@seanmars/tospec 0.19.0-beta.7 → 0.19.0-beta.8

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

@@ -16,6 +16,20 @@ export interface StatusOptions {
  * reference this one constant rather than each spelling the shape out.
  */
 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).
+ */
+export declare const STATUS_FAILURE_PAYLOAD: Record<string, unknown>;
 export declare function statusCommand(options: StatusOptions): Promise<void>;
 export declare function printStatusText(status: ChangeStatus): void;
 //# sourceMappingURL=status.d.ts.map

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;AAa5C,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,CAAqB,CAAC;AAMvF,wBAAsB,aAAa,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAmHzE;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAmC1D"}
+{"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"}

package/dist/commands/workflow/status.js

@@ -6,14 +6,29 @@
 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, getAvailableChanges, getStatusIndicator, } from './shared.js';
+import { validateChangeExists, validateSchemaExists, assertChangeSchema, getAvailableChanges, getStatusIndicator, } from './shared.js';
 import { emitSuccess, asStatus } from '../shared-output.js';
+import { findTicketPath } from '../../utils/item-discovery.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.
  */
-export const BATCH_STATUS_FAILURE_PAYLOAD = { changes: null };
+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).
+ */
+export const STATUS_FAILURE_PAYLOAD = { changeName: null, root: null };
 // -----------------------------------------------------------------------------
 // Command Implementation
 // -----------------------------------------------------------------------------
