@askexenow/exe-os 0.9.64 → 0.9.66

package/dist/hooks/session-end.js

@@ -149,6 +149,11 @@ function normalizeAutoUpdate(raw) {
   const userAU = raw.autoUpdate ?? {};
   raw.autoUpdate = { ...defaultAU, ...userAU };
 }
+function normalizeOrchestration(raw) {
+  const defaultOrg = DEFAULT_CONFIG.orchestration;
+  const userOrg = raw.orchestration ?? {};
+  raw.orchestration = { ...defaultOrg, ...userOrg };
+}
 async function loadConfig() {
   const dir = process.env.EXE_OS_DIR ?? process.env.EXE_MEM_DIR ?? EXE_AI_DIR;
   await ensurePrivateDir(dir);
@@ -173,6 +178,7 @@ async function loadConfig() {
     normalizeScalingRoadmap(migratedCfg);
     normalizeSessionLifecycle(migratedCfg);
     normalizeAutoUpdate(migratedCfg);
+    normalizeOrchestration(migratedCfg);
     const config = { ...DEFAULT_CONFIG, dbPath: path.join(dir, "memories.db"), ...migratedCfg };
     if (config.dbPath.startsWith("~")) {
       config.dbPath = config.dbPath.replace(/^~/, os.homedir());
@@ -196,6 +202,7 @@ function loadConfigSync() {
     normalizeScalingRoadmap(migratedCfg);
     normalizeSessionLifecycle(migratedCfg);
     normalizeAutoUpdate(migratedCfg);
+    normalizeOrchestration(migratedCfg);
     return { ...DEFAULT_CONFIG, dbPath: path.join(dir, "memories.db"), ...migratedCfg };
   } catch {
     return { ...DEFAULT_CONFIG, dbPath: path.join(dir, "memories.db") };
@@ -217,6 +224,7 @@ async function loadConfigFrom(configPath) {
     normalizeScalingRoadmap(migratedCfg);
     normalizeSessionLifecycle(migratedCfg);
     normalizeAutoUpdate(migratedCfg);
+    normalizeOrchestration(migratedCfg);
     return { ...DEFAULT_CONFIG, ...migratedCfg };
   } catch {
     return { ...DEFAULT_CONFIG };
@@ -288,6 +296,10 @@ var init_config = __esm({
         checkOnBoot: true,
         autoInstall: false,
         checkIntervalMs: 24 * 60 * 60 * 1e3
+      },
+      orchestration: {
+        phase: "phase_1_coo",
+        phaseSetBy: "default"
       }
     };
     CONFIG_MIGRATIONS = [
@@ -6934,15 +6946,15 @@ var init_task_scope = __esm({
 
 // src/lib/keychain.ts
 import { readFile as readFile4, writeFile as writeFile5, unlink, mkdir as mkdir4, chmod as chmod2 } from "fs/promises";
-import { existsSync as existsSync17 } from "fs";
+import { existsSync as existsSync18 } from "fs";
 import { execSync as execSync8 } from "child_process";
-import path21 from "path";
+import path22 from "path";
 import os13 from "os";
 function getKeyDir() {
-  return process.env.EXE_OS_DIR ?? process.env.EXE_MEM_DIR ?? path21.join(os13.homedir(), ".exe-os");
+  return process.env.EXE_OS_DIR ?? process.env.EXE_MEM_DIR ?? path22.join(os13.homedir(), ".exe-os");
 }
 function getKeyPath() {
-  return path21.join(getKeyDir(), "master.key");
+  return path22.join(getKeyDir(), "master.key");
 }
 function macKeychainGet() {
   if (process.platform !== "darwin") return null;
@@ -7090,7 +7102,7 @@ async function getMasterKey() {
     }
   }
   const keyPath = getKeyPath();
-  if (!existsSync17(keyPath)) {
+  if (!existsSync18(keyPath)) {
     process.stderr.write(
       `[keychain] Key not found at ${keyPath} (HOME=${os13.homedir()}, EXE_OS_DIR=${process.env.EXE_OS_DIR ?? "unset"})
 `
@@ -7364,12 +7376,12 @@ __export(shard_manager_exports, {
   listShards: () => listShards,
   shardExists: () => shardExists
 });
-import path22 from "path";
-import { existsSync as existsSync18, mkdirSync as mkdirSync10, readdirSync as readdirSync5, renameSync as renameSync4, statSync as statSync2 } from "fs";
+import path23 from "path";
+import { existsSync as existsSync19, mkdirSync as mkdirSync10, readdirSync as readdirSync5, renameSync as renameSync5, statSync as statSync3 } from "fs";
 import { createClient as createClient2 } from "@libsql/client";
 function initShardManager(encryptionKey) {
   _encryptionKey = encryptionKey;
-  if (!existsSync18(SHARDS_DIR)) {
+  if (!existsSync19(SHARDS_DIR)) {
     mkdirSync10(SHARDS_DIR, { recursive: true });
   }
   _shardingEnabled = true;
@@ -7399,7 +7411,7 @@ function getShardClient(projectName) {
   while (_shards.size >= MAX_OPEN_SHARDS) {
     evictLRU();
   }
-  const dbPath = path22.join(SHARDS_DIR, `${safeName}.db`);
+  const dbPath = path23.join(SHARDS_DIR, `${safeName}.db`);
   const client = createClient2({
     url: `file:${dbPath}`,
     encryptionKey: _encryptionKey
@@ -7410,13 +7422,13 @@ function getShardClient(projectName) {
 }
 function shardExists(projectName) {
   const safeName = safeShardName(projectName);
-  return existsSync18(path22.join(SHARDS_DIR, `${safeName}.db`));
+  return existsSync19(path23.join(SHARDS_DIR, `${safeName}.db`));
 }
 function safeShardName(projectName) {
   return projectName.replace(/[^a-zA-Z0-9_-]/g, "_");
 }
 function listShards() {
-  if (!existsSync18(SHARDS_DIR)) return [];
+  if (!existsSync19(SHARDS_DIR)) return [];
   return readdirSync5(SHARDS_DIR).filter((f) => f.endsWith(".db")).map((f) => f.replace(".db", ""));
 }
 async function auditShardHealth(options = {}) {
@@ -7428,8 +7440,8 @@ async function auditShardHealth(options = {}) {
   const names = listShards();
   const shards = [];
   for (const name of names) {
-    const dbPath = path22.join(SHARDS_DIR, `${name}.db`);
-    const stat = statSync2(dbPath);
+    const dbPath = path23.join(SHARDS_DIR, `${name}.db`);
+    const stat = statSync3(dbPath);
     const item = {
       name,
       path: dbPath,
@@ -7463,8 +7475,8 @@ async function auditShardHealth(options = {}) {
         _shards.delete(name);
         _shardLastAccess.delete(name);
         const stamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
-        const archivedPath = path22.join(SHARDS_DIR, `${name}.db.broken-${stamp}`);
-        renameSync4(dbPath, archivedPath);
+        const archivedPath = path23.join(SHARDS_DIR, `${name}.db.broken-${stamp}`);
+        renameSync5(dbPath, archivedPath);
         item.archivedPath = archivedPath;
       }
     } finally {
@@ -7680,12 +7692,12 @@ async function getReadyShardClient(projectName) {
     client.close();
     _shards.delete(safeName);
     _shardLastAccess.delete(safeName);
-    const dbPath = path22.join(SHARDS_DIR, `${safeName}.db`);
-    if (existsSync18(dbPath)) {
-      const stat = statSync2(dbPath);
+    const dbPath = path23.join(SHARDS_DIR, `${safeName}.db`);
+    if (existsSync19(dbPath)) {
+      const stat = statSync3(dbPath);
       const stamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
-      const archivedPath = path22.join(SHARDS_DIR, `${safeName}.db.broken-${stamp}`);
-      renameSync4(dbPath, archivedPath);
+      const archivedPath = path23.join(SHARDS_DIR, `${safeName}.db.broken-${stamp}`);
+      renameSync5(dbPath, archivedPath);
       process.stderr.write(
         `[shard-manager] Archived unreadable shard ${safeName}: ${archivedPath} (${stat.size} bytes, mtime ${stat.mtime.toISOString()})
 `
@@ -7752,7 +7764,7 @@ var init_shard_manager = __esm({
   "src/lib/shard-manager.ts"() {
     "use strict";
     init_config();
-    SHARDS_DIR = path22.join(EXE_AI_DIR, "shards");
+    SHARDS_DIR = path23.join(EXE_AI_DIR, "shards");
     SHARD_IDLE_MS = 5 * 60 * 1e3;
     MAX_OPEN_SHARDS = 10;
     EVICTION_INTERVAL_MS = 60 * 1e3;
@@ -7802,6 +7814,12 @@ var init_platform_procedures = __esm({
         priority: "p0",
         content: "Founder -> coordinator (the executive agent, internally routed as 'COO') -> CTO/CMO. CTO -> engineers. CMO -> content production. Never skip levels: the coordinator does not bypass managers for specialist work. Specialists report to their manager. If you need cross-team info, use ask_team_memory \u2014 don't read other agents' task folders. Each level owns dispatch downward and review upward."
       },
+      {
+        title: "Customer orchestration maturity \u2014 recommend, never trap",
+        domain: "workflow",
+        priority: "p1",
+        content: "New customers start best in Phase 1: founder \u2194 coordinator/Chief of Staff, building company context. Suggest Phase 2 executives when domain work repeats; suggest Phase 3 parallel execution only when review/permission gates are ready. This is guidance, not a blocker: users may jump phases anytime. Never overwrite their phase, role titles, identities, or custom org design."
+      },
       {
         title: "Single dispatch path \u2014 create_task only",
         domain: "workflow",
@@ -7860,6 +7878,12 @@ var init_platform_procedures = __esm({
         priority: "p0",
         content: "exe-build-adv is MANDATORY for ALL work touching 3+ files. Run /exe-build-adv --auto BEFORE implementation. Pipeline: Spec \u2192 AC \u2192 Tests \u2192 Evaluate \u2192 Fix. No multi-file feature ships without pipeline artifacts. No exceptions \u2014 managers reject work without them."
       },
+      {
+        title: "Commit discipline \u2014 never leave verified work floating",
+        domain: "workflow",
+        priority: "p1",
+        content: "After any code-change batch passes typecheck/tests/build, run git status, summarize changed files, and commit with a clear message before ending the session. If work must remain uncommitted for review/dogfood, explicitly say so, list the files, and state the blocker. Never imply work is complete while verified changes are still floating locally."
+      },
       {
         title: "Desktop and TUI are the same product",
         domain: "architecture",
@@ -8867,78 +8891,6 @@ var init_fast_db_init = __esm({
   }
 });
 
-// src/lib/memory-queue.ts
-import { appendFileSync as appendFileSync2, readFileSync as readFileSync15, renameSync as renameSync5, unlinkSync as unlinkSync9, existsSync as existsSync19, statSync as statSync3 } from "fs";
-import path23 from "path";
-function enqueueMemory(entry) {
-  appendFileSync2(QUEUE_PATH2, JSON.stringify(entry) + "\n");
-}
-var QUEUE_PATH2, PROCESSING_PATH, TTL_MS2;
-var init_memory_queue = __esm({
-  "src/lib/memory-queue.ts"() {
-    "use strict";
-    init_config();
-    QUEUE_PATH2 = path23.join(EXE_AI_DIR, "memory-queue.jsonl");
-    PROCESSING_PATH = QUEUE_PATH2 + ".processing";
-    TTL_MS2 = 24 * 60 * 60 * 1e3;
-  }
-});
-
-// src/lib/memory-queue-client.ts
-var memory_queue_client_exports = {};
-__export(memory_queue_client_exports, {
-  batchWriteMemoryViaDaemon: () => batchWriteMemoryViaDaemon,
-  writeMemoryViaDaemon: () => writeMemoryViaDaemon
-});
-async function writeMemoryViaDaemon(entry) {
-  if (process.env.EXE_IS_DAEMON === "1") {
-    enqueueMemory(entry);
-    return false;
-  }
-  if (!isClientConnected()) {
-    enqueueMemory(entry);
-    return false;
-  }
-  try {
-    const response = await sendDaemonRequest({
-      type: "write-memory",
-      entry
-    });
-    if (response.ok) return true;
-    enqueueMemory(entry);
-    return false;
-  } catch {
-    enqueueMemory(entry);
-    return false;
-  }
-}
-async function batchWriteMemoryViaDaemon(entries) {
-  if (entries.length === 0) return 0;
-  if (process.env.EXE_IS_DAEMON === "1" || !isClientConnected()) {
-    for (const entry of entries) enqueueMemory(entry);
-    return 0;
-  }
-  try {
-    const response = await sendDaemonRequest({
-      type: "batch-write-memory",
-      entries
-    });
-    if (response.ok) return response.count ?? entries.length;
-    for (const entry of entries) enqueueMemory(entry);
-    return 0;
-  } catch {
-    for (const entry of entries) enqueueMemory(entry);
-    return 0;
-  }
-}
-var init_memory_queue_client = __esm({
-  "src/lib/memory-queue-client.ts"() {
-    "use strict";
-    init_exe_daemon_client();
-    init_memory_queue();
-  }
-});
-
 // src/lib/git-staleness.ts
 var git_staleness_exports = {};
 __export(git_staleness_exports, {
@@ -9486,6 +9438,119 @@ function buildAutoCheckpoint(input2) {
   };
 }
 
+// src/lib/memory-queue-client.ts
+init_exe_daemon_client();
+
+// src/lib/memory-queue.ts
+init_config();
+import { appendFileSync as appendFileSync2, readFileSync as readFileSync15, renameSync as renameSync4, unlinkSync as unlinkSync9, existsSync as existsSync17, statSync as statSync2 } from "fs";
+import path21 from "path";
+var QUEUE_PATH2 = path21.join(EXE_AI_DIR, "memory-queue.jsonl");
+var PROCESSING_PATH = QUEUE_PATH2 + ".processing";
+var TTL_MS2 = 24 * 60 * 60 * 1e3;
+function enqueueMemory(entry) {
+  appendFileSync2(QUEUE_PATH2, JSON.stringify(entry) + "\n");
+}
+
+// src/lib/memory-queue-client.ts
+async function writeMemoryViaDaemon(entry) {
+  if (process.env.EXE_IS_DAEMON === "1") {
+    enqueueMemory(entry);
+    return false;
+  }
+  if (!isClientConnected()) {
+    enqueueMemory(entry);
+    return false;
+  }
+  try {
+    const response = await sendDaemonRequest({
+      type: "write-memory",
+      entry
+    });
+    if (response.ok) return true;
+    enqueueMemory(entry);
+    return false;
+  } catch {
+    enqueueMemory(entry);
+    return false;
+  }
+}
+
+// src/lib/checkpoint-orchestrator.ts
+function toolNameForReason(reason) {
+  switch (reason) {
+    case "periodic":
+      return "auto-summary";
+    case "session-end":
+      return "SessionEnd";
+    case "pre-compact":
+      return "pre-compact-hook";
+    case "capacity-signal":
+      return "auto-checkpoint";
+  }
+}
+function importanceForReason(reason, override) {
+  if (override !== void 0) return override;
+  switch (reason) {
+    case "periodic":
+      return 7;
+    case "session-end":
+    case "pre-compact":
+    case "capacity-signal":
+      return 8;
+  }
+}
+function buildContinuityCheckpoint(input2) {
+  const { checkpointText, decisionTexts } = buildAutoCheckpoint({
+    agentId: input2.agentId,
+    agentRole: input2.agentRole,
+    sessionId: input2.sessionId,
+    projectName: input2.projectName,
+    reason: input2.reason,
+    memories: input2.memories ?? [],
+    tasks: input2.tasks ?? [],
+    maxSamples: input2.maxSamples
+  });
+  const extra = input2.extraSections?.filter((section) => section.trim().length > 0) ?? [];
+  return {
+    checkpointText: extra.length > 0 ? `${checkpointText}
+
+${extra.join("\n\n")}` : checkpointText,
+    decisionTexts
+  };
+}
+async function writeContinuityCheckpoint(input2) {
+  const result = buildContinuityCheckpoint(input2);
+  const now = (/* @__PURE__ */ new Date()).toISOString();
+  await writeMemoryViaDaemon({
+    raw_text: result.checkpointText,
+    agent_id: input2.agentId,
+    agent_role: input2.agentRole,
+    session_id: input2.sessionId,
+    tool_name: toolNameForReason(input2.reason),
+    project_name: input2.projectName,
+    timestamp: now,
+    importance: importanceForReason(input2.reason, input2.importance),
+    task_id: input2.taskId,
+    memory_type: "checkpoint"
+  });
+  const decisionLimit = input2.reason === "periodic" ? 3 : 5;
+  for (const decisionText of result.decisionTexts.slice(0, decisionLimit)) {
+    await writeMemoryViaDaemon({
+      raw_text: decisionText,
+      agent_id: input2.agentId,
+      agent_role: input2.agentRole,
+      session_id: input2.sessionId,
+      tool_name: "auto-decision",
+      project_name: input2.projectName,
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      importance: 8,
+      memory_type: "decision"
+    });
+  }
+  return result;
+}
+
 // src/adapters/claude/hooks/session-end.ts
 if (!process.env.AGENT_ID) {
   process.env.AGENT_ID = "default";
@@ -9535,7 +9600,7 @@ Orphaned tasks at session end: ${orphanResult.rows.map((r) => `"${String(r.title
                 ORDER BY priority ASC, updated_at DESC LIMIT 10`,
           args: [agent.agentId, ...seScope.args]
         });
-        const { checkpointText, decisionTexts } = buildAutoCheckpoint({
+        await writeContinuityCheckpoint({
           agentId: agent.agentId,
           agentRole: agent.agentRole,
           sessionId: data.session_id,
@@ -9543,35 +9608,9 @@ Orphaned tasks at session end: ${orphanResult.rows.map((r) => `"${String(r.title
           reason: "session-end",
           memories: recent.rows,
           tasks: taskRows.rows,
-          maxSamples: 12
+          maxSamples: 12,
+          extraSections: orphanInfo ? [`## Session-End Warnings${orphanInfo}`] : []
         });
-        const { writeMemoryViaDaemon: writeMemoryViaDaemon2 } = await Promise.resolve().then(() => (init_memory_queue_client(), memory_queue_client_exports));
-        await writeMemoryViaDaemon2({
-          raw_text: `${checkpointText}${orphanInfo ? `
-
-## Session-End Warnings${orphanInfo}` : ""}`,
-          agent_id: agent.agentId,
-          agent_role: agent.agentRole,
-          session_id: data.session_id,
-          tool_name: "SessionEnd",
-          project_name: projectName,
-          timestamp: (/* @__PURE__ */ new Date()).toISOString(),
-          importance: 8,
-          memory_type: "checkpoint"
-        });
-        for (const decisionText of decisionTexts.slice(0, 5)) {
-          await writeMemoryViaDaemon2({
-            raw_text: decisionText,
-            agent_id: agent.agentId,
-            agent_role: agent.agentRole,
-            session_id: data.session_id,
-            tool_name: "auto-decision",
-            project_name: projectName,
-            timestamp: (/* @__PURE__ */ new Date()).toISOString(),
-            importance: 8,
-            memory_type: "decision"
-          });
-        }
         try {
           const { clearSessionFileReads: clearSessionFileReads2 } = await Promise.resolve().then(() => (init_git_staleness(), git_staleness_exports));
           await clearSessionFileReads2(data.session_id);

package/dist/hooks/session-start.js

@@ -149,6 +149,11 @@ function normalizeAutoUpdate(raw) {
   const userAU = raw.autoUpdate ?? {};
   raw.autoUpdate = { ...defaultAU, ...userAU };
 }
+function normalizeOrchestration(raw) {
+  const defaultOrg = DEFAULT_CONFIG.orchestration;
+  const userOrg = raw.orchestration ?? {};
+  raw.orchestration = { ...defaultOrg, ...userOrg };
+}
 async function loadConfig() {
   const dir = process.env.EXE_OS_DIR ?? process.env.EXE_MEM_DIR ?? EXE_AI_DIR;
   await ensurePrivateDir(dir);
@@ -173,6 +178,7 @@ async function loadConfig() {
     normalizeScalingRoadmap(migratedCfg);
     normalizeSessionLifecycle(migratedCfg);
     normalizeAutoUpdate(migratedCfg);
+    normalizeOrchestration(migratedCfg);
     const config = { ...DEFAULT_CONFIG, dbPath: path.join(dir, "memories.db"), ...migratedCfg };
     if (config.dbPath.startsWith("~")) {
       config.dbPath = config.dbPath.replace(/^~/, os.homedir());
@@ -196,6 +202,7 @@ function loadConfigSync() {
     normalizeScalingRoadmap(migratedCfg);
     normalizeSessionLifecycle(migratedCfg);
     normalizeAutoUpdate(migratedCfg);
+    normalizeOrchestration(migratedCfg);
     return { ...DEFAULT_CONFIG, dbPath: path.join(dir, "memories.db"), ...migratedCfg };
   } catch {
     return { ...DEFAULT_CONFIG, dbPath: path.join(dir, "memories.db") };
@@ -217,6 +224,7 @@ async function loadConfigFrom(configPath) {
     normalizeScalingRoadmap(migratedCfg);
     normalizeSessionLifecycle(migratedCfg);
     normalizeAutoUpdate(migratedCfg);
+    normalizeOrchestration(migratedCfg);
     return { ...DEFAULT_CONFIG, ...migratedCfg };
   } catch {
     return { ...DEFAULT_CONFIG };
@@ -288,6 +296,10 @@ var init_config = __esm({
         checkOnBoot: true,
         autoInstall: false,
         checkIntervalMs: 24 * 60 * 60 * 1e3
+      },
+      orchestration: {
+        phase: "phase_1_coo",
+        phaseSetBy: "default"
       }
     };
     CONFIG_MIGRATIONS = [
@@ -4238,6 +4250,12 @@ var init_platform_procedures = __esm({
         priority: "p0",
         content: "Founder -> coordinator (the executive agent, internally routed as 'COO') -> CTO/CMO. CTO -> engineers. CMO -> content production. Never skip levels: the coordinator does not bypass managers for specialist work. Specialists report to their manager. If you need cross-team info, use ask_team_memory \u2014 don't read other agents' task folders. Each level owns dispatch downward and review upward."
       },
+      {
+        title: "Customer orchestration maturity \u2014 recommend, never trap",
+        domain: "workflow",
+        priority: "p1",
+        content: "New customers start best in Phase 1: founder \u2194 coordinator/Chief of Staff, building company context. Suggest Phase 2 executives when domain work repeats; suggest Phase 3 parallel execution only when review/permission gates are ready. This is guidance, not a blocker: users may jump phases anytime. Never overwrite their phase, role titles, identities, or custom org design."
+      },
       {
         title: "Single dispatch path \u2014 create_task only",
         domain: "workflow",
@@ -4296,6 +4314,12 @@ var init_platform_procedures = __esm({
         priority: "p0",
         content: "exe-build-adv is MANDATORY for ALL work touching 3+ files. Run /exe-build-adv --auto BEFORE implementation. Pipeline: Spec \u2192 AC \u2192 Tests \u2192 Evaluate \u2192 Fix. No multi-file feature ships without pipeline artifacts. No exceptions \u2014 managers reject work without them."
       },
+      {
+        title: "Commit discipline \u2014 never leave verified work floating",
+        domain: "workflow",
+        priority: "p1",
+        content: "After any code-change batch passes typecheck/tests/build, run git status, summarize changed files, and commit with a clear message before ending the session. If work must remain uncommitted for review/dogfood, explicitly say so, list the files, and state the blocker. Never imply work is complete while verified changes are still floating locally."
+      },
       {
         title: "Desktop and TUI are the same product",
         domain: "architecture",
@@ -8055,6 +8079,115 @@ var init_identity = __esm({
   }
 });
 
+// src/lib/orchestration-phase.ts
+var orchestration_phase_exports = {};
+__export(orchestration_phase_exports, {
+  ORCHESTRATION_PHASES: () => ORCHESTRATION_PHASES,
+  applyDefaultOrchestrationPhase: () => applyDefaultOrchestrationPhase,
+  getConfigOrchestrationPhase: () => getConfigOrchestrationPhase,
+  getOrchestrationPhaseInfo: () => getOrchestrationPhaseInfo,
+  loadOrchestrationPhase: () => loadOrchestrationPhase,
+  normalizeOrchestrationPhase: () => normalizeOrchestrationPhase,
+  phaseReminderLine: () => phaseReminderLine,
+  setOrchestrationPhase: () => setOrchestrationPhase
+});
+function normalizeOrchestrationPhase(input2) {
+  if (typeof input2 !== "string") return "phase_1_coo";
+  const normalized = input2.trim().toLowerCase().replace(/\s+/g, "_");
+  if (["1", "phase1", "phase_1", "coo", "coo_mode", "chief_of_staff", "phase_1_coo"].includes(normalized)) {
+    return "phase_1_coo";
+  }
+  if (["2", "phase2", "phase_2", "executives", "executive", "executive_bench", "phase_2_executives"].includes(normalized)) {
+    return "phase_2_executives";
+  }
+  if (["3", "phase3", "phase_3", "parallel", "parallel_org", "parallel_execution", "phase_3_parallel_org"].includes(normalized)) {
+    return "phase_3_parallel_org";
+  }
+  if (ORCHESTRATION_PHASES.includes(normalized)) return normalized;
+  return "phase_1_coo";
+}
+function getOrchestrationPhaseInfo(phase) {
+  return PHASE_INFO[normalizeOrchestrationPhase(phase)];
+}
+function getConfigOrchestrationPhase(config) {
+  const orchestration = config.orchestration;
+  return normalizeOrchestrationPhase(orchestration?.phase);
+}
+function applyDefaultOrchestrationPhase(config) {
+  if (!config.orchestration) {
+    config.orchestration = {
+      phase: "phase_1_coo",
+      phaseSetAt: (/* @__PURE__ */ new Date()).toISOString(),
+      phaseSetBy: "setup-default"
+    };
+    return config;
+  }
+  if (!config.orchestration.phase) {
+    config.orchestration = {
+      ...config.orchestration,
+      phase: "phase_1_coo",
+      phaseSetAt: config.orchestration.phaseSetAt ?? (/* @__PURE__ */ new Date()).toISOString(),
+      phaseSetBy: config.orchestration.phaseSetBy ?? "setup-default"
+    };
+  }
+  return config;
+}
+async function loadOrchestrationPhase() {
+  const config = await loadConfig();
+  return getOrchestrationPhaseInfo(config.orchestration?.phase);
+}
+async function setOrchestrationPhase(phaseInput, setBy = "user") {
+  const config = await loadConfig();
+  const phase = normalizeOrchestrationPhase(phaseInput);
+  config.orchestration = {
+    ...config.orchestration ?? {},
+    phase,
+    phaseSetAt: (/* @__PURE__ */ new Date()).toISOString(),
+    phaseSetBy: setBy
+  };
+  await saveConfig(config);
+  return getOrchestrationPhaseInfo(phase);
+}
+function phaseReminderLine(phase) {
+  const info = getOrchestrationPhaseInfo(phase);
+  return `${info.shortLabel}: ${info.focus}. ${info.nextSuggestion}`;
+}
+var ORCHESTRATION_PHASES, PHASE_INFO;
+var init_orchestration_phase = __esm({
+  "src/lib/orchestration-phase.ts"() {
+    "use strict";
+    init_config();
+    ORCHESTRATION_PHASES = [
+      "phase_1_coo",
+      "phase_2_executives",
+      "phase_3_parallel_org"
+    ];
+    PHASE_INFO = {
+      phase_1_coo: {
+        phase: "phase_1_coo",
+        shortLabel: "Phase 1 \u2014 COO mode",
+        label: "Phase 1 \u2014 COO / Chief of Staff mode",
+        focus: "building company context before delegation",
+        nextSuggestion: "Unlock executives when technical, marketing, ops, legal, or finance work repeats."
+      },
+      phase_2_executives: {
+        phase: "phase_2_executives",
+        shortLabel: "Phase 2 \u2014 Executive bench",
+        label: "Phase 2 \u2014 Executive bench",
+        focus: "COO works with domain executives like CTO/CMO before specialist fan-out",
+        nextSuggestion: "Unlock parallel execution when review gates, permissions, and workflows are ready."
+      },
+      phase_3_parallel_org: {
+        phase: "phase_3_parallel_org",
+        shortLabel: "Phase 3 \u2014 Parallel org",
+        label: "Phase 3 \u2014 Parallel execution org",
+        focus: "executives can delegate to specialists in parallel with review gates",
+        nextSuggestion: "Keep review/CI/permission gates healthy; downgrade anytime if you want simpler COO-only mode."
+      }
+    };
+  }
+});
+
 // src/adapters/claude/hooks/session-start.ts
 init_config();
 import path21 from "path";
@@ -8236,6 +8369,15 @@ You are **${title}**${role ? ` (${role})` : ""}. ${firstLine}
       } catch {
       }
     }
+    try {
+      const { loadOrchestrationPhase: loadOrchestrationPhase2 } = await Promise.resolve().then(() => (init_orchestration_phase(), orchestration_phase_exports));
+      const phase = await loadOrchestrationPhase2();
+      additionalContext += `## Orchestration Phase
+${phase.label}. Focus: ${phase.focus}. This is guidance, not a blocker; the user can switch phases anytime. ${phase.nextSuggestion}
+
+`;
+    } catch {
+    }
     if (memories.length > 0) {
       const brief = memories.map(
         (m) => `[${m.timestamp}] ${m.tool_name}: ${m.raw_text.slice(0, 200)}`