@context-forge/core 0.3.3 → 0.3.6

package/dist/config/ConfigKeys.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ConfigKeys.d.ts","sourceRoot":"","sources":["../../src/config/ConfigKeys.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;IACtC,OAAO,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;CAChE;AAED,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAsB3D,CAAC"}
+{"version":3,"file":"ConfigKeys.d.ts","sourceRoot":"","sources":["../../src/config/ConfigKeys.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;IACtC,OAAO,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;CAChE;AAED,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAgC3D,CAAC"}

package/dist/config/ConfigKeys.js

@@ -20,5 +20,15 @@ export const CONFIG_KEYS = {
         description: 'Strategy for managing the AI project guide via git',
         enum: ['submodule', 'clone', 'manual'],
     },
+    'workflow.auto_advance': {
+        type: 'boolean',
+        default: false,
+        description: 'Auto-advance to next slice when current is complete',
+    },
+    'workflow.auto_fix': {
+        type: 'boolean',
+        default: false,
+        description: 'Automatically apply non-destructive corrections when running consistency checks',
+    },
 };
 //# sourceMappingURL=ConfigKeys.js.map

package/dist/config/ConfigKeys.js.map

@@ -1 +1 @@
-{"version":3,"file":"ConfigKeys.js","sourceRoot":"","sources":["../../src/config/ConfigKeys.ts"],"names":[],"mappings":"AAQA,MAAM,CAAC,MAAM,WAAW,GAAwC;IAC9D,eAAe,EAAE;QACf,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,EAAE;QACX,WAAW,EAAE,qEAAqE;KACnF;IACD,mBAAmB,EAAE;QACnB,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,KAAK;QACd,WAAW,EAAE,sDAAsD;KACpE;IACD,cAAc,EAAE;QACd,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,EAAE;QACX,WAAW,EAAE,4CAA4C;KAC1D;IACD,oBAAoB,EAAE;QACpB,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,WAAW;QACpB,WAAW,EAAE,oDAAoD;QACjE,IAAI,EAAE,CAAC,WAAW,EAAE,OAAO,EAAE,QAAQ,CAAC;KACvC;CACF,CAAC"}
+{"version":3,"file":"ConfigKeys.js","sourceRoot":"","sources":["../../src/config/ConfigKeys.ts"],"names":[],"mappings":"AAQA,MAAM,CAAC,MAAM,WAAW,GAAwC;IAC9D,eAAe,EAAE;QACf,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,EAAE;QACX,WAAW,EAAE,qEAAqE;KACnF;IACD,mBAAmB,EAAE;QACnB,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,KAAK;QACd,WAAW,EAAE,sDAAsD;KACpE;IACD,cAAc,EAAE;QACd,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,EAAE;QACX,WAAW,EAAE,4CAA4C;KAC1D;IACD,oBAAoB,EAAE;QACpB,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,WAAW;QACpB,WAAW,EAAE,oDAAoD;QACjE,IAAI,EAAE,CAAC,WAAW,EAAE,OAAO,EAAE,QAAQ,CAAC;KACvC;IACD,uBAAuB,EAAE;QACvB,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,KAAK;QACd,WAAW,EAAE,qDAAqD;KACnE;IACD,mBAAmB,EAAE;QACnB,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,KAAK;QACd,WAAW,EAAE,iFAAiF;KAC/F;CACF,CAAC"}

package/dist/guides/GuideManager.d.ts

@@ -15,6 +15,8 @@ export declare class GuideManager {
     private resolveSource;
     /** Resolve strategy from config or default */
     private resolveStrategy;
+    /** Create user artifact directories alongside the guide */
+    private createUserDirectories;
     /** Map method name to strategy instance */
     private getStrategy;
 }

