@seanmars/tospec 0.19.0-beta.8 → 0.21.0

package/dist/utils/item-discovery.js

@@ -3,17 +3,12 @@ import path from 'path';
 import { frontmatterString } from './frontmatter.js';
 /**
  * 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.
+ * names this change, oldest first (the filename is the `yyyyMMdd_HHmmss` stamp).
+ * Non-recursive, so `tickets/archive/` is excluded.
  *
- * 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.
+ * Plural because the index can hold more than one: `rm -rf` on a change leaves
+ * its ticket behind, and recreating the name adds a second. Callers that can
+ * report the ambiguity should; `findTicketPath` picks for the rest.
  */
 export async function findTicketPaths(root, changeName) {
     const ticketsPath = path.join(root, 'tospec', 'tickets');
@@ -41,29 +36,20 @@ export async function findTicketPaths(root, changeName) {
     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).
+ * the later stamp describes the change on disk. Taking the first `readdir` entry
+ * files the run under the abandoned attempt's ticket.
  */
 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`
- * and dot-directories. The one rule for "which changes exist": list, archive
- * and status each filtered slightly differently, so a stray `.tmp/` showed up
- * in some listings and not others.
- */
-export async function listActiveChangeDirs(changesDir) {
+/** Sorted names of the non-dot subdirectories of `dir`; [] when it cannot be read. */
+async function listSubdirectories(dir) {
     try {
-        const entries = await fs.readdir(changesDir, { withFileTypes: true });
+        const entries = await fs.readdir(dir, { withFileTypes: true });
         return entries
-            .filter((entry) => entry.isDirectory() && !entry.name.startsWith('.') && entry.name !== 'archive')
+            .filter((entry) => entry.isDirectory() && !entry.name.startsWith('.'))
             .map((entry) => entry.name)
             .sort();
     }
@@ -71,43 +57,33 @@ export async function listActiveChangeDirs(changesDir) {
         return [];
     }
 }
+/**
+ * The one rule for "which changes exist". Filtered separately per command, a
+ * stray `.tmp/` shows up in some listings and not others.
+ */
+export async function listActiveChangeDirs(changesDir) {
+    const names = await listSubdirectories(changesDir);
+    return names.filter((name) => name !== 'archive');
+}
 export async function getActiveChangeIds(root = process.cwd()) {
     return listActiveChangeDirs(path.join(root, 'tospec', 'changes'));
 }
+/** A capability directory counts as a spec only once it holds a `spec.md`. */
 export async function getSpecIds(root = process.cwd()) {
     const specsPath = path.join(root, 'tospec', 'specs');
-    const result = [];
-    try {
-        const entries = await fs.readdir(specsPath, { withFileTypes: true });
-        for (const entry of entries) {
-            if (!entry.isDirectory() || entry.name.startsWith('.'))
-                continue;
-            const specFile = path.join(specsPath, entry.name, 'spec.md');
-            try {
-                await fs.access(specFile);
-                result.push(entry.name);
-            }
-            catch {
-                // ignore
-            }
+    const names = await listSubdirectories(specsPath);
+    const present = await Promise.all(names.map(async (name) => {
+        try {
+            await fs.access(path.join(specsPath, name, 'spec.md'));
+            return name;
         }
-    }
-    catch {
-        // ignore
-    }
-    return result.sort();
+        catch {
+            return null;
+        }
+    }));
+    return present.filter((name) => name !== null);
 }
 export async function getArchivedChangeIds(root = process.cwd()) {
-    const archivePath = path.join(root, 'tospec', 'changes', 'archive');
-    try {
-        const entries = await fs.readdir(archivePath, { withFileTypes: true });
-        return entries
-            .filter((entry) => entry.isDirectory() && !entry.name.startsWith('.'))
-            .map((entry) => entry.name)
-            .sort();
-    }
-    catch {
-        return [];
-    }
+    return listSubdirectories(path.join(root, 'tospec', 'changes', 'archive'));
 }
 //# sourceMappingURL=item-discovery.js.map

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":"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"}

package/dist/utils/link.d.ts

@@ -1,26 +1,17 @@
 /**
  * How init/update deliver skill dirs from the canonical `.agents/skills/` into
- * each dependent tool's directory.
- *
- * Copying, deliberately, and not a link of any kind — see
- * tospec/decisions/20260914_205300-copy-dependent-skill-dirs-for-cross-platform-teams.md.
- * A link has no cross-platform spelling: Windows needs a junction (git walks
- * through it and records ordinary files) while POSIX gets a symlink (git records
- * mode 120000 holding the target path). A repository that commits its generated
- * skills therefore ends up with tracked content that depends on which OS last
- * ran the command, and a 120000 blob checked out with `core.symlinks=false`
- * becomes a text file where a skill directory belongs, loading nothing. Live
- * edit propagation is not worth a mixed-platform team trading diffs over it.
+ * each dependent tool's directory: a copy, never a link. A link has no
+ * cross-platform spelling (Windows junction vs POSIX symlink record differently
+ * in git), so a repo committing its generated skills would track content that
+ * depends on which OS last ran the command.
+ * tospec/decisions/20260914_205300-copy-dependent-skill-dirs-for-cross-platform-teams.md
  */
 /**
  * Recursively copies a directory, replacing any existing dest. The `rm` first
- * is what makes it a replace rather than a merge: `cp` alone would leave
- * files that the source no longer generates.
- *
- * It is also the migration off the link era: `fs.rm(recursive)` on a junction or
- * symlink unlinks it and leaves the target intact, so a project whose tool dirs
- * are still links becomes plain copies on the next `tospec update`, with no
- * separate migration step and no risk to the canonical directory.
+ * makes it a replace rather than a merge, since `cp` alone leaves files the
+ * source no longer generates. It is also the migration off the link era:
+ * `fs.rm(recursive)` on a junction or symlink unlinks it and leaves the target
+ * intact, so link-based tool dirs become plain copies on the next update.
  */
 export declare function copyDir(src: string, dest: string): Promise<void>;
 //# sourceMappingURL=link.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"link.d.ts","sourceRoot":"","sources":["../../src/utils/link.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH;;;;;;;;;GASG;AACH,wBAAsB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGtE"}
+{"version":3,"file":"link.d.ts","sourceRoot":"","sources":["../../src/utils/link.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH;;;;;;GAMG;AACH,wBAAsB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGtE"}

package/dist/utils/link.js

@@ -1,27 +1,18 @@
 /**
  * How init/update deliver skill dirs from the canonical `.agents/skills/` into
- * each dependent tool's directory.
- *
- * Copying, deliberately, and not a link of any kind — see
- * tospec/decisions/20260914_205300-copy-dependent-skill-dirs-for-cross-platform-teams.md.
- * A link has no cross-platform spelling: Windows needs a junction (git walks
- * through it and records ordinary files) while POSIX gets a symlink (git records
- * mode 120000 holding the target path). A repository that commits its generated
- * skills therefore ends up with tracked content that depends on which OS last
- * ran the command, and a 120000 blob checked out with `core.symlinks=false`
- * becomes a text file where a skill directory belongs, loading nothing. Live
- * edit propagation is not worth a mixed-platform team trading diffs over it.
+ * each dependent tool's directory: a copy, never a link. A link has no
+ * cross-platform spelling (Windows junction vs POSIX symlink record differently
+ * in git), so a repo committing its generated skills would track content that
+ * depends on which OS last ran the command.
+ * tospec/decisions/20260914_205300-copy-dependent-skill-dirs-for-cross-platform-teams.md
  */
 import * as fs from 'node:fs';
 /**
  * Recursively copies a directory, replacing any existing dest. The `rm` first
- * is what makes it a replace rather than a merge: `cp` alone would leave
- * files that the source no longer generates.
- *
- * It is also the migration off the link era: `fs.rm(recursive)` on a junction or
- * symlink unlinks it and leaves the target intact, so a project whose tool dirs
- * are still links becomes plain copies on the next `tospec update`, with no
- * separate migration step and no risk to the canonical directory.
+ * makes it a replace rather than a merge, since `cp` alone leaves files the
+ * source no longer generates. It is also the migration off the link era:
+ * `fs.rm(recursive)` on a junction or symlink unlinks it and leaves the target
+ * intact, so link-based tool dirs become plain copies on the next update.
  */
 export async function copyDir(src, dest) {
     await fs.promises.rm(dest, { recursive: true, force: true });

package/dist/utils/link.js.map

@@ -1 +1 @@
-{"version":3,"file":"link.js","sourceRoot":"","sources":["../../src/utils/link.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAE9B;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,GAAW,EAAE,IAAY;IACrD,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7D,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,CAAC,CAAC;AAC/E,CAAC"}
+{"version":3,"file":"link.js","sourceRoot":"","sources":["../../src/utils/link.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAE9B;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,GAAW,EAAE,IAAY;IACrD,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7D,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,gBAAgB,EAAE,IAAI,EAAE,CAAC,CAAC;AAC/E,CAAC"}

package/dist/utils/requirement-diff.d.ts

@@ -1,10 +1,8 @@
 /**
- * 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.
+ * Requirement-level diffing for `tospec show <change> --diff`. A MODIFIED block
+ * restates the whole requirement, so reading one says nothing about which line
+ * moved; pairing it with its main-spec counterpart makes a delta reviewable
+ * without opening two files side by side.
  */
 /** A main-spec requirement block, and how its header matched the delta's. */
 export interface MatchedRequirementBlock {
@@ -19,29 +17,21 @@ export interface MatchedRequirementBlock {
     exact: boolean;
 }
 /**
- * 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.
+ * Null when no header matches either way. Exact lookup first, then the shared
+ * case/whitespace fold, so a header differing only in spelling still shows its diff
+ * — flagged inexact rather than silently treated as a match.
  */
 export declare function extractRequirementBlock(specContent: string, requirementName: string): MatchedRequirementBlock | null;
 /**
- * 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.
+ * A unified diff between a main-spec requirement block and the delta block replacing
+ * it. A null main block diffs against the empty string, so every line reads as an
+ * addition. File headers are omitted because the caller labels the block itself.
  */
 export declare function diffRequirementBlock(baseBlock: string | null, deltaBlock: string, label: string): string;
 /**
- * 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.
+ * 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.
  */
 export declare function buildRenameMap(renames: Array<{
     from: string;

package/dist/utils/requirement-diff.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"requirement-diff.d.ts","sourceRoot":"","sources":["../../src/utils/requirement-diff.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AASH,6EAA6E;AAC7E,MAAM,WAAW,uBAAuB;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,MAAM,EACnB,eAAe,EAAE,MAAM,GACtB,uBAAuB,GAAG,IAAI,CAiBhC;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,GACZ,MAAM,CAMR;AAMD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAShG"}
+{"version":3,"file":"requirement-diff.d.ts","sourceRoot":"","sources":["../../src/utils/requirement-diff.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,6EAA6E;AAC7E,MAAM,WAAW,uBAAuB;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,MAAM,EACnB,eAAe,EAAE,MAAM,GACtB,uBAAuB,GAAG,IAAI,CAiBhC;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,GACZ,MAAM,CAMR;AAMD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAShG"}

package/dist/utils/requirement-diff.js

@@ -1,21 +1,15 @@
 /**
- * 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.
+ * Requirement-level diffing for `tospec show <change> --diff`. A MODIFIED block
+ * restates the whole requirement, so reading one says nothing about which line
+ * moved; pairing it with its main-spec counterpart makes a delta reviewable
+ * 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.
+ * Null when no header matches either way. Exact lookup first, then the shared
+ * case/whitespace fold, so a header differing 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);
@@ -34,12 +28,9 @@ export function extractRequirementBlock(specContent, requirementName) {
     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.
+ * A unified diff between a main-spec requirement block and the delta block replacing
+ * it. A null main block diffs against the empty string, so every line reads as an
+ * addition. File headers are omitted because the caller labels the block itself.
  */
 export function diffRequirementBlock(baseBlock, deltaBlock, label) {
     const base = ensureTrailingNewline(baseBlock ?? '');
@@ -51,10 +42,9 @@ 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.
+ * 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.
  */
 export function buildRenameMap(renames) {
     const map = new Map();

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

@@ -1 +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"}
+{"version":3,"file":"requirement-diff.js","sourceRoot":"","sources":["../../src/utils/requirement-diff.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;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;;;;GAIG;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;;;;GAIG;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;;;;GAIG;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/dist/utils/spec-files.d.ts

@@ -1,31 +1,18 @@
 /**
  * Every `spec.md` under a change's `specs/` directory, at any depth.
  *
- * Deliberately recursive even though the supported layout is exactly
+ * Recursive even though the supported layout is exactly
  * `specs/<capability>/spec.md`: the merge path reads one level, so anything
- * deeper is a file that would be applied by nobody. Finding it is what lets the
- * validator report it and archive refuse — the original defect was that the
- * merge path and the discovery path each answered "is there a delta spec here"
- * on their own, and disagreed silently.
- *
- * Shared so that answer has exactly one definition. See
+ * 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
- *
- * Returns absolute paths, sorted by code point for deterministic issue ordering
- * (not localeCompare — that follows the process ICU locale and would order
- * 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.
+ * Every `*.md` under a change's `specs/` directory, at any depth. Unlike
+ * {@link findSpecFiles} the basename is not filtered, so the validator can
+ * report a file whose mistake is a wrong *basename*. The merge path
+ * (`findSpecUpdates`) must keep reading only `spec.md`.
  */
 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;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAsB9E"}
+{"version":3,"file":"spec-files.d.ts","sourceRoot":"","sources":["../../src/utils/spec-files.ts"],"names":[],"mappings":"AAiCA;;;;;;;;GAQG;AACH,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAEvE;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAE9E"}

package/dist/utils/spec-files.js

@@ -1,78 +1,53 @@
 import { promises as fs } from 'node:fs';
 import path from 'node:path';
 /**
- * Every `spec.md` under a change's `specs/` directory, at any depth.
- *
- * Deliberately recursive even though the supported layout is exactly
- * `specs/<capability>/spec.md`: the merge path reads one level, so anything
- * deeper is a file that would be applied by nobody. Finding it is what lets the
- * validator report it and archive refuse — the original defect was that the
- * merge path and the discovery path each answered "is there a delta spec here"
- * on their own, and disagreed silently.
- *
- * Shared so that answer has exactly one definition. See
- * tospec/decisions/20260730_014309-delta-spec-layout-one-level.md
- *
- * Returns absolute paths, sorted by code point for deterministic issue ordering
- * (not localeCompare — that follows the process ICU locale and would order
- * differently on CI than locally).
+ * 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".
  */
-export async function findSpecFiles(specsDir) {
+async function findFiles(dir, accept) {
     const results = [];
-    const walk = async (dir) => {
+    const walk = async (current) => {
         let entries;
         try {
-            entries = await fs.readdir(dir, { withFileTypes: true });
+            entries = await fs.readdir(current, { withFileTypes: true });
         }
         catch {
-            // A missing or unreadable specs/ means "no delta specs" to every caller.
             return;
         }
         for (const entry of entries) {
-            const full = path.join(dir, entry.name);
+            const full = path.join(current, entry.name);
             if (entry.isDirectory()) {
                 await walk(full);
             }
-            else if (entry.isFile() && entry.name === 'spec.md') {
+            else if (entry.isFile() && accept(entry.name)) {
                 results.push(full);
             }
         }
     };
-    await walk(specsDir);
+    await walk(dir);
     return results.sort();
 }
 /**
- * Every `*.md` under a change's `specs/` directory, at any depth — unlike
- * {@link findSpecFiles}, basename is not filtered.
+ * Every `spec.md` under a change's `specs/` directory, at any depth.
  *
- * 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.
+ * Recursive even though the supported layout is exactly
+ * `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');
+}
+/**
+ * Every `*.md` under a change's `specs/` directory, at any depth. Unlike
+ * {@link findSpecFiles} the basename is not filtered, so the validator can
+ * report a file whose mistake is a wrong *basename*. The merge path
+ * (`findSpecUpdates`) must keep reading only `spec.md`.
  */
 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();
