opencontext-mcp 1.2.0 → 1.3.0

package/README.md

@@ -22,18 +22,36 @@ No vector databases, no cloud subscriptions, and no hidden state. Memory is plai
 
 ### Quickstart
 
-Run directly without installation via `npx`:
+Run the MCP server directly without installation via `npx`:
 
 ```bash
 npx -y opencontext-mcp
 
 ```
 
+### One-Command Setup
+
+Scaffold OpenContext in the current project interactively:
+
+```bash
+npx -y opencontext-mcp init
+```
+
+`init` walks you through the setup (enabling OpenCode and Claude Code integration) and generates everything you need:
+
+- `.opencontext/` — directory that holds your context topic files
+- `.opencontext.json` — configuration template
+- `opencode.json` — MCP server entry for OpenCode
+- `.mcp.json` — MCP server entry for Claude Code
+- `AGENTS.md` / `CLAUDE.md` — workflow reminders for your agents
+
+The `init` command takes no arguments: it always runs in the current directory, prompts interactively, and never overwrites an existing config.
+
 ### Client Setup
 
 #### OpenCode
 
-Add OpenContext to your project MCP configuration (`opencode.json`):
+Add OpenContext to your project MCP configuration (`opencode.json`) — or let `opencontext-mcp init` do it for you:
 
 ```json
 {
@@ -66,6 +84,22 @@ Add OpenContext to your MCP settings file (`claude_desktop_config.json` or Curso
 
 ---
 
+### Remote Access (HTTP)
+
+Expose the MCP server over the network with the Streamable HTTP transport. The endpoint URL is printed to stderr on startup.
+
+```bash
+# Plain HTTP on 127.0.0.1:3032 (default)
+opencontext-mcp --http
+
+# Custom port / bind to all interfaces
+opencontext-mcp server --http --port 8787 --host 0.0.0.0
+```
+
+The server listens at `http://<host>:<port>/mcp` (stateless Streamable HTTP — one request at a time, no sessions). `GET /` returns basic server info, handy for a browser health check.
+
+---
+
 ### Core Tools
 
 | Tool | Parameters | Description |
@@ -121,27 +155,19 @@ When a topic becomes obsolete, call `delete_context` to remove it. For deprecate
 
 ### Configuration
 
-Customize storage paths and security boundaries with an optional `.opencontext.jsonc` file in your repository root:
+Customize storage paths and security boundaries with an optional `.opencontext.json` file in your repository root (plain JSON — comments are not supported):
 
-```jsonc
+```json
 {
-  // Storage location (default: ".opencontext")
   "path": ".opencontext",
-
-  // Prevent agents from writing or updating files
   "readOnly": false,
-
-  // Auto-generate index.md with topic descriptions
   "autoIndex": true,
-
-  // Write guard & prompt injection defenses
   "guard": {
     "enabled": true,
     "maxFileSizeKb": 50,
     "strictPatternCheck": true
   }
 }