package/dist/guides/GuideManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"GuideManager.d.ts","sourceRoot":"","sources":["../../src/guides/GuideManager.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,aAAa,EAAE,YAAY,EAAmB,MAAM,YAAY,CAAC;AAOvG,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAgB;IAC/C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;gBAE7B,WAAW,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,aAAa;IAM9D,4CAA4C;IACtC,MAAM,IAAI,OAAO,CAAC,SAAS,CAAC;IAKlC,yCAAyC;IACnC,OAAO,CAAC,gBAAgB,CAAC,EAAE,WAAW,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAiB9F,4CAA4C;IACtC,MAAM,IAAI,OAAO,CAAC,YAAY,CAAC;IAerC,gDAAgD;YAClC,aAAa;IAc3B,8CAA8C;YAChC,eAAe;IAc7B,2CAA2C;IAC3C,OAAO,CAAC,WAAW;CAUpB"}
+{"version":3,"file":"GuideManager.d.ts","sourceRoot":"","sources":["../../src/guides/GuideManager.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,aAAa,EAAE,YAAY,EAAmB,MAAM,YAAY,CAAC;AAOvG,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAgB;IAC/C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;gBAE7B,WAAW,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,aAAa;IAM9D,4CAA4C;IACtC,MAAM,IAAI,OAAO,CAAC,SAAS,CAAC;IAKlC,yCAAyC;IACnC,OAAO,CAAC,gBAAgB,CAAC,EAAE,WAAW,EAAE,cAAc,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAsB9F,4CAA4C;IACtC,MAAM,IAAI,OAAO,CAAC,YAAY,CAAC;IAerC,gDAAgD;YAClC,aAAa;IAc3B,8CAA8C;YAChC,eAAe;IAc7B,2DAA2D;IAC3D,OAAO,CAAC,qBAAqB;IAa7B,2CAA2C;IAC3C,OAAO,CAAC,WAAW;CAUpB"}

package/dist/guides/GuideManager.js

@@ -1,5 +1,6 @@
 // Orchestration layer for guide lifecycle management
 import { join } from 'path';
+import { mkdirSync } from 'fs';
 import { DEFAULT_SOURCE_GIT, GUIDE_RELATIVE_PATH } from './types.js';
 import { GuideDetector } from './GuideDetector.js';
 import { SubmoduleStrategy } from './strategies/SubmoduleStrategy.js';
@@ -30,7 +31,10 @@ export class GuideManager {
             throw new Error('Guide is already installed. Use guide_update (or cf guides update) to update it.');
         }
         const strategy = this.getStrategy(method);
-        return strategy.install(this.projectPath, source, targetDir);
+        const result = await strategy.install(this.projectPath, source, targetDir);
+        // Create user artifact directories so the project is ready to use
+        this.createUserDirectories();
+        return result;
     }
     /** Update an existing guide installation */
     async update() {
@@ -73,6 +77,19 @@ export class GuideManager {
         }
         return 'submodule';
     }
