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

package/dist/utils/change-utils.js

@@ -1,10 +1,12 @@
 import path from 'path';
+import { promises as fsPromises } from 'fs';
 import { FileSystemUtils } from './file-system.js';
 import { formatTimestamp, formatLocalDate } from './timestamp.js';
 import { writeChangeMetadata, validateSchemaName } from './change-metadata.js';
 import { readProjectConfig, resolveConfigFileInDir } from '../core/project-config.js';
 import { isKebabId } from '../core/id.js';
 import { resolveSchema, loadTemplate } from '../core/artifact-graph/index.js';
+import { findTicketPath } from './item-discovery.js';
 const DEFAULT_SCHEMA = 'sdd';
 // sdd → requirement, issue → issue; custom schemas leave type unset.
 const SCHEMA_TO_CHANGE_TYPE = {
@@ -24,7 +26,8 @@ const SCHEMA_TO_CHANGE_TYPE = {
  * A leading digit is allowed so ordering conventions like `100-add-feature` or
  * `00001-add-auth` work.
  *
- * @param name - The change name to validate
+ * @param name - The kebab-case identifier to validate
+ * @param noun - The user-facing name for the identifier in validation errors
  * @returns Validation result with `valid: true` or `valid: false` with an error message
  *
  * @example
@@ -32,34 +35,59 @@ const SCHEMA_TO_CHANGE_TYPE = {
  * validateChangeName('100-add-feature') // { valid: true }
  * validateChangeName('Add-Auth') // { valid: false, error: '...' }
  */
-export function validateChangeName(name) {
+/**
+ * Upper bound on a change name, in characters.
+ *
+ * Deliberately generous: a kebab-case summary of a change runs well under this,
+ * so the limit only catches input that was never a name. See the check in
+ * `validateChangeName` for why it exists at all.
+ */
+export const MAX_CHANGE_NAME_LENGTH = 100;
+export function validateChangeName(name, noun = 'Change name') {
     if (!name) {
-        return { valid: false, error: 'Change name cannot be empty' };
+        return { valid: false, error: `${noun} cannot be empty` };
     }
     if (!isKebabId(name)) {
         // Provide specific error messages for common mistakes
         if (/[A-Z]/.test(name)) {
-            return { valid: false, error: 'Change name must be lowercase (use kebab-case)' };
+            return { valid: false, error: `${noun} must be lowercase (use kebab-case)` };
         }
         if (/\s/.test(name)) {
-            return { valid: false, error: 'Change name cannot contain spaces (use hyphens instead)' };
+            return { valid: false, error: `${noun} cannot contain spaces (use hyphens instead)` };
         }
         if (/_/.test(name)) {
-            return { valid: false, error: 'Change name cannot contain underscores (use hyphens instead)' };
+            return { valid: false, error: `${noun} cannot contain underscores (use hyphens instead)` };
         }
         if (name.startsWith('-')) {
-            return { valid: false, error: 'Change name cannot start with a hyphen' };
+            return { valid: false, error: `${noun} cannot start with a hyphen` };
         }
         if (name.endsWith('-')) {
-            return { valid: false, error: 'Change name cannot end with a hyphen' };
+            return { valid: false, error: `${noun} cannot end with a hyphen` };
         }
         if (/--/.test(name)) {
-            return { valid: false, error: 'Change name cannot contain consecutive hyphens' };
+            return { valid: false, error: `${noun} cannot contain consecutive hyphens` };
         }
         if (/[^a-z0-9-]/.test(name)) {
-            return { valid: false, error: 'Change name can only contain lowercase letters, numbers, and hyphens' };
+            return { valid: false, error: `${noun} can only contain lowercase letters, numbers, and hyphens` };
         }
-        return { valid: false, error: 'Change name must follow kebab-case convention (e.g., add-auth, refactor-db)' };
+        return { valid: false, error: `${noun} must follow kebab-case convention (e.g., add-auth, refactor-db)` };
+    }
+    // Checked last so a malformed name still gets the specific message above.
+    //
+    // The name becomes a directory under tospec/changes/ and, on archive, the
+    // longer `<yyyyMMdd_HHmmss>-<name>` under tospec/changes/archive/ — about 38
+    // characters of path before the name itself. Without a limit the overflow
+    // surfaced as a raw ENOENT from whichever write happened to cross the
+    // platform's path limit first, after the change directory was already on disk.
+    // No cap can guarantee the write succeeds (the project root's own length is
+    // unknown here), so this is a legibility bound, not a correctness one: it
+    // rejects the names that cannot plausibly be intended, with a message that
+    // names the problem.
+    if (name.length > MAX_CHANGE_NAME_LENGTH) {
+        return {
+            valid: false,
+            error: `${noun} is ${name.length} characters; the maximum is ${MAX_CHANGE_NAME_LENGTH}`,
+        };
     }
     return { valid: true };
 }
@@ -85,6 +113,30 @@ export function validateChangeName(name) {
  * const result = await createChange('/path/to/project', 'add-auth', { schema: 'my-workflow' })
  * console.log(result.schema) // 'my-workflow'
  */
+/**
+ * Bring a tospec root up to the full layout every command expects.
+ *
+ * Any command that writes into `tospec/` may be the one that creates it — from
+ * an implicit root, or a config-only clone. A command that creates only the one
+ * subdirectory it needs leaves a half-root: the directory then resolves as a
+ * project for every other command, so `validate --all` and `status --all` start
+ * answering "0 items, all fine" about somewhere that was never a project. That
+ * vacuous pass is the reason those commands refuse an implicit root in the first
+ * place, so creating one by halves hands it back through the side door.
+ *
+ * Shared rather than inlined because `new change` and `decision new` are both
+ * such commands, and only one of them used to do this.
+ */
+export async function completeRootStructure(projectRoot, defaultSchema) {
+    const tospecDir = path.join(projectRoot, 'tospec');
+    await FileSystemUtils.createDirectory(path.join(tospecDir, 'specs'));
+    await FileSystemUtils.createDirectory(path.join(tospecDir, 'changes', 'archive'));
+    // The config records the PROJECT default schema, never a one-off override,
+    // and is written only when none exists.
+    if (!resolveConfigFileInDir(tospecDir)) {
+        await FileSystemUtils.writeFile(path.join(tospecDir, 'config.yaml'), `schema: ${defaultSchema}\n`);
+    }
+}
 export async function createChange(projectRoot, name, options = {}) {
     // Validate the name first
     const validation = validateChangeName(name);
@@ -116,32 +168,49 @@ export async function createChange(projectRoot, name, options = {}) {
     if (await FileSystemUtils.directoryExists(changeDir)) {
         throw new Error(`Change '${name}' already exists at ${changeDir}`);
     }
-    // Creating a change may scaffold or complete the root itself (an
-    // implicit root, or a config-only/incomplete clone). Never leave a
-    // half-root behind that doctor immediately calls unhealthy: ensure
-    // specs/ and changes/archive/ exist, and write a config only when
-    // none exists. The config records the PROJECT default schema, never
-    // a one-change --schema override.
-    const tospecDir = path.join(projectRoot, 'tospec');
     // Create the directory (including parent directories if needed)
     await FileSystemUtils.createDirectory(changeDir);
-    await FileSystemUtils.createDirectory(path.join(tospecDir, 'specs'));
-    await FileSystemUtils.createDirectory(path.join(tospecDir, 'changes', 'archive'));
-    if (!resolveConfigFileInDir(tospecDir)) {
-        await FileSystemUtils.writeFile(path.join(tospecDir, 'config.yaml'), `schema: ${defaultSchema}\n`);
+    // Everything after the change directory exists is rolled back on failure.
+    //
+    // Creation is several writes — metadata, then the ticket stub in a different
+    // tree — and a failure partway through used to leave the change directory
+    // behind with no ticket. `list`, `status --all` and `validate --all` then
+    // treated that debris as a real change, so a command that reported failure
+    // had in fact added something the project had to be cleaned of by hand.
+    //
+    // Only the change directory is removed. The sibling scaffolding below
+    // (specs/, changes/archive/, config.yaml) completes the root itself and stays
+    // valid for every other change, so undoing it would turn one change's failure
+    // into damage to the project.
+    try {
+        // Creating a change may scaffold or complete the root itself; never leave
+        // a half-root behind that doctor immediately calls unhealthy.
+        await completeRootStructure(projectRoot, defaultSchema);
+        // Write metadata file with schema and creation date
+        const today = formatLocalDate();
+        writeChangeMetadata(changeDir, {
+            schema: schemaName,
+            type: SCHEMA_TO_CHANGE_TYPE[schemaName],
+            created: today,
+            ...options.metadata,
+        }, projectRoot);
+        // Generate the ticket stub. The timestamped filename (and its `date` header)
+        // are CLI-generated — agents can't reliably reproduce the timestamp.
+        //
+        // The path comes back so the caller can report it. Nothing else can work it
+        // out: the stamp is generated in here and never written anywhere an agent
+        // reads, so filling in the ticket's Summary meant globbing a directory for a
+        // filename the CLI had just chosen and thrown away.
+        const ticketPath = await writeTicketStub(projectRoot, name, schemaName, options.description);
+        return { schema: schemaName, changeDir, ...(ticketPath ? { ticketPath } : {}) };
+    }
+    catch (error) {
+        // Best effort: report the original failure, not a cleanup failure. If the
+        // rollback itself cannot run, the caller still needs to see what actually
+        // went wrong.
+        await fsPromises.rm(changeDir, { recursive: true, force: true }).catch(() => { });
+        throw error;
     }
-    // Write metadata file with schema and creation date
-    const today = formatLocalDate();
-    writeChangeMetadata(changeDir, {
-        schema: schemaName,
-        type: SCHEMA_TO_CHANGE_TYPE[schemaName],
-        created: today,
-        ...options.metadata,
-    }, projectRoot);
-    // Generate the ticket stub. The timestamped filename (and its `date` header)
-    // are CLI-generated — agents can't reliably reproduce the timestamp.
-    await writeTicketStub(projectRoot, name, schemaName, options.description);
-    return { schema: schemaName, changeDir };
 }
 /**
  * Writes a ticket stub into the global `tospec/tickets/<yyyyMMdd_HHmmss>-<name>.md`
@@ -158,7 +227,7 @@ async function writeTicketStub(projectRoot, name, schemaName, description) {
         schema = resolveSchema(schemaName, projectRoot);
     }
     catch {
-        return; // schema unresolvable — nothing to scaffold
+        return undefined; // schema unresolvable — nothing to scaffold
     }
     // A schema opts into the global ticket index by shipping a ticket.md template.
     let body;
@@ -166,7 +235,7 @@ async function writeTicketStub(projectRoot, name, schemaName, description) {
         body = loadTemplate(schemaName, 'ticket.md', projectRoot);
     }
     catch {
-        return; // no ticket template — this schema doesn't use tickets
+        return undefined; // no ticket template — this schema doesn't use tickets
     }
     // Fill the `## Summary` placeholder with the provided description; a function
     // replacer keeps `$`-sequences in the text literal. No description → the
@@ -175,6 +244,17 @@ async function writeTicketStub(projectRoot, name, schemaName, description) {
     if (summary) {
         body = body.replace(/(##[ \t]*Summary[ \t]*\r?\n)\[[^\]]*\]/, (_m, head) => head + summary);
     }
+    // Round 4 report 6. The ledger is meant to hold one active ticket per change,
+    // but nothing checked: abandoning a change with `rm -rf` leaves its ticket
+    // behind, and recreating the change under the same name wrote a second. Both
+    // then pointed at the same proposal, archive filed the run under the older
+    // one, and the newer stayed in the active list forever naming a path that no
+    // longer exists — with no command able to remove it. Reusing the existing
+    // ticket keeps the index 1:1; its stamp is from the earlier attempt, which is
+    // the honest record of when this change name was first opened.
+    const existing = await findTicketPath(projectRoot, name);
+    if (existing)
+        return existing;
     const stamp = formatTimestamp(new Date());
     const ticketPath = path.join(projectRoot, 'tospec', 'tickets', `${stamp}-${name}.md`);
     // ref points at where the change's details live: proposal.md (sdd) or task.md,
@@ -184,8 +264,18 @@ async function writeTicketStub(projectRoot, name, schemaName, description) {
     const ref = hasProposal ? `tospec/changes/${name}/proposal.md` : `tospec/changes/${name}/task.md`;
     // date is quoted so yaml keeps it a string (bare yyyyMMdd_HHmmss would parse
     // as an underscore-separated integer under yaml 1.1).
-    const header = `---\ntitle: ${name}\ndate: "${stamp}"\ntype: ${schemaName}\nchange: ${name}\nref: ${ref}\n---\n\n`;
+    //
+    // `type` carries the change type, the same vocabulary as .tospec.yaml and
+    // `list --json` (requirement | issue). It used to carry the schema name, so
+    // one key meant two different things across two files of the same change —
+    // invisible for an issue change, where the two words coincide, and wrong for
+    // every sdd one. The dashboard had already absorbed the split as a CSS rule
+    // matching `.badge-requirement, .badge-sdd`. The schema name is still worth
+    // recording, so it gets its own key rather than borrowing this one.
+    const changeType = SCHEMA_TO_CHANGE_TYPE[schemaName] ?? schemaName;
+    const header = `---\ntitle: ${name}\ndate: "${stamp}"\ntype: ${changeType}\nschema: ${schemaName}\nchange: ${name}\nref: ${ref}\n---\n\n`;
     await FileSystemUtils.createDirectory(path.join(projectRoot, 'tospec', 'tickets'));
     await FileSystemUtils.writeFile(ticketPath, header + body);
+    return ticketPath;
 }
 //# sourceMappingURL=change-utils.js.map

package/dist/utils/change-utils.js.map

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

package/dist/utils/file-system.d.ts

@@ -4,7 +4,7 @@
  *
  * Shared by `tospec list --sort recent` and the dashboard so both rank changes
  * by the same clock; they used to walk separately and could disagree.
- * ponytail: recursive walk; fine at repo scale (dozens of changes).
+ * Limitation: recursive walk; fine at repo scale (dozens of changes).
  */
 export declare function getLastModified(dirPath: string): Promise<Date>;
 /**

package/dist/utils/file-system.js

@@ -7,7 +7,7 @@ const fs = nodeFs.promises;
  *
  * Shared by `tospec list --sort recent` and the dashboard so both rank changes
  * by the same clock; they used to walk separately and could disagree.
- * ponytail: recursive walk; fine at repo scale (dozens of changes).
+ * Limitation: recursive walk; fine at repo scale (dozens of changes).
  */
 export async function getLastModified(dirPath) {
     let latest = null;

package/dist/utils/item-discovery.d.ts

@@ -1,12 +1,27 @@
 /**
- * Finds a change's ticket in the global `tospec/tickets/` index by matching the
- * ticket frontmatter's `change:` field. Scans only the active folder
- * (non-recursive), so archived tickets under `tickets/archive/` are excluded.
- * Returns the absolute path, or undefined if none matches.
+ * Every ticket in the active `tospec/tickets/` index whose frontmatter `change:`
+ * names this change, sorted by filename — which is the `yyyyMMdd_HHmmss` stamp,
+ * so oldest first. Scans only the active folder (non-recursive), so archived
+ * tickets under `tickets/archive/` are excluded.
  *
- * ponytail: linear scan of tickets/; fine at repo scale (one ticket per change).
+ * Plural because the index can hold more than one: a change abandoned with
+ * `rm -rf` leaves its ticket behind, and recreating the change under the same
+ * name used to add a second (round 4 report 6). Callers that can report the
+ * ambiguity should; `findTicketPath` picks for those that cannot.
+ *
+ * Limitation: linear scan of tickets/; fine at repo scale (one ticket per change).
  * Add an index if a project ever accumulates thousands of active changes.
  */
+export declare function findTicketPaths(root: string, changeName: string): Promise<string[]>;
+/**
+ * The ticket to treat as this change's, when there is more than one.
+ *
+ * The newest wins: a second ticket exists because the change was recreated, so
+ * the later stamp is the one that describes the change on disk. Taking the
+ * first `readdir` entry instead meant archive filed the run under a ticket
+ * belonging to the abandoned attempt and left the real one stranded in the
+ * active list forever (round 4 report 6).
+ */
 export declare function findTicketPath(root: string, changeName: string): Promise<string | undefined>;
 /**
  * Active change directory names under `changesDir`, sorted, excluding `archive`

package/dist/utils/item-discovery.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"item-discovery.d.ts","sourceRoot":"","sources":["../../src/utils/item-discovery.ts"],"names":[],"mappings":"AAIA;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAmBlG;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAUhF;AAED,wBAAsB,kBAAkB,CAAC,IAAI,GAAE,MAAsB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAExF;AAED,wBAAsB,UAAU,CAAC,IAAI,GAAE,MAAsB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAmBhF;AAED,wBAAsB,oBAAoB,CAAC,IAAI,GAAE,MAAsB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAW1F"}
+{"version":3,"file":"item-discovery.d.ts","sourceRoot":"","sources":["../../src/utils/item-discovery.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;GAaG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAoBzF;AAED;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAGlG;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAUhF;AAED,wBAAsB,kBAAkB,CAAC,IAAI,GAAE,MAAsB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAExF;AAED,wBAAsB,UAAU,CAAC,IAAI,GAAE,MAAsB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAmBhF;AAED,wBAAsB,oBAAoB,CAAC,IAAI,GAAE,MAAsB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAW1F"}

package/dist/utils/item-discovery.js

@@ -2,23 +2,29 @@ import { promises as fs } from 'fs';
 import path from 'path';
 import { frontmatterString } from './frontmatter.js';
 /**
- * Finds a change's ticket in the global `tospec/tickets/` index by matching the
- * ticket frontmatter's `change:` field. Scans only the active folder
- * (non-recursive), so archived tickets under `tickets/archive/` are excluded.
- * Returns the absolute path, or undefined if none matches.
+ * Every ticket in the active `tospec/tickets/` index whose frontmatter `change:`
+ * names this change, sorted by filename — which is the `yyyyMMdd_HHmmss` stamp,
+ * so oldest first. Scans only the active folder (non-recursive), so archived
+ * tickets under `tickets/archive/` are excluded.
  *
- * ponytail: linear scan of tickets/; fine at repo scale (one ticket per change).
+ * Plural because the index can hold more than one: a change abandoned with
+ * `rm -rf` leaves its ticket behind, and recreating the change under the same
+ * name used to add a second (round 4 report 6). Callers that can report the
+ * ambiguity should; `findTicketPath` picks for those that cannot.
+ *
+ * Limitation: linear scan of tickets/; fine at repo scale (one ticket per change).
  * Add an index if a project ever accumulates thousands of active changes.
  */
-export async function findTicketPath(root, changeName) {
+export async function findTicketPaths(root, changeName) {
     const ticketsPath = path.join(root, 'tospec', 'tickets');
     let entries;
     try {
         entries = await fs.readdir(ticketsPath, { withFileTypes: true });
     }
     catch {
-        return undefined;
+        return [];
     }
+    const matches = [];
     for (const entry of entries) {
         if (!entry.isFile() || !entry.name.endsWith('.md'))
             continue;
@@ -26,13 +32,26 @@ export async function findTicketPath(root, changeName) {
         try {
             const content = await fs.readFile(full, 'utf-8');
             if (frontmatterString(content, 'change') === changeName)
-                return full;
+                matches.push(full);
         }
         catch {
             continue;
         }
     }
-    return undefined;
+    return matches.sort((a, b) => path.basename(a).localeCompare(path.basename(b)));
+}
+/**
+ * The ticket to treat as this change's, when there is more than one.
+ *
+ * The newest wins: a second ticket exists because the change was recreated, so
+ * the later stamp is the one that describes the change on disk. Taking the
+ * first `readdir` entry instead meant archive filed the run under a ticket
+ * belonging to the abandoned attempt and left the real one stranded in the
+ * active list forever (round 4 report 6).
+ */
+export async function findTicketPath(root, changeName) {
+    const matches = await findTicketPaths(root, changeName);
+    return matches.length === 0 ? undefined : matches[matches.length - 1];
 }
 /**
  * Active change directory names under `changesDir`, sorted, excluding `archive`

package/dist/utils/item-discovery.js.map

@@ -1 +1 @@
-{"version":3,"file":"item-discovery.js","sourceRoot":"","sources":["../../src/utils/item-discovery.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"item-discovery.js","sourceRoot":"","sources":["../../src/utils/item-discovery.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,IAAI,CAAC;AACpC,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAY,EAAE,UAAkB;IACpE,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;IACzD,IAAI,OAAO,CAAC;IACZ,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IACnE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,SAAS;QAC7D,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAChD,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YACjD,IAAI,iBAAiB,CAAC,OAAO,EAAE,QAAQ,CAAC,KAAK,UAAU;gBAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9E,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAClF,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAY,EAAE,UAAkB;IACnE,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACxD,OAAO,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACxE,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,UAAkB;IAC3D,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QACtE,OAAO,OAAO;aACX,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC;aACjG,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC;aAC1B,IAAI,EAAE,CAAC;IACZ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,IAAI,GAAW,OAAO,CAAC,GAAG,EAAE;IACnE,OAAO,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC,CAAC;AACpE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAI,GAAW,OAAO,CAAC,GAAG,EAAE;IAC3D,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IACrD,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QACrE,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,IAAI,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;gBAAE,SAAS;YACjE,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;YAC7D,IAAI,CAAC;gBACH,MAAM,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;gBAC1B,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC1B,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS;YACX,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,SAAS;IACX,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;AACvB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,IAAI,GAAW,OAAO,CAAC,GAAG,EAAE;IACrE,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;IACpE,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QACvE,OAAO,OAAO;aACX,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;aACrE,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC;aAC1B,IAAI,EAAE,CAAC;IACZ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/utils/spec-files.d.ts

@@ -16,4 +16,16 @@
  * differently on CI than locally).
  */
 export declare function findSpecFiles(specsDir: string): Promise<string[]>;
+/**
+ * Every `*.md` under a change's `specs/` directory, at any depth — unlike
+ * {@link findSpecFiles}, basename is not filtered.
+ *
+ * Exists so the validator can see the same misplacement class it already
+ * catches (wrong depth, dot-directory) when the mistake is a wrong *basename*
+ * instead: `specs/<capability>/spec.md`'s wrong-basename sibling is invisible
+ * to `findSpecFiles`, which drops it before any guard loop runs. The merge
+ * path (`findSpecUpdates`) must keep reading only `spec.md` — this walker is
+ * for validation to report the file, not for merge to read it.
+ */
+export declare function findAllMarkdownFiles(specsDir: string): Promise<string[]>;
 //# sourceMappingURL=spec-files.d.ts.map

package/dist/utils/spec-files.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"spec-files.d.ts","sourceRoot":"","sources":["../../src/utils/spec-files.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAuBvE"}
+{"version":3,"file":"spec-files.d.ts","sourceRoot":"","sources":["../../src/utils/spec-files.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAuBvE;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAsB9E"}

package/dist/utils/spec-files.js

@@ -41,4 +41,38 @@ export async function findSpecFiles(specsDir) {
     await walk(specsDir);
     return results.sort();
 }
+/**
+ * Every `*.md` under a change's `specs/` directory, at any depth — unlike
+ * {@link findSpecFiles}, basename is not filtered.
+ *
+ * Exists so the validator can see the same misplacement class it already
+ * catches (wrong depth, dot-directory) when the mistake is a wrong *basename*
+ * instead: `specs/<capability>/spec.md`'s wrong-basename sibling is invisible
+ * to `findSpecFiles`, which drops it before any guard loop runs. The merge
+ * path (`findSpecUpdates`) must keep reading only `spec.md` — this walker is
+ * for validation to report the file, not for merge to read it.
+ */
+export async function findAllMarkdownFiles(specsDir) {
+    const results = [];
+    const walk = async (dir) => {
+        let entries;
+        try {
+            entries = await fs.readdir(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const entry of entries) {
+            const full = path.join(dir, entry.name);
+            if (entry.isDirectory()) {
+                await walk(full);
+            }
+            else if (entry.isFile() && entry.name.toLowerCase().endsWith('.md')) {
+                results.push(full);
+            }
+        }
+    };
+    await walk(specsDir);
+    return results.sort();
+}
 //# sourceMappingURL=spec-files.js.map

package/dist/utils/spec-files.js.map

@@ -1 +1 @@
-{"version":3,"file":"spec-files.js","sourceRoot":"","sources":["../../src/utils/spec-files.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,QAAgB;IAClD,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,MAAM,IAAI,GAAG,KAAK,EAAE,GAAW,EAAiB,EAAE;QAChD,IAAI,OAAO,CAAC;QACZ,IAAI,CAAC;YACH,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3D,CAAC;QAAC,MAAM,CAAC;YACP,yEAAyE;YACzE,OAAO;QACT,CAAC;QACD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YACxC,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxB,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC;YACnB,CAAC;iBAAM,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;gBACtD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACrB,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC;IACrB,OAAO,OAAO,CAAC,IAAI,EAAE,CAAC;AACxB,CAAC"}
+{"version":3,"file":"spec-files.js","sourceRoot":"","sources":["../../src/utils/spec-files.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,QAAgB;IAClD,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,MAAM,IAAI,GAAG,KAAK,EAAE,GAAW,EAAiB,EAAE;QAChD,IAAI,OAAO,CAAC;QACZ,IAAI,CAAC;YACH,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3D,CAAC;QAAC,MAAM,CAAC;YACP,yEAAyE;YACzE,OAAO;QACT,CAAC;QACD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YACxC,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxB,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC;YACnB,CAAC;iBAAM,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;gBACtD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACrB,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC;IACrB,OAAO,OAAO,CAAC,IAAI,EAAE,CAAC;AACxB,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,QAAgB;IACzD,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,MAAM,IAAI,GAAG,KAAK,EAAE,GAAW,EAAiB,EAAE;QAChD,IAAI,OAAO,CAAC;QACZ,IAAI,CAAC;YACH,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3D,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;QACT,CAAC;QACD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YACxC,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxB,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC;YACnB,CAAC;iBAAM,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;gBACtE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACrB,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC;IACrB,OAAO,OAAO,CAAC,IAAI,EAAE,CAAC;AACxB,CAAC"}

package/dist/utils/task-progress.js

@@ -8,7 +8,7 @@ import { resolveSchemaForChange } from './change-metadata.js';
  * subtask is never invisible to progress; the indent is kept only so the
  * dashboard can render the nesting it found.
  *
- * ponytail: line-based, so a `- [ ]` inside an indented code block in tasks.md
+ * Limitation: line-based, so a `- [ ]` inside an indented code block in tasks.md
  * miscounts. A real markdown parse is the fix if that ever bites.
  */
 const TASK_PATTERN = /^([ \t]*)[-*]\s+\[([\sxX])\]\s*(.*)$/;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seanmars/tospec",
-  "version": "0.19.0-beta.6",
+  "version": "0.19.0-beta.8",
   "description": "Spec-driven development CLI for structured requirements and issue workflows",
   "license": "MIT",
   "homepage": "https://www.npmjs.com/package/@seanmars/tospec",

package/schemas/decision/templates/decision.md

@@ -23,7 +23,9 @@
 <!-- Follow-up implementation items, phased if useful -->
 
 ## Related Changes
-<!-- Optional: changes that implement this decision (back-linked by tospec new change --decisions); list change names, add archive paths once archived; omit if none yet -->
+<!-- Optional, maintained by hand: nothing writes this section. `tospec new change --decisions <file>`
+     records the link on the change's side only. List change names here yourself, add archive paths
+     once archived; omit if none yet -->
 
 ## Decision Process
 <!-- Optional: the key Q&A that shaped this decision; each pair starts with **Q:**, answer in the next paragraph; summarize, don't paste a transcript; omit if there was no interactive discussion -->

package/schemas/decision/templates/index.md

@@ -1,2 +1,2 @@
-| timestamp | title | summary | file |
-| ----- | ----- | ----- | ----- |
+| timestamp | status | title | summary | file |
+| ----- | ----- | ----- | ----- | ----- |

package/schemas/issue/schema.yaml

@@ -29,8 +29,10 @@ artifacts:
     instruction: |
       Write delta specs only when the fix changes externally observable behavior
       (same grammar as sdd, same layout: specs/<capability>/spec.md, exactly one
-      directory level). If the bug stems from a wrong spec, fix that Requirement
-      with MODIFIED.
+      directory level). REMOVED lists each name as a bullet with Reason and
+      Migration fields; RENAMED writes a FROM:/TO: pair, e.g. "- FROM: `<old
+      name>`" / "- TO: `<new name>`". If the bug stems from a wrong spec, fix
+      that Requirement with MODIFIED.
 apply:
   requires: [task]
   tracks: task.md

package/schemas/issue/templates/spec.md

@@ -1,3 +1,11 @@
+<!-- A NEW capability's delta opens with ## Purpose (one sentence on why this
+capability exists); archive carries it into the newly created main spec. Delete
+this block when the delta targets a capability that already has a main spec —
+edit that spec's Purpose directly instead. -->
+
+## Purpose
+[One sentence: why this capability exists]
+
 ## ADDED Requirements
 
 ### Requirement: [name]
@@ -9,5 +17,15 @@
 - **AND** [additional outcome]
 
 <!-- MODIFIED, REMOVED, and RENAMED Requirements may also be used.
-MODIFIED must contain the full updated requirement block.
-REMOVED must include Reason and Migration; RENAMED uses a FROM/TO pair. -->
+MODIFIED must contain the full updated requirement block. -->
+
+## REMOVED Requirements
+
+- `[name]`
+- Reason: [why removed]
+- Migration: [how existing usage migrates]
+
+## RENAMED Requirements
+
+- FROM: `[old name]`
+- TO: `[new name]`

package/schemas/sdd/schema.yaml

@@ -39,6 +39,10 @@ artifacts:
       body, not only in the heading) /
       #### Scenario: <name> (four #, WHEN/THEN/AND bullets).
       MODIFIED must paste the full updated requirement block.
+      REMOVED lists each removed name as a bullet with Reason and Migration
+      fields, e.g. "- <name>" / "- Reason: ..." / "- Migration: ...".
+      RENAMED writes a FROM:/TO: pair per entry, e.g. "- FROM: `<old name>`" /
+      "- TO: `<new name>`".
       A new capability's delta must open with ## Purpose (one sentence on why this
       capability exists); archive carries it into the newly created main spec. Do
       not add Purpose to an existing capability's delta (edit the main spec's

package/schemas/sdd/templates/spec.md

@@ -1,3 +1,11 @@
+<!-- A NEW capability's delta opens with ## Purpose (one sentence on why this
+capability exists); archive carries it into the newly created main spec. Delete
+this block when the delta targets a capability that already has a main spec —
+edit that spec's Purpose directly instead. -->
+
+## Purpose
+[One sentence: why this capability exists]
+
 ## ADDED Requirements
 
 ### Requirement: [name]
@@ -9,5 +17,15 @@
 - **AND** [additional outcome]
 
 <!-- MODIFIED, REMOVED, and RENAMED Requirements may also be used.
-MODIFIED must contain the full updated requirement block.
-REMOVED must include Reason and Migration; RENAMED uses a FROM/TO pair. -->
+MODIFIED must contain the full updated requirement block. -->
+
+## REMOVED Requirements
+
+- `[name]`
+- Reason: [why removed]
+- Migration: [how existing usage migrates]
+
+## RENAMED Requirements
+
+- FROM: `[old name]`
+- TO: `[new name]`