-
 ```
 
 ---

package/dist/cli/index.d.ts

@@ -0,0 +1,25 @@
+export interface ServerCliArgs {
+    command: "server";
+    transport: "stdio" | "http";
+    port: number;
+    host: string;
+}
+export type CliArgs = ServerCliArgs | {
+    command: "init";
+} | {
+    command: "help";
+} | {
+    command: "version";
+};
+export declare class CliError extends Error {
+    constructor(message: string);
+}
+/**
+ * Parses command-line arguments into a structured CliArgs object.
+ * @param argv - Raw process.argv (defaults to process.argv)
+ * @returns Parsed arguments
+ * @throws CliError on invalid arguments
+ */
+export declare function parseArgs(argv?: string[]): CliArgs;
+export declare function printHelp(): void;
+export declare function printVersion(): void;

package/dist/cli/index.js

@@ -0,0 +1,97 @@
+import { SERVER_VERSION, DEFAULT_HTTP_HOST, DEFAULT_HTTP_PORT, } from "../shared/constants.js";
+export class CliError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "CliError";
+    }
+}
+const USAGE = `Usage: opencontext-mcp [command] [options]
+
+Commands:
+  (default)        Start the MCP server (stdio transport)
+  server           Start the MCP server (alias of the default)
+  init             Initialize OpenContext in the current directory
+  --help, -h       Show this help message
+  --version, -v    Show version number
+
+Server options:
+  --http               Serve over HTTP using the Streamable HTTP transport
+  --port <port>        HTTP port (default: 3032)
+  --host <host>        Interface to bind (default: 127.0.0.1)
+
+Examples:
+  opencontext-mcp                       Start MCP server over stdio
+  opencontext-mcp --http                Serve over HTTP at http://127.0.0.1:3032/mcp
+  opencontext-mcp server --http --port 8787`;
+/**
+ * Parses command-line arguments into a structured CliArgs object.
+ * @param argv - Raw process.argv (defaults to process.argv)
+ * @returns Parsed arguments
+ * @throws CliError on invalid arguments
+ */
+export function parseArgs(argv = process.argv) {
+    const args = argv.slice(2);
+    if (args.length === 0) {
+        return { command: "server", transport: "stdio", port: DEFAULT_HTTP_PORT, host: DEFAULT_HTTP_HOST };
+    }
+    const first = args[0];
+    if (first === undefined) {
+        return { command: "server", transport: "stdio", port: DEFAULT_HTTP_PORT, host: DEFAULT_HTTP_HOST };
+    }
+    if (first === "--help" || first === "-h") {
+        return { command: "help" };
+    }
+    if (first === "--version" || first === "-v") {
+        return { command: "version" };
+    }
+    if (first === "init") {
+        return { command: "init" };
+    }
+    let index = first === "server" ? 1 : 0;
+    let transport = "stdio";
+    let port = DEFAULT_HTTP_PORT;
+    let host = DEFAULT_HTTP_HOST;
+    while (index < args.length) {
+        const arg = args[index];
+        if (arg === undefined) {
+            break;
+        }
+        switch (arg) {
+            case "--http":
+                transport = "http";
+                index += 1;
+                break;
+            case "--port": {
+                const value = args[index + 1];
+                if (value === undefined || !/^\d+$/.test(value)) {
+                    throw new CliError("--port requires a numeric value");
+                }
+                port = Number(value);
+                index += 2;
+                break;
+            }
+            case "--host": {
+                const value = args[index + 1];
+                if (value === undefined) {
+                    throw new CliError("--host requires a value");
+                }
+                host = value;
+                index += 2;
+                break;
+            }
+            default:
+                if (arg.startsWith("-")) {
+                    throw new CliError(`Unknown option: ${arg}\n\nRun "opencontext-mcp --help" for usage.`);
+                }
+                throw new CliError(`Unknown command: ${arg}\n\nRun "opencontext-mcp --help" for usage.`);
+        }
+    }
+    return { command: "server", transport, port, host };
+}
+export function printHelp() {
+    process.stdout.write(USAGE + "\n");
+}
+export function printVersion() {
+    process.stdout.write(SERVER_VERSION + "\n");
+}
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

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

package/dist/{config.d.ts → config/index.d.ts}

@@ -18,7 +18,7 @@ export interface OpenContextConfig {
 export type ResolvedConfig = Required<Omit<OpenContextConfig, "$schema">>;
 export declare const DEFAULT_CONFIG: ResolvedConfig;
 /**
- * Loads configuration from .opencontext.jsonc or .opencontext.json in the given directory.
+ * Loads configuration from .opencontext.json in the given directory.
  * Falls back to DEFAULT_CONFIG if no file exists or parsing fails.
  */
 export declare function loadConfig(cwd?: string): Promise<ResolvedConfig>;

package/dist/config/index.js

@@ -0,0 +1,62 @@
+import { readFile } from "node:fs/promises";
+import * as path from "node:path";
+export const DEFAULT_CONFIG = {
+    path: ".opencontext",
+    readOnly: false,
+    disabled: false,
+    autoIndex: true,
+    history: {
+        enabled: false,
+        maxBackupsPerTopic: 5,
+        retentionDays: 7,
+    },
+    guard: {
+        enabled: true,
+        maxFileSizeKb: 50,
+        strictPatternCheck: true,
+    },
+};
+const CONFIG_FILENAME = ".opencontext.json";
+/**
+ * Merges a partial config object into a full one, recursing into nested
+ * objects (e.g. history, guard) instead of replacing them wholesale.
+ */
+function deepMerge(target, source) {
+    const result = { ...target };
+    for (const key of Object.keys(source)) {
+        const sourceVal = source[key];
+        const targetVal = result[key];
+        if (sourceVal !== null &&
+            typeof sourceVal === "object" &&
+            !Array.isArray(sourceVal) &&
+            targetVal !== null &&
+            typeof targetVal === "object" &&
+            !Array.isArray(targetVal)) {
+            result[key] = deepMerge(targetVal, sourceVal);
+        }
+        else if (sourceVal !== undefined) {
+            result[key] = sourceVal;
+        }
+    }
+    return result;
+}
+/**
+ * Loads configuration from .opencontext.json in the given directory.
+ * Falls back to DEFAULT_CONFIG if no file exists or parsing fails.
+ */
+export async function loadConfig(cwd = process.cwd()) {
+    const filePath = path.join(cwd, CONFIG_FILENAME);
+    try {
+        const raw = await readFile(filePath, "utf8");
+        const parsed = JSON.parse(raw);
+        return deepMerge(DEFAULT_CONFIG, parsed);
+    }
+    catch (error) {
+        if (error.code === "ENOENT") {
+            return DEFAULT_CONFIG;
+        }
+        console.error(`OpenContext: failed to parse ${CONFIG_FILENAME}: ${error.message}`);
+        return DEFAULT_CONFIG;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAsBlC,MAAM,CAAC,MAAM,cAAc,GAAmB;IAC5C,IAAI,EAAE,cAAc;IACpB,QAAQ,EAAE,KAAK;IACf,QAAQ,EAAE,KAAK;IACf,SAAS,EAAE,IAAI;IACf,OAAO,EAAE;QACP,OAAO,EAAE,KAAK;QACd,kBAAkB,EAAE,CAAC;QACrB,aAAa,EAAE,CAAC;KACjB;IACD,KAAK,EAAE;QACL,OAAO,EAAE,IAAI;QACb,aAAa,EAAE,EAAE;QACjB,kBAAkB,EAAE,IAAI;KACzB;CACF,CAAC;AAEF,MAAM,eAAe,GAAG,mBAAmB,CAAC;AAE5C;;;GAGG;AACH,SAAS,SAAS,CAAoC,MAAS,EAAE,MAAkB;IACjF,MAAM,MAAM,GAAG,EAAE,GAAG,MAAM,EAAE,CAAC;IAC7B,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAmB,EAAE,CAAC;QACxD,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAC9B,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAC9B,IACE,SAAS,KAAK,IAAI;YAClB,OAAO,SAAS,KAAK,QAAQ;YAC7B,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC;YACzB,SAAS,KAAK,IAAI;YAClB,OAAO,SAAS,KAAK,QAAQ;YAC7B,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,EACzB,CAAC;YACA,MAAkC,CAAC,GAAa,CAAC,GAAG,SAAS,CAC5D,SAAoC,EACpC,SAAoC,CACrC,CAAC;QACJ,CAAC;aAAM,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;YACnC,MAAM,CAAC,GAAG,CAAC,GAAG,SAA0B,CAAC;QAC3C,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,MAAc,OAAO,CAAC,GAAG,EAAE;IAC1D,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC;IAEjD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC7C,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAsB,CAAC;QACpD,OAAO,SAAS,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;IAC3C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACvD,OAAO,cAAc,CAAC;QACxB,CAAC;QACD,OAAO,CAAC,KAAK,CAAC,gCAAgC,eAAe,KAAM,KAAe,CAAC,OAAO,EAAE,CAAC,CAAC;QAC9F,OAAO,cAAc,CAAC;IACxB,CAAC;AACH,CAAC"}

package/dist/index.js

@@ -1,16 +1,62 @@
 #!/usr/bin/env node
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { createOpenContextServer } from "./server.js";
-import { SERVER_NAME, getErrorMessage } from "./types.js";
+import { createOpenContextServer, startHttpServer } from "./server/index.js";
+import { SERVER_NAME, SERVER_VERSION } from "./shared/constants.js";
+import { getErrorMessage } from "./shared/errors.js";
+import { parseArgs, printHelp, printVersion, CliError } from "./cli/index.js";
+import { runInit } from "./init/index.js";
 /**
- * Main entry point for the OpenContext MCP server.
- * Creates server instance and connects to stdio transport.
+ * Main entry point for the OpenContext CLI.
+ * Routes to the appropriate command based on CLI arguments.
  */
 async function main() {
-    const server = await createOpenContextServer();
-    const transport = new StdioServerTransport();
-    await server.connect(transport);
+    let args;
+    try {
+        args = parseArgs();
+    }
+    catch (error) {
+        if (error instanceof CliError) {
+            process.stderr.write(`Error: ${error.message}\n`);
+            process.exit(1);
+        }
+        throw error;
+    }
+    switch (args.command) {
+        case "help":
+            printHelp();
+            return;
+        case "version":
+            printVersion();
+            return;
+        case "init":
+            await runInit();
+            return;
+        case "server":
+        default: {
+            if (args.transport === "http") {
+                const handle = await startHttpServer({
+                    host: args.host,
+                    port: args.port,
+                    buildServer: () => createOpenContextServer(),
+                });
+                process.stderr.write(`[opencontext] v${SERVER_VERSION} active. ${handle.url}\n`);
+                break;
+            }
+            const server = await createOpenContextServer();
+            const transport = new StdioServerTransport();
+            await server.connect(transport);
+            if (process.env.OPENCONTEXT_TELEMETRY_DISABLED !== "1" &&
+                process.env.DO_NOT_TRACK !== "1") {
+                process.stderr.write(`[opencontext] v${SERVER_VERSION} active. https://github.com/slxca/opencontext\n`);
+            }
+            break;
+        }
+    }
 }
+// Clean exit on SIGINT — no orphaned temp files
+process.on("SIGINT", () => {
+    process.exit(0);
+});
 main().catch((error) => {
     console.error(`Failed to start ${SERVER_NAME}: ${getErrorMessage(error)}`);
     process.exit(1);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE1D;;;GAGG;AACH,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,MAAM,uBAAuB,EAAE,CAAC;IAC/C,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AAClC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IAC9B,OAAO,CAAC,KAAK,CAAC,mBAAmB,WAAW,KAAK,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC3E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,uBAAuB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC7E,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC9E,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE1C;;;GAGG;AACH,KAAK,UAAU,IAAI;IACjB,IAAI,IAAI,CAAC;IACT,IAAI,CAAC;QACH,IAAI,GAAG,SAAS,EAAE,CAAC;IACrB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,QAAQ,EAAE,CAAC;YAC9B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,KAAK,CAAC,OAAO,IAAI,CAAC,CAAC;YAClD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;IAED,QAAQ,IAAI,CAAC,OAAO,EAAE,CAAC;QACrB,KAAK,MAAM;YACT,SAAS,EAAE,CAAC;YACZ,OAAO;QAET,KAAK,SAAS;YACZ,YAAY,EAAE,CAAC;YACf,OAAO;QAET,KAAK,MAAM;YACT,MAAM,OAAO,EAAE,CAAC;YAChB,OAAO;QAET,KAAK,QAAQ,CAAC;QACd,OAAO,CAAC,CAAC,CAAC;YACR,IAAI,IAAI,CAAC,SAAS,KAAK,MAAM,EAAE,CAAC;gBAC9B,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC;oBACnC,IAAI,EAAE,IAAI,CAAC,IAAI;oBACf,IAAI,EAAE,IAAI,CAAC,IAAI;oBACf,WAAW,EAAE,GAAG,EAAE,CAAC,uBAAuB,EAAE;iBAC7C,CAAC,CAAC;gBACH,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,kBAAkB,cAAc,YAAY,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC;gBACjF,MAAM;YACR,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,uBAAuB,EAAE,CAAC;YAC/C,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;YAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YAEhC,IACE,OAAO,CAAC,GAAG,CAAC,8BAA8B,KAAK,GAAG;gBAClD,OAAO,CAAC,GAAG,CAAC,YAAY,KAAK,GAAG,EAChC,CAAC;gBACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,kBAAkB,cAAc,iDAAiD,CAClF,CAAC;YACJ,CAAC;YACD,MAAM;QACR,CAAC;IACH,CAAC;AACH,CAAC;AAED,gDAAgD;AAChD,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;IACxB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IAC9B,OAAO,CAAC,KAAK,CAAC,mBAAmB,WAAW,KAAK,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC3E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/init/constants.d.ts

@@ -0,0 +1,6 @@
+/** Filename of the generated OpenContext config template. */
+export declare const CONFIG_FILENAME = ".opencontext.json";
+/** Directory that holds the context topic files. */
+export declare const CONTEXT_DIR_NAME = ".opencontext";
+/** Template written when no .opencontext.json exists yet. */
+export declare const CONFIG_CONTENT = "{\n  \"path\": \".opencontext\",\n  \"readOnly\": false,\n  \"autoIndex\": true,\n  \"guard\": {\n    \"enabled\": true,\n    \"maxFileSizeKb\": 50,\n    \"strictPatternCheck\": true\n  }\n}\n";

package/dist/init/constants.js

@@ -0,0 +1,17 @@
+/** Filename of the generated OpenContext config template. */
+export const CONFIG_FILENAME = ".opencontext.json";
+/** Directory that holds the context topic files. */
+export const CONTEXT_DIR_NAME = ".opencontext";
+/** Template written when no .opencontext.json exists yet. */
+export const CONFIG_CONTENT = `{
+  "path": ".opencontext",
+  "readOnly": false,
+  "autoIndex": true,
+  "guard": {
+    "enabled": true,
+    "maxFileSizeKb": 50,
+    "strictPatternCheck": true
+  }
+}
+`;
+//# sourceMappingURL=constants.js.map

package/dist/init/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/init/constants.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,MAAM,CAAC,MAAM,eAAe,GAAG,mBAAmB,CAAC;AAEnD,oDAAoD;AACpD,MAAM,CAAC,MAAM,gBAAgB,GAAG,cAAc,CAAC;AAE/C,6DAA6D;AAC7D,MAAM,CAAC,MAAM,cAAc,GAAG;;;;;;;;;;CAU7B,CAAC"}

package/dist/init/display.d.ts

@@ -0,0 +1,9 @@
+import type { ConfigStatus } from "../shared/types.js";
+/**
+ * Prints a step indicator to stderr.
+ * @param label - Step label
+ * @param done - Whether to show a checkmark (done) or spinner text
+ */
+export declare function printStep(label: string, done?: boolean): void;
+/** Prints a config/generation result line to stderr. */
+export declare function printResult(status: ConfigStatus | "invalid", message: string): void;

package/dist/init/display.js

@@ -0,0 +1,28 @@
+/**
+ * Prints a step indicator to stderr.
+ * @param label - Step label
+ * @param done - Whether to show a checkmark (done) or spinner text
+ */
+export function printStep(label, done = true) {
+    const icon = done ? "\x1b[32m✓\x1b[0m" : "\x1b[36m●\x1b[0m";
+    process.stderr.write(`  ${icon} ${label}\n`);
+}
+/** Maps a config result to a terminal status icon. */
+function statusIcon(status) {
+    switch (status) {
+        case "created":
+            return "\x1b[32m✓\x1b[0m";
+        case "updated":
+            return "\x1b[33m~ \x1b[0m";
+        case "unchanged":
+            return "\x1b[36m✓\x1b[0m";
+        case "skipped":
+            return "\x1b[90m-\x1b[0m";
+    }
+}
+/** Prints a config/generation result line to stderr. */
+export function printResult(status, message) {
+    const icon = status === "invalid" ? "\x1b[31m!\x1b[0m" : statusIcon(status);
+    process.stderr.write(`  ${icon} ${message}\n`);
+}
+//# sourceMappingURL=display.js.map

package/dist/init/display.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"display.js","sourceRoot":"","sources":["../../src/init/display.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,UAAU,SAAS,CAAC,KAAa,EAAE,IAAI,GAAG,IAAI;IAClD,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,kBAAkB,CAAC;IAC5D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,IAAI,IAAI,KAAK,IAAI,CAAC,CAAC;AAC/C,CAAC;AAED,sDAAsD;AACtD,SAAS,UAAU,CAAC,MAAoB;IACtC,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,SAAS;YACZ,OAAO,kBAAkB,CAAC;QAC5B,KAAK,SAAS;YACZ,OAAO,mBAAmB,CAAC;QAC7B,KAAK,WAAW;YACd,OAAO,kBAAkB,CAAC;QAC5B,KAAK,SAAS;YACZ,OAAO,kBAAkB,CAAC;IAC9B,CAAC;AACH,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,WAAW,CAAC,MAAgC,EAAE,OAAe;IAC3E,MAAM,IAAI,GAAG,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IAC5E,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,IAAI,IAAI,OAAO,IAAI,CAAC,CAAC;AACjD,CAAC"}

package/dist/init/files.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Writes a file atomically using a temp-then-rename pattern.
+ * @param filePath - Target file path
+ * @param content - File content
+ */
+export declare function atomicWrite(filePath: string, content: string): Promise<void>;
+/**
+ * Validates an existing .opencontext.json file.
+ * Leaves the file content untouched; only reports whether it parses.
+ * @returns true when the existing config is parseable JSON
+ */
+export declare function validateConfigFile(filePath: string): Promise<boolean>;

package/dist/init/files.js

@@ -0,0 +1,39 @@
+import { readFile, writeFile, unlink, rename } from "node:fs/promises";
+/**
+ * Writes a file atomically using a temp-then-rename pattern.
+ * @param filePath - Target file path
+ * @param content - File content
+ */
+export async function atomicWrite(filePath, content) {
+    const tmpPath = filePath + ".tmp";
+    try {
+        await writeFile(tmpPath, content, "utf8");
+        await rename(tmpPath, filePath);
+    }
+    catch (error) {
+        // Clean up temp file on failure
+        try {
+            await unlink(tmpPath);
+        }
+        catch {
+            // Ignore cleanup errors
+        }
+        throw error;
+    }
+}
+/**
+ * Validates an existing .opencontext.json file.
+ * Leaves the file content untouched; only reports whether it parses.
+ * @returns true when the existing config is parseable JSON
+ */
+export async function validateConfigFile(filePath) {
+    try {
+        const raw = await readFile(filePath, "utf8");
+        JSON.parse(raw);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=files.js.map

package/dist/init/files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.js","sourceRoot":"","sources":["../../src/init/files.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAEvE;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,QAAgB,EAAE,OAAe;IACjE,MAAM,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;IAClC,IAAI,CAAC;QACH,MAAM,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;QAC1C,MAAM,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAClC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,gCAAgC;QAChC,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,OAAO,CAAC,CAAC;QACxB,CAAC;QAAC,MAAM,CAAC;YACP,wBAAwB;QAC1B,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,QAAgB;IACvD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC7C,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAChB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/init/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Runs the init command.
+ * Inspects the current directory, prompts for configuration, and generates files.
+ * Existing configs are extended, never overwritten.
+ */
+export declare function runInit(): Promise<void>;