+    /** Create user artifact directories alongside the guide */
+    createUserDirectories() {
+        const userDirs = [
+            'project-documents/user',
+            'project-documents/user/architecture',
+            'project-documents/user/slices',
+            'project-documents/user/tasks',
+            'project-documents/user/project-guides',
+        ];
+        for (const dir of userDirs) {
+            mkdirSync(join(this.projectPath, dir), { recursive: true });
+        }
+    }
     /** Map method name to strategy instance */
     getStrategy(method) {
         switch (method) {

package/dist/guides/GuideManager.js.map

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

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

@@ -1 +1 @@
-{"version":3,"file":"ArtifactIntrospector.d.ts","sourceRoot":"","sources":["../../src/introspection/ArtifactIntrospector.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAC7D,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,uBAAuB,EACvB,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAOpB;;;GAGG;AACH,qBAAa,oBAAqB,YAAW,qBAAqB;IAC1D,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAI/D,aAAa,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,cAAc,CAAC;IAIxE,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAI9D,eAAe,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAIrF,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAIhG;;;OAGG;IACG,SAAS,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,oBAAoB,CAAC;CAsGrE"}
+{"version":3,"file":"ArtifactIntrospector.d.ts","sourceRoot":"","sources":["../../src/introspection/ArtifactIntrospector.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAC7D,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,uBAAuB,EACvB,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAQpB;;;GAGG;AACH,qBAAa,oBAAqB,YAAW,qBAAqB;IAC1D,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAI/D,aAAa,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,cAAc,CAAC;IAIxE,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAI9D,eAAe,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAIrF,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAIhG;;;OAGG;IACG,SAAS,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,oBAAoB,CAAC;CA2FrE"}

package/dist/introspection/ArtifactIntrospector.js

@@ -4,6 +4,7 @@ import { parseTaskFile } from './parsers/taskFileParser.js';
 import { parseFrontmatter } from './parsers/frontmatterParser.js';
 import { parseFutureWork } from './parsers/futureWorkParser.js';
 import { detectDocuments, checkFileExists } from './parsers/documentDetector.js';
+import { resolveArtifactPath } from '../schema/resolveFileByIndex.js';
 /**
  * Orchestrator that delegates to individual parser functions.
  * Each method resolves file paths from projectPath as needed.
@@ -45,9 +46,10 @@ export class ArtifactIntrospector {
         // Parse slice plan if available
         try {
             if (project.fileSlicePlan) {
-                const planPath = join(projectPath, project.fileSlicePlan);
-                const planResult = await parseSlicePlan(planPath);
-                if (planResult.totalSlices > 0) {
+                const planRelPath = resolveArtifactPath('fileSlicePlan', project.fileSlicePlan);
+                const planPath = planRelPath ? join(projectPath, planRelPath) : null;
+                const planResult = planPath ? await parseSlicePlan(planPath) : null;
+                if (planResult && planResult.totalSlices > 0) {
                     summary.slicePlan = {
                         totalSlices: planResult.totalSlices,
                         completedSlices: planResult.completedSlices,
@@ -89,29 +91,29 @@ export class ArtifactIntrospector {
         catch {
             // Task parsing failed — continue with other operations
         }
-        // Check artifact existence
+        // Check artifact existence (resolve stems to full relative paths)
+        const checkArtifact = async (field, stem) => {
+            if (!stem)
+                return false;
+            const relPath = resolveArtifactPath(field, stem);
+            if (!relPath)
+                return false;
+            return checkFileExists(projectPath, relPath);
+        };
         try {
-            if (project.fileSlicePlan) {
-                summary.artifacts.hasSlicePlan = await checkFileExists(projectPath, project.fileSlicePlan);
-            }
+            summary.artifacts.hasSlicePlan = await checkArtifact('fileSlicePlan', project.fileSlicePlan);
         }
         catch { /* continue */ }
         try {
-            if (project.fileHLD) {
-                summary.artifacts.hasHLD = await checkFileExists(projectPath, project.fileHLD);
-            }
+            summary.artifacts.hasHLD = await checkArtifact('fileHLD', project.fileHLD);
         }
         catch { /* continue */ }
         try {
-            if (project.fileArch) {
-                summary.artifacts.hasArch = await checkFileExists(projectPath, project.fileArch);
-            }
+            summary.artifacts.hasArch = await checkArtifact('fileArch', project.fileArch);
         }
         catch { /* continue */ }
         try {
-            if (project.fileSpec) {
-                summary.artifacts.hasSpec = await checkFileExists(projectPath, project.fileSpec);
-            }
+            summary.artifacts.hasSpec = await checkArtifact('fileSpec', project.fileSpec);
         }
         catch { /* continue */ }
         // Check current slice design and task file existence

package/dist/introspection/ArtifactIntrospector.js.map

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

package/dist/introspection/ConsistencyChecker.d.ts

@@ -0,0 +1,38 @@
+import type { ProjectData } from '../types/project.js';
+import type { IArtifactIntrospector } from './interfaces.js';
+import type { ConsistencyCheckResult, ConsistencyFixResult } from './types.js';
+/**
+ * Compares related artifact states within a project and flags mismatches.
+ * Optionally applies non-destructive corrections to fixable findings.
+ */
+export declare class ConsistencyChecker {
+    private readonly introspector;
+    constructor(introspector: IArtifactIntrospector);
+    /**
+     * Run all detection rules against a project and return structured findings.
+     */
+    check(project: ProjectData): Promise<ConsistencyCheckResult>;
+    /**
+     * Run check(), then apply non-destructive corrections to fixable findings.
+     */
+    fix(project: ProjectData): Promise<ConsistencyFixResult>;
+    /** Rule 1: Task completion vs. slice plan checkbox */
+    private ruleTaskVsPlan;
+    /** Rule 2: Frontmatter status vs. computed state */
+    private ruleFrontmatterVsComputed;
+    /** Rule 3: Missing artifact cross-references */
+    private ruleMissingArtifacts;
+    /** Rule 4: Plan checkbox vs. slice frontmatter status */
+    private rulePlanVsFrontmatter;
+    /** Rule 5: Task file frontmatter status vs. computed task completion */
+    private ruleTaskFileStatus;
+    private emptyResult;
+    private buildResult;
+    private resolveSlicePlanPath;
+    private safeDetectDocuments;
+    private safeParseSlicePlan;
+    private safeParseTaskFile;
+    private safeParseFrontmatter;
+    private safeParseTaskFileFrontmatter;
+}
+//# sourceMappingURL=ConsistencyChecker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ConsistencyChecker.d.ts","sourceRoot":"","sources":["../../src/introspection/ConsistencyChecker.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAC7D,OAAO,KAAK,EAEV,sBAAsB,EACtB,oBAAoB,EAIrB,MAAM,YAAY,CAAC;AAapB;;;GAGG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAwB;gBAEzC,YAAY,EAAE,qBAAqB;IAI/C;;OAEG;IACG,KAAK,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAiElE;;OAEG;IACG,GAAG,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAqC9D,sDAAsD;IACtD,OAAO,CAAC,cAAc;IAoDtB,oDAAoD;IACpD,OAAO,CAAC,yBAAyB;IAoDjC,gDAAgD;IAChD,OAAO,CAAC,oBAAoB;IAmC5B,yDAAyD;IACzD,OAAO,CAAC,qBAAqB;IAoD7B,wEAAwE;IACxE,OAAO,CAAC,kBAAkB;IAmD1B,OAAO,CAAC,WAAW;IAYnB,OAAO,CAAC,WAAW;IAoBnB,OAAO,CAAC,oBAAoB;YAMd,mBAAmB;YAYnB,kBAAkB;YAalB,iBAAiB;YAajB,oBAAoB;YAYpB,4BAA4B;CAY3C"}

package/dist/introspection/ConsistencyChecker.js

@@ -0,0 +1,381 @@
+import { join } from 'node:path';
+import { resolveArtifactPath } from '../schema/resolveFileByIndex.js';
+import { updateCheckbox, updateFrontmatterField } from './writers/markdownWriter.js';
+/**
+ * Extract numeric slice index from a fileSlice value like "165-slice.workflow-navigator".
+ */
+function extractSliceIndex(fileSlice) {
+    if (!fileSlice)
+        return null;
+    const match = /^(\d+)-/.exec(fileSlice);
+    return match ? parseInt(match[1], 10) : null;
+}
+/**
+ * Compares related artifact states within a project and flags mismatches.
+ * Optionally applies non-destructive corrections to fixable findings.
+ */
+export class ConsistencyChecker {
+    introspector;
+    constructor(introspector) {
+        this.introspector = introspector;
+    }
+    /**
+     * Run all detection rules against a project and return structured findings.
+     */
+    async check(project) {
+        const projectPath = project.projectPath;
+        if (!projectPath) {
+            return this.emptyResult('');
+        }
+        const sliceIndex = extractSliceIndex(project.fileSlice);
+        if (sliceIndex === null) {
+            return this.emptyResult(projectPath);
+        }
+        // Gather data from introspector — each call individually try/caught
+        const docs = await this.safeDetectDocuments(projectPath, sliceIndex);
+        const slicePlanResult = await this.safeParseSlicePlan(project, projectPath);
+        const taskResult = await this.safeParseTaskFile(docs?.taskFile, projectPath);
+        const sliceFrontmatter = await this.safeParseFrontmatter(docs?.sliceDesign, projectPath);
+        // Find the matching slice plan entry
+        const planEntry = slicePlanResult?.entries.find((e) => e.index === sliceIndex) ?? null;
+        const slicePlanPath = this.resolveSlicePlanPath(project, projectPath);
+        const findings = [];
+        // Rule 1: task completion vs. slice plan checkbox
+        findings.push(...this.ruleTaskVsPlan(taskResult, planEntry, slicePlanPath, slicePlanResult, sliceIndex));
+        const sliceDesignRel = docs?.sliceDesign ?? null;
+        // Rule 2: frontmatter status vs. computed state
+        findings.push(...this.ruleFrontmatterVsComputed(sliceFrontmatter, taskResult, sliceDesignRel, projectPath));
+        // Rule 3: missing artifact cross-references
+        findings.push(...this.ruleMissingArtifacts(docs, planEntry, sliceIndex));
+        // Rule 4: plan checkbox vs. slice frontmatter status
+        findings.push(...this.rulePlanVsFrontmatter(planEntry, sliceFrontmatter, slicePlanPath, sliceDesignRel, projectPath));
+        // Rule 5: task file frontmatter status vs. computed task completion
+        const taskFileFrontmatter = await this.safeParseTaskFileFrontmatter(docs?.taskFile, projectPath);
+        findings.push(...this.ruleTaskFileStatus(taskResult, taskFileFrontmatter));
+        return this.buildResult(projectPath, findings);
+    }
+    /**
+     * Run check(), then apply non-destructive corrections to fixable findings.
+     */
+    async fix(project) {
+        const checkResult = await this.check(project);
+        const fixLog = [];
+        const fixErrors = [];
+        let fixed = 0;
+        for (const finding of checkResult.findings) {
+            if (!finding.fixable || !finding.fixAction)
+                continue;
+            try {
+                if (finding.fixAction.type === 'update-checkbox') {
+                    const { lineIndex, checked } = finding.fixAction.detail;
+                    const entry = await updateCheckbox(finding.fixAction.filePath, lineIndex, checked);
+                    entry.rule = finding.rule;
+                    fixLog.push(entry);
+                    fixed++;
+                }
+                else if (finding.fixAction.type === 'update-frontmatter') {
+                    const { key, value } = finding.fixAction.detail;
+                    const entry = await updateFrontmatterField(finding.fixAction.filePath, key, value);
+                    entry.rule = finding.rule;
+                    fixLog.push(entry);
+                    fixed++;
+                }
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                fixErrors.push(`Fix failed for ${finding.rule}: ${msg}`);
+            }
+        }
+        return { ...checkResult, fixed, fixLog, fixErrors };
+    }
+    // --- Detection Rules ---
+    /** Rule 1: Task completion vs. slice plan checkbox */
+    ruleTaskVsPlan(taskResult, planEntry, slicePlanPath, slicePlanResult, sliceIndex) {
+        const findings = [];
+        if (!taskResult || !planEntry || !slicePlanPath || !slicePlanResult)
+            return findings;
+        const tasksComplete = taskResult.inferredStatus === 'complete';
+        const sliceChecked = planEntry.isChecked;
+        if (tasksComplete && !sliceChecked) {
+            // Find the line index of this entry in the plan file for fixing
+            const entryIdx = slicePlanResult.entries.findIndex((e) => e.index === sliceIndex);
+            findings.push({
+                rule: 'task-vs-plan',
+                severity: 'warning',
+                location: slicePlanPath,
+                description: `Tasks complete (${taskResult.completedTasks}/${taskResult.totalTasks}) but slice ${sliceIndex} is unchecked in plan`,
+                suggestedFix: `Check the slice plan entry for (${sliceIndex})`,
+                fixable: true,
+                fixAction: {
+                    type: 'update-checkbox',
+                    filePath: slicePlanPath,
+                    detail: { lineIndex: entryIdx, checked: true, entryIndex: sliceIndex },
+                },
+            });
+        }
+        if (sliceChecked && !tasksComplete) {
+            const entryIdx = slicePlanResult.entries.findIndex((e) => e.index === sliceIndex);
+            findings.push({
+                rule: 'task-vs-plan',
+                severity: 'error',
+                location: slicePlanPath,
+                description: `Slice ${sliceIndex} is checked in plan but tasks are incomplete (${taskResult.completedTasks}/${taskResult.totalTasks})`,
+                suggestedFix: `Uncheck the slice plan entry for (${sliceIndex})`,
+                fixable: true,
+                fixAction: {
+                    type: 'update-checkbox',
+                    filePath: slicePlanPath,
+                    detail: { lineIndex: entryIdx, checked: false, entryIndex: sliceIndex },
+                },
+            });
+        }
+        return findings;
+    }
+    /** Rule 2: Frontmatter status vs. computed state */
+    ruleFrontmatterVsComputed(frontmatter, taskResult, sliceDesignRelPath, projectPath) {
+        const findings = [];
+        if (!frontmatter?.found || !frontmatter.data.status)
+            return findings;
+        if (!taskResult)
+            return findings;
+        const fmStatus = frontmatter.data.status.toLowerCase();
+        const tasksComplete = taskResult.inferredStatus === 'complete';
+        const sliceDesignFullPath = sliceDesignRelPath
+            ? join(projectPath, sliceDesignRelPath)
+            : frontmatter.filePath;
+        if (fmStatus === 'complete' && !tasksComplete) {
+            findings.push({
+                rule: 'frontmatter-vs-computed',
+                severity: 'error',
+                location: sliceDesignFullPath,
+                description: `Frontmatter status is "complete" but tasks are incomplete (${taskResult.completedTasks}/${taskResult.totalTasks})`,
+                suggestedFix: 'Update frontmatter status to "in-progress"',
+                fixable: true,
+                fixAction: {
+                    type: 'update-frontmatter',
+                    filePath: sliceDesignFullPath,
+                    detail: { key: 'status', value: 'in-progress' },
+                },
+            });
+        }
+        if ((fmStatus === 'in-progress' || fmStatus === 'not-started') && tasksComplete) {
+            findings.push({
+                rule: 'frontmatter-vs-computed',
+                severity: 'warning',
+                location: sliceDesignFullPath,
+                description: `Frontmatter status is "${fmStatus}" but all tasks are complete (${taskResult.completedTasks}/${taskResult.totalTasks})`,
+                suggestedFix: 'Update frontmatter status to "complete"',
+                fixable: true,
+                fixAction: {
+                    type: 'update-frontmatter',
+                    filePath: sliceDesignFullPath,
+                    detail: { key: 'status', value: 'complete' },
+                },
+            });
+        }
+        return findings;
+    }
+    /** Rule 3: Missing artifact cross-references */
+    ruleMissingArtifacts(docs, planEntry, sliceIndex) {
+        const findings = [];
+        const hasTaskFile = docs?.taskFile !== null && docs?.taskFile !== undefined;
+        const hasPlanEntry = planEntry !== null;
+        if (hasTaskFile && !hasPlanEntry) {
+            findings.push({
+                rule: 'missing-artifact',
+                severity: 'info',
+                location: docs.taskFile[0],
+                description: `Task file exists for slice ${sliceIndex} but no matching slice plan entry found`,
+                suggestedFix: 'Add an entry for this slice to the slice plan',
+                fixable: false,
+            });
+        }
+        if (hasPlanEntry && !hasTaskFile) {
+            findings.push({
+                rule: 'missing-artifact',
+                severity: 'info',
+                location: `slice plan entry ${sliceIndex}`,
+                description: `Slice plan entry exists for ${sliceIndex} (${planEntry.name}) but no task file found`,
+                suggestedFix: 'Create a task file when ready to begin implementation',
+                fixable: false,
+            });
+        }
+        return findings;
+    }
+    /** Rule 4: Plan checkbox vs. slice frontmatter status */
+    rulePlanVsFrontmatter(planEntry, frontmatter, slicePlanPath, sliceDesignRelPath, projectPath) {
+        const findings = [];
+        if (!planEntry || !frontmatter?.found || !frontmatter.data.status)
+            return findings;
+        const fmStatus = frontmatter.data.status.toLowerCase();
+        const planChecked = planEntry.isChecked;
+        const sliceDesignFullPath = sliceDesignRelPath
+            ? join(projectPath, sliceDesignRelPath)
+            : frontmatter.filePath;
+        if (planChecked && fmStatus !== 'complete') {
+            findings.push({
+                rule: 'plan-vs-frontmatter',
+                severity: 'warning',
+                location: sliceDesignFullPath,
+                description: `Slice plan entry is checked but frontmatter status is "${fmStatus}"`,
+                suggestedFix: 'Update frontmatter status to "complete"',
+                fixable: true,
+                fixAction: {
+                    type: 'update-frontmatter',
+                    filePath: sliceDesignFullPath,
+                    detail: { key: 'status', value: 'complete' },
+                },
+            });
+        }
+        if (!planChecked && fmStatus === 'complete' && slicePlanPath) {
+            findings.push({
+                rule: 'plan-vs-frontmatter',
+                severity: 'warning',
+                location: slicePlanPath,
+                description: `Frontmatter status is "complete" but slice plan entry is unchecked`,
+                suggestedFix: 'Check the slice plan entry',
+                fixable: true,
+                fixAction: {
+                    type: 'update-checkbox',
+                    filePath: slicePlanPath,
+                    detail: { lineIndex: -1, checked: true },
+                },
+            });
+        }
+        return findings;
+    }
+    /** Rule 5: Task file frontmatter status vs. computed task completion */
+    ruleTaskFileStatus(taskResult, taskFrontmatter) {
+        const findings = [];
+        if (!taskResult || !taskFrontmatter?.found || !taskFrontmatter.data.status)
+            return findings;
+        const fmStatus = taskFrontmatter.data.status.toLowerCase().replace(/_/g, '-');
+        const computed = taskResult.inferredStatus; // 'complete' | 'in-progress' | 'not-started'
+        const taskFilePath = taskFrontmatter.filePath;
+        // Map task file status values to normalized form for comparison
+        // Task files use not_started/in_progress/complete in frontmatter
+        if (fmStatus === 'complete' && computed !== 'complete') {
+            findings.push({
+                rule: 'task-file-status',
+                severity: 'error',
+                location: taskFilePath,
+                description: `Task file status is "complete" but tasks are incomplete (${taskResult.completedTasks}/${taskResult.totalTasks})`,
+                suggestedFix: 'Update task file status to "in_progress"',
+                fixable: true,
+                fixAction: {
+                    type: 'update-frontmatter',
+                    filePath: taskFilePath,
+                    detail: { key: 'status', value: 'in_progress' },
+                },
+            });
+        }
+        if (fmStatus !== 'complete' && computed === 'complete') {
+            findings.push({
+                rule: 'task-file-status',
+                severity: 'warning',
+                location: taskFilePath,
+                description: `Task file status is "${taskFrontmatter.data.status}" but all tasks are complete (${taskResult.completedTasks}/${taskResult.totalTasks})`,
+                suggestedFix: 'Update task file status to "complete"',
+                fixable: true,
+                fixAction: {
+                    type: 'update-frontmatter',
+                    filePath: taskFilePath,
+                    detail: { key: 'status', value: 'complete' },
+                },
+            });
+        }
+        return findings;
+    }
+    // --- Helper methods ---
+    emptyResult(projectPath) {
+        return {
+            projectPath,
+            findings: [],
+            totalFindings: 0,
+            errors: 0,
+            warnings: 0,
+            infos: 0,
+            summary: 'No inconsistencies found',
+        };
+    }
+    buildResult(projectPath, findings) {
+        const errors = findings.filter((f) => f.severity === 'error').length;
+        const warnings = findings.filter((f) => f.severity === 'warning').length;
+        const infos = findings.filter((f) => f.severity === 'info').length;
+        const total = findings.length;
+        let summary;
+        if (total === 0) {
+            summary = 'No inconsistencies found';
+        }
+        else {
+            const parts = [];
+            if (errors > 0)
+                parts.push(`${errors} error${errors !== 1 ? 's' : ''}`);
+            if (warnings > 0)
+                parts.push(`${warnings} warning${warnings !== 1 ? 's' : ''}`);
+            if (infos > 0)
+                parts.push(`${infos} info${infos !== 1 ? 's' : ''}`);
+            summary = `${total} finding${total !== 1 ? 's' : ''}: ${parts.join(', ')}`;
+        }
+        return { projectPath, findings, totalFindings: total, errors, warnings, infos, summary };
+    }
+    resolveSlicePlanPath(project, projectPath) {
+        if (!project.fileSlicePlan)
+            return null;
+        const relPath = resolveArtifactPath('fileSlicePlan', project.fileSlicePlan);
+        return relPath ? join(projectPath, relPath) : null;
+    }
+    async safeDetectDocuments(projectPath, sliceIndex) {
+        try {
+            const docs = await this.introspector.detectDocuments(projectPath, sliceIndex);
+            return { taskFile: docs.taskFile, sliceDesign: docs.sliceDesign };
+        }
+        catch {
+            return null;
+        }
+    }
+    async safeParseSlicePlan(project, projectPath) {
+        const planPath = this.resolveSlicePlanPath(project, projectPath);
+        if (!planPath)
+            return null;
+        try {
+            return await this.introspector.parseSlicePlan(planPath);
+        }
+        catch {
+            return null;
+        }
+    }
+    async safeParseTaskFile(taskFilePaths, projectPath) {
+        if (!taskFilePaths || taskFilePaths.length === 0)
+            return null;
+        try {
+            const fullPaths = taskFilePaths.map((p) => join(projectPath, p));
+            return await this.introspector.parseTaskFile(fullPaths);
+        }
+        catch {
+            return null;
+        }
+    }
+    async safeParseFrontmatter(sliceDesignRelPath, projectPath) {
+        if (!sliceDesignRelPath)
+            return null;
+        try {
+            return await this.introspector.parseFrontmatter(join(projectPath, sliceDesignRelPath));
+        }
+        catch {
+            return null;
+        }
+    }
+    async safeParseTaskFileFrontmatter(taskFilePaths, projectPath) {
+        if (!taskFilePaths || taskFilePaths.length === 0)
+            return null;
+        // Parse frontmatter from the first task file (primary file has the frontmatter)
+        try {
+            return await this.introspector.parseFrontmatter(join(projectPath, taskFilePaths[0]));
+        }
+        catch {
+            return null;
+        }
+    }
+}
+//# sourceMappingURL=ConsistencyChecker.js.map