@seanmars/tospec 0.24.0 → 0.26.0

package/dist/utils/spec-files.js

@@ -1,14 +1,24 @@
 import { promises as fs } from 'node:fs';
 import path from 'node:path';
+import { hasDeltaSection } from '../core/parsers/requirement-blocks.js';
+import { FileSystemUtils, enterOnce, isDirectoryEntry } from './file-system.js';
+import { findDeltaSpecSources } from '../core/specs-apply.js';
 /**
  * Absolute paths of every accepted file under `dir`, at any depth, sorted by
  * code point — not localeCompare, which follows the process ICU locale and
  * would order issues differently on CI than locally. A missing or unreadable
  * directory means "no files".
+ *
+ * Links are followed, as the merge path follows them: a delta the merge reads
+ * through a linked capability folder or a linked `spec.md` must be one validate
+ * reads too, or validate reports "no deltas" for a change archive merges.
  */
 async function findFiles(dir, accept) {
     const results = [];
+    const visited = new Set();
     const walk = async (current) => {
+        if (!(await enterOnce(visited, current)))
+            return;
         let entries;
         try {
             entries = await fs.readdir(current, { withFileTypes: true });
@@ -18,10 +28,10 @@ async function findFiles(dir, accept) {
         }
         for (const entry of entries) {
             const full = path.join(current, entry.name);
-            if (entry.isDirectory()) {
+            if (isDirectoryEntry(current, entry)) {
                 await walk(full);
             }
-            else if (entry.isFile() && accept(entry.name)) {
+            else if (accept(entry.name) && (entry.isFile() || (await isLinkedFile(full, entry)))) {
                 results.push(full);
             }
         }
@@ -29,6 +39,11 @@ async function findFiles(dir, accept) {
     await walk(dir);
     return results.sort();
 }
+async function isLinkedFile(full, entry) {
+    if (!entry.isSymbolicLink())
+        return false;
+    return fs.stat(full).then((stat) => stat.isFile(), () => false);
+}
 /**
  * Every `spec.md` under a change's `specs/` directory, at any depth.
  *
@@ -36,11 +51,67 @@ async function findFiles(dir, accept) {
  * `specs/<capability>/spec.md`: the merge path reads one level, so anything
  * deeper would be applied by nobody, and finding it lets the validator report it
  * and archive refuse.
- * tospec/decisions/20260730_014309-delta-spec-layout-one-level.md
  */
 export async function findSpecFiles(specsDir) {
     return findFiles(specsDir, (name) => name === 'spec.md');
 }
+/**
+ * The spec files a declared `skip_specs: true` contradicts, relative to
+ * `specs/` in POSIX form; none when the marker is not declared. validate's
+ * ERROR and `instructions apply`'s warning both read this list, so the two
+ * cannot disagree about which change carries the contradiction.
+ *
+ * Counts only the files the merge would apply, picked by the merge's own
+ * selection. A root `specs/<cap>.md` is applied by nobody, so it does not
+ * contradict "this change merges no deltas"; validate warns about it instead.
+ * Calling it a contradiction would make the same file an ERROR under
+ * skip_specs and a WARNING everywhere else, and would block a root notes file
+ * that merely quotes a delta header — the case the WARNING level exists for.
+ * A nested or root `spec.md` is no contradiction either, for the same reason:
+ * validate's layout ERROR names it whatever the marker says, and counted here
+ * it was also the one spec file apply's "Not present in this change: specs"
+ * told the agent to ignore.
+ */
+export async function findSkipSpecsContradictions(changeDir, marker) {
+    if (!marker.declared)
+        return [];
+    const specsDir = path.join(changeDir, 'specs');
+    return (await findDeltaSpecSources(specsDir)).map(({ source }) => FileSystemUtils.toPosixPath(path.relative(specsDir, source)));
+}
+/**
+ * Why validate refuses a `.md` file below the `specs/` root by its path alone,
+ * or null for `<capability>/spec.md`. `entryPath` is relative to `specs/`, in
+ * POSIX form, and at least one folder deep: `specs/spec.md` has its own rule
+ * ({@link findRootSpecDelta}) and any other root file only warns
+ * ({@link findRootDeltaFiles}). validate's layout ERRORs and
+ * {@link findMisplacedSpecFiles} both judge by it, so apply cannot call a change
+ * ready that validate refuses for its layout.
+ */
+export function specLayoutFault(entryPath) {
+    const segments = entryPath.split('/');
+    if (segments.length > 2)
+        return 'nested';
+    // fast-glob (which computes artifact status) skips dot-directories while the
+    // merge path's readdir does not.
+    if (segments[0].startsWith('.'))
+        return 'dot-folder';
+    return segments[1] === 'spec.md' ? null : 'misnamed';
+}
+/**
+ * The files validate refuses for where they sit, relative to `specs/` in POSIX
+ * form: `specs/spec.md` by {@link findRootSpecDelta}, and every `.md` below the
+ * root by {@link specLayoutFault}. `skip_specs` does not change the list, as it
+ * does not change those ERRORs.
+ */
+export async function findMisplacedSpecFiles(specsDir, options) {
+    const relative = (file) => FileSystemUtils.toPosixPath(path.relative(specsDir, file));
+    const rootSpec = await findRootSpecDelta(specsDir, options);
+    const below = (await findAllMarkdownFiles(specsDir))
+        .filter((file) => path.dirname(file) !== specsDir)
+        .map(relative)
+        .filter((entryPath) => specLayoutFault(entryPath) !== null);
+    return [...(rootSpec === undefined ? [] : [relative(rootSpec)]), ...below].sort();
+}
 /**
  * Every `*.md` under a change's `specs/` directory, at any depth. Unlike
  * {@link findSpecFiles} the basename is not filtered, so the validator can
@@ -50,4 +121,122 @@ export async function findSpecFiles(specsDir) {
 export async function findAllMarkdownFiles(specsDir) {
     return findFiles(specsDir, (name) => name.toLowerCase().endsWith('.md'));
 }
+/**
+ * `*.md` files directly under `specs/` (other than the file `specs/spec.md`
+ * resolves to, which has its own ERROR) that carry a delta section header — a delta written as
+ * `specs/<capability>.md` instead of `specs/<capability>/spec.md`, which the
+ * merge never reads.
+ *
+ * Only these: a root `.md` without a delta header is notes, and stays clutter
+ * rather than a lost delta. Validate and archive both read this one list and
+ * both only warn, so neither refuses what the other accepts.
+ *
+ * `includeRootSpec` keeps `specs/spec.md` in the list, for a caller where
+ * nothing else names it: archive wherever the merge-empty backstop does not run
+ * (under `--skip-specs`, or beside a capability delta).
+ */
+export async function findRootDeltaFiles(specsDir, options = {}) {
+    let entries;
+    try {
+        entries = await fs.readdir(specsDir, { withFileTypes: true });
+    }
+    catch {
+        return [];
+    }
+    const rootSpecName = options.includeRootSpec
+        ? undefined
+        : await resolveRootSpecName(specsDir, entries.map((entry) => entry.name));
+    const found = [];
+    for (const entry of entries) {
+        if (!entry.isFile() || !entry.name.toLowerCase().endsWith('.md') || entry.name === rootSpecName)
+            continue;
+        const full = path.join(specsDir, entry.name);
+        let content;
+        try {
+            content = await fs.readFile(full, 'utf-8');
+        }
+        catch {
+            continue;
+        }
+        if (hasDeltaSection(content))
+            found.push(full);
+    }
+    return found.sort();
+}
+/**
+ * `*.md` files below the `specs/` root, other than a `spec.md`, that carry a
+ * delta section header: a delta written as `specs/<capability>/notes.md` or
+ * `SPEC.md`, which the merge never reads (it reads `spec.md`, spelled exactly).
+ * Without a delta header the file is notes, the rule {@link findRootDeltaFiles}
+ * applies at the root. Root files are left to that function.
+ */
+export async function findMisnamedDeltaFiles(specsDir) {
+    const found = [];
+    for (const file of await findAllMarkdownFiles(specsDir)) {
+        if (path.dirname(file) === specsDir || path.basename(file) === 'spec.md')
+            continue;
+        let content;
+        try {
+            content = await fs.readFile(file, 'utf-8');
+        }
+        catch {
+            continue;
+        }
+        if (hasDeltaSection(content))
+            found.push(file);
+    }
+    return found;
+}
+/**
+ * The file the validator's `specs/spec.md` ERROR lands on, under its name on
+ * disk, for a caller that names that file without running that check: the
+ * archive backstop. {@link findSpecFiles} matches the basename exactly, so on a
+ * case-insensitive file system a lone `SPEC.md` was left out of both that
+ * backstop and {@link findRootDeltaFiles}, and archived under `--no-validate`
+ * with nothing naming it.
+ */
+export async function findRootSpecFile(specsDir) {
+    let names;
+    try {
+        names = await fs.readdir(specsDir);
+    }
+    catch {
+        return undefined;
+    }
+    const name = await resolveRootSpecName(specsDir, names);
+    return name === undefined ? undefined : path.join(specsDir, name);
+}
+/**
+ * The file `specs/spec.md` resolves to, when it is a delta the merge cannot
+ * read: always where the change must carry a delta, and elsewhere only with a
+ * delta header, since without one it is notes. validate's ERROR and the
+ * archive backstop both pick it here: the backstop counted the file whatever
+ * the schema demanded, so it refused notes validate had passed and sent the
+ * user back to validate.
+ */
+export async function findRootSpecDelta(specsDir, options) {
+    const file = await findRootSpecFile(specsDir);
+    if (file === undefined || options.requireDelta)
+        return file;
+    const content = await fs.readFile(file, 'utf-8').catch(() => '');
+    return hasDeltaSection(content) ? file : undefined;
+}
+/**
+ * The entry name the validator's `specs/spec.md` ERROR lands on. That check
+ * stats the path, so the file system decides the case: on a case-insensitive
+ * one (Windows, default macOS) it fires for `SPEC.md` too. A plain
+ * case-insensitive exclusion would instead hide a `SPEC.md` delta on a
+ * case-sensitive file system, where that ERROR never fires for it.
+ *
+ * Only a regular file, as in that check: a directory named `spec.md` is a
+ * capability folder.
+ */
+async function resolveRootSpecName(specsDir, names) {
+    const stat = await fs.stat(path.join(specsDir, 'spec.md')).catch(() => null);
+    if (!stat?.isFile())
+        return undefined;
+    if (names.includes('spec.md'))
+        return 'spec.md';
+    return names.find((name) => name.toLowerCase() === 'spec.md');
+}
 //# 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;;;;;GAKG;AACH,KAAK,UAAU,SAAS,CAAC,GAAW,EAAE,MAAiC;IACrE,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,MAAM,IAAI,GAAG,KAAK,EAAE,OAAe,EAAiB,EAAE;QACpD,IAAI,OAAO,CAAC;QACZ,IAAI,CAAC;YACH,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/D,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;QACT,CAAC;QACD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YAC5C,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxB,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC;YACnB,CAAC;iBAAM,IAAI,KAAK,CAAC,MAAM,EAAE,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;gBAChD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACrB,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,IAAI,CAAC,GAAG,CAAC,CAAC;IAChB,OAAO,OAAO,CAAC,IAAI,EAAE,CAAC;AACxB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,QAAgB;IAClD,OAAO,SAAS,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;AAC3D,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,QAAgB;IACzD,OAAO,SAAS,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;AAC3E,CAAC"}
+{"version":3,"file":"spec-files.js","sourceRoot":"","sources":["../../src/utils/spec-files.ts"],"names":[],"mappings":"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"}

package/dist/utils/task-progress.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"task-progress.d.ts","sourceRoot":"","sources":["../../src/utils/task-progress.ts"],"names":[],"mappings":"AAwBA,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,QAAS,SAAQ,UAAU;IAC1C,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,EAAE,CAoBnE;AA8BD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAOjF;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,QAAQ,EAAE,CAAC,CAarB;AAED,qFAAqF;AACrF,wBAAsB,wBAAwB,CAC5C,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,YAAY,CAAC,CAGvB;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAkB1F;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,CAI/D"}
+{"version":3,"file":"task-progress.d.ts","sourceRoot":"","sources":["../../src/utils/task-progress.ts"],"names":[],"mappings":"AAyCA,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,QAAS,SAAQ,UAAU;IAC1C,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,EAAE,CAoBnE;AA8BD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAOjF;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,QAAQ,EAAE,CAAC,CAarB;AAED,qFAAqF;AACrF,wBAAsB,wBAAwB,CAC5C,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,YAAY,CAAC,CAGvB;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAwB1F;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,CAI/D"}

package/dist/utils/task-progress.js

@@ -12,13 +12,30 @@ import { resolveSchemaForChange } from './change-metadata.js';
  * GitHub's rendering is the only view of tasks.md the author can check against,
  * so "tasks tospec sees" must equal "tasks GitHub draws". Too narrow and
  * `+ [ ] 1.2 …` is a box nobody can count; too wide and `- [ ]2.6 …` is a task
- * nobody can tick.
+ * nobody can tick. Ordered-list markers (`1.` / `1)`, up to 9 digits as in
+ * CommonMark) are GFM list items too: left out, `1. [ ] 1.2 …` was a drawn box
+ * the archive gate never saw, so an unfinished change passed it.
  *
  * Fences are masked by the callers (`buildCodeFenceMask`), not here: a tasks.md
  * documenting the task format puts real `- [ ]` lines in a fence, which would
  * leave the archive gate permanently incomplete.
+ *
+ * The text is `[^\r\n]*`, not `.*`: `.` also stops at U+2028/U+2029, but
+ * CommonMark ends a line only at LF, CR or CRLF, so GitHub draws
+ * `- [ ] a<U+2028>b` as a checkbox. Under `.*` that box went uncounted and an
+ * unfinished change passed the archive gate.
+ *
+ * `(?![ \t])` stops the text from re-splitting the blanks after `]`. Without it,
+ * on a line the text cannot finish, `[ \t]+` gave its blanks back one at a time
+ * and the text rescanned to the terminator after each: `- [ ]` + 80k blanks +
+ * U+2028 took 7.5 s under `.*`, and a bare CR that setTaskDone's old `\n` split
+ * left inside a line took 5.8 s. Both callers now end a line at every CR, so no
+ * line reaches the text holding one; the lookahead stays so a caller that splits
+ * otherwise cannot bring the cost back. Only the longest run could ever match,
+ * since a shorter one leaves the text the same terminator to cross, so the
+ * groups are unchanged.
  */
-const TASK_PATTERN = /^([ \t]*)[-*+][ \t]+\[([ \txX])\](?:[ \t]+(.*))?$/;
+const TASK_PATTERN = /^([ \t]*)(?:[-*+]|\d{1,9}[.)])[ \t]+\[([ \txX])\](?:[ \t]+(?![ \t])([^\r\n]*))?$/;
 export function parseTasksFromContent(content) {
     const tasks = [];
     // normalizeDocument so a leading BOM cannot hide the first line:
@@ -116,22 +133,28 @@ export async function getTaskProgressForChange(changesDir, changeName, projectRo
  */
 export async function setTaskDone(file, line, done) {
     const content = await fs.readFile(file, 'utf-8');
-    // BOM stripped so `line` means the same line it did in `parseTasksFromContent`,
-    // which numbers from BOM-free text. Splitting on '\n' leaves each line's '\r'
-    // attached, which is what preserves CRLF through the rejoin below.
-    const lines = stripBom(content).split('\n');
+    // Split where `parseTasksFromContent` splits (BOM stripped; CRLF, LF and a
+    // bare CR each end a line), so `line` means the line it numbered: a '\n'-only
+    // split joined the lines around a bare CR and shifted every later one. A bare
+    // CR ends a line rather than staying text because CommonMark ends one there,
+    // and a task GitHub draws after it would otherwise go uncounted. The endings
+    // are rejoined as they were.
+    const text = stripBom(content);
+    const lines = text.split(/\r\n?|\n/);
+    const endings = text.match(/\r\n?|\n/g) ?? [];
     const raw = lines[line - 1];
     // A fenced line is "not a task" for the same reason it is not counted: it is a
     // quoted example, and writing to it edits documentation. The UI draws no
     // checkbox there, so reaching here means a stale client — hence the caller's 409.
     const fenced = buildCodeFenceMask(lines);
-    if (raw === undefined || fenced[line - 1] || !TASK_PATTERN.test(raw.replace(/\r$/, ''))) {
+    if (raw === undefined || fenced[line - 1] || !TASK_PATTERN.test(raw)) {
         throw new Error(`Line ${line} of ${path.basename(file)} is not a task`);
     }
     // Same box class as TASK_PATTERN, so this rewrites exactly the marker the line
-    // matched on; the first `[…]` on a task line is always it.
+    // matched on; the first `[…]` on a task line is always it, ordered list
+    // included (`1.` / `1)` carry no bracket).
     lines[line - 1] = raw.replace(/\[[ \txX]\]/, done ? '[x]' : '[ ]');
-    await fs.writeFile(file, lines.join('\n'), 'utf-8');
+    await fs.writeFile(file, lines.map((l, i) => l + (endings[i] ?? '')).join(''), 'utf-8');
 }
 /**
  * "Tasks done", not "Complete": this counts checkboxes, while `tospec status`

package/dist/utils/task-progress.js.map

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

package/dist/utils/timestamp.d.ts

@@ -3,10 +3,37 @@
  * archive dirs and ticket files — agents must never assemble one by hand.
  */
 export declare function formatTimestamp(date: Date): string;
+/**
+ * Splits `<yyyyMMdd_HHmmss>-<name>` (an archive dir, a ticket file's base), or
+ * null when the value does not open with a stamp. Splitting on the first hyphen
+ * alone read `no-date-change` as stamp `no`, name `date-change`.
+ */
+export declare function parseStampedName(value: string): {
+    stamp: string;
+    name: string;
+} | null;
 /**
  * A Date as `yyyy-MM-dd` in local time. For date-only metadata, instead of
  * `toISOString().split('T')[0]`, which truncates in UTC and records the wrong
  * calendar day near local midnight.
  */
 export declare function formatLocalDate(date?: Date): string;
+/**
+ * A Date as `yyyy-MM-ddTHH:mm:ss` in local time, with no zone: the `created`
+ * a new change records. The day alone could not order two changes made on one
+ * day, and validate needs that order to say which of two changes rewriting one
+ * requirement archives first.
+ */
+export declare function formatLocalDateTime(date?: Date): string;
+/** Both spellings of `created`: the datetime a change records now, and the day older changes recorded. */
+export declare const CREATED_PATTERN: RegExp;
+/**
+ * A `created` value as the local Date it names, and whether it carried a time;
+ * null when it matches neither spelling or names no real moment (`2026-13-45`
+ * and `25:00:00` would roll over into another one).
+ */
+export declare function parseCreated(value: string): {
+    date: Date;
+    hasTime: boolean;
+} | null;
 //# sourceMappingURL=timestamp.d.ts.map

package/dist/utils/timestamp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"timestamp.d.ts","sourceRoot":"","sources":["../../src/utils/timestamp.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CASlD;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,GAAE,IAAiB,GAAG,MAAM,CAG/D"}
+{"version":3,"file":"timestamp.d.ts","sourceRoot":"","sources":["../../src/utils/timestamp.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CASlD;AAID;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAGtF;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,GAAE,IAAiB,GAAG,MAAM,CAG/D;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,GAAE,IAAiB,GAAG,MAAM,CAGnE;AAED,0GAA0G;AAC1G,eAAO,MAAM,eAAe,QAA2D,CAAC;AAExF;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAQnF"}

package/dist/utils/timestamp.js

@@ -12,6 +12,16 @@ export function formatTimestamp(date) {
     const seconds = pad(date.getSeconds());
     return `${year}${month}${day}_${hours}${minutes}${seconds}`;
 }
+const STAMPED_NAME = /^(\d{8}_\d{6})-(.+)$/;
+/**
+ * Splits `<yyyyMMdd_HHmmss>-<name>` (an archive dir, a ticket file's base), or
+ * null when the value does not open with a stamp. Splitting on the first hyphen
+ * alone read `no-date-change` as stamp `no`, name `date-change`.
+ */
+export function parseStampedName(value) {
+    const match = STAMPED_NAME.exec(value);
+    return match ? { stamp: match[1], name: match[2] } : null;
+}
 /**
  * A Date as `yyyy-MM-dd` in local time. For date-only metadata, instead of
  * `toISOString().split('T')[0]`, which truncates in UTC and records the wrong
@@ -21,4 +31,31 @@ export function formatLocalDate(date = new Date()) {
     const pad = (n) => String(n).padStart(2, '0');
     return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())}`;
 }
+/**
+ * A Date as `yyyy-MM-ddTHH:mm:ss` in local time, with no zone: the `created`
+ * a new change records. The day alone could not order two changes made on one
+ * day, and validate needs that order to say which of two changes rewriting one
+ * requirement archives first.
+ */
+export function formatLocalDateTime(date = new Date()) {
+    const pad = (n) => String(n).padStart(2, '0');
+    return `${formatLocalDate(date)}T${pad(date.getHours())}:${pad(date.getMinutes())}:${pad(date.getSeconds())}`;
+}
+/** Both spellings of `created`: the datetime a change records now, and the day older changes recorded. */
+export const CREATED_PATTERN = /^(\d{4})-(\d{2})-(\d{2})(?:T(\d{2}):(\d{2}):(\d{2}))?$/;
+/**
+ * A `created` value as the local Date it names, and whether it carried a time;
+ * null when it matches neither spelling or names no real moment (`2026-13-45`
+ * and `25:00:00` would roll over into another one).
+ */
+export function parseCreated(value) {
+    const match = CREATED_PATTERN.exec(value);
+    if (!match)
+        return null;
+    const [, y, mo, d, h, mi, s] = match;
+    const hasTime = h !== undefined;
+    const date = hasTime ? new Date(+y, +mo - 1, +d, +h, +mi, +s) : new Date(+y, +mo - 1, +d);
+    const roundTrip = hasTime ? formatLocalDateTime(date) : formatLocalDate(date);
+    return roundTrip === value ? { date, hasTime } : null;
+}
 //# sourceMappingURL=timestamp.js.map

package/dist/utils/timestamp.js.map

@@ -1 +1 @@
-{"version":3,"file":"timestamp.js","sourceRoot":"","sources":["../../src/utils/timestamp.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,eAAe,CAAC,IAAU;IACxC,MAAM,GAAG,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC9D,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IAChC,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC;IACvC,MAAM,GAAG,GAAG,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC;IAChC,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;IACnC,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;IACvC,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;IACvC,OAAO,GAAG,IAAI,GAAG,KAAK,GAAG,GAAG,IAAI,KAAK,GAAG,OAAO,GAAG,OAAO,EAAE,CAAC;AAC9D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,IAAI,GAAS,IAAI,IAAI,EAAE;IACrD,MAAM,GAAG,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC9D,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,IAAI,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;AACpF,CAAC"}
+{"version":3,"file":"timestamp.js","sourceRoot":"","sources":["../../src/utils/timestamp.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seanmars/tospec",
-  "version": "0.24.0",
+  "version": "0.26.0",
   "description": "Spec-driven development CLI for structured requirements and issue workflows",
   "license": "MIT",
   "homepage": "https://www.npmjs.com/package/@seanmars/tospec",
@@ -34,6 +34,7 @@
     "node": ">=22.22.0"
   },
   "devDependencies": {
+    "@types/cross-spawn": "^6.0.6",
     "@types/node": "^24.13.4",
     "typescript": "^7.0.2",
     "vitest": "^5.0.0"
@@ -42,8 +43,10 @@
     "@inquirer/core": "^12.0.3",
     "@inquirer/prompts": "^8.7.2",
     "commander": "^15.0.0",
+    "cross-spawn": "^7.0.6",
     "diff": "^9.0.0",
     "fast-glob": "^3.3.3",
+    "fast-string-width": "^3.0.2",
     "marked": "^18.0.12",
     "yaml": "^2.9.0",
     "zod": "^4.6.2"

package/schemas/decision/templates/decision.md

@@ -24,8 +24,8 @@
 
 ## Related Changes
 <!-- 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 -->
+     and `tospec decision new --change <name>` record 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/issue/schema.yaml

@@ -12,15 +12,19 @@ artifacts:
     requires: []
     instruction: |
       Diagnose and write the issue task: first build a tight feedback loop (one
-      command that turns this bug red), list 3-5 falsifiable hypotheses and rank
-      them, verify each, then write down the root cause. Contents: root-cause
-      analysis, fix plan, test plan (why existing tests missed it / which edge
+      command that turns this bug red), list as many falsifiable hypotheses as
+      the evidence supports (one or two is fine when the loop already points at
+      one cause) and rank them, verify each, then write down the root cause.
+      Redact secrets as <REDACTED> in everything pasted here: task.md is
+      committed and kept in the archive. Quote only the lines that carry the
+      signal, and do not redact the error message itself. A step that needs
+      the user's login is theirs to run; do not capture its output.
+      Contents: root-cause analysis, fix plan, test plan (why existing tests missed it / which edge
       cases are missing), and a task checkbox list.
     validation:
       requiredSections: [Feedback Loop, Root Cause, Fix Plan, Test Plan, Tasks]
   - id: specs
-    # Exactly one directory level — same constraint as sdd. See
-    # tospec/decisions/20260730_014309-delta-spec-layout-one-level.md
+    # Exactly one directory level — same constraint as sdd.
     generates: specs/*/spec.md
     description: Optional behavior-changing delta specifications
     template: spec.md
@@ -29,7 +33,9 @@ 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). REMOVED lists each name as a bullet with Reason and
+      directory level). Use the capability's exact name from tospec/specs/,
+      letter case included; a new capability gets a kebab-case name, same rule
+      as sdd. 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 — pasting the full updated block, since a

package/schemas/issue/templates/task.md

@@ -15,7 +15,7 @@
 
 ## Tasks
 ### 1. Fix
-- [ ] 1.1 Write a regression test (red)
+- [ ] 1.1 Regression test is red (the one from diagnosis, or write it now)
 - [ ] 1.2 Implement the fix until the test passes (green)
 - [ ] 1.3 Add edge-case tests: [...]
 - [ ] 1.4 Run the full test suite to confirm no regressions

package/schemas/sdd/schema.yaml

@@ -15,9 +15,14 @@ artifacts:
       add/modify/remove), Capabilities (New/Modified capabilities and their specs),
       Impact (affected code/APIs/dependencies/systems). This is what specs and
       design expand from; never write file paths or code snippets (they go stale).
-      If the change has no externally observable effect at all (tooling, CI,
-      docs), say so in Impact and set `skip_specs: true` in the change's
-      .tospec.yaml — see the specs artifact below.
+      Name a capability after the long-lived functional area it covers (`auth`),
+      not after this change (`add-login-endpoint`), in kebab-case; a Modified
+      capability keeps its exact existing name. When the change falls inside
+      an existing capability's area, list that one under Modified Capabilities;
+      create a new capability only when the area is genuinely different.
+      If the user explicitly says this change needs no delta spec, say so in
+      Impact and set `skip_specs: true` in the change's .tospec.yaml — see the
+      specs artifact below.
     validation:
       requiredSections: [Why, What Changes, Impact]
       minSectionLength:
@@ -29,8 +34,7 @@ artifacts:
   - id: specs
     # Exactly one directory level. A deeper path (specs/<area>/<capability>/spec.md)
     # is rejected by the validator: archive's merge only reads one level, so a nested
-    # file would validate clean and then vanish on archive. See
-    # tospec/decisions/20260730_014309-delta-spec-layout-one-level.md
+    # file would validate clean and then vanish on archive.
     generates: specs/*/spec.md
     description: Delta specifications for affected capabilities
     template: spec.md
@@ -38,6 +42,13 @@ artifacts:
     instruction: |
       Write delta specs from the proposal. One file per capability, at
       specs/<capability>/spec.md — exactly one directory level, never nested.
+      An existing capability's folder uses its exact name from tospec/specs/,
+      letter case included: a name differing only in case is rejected. A new
+      capability's folder name becomes its main spec's name, so write it in
+      kebab-case (lowercase letters, numbers, single hyphens; letters with no
+      case, such as 中文, are fine); validate warns otherwise. A name Windows
+      cannot hold (con, aux, nul, prn, com1-9, lpt1-9, any of <>:"/\|?*, or a
+      trailing dot or space) is rejected.
       Grammar: ## ADDED|MODIFIED|REMOVED|RENAMED Requirements /
       ### Requirement: <name> (state the obligation with SHALL or MUST in the
       body, not only in the heading) /
@@ -60,11 +71,11 @@ artifacts:
       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
       Purpose directly instead).
-      A change with genuinely no behavioral effect (infrastructure, tooling,
-      doc-only) writes no delta and declares `skip_specs: true` in its
-      .tospec.yaml instead. Use it only when that is actually true — never
-      invent a Requirement to get past validation, and never set the marker on a
-      change that does have delta specs (validation rejects that contradiction).
+      When the user explicitly says this change needs no delta spec, write no
+      delta and declare `skip_specs: true` in its .tospec.yaml instead. Never
+      set the marker on your own judgment, never invent a Requirement to get
+      past validation, and never set the marker on a change that does have
+      delta specs (validation rejects that contradiction).
   - id: design
     generates: design.md
     description: Technical design and testing seams

package/schemas/sdd/templates/proposal.md

@@ -6,7 +6,7 @@
 
 ## Capabilities
 ### New Capabilities
-- `<name>`: <description> (maps to specs/<name>/spec.md)
+- `<name>`: <summary> (maps to specs/<name>/spec.md)
 
 ### Modified Capabilities
 - `<existing-name>`: <the requirement that changes>