@contorium/mcp 0.8.1

package/node_modules/@contora/state-core/dist/scanner/workspaceScanner.js

@@ -0,0 +1,148 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.scanWorkspace = scanWorkspace;
+const fs = __importStar(require("node:fs/promises"));
+const path = __importStar(require("node:path"));
+const gitScan_js_1 = require("./gitScan.js");
+const SKIP_DIRS = new Set([
+    'node_modules',
+    '.git',
+    '.contora',
+    '.context-recall',
+    'dist',
+    'out',
+    '.vscode',
+    'coverage',
+]);
+const SKIP_EXT = /\.(png|jpg|jpeg|gif|ico|woff2?|ttf|eot|zip|vsix|map)$/i;
+async function readReadmeHint(root) {
+    for (const name of ['README.md', 'readme.md', 'Readme.md']) {
+        try {
+            const text = await fs.readFile(path.join(root, name), 'utf8');
+            for (const line of text.split('\n')) {
+                const t = line.replace(/^#+\s*/, '').trim();
+                if (t.length >= 12 && !/^contorium|table of contents/i.test(t)) {
+                    return t.length > 160 ? t.slice(0, 157) + '…' : t;
+                }
+            }
+        }
+        catch {
+            /* try next */
+        }
+    }
+    return undefined;
+}
+async function listTopLevelModules(root) {
+    const out = [];
+    try {
+        const entries = await fs.readdir(root, { withFileTypes: true });
+        for (const e of entries) {
+            if (!e.isDirectory() || e.name.startsWith('.') || SKIP_DIRS.has(e.name)) {
+                continue;
+            }
+            out.push(e.name);
+        }
+    }
+    catch {
+        return out;
+    }
+    return out.slice(0, 12);
+}
+async function collectRecentFiles(root, maxFiles, maxDepth) {
+    const scored = [];
+    async function walk(dir, depth) {
+        if (depth > maxDepth || scored.length >= maxFiles * 3) {
+            return;
+        }
+        let entries;
+        try {
+            entries = await fs.readdir(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const e of entries) {
+            const name = e.name;
+            if (name.startsWith('.') && name !== '.env') {
+                if (SKIP_DIRS.has(name)) {
+                    continue;
+                }
+            }
+            const full = path.join(dir, name);
+            const rel = path.relative(root, full).replace(/\\/g, '/');
+            if (e.isDirectory()) {
+                if (!SKIP_DIRS.has(name)) {
+                    await walk(full, depth + 1);
+                }
+                continue;
+            }
+            if (SKIP_EXT.test(name)) {
+                continue;
+            }
+            try {
+                const st = await fs.stat(full);
+                scored.push({ rel, mtime: st.mtimeMs });
+            }
+            catch {
+                /* skip */
+            }
+        }
+    }
+    await walk(root, 0);
+    scored.sort((a, b) => b.mtime - a.mtime);
+    return scored.slice(0, maxFiles).map((s) => s.rel);
+}
+/** Mode B — workspace filesystem scan (no IDE required). */
+async function scanWorkspace(workspaceRoot) {
+    const root = path.resolve(workspaceRoot);
+    const now = Date.now();
+    const [git, topLevelModules, recentFiles, readmeHint] = await Promise.all([
+        (0, gitScan_js_1.scanGitPorcelain)(root),
+        listTopLevelModules(root),
+        collectRecentFiles(root, 24, 5),
+        readReadmeHint(root),
+    ]);
+    return {
+        workspaceRoot: root,
+        scannedAt: now,
+        topLevelModules,
+        recentFiles,
+        gitStaged: git.staged,
+        gitWorking: git.working,
+        readmeHint,
+        isGitRepo: git.isRepo,
+    };
+}

package/node_modules/@contora/state-core/dist/semiAutoHandoff.d.ts

@@ -0,0 +1,46 @@
+import { type ChpHandoffFormat } from './understanding/chpHandoff.js';
+export type HandoffInjectionStatus = 'pending' | 'injected' | 'skipped';
+export interface HandoffInjectionState {
+    runtime_id: string;
+    status: HandoffInjectionStatus;
+    prompted_at: number;
+    resolved_at?: number;
+    context_file: string;
+    format?: ChpHandoffFormat;
+    /** Set on each new AI chat — skip/inject applies to this chat only. */
+    chat_session_id?: string;
+}
+export interface PrepareHandoffOptions {
+    /** New AI chat (MCP reconnect / new Agent window) — always re-prompt. */
+    newChat?: boolean;
+}
+/** Active runtime = bootstrap marker + handoff available. */
+export declare function checkActiveRuntime(workspaceRoot: string): Promise<{
+    active: boolean;
+    runtime_id?: string;
+}>;
+export declare function readHandoffInjectionState(workspaceRoot: string): Promise<HandoffInjectionState | undefined>;
+export declare function readConfirmedHandoffContext(workspaceRoot: string): Promise<string | undefined>;
+export declare function buildInjectionPromptMessage(projectHint: string, compactLine?: string): string;
+/** Prepare semi-auto injection — pending only, does NOT write context file. */
+export declare function prepareHandoffInjection(workspaceRoot: string, options?: PrepareHandoffOptions): Promise<{
+    shouldPrompt: boolean;
+    alreadyInjected: boolean;
+    prompt?: string;
+    state?: HandoffInjectionState;
+    compact?: string;
+}>;
+/** User confirmed — write context file and mark injected. */
+export declare function confirmHandoffInjection(workspaceRoot: string, format?: ChpHandoffFormat): Promise<{
+    ok: boolean;
+    filePath?: string;
+    text?: string;
+    hint?: string;
+}>;
+/** User declined injection for this runtime session. */
+export declare function skipHandoffInjection(workspaceRoot: string): Promise<{
+    ok: boolean;
+}>;
+/** Reset pending state when runtime_id changes (new bootstrap). */
+export declare function syncInjectionWithRuntime(workspaceRoot: string): Promise<void>;
+//# sourceMappingURL=semiAutoHandoff.d.ts.map

package/node_modules/@contora/state-core/dist/semiAutoHandoff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semiAutoHandoff.d.ts","sourceRoot":"","sources":["../src/semiAutoHandoff.ts"],"names":[],"mappings":"AAEA,OAAO,EAAqB,KAAK,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAMzF,MAAM,MAAM,sBAAsB,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,CAAC;AAExE,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,sBAAsB,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,uEAAuE;IACvE,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,qBAAqB;IACpC,yEAAyE;IACzE,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAoBD,6DAA6D;AAC7D,wBAAsB,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC;IACvE,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC,CAWD;AAED,wBAAsB,yBAAyB,CAC7C,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,qBAAqB,GAAG,SAAS,CAAC,CAE5C;AAED,wBAAsB,2BAA2B,CAC/C,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAU7B;AAED,wBAAgB,2BAA2B,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,CAU7F;AAED,+EAA+E;AAC/E,wBAAsB,uBAAuB,CAC3C,aAAa,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,OAAO,CAAC;IACT,YAAY,EAAE,OAAO,CAAC;IACtB,eAAe,EAAE,OAAO,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,qBAAqB,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC,CAuDD;AAED,6DAA6D;AAC7D,wBAAsB,uBAAuB,CAC3C,aAAa,EAAE,MAAM,EACrB,MAAM,GAAE,gBAA6B,GACpC,OAAO,CAAC;IACT,EAAE,EAAE,OAAO,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC,CA4BD;AAYD,wDAAwD;AACxD,wBAAsB,oBAAoB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAA;CAAE,CAAC,CAgB1F;AAED,mEAAmE;AACnE,wBAAsB,wBAAwB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBnF"}

package/node_modules/@contora/state-core/dist/semiAutoHandoff.js

@@ -0,0 +1,227 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkActiveRuntime = checkActiveRuntime;
+exports.readHandoffInjectionState = readHandoffInjectionState;
+exports.readConfirmedHandoffContext = readConfirmedHandoffContext;
+exports.buildInjectionPromptMessage = buildInjectionPromptMessage;
+exports.prepareHandoffInjection = prepareHandoffInjection;
+exports.confirmHandoffInjection = confirmHandoffInjection;
+exports.skipHandoffInjection = skipHandoffInjection;
+exports.syncInjectionWithRuntime = syncInjectionWithRuntime;
+const fs = __importStar(require("node:fs/promises"));
+const path = __importStar(require("node:path"));
+const chpHandoff_js_1 = require("./understanding/chpHandoff.js");
+const INJECTION_STATE_FILE = 'mcp.handoff-injection.json';
+const CONTEXT_FILE = 'mcp.auto-context.md';
+const BOOTSTRAP_FILE = 'runtime.bootstrap.json';
+function contoraPath(workspaceRoot, name) {
+    return path.join(path.resolve(workspaceRoot), '.contora', name);
+}
+async function readJson(filePath) {
+    try {
+        const raw = await fs.readFile(filePath, 'utf8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return undefined;
+    }
+}
+async function writeJson(filePath, data) {
+    await fs.mkdir(path.dirname(filePath), { recursive: true });
+    await fs.writeFile(filePath, `${JSON.stringify(data, null, 2)}\n`, 'utf8');
+}
+/** Active runtime = bootstrap marker + handoff available. */
+async function checkActiveRuntime(workspaceRoot) {
+    const root = path.resolve(workspaceRoot);
+    const bootstrap = await readJson(contoraPath(root, BOOTSTRAP_FILE));
+    if (!bootstrap?.runtime_id) {
+        return { active: false };
+    }
+    const handoff = await (0, chpHandoff_js_1.getProjectHandoff)(root, 'compact');
+    if (!handoff.found) {
+        return { active: false, runtime_id: bootstrap.runtime_id };
+    }
+    return { active: true, runtime_id: bootstrap.runtime_id };
+}
+async function readHandoffInjectionState(workspaceRoot) {
+    return readJson(contoraPath(workspaceRoot, INJECTION_STATE_FILE));
+}
+async function readConfirmedHandoffContext(workspaceRoot) {
+    const state = await readHandoffInjectionState(workspaceRoot);
+    if (state?.status !== 'injected') {
+        return undefined;
+    }
+    try {
+        return await fs.readFile(contoraPath(workspaceRoot, CONTEXT_FILE), 'utf8');
+    }
+    catch {
+        return undefined;
+    }
+}
+function buildInjectionPromptMessage(projectHint, compactLine) {
+    const project = projectHint || 'this project';
+    const lines = [
+        `[?] Contorium Runtime active for "${project}". Inject current working state? (Y/n)`,
+        `Terminal: Enter or i · IDE: click [?] on status bar · Agent: confirm_handoff_injection`,
+    ];
+    if (compactLine) {
+        lines.push(compactLine);
+    }
+    return lines.join('\n');
+}
+/** Prepare semi-auto injection — pending only, does NOT write context file. */
+async function prepareHandoffInjection(workspaceRoot, options) {
+    const root = path.resolve(workspaceRoot);
+    const { active, runtime_id } = await checkActiveRuntime(root);
+    if (!active || !runtime_id) {
+        return { shouldPrompt: false, alreadyInjected: false };
+    }
+    const existing = await readHandoffInjectionState(root);
+    const compact = await (0, chpHandoff_js_1.getProjectHandoff)(root, 'compact');
+    const project = path.basename(root);
+    const chatSessionId = options?.newChat
+        ? `chat-${Date.now()}`
+        : existing?.chat_session_id ?? `chat-${Date.now()}`;
+    if (options?.newChat) {
+        const state = {
+            runtime_id,
+            status: 'pending',
+            prompted_at: Date.now(),
+            context_file: `.contora/${CONTEXT_FILE}`,
+            chat_session_id: chatSessionId,
+        };
+        await writeJson(contoraPath(root, INJECTION_STATE_FILE), state);
+        return {
+            shouldPrompt: true,
+            alreadyInjected: false,
+            prompt: buildInjectionPromptMessage(project, compact.text),
+            state,
+            compact: compact.text,
+        };
+    }
+    if (existing?.runtime_id === runtime_id && existing.status === 'injected') {
+        return { shouldPrompt: false, alreadyInjected: true, state: existing };
+    }
+    if (existing?.runtime_id === runtime_id && existing.status === 'skipped') {
+        return { shouldPrompt: false, alreadyInjected: false, state: existing };
+    }
+    const state = {
+        runtime_id,
+        status: 'pending',
+        prompted_at: Date.now(),
+        context_file: `.contora/${CONTEXT_FILE}`,
+        chat_session_id: chatSessionId,
+    };
+    await writeJson(contoraPath(root, INJECTION_STATE_FILE), state);
+    return {
+        shouldPrompt: true,
+        alreadyInjected: false,
+        prompt: buildInjectionPromptMessage(project, compact.text),
+        state,
+        compact: compact.text,
+    };
+}
+/** User confirmed — write context file and mark injected. */
+async function confirmHandoffInjection(workspaceRoot, format = 'markdown') {
+    const root = path.resolve(workspaceRoot);
+    const { active, runtime_id } = await checkActiveRuntime(root);
+    if (!active || !runtime_id) {
+        return { ok: false, hint: 'No active runtime or handoff — save changes or run sync first.' };
+    }
+    const result = await (0, chpHandoff_js_1.getProjectHandoff)(root, format);
+    if (!result.found || !result.text) {
+        return { ok: false, hint: 'Handoff not ready.' };
+    }
+    const contextPath = contoraPath(root, CONTEXT_FILE);
+    await fs.writeFile(contextPath, result.text, 'utf8');
+    const state = {
+        runtime_id,
+        status: 'injected',
+        prompted_at: (await readHandoffInjectionState(root))?.prompted_at ?? Date.now(),
+        resolved_at: Date.now(),
+        context_file: `.contora/${CONTEXT_FILE}`,
+        format,
+        chat_session_id: (await readHandoffInjectionState(root))?.chat_session_id,
+    };
+    await writeJson(contoraPath(root, INJECTION_STATE_FILE), state);
+    await markHandoffInjectionUsed(root, runtime_id);
+    return { ok: true, filePath: contextPath, text: result.text };
+}
+async function markHandoffInjectionUsed(workspaceRoot, runtimeId) {
+    const handoffPath = contoraPath(workspaceRoot, 'handoff.json');
+    const raw = await readJson(handoffPath);
+    if (!raw) {
+        return;
+    }
+    raw.last_handoff_used = { runtime_id: runtimeId, at: Date.now() };
+    await writeJson(handoffPath, raw);
+}
+/** User declined injection for this runtime session. */
+async function skipHandoffInjection(workspaceRoot) {
+    const root = path.resolve(workspaceRoot);
+    const { runtime_id } = await checkActiveRuntime(root);
+    if (!runtime_id) {
+        return { ok: false };
+    }
+    const state = {
+        runtime_id,
+        status: 'skipped',
+        prompted_at: (await readHandoffInjectionState(root))?.prompted_at ?? Date.now(),
+        resolved_at: Date.now(),
+        context_file: `.contora/${CONTEXT_FILE}`,
+        chat_session_id: (await readHandoffInjectionState(root))?.chat_session_id,
+    };
+    await writeJson(contoraPath(root, INJECTION_STATE_FILE), state);
+    return { ok: true };
+}
+/** Reset pending state when runtime_id changes (new bootstrap). */
+async function syncInjectionWithRuntime(workspaceRoot) {
+    const root = path.resolve(workspaceRoot);
+    const { runtime_id } = await checkActiveRuntime(root);
+    if (!runtime_id) {
+        return;
+    }
+    const existing = await readHandoffInjectionState(root);
+    if (existing && existing.runtime_id !== runtime_id) {
+        await writeJson(contoraPath(root, INJECTION_STATE_FILE), {
+            runtime_id,
+            status: 'pending',
+            prompted_at: Date.now(),
+            context_file: `.contora/${CONTEXT_FILE}`,
+            chat_session_id: `chat-${Date.now()}`,
+        });
+    }
+}

package/node_modules/@contora/state-core/dist/sourceMetadata.d.ts

@@ -0,0 +1,4 @@
+import type { AdapterKind, BootstrapStateJson, StateEngineMode, StateSourceMetadata } from './types.js';
+export declare function attachStateSource(state: BootstrapStateJson, mode: StateEngineMode, writer: AdapterKind): BootstrapStateJson;
+export declare function parseStateSource(raw: unknown): StateSourceMetadata | undefined;
+//# sourceMappingURL=sourceMetadata.d.ts.map

package/node_modules/@contora/state-core/dist/sourceMetadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sourceMetadata.d.ts","sourceRoot":"","sources":["../src/sourceMetadata.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAExG,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,kBAAkB,EACzB,IAAI,EAAE,eAAe,EACrB,MAAM,EAAE,WAAW,GAClB,kBAAkB,CAOpB;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,GAAG,mBAAmB,GAAG,SAAS,CAgB9E"}

package/node_modules/@contora/state-core/dist/sourceMetadata.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.attachStateSource = attachStateSource;
+exports.parseStateSource = parseStateSource;
+function attachStateSource(state, mode, writer) {
+    const source = {
+        mode,
+        lastWriter: writer,
+        lastUpdated: new Date().toISOString(),
+    };
+    return { ...state, source };
+}
+function parseStateSource(raw) {
+    if (!raw || typeof raw !== 'object') {
+        return undefined;
+    }
+    const o = raw;
+    const mode = o.mode;
+    const lastWriter = o.lastWriter;
+    const lastUpdated = o.lastUpdated;
+    if ((mode !== 'event-driven' && mode !== 'scan-driven' && mode !== 'merged') ||
+        (lastWriter !== 'ide' && lastWriter !== 'mcp' && lastWriter !== 'cli') ||
+        typeof lastUpdated !== 'string') {
+        return undefined;
+    }
+    return { mode, lastWriter, lastUpdated };
+}

package/node_modules/@contora/state-core/dist/state-builder/buildFromScan.d.ts

@@ -0,0 +1,5 @@
+import type { BootstrapStateJson, WorkspaceScanFacts } from '../types.js';
+import type { ProjectBuiltState } from './types.js';
+/** Scan-driven L2/L4 when no IDE events (MCP / CLI bootstrap). */
+export declare function buildProjectStateFromScan(scan: WorkspaceScanFacts, state?: BootstrapStateJson): ProjectBuiltState;
+//# sourceMappingURL=buildFromScan.d.ts.map

package/node_modules/@contora/state-core/dist/state-builder/buildFromScan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buildFromScan.d.ts","sourceRoot":"","sources":["../../src/state-builder/buildFromScan.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAC1E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,kEAAkE;AAClE,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,kBAAkB,EACxB,KAAK,CAAC,EAAE,kBAAkB,GACzB,iBAAiB,CA8BnB"}

package/node_modules/@contora/state-core/dist/state-builder/buildFromScan.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildProjectStateFromScan = buildProjectStateFromScan;
+/** Scan-driven L2/L4 when no IDE events (MCP / CLI bootstrap). */
+function buildProjectStateFromScan(scan, state) {
+    const modules = [
+        ...scan.topLevelModules.slice(0, 6),
+        ...scan.recentFiles.slice(0, 4).map((f) => f.split('/').pop() ?? f),
+    ];
+    const active = [...new Set(modules)].slice(0, 8);
+    const goal = scan.readmeHint?.trim() ||
+        (active.length ? `develop ${active.slice(0, 2).join(' and ')} areas` : 'ongoing workspace development');
+    const gitCount = scan.gitStaged.length + scan.gitWorking.length;
+    return {
+        version: 1,
+        engine_version: 2,
+        generatedAt: scan.scannedAt,
+        task_anchor: state?.currentTask?.trim() || undefined,
+        project_goal: goal,
+        current_stage: scan.isGitRepo
+            ? 'repository scan (tool-agnostic bootstrap)'
+            : 'workspace scan (no git)',
+        active_modules: active,
+        recent_decisions: [],
+        open_problems: gitCount >= 6 ? ['uncommitted changes across workspace'] : ['(light or undirected activity)'],
+        completed_milestones: [],
+        next_actions: [
+            'review recent file activity',
+            ...(scan.isGitRepo ? ['review and commit pending changes'] : []),
+        ],
+        confidence: 0.35,
+    };
+}

package/node_modules/@contora/state-core/dist/state-builder/normalization.d.ts

@@ -0,0 +1,5 @@
+import type { ProjectBuiltState } from './types.js';
+/** L3 — dedupe, layer split, loop guard, semantic compression. */
+export declare function normalizeProjectBuiltState(raw: ProjectBuiltState, taskAnchor: string): ProjectBuiltState;
+export declare function filterWeakInferenceLines(lines: readonly string[], taskAnchor: string): string[];
+//# sourceMappingURL=normalization.d.ts.map

package/node_modules/@contora/state-core/dist/state-builder/normalization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalization.d.ts","sourceRoot":"","sources":["../../src/state-builder/normalization.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AA2EpD,kEAAkE;AAClE,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,iBAAiB,EACtB,UAAU,EAAE,MAAM,GACjB,iBAAiB,CAsCnB;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAc/F"}

package/node_modules/@contora/state-core/dist/state-builder/normalization.js

@@ -0,0 +1,107 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeProjectBuiltState = normalizeProjectBuiltState;
+exports.filterWeakInferenceLines = filterWeakInferenceLines;
+function normKey(s) {
+    return s.trim().toLowerCase().replace(/\s+/g, ' ');
+}
+function dedupeStrings(items, max) {
+    const seen = new Set();
+    const out = [];
+    for (const raw of items) {
+        const t = raw.trim();
+        if (t.length < 3) {
+            continue;
+        }
+        const k = normKey(t);
+        if (seen.has(k)) {
+            continue;
+        }
+        seen.add(k);
+        out.push(t);
+        if (out.length >= max) {
+            break;
+        }
+    }
+    return out;
+}
+function compressSimilarActions(actions, taskAnchor) {
+    const taskK = normKey(taskAnchor);
+    const out = [];
+    const seenRoots = new Set();
+    for (const raw of actions) {
+        let t = raw.trim();
+        if (!t) {
+            continue;
+        }
+        t = t.replace(/^continue:\s*/i, '').trim();
+        const k = normKey(t);
+        if (taskK.length >= 4 && (k === taskK || k.includes(taskK) || taskK.includes(k))) {
+            continue;
+        }
+        const root = k.slice(0, Math.min(32, k.length));
+        if (seenRoots.has(root)) {
+            continue;
+        }
+        seenRoots.add(root);
+        out.push(t);
+    }
+    return out.slice(0, 6);
+}
+function echoesTask(text, taskAnchor) {
+    const t = normKey(text);
+    const a = normKey(taskAnchor);
+    if (!a || a.length < 4) {
+        return false;
+    }
+    return t === a || t.includes(a) || a.includes(t);
+}
+function stripTaskFromGoal(goal, taskAnchor) {
+    if (!goal.trim() || echoesTask(goal, taskAnchor)) {
+        return '';
+    }
+    return goal.trim();
+}
+function stripTaskFromStage(stage, taskAnchor) {
+    if (!stage.trim() || echoesTask(stage, taskAnchor)) {
+        return stage.trim();
+    }
+    return stage.trim();
+}
+/** L3 — dedupe, layer split, loop guard, semantic compression. */
+function normalizeProjectBuiltState(raw, taskAnchor) {
+    const goal = stripTaskFromGoal(raw.project_goal, taskAnchor);
+    const stage = stripTaskFromStage(raw.current_stage, taskAnchor);
+    const modules = dedupeStrings(raw.active_modules, 8);
+    const problems = dedupeStrings(raw.open_problems.filter((p) => !echoesTask(p, taskAnchor)), 6);
+    const milestones = dedupeStrings(raw.completed_milestones, 5);
+    const decisions = dedupeStrings(raw.recent_decisions.filter((d) => !echoesTask(d, taskAnchor)), 8);
+    const next_actions = compressSimilarActions(raw.next_actions.filter((a) => !echoesTask(a, taskAnchor)), taskAnchor);
+    const confidence = Math.min(1, raw.confidence * 0.6 +
+        (goal ? 0.15 : 0) +
+        (modules.length ? 0.15 : 0) +
+        (next_actions.length ? 0.1 : 0));
+    return {
+        ...raw,
+        project_goal: goal.slice(0, 240),
+        current_stage: stage.slice(0, 120),
+        active_modules: modules,
+        recent_decisions: decisions,
+        open_problems: problems,
+        completed_milestones: milestones,
+        next_actions,
+        confidence: Math.round(confidence * 100) / 100,
+    };
+}
+function filterWeakInferenceLines(lines, taskAnchor) {
+    return dedupeStrings(lines.filter((l) => {
+        const t = l.trim();
+        if (t.length < 4) {
+            return false;
+        }
+        if (/^stated focus:/i.test(t)) {
+            return false;
+        }
+        return !echoesTask(t, taskAnchor);
+    }), 8);
+}

package/node_modules/@contora/state-core/dist/state-builder/rebuildFromScan.d.ts

@@ -0,0 +1,4 @@
+import type { AdapterKind, BootstrapStateJson, WorkspaceScanFacts } from '../types.js';
+/** Unified scan path — MCP / CLI / IDE fallback share one state-builder implementation. */
+export declare function rebuildArtifactsFromScan(workspaceRoot: string, scan: WorkspaceScanFacts, state?: BootstrapStateJson, writer?: AdapterKind): Promise<void>;
+//# sourceMappingURL=rebuildFromScan.d.ts.map

package/node_modules/@contora/state-core/dist/state-builder/rebuildFromScan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rebuildFromScan.d.ts","sourceRoot":"","sources":["../../src/state-builder/rebuildFromScan.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAMvF,2FAA2F;AAC3F,wBAAsB,wBAAwB,CAC5C,aAAa,EAAE,MAAM,EACrB,IAAI,EAAE,kBAAkB,EACxB,KAAK,CAAC,EAAE,kBAAkB,EAC1B,MAAM,GAAE,WAAmB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAaf"}

package/node_modules/@contora/state-core/dist/state-builder/rebuildFromScan.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.rebuildArtifactsFromScan = rebuildArtifactsFromScan;
+const buildUnderstanding_js_1 = require("../understanding/buildUnderstanding.js");
+const buildFromScan_js_1 = require("./buildFromScan.js");
+const snapshot_js_1 = require("./snapshot.js");
+const store_js_1 = require("./store.js");
+/** Unified scan path — MCP / CLI / IDE fallback share one state-builder implementation. */
+async function rebuildArtifactsFromScan(workspaceRoot, scan, state, writer = 'mcp') {
+    const built = (0, buildFromScan_js_1.buildProjectStateFromScan)(scan, state);
+    let md = (0, snapshot_js_1.formatProjectSnapshotMarkdown)(built);
+    if (writer === 'cli' || writer === 'mcp') {
+        md += `\n(generated by Contorium scan-driven bootstrap — ${writer} adapter; IDE events may refine this)\n`;
+    }
+    await (0, store_js_1.writeProjectBuiltState)(workspaceRoot, built, md);
+    await (0, buildUnderstanding_js_1.buildAndWriteUnderstandingArtifacts)({
+        workspaceRoot,
+        state,
+        built,
+        scan,
+    }).catch(() => undefined);
+}

package/node_modules/@contora/state-core/dist/state-builder/snapshot.d.ts

@@ -0,0 +1,5 @@
+import type { ProjectBuiltState } from './types.js';
+/** Human-readable PROJECT SNAPSHOT — shared by IDE, MCP, and CLI. */
+export declare function formatProjectSnapshotMarkdown(state: ProjectBuiltState): string;
+export declare function projectSnapshotBulletLines(state: ProjectBuiltState): string[];
+//# sourceMappingURL=snapshot.d.ts.map

package/node_modules/@contora/state-core/dist/state-builder/snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../src/state-builder/snapshot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAcpD,qEAAqE;AACrE,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,CAsB9E;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,iBAAiB,GAAG,MAAM,EAAE,CAe7E"}