feat: add specify artifact command exposing composition stacks as JSON

src/specify_cli/__init__.py

@@ -560,6 +560,13 @@ def _require_specify_project() -> Path:
 _register_preset_cmds(app)
 
 
+# ===== Artifact Commands =====
+
+# Read-only introspection over the composed inventory (commands/templates/scripts).
+from .artifacts._commands import register as _register_artifact_cmds  # noqa: E402
+_register_artifact_cmds(app)
+
+
 # ===== Bundle Commands =====
 
 # Bundler subcommand group (specify bundle ...) — see commands/bundle/.

src/specify_cli/_assets.py

@@ -32,6 +32,32 @@ def _repo_root() -> Path:
     return Path(__file__).parent.parent.parent
 
 
+def _locate_core_asset_dir(subdir: str) -> Path | None:
+    """Return the on-disk directory holding a family of core assets, or None.
+
+    ``subdir`` is one of ``"commands"``, ``"templates"``, or ``"scripts"`` —
+    the three asset families every core baseline consumer needs to agree on.
+    Prefers the wheel-installed ``core_pack`` bundle, then falls back to the
+    source-checkout layout. This is the single place that knows the two-tier
+    resolution ("wheel bundle, else repo-root checkout") for locating core
+    assets, so callers (extension command-name discovery, the preset
+    resolver's core fallback, and the artifact command's core-baseline
+    enumeration) cannot silently diverge on what "core" means on a given
+    machine.
+    """
+    core = _locate_core_pack()
+    if core is not None:
+        candidate = core / subdir
+        return candidate if candidate.is_dir() else None
+    if subdir == "commands":
+        candidate = _repo_root() / "templates" / "commands"
+    elif subdir in ("templates", "scripts"):
+        candidate = _repo_root() / subdir
+    else:  # pragma: no cover — internal misuse
+        return None
+    return candidate if candidate.is_dir() else None
+
+
 def _locate_bundled_extension(extension_id: str) -> Path | None:
     """Return the path to a bundled extension, or None.
 

src/specify_cli/_identifier.py

@@ -98,6 +98,26 @@ def derive_named_id(layer: str, source_id: str, kind: str, name: str) -> str:
     return f"{layer}:{source_id}:{kind}:{name}"
 
 
+_LAYER_KINDS = frozenset({"core", PROJECT_OVERRIDE_LAYER, "preset", "extension"})
+
+
+def layer_kind_from_lookup_id(lookup_id: str) -> str | None:
+    """Return the layer segment of a resolved-stack ``lookupId``, or ``None``.
+
+    ``lookupId`` values on resolved stack layers follow the same
+    ``"{layer}:..."`` grammar as manifest-contribution ``id`` values (see
+    module docstring), with ``layer`` additionally taking on
+    :data:`PROJECT_OVERRIDE_LAYER` for resolver-only project-override layers.
+    This is the single place that knows the set of valid layer prefixes, so
+    consumers can classify a lookupId without re-deriving the grammar via
+    string-prefix checks of their own.
+    """
+    layer, _, rest = lookup_id.partition(":")
+    if not rest or layer not in _LAYER_KINDS:
+        return None
+    return layer
+
+
 def canonical_json(value: Any) -> bytes:
     """Serialize ``value`` to a canonical UTF-8 JSON byte string.
 

src/specify_cli/_script_variants.py

@@ -0,0 +1,32 @@
+"""Canonical names and paths for the core script runtime variants."""
+
+from __future__ import annotations
+
+from collections.abc import Iterator
+from pathlib import Path
+
+_SCRIPT_VARIANTS = (
+    ("bash", ".sh", False),
+    ("powershell", ".ps1", False),
+    ("python", ".py", True),
+)
+
+
+def canonical_script_name(path: Path) -> str | None:
+    """Return the logical name shared by a core script's runtime variants."""
+    for runtime, suffix, uses_underscores in _SCRIPT_VARIANTS:
+        if path.parent.name == runtime and path.suffix == suffix:
+            return path.stem.replace("_", "-") if uses_underscores else path.stem
+    return None
+
+
+def script_variant_paths(scripts_dir: Path, name: str) -> Iterator[Path]:
+    """Yield candidate paths for the logical script *name*.
+
+    The legacy flat Bash path (``<scripts_dir>/<name>.sh``) is yielded first so
+    existing projects keep working, followed by the runtime-specific paths.
+    """
+    yield scripts_dir / f"{name}.sh"
+    for runtime, suffix, uses_underscores in _SCRIPT_VARIANTS:
+        stem = name.replace("-", "_") if uses_underscores else name
+        yield scripts_dir / runtime / f"{stem}{suffix}"