@context-forge/core 0.1.0 → 0.2.2

package/dist/introspection/FutureWorkCollector.js

@@ -0,0 +1,116 @@
+import { basename } from 'node:path';
+import { buildModel } from './ProjectModelBuilder.js';
+const EMPTY_RESULT = (projectPath) => ({
+    projectPath,
+    groups: [],
+    totalItems: 0,
+    pendingItems: 0,
+    completedItems: 0,
+    markdown: '## Future Work\n\n*No future work items found.*',
+});
+function pad(index) {
+    return String(index).padStart(3, '0');
+}
+function generateMarkdown(groups, totals) {
+    const lines = ['## Future Work Summary', ''];
+    for (const group of groups) {
+        if (group.items.length === 0)
+            continue;
+        lines.push(`### ${group.initiativeIndex} — ${group.initiativeName}`);
+        lines.push(`*Source: ${group.sourceFile}*`);
+        for (const item of group.items) {
+            const box = item.done ? '[x]' : '[ ]';
+            lines.push(`- ${box} (${item.index}) ${item.name}`);
+        }
+        lines.push('');
+    }
+    lines.push(`**Total: ${totals.total} items (${totals.pending} pending, ${totals.completed} completed)**`);
+    return lines.join('\n');
+}
+export class FutureWorkCollector {
+    async collect(projectPath, statusFilter = 'all') {
+        let model;
+        try {
+            model = await buildModel(projectPath);
+        }
+        catch {
+            return EMPTY_RESULT(projectPath);
+        }
+        const groups = [];
+        for (const [initIndex, initiative] of Object.entries(model.initiatives)) {
+            const { slicePlan } = initiative;
+            if (!slicePlan)
+                continue;
+            const filepath = slicePlan.filepath ?? '';
+            const sourceFile = filepath
+                ? filepath.replace(projectPath + '/', '').replace(projectPath, '')
+                : slicePlan.name;
+            let rawItems;
+            // Standalone detection: filename contains 'slices.future.'
+            if (basename(filepath).includes('slices.future.')) {
+                const entries = slicePlan.entries ?? [];
+                rawItems = entries.map((e) => ({
+                    index: pad(e.index),
+                    name: e.name,
+                    done: e.isChecked,
+                    sourceFile,
+                    sourceInitiativeIndex: initIndex,
+                    sourceInitiativeName: initiative.name,
+                }));
+            }
+            else {
+                rawItems = (slicePlan.futureWork ?? []).map((fw) => ({
+                    index: fw.index,
+                    name: fw.name,
+                    done: fw.done,
+                    sourceFile,
+                    sourceInitiativeIndex: initIndex,
+                    sourceInitiativeName: initiative.name,
+                }));
+            }
+            if (rawItems.length === 0)
+                continue;
+            // Apply status filter
+            const items = statusFilter === 'pending'
+                ? rawItems.filter((i) => !i.done)
+                : statusFilter === 'completed'
+                    ? rawItems.filter((i) => i.done)
+                    : rawItems;
+            if (items.length === 0)
+                continue;
+            const completedItems = items.filter((i) => i.done).length;
+            const pendingItems = items.length - completedItems;
+            groups.push({
+                initiativeIndex: initIndex,
+                initiativeName: initiative.name,
+                sourceFile,
+                items,
+                totalItems: items.length,
+                pendingItems,
+                completedItems,
+            });
+        }
+        // Sort groups by initiative index for deterministic output
+        groups.sort((a, b) => a.initiativeIndex.localeCompare(b.initiativeIndex));
+        const totalItems = groups.reduce((s, g) => s + g.totalItems, 0);
+        const pendingItems = groups.reduce((s, g) => s + g.pendingItems, 0);
+        const completedItems = groups.reduce((s, g) => s + g.completedItems, 0);
+        if (totalItems === 0) {
+            return EMPTY_RESULT(projectPath);
+        }
+        const markdown = generateMarkdown(groups, {
+            total: totalItems,
+            pending: pendingItems,
+            completed: completedItems,
+        });
+        return {
+            projectPath,
+            groups,
+            totalItems,
+            pendingItems,
+            completedItems,
+            markdown,
+        };
+    }
+}
+//# sourceMappingURL=FutureWorkCollector.js.map

