overlane 0.1.132 → 0.1.133

package/dist/overlane.mjs

@@ -20629,18 +20629,127 @@ var init_project_binding = __esm({
   }
 });
 
+// ../contracts/src/clients.ts
+var CLIENT_IDS, ClientId, CLIENT_LABELS, ClientSurface;
+var init_clients = __esm({
+  "../contracts/src/clients.ts"() {
+    "use strict";
+    init_zod();
+    CLIENT_IDS = ["claude", "codex", "grok", "cursor", "gemini"];
+    ClientId = external_exports.enum(CLIENT_IDS);
+    CLIENT_LABELS = {
+      claude: "Claude Code",
+      codex: "Codex",
+      grok: "Grok Build",
+      cursor: "Cursor",
+      gemini: "Gemini CLI"
+    };
+    ClientSurface = external_exports.enum(["cli", "ide", "cloud"]);
+  }
+});
+
+// ../contracts/src/code-map.ts
+function codeMapDefault(setting, results = GATE_07_LATEST) {
+  const result = results[setting];
+  if (result.verdict === "failed") return { setting, on: false, basis: "gate-07-failed", reason: `off: ${result.summary} (${result.evidence})`, gate07: "failed" };
+  if (result.verdict === "passed") return { setting, on: true, basis: "gate-07-passed", reason: `on: ${result.summary} (${result.evidence})`, gate07: "passed" };
+  const on = SPEC_DEFAULT[setting];
+  if (result.verdict === "pending") {
+    return { setting, on, basis: "spec-default-provisional", reason: `${on ? "on" : "off"} by the spec default, provisional: ${result.summary} (${result.evidence})`, gate07: "pending" };
+  }
+  return { setting, on, basis: "spec-default", reason: `${on ? "on" : "off"} by the spec default: ${result.summary}`, gate07: "not-applicable" };
+}
+var CODE_MAP_SETTINGS, CodeMapSetting, GATE_07_VERDICTS, Gate07Verdict, GATE_07_LATEST, SPEC_DEFAULT, CODE_MAP_BASES, CodeMapDefault, CODE_MAP_CHARS_PER_TOKEN, estimateCodeMapTokens, CODE_MAP_CONTEXT_SETTINGS, CodeMapContextSetting, CODE_MAP_INTENTS, CodeMapIntent, CODE_MAP_CONTEXT_MODES, CodeMapContextMode, CodeMapContextRow, CodeMapClientStatus, CodeMapStatus, codeMapPaths;
+var init_code_map = __esm({
+  "../contracts/src/code-map.ts"() {
+    "use strict";
+    init_zod();
+    init_clients();
+    init_common();
+    CODE_MAP_SETTINGS = ["local-agent-with-grep", "cloud-session", "bot", "review-service", "cross-repo", "wiki"];
+    CodeMapSetting = external_exports.enum(CODE_MAP_SETTINGS);
+    GATE_07_VERDICTS = ["passed", "failed", "pending", "not-applicable"];
+    Gate07Verdict = external_exports.enum(GATE_07_VERDICTS);
+    GATE_07_LATEST = {
+      "local-agent-with-grep": {
+        verdict: "failed",
+        summary: "GATE-07 failed with a local checkout and grep: cueline 115% and afltables 109% of the native-search token cost",
+        evidence: "ADR 0018, docs/findings/gate-07-preliminary.md, docs/findings/gate-07-realism-afltables.md"
+      },
+      "cloud-session": {
+        verdict: "pending",
+        summary: "re-run for agents without a checkout: the mechanical leg is recorded, the agent leg waits on a model",
+        evidence: "docs/findings/MS-A5-results.md (MS-A5.6)"
+      },
+      bot: {
+        verdict: "pending",
+        summary: "re-run for agents without a checkout: the mechanical leg is recorded, the agent leg waits on a model",
+        evidence: "docs/findings/MS-A5-results.md (MS-A5.6)"
+      },
+      "review-service": { verdict: "not-applicable", summary: "the review service has no grep to compare with; it uses the map as context", evidence: "ADR 0032 decision 3" },
+      "cross-repo": { verdict: "not-applicable", summary: "cross-repository questions have no single checkout to search", evidence: "ADR 0032 decision 2" },
+      wiki: { verdict: "not-applicable", summary: "the generated wiki is built from the map", evidence: "ADR 0032 decision 3" }
+    };
+    SPEC_DEFAULT = {
+      "local-agent-with-grep": false,
+      "cloud-session": true,
+      bot: true,
+      "review-service": true,
+      "cross-repo": true,
+      wiki: true
+    };
+    CODE_MAP_BASES = ["gate-07-failed", "gate-07-passed", "spec-default-provisional", "spec-default", "project-setting"];
+    CodeMapDefault = external_exports.object({ setting: CodeMapSetting, on: external_exports.boolean(), basis: external_exports.enum(CODE_MAP_BASES), reason: external_exports.string().min(1), gate07: Gate07Verdict }).strict();
+    CODE_MAP_CHARS_PER_TOKEN = 2.3;
+    estimateCodeMapTokens = (text) => Math.ceil(text.length * 10 / (CODE_MAP_CHARS_PER_TOKEN * 10));
+    CODE_MAP_CONTEXT_SETTINGS = ["default", "on", "off"];
+    CodeMapContextSetting = external_exports.enum(CODE_MAP_CONTEXT_SETTINGS);
+    CODE_MAP_INTENTS = ["read-only", "edit", "unknown"];
+    CodeMapIntent = external_exports.enum(CODE_MAP_INTENTS);
+    CODE_MAP_CONTEXT_MODES = ["on", "read-only", "off"];
+    CodeMapContextMode = external_exports.enum(CODE_MAP_CONTEXT_MODES);
+    CodeMapContextRow = external_exports.object({ mode: CodeMapContextMode, basis: external_exports.enum(["setting-default", "project-setting"]), reason: external_exports.string().min(1) }).strict();
+    CodeMapClientStatus = external_exports.object({
+      subject: external_exports.string().min(1),
+      client: external_exports.string().min(1),
+      setting: CodeMapSetting,
+      on: external_exports.boolean(),
+      basis: external_exports.enum(CODE_MAP_BASES),
+      reason: external_exports.string().min(1),
+      gate07: Gate07Verdict,
+      /** ADR 0055: the map as context at session start. Separate from `on`, which is about the code tools. */
+      context: CodeMapContextRow.optional()
+    }).strict();
+    CodeMapStatus = external_exports.object({
+      tenantId: TenantId,
+      projectId: ProjectId,
+      /** ADR 0018: the Worker serves code routes and the MCP code tool only when the project turns the code layer on. */
+      projectCodeLayer: external_exports.boolean(),
+      /** ADR 0055: the project's `codeMapContext` setting. Absent in answers from before it existed, which read as `default`. */
+      projectCodeMapContext: CodeMapContextSetting.optional(),
+      clients: external_exports.array(CodeMapClientStatus)
+    }).strict();
+    codeMapPaths = {
+      status: (tenantId, projectId) => `/v1/tenants/${encodeURIComponent(tenantId)}/projects/${encodeURIComponent(projectId)}/code-map/status`
+    };
+  }
+});
+
 // ../contracts/src/context-packet.ts
 var ProjectIdentity, Checkpoint, ActiveTask, WorkingCopyRevision, HardPolicy, SkillSummary, ContextPacket;
 var init_context_packet = __esm({
   "../contracts/src/context-packet.ts"() {
     "use strict";
     init_zod();
+    init_code_map();
     init_common();
     init_task_contract();
     ProjectIdentity = external_exports.object({
       projectId: ProjectId,
       releaseVersion: SemVer,
-      releaseDigest: Sha256Digest
+      releaseDigest: Sha256Digest,
+      /** ADR 0055: the project's `codeMapContext` setting, present only when it is not `default`. The agent never sees it (agentView leaves it out). */
+      codeMapContext: CodeMapContextSetting.optional()
     }).strict();
     Checkpoint = external_exports.object({
       taskId: TaskId,
@@ -20734,6 +20843,7 @@ var init_api2 = __esm({
   "../contracts/src/api.ts"() {
     "use strict";
     init_zod();
+    init_code_map();
     init_common();
     apiPaths = {
       projects: (tenantId) => `/v1/tenants/${encodeURIComponent(tenantId)}/projects`,
@@ -20779,10 +20889,12 @@ var init_api2 = __esm({
         connection: ProjectConnection.optional(),
         name: external_exports.string().min(1).max(100),
         /** ADR 0018: the hosted code layer is off unless a project turns it on. Missing means false. */
-        codeLayer: external_exports.boolean().optional()
+        codeLayer: external_exports.boolean().optional(),
+        /** ADR 0055: the code map as session-start context, separate from `codeLayer`. Missing means `default`. */
+        codeMapContext: CodeMapContextSetting.optional()
       }).strict().superRefine(checkProviderShape)
     );
-    UpdateProjectRequest = external_exports.object({ codeLayer: external_exports.boolean() }).strict();
+    UpdateProjectRequest = external_exports.object({ codeLayer: external_exports.boolean().optional(), codeMapContext: CodeMapContextSetting.optional() }).strict().refine((body2) => body2.codeLayer !== void 0 || body2.codeMapContext !== void 0, { message: "send codeLayer or codeMapContext" });
     ProjectRecord = withCompat(
       fillProvider,
       external_exports.object({
@@ -20798,7 +20910,9 @@ var init_api2 = __esm({
         releaseDigest: Sha256Digest,
         createdAt: Timestamp,
         /** ADR 0018: registers the MCP `code` tool and opens the code routes. Missing in older records means false. */
-        codeLayer: external_exports.boolean().default(false)
+        codeLayer: external_exports.boolean().default(false),
+        /** ADR 0055: `default` follows the per-client default; `on` and `off` override it. Missing in older records means `default`. */
+        codeMapContext: CodeMapContextSetting.optional()
       }).strict().superRefine(checkProviderShape)
     );
     WhoAmI = external_exports.object({
@@ -20954,25 +21068,6 @@ var init_code_index = __esm({
   }
 });
 
-// ../contracts/src/clients.ts
-var CLIENT_IDS, ClientId, CLIENT_LABELS, ClientSurface;
-var init_clients = __esm({
-  "../contracts/src/clients.ts"() {
-    "use strict";
-    init_zod();
-    CLIENT_IDS = ["claude", "codex", "grok", "cursor", "gemini"];
-    ClientId = external_exports.enum(CLIENT_IDS);
-    CLIENT_LABELS = {
-      claude: "Claude Code",
-      codex: "Codex",
-      grok: "Grok Build",
-      cursor: "Cursor",
-      gemini: "Gemini CLI"
-    };
-    ClientSurface = external_exports.enum(["cli", "ide", "cloud"]);
-  }
-});
-
 // ../contracts/src/release.ts
 async function releaseDigestOf(files) {
   const lines = [...files].sort((a, b) => a.path < b.path ? -1 : a.path > b.path ? 1 : 0).map((file2) => `${file2.path}\0${file2.digest}
@@ -23457,69 +23552,25 @@ var init_wording = __esm({
   }
 });
 
-// ../contracts/src/code-map.ts
-function codeMapDefault(setting, results = GATE_07_LATEST) {
-  const result = results[setting];
-  if (result.verdict === "failed") return { setting, on: false, basis: "gate-07-failed", reason: `off: ${result.summary} (${result.evidence})`, gate07: "failed" };
-  if (result.verdict === "passed") return { setting, on: true, basis: "gate-07-passed", reason: `on: ${result.summary} (${result.evidence})`, gate07: "passed" };
-  const on = SPEC_DEFAULT[setting];
-  if (result.verdict === "pending") {
-    return { setting, on, basis: "spec-default-provisional", reason: `${on ? "on" : "off"} by the spec default, provisional: ${result.summary} (${result.evidence})`, gate07: "pending" };
-  }
-  return { setting, on, basis: "spec-default", reason: `${on ? "on" : "off"} by the spec default: ${result.summary}`, gate07: "not-applicable" };
-}
-var CODE_MAP_SETTINGS, CodeMapSetting, GATE_07_VERDICTS, Gate07Verdict, GATE_07_LATEST, SPEC_DEFAULT, CODE_MAP_BASES, CodeMapDefault, CodeMapClientStatus, CodeMapStatus, codeMapPaths;
-var init_code_map = __esm({
-  "../contracts/src/code-map.ts"() {
+// ../contracts/src/code-map-context.ts
+var CodeMapDigest, CODE_MAP_DIGEST_PATH;
+var init_code_map_context = __esm({
+  "../contracts/src/code-map-context.ts"() {
     "use strict";
     init_zod();
-    init_clients();
+    init_code_map();
     init_common();
-    CODE_MAP_SETTINGS = ["local-agent-with-grep", "cloud-session", "bot", "review-service", "cross-repo", "wiki"];
-    CodeMapSetting = external_exports.enum(CODE_MAP_SETTINGS);
-    GATE_07_VERDICTS = ["passed", "failed", "pending", "not-applicable"];
-    Gate07Verdict = external_exports.enum(GATE_07_VERDICTS);
-    GATE_07_LATEST = {
-      "local-agent-with-grep": {
-        verdict: "failed",
-        summary: "GATE-07 failed with a local checkout and grep: cueline 115% and afltables 109% of the native-search token cost",
-        evidence: "ADR 0018, docs/findings/gate-07-preliminary.md, docs/findings/gate-07-realism-afltables.md"
-      },
-      "cloud-session": {
-        verdict: "pending",
-        summary: "re-run for agents without a checkout: the mechanical leg is recorded, the agent leg waits on a model",
-        evidence: "docs/findings/MS-A5-results.md (MS-A5.6)"
-      },
-      bot: {
-        verdict: "pending",
-        summary: "re-run for agents without a checkout: the mechanical leg is recorded, the agent leg waits on a model",
-        evidence: "docs/findings/MS-A5-results.md (MS-A5.6)"
-      },
-      "review-service": { verdict: "not-applicable", summary: "the review service has no grep to compare with; it uses the map as context", evidence: "ADR 0032 decision 3" },
-      "cross-repo": { verdict: "not-applicable", summary: "cross-repository questions have no single checkout to search", evidence: "ADR 0032 decision 2" },
-      wiki: { verdict: "not-applicable", summary: "the generated wiki is built from the map", evidence: "ADR 0032 decision 3" }
-    };
-    SPEC_DEFAULT = {
-      "local-agent-with-grep": false,
-      "cloud-session": true,
-      bot: true,
-      "review-service": true,
-      "cross-repo": true,
-      wiki: true
-    };
-    CODE_MAP_BASES = ["gate-07-failed", "gate-07-passed", "spec-default-provisional", "spec-default", "project-setting"];
-    CodeMapDefault = external_exports.object({ setting: CodeMapSetting, on: external_exports.boolean(), basis: external_exports.enum(CODE_MAP_BASES), reason: external_exports.string().min(1), gate07: Gate07Verdict }).strict();
-    CodeMapClientStatus = external_exports.object({ subject: external_exports.string().min(1), client: external_exports.string().min(1), setting: CodeMapSetting, on: external_exports.boolean(), basis: external_exports.enum(CODE_MAP_BASES), reason: external_exports.string().min(1), gate07: Gate07Verdict }).strict();
-    CodeMapStatus = external_exports.object({
-      tenantId: TenantId,
-      projectId: ProjectId,
-      /** ADR 0018: the Worker serves code routes and the MCP code tool only when the project turns the code layer on. */
-      projectCodeLayer: external_exports.boolean(),
-      clients: external_exports.array(CodeMapClientStatus)
+    CodeMapDigest = external_exports.object({
+      schemaVersion: external_exports.literal("1"),
+      revision: external_exports.object({ commitSha: CommitSha, branch: external_exports.string().min(1).optional() }).strict(),
+      builtAt: Timestamp,
+      coverage: external_exports.object({ files: external_exports.number().int().nonnegative(), symbols: external_exports.number().int().nonnegative(), uncovered: external_exports.number().int().nonnegative() }).strict(),
+      /** Ranked body lines, most useful first. Trimming drops lines from the end, never the middle of a line. */
+      lines: external_exports.array(external_exports.string()),
+      /** Qualified names of the symbols the ranking put first. */
+      seeds: external_exports.array(external_exports.string())
     }).strict();
-    codeMapPaths = {
-      status: (tenantId, projectId) => `/v1/tenants/${encodeURIComponent(tenantId)}/projects/${encodeURIComponent(projectId)}/code-map/status`
-    };
+    CODE_MAP_DIGEST_PATH = ".harness/code-map.json";
   }
 });
 
@@ -24546,8 +24597,8 @@ function parsePipelineConfig(text) {
         for (const key of issue2.keys) issues.push({ line: lineFor([...path, key]), message: `unknown key '${key}'` });
         continue;
       }
-      const where = path.length === 0 ? "" : `${path.map(String).join(".")}: `;
-      issues.push({ line: lineFor(path), message: `${where}${issue2.message}` });
+      const where2 = path.length === 0 ? "" : `${path.map(String).join(".")}: `;
+      issues.push({ line: lineFor(path), message: `${where2}${issue2.message}` });
     }
     return { ok: false, issues: dedupeIssues(issues) };
   }
@@ -25019,6 +25070,7 @@ var init_src = __esm({
     init_autonomy();
     init_wording();
     init_code_map();
+    init_code_map_context();
     init_agent();
     init_plans();
     init_billing();
@@ -32378,7 +32430,7 @@ var VERSION;
 var init_assets = __esm({
   "src/assets.ts"() {
     "use strict";
-    VERSION = true ? "0.1.132" : "0.0.0-dev";
+    VERSION = true ? "0.1.133" : "0.0.0-dev";
   }
 });
 
@@ -40516,14 +40568,407 @@ var init_oidc = __esm({
   }
 });
 
-// ../index-builder/src/run.ts
+// ../index-builder/src/context-map.ts
+function stripNoise(text) {
+  return text.replace(/\/\*[\s\S]*?\*\//g, " ").replace(/\/\/[^\n]*/g, " ").replace(/"(?:[^"\\\n]|\\.)*"|'(?:[^'\\\n]|\\.)*'|`(?:[^`\\]|\\.)*`/g, '""');
+}
+function wordsOf(text) {
+  const parts2 = text.replace(/([a-z0-9])([A-Z])/g, "$1 $2").replace(/([A-Z]+)([A-Z][a-z])/g, "$1 $2").split(/[^A-Za-z0-9]+/);
+  const out2 = [];
+  for (const part of parts2) {
+    let word = part.toLowerCase();
+    if (word.length < 3 || /^\d+$/.test(word) || STOP.has(word)) continue;
+    if (word.endsWith("ies") && word.length > 4) word = `${word.slice(0, -3)}y`;
+    else if (word.endsWith("s") && !word.endsWith("ss") && word.length > 3) word = word.slice(0, -1);
+    if (word.endsWith("ing") && word.length > 6) word = word.slice(0, -3);
+    else if (word.endsWith("ed") && word.length > 5) word = word.slice(0, -2);
+    out2.push(word);
+  }
+  return out2;
+}
+function resolveImport(from, spec) {
+  if (!spec.startsWith(".")) return null;
+  const parts2 = from.split("/").slice(0, -1);
+  for (const piece of spec.split("/")) {
+    if (piece === "." || piece === "") continue;
+    if (piece === "..") parts2.pop();
+    else parts2.push(piece);
+  }
+  return stripModuleExtension(parts2.join("/"));
+}
+function stripModuleExtension(path) {
+  return path.replace(/\.(?:[cm]?[jt]sx?|d\.ts)$/, "");
+}
+function reaches(visible, path) {
+  const bare = stripModuleExtension(path);
+  return visible.has(bare) || visible.has(path) || bare.endsWith("/index") && visible.has(bare.slice(0, -"/index".length));
+}
+function headerOf(content, symbol2) {
+  const lines = content.split("\n");
+  const start2 = symbol2.range[0];
+  const chunk = [];
+  for (let i2 = start2; i2 < Math.min(lines.length, start2 + 4); i2 += 1) {
+    const line2 = lines[i2] ?? "";
+    chunk.push(line2);
+    if (line2.includes("{")) break;
+  }
+  return chunk.join(" ");
+}
+async function buildRepoIndex(files) {
+  const symbols2 = /* @__PURE__ */ new Map();
+  const byName = /* @__PURE__ */ new Map();
+  const byFile = /* @__PURE__ */ new Map();
+  const imports = /* @__PURE__ */ new Map();
+  const ranges = /* @__PURE__ */ new Map();
+  const headers = /* @__PURE__ */ new Map();
+  const paths = [...files.keys()].filter((path) => languageForPath(path) !== null).sort();
+  for (const path of paths) {
+    const content = files.get(path);
+    const shard = await parseDeclarations(path, content);
+    if (shard === null) continue;
+    const targets = /* @__PURE__ */ new Set();
+    for (const match of content.matchAll(/from\s+["']([^"']+)["']/g)) {
+      const resolved = resolveImport(path, match[1] ?? "");
+      if (resolved !== null) targets.add(resolved);
+    }
+    imports.set(path, targets);
+    for (const symbol2 of shard.symbols) {
+      const hash2 = symbol2.symbol.indexOf("#");
+      const entry = { id: symbol2.symbol, name: symbol2.name, qualified: symbol2.symbol.slice(hash2 + 1), kind: symbol2.kind, path, line: symbol2.range[0] + 1, parent: symbol2.parent };
+      symbols2.set(entry.id, entry);
+      ranges.set(entry.id, symbol2);
+      byName.set(entry.name, [...byName.get(entry.name) ?? [], entry]);
+      byFile.set(path, [...byFile.get(path) ?? [], entry]);
+      if (symbol2.kind === "class" || symbol2.kind === "interface") headers.set(entry.id, headerOf(content, symbol2));
+    }
+  }
+  const callees = /* @__PURE__ */ new Map();
+  const callers = /* @__PURE__ */ new Map();
+  for (const entry of symbols2.values()) {
+    if (!CALLABLE.has(entry.kind)) continue;
+    const range = ranges.get(entry.id)?.enclosingRange;
+    if (range === void 0) continue;
+    const text = stripNoise(files.get(entry.path).split("\n").slice(range[0], range[2] + 1).join("\n"));
+    const visible = imports.get(entry.path) ?? /* @__PURE__ */ new Set();
+    const seen = /* @__PURE__ */ new Set();
+    for (const match of text.matchAll(/[A-Za-z_$][\w$]*/g)) {
+      const id2 = match[0];
+      if (KEYWORDS.has(id2) || seen.has(id2)) continue;
+      seen.add(id2);
+      for (const target of byName.get(id2) ?? []) {
+        if (target.id === entry.id || target.kind === "property" || target.kind === "parameter") continue;
+        if (target.path !== entry.path && !reaches(visible, target.path)) continue;
+        if (target.id === entry.parent) continue;
+        callees.set(entry.id, (callees.get(entry.id) ?? /* @__PURE__ */ new Set()).add(target.id));
+        callers.set(target.id, (callers.get(target.id) ?? /* @__PURE__ */ new Set()).add(entry.id));
+      }
+    }
+  }
+  const heritage = /* @__PURE__ */ new Map();
+  const heirs = /* @__PURE__ */ new Map();
+  const resolve16 = (from, name2) => {
+    const visible = imports.get(from.path) ?? /* @__PURE__ */ new Set();
+    return (byName.get(baseName(name2)) ?? []).find((candidate) => candidate.path === from.path || reaches(visible, candidate.path));
+  };
+  for (const [id2, header] of headers) {
+    const entry = symbols2.get(id2);
+    const stem2 = header.slice(header.indexOf(entry.name) + entry.name.length).replace(/^<[^>]*>/, "").replace(/\{.*$/, "");
+    const ext = /\bextends\s+([A-Za-z_$][\w$.]*)/.exec(stem2)?.[1];
+    const impl = /\bimplements\s+(.+)$/.exec(stem2)?.[1];
+    const extendsIds = ext === void 0 ? [] : [resolve16(entry, ext)?.id].filter((value) => value !== void 0);
+    const implementsIds = (impl === void 0 ? [] : impl.split(/,(?![^<]*>)/).map((part) => resolve16(entry, part.trim()))).filter((value) => value !== void 0).map((value) => value.id);
+    if (extendsIds.length === 0 && implementsIds.length === 0) continue;
+    heritage.set(id2, { extends: extendsIds, implements: implementsIds });
+    for (const target of extendsIds) heirs.set(target, { extendedBy: [...heirs.get(target)?.extendedBy ?? [], id2], implementedBy: heirs.get(target)?.implementedBy ?? [] });
+    for (const target of implementsIds) heirs.set(target, { extendedBy: heirs.get(target)?.extendedBy ?? [], implementedBy: [...heirs.get(target)?.implementedBy ?? [], id2] });
+  }
+  const words = /* @__PURE__ */ new Map();
+  for (const entry of symbols2.values()) for (const word of new Set(wordsOf(entry.name))) words.set(word, (words.get(word) ?? 0) + 1);
+  return { files: paths.length, symbols: symbols2, byName, byFile, callees, callers, heritage, heirs, imports, words, wordDocs: symbols2.size };
+}
+function idf(index, word) {
+  return Math.log(index.wordDocs / (1 + (index.words.get(word) ?? 0)));
+}
+function scoreSymbols(index, task) {
+  const exactNames = /* @__PURE__ */ new Set();
+  for (const match of task.matchAll(/[A-Za-z_$][\w$]*(?:\.[A-Za-z_$][\w$]*)*/g)) {
+    const token = match[0];
+    if (token.length >= 4 && index.byName.has(token)) exactNames.add(token);
+    if (token.includes(".")) exactNames.add(token);
+  }
+  const taskWords = new Set(wordsOf(task));
+  const scored = [];
+  for (const symbol2 of index.symbols.values()) {
+    if (!SEEDABLE.has(symbol2.kind)) continue;
+    if (symbol2.kind === "constant" && !/^[A-Z][A-Z0-9_]+$/.test(symbol2.name)) continue;
+    let score = 0;
+    let exact = false;
+    if (exactNames.has(symbol2.qualified)) {
+      score = 200;
+      exact = true;
+    } else if (exactNames.has(symbol2.name) && !symbol2.qualified.includes(".")) {
+      score = 150;
+      exact = true;
+    } else if (exactNames.has(symbol2.name)) {
+      score = 100;
+      exact = true;
+    } else {
+      const own2 = new Set(wordsOf(symbol2.name));
+      const fileWords = new Set(wordsOf(symbol2.path.split("/").pop()?.replace(/\.ts$/, "") ?? ""));
+      let hits = 0;
+      for (const word of own2) if (taskWords.has(word) && idf(index, word) >= MIN_WORD_IDF) {
+        score += idf(index, word);
+        hits += 1;
+      }
+      for (const word of fileWords) if (!own2.has(word) && taskWords.has(word) && idf(index, word) >= MIN_WORD_IDF) score += idf(index, word) * 0.4;
+      if (hits === 0) score = 0;
+      else score /= 1 + 0.15 * own2.size;
+      if (score < MIN_SOFT_SCORE) score = 0;
+    }
+    if (score > 0) scored.push({ symbol: symbol2, score, exact });
+  }
+  return scored.sort((a, b) => b.score - a.score || a.symbol.path.localeCompare(b.symbol.path) || a.symbol.line - b.symbol.line);
+}
+function pageRank(index, personal) {
+  const neighbours = /* @__PURE__ */ new Map();
+  const link = (a, b, weight) => {
+    if (a === b) return;
+    neighbours.set(a, (neighbours.get(a) ?? /* @__PURE__ */ new Map()).set(b, (neighbours.get(a)?.get(b) ?? 0) + weight));
+    neighbours.set(b, (neighbours.get(b) ?? /* @__PURE__ */ new Map()).set(a, (neighbours.get(b)?.get(a) ?? 0) + weight));
+  };
+  for (const [from, targets] of index.callees) {
+    const a = index.symbols.get(from)?.path;
+    if (a === void 0) continue;
+    for (const target of targets) {
+      const b = index.symbols.get(target)?.path;
+      if (b !== void 0) link(a, b, 1);
+    }
+  }
+  let total = 0;
+  for (const value of personal.values()) total += value;
+  const damping = 0.5;
+  let rank = /* @__PURE__ */ new Map();
+  for (const [path, value] of personal) rank.set(path, total === 0 ? 0 : value / total);
+  for (let step2 = 0; step2 < 15; step2 += 1) {
+    const next = /* @__PURE__ */ new Map();
+    for (const [path, value] of personal) next.set(path, (1 - damping) * (total === 0 ? 0 : value / total));
+    for (const [path, mass] of rank) {
+      const out2 = neighbours.get(path);
+      if (out2 === void 0 || mass === 0) continue;
+      let sum = 0;
+      for (const weight of out2.values()) sum += weight;
+      for (const [other, weight] of out2) next.set(other, (next.get(other) ?? 0) + damping * mass * (weight / sum));
+    }
+    rank = next;
+  }
+  return rank;
+}
+function callerLines(index, seed) {
+  const lines = [];
+  const seen = /* @__PURE__ */ new Set([seed.id]);
+  let frontier = [seed.id];
+  for (let depth = 1; depth <= 3 && frontier.length > 0 && lines.length < 12; depth += 1) {
+    const next = [];
+    for (const id2 of frontier) {
+      const target = index.symbols.get(id2);
+      const callers = [...index.callers.get(id2) ?? []].filter((caller) => !seen.has(caller)).map((caller) => index.symbols.get(caller)).sort((a, b) => a.path.localeCompare(b.path) || a.line - b.line);
+      for (const caller of callers.slice(0, 8)) {
+        seen.add(caller.id);
+        next.push(caller.id);
+        if (lines.length < 12) lines.push(`${"  ".repeat(depth)}${caller.qualified} ${caller.path}:${caller.line}  -> ${target.qualified}`);
+      }
+      if (callers.length > 8) lines.push(`${"  ".repeat(depth)}(+${callers.length - 8} more callers of ${target.qualified})`);
+    }
+    frontier = next;
+  }
+  return lines;
+}
+function seedBlock(index, seed) {
+  const out2 = [`${seed.kind} ${where(seed)}`];
+  const heirs = index.heirs.get(seed.id);
+  const heritage = index.heritage.get(seed.id);
+  const list = (ids, limit) => {
+    const shown2 = ids.slice(0, limit).map((id2) => index.symbols.get(id2)).filter((value) => value !== void 0).sort((a, b) => a.path.localeCompare(b.path));
+    return `${shown2.map((entry) => `${entry.name} ${entry.path}:${entry.line}`).join("; ")}${ids.length > limit ? `; (+${ids.length - limit} more, ${ids.length} total)` : ""}`;
+  };
+  if (heritage !== void 0) {
+    if (heritage.extends.length > 0) out2.push(`  extends: ${list(heritage.extends, 4)}`);
+    if (heritage.implements.length > 0) out2.push(`  implements: ${list(heritage.implements, 4)}`);
+  }
+  if (heirs !== void 0) {
+    if (heirs.implementedBy.length > 0) out2.push(`  implemented by: ${list(heirs.implementedBy, 12)}`);
+    if (heirs.extendedBy.length > 0) out2.push(`  extended by: ${list(heirs.extendedBy, 6)}`);
+  }
+  const calls = [...index.callees.get(seed.id) ?? []].map((id2) => index.symbols.get(id2)).sort((a, b) => a.path.localeCompare(b.path) || a.line - b.line);
+  if (calls.length > 0) out2.push(`  calls: ${calls.slice(0, 8).map((entry) => `${entry.qualified} ${entry.path}:${entry.line}`).join("; ")}${calls.length > 8 ? `; (+${calls.length - 8} more)` : ""}`);
+  const up = callerLines(index, seed);
+  if (up.length > 0) out2.push("  called by (up to 3 levels):", ...up);
+  return out2;
+}
+function outline(index, path) {
+  const entries = (index.byFile.get(path) ?? []).filter((symbol2) => symbol2.kind !== "property" && symbol2.kind !== "parameter");
+  const tops = entries.filter((symbol2) => symbol2.parent === void 0);
+  const parts2 = tops.slice(0, 8).map((symbol2) => {
+    const members2 = entries.filter((member) => member.parent === symbol2.id).map((member) => member.name);
+    return members2.length > 0 ? `${symbol2.name}{${members2.slice(0, 8).join(",")}}` : symbol2.name;
+  });
+  return `${path}: ${parts2.join(" ")}`;
+}
+function layout(index) {
+  const domains = /* @__PURE__ */ new Map();
+  for (const path of index.imports.keys()) {
+    const parts2 = path.split("/");
+    const key = parts2.length > 2 ? `${parts2[0]}/${parts2[1]}` : parts2[0] ?? path;
+    domains.set(key, (domains.get(key) ?? 0) + 1);
+  }
+  return [`Layout: ${index.files} source files. ${[...domains].sort().map(([key, count]) => `${key}(${count})`).join(" ")}`];
+}
+function mostCalled(index, limit) {
+  const counts2 = [];
+  for (const [id2, callers] of index.callers) {
+    const symbol2 = index.symbols.get(id2);
+    if (symbol2 === void 0 || !SEEDABLE.has(symbol2.kind) || symbol2.kind === "constant") continue;
+    counts2.push({ symbol: symbol2, callers: callers.size });
+  }
+  counts2.sort((a, b) => b.callers - a.callers || a.symbol.path.localeCompare(b.symbol.path) || a.symbol.line - b.symbol.line);
+  return counts2.slice(0, limit).map((entry) => entry.symbol);
+}
+function buildCodeMap(index, task, options = DEFAULT_MAP_OPTIONS) {
+  const lines = [...layout(index), "Edges: 'called by' and 'calls' are resolved by name within imported files, ignoring comments and strings. Lines are file:line of the declaration."];
+  const fits = (extra) => estimateTokens(`${[...lines, ...extra].join("\n")}
+`) <= options.maxTokens;
+  const scored = scoreSymbols(index, task);
+  const seeds = [];
+  const shownFiles = /* @__PURE__ */ new Set();
+  const taskFree = scored.length === 0;
+  const candidates = taskFree ? mostCalled(index, options.maxSeeds).map((symbol2) => ({ symbol: symbol2, score: 1 })) : scored;
+  lines.push("", taskFree ? "Most called symbols:" : "Symbols most relevant to the task:");
+  for (const item of candidates) {
+    if (seeds.length >= options.maxSeeds) break;
+    const block2 = seedBlock(index, item.symbol);
+    if (!fits(block2)) {
+      const short = block2.slice(0, 1);
+      if (!fits(short)) continue;
+      lines.push(...short);
+    } else lines.push(...block2);
+    seeds.push(item.symbol);
+    shownFiles.add(item.symbol.path);
+  }
+  const personal = /* @__PURE__ */ new Map();
+  if (taskFree) for (const path of index.byFile.keys()) personal.set(path, 1);
+  else for (const item of scored.slice(0, 40)) personal.set(item.symbol.path, (personal.get(item.symbol.path) ?? 0) + item.score);
+  const rank = pageRank(index, personal);
+  const ordered = [...rank].filter(([path]) => !shownFiles.has(path)).sort((a, b) => b[1] - a[1] || a[0].localeCompare(b[0]));
+  const related = [];
+  const top = ordered[0]?.[1] ?? 0;
+  for (const [path, mass] of ordered) {
+    if (mass <= 0 || mass < top * 0.05 || related.length >= MAX_RELATED_FILES) break;
+    const line2 = outline(index, path);
+    if (!fits(["", taskFree ? "Central files:" : "Related files:", ...related, line2])) break;
+    related.push(line2);
+  }
+  if (related.length > 0) lines.push("", taskFree ? "Central files:" : "Related files:", ...related);
+  const text = `${lines.join("\n")}
+`;
+  return { lines, text, estimatedTokens: estimateTokens(text), seeds: seeds.map((seed) => seed.qualified), files: index.files, symbols: index.symbols.size };
+}
+function buildCodeMapDigest(input2) {
+  const map2 = buildCodeMap(input2.index, input2.task ?? "", input2.options ?? DEFAULT_MAP_OPTIONS);
+  return {
+    schemaVersion: "1",
+    revision: { commitSha: input2.commitSha, ...input2.branch === void 0 ? {} : { branch: input2.branch } },
+    builtAt: input2.builtAt,
+    coverage: { files: map2.files, symbols: map2.symbols, uncovered: input2.uncovered },
+    lines: map2.lines,
+    seeds: map2.seeds
+  };
+}
+var KEYWORDS, CALLABLE, SEEDABLE, MIN_WORD_IDF, MIN_SOFT_SCORE, MAX_RELATED_FILES, STOP, baseName, DEFAULT_MAP_OPTIONS, estimateTokens, where;
+var init_context_map = __esm({
+  "../index-builder/src/context-map.ts"() {
+    "use strict";
+    init_src();
+    init_languages();
+    init_treesitter();
+    KEYWORDS = /* @__PURE__ */ new Set(["const", "let", "var", "function", "return", "if", "else", "new", "this", "class", "extends", "implements", "import", "export", "from", "type", "interface", "async", "await", "string", "number", "boolean", "void", "null", "undefined", "true", "false", "private", "protected", "public", "readonly", "static", "abstract", "super", "typeof", "for", "of", "in", "while", "throw", "try", "catch", "as"]);
+    CALLABLE = /* @__PURE__ */ new Set(["function", "method", "constant", "variable"]);
+    SEEDABLE = /* @__PURE__ */ new Set(["function", "method", "class", "interface", "type", "constant"]);
+    MIN_WORD_IDF = 2.5;
+    MIN_SOFT_SCORE = 3.5;
+    MAX_RELATED_FILES = 14;
+    STOP = /* @__PURE__ */ new Set(["the", "a", "an", "of", "to", "in", "is", "are", "and", "or", "for", "that", "this", "it", "its", "by", "be", "on", "as", "at", "with", "from", "which", "what", "when", "where", "who", "how", "do", "does", "not", "any", "each", "every", "all", "also", "than", "then", "so", "if", "into", "file", "path", "answer", "end", "final", "message", "line", "start", "follow", "separate", "comma", "give", "name", "modify", "files", "repository", "source", "code", "change", "update", "make", "use", "uses", "used", "other", "only", "about", "will", "can", "should", "need", "needs", "happen", "merely", "share", "same", "return", "returns", "pass", "passes"]);
+    baseName = (name2) => name2.replace(/<.*$/, "").split(".").pop() ?? name2;
+    DEFAULT_MAP_OPTIONS = { maxTokens: 3400, maxSeeds: 6 };
+    estimateTokens = estimateCodeMapTokens;
+    where = (symbol2) => `${symbol2.qualified} ${symbol2.path}:${symbol2.line}`;
+  }
+});
+
+// ../index-builder/src/context-map-build.ts
 import { execFile as execFile2 } from "node:child_process";
-import { mkdir as mkdir3, readdir as readdir4, rm as rm2, writeFile as writeFile3 } from "node:fs/promises";
-import { join as join26, resolve as resolve14 } from "node:path";
-import { parseArgs as parseArgs2 } from "node:util";
+import { mkdir as mkdir3, readFile as readFile5, writeFile as writeFile3 } from "node:fs/promises";
+import { dirname as dirname9, join as join26 } from "node:path";
 import { promisify as promisify2 } from "node:util";
 async function git3(root, args2) {
-  const { stdout } = await execFileAsync2("git", args2, { cwd: root, encoding: "utf8" });
+  const { stdout } = await execFileAsync2("git", args2, { cwd: root, encoding: "utf8", maxBuffer: 256 * 1024 * 1024 });
+  return stdout.trim();
+}
+async function buildDigestForCheckout(options) {
+  const tracked = (await execFileAsync2("git", ["ls-files", "-z"], { cwd: options.root, encoding: "utf8", maxBuffer: 256 * 1024 * 1024 })).stdout.split("\0").filter((path) => path !== "");
+  const files = /* @__PURE__ */ new Map();
+  let uncovered = 0;
+  for (const path of tracked) {
+    if (languageForPath(path) === null) continue;
+    try {
+      const bytes = await readFile5(join26(options.root, path));
+      if (bytes.byteLength > MAX_PARSE_BYTES) {
+        uncovered += 1;
+        continue;
+      }
+      files.set(path, bytes.toString("utf8"));
+    } catch {
+      uncovered += 1;
+    }
+  }
+  const index = await buildRepoIndex(files);
+  const commitSha = await git3(options.root, ["rev-parse", "HEAD"]);
+  let branch;
+  try {
+    branch = await git3(options.root, ["symbolic-ref", "--short", "-q", "HEAD"]) || void 0;
+  } catch {
+    branch = void 0;
+  }
+  return CodeMapDigest.parse(
+    buildCodeMapDigest({ index, commitSha, ...branch === void 0 ? {} : { branch }, uncovered, builtAt: options.builtAt ?? (/* @__PURE__ */ new Date()).toISOString(), ...options.task === void 0 ? {} : { task: options.task } })
+  );
+}
+async function writeDigest(root, digest, out2) {
+  const path = out2 ?? join26(root, CODE_MAP_DIGEST_PATH);
+  await mkdir3(dirname9(path), { recursive: true });
+  await writeFile3(path, `${JSON.stringify(digest)}
+`);
+  return path;
+}
+var execFileAsync2;
+var init_context_map_build = __esm({
+  "../index-builder/src/context-map-build.ts"() {
+    "use strict";
+    init_src();
+    init_context_map();
+    init_languages();
+    init_snapshot();
+    execFileAsync2 = promisify2(execFile2);
+  }
+});
+
+// ../index-builder/src/run.ts
+import { execFile as execFile3 } from "node:child_process";
+import { mkdir as mkdir4, readdir as readdir4, rm as rm2, writeFile as writeFile4 } from "node:fs/promises";
+import { join as join27, resolve as resolve14 } from "node:path";
+import { parseArgs as parseArgs2 } from "node:util";
+import { promisify as promisify3 } from "node:util";
+async function git4(root, args2) {
+  const { stdout } = await execFileAsync3("git", args2, { cwd: root, encoding: "utf8" });
   return stdout.trim();
 }
 function parseRepository(value) {
@@ -40533,7 +40978,7 @@ function parseRepository(value) {
 }
 async function repositoryFromRemote(root) {
   try {
-    const url2 = await git3(root, ["remote", "get-url", "origin"]);
+    const url2 = await git4(root, ["remote", "get-url", "origin"]);
     return /github\.com[:/]([^/\s]+)\/([^/\s]+?)(?:\.git)?\/?$/.exec(url2)?.slice(1, 3).join("/");
   } catch {
     return void 0;
@@ -40545,7 +40990,7 @@ async function snapshotFromArgs(values, env) {
   if (projectId !== void 0 && !ProjectId.safeParse(projectId).success) throw new UsageError2(`--project must be a project identifier, got "${projectId}"`);
   const repoText = projectId !== void 0 ? typeof values["repo"] === "string" ? values["repo"] : void 0 : (typeof values["repo"] === "string" ? values["repo"] : void 0) ?? env["GITHUB_REPOSITORY"] ?? await repositoryFromRemote(root);
   if (!repoText && projectId === void 0) throw new UsageError2("cannot determine the repository; pass --project ID, or --repo owner/name");
-  const commit = (typeof values["commit"] === "string" ? values["commit"] : void 0) ?? env["GITHUB_SHA"] ?? await git3(root, ["rev-parse", "HEAD"]);
+  const commit = (typeof values["commit"] === "string" ? values["commit"] : void 0) ?? env["GITHUB_SHA"] ?? await git4(root, ["rev-parse", "HEAD"]);
   const branch = typeof values["branch"] === "string" ? values["branch"] : void 0;
   const tenant = (typeof values["tenant"] === "string" ? values["tenant"] : void 0) ?? env["HARNESS_TENANT"];
   if (!tenant) throw new UsageError2("missing --tenant (or HARNESS_TENANT)");
@@ -40572,6 +41017,13 @@ async function runCli2(argv, env, out2 = console.log, err2 = console.error) {
       out2(`built ${built.shards.length} shards (${built.uncovered.length} files uncovered) into ${resolve14(outDir)}`);
       return 0;
     }
+    if (command === "map") {
+      const root = resolve14(values.root ?? process.cwd());
+      const digest = await buildDigestForCheckout({ root, ...values.task === void 0 ? {} : { task: values.task } });
+      const path = await writeDigest(root, digest, values.out === void 0 ? void 0 : resolve14(values.out));
+      out2(`wrote the code map digest for ${digest.revision.commitSha.slice(0, 12)} (${digest.coverage.files} files, ${digest.coverage.symbols} symbols, ${digest.lines.length} lines) to ${path}`);
+      return 0;
+    }
     if (command === "upload") {
       const service = values.service;
       if (!service) throw new UsageError2("upload needs --service URL");
@@ -40595,28 +41047,31 @@ ${USAGE}`);
   }
 }
 async function writeSnapshot(dir, built) {
-  await mkdir3(join26(dir, "shards"), { recursive: true });
-  for (const name2 of await readdir4(join26(dir, "shards"))) await rm2(join26(dir, "shards", name2));
-  await writeFile3(join26(dir, "manifest.json"), JSON.stringify(built.manifest, null, 2));
-  await writeFile3(join26(dir, "uncovered.json"), JSON.stringify(built.uncovered, null, 2));
+  await mkdir4(join27(dir, "shards"), { recursive: true });
+  for (const name2 of await readdir4(join27(dir, "shards"))) await rm2(join27(dir, "shards", name2));
+  await writeFile4(join27(dir, "manifest.json"), JSON.stringify(built.manifest, null, 2));
+  await writeFile4(join27(dir, "uncovered.json"), JSON.stringify(built.uncovered, null, 2));
   for (const shard of built.shards) {
     const name2 = shardKeyOf(shard).slice("sha256:".length);
-    await writeFile3(join26(dir, "shards", `${name2}.json`), JSON.stringify(shard));
+    await writeFile4(join27(dir, "shards", `${name2}.json`), JSON.stringify(shard));
   }
 }
-var execFileAsync2, USAGE, UsageError2, OPTIONS;
+var execFileAsync3, USAGE, UsageError2, OPTIONS;
 var init_run = __esm({
   "../index-builder/src/run.ts"() {
     "use strict";
     init_src();
+    init_context_map_build();
     init_oidc();
     init_snapshot();
     init_upload();
-    execFileAsync2 = promisify2(execFile2);
+    execFileAsync3 = promisify3(execFile3);
     USAGE = `usage:
   mvrx-index build  --scip FILE [--scip FILE ...] --out DIR [--project ID | --repo owner/name] [--tenant ID] [--commit SHA] [--branch B] [--root DIR]
+  mvrx-index map    [--root DIR] [--out FILE] [--task TEXT]
   mvrx-index upload --service URL --tenant ID (--project ID | --repo owner/name) --commit SHA [--branch B] [--scip FILE ...] [--root DIR] [--audience URL]
 
+map writes the ranked code map digest (default .harness/code-map.json in the root) that the session-start hook delivers as context (ADR 0055). No model; --task ranks by the words of a task.
 --project indexes an Overlane project (no GitHub repository needed) and uploads with HARNESS_TOKEN.
 --repo names a GitHub repository; in GitHub Actions the OIDC token is used when ACTIONS_ID_TOKEN_REQUEST_URL is set.
 Authentication for upload: HARNESS_TOKEN (always for --project), or the GitHub Actions OIDC token for --repo.
@@ -40633,7 +41088,8 @@ Authentication for upload: HARNESS_TOKEN (always for --project), or the GitHub A
       commit: { type: "string" },
       branch: { type: "string" },
       root: { type: "string" },
-      audience: { type: "string" }
+      audience: { type: "string" },
+      task: { type: "string" }
     };
   }
 });
@@ -40648,6 +41104,8 @@ var init_src2 = __esm({
     init_snapshot();
     init_upload();
     init_oidc();
+    init_context_map();
+    init_context_map_build();
     init_run();
   }
 });
@@ -55442,8 +55900,8 @@ var init_cloud = __esm({
 // ../code-shim/src/git.ts
 import { execFileSync } from "node:child_process";
 import { existsSync as existsSync8 } from "node:fs";
-import { join as join30 } from "node:path";
-function git4(root, args2) {
+import { join as join31 } from "node:path";
+function git5(root, args2) {
   try {
     return execFileSync("git", args2, { cwd: root, encoding: "utf8", stdio: ["ignore", "pipe", "ignore"], maxBuffer: 64 * 1024 * 1024, timeout: 1e4 });
   } catch {
@@ -55451,12 +55909,12 @@ function git4(root, args2) {
   }
 }
 function headCommit2(root) {
-  const out2 = git4(root, ["rev-parse", "--verify", "HEAD"]);
+  const out2 = git5(root, ["rev-parse", "--verify", "HEAD"]);
   const sha = out2?.trim();
   return sha !== void 0 && /^[0-9a-f]{40,64}$/.test(sha) ? sha : null;
 }
 function originRepository(root) {
-  const url2 = git4(root, ["remote", "get-url", "origin"])?.trim();
+  const url2 = git5(root, ["remote", "get-url", "origin"])?.trim();
   if (url2 === void 0 || url2.length === 0) return null;
   const match = /[:/]([^/:]+)\/([^/]+?)(?:\.git)?\/?$/.exec(url2);
   const owner = match?.[1];
@@ -55502,9 +55960,9 @@ function parseStatus(raw, exists) {
 }
 function readWorkingCopyState(root) {
   const head = headCommit2(root);
-  const raw = git4(root, ["status", "--porcelain=v2", "-z", "--untracked-files=all"]);
+  const raw = git5(root, ["status", "--porcelain=v2", "-z", "--untracked-files=all"]);
   if (raw === null) return { head, dirty: /* @__PURE__ */ new Set(), deleted: /* @__PURE__ */ new Set(), renamed: /* @__PURE__ */ new Map() };
-  return { head, ...parseStatus(raw, (path) => existsSync8(join30(root, path))) };
+  return { head, ...parseStatus(raw, (path) => existsSync8(join31(root, path))) };
 }
 var init_git2 = __esm({
   "../code-shim/src/git.ts"() {
@@ -55515,16 +55973,16 @@ var init_git2 = __esm({
 // ../code-shim/src/config.ts
 import { readFileSync as readFileSync14 } from "node:fs";
 import { homedir as homedir2 } from "node:os";
-import { join as join31 } from "node:path";
+import { join as join32 } from "node:path";
 function configDir(env) {
-  const base4 = env["XDG_CONFIG_HOME"] ?? (process.platform === "win32" ? env["APPDATA"] : void 0) ?? join31(homedir2(), ".config");
-  return join31(base4, "mvrx-harness");
+  const base4 = env["XDG_CONFIG_HOME"] ?? (process.platform === "win32" ? env["APPDATA"] : void 0) ?? join32(homedir2(), ".config");
+  return join32(base4, "mvrx-harness");
 }
 function findToken2(env, serviceUrl, now) {
   const fromEnv = env["HARNESS_TOKEN"];
   if (fromEnv !== void 0 && fromEnv.length > 0) return fromEnv;
   try {
-    const file2 = JSON.parse(readFileSync14(join31(configDir(env), "credentials.json"), "utf8"));
+    const file2 = JSON.parse(readFileSync14(join32(configDir(env), "credentials.json"), "utf8"));
     const stored = file2[serviceUrl];
     if (stored === void 0 || typeof stored.accessToken !== "string" || stored.accessToken.length === 0) return null;
     if (typeof stored.expiresAt === "number" && stored.expiresAt <= now) return null;
@@ -55536,7 +55994,7 @@ function findToken2(env, serviceUrl, now) {
 function resolveCloudConfig(root, env, now) {
   let binding;
   try {
-    const parsed = ProjectBinding.safeParse(JSON.parse(readFileSync14(join31(root, ".harness", "project.json"), "utf8")));
+    const parsed = ProjectBinding.safeParse(JSON.parse(readFileSync14(join32(root, ".harness", "project.json"), "utf8")));
     if (!parsed.success) return null;
     binding = parsed.data;
   } catch {
@@ -55958,8 +56416,8 @@ async function locate(index, path, namePath) {
   const [only] = matches;
   if (only === void 0) return { ok: false, reason: `symbol ${namePath} not found in ${path}` };
   if (matches.length > 1) {
-    const where = matches.map((m) => `line ${m.range[0] + 1}`).join(", ");
-    return { ok: false, reason: `symbol ${namePath} is ambiguous in ${path} (${matches.length} matches: ${where}); give a longer name_path` };
+    const where2 = matches.map((m) => `line ${m.range[0] + 1}`).join(", ");
+    return { ok: false, reason: `symbol ${namePath} is ambiguous in ${path} (${matches.length} matches: ${where2}); give a longer name_path` };
   }
   return { ok: true, shard, symbol: only };
 }
@@ -58783,17 +59241,17 @@ function naturalCompare(a, b) {
   }
   return left.length - right.length || (a < b ? -1 : a > b ? 1 : 0);
 }
-function splitFrontMatter(text, where) {
+function splitFrontMatter(text, where2) {
   const normalized = text.replace(/\r\n/g, "\n");
   const match = /^---\n([\s\S]*?)\n?---\n?([\s\S]*)$/.exec(normalized);
-  if (!match) throw new KitError(`${where}: missing YAML front matter`);
+  if (!match) throw new KitError(`${where2}: missing YAML front matter`);
   let data;
   try {
     data = (0, import_yaml.parse)(match[1] ?? "");
   } catch (error62) {
-    throw new KitError(`${where}: front matter is not valid YAML`, [error62 instanceof Error ? error62.message : String(error62)]);
+    throw new KitError(`${where2}: front matter is not valid YAML`, [error62 instanceof Error ? error62.message : String(error62)]);
   }
-  if (data === null || typeof data !== "object" || Array.isArray(data)) throw new KitError(`${where}: front matter must be a mapping`);
+  if (data === null || typeof data !== "object" || Array.isArray(data)) throw new KitError(`${where2}: front matter must be a mapping`);
   return { data, body: match[2] ?? "" };
 }
 function joinFrontMatter(data, body2) {
@@ -58822,21 +59280,21 @@ function sectionsOf(body2, level = 2) {
 function sectionText(lines) {
   return (lines ?? []).join("\n").replace(/^\n+|\s+$/g, "");
 }
-function bulletsOf(lines, where) {
+function bulletsOf(lines, where2) {
   const items = [];
   for (const line2 of lines ?? []) {
     if (line2.trim() === "") continue;
     const match = /^- (.*)$/.exec(line2);
-    if (!match) throw new KitError(`${where}: expected a "- " bullet, found "${line2}"`);
+    if (!match) throw new KitError(`${where2}: expected a "- " bullet, found "${line2}"`);
     items.push(match[1] ?? "");
   }
   return items;
 }
-function assertLine(value, where) {
-  if (value !== value.trim() || /[\r\n]/.test(value)) throw new KitError(`${where} must be one line without surrounding whitespace`, [JSON.stringify(value)]);
+function assertLine(value, where2) {
+  if (value !== value.trim() || /[\r\n]/.test(value)) throw new KitError(`${where2} must be one line without surrounding whitespace`, [JSON.stringify(value)]);
 }
-function assertBlock(value, where) {
-  if (value !== value.trim() || /\r/.test(value) || /^#{1,2}\s/m.test(value)) throw new KitError(`${where} must be trimmed text with no line starting with "# " or "## "`, [JSON.stringify(value.slice(0, 80))]);
+function assertBlock(value, where2) {
+  if (value !== value.trim() || /\r/.test(value) || /^#{1,2}\s/m.test(value)) throw new KitError(`${where2} must be trimmed text with no line starting with "# " or "## "`, [JSON.stringify(value.slice(0, 80))]);
 }
 function slugify2(value) {
   return value.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "") || "project";
@@ -58848,9 +59306,9 @@ var planPaths = (repoDir) => {
   const root = join15(repoDir, PLAN_DIR);
   return { root, project: join15(root, "project.md"), milestones: join15(root, "milestones.md"), tasks: join15(root, "tasks"), task: (id2) => join15(root, "tasks", `${id2}.md`) };
 };
-function parsePlan(input2, where) {
+function parsePlan(input2, where2) {
   const result = Plan.safeParse(input2);
-  if (!result.success) throw new KitError(`${where}: plan is invalid`, result.error.issues.map((issue2) => `${issue2.path.join(".") || "(root)"}: ${issue2.message}`));
+  if (!result.success) throw new KitError(`${where2}: plan is invalid`, result.error.issues.map((issue2) => `${issue2.path.join(".") || "(root)"}: ${issue2.message}`));
   return result.data;
 }
 function canonicalizePlan(plan3) {
@@ -58916,16 +59374,16 @@ async function readText2(file2) {
     throw new KitError(`cannot read ${file2}`, [error62 instanceof Error ? error62.message : String(error62)]);
   }
 }
-function parseProject(text, where) {
-  const { data, body: body2 } = splitFrontMatter(text, where);
+function parseProject(text, where2) {
+  const { data, body: body2 } = splitFrontMatter(text, where2);
   const sections = sectionsOf(body2);
   return {
     schemaVersion: data["schemaVersion"],
-    project: { name: data["name"], goal: sectionText(sections.get("Goal")), constraints: bulletsOf(sections.get("Constraints"), `${where} Constraints`) }
+    project: { name: data["name"], goal: sectionText(sections.get("Goal")), constraints: bulletsOf(sections.get("Constraints"), `${where2} Constraints`) }
   };
 }
-function parseMilestones(text, where) {
-  const { body: body2 } = splitFrontMatter(text, where);
+function parseMilestones(text, where2) {
+  const { body: body2 } = splitFrontMatter(text, where2);
   const milestones = [];
   let current2;
   let inAcceptance = false;
@@ -58949,12 +59407,12 @@ function parseMilestones(text, where) {
     const depends = /^Depends on: (.+)$/.exec(line2);
     if (depends && !inAcceptance) current2.dependsOn = (depends[1] ?? "").split(",").map((id2) => id2.trim());
     else if (inAcceptance && line2.startsWith("- ")) current2.acceptance.push(line2.slice(2));
-    else throw new KitError(`${where}: unexpected line under ${current2.id}: "${line2}"`);
+    else throw new KitError(`${where2}: unexpected line under ${current2.id}: "${line2}"`);
   }
   return milestones;
 }
-function parseTask(text, where) {
-  const { data, body: body2 } = splitFrontMatter(text, where);
+function parseTask(text, where2) {
+  const { data, body: body2 } = splitFrontMatter(text, where2);
   const sections = sectionsOf(body2);
   return {
     id: data["id"],
@@ -58962,7 +59420,7 @@ function parseTask(text, where) {
     milestone: data["milestone"],
     outcome: sectionText(sections.get("Outcome")),
     allowedPaths: data["allowedPaths"],
-    acceptance: bulletsOf(sections.get("Acceptance"), `${where} Acceptance`),
+    acceptance: bulletsOf(sections.get("Acceptance"), `${where2} Acceptance`),
     verification: data["verification"],
     evidenceLevel: data["evidenceLevel"],
     dependsOn: data["dependsOn"],
@@ -59195,14 +59653,14 @@ async function readOptional2(file2) {
     return void 0;
   }
 }
-function parseTasksFile(text, where) {
+function parseTasksFile(text, where2) {
   let block2 = { milestones: {}, tasks: {} };
   const match = BLOCK_PATTERN.exec(text);
   if (match) {
     try {
       block2 = BlockSchema.parse(JSON.parse(match[1] ?? ""));
     } catch (error62) {
-      throw new KitError(`${where}: the mvrx-kit comment block is invalid`, [error62 instanceof Error ? error62.message : String(error62)]);
+      throw new KitError(`${where2}: the mvrx-kit comment block is invalid`, [error62 instanceof Error ? error62.message : String(error62)]);
     }
   }
   const phases = [];
@@ -63967,13 +64425,16 @@ var reviewSettingsSetCommand = defineCommand({
 var codeMapStatusCommand = defineCommand({
   path: ["code-map", "status"],
   summary: "Show, per client, whether the code map is on and why",
-  description: "Lists every supported client in its local and cloud setting, and the bots, review service, cross-repository questions and wiki, with whether the code map is on and the reason. The default for a setting follows the latest GATE-07 result for that setting: off for a local agent with grep (the local run failed, ADR 0018), on where there is no checkout until a re-run says otherwise.",
+  description: "Lists every supported client in its local and cloud setting, and the bots, review service, cross-repository questions and wiki, with two settings each. The code tools (codeLayer): the default follows the latest GATE-07 result for that setting, off for a local agent with grep (ADR 0018), on where there is no checkout. The map as context (codeMapContext, ADR 0055): a ranked map delivered once at session start, on where there is no checkout, on for read-only work for a local agent, and opt-in for edits and when the intent is unknown. The project setting codeMapContext (default, on or off) overrides the default.",
   examples: ["overlane code-map status", "overlane code-map status --json"],
   effect: "read",
   ...common8,
   keywords: ["code map", "code tools", "is the code map on", "gate-07", "code layer", "per client"],
   result: CodeMapStatus,
-  text: (d) => d.clients.map((row) => `${row.on ? "on " : "off"}  ${row.subject}: ${row.reason}`),
+  text: (d) => [
+    `Project settings: codeLayer ${d.projectCodeLayer ? "on" : "off"}, codeMapContext ${d.projectCodeMapContext ?? "default"}.`,
+    ...d.clients.flatMap((row) => [`tools ${row.on ? "on " : "off"}  ${row.subject}: ${row.reason}`, ...row.context === void 0 ? [] : [`context ${row.context.mode.padEnd(9)}  ${row.subject}: ${row.context.reason}`]])
+  ],
   handler: async (inv) => {
     const { call: call2, tenantId, projectId } = await connected4(inv);
     return { data: await call2(CodeMapStatus, "GET", codeMapPaths.status(tenantId, projectId)) };
@@ -64161,8 +64622,8 @@ function searchCommands(specs, query, limit = SEARCH_LIMIT) {
       const frequency = doc.weighted.get(term) ?? 0;
       if (frequency === 0) continue;
       const containing = documents.filter((other) => other.weighted.has(term)).length;
-      const idf = Math.log(1 + (documents.length - containing + 0.5) / (containing + 0.5));
-      score += idf * (frequency * (K1 + 1) / (frequency + K1 * (1 - B + B * doc.length / averageLength)));
+      const idf2 = Math.log(1 + (documents.length - containing + 0.5) / (containing + 0.5));
+      score += idf2 * (frequency * (K1 + 1) / (frequency + K1 * (1 - B + B * doc.length / averageLength)));
     }
     if (score > 0) scored.push({ doc, score });
   }
@@ -66297,35 +66758,35 @@ init_src2();
 
 // src/data-dir.ts
 import { homedir } from "node:os";
-import { join as join27 } from "node:path";
+import { join as join28 } from "node:path";
 function dataDir(env = process.env, home = homedir()) {
   const override = env["MVRX_DATA_DIR"];
   if (override !== void 0 && override !== "") return override;
-  const base4 = env["XDG_DATA_HOME"] ?? (process.platform === "win32" ? env["LOCALAPPDATA"] : void 0) ?? (process.platform === "darwin" ? join27(home, "Library", "Application Support") : join27(home, ".local", "share"));
-  return join27(base4, "mvrx-harness");
+  const base4 = env["XDG_DATA_HOME"] ?? (process.platform === "win32" ? env["LOCALAPPDATA"] : void 0) ?? (process.platform === "darwin" ? join28(home, "Library", "Application Support") : join28(home, ".local", "share"));
+  return join28(base4, "mvrx-harness");
 }
 function marketplaceRoot(env = process.env, home = homedir()) {
-  return join27(dataDir(env, home), "marketplace");
+  return join28(dataDir(env, home), "marketplace");
 }
 
 // src/plugin.ts
 import { readFileSync as readFileSync13 } from "node:fs";
-import { join as join29 } from "node:path";
+import { join as join30 } from "node:path";
 import { parseArgs as parseArgs3 } from "node:util";
 
 // src/marketplace.ts
 init_src();
 import { createHash as createHash7 } from "node:crypto";
 import { cpSync, existsSync as existsSync7, mkdirSync as mkdirSync9, readdirSync as readdirSync3, readFileSync as readFileSync12, renameSync as renameSync6, rmSync as rmSync4, statSync as statSync2, writeFileSync as writeFileSync8 } from "node:fs";
-import { dirname as dirname9, join as join28, relative as relative2, sep } from "node:path";
+import { dirname as dirname10, join as join29, relative as relative2, sep } from "node:path";
 var CLIENT_DIRS = ["claude", "codex"];
 var EMBEDDED_MANIFEST = "release-manifest.json";
-var INSTALLED_MANIFEST = join28(".release", "manifest.json");
+var INSTALLED_MANIFEST = join29(".release", "manifest.json");
 var MarketplaceError = class extends Error {
 };
 function loadEmbedded(packageRoot2) {
-  const dir = join28(packageRoot2, "plugins");
-  const path = join28(dir, EMBEDDED_MANIFEST);
+  const dir = join29(packageRoot2, "plugins");
+  const path = join29(dir, EMBEDDED_MANIFEST);
   if (!existsSync7(path)) throw new MarketplaceError(`this package has no embedded plugin release (${path} is missing)`);
   const parsed = ReleaseManifest.safeParse(JSON.parse(readFileSync12(path, "utf8")));
   if (!parsed.success) throw new MarketplaceError(`the embedded release manifest is invalid: ${parsed.error.message}`);
@@ -66338,7 +66799,7 @@ function listFiles(root, dir = root) {
   if (!existsSync7(dir)) return [];
   const out2 = [];
   for (const entry of readdirSync3(dir, { withFileTypes: true })) {
-    const full = join28(dir, entry.name);
+    const full = join29(dir, entry.name);
     if (entry.isDirectory()) out2.push(...listFiles(root, full));
     else out2.push(relative2(root, full).split(sep).join("/"));
   }
@@ -66350,7 +66811,7 @@ async function verifyTree(treeRoot, manifest) {
   if (recomputed !== manifest.digest) problems.push(`manifest digest ${manifest.digest} does not match its file list (${recomputed})`);
   const listed = new Set(manifest.files.map((file2) => file2.path));
   for (const file2 of manifest.files) {
-    const path = join28(treeRoot, file2.path);
+    const path = join29(treeRoot, file2.path);
     if (!existsSync7(path)) {
       problems.push(`missing: ${file2.path}`);
       continue;
@@ -66358,7 +66819,7 @@ async function verifyTree(treeRoot, manifest) {
     if (sha2562(readFileSync12(path)) !== file2.digest) problems.push(`modified: ${file2.path}`);
   }
   for (const client of CLIENT_DIRS) {
-    for (const found of listFiles(join28(treeRoot, client))) {
+    for (const found of listFiles(join29(treeRoot, client))) {
       if (!listed.has(`${client}/${found}`)) problems.push(`unlisted: ${client}/${found}`);
     }
   }
@@ -66366,7 +66827,7 @@ async function verifyTree(treeRoot, manifest) {
 }
 function readInstalledManifest(target) {
   try {
-    const parsed = ReleaseManifest.safeParse(JSON.parse(readFileSync12(join28(target, INSTALLED_MANIFEST), "utf8")));
+    const parsed = ReleaseManifest.safeParse(JSON.parse(readFileSync12(join29(target, INSTALLED_MANIFEST), "utf8")));
     return parsed.success ? parsed.data : null;
   } catch {
     return null;
@@ -66394,15 +66855,15 @@ async function syncMarketplace(embedded, target) {
   mkdirSync9(staging, { recursive: true });
   try {
     for (const client of CLIENT_DIRS) {
-      if (existsSync7(join28(embedded.dir, client))) cpSync(join28(embedded.dir, client), join28(staging, client), { recursive: true });
+      if (existsSync7(join29(embedded.dir, client))) cpSync(join29(embedded.dir, client), join29(staging, client), { recursive: true });
     }
-    mkdirSync9(join28(staging, ".release"), { recursive: true });
-    writeFileSync8(join28(staging, INSTALLED_MANIFEST), `${JSON.stringify(embedded.manifest, null, 2)}
+    mkdirSync9(join29(staging, ".release"), { recursive: true });
+    writeFileSync8(join29(staging, INSTALLED_MANIFEST), `${JSON.stringify(embedded.manifest, null, 2)}
 `);
     const after = await verifyTree(staging, embedded.manifest);
     if (after.length > 0) throw new MarketplaceError(`the copied plugin files do not match the release manifest:
   ${after.join("\n  ")}`);
-    mkdirSync9(dirname9(target), { recursive: true });
+    mkdirSync9(dirname10(target), { recursive: true });
     if (existsSync7(target)) renameSync6(target, previous);
     try {
       renameSync6(staging, target);
@@ -66429,7 +66890,7 @@ var PLUGIN_USAGE = `  overlane plugin install [--scope project|user] [--client c
 var PluginUsageError = class extends Error {
 };
 function readNames(treeRoot, client) {
-  const file2 = client === "claude" ? join29(treeRoot, "claude", ".claude-plugin", "marketplace.json") : join29(treeRoot, "codex", ".agents", "plugins", "marketplace.json");
+  const file2 = client === "claude" ? join30(treeRoot, "claude", ".claude-plugin", "marketplace.json") : join30(treeRoot, "codex", ".agents", "plugins", "marketplace.json");
   const parsed = JSON.parse(readFileSync13(file2, "utf8"));
   const record3 = parsed;
   const plugin = record3.plugins?.[0]?.name;
@@ -66476,7 +66937,7 @@ ${PLUGIN_USAGE}`);
       const key = `${names.plugin}@${names.marketplace}`;
       if (!await available(deps, client)) {
         if (explicit !== void 0) {
-          deps.stderr(`overlane: \`${client}\` was not found on PATH; the marketplace is at ${join29(root, client)}
+          deps.stderr(`overlane: \`${client}\` was not found on PATH; the marketplace is at ${join30(root, client)}
 `);
           failed = true;
         } else {
@@ -66488,7 +66949,7 @@ ${PLUGIN_USAGE}`);
       ranAny = true;
       deps.stdout(`${client}:
 `);
-      const dir = join29(root, client);
+      const dir = join30(root, client);
       const steps = client === "claude" ? [
         ["claude", ["plugin", "marketplace", "add", dir, "--scope", scope]],
         ["claude", ["plugin", "marketplace", "update", names.marketplace]],
@@ -66654,13 +67115,13 @@ var pluginInstallCommand = defineCommand({
 var packageCommands = [indexBuildCommand, indexUploadCommand, shimCommand, pluginInstallCommand];
 
 // src/deps.ts
-import { execFile as execFile3, spawn } from "node:child_process";
+import { execFile as execFile4, spawn } from "node:child_process";
 import { homedir as homedir3 } from "node:os";
-import { join as join32 } from "node:path";
+import { join as join33 } from "node:path";
 import { createInterface } from "node:readline/promises";
 function exec(command, args2, options) {
   return new Promise((resolveResult) => {
-    execFile3(command, [...args2], { cwd: options?.cwd, encoding: "utf8", maxBuffer: 16 * 1024 * 1024 }, (error62, stdout, stderr) => {
+    execFile4(command, [...args2], { cwd: options?.cwd, encoding: "utf8", maxBuffer: 16 * 1024 * 1024 }, (error62, stdout, stderr) => {
       if (error62 === null) {
         resolveResult({ code: 0, stdout, stderr });
       } else if ("code" in error62 && typeof error62.code === "number") {
@@ -66702,8 +67163,8 @@ async function confirm(question) {
   }
 }
 function configDir2(env) {
-  const base4 = env["XDG_CONFIG_HOME"] ?? (process.platform === "win32" ? env["APPDATA"] : void 0) ?? join32(homedir3(), ".config");
-  return join32(base4, "mvrx-harness");
+  const base4 = env["XDG_CONFIG_HOME"] ?? (process.platform === "win32" ? env["APPDATA"] : void 0) ?? join33(homedir3(), ".config");
+  return join33(base4, "mvrx-harness");
 }
 function createDeps2(env = process.env) {
   return {