opencontext-mcp 1.2.1 → 1.3.0

package/dist/init/index.js

@@ -0,0 +1,157 @@
+import { mkdir, readdir, unlink } from "node:fs/promises";
+import * as path from "node:path";
+import * as readline from "node:readline/promises";
+import { stdin, stdout } from "node:process";
+import { inspectTargetDir } from "./inspect.js";
+import { promptForConfirm } from "./prompts.js";
+import { atomicWrite, validateConfigFile } from "./files.js";
+import { printStep, printResult } from "./display.js";
+import { CONFIG_FILENAME, CONTEXT_DIR_NAME, CONFIG_CONTENT } from "./constants.js";
+import { upsertOpenCodeConfig, OPENCODE_CONFIG_FILENAME, } from "./integrations/opencode.js";
+import { upsertClaudeConfig, CLAUDE_MCP_FILENAME, } from "./integrations/claude.js";
+import { upsertWorkflowFile, AGENTS_FILENAME, CLAUDE_FILENAME, } from "./integrations/workflow-files.js";
+/**
+ * Runs the init command.
+ * Inspects the current directory, prompts for configuration, and generates files.
+ * Existing configs are extended, never overwritten.
+ */
+export async function runInit() {
+    const targetDir = path.resolve(".");
+    let opencode = true;
+    let claude = true;
+    // Step 1: Inspect
+    printStep("Inspecting directory", false);
+    const inspection = await inspectTargetDir(targetDir);
+    printStep("Inspecting directory");
+    // Show environment info
+    process.stderr.write(`\n  Node.js ${inspection.nodeVersion}`);
+    if (inspection.packageManager) {
+        process.stderr.write(` | ${inspection.packageManager}`);
+    }
+    process.stderr.write("\n\n");
+    // Step 2: Interactive selection
+    const rl = readline.createInterface({ input: stdin, output: stdout });
+    try {
+        if (inspection.isNonEmpty) {
+            const proceed = await promptForConfirm(rl, "  Directory is not empty. Continue anyway?");
+            if (!proceed) {
+                process.stderr.write("  Aborted.\n");
+                return;
+            }
+        }
+        opencode = await promptForConfirm(rl, "  Enable OpenCode integration?", true);
+        if (!opencode) {
+            printResult("skipped", "OpenCode integration skipped");
+        }
+        claude = await promptForConfirm(rl, "  Enable Claude Code integration?", true);
+        if (!claude) {
+            printResult("skipped", "Claude Code integration skipped");
+        }
+    }
+    finally {
+        rl.close();
+    }
+    // Step 3: Create directories + files
+    const createdFiles = [];
+    const createdDirs = [];
+    try {
+        // Ensure target directory exists
+        await mkdir(targetDir, { recursive: true });
+        // Create .opencontext/ directory
+        const contextDirPath = path.join(targetDir, CONTEXT_DIR_NAME);
+        await mkdir(contextDirPath, { recursive: true });
+        createdDirs.push(contextDirPath);
+        // Step 4: OpenContext config — create when missing, preserve otherwise
+        const configPath = path.join(targetDir, CONFIG_FILENAME);
+        if (!inspection.hasConfigFile) {
+            await atomicWrite(configPath, CONFIG_CONTENT);
+            createdFiles.push(CONFIG_FILENAME);
+            printResult("created", `${CONFIG_FILENAME} created.`);
+        }
+        else {
+            const valid = await validateConfigFile(configPath);
+            if (valid) {
+                printResult("unchanged", `${CONFIG_FILENAME} already exists and is valid — preserved.`);
+            }
+            else {
+                printResult("invalid", `${CONFIG_FILENAME} already exists but is malformed — left untouched.`);
+            }
+        }
+        // Step 5: AI client configs — always extended, never overwritten
+        if (opencode) {
+            const result = await upsertOpenCodeConfig(targetDir);
+            printResult(result.status, result.message);
+            if (result.status === "created") {
+                createdFiles.push(OPENCODE_CONFIG_FILENAME);
+            }
+        }
+        else {
+            printResult("skipped", "OpenCode config skipped.");
+        }
+        if (claude) {
+            const result = await upsertClaudeConfig(targetDir);
+            printResult(result.status, result.message);
+            if (result.status === "created") {
+                createdFiles.push(CLAUDE_MCP_FILENAME);
+            }
+        }
+        else {
+            printResult("skipped", "Claude Code config skipped.");
+        }
+        // Step 6: Workflow files — AGENTS.md for OpenCode, CLAUDE.md for Claude Code
+        if (opencode) {
+            const result = await upsertWorkflowFile(targetDir, AGENTS_FILENAME);
+            printResult(result.status, result.message);
+            if (result.status === "created") {
+                createdFiles.push(AGENTS_FILENAME);
+            }
+        }
+        if (claude) {
+            const result = await upsertWorkflowFile(targetDir, CLAUDE_FILENAME);
+            printResult(result.status, result.message);
+            if (result.status === "created") {
+                createdFiles.push(CLAUDE_FILENAME);
+            }
+        }
+        // Done
+        process.stderr.write("\n");
+        // Summary
+        process.stderr.write("  Created:\n");
+        for (const file of createdFiles) {
+            process.stderr.write(`    ${file}\n`);
+        }
+        for (const dir of createdDirs) {
+            process.stderr.write(`    ${CONTEXT_DIR_NAME}/\n`);
+        }
+        process.stderr.write("\n  Next steps:\n");
+        process.stderr.write(`    cd ${path.relative(process.cwd(), targetDir) || "."}\n`);
+        process.stderr.write("    Restart OpenCode / Claude Code to load the OpenContext MCP server.\n");
+    }
+    catch (error) {
+        // Rollback: remove created files and directories
+        process.stderr.write("\n  Generation failed. Cleaning up...\n");
+        for (const file of createdFiles) {
+            try {
+                await unlink(path.join(targetDir, file));
+            }
+            catch {
+                // Ignore cleanup errors
+            }
+        }
+        // Only remove context dir if we created it and it's empty
+        for (const dir of createdDirs) {
+            try {
+                const entries = await readdir(dir);
+                if (entries.length === 0) {
+                    const { rmdir } = await import("node:fs/promises");
+                    await rmdir(dir);
+                }
+            }
+            catch {
+                // Ignore cleanup errors
+            }
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/init/index.js.map

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

package/dist/init/inspect.d.ts

@@ -0,0 +1,21 @@
+/** Result of inspecting the target directory. */
+export interface InspectionResult {
+    /** Absolute path to the target directory. */
+    targetDir: string;
+    /** Whether .opencontext.json already exists. */
+    hasConfigFile: boolean;
+    /** Whether .opencontext/ directory already exists. */
+    hasContextDir: boolean;
+    /** Whether the directory is non-empty (excluding dotfiles). */
+    isNonEmpty: boolean;
+    /** Detected package manager, if any. */
+    packageManager: string | null;
+    /** Node.js version string. */
+    nodeVersion: string;
+}
+/**
+ * Inspects the target directory for existing configuration and environment.
+ * @param targetDir - Absolute path to inspect
+ * @returns InspectionResult with findings
+ */
+export declare function inspectTargetDir(targetDir: string): Promise<InspectionResult>;

package/dist/init/inspect.js

@@ -0,0 +1,57 @@
+import { readdir } from "node:fs/promises";
+import { CONFIG_FILENAME, CONTEXT_DIR_NAME } from "./constants.js";
+/**
+ * Inspects the target directory for existing configuration and environment.
+ * @param targetDir - Absolute path to inspect
+ * @returns InspectionResult with findings
+ */
+export async function inspectTargetDir(targetDir) {
+    let entries = [];
+    try {
+        entries = await readdir(targetDir);
+    }
+    catch (error) {
+        if (error.code === "ENOENT") {
+            // Directory doesn't exist — that's fine, we'll create it
+            return {
+                targetDir,
+                hasConfigFile: false,
+                hasContextDir: false,
+                isNonEmpty: false,
+                packageManager: null,
+                nodeVersion: process.version,
+            };
+        }
+        throw error;
+    }
+    const hasConfigFile = entries.includes(CONFIG_FILENAME);
+    const hasContextDir = entries.includes(CONTEXT_DIR_NAME);
+    // Filter out dotfiles and common non-user files for emptiness check
+    const userFiles = entries.filter((e) => !e.startsWith(".") && e !== "node_modules");
+    const isNonEmpty = userFiles.length > 0;
+    const packageManager = detectPackageManager(entries);
+    return {
+        targetDir,
+        hasConfigFile,
+        hasContextDir,
+        isNonEmpty,
+        packageManager,
+        nodeVersion: process.version,
+    };
+}
+function detectPackageManager(entries) {
+    if (entries.includes("pnpm-lock.yaml"))
+        return "pnpm";
+    if (entries.includes("yarn.lock"))
+        return "yarn";
+    if (entries.includes("package-lock.json"))
+        return "npm";
+    if (entries.includes("bun.lockb"))
+        return "bun";
+    if (entries.includes("Cargo.toml"))
+        return "cargo";
+    if (entries.includes("go.mod"))
+        return "go";
+    return null;
+}
+//# sourceMappingURL=inspect.js.map

package/dist/init/inspect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspect.js","sourceRoot":"","sources":["../../src/init/inspect.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAkBnE;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,SAAiB;IACtD,IAAI,OAAO,GAAa,EAAE,CAAC;IAC3B,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,OAAO,CAAC,SAAS,CAAC,CAAC;IACrC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACvD,yDAAyD;YACzD,OAAO;gBACL,SAAS;gBACT,aAAa,EAAE,KAAK;gBACpB,aAAa,EAAE,KAAK;gBACpB,UAAU,EAAE,KAAK;gBACjB,cAAc,EAAE,IAAI;gBACpB,WAAW,EAAE,OAAO,CAAC,OAAO;aAC7B,CAAC;QACJ,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;IAED,MAAM,aAAa,GAAG,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;IACxD,MAAM,aAAa,GAAG,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAC;IAEzD,oEAAoE;IACpE,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAC9B,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,cAAc,CAClD,CAAC;IACF,MAAM,UAAU,GAAG,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC;IAExC,MAAM,cAAc,GAAG,oBAAoB,CAAC,OAAO,CAAC,CAAC;IAErD,OAAO;QACL,SAAS;QACT,aAAa;QACb,aAAa;QACb,UAAU;QACV,cAAc;QACd,WAAW,EAAE,OAAO,CAAC,OAAO;KAC7B,CAAC;AACJ,CAAC;AAED,SAAS,oBAAoB,CAAC,OAAiB;IAC7C,IAAI,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC;QAAE,OAAO,MAAM,CAAC;IACtD,IAAI,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC;QAAE,OAAO,MAAM,CAAC;IACjD,IAAI,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC;QAAE,OAAO,KAAK,CAAC;IACxD,IAAI,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC;QAAE,OAAO,KAAK,CAAC;IAChD,IAAI,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC;QAAE,OAAO,OAAO,CAAC;IACnD,IAAI,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,IAAI,CAAC;IAC5C,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/init/integrations/claude.d.ts

@@ -0,0 +1,17 @@
+import type { ConfigWriteResult } from "../../shared/types.js";
+/** Filename for the Claude Code project MCP config. */
+export declare const CLAUDE_MCP_FILENAME = ".mcp.json";
+/** Shape of the Claude Code MCP server entry generated by init. */
+export interface ClaudeMcpEntry {
+    command: string;
+    args: string[];
+}
+/** Current Claude Code MCP server entry. */
+export declare function claudeMcpEntry(): ClaudeMcpEntry;
+/**
+ * Ensures the Claude Code config has a current OpenContext MCP server entry.
+ * Existing configs are extended, never overwritten: all other keys and MCP
+ * servers are preserved. An already-current entry is left untouched.
+ * @param targetDir - Project root directory
+ */
+export declare function upsertClaudeConfig(targetDir: string): Promise<ConfigWriteResult>;

package/dist/init/integrations/claude.js

@@ -0,0 +1,94 @@
+import { readFile, writeFile } from "node:fs/promises";
+import * as path from "node:path";
+import { OPENCONTEXT_MCP_PACKAGE } from "../../shared/constants.js";
+import { isNodeError } from "../../shared/errors.js";
+/** Filename for the Claude Code project MCP config. */
+export const CLAUDE_MCP_FILENAME = ".mcp.json";
+/** Current Claude Code MCP server entry. */
+export function claudeMcpEntry() {
+    return {
+        command: "npx",
+        args: ["-y", OPENCONTEXT_MCP_PACKAGE],
+    };
+}
+function isPlainObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/**
+ * Reads an existing JSON config file, distinguishing "missing" from
+ * "present but not parseable".
+ */
+async function readExistingJson(filePath) {
+    let raw;
+    try {
+        raw = await readFile(filePath, "utf8");
+    }
+    catch (error) {
+        if (isNodeError(error) && error.code === "ENOENT") {
+            return { exists: false, malformed: false };
+        }
+        throw error;
+    }
+    try {
+        return {
+            exists: true,
+            malformed: false,
+            parsed: JSON.parse(raw),
+        };
+    }
+    catch {
+        return { exists: true, malformed: true };
+    }
+}
+/** Whether an existing Claude MCP entry matches the current shape. */
+function isClaudeMcpCurrent(entry) {
+    if (!isPlainObject(entry)) {
+        return false;
+    }
+    const desired = claudeMcpEntry();
+    const current = entry;
+    const args = current.args;
+    return (current.command === desired.command &&
+        Array.isArray(args) &&
+        args.length === desired.args.length &&
+        args.every((part, i) => part === desired.args[i]));
+}
+/**
+ * Ensures the Claude Code config has a current OpenContext MCP server entry.
+ * Existing configs are extended, never overwritten: all other keys and MCP
+ * servers are preserved. An already-current entry is left untouched.
+ * @param targetDir - Project root directory
+ */
+export async function upsertClaudeConfig(targetDir) {
+    const filePath = path.join(targetDir, CLAUDE_MCP_FILENAME);
+    const existing = await readExistingJson(filePath);
+    if (existing.exists && existing.malformed) {
+        return {
+            status: "skipped",
+            message: `${CLAUDE_MCP_FILENAME} exists but is not valid JSON — left untouched.`,
+        };
+    }
+    const existingConfig = existing.parsed ?? {};
+    const existingServers = isPlainObject(existingConfig.mcpServers)
+        ? existingConfig.mcpServers
+        : {};
+    const current = existingServers.opencontext;
+    if (current !== undefined && isClaudeMcpCurrent(current)) {
+        return {
+            status: "unchanged",
+            message: `${CLAUDE_MCP_FILENAME} — OpenContext MCP server is up to date.`,
+        };
+    }
+    const merged = { ...existingConfig };
+    const servers = { ...existingServers };
+    servers.opencontext = claudeMcpEntry();
+    merged.mcpServers = servers;
+    await writeFile(filePath, `${JSON.stringify(merged, null, 2)}\n`, "utf8");
+    const status = existing.exists ? "updated" : "created";
+    const verb = existing.exists ? "updated" : "created";
+    return {
+        status,
+        message: `${CLAUDE_MCP_FILENAME} ${verb} — OpenContext MCP server configured.`,
+    };
+}
+//# sourceMappingURL=claude.js.map

package/dist/init/integrations/claude.js.map

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

package/dist/init/integrations/opencode.d.ts

@@ -0,0 +1,20 @@
+import type { ConfigWriteResult } from "../../shared/types.js";
+/** Filename for the OpenCode project config. */
+export declare const OPENCODE_CONFIG_FILENAME = "opencode.json";
+/** JSON schema used for generated OpenCode configs. */
+export declare const OPENCODE_CONFIG_SCHEMA = "https://opencode.ai/config.json";
+/** Shape of the OpenCode MCP server entry generated by init. */
+export interface OpenCodeMcpEntry {
+    type: "local";
+    command: string[];
+    enabled: boolean;
+}
+/** Current OpenCode MCP server entry. */
+export declare function openCodeMcpEntry(): OpenCodeMcpEntry;
+/**
+ * Ensures the OpenCode config has a current OpenContext MCP server entry.
+ * Existing configs are extended, never overwritten: all other keys and MCP
+ * servers are preserved. An already-current entry is left untouched.
+ * @param targetDir - Project root directory
+ */
+export declare function upsertOpenCodeConfig(targetDir: string): Promise<ConfigWriteResult>;

package/dist/init/integrations/opencode.js

@@ -0,0 +1,108 @@
+import { readFile, writeFile } from "node:fs/promises";
+import * as path from "node:path";
+import { OPENCONTEXT_MCP_PACKAGE } from "../../shared/constants.js";
+import { isNodeError } from "../../shared/errors.js";
+/** Filename for the OpenCode project config. */
+export const OPENCODE_CONFIG_FILENAME = "opencode.json";
+/** JSON schema used for generated OpenCode configs. */
+export const OPENCODE_CONFIG_SCHEMA = "https://opencode.ai/config.json";
+/** Current OpenCode MCP server entry. */
+export function openCodeMcpEntry() {
+    return {
+        type: "local",
+        command: ["npx", "-y", OPENCONTEXT_MCP_PACKAGE],
+        enabled: true,
+    };
+}
+function isPlainObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/**
+ * Reads an existing JSON config file, distinguishing "missing" from
+ * "present but not parseable".
+ */
+async function readExistingJson(filePath) {
+    let raw;
+    try {
+        raw = await readFile(filePath, "utf8");
+    }
+    catch (error) {
+        if (isNodeError(error) && error.code === "ENOENT") {
+            return { exists: false, malformed: false };
+        }
+        throw error;
+    }
+    try {
+        return {
+            exists: true,
+            malformed: false,
+            parsed: JSON.parse(raw),
+        };
+    }
+    catch {
+        return { exists: true, malformed: true };
+    }
+}
+/** Whether an existing OpenCode MCP entry matches the current shape. */
+function isOpenCodeMcpCurrent(entry) {
+    if (!isPlainObject(entry)) {
+        return false;
+    }
+    const desired = openCodeMcpEntry();
+    const current = entry;
+    const command = current.command;
+    return (current.type === desired.type &&
+        Array.isArray(command) &&
+        command.length === desired.command.length &&
+        command.every((part, i) => part === desired.command[i]) &&
+        current.enabled !== false);
+}
+/**
+ * Ensures the OpenCode config has a current OpenContext MCP server entry.
+ * Existing configs are extended, never overwritten: all other keys and MCP
+ * servers are preserved. An already-current entry is left untouched.
+ * @param targetDir - Project root directory
+ */
+export async function upsertOpenCodeConfig(targetDir) {
+    const filePath = path.join(targetDir, OPENCODE_CONFIG_FILENAME);
+    const existing = await readExistingJson(filePath);
+    if (existing.exists && existing.malformed) {
+        return {
+            status: "skipped",
+            message: `${OPENCODE_CONFIG_FILENAME} exists but is not valid JSON — left untouched.`,
+        };
+    }
+    const existingConfig = existing.parsed ?? {};
+    const existingMcp = isPlainObject(existingConfig.mcp) ? existingConfig.mcp : {};
+    const current = existingMcp.opencontext;
+    if (current !== undefined && isOpenCodeMcpCurrent(current)) {
+        return {
+            status: "unchanged",
+            message: `${OPENCODE_CONFIG_FILENAME} — OpenContext MCP server is up to date.`,
+        };
+    }
+    // Preserve existing $schema, otherwise add the current one.
+    const merged = {};
+    if (typeof existingConfig.$schema === "string") {
+        merged.$schema = existingConfig.$schema;
+    }
+    else {
+        merged.$schema = OPENCODE_CONFIG_SCHEMA;
+    }
+    for (const [key, value] of Object.entries(existingConfig)) {
+        if (key !== "$schema" && key !== "mcp") {
+            merged[key] = value;
+        }
+    }
+    const mcp = { ...existingMcp };
+    mcp.opencontext = openCodeMcpEntry();
+    merged.mcp = mcp;
+    await writeFile(filePath, `${JSON.stringify(merged, null, 2)}\n`, "utf8");
+    const status = existing.exists ? "updated" : "created";
+    const verb = existing.exists ? "updated" : "created";
+    return {
+        status,
+        message: `${OPENCODE_CONFIG_FILENAME} ${verb} — OpenContext MCP server configured.`,
+    };
+}
+//# sourceMappingURL=opencode.js.map

package/dist/init/integrations/opencode.js.map

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

package/dist/init/integrations/workflow-files.d.ts

@@ -0,0 +1,23 @@
+import type { ConfigStatus } from "../../shared/types.js";
+/** AGENTS.md — auto-read by OpenCode (and most agent tools). */
+export declare const AGENTS_FILENAME = "AGENTS.md";
+/** CLAUDE.md — auto-read by Claude Code. */
+export declare const CLAUDE_FILENAME = "CLAUDE.md";
+/** Marker delimiting the managed OpenContext section inside workflow files. */
+export declare const SECTION_START = "<!-- OPENCONTEXT:START -->";
+export declare const SECTION_END = "<!-- OPENCONTEXT:END -->";
+export interface WorkflowFileResult {
+    status: ConfigStatus;
+    message: string;
+}
+/** Returns the current OpenContext workflow section for AGENTS.md / CLAUDE.md. */
+export declare function workflowSection(): string;
+/**
+ * Ensures a workflow file (AGENTS.md / CLAUDE.md) carries the current
+ * OpenContext section. Existing files are extended, never overwritten: the
+ * section is inserted between the OPENCONTEXT markers when present, or
+ * appended otherwise. All other content is preserved.
+ * @param targetDir - Project root directory
+ * @param filename - Workflow file name (AGENTS.md or CLAUDE.md)
+ */
+export declare function upsertWorkflowFile(targetDir: string, filename: string): Promise<WorkflowFileResult>;

package/dist/init/integrations/workflow-files.js

@@ -0,0 +1,102 @@
+import { readFile, writeFile } from "node:fs/promises";
+import * as path from "node:path";
+import { isNodeError } from "../../shared/errors.js";
+/** AGENTS.md — auto-read by OpenCode (and most agent tools). */
+export const AGENTS_FILENAME = "AGENTS.md";
+/** CLAUDE.md — auto-read by Claude Code. */
+export const CLAUDE_FILENAME = "CLAUDE.md";
+/** Marker delimiting the managed OpenContext section inside workflow files. */
+export const SECTION_START = "<!-- OPENCONTEXT:START -->";
+export const SECTION_END = "<!-- OPENCONTEXT:END -->";
+/** Returns the current OpenContext workflow section for AGENTS.md / CLAUDE.md. */
+export function workflowSection() {
+    return `
+${SECTION_START}
+## CRITICAL MEMORY SYSTEM: OpenContext Protocol
+
+You have access to persistent project context via OpenContext MCP tools (\`.opencontext/\`). Adherence to this protocol is mandatory for consistency across sessions.
+
+### 1. Mandatory Pre-Flight: Inspect Context
+Before editing, refactoring, or generating code that affects:
+- Architecture, module boundaries, or dependency graph
+- Database schemas, migrations, or models
+- API contracts, route handlers, or DTOs
+- Authentication, authorization, or security rules
+
+**Action Required:** Execute \`read_context\` FIRST to check existing conventions, past design decisions, and project rules. Do NOT assume architectural patterns without reading relevant context topics.
+
+### 2. Post-Implementation: Persist Changes
+Immediately after introducing, altering, or deprecating conventions, run the corresponding OpenContext tool:
+
+* **Save/Update (\`save_context\`):**
+  - **When:** You add or change an architectural pattern, schema, shared utility rule, or tech stack decision.
+  - **Format:** Concise, topic-scoped Markdown summary.
+  - **Lifecycle Frontmatter:** When updating an existing convention, you MUST include YAML frontmatter:
+    \`\`\`yaml
+    ---
+    status: active | superseded | deprecated
+    supersedes: previous_topic_slug
+    ---
+    \`\`\`
+* **Deprecate vs. Delete (\`delete_context\`):**
+  - Use \`status: deprecated\` or \`status: superseded\` in YAML frontmatter if historical context is valuable.
+  - Call \`delete_context\` ONLY when a topic is fully obsolete or entirely removed from the codebase.
+
+### 3. Execution Rules
+- **Never skip:** Do not bypass \`read_context\` on multi-file or cross-cutting tasks to save tokens.
+- **Fail-safe:** If unsure whether an architectural decision exists, invoke \`read_context\` before taking action.
+${SECTION_END}
+  `;
+}
+/**
+ * Ensures a workflow file (AGENTS.md / CLAUDE.md) carries the current
+ * OpenContext section. Existing files are extended, never overwritten: the
+ * section is inserted between the OPENCONTEXT markers when present, or
+ * appended otherwise. All other content is preserved.
+ * @param targetDir - Project root directory
+ * @param filename - Workflow file name (AGENTS.md or CLAUDE.md)
+ */
+export async function upsertWorkflowFile(targetDir, filename) {
+    const filePath = path.join(targetDir, filename);
+    const section = workflowSection();
+    let existing;
+    try {
+        existing = await readFile(filePath, "utf8");
+    }
+    catch (error) {
+        if (isNodeError(error) && error.code === "ENOENT") {
+            await writeFile(filePath, `${section}\n`, "utf8");
+            return {
+                status: "created",
+                message: `${filename} created with the OpenContext workflow.`,
+            };
+        }
+        throw error;
+    }
+    const startIdx = existing.indexOf(SECTION_START);
+    const endIdx = existing.indexOf(SECTION_END);
+    if (startIdx !== -1 && endIdx !== -1 && endIdx > startIdx) {
+        // Replace the managed section with the current content.
+        const updated = `${existing.slice(0, startIdx)}${section}${existing.slice(endIdx + SECTION_END.length)}`;
+        if (updated === existing) {
+            return {
+                status: "unchanged",
+                message: `${filename} — OpenContext workflow is up to date.`,
+            };
+        }
+        await writeFile(filePath, updated, "utf8");
+        return {
+            status: "updated",
+            message: `${filename} — OpenContext workflow updated.`,
+        };
+    }
+    // No managed section yet — append it, preserving the existing content.
+    const trimmed = existing.replace(/\s*$/, "");
+    const updated = `${trimmed}\n\n${section}\n`;
+    await writeFile(filePath, updated, "utf8");
+    return {
+        status: "updated",
+        message: `${filename} — OpenContext workflow added.`,
+    };
+}
+//# sourceMappingURL=workflow-files.js.map

package/dist/init/integrations/workflow-files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-files.js","sourceRoot":"","sources":["../../../src/init/integrations/workflow-files.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAGrD,gEAAgE;AAChE,MAAM,CAAC,MAAM,eAAe,GAAG,WAAW,CAAC;AAE3C,4CAA4C;AAC5C,MAAM,CAAC,MAAM,eAAe,GAAG,WAAW,CAAC;AAE3C,+EAA+E;AAC/E,MAAM,CAAC,MAAM,aAAa,GAAG,4BAA4B,CAAC;AAC1D,MAAM,CAAC,MAAM,WAAW,GAAG,0BAA0B,CAAC;AAOtD,kFAAkF;AAClF,MAAM,UAAU,eAAe;IAC7B,OAAO;EACP,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkCb,WAAW;GACV,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,SAAiB,EACjB,QAAgB;IAEhB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAChD,MAAM,OAAO,GAAG,eAAe,EAAE,CAAC;IAElC,IAAI,QAAgB,CAAC;IACrB,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC9C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,WAAW,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAClD,MAAM,SAAS,CAAC,QAAQ,EAAE,GAAG,OAAO,IAAI,EAAE,MAAM,CAAC,CAAC;YAClD,OAAO;gBACL,MAAM,EAAE,SAAS;gBACjB,OAAO,EAAE,GAAG,QAAQ,yCAAyC;aAC9D,CAAC;QACJ,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;IAED,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IACjD,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAE7C,IAAI,QAAQ,KAAK,CAAC,CAAC,IAAI,MAAM,KAAK,CAAC,CAAC,IAAI,MAAM,GAAG,QAAQ,EAAE,CAAC;QAC1D,wDAAwD;QACxD,MAAM,OAAO,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,GAAG,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC;QACzG,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;YACzB,OAAO;gBACL,MAAM,EAAE,WAAW;gBACnB,OAAO,EAAE,GAAG,QAAQ,wCAAwC;aAC7D,CAAC;QACJ,CAAC;QACD,MAAM,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QAC3C,OAAO;YACL,MAAM,EAAE,SAAS;YACjB,OAAO,EAAE,GAAG,QAAQ,kCAAkC;SACvD,CAAC;IACJ,CAAC;IAED,uEAAuE;IACvE,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC7C,MAAM,OAAO,GAAG,GAAG,OAAO,OAAO,OAAO,IAAI,CAAC;IAC7C,MAAM,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IAC3C,OAAO;QACL,MAAM,EAAE,SAAS;QACjB,OAAO,EAAE,GAAG,QAAQ,gCAAgC;KACrD,CAAC;AACJ,CAAC"}

package/dist/init/prompts.d.ts

@@ -0,0 +1,9 @@
+import * as readline from "node:readline/promises";
+/**
+ * Prompts the user for a yes/no answer.
+ * @param rl - Readline interface
+ * @param message - Prompt message
+ * @param defaultYes - Default answer when the user presses Enter
+ * @returns true if user confirms
+ */
+export declare function promptForConfirm(rl: readline.Interface, message: string, defaultYes?: boolean): Promise<boolean>;