@cortexkit/magic-context 0.23.1 → 0.24.0

package/dist/index.js

@@ -8265,9 +8265,6 @@ import { execFileSync, spawnSync } from "node:child_process";
 import { existsSync as existsSync4 } from "node:fs";
 import { homedir as homedir4 } from "node:os";
 import { join as join5 } from "node:path";
-function getStaticModels() {
-  return [...STATIC_MODELS];
-}
 function detectPiBinary() {
   const fromPath = findOnPath("pi");
   if (fromPath)
@@ -8314,17 +8311,26 @@ function parseModelListOutput(output) {
     const line = rawLine.trim().replace(/^[•*-]\s*/, "");
     if (!line || line.toLowerCase().includes("usage:"))
       continue;
-    const token = line.split(/\s+/)[0]?.trim().replace(/,$/, "");
-    if (!token?.includes("/"))
+    const cols = line.split(/\s+/);
+    const first = cols[0]?.replace(/,$/, "") ?? "";
+    if (first.includes("/")) {
+      if (!/^https?:\/\//.test(first))
+        models.add(first);
       continue;
-    if (/^https?:\/\//.test(token))
+    }
+    const provider = first;
+    const model = cols[1]?.replace(/,$/, "") ?? "";
+    if (provider.toLowerCase() === "provider" && model.toLowerCase() === "model") {
       continue;
-    models.add(token);
+    }
+    if (PROVIDER_TOKEN.test(provider) && MODEL_TOKEN.test(model)) {
+      models.add(`${provider}/${model}`);
+    }
   }
   return [...models];
 }
 function getAvailableModels(piPath) {
-  const outputs = [runPi(piPath, ["models", "list"]), runPi(piPath, ["--list-models"])];
+  const outputs = [runPi(piPath, ["--list-models"]), runPi(piPath, ["models", "list"])];
   for (const output of outputs) {
     if (!output)
       continue;
@@ -8332,95 +8338,13 @@ function getAvailableModels(piPath) {
     if (models.length > 0)
       return models;
   }
-  return getStaticModels();
+  return [];
 }
-function buildModelSelection(allModels, role) {
-  const result = [];
-  const added = new Set;
-  const addIfAvailable = (pattern, hint) => {
-    const matches = allModels.filter((m) => m === pattern || m.endsWith(`/${pattern}`));
-    for (const model of matches) {
-      if (added.has(model))
-        continue;
-      added.add(model);
-      result.push({
-        label: hint ? `${model} — ${hint}` : model,
-        value: model,
-        recommended: result.length === 0
-      });
-    }
-  };
-  if (role === "historian") {
-    addIfAvailable("anthropic/claude-haiku-4-5", "fast/cheap default");
-    addIfAvailable("github-copilot/claude-sonnet-4.6", "per-request billing");
-    addIfAvailable("anthropic/claude-sonnet-4-6");
-    addIfAvailable("github-copilot/gpt-5.4", "per-request billing");
-    addIfAvailable("openai/gpt-5.4");
-    addIfAvailable("opencode-go/minimax-m2.7");
-    addIfAvailable("opencode-go/glm-5");
-  } else if (role === "dreamer") {
-    for (const model of allModels.filter((m) => m.startsWith("ollama/"))) {
-      if (added.has(model))
-        continue;
-      added.add(model);
-      result.push({
-        label: `${model} — local`,
-        value: model,
-        recommended: result.length === 0
-      });
-    }
-    addIfAvailable("anthropic/claude-sonnet-4-6", "recommended quality default");
-    addIfAvailable("github-copilot/claude-sonnet-4.6", "per-request billing");
-    addIfAvailable("github-copilot/gemini-3-flash-preview", "fast/cheap");
-    addIfAvailable("opencode-go/glm-5");
-    addIfAvailable("opencode-go/minimax-m2.7");
-  } else {
-    for (const model of allModels.filter((m) => m.startsWith("cerebras/"))) {
-      if (added.has(model))
-        continue;
-      added.add(model);
-      result.push({
-        label: `${model} — fast`,
-        value: model,
-        recommended: result.length === 0
-      });
-    }
-    addIfAvailable("github-copilot/gemini-3-flash-preview", "fast");
-    addIfAvailable("github-copilot/gpt-5-mini", "fast");
-    addIfAvailable("openai/gpt-5.4-mini", "fast");
-    addIfAvailable("anthropic/claude-haiku-4-5", "fast");
-  }
-  for (const model of allModels) {
-    if (result.length >= 30)
-      break;
-    if (added.has(model))
-      continue;
-    added.add(model);
-    result.push({
-      label: model,
-      value: model,
-      recommended: result.length === 0
-    });
-  }
-  return result;
-}
-var PI_PACKAGE_SOURCE = "npm:@cortexkit/pi-magic-context", STATIC_MODELS;
+var PI_PACKAGE_SOURCE = "npm:@cortexkit/pi-magic-context", PROVIDER_TOKEN, MODEL_TOKEN;
 var init_pi_helpers = __esm(() => {
   init_find_on_path();
-  STATIC_MODELS = [
-    "anthropic/claude-haiku-4-5",
-    "anthropic/claude-sonnet-4-6",
-    "github-copilot/claude-sonnet-4.6",
-    "github-copilot/gpt-5.4",
-    "github-copilot/gpt-5-mini",
-    "github-copilot/gemini-3-flash-preview",
-    "openai/gpt-5.4",
-    "openai/gpt-5.4-mini",
-    "opencode-go/glm-5",
-    "opencode-go/minimax-m2.7",
-    "ollama/qwen2.5-coder:7b",
-    "cerebras/llama3.1-8b"
-  ];
+  PROVIDER_TOKEN = /^[a-z0-9][a-z0-9._-]*$/i;
+  MODEL_TOKEN = /^[a-z0-9][a-z0-9._:-]*$/i;
 });
 
 // src/adapters/pi.ts
@@ -9741,6 +9665,21 @@ import j2 from "node:process";
 function te() {
   return j2.platform !== "win32" ? j2.env.TERM !== "linux" : !!j2.env.CI || !!j2.env.WT_SESSION || !!j2.env.TERMINUS_SUBLIME || j2.env.ConEmuTask === "{cmd::Cmder}" || j2.env.TERM_PROGRAM === "Terminus-Sublime" || j2.env.TERM_PROGRAM === "vscode" || j2.env.TERM === "xterm-256color" || j2.env.TERM === "alacritty" || j2.env.TERMINAL_EMULATOR === "JetBrains-JediTerm";
 }
+function Mt(t) {
+  return t.label ?? String(t.value ?? "");
+}
+function Rt(t, r) {
+  if (!t)
+    return true;
+  const s = (r.label ?? String(r.value ?? "")).toLowerCase(), i = (r.hint ?? "").toLowerCase(), u = String(r.value).toLowerCase(), n = t.toLowerCase();
+  return s.includes(n) || i.includes(n) || u.includes(n);
+}
+function se(t, r) {
+  const s = [];
+  for (const i of r)
+    t.includes(i.value) && s.push(i);
+  return s;
+}
 var import_sisteransi2, tt2, at2 = () => process.env.CI === "true", w2 = (t, r) => tt2 ? t : r, _t, ot2, ut2, F2, lt, $2, E2, It, Et, z2, H2, et2, U2, J2, Gt, st2, ct, xt, $t, dt, Ot, ht2, pt, mt, gt, M = (t) => {
   switch (t) {
     case "initial":
@@ -9798,7 +9737,47 @@ var import_sisteransi2, tt2, at2 = () => process.env.CI === "true", w2 = (t, r)
     for (const G2 of b2)
       C2.push(G2);
   return g && C2.push(l), C2;
-}, ue = (t) => {
+}, At = (t) => new Q({ options: t.options, initialValue: t.initialValue ? [t.initialValue] : undefined, initialUserInput: t.initialUserInput, placeholder: t.placeholder, filter: t.filter ?? ((r, s) => Rt(r, s)), signal: t.signal, input: t.input, output: t.output, validate: t.validate, render() {
+  const r = t.withGuide ?? h.withGuide, s = r ? [`${e("gray", $2)}`, `${M(this.state)}  ${t.message}`] : [`${M(this.state)}  ${t.message}`], i = this.userInput, u = this.options, n = t.placeholder, o = i === "" && n !== undefined, c2 = (a, l) => {
+    const d2 = Mt(a), y = a.hint && a.value === this.focusedValue ? e("dim", ` (${a.hint})`) : "";
+    switch (l) {
+      case "active":
+        return `${e("green", z2)} ${d2}${y}`;
+      case "inactive":
+        return `${e("dim", H2)} ${e("dim", d2)}`;
+      case "disabled":
+        return `${e("gray", H2)} ${e(["strikethrough", "gray"], d2)}`;
+    }
+  };
+  switch (this.state) {
+    case "submit": {
+      const a = se(this.selectedValues, u), l = a.length > 0 ? `  ${e("dim", a.map(Mt).join(", "))}` : "", d2 = r ? e("gray", $2) : "";
+      return `${s.join(`
+`)}
+${d2}${l}`;
+    }
+    case "cancel": {
+      const a = i ? `  ${e(["strikethrough", "dim"], i)}` : "", l = r ? e("gray", $2) : "";
+      return `${s.join(`
+`)}
+${l}${a}`;
+    }
+    default: {
+      const a = this.state === "error" ? "yellow" : "cyan", l = r ? `${e(a, $2)}  ` : "", d2 = r ? e(a, E2) : "";
+      let y = "";
+      if (this.isNavigating || o) {
+        const v2 = o ? n : i;
+        y = v2 !== "" ? ` ${e("dim", v2)}` : "";
+      } else
+        y = ` ${this.userInputWithCursor}`;
+      const p2 = this.filteredOptions.length !== u.length ? e("dim", ` (${this.filteredOptions.length} match${this.filteredOptions.length === 1 ? "" : "es"})`) : "", m = this.filteredOptions.length === 0 && i ? [`${l}${e("yellow", "No matches found")}`] : [], g = this.state === "error" ? [`${l}${e("yellow", this.error)}`] : [];
+      r && s.push(`${l.trimEnd()}`), s.push(`${l}${e("dim", "Search:")}${y}${p2}`, ...m, ...g);
+      const S2 = [`${e("dim", "↑/↓")} to select`, `${e("dim", "Enter:")} confirm`, `${e("dim", "Type:")} to search`], h2 = [`${l}${S2.join(" • ")}`, d2], f = this.filteredOptions.length === 0 ? [] : Y2({ cursor: this.cursor, options: this.filteredOptions, columnPadding: r ? 3 : 0, rowPadding: s.length + h2.length, style: (v2, T) => c2(v2, v2.disabled ? "disabled" : T ? "active" : "inactive"), maxItems: t.maxItems, output: t.output });
+      return [...s, ...f.map((v2) => `${l}${v2}`), ...h2].join(`
+`);
+    }
+  }
+} }).prompt(), ue = (t) => {
   const r = t.active ?? "Yes", s = t.inactive ?? "No";
   return new X({ active: r, inactive: s, signal: t.signal, input: t.input, output: t.output, initialValue: t.initialValue ?? true, render() {
     const i = t.withGuide ?? h.withGuide, u = `${M(this.state)}  `, n = i ? `${e("gray", $2)}  ` : "", o = W(t.output, t.message, n, u), c2 = `${i ? `${e("gray", $2)}
@@ -10108,6 +10087,7 @@ __export(exports_prompts, {
   spinner: () => spinner,
   selectOne: () => selectOne,
   selectMany: () => selectMany,
+  selectAutocomplete: () => selectAutocomplete,
   promptIO: () => promptIO,
   outro: () => outro,
   note: () => note,
@@ -10187,6 +10167,16 @@ async function selectMany(message, options, initial) {
   handleCancel(result);
   return result;
 }
+async function selectAutocomplete(message, options, opts = {}) {
+  const result = await At({
+    message,
+    options: options.map(toClackOption),
+    placeholder: opts.placeholder,
+    maxItems: opts.maxItems ?? 10
+  });
+  handleCancel(result);
+  return result;
+}
 var log, promptIO;
 var init_prompts = __esm(() => {
   init_dist4();
@@ -10219,7 +10209,8 @@ var init_prompts = __esm(() => {
     confirm,
     text,
     selectOne,
-    selectMany
+    selectMany,
+    selectAutocomplete
   };
 });
 
@@ -10785,6 +10776,58 @@ var init_conflict_fixer = __esm(() => {
   ];
 });
 
+// src/lib/model-picker.ts
+function sortModelsForPicker(models) {
+  return [...new Set(models)].sort((a, b2) => a.localeCompare(b2));
+}
+function modelOptions(models) {
+  return sortModelsForPicker(models).map((model) => ({ label: model, value: model }));
+}
+async function pickModel(prompts, allModels, role) {
+  const copy = ROLE_COPY[role];
+  prompts.note(copy.blurb, copy.title);
+  const options = modelOptions(allModels);
+  if (options.length === 0) {
+    return (await prompts.text(`${copy.pickMessage} (type a provider/model id)`, {
+      placeholder: "e.g. anthropic/claude-haiku-4-5",
+      validate: (value) => value.trim().length === 0 ? "A model id is required" : undefined
+    })).trim();
+  }
+  return prompts.selectAutocomplete(copy.pickMessage, options, {
+    placeholder: copy.placeholder
+  });
+}
+var ROLE_COPY;
+var init_model_picker = __esm(() => {
+  ROLE_COPY = {
+    historian: {
+      title: "Historian",
+      blurb: `The historian runs in the background and condenses older conversation into
+` + `compact summaries, so your context never overflows. It works on one bounded
+` + `chunk at a time and runs often — it does NOT need a frontier model. A smaller,
+` + `cheaper, faster model (a mini / flash / haiku tier) works well here and keeps
+` + "your costs down.",
+      pickMessage: "Select a model for the historian",
+      placeholder: "type to filter (e.g. haiku, flash, mini)…"
+    },
+    dreamer: {
+      title: "Dreamer",
+      blurb: `The dreamer runs periodically (typically overnight) to consolidate and maintain
+` + `your project memories. It is not on the hot path and does NOT need a frontier
+` + "model — a cheaper or local model is a good fit here.",
+      pickMessage: "Select a model for the dreamer",
+      placeholder: "type to filter (e.g. flash, local, glm)…"
+    },
+    sidekick: {
+      title: "Sidekick",
+      blurb: `The sidekick augments your prompt with relevant project context when you run
+` + "/ctx-aug. Fast models are preferred here.",
+      pickMessage: "Select a model for the sidekick",
+      placeholder: "type to filter…"
+    }
+  };
+});
+
 // src/lib/opencode-helpers.ts
 import { execSync } from "node:child_process";
 function isOpenCodeInstalled() {
@@ -10811,55 +10854,6 @@ function getAvailableModels2() {
     return [];
   }
 }
-function buildModelSelection2(allModels, role) {
-  const result = [];
-  const added = new Set;
-  const addIfAvailable = (pattern, hint) => {
-    const matches = allModels.filter((m) => m === pattern || m.endsWith(`/${pattern}`));
-    for (const m of matches) {
-      if (!added.has(m)) {
-        added.add(m);
-        result.push({
-          label: hint ? `${m} — ${hint}` : m,
-          value: m,
-          recommended: result.length === 0
-        });
-      }
-    }
-  };
-  if (role === "historian") {
-    addIfAvailable("github-copilot/claude-sonnet-4.6", "per-request billing");
-    addIfAvailable("anthropic/claude-sonnet-4-6");
-    addIfAvailable("github-copilot/gpt-5.4", "per-request billing");
-    addIfAvailable("openai/gpt-5.4");
-    addIfAvailable("github-copilot/gemini-3.1-pro-preview", "per-request billing");
-    addIfAvailable("opencode-go/minimax-m2.7");
-    addIfAvailable("opencode-go/glm-5");
-  } else if (role === "dreamer") {
-    for (const m of allModels.filter((m2) => m2.startsWith("ollama/"))) {
-      if (!added.has(m)) {
-        added.add(m);
-        result.push({ label: `${m} — local`, value: m, recommended: result.length === 0 });
-      }
-    }
-    addIfAvailable("github-copilot/claude-sonnet-4.6", "per-request billing");
-    addIfAvailable("anthropic/claude-sonnet-4-6");
-    addIfAvailable("github-copilot/gemini-3-flash-preview", "per-request billing");
-    addIfAvailable("opencode-go/glm-5");
-    addIfAvailable("opencode-go/minimax-m2.7");
-  } else if (role === "sidekick") {
-    for (const m of allModels.filter((m2) => m2.startsWith("cerebras/"))) {
-      if (!added.has(m)) {
-        added.add(m);
-        result.push({ label: m, value: m, recommended: result.length === 0 });
-      }
-    }
-    addIfAvailable("opencode/gpt-5-nano");
-    addIfAvailable("github-copilot/gemini-3-flash-preview");
-    addIfAvailable("github-copilot/gpt-5-mini");
-  }
-  return result;
-}
 var init_opencode_helpers = () => {};
 
 // src/commands/setup-opencode.ts
@@ -11008,8 +11002,11 @@ function writeMagicContextConfig(configPath, options) {
   writeFileSync4(configPath, `${import_comment_json4.stringify(config, null, 2)}
 `);
 }
-async function runSetup() {
+async function runSetup(dryRun = false) {
   intro("Magic Context — Setup");
+  if (dryRun) {
+    log.warn("Dry run — no files will be written and no config will be changed.");
+  }
   const s = spinner();
   s.start("Checking OpenCode installation");
   const installed = isOpenCodeInstalled();
@@ -11035,11 +11032,17 @@ async function runSetup() {
   }
   const paths = detectConfigPaths();
   const hadExistingSetup = paths.opencodeConfigFormat !== "none" || existsSync8(paths.magicContextConfig) || paths.tuiConfigFormat !== "none";
-  await resolveDcpConflictBeforeSetup(paths.opencodeConfig, paths.opencodeConfigFormat);
-  addPluginToOpenCodeConfig(paths.opencodeConfig, paths.opencodeConfigFormat);
-  log.success(`Plugin added to ${paths.opencodeConfig}`);
-  log.info("Disabled built-in compaction (auto=false, prune=false)");
-  log.message("Magic Context handles context management — built-in compaction would interfere");
+  if (!dryRun) {
+    await resolveDcpConflictBeforeSetup(paths.opencodeConfig, paths.opencodeConfigFormat);
+  }
+  if (dryRun) {
+    log.message(`[dry-run] would add the plugin to ${paths.opencodeConfig} and disable compaction`);
+  } else {
+    addPluginToOpenCodeConfig(paths.opencodeConfig, paths.opencodeConfigFormat);
+    log.success(`Plugin added to ${paths.opencodeConfig}`);
+    log.info("Disabled built-in compaction (auto=false, prune=false)");
+    log.message("Magic Context handles context management — built-in compaction would interfere");
+  }
   if (hadExistingSetup) {
     const conflicts = detectConflicts(process.cwd());
     if (conflicts.hasConflict) {
@@ -11047,60 +11050,38 @@ async function runSetup() {
       for (const reason of conflicts.reasons) {
         log.message(`  • ${reason}`);
       }
-      const shouldFixConflicts = await confirm("Apply automatic conflict fixes to your OpenCode and OMO config files?", true);
-      if (shouldFixConflicts) {
-        const actions = fixConflicts(process.cwd(), conflicts.conflicts);
-        if (actions.length > 0) {
-          for (const action of actions) {
-            log.success(action);
+      if (dryRun) {
+        log.message("[dry-run] would offer to apply automatic conflict fixes");
+      } else {
+        const shouldFixConflicts = await confirm("Apply automatic conflict fixes to your OpenCode and OMO config files?", true);
+        if (shouldFixConflicts) {
+          const actions = fixConflicts(process.cwd(), conflicts.conflicts);
+          if (actions.length > 0) {
+            for (const action of actions) {
+              log.success(action);
+            }
+          } else {
+            log.info("No additional conflict changes were needed");
           }
         } else {
-          log.info("No additional conflict changes were needed");
+          log.warn("Skipped automatic conflict fixes — Magic Context may remain disabled");
         }
-      } else {
-        log.warn("Skipped automatic conflict fixes — Magic Context may remain disabled");
       }
     }
   }
-  let historianModel = null;
-  if (allModels.length > 0) {
-    const historianOptions = buildModelSelection2(allModels, "historian");
-    if (historianOptions.length > 0) {
-      historianModel = await selectOne("Select a model for historian (background context compressor)", historianOptions);
-      log.success(`Historian: ${historianModel}`);
-    } else {
-      log.info("No suitable historian models found — using built-in fallback chain");
-    }
-  } else {
-    log.info("Skipping model selection — using built-in fallback chain");
-  }
-  log.message("The dreamer runs overnight to consolidate and maintain project memories.");
+  const historianModel = await pickModel(promptIO, allModels, "historian");
+  log.success(`Historian: ${historianModel}`);
   const dreamerEnabled = await confirm("Enable dreamer?", true);
   let dreamerModel = null;
-  if (dreamerEnabled && allModels.length > 0) {
-    const dreamerOptions = buildModelSelection2(allModels, "dreamer");
-    if (dreamerOptions.length > 0) {
-      dreamerModel = await selectOne("Select a model for dreamer (runs in background, local LLMs ideal)", dreamerOptions);
-      log.success(`Dreamer: ${dreamerModel}`);
-    } else {
-      log.info("No suitable dreamer models — using built-in fallback chain");
-    }
-  } else if (dreamerEnabled) {
-    log.info("Using built-in fallback chain for dreamer");
+  if (dreamerEnabled) {
+    dreamerModel = await pickModel(promptIO, allModels, "dreamer");
+    log.success(`Dreamer: ${dreamerModel}`);
   }
-  log.message("Sidekick augments prompts with project context via /ctx-aug command.");
   const sidekickEnabled = await confirm("Enable sidekick?", false);
   let sidekickModel = null;
-  if (sidekickEnabled && allModels.length > 0) {
-    const sidekickOptions = buildModelSelection2(allModels, "sidekick");
-    if (sidekickOptions.length > 0) {
-      sidekickModel = await selectOne("Select a model for sidekick (fast models preferred)", sidekickOptions);
-      log.success(`Sidekick: ${sidekickModel}`);
-    } else {
-      log.info("No suitable sidekick models — using built-in fallback chain");
-    }
-  } else if (sidekickEnabled) {
-    log.info("Using built-in fallback chain for sidekick");
+  if (sidekickEnabled) {
+    sidekickModel = await pickModel(promptIO, allModels, "sidekick");
+    log.success(`Sidekick: ${sidekickModel}`);
   }
   const hasAnthropic = allModels.some((m) => m.startsWith("anthropic/"));
   let claudeMax = false;
@@ -11112,24 +11093,32 @@ async function runSetup() {
       log.success("Cache TTL set to 59m for Anthropic models");
     }
   }
-  writeMagicContextConfig(paths.magicContextConfig, {
-    historianModel,
-    dreamerEnabled,
-    dreamerModel,
-    sidekickEnabled,
-    sidekickModel,
-    claudeMax
-  });
-  log.success(`Config written to ${paths.magicContextConfig}`);
-  addPluginToTuiConfig(paths.tuiConfig, paths.tuiConfigFormat);
-  log.success("TUI sidebar plugin added to tui.json");
+  if (dryRun) {
+    log.message(`[dry-run] would write Magic Context config to ${paths.magicContextConfig}`);
+    log.message("[dry-run] would add the TUI sidebar plugin to tui.json");
+  } else {
+    writeMagicContextConfig(paths.magicContextConfig, {
+      historianModel,
+      dreamerEnabled,
+      dreamerModel,
+      sidekickEnabled,
+      sidekickModel,
+      claudeMax
+    });
+    log.success(`Config written to ${paths.magicContextConfig}`);
+    addPluginToTuiConfig(paths.tuiConfig, paths.tuiConfigFormat);
+    log.success("TUI sidebar plugin added to tui.json");
+  }
   if (paths.omoConfig && !hadExistingSetup) {
     log.warn(`Found oh-my-opencode config: ${paths.omoConfig}`);
     log.message(`These hooks may conflict:
 ` + `  • context-window-monitor
 ` + `  • preemptive-compaction
 ` + "  • anthropic-context-window-limit-recovery");
-    const shouldDisable = await confirm("Disable these hooks in oh-my-opencode?", true);
+    const shouldDisable = dryRun ? false : await confirm("Disable these hooks in oh-my-opencode?", true);
+    if (dryRun) {
+      log.message("[dry-run] would offer to disable conflicting oh-my-opencode hooks");
+    }
     if (shouldDisable) {
       const actions = fixConflicts(process.cwd(), {
         compactionAuto: false,
@@ -11154,7 +11143,11 @@ async function runSetup() {
     sidekickEnabled ? `Sidekick: enabled${sidekickModel ? ` (${sidekickModel})` : ""}` : "Sidekick: disabled"
   ].join(`
 `);
-  note(summary, "Configuration");
+  note(summary, dryRun ? "Configuration (dry run — not written)" : "Configuration");
+  if (dryRun) {
+    outro("Dry run complete — nothing was written.");
+    return 0;
+  }
   const shouldStar = await confirm("★ Star the repo on GitHub?", true);
   if (shouldStar) {
     try {
@@ -11177,6 +11170,7 @@ var init_setup_opencode = __esm(() => {
   init_conflict_detector();
   init_conflict_fixer();
   init_opencode();
+  init_model_picker();
   init_opencode_helpers();
   init_paths();
   init_prompts();
@@ -11319,10 +11313,6 @@ function writeMagicContextConfig2(configPath, options) {
   writeFileSync5(configPath, `${import_comment_json5.stringify(config, null, 2)}
 `);
 }
-async function chooseModel(prompts, allModels, role, message) {
-  const options = buildModelSelection(allModels, role);
-  return prompts.selectOne(message, options);
-}
 async function chooseEmbedding(prompts) {
   const provider = await prompts.selectOne("Select embedding provider", [
     {
@@ -11383,18 +11373,25 @@ Run \`pi update --self\` (or \`npm install -g @earendil-works/pi-coding-agent@la
   spinner2.start("Fetching available Pi models");
   const allModels = env.getAvailableModels(pi.path);
   spinner2.stop(`Found ${allModels.length} model choices`);
+  const dryRun = options.dryRun === true;
+  if (dryRun) {
+    prompts.log.warn("Dry run — no files will be written and no package will be registered.");
+  }
   const settingsPath = env.paths.getPiUserExtensionsPath();
   const configPath = env.paths.getPiUserConfigPath();
   const configurePi = await prompts.confirm("Configure Pi to load Magic Context?", true);
-  let packageAdded = false;
   if (configurePi) {
-    packageAdded = writePiSettingsPackage(settingsPath);
-    prompts.log.success(packageAdded ? `Added ${PI_PACKAGE_SOURCE} to ${settingsPath}` : `Magic Context package already present in ${settingsPath}`);
-    prompts.log.message("This mirrors `pi install npm:@cortexkit/pi-magic-context` without running installs during setup verification.");
+    if (dryRun) {
+      prompts.log.message(`[dry-run] would add ${PI_PACKAGE_SOURCE} to ${settingsPath}`);
+    } else {
+      const packageAdded = writePiSettingsPackage(settingsPath);
+      prompts.log.success(packageAdded ? `Added ${PI_PACKAGE_SOURCE} to ${settingsPath}` : `Magic Context package already present in ${settingsPath}`);
+      prompts.log.message("This mirrors `pi install npm:@cortexkit/pi-magic-context` without running installs during setup verification.");
+    }
   } else {
     prompts.log.warn("Skipped Pi package registration; install manually with `pi install npm:@cortexkit/pi-magic-context`.");
   }
-  const historianModel = await chooseModel(prompts, allModels, "historian", "Select a model for historian (background context compressor)");
+  const historianModel = await pickModel(prompts, allModels, "historian");
   let historianThinkingLevel;
   if (historianModel.startsWith("github-copilot/")) {
     prompts.log.warn(`GitHub Copilot reasoning models require an explicit thinking level.
@@ -11414,36 +11411,41 @@ Run \`pi update --self\` (or \`npm install -g @earendil-works/pi-coding-agent@la
     ]);
   }
   const dreamerEnabled = await prompts.confirm("Enable dreamer for overnight memory maintenance?", true);
-  const dreamerModel = await chooseModel(prompts, allModels, "dreamer", "Select a model for dreamer (overnight memory maintenance)");
+  const dreamerModel = dreamerEnabled ? await pickModel(prompts, allModels, "dreamer") : undefined;
   const sidekickEnabled = await prompts.confirm("Enable sidekick for /ctx-aug?", false);
-  const sidekickModel = sidekickEnabled ? await chooseModel(prompts, allModels, "sidekick", "Select a model for sidekick (fast models preferred)") : undefined;
+  const sidekickModel = sidekickEnabled ? await pickModel(prompts, allModels, "sidekick") : undefined;
   const embedding = await chooseEmbedding(prompts);
-  writeMagicContextConfig2(configPath, {
-    historianModel,
-    historianThinkingLevel,
-    dreamerEnabled,
-    dreamerModel,
-    sidekickEnabled,
-    sidekickModel,
-    embedding
-  });
-  prompts.log.success(`Config written to ${configPath}`);
+  if (dryRun) {
+    prompts.log.message(`[dry-run] would write Magic Context config to ${configPath}`);
+  } else {
+    writeMagicContextConfig2(configPath, {
+      historianModel,
+      historianThinkingLevel,
+      dreamerEnabled,
+      dreamerModel,
+      sidekickEnabled,
+      sidekickModel,
+      embedding
+    });
+    prompts.log.success(`Config written to ${configPath}`);
+  }
   const thinkingLevelSuffix = historianThinkingLevel ? ` (thinking: ${historianThinkingLevel})` : "";
   const summary = [
     `Pi settings: ${configurePi ? settingsPath : "skipped"}`,
     `Magic Context config: ${configPath}`,
     `Historian: ${historianModel}${thinkingLevelSuffix}`,
-    `Dreamer: ${dreamerModel} (${dreamerEnabled ? "enabled" : "disabled"})`,
+    `Dreamer: ${dreamerEnabled ? dreamerModel : "disabled"}`,
     sidekickEnabled ? `Sidekick: ${sidekickModel}` : "Sidekick: disabled",
     `Embedding: ${embedding.provider}${"model" in embedding ? ` (${embedding.model})` : ""}`
   ].join(`
 `);
-  prompts.note(summary, "Configuration");
-  prompts.outro("Start a Pi session and try /ctx-aug");
+  prompts.note(summary, dryRun ? "Configuration (dry run — not written)" : "Configuration");
+  prompts.outro(dryRun ? "Dry run complete — nothing was written." : "Start a Pi session and try /ctx-aug");
   return 0;
 }
 var import_comment_json5, DEFAULT_ENV;
 var init_setup_pi = __esm(() => {
+  init_model_picker();
   init_paths();
   init_pi_helpers();
   init_pi_package_entry();
@@ -11466,7 +11468,8 @@ __export(exports_setup, {
   runSetup: () => runSetup3
 });
 async function runSetup3(argv) {
-  intro("Magic Context setup");
+  const dryRun = argv.includes("--dry-run");
+  intro(dryRun ? "Magic Context setup (dry run)" : "Magic Context setup");
   const adapters = await resolveAdaptersForCommand(argv, {
     allowMulti: true,
     verb: "setup"
@@ -11483,24 +11486,25 @@ async function runSetup3(argv) {
       anyFailure = true;
       continue;
     }
-    const code = await dispatchSetup(adapter);
+    const code = await dispatchSetup(adapter, dryRun);
     if (code !== 0)
       anyFailure = true;
-    printNextSteps(adapter);
+    if (!dryRun)
+      printNextSteps(adapter);
   }
   if (anyFailure) {
     outro("Setup finished with warnings — see above.");
     return 1;
   }
-  outro("Done.");
+  outro(dryRun ? "Dry run done — no changes were made." : "Done.");
   return 0;
 }
-async function dispatchSetup(adapter) {
+async function dispatchSetup(adapter, dryRun) {
   switch (adapter.kind) {
     case "opencode":
-      return runSetup();
+      return runSetup(dryRun);
     case "pi":
-      return runSetup2();
+      return runSetup2({ dryRun });
   }
 }
 function printNextSteps(adapter) {
@@ -12224,6 +12228,7 @@ var init_storage_meta_shared = __esm(() => {
     "cachedM0Bytes",
     "cachedM1Bytes",
     "cachedM0ProjectMemoryEpoch",
+    "cachedM0WorkspaceFingerprint",
     "cachedM0ProjectUserProfileVersion",
     "cachedM0MaxCompartmentSeq",
     "cachedM0MaxMemoryId",
@@ -145370,6 +145375,35 @@ function initializeDatabase(db) {
     );
     CREATE INDEX IF NOT EXISTS idx_compartments_session ON compartments(session_id);
 
+    CREATE TABLE IF NOT EXISTS compartment_chunk_embeddings (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      compartment_id INTEGER NOT NULL REFERENCES compartments(id) ON DELETE CASCADE,
+      session_id TEXT NOT NULL,
+      project_path TEXT NOT NULL,
+      harness TEXT NOT NULL DEFAULT 'opencode',
+      window_index INTEGER NOT NULL DEFAULT 0,
+      start_ordinal INTEGER NOT NULL,
+      end_ordinal INTEGER NOT NULL,
+      chunk_hash TEXT NOT NULL,
+      model_id TEXT NOT NULL,
+      dims INTEGER NOT NULL,
+      vector BLOB NOT NULL,
+      created_at INTEGER NOT NULL,
+      UNIQUE(compartment_id, window_index)
+    );
+    CREATE INDEX IF NOT EXISTS idx_cce_session ON compartment_chunk_embeddings(session_id);
+    CREATE INDEX IF NOT EXISTS idx_cce_project_model ON compartment_chunk_embeddings(project_path, model_id);
+
+    CREATE TABLE IF NOT EXISTS session_projects (
+      session_id TEXT NOT NULL,
+      harness TEXT NOT NULL DEFAULT 'opencode',
+      project_path TEXT NOT NULL,
+      updated_at INTEGER NOT NULL,
+      PRIMARY KEY(session_id, harness)
+    );
+    CREATE INDEX IF NOT EXISTS idx_session_projects_project
+      ON session_projects(project_path);
+
     CREATE TABLE IF NOT EXISTS compartment_events (
       id INTEGER PRIMARY KEY AUTOINCREMENT,
       session_id TEXT NOT NULL,
@@ -145555,6 +145589,25 @@ CREATE INDEX IF NOT EXISTS idx_dream_queue_pending ON dream_queue(started_at, en
       rekeyed_at INTEGER NOT NULL
     );
 
+    CREATE TABLE IF NOT EXISTS workspaces (
+      id INTEGER PRIMARY KEY AUTOINCREMENT,
+      name TEXT NOT NULL UNIQUE,
+      created_at INTEGER NOT NULL,
+      updated_at INTEGER NOT NULL,
+      share_categories TEXT NOT NULL DEFAULT '["CONSTRAINTS"]'
+    );
+
+    CREATE TABLE IF NOT EXISTS workspace_members (
+      workspace_id INTEGER NOT NULL REFERENCES workspaces(id) ON DELETE CASCADE,
+      project_path TEXT NOT NULL,
+      display_name TEXT NOT NULL,
+      display_path TEXT NOT NULL,
+      added_at INTEGER NOT NULL,
+      PRIMARY KEY (workspace_id, project_path)
+    );
+    CREATE UNIQUE INDEX IF NOT EXISTS idx_workspace_member_unique ON workspace_members(project_path);
+    CREATE UNIQUE INDEX IF NOT EXISTS idx_workspace_member_name ON workspace_members(workspace_id, display_name);
+
     CREATE TABLE IF NOT EXISTS v22_backfill_failures (
       id INTEGER PRIMARY KEY AUTOINCREMENT,
       table_name TEXT NOT NULL,
@@ -145666,6 +145719,7 @@ CREATE INDEX IF NOT EXISTS idx_dream_queue_pending ON dream_queue(started_at, en
       deferred_execute_state TEXT,
       cached_m0_bytes BLOB,
       cached_m0_project_memory_epoch INTEGER,
+      cached_m0_workspace_fingerprint TEXT,
       cached_m0_project_user_profile_version INTEGER,
       cached_m0_max_compartment_seq INTEGER,
       cached_m0_max_memory_id INTEGER,
@@ -145824,6 +145878,7 @@ CREATE INDEX IF NOT EXISTS idx_dream_queue_pending ON dream_queue(started_at, en
   ensureColumn(db, "session_meta", "cleared_reasoning_through_tag", "INTEGER DEFAULT 0");
   ensureColumn(db, "session_meta", "stripped_placeholder_ids", "TEXT DEFAULT ''");
   ensureColumn(db, "session_meta", "stale_reduce_stripped_ids", "TEXT DEFAULT ''");
+  ensureColumn(db, "session_meta", "processed_image_stripped_ids", "TEXT DEFAULT ''");
   ensureColumn(db, "compartments", "start_message_id", "TEXT DEFAULT ''");
   ensureColumn(db, "compartments", "end_message_id", "TEXT DEFAULT ''");
   ensureColumn(db, "memory_embeddings", "model_id", "TEXT");
@@ -145877,6 +145932,7 @@ CREATE INDEX IF NOT EXISTS idx_dream_queue_pending ON dream_queue(started_at, en
   ensureColumn(db, "memories", "importance", "INTEGER");
   ensureColumn(db, "session_meta", "cached_m0_bytes", "BLOB");
   ensureColumn(db, "session_meta", "cached_m0_project_memory_epoch", "INTEGER");
+  ensureColumn(db, "session_meta", "cached_m0_workspace_fingerprint", "TEXT");
   ensureColumn(db, "session_meta", "cached_m0_project_user_profile_version", "INTEGER");
   ensureColumn(db, "session_meta", "cached_m0_max_compartment_seq", "INTEGER");
   ensureColumn(db, "session_meta", "cached_m0_max_memory_id", "INTEGER");
@@ -145908,6 +145964,15 @@ CREATE INDEX IF NOT EXISTS idx_dream_queue_pending ON dream_queue(started_at, en
         project_user_profile_version INTEGER NOT NULL DEFAULT 0,
         updated_at INTEGER NOT NULL DEFAULT 0
       );
+      CREATE TABLE IF NOT EXISTS session_projects (
+        session_id TEXT NOT NULL,
+        harness TEXT NOT NULL DEFAULT 'opencode',
+        project_path TEXT NOT NULL,
+        updated_at INTEGER NOT NULL,
+        PRIMARY KEY(session_id, harness)
+      );
+      CREATE INDEX IF NOT EXISTS idx_session_projects_project
+        ON session_projects(project_path);
       CREATE TABLE IF NOT EXISTS m0_mutation_log (
         id INTEGER PRIMARY KEY AUTOINCREMENT,
         session_id TEXT NOT NULL,
@@ -145935,6 +146000,23 @@ CREATE INDEX IF NOT EXISTS idx_dream_queue_pending ON dream_queue(started_at, en
         new_project_path TEXT NOT NULL,
         rekeyed_at INTEGER NOT NULL
       );
+      CREATE TABLE IF NOT EXISTS workspaces (
+        id INTEGER PRIMARY KEY AUTOINCREMENT,
+        name TEXT NOT NULL UNIQUE,
+        created_at INTEGER NOT NULL,
+        updated_at INTEGER NOT NULL,
+        share_categories TEXT NOT NULL DEFAULT '["CONSTRAINTS"]'
+      );
+      CREATE TABLE IF NOT EXISTS workspace_members (
+        workspace_id INTEGER NOT NULL REFERENCES workspaces(id) ON DELETE CASCADE,
+        project_path TEXT NOT NULL,
+        display_name TEXT NOT NULL,
+        display_path TEXT NOT NULL,
+        added_at INTEGER NOT NULL,
+        PRIMARY KEY (workspace_id, project_path)
+      );
+      CREATE UNIQUE INDEX IF NOT EXISTS idx_workspace_member_unique ON workspace_members(project_path);
+      CREATE UNIQUE INDEX IF NOT EXISTS idx_workspace_member_name ON workspace_members(workspace_id, display_name);
       CREATE TABLE IF NOT EXISTS v22_backfill_failures (
         id INTEGER PRIMARY KEY AUTOINCREMENT,
         table_name TEXT NOT NULL,
@@ -145956,6 +146038,7 @@ CREATE INDEX IF NOT EXISTS idx_dream_queue_pending ON dream_queue(started_at, en
   ensureColumn(db, "recomp_compartments", "harness", "TEXT NOT NULL DEFAULT 'opencode'");
   ensureColumn(db, "recomp_facts", "harness", "TEXT NOT NULL DEFAULT 'opencode'");
   ensureColumn(db, "message_history_index", "harness", "TEXT NOT NULL DEFAULT 'opencode'");
+  ensureColumn(db, "workspaces", "share_categories", `TEXT NOT NULL DEFAULT '["CONSTRAINTS"]'`);
 }
 function healAllNullColumns(db) {
   healNullTextColumns(db);
@@ -145993,6 +146076,7 @@ function healNullTextColumns(db) {
     ["system_prompt_hash", ""],
     ["stripped_placeholder_ids", ""],
     ["stale_reduce_stripped_ids", ""],
+    ["processed_image_stripped_ids", ""],
     ["memory_block_cache", ""],
     ["memory_block_ids", ""],
     ["compaction_marker_state", ""],
@@ -146037,7 +146121,7 @@ function healNullIntegerColumns(db) {
   }
 }
 function ensureColumn(db, table, column, definition) {
-  if (!/^[a-z][a-z0-9_]*$/.test(table) || !/^[a-z][a-z0-9_]*$/.test(column) || !/^[A-Z0-9_'(),[\]\s]+$/i.test(definition)) {
+  if (!/^[a-z][a-z0-9_]*$/.test(table) || !/^[a-z][a-z0-9_]*$/.test(column) || !/^[A-Z0-9_"'(),[\]\s]+$/i.test(definition)) {
     throw new Error(`Unsafe schema identifier: ${table}.${column} ${definition}`);
   }
   const rows = db.prepare(`PRAGMA table_info(${table})`).all();
@@ -146129,7 +146213,7 @@ function closeDatabase() {
     }
   }
 }
-var databases, persistenceByDatabase, persistenceErrorByDatabase, lastSchemaFenceRejection = null, LATEST_SUPPORTED_VERSION = 32, sqlitePragmaConfig, CHANNEL2_CLAIM_TTL_MS = 120000;
+var databases, persistenceByDatabase, persistenceErrorByDatabase, lastSchemaFenceRejection = null, LATEST_SUPPORTED_VERSION = 36, sqlitePragmaConfig, CHANNEL2_CLAIM_TTL_MS = 120000;
 var init_storage_db = __esm(async () => {
   init_data_path();
   init_logger();
@@ -146149,10 +146233,263 @@ var init_storage_db = __esm(async () => {
   };
 });
 
+// ../plugin/src/features/magic-context/memory/constants.ts
+var V2_MEMORY_CATEGORIES, CATEGORY_PRIORITY, MEMORY_CATEGORY_ORDER_UNKNOWN = 99, MEMORY_CATEGORY_ORDER_PRIORITY, MEMORY_CATEGORY_ORDER_SQL, CATEGORY_DEFAULT_TTL;
+var init_constants = __esm(() => {
+  V2_MEMORY_CATEGORIES = [
+    "PROJECT_RULES",
+    "ARCHITECTURE",
+    "CONSTRAINTS",
+    "CONFIG_VALUES",
+    "NAMING"
+  ];
+  CATEGORY_PRIORITY = [
+    "PROJECT_RULES",
+    "ARCHITECTURE",
+    "CONSTRAINTS",
+    "CONFIG_VALUES",
+    "NAMING",
+    "USER_DIRECTIVES",
+    "USER_PREFERENCES",
+    "CONFIG_DEFAULTS",
+    "ARCHITECTURE_DECISIONS",
+    "ENVIRONMENT",
+    "WORKFLOW_RULES",
+    "KNOWN_ISSUES"
+  ];
+  MEMORY_CATEGORY_ORDER_PRIORITY = CATEGORY_PRIORITY.reduce((acc, category, index) => {
+    acc[category] = index;
+    return acc;
+  }, {});
+  MEMORY_CATEGORY_ORDER_SQL = `CASE category ${CATEGORY_PRIORITY.map((category, index) => `WHEN '${category}' THEN ${index}`).join(" ")} ELSE ${MEMORY_CATEGORY_ORDER_UNKNOWN} END`;
+  CATEGORY_DEFAULT_TTL = {
+    WORKFLOW_RULES: 90 * 24 * 60 * 60 * 1000,
+    KNOWN_ISSUES: 30 * 24 * 60 * 60 * 1000
+  };
+});
+
+// ../plugin/src/features/magic-context/memory/project-identity.ts
+import { execFileSync as execFileSync3 } from "node:child_process";
+import { createHash } from "node:crypto";
+import { statSync as statSync3 } from "node:fs";
+import path3 from "node:path";
+function asError(error) {
+  return error instanceof Error ? error : undefined;
+}
+function getErrorCode(error) {
+  if (error === null || typeof error !== "object" || !("code" in error)) {
+    return;
+  }
+  const code = error.code;
+  return typeof code === "string" ? code : undefined;
+}
+function getErrorSignal(error) {
+  if (error === null || typeof error !== "object" || !("signal" in error)) {
+    return;
+  }
+  const signal = error.signal;
+  return typeof signal === "string" ? signal : undefined;
+}
+function getErrorKilled(error) {
+  if (error === null || typeof error !== "object" || !("killed" in error)) {
+    return false;
+  }
+  return error.killed === true;
+}
+function getErrorStderr(error) {
+  if (error === null || typeof error !== "object" || !("stderr" in error)) {
+    return "";
+  }
+  const stderr = error.stderr;
+  if (typeof stderr === "string") {
+    return stderr;
+  }
+  if (Buffer.isBuffer(stderr)) {
+    return stderr.toString("utf8");
+  }
+  return "";
+}
+function directoryFallback(directory) {
+  const canonical = path3.resolve(directory);
+  const hash = createHash("md5").update(canonical, "utf8").digest("hex").slice(0, 12);
+  return `dir:${hash}`;
+}
+function assertDirectoryUsable(canonicalDirectory, rawDirectory) {
+  try {
+    const stat = statSync3(canonicalDirectory);
+    if (!stat.isDirectory()) {
+      throw new ProjectIdentityError("unknown", rawDirectory, `Project path is not a directory: ${canonicalDirectory}`);
+    }
+  } catch (error) {
+    if (error instanceof ProjectIdentityError) {
+      throw error;
+    }
+    const code = getErrorCode(error);
+    if (code === "EACCES" || code === "EPERM") {
+      throw new ProjectIdentityError("permission_denied", rawDirectory, `Permission denied while accessing project directory: ${canonicalDirectory}`, asError(error));
+    }
+    throw new ProjectIdentityError("unknown", rawDirectory, `Unable to access project directory: ${canonicalDirectory}`, asError(error));
+  }
+}
+function isGitTimeoutError(error) {
+  const code = getErrorCode(error);
+  const signal = getErrorSignal(error);
+  return code === "ETIMEDOUT" || signal === "SIGTERM" || signal === "SIGKILL" || getErrorKilled(error);
+}
+function classifyGitError(error, rawDirectory) {
+  if (isGitTimeoutError(error)) {
+    return new ProjectIdentityError("git_timeout", rawDirectory, `git rev-list timed out after ${GIT_TIMEOUT_MS}ms`, asError(error));
+  }
+  const code = getErrorCode(error);
+  if (code === "ENOENT") {
+    return new ProjectIdentityError("git_missing", rawDirectory, "git binary is not available in PATH", asError(error));
+  }
+  if (code === "EACCES" || code === "EPERM") {
+    return new ProjectIdentityError("permission_denied", rawDirectory, "Permission denied while spawning git", asError(error));
+  }
+  const stderr = getErrorStderr(error).toLowerCase();
+  if (stderr.includes("not a git repository") || stderr.includes("does not have any commits yet") || stderr.includes("ambiguous argument 'head'") || stderr.includes("unknown revision or path")) {
+    return new ProjectIdentityError("not_git_repo", rawDirectory, "Directory has no git root commit; caller may use directory fallback", asError(error));
+  }
+  return new ProjectIdentityError("unknown", rawDirectory, "git rev-list failed while resolving project identity", asError(error));
+}
+function resolveProjectIdentityStrict(directory) {
+  const canonical = path3.resolve(directory);
+  const cached = identityCache.get(canonical);
+  if (cached !== undefined) {
+    return cached;
+  }
+  assertDirectoryUsable(canonical, directory);
+  let output;
+  try {
+    output = execFileSync3("git", ["rev-list", "--max-parents=0", "HEAD"], {
+      cwd: canonical,
+      encoding: "utf8",
+      env: { ...process.env, LC_ALL: "C", LANG: "C" },
+      stdio: ["ignore", "pipe", "pipe"],
+      timeout: GIT_TIMEOUT_MS
+    });
+  } catch (error) {
+    throw classifyGitError(error, directory);
+  }
+  const firstLine = output.split(`
+`)[0]?.trim() ?? "";
+  const rootCommit = firstLine.slice(0, 64);
+  if (rootCommit.length < 7) {
+    throw new ProjectIdentityError("unknown", directory, "git rev-list returned no valid root commit hash");
+  }
+  const identity = `git:${rootCommit}`;
+  identityCache.set(canonical, identity);
+  return identity;
+}
+function shouldUseDirectoryFallback(error) {
+  return error.errorClass === "not_git_repo" || error.errorClass === "unknown" && error.message.startsWith("Unable to access project directory:");
+}
+function resolveProjectIdentity(directory) {
+  const canonical = path3.resolve(directory);
+  const cachedFallback = directoryFallbackCache.get(canonical);
+  if (cachedFallback !== undefined) {
+    if (!hasGitDir(canonical)) {
+      return cachedFallback;
+    }
+    directoryFallbackCache.delete(canonical);
+  }
+  try {
+    return resolveProjectIdentityStrict(directory);
+  } catch (error) {
+    if (error instanceof ProjectIdentityError && shouldUseDirectoryFallback(error)) {
+      const fallback = directoryFallback(canonical);
+      if (!hasGitDir(canonical)) {
+        directoryFallbackCache.set(canonical, fallback);
+      }
+      return fallback;
+    }
+    throw error;
+  }
+}
+function hasGitDir(canonical) {
+  try {
+    statSync3(path3.join(canonical, ".git"));
+    return true;
+  } catch {
+    return false;
+  }
+}
+var GIT_TIMEOUT_MS = 5000, identityCache, directoryFallbackCache, ProjectIdentityError;
+var init_project_identity = __esm(() => {
+  identityCache = new Map;
+  directoryFallbackCache = new Map;
+  ProjectIdentityError = class ProjectIdentityError extends Error {
+    errorClass;
+    rawDirectory;
+    constructor(errorClass, rawDirectory, message, cause) {
+      super(message);
+      this.name = "ProjectIdentityError";
+      this.errorClass = errorClass;
+      this.rawDirectory = rawDirectory;
+      if (cause) {
+        this.cause = cause;
+      }
+    }
+  };
+});
+
+// ../plugin/src/features/magic-context/project-identity.ts
+var init_project_identity2 = __esm(() => {
+  init_project_identity();
+});
+
+// ../plugin/src/features/magic-context/workspaces.ts
+function uniqueSorted(values) {
+  return [...new Set(values)].sort((left, right) => left.localeCompare(right));
+}
+function isInTransaction(db) {
+  const candidate = db;
+  return candidate.inTransaction === true || candidate.isTransaction === true;
+}
+function bumpEpochRows(db, identities, now) {
+  const stmt2 = db.prepare(`INSERT INTO project_state
+            (project_path, project_memory_epoch, project_user_profile_version, updated_at)
+         VALUES (?, 1, 0, ?)
+         ON CONFLICT(project_path) DO UPDATE SET
+            project_memory_epoch = project_memory_epoch + 1,
+            updated_at = excluded.updated_at`);
+  for (const identity of uniqueSorted(identities)) {
+    stmt2.run(identity, now);
+  }
+}
+function bumpEpochsForWorkspaceMemberSet(db, identities, now = Date.now()) {
+  const run = () => bumpEpochRows(db, identities, now);
+  if (isInTransaction(db)) {
+    run();
+    return;
+  }
+  db.exec("BEGIN IMMEDIATE");
+  try {
+    run();
+    db.exec("COMMIT");
+  } catch (error) {
+    try {
+      db.exec("ROLLBACK");
+    } catch {}
+    throw error;
+  }
+}
+var VALID_SHARE_CATEGORIES;
+var init_workspaces = __esm(() => {
+  init_constants();
+  init_project_identity2();
+  VALID_SHARE_CATEGORIES = new Set(V2_MEMORY_CATEGORIES);
+});
+
 // ../plugin/src/features/magic-context/migrations.ts
 function tableExists(db, name2) {
   return Boolean(db.prepare("SELECT name FROM sqlite_master WHERE type='table' AND name = ?").get(name2));
 }
+function columnExists(db, table, column) {
+  const rows = db.prepare(`PRAGMA table_info(${table})`).all();
+  return rows.some((row) => row.name === column);
+}
 function ensureMigrationsTable(db) {
   db.exec(`
 		CREATE TABLE IF NOT EXISTS schema_migrations (
@@ -146221,6 +146558,7 @@ function runMigrations(db) {
 var MIGRATIONS, LATEST_MIGRATION_VERSION;
 var init_migrations = __esm(async () => {
   init_logger();
+  init_workspaces();
   await init_storage_db();
   MIGRATIONS = [
     {
@@ -147018,6 +147356,156 @@ var init_migrations = __esm(async () => {
         db.prepare("UPDATE session_meta SET force_emergency_bypass_used = 0 WHERE force_emergency_bypass_used IS NULL").run();
         db.prepare("UPDATE session_meta SET last_usage_context_limit = 0 WHERE last_usage_context_limit IS NULL").run();
       }
+    },
+    {
+      version: 33,
+      description: "Compartment chunk embeddings for semantic message-history search",
+      up: (db) => {
+        db.exec(`
+                CREATE TABLE IF NOT EXISTS compartment_chunk_embeddings (
+                    id INTEGER PRIMARY KEY AUTOINCREMENT,
+                    compartment_id INTEGER NOT NULL REFERENCES compartments(id) ON DELETE CASCADE,
+                    session_id TEXT NOT NULL,
+                    project_path TEXT NOT NULL,
+                    harness TEXT NOT NULL DEFAULT 'opencode',
+                    window_index INTEGER NOT NULL DEFAULT 0,
+                    start_ordinal INTEGER NOT NULL,
+                    end_ordinal INTEGER NOT NULL,
+                    chunk_hash TEXT NOT NULL,
+                    model_id TEXT NOT NULL,
+                    dims INTEGER NOT NULL,
+                    vector BLOB NOT NULL,
+                    created_at INTEGER NOT NULL,
+                    UNIQUE(compartment_id, window_index)
+                );
+                CREATE INDEX IF NOT EXISTS idx_cce_session
+                    ON compartment_chunk_embeddings(session_id);
+                CREATE INDEX IF NOT EXISTS idx_cce_project_model
+                    ON compartment_chunk_embeddings(project_path, model_id);
+            `);
+      }
+    },
+    {
+      version: 34,
+      description: "workspace tables and m[0] workspace fingerprint cache reset",
+      up: (db) => {
+        db.exec(`
+                CREATE TABLE IF NOT EXISTS workspaces (
+                    id INTEGER PRIMARY KEY AUTOINCREMENT,
+                    name TEXT NOT NULL UNIQUE,
+                    created_at INTEGER NOT NULL,
+                    updated_at INTEGER NOT NULL
+                );
+                CREATE TABLE IF NOT EXISTS workspace_members (
+                    workspace_id INTEGER NOT NULL REFERENCES workspaces(id) ON DELETE CASCADE,
+                    project_path TEXT NOT NULL,
+                    display_name TEXT NOT NULL,
+                    display_path TEXT NOT NULL,
+                    added_at INTEGER NOT NULL,
+                    PRIMARY KEY (workspace_id, project_path)
+                );
+                CREATE UNIQUE INDEX IF NOT EXISTS idx_workspace_member_unique
+                    ON workspace_members(project_path);
+                CREATE UNIQUE INDEX IF NOT EXISTS idx_workspace_member_name
+                    ON workspace_members(workspace_id, display_name);
+            `);
+        const hasSessionMeta = db.prepare("SELECT 1 FROM sqlite_master WHERE type='table' AND name='session_meta' LIMIT 1").get();
+        if (!hasSessionMeta)
+          return;
+        ensureColumn(db, "session_meta", "cached_m0_workspace_fingerprint", "TEXT");
+        const columns = new Set(db.prepare("PRAGMA table_info(session_meta)").all().map((column) => column.name));
+        const clears = [
+          ["cached_m0_bytes", null],
+          ["cached_m1_bytes", null],
+          ["cached_m0_project_memory_epoch", null],
+          ["cached_m0_workspace_fingerprint", null],
+          ["cached_m0_project_user_profile_version", null],
+          ["cached_m0_max_compartment_seq", null],
+          ["cached_m0_max_memory_id", null],
+          ["cached_m0_max_mutation_id", null],
+          ["cached_m0_max_memory_mutation_id", null],
+          ["cached_m0_project_docs_hash", null],
+          ["cached_m0_materialized_at", null],
+          ["cached_m0_session_facts_version", null],
+          ["cached_m0_upgrade_state", null],
+          ["cached_m0_system_hash", null],
+          ["cached_m0_tool_set_hash", null],
+          ["cached_m0_model_key", null],
+          ["cached_m0_last_baseline_end_message_id", null],
+          ["memory_block_cache", ""],
+          ["memory_block_ids", ""],
+          ["memory_block_count", 0]
+        ];
+        const setClauses = [];
+        const values = [];
+        for (const [column, value] of clears) {
+          if (!columns.has(column))
+            continue;
+          setClauses.push(`${column} = ?`);
+          values.push(value);
+        }
+        if (setClauses.length > 0) {
+          db.prepare(`UPDATE session_meta SET ${setClauses.join(", ")}`).run(...values);
+        }
+      }
+    },
+    {
+      version: 35,
+      description: "workspace per-category share defaults and epoch refresh",
+      up: (db) => {
+        db.exec(`
+                CREATE TABLE IF NOT EXISTS workspaces (
+                    id INTEGER PRIMARY KEY AUTOINCREMENT,
+                    name TEXT NOT NULL UNIQUE,
+                    created_at INTEGER NOT NULL,
+                    updated_at INTEGER NOT NULL,
+                    share_categories TEXT NOT NULL DEFAULT '["CONSTRAINTS"]'
+                );
+            `);
+        if (!columnExists(db, "workspaces", "share_categories")) {
+          db.exec(`ALTER TABLE workspaces ADD COLUMN share_categories TEXT NOT NULL DEFAULT '["CONSTRAINTS"]'`);
+        }
+        db.prepare(`UPDATE workspaces
+                    SET share_categories = '["CONSTRAINTS"]'
+                  WHERE share_categories IS NULL OR share_categories = ''`).run();
+        if (!tableExists(db, "workspace_members"))
+          return;
+        const rows = db.prepare(`SELECT DISTINCT project_path AS identity
+                       FROM workspace_members
+                      WHERE project_path IS NOT NULL AND project_path <> ''
+                      ORDER BY project_path ASC`).all();
+        const identities = rows.map((row) => typeof row.identity === "string" ? row.identity : "").filter((identity) => identity.length > 0);
+        if (identities.length > 0) {
+          bumpEpochsForWorkspaceMemberSet(db, identities, Date.now());
+        }
+      }
+    },
+    {
+      version: 36,
+      description: "session project ownership map for compartment chunk backfill scoping",
+      up: (db) => {
+        db.exec(`
+                CREATE TABLE IF NOT EXISTS session_projects (
+                    session_id TEXT NOT NULL,
+                    harness TEXT NOT NULL DEFAULT 'opencode',
+                    project_path TEXT NOT NULL,
+                    updated_at INTEGER NOT NULL,
+                    PRIMARY KEY(session_id, harness)
+                );
+                CREATE INDEX IF NOT EXISTS idx_session_projects_project
+                    ON session_projects(project_path);
+            `);
+        const hasChunkTable = db.prepare("SELECT 1 FROM sqlite_master WHERE type='table' AND name='compartment_chunk_embeddings'").get();
+        if (hasChunkTable) {
+          db.exec(`
+                    INSERT OR IGNORE INTO session_projects (session_id, harness, project_path, updated_at)
+                    SELECT session_id, harness, MIN(project_path), 0
+                    FROM compartment_chunk_embeddings
+                    GROUP BY session_id, harness
+                    HAVING COUNT(DISTINCT project_path) = 1;
+                `);
+        }
+      }
     }
   ];
   LATEST_MIGRATION_VERSION = MIGRATIONS.reduce((max, m) => Math.max(max, m.version), 0);
@@ -147030,177 +147518,6 @@ var init_project_docs_hash = __esm(() => {
   MAX_PROJECT_DOC_BYTES = 256 * 1024;
   docsCache = new Map;
 });
-
-// ../plugin/src/features/magic-context/memory/project-identity.ts
-import { execFileSync as execFileSync3 } from "node:child_process";
-import { createHash } from "node:crypto";
-import { statSync as statSync3 } from "node:fs";
-import path3 from "node:path";
-function asError(error) {
-  return error instanceof Error ? error : undefined;
-}
-function getErrorCode(error) {
-  if (error === null || typeof error !== "object" || !("code" in error)) {
-    return;
-  }
-  const code = error.code;
-  return typeof code === "string" ? code : undefined;
-}
-function getErrorSignal(error) {
-  if (error === null || typeof error !== "object" || !("signal" in error)) {
-    return;
-  }
-  const signal = error.signal;
-  return typeof signal === "string" ? signal : undefined;
-}
-function getErrorKilled(error) {
-  if (error === null || typeof error !== "object" || !("killed" in error)) {
-    return false;
-  }
-  return error.killed === true;
-}
-function getErrorStderr(error) {
-  if (error === null || typeof error !== "object" || !("stderr" in error)) {
-    return "";
-  }
-  const stderr = error.stderr;
-  if (typeof stderr === "string") {
-    return stderr;
-  }
-  if (Buffer.isBuffer(stderr)) {
-    return stderr.toString("utf8");
-  }
-  return "";
-}
-function directoryFallback(directory) {
-  const canonical = path3.resolve(directory);
-  const hash = createHash("md5").update(canonical, "utf8").digest("hex").slice(0, 12);
-  return `dir:${hash}`;
-}
-function assertDirectoryUsable(canonicalDirectory, rawDirectory) {
-  try {
-    const stat = statSync3(canonicalDirectory);
-    if (!stat.isDirectory()) {
-      throw new ProjectIdentityError("unknown", rawDirectory, `Project path is not a directory: ${canonicalDirectory}`);
-    }
-  } catch (error) {
-    if (error instanceof ProjectIdentityError) {
-      throw error;
-    }
-    const code = getErrorCode(error);
-    if (code === "EACCES" || code === "EPERM") {
-      throw new ProjectIdentityError("permission_denied", rawDirectory, `Permission denied while accessing project directory: ${canonicalDirectory}`, asError(error));
-    }
-    throw new ProjectIdentityError("unknown", rawDirectory, `Unable to access project directory: ${canonicalDirectory}`, asError(error));
-  }
-}
-function isGitTimeoutError(error) {
-  const code = getErrorCode(error);
-  const signal = getErrorSignal(error);
-  return code === "ETIMEDOUT" || signal === "SIGTERM" || signal === "SIGKILL" || getErrorKilled(error);
-}
-function classifyGitError(error, rawDirectory) {
-  if (isGitTimeoutError(error)) {
-    return new ProjectIdentityError("git_timeout", rawDirectory, `git rev-list timed out after ${GIT_TIMEOUT_MS}ms`, asError(error));
-  }
-  const code = getErrorCode(error);
-  if (code === "ENOENT") {
-    return new ProjectIdentityError("git_missing", rawDirectory, "git binary is not available in PATH", asError(error));
-  }
-  if (code === "EACCES" || code === "EPERM") {
-    return new ProjectIdentityError("permission_denied", rawDirectory, "Permission denied while spawning git", asError(error));
-  }
-  const stderr = getErrorStderr(error).toLowerCase();
-  if (stderr.includes("not a git repository") || stderr.includes("does not have any commits yet") || stderr.includes("ambiguous argument 'head'") || stderr.includes("unknown revision or path")) {
-    return new ProjectIdentityError("not_git_repo", rawDirectory, "Directory has no git root commit; caller may use directory fallback", asError(error));
-  }
-  return new ProjectIdentityError("unknown", rawDirectory, "git rev-list failed while resolving project identity", asError(error));
-}
-function resolveProjectIdentityStrict(directory) {
-  const canonical = path3.resolve(directory);
-  const cached = identityCache.get(canonical);
-  if (cached !== undefined) {
-    return cached;
-  }
-  assertDirectoryUsable(canonical, directory);
-  let output;
-  try {
-    output = execFileSync3("git", ["rev-list", "--max-parents=0", "HEAD"], {
-      cwd: canonical,
-      encoding: "utf8",
-      env: { ...process.env, LC_ALL: "C", LANG: "C" },
-      stdio: ["ignore", "pipe", "pipe"],
-      timeout: GIT_TIMEOUT_MS
-    });
-  } catch (error) {
-    throw classifyGitError(error, directory);
-  }
-  const firstLine = output.split(`
-`)[0]?.trim() ?? "";
-  const rootCommit = firstLine.slice(0, 64);
-  if (rootCommit.length < 7) {
-    throw new ProjectIdentityError("unknown", directory, "git rev-list returned no valid root commit hash");
-  }
-  const identity = `git:${rootCommit}`;
-  identityCache.set(canonical, identity);
-  return identity;
-}
-function shouldUseDirectoryFallback(error) {
-  return error.errorClass === "not_git_repo" || error.errorClass === "unknown" && error.message.startsWith("Unable to access project directory:");
-}
-function resolveProjectIdentity(directory) {
-  const canonical = path3.resolve(directory);
-  const cachedFallback = directoryFallbackCache.get(canonical);
-  if (cachedFallback !== undefined) {
-    if (!hasGitDir(canonical)) {
-      return cachedFallback;
-    }
-    directoryFallbackCache.delete(canonical);
-  }
-  try {
-    return resolveProjectIdentityStrict(directory);
-  } catch (error) {
-    if (error instanceof ProjectIdentityError && shouldUseDirectoryFallback(error)) {
-      const fallback = directoryFallback(canonical);
-      if (!hasGitDir(canonical)) {
-        directoryFallbackCache.set(canonical, fallback);
-      }
-      return fallback;
-    }
-    throw error;
-  }
-}
-function hasGitDir(canonical) {
-  try {
-    statSync3(path3.join(canonical, ".git"));
-    return true;
-  } catch {
-    return false;
-  }
-}
-var GIT_TIMEOUT_MS = 5000, identityCache, directoryFallbackCache, ProjectIdentityError;
-var init_project_identity = __esm(() => {
-  identityCache = new Map;
-  directoryFallbackCache = new Map;
-  ProjectIdentityError = class ProjectIdentityError extends Error {
-    errorClass;
-    rawDirectory;
-    constructor(errorClass, rawDirectory, message, cause) {
-      super(message);
-      this.name = "ProjectIdentityError";
-      this.errorClass = errorClass;
-      this.rawDirectory = rawDirectory;
-      if (cause) {
-        this.cause = cause;
-      }
-    }
-  };
-});
-
-// ../plugin/src/features/magic-context/project-identity.ts
-var init_project_identity2 = __esm(() => {
-  init_project_identity();
-});
 // ../plugin/src/features/magic-context/storage-m0-mutation-log.ts
 var M0_MUTATION_TYPES;
 var init_storage_m0_mutation_log = __esm(() => {
@@ -147328,6 +147645,7 @@ var init_storage = __esm(async () => {
   init_storage_source();
   init_storage_tags();
   init_storage_v22_backfill_failures();
+  init_workspaces();
   await __promiseAll([
     init_message_index(),
     init_migrations(),
@@ -162515,7 +162833,8 @@ var init_magic_context = __esm(() => {
     endpoint: exports_external.string().optional().describe("API endpoint URL. Required when provider is openai-compatible."),
     api_key: exports_external.string().optional().describe("API key for remote embedding provider (optional)"),
     input_type: exports_external.string().optional().describe("Optional input_type sent in the embedding request body. Required by some openai-compatible providers (e.g. NVIDIA NIM expects 'query' or 'passage'). Omitted from the request when unset."),
-    truncate: exports_external.string().optional().describe("Optional truncate mode sent in the embedding request body (e.g. NVIDIA NIM accepts 'NONE' | 'START' | 'END'). Omitted from the request when unset.")
+    truncate: exports_external.string().optional().describe("Optional truncate mode sent in the embedding request body (e.g. NVIDIA NIM accepts 'NONE' | 'START' | 'END'). Omitted from the request when unset."),
+    max_input_tokens: exports_external.number().int().positive().optional().describe("Optional maximum input tokens for chunk embeddings. Defaults conservatively to 512 when omitted.")
   }).superRefine((data, ctx) => {
     if (data.provider === "openai-compatible" && !data.endpoint?.trim()) {
       ctx.addIssue({
@@ -162536,7 +162855,8 @@ var init_magic_context = __esm(() => {
     if (data.provider === "local") {
       return {
         provider: "local",
-        model: data.model?.trim() || DEFAULT_LOCAL_EMBEDDING_MODEL
+        model: data.model?.trim() || DEFAULT_LOCAL_EMBEDDING_MODEL,
+        ...data.max_input_tokens ? { max_input_tokens: data.max_input_tokens } : {}
       };
     }
     if (data.provider === "openai-compatible") {
@@ -162549,7 +162869,8 @@ var init_magic_context = __esm(() => {
         endpoint: data.endpoint?.trim() ?? "",
         ...apiKey ? { api_key: apiKey } : {},
         ...inputType ? { input_type: inputType } : {},
-        ...truncate ? { truncate } : {}
+        ...truncate ? { truncate } : {},
+        ...data.max_input_tokens ? { max_input_tokens: data.max_input_tokens } : {}
       };
     }
     return { provider: "off" };
@@ -166500,6 +166821,7 @@ function printUsage() {
   console.log("");
   console.log("  Usage:");
   console.log("    npx @cortexkit/magic-context@latest setup");
+  console.log("        # add --dry-run to preview the wizard without writing any files");
   console.log("    npx @cortexkit/magic-context@latest doctor");
   console.log("    npx @cortexkit/magic-context@latest doctor --issue");
   console.log("    npx @cortexkit/magic-context@latest doctor migrate \\");