archctx 0.2.0 → 0.2.1

package/assets/catalog.yaml

@@ -1,7 +1,7 @@
 {
   "schemaVersion": "archcontext.practice-catalog-manifest/v1",
   "catalogVersion": "2026.06.0",
-  "productVersion": "0.2.0",
+  "productVersion": "0.2.1",
   "generatedAt": "1970-01-01T00:00:00.000Z",
   "entries": [
     {

package/bin/archctx.mjs

@@ -702,7 +702,7 @@ function productVersionManifest() {
     }
   };
 }
-var ARCHCONTEXT_PRODUCT_NAME = "archctx", ARCHCONTEXT_PRODUCT_VERSION = "0.2.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.2.1", 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();
@@ -14850,6 +14850,12 @@ function uniqueSorted4(values) {
 init_src();
 import { existsSync as existsSync8, readdirSync as readdirSync6, readFileSync as readFileSync8 } from "node:fs";
 import { basename as basename4, resolve as resolve11 } from "node:path";
+function nativeNodeSource(node) {
+  const value = node.source;
+  if (!value || typeof value !== "object" || Array.isArray(value))
+    return;
+  return value;
+}
 var ARCHITECTURE_DOCS_RENDERER_VERSION = "archcontext.docs-renderer/v1";
 var ARCHITECTURE_DOCS_GENERATED_BEGIN_PREFIX = "<!-- BEGIN ARCHCONTEXT:generated";
 var ARCHITECTURE_DOCS_GENERATED_END_PREFIX = "<!-- END ARCHCONTEXT:generated";
@@ -15078,23 +15084,10 @@ function mermaidId(id) {
 function readYamlObjects(dir) {
   if (!existsSync8(dir))
     return [];
-  return readdirSync6(dir).filter((file) => /\.ya?ml$/.test(file)).sort().map((file) => parseFlatYaml(readFileSync8(resolve11(dir, file), "utf8")));
-}
-function parseFlatYaml(body) {
-  const out = {};
-  for (const line of body.split(/\r?\n/)) {
-    const match = line.match(/^([A-Za-z0-9_-]+):\s*(.*)$/);
-    if (!match)
-      continue;
-    const [, key, raw] = match;
-    if (raw.startsWith('"') && raw.endsWith('"'))
-      out[key] = JSON.parse(raw);
-    else if (raw === "true" || raw === "false")
-      out[key] = raw === "true";
-    else
-      out[key] = raw;
-  }
-  return out;
+  return readdirSync6(dir).filter((file) => /\.ya?ml$/.test(file)).sort().map((file) => {
+    const path = resolve11(dir, file);
+    return parseJsonOrStableYaml(readFileSync8(path, "utf8"), path);
+  });
 }
 function escapeMermaid(value) {
   return value.replace(/"/g, "'");
@@ -15441,6 +15434,61 @@ function escapeDsl(value) {
 function escapeRegExp(value) {
   return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
+function resolveArchitectureOwnerForPath(nodes, path) {
+  const candidates = [];
+  for (const node of nodes) {
+    const source = nativeNodeSource(node);
+    const include = source?.include ?? [];
+    if (include.length === 0)
+      continue;
+    const excluded = (source?.exclude ?? []).some((pattern) => matchesGlob(path, pattern));
+    if (excluded)
+      continue;
+    const specificity = include.filter((pattern) => matchesGlob(path, pattern)).reduce((max, pattern) => Math.max(max, globLiteralPrefixLength(pattern)), -1);
+    if (specificity >= 0)
+      candidates.push({ node, specificity });
+  }
+  if (candidates.length === 0)
+    return { status: "no-match" };
+  const maxSpecificity = candidates.reduce((max, candidate) => Math.max(max, candidate.specificity), -1);
+  const winners = candidates.filter((candidate) => candidate.specificity === maxSpecificity).map((candidate) => candidate.node);
+  if (winners.length > 1)
+    return { status: "ambiguous", candidates: winners };
+  return { status: "matched", node: winners[0] };
+}
+function matchesGlob(path, pattern) {
+  return globToRegExp(pattern).test(path);
+}
+function globLiteralPrefixLength(pattern) {
+  const index = pattern.search(/[*?]/);
+  return index === -1 ? pattern.length : index;
+}
+function globToRegExp(pattern) {
+  let out = "";
+  let index = 0;
+  while (index < pattern.length) {
+    if (pattern.startsWith("**/", index)) {
+      out += "(?:.*/)?";
+      index += 3;
+      continue;
+    }
+    if (pattern.startsWith("**", index)) {
+      out += ".*";
+      index += 2;
+      continue;
+    }
+    const char = pattern[index];
+    if (char === "*") {
+      out += "[^/]*";
+    } else if (char === "?") {
+      out += "[^/]";
+    } else {
+      out += escapeRegExp(char);
+    }
+    index += 1;
+  }
+  return new RegExp(`^${out}$`);
+}
 
 // packages/local-runtime/explorer-html/src/index.ts
 var STATUS_STYLE = {
@@ -19494,6 +19542,22 @@ function createDefaultProjectionTargetManifest() {
         pathTemplate: "docs/architecture/diagrams/architecture.likec4",
         ownership: "generated",
         format: "likec4"
+      },
+      {
+        id: "projection_rule.agent-context.claude",
+        targetType: "agent-context",
+        scope: { kind: "entity", entityKind: "capability" },
+        pathTemplate: "{primarySourceDir}/CLAUDE.md",
+        ownership: "mixed",
+        format: "markdown"
+      },
+      {
+        id: "projection_rule.agent-context.agents",
+        targetType: "agent-context",
+        scope: { kind: "entity", entityKind: "capability" },
+        pathTemplate: "{primarySourceDir}/AGENTS.md",
+        ownership: "mixed",
+        format: "markdown"
       }
     ]
   };
@@ -28991,6 +29055,7 @@ function writeHtml2(response, statusCode, body) {
 }
 
 // packages/surfaces/mcp-local/src/index.ts
+var MCP_PROTOCOL_VERSION = "2025-03-26";
 var LOCAL_MCP_TOOLS = [
   {
     name: "archcontext_prepare_task",
@@ -29302,9 +29367,17 @@ async function runStdioMcpLoop(input, output, log = (line) => process.stderr.wri
   log("[archctx-mcp] started");
   for await (const line of input) {
     const message = JSON.parse(line);
+    if (message.id === undefined)
+      continue;
     let result;
-    if (message.method === "tools/list") {
+    if (message.method === "initialize") {
+      result = mcpInitializeResult(message.params?.protocolVersion);
+    } else if (message.method === "ping") {
+      result = {};
+    } else if (message.method === "tools/list") {
       result = { tools: server.listTools() };
+    } else if (message.method === "tools/call") {
+      result = await server.callTool(message.params?.name, message.params?.arguments ?? {});
     } else if (message.method === "resources/list") {
       result = { resources: await server.listResources(message.params?.root) };
     } else if (message.method === "resources/read") {
@@ -29314,11 +29387,28 @@ async function runStdioMcpLoop(input, output, log = (line) => process.stderr.wri
         contents: content === undefined ? [] : [{ uri, mimeType: "application/json", text: JSON.stringify(content) }]
       };
     } else {
-      result = await server.callTool(message.params?.name, message.params?.arguments ?? {});
+      result = {
+        content: errorEnvelope("mcp", "AC_SCHEMA_INVALID", `Unknown MCP method: ${message.method}`),
+        dataClassification: "local-metadata"
+      };
     }
     output(JSON.stringify({ jsonrpc: "2.0", id: message.id, result }));
   }
 }
+function mcpInitializeResult(clientProtocolVersion) {
+  const product = productVersionManifest().product;
+  return {
+    protocolVersion: typeof clientProtocolVersion === "string" ? clientProtocolVersion : MCP_PROTOCOL_VERSION,
+    capabilities: {
+      tools: { listChanged: false },
+      resources: { subscribe: false, listChanged: false }
+    },
+    serverInfo: {
+      name: product.name,
+      version: product.version
+    }
+  };
+}
 function isExternalDocumentationResourceUri(uri) {
   return /^archcontext:\/\/external-docs\/context7\/sha256:[0-9a-f]{64}$/.test(uri);
 }
@@ -29365,6 +29455,8 @@ if (__require.main == __require.module) {
 `);
     if (result.ok === false)
       process.exitCode = 1;
+    if (command === "resolve")
+      process.exitCode = resolveCommandExitCode(result);
   }
 }
 async function* stdinLines() {
@@ -29621,6 +29713,37 @@ async function runCliUnchecked(command2 = "help", args2 = [], cwd, deps = {}) {
             revocation: "archctx tunnel --revoke"
           }
         };
+      case "resolve": {
+        const path = readFlag(args2, "--path");
+        if (!path)
+          return errorEnvelope("resolve", "AC_SCHEMA_INVALID", "resolve requires --path");
+        if (!isRepoRelativePosixPath(path)) {
+          return errorEnvelope("resolve", "AC_SCHEMA_INVALID", "resolve --path must be a repository-relative POSIX path");
+        }
+        const model = loadNativeModelFromArchContext(cwd);
+        const outcome = resolveArchitectureOwnerForPath(model.nodes, path);
+        if (outcome.status === "matched") {
+          const node = outcome.node;
+          return okEnvelope("resolve", {
+            matched: true,
+            ambiguous: false,
+            stableId: node.id,
+            kind: node.kind,
+            name: node.name,
+            ...node.source ? { source: node.source } : {},
+            ...node.extensions ? { extensions: node.extensions } : {}
+          });
+        }
+        if (outcome.status === "ambiguous") {
+          return okEnvelope("resolve", {
+            matched: false,
+            ambiguous: true,
+            path,
+            candidates: outcome.candidates.map((node) => node.id)
+          });
+        }
+        return okEnvelope("resolve", { matched: false, ambiguous: false, path });
+      }
       case "help":
       default:
         return {
@@ -29628,8 +29751,8 @@ async function runCliUnchecked(command2 = "help", args2 = [], cwd, deps = {}) {
           ok: true,
           requestId: "help",
           data: {
-            commands: ["init", "sync", "validate", "context", "status", "daemon", "repo", "landscape", "ledger", "book", "recommendations", "explore", "prepare", "practices", "checkpoint", "hook", "hooks", "investigate", "agents", "jobs", "audit", "plan", "apply", "review", "complete", "github", "config", "mcp", "install", "uninstall", "doctor", "update", "paths", "privacy-audit", "export", "import", "tunnel"],
-            examples: ["archctx init --name MyApp", "archctx ledger migrate --from-yaml --dry-run", "archctx ledger promote --mode authoritative --preflight --rollback-plan", "archctx book recommendations --open --explain", "archctx recommendations accept --id recommendation.<id> --reason 'Accepted after local readback.'", "archctx recommendations metrics", "archctx practices validate --strict", "archctx practices list --json", "archctx practices waivers", "archctx practices waive --practice-id modularity.no-new-cycle --owner team-architecture --reason 'External migration window requires this edge until cutover.' --review-at 2026-07-10T00:00:00.000Z --expires-at 2026-07-24T00:00:00.000Z --evidence-digest sha256:<64-hex> --subject module.a->module.b", "archctx checkpoint --task-session-id task_cli", "archctx investigate --runner-port codex", "archctx agents status --status queued,running", "archctx agents budget", "archctx hook enqueue --event post-edit --path src/app.ts", "archctx jobs list --status queued", "archctx audit run --reason 'quarterly architecture audit'", "archctx audit run --no-wait", "archctx audit list --status pending", "archctx audit show audit_run.<id>", "archctx audit approve audit_run.<id>", "archctx audit approve audit_run.<id> --confirm-public-repo public:<owner/repo>:<baseSha>:<runId>", "archctx audit approve audit_run.<id> --resume", "archctx hooks install --host codex", "archctx paths", "archctx update --check", "archctx doctor --check-updates", "archctx github connect", "archctx github status", "archctx daemon start", "archctx explore start --foreground", "archctx export likec4", "archctx import structurizr --content '<json>'", "archctx tunnel"]
+            commands: ["init", "sync", "validate", "context", "status", "daemon", "repo", "landscape", "ledger", "book", "recommendations", "explore", "prepare", "practices", "checkpoint", "hook", "hooks", "investigate", "agents", "jobs", "audit", "plan", "apply", "review", "complete", "github", "config", "mcp", "install", "uninstall", "doctor", "update", "paths", "privacy-audit", "export", "import", "resolve", "tunnel"],
+            examples: ["archctx init --name MyApp", "archctx ledger migrate --from-yaml --dry-run", "archctx ledger promote --mode authoritative --preflight --rollback-plan", "archctx book recommendations --open --explain", "archctx recommendations accept --id recommendation.<id> --reason 'Accepted after local readback.'", "archctx recommendations metrics", "archctx practices validate --strict", "archctx practices list --json", "archctx practices waivers", "archctx practices waive --practice-id modularity.no-new-cycle --owner team-architecture --reason 'External migration window requires this edge until cutover.' --review-at 2026-07-10T00:00:00.000Z --expires-at 2026-07-24T00:00:00.000Z --evidence-digest sha256:<64-hex> --subject module.a->module.b", "archctx checkpoint --task-session-id task_cli", "archctx investigate --runner-port codex", "archctx agents status --status queued,running", "archctx agents budget", "archctx hook enqueue --event post-edit --path src/app.ts", "archctx jobs list --status queued", "archctx audit run --reason 'quarterly architecture audit'", "archctx audit run --no-wait", "archctx audit list --status pending", "archctx audit show audit_run.<id>", "archctx audit approve audit_run.<id>", "archctx audit approve audit_run.<id> --confirm-public-repo public:<owner/repo>:<baseSha>:<runId>", "archctx audit approve audit_run.<id> --resume", "archctx hooks install --host codex", "archctx paths", "archctx update --check", "archctx doctor --check-updates", "archctx github connect", "archctx github status", "archctx daemon start", "archctx explore start --foreground", "archctx export likec4", "archctx import structurizr --content '<json>'", "archctx resolve --path packages/core/projection-engine/src/index.ts", "archctx tunnel"]
           }
         };
     }
@@ -32164,6 +32287,16 @@ function renderResult(result, format) {
   return `OK ${result.requestId}
 ${JSON.stringify(result.data, null, 2)}`;
 }
+function resolveCommandExitCode(result) {
+  if (!result || result.ok !== true)
+    return 1;
+  const data = result.data;
+  if (data?.matched === true)
+    return 0;
+  if (data?.ambiguous === true)
+    return 2;
+  return 1;
+}
 function readFlag(args2, flag) {
   const index = args2.indexOf(flag);
   if (index === -1)
@@ -32193,5 +32326,6 @@ function readRepeatedFlag(args2, flag) {
 }
 export {
   runForegroundDaemon,
-  runCli
+  runCli,
+  resolveCommandExitCode
 };

package/package.json

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

package/schemas/runtime/projection-target.schema.json

@@ -10,7 +10,7 @@
     "targetId": { "type": "string", "pattern": "^projection_target\\.[a-zA-Z0-9_.-]+$" },
     "type": {
       "type": "string",
-      "enum": ["architecture-index", "entity-summary", "relation-summary", "decision-index", "architecture-changelog", "diagram-mermaid", "diagram-structurizr", "diagram-likec4"]
+      "enum": ["architecture-index", "entity-summary", "relation-summary", "decision-index", "architecture-changelog", "diagram-mermaid", "diagram-structurizr", "diagram-likec4", "agent-context"]
     },
     "scope": {
       "type": "object",