@contorium/mcp 0.8.1

package/node_modules/@contora/state-core/dist/understanding/chpHandoff.js

@@ -0,0 +1,214 @@
+"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.CHP_VERSION = void 0;
+exports.buildChpHandoffStateSync = buildChpHandoffStateSync;
+exports.buildChpHandoffState = buildChpHandoffState;
+exports.formatChpCompact = formatChpCompact;
+exports.formatChpMarkdown = formatChpMarkdown;
+exports.getProjectHandoff = getProjectHandoff;
+const path = __importStar(require("node:path"));
+const bootstrapState_js_1 = require("../bootstrap/bootstrapState.js");
+const formatHandoff_js_1 = require("./formatHandoff.js");
+const store_js_1 = require("./store.js");
+/** Contorium Handoff Protocol v1 — shared AI state shape. */
+exports.CHP_VERSION = 1;
+function projectName(workspaceRoot) {
+    return path.basename(path.resolve(workspaceRoot)) || 'project';
+}
+function isoTime(ms) {
+    return new Date(ms).toISOString();
+}
+function mapKeyChange(kc) {
+    const type = kc.kind === 'function'
+        ? 'function_update'
+        : kc.kind === 'class'
+            ? 'class_update'
+            : 'file_update';
+    const name = kc.kind === 'function' ? `${kc.symbol}()` : kc.symbol;
+    return { type, name, change_type: kc.change_type };
+}
+function lastChangeLabel(changes) {
+    if (!changes.length) {
+        return '—';
+    }
+    return changes[0].name;
+}
+function lastActionFromChanges(changes) {
+    if (!changes.length) {
+        return 'idle';
+    }
+    const first = changes[0];
+    switch (first.change_type) {
+        case 'added':
+            return `add_${first.type.replace('_update', '')}`;
+        case 'removed':
+            return `remove_${first.type.replace('_update', '')}`;
+        case 'modified':
+            return `modify_${first.type.replace('_update', '')}`;
+        default:
+            return first.type;
+    }
+}
+/** Build CHP v1 from in-memory runtime slices (sync — dashboard / IDE status bar). */
+function buildChpHandoffStateSync(input) {
+    const root = path.resolve(input.workspaceRoot);
+    const handoff = input.handoff ?? null;
+    const change = input.change ?? null;
+    const currentTask = input.currentTask?.trim() ||
+        handoff?.current_focus?.trim() ||
+        '';
+    const lastWriter = input.lastWriter ?? 'runtime';
+    const keyChanges = handoff?.key_changes?.length
+        ? handoff.key_changes
+        : change?.key_changes ?? [];
+    const recentChanges = keyChanges.slice(0, 8).map(mapKeyChange);
+    if (!handoff && !currentTask && !recentChanges.length) {
+        return null;
+    }
+    const generatedAt = handoff?.generatedAt ?? change?.generatedAt ?? Date.now();
+    return {
+        version: exports.CHP_VERSION,
+        project: projectName(root),
+        workspace_root: root,
+        current_task: currentTask || handoff?.current_focus?.trim() || '(not set)',
+        goal: handoff?.goal?.trim() || currentTask || '(not set)',
+        recent_changes: recentChanges,
+        agent_context: {
+            active_agent: String(lastWriter),
+            last_action: lastActionFromChanges(recentChanges),
+        },
+        summary: handoff?.summary?.trim() || 'No handoff summary yet.',
+        last_updated: isoTime(generatedAt),
+    };
+}
+/** Build CHP v1 state from runtime artifacts (single read model). */
+async function buildChpHandoffState(input) {
+    const root = path.resolve(input.workspaceRoot);
+    const [handoff, change, state] = await Promise.all([
+        input.handoff !== undefined ? Promise.resolve(input.handoff) : (0, store_js_1.readHandoffArtifact)(root),
+        input.change !== undefined ? Promise.resolve(input.change) : (0, store_js_1.readChangeArtifact)(root),
+        (0, bootstrapState_js_1.readStateJson)(root),
+    ]);
+    return buildChpHandoffStateSync({
+        workspaceRoot: root,
+        handoff,
+        change,
+        currentTask: input.currentTask?.trim() || state?.currentTask?.trim(),
+        lastWriter: input.lastWriter ?? state?.source?.lastWriter,
+    });
+}
+/** CHP compact one-liner for Passive CLI / IDE status bar. */
+function formatChpCompact(state, filter) {
+    const task = truncatePlain(state.current_task, 36);
+    const last = truncatePlain(lastChangeLabel(state.recent_changes), 28);
+    const agent = state.agent_context.active_agent;
+    const filterNote = filter?.trim() ? ` · filter:${filter.trim()}` : '';
+    return `[Contorium] task: ${task} | last: ${last} | agent: ${agent}${filterNote}`;
+}
+function truncatePlain(text, max) {
+    if (text.length <= max) {
+        return text;
+    }
+    return `${text.slice(0, Math.max(0, max - 1))}…`;
+}
+/** CHP markdown — AI chat injection (wraps V3.1 handoff block when available). */
+function formatChpMarkdown(chp, handoff, timeline) {
+    if (handoff) {
+        const base = (0, formatHandoff_js_1.formatHandoffMarkdown)(handoff, timeline);
+        const header = [
+            `# Project: ${chp.project}`,
+            `Current Task: ${chp.current_task}`,
+            `Agent: ${chp.agent_context.active_agent} · last action: ${chp.agent_context.last_action}`,
+            '',
+        ].join('\n');
+        return `${header}${base}`;
+    }
+    const lines = [
+        `# Project: ${chp.project}`,
+        '',
+        `Current Task: ${chp.current_task}`,
+        `Goal: ${chp.goal}`,
+        '',
+        'Recent Changes:',
+    ];
+    if (chp.recent_changes.length) {
+        for (const c of chp.recent_changes.slice(0, 8)) {
+            lines.push(`- ${c.name}${c.change_type ? ` (${c.change_type})` : ''}`);
+        }
+    }
+    else {
+        lines.push('- (none)');
+    }
+    lines.push('');
+    lines.push('Agent Context:');
+    lines.push(`- active: ${chp.agent_context.active_agent}`);
+    lines.push(`- last action: ${chp.agent_context.last_action}`);
+    lines.push('');
+    lines.push('Summary:');
+    lines.push(chp.summary);
+    lines.push('');
+    return lines.join('\n');
+}
+/** Unified get_handoff — read runtime artifacts and format. */
+async function getProjectHandoff(workspaceRoot, format = 'compact', filter) {
+    const root = path.resolve(workspaceRoot);
+    const [chp, handoff, timeline] = await Promise.all([
+        buildChpHandoffState({ workspaceRoot: root }),
+        (0, store_js_1.readHandoffArtifact)(root),
+        (0, store_js_1.readProjectTimeline)(root),
+    ]);
+    if (!chp) {
+        return { found: false };
+    }
+    const filtered = filter?.trim()
+        ? {
+            ...chp,
+            recent_changes: chp.recent_changes.filter((c) => c.name.toLowerCase().includes(filter.trim().toLowerCase())),
+        }
+        : chp;
+    switch (format) {
+        case 'json':
+            return { found: true, state: filtered, text: JSON.stringify(filtered, null, 2) };
+        case 'markdown':
+            return {
+                found: true,
+                state: filtered,
+                text: formatChpMarkdown(filtered, handoff, timeline),
+            };
+        default:
+            return { found: true, state: filtered, text: formatChpCompact(filtered, filter) };
+    }
+}

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