package/dist/introspection/FutureWorkCollector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FutureWorkCollector.js","sourceRoot":"","sources":["../../src/introspection/FutureWorkCollector.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAUtD,MAAM,YAAY,GAAG,CAAC,WAAmB,EAA6B,EAAE,CAAC,CAAC;IACxE,WAAW;IACX,MAAM,EAAE,EAAE;IACV,UAAU,EAAE,CAAC;IACb,YAAY,EAAE,CAAC;IACf,cAAc,EAAE,CAAC;IACjB,QAAQ,EAAE,iDAAiD;CAC5D,CAAC,CAAC;AAEH,SAAS,GAAG,CAAC,KAAa;IACxB,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AACxC,CAAC;AAED,SAAS,gBAAgB,CACvB,MAAyB,EACzB,MAA6D;IAE7D,MAAM,KAAK,GAAa,CAAC,wBAAwB,EAAE,EAAE,CAAC,CAAC;IAEvD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QACvC,KAAK,CAAC,IAAI,CAAC,OAAO,KAAK,CAAC,eAAe,MAAM,KAAK,CAAC,cAAc,EAAE,CAAC,CAAC;QACrE,KAAK,CAAC,IAAI,CAAC,YAAY,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC;QAC5C,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YAC/B,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;YACtC,KAAK,CAAC,IAAI,CAAC,KAAK,GAAG,KAAK,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QACtD,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACjB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,YAAY,MAAM,CAAC,KAAK,WAAW,MAAM,CAAC,OAAO,aAAa,MAAM,CAAC,SAAS,eAAe,CAAC,CAAC;IAC1G,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,OAAO,mBAAmB;IAC9B,KAAK,CAAC,OAAO,CACX,WAAmB,EACnB,eAA6B,KAAK;QAElC,IAAI,KAAK,CAAC;QACV,IAAI,CAAC;YACH,KAAK,GAAG,MAAM,UAAU,CAAC,WAAW,CAAC,CAAC;QACxC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,YAAY,CAAC,WAAW,CAAC,CAAC;QACnC,CAAC;QAED,MAAM,MAAM,GAAsB,EAAE,CAAC;QAErC,KAAK,MAAM,CAAC,SAAS,EAAE,UAAU,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC;YACxE,MAAM,EAAE,SAAS,EAAE,GAAG,UAAU,CAAC;YACjC,IAAI,CAAC,SAAS;gBAAE,SAAS;YAEzB,MAAM,QAAQ,GAAG,SAAS,CAAC,QAAQ,IAAI,EAAE,CAAC;YAC1C,MAAM,UAAU,GAAG,QAAQ;gBACzB,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,WAAW,GAAG,GAAG,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC;gBAClE,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC;YAEnB,IAAI,QAAmC,CAAC;YAExC,2DAA2D;YAC3D,IAAI,QAAQ,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;gBAClD,MAAM,OAAO,GAAqB,SAAS,CAAC,OAAO,IAAI,EAAE,CAAC;gBAC1D,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;oBAC7B,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC;oBACnB,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,IAAI,EAAE,CAAC,CAAC,SAAS;oBACjB,UAAU;oBACV,qBAAqB,EAAE,SAAS;oBAChC,oBAAoB,EAAE,UAAU,CAAC,IAAI;iBACtC,CAAC,CAAC,CAAC;YACN,CAAC;iBAAM,CAAC;gBACN,QAAQ,GAAG,CAAC,SAAS,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;oBACnD,KAAK,EAAE,EAAE,CAAC,KAAK;oBACf,IAAI,EAAE,EAAE,CAAC,IAAI;oBACb,IAAI,EAAE,EAAE,CAAC,IAAI;oBACb,UAAU;oBACV,qBAAqB,EAAE,SAAS;oBAChC,oBAAoB,EAAE,UAAU,CAAC,IAAI;iBACtC,CAAC,CAAC,CAAC;YACN,CAAC;YAED,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;gBAAE,SAAS;YAEpC,sBAAsB;YACtB,MAAM,KAAK,GACT,YAAY,KAAK,SAAS;gBACxB,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;gBACjC,CAAC,CAAC,YAAY,KAAK,WAAW;oBAC5B,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;oBAChC,CAAC,CAAC,QAAQ,CAAC;YAEjB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;gBAAE,SAAS;YAEjC,MAAM,cAAc,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;YAC1D,MAAM,YAAY,GAAG,KAAK,CAAC,MAAM,GAAG,cAAc,CAAC;YAEnD,MAAM,CAAC,IAAI,CAAC;gBACV,eAAe,EAAE,SAAS;gBAC1B,cAAc,EAAE,UAAU,CAAC,IAAI;gBAC/B,UAAU;gBACV,KAAK;gBACL,UAAU,EAAE,KAAK,CAAC,MAAM;gBACxB,YAAY;gBACZ,cAAc;aACf,CAAC,CAAC;QACL,CAAC;QAED,2DAA2D;QAC3D,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,eAAe,CAAC,aAAa,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC;QAE1E,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;QAChE,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC;QACpE,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,cAAc,EAAE,CAAC,CAAC,CAAC;QAExE,IAAI,UAAU,KAAK,CAAC,EAAE,CAAC;YACrB,OAAO,YAAY,CAAC,WAAW,CAAC,CAAC;QACnC,CAAC;QAED,MAAM,QAAQ,GAAG,gBAAgB,CAAC,MAAM,EAAE;YACxC,KAAK,EAAE,UAAU;YACjB,OAAO,EAAE,YAAY;YACrB,SAAS,EAAE,cAAc;SAC1B,CAAC,CAAC;QAEH,OAAO;YACL,WAAW;YACX,MAAM;YACN,UAAU;YACV,YAAY;YACZ,cAAc;YACd,QAAQ;SACT,CAAC;IACJ,CAAC;CACF"}

package/dist/introspection/ProjectModelBuilder.d.ts

@@ -0,0 +1,32 @@
+import type { TaskItem, ProjectModel } from './types.js';
+/** Intermediate document entry from directory scanning */
+interface DocEntry {
+    index: number;
+    docType: string;
+    name: string;
+    filename: string;
+    filepath: string;
+    status: string;
+    dateCreated?: string;
+    dateUpdated?: string;
+    project?: string;
+    parent?: string;
+    description?: string;
+    taskItems: TaskItem[];
+    splitNum?: number;
+}
+/**
+ * Scan project-documents/user/ subdirectories for methodology documents.
+ * Exported for testing — not part of public API.
+ */
+export declare function scanDirectory(userDir: string): Promise<DocEntry[]>;
+/**
+ * Build the full project model from a project root path.
+ * Replicates parse.py's build_model() logic.
+ */
+export declare function buildModel(projectPath: string, options?: {
+    name?: string;
+    description?: string;
+}): Promise<ProjectModel>;
+export {};
+//# sourceMappingURL=ProjectModelBuilder.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ProjectModelBuilder.d.ts","sourceRoot":"","sources":["../../src/introspection/ProjectModelBuilder.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,QAAQ,EACR,YAAY,EAUb,MAAM,YAAY,CAAC;AAsBpB,0DAA0D;AAC1D,UAAU,QAAQ;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAqBD;;;GAGG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAuDxE;AAuDD;;;GAGG;AACH,wBAAsB,UAAU,CAC9B,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAChD,OAAO,CAAC,YAAY,CAAC,CAwMvB"}