@@ -23,9 +38,16 @@ export async function statusCommand(options) {
     }
     // 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.
     const root = await resolveRootForCommand(options, {
         json: options.json,
-        failurePayload: options.all ? BATCH_STATUS_FAILURE_PAYLOAD : undefined,
+        allowImplicitRoot: false,
+        failurePayload: options.all ? BATCH_STATUS_FAILURE_PAYLOAD : STATUS_FAILURE_PAYLOAD,
     });
     if (!root) {
         return;
@@ -40,6 +62,15 @@ export async function statusCommand(options) {
         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.
+    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.
     if (!options.change) {
@@ -47,6 +78,7 @@ export async function statusCommand(options) {
         // 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) {
@@ -63,7 +95,7 @@ export async function statusCommand(options) {
             const entries = [];
             for (const changeName of available.sort((a, b) => a.localeCompare(b))) {
                 try {
-                    entries.push(loadStatus(changeName));
+                    entries.push(await loadStatusWithTicket(changeName));
                 }
                 catch (error) {
                     entries.push({ changeName, status: [asStatus(error, 'change_error')] });
@@ -101,17 +133,31 @@ export async function statusCommand(options) {
         // every change should not have to find it in --help.
         throw new Error(`Missing required option --change (or --all for every active change). Available changes:\n  ${available.join('\n  ')}`);
     }
-    const changeName = await validateChangeExists(options.change, projectRoot, root.changesDir, { newChangeHint });
-    // Validate schema if explicitly provided
+    // 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
-    const status = loadStatus(changeName);
     if (options.json) {
-        emitSuccess({ ...status }, rootOutput);
+        emitSuccess({ ...(await loadStatusWithTicket(changeName)) }, rootOutput);
         return;
     }
+    const status = loadStatus(changeName);
     printStatusText(status);
 }
 export function printStatusText(status) {
@@ -133,6 +179,14 @@ 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.
+        if (artifact.status === 'optional') {
+            line += ' (optional: not written — write it if this change needs it)';
+        }
+        if (artifact.status === 'skipped') {
+            line += ' (skipped: this change declared it away)';
+        }
         console.log(line);
     }
     for (const diagnostic of status.status ?? []) {

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

@@ -3,6 +3,13 @@
  *
  * Shows resolved template paths for all artifacts in a schema.
  */
+/**
+ * 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.
+ */
+export declare const TEMPLATES_FAILURE_PAYLOAD: Record<string, unknown>;
 export interface TemplatesOptions {
     schema?: string;
     json?: boolean;

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,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;;;;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"}

package/dist/commands/workflow/templates.js

@@ -10,6 +10,19 @@ 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.
+ */
+export const TEMPLATES_FAILURE_PAYLOAD = {
+    templates: null,
+    root: null,
+};
+// -----------------------------------------------------------------------------
 // Command Implementation
 // -----------------------------------------------------------------------------
 export async function templatesCommand(options) {

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

@@ -1 +1 @@
-{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../../src/commands/workflow/templates.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EACL,aAAa,EACb,YAAY,EACZ,aAAa,GACd,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAiBnF,gFAAgF;AAChF,yBAAyB;AACzB,gFAAgF;AAEhF,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,OAAyB;IAC9D,oEAAoE;IACpE,2EAA2E;IAC3E,MAAM,IAAI,GAAG,MAAM,qBAAqB,CAAC,OAAO,EAAE;QAChD,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,cAAc,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE;KACpC,CAAC,CAAC;IACH,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO;IACT,CAAC;IACD,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC;IAC9B,MAAM,UAAU,GAAG,oBAAoB,CAAC,OAAO,CAAC,MAAM,IAAI,cAAc,EAAE,WAAW,CAAC,CAAC;IACvF,MAAM,MAAM,GAAG,aAAa,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;IACtD,MAAM,KAAK,GAAG,aAAa,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IAC/C,MAAM,SAAS,GAAG,YAAY,CAAC,UAAU,EAAE,WAAW,CAAE,CAAC;IAEzD,mDAAmD;IACnD,MAAM,EACJ,iBAAiB,EACjB,oBAAoB,GACrB,GAAG,MAAM,MAAM,CAAC,uCAAuC,CAAC,CAAC;IAC1D,MAAM,iBAAiB,GAAG,oBAAoB,CAAC,WAAW,CAAC,CAAC;IAC5D,MAAM,cAAc,GAAG,iBAAiB,EAAE,CAAC;IAE3C,0EAA0E;IAC1E,0EAA0E;IAC1E,MAAM,WAAW,GAAG,CAAC,KAAa,EAAE,MAAc,EAAW,EAAE;QAC7D,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAC9C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IAClE,CAAC,CAAC;IAEF,IAAI,MAAsC,CAAC;IAC3C,IAAI,WAAW,CAAC,SAAS,EAAE,iBAAiB,CAAC,EAAE,CAAC;QAC9C,MAAM,GAAG,SAAS,CAAC;IACrB,CAAC;SAAM,IAAI,WAAW,CAAC,SAAS,EAAE,cAAc,CAAC,EAAE,CAAC;QAClD,MAAM,GAAG,MAAM,CAAC;IAClB,CAAC;SAAM,CAAC;QACN,MAAM,GAAG,SAAS,CAAC;IACrB,CAAC;IAED,MAAM,SAAS,GAAmB,KAAK,CAAC,eAAe,EAAE,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAC3E,UAAU,EAAE,QAAQ,CAAC,EAAE;QACvB,YAAY,EAAE,eAAe,CAAC,wBAAwB,CACpD,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,EAAE,QAAQ,CAAC,QAAQ,CAAC,CACrD;QACD,MAAM;KACP,CAAC,CAAC,CAAC;IAEJ,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,MAAM,MAAM,GAAqD,EAAE,CAAC;QACpE,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;YAC1B,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,YAAY,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;QACpE,CAAC;QACD,WAAW,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC;QACvD,OAAO;IACT,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,WAAW,UAAU,EAAE,CAAC,CAAC;IACrC,OAAO,CAAC,GAAG,CAAC,WAAW,MAAM,EAAE,CAAC,CAAC;IACjC,OAAO,CAAC,GAAG,EAAE,CAAC;IAEd,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;QAC1B,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC;QAChC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC;IACrC,CAAC;AACH,CAAC"}
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../../src/commands/workflow/templates.ts"],"names":[],"mappings":"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"}

package/dist/core/archive.d.ts

@@ -40,6 +40,20 @@ export declare class ArchiveCommand {
      * step by hand for the "every blocked path throws in JSON mode" invariant.
      */
     private gate;
+    /**
+     * Required artifacts the change never produced, in schema order.
+     *
+     * Reads the same graph `tospec status` does, so the two can never disagree
+     * about what "required" means. `skipped` covers the legitimate opt-out
+     * (`skip_specs: true`), and optional artifacts are the schema's own statement
+     * that their absence is fine — neither is reported here.
+     *
+     * A change whose graph cannot be loaded at all (unreadable metadata, unknown
+     * schema) returns nothing rather than throwing: this gate exists to describe
+     * a change, not to become a second way for archive to fail on one. Whatever
+     * broke the load is already validation's to report.
+     */
+    private findMissingRequiredArtifacts;
     /**
      * Shared archive flow. In human mode (json=false) prompts and prose match
      * the historical behavior and cancellations return null. In JSON mode no

package/dist/core/archive.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"archive.d.ts","sourceRoot":"","sources":["../../src/core/archive.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAQxD;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,wBAAkB,CAAC;AAElD;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,CAYjF;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAoDD;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAe5E;AAgED,2FAA2F;AAC3F,wBAAsB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAYvE;AAED,qBAAa,cAAc;IACnB,OAAO,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoC9E;IAED,OAAO,CAAC,gBAAgB;IAiBxB;;;;;;;OAOG;YACW,IAAI;IA+BlB;;;;OAIG;YACW,GAAG;YA4YH,YAAY;CAwC3B"}
+{"version":3,"file":"archive.d.ts","sourceRoot":"","sources":["../../src/core/archive.ts"],"names":[],"mappings":"AAmBA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAQxD;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,wBAAkB,CAAC;AAElD;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,CAYjF;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AA2DD;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAe5E;AAgED,2FAA2F;AAC3F,wBAAsB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAYvE;AAED,qBAAa,cAAc;IACnB,OAAO,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAyC9E;IAED,OAAO,CAAC,gBAAgB;IAiBxB;;;;;;;OAOG;YACW,IAAI;IAoClB;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,4BAA4B;IAuBpC;;;;OAIG;YACW,GAAG;YAweH,YAAY;CAwC3B"}

package/dist/core/archive.js

@@ -5,11 +5,12 @@ import { Validator } from './validation/validator.js';
 import { validateChangeArtifacts } from '../commands/validate.js';
 import { isRootSelectionError, resolveRootForCommand, toRootOutput, } from './root-selection.js';
 import { findSpecUpdates, buildUpdatedSpec, writeUpdatedSpec, retireSpec, } from './specs-apply.js';
+import { loadChangeContext, formatChangeStatus } from './artifact-graph/index.js';
 import { formatTimestamp } from '../utils/timestamp.js';
 import { findSpecFiles } from '../utils/spec-files.js';
 import { FileSystemUtils, isMissingPathError } from '../utils/file-system.js';
 import { isKebabId, KEBAB_ID_DESCRIPTION } from './id.js';
-import { findTicketPath, listActiveChangeDirs } from '../utils/item-discovery.js';
+import { findTicketPaths, listActiveChangeDirs } from '../utils/item-discovery.js';
 import { METADATA_FILENAME, readChangeMetadata } from '../utils/change-metadata.js';
 import { emitSuccess, emitFailureStatus } from '../commands/shared-output.js';
 /**
@@ -169,7 +170,12 @@ export class ArchiveCommand {
         // Same root resolution adapter as every other command (report 4.3).
         const root = await resolveRootForCommand(options, {
             json,
-            failurePayload: { archive: null },
+            // See workflow/status.ts: an implicit root means no ancestor holds a
+            // `tospec/` dir, and archiving there can only fail — but with a plain
+            // "no changes directory" message rather than the shared no_tospec_root
+            // diagnostic its sibling commands report for the same condition.
+            allowImplicitRoot: false,
+            failurePayload: { archive: null, root: null },
         });
         if (!root) {
             return;
@@ -178,32 +184,32 @@ export class ArchiveCommand {
             // A gate overridden by --yes has something to report but did not fail —
             // exit 0 stands, and the warning rides on `status` instead of being
             // dropped, since prose on stdout would corrupt the JSON document.
-            const gateWarnings = [];
+            const jsonWarnings = [];
             try {
-                const result = await this.run(changeName, options, root, true, gateWarnings);
+                const result = await this.run(changeName, options, root, true, jsonWarnings);
                 if (!result) {
                     return;
                 }
-                emitSuccess({ archive: result, ...(gateWarnings.length ? { status: gateWarnings } : {}) }, toRootOutput(root));
+                emitSuccess({ archive: result, ...(jsonWarnings.length ? { status: jsonWarnings } : {}) }, toRootOutput(root));
             }
             catch (error) {
                 // The gates that were overridden before the failure still happened, and
                 // a run that both skipped validation *and* then failed is exactly when
                 // the reader needs to know. Dropping them here reproduced, on the
                 // failure path, the discard this collection exists to prevent.
-                this.printJsonFailure(root, toArchiveDiagnostic(error), gateWarnings);
+                this.printJsonFailure(root, toArchiveDiagnostic(error), jsonWarnings);
             }
             return;
         }
         await this.run(changeName, options, root, false, []);
     }
-    printJsonFailure(root, diagnostic, gateWarnings = []) {
+    printJsonFailure(root, diagnostic, jsonWarnings = []) {
         // emitFailureStatus appends the error to any `status` already in the
         // payload, so the warnings keep their order and precede the failure.
         emitFailureStatus({
             archive: null,
             ...(root ? { root: toRootOutput(root) } : {}),
-            ...(gateWarnings.length ? { status: gateWarnings } : {}),
+            ...(jsonWarnings.length ? { status: jsonWarnings } : {}),
         }, diagnostic);
     }
     /**
@@ -217,7 +223,12 @@ export class ArchiveCommand {
     async gate(opts) {
         if (opts.yes) {
             if (opts.json) {
-                opts.warnings.push({ severity: 'warning', code: opts.code, message: opts.message, fix: opts.fix });
+                // No `fix`. Every gate's fix is phrased for the caller who is being
+                // blocked and ends in "or rerun with --yes" — advice that read as
+                // nonsense in the output of a run that already passed `--yes`, telling
+                // the reader to do the thing they just did. The archive has happened;
+                // there is nothing left to act on, so the message stands alone.
+                opts.warnings.push({ severity: 'warning', code: opts.code, message: opts.message });
             }
             else {
                 console.error(opts.warning);
@@ -235,12 +246,42 @@ export class ArchiveCommand {
         }
         return true;
     }
+    /**
+     * Required artifacts the change never produced, in schema order.
+     *
+     * Reads the same graph `tospec status` does, so the two can never disagree
+     * about what "required" means. `skipped` covers the legitimate opt-out
+     * (`skip_specs: true`), and optional artifacts are the schema's own statement
+     * that their absence is fine — neither is reported here.
+     *
+     * A change whose graph cannot be loaded at all (unreadable metadata, unknown
+     * schema) returns nothing rather than throwing: this gate exists to describe
+     * a change, not to become a second way for archive to fail on one. Whatever
+     * broke the load is already validation's to report.
+     */
+    findMissingRequiredArtifacts(projectRoot, changeName, changeDir) {
+        try {
+            // Schema left undefined on purpose: loadChangeContext reads it from the
+            // change's own metadata, the same way `status` does.
+            const status = formatChangeStatus(loadChangeContext(projectRoot, changeName, undefined, { changeDir }));
+            return status.artifacts
+                .filter((artifact) => !artifact.optional && artifact.status !== 'done' && artifact.status !== 'skipped')
+                // A stub's file is on disk and still holds the template, so reporting it
+                // the same way as an absent one sent the reader to look for a file that
+                // was right there. The status is what distinguishes the two, and it is
+                // already in hand here.
+                .map((artifact) => (artifact.status === 'stub' ? `${artifact.id} (stub)` : artifact.id));
+        }
+        catch {
+            return [];
+        }
+    }
     /**
      * Shared archive flow. In human mode (json=false) prompts and prose match
      * the historical behavior and cancellations return null. In JSON mode no
      * prose reaches stdout and every blocked path throws.
      */
-    async run(changeName, options, root, json, gateWarnings) {
+    async run(changeName, options, root, json, jsonWarnings) {
         const changesDir = root.changesDir;
         const archiveDir = root.archiveDir;
         const mainSpecsDir = root.specsDir;
@@ -249,7 +290,7 @@ export class ArchiveCommand {
             await fs.access(changesDir);
         }
         catch {
-            throw new Error("No Tospec changes directory found. Run 'tospec init' first.");
+            throw new ArchiveBlockedError('changes_dir_missing', 'No Tospec changes directory found.', "Run 'tospec init' first.");
         }
         // Captured before the interactive branch can overwrite `changeName`: the
         // kebab guard below applies to the argument only, and provenance is the
@@ -323,11 +364,11 @@ export class ArchiveCommand {
                 syncReportContent = await fs.readFile(syncReportPath, 'utf-8');
             }
             catch {
-                throw new ArchiveBlockedError('SYNC_REPORT_MISSING', `sync-report.md not found for change '${changeName}'.`, 'Run tospec-sync first, or omit --require-sync.');
+                throw new ArchiveBlockedError('sync_report_missing', `sync-report.md not found for change '${changeName}'.`, 'Run tospec-sync first, or omit --require-sync.');
             }
             const conclusion = parseSyncReportConclusion(syncReportContent);
             if (conclusion !== 'PASS') {
-                throw new ArchiveBlockedError('SYNC_REPORT_FAILED', `sync-report.md for change '${changeName}' does not report a PASS conclusion (found: ${conclusion ?? 'unparseable'}).`, 'Resolve the flagged Requirement(s) via tospec-apply, then re-run tospec-sync.');
+                throw new ArchiveBlockedError('sync_report_failed', `sync-report.md for change '${changeName}' does not report a PASS conclusion (found: ${conclusion ?? 'unparseable'}).`, 'Resolve the flagged Requirement(s) via tospec-apply, then re-run tospec-sync.');
             }
         }
         const skipValidation = options.validate === false || options.noValidate === true;
@@ -376,11 +417,18 @@ export class ArchiveCommand {
                 json,
                 yes: !!options.yes,
                 code: 'archive_confirmation_required',
-                message: 'Skipping validation requires confirmation: rerun with --yes.',
+                // States the condition, not the remedy. A gate's `message` is reused
+                // verbatim when `--yes` overrides the gate, where "rerun with --yes"
+                // told the reader to do the thing they had just done — the same defect
+                // that removing `fix` from overridden gates was meant to end. The other
+                // two gates were already written this way ("N incomplete task(s) found"),
+                // which is why only this one carried it. Remedies belong in `fix`, which
+                // an overridden gate drops.
+                message: `Validation is disabled for change '${changeName}' (--no-validate).`,
                 fix: 'tospec archive <change-name> --json --no-validate --yes',
                 prompt: '⚠️  WARNING: Skipping validation may archive invalid specs. Continue? (y/N)',
                 warning: '\n⚠️  WARNING: Skipping validation may archive invalid specs.',
-                warnings: gateWarnings,
+                warnings: jsonWarnings,
             });
             if (!proceed)
                 return null;
@@ -390,6 +438,36 @@ export class ArchiveCommand {
                 console.error(`Affected files: ${changeDir}`);
             }
         }
+        // The artifact graph already knows which artifacts a schema requires, and
+        // `status` reports it as isComplete — but nothing consulted that before
+        // archiving, so a change carrying only a delta spec archived clean with no
+        // proposal and no design. Validation cannot catch it: it checks the content
+        // of files that exist, and these do not exist.
+        //
+        // Archive is the last moment this is recoverable. Afterwards the change is
+        // in archive/ and its deltas are merged, so the why and the how the schema
+        // asked for are gone for good — and the person who had the answers has
+        // moved on. Overridable like every other gate, because a schema artifact is
+        // a planning obligation rather than a correctness one.
+        const missingArtifacts = this.findMissingRequiredArtifacts(root.path, changeName, changeDir);
+        if (missingArtifacts.length > 0) {
+            const names = missingArtifacts.join(', ');
+            // "missing or incomplete", because the list holds both: an artifact with no
+            // file, and one whose file is still the unfilled template. Saying "missing"
+            // of the second sent the reader looking for a file already on disk.
+            const proceed = await this.gate({
+                json,
+                yes: !!options.yes,
+                code: 'archive_artifacts_incomplete',
+                message: `Change '${changeName}' is missing or has incomplete required artifact(s): ${names}.`,
+                fix: `Run tospec status --change ${changeName} for the next step, or rerun with --yes.`,
+                prompt: `Warning: missing or incomplete required artifact(s): ${names}. Continue?`,
+                warning: `Warning: missing or incomplete required artifact(s): ${names}. Continuing due to --yes flag.`,
+                warnings: jsonWarnings,
+            });
+            if (!proceed)
+                return null;
+        }
         // Show progress and check for incomplete tasks
         // Use the already-resolved root rather than re-deriving it from changesDir:
         // the '..','..' hop silently encodes the tospec/changes layout.
@@ -408,7 +486,7 @@ export class ArchiveCommand {
                 fix: 'Create the schema-tracked tasks file with checkboxes, or rerun with --yes.',
                 prompt: 'Warning: no tracked task checkboxes were found. Continue?',
                 warning: 'Warning: no tracked task checkboxes were found. Continuing due to --yes flag.',
-                warnings: gateWarnings,
+                warnings: jsonWarnings,
             });
             if (!proceed)
                 return null;
@@ -422,16 +500,39 @@ export class ArchiveCommand {
                 fix: 'Complete the tasks or rerun with --yes.',
                 prompt: `Warning: ${incompleteTasks} incomplete task(s) found. Continue?`,
                 warning: `Warning: ${incompleteTasks} incomplete task(s) found. Continuing due to --yes flag.`,
-                warnings: gateWarnings,
+                warnings: jsonWarnings,
             });
             if (!proceed)
                 return null;
         }
         // Handle spec updates unless skipSpecs flag is set
         let specsUpdated = false;
-        let totals;
+        let totals = { added: 0, modified: 0, removed: 0, renamed: 0, retired: 0 };
         if (options.skipSpecs) {
-            if (!json) {
+            // Round 4 report 2. `--skip-specs` is documented for changes that have no
+            // deltas, so pointing it at one that does is user error — but archiving in
+            // silence made the mistake unrecoverable: the change moved to archive/ and
+            // the capability never reached the main specs, with nothing in the output
+            // saying so. The metadata spelling of the same intent (`skip_specs: true`)
+            // is an ERROR under exactly this shape; this at least names what was left
+            // behind. It stays a warning rather than a block because the flag is an
+            // explicit instruction and `--yes` already means "I confirm".
+            const discarded = await findSpecUpdates(changeDir, mainSpecsDir);
+            if (discarded.length > 0) {
+                // source is <changeDir>/specs/<capability>/spec.md — the capability is
+                // the directory that names it, the same level findSpecUpdates walks.
+                const listed = discarded
+                    .map((update) => path.basename(path.dirname(update.source)))
+                    .join(', ');
+                const message = `--skip-specs discarded ${discarded.length} delta spec(s); these capabilities were not merged into the main specs: ${listed}.`;
+                if (json) {
+                    jsonWarnings.push({ severity: 'warning', code: 'archive_deltas_discarded', message });
+                }
+                else {
+                    console.log(`Warning: ${message}`);
+                }
+            }
+            else if (!json) {
                 console.log('Skipping spec updates (--skip-specs flag provided).');
             }
         }
@@ -482,6 +583,15 @@ export class ArchiveCommand {
                     try {
                         for (const update of specUpdates) {
                             const built = await buildUpdatedSpec(update, changeName, { silent: json });
+                            // In human mode buildUpdatedSpec already printed these. In JSON mode
+                            // it stayed silent, so `status[]` is where they have to land — a
+                            // dangling REMOVED used to be a completely invisible no-op for
+                            // agent callers.
+                            if (json) {
+                                for (const n of built.notices) {
+                                    jsonWarnings.push({ severity: 'warning', code: n.code, message: n.message });
+                                }
+                            }
                             prepared.push({ update, rebuilt: built.rebuilt, crlf: built.crlf, retired: built.retired, counts: built.counts });
                         }
                     }
@@ -559,7 +669,27 @@ export class ArchiveCommand {
         // The change's ticket lives in the global tospec/tickets/ index (outside the
         // change dir), so move it alongside into tickets/archive/ to keep the active
         // index limited to in-flight changes.
-        const ticketPath = await findTicketPath(root.path, changeName);
+        const ticketPaths = await findTicketPaths(root.path, changeName);
+        // Newest wins. A second ticket exists only because the change was recreated
+        // before this was fixed, so the later stamp is the one describing the change
+        // being archived — taking `readdir` order filed the run under the abandoned
+        // attempt's ticket and stranded the real one (round 4 report 6). Reported
+        // rather than cleaned up: the leftovers are the user's to keep or delete,
+        // and archive must not silently remove a record.
+        const ticketPath = ticketPaths[ticketPaths.length - 1];
+        if (ticketPaths.length > 1) {
+            const stranded = ticketPaths
+                .slice(0, -1)
+                .map((file) => path.basename(file))
+                .join(', ');
+            const message = `${ticketPaths.length} active tickets name change '${changeName}'; archived ${path.basename(ticketPath)} and left the rest in tospec/tickets/: ${stranded}.`;
+            if (json) {
+                jsonWarnings.push({ severity: 'warning', code: 'ticket_duplicates_left', message });
+            }
+            else {
+                console.log(`Warning: ${message}`);
+            }
+        }
         if (ticketPath) {
             const ticketArchiveDir = path.join(root.path, 'tospec', 'tickets', 'archive');
             await fs.mkdir(ticketArchiveDir, { recursive: true });
@@ -576,7 +706,7 @@ export class ArchiveCommand {
             archivedAs: archiveName,
             path: archivePath,
             specsUpdated,
-            ...(totals ? { totals } : {}),
+            totals,
         };
     }
     async selectChange(changesDir, projectRoot) {