@@ -0,0 +1,21 @@
+export interface ExtractedSymbol {
+    kind: 'function' | 'class' | 'import';
+    name: string;
+    line: number;
+    importTarget?: string;
+}
+export interface FileExtraction {
+    file: string;
+    symbols: ExtractedSymbol[];
+    /** Direct call targets detected in this file (same-file or imported names). */
+    calls: string[];
+}
+export declare function isCodeFile(rel: string): boolean;
+declare function nodeId(file: string, kind: string, name: string): string;
+export { nodeId };
+export declare function extractFile(workspaceRoot: string, relFile: string): Promise<FileExtraction | undefined>;
+/** Parse in-memory source (IDE live edit / incremental path). */
+export declare function extractFromSource(relFile: string, text: string): FileExtraction | undefined;
+export declare function resolveRelativeImport(fromFile: string, importTarget: string): string | undefined;
+export declare function symbolNamesByKind(extraction: FileExtraction, kind: 'function' | 'class'): string[];
+//# sourceMappingURL=extractor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"extractor.d.ts","sourceRoot":"","sources":["../../src/understanding/extractor.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,UAAU,GAAG,OAAO,GAAG,QAAQ,CAAC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,+EAA+E;IAC/E,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAMD,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAG/C;AAED,iBAAS,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED,OAAO,EAAE,MAAM,EAAE,CAAC;AAgFlB,wBAAsB,WAAW,CAC/B,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAmBrC;AAED,iEAAiE;AACjE,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAS3F;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAgBhG;AAED,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,cAAc,EAC1B,IAAI,EAAE,UAAU,GAAG,OAAO,GACzB,MAAM,EAAE,CAEV"}

