@seanmars/tospec 0.19.0-beta.8 → 0.20.0

package/dist/commands/workflow/shared.js

@@ -1,24 +1,12 @@
-/**
- * Shared Types and Utilities for Artifact Workflow Commands
- *
- * This module contains types, constants, and validation helpers used across
- * multiple artifact workflow commands.
- */
+/** Types, constants and validation helpers shared by the workflow commands. */
 import path from 'path';
 import * as fs from 'fs';
 import { getSchemaDir, listLoadableSchemas, resolveSchema } from '../../core/artifact-graph/index.js';
 import { validateChangeName } from '../../utils/change-utils.js';
-import { DECISION_SCHEMA_NAME } from '../decision.js';
-// -----------------------------------------------------------------------------
-// Constants
-// -----------------------------------------------------------------------------
-export const DEFAULT_SCHEMA = 'sdd';
-// -----------------------------------------------------------------------------
-// Utility Functions
-// -----------------------------------------------------------------------------
-/**
- * Gets the status indicator for an artifact.
- */
+import { DECISION_SCHEMA_NAME, DEFAULT_SCHEMA } from '../../core/schema-names.js';
+// Defined in core/schema-names so this module and decision.ts share it without
+// importing each other; re-exported because the workflow barrel publishes it.
+export { DEFAULT_SCHEMA };
 export function getStatusIndicator(status) {
     switch (status) {
         case 'done':
@@ -27,9 +15,8 @@ export function getStatusIndicator(status) {
             return '[ ]';
         case 'blocked':
             return '[-]';
-        // Both mean "not written and not required", and the reader's next move is
-        // the same for either, so they share a marker; the label beside it says
-        // which (see status.ts).
+        // Both mean "not written and not required" and call for the same next move,
+        // so they share a marker; the label beside it says which.
         case 'skipped':
         case 'optional':
             return '[~]';
@@ -37,14 +24,10 @@ export function getStatusIndicator(status) {
             return '[!]';
     }
 }
-/**
- * Returns the list of available change directory names under tospec/changes/.
- * Excludes the archive directory and hidden directories.
- */
+/** Change directory names under `tospec/changes/`, minus `archive` and dotdirs. */
 export async function getAvailableChanges(projectRoot, changesDir = path.join(projectRoot, 'tospec', 'changes')) {
-    const changesPath = changesDir;
     try {
-        const entries = await fs.promises.readdir(changesPath, { withFileTypes: true });
+        const entries = await fs.promises.readdir(changesDir, { withFileTypes: true });
         return entries
             .filter((e) => e.isDirectory() && e.name !== 'archive' && !e.name.startsWith('.'))
             .map((e) => e.name);
@@ -56,11 +39,12 @@ export async function getAvailableChanges(projectRoot, changesDir = path.join(pr
     }
 }
 /**
- * Validates that a change exists and returns available changes if not.
- * Checks directory existence directly to support scaffolded changes (without proposal.md).
+ * Resolves a change name, listing what is available when it does not exist.
+ * Tests the directory rather than an artifact, so a scaffolded change (no
+ * proposal.md yet) still counts.
  */
 export async function validateChangeExists(changeName, projectRoot, changesDir = path.join(projectRoot, 'tospec', 'changes'), hints = {}) {
-    // Hints must stay pasteable: callers with a selected store pass a
+    // Hints must stay pasteable: a caller with a selected store passes a
     // store-carrying hint so following it lands in the same root.
     const newChangeHint = hints.newChangeHint ?? 'tospec new change <name>';
     if (!changeName) {
@@ -70,12 +54,11 @@ export async function validateChangeExists(changeName, projectRoot, changesDir =
         }
         throw new Error(`Missing required option --change. Available changes:\n  ${available.join('\n  ')}`);
     }
-    // Validate change name format to prevent path traversal
+    // Name format first: this value is about to be joined onto a directory.
     const nameValidation = validateChangeName(changeName);
     if (!nameValidation.valid) {
         throw new Error(`Invalid change name '${changeName}': ${nameValidation.error}`);
     }
-    // Check directory existence directly
     const changePath = path.join(changesDir, changeName);
     const exists = fs.existsSync(changePath) && fs.statSync(changePath).isDirectory();
     if (!exists) {
@@ -88,22 +71,14 @@ export async function validateChangeExists(changeName, projectRoot, changesDir =
     return changeName;
 }
 /**
- * Validates that a schema is usable, not merely present on disk.
- *
- * Round 4 report 5: this checked for the directory only, so
- * `new change --schema <name>` succeeded against a schema.yaml that does not
- * parse and left behind a change nothing could read — no `type` in its
- * metadata, no ticket, and every later command failing on it. Resolving the
- * schema here turns that into the precise message `templates --schema <name>`
- * was already giving, before anything is written.
- *
- * @param schemaName - The schema name to validate
- * @param projectRoot - Optional project root for project-local schema resolution
+ * Validates that a schema is usable, not merely present on disk. A directory
+ * check alone lets `new change --schema <name>` succeed against a schema.yaml
+ * that does not parse, leaving a change nothing can read.
  */
 export function validateSchemaExists(schemaName, projectRoot) {
     const schemaDir = getSchemaDir(schemaName, projectRoot);
     if (!schemaDir) {
-        // Loadable, not merely present, so the list is only ever advice that works.
+        // Loadable, not merely present, so the list is advice that works.
         const availableSchemas = listLoadableSchemas(projectRoot);
         throw new Error(`Schema '${schemaName}' not found. Available schemas:\n  ${availableSchemas.join('\n  ')}`);
     }
@@ -111,18 +86,12 @@ export function validateSchemaExists(schemaName, projectRoot) {
     return schemaName;
 }
 /**
- * Refuses the decision schema for commands that operate on a change.
- *
- * The decision schema backs `tospec decision new`; its artifact belongs in
- * `tospec/decisions/`. Pointed at a change it produces something no command can
- * reach — `new change --schema decision` built a directory `decision list`
- * never saw, and `instructions --schema decision --change <x>` sent an agent to
- * write `tospec/changes/<x>/decision.md`, a file nothing reads and archive does
- * not merge.
+ * Refuses the decision schema for commands that operate on a change: its
+ * artifact belongs in `tospec/decisions/`, so pointed at a change it produces a
+ * directory `decision list` never sees and a `decision.md` archive never merges.
  *
- * Shared by both so the two entry points cannot disagree about it; `templates
- * --schema decision` deliberately does not call this, because listing that
- * schema's templates is what `decision new` itself needs.
+ * `templates --schema decision` does not call this — listing that schema's
+ * templates is what `decision new` itself needs.
  */
 export function assertChangeSchema(schemaName) {
     if (schemaName === DECISION_SCHEMA_NAME) {

package/dist/commands/workflow/shared.js.map

@@ -1 +1 @@
-{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../../src/commands/workflow/shared.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../../src/commands/workflow/shared.ts"],"names":[],"mappings":"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"}

package/dist/commands/workflow/status.d.ts

@@ -1,8 +1,4 @@
-/**
- * Status Command
- *
- * Displays artifact completion status for a change.
- */
+/** `tospec status` — artifact completion for one change, or for every change. */
 import { type ChangeStatus } from '../../core/artifact-graph/index.js';
 export interface StatusOptions {
     change?: string;
@@ -13,21 +9,15 @@ export interface StatusOptions {
 /**
  * The `--all --json` failure null-shape. Root selection resolves inside this
  * module while thrown errors are caught by the CLI wrapper, so both call sites
- * reference this one constant rather than each spelling the shape out.
+ * reference this one constant.
  */
 export declare const BATCH_STATUS_FAILURE_PAYLOAD: Record<string, unknown>;
 /**
- * The single-change `--json` failure null-shape.
- *
- * Flat payload, like `instructions` and `show`: it spreads `changeName`,
- * `artifacts` and a dozen siblings at the top level rather than nesting them
- * under a wrapper. Per
- * decisions/20260917_155623-flat-json-payloads-null-a-real-success-key.md, such
- * a command nulls a key its success output really carries — `changeName` here,
- * as `instruction` and `id` do there. It previously nulled nothing at all, which
- * left this the one envelope a caller could not tell apart from an unrelated
- * error document; the ADR's two tests both pass vacuously on an empty key set,
- * so the rule had to be asserted directly (see json-failure.test.ts).
+ * The single-change `--json` failure null-shape. Flat payload, like
+ * `instructions` and `show`, so it nulls a key its success output really carries
+ * (`changeName`) — otherwise a caller cannot tell this envelope from an
+ * unrelated error document.
+ * decisions/20260917_155623-flat-json-payloads-null-a-real-success-key.md
  */
 export declare const STATUS_FAILURE_PAYLOAD: Record<string, unknown>;
 export declare function statusCommand(options: StatusOptions): Promise<void>;

package/dist/commands/workflow/status.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../src/commands/workflow/status.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAQH,OAAO,EAGL,KAAK,YAAY,EAClB,MAAM,oCAAoC,CAAC;AAe5C,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AASD;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAiC,CAAC;AAEnG;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAoC,CAAC;AAMhG,wBAAsB,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAmJzE;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CA6C1D"}
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../src/commands/workflow/status.ts"],"names":[],"mappings":"AAAA,iFAAiF;AAQjF,OAAO,EAGL,KAAK,YAAY,EAClB,MAAM,oCAAoC,CAAC;AAY5C,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AASD;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAiC,CAAC;AAEnG;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAoC,CAAC;AAEhG,wBAAsB,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CA6IzE;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAmD1D"}

package/dist/commands/workflow/status.js

@@ -1,49 +1,33 @@
-/**
- * Status Command
- *
- * Displays artifact completion status for a change.
- */
+/** `tospec status` — artifact completion for one change, or for every change. */
 import { getChangeDir } from '../../core/planning-home.js';
 import { resolveRootForCommand, toPlanningHome, toRootOutput, } from '../../core/root-selection.js';
 import { loadChangeContext, formatChangeStatus, } from '../../core/artifact-graph/index.js';
 import { validateChangeExists, validateSchemaExists, assertChangeSchema, getAvailableChanges, getStatusIndicator, } from './shared.js';
 import { emitSuccess, asStatus } from '../shared-output.js';
 import { findTicketPath } from '../../utils/item-discovery.js';
+import { printProjectConfigDiagnostics } from '../../core/project-config.js';
 /**
  * The `--all --json` failure null-shape. Root selection resolves inside this
  * module while thrown errors are caught by the CLI wrapper, so both call sites
- * reference this one constant rather than each spelling the shape out.
+ * reference this one constant.
  */
 export const BATCH_STATUS_FAILURE_PAYLOAD = { changes: null, root: null };
 /**
- * The single-change `--json` failure null-shape.
- *
- * Flat payload, like `instructions` and `show`: it spreads `changeName`,
- * `artifacts` and a dozen siblings at the top level rather than nesting them
- * under a wrapper. Per
- * decisions/20260917_155623-flat-json-payloads-null-a-real-success-key.md, such
- * a command nulls a key its success output really carries — `changeName` here,
- * as `instruction` and `id` do there. It previously nulled nothing at all, which
- * left this the one envelope a caller could not tell apart from an unrelated
- * error document; the ADR's two tests both pass vacuously on an empty key set,
- * so the rule had to be asserted directly (see json-failure.test.ts).
+ * The single-change `--json` failure null-shape. Flat payload, like
+ * `instructions` and `show`, so it nulls a key its success output really carries
+ * (`changeName`) — otherwise a caller cannot tell this envelope from an
+ * unrelated error document.
+ * decisions/20260917_155623-flat-json-payloads-null-a-real-success-key.md
  */
 export const STATUS_FAILURE_PAYLOAD = { changeName: null, root: null };
-// -----------------------------------------------------------------------------
-// Command Implementation
-// -----------------------------------------------------------------------------
 export async function statusCommand(options) {
     if (options.all && options.change) {
         throw new Error('The --all and --change options are mutually exclusive.');
     }
-    // The batch null-shape rides along so a root-selection failure under
-    // --all --json still carries `changes: null` rather than an empty payload.
-    //
     // No implicit root: it resolves only when no ancestor holds a `tospec/` dir,
     // and status would then answer "No active changes." with exit 0 about a
-    // directory that is not a project at all — the same vacuous pass `validate`
-    // refuses implicit roots to avoid. `list` and `archive` refuse it too, so all
-    // four now report the one `no_tospec_root` diagnostic for the one condition.
+    // directory that is not a project — the vacuous pass `validate`, `list` and
+    // `archive` also refuse.
     const root = await resolveRootForCommand(options, {
         json: options.json,
         allowImplicitRoot: false,
@@ -56,30 +40,33 @@ export async function statusCommand(options) {
     const projectRoot = root.path;
     const rootOutput = toRootOutput(root);
     const newChangeHint = 'tospec new change <name>';
-    // Single definition of "load one change's status" so the batch and
-    // single-change payloads cannot drift apart.
+    // One definition of "load a change's status", so the batch and single-change
+    // payloads cannot drift apart.
     const loadStatus = (changeName) => formatChangeStatus(loadChangeContext(projectRoot, changeName, options.schema, {
         changeDir: getChangeDir(planningHome, changeName),
         planningHome,
     }));
     // The ticket lives outside the change dir under a CLI-generated timestamp, so
-    // it appears in no artifact path — an agent asked to fill in its Summary had
-    // to glob `tospec/tickets/` and match frontmatter by hand. Added here, inside
-    // the shared loader, so the batch and single-change payloads keep reporting
-    // the same fields.
+    // it appears in no artifact path; without this an agent has to glob
+    // `tospec/tickets/` and match frontmatter by hand.
     const loadStatusWithTicket = async (changeName) => ({
         ...loadStatus(changeName),
         ticketPath: (await findTicketPath(projectRoot, changeName)) ?? null,
     });
-    // Handle no-changes case gracefully — status is informational,
-    // so "no changes" is a valid state, not an error.
+    // `--schema` is judged on its own, before anything about changes is read: a
+    // wrong name is wrong whatever else was passed, and checking it later sends
+    // the caller to create a change first. `decision` is refused too, since it
+    // would plan an artifact at `tospec/changes/<change>/decision.md` — the orphan
+    // `instructions` and `new change` already refuse.
+    if (options.schema) {
+        validateSchemaExists(options.schema, projectRoot);
+        assertChangeSchema(options.schema);
+    }
+    // A change's schema falls back to the project config, so a config that no
+    // longer parses changes what this command reports — say so, once.
+    printProjectConfigDiagnostics(projectRoot);
+    // "No changes" is a valid state for an informational command, not an error.
     if (!options.change) {
-        // Validated before the no-changes early return so a bogus --schema fails
-        // the same way whether or not any change exists yet.
-        if (options.all && options.schema) {
-            validateSchemaExists(options.schema, projectRoot);
-            assertChangeSchema(options.schema);
-        }
         const available = await getAvailableChanges(projectRoot, root.changesDir);
         if (available.length === 0) {
             if (options.json) {
@@ -90,15 +77,27 @@ export async function statusCommand(options) {
             return;
         }
         if (options.all) {
-            // readdir order is platform-dependent; sort with the comparator
-            // `validate --all` uses so both batch commands order a change set alike.
+            // readdir order is platform-dependent; the comparator is the one
+            // `validate --all` uses, so both batch commands order a change set alike.
             const entries = [];
+            // Top-level copies of the per-entry failures, for the `status` array the
+            // partial envelope carries: `list --json` and `validate --all --json`
+            // report an unreadable change there too, so a caller reads one place.
+            const diagnostics = [];
             for (const changeName of available.sort((a, b) => a.localeCompare(b))) {
                 try {
                     entries.push(await loadStatusWithTicket(changeName));
                 }
                 catch (error) {
-                    entries.push({ changeName, status: [asStatus(error, 'change_error')] });
+                    const diagnostic = asStatus(error, 'change_error');
+                    entries.push({ changeName, status: [diagnostic] });
+                    diagnostics.push({
+                        ...diagnostic,
+                        code: 'change_unreadable',
+                        message: `Change '${changeName}' could not be read: ${diagnostic.message}`,
+                        target: getChangeDir(planningHome, changeName),
+                        fix: `Fix ${changeName}'s .tospec.yaml, or move the directory out of tospec/changes/.`,
+                    });
                 }
             }
             // `artifacts` is what a loaded status has and a diagnostic entry does not.
@@ -106,8 +105,7 @@ export async function statusCommand(options) {
             if (options.json) {
                 // The full envelope is emitted even on partial failure: dropping the
                 // report to report the failure would lose every change that did load.
-                // Same shape as `validate --all`, which carries per-item issues too.
-                emitSuccess({ changes: entries }, rootOutput);
+                emitSuccess({ changes: entries, ...(diagnostics.length ? { status: diagnostics } : {}) }, rootOutput);
             }
             else {
                 entries.forEach((entry, index) => {
@@ -128,31 +126,12 @@ export async function statusCommand(options) {
             }
             return;
         }
-        // Changes exist but neither --change nor --all was given. Name --all here
-        // too: it is the other way to answer this prompt, and a caller who wants
-        // every change should not have to find it in --help.
+        // Changes exist but neither --change nor --all was given, so name both ways
+        // to answer this prompt.
         throw new Error(`Missing required option --change (or --all for every active change). Available changes:\n  ${available.join('\n  ')}`);
     }
-    // Validate schema if explicitly provided.
-    //
-    // Guarded for the same reason as `instructions` and `new change`, and with
-    // more force: `status --schema decision` planned an artifact at
-    // tospec/changes/<change>/decision.md — the orphan file those two already
-    // refuse — and then handed back a nextSteps line telling the caller to run
-    // `tospec instructions decision`, which refuses. The two commands together
-    // formed a closed loop: the one that issues the instruction was the one
-    // without the check.
-    //
-    // Before change resolution, not after (round 4 report 15). Sitting after it,
-    // the guard never fired in an empty project: the caller got "Create one with:
-    // tospec new change <name>", did exactly that, and only then learned the
-    // schema was never usable — the misdirection this guard was added to remove.
-    if (options.schema) {
-        validateSchemaExists(options.schema, projectRoot);
-        assertChangeSchema(options.schema);
-    }
     const changeName = await validateChangeExists(options.change, projectRoot, root.changesDir, { newChangeHint });
-    // loadChangeContext will auto-detect schema from metadata if not provided
+    // The schema comes from the change's metadata when not given.
     if (options.json) {
         emitSuccess({ ...(await loadStatusWithTicket(changeName)) }, rootOutput);
         return;
@@ -161,14 +140,20 @@ export async function statusCommand(options) {
     printStatusText(status);
 }
 export function printStatusText(status) {
-    const doneCount = status.artifacts.filter((a) => a.status === 'done').length;
-    const total = status.artifacts.length;
+    // Counted against the same definition `graph.isComplete` uses: an optional
+    // artifact nobody wrote and one the change declared away are not outstanding
+    // work, so counting them prints "Progress: 1/2" above "All artifacts
+    // complete!". One that *was* written reports `done` and counts.
+    const counted = status.artifacts.filter((a) => a.status !== 'optional' && a.status !== 'skipped');
+    const doneCount = counted.filter((a) => a.status === 'done').length;
+    const setAside = status.artifacts.length - counted.length;
     console.log(`Change: ${status.changeName}`);
     console.log(`Schema: ${status.schemaName}`);
     if (status.changeRoot) {
         console.log(`Change root: ${status.changeRoot}`);
     }
-    console.log(`Progress: ${doneCount}/${total} artifacts complete`);
+    const setAsideNote = setAside > 0 ? ` (${setAside} not required)` : '';
+    console.log(`Progress: ${doneCount}/${counted.length} artifacts complete${setAsideNote}`);
     console.log();
     for (const artifact of status.artifacts) {
         const indicator = getStatusIndicator(artifact.status);
@@ -179,8 +164,8 @@ export function printStatusText(status) {
         if (artifact.status === 'stub') {
             line += ' (stub: file exists but is empty or template-identical — fill it in)';
         }
-        // The two share a marker; the label is what tells them apart, and the
-        // difference is whether writing it is still on the table.
+        // `optional` and `skipped` share a marker; the label says whether writing
+        // it is still on the table.
         if (artifact.status === 'optional') {
             line += ' (optional: not written — write it if this change needs it)';
         }

package/dist/commands/workflow/status.js.map

@@ -1 +1 @@
-{"version":3,"file":"status.js","sourceRoot":"","sources":["../../../src/commands/workflow/status.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../../src/commands/workflow/status.ts"],"names":[],"mappings":"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"}

package/dist/commands/workflow/templates.d.ts

@@ -1,13 +1,7 @@
-/**
- * Templates Command
- *
- * Shows resolved template paths for all artifacts in a schema.
- */
+/** `tospec templates` — resolved template paths for a schema's artifacts. */
 /**
  * The `--json` null-shape. Exported so the commander-level shape table and this
- * command's own catch block read the same object instead of two literals that
- * drifted — the catch block's copy was missing `root`, which every success
- * payload carries.
+ * command's own catch block read one object rather than two literals that drift.
  */
 export declare const TEMPLATES_FAILURE_PAYLOAD: Record<string, unknown>;
 export interface TemplatesOptions {
@@ -18,6 +12,12 @@ export interface TemplateInfo {
     artifactId: string;
     templatePath: string;
     source: 'project' | 'user' | 'package';
+    /**
+     * False when the schema names a template file that is not on disk. Composing
+     * the path without checking reports success for a path that ENOENTs, while
+     * `instructions` for the same schema fails outright.
+     */
+    exists: boolean;
 }
 export declare function templatesCommand(options: TemplatesOptions): Promise<void>;
 //# sourceMappingURL=templates.d.ts.map

package/dist/commands/workflow/templates.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../../src/commands/workflow/templates.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAiBH;;;;;GAKG;AACH,eAAO,MAAM,yBAAyB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAG7D,CAAC;AAEF,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS,CAAC;CACxC;AAMD,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiE/E"}
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../../src/commands/workflow/templates.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAc7E;;;GAGG;AACH,eAAO,MAAM,yBAAyB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAG7D,CAAC;AAEF,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS,CAAC;IACvC;;;;OAIG;IACH,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CA8D/E"}

package/dist/commands/workflow/templates.js

@@ -1,36 +1,25 @@
-/**
- * Templates Command
- *
- * Shows resolved template paths for all artifacts in a schema.
- */
+/** `tospec templates` — resolved template paths for a schema's artifacts. */
 import path from 'path';
-import { resolveSchema, getSchemaDir, ArtifactGraph, } from '../../core/artifact-graph/index.js';
+import * as fs from 'fs';
+import { resolveSchema, getSchemaDirWithSource, ArtifactGraph, } from '../../core/artifact-graph/index.js';
 import { FileSystemUtils } from '../../utils/file-system.js';
 import { validateSchemaExists, DEFAULT_SCHEMA } from './shared.js';
 import { emitSuccess } from '../shared-output.js';
 import { resolveRootForCommand, toRootOutput } from '../../core/root-selection.js';
-// -----------------------------------------------------------------------------
-// Types
-// -----------------------------------------------------------------------------
 /**
  * The `--json` null-shape. Exported so the commander-level shape table and this
- * command's own catch block read the same object instead of two literals that
- * drifted — the catch block's copy was missing `root`, which every success
- * payload carries.
+ * command's own catch block read one object rather than two literals that drift.
  */
 export const TEMPLATES_FAILURE_PAYLOAD = {
     templates: null,
     root: null,
 };
-// -----------------------------------------------------------------------------
-// Command Implementation
-// -----------------------------------------------------------------------------
 export async function templatesCommand(options) {
-    // Same root resolution as every other command — a subdirectory of a
-    // tospec project resolves the project root, not the bare cwd (report 4.3).
+    // Same root resolution as every other command: a subdirectory of a project
+    // resolves the project root, not the bare cwd.
     const root = await resolveRootForCommand(options, {
         json: options.json,
-        failurePayload: { templates: null },
+        failurePayload: TEMPLATES_FAILURE_PAYLOAD,
     });
     if (!root) {
         return;
@@ -39,46 +28,43 @@ export async function templatesCommand(options) {
     const schemaName = validateSchemaExists(options.schema ?? DEFAULT_SCHEMA, projectRoot);
     const schema = resolveSchema(schemaName, projectRoot);
     const graph = ArtifactGraph.fromSchema(schema);
-    const schemaDir = getSchemaDir(schemaName, projectRoot);
-    // Determine the source (project, user, or package)
-    const { getUserSchemasDir, getProjectSchemasDir, } = await import('../../core/artifact-graph/resolver.js');
-    const projectSchemasDir = getProjectSchemasDir(projectRoot);
-    const userSchemasDir = getUserSchemasDir();
-    // Determine source by checking if schemaDir is inside each base directory
-    // Using path.relative is more robust than startsWith for path comparisons
-    const isInsideDir = (child, parent) => {
-        const relative = path.relative(parent, child);
-        return !relative.startsWith('..') && !path.isAbsolute(relative);
-    };
-    let source;
-    if (isInsideDir(schemaDir, projectSchemasDir)) {
-        source = 'project';
-    }
-    else if (isInsideDir(schemaDir, userSchemasDir)) {
-        source = 'user';
-    }
-    else {
-        source = 'package';
-    }
-    const templates = graph.getAllArtifacts().map((artifact) => ({
-        artifactId: artifact.id,
-        templatePath: FileSystemUtils.canonicalizeExistingPath(path.join(schemaDir, 'templates', artifact.template)),
-        source,
+    // The layer comes from the resolver that picked the directory rather than
+    // being re-derived here, so there is only one answer to "which layer won".
+    const { dir: schemaDir, source } = getSchemaDirWithSource(schemaName, projectRoot);
+    const templates = graph.getAllArtifacts().map((artifact) => {
+        const templatePath = path.join(schemaDir, 'templates', artifact.template);
+        return {
+            artifactId: artifact.id,
+            templatePath: FileSystemUtils.canonicalizeExistingPath(templatePath),
+            source,
+            exists: fs.existsSync(templatePath),
+        };
+    });
+    const missing = templates.filter((t) => !t.exists);
+    // Reported, not thrown: the other artifacts' paths are still correct, and
+    // exit stays 0 because nothing the caller asked for failed.
+    const missingDiagnostics = missing.map((t) => ({
+        severity: 'warning',
+        code: 'template_file_missing',
+        message: `Schema '${schemaName}' declares template '${t.artifactId}' at ${t.templatePath}, but that file does not exist. tospec instructions ${t.artifactId} will fail until it is created.`,
     }));
     if (options.json) {
         const output = {};
         for (const t of templates) {
-            output[t.artifactId] = { path: t.templatePath, source: t.source };
+            output[t.artifactId] = { path: t.templatePath, source: t.source, exists: t.exists };
         }
-        emitSuccess({ templates: output }, toRootOutput(root));
+        emitSuccess({ templates: output, ...(missingDiagnostics.length ? { status: missingDiagnostics } : {}) }, toRootOutput(root));
         return;
     }
+    for (const diagnostic of missingDiagnostics) {
+        console.error(`Warning: ${diagnostic.message}`);
+    }
     console.log(`Schema: ${schemaName}`);
     console.log(`Source: ${source}`);
     console.log();
     for (const t of templates) {
         console.log(`${t.artifactId}:`);
-        console.log(`  ${t.templatePath}`);
+        console.log(`  ${t.templatePath}${t.exists ? '' : '  (missing)'}`);
     }
 }
 //# sourceMappingURL=templates.js.map