+    return findFiles(specsDir, (name) => name.toLowerCase().endsWith('.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;;;;;;;;;;;;;;;;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"}
+{"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"}

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

@@ -13,18 +13,14 @@ export interface TaskItem extends ParsedTask {
 }
 export declare function parseTasksFromContent(content: string): ParsedTask[];
 /**
- * Absolute paths of the files holding a change's tracked tasks: every file
- * matched by the tracked-tasks artifact's `generates` glob — the same
- * file-resolution `tospec status` uses (`resolveArtifactOutputs`) — so tasks are
- * no longer blind to nested `tasks.md` files (#1202). Falls back to a single
- * top-level `tasks.md` when the schema is unresolvable, no tracked-tasks
- * artifact is found, or the glob matches no file.
+ * Absolute paths of the files holding a change's tracked tasks, through the same
+ * `resolveArtifactOutputs` glob resolution `tospec status` uses. Falls back to a
+ * single top-level `tasks.md` when nothing resolves.
  */
 export declare function resolveTaskFiles(changeDir: string, projectRoot: string): string[];
 /**
- * Lists every task of a change, in file order. Files that can't be read (absent
- * `tasks.md`, or vanished between glob and read) contribute nothing rather than
- * throwing.
+ * Every task of a change, in file order. Files that cannot be read contribute
+ * nothing rather than throwing.
  */
 export declare function listTasksForChange(changesDir: string, changeName: string, projectRoot: string): Promise<TaskItem[]>;
 /** Computes a change's task progress across its tracked task files. Never throws. */
@@ -36,5 +32,11 @@ export declare function getTaskProgressForChange(changesDir: string, changeName:
  * 409, which is what a stale client sees when the file moved under it.
  */
 export declare function setTaskDone(file: string, line: number, done: boolean): Promise<void>;
+/**
+ * "Tasks done", not "Complete": this counts checkboxes, while `tospec status`
+ * answers whether the change's artifacts exist. A change with only a finished
+ * `tasks.md` read as `✓ Complete` in `list` and `1/4 artifacts complete` in
+ * `status`, and the word was what made them look contradictory.
+ */
 export declare function formatTaskStatus(progress: TaskProgress): string;
 //# sourceMappingURL=task-progress.d.ts.map

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":"AAiBA,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,CAanE;AAgCD;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAOjF;AAED;;;;GAIG;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,CAY1F;AAED,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":"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"}