package/node_modules/@contora/state-core/dist/understanding/extractor.js

@@ -0,0 +1,173 @@
+"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.isCodeFile = isCodeFile;
+exports.nodeId = nodeId;
+exports.extractFile = extractFile;
+exports.extractFromSource = extractFromSource;
+exports.resolveRelativeImport = resolveRelativeImport;
+exports.symbolNamesByKind = symbolNamesByKind;
+const fs = __importStar(require("node:fs/promises"));
+const path = __importStar(require("node:path"));
+const CODE_EXT = new Set(['.ts', '.tsx', '.js', '.jsx', '.mjs', '.cjs', '.py']);
+const CALL_KEYWORDS = new Set([
+    'if', 'for', 'while', 'switch', 'catch', 'return', 'new', 'typeof', 'instanceof', 'function',
+    'class', 'import', 'export', 'await', 'async', 'throw', 'delete', 'void', 'super', 'this',
+]);
+function norm(rel) {
+    return rel.replace(/\\/g, '/');
+}
+function isCodeFile(rel) {
+    const ext = path.extname(rel).toLowerCase();
+    return CODE_EXT.has(ext);
+}
+function nodeId(file, kind, name) {
+    return `${norm(file)}::${kind}::${name}`;
+}
+function extractTsJs(lines) {
+    const symbols = [];
+    const calls = new Set();
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const ln = i + 1;
+        const fnMatch = line.match(/^\s*(?:export\s+)?(?:async\s+)?function\s+([A-Za-z_$][\w$]*)/) ??
+            line.match(/^\s*(?:export\s+)?const\s+([A-Za-z_$][\w$]*)\s*=\s*(?:async\s*)?\(/) ??
+            line.match(/^\s*(?:export\s+)?const\s+([A-Za-z_$][\w$]*)\s*=\s*(?:async\s+)?function\b/);
+        if (fnMatch?.[1]) {
+            symbols.push({ kind: 'function', name: fnMatch[1], line: ln });
+        }
+        const classMatch = line.match(/^\s*(?:export\s+)?class\s+([A-Za-z_$][\w$]*)/);
+        if (classMatch?.[1]) {
+            symbols.push({ kind: 'class', name: classMatch[1], line: ln });
+        }
+        const importFrom = line.match(/^\s*import\s+(?:[\w*{}\s,]+?\s+from\s+)?['"]([^'"]+)['"]/);
+        if (importFrom?.[1]) {
+            symbols.push({ kind: 'import', name: importFrom[1], line: ln, importTarget: importFrom[1] });
+        }
+        const importSide = line.match(/^\s*import\s+['"]([^'"]+)['"]/);
+        if (importSide?.[1] && !importFrom) {
+            symbols.push({ kind: 'import', name: importSide[1], line: ln, importTarget: importSide[1] });
+        }
+        for (const m of line.matchAll(/\b([A-Za-z_$][\w$]*)\s*\(/g)) {
+            const name = m[1];
+            if (!CALL_KEYWORDS.has(name)) {
+                calls.add(name);
+            }
+        }
+    }
+    return { symbols, calls: [...calls] };
+}
+function extractPython(lines) {
+    const symbols = [];
+    const calls = new Set();
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const ln = i + 1;
+        const defMatch = line.match(/^\s*(?:async\s+)?def\s+([A-Za-z_][\w]*)\s*\(/);
+        if (defMatch?.[1]) {
+            symbols.push({ kind: 'function', name: defMatch[1], line: ln });
+        }
+        const classMatch = line.match(/^\s*class\s+([A-Za-z_][\w]*)\s*[(:]/);
+        if (classMatch?.[1]) {
+            symbols.push({ kind: 'class', name: classMatch[1], line: ln });
+        }
+        const importMatch = line.match(/^\s*(?:from\s+(\S+)\s+import|import\s+(\S+))/);
+        if (importMatch) {
+            const target = (importMatch[1] ?? importMatch[2] ?? '').split(',')[0].trim();
+            if (target) {
+                symbols.push({ kind: 'import', name: target, line: ln, importTarget: target });
+            }
+        }
+        for (const m of line.matchAll(/\b([A-Za-z_][\w]*)\s*\(/g)) {
+            const name = m[1];
+            if (!CALL_KEYWORDS.has(name) && name !== 'def' && name !== 'class') {
+                calls.add(name);
+            }
+        }
+    }
+    return { symbols, calls: [...calls] };
+}
+async function extractFile(workspaceRoot, relFile) {
+    const normalized = norm(relFile);
+    if (!isCodeFile(normalized)) {
+        return undefined;
+    }
+    const abs = path.join(workspaceRoot, normalized);
+    let text;
+    try {
+        text = await fs.readFile(abs, 'utf8');
+    }
+    catch {
+        return undefined;
+    }
+    if (text.length > 512_000) {
+        return undefined;
+    }
+    const lines = text.split('\n');
+    const ext = path.extname(normalized).toLowerCase();
+    const parsed = ext === '.py' ? extractPython(lines) : extractTsJs(lines);
+    return { file: normalized, symbols: parsed.symbols, calls: parsed.calls };
+}
+/** Parse in-memory source (IDE live edit / incremental path). */
+function extractFromSource(relFile, text) {
+    const normalized = norm(relFile);
+    if (!isCodeFile(normalized) || text.length > 512_000) {
+        return undefined;
+    }
+    const lines = text.split('\n');
+    const ext = path.extname(normalized).toLowerCase();
+    const parsed = ext === '.py' ? extractPython(lines) : extractTsJs(lines);
+    return { file: normalized, symbols: parsed.symbols, calls: parsed.calls };
+}
+function resolveRelativeImport(fromFile, importTarget) {
+    if (!importTarget.startsWith('.')) {
+        return undefined;
+    }
+    const base = path.dirname(fromFile);
+    const joined = norm(path.join(base, importTarget));
+    const candidates = [
+        joined,
+        `${joined}.ts`,
+        `${joined}.tsx`,
+        `${joined}.js`,
+        `${joined}.jsx`,
+        `${joined}/index.ts`,
+        `${joined}/index.js`,
+    ];
+    return candidates[0];
+}
+function symbolNamesByKind(extraction, kind) {
+    return extraction.symbols.filter((s) => s.kind === kind).map((s) => s.name);
+}

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

@@ -0,0 +1,30 @@
+import type { HandoffArtifact, HandoffNextAction, ProjectTimeline } from './types.js';
+import type { ProjectBuiltState } from '../state-builder/types.js';
+import type { KnowledgeSnapshot } from './knowledgeGraph/types.js';
+/** Machine-stable graph ref: fn:name, cls:name, mod:path */
+export declare function normalizeGraphRef(ref: string): string;
+/** Plain next line for canonical export (no [action] tags). */
+export declare function formatNextActionPlain(a: HandoffNextAction): string;
+/** V3.1 execution block — single AI decision entry (no duplicate snapshot lists). */
+export declare function formatAiHandoffExecutionBlock(handoff: HandoffArtifact): string;
+export interface CanonicalAiExportInput {
+    taskAnchor: string;
+    built?: ProjectBuiltState | null;
+    snapshotMarkdown?: string;
+    activeFiles: string[];
+    recentGitActivity: string[];
+    handoff?: HandoffArtifact | null;
+    timeline?: ProjectTimeline;
+    instruction: string;
+    notes?: string;
+    /** Optional weak insights — omitted from canonical body when empty */
+    insights?: string[];
+    /** V3.1 cognitive snapshot — preferred over full graph refs */
+    knowledgeSnapshot?: KnowledgeSnapshot | null;
+}
+/**
+ * V3.1 canonical markdown for IDE one-click copy (AI Mode).
+ * Layered: snapshot → working context → change/impact/graph → execution handoff → instruction.
+ */
+export declare function formatCanonicalAiMarkdown(input: CanonicalAiExportInput): string;
+//# sourceMappingURL=formatCanonicalExport.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"formatCanonicalExport.d.ts","sourceRoot":"","sources":["../../src/understanding/formatCanonicalExport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AACtF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAoBnE,4DAA4D;AAC5D,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAqBrD;AAED,+DAA+D;AAC/D,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAalE;AA6KD,qFAAqF;AACrF,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM,CA8B9E;AAmCD,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACjC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,OAAO,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sEAAsE;IACtE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,+DAA+D;IAC/D,iBAAiB,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC;CAC9C;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,sBAAsB,GAAG,MAAM,CAqG/E"}