@seanmars/tospec 0.17.0 → 0.19.0-beta.0

package/dist/utils/requirement-diff.js

@@ -0,0 +1,69 @@
+/**
+ * Requirement-level diffing for `tospec show <change> --diff`.
+ *
+ * A delta spec says what changes but not what it changes *from*: a MODIFIED
+ * block restates the whole requirement, so reading one tells you nothing about
+ * which line moved. Pairing each block with its main-spec counterpart is the
+ * only way to review a delta without opening two files side by side.
+ */
+import { formatPatch, OMIT_HEADERS, structuredPatch } from 'diff';
+import { extractRequirementsSection, foldRequirementName, normalizeRequirementName, } from '../core/parsers/requirement-blocks.js';
+/**
+ * The raw markdown block for a requirement in a main spec, or null when no
+ * header matches either way.
+ *
+ * Delegates to extractRequirementsSection(), which already handles code fences,
+ * section boundaries and header parsing. Lookup is exact first, then the shared
+ * case/whitespace fold, so a header that differs only in spelling still shows
+ * its diff — flagged inexact rather than silently treated as a match.
+ */
+export function extractRequirementBlock(specContent, requirementName) {
+    const parts = extractRequirementsSection(specContent);
+    const targetName = normalizeRequirementName(requirementName);
+    const foldedTarget = foldRequirementName(targetName);
+    let folded = null;
+    for (const block of parts.bodyBlocks) {
+        const name = normalizeRequirementName(block.name);
+        if (name === targetName) {
+            return { raw: block.raw, name, exact: true };
+        }
+        if (!folded && foldRequirementName(name) === foldedTarget) {
+            folded = { raw: block.raw, name, exact: false };
+        }
+    }
+    return folded;
+}
+/**
+ * A unified diff between a main-spec requirement block and the delta block that
+ * replaces it. A null main block diffs against the empty string, so every line
+ * reads as an addition.
+ *
+ * structuredPatch keeps the unified hunk ranges; the synthetic file headers are
+ * omitted because the caller labels the block itself.
+ */
+export function diffRequirementBlock(baseBlock, deltaBlock, label) {
+    const base = ensureTrailingNewline(baseBlock ?? '');
+    const delta = ensureTrailingNewline(deltaBlock);
+    const patch = structuredPatch(label, label, base, delta);
+    return formatPatch(patch, OMIT_HEADERS).trimEnd();
+}
+function ensureTrailingNewline(s) {
+    return s.endsWith('\n') ? s : s + '\n';
+}
+/**
+ * Maps a RENAMED TO name (folded) back to the original main-spec name.
+ *
+ * Renames apply in source order, so a chain A -> B -> C maps C back to A — the
+ * block a later MODIFIED C actually replaces in the main spec.
+ */
+export function buildRenameMap(renames) {
+    const map = new Map();
+    for (const r of renames) {
+        const from = foldRequirementName(r.from);
+        const original = map.get(from) ?? normalizeRequirementName(r.from);
+        map.delete(from);
+        map.set(foldRequirementName(r.to), original);
+    }
+    return map;
+}
+//# sourceMappingURL=requirement-diff.js.map

package/dist/utils/requirement-diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"requirement-diff.js","sourceRoot":"","sources":["../../src/utils/requirement-diff.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,MAAM,CAAC;AAClE,OAAO,EACL,0BAA0B,EAC1B,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,uCAAuC,CAAC;AAe/C;;;;;;;;GAQG;AACH,MAAM,UAAU,uBAAuB,CACrC,WAAmB,EACnB,eAAuB;IAEvB,MAAM,KAAK,GAAG,0BAA0B,CAAC,WAAW,CAAC,CAAC;IACtD,MAAM,UAAU,GAAG,wBAAwB,CAAC,eAAe,CAAC,CAAC;IAC7D,MAAM,YAAY,GAAG,mBAAmB,CAAC,UAAU,CAAC,CAAC;IACrD,IAAI,MAAM,GAAmC,IAAI,CAAC;IAElD,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;QACrC,MAAM,IAAI,GAAG,wBAAwB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAClD,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;YACxB,OAAO,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QAC/C,CAAC;QACD,IAAI,CAAC,MAAM,IAAI,mBAAmB,CAAC,IAAI,CAAC,KAAK,YAAY,EAAE,CAAC;YAC1D,MAAM,GAAG,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;QAClD,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB,CAClC,SAAwB,EACxB,UAAkB,EAClB,KAAa;IAEb,MAAM,IAAI,GAAG,qBAAqB,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;IACpD,MAAM,KAAK,GAAG,qBAAqB,CAAC,UAAU,CAAC,CAAC;IAChD,MAAM,KAAK,GAAG,eAAe,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;IAEzD,OAAO,WAAW,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC,OAAO,EAAE,CAAC;AACpD,CAAC;AAED,SAAS,qBAAqB,CAAC,CAAS;IACtC,OAAO,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;AACzC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,cAAc,CAAC,OAA4C;IACzE,MAAM,GAAG,GAAG,IAAI,GAAG,EAAkB,CAAC;IACtC,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,mBAAmB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACzC,MAAM,QAAQ,GAAG,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,wBAAwB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACnE,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACjB,GAAG,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,QAAQ,CAAC,CAAC;IAC/C,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seanmars/tospec",
-  "version": "0.17.0",
+  "version": "0.19.0-beta.0",
   "description": "Spec-driven development CLI for structured requirements and issue workflows",
   "license": "MIT",
   "homepage": "https://www.npmjs.com/package/@seanmars/tospec",
@@ -42,6 +42,7 @@
     "@inquirer/core": "^11.2.1",
     "@inquirer/prompts": "^8.5.2",
     "commander": "^15.0.0",
+    "diff": "^9.0.0",
     "fast-glob": "^3.3.3",
     "marked": "^18.0.6",
     "yaml": "^2.9.0",