@context-forge/core 0.8.6 → 0.9.0

package/dist/introspection/parsers/slicePlanParser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"slicePlanParser.d.ts","sourceRoot":"","sources":["../../../src/introspection/parsers/slicePlanParser.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAkB,eAAe,EAAE,MAAM,aAAa,CAAC;AAqBnE;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAqE/E"}
+{"version":3,"file":"slicePlanParser.d.ts","sourceRoot":"","sources":["../../../src/introspection/parsers/slicePlanParser.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAkB,eAAe,EAAE,MAAM,aAAa,CAAC;AAqBnE;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAuE/E"}

package/dist/introspection/parsers/slicePlanParser.js

@@ -1,4 +1,5 @@
 import { readFile } from 'node:fs/promises';
+import { STATUS } from '../types.js';
 /** Matches `N. [ ] **(NNN) Slice Name** — description` — indexed format */
 const PLAN_INDEXED_RE = /^(\d+)\.\s+\[([ xX])\]\s+\*\*\((\d+)\)\s+(.+?)\*\*\s*(.*)/;
 /** Matches `N. [ ] **Slice Name** — description` — unindexed format (no parenthesized index) */
@@ -47,9 +48,10 @@ export async function parseSlicePlan(filePath) {
                 entries.push({
                     index: parseInt(indexed[3], 10),
                     name: indexed[4].trim(),
-                    status: isChecked ? 'complete' : 'not-started',
+                    status: isChecked ? STATUS.Complete : STATUS.NotStarted,
                     isChecked,
                     lineIndex: i,
+                    indexSource: 'explicit',
                     ...(description && { description }),
                 });
                 continue;
@@ -63,9 +65,10 @@ export async function parseSlicePlan(filePath) {
                 entries.push({
                     index: unindexedCounter,
                     name: unindexed[3].trim(),
-                    status: isChecked ? 'complete' : 'not-started',
+                    status: isChecked ? STATUS.Complete : STATUS.NotStarted,
                     isChecked,
                     lineIndex: i,
+                    indexSource: 'fallback',
                     ...(description && { description }),
                 });
             }

package/dist/introspection/parsers/slicePlanParser.js.map

@@ -1 +1 @@
-{"version":3,"file":"slicePlanParser.js","sourceRoot":"","sources":["../../../src/introspection/parsers/slicePlanParser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAG5C,2EAA2E;AAC3E,MAAM,eAAe,GAAG,2DAA2D,CAAC;AAEpF,gGAAgG;AAChG,MAAM,iBAAiB,GAAG,mDAAmD,CAAC;AAE9E,mCAAmC;AACnC,MAAM,UAAU,GAAG,YAAY,CAAC;AAEhC,iDAAiD;AACjD,MAAM,kBAAkB,GAAG,CAAC,aAAa,EAAE,sBAAsB,EAAE,OAAO,EAAE,iBAAiB,CAAC,CAAC;AAE/F,oEAAoE;AACpE,SAAS,gBAAgB,CAAC,GAAuB;IAC/C,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAC;IAC3B,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACpD,OAAO,OAAO,IAAI,SAAS,CAAC;AAC9B,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,QAAgB;IACnD,MAAM,KAAK,GAAoB,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,EAAE,WAAW,EAAE,CAAC,EAAE,eAAe,EAAE,CAAC,EAAE,CAAC;IAE7F,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAClD,MAAM,OAAO,GAAqB,EAAE,CAAC;QACrC,IAAI,cAAc,GAAG,IAAI,CAAC;QAC1B,IAAI,gBAAgB,GAAG,CAAC,CAAC;QAEzB,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAClC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAEjC,IAAI,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC9B,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;gBAC7D,cAAc,GAAG,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC;gBAC1E,SAAS;YACX,CAAC;YAED,IAAI,CAAC,cAAc;gBAAE,SAAS;YAE9B,uCAAuC;YACvC,MAAM,OAAO,GAAG,eAAe,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC/C,IAAI,OAAO,EAAE,CAAC;gBACZ,MAAM,SAAS,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,GAAG,CAAC;gBACnD,MAAM,WAAW,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;gBACjD,OAAO,CAAC,IAAI,CAAC;oBACX,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;oBAC/B,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE;oBACvB,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,aAAa;oBAC9C,SAAS;oBACT,SAAS,EAAE,CAAC;oBACZ,GAAG,CAAC,WAAW,IAAI,EAAE,WAAW,EAAE,CAAC;iBACpC,CAAC,CAAC;gBACH,SAAS;YACX,CAAC;YAED,kEAAkE;YAClE,MAAM,SAAS,GAAG,iBAAiB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACnD,IAAI,SAAS,EAAE,CAAC;gBACd,gBAAgB,EAAE,CAAC;gBACnB,MAAM,SAAS,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,GAAG,CAAC;gBACrD,MAAM,WAAW,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;gBACnD,OAAO,CAAC,IAAI,CAAC;oBACX,KAAK,EAAE,gBAAgB;oBACvB,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE;oBACzB,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,aAAa;oBAC9C,SAAS;oBACT,SAAS,EAAE,CAAC;oBACZ,GAAG,CAAC,WAAW,IAAI,EAAE,WAAW,EAAE,CAAC;iBACpC,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,4EAA4E;QAC5E,yEAAyE;QACzE,8EAA8E;QAC9E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;QAE1C,MAAM,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC;QAClE,OAAO;YACL,QAAQ;YACR,OAAO;YACP,WAAW,EAAE,OAAO,CAAC,MAAM;YAC3B,eAAe;SAChB,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}
+{"version":3,"file":"slicePlanParser.js","sourceRoot":"","sources":["../../../src/introspection/parsers/slicePlanParser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGrC,2EAA2E;AAC3E,MAAM,eAAe,GAAG,2DAA2D,CAAC;AAEpF,gGAAgG;AAChG,MAAM,iBAAiB,GAAG,mDAAmD,CAAC;AAE9E,mCAAmC;AACnC,MAAM,UAAU,GAAG,YAAY,CAAC;AAEhC,iDAAiD;AACjD,MAAM,kBAAkB,GAAG,CAAC,aAAa,EAAE,sBAAsB,EAAE,OAAO,EAAE,iBAAiB,CAAC,CAAC;AAE/F,oEAAoE;AACpE,SAAS,gBAAgB,CAAC,GAAuB;IAC/C,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAC;IAC3B,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACpD,OAAO,OAAO,IAAI,SAAS,CAAC;AAC9B,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,QAAgB;IACnD,MAAM,KAAK,GAAoB,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,EAAE,WAAW,EAAE,CAAC,EAAE,eAAe,EAAE,CAAC,EAAE,CAAC;IAE7F,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAClD,MAAM,OAAO,GAAqB,EAAE,CAAC;QACrC,IAAI,cAAc,GAAG,IAAI,CAAC;QAC1B,IAAI,gBAAgB,GAAG,CAAC,CAAC;QAEzB,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAClC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAEjC,IAAI,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC9B,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;gBAC7D,cAAc,GAAG,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC;gBAC1E,SAAS;YACX,CAAC;YAED,IAAI,CAAC,cAAc;gBAAE,SAAS;YAE9B,uCAAuC;YACvC,MAAM,OAAO,GAAG,eAAe,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC/C,IAAI,OAAO,EAAE,CAAC;gBACZ,MAAM,SAAS,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,GAAG,CAAC;gBACnD,MAAM,WAAW,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;gBACjD,OAAO,CAAC,IAAI,CAAC;oBACX,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;oBAC/B,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE;oBACvB,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU;oBACvD,SAAS;oBACT,SAAS,EAAE,CAAC;oBACZ,WAAW,EAAE,UAAU;oBACvB,GAAG,CAAC,WAAW,IAAI,EAAE,WAAW,EAAE,CAAC;iBACpC,CAAC,CAAC;gBACH,SAAS;YACX,CAAC;YAED,kEAAkE;YAClE,MAAM,SAAS,GAAG,iBAAiB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACnD,IAAI,SAAS,EAAE,CAAC;gBACd,gBAAgB,EAAE,CAAC;gBACnB,MAAM,SAAS,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,GAAG,CAAC;gBACrD,MAAM,WAAW,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;gBACnD,OAAO,CAAC,IAAI,CAAC;oBACX,KAAK,EAAE,gBAAgB;oBACvB,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE;oBACzB,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU;oBACvD,SAAS;oBACT,SAAS,EAAE,CAAC;oBACZ,WAAW,EAAE,UAAU;oBACvB,GAAG,CAAC,WAAW,IAAI,EAAE,WAAW,EAAE,CAAC;iBACpC,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,4EAA4E;QAC5E,yEAAyE;QACzE,8EAA8E;QAC9E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;QAE1C,MAAM,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC;QAClE,OAAO;YACL,QAAQ;YACR,OAAO;YACP,WAAW,EAAE,OAAO,CAAC,MAAM;YAC3B,eAAe;SAChB,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/introspection/parsers/statusNormalizer.d.ts

@@ -1,4 +1,12 @@
 import type { NormalizedStatus } from '../types.js';
-/** Normalize a raw status string to one of the canonical values */
-export declare function normalizeStatus(raw: string | undefined | null): NormalizedStatus;
+/**
+ * Normalize a raw status string to one of the canonical values.
+ *
+ * Returns `undefined` when the input was present but not recognized —
+ * this is distinct from a real `not-started` and must not be conflated
+ * with it. `deferred` is intentionally absent from `STATUS_MAP` (it has
+ * no `NormalizedStatus` equivalent) and therefore also normalizes to
+ * `undefined`.
+ */
+export declare function normalizeStatus(raw: string | undefined | null): NormalizedStatus | undefined;
 //# sourceMappingURL=statusNormalizer.d.ts.map

package/dist/introspection/parsers/statusNormalizer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"statusNormalizer.d.ts","sourceRoot":"","sources":["../../../src/introspection/parsers/statusNormalizer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAoBpD,mEAAmE;AACnE,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,gBAAgB,CAGhF"}
+{"version":3,"file":"statusNormalizer.d.ts","sourceRoot":"","sources":["../../../src/introspection/parsers/statusNormalizer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAoBpD;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,gBAAgB,GAAG,SAAS,CAG5F"}

package/dist/introspection/parsers/statusNormalizer.js

@@ -1,23 +1,32 @@
+import { STATUS } from '../types.js';
 /** Maps variant status spellings to normalized values (ported from parse.py _STATUS) */
 const STATUS_MAP = {
-    complete: 'complete',
-    completed: 'complete',
-    done: 'complete',
-    in_progress: 'in-progress',
-    'in-progress': 'in-progress',
-    'in progress': 'in-progress',
-    active: 'in-progress',
-    not_started: 'not-started',
-    'not-started': 'not-started',
-    'not started': 'not-started',
-    ready: 'not-started',
-    pending: 'not-started',
-    planned: 'not-started',
-    deprecated: 'deprecated',
+    complete: STATUS.Complete,
+    completed: STATUS.Complete,
+    done: STATUS.Complete,
+    in_progress: STATUS.InProgress,
+    'in-progress': STATUS.InProgress,
+    'in progress': STATUS.InProgress,
+    active: STATUS.InProgress,
+    not_started: STATUS.NotStarted,
+    'not-started': STATUS.NotStarted,
+    'not started': STATUS.NotStarted,
+    ready: STATUS.NotStarted,
+    pending: STATUS.NotStarted,
+    planned: STATUS.NotStarted,
+    deprecated: STATUS.Deprecated,
 };
-/** Normalize a raw status string to one of the canonical values */
+/**
+ * Normalize a raw status string to one of the canonical values.
+ *
+ * Returns `undefined` when the input was present but not recognized —
+ * this is distinct from a real `not-started` and must not be conflated
+ * with it. `deferred` is intentionally absent from `STATUS_MAP` (it has
+ * no `NormalizedStatus` equivalent) and therefore also normalizes to
+ * `undefined`.
+ */
 export function normalizeStatus(raw) {
     const key = (raw ?? '').toLowerCase().trim();
-    return STATUS_MAP[key] ?? 'not-started';
+    return STATUS_MAP[key];
 }
 //# sourceMappingURL=statusNormalizer.js.map

package/dist/introspection/parsers/statusNormalizer.js.map

@@ -1 +1 @@
-{"version":3,"file":"statusNormalizer.js","sourceRoot":"","sources":["../../../src/introspection/parsers/statusNormalizer.ts"],"names":[],"mappings":"AAEA,wFAAwF;AACxF,MAAM,UAAU,GAAqC;IACnD,QAAQ,EAAE,UAAU;IACpB,SAAS,EAAE,UAAU;IACrB,IAAI,EAAE,UAAU;IAChB,WAAW,EAAE,aAAa;IAC1B,aAAa,EAAE,aAAa;IAC5B,aAAa,EAAE,aAAa;IAC5B,MAAM,EAAE,aAAa;IACrB,WAAW,EAAE,aAAa;IAC1B,aAAa,EAAE,aAAa;IAC5B,aAAa,EAAE,aAAa;IAC5B,KAAK,EAAE,aAAa;IACpB,OAAO,EAAE,aAAa;IACtB,OAAO,EAAE,aAAa;IACtB,UAAU,EAAE,YAAY;CACzB,CAAC;AAEF,mEAAmE;AACnE,MAAM,UAAU,eAAe,CAAC,GAA8B;IAC5D,MAAM,GAAG,GAAG,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;IAC7C,OAAO,UAAU,CAAC,GAAG,CAAC,IAAI,aAAa,CAAC;AAC1C,CAAC"}
+{"version":3,"file":"statusNormalizer.js","sourceRoot":"","sources":["../../../src/introspection/parsers/statusNormalizer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGrC,wFAAwF;AACxF,MAAM,UAAU,GAAqC;IACnD,QAAQ,EAAE,MAAM,CAAC,QAAQ;IACzB,SAAS,EAAE,MAAM,CAAC,QAAQ;IAC1B,IAAI,EAAE,MAAM,CAAC,QAAQ;IACrB,WAAW,EAAE,MAAM,CAAC,UAAU;IAC9B,aAAa,EAAE,MAAM,CAAC,UAAU;IAChC,aAAa,EAAE,MAAM,CAAC,UAAU;IAChC,MAAM,EAAE,MAAM,CAAC,UAAU;IACzB,WAAW,EAAE,MAAM,CAAC,UAAU;IAC9B,aAAa,EAAE,MAAM,CAAC,UAAU;IAChC,aAAa,EAAE,MAAM,CAAC,UAAU;IAChC,KAAK,EAAE,MAAM,CAAC,UAAU;IACxB,OAAO,EAAE,MAAM,CAAC,UAAU;IAC1B,OAAO,EAAE,MAAM,CAAC,UAAU;IAC1B,UAAU,EAAE,MAAM,CAAC,UAAU;CAC9B,CAAC;AAEF;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAAC,GAA8B;IAC5D,MAAM,GAAG,GAAG,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC;IAC7C,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC"}

package/dist/introspection/parsers/taskFileParser.d.ts

@@ -1,13 +1,17 @@
 import type { TaskItem, TaskFileResult } from '../types.js';
 /**
  * Extract checkbox items from a single task file.
- * Never throws — returns empty array on error.
+ * A missing file (ENOENT) is a normal "no task file" signal and returns an
+ * empty array. Any other read failure (permission denied, EISDIR, etc.) is a
+ * genuine resolution failure and propagates — callers must not conflate it
+ * with "no task file" (TD-2a: a resolution failure is never coerced to absent).
  */
 export declare function parseTaskItems(filePath: string): Promise<TaskItem[]>;
 /**
  * Parse one or more task files, merge items, compute counts and inferred status.
  * For multiple files (split support): merge items in path order, use first file's path.
- * Never throws — returns empty result on error.
+ * Propagates a genuine read failure from parseTaskItems (see above); only a
+ * missing file is treated as "no tasks".
  */
 export declare function parseTaskFile(filePaths: string | string[]): Promise<TaskFileResult>;
 //# sourceMappingURL=taskFileParser.d.ts.map

package/dist/introspection/parsers/taskFileParser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"taskFileParser.d.ts","sourceRoot":"","sources":["../../../src/introspection/parsers/taskFileParser.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAQ5D;;;GAGG;AACH,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAkB1E;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CA+BzF"}
+{"version":3,"file":"taskFileParser.d.ts","sourceRoot":"","sources":["../../../src/introspection/parsers/taskFileParser.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAQ5D;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAsB1E;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CA+BzF"}

package/dist/introspection/parsers/taskFileParser.js

@@ -1,36 +1,45 @@
 import { readFile } from 'node:fs/promises';
+import { STATUS } from '../types.js';
 /** Matches `- [ ] text` and `- [x] text` at any indentation level (from parse.py) */
 const CHECKBOX_RE = /^(?:\s*)-\s+\[([ xX])\]\s+(.+)$/;
 /** Maximum task name length before truncation (matching parse.py) */
 const MAX_NAME_LENGTH = 120;
 /**
  * Extract checkbox items from a single task file.
- * Never throws — returns empty array on error.
+ * A missing file (ENOENT) is a normal "no task file" signal and returns an
+ * empty array. Any other read failure (permission denied, EISDIR, etc.) is a
+ * genuine resolution failure and propagates — callers must not conflate it
+ * with "no task file" (TD-2a: a resolution failure is never coerced to absent).
  */
 export async function parseTaskItems(filePath) {
     const items = [];
+    let content;
     try {
-        const content = await readFile(filePath, 'utf-8');
-        for (const line of content.split('\n')) {
-            const m = CHECKBOX_RE.exec(line);
-            if (m) {
-                let name = m[2].trim();
-                if (name.length > MAX_NAME_LENGTH) {
-                    name = name.slice(0, MAX_NAME_LENGTH - 3) + '...';
-                }
-                items.push({ name, done: m[1].toLowerCase() === 'x' });
-            }
+        content = await readFile(filePath, 'utf-8');
+    }
+    catch (err) {
+        if (err instanceof Error && 'code' in err && err.code === 'ENOENT') {
+            return items;
         }
+        throw err;
     }
-    catch {
-        // Missing/unreadable file: return empty
+    for (const line of content.split('\n')) {
+        const m = CHECKBOX_RE.exec(line);
+        if (m) {
+            let name = m[2].trim();
+            if (name.length > MAX_NAME_LENGTH) {
+                name = name.slice(0, MAX_NAME_LENGTH - 3) + '...';
+            }
+            items.push({ name, done: m[1].toLowerCase() === 'x' });
+        }
     }
     return items;
 }
 /**
  * Parse one or more task files, merge items, compute counts and inferred status.
  * For multiple files (split support): merge items in path order, use first file's path.
- * Never throws — returns empty result on error.
+ * Propagates a genuine read failure from parseTaskItems (see above); only a
+ * missing file is treated as "no tasks".
  */
 export async function parseTaskFile(filePaths) {
     const paths = Array.isArray(filePaths) ? filePaths : [filePaths];
@@ -44,16 +53,16 @@ export async function parseTaskFile(filePaths) {
     const completedTasks = allItems.filter((item) => item.done).length;
     let inferredStatus;
     if (totalTasks === 0) {
-        inferredStatus = 'not-started';
+        inferredStatus = STATUS.NotStarted;
     }
     else if (completedTasks === totalTasks) {
-        inferredStatus = 'complete';
+        inferredStatus = STATUS.Complete;
     }
     else if (completedTasks > 0) {
-        inferredStatus = 'in-progress';
+        inferredStatus = STATUS.InProgress;
     }
     else {
-        inferredStatus = 'not-started';
+        inferredStatus = STATUS.NotStarted;
     }
     return {
         filePath: primaryPath,

package/dist/introspection/parsers/taskFileParser.js.map

@@ -1 +1 @@
-{"version":3,"file":"taskFileParser.js","sourceRoot":"","sources":["../../../src/introspection/parsers/taskFileParser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAG5C,qFAAqF;AACrF,MAAM,WAAW,GAAG,iCAAiC,CAAC;AAEtD,qEAAqE;AACrE,MAAM,eAAe,GAAG,GAAG,CAAC;AAE5B;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,QAAgB;IACnD,MAAM,KAAK,GAAe,EAAE,CAAC;IAC7B,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAClD,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACvC,MAAM,CAAC,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACjC,IAAI,CAAC,EAAE,CAAC;gBACN,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;gBACvB,IAAI,IAAI,CAAC,MAAM,GAAG,eAAe,EAAE,CAAC;oBAClC,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,eAAe,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC;gBACpD,CAAC;gBACD,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,GAAG,EAAE,CAAC,CAAC;YACzD,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,wCAAwC;IAC1C,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,SAA4B;IAC9D,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACjE,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAEnC,MAAM,QAAQ,GAAe,EAAE,CAAC;IAChC,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,MAAM,KAAK,GAAG,MAAM,cAAc,CAAC,CAAC,CAAC,CAAC;QACtC,QAAQ,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC;IAC1B,CAAC;IAED,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC;IACnC,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;IAEnE,IAAI,cAAgD,CAAC;IACrD,IAAI,UAAU,KAAK,CAAC,EAAE,CAAC;QACrB,cAAc,GAAG,aAAa,CAAC;IACjC,CAAC;SAAM,IAAI,cAAc,KAAK,UAAU,EAAE,CAAC;QACzC,cAAc,GAAG,UAAU,CAAC;IAC9B,CAAC;SAAM,IAAI,cAAc,GAAG,CAAC,EAAE,CAAC;QAC9B,cAAc,GAAG,aAAa,CAAC;IACjC,CAAC;SAAM,CAAC;QACN,cAAc,GAAG,aAAa,CAAC;IACjC,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,WAAW;QACrB,KAAK,EAAE,QAAQ;QACf,UAAU;QACV,cAAc;QACd,cAAc;KACf,CAAC;AACJ,CAAC"}
+{"version":3,"file":"taskFileParser.js","sourceRoot":"","sources":["../../../src/introspection/parsers/taskFileParser.ts"],"names":[],"mappings":"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"}

package/dist/introspection/reviewGate.d.ts

@@ -0,0 +1,62 @@
+import type { ConfigManager } from '../config/ConfigManager.js';
+/** Frontmatter verdict vocabulary (uppercase, untrusted external data) */
+export type Verdict = 'PASS' | 'CONCERNS' | 'FAIL' | 'UNKNOWN';
+/** Config token for the verdict floor that clears a gate (lowercase, project policy) */
+export type ThresholdToken = 'pass' | 'concerns';
+/** Config token for how to treat an UNKNOWN/absent/unparseable verdict */
+export type UnknownPolicy = 'fail' | 'concerns' | 'pass';
+/** Outcome of evaluating a present review's verdict against policy */
+export type GateOutcome = 'clears' | 'pending' | 'failed';
+/** A lifecycle boundary at which a review may be owed */
+export type Boundary = 'preSlicePlan' | 'preTasks' | 'preImplementation' | 'preAdvance';
+/** Maps a lifecycle boundary to the review type owed at that boundary. */
+export declare function positionToReviewType(boundary: Boundary): string;
+/**
+ * Normalizes a raw frontmatter verdict to the known vocabulary.
+ * Untrusted external data: anything absent or unrecognized degrades to UNKNOWN, never throws.
+ */
+export declare function normalizeVerdict(raw: string | undefined): Verdict;
+/**
+ * The verdict decision matrix (design TD-2). Returns only 'clears'/'failed' — the
+ * 'pending' outcome belongs to the caller, derived from the absent-artifact signal.
+ */
+export declare function evaluateVerdict(verdict: Verdict, threshold: ThresholdToken, unknownAs: UnknownPolicy): GateOutcome;
+/** Resolved gate policy, ready for the navigator to evaluate any boundary. */
+export interface ResolvedGate {
+    threshold: ThresholdToken;
+    unknownAs: UnknownPolicy;
+    thresholdFor(boundary: Boundary): ThresholdToken;
+    /** YYYYMMDD cutoff, or '' for no cutoff. Grandfathers artifacts dated earlier out of every boundary. */
+    effectiveDate: string;
+}
+/**
+ * Reads gate config and resolves policy. Returns null when gating is off (caller skips
+ * — no artifact lookup). A missing config file is not a failure (ConfigManager already
+ * falls through to the built-in default, i.e. gating off). A genuine read/parse failure
+ * propagates (TD-8a). An out-of-vocabulary token throws a descriptive error (TD-8b) —
+ * config is the project's own declared policy, so it fails fast rather than degrading
+ * to UNKNOWN the way an untrusted frontmatter verdict does.
+ */
+export declare function resolveGateConfig(config: ConfigManager): Promise<ResolvedGate | null>;
+/** Gated status a boundary evaluation can produce, or null to keep the caller's existing status. */
+type GateStatus = 'pending-review' | 'review-failed';
+/** Result of evaluating a gate at a boundary: the status plus a human-readable rationale. */
+export interface GateEvaluation {
+    status: GateStatus;
+    reviewType: string;
+    rationale: string;
+    /** Relative path (from projectPath) to the review artifact, when one was found.
+     *  Absent for pending-review (no artifact exists yet). Lets callers point a
+     *  finding's location at the artifact without a second detectDocuments call. */
+    artifactPath?: string;
+}
+/**
+ * Composite gate evaluation for one boundary of one slice/arch index.
+ * Returns null when gating is off OR the review clears — i.e. "nothing to flag."
+ * Returns a GateEvaluation when the review is absent (pending-review) or
+ * present-but-not-clearing (review-failed). Pure I/O over the pure helpers;
+ * both WorkflowNavigator and ConsistencyChecker call this.
+ */
+export declare function evaluateReviewGate(projectPath: string, index: number, boundary: Boundary, config: ConfigManager, resolved?: ResolvedGate): Promise<GateEvaluation | null>;
+export {};
+//# sourceMappingURL=reviewGate.d.ts.map

package/dist/introspection/reviewGate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reviewGate.d.ts","sourceRoot":"","sources":["../../src/introspection/reviewGate.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAIhE,0EAA0E;AAC1E,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG,UAAU,GAAG,MAAM,GAAG,SAAS,CAAC;AAE/D,wFAAwF;AACxF,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,UAAU,CAAC;AAEjD,0EAA0E;AAC1E,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,UAAU,GAAG,MAAM,CAAC;AAEzD,sEAAsE;AACtE,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;AAE1D,yDAAyD;AACzD,MAAM,MAAM,QAAQ,GAAG,cAAc,GAAG,UAAU,GAAG,mBAAmB,GAAG,YAAY,CAAC;AA0BxF,0EAA0E;AAC1E,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAE/D;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAIjE;AAoBD;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,OAAO,EAChB,SAAS,EAAE,cAAc,EACzB,SAAS,EAAE,aAAa,GACvB,WAAW,CAab;AAED,8EAA8E;AAC9E,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,cAAc,CAAC;IAC1B,SAAS,EAAE,aAAa,CAAC;IACzB,YAAY,CAAC,QAAQ,EAAE,QAAQ,GAAG,cAAc,CAAC;IACjD,wGAAwG;IACxG,aAAa,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAmC3F;AAED,oGAAoG;AACpG,KAAK,UAAU,GAAG,gBAAgB,GAAG,eAAe,CAAC;AAErD,6FAA6F;AAC7F,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,UAAU,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB;;oFAEgF;IAChF,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,aAAa,EACrB,QAAQ,CAAC,EAAE,YAAY,GACtB,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAwDhC"}

package/dist/introspection/reviewGate.js

@@ -0,0 +1,164 @@
+import { join } from 'node:path';
+import { detectDocuments } from './parsers/documentDetector.js';
+import { parseFrontmatter } from './parsers/frontmatterParser.js';
+/** Boundary → review type. Single source of truth: position derives the type, never configured. */
+const BOUNDARY_REVIEW_TYPE = {
+    preSlicePlan: 'arch',
+    preTasks: 'slice',
+    preImplementation: 'tasks',
+    preAdvance: 'code',
+};
+/**
+ * Per-gate threshold override config key, keyed by boundary. Mirrors ConfigKeys.ts.
+ * Key segments match BOUNDARY_REVIEW_TYPE's values (arch/slice/tasks/code), not the
+ * boundary names, for consistency with the review-type vocabulary used elsewhere.
+ */
+const BOUNDARY_THRESHOLD_KEY = {
+    preSlicePlan: 'workflow.review_gates.arch.threshold',
+    preTasks: 'workflow.review_gates.slice.threshold',
+    preImplementation: 'workflow.review_gates.tasks.threshold',
+    preAdvance: 'workflow.review_gates.code.threshold',
+};
+const KNOWN_VERDICTS = ['PASS', 'CONCERNS', 'FAIL', 'UNKNOWN'];
+const KNOWN_THRESHOLDS = ['pass', 'concerns'];
+const KNOWN_UNKNOWN_POLICIES = ['fail', 'concerns', 'pass'];
+/** Maps a lifecycle boundary to the review type owed at that boundary. */
+export function positionToReviewType(boundary) {
+    return BOUNDARY_REVIEW_TYPE[boundary];
+}
+/**
+ * Normalizes a raw frontmatter verdict to the known vocabulary.
+ * Untrusted external data: anything absent or unrecognized degrades to UNKNOWN, never throws.
+ */
+export function normalizeVerdict(raw) {
+    if (raw === undefined)
+        return 'UNKNOWN';
+    const upper = raw.trim().toUpperCase();
+    return KNOWN_VERDICTS.includes(upper) ? upper : 'UNKNOWN';
+}
+function parseThresholdToken(raw, key) {
+    if (KNOWN_THRESHOLDS.includes(raw)) {
+        return raw;
+    }
+    throw new Error(`Config key "${key}" must be one of [${KNOWN_THRESHOLDS.map((v) => `"${v}"`).join(', ')}], got "${raw}"`);
+}
+function parseUnknownPolicy(raw, key) {
+    if (KNOWN_UNKNOWN_POLICIES.includes(raw)) {
+        return raw;
+    }
+    throw new Error(`Config key "${key}" must be one of [${KNOWN_UNKNOWN_POLICIES.map((v) => `"${v}"`).join(', ')}], got "${raw}"`);
+}
+/**
+ * The verdict decision matrix (design TD-2). Returns only 'clears'/'failed' — the
+ * 'pending' outcome belongs to the caller, derived from the absent-artifact signal.
+ */
+export function evaluateVerdict(verdict, threshold, unknownAs) {
+    switch (verdict) {
+        case 'PASS':
+            return 'clears';
+        case 'FAIL':
+            return 'failed';
+        case 'CONCERNS':
+            return threshold === 'concerns' ? 'clears' : 'failed';
+        case 'UNKNOWN': {
+            const standIn = unknownAs === 'fail' ? 'FAIL' : unknownAs === 'concerns' ? 'CONCERNS' : 'PASS';
+            return evaluateVerdict(standIn, threshold, unknownAs);
+        }
+    }
+}
+/**
+ * Reads gate config and resolves policy. Returns null when gating is off (caller skips
+ * — no artifact lookup). A missing config file is not a failure (ConfigManager already
+ * falls through to the built-in default, i.e. gating off). A genuine read/parse failure
+ * propagates (TD-8a). An out-of-vocabulary token throws a descriptive error (TD-8b) —
+ * config is the project's own declared policy, so it fails fast rather than degrading
+ * to UNKNOWN the way an untrusted frontmatter verdict does.
+ */
+export async function resolveGateConfig(config) {
+    const enabled = await config.get('workflow.review_enabled');
+    if (enabled.value !== true) {
+        return null;
+    }
+    const globalThresholdRaw = await config.get('workflow.review_threshold');
+    const unknownAsRaw = await config.get('workflow.review_unknown_as');
+    const globalThreshold = parseThresholdToken(String(globalThresholdRaw.value), 'workflow.review_threshold');
+    const unknownAs = parseUnknownPolicy(String(unknownAsRaw.value), 'workflow.review_unknown_as');
+    const overrides = new Map();
+    for (const boundary of Object.keys(BOUNDARY_THRESHOLD_KEY)) {
+        const key = BOUNDARY_THRESHOLD_KEY[boundary];
+        const overrideRaw = await config.get(key);
+        const overrideValue = String(overrideRaw.value);
+        if (overrideValue !== '') {
+            overrides.set(boundary, parseThresholdToken(overrideValue, key));
+        }
+    }
+    const effectiveDateRaw = await config.get('workflow.review_gate_effective_date');
+    const effectiveDate = String(effectiveDateRaw.value);
+    return {
+        threshold: globalThreshold,
+        unknownAs,
+        effectiveDate,
+        thresholdFor(boundary) {
+            return overrides.get(boundary) ?? globalThreshold;
+        },
+    };
+}
+/**
+ * Composite gate evaluation for one boundary of one slice/arch index.
+ * Returns null when gating is off OR the review clears — i.e. "nothing to flag."
+ * Returns a GateEvaluation when the review is absent (pending-review) or
+ * present-but-not-clearing (review-failed). Pure I/O over the pure helpers;
+ * both WorkflowNavigator and ConsistencyChecker call this.
+ */
+export async function evaluateReviewGate(projectPath, index, boundary, config, resolved) {
+    const gate = resolved ?? (await resolveGateConfig(config));
+    if (gate === null)
+        return null;
+    const reviewType = positionToReviewType(boundary);
+    const docs = await detectDocuments(projectPath, index, reviewType);
+    // preSlicePlan gates an architecture index; every other boundary gates a
+    // slice index — read whichever artifact's frontmatter is relevant to this
+    // boundary, once, shared by both checks below.
+    const gatedArtifactPath = boundary === 'preSlicePlan' ? docs.architecture : docs.sliceDesign;
+    const gatedArtifactFrontmatter = gatedArtifactPath
+        ? await parseFrontmatter(join(projectPath, gatedArtifactPath))
+        : null;
+    // Effective-date grandfather cutoff: a slice/architecture designed before this
+    // date is exempt from every gate boundary, uniformly, so turning on gating on
+    // a project with existing history doesn't retroactively demand reviews for
+    // work that predates the gate. Checked before the docs-only declaration below
+    // since a grandfathered slice needs no declaration at all.
+    if (gate.effectiveDate !== '' && gatedArtifactFrontmatter) {
+        const dateCreated = gatedArtifactFrontmatter.data.dateCreated;
+        if (dateCreated && dateCreated < gate.effectiveDate) {
+            return null;
+        }
+    }
+    // Docs-only declaration (#57): a slice-design frontmatter of codeReview: none
+    // clears the pre-advance ('code') gate unconditionally — this slice cannot
+    // produce a code review. Absent (the default) leaves the gate unaffected.
+    // Scoped to preAdvance only; every other boundary evaluates normally.
+    if (boundary === 'preAdvance' && gatedArtifactFrontmatter?.data.codeReview === 'none') {
+        return null;
+    }
+    if (docs.review === null) {
+        return {
+            status: 'pending-review',
+            reviewType,
+            rationale: `Slice ${index} requires a ${reviewType} review before proceeding — no review artifact found.`,
+        };
+    }
+    const frontmatter = await parseFrontmatter(join(projectPath, docs.review));
+    const verdict = normalizeVerdict(frontmatter.data.verdict);
+    const threshold = gate.thresholdFor(boundary);
+    const outcome = evaluateVerdict(verdict, threshold, gate.unknownAs);
+    if (outcome === 'clears')
+        return null;
+    return {
+        status: 'review-failed',
+        reviewType,
+        rationale: `Review artifact present but verdict ${verdict} does not clear threshold '${threshold}' for slice ${index}.`,
+        artifactPath: docs.review,
+    };
+}
+//# sourceMappingURL=reviewGate.js.map

package/dist/introspection/reviewGate.js.map

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

package/dist/introspection/statusDerivation.d.ts

@@ -0,0 +1,23 @@
+import { type NormalizedStatus } from './types.js';
+/**
+ * Already-resolved signals for a single slice-plan entry. The caller is
+ * responsible for I/O (detectDocuments / parseTaskFile / parseFrontmatter)
+ * and for distinguishing "signal absent" (leave the field undefined) from
+ * "signal present but failed to resolve" (do not call this function with a
+ * placeholder — surface the resolution failure instead; see TD-2a).
+ */
+export interface EntryStatusSignals {
+    /** Slice-design frontmatter status, if a design exists and normalized cleanly. */
+    frontmatterStatus?: NormalizedStatus;
+    /** Task file's inferred status, if a task file exists and parsed cleanly. */
+    taskInferredStatus?: NormalizedStatus;
+    /** The slice-plan checkbox. Its only authority is asserting complete. */
+    isChecked: boolean;
+}
+/**
+ * Derive a slice-plan entry's status from the precedence lattice
+ * (highest priority first): deprecated frontmatter > computed task
+ * completion > slice-design frontmatter > plan checkbox.
+ */
+export declare function deriveEntryStatus(signals: EntryStatusSignals): NormalizedStatus;
+//# sourceMappingURL=statusDerivation.d.ts.map

package/dist/introspection/statusDerivation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"statusDerivation.d.ts","sourceRoot":"","sources":["../../src/introspection/statusDerivation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,KAAK,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAE3D;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IACjC,kFAAkF;IAClF,iBAAiB,CAAC,EAAE,gBAAgB,CAAC;IACrC,6EAA6E;IAC7E,kBAAkB,CAAC,EAAE,gBAAgB,CAAC;IACtC,yEAAyE;IACzE,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,gBAAgB,CAW/E"}

package/dist/introspection/statusDerivation.js

@@ -0,0 +1,19 @@
+import { STATUS } from './types.js';
+/**
+ * Derive a slice-plan entry's status from the precedence lattice
+ * (highest priority first): deprecated frontmatter > computed task
+ * completion > slice-design frontmatter > plan checkbox.
+ */
+export function deriveEntryStatus(signals) {
+    if (signals.frontmatterStatus === STATUS.Deprecated) {
+        return STATUS.Deprecated;
+    }
+    if (signals.taskInferredStatus !== undefined) {
+        return signals.taskInferredStatus;
+    }
+    if (signals.frontmatterStatus !== undefined) {
+        return signals.frontmatterStatus;
+    }
+    return signals.isChecked ? STATUS.Complete : STATUS.NotStarted;
+}
+//# sourceMappingURL=statusDerivation.js.map

package/dist/introspection/statusDerivation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"statusDerivation.js","sourceRoot":"","sources":["../../src/introspection/statusDerivation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAyB,MAAM,YAAY,CAAC;AAkB3D;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAA2B;IAC3D,IAAI,OAAO,CAAC,iBAAiB,KAAK,MAAM,CAAC,UAAU,EAAE,CAAC;QACpD,OAAO,MAAM,CAAC,UAAU,CAAC;IAC3B,CAAC;IACD,IAAI,OAAO,CAAC,kBAAkB,KAAK,SAAS,EAAE,CAAC;QAC7C,OAAO,OAAO,CAAC,kBAAkB,CAAC;IACpC,CAAC;IACD,IAAI,OAAO,CAAC,iBAAiB,KAAK,SAAS,EAAE,CAAC;QAC5C,OAAO,OAAO,CAAC,iBAAiB,CAAC;IACnC,CAAC;IACD,OAAO,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC;AACjE,CAAC"}

package/dist/introspection/types.d.ts

@@ -1,5 +1,11 @@
 /** Normalized status values used across introspection results */
-export type NormalizedStatus = 'complete' | 'in-progress' | 'not-started' | 'deprecated';
+export declare const STATUS: {
+    readonly Complete: "complete";
+    readonly InProgress: "in-progress";
+    readonly NotStarted: "not-started";
+    readonly Deprecated: "deprecated";
+};
+export type NormalizedStatus = (typeof STATUS)[keyof typeof STATUS];
 /** Result of parsing a single slice plan entry */
 export interface SlicePlanEntry {
     index: number;
@@ -10,6 +16,13 @@ export interface SlicePlanEntry {
     lineIndex: number;
     /** Overview/description text from after the bold name (e.g., " — Summary text...") */
     description?: string;
+    /**
+     * Whether `index` came from a bolded `(NNN)` in the source ('explicit') or was
+     * synthesized as a per-file sequential counter for unindexed entries ('fallback').
+     * Fallback indices are not stable across files and must not enter cross-plan
+     * aggregation (see ConsistencyChecker.checkAll()).
+     */
+    indexSource: 'explicit' | 'fallback';
 }
 /** Result of parsing a slice plan document */
 export interface SlicePlanResult {
@@ -30,7 +43,7 @@ export interface TaskFileResult {
     totalTasks: number;
     completedTasks: number;
     /** Inferred status based on checkbox state */
-    inferredStatus: 'complete' | 'in-progress' | 'not-started';
+    inferredStatus: NormalizedStatus;
 }
 /** Extracted YAML frontmatter fields */
 export interface FrontmatterData {
@@ -61,6 +74,7 @@ export interface DocumentDetectionResult {
     taskFile: string[] | null;
     architecture: string | null;
     slicePlan: string | null;
+    review: string | null;
 }
 /** Base document shape produced by _d() in parse.py */
 export interface DocSummary {
@@ -218,12 +232,17 @@ export interface ConsistencyFixResult extends ConsistencyCheckResult {
 export interface SliceStatus {
     name: string;
     index: number | null;
-    status: 'needs-design' | 'needs-tasks' | 'in-implementation' | 'complete' | 'no-active-slice';
+    status: 'needs-design' | 'needs-tasks' | 'in-implementation' | 'complete' | 'no-active-slice' | 'pending-review' | 'review-failed';
     taskProgress?: {
         completed: number;
         total: number;
         inferredStatus: NormalizedStatus;
     };
+    /** Set when status is 'pending-review' or 'review-failed'; carries the gate's rationale for getNext() to route without recomputing the gate. */
+    gateInfo?: {
+        reviewType: string;
+        rationale: string;
+    };
 }
 /** Full workflow status for a project */
 export interface WorkflowStatus {