@seanmars/tospec 0.19.0-beta.0 → 0.19.0-beta.13

package/dist/core/validation/task-numbering.js

@@ -1,9 +1,10 @@
 import { parseTasksFromContent } from '../../utils/task-progress.js';
+import { buildCodeFenceMask, normalizeDocument } from '../parsers/requirement-text.js';
 /**
  * A group heading is level 2 or 3, because the two schemas differ: sdd's
- * `tasks.md` numbers slices at `## 1.`, while issue's `task.md` puts `### 1. Fix`
- * under an unnumbered `## Tasks`. Matching only one level would make the check
- * silently inert for the other schema.
+ * `tasks.md` numbers slices at `## 1.`, while issue's `task.md` puts
+ * `### 1. Fix` under an unnumbered `## Tasks`. Matching one level would leave
+ * the check inert for the other schema.
  */
 const GROUP_HEADING = /^ {0,3}#{2,3}[ \t]+/;
 const NUMBERED_GROUP_HEADING = /^ {0,3}#{2,3}[ \t]+(\d+)\./;
@@ -15,24 +16,35 @@ export function findTaskNumberingIssues(documents) {
     const issues = [];
     const firstLocationById = new Map();
     for (const document of documents) {
-        const lines = document.content.split(/\r?\n/);
+        const lines = normalizeDocument(document.content).split('\n');
         if (!lines.some((line) => NUMBERED_GROUP_HEADING.test(line)))
             continue;
+        // Parsed once for the whole document, then addressed by line — never
+        // `parseTasksFromContent(line)` per line, which opts out of fence masking:
+        // the mask is built from surrounding lines, so a line handed over alone can
+        // never be inside a fence, and a tasks.md documenting its own format would
+        // draw warnings over its fenced examples.
+        const taskByLine = new Map();
+        for (const task of parseTasksFromContent(document.content)) {
+            taskByLine.set(task.line, task);
+        }
+        // Headings need the mask for the same reason: a `## 9. …` inside a fence is
+        // a quoted example, and letting it open a numbered group misjudges every
+        // real task below it.
+        const fenced = buildCodeFenceMask(lines);
         let currentGroup;
         lines.forEach((line, index) => {
+            if (fenced[index])
+                return;
             if (GROUP_HEADING.test(line)) {
-                // An unnumbered heading at either level ends the numbered group rather
-                // than letting it leak across sections.
+                // An unnumbered heading at either level ends the numbered group, so it
+                // cannot leak across sections.
                 currentGroup = line.match(NUMBERED_GROUP_HEADING)?.[1];
                 return;
             }
             if (currentGroup === undefined)
                 return;
-            // Deliberately the same line-based reader progress counting uses, fenced
-            // blocks and all. A checkbox in a fence is miscounted by both or neither;
-            // making only this side fence-aware would put the two readers back out of
-            // step, which is the failure mode worth avoiding here.
-            const task = parseTasksFromContent(line)[0];
+            const task = taskByLine.get(index + 1);
             const id = task?.text.match(TASK_ID)?.[1];
             if (!id)
                 return;

package/dist/core/validation/task-numbering.js.map

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

package/dist/core/validation/types.d.ts

@@ -5,6 +5,16 @@ export interface ValidationIssue {
     message: string;
     line?: number;
     column?: number;
+    /**
+     * Background explaining the rule rather than this occurrence of it — why the
+     * check is a warning, what it cannot see, what to do in general.
+     *
+     * Separate from the per-occurrence `message` because it is identical every
+     * time the rule fires; inlined, it repeats once per occurrence and buries the
+     * names that differ. `createReport` hoists these into
+     * `ValidationReport.notes`, deduplicated, and clears them from the issues.
+     */
+    note?: string;
 }
 export interface ValidationReport {
     valid: boolean;
@@ -14,5 +24,13 @@ export interface ValidationReport {
         warnings: number;
         info: number;
     };
+    /** Distinct `ValidationIssue.note` values, each carried once. */
+    notes?: string[];
 }
+/**
+ * Severity symbol for human output. Shared so no two surfaces show different
+ * glyphs for one level; the line formats around it differ on purpose
+ * (`validate` prints the level, `archive` does not), so only this is common.
+ */
+export declare function issueSymbol(level: ValidationLevel | string): string;
 //# sourceMappingURL=types.d.ts.map

package/dist/core/validation/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/validation/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAE3D,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,eAAe,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,OAAO,EAAE;QACP,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;CACH"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/validation/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAE3D,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,eAAe,CAAC;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;;;;OAQG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,OAAO,EAAE;QACP,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IACF,iEAAiE;IACjE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,GAAG,MAAM,CAInE"}

package/dist/core/validation/types.js

@@ -1,2 +1,13 @@
-export {};
+/**
+ * Severity symbol for human output. Shared so no two surfaces show different
+ * glyphs for one level; the line formats around it differ on purpose
+ * (`validate` prints the level, `archive` does not), so only this is common.
+ */
+export function issueSymbol(level) {
+    if (level === 'ERROR')
+        return '✗';
+    if (level === 'WARNING')
+        return '⚠';
+    return 'ℹ';
+}
 //# sourceMappingURL=types.js.map

package/dist/core/validation/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/validation/types.ts"],"names":[],"mappings":""}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/validation/types.ts"],"names":[],"mappings":"AAgCA;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,KAA+B;IACzD,IAAI,KAAK,KAAK,OAAO;QAAE,OAAO,GAAG,CAAC;IAClC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,GAAG,CAAC;IACpC,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/core/validation/validator.d.ts

@@ -3,84 +3,83 @@ export declare class Validator {
     private strictMode;
     constructor(strictMode?: boolean);
     validateSpec(filePath: string): Promise<ValidationReport>;
-    /**
-     * Validate spec content from a string (used for pre-write validation of rebuilt specs)
-     */
     validateSpecContent(specName: string, content: string): Promise<ValidationReport>;
-    validateChange(filePath: string): Promise<ValidationReport>;
     /**
-     * Validate delta-formatted spec files under a change directory.
-     * Enforces:
-     * - At least one delta across all files
-     * - ADDED/MODIFIED: each requirement has SHALL/MUST and at least one scenario
-     * - REMOVED: names only; no scenario/description required
-     * - RENAMED: pairs well-formed
-     * - No duplicates within sections; no cross-section conflicts per spec
-     * - MODIFIED: no scenario the current main spec still has is dropped
+     * Validate delta-formatted spec files under a change directory: at least one
+     * delta overall, ADDED/MODIFIED requirements carrying SHALL/MUST and a
+     * scenario, well-formed REMOVED (names only) and RENAMED (FROM:/TO: pairs)
+     * entries, no duplicate or cross-section names, and no scenario the current
+     * main spec still has dropped by a MODIFIED.
+     *
+     * `mainSpecsDir` enables that last rule; without it there is nothing to
+     * compare against, so it is skipped. Archive refuses such deltas either way.
      *
-     * `mainSpecsDir` enables that last rule; without it the scenario-loss check is
-     * skipped, because there is nothing to compare against. Callers that have the
-     * project root should always pass it — archive refuses these deltas either
-     * way, and the check only decides whether the user learns now or at archive
-     * time.
+     * `archivePreflight` is opt-out because the dry run rebuilds every updated
+     * spec. For `tospec validate` that is the point; for `archive` it is
+     * duplication, since the real merge follows moments later.
      */
-    validateChangeDeltaSpecs(changeDir: string, mainSpecsDir?: string): Promise<ValidationReport>;
+    validateChangeDeltaSpecs(changeDir: string, mainSpecsDir?: string, options?: {
+        archivePreflight?: boolean;
+    }): Promise<ValidationReport>;
     private convertZodErrors;
     private applySpecRules;
-    private applyChangeRules;
     private enrichTopLevelError;
     private createReport;
     private extractRequirementText;
-    private containsShallOrMust;
     /**
-     * Build an error message for a requirement block whose body lacks SHALL/MUST.
-     *
-     * When the SHALL/MUST keyword already appears in the requirement header (e.g.
-     * `### Requirement: The system SHALL ...`) the original generic error
-     * ("must contain SHALL or MUST") is confusing because the keyword is visibly
-     * present in the spec. Per the Tospec conventions the keyword has to live
-     * on the requirement body line (the line right after the header), so we point
-     * the author at that exact fix when the keyword is found in the header only.
+     * When the keyword already appears in the header (`### Requirement: The system
+     * SHALL ...`) the generic "must contain SHALL or MUST" reads as wrong, since
+     * the keyword is visibly there. The convention puts it on the body line, so
+     * point the author at that exact fix instead.
      */
     private buildMissingShallOrMustMessage;
+    /**
+     * The main spec's two Purpose rules, applied to a delta that is about to
+     * create that main spec. Placeholder before brevity, as on the spec path.
+     *
+     * `mainSpecsDir` absent means new capabilities cannot be told from existing
+     * ones, so nothing is reported.
+     */
+    private collectDeltaPurposeIssues;
     /**
      * Scenarios a MODIFIED block would delete from the current main spec.
      *
      * A MODIFIED replaces the whole requirement, so a scenario the block omits is
-     * lost. `specs-apply` already refuses to apply such a block, but only at
-     * archive time — so a change could validate clean, be implemented and
-     * reviewed, and fail days later at the most expensive possible moment. Both
-     * sides now call `findMissingScenarios`, so validate reports exactly what
-     * archive refuses.
+     * lost. `specs-apply` refuses such a block too, but only at archive time. Both
+     * sides call `findMissingScenarios`, so validate reports what archive refuses.
      *
-     * Deliberately silent in two cases, because archive gates them separately and
-     * a warning here would be a false alarm:
-     * - the main spec file does not exist yet (the capability is new)
-     * - the requirement header is absent from it (a MODIFIED written against a
-     *   sister change still in flight)
+     * Silent when the main spec does not exist yet (new capability) or lacks the
+     * requirement header (a MODIFIED written against a sister change still in
+     * flight): archive gates both separately.
      */
     private collectDroppedScenarioIssues;
     /**
-     * Dry-run the merge and report what it would refuse.
+     * Dry-run the merge and report what it would refuse, plus the one thing it
+     * would accept while doing nothing.
      *
      * Reusing the merge builder rather than restating its preconditions is the
-     * whole point: several of them deliberately read a missing target as
-     * already-synced rather than as a failure, and a second copy of those rules
-     * would be free to drift — which shows up as validate and archive disagreeing,
-     * the one thing this check exists to prevent.
+     * point: a second copy would be free to drift, which shows up as validate and
+     * archive disagreeing.
      *
-     * INFO leaves the verdict alone. A MODIFIED whose target is missing is also
-     * what a change modifying a sibling's unarchived requirement looks like, and
-     * that is valid today; what is missing is the information, not the verdict.
+     * WARNING, not ERROR or INFO. ERROR is wrong because a MODIFIED whose target
+     * is missing is also what a change modifying a sibling's unarchived
+     * requirement looks like. INFO was wrong because `--strict` ignores it, so the
+     * pre-archive gate waved through changes archive would refuse.
+     * tospec/decisions/20260916_154000-archive-dry-run-findings-are-warnings.md
      */
     private findArchiveBlockers;
     /**
-     * Scenario-quality rules for a delta requirement block (report 2.1): only
-     * `#### Scenario:` headers count as scenarios, each scenario body must
-     * contain WHEN and THEN (uppercase, per the spec convention), and stray
-     * level-4 headers get a WARNING so authors know they were not counted.
+     * Scenario-quality rules for a delta requirement block: only `#### Scenario:`
+     * headers count, each scenario body must contain uppercase WHEN and THEN, and
+     * a stray level-4 header gets a WARNING so the author knows it was not counted.
      */
     private collectScenarioIssues;
-    private formatSectionList;
+    /**
+     * RENAMED/REMOVED have their own grammar (FROM:/TO: pairs; name bullets with
+     * Reason/Migration), not the `### Requirement:` block ADDED/MODIFIED use, so
+     * "add a ### Requirement: block" would send their authors to a fix that does
+     * not work.
+     */
+    private formatEmptySectionMessage;
 }
 //# sourceMappingURL=validator.d.ts.map

package/dist/core/validation/validator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../../src/core/validation/validator.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,gBAAgB,EAAoC,MAAM,YAAY,CAAC;AAqBhF,qBAAa,SAAS;IACpB,OAAO,CAAC,UAAU,CAAU;gBAEhB,UAAU,GAAE,OAAe;IAIjC,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAiB/D;;OAEG;IACG,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAkBjF,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IA+BjE;;;;;;;;;;;;;;;OAeG;IACG,wBAAwB,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAgSnG,OAAO,CAAC,gBAAgB;IAcxB,OAAO,CAAC,cAAc;IA6FtB,OAAO,CAAC,gBAAgB;IA2BxB,OAAO,CAAC,mBAAmB;IAc3B,OAAO,CAAC,YAAY;IAoBpB,OAAO,CAAC,sBAAsB;IAU9B,OAAO,CAAC,mBAAmB;IAI3B;;;;;;;;;OASG;IACH,OAAO,CAAC,8BAA8B;IAQtC;;;;;;;;;;;;;;;OAeG;YACW,4BAA4B;IAqD1C;;;;;;;;;;;;OAYG;YACW,mBAAmB;IA4DjC;;;;;OAKG;IACH,OAAO,CAAC,qBAAqB;IA2C7B,OAAO,CAAC,iBAAiB;CAO1B"}
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../../src/core/validation/validator.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,gBAAgB,EAAoC,MAAM,YAAY,CAAC;AAqEhF,qBAAa,SAAS;IACpB,OAAO,CAAC,UAAU,CAAU;IAE5B,YAAY,UAAU,GAAE,OAAe,EAEtC;IAEK,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAc9D;IAEK,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAgBtF;IAED;;;;;;;;;;;;;OAaG;IACG,wBAAwB,CAC5B,SAAS,EAAE,MAAM,EACjB,YAAY,CAAC,EAAE,MAAM,EACrB,OAAO,GAAE;QAAE,gBAAgB,CAAC,EAAE,OAAO,CAAA;KAAO,GAC3C,OAAO,CAAC,gBAAgB,CAAC,CA4W3B;IAED,OAAO,CAAC,gBAAgB;IAoBxB,OAAO,CAAC,cAAc;IAgFtB,OAAO,CAAC,mBAAmB;IAc3B,OAAO,CAAC,YAAY;IA0BpB,OAAO,CAAC,sBAAsB;IAQ9B;;;;;OAKG;IACH,OAAO,CAAC,8BAA8B;IAuBtC;;;;;;OAMG;YACW,yBAAyB;IA4CvC;;;;;;;;;;OAUG;YACW,4BAA4B;IA8I1C;;;;;;;;;;;;;OAaG;YACW,mBAAmB;IAyEjC;;;;OAIG;IACH,OAAO,CAAC,qBAAqB;IA4D7B;;;;;OAKG;IACH,OAAO,CAAC,yBAAyB;CAalC"}