archctx 0.1.4-beta.0 → 0.1.4

package/assets/catalog.yaml

@@ -1,7 +1,7 @@
 {
   "schemaVersion": "archcontext.practice-catalog-manifest/v1",
   "catalogVersion": "2026.06.0",
-  "productVersion": "0.1.4-beta.0",
+  "productVersion": "0.1.4",
   "generatedAt": "1970-01-01T00:00:00.000Z",
   "entries": [
     {
@@ -389,5 +389,5 @@
     "structurizr.dsl",
     "twelve-factor"
   ],
-  "catalogDigest": "sha256:19c4fdf4068eaf19f782d92373354cff071947134e76eb6927998d5a9a1146c3"
+  "catalogDigest": "sha256:89829151a844ca84c522924c43d7b174ff613b0b50dbbb2c7174a20d9ac3ab47"
 }

package/bin/archctx.mjs

@@ -702,7 +702,7 @@ function productVersionManifest() {
     }
   };
 }
-var ARCHCONTEXT_PRODUCT_NAME = "archctx", ARCHCONTEXT_PRODUCT_VERSION = "0.1.4-beta.0", ARCHCONTEXT_PACKAGE_MANAGER = "bun@1.3.10", ARCHCONTEXT_NODE_RANGE = ">=24 <26", LOCAL_RUNTIME_RPC_SCHEMA_VERSION = "archcontext.runtime-rpc/v1", ARCHCONTEXT_SCHEMA_SET_VERSION = "2026-06-25.al0-ledger";
+var ARCHCONTEXT_PRODUCT_NAME = "archctx", ARCHCONTEXT_PRODUCT_VERSION = "0.1.4", ARCHCONTEXT_PACKAGE_MANAGER = "bun@1.3.10", ARCHCONTEXT_NODE_RANGE = ">=24 <26", LOCAL_RUNTIME_RPC_SCHEMA_VERSION = "archcontext.runtime-rpc/v1", ARCHCONTEXT_SCHEMA_SET_VERSION = "2026-06-25.al0-ledger";
 // packages/contracts/src/index.ts
 var init_src = __esm(() => {
   init_control_plane_routes();
@@ -25904,8 +25904,14 @@ var ARCHITECTURE_BOOK_RESOURCES = [
 class McpLocalServer {
   resources = new Map;
   runtimeInstance;
-  constructor(runtime) {
-    this.runtimeInstance = runtime;
+  runtimeResolver;
+  constructor(runtimeOrOptions) {
+    if (isMcpLocalServerOptions(runtimeOrOptions)) {
+      this.runtimeInstance = runtimeOrOptions.runtime;
+      this.runtimeResolver = runtimeOrOptions.runtimeResolver;
+    } else {
+      this.runtimeInstance = runtimeOrOptions;
+    }
   }
   listTools() {
     return LOCAL_MCP_TOOLS;
@@ -26027,7 +26033,7 @@ class McpLocalServer {
       }))
     ];
     try {
-      const status = await (await this.runtime(root)).docs(root, { command: "status", provider: "context7" });
+      const status = await (await this.runtime(root, { allowResolver: false })).docs(root, { command: "status", provider: "context7" });
       if (!status.ok)
         return localResources;
       const cacheEntries = status.data?.cacheEntries ?? [];
@@ -26090,7 +26096,7 @@ class McpLocalServer {
       dataClassification: "local-architecture"
     };
   }
-  async runtime(root = process.cwd()) {
+  async runtime(root = process.cwd(), options = { allowResolver: true }) {
     if (this.runtimeInstance)
       return this.runtimeInstance;
     const client = createRuntimeRpcClientFromConnectionFile2(root);
@@ -26103,9 +26109,16 @@ class McpLocalServer {
         return this.runtimeInstance;
       }
     }
+    if (options.allowResolver !== false && this.runtimeResolver) {
+      this.runtimeInstance = await this.runtimeResolver(root);
+      return this.runtimeInstance;
+    }
     throw new Error("archctxd RPC is unavailable; run `archctx daemon start` before using the local MCP surface");
   }
 }
+function isMcpLocalServerOptions(value) {
+  return Boolean(value && typeof value === "object" && (("runtime" in value) || ("runtimeResolver" in value)));
+}
 function requiredArg(args, key) {
   const value = args[key];
   if (typeof value !== "string" || value.length === 0)
@@ -26119,8 +26132,8 @@ function runtimeUnavailable(requestId, error) {
   };
 }
 async function runStdioMcpLoop(input, output, log = (line) => process.stderr.write(`${line}
-`)) {
-  const server = new McpLocalServer;
+`), options = {}) {
+  const server = new McpLocalServer(options);
   log("[archctx-mcp] started");
   for await (const line of input) {
     const message = JSON.parse(line);
@@ -26173,7 +26186,8 @@ class RuntimeVersionUnsupportedError extends Error {
 if (__require.main == __require.module) {
   if (command === "mcp" && args.length === 0) {
     await runStdioMcpLoop(stdinLines(), (line) => process.stdout.write(`${line}
-`));
+`), (line) => process.stderr.write(`${line}
+`), { runtimeResolver: (root) => createOrStartRuntimeRpcClient(root) });
   } else if (command === "daemon" && args[0] === "start" && args.includes("--foreground")) {
     await runForegroundDaemon(process.cwd(), args).catch((error) => {
       process.stderr.write(`${error instanceof Error ? error.message : String(error)}
@@ -28241,39 +28255,9 @@ async function createCliRuntime(cwd, deps) {
       return;
     } };
   if (!deps.disableRpcDiscovery && !hasEmbeddedRuntimeDeps(deps)) {
-    const fileIssue = runtimeRpcCompatibilityIssue(cwd);
-    if (fileIssue?.pidAlive)
-      throw new RuntimeVersionUnsupportedError(fileIssue);
-    const client = createRuntimeRpcClientFromConnectionFile(cwd);
-    if (client) {
-      const health = await client.health().catch(() => {
-        return;
-      });
-      const healthIssue = runtimeRpcCompatibilityIssueFromHealth(cwd, client, health);
-      if (healthIssue)
-        throw new RuntimeVersionUnsupportedError(healthIssue);
-      if (health?.ok === true)
-        return { client, close: async () => {
-          return;
-        } };
-      recoverStaleDaemonControlFiles(cwd, { removeUnhealthyConnection: true });
-    } else {
-      recoverStaleDaemonControlFiles(cwd);
-    }
-    const started = await startBackgroundDaemon([], cwd);
-    if (!started.ok)
-      throw new Error(started.error?.message ?? "archctxd did not start");
-    const startedClient = createRuntimeRpcClientFromConnectionFile(cwd);
-    if (startedClient) {
-      const health = await startedClient.health().catch(() => {
-        return;
-      });
-      if (health?.ok === true)
-        return { client: startedClient, close: async () => {
-          return;
-        } };
-    }
-    throw new Error("archctxd started but no healthy runtime RPC connection was available");
+    return { client: await createOrStartRuntimeRpcClient(cwd), close: async () => {
+      return;
+    } };
   }
   const {
     runtimeClient: _runtimeClient,
@@ -28294,6 +28278,40 @@ async function createCliRuntime(cwd, deps) {
   });
   return { client: daemon, close: () => daemon.stop() };
 }
+async function createOrStartRuntimeRpcClient(cwd) {
+  const fileIssue = runtimeRpcCompatibilityIssue(cwd);
+  if (fileIssue?.pidAlive)
+    throw new RuntimeVersionUnsupportedError(fileIssue);
+  const client = createRuntimeRpcClientFromConnectionFile(cwd);
+  if (client) {
+    const health = await client.health().catch(() => {
+      return;
+    });
+    const healthIssue = runtimeRpcCompatibilityIssueFromHealth(cwd, client, health);
+    if (healthIssue)
+      throw new RuntimeVersionUnsupportedError(healthIssue);
+    if (health?.ok === true)
+      return client;
+    recoverStaleDaemonControlFiles(cwd, { removeUnhealthyConnection: true });
+  } else {
+    recoverStaleDaemonControlFiles(cwd);
+  }
+  const started = await startBackgroundDaemon([], cwd);
+  if (!started.ok)
+    throw new Error(mcpDaemonStartRecoveryMessage(started.error?.message ?? "archctxd did not start"));
+  const startedClient = createRuntimeRpcClientFromConnectionFile(cwd);
+  if (startedClient) {
+    const health = await startedClient.health().catch(() => {
+      return;
+    });
+    if (health?.ok === true)
+      return startedClient;
+  }
+  throw new Error(mcpDaemonStartRecoveryMessage("archctxd started but no healthy runtime RPC connection was available"));
+}
+function mcpDaemonStartRecoveryMessage(message) {
+  return message.includes("archctx daemon") ? message : `${message}; run \`archctx daemon start\` before using the local MCP surface`;
+}
 function hasEmbeddedRuntimeDeps(deps) {
   return [
     "codeFacts",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "archctx",
-  "version": "0.1.4-beta.0",
+  "version": "0.1.4",
   "description": "Local architecture context CLI for agentic coding workflows.",
   "private": false,
   "type": "module",