@seanmars/tospec 0.19.0-beta.7 → 0.20.0

package/dist/commands/workflow/new-change.d.ts

@@ -1,9 +1,6 @@
 /**
- * New Change Command
- *
- * Creates a new change directory with optional description and schema in the
- * resolved Tospec root. Initiative linking and workspace affected areas are
- * no longer part of this command.
+ * `tospec new change` — creates a change directory with an optional description
+ * and schema in the resolved Tospec root.
  */
 export interface NewChangeOptions {
     description?: string;
@@ -15,5 +12,7 @@ export interface NewChangeOptions {
     areas?: string;
     json?: boolean;
 }
+/** The `--json` null-shape; shared by the commander table and both catch sites. */
+export declare const NEW_CHANGE_FAILURE_PAYLOAD: Record<string, unknown>;
 export declare function newChangeCommand(name: string | undefined, options: NewChangeOptions): Promise<void>;
 //# sourceMappingURL=new-change.d.ts.map

package/dist/commands/workflow/new-change.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"new-change.d.ts","sourceRoot":"","sources":["../../../src/commands/workflow/new-change.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAoBH,MAAM,WAAW,gBAAgB;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AA2DD,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoEzG"}
+{"version":3,"file":"new-change.d.ts","sourceRoot":"","sources":["../../../src/commands/workflow/new-change.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAiBH,MAAM,WAAW,gBAAgB;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oEAAoE;IACpE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAyFD,mFAAmF;AACnF,eAAO,MAAM,0BAA0B,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAgC,CAAC;AAEhG,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAmHzG"}

package/dist/commands/workflow/new-change.js

@@ -1,19 +1,14 @@
 /**
- * New Change Command
- *
- * Creates a new change directory with optional description and schema in the
- * resolved Tospec root. Initiative linking and workspace affected areas are
- * no longer part of this command.
+ * `tospec new change` — creates a change directory with an optional description
+ * and schema in the resolved Tospec root.
  */
 import path from 'path';
+import { existsSync } from 'fs';
 import { createChange, validateChangeName } from '../../utils/change-utils.js';
 import { formatChangeLocation } from '../../core/planning-home.js';
 import { resolveRootForCommand, RootSelectionError, toPlanningHome, toRootOutput, } from '../../core/root-selection.js';
-import { validateSchemaExists } from './shared.js';
+import { validateSchemaExists, assertChangeSchema } from './shared.js';
 import { emitSuccess, emitFailure } from '../shared-output.js';
-// -----------------------------------------------------------------------------
-// Command Implementation
-// -----------------------------------------------------------------------------
 function assertRemovedOptionsAbsent(options) {
     if (options.initiative !== undefined) {
         throw new RootSelectionError('--initiative is no longer supported. Tospec changes are always repo-local.', 'initiative_option_removed', { target: 'change.options' });
@@ -32,18 +27,68 @@ function parseDecisionsOption(value) {
         .filter(Boolean);
     return decisions.length > 0 ? { decisions } : undefined;
 }
+/**
+ * Refuses a `--decisions` entry that names no existing ADR. Checked at creation
+ * because nothing downstream does: validate ignores the field, and archive only
+ * follows it into the ticket's Related Decisions links, where a typo becomes a
+ * dead link.
+ */
+function assertDecisionsExist(projectRoot, decisions) {
+    const decisionsDir = path.join(projectRoot, 'tospec', 'decisions');
+    const missing = decisions.filter((file) => !existsSync(path.join(decisionsDir, file)));
+    if (missing.length === 0)
+        return;
+    throw new Error(`No such decision record(s) in tospec/decisions/: ${missing.join(', ')}. ` +
+        'Pass the filename as tospec decision new reported it, or run tospec decision list.');
+}
 function printCreatedChangeHuman(payload, root) {
-    // A relative path is only honest when the root is where the user
-    // stands; a distant ancestor root gets the absolute path.
-    const location = root.path === process.cwd()
+    // A relative path is only honest when the root is where the user stands.
+    // Forward slashes on every platform: the message is read as a POSIX-style
+    // project path, and mixing `\` with the trailing `/` looked like a typo.
+    const location = toPosixPath(root.path === process.cwd()
         ? formatChangeLocation(toPlanningHome(root), payload.change.id)
-        : payload.change.path;
+        : payload.change.path);
     console.log(`Created change '${payload.change.id}' at ${location}/`);
     console.log(`Schema: ${payload.change.schema}`);
+    // The CLI owns the ticket's timestamped filename, so this is the only place a
+    // human learns which file to open.
+    if (payload.change.ticketPath) {
+        console.log(`Ticket: ${toDisplayPath(root, payload.change.ticketPath)}`);
+    }
     console.log(`Next: ${`tospec status --change ${payload.change.id}`}`);
 }
+/** Root-relative while the user stands in the root; absolute otherwise. */
+function toDisplayPath(root, absolutePath) {
+    return toPosixPath(root.path === process.cwd() ? path.relative(root.path, absolutePath) : absolutePath);
+}
+function toPosixPath(p) {
+    return p.replace(/\\/g, '/');
+}
+/** The `--json` null-shape; shared by the commander table and both catch sites. */
+export const NEW_CHANGE_FAILURE_PAYLOAD = { change: null, root: null };
 export async function newChangeCommand(name, options) {
+    // Root resolution first: validating arguments before it makes a rejected name
+    // report `root: null`, while `list --type bogus` and `templates --schema
+    // nosuch` — argument failures of the same kind — both report the root.
+    let resolvedRoot = null;
+    const failurePayload = () => ({
+        change: null,
+        root: resolvedRoot ? toRootOutput(resolvedRoot) : null,
+    });
     try {
+        // Writes must not scaffold a tree: the implicit fallback would silently
+        // create `tospec/` in whatever directory the user happened to be in,
+        // while `list` and `status` refuse there. `tospec init` is the only
+        // command that creates a root.
+        resolvedRoot = await resolveRootForCommand(options, {
+            json: options.json,
+            allowImplicitRoot: false,
+            failurePayload: failurePayload(),
+        });
+        if (!resolvedRoot) {
+            return;
+        }
+        const root = resolvedRoot;
         if (!name) {
             throw new Error('Missing required argument <name>');
         }
@@ -52,17 +97,14 @@ export async function newChangeCommand(name, options) {
             throw new Error(validation.error);
         }
         assertRemovedOptionsAbsent(options);
-        const root = await resolveRootForCommand(options, {
-            json: options.json,
-            failurePayload: { change: null },
-        });
-        if (!root) {
-            return;
-        }
         const projectRoot = root.path;
-        // Validate schema if provided
         if (options.schema) {
             validateSchemaExists(options.schema, projectRoot);
+            assertChangeSchema(options.schema);
+        }
+        const parsedDecisions = parseDecisionsOption(options.decisions);
+        if (parsedDecisions) {
+            assertDecisionsExist(projectRoot, parsedDecisions.decisions);
         }
         const resolvedSchema = options.schema ?? root.defaultSchema;
         if (!options.json) {
@@ -72,11 +114,11 @@ export async function newChangeCommand(name, options) {
             schema: options.schema,
             defaultSchema: root.defaultSchema,
             changesDir: root.changesDir,
-            // --description fills the ticket stub's `## Summary` (see writeTicketStub).
+            // --description fills the ticket stub's `## Summary`.
             ...(options.description ? { description: options.description } : {}),
             metadata: {
                 ...(options.goal ? { goal: options.goal } : {}),
-                ...(parseDecisionsOption(options.decisions) ?? {}),
+                ...(parsedDecisions ?? {}),
             },
         });
         const payload = {
@@ -85,18 +127,41 @@ export async function newChangeCommand(name, options) {
                 path: result.changeDir,
                 metadataPath: path.join(result.changeDir, '.tospec.yaml'),
                 schema: result.schema,
+                // The CLI owns the ticket's timestamped filename, so reporting it is
+                // the only way a caller can open the stub it must fill in.
+                ...(result.ticketPath ? { ticketPath: result.ticketPath } : {}),
             },
             root: toRootOutput(root),
         };
+        // A `--description` that could not be applied is reported, never dropped.
+        const diagnostics = [];
+        if (result.ticketSummaryKept) {
+            diagnostics.push({
+                severity: 'warning',
+                code: 'ticket_summary_kept',
+                message: `--description was not applied: ticket ${path.basename(result.ticketPath ?? '')} already has a Summary. Edit it directly to change the summary.`,
+            });
+        }
+        if (result.ticketsUnsupported) {
+            // No ticket.md in the schema, and nothing else stores a one-line summary,
+            // so the text is gone; naming where it can live is all that remains.
+            diagnostics.push({
+                severity: 'warning',
+                code: 'ticket_unsupported',
+                message: `--description was not applied: schema '${result.schema}' ships no ticket.md, so this change has no ticket to summarize. Put the summary in the change's own artifact instead.`,
+            });
+        }
         if (options.json) {
-            emitSuccess({ change: payload.change }, payload.root);
+            emitSuccess({ change: payload.change, ...(diagnostics.length ? { status: diagnostics } : {}) }, payload.root);
             return;
         }
+        for (const diagnostic of diagnostics)
+            console.error(`Warning: ${diagnostic.message}`);
         printCreatedChangeHuman(payload, root);
     }
     catch (error) {
         if (options.json) {
-            emitFailure(true, { change: null }, error, 'change_error');
+            emitFailure(true, failurePayload(), error, 'change_error');
             return;
         }
         throw error;

package/dist/commands/workflow/new-change.js.map

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

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

@@ -1,8 +1,6 @@
-/**
- * Schemas Command
- *
- * Lists available workflow schemas with descriptions.
- */
+/** `tospec schemas` — the available workflow schemas, with descriptions. */
+/** The `--json` null-shape; shared by the commander table and the catch block. */
+export declare const SCHEMAS_FAILURE_PAYLOAD: Record<string, unknown>;
 export interface SchemasOptions {
     json?: boolean;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/commands/workflow/schemas.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAUH,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAMD,wBAAsB,cAAc,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CA+B3E"}
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/commands/workflow/schemas.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAM5E,kFAAkF;AAClF,eAAO,MAAM,uBAAuB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAG3D,CAAC;AAEF,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wBAAsB,cAAc,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CA2D3E"}

package/dist/commands/workflow/schemas.js

@@ -1,26 +1,39 @@
-/**
- * Schemas Command
- *
- * Lists available workflow schemas with descriptions.
- */
+/** `tospec schemas` — the available workflow schemas, with descriptions. */
 import { listSchemasWithInfo } from '../../core/artifact-graph/index.js';
 import { emitSuccess } from '../shared-output.js';
 import { resolveRootForCommand, toRootOutput } from '../../core/root-selection.js';
-// -----------------------------------------------------------------------------
-// Command Implementation
-// -----------------------------------------------------------------------------
+/** The `--json` null-shape; shared by the commander table and the catch block. */
+export const SCHEMAS_FAILURE_PAYLOAD = {
+    schemas: null,
+    root: null,
+};
 export async function schemasCommand(options) {
-    // Same root resolution as every other command (report 4.3).
     const root = await resolveRootForCommand(options, {
         json: options.json,
-        failurePayload: { schemas: null },
+        failurePayload: SCHEMAS_FAILURE_PAYLOAD,
     });
     if (!root) {
         return;
     }
     const schemas = listSchemasWithInfo(root.path);
+    // A schema that failed to load stays in the list carrying its reason rather
+    // than vanishing: the author most likely to hit this just wrote it, and an
+    // absent row answers none of their questions. Same rule `list` applies to an
+    // unreadable change — see
+    // tospec/decisions/20260917_234821-batch-commands-degrade-per-item.md.
+    const status = schemas
+        .filter((schema) => schema.error !== undefined)
+        .map((schema) => ({
+        severity: 'error',
+        code: 'schema_unreadable',
+        message: `Schema '${schema.name}' could not be loaded: ${schema.error}`,
+        target: schema.path,
+        fix: `Fix ${schema.name}'s schema.yaml, or remove the directory.`,
+    }));
     if (options.json) {
-        emitSuccess({ schemas }, toRootOutput(root));
+        emitSuccess({ schemas, ...(status.length ? { status } : {}) }, toRootOutput(root));
+        if (status.length)
+            process.exitCode = 1;
         return;
     }
     console.log('Available schemas:');
@@ -34,9 +47,22 @@ export async function schemasCommand(options) {
             sourceLabel = ' (user override)';
         }
         console.log(`  ${schema.name}${sourceLabel}`);
+        if (schema.error !== undefined) {
+            console.log(`    unreadable: ${schema.error}`);
+            console.log();
+            continue;
+        }
         console.log(`    ${schema.description}`);
         console.log(`    Artifacts: ${schema.artifacts.join(' → ')}`);
         console.log();
     }
+    if (status.length) {
+        for (const entry of status) {
+            console.error(`Error: ${entry.message}`);
+            if (entry.fix)
+                console.error(`Fix: ${entry.fix}`);
+        }
+        process.exitCode = 1;
+    }
 }
 //# sourceMappingURL=schemas.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../../src/commands/workflow/schemas.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAUnF,gFAAgF;AAChF,yBAAyB;AACzB,gFAAgF;AAEhF,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAAuB;IAC1D,4DAA4D;IAC5D,MAAM,IAAI,GAAG,MAAM,qBAAqB,CAAC,OAAO,EAAE;QAChD,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,cAAc,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE;KAClC,CAAC,CAAC;IACH,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO;IACT,CAAC;IACD,MAAM,OAAO,GAAG,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAE/C,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QACjB,WAAW,CAAC,EAAE,OAAO,EAAE,EAAE,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC;QAC7C,OAAO;IACT,CAAC;IAED,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;IAClC,OAAO,CAAC,GAAG,EAAE,CAAC;IAEd,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,WAAW,GAAG,EAAE,CAAC;QACrB,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAChC,WAAW,GAAG,YAAY,CAAC;QAC7B,CAAC;aAAM,IAAI,MAAM,CAAC,MAAM,KAAK,MAAM,EAAE,CAAC;YACpC,WAAW,GAAG,kBAAkB,CAAC;QACnC,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC,IAAI,GAAG,WAAW,EAAE,CAAC,CAAC;QAC9C,OAAO,CAAC,GAAG,CAAC,OAAO,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;QACzC,OAAO,CAAC,GAAG,CAAC,kBAAkB,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC9D,OAAO,CAAC,GAAG,EAAE,CAAC;IAChB,CAAC;AACH,CAAC"}
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../../src/commands/workflow/schemas.ts"],"names":[],"mappings":"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"}

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

@@ -1,9 +1,7 @@
-/**
- * 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 { DEFAULT_SCHEMA } from '../../core/schema-names.js';
+import type { ArtifactStatusValue } from '../../core/change-status-policy.js';
+import type { ProjectConfigDiagnostic } from '../../core/project-config.js';
 export interface ChangeCommandStatus {
     severity: 'error' | 'warning';
     code: string;
@@ -12,7 +10,12 @@ export interface ChangeCommandStatus {
     fix?: string;
 }
 export interface TaskItem {
+    /**
+     * The task's own number from the file ("1.2"), not its position in the list;
+     * the ordinal only when the file numbers nothing.
+     */
     id: string;
+    /** The task text with that number stripped — `id` + `description` is the line. */
     description: string;
     done: boolean;
 }
@@ -28,31 +31,55 @@ export interface ApplyInstructions {
     };
     tasks: TaskItem[];
     state: 'blocked' | 'all_done' | 'ready';
+    /** Artifacts `apply.requires` insists on that do not exist; these block. */
     missingArtifacts?: string[];
+    /**
+     * Schema artifacts absent from the change that `apply.requires` does not
+     * insist on. The state stays `ready`, but the instruction may refer to them,
+     * so the caller is told which references have no file behind them.
+     */
+    missingContext?: string[];
     instruction: string;
+    /**
+     * Project context from `tospec/config.yaml`, as every artifact's instructions
+     * carry it. The apply skill makes a single `tospec instructions apply` call
+     * and treats it as the whole briefing, so what is missing here is missing for
+     * good.
+     */
+    context?: string;
+    /** Rules configured under the `apply` key of `rules:`, if any. */
+    rules?: string[];
+    /**
+     * Problems with the project's config, in the same shape the artifact
+     * instructions report them.
+     */
+    configWarnings?: ProjectConfigDiagnostic[];
 }
-export declare const DEFAULT_SCHEMA = "sdd";
-/**
- * Gets the status indicator for an artifact.
- */
-export declare function getStatusIndicator(status: 'done' | 'ready' | 'blocked' | 'skipped' | 'stub'): string;
-/**
- * Returns the list of available change directory names under tospec/changes/.
- * Excludes the archive directory and hidden directories.
- */
+export { DEFAULT_SCHEMA };
+export declare function getStatusIndicator(status: ArtifactStatusValue): string;
+/** Change directory names under `tospec/changes/`, minus `archive` and dotdirs. */
 export declare function getAvailableChanges(projectRoot: string, changesDir?: string): Promise<string[]>;
 /**
- * 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 declare function validateChangeExists(changeName: string | undefined, projectRoot: string, changesDir?: string, hints?: {
     newChangeHint?: string;
 }): Promise<string>;
 /**
- * Validates that a schema exists and returns available schemas if not.
- *
- * @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 declare function validateSchemaExists(schemaName: string, projectRoot?: string): string;
+/**
+ * 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.
+ *
+ * `templates --schema decision` does not call this — listing that schema's
+ * templates is what `decision new` itself needs.
+ */
+export declare function assertChangeSchema(schemaName: string): void;
 //# sourceMappingURL=shared.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../src/commands/workflow/shared.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAWH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACvC,QAAQ,EAAE;QACR,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,KAAK,EAAE,SAAS,GAAG,UAAU,GAAG,OAAO,CAAC;IACxC,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;CACrB;AAMD,eAAO,MAAM,cAAc,QAAQ,CAAC;AAMpC;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,CAapG;AAED;;;GAGG;AACH,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,EACnB,UAAU,SAA8C,GACvD,OAAO,CAAC,MAAM,EAAE,CAAC,CAWnB;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,WAAW,EAAE,MAAM,EACnB,UAAU,SAA8C,EACxD,KAAK,GAAE;IAAE,aAAa,CAAC,EAAE,MAAM,CAAA;CAAO,GACrC,OAAO,CAAC,MAAM,CAAC,CAsCjB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CASrF"}
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../../src/commands/workflow/shared.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAM/E,OAAO,EAAwB,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAClF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAC9E,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAE5E,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,QAAQ;IACvB;;;OAGG;IACH,EAAE,EAAE,MAAM,CAAC;IACX,kFAAkF;IAClF,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACvC,QAAQ,EAAE;QACR,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,KAAK,EAAE,SAAS,GAAG,UAAU,GAAG,OAAO,CAAC;IACxC,4EAA4E;IAC5E,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kEAAkE;IAClE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB;;;OAGG;IACH,cAAc,CAAC,EAAE,uBAAuB,EAAE,CAAC;CAC5C;AAID,OAAO,EAAE,cAAc,EAAE,CAAC;AAE1B,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM,CAgBtE;AAED,mFAAmF;AACnF,wBAAsB,mBAAmB,CACvC,WAAW,EAAE,MAAM,EACnB,UAAU,SAA8C,GACvD,OAAO,CAAC,MAAM,EAAE,CAAC,CAUnB;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,WAAW,EAAE,MAAM,EACnB,UAAU,SAA8C,EACxD,KAAK,GAAE;IAAE,aAAa,CAAC,EAAE,MAAM,CAAA;CAAO,GACrC,OAAO,CAAC,MAAM,CAAC,CAqCjB;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAWrF;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAO3D"}

package/dist/commands/workflow/shared.js

@@ -1,23 +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, listSchemas } from '../../core/artifact-graph/index.js';
+import { getSchemaDir, listLoadableSchemas, resolveSchema } from '../../core/artifact-graph/index.js';
 import { validateChangeName } from '../../utils/change-utils.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':
@@ -26,20 +15,19 @@ export function getStatusIndicator(status) {
             return '[ ]';
         case 'blocked':
             return '[-]';
+        // 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 '[~]';
         case 'stub':
             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);
@@ -51,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) {
@@ -65,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) {
@@ -83,17 +71,32 @@ export async function validateChangeExists(changeName, projectRoot, changesDir =
     return changeName;
 }
 /**
- * Validates that a schema exists and returns available schemas if not.
- *
- * @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) {
-        const availableSchemas = listSchemas(projectRoot);
+        // 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  ')}`);
     }
+    resolveSchema(schemaName, projectRoot);
     return schemaName;
 }
+/**
+ * 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.
+ *
+ * `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) {
+        throw new Error(`Schema '${DECISION_SCHEMA_NAME}' records an architecture decision, not a change. ` +
+            'Use: tospec decision new <topic>');
+    }
+}
 //# sourceMappingURL=shared.js.map

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,9 +9,17 @@ 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`, 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>;
 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,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"}