package/dist/introspection/ProjectModelBuilder.js

@@ -0,0 +1,321 @@
+import { readdir, access } from 'node:fs/promises';
+import { join, basename } from 'node:path';
+import { parseFrontmatter } from './parsers/frontmatterParser.js';
+import { parseTaskItems } from './parsers/taskFileParser.js';
+import { parseFutureWork } from './parsers/futureWorkParser.js';
+import { parseSlicePlan } from './parsers/slicePlanParser.js';
+import { normalizeStatus } from './parsers/statusNormalizer.js';
+const USER_DOCS = 'project-documents/user';
+// Subdirectories scanned under user/ (matching parse.py order)
+const SCAN_DIRS = [
+    'architecture',
+    'slices',
+    'tasks',
+    'features',
+    'project-guides',
+    'reviews',
+    'analysis',
+    'maintenance',
+];
+/** Matches indexed methodology filenames: NNN-type.name[-N].md */
+const INDEXED_RE = /^(\d{3})-(arch|slices|slice|tasks|feature|issue|review|analysis|concept|spec|hld)\.(.+?)(?:-(\d+))?\.md$/i;
+/** Fallback for project-guides: NNN-type.name.md */
+const GUIDE_RE = /^(\d{3})-(concept|spec|hld|slices|guide)\.(.+?)\.md$/i;
+/** Safe directory listing — returns empty on error */
+async function safeReaddir(dirPath) {
+    try {
+        return await readdir(dirPath);
+    }
+    catch {
+        return [];
+    }
+}
+/** Check file existence */
+async function fileExists(filePath) {
+    try {
+        await access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Scan project-documents/user/ subdirectories for methodology documents.
+ * Exported for testing — not part of public API.
+ */
+export async function scanDirectory(userDir) {
+    const docs = [];
+    for (const subdir of SCAN_DIRS) {
+        const dirPath = join(userDir, subdir);
+        const files = await safeReaddir(dirPath);
+        for (const filename of files) {
+            if (!filename.endsWith('.md'))
+                continue;
+            let m = INDEXED_RE.exec(filename);
+            let splitNum;
+            if (!m) {
+                // Try guide regex for project-guides
+                m = GUIDE_RE.exec(filename);
+                if (!m)
+                    continue;
+            }
+            else {
+                splitNum = m[4] ? parseInt(m[4], 10) : undefined;
+            }
+            const index = parseInt(m[1], 10);
+            const docType = m[2].toLowerCase();
+            const name = m[3];
+            const filepath = join(dirPath, filename);
+            // Parse frontmatter
+            const fm = await parseFrontmatter(filepath);
+            const status = normalizeStatus(fm.data.status);
+            // Parse task items for task docs
+            let taskItems = [];
+            if (docType === 'tasks') {
+                taskItems = await parseTaskItems(filepath);
+            }
+            docs.push({
+                index,
+                docType,
+                name,
+                filename,
+                filepath,
+                status,
+                dateCreated: fm.data.dateCreated || undefined,
+                dateUpdated: fm.data.dateUpdated || undefined,
+                project: fm.data.project || undefined,
+                parent: fm.data.parent || undefined,
+                description: fm.data.description || undefined,
+                taskItems,
+                splitNum,
+            });
+        }
+    }
+    return docs;
+}
+/** Format index as zero-padded string (matching parse.py f"{doc.index:03d}") */
+function pad(index) {
+    return String(index).padStart(3, '0');
+}
+/** Convert DocEntry to base DocSummary shape (matching parse.py _d()) */
+function toDocSummary(doc) {
+    const result = {
+        index: pad(doc.index),
+        name: doc.name,
+        status: doc.status,
+    };
+    if (doc.dateCreated)
+        result.dateCreated = doc.dateCreated;
+    if (doc.dateUpdated)
+        result.dateUpdated = doc.dateUpdated;
+    return result;
+}
+/** Title-case a string: hyphens/underscores/dots → spaces, capitalize words */
+function titleCase(s) {
+    return s
+        .replace(/[-_.]/g, ' ')
+        .replace(/\b\w/g, (c) => c.toUpperCase());
+}
+/** Build task entry from one or more task docs at the same index */
+function buildTaskEntry(taskDocs) {
+    const sorted = [...taskDocs].sort((a, b) => (a.splitNum ?? 0) - (b.splitNum ?? 0));
+    const first = sorted[0];
+    const allItems = sorted.flatMap((d) => d.taskItems);
+    const taskCount = allItems.length;
+    const completedTasks = allItems.filter((t) => t.done).length;
+    // Infer status from checkboxes if frontmatter says not-started
+    let status = first.status;
+    if (status === 'not-started' && taskCount > 0) {
+        if (completedTasks === taskCount)
+            status = 'complete';
+        else if (completedTasks > 0)
+            status = 'in-progress';
+    }
+    const entry = {
+        index: pad(first.index),
+        name: `tasks.${first.name}`,
+        status,
+        taskCount,
+        completedTasks,
+    };
+    if (first.dateCreated)
+        entry.dateCreated = first.dateCreated;
+    if (first.dateUpdated)
+        entry.dateUpdated = first.dateUpdated;
+    if (allItems.length > 0)
+        entry.items = allItems;
+    return entry;
+}
+/**
+ * Build the full project model from a project root path.
+ * Replicates parse.py's build_model() logic.
+ */
+export async function buildModel(projectPath, options) {
+    const userDir = join(projectPath, USER_DOCS);
+    const docs = await scanDirectory(userDir);
+    // Infer project name: from first doc with project field, then directory name
+    const projectDoc = docs.find((d) => d.project);
+    const inferredName = options?.name ?? titleCase(projectDoc?.project ?? basename(projectPath));
+    const model = {
+        name: inferredName,
+        description: options?.description ?? '',
+        foundation: [],
+        projectArchitecture: [],
+        initiatives: {},
+        futureSlices: [],
+        quality: [],
+        investigation: [],
+        maintenance: [],
+        devlog: false,
+    };
+    // Check DEVLOG.md at project root
+    model.devlog = await fileExists(join(projectPath, 'DEVLOG.md'));
+    // --- Foundation band (000-009) ---
+    const foundationTypes = new Set(['concept', 'spec', 'hld', 'slices']);
+    const foundationDocs = docs
+        .filter((d) => d.index >= 0 && d.index <= 9 && foundationTypes.has(d.docType))
+        .sort((a, b) => a.index - b.index || a.docType.localeCompare(b.docType));
+    model.foundation = foundationDocs.map((d) => ({
+        ...toDocSummary(d),
+        type: d.docType,
+    }));
+    // --- Project architecture band (050-099) ---
+    const archTypes = new Set(['arch', 'hld']);
+    const projArchDocs = docs
+        .filter((d) => d.index >= 50 && d.index <= 99 && archTypes.has(d.docType))
+        .sort((a, b) => a.index - b.index);
+    model.projectArchitecture = projArchDocs.map((d) => ({
+        ...toDocSummary(d),
+        type: (d.name.includes('hld') || d.docType === 'hld' ? 'hld' : 'arch'),
+    }));
+    // --- Initiative bands (100-799) ---
+    // Identify base indices from arch or slices docs
+    const baseIndices = new Set();
+    for (const d of docs) {
+        if (d.index >= 100 && d.index <= 799 && (d.docType === 'arch' || d.docType === 'slices')) {
+            baseIndices.add(d.index);
+        }
+    }
+    const sortedBases = [...baseIndices].sort((a, b) => a - b);
+    for (let i = 0; i < sortedBases.length; i++) {
+        const base = sortedBases[i];
+        const upper = i + 1 < sortedBases.length ? sortedBases[i + 1] : 800;
+        const archDoc = docs.find((d) => d.index === base && d.docType === 'arch');
+        const slicesDoc = docs.find((d) => d.index === base && d.docType === 'slices');
+        const rawName = archDoc?.name ?? slicesDoc?.name ?? String(base);
+        const initiative = {
+            name: titleCase(rawName),
+            slices: [],
+            features: [],
+        };
+        if (archDoc) {
+            initiative.arch = toDocSummary(archDoc);
+        }
+        // Slice plan: parse both main-body entries and future work section
+        let planEntries = [];
+        if (slicesDoc) {
+            const [planResult, fwResult] = await Promise.all([
+                parseSlicePlan(slicesDoc.filepath),
+                parseFutureWork(slicesDoc.filepath, upper),
+            ]);
+            planEntries = planResult.entries;
+            const planBlock = {
+                ...toDocSummary(slicesDoc),
+                filepath: slicesDoc.filepath,
+                entries: planResult.entries,
+                futureWork: fwResult.items,
+            };
+            initiative.slicePlan = planBlock;
+        }
+        // Collect actual slice docs in this band
+        const bandSlices = docs
+            .filter((d) => d.index >= base && d.index < upper && d.docType === 'slice')
+            .sort((a, b) => a.index - b.index);
+        // Collect task docs in this band (grouped by index)
+        const bandTasks = docs.filter((d) => d.index >= base && d.index < upper && d.docType === 'tasks');
+        const tasksByIndex = new Map();
+        for (const t of bandTasks) {
+            const existing = tasksByIndex.get(t.index) ?? [];
+            existing.push(t);
+            tasksByIndex.set(t.index, existing);
+        }
+        // Collect feature/issue docs in this band (grouped by index)
+        const bandFeatures = docs.filter((d) => d.index >= base &&
+            d.index < upper &&
+            (d.docType === 'feature' || d.docType === 'issue'));
+        const featuresByIndex = new Map();
+        for (const f of bandFeatures) {
+            const existing = featuresByIndex.get(f.index) ?? [];
+            existing.push(f);
+            featuresByIndex.set(f.index, existing);
+        }
+        // Build slice entries
+        const sliceIndices = new Set(bandSlices.map((s) => s.index));
+        for (const sliceDoc of bandSlices) {
+            const entry = toDocSummary(sliceDoc);
+            // Attach tasks
+            const tasks = tasksByIndex.get(sliceDoc.index);
+            if (tasks && tasks.length > 0) {
+                entry.tasks = buildTaskEntry(tasks);
+            }
+            // Attach features
+            const features = featuresByIndex.get(sliceDoc.index);
+            if (features && features.length > 0) {
+                entry.features = features.map(toDocSummary);
+            }
+            initiative.slices.push(entry);
+        }
+        // Fill planned-but-unwritten slices from slice plan main body (matching parse.py)
+        for (const entry of planEntries) {
+            if (entry.index >= base && entry.index < upper && !sliceIndices.has(entry.index)) {
+                initiative.slices.push({
+                    index: pad(entry.index),
+                    name: entry.name,
+                    status: entry.isChecked ? 'complete' : 'not-started',
+                    planned: true,
+                });
+            }
+        }
+        // Re-sort all slices by index
+        initiative.slices.sort((a, b) => a.index.localeCompare(b.index));
+        // Collect unclaimed features as futureSlices
+        for (const [idx, feats] of featuresByIndex) {
+            if (!sliceIndices.has(idx)) {
+                for (const f of feats) {
+                    const entry = {
+                        ...toDocSummary(f),
+                        parent: pad(base),
+                    };
+                    model.futureSlices.push(entry);
+                }
+            }
+        }
+        model.initiatives[pad(base)] = initiative;
+    }
+    // --- Operational band (900+) ---
+    // Quality: review docs 900+
+    model.quality = docs
+        .filter((d) => d.index >= 900 && d.docType === 'review')
+        .sort((a, b) => a.index - b.index)
+        .map(toDocSummary);
+    // Investigation: all analysis docs (no index filter per parse.py)
+    model.investigation = docs
+        .filter((d) => d.docType === 'analysis')
+        .sort((a, b) => a.index - b.index)
+        .map(toDocSummary);
+    // Maintenance: tasks docs 900+
+    model.maintenance = docs
+        .filter((d) => d.index >= 900 && d.docType === 'tasks')
+        .sort((a, b) => a.index - b.index)
+        .map((d) => {
+        const entry = toDocSummary(d);
+        if (d.taskItems.length > 0) {
+            entry.taskCount = d.taskItems.length;
+            entry.completedTasks = d.taskItems.filter((t) => t.done).length;
+        }
+        return entry;
+    });
+    return model;
+}
+//# sourceMappingURL=ProjectModelBuilder.js.map

package/dist/introspection/ProjectModelBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProjectModelBuilder.js","sourceRoot":"","sources":["../../src/introspection/ProjectModelBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAehE,MAAM,SAAS,GAAG,wBAAwB,CAAC;AAE3C,+DAA+D;AAC/D,MAAM,SAAS,GAAG;IAChB,cAAc;IACd,QAAQ;IACR,OAAO;IACP,UAAU;IACV,gBAAgB;IAChB,SAAS;IACT,UAAU;IACV,aAAa;CACL,CAAC;AAEX,kEAAkE;AAClE,MAAM,UAAU,GAAG,2GAA2G,CAAC;AAE/H,oDAAoD;AACpD,MAAM,QAAQ,GAAG,uDAAuD,CAAC;AAmBzE,sDAAsD;AACtD,KAAK,UAAU,WAAW,CAAC,OAAe;IACxC,IAAI,CAAC;QACH,OAAO,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,2BAA2B;AAC3B,KAAK,UAAU,UAAU,CAAC,QAAgB;IACxC,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,OAAe;IACjD,MAAM,IAAI,GAAe,EAAE,CAAC;IAE5B,KAAK,MAAM,MAAM,IAAI,SAAS,EAAE,CAAC;QAC/B,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QACtC,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,OAAO,CAAC,CAAC;QAEzC,KAAK,MAAM,QAAQ,IAAI,KAAK,EAAE,CAAC;YAC7B,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC;gBAAE,SAAS;YAExC,IAAI,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAClC,IAAI,QAA4B,CAAC;YAEjC,IAAI,CAAC,CAAC,EAAE,CAAC;gBACP,qCAAqC;gBACrC,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBAC5B,IAAI,CAAC,CAAC;oBAAE,SAAS;YACnB,CAAC;iBAAM,CAAC;gBACN,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YACnD,CAAC;YAED,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YACjC,MAAM,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;YACnC,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YAClB,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YAEzC,oBAAoB;YACpB,MAAM,EAAE,GAAG,MAAM,gBAAgB,CAAC,QAAQ,CAAC,CAAC;YAC5C,MAAM,MAAM,GAAG,eAAe,CAAC,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAE/C,iCAAiC;YACjC,IAAI,SAAS,GAAe,EAAE,CAAC;YAC/B,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;gBACxB,SAAS,GAAG,MAAM,cAAc,CAAC,QAAQ,CAAC,CAAC;YAC7C,CAAC;YAED,IAAI,CAAC,IAAI,CAAC;gBACR,KAAK;gBACL,OAAO;gBACP,IAAI;gBACJ,QAAQ;gBACR,QAAQ;gBACR,MAAM;gBACN,WAAW,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,IAAI,SAAS;gBAC7C,WAAW,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,IAAI,SAAS;gBAC7C,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,IAAI,SAAS;gBACrC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,IAAI,SAAS;gBACnC,WAAW,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,IAAI,SAAS;gBAC7C,SAAS;gBACT,QAAQ;aACT,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,gFAAgF;AAChF,SAAS,GAAG,CAAC,KAAa;IACxB,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AACxC,CAAC;AAED,yEAAyE;AACzE,SAAS,YAAY,CAAC,GAAa;IACjC,MAAM,MAAM,GAAe;QACzB,KAAK,EAAE,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC;QACrB,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,MAAM,EAAE,GAAG,CAAC,MAAM;KACnB,CAAC;IACF,IAAI,GAAG,CAAC,WAAW;QAAE,MAAM,CAAC,WAAW,GAAG,GAAG,CAAC,WAAW,CAAC;IAC1D,IAAI,GAAG,CAAC,WAAW;QAAE,MAAM,CAAC,WAAW,GAAG,GAAG,CAAC,WAAW,CAAC;IAC1D,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,+EAA+E;AAC/E,SAAS,SAAS,CAAC,CAAS;IAC1B,OAAO,CAAC;SACL,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;SACtB,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;AAC9C,CAAC;AAED,oEAAoE;AACpE,SAAS,cAAc,CAAC,QAAoB;IAC1C,MAAM,MAAM,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC,CAAC;IACnF,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IAExB,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACpD,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC;IAClC,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;IAE7D,+DAA+D;IAC/D,IAAI,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC;IAC1B,IAAI,MAAM,KAAK,aAAa,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;QAC9C,IAAI,cAAc,KAAK,SAAS;YAAE,MAAM,GAAG,UAAU,CAAC;aACjD,IAAI,cAAc,GAAG,CAAC;YAAE,MAAM,GAAG,aAAa,CAAC;IACtD,CAAC;IAED,MAAM,KAAK,GAAmB;QAC5B,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC;QACvB,IAAI,EAAE,SAAS,KAAK,CAAC,IAAI,EAAE;QAC3B,MAAM;QACN,SAAS;QACT,cAAc;KACf,CAAC;IACF,IAAI,KAAK,CAAC,WAAW;QAAE,KAAK,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;IAC7D,IAAI,KAAK,CAAC,WAAW;QAAE,KAAK,CAAC,WAAW,GAAG,KAAK,CAAC,WAAW,CAAC;IAC7D,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC;QAAE,KAAK,CAAC,KAAK,GAAG,QAAQ,CAAC;IAChD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,WAAmB,EACnB,OAAiD;IAEjD,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IAC7C,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,OAAO,CAAC,CAAC;IAE1C,6EAA6E;IAC7E,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IAC/C,MAAM,YAAY,GAAG,OAAO,EAAE,IAAI,IAAI,SAAS,CAAC,UAAU,EAAE,OAAO,IAAI,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC;IAE9F,MAAM,KAAK,GAAiB;QAC1B,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,OAAO,EAAE,WAAW,IAAI,EAAE;QACvC,UAAU,EAAE,EAAE;QACd,mBAAmB,EAAE,EAAE;QACvB,WAAW,EAAE,EAAE;QACf,YAAY,EAAE,EAAE;QAChB,OAAO,EAAE,EAAE;QACX,aAAa,EAAE,EAAE;QACjB,WAAW,EAAE,EAAE;QACf,MAAM,EAAE,KAAK;KACd,CAAC;IAEF,kCAAkC;IAClC,KAAK,CAAC,MAAM,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC,CAAC;IAEhE,oCAAoC;IACpC,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC;IACtE,MAAM,cAAc,GAAG,IAAI;SACxB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC,IAAI,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;SAC7E,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAE3E,KAAK,CAAC,UAAU,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC5C,GAAG,YAAY,CAAC,CAAC,CAAC;QAClB,IAAI,EAAE,CAAC,CAAC,OAAO;KAChB,CAAC,CAAsB,CAAC;IAEzB,8CAA8C;IAC9C,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;IAC3C,MAAM,YAAY,GAAG,IAAI;SACtB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,IAAI,CAAC,CAAC,KAAK,IAAI,EAAE,IAAI,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;SACzE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IAErC,KAAK,CAAC,mBAAmB,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACnD,GAAG,YAAY,CAAC,CAAC,CAAC;QAClB,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAmB;KACzF,CAAC,CAAgB,CAAC;IAEnB,qCAAqC;IACrC,iDAAiD;IACjD,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;IACtC,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACrB,IAAI,CAAC,CAAC,KAAK,IAAI,GAAG,IAAI,CAAC,CAAC,KAAK,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,OAAO,KAAK,MAAM,IAAI,CAAC,CAAC,OAAO,KAAK,QAAQ,CAAC,EAAE,CAAC;YACzF,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,MAAM,WAAW,GAAG,CAAC,GAAG,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAE3D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,WAAW,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5C,MAAM,IAAI,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;QAC5B,MAAM,KAAK,GAAG,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QAEpE,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,IAAI,IAAI,CAAC,CAAC,OAAO,KAAK,MAAM,CAAC,CAAC;QAC3E,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,IAAI,IAAI,CAAC,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC;QAE/E,MAAM,OAAO,GAAG,OAAO,EAAE,IAAI,IAAI,SAAS,EAAE,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC;QACjE,MAAM,UAAU,GAAe;YAC7B,IAAI,EAAE,SAAS,CAAC,OAAO,CAAC;YACxB,MAAM,EAAE,EAAE;YACV,QAAQ,EAAE,EAAE;SACb,CAAC;QAEF,IAAI,OAAO,EAAE,CAAC;YACZ,UAAU,CAAC,IAAI,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;QAC1C,CAAC;QAED,mEAAmE;QACnE,IAAI,WAAW,GAA0C,EAAE,CAAC;QAC5D,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,CAAC,UAAU,EAAE,QAAQ,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;gBAC/C,cAAc,CAAC,SAAS,CAAC,QAAQ,CAAC;gBAClC,eAAe,CAAC,SAAS,CAAC,QAAQ,EAAE,KAAK,CAAC;aAC3C,CAAC,CAAC;YACH,WAAW,GAAG,UAAU,CAAC,OAAO,CAAC;YACjC,MAAM,SAAS,GAAmB;gBAChC,GAAG,YAAY,CAAC,SAAS,CAAC;gBAC1B,QAAQ,EAAE,SAAS,CAAC,QAAQ;gBAC5B,OAAO,EAAE,UAAU,CAAC,OAAO;gBAC3B,UAAU,EAAE,QAAQ,CAAC,KAAK;aAC3B,CAAC;YACF,UAAU,CAAC,SAAS,GAAG,SAAS,CAAC;QACnC,CAAC;QAED,yCAAyC;QACzC,MAAM,UAAU,GAAG,IAAI;aACpB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,IAAI,CAAC,CAAC,KAAK,GAAG,KAAK,IAAI,CAAC,CAAC,OAAO,KAAK,OAAO,CAAC;aAC1E,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;QAErC,oDAAoD;QACpD,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAC3B,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,IAAI,CAAC,CAAC,KAAK,GAAG,KAAK,IAAI,CAAC,CAAC,OAAO,KAAK,OAAO,CACnE,CAAC;QACF,MAAM,YAAY,GAAG,IAAI,GAAG,EAAsB,CAAC;QACnD,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;YAC1B,MAAM,QAAQ,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;YACjD,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACjB,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QACtC,CAAC;QAED,6DAA6D;QAC7D,MAAM,YAAY,GAAG,IAAI,CAAC,MAAM,CAC9B,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,KAAK,IAAI,IAAI;YACf,CAAC,CAAC,KAAK,GAAG,KAAK;YACf,CAAC,CAAC,CAAC,OAAO,KAAK,SAAS,IAAI,CAAC,CAAC,OAAO,KAAK,OAAO,CAAC,CACrD,CAAC;QACF,MAAM,eAAe,GAAG,IAAI,GAAG,EAAsB,CAAC;QACtD,KAAK,MAAM,CAAC,IAAI,YAAY,EAAE,CAAC;YAC7B,MAAM,QAAQ,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;YACpD,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YACjB,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;QACzC,CAAC;QAED,sBAAsB;QACtB,MAAM,YAAY,GAAG,IAAI,GAAG,CAAS,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;QAErE,KAAK,MAAM,QAAQ,IAAI,UAAU,EAAE,CAAC;YAClC,MAAM,KAAK,GAAoB,YAAY,CAAC,QAAQ,CAAoB,CAAC;YAEzE,eAAe;YACf,MAAM,KAAK,GAAG,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;YAC/C,IAAI,KAAK,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC9B,KAAK,CAAC,KAAK,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC;YACtC,CAAC;YAED,kBAAkB;YAClB,MAAM,QAAQ,GAAG,eAAe,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;YACrD,IAAI,QAAQ,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACpC,KAAK,CAAC,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC;YAC9C,CAAC;YAED,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;QAED,kFAAkF;QAClF,KAAK,MAAM,KAAK,IAAI,WAAW,EAAE,CAAC;YAChC,IAAI,KAAK,CAAC,KAAK,IAAI,IAAI,IAAI,KAAK,CAAC,KAAK,GAAG,KAAK,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;gBACjF,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC;oBACrB,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC;oBACvB,IAAI,EAAE,KAAK,CAAC,IAAI;oBAChB,MAAM,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,aAAa;oBACpD,OAAO,EAAE,IAAI;iBACd,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QACD,8BAA8B;QAC9B,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;QAEjE,6CAA6C;QAC7C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,eAAe,EAAE,CAAC;YAC3C,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC3B,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;oBACtB,MAAM,KAAK,GAAqB;wBAC9B,GAAG,YAAY,CAAC,CAAC,CAAC;wBAClB,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC;qBAClB,CAAC;oBACF,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBACjC,CAAC;YACH,CAAC;QACH,CAAC;QAED,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,UAAU,CAAC;IAC5C,CAAC;IAED,kCAAkC;IAClC,4BAA4B;IAC5B,KAAK,CAAC,OAAO,GAAG,IAAI;SACjB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,IAAI,CAAC,CAAC,OAAO,KAAK,QAAQ,CAAC;SACvD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;SACjC,GAAG,CAAC,YAAY,CAAC,CAAC;IAErB,kEAAkE;IAClE,KAAK,CAAC,aAAa,GAAG,IAAI;SACvB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,UAAU,CAAC;SACvC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;SACjC,GAAG,CAAC,YAAY,CAAC,CAAC;IAErB,+BAA+B;IAC/B,KAAK,CAAC,WAAW,GAAG,IAAI;SACrB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,IAAI,CAAC,CAAC,OAAO,KAAK,OAAO,CAAC;SACtD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;SACjC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACT,MAAM,KAAK,GAAqB,YAAY,CAAC,CAAC,CAAC,CAAC;QAChD,IAAI,CAAC,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC3B,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC;YACrC,KAAK,CAAC,cAAc,GAAG,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC;QAClE,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC,CAAC,CAAC;IAEL,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/introspection/index.d.ts

@@ -0,0 +1,4 @@
+export * from './types.js';
+export type { IArtifactIntrospector } from './interfaces.js';
+export { normalizeStatus } from './parsers/statusNormalizer.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/introspection/index.ts"],"names":[],"mappings":"AACA,cAAc,YAAY,CAAC;AAC3B,YAAY,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAG7D,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/introspection/index.js

@@ -0,0 +1,5 @@
+// Introspection module — browser-safe exports (types, interfaces, pure functions)
+export * from './types.js';
+// normalizeStatus is a pure function with no fs dependency — browser-safe
+export { normalizeStatus } from './parsers/statusNormalizer.js';
+//# sourceMappingURL=index.js.map

package/dist/introspection/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/introspection/index.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,cAAc,YAAY,CAAC;AAG3B,0EAA0E;AAC1E,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC"}

package/dist/introspection/interfaces.d.ts

@@ -0,0 +1,18 @@
+import type { ProjectData } from '../types/project.js';
+import type { SlicePlanResult, TaskFileResult, FrontmatterResult, FutureWorkResult, DocumentDetectionResult, IntrospectionSummary } from './types.js';
+/** Public interface for artifact introspection — consumed by slices 164–166 and project_get enrichment */
+export interface IArtifactIntrospector {
+    /** Parse a slice plan and return entries with completion state */
+    parseSlicePlan(slicePlanPath: string): Promise<SlicePlanResult>;
+    /** Parse a task file (or merged split files) and return checkbox items */
+    parseTaskFile(taskFilePaths: string | string[]): Promise<TaskFileResult>;
+    /** Extract YAML frontmatter from a markdown file */
+    parseFrontmatter(filePath: string): Promise<FrontmatterResult>;
+    /** Parse the Future Work section from a slice plan */
+    parseFutureWork(slicePlanPath: string, nextIndex?: number): Promise<FutureWorkResult>;
+    /** Check what methodology documents exist for a given slice index */
+    detectDocuments(projectPath: string, sliceIndex: number): Promise<DocumentDetectionResult>;
+    /** Generate an introspection summary for a project (for enriching project_get) */
+    summarize(project: ProjectData): Promise<IntrospectionSummary>;
+}
+//# sourceMappingURL=interfaces.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../../src/introspection/interfaces.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,uBAAuB,EACvB,oBAAoB,EACrB,MAAM,YAAY,CAAC;AAEpB,0GAA0G;AAC1G,MAAM,WAAW,qBAAqB;IACpC,kEAAkE;IAClE,cAAc,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAEhE,0EAA0E;IAC1E,aAAa,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IAEzE,oDAAoD;IACpD,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAE/D,sDAAsD;IACtD,eAAe,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAEtF,qEAAqE;IACrE,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAC;IAE3F,kFAAkF;IAClF,SAAS,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;CAChE"}

package/dist/introspection/interfaces.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=interfaces.js.map

package/dist/introspection/interfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../../src/introspection/interfaces.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,12 @@
+import type { DocumentDetectionResult } from '../types.js';
+/**
+ * Check if a file exists at the given path.
+ */
+export declare function checkFileExists(projectPath: string, relativePath: string): Promise<boolean>;
+/**
+ * Detect methodology documents for a given slice index under a project path.
+ * Checks project-documents/user/ subdirectories for matching files.
+ * Never throws — returns nulls for missing directories.
+ */
+export declare function detectDocuments(projectPath: string, sliceIndex: number): Promise<DocumentDetectionResult>;
+//# sourceMappingURL=documentDetector.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"documentDetector.d.ts","sourceRoot":"","sources":["../../../src/introspection/parsers/documentDetector.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAI3D;;GAEG;AACH,wBAAsB,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOjG;AAwBD;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,uBAAuB,CAAC,CA8BlC"}

package/dist/introspection/parsers/documentDetector.js

@@ -0,0 +1,66 @@
+import { readdir, access } from 'node:fs/promises';
+import { join } from 'node:path';
+const USER_DOCS = 'project-documents/user';
+/**
+ * Check if a file exists at the given path.
+ */
+export async function checkFileExists(projectPath, relativePath) {
+    try {
+        await access(join(projectPath, relativePath));
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Read a directory listing safely — returns empty array on error.
+ */
+async function safeReaddir(dirPath) {
+    try {
+        return await readdir(dirPath);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Find files in a directory matching a prefix pattern like `NNN-type.`.
+ * Returns full relative paths from projectPath.
+ */
+function matchFiles(files, prefix, dir) {
+    return files
+        .filter((f) => f.startsWith(prefix) && f.endsWith('.md'))
+        .sort()
+        .map((f) => join(dir, f));
+}
+/**
+ * Detect methodology documents for a given slice index under a project path.
+ * Checks project-documents/user/ subdirectories for matching files.
+ * Never throws — returns nulls for missing directories.
+ */
+export async function detectDocuments(projectPath, sliceIndex) {
+    const idx = String(sliceIndex);
+    const slicesDir = join(projectPath, USER_DOCS, 'slices');
+    const tasksDir = join(projectPath, USER_DOCS, 'tasks');
+    const archDir = join(projectPath, USER_DOCS, 'architecture');
+    const [sliceFiles, taskFiles, archFiles] = await Promise.all([
+        safeReaddir(slicesDir),
+        safeReaddir(tasksDir),
+        safeReaddir(archDir),
+    ]);
+    // slices/{index}-slice.*.md → sliceDesign
+    const sliceMatches = matchFiles(sliceFiles, `${idx}-slice.`, join(USER_DOCS, 'slices'));
+    const sliceDesign = sliceMatches.length > 0 ? sliceMatches[0] : null;
+    // tasks/{index}-tasks.*.md → taskFile (array, supports split files)
+    const taskMatches = matchFiles(taskFiles, `${idx}-tasks.`, join(USER_DOCS, 'tasks'));
+    const taskFile = taskMatches.length > 0 ? taskMatches : null;
+    // architecture/{index}-arch.*.md → architecture
+    const archMatches = matchFiles(archFiles, `${idx}-arch.`, join(USER_DOCS, 'architecture'));
+    const architecture = archMatches.length > 0 ? archMatches[0] : null;
+    // architecture/{index}-slices.*.md → slicePlan
+    const planMatches = matchFiles(archFiles, `${idx}-slices.`, join(USER_DOCS, 'architecture'));
+    const slicePlan = planMatches.length > 0 ? planMatches[0] : null;
+    return { sliceDesign, taskFile, architecture, slicePlan };
+}
+//# sourceMappingURL=documentDetector.js.map

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

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