@askexenow/exe-os 0.9.21 → 0.9.23

package/dist/bin/exe-session-cleanup.js

@@ -2956,8 +2956,8 @@ function getShardClient(projectName) {
     throw new Error("Shard manager not initialized. Call initShardManager() first.");
   }
   const safeName = projectName.replace(/[^a-zA-Z0-9_-]/g, "_");
-  if (!safeName) {
-    throw new Error(`Invalid project name for shard: "${projectName}"`);
+  if (!safeName || safeName === "unknown") {
+    throw new Error(`Invalid project name for shard: "${projectName}" (resolved to "${safeName}")`);
   }
   const cached = _shards.get(safeName);
   if (cached) {
@@ -3826,19 +3826,32 @@ async function flushBatch() {
       const { isShardingEnabled: isShardingEnabled2, getReadyShardClient: getReadyShardClient2 } = await Promise.resolve().then(() => (init_shard_manager(), shard_manager_exports));
       if (isShardingEnabled2()) {
         const byProject = /* @__PURE__ */ new Map();
+        let skippedUnknown = 0;
         for (const row of batch) {
-          const proj = row.project_name || "unknown";
+          const proj = row.project_name?.trim();
+          if (!proj) {
+            skippedUnknown++;
+            continue;
+          }
           if (!byProject.has(proj)) byProject.set(proj, []);
           byProject.get(proj).push(row);
         }
+        if (skippedUnknown > 0) {
+          process.stderr.write(
+            `[store] Shard skip: ${skippedUnknown} record(s) with empty project_name (kept in main DB only)
+`
+          );
+        }
         for (const [project, rows] of byProject) {
           try {
             const shardClient = await getReadyShardClient2(project);
             const shardStmts = rows.map(buildStmt);
             await shardClient.batch(shardStmts, "write");
           } catch (err) {
+            const fullError = err instanceof Error ? `${err.name}: ${err.message}${err.stack ? `
+${err.stack.split("\n").slice(1, 3).join("\n")}` : ""}` : String(err);
             process.stderr.write(
-              `[store] Shard write failed for ${project}: ${err instanceof Error ? err.message : String(err)}
+              `[store] Shard write failed for ${project} (${rows.length} records): ${fullError}
 `
             );
           }

package/dist/bin/exe-start-codex.js

@@ -1,6 +1,8 @@
 #!/usr/bin/env node
 var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
   get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
 }) : x)(function(x) {
@@ -14,6 +16,15 @@ var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, { get: all[name], enumerable: true });
 };
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/types/memory.ts
 var EMBEDDING_DIM;
@@ -2607,8 +2618,8 @@ function getShardClient(projectName) {
     throw new Error("Shard manager not initialized. Call initShardManager() first.");
   }
   const safeName = projectName.replace(/[^a-zA-Z0-9_-]/g, "_");
-  if (!safeName) {
-    throw new Error(`Invalid project name for shard: "${projectName}"`);
+  if (!safeName || safeName === "unknown") {
+    throw new Error(`Invalid project name for shard: "${projectName}" (resolved to "${safeName}")`);
   }
   const cached = _shards.get(safeName);
   if (cached) {
@@ -3141,7 +3152,7 @@ ${p.content}`).join("\n\n");
 });
 
 // src/lib/runtime-table.ts
-var RUNTIME_TABLE;
+var RUNTIME_TABLE, DEFAULT_RUNTIME;
 var init_runtime_table = __esm({
   "src/lib/runtime-table.ts"() {
     "use strict";
@@ -3163,6 +3174,7 @@ var init_runtime_table = __esm({
         defaultModel: "anthropic/claude-sonnet-4-6"
       }
     };
+    DEFAULT_RUNTIME = "claude";
   }
 });
 
@@ -3513,6 +3525,7 @@ var installer_exports = {};
 __export(installer_exports, {
   installCodexStatusLine: () => installCodexStatusLine,
   mergeCodexHooks: () => mergeCodexHooks,
+  registerCodexMcpServer: () => registerCodexMcpServer,
   runCodexInstaller: () => runCodexInstaller,
   verifyCodexHooks: () => verifyCodexHooks
 });
@@ -3684,11 +3697,52 @@ status_line = [${DEFAULT_CODEX_STATUS_LINE.map((s) => `"${s}"`).join(", ")}]`;
   await writeFile5(configPath, content);
   return "installed";
 }
+async function registerCodexMcpServer(packageRoot, homeDir = os10.homedir()) {
+  const codexDir = path13.join(homeDir, ".codex");
+  const configPath = path13.join(codexDir, "config.toml");
+  const serverJsPath = path13.join(packageRoot, "dist", "mcp", "server.js");
+  await mkdir5(codexDir, { recursive: true });
+  let content = "";
+  if (existsSync12(configPath)) {
+    content = await readFile5(configPath, "utf-8");
+  }
+  const sectionHeader = "[mcp_servers.exe-os]";
+  const headerIndex = content.indexOf(sectionHeader);
+  if (headerIndex !== -1) {
+    const afterHeader = content.slice(headerIndex + sectionHeader.length);
+    const nextSectionMatch = afterHeader.match(/\n\[(?!mcp_servers\.exe-os)/);
+    const sectionEnd = nextSectionMatch ? headerIndex + sectionHeader.length + nextSectionMatch.index : content.length;
+    const sectionContent = content.slice(headerIndex, sectionEnd);
+    if (sectionContent.includes(serverJsPath)) {
+      return "already-registered";
+    }
+    const newSection2 = `${sectionHeader}
+command = "node"
+args = ["${serverJsPath}"]
+`;
+    content = content.slice(0, headerIndex) + newSection2 + content.slice(sectionEnd);
+    await writeFile5(configPath, content);
+    return "updated";
+  }
+  const newSection = `[mcp_servers.exe-os]
+command = "node"
+args = ["${serverJsPath}"]
+`;
+  const separator = content.length > 0 && !content.endsWith("\n") ? "\n\n" : content.length > 0 ? "\n" : "";
+  content = content + separator + newSection;
+  await writeFile5(configPath, content);
+  return "registered";
+}
 async function runCodexInstaller(homeDir) {
   const packageRoot = resolvePackageRoot();
   const result = await mergeCodexHooks(packageRoot, homeDir);
   process.stderr.write(
     `[exe-os] Codex hooks: ${result.added} added, ${result.skipped} unchanged
+`
+  );
+  const mcpResult = await registerCodexMcpServer(packageRoot, homeDir);
+  process.stderr.write(
+    `[exe-os] Codex MCP server: ${mcpResult}
 `
   );
   const statusResult = await installCodexStatusLine(homeDir);
@@ -3714,13 +3768,102 @@ var init_installer2 = __esm({
   }
 });
 
+// src/lib/agent-config.ts
+var agent_config_exports = {};
+__export(agent_config_exports, {
+  AGENT_CONFIG_PATH: () => AGENT_CONFIG_PATH,
+  DEFAULT_MODELS: () => DEFAULT_MODELS,
+  KNOWN_RUNTIMES: () => KNOWN_RUNTIMES,
+  RUNTIME_LABELS: () => RUNTIME_LABELS,
+  clearAgentRuntime: () => clearAgentRuntime,
+  getAgentRuntime: () => getAgentRuntime,
+  loadAgentConfig: () => loadAgentConfig,
+  saveAgentConfig: () => saveAgentConfig,
+  setAgentRuntime: () => setAgentRuntime
+});
+import { readFileSync as readFileSync8, writeFileSync as writeFileSync7, existsSync as existsSync13 } from "fs";
+import path14 from "path";
+function loadAgentConfig() {
+  if (!existsSync13(AGENT_CONFIG_PATH)) return {};
+  try {
+    return JSON.parse(readFileSync8(AGENT_CONFIG_PATH, "utf-8"));
+  } catch {
+    return {};
+  }
+}
+function saveAgentConfig(config) {
+  const dir = path14.dirname(AGENT_CONFIG_PATH);
+  ensurePrivateDirSync(dir);
+  writeFileSync7(AGENT_CONFIG_PATH, JSON.stringify(config, null, 2) + "\n", "utf-8");
+  enforcePrivateFileSync(AGENT_CONFIG_PATH);
+}
+function getAgentRuntime(agentId) {
+  const config = loadAgentConfig();
+  const entry = config[agentId];
+  if (entry) return entry;
+  const orgDefault = config["default"];
+  if (orgDefault) return orgDefault;
+  return { runtime: DEFAULT_RUNTIME, model: DEFAULT_MODELS[DEFAULT_RUNTIME] };
+}
+function setAgentRuntime(agentId, runtime, model, reasoning_effort) {
+  const knownModels = KNOWN_RUNTIMES[runtime];
+  if (!knownModels) {
+    return {
+      ok: false,
+      error: `Unknown runtime "${runtime}". Valid: ${Object.keys(KNOWN_RUNTIMES).join(", ")}`
+    };
+  }
+  if (!knownModels.includes(model)) {
+    return {
+      ok: false,
+      error: `Unknown model "${model}" for runtime "${runtime}". Valid: ${knownModels.join(", ")}`
+    };
+  }
+  const config = loadAgentConfig();
+  const entry = { runtime, model };
+  if (reasoning_effort) entry.reasoning_effort = reasoning_effort;
+  config[agentId] = entry;
+  saveAgentConfig(config);
+  return { ok: true };
+}
+function clearAgentRuntime(agentId) {
+  const config = loadAgentConfig();
+  delete config[agentId];
+  saveAgentConfig(config);
+}
+var AGENT_CONFIG_PATH, KNOWN_RUNTIMES, RUNTIME_LABELS, DEFAULT_MODELS;
+var init_agent_config = __esm({
+  "src/lib/agent-config.ts"() {
+    "use strict";
+    init_config();
+    init_runtime_table();
+    init_secure_files();
+    AGENT_CONFIG_PATH = path14.join(EXE_AI_DIR, "agent-config.json");
+    KNOWN_RUNTIMES = {
+      claude: ["claude-opus-4.6", "claude-opus-4", "claude-sonnet-4.6", "claude-sonnet-4", "claude-haiku-4.5"],
+      codex: ["gpt-5.4", "gpt-5.5", "gpt-5.3-codex-spark", "o3", "o4-mini"],
+      opencode: ["anthropic/claude-sonnet-4-6", "openai/gpt-5.4", "google/gemini-2.5-pro", "deepseek/deepseek-r3", "minimax/minimax-m2.5"]
+    };
+    RUNTIME_LABELS = {
+      claude: "Claude Code (Anthropic)",
+      codex: "Codex (OpenAI)",
+      opencode: "OpenCode (open source)"
+    };
+    DEFAULT_MODELS = {
+      claude: "claude-opus-4.6",
+      codex: RUNTIME_TABLE.codex?.defaultModel ?? "gpt-5.4",
+      opencode: RUNTIME_TABLE.opencode?.defaultModel ?? "anthropic/claude-sonnet-4-6"
+    };
+  }
+});
+
 // src/bin/exe-start-codex.ts
 import os11 from "os";
-import path14 from "path";
+import path15 from "path";
 import {
-  existsSync as existsSync13,
-  readFileSync as readFileSync8,
-  writeFileSync as writeFileSync7,
+  existsSync as existsSync14,
+  readFileSync as readFileSync9,
+  writeFileSync as writeFileSync8,
   mkdirSync as mkdirSync7,
   readdirSync as readdirSync4
 } from "fs";
@@ -4038,19 +4181,32 @@ async function flushBatch() {
       const { isShardingEnabled: isShardingEnabled2, getReadyShardClient: getReadyShardClient2 } = await Promise.resolve().then(() => (init_shard_manager(), shard_manager_exports));
       if (isShardingEnabled2()) {
         const byProject = /* @__PURE__ */ new Map();
+        let skippedUnknown = 0;
         for (const row of batch) {
-          const proj = row.project_name || "unknown";
+          const proj = row.project_name?.trim();
+          if (!proj) {
+            skippedUnknown++;
+            continue;
+          }
           if (!byProject.has(proj)) byProject.set(proj, []);
           byProject.get(proj).push(row);
         }
+        if (skippedUnknown > 0) {
+          process.stderr.write(
+            `[store] Shard skip: ${skippedUnknown} record(s) with empty project_name (kept in main DB only)
+`
+          );
+        }
         for (const [project, rows] of byProject) {
           try {
             const shardClient = await getReadyShardClient2(project);
             const shardStmts = rows.map(buildStmt);
             await shardClient.batch(shardStmts, "write");
           } catch (err) {
+            const fullError = err instanceof Error ? `${err.name}: ${err.message}${err.stack ? `
+${err.stack.split("\n").slice(1, 3).join("\n")}` : ""}` : String(err);
             process.stderr.write(
-              `[store] Shard write failed for ${project}: ${err instanceof Error ? err.message : String(err)}
+              `[store] Shard write failed for ${project} (${rows.length} records): ${fullError}
 `
             );
           }
@@ -4201,12 +4357,24 @@ var BOOT_INSTRUCTIONS = `
 ---
 ## Boot Instructions
 You have access to exe-os MCP tools for persistent memory, tasks, and team coordination.
+MCP tools are available under the exe-os server. Call them directly by name:
+- list_tasks \u2014 see your assigned work
+- get_task \u2014 read full task context
+- update_task \u2014 mark tasks in_progress or done
+- store_memory \u2014 persist findings for future sessions
+- recall_my_memory \u2014 search your past work
+- ask_team_memory \u2014 query a colleague's knowledge
+
 On startup: call list_tasks to check for assigned work.
-When done with a task: call update_task with status "done".
-Always call store_memory to persist important findings.
+When done with a task: call update_task with status "done" and a result summary.
+Always call store_memory to persist important decisions.
+
+\u26A0 FIRST RUN: If hooks haven't been approved yet, run /hooks in Codex and approve
+all exe-os hooks before starting work. Without approved hooks, memory capture
+and session tracking won't function.
 `;
 function resolveAgent(argv) {
-  const invokedAs = path14.basename(argv[1] ?? "");
+  const invokedAs = path15.basename(argv[1] ?? "");
   if (invokedAs && invokedAs !== "exe-start-codex" && !invokedAs.endsWith(".js")) {
     const agent2 = invokedAs.replace(/-codex$/, "").toLowerCase();
     return { agent: agent2, passthrough: argv.slice(2) };
@@ -4232,24 +4400,24 @@ function resolveAgent(argv) {
   return { agent, passthrough, sessionName };
 }
 function loadIdentity(agent) {
-  const dir = path14.join(os11.homedir(), ".exe-os", "identity");
-  const exact = path14.join(dir, `${agent}.md`);
-  if (existsSync13(exact)) {
-    const content = readFileSync8(exact, "utf-8").trim();
+  const dir = path15.join(os11.homedir(), ".exe-os", "identity");
+  const exact = path15.join(dir, `${agent}.md`);
+  if (existsSync14(exact)) {
+    const content = readFileSync9(exact, "utf-8").trim();
     if (content) return content;
   }
   try {
     const files = readdirSync4(dir);
     const match = files.find((f) => f.toLowerCase() === `${agent.toLowerCase()}.md`);
     if (match) {
-      const content = readFileSync8(path14.join(dir, match), "utf-8").trim();
+      const content = readFileSync9(path15.join(dir, match), "utf-8").trim();
       if (content) return content;
     }
   } catch {
   }
   try {
-    const rosterPath = path14.join(os11.homedir(), ".exe-os", "exe-employees.json");
-    const roster = JSON.parse(readFileSync8(rosterPath, "utf8"));
+    const rosterPath = path15.join(os11.homedir(), ".exe-os", "exe-employees.json");
+    const roster = JSON.parse(readFileSync9(rosterPath, "utf8"));
     const emp = roster.find((e) => e.name.toLowerCase() === agent.toLowerCase());
     if (emp?.systemPrompt && emp.systemPrompt.trim().length > 20) {
       return emp.systemPrompt;
@@ -4259,18 +4427,18 @@ function loadIdentity(agent) {
   return null;
 }
 function writePromptFile(agent, identity, behaviorsPath) {
-  const promptDir = path14.join(os11.homedir(), ".exe-os", "codex-prompt");
+  const promptDir = path15.join(os11.homedir(), ".exe-os", "codex-prompt");
   mkdirSync7(promptDir, { recursive: true });
   let prompt = identity;
-  if (behaviorsPath && existsSync13(behaviorsPath)) {
-    const behaviors = readFileSync8(behaviorsPath, "utf-8").trim();
+  if (behaviorsPath && existsSync14(behaviorsPath)) {
+    const behaviors = readFileSync9(behaviorsPath, "utf-8").trim();
     if (behaviors) {
       prompt += "\n\n" + behaviors;
     }
   }
   prompt += "\n" + BOOT_INSTRUCTIONS;
-  const outPath = path14.join(promptDir, `${agent}.md`);
-  writeFileSync7(outPath, prompt, "utf-8");
+  const outPath = path15.join(promptDir, `${agent}.md`);
+  writeFileSync8(outPath, prompt, "utf-8");
   return outPath;
 }
 async function main() {
@@ -4349,8 +4517,8 @@ async function main() {
   process.env.EXE_RUNTIME = "codex";
   const empRole = (() => {
     try {
-      const emps = readFileSync8(
-        path14.join(os11.homedir(), ".exe-os", "exe-employees.json"),
+      const emps = readFileSync9(
+        path15.join(os11.homedir(), ".exe-os", "exe-employees.json"),
         "utf-8"
       );
       const found = JSON.parse(emps).find(
@@ -4387,14 +4555,14 @@ async function main() {
   if (WORKTREE_ROLES.has(empRole)) {
     try {
       const { execSync: es } = await import("child_process");
-      const worktreeDir = path14.join(process.cwd(), ".worktrees", worktreeName);
+      const worktreeDir = path15.join(process.cwd(), ".worktrees", worktreeName);
       const branchName = `${worktreeName}/codex-${Date.now()}`;
-      if (existsSync13(worktreeDir)) {
+      if (existsSync14(worktreeDir)) {
         worktreePath = worktreeDir;
         process.stderr.write(`[exe-start-codex] Reusing worktree at ${worktreeDir}
 `);
       } else {
-        mkdirSync7(path14.dirname(worktreeDir), { recursive: true });
+        mkdirSync7(path15.dirname(worktreeDir), { recursive: true });
         es(`git worktree add "${worktreeDir}" -b "${branchName}" HEAD`, {
           encoding: "utf-8",
           timeout: 3e4
@@ -4410,7 +4578,16 @@ async function main() {
       );
     }
   }
-  const effectiveModel = process.env.EXE_AGENT_MODEL ?? CODEX.defaultModel;
+  let configModel;
+  let configReasoning;
+  try {
+    const { getAgentRuntime: getAgentRuntime2 } = (init_agent_config(), __toCommonJS(agent_config_exports));
+    const rtConfig = getAgentRuntime2(agent);
+    configModel = rtConfig.model;
+    configReasoning = rtConfig.reasoning_effort;
+  } catch {
+  }
+  const effectiveModel = process.env.EXE_AGENT_MODEL ?? configModel ?? CODEX.defaultModel;
   const args = [
     "-m",
     effectiveModel,
@@ -4418,7 +4595,7 @@ async function main() {
     CODEX.inlineFlag,
     ...passthrough
   ];
-  const reasoningEffort = process.env.EXE_AGENT_REASONING_EFFORT;
+  const reasoningEffort = process.env.EXE_AGENT_REASONING_EFFORT ?? configReasoning;
   if (reasoningEffort) {
     args.push("-c", `model_reasoning_effort="${reasoningEffort}"`);
   }
@@ -4428,7 +4605,7 @@ async function main() {
   if (promptPath) {
     args.push("-c", `model_instructions_file="${promptPath}"`);
   }
-  args.push("You are an AI employee with exe-os MCP tools. DO NOT ask for confirmation \u2014 work autonomously. Immediately: 1) Call list_tasks to see your assigned tasks. 2) Call get_task on the highest priority open task. 3) Start working on it. 4) When done, call update_task with status done and a result summary. 5) Check list_tasks again for the next task. 6) If NO open tasks remain, say 'All tasks complete. Standing by.' and STOP \u2014 do not explore the codebase, do not look for extra work, do not run reviews. Just stop and wait.");
+  args.push("You are an AI employee with exe-os MCP tools (list_tasks, get_task, update_task, store_memory, recall_my_memory, ask_team_memory). DO NOT ask for confirmation \u2014 work autonomously. Immediately: 1) Call list_tasks to see your assigned tasks. 2) Call get_task on the highest priority open task. 3) Start working on it. 4) When done, call update_task with status done and a result summary. 5) Check list_tasks again for the next task. 6) If NO open tasks remain, say 'All tasks complete. Standing by.' and STOP. If MCP tools are unavailable, tell the user to run 'exe-os codex' to register them.");
   process.stderr.write(
     `[exe-start-codex] launching ${agent} on ${CODEX.binary} (${effectiveModel}) \u2014 interactive mode
 `

package/dist/bin/exe-start-opencode.js

@@ -2607,8 +2607,8 @@ function getShardClient(projectName) {
     throw new Error("Shard manager not initialized. Call initShardManager() first.");
   }
   const safeName = projectName.replace(/[^a-zA-Z0-9_-]/g, "_");
-  if (!safeName) {
-    throw new Error(`Invalid project name for shard: "${projectName}"`);
+  if (!safeName || safeName === "unknown") {
+    throw new Error(`Invalid project name for shard: "${projectName}" (resolved to "${safeName}")`);
   }
   const cached = _shards.get(safeName);
   if (cached) {
@@ -4100,19 +4100,32 @@ async function flushBatch() {
       const { isShardingEnabled: isShardingEnabled2, getReadyShardClient: getReadyShardClient2 } = await Promise.resolve().then(() => (init_shard_manager(), shard_manager_exports));
       if (isShardingEnabled2()) {
         const byProject = /* @__PURE__ */ new Map();
+        let skippedUnknown = 0;
         for (const row of batch) {
-          const proj = row.project_name || "unknown";
+          const proj = row.project_name?.trim();
+          if (!proj) {
+            skippedUnknown++;
+            continue;
+          }
           if (!byProject.has(proj)) byProject.set(proj, []);
           byProject.get(proj).push(row);
         }
+        if (skippedUnknown > 0) {
+          process.stderr.write(
+            `[store] Shard skip: ${skippedUnknown} record(s) with empty project_name (kept in main DB only)
+`
+          );
+        }
         for (const [project, rows] of byProject) {
           try {
             const shardClient = await getReadyShardClient2(project);
             const shardStmts = rows.map(buildStmt);
             await shardClient.batch(shardStmts, "write");
           } catch (err) {
+            const fullError = err instanceof Error ? `${err.name}: ${err.message}${err.stack ? `
+${err.stack.split("\n").slice(1, 3).join("\n")}` : ""}` : String(err);
             process.stderr.write(
-              `[store] Shard write failed for ${project}: ${err instanceof Error ? err.message : String(err)}
+              `[store] Shard write failed for ${project} (${rows.length} records): ${fullError}
 `
             );
           }

package/dist/bin/exe-status.js

@@ -2945,8 +2945,8 @@ function getShardClient(projectName) {
     throw new Error("Shard manager not initialized. Call initShardManager() first.");
   }
   const safeName = projectName.replace(/[^a-zA-Z0-9_-]/g, "_");
-  if (!safeName) {
-    throw new Error(`Invalid project name for shard: "${projectName}"`);
+  if (!safeName || safeName === "unknown") {
+    throw new Error(`Invalid project name for shard: "${projectName}" (resolved to "${safeName}")`);
   }
   const cached = _shards.get(safeName);
   if (cached) {
@@ -3815,19 +3815,32 @@ async function flushBatch() {
       const { isShardingEnabled: isShardingEnabled2, getReadyShardClient: getReadyShardClient2 } = await Promise.resolve().then(() => (init_shard_manager(), shard_manager_exports));
       if (isShardingEnabled2()) {
         const byProject = /* @__PURE__ */ new Map();
+        let skippedUnknown = 0;
         for (const row of batch) {
-          const proj = row.project_name || "unknown";
+          const proj = row.project_name?.trim();
+          if (!proj) {
+            skippedUnknown++;
+            continue;
+          }
           if (!byProject.has(proj)) byProject.set(proj, []);
           byProject.get(proj).push(row);
         }
+        if (skippedUnknown > 0) {
+          process.stderr.write(
+            `[store] Shard skip: ${skippedUnknown} record(s) with empty project_name (kept in main DB only)
+`
+          );
+        }
         for (const [project, rows] of byProject) {
           try {
             const shardClient = await getReadyShardClient2(project);
             const shardStmts = rows.map(buildStmt);
             await shardClient.batch(shardStmts, "write");
           } catch (err) {
+            const fullError = err instanceof Error ? `${err.name}: ${err.message}${err.stack ? `
+${err.stack.split("\n").slice(1, 3).join("\n")}` : ""}` : String(err);
             process.stderr.write(
-              `[store] Shard write failed for ${project}: ${err instanceof Error ? err.message : String(err)}
+              `[store] Shard write failed for ${project} (${rows.length} records): ${fullError}
 `
             );
           }

package/dist/bin/exe-team.js

@@ -2934,8 +2934,8 @@ function getShardClient(projectName) {
     throw new Error("Shard manager not initialized. Call initShardManager() first.");
   }
   const safeName = projectName.replace(/[^a-zA-Z0-9_-]/g, "_");
-  if (!safeName) {
-    throw new Error(`Invalid project name for shard: "${projectName}"`);
+  if (!safeName || safeName === "unknown") {
+    throw new Error(`Invalid project name for shard: "${projectName}" (resolved to "${safeName}")`);
   }
   const cached = _shards.get(safeName);
   if (cached) {
@@ -3804,19 +3804,32 @@ async function flushBatch() {
       const { isShardingEnabled: isShardingEnabled2, getReadyShardClient: getReadyShardClient2 } = await Promise.resolve().then(() => (init_shard_manager(), shard_manager_exports));
       if (isShardingEnabled2()) {
         const byProject = /* @__PURE__ */ new Map();
+        let skippedUnknown = 0;
         for (const row of batch) {
-          const proj = row.project_name || "unknown";
+          const proj = row.project_name?.trim();
+          if (!proj) {
+            skippedUnknown++;
+            continue;
+          }
           if (!byProject.has(proj)) byProject.set(proj, []);
           byProject.get(proj).push(row);
         }
+        if (skippedUnknown > 0) {
+          process.stderr.write(
+            `[store] Shard skip: ${skippedUnknown} record(s) with empty project_name (kept in main DB only)
+`
+          );
+        }
         for (const [project, rows] of byProject) {
           try {
             const shardClient = await getReadyShardClient2(project);
             const shardStmts = rows.map(buildStmt);
             await shardClient.batch(shardStmts, "write");
           } catch (err) {
+            const fullError = err instanceof Error ? `${err.name}: ${err.message}${err.stack ? `
+${err.stack.split("\n").slice(1, 3).join("\n")}` : ""}` : String(err);
             process.stderr.write(
-              `[store] Shard write failed for ${project}: ${err instanceof Error ? err.message : String(err)}
+              `[store] Shard write failed for ${project} (${rows.length} records): ${fullError}
 `
             );
           }

package/dist/bin/git-sweep.js

@@ -6553,8 +6553,8 @@ function getShardClient(projectName2) {
     throw new Error("Shard manager not initialized. Call initShardManager() first.");
   }
   const safeName = projectName2.replace(/[^a-zA-Z0-9_-]/g, "_");
-  if (!safeName) {
-    throw new Error(`Invalid project name for shard: "${projectName2}"`);
+  if (!safeName || safeName === "unknown") {
+    throw new Error(`Invalid project name for shard: "${projectName2}" (resolved to "${safeName}")`);
   }
   const cached = _shards.get(safeName);
   if (cached) {
@@ -7423,19 +7423,32 @@ async function flushBatch() {
       const { isShardingEnabled: isShardingEnabled2, getReadyShardClient: getReadyShardClient2 } = await Promise.resolve().then(() => (init_shard_manager(), shard_manager_exports));
       if (isShardingEnabled2()) {
         const byProject = /* @__PURE__ */ new Map();
+        let skippedUnknown = 0;
         for (const row of batch) {
-          const proj = row.project_name || "unknown";
+          const proj = row.project_name?.trim();
+          if (!proj) {
+            skippedUnknown++;
+            continue;
+          }
           if (!byProject.has(proj)) byProject.set(proj, []);
           byProject.get(proj).push(row);
         }
+        if (skippedUnknown > 0) {
+          process.stderr.write(
+            `[store] Shard skip: ${skippedUnknown} record(s) with empty project_name (kept in main DB only)
+`
+          );
+        }
         for (const [project, rows] of byProject) {
           try {
             const shardClient = await getReadyShardClient2(project);
             const shardStmts = rows.map(buildStmt);
             await shardClient.batch(shardStmts, "write");
           } catch (err) {
+            const fullError = err instanceof Error ? `${err.name}: ${err.message}${err.stack ? `
+${err.stack.split("\n").slice(1, 3).join("\n")}` : ""}` : String(err);
             process.stderr.write(
-              `[store] Shard write failed for ${project}: ${err instanceof Error ? err.message : String(err)}
+              `[store] Shard write failed for ${project} (${rows.length} records): ${fullError}
 `
             );
           }