clikit-plugin 0.2.45 → 0.2.47

package/dist/index.js

@@ -16196,12 +16196,21 @@ var DEFAULT_CONFIG = {
   commands: {},
   skills: {},
   lsp: {},
+  workflow: {
+    mode: "compressed",
+    active_roles: ["build", "plan", "review", "coordinator"],
+    use_packets: true,
+    embed_verify_in_start: true,
+    verify_is_audit: true,
+    subagent_call_budget: 2
+  },
   hooks: {
     session_logging: false,
     tool_logging: false,
     todo_enforcer: {
       enabled: true,
-      warn_on_incomplete: true
+      warn_on_incomplete: false,
+      beads_authoritative: true
     },
     empty_message_sanitizer: {
       enabled: true,
@@ -16225,25 +16234,22 @@ var DEFAULT_CONFIG = {
       max_output_lines: 500,
       preserve_head_lines: 50,
       preserve_tail_lines: 50,
-      log: false
-    },
-    swarm_enforcer: {
-      enabled: true,
-      strict_file_locking: true,
-      block_unreserved_edits: false,
+      packet_friendly: true,
       log: false
     },
     memory_digest: {
       enabled: true,
-      max_per_type: 10,
+      max_per_type: 5,
       include_types: ["decision", "learning", "blocker", "progress", "handoff"],
-      index_highlights_per_type: 2,
+      index_highlights_per_type: 1,
       write_topic_files: true,
+      compact_mode: true,
       log: false
     },
     todo_beads_sync: {
-      enabled: true,
+      enabled: false,
       close_missing: true,
+      mode: "disabled",
       log: false
     },
     cass_memory: {
@@ -16256,8 +16262,10 @@ var DEFAULT_CONFIG = {
     },
     beads_context: {
       enabled: true,
-      max_issues: 20,
+      max_issues: 8,
       include_closed: false,
+      active_only: true,
+      ready_limit: 3,
       log: false
     }
   }
@@ -16550,7 +16558,7 @@ function checkTodoCompletion(todos) {
     inProgress
   };
 }
-function formatIncompleteWarning(result, sessionId) {
+function formatIncompleteWarning(result, sessionId, beadsAuthoritative) {
   const safeResult = normalizeTodoResult(result);
   const lines = [];
   if (sessionId) {
@@ -16567,7 +16575,7 @@ function formatIncompleteWarning(result, sessionId) {
     safeResult.incomplete.forEach((t) => lines.push(`    - [${t.id}] ${t.content}`));
   }
   lines.push("");
-  lines.push("  Complete all todos before finishing.");
+  lines.push(beadsAuthoritative ? "  Todos are informational only here \u2014 update/close the active Beads issue instead." : "  Complete all todos before finishing.");
   return lines.join(`
 `);
 }
@@ -16890,90 +16898,9 @@ function formatTruncationLog(result) {
   const saved = result.originalLength - result.truncatedLength;
   return `[CliKit:truncator] Truncated output: ${result.originalLines} \u2192 ${result.truncatedLines} lines, saved ${(saved / 1024).toFixed(1)}KB`;
 }
-// src/hooks/swarm-enforcer.ts
-import * as path6 from "path";
-function isFileInScope(filePath, scope) {
-  if (typeof filePath !== "string")
-    return false;
-  const normalizedPath = path6.resolve(filePath);
-  for (const reserved of scope.reservedFiles) {
-    const normalizedReserved = path6.resolve(reserved);
-    if (normalizedPath === normalizedReserved) {
-      return true;
-    }
-  }
-  if (scope.allowedPatterns) {
-    for (const pattern of scope.allowedPatterns) {
-      if (normalizedPath.includes(pattern) || normalizedPath.startsWith(path6.resolve(pattern))) {
-        return true;
-      }
-    }
-  }
-  return false;
-}
-function checkEditPermission(filePath, scope, config2) {
-  if (!scope) {
-    return { allowed: true };
-  }
-  if (config2?.strict_file_locking === false) {
-    return { allowed: true };
-  }
-  if (typeof filePath !== "string") {
-    return { allowed: false, reason: "Invalid file path" };
-  }
-  if (isFileInScope(filePath, scope)) {
-    return { allowed: true, file: filePath };
-  }
-  return {
-    allowed: false,
-    file: filePath,
-    reason: `File is not in task scope for task ${scope.taskId}`,
-    suggestion: `Reserve the file first using beads-village reserve, or ask the lead agent to reassign.`
-  };
-}
-function extractFileFromToolInput(toolName, input) {
-  if (typeof toolName !== "string")
-    return;
-  switch (toolName.toLowerCase()) {
-    case "edit":
-    case "write":
-    case "read":
-      return input.filePath;
-    case "bash": {
-      const cmd = input.command;
-      if (!cmd)
-        return;
-      const writePatterns = [
-        />\s*["']?([^\s"'|&;]+)/,
-        /tee\s+["']?([^\s"'|&;]+)/,
-        /mv\s+\S+\s+["']?([^\s"'|&;]+)/,
-        /cp\s+\S+\s+["']?([^\s"'|&;]+)/
-      ];
-      for (const pattern of writePatterns) {
-        const match = cmd.match(pattern);
-        if (match)
-          return match[1];
-      }
-      return;
-    }
-    default:
-      return;
-  }
-}
-function formatEnforcementWarning(result) {
-  if (result.allowed)
-    return "";
-  const lines = [`[CliKit:swarm-enforcer] BLOCKED edit to ${result.file}`];
-  if (result.reason)
-    lines.push(`  Reason: ${result.reason}`);
-  if (result.suggestion)
-    lines.push(`  Suggestion: ${result.suggestion}`);
-  return lines.join(`
-`);
-}
 // src/hooks/memory-digest.ts
 import * as fs6 from "fs";
-import * as path7 from "path";
+import * as path6 from "path";
 import { Database } from "bun:sqlite";
 function parseJsonArray(value) {
   if (typeof value !== "string" || !value.trim())
@@ -16993,7 +16920,7 @@ function formatDate(iso) {
   }
 }
 function writeTopicFile(memoryDir, type, heading, rows) {
-  const topicPath = path7.join(memoryDir, `${type}.md`);
+  const topicPath = path6.join(memoryDir, `${type}.md`);
   const lines = [];
   lines.push(`# ${heading}`);
   lines.push("");
@@ -17041,13 +16968,14 @@ function generateMemoryDigest(projectDir, config2) {
   const result = { written: false, path: "", counts: {} };
   if (typeof projectDir !== "string" || !projectDir)
     return result;
-  const memoryDir = path7.join(projectDir, ".opencode", "memory");
-  const dbPath = path7.join(memoryDir, "memory.db");
+  const memoryDir = path6.join(projectDir, ".opencode", "memory");
+  const dbPath = path6.join(memoryDir, "memory.db");
   if (!fs6.existsSync(dbPath)) {
     return result;
   }
-  const maxPerType = config2?.max_per_type ?? 10;
-  const indexHighlightsPerType = config2?.index_highlights_per_type ?? 2;
+  const compactMode = config2?.compact_mode !== false;
+  const maxPerType = config2?.max_per_type ?? (compactMode ? 5 : 10);
+  const indexHighlightsPerType = config2?.index_highlights_per_type ?? (compactMode ? 1 : 2);
   const writeTopicFiles = config2?.write_topic_files !== false;
   const includeTypes = config2?.include_types ?? [
     "decision",
@@ -17091,7 +17019,8 @@ function generateMemoryDigest(projectDir, config2) {
         const date5 = formatDate(row.created_at);
         const headline = row.narrative.split(`
 `)[0];
-        sections.push(`- ${date5}: ${headline}`);
+        const beadNote = row.bead_id ? ` [${row.bead_id}]` : "";
+        sections.push(`- ${date5}${beadNote}: ${headline}`);
       }
       sections.push("");
       if (writeTopicFiles) {
@@ -17106,7 +17035,7 @@ function generateMemoryDigest(projectDir, config2) {
     sections.push("*No observations found in memory database.*");
     sections.push("");
   }
-  const digestPath = path7.join(memoryDir, "_digest.md");
+  const digestPath = path6.join(memoryDir, "_digest.md");
   const content = sections.join(`
 `);
   try {
@@ -17128,7 +17057,7 @@ function formatDigestLog(result) {
 }
 // src/hooks/todo-beads-sync.ts
 import * as fs7 from "fs";
-import * as path8 from "path";
+import * as path7 from "path";
 import { Database as Database2 } from "bun:sqlite";
 import { execFile } from "child_process";
 import { promisify } from "util";
@@ -17272,7 +17201,18 @@ function syncTodosToBeadsAttempt(beadsDbPath, sessionID, todos, config2) {
   }
 }
 function syncTodosToBeads(projectDirectory, sessionID, todos, config2) {
-  const beadsDbPath = path8.join(projectDirectory, ".beads", "beads.db");
+  if (config2?.mode === "disabled" || config2?.enabled === false) {
+    return {
+      synced: false,
+      sessionID,
+      totalTodos: todos.length,
+      created: 0,
+      updated: 0,
+      closed: 0,
+      skippedReason: "Todo sync disabled; Beads is authoritative"
+    };
+  }
+  const beadsDbPath = path7.join(projectDirectory, ".beads", "beads.db");
   if (!fs7.existsSync(beadsDbPath)) {
     return {
       synced: false,
@@ -17303,7 +17243,7 @@ function syncTodosToBeads(projectDirectory, sessionID, todos, config2) {
   throw lastError instanceof Error ? lastError : new Error("Todo-Beads sync failed after retries");
 }
 function flushBeadsJsonl(projectDirectory, result) {
-  const jsonlPath = path8.join(projectDirectory, ".beads", "issues.jsonl");
+  const jsonlPath = path7.join(projectDirectory, ".beads", "issues.jsonl");
   execFileAsync("bd", ["export", "--force", "-o", jsonlPath], {
     cwd: projectDirectory,
     timeout: 5000
@@ -17321,7 +17261,7 @@ function formatTodoBeadsSyncLog(result) {
 }
 // src/hooks/beads-context.ts
 import * as fs8 from "fs";
-import * as path9 from "path";
+import * as path8 from "path";
 import { Database as Database3 } from "bun:sqlite";
 var BEADS_CONTEXT_BUSY_TIMEOUT_MS = 2000;
 var PRIORITY_LABELS = {
@@ -17337,7 +17277,7 @@ var STATUS_ICONS = {
   closed: "\u2713"
 };
 function openBeadsDbReadonly(projectDirectory) {
-  const beadsDbPath = path9.join(projectDirectory, ".beads", "beads.db");
+  const beadsDbPath = path8.join(projectDirectory, ".beads", "beads.db");
   if (!fs8.existsSync(beadsDbPath)) {
     return null;
   }
@@ -17349,6 +17289,67 @@ function openBeadsDbReadonly(projectDirectory) {
     return null;
   }
 }
+function formatIssueLine(issue2) {
+  const icon = STATUS_ICONS[issue2.status] ?? "?";
+  const priority = PRIORITY_LABELS[issue2.priority] ?? `p${issue2.priority}`;
+  const assignee = issue2.assignee ? ` @${issue2.assignee}` : "";
+  return `- ${icon} \`${issue2.id}\` **${issue2.title}** (${priority}${assignee})`;
+}
+function formatCompressedBeadsSnapshot(issues, config2) {
+  if (issues.length === 0) {
+    return null;
+  }
+  const inProgress = issues.filter((issue2) => issue2.status === "in_progress");
+  const ready = issues.filter((issue2) => issue2.status === "open");
+  const includeClosed = config2?.include_closed === true;
+  const closed = includeClosed ? issues.filter((issue2) => issue2.status === "closed") : [];
+  const readyLimit = config2?.ready_limit ?? 3;
+  const activeOnly = config2?.active_only !== false;
+  const lines = [
+    "## Beads Task State",
+    "",
+    "Beads is the live execution source of truth. Prefer the active issue and its direct dependencies.",
+    ""
+  ];
+  if (inProgress.length > 0) {
+    lines.push("### Active Issue");
+    lines.push(formatIssueLine(inProgress[0]));
+    if (inProgress.length > 1) {
+      lines.push(`- +${inProgress.length - 1} additional in-progress issue(s)`);
+    }
+    lines.push("");
+  }
+  if (!activeOnly && ready.length > 0) {
+    lines.push("### Ready Queue");
+    for (const issue2 of ready.slice(0, readyLimit)) {
+      lines.push(formatIssueLine(issue2));
+    }
+    if (ready.length > readyLimit) {
+      lines.push(`- +${ready.length - readyLimit} more ready issue(s)`);
+    }
+    lines.push("");
+  } else if (activeOnly && ready.length > 0 && inProgress.length === 0) {
+    lines.push("### Ready Queue (fallback)");
+    for (const issue2 of ready.slice(0, readyLimit)) {
+      lines.push(formatIssueLine(issue2));
+    }
+    if (ready.length > readyLimit) {
+      lines.push(`- +${ready.length - readyLimit} more ready issue(s)`);
+    }
+    lines.push("");
+  } else if (activeOnly && ready.length > 0) {
+    lines.push(`Ready queue hidden (active_only=true, ${ready.length} ready issue(s) available).`);
+    lines.push("");
+  }
+  if (closed.length > 0) {
+    lines.push(`Recently closed available on demand: ${closed.length}`);
+    lines.push("");
+  }
+  lines.push("Use `mcp__beads_village__show({id})` for full details.");
+  lines.push("Use `mcp__beads_village__claim()` only when starting the next packet.");
+  return lines.join(`
+`);
+}
 function getBeadsSnapshot(projectDirectory, config2) {
   const db = openBeadsDbReadonly(projectDirectory);
   if (!db) {
@@ -17371,55 +17372,16 @@ function getBeadsSnapshot(projectDirectory, config2) {
     if (issues.length === 0) {
       return null;
     }
-    const countByStatus = {};
-    for (const issue2 of issues) {
-      countByStatus[issue2.status] = (countByStatus[issue2.status] ?? 0) + 1;
-    }
-    const statusSummary = Object.entries(countByStatus).map(([status, count]) => `${status}: ${count}`).join(", ");
-    const lines = [
-      `## Active Beads Issues (${statusSummary})`,
-      ""
-    ];
-    const inProgress = issues.filter((i) => i.status === "in_progress");
-    const open = issues.filter((i) => i.status === "open");
-    const closed = issues.filter((i) => i.status === "closed");
-    if (inProgress.length > 0) {
-      lines.push("### In Progress");
-      for (const issue2 of inProgress) {
-        lines.push(formatIssueLine(issue2));
-      }
-      lines.push("");
-    }
-    if (open.length > 0) {
-      lines.push("### Ready");
-      for (const issue2 of open) {
-        lines.push(formatIssueLine(issue2));
-      }
-      lines.push("");
-    }
-    if (closed.length > 0 && includeClosed) {
-      lines.push("### Recently Closed");
-      for (const issue2 of closed) {
-        lines.push(formatIssueLine(issue2));
-      }
-      lines.push("");
-    }
-    lines.push("Use `mcp__beads_village__show({id})` to see full issue details.");
-    lines.push("Use `mcp__beads_village__claim()` to pick up the next ready task.");
-    return lines.join(`
-`);
+    return formatCompressedBeadsSnapshot(issues, {
+      ...config2,
+      include_closed: includeClosed
+    });
   } catch {
     return null;
   } finally {
     db.close();
   }
 }
-function formatIssueLine(issue2) {
-  const icon = STATUS_ICONS[issue2.status] ?? "?";
-  const priority = PRIORITY_LABELS[issue2.priority] ?? `p${issue2.priority}`;
-  const assignee = issue2.assignee ? ` @${issue2.assignee}` : "";
-  return `- ${icon} \`${issue2.id}\` **${issue2.title}** (${priority}${assignee})`;
-}
 function getBeadsCompactionContext(projectDirectory, config2) {
   const snapshot = getBeadsSnapshot(projectDirectory, {
     ...config2,
@@ -17432,8 +17394,8 @@ function getBeadsCompactionContext(projectDirectory, config2) {
   return [
     "## Beads Task State (Source of Truth)",
     "",
-    "The following Beads issues represent the canonical task state.",
-    "Preserve this context across compaction \u2014 it takes priority over OpenCode todos.",
+    "Preserve active Beads task state across compaction. Prefer the active issue and direct packet scope.",
+    "OpenCode todos are informational only when Beads state is available.",
     "",
     snapshot
   ].join(`
@@ -17445,11 +17407,11 @@ import { promisify as promisify2 } from "util";
 
 // src/tools/memory-db.ts
 import * as fs9 from "fs";
-import * as path10 from "path";
+import * as path9 from "path";
 import { Database as Database4 } from "bun:sqlite";
 function getMemoryPaths(projectDir = process.cwd()) {
-  const memoryDir = path10.join(projectDir, ".opencode", "memory");
-  const memoryDbPath = path10.join(memoryDir, "memory.db");
+  const memoryDir = path9.join(projectDir, ".opencode", "memory");
+  const memoryDbPath = path9.join(memoryDir, "memory.db");
   return { memoryDir, memoryDbPath };
 }
 function ensureObservationSchema(db) {
@@ -17774,185 +17736,6 @@ async function cassMemoryReflect(params = {}) {
   return embeddedReflect(p);
 }
 
-// src/tools/swarm.ts
-var swarmState = {
-  planId: null,
-  tasks: new Map,
-  parallelism: 3
-};
-function swarm(params) {
-  if (!params || typeof params !== "object") {
-    return { planId: "none", tasks: [], parallelism: 3, estimatedTime: "0m" };
-  }
-  const p = params;
-  switch (p.operation) {
-    case "plan":
-      return swarmPlan(p);
-    case "monitor":
-      return swarmMonitor(p);
-    case "delegate":
-      return swarmDelegate(p);
-    case "abort":
-      return swarmAbort(p);
-    default:
-      return { planId: "none", tasks: [], parallelism: 3, estimatedTime: "0m" };
-  }
-}
-function swarmPlan(params) {
-  const planId = `swarm-${Date.now()}`;
-  swarmState.planId = planId;
-  swarmState.tasks.clear();
-  swarmState.parallelism = params.parallelism || 3;
-  for (const task of params.tasks) {
-    swarmState.tasks.set(task.id, { ...task, status: task.status || "pending" });
-  }
-  const completedDeps = findReadyTasks();
-  for (const taskId of completedDeps) {
-    const task = swarmState.tasks.get(taskId);
-    if (task && task.status === "pending") {
-      task.status = "in_progress";
-    }
-  }
-  return {
-    planId,
-    tasks: Array.from(swarmState.tasks.values()),
-    parallelism: swarmState.parallelism,
-    estimatedTime: estimateTime(params.tasks)
-  };
-}
-function swarmMonitor(params) {
-  const tasks = Array.from(swarmState.tasks.values());
-  if (params.taskId) {
-    const task = swarmState.tasks.get(params.taskId);
-    if (!task) {
-      throw new Error(`Task not found: ${params.taskId}`);
-    }
-  }
-  return {
-    planId: swarmState.planId || "none",
-    totalTasks: tasks.length,
-    completed: tasks.filter((t) => t.status === "completed").length,
-    inProgress: tasks.filter((t) => t.status === "in_progress").length,
-    pending: tasks.filter((t) => t.status === "pending").length,
-    failed: tasks.filter((t) => t.status === "failed").length,
-    tasks
-  };
-}
-function swarmDelegate(params) {
-  const task = swarmState.tasks.get(params.taskId);
-  if (!task) {
-    throw new Error(`Task not found: ${params.taskId}`);
-  }
-  task.agentRole = params.agentRole;
-  task.status = "in_progress";
-  return {
-    taskId: params.taskId,
-    delegatedTo: `@${params.agentRole}`,
-    status: "delegated"
-  };
-}
-function swarmAbort(params) {
-  const task = swarmState.tasks.get(params.taskId);
-  if (!task) {
-    throw new Error(`Task not found: ${params.taskId}`);
-  }
-  task.status = "failed";
-  return {
-    taskId: params.taskId,
-    aborted: true,
-    reason: params.reason
-  };
-}
-function findReadyTasks() {
-  const ready = [];
-  for (const [id, task] of swarmState.tasks) {
-    if (task.status !== "pending")
-      continue;
-    const deps = task.dependencies || [];
-    const allDepsComplete = deps.every((depId) => {
-      const dep = swarmState.tasks.get(depId);
-      return dep && dep.status === "completed";
-    });
-    if (allDepsComplete) {
-      ready.push(id);
-    }
-  }
-  return ready;
-}
-function estimateTime(tasks) {
-  const totalTasks = tasks.length;
-  const parallelism = swarmState.parallelism;
-  const avgTaskTime = 5;
-  const batches = Math.ceil(totalTasks / parallelism);
-  const totalMinutes = batches * avgTaskTime;
-  if (totalMinutes < 60) {
-    return `${totalMinutes} minutes`;
-  } else {
-    const hours = Math.floor(totalMinutes / 60);
-    const mins = totalMinutes % 60;
-    return `${hours}h ${mins}m`;
-  }
-}
-
-// src/tools/quick-research.ts
-function quickResearch(params) {
-  if (!params || typeof params !== "object") {
-    return {
-      query: "",
-      suggestion: "Invalid params provided"
-    };
-  }
-  const p = params;
-  if (!p.query || typeof p.query !== "string") {
-    return {
-      query: "",
-      suggestion: "Missing query parameter"
-    };
-  }
-  const sources = p.sources || ["memory", "context7", "github"];
-  const limit = p.limit || 5;
-  let memoryResults;
-  let context7Hint;
-  let githubHint;
-  if (sources.includes("memory")) {
-    try {
-      memoryResults = memorySearch({ query: p.query, limit });
-    } catch {}
-  }
-  if (sources.includes("context7")) {
-    context7Hint = `Use context7 MCP tool: context7_resolve-library-id({ libraryName: "${p.query}" }) then context7_query-docs()`;
-  }
-  if (sources.includes("github")) {
-    const langHint = p.language ? ` language:${p.language}` : "";
-    githubHint = `Use gh-grep MCP tool: gh-grep_searchGitHub({ query: "${p.query}${langHint}" })`;
-  }
-  const suggestion = buildSuggestion(p.query, memoryResults, sources);
-  return {
-    query: p.query,
-    memory: memoryResults,
-    context7Hint,
-    githubHint,
-    suggestion
-  };
-}
-function buildSuggestion(query, memoryResults, sources) {
-  const parts = [];
-  if (memoryResults && memoryResults.length > 0) {
-    parts.push(`Found ${memoryResults.length} relevant observations in memory.`);
-    parts.push(`Check memory-get({ ids: "${memoryResults.map((r) => r.id).join(",")}" }) for details.`);
-  }
-  if (sources?.includes("context7")) {
-    parts.push(`For library docs, run context7_resolve-library-id \u2192 context7_query-docs.`);
-  }
-  if (sources?.includes("github")) {
-    parts.push(`For code examples, run gh-grep_searchGitHub with your query.`);
-  }
-  if (parts.length === 0) {
-    parts.push(`No results found. Try broadening your query or checking different sources.`);
-  }
-  return parts.join(" ");
-}
-
 // src/tools/context-summary.ts
 function parseStringArray(value) {
   if (typeof value !== "string" || !value.trim()) {
@@ -18047,170 +17830,6 @@ function buildSummary(sections, maxTokens) {
   return summary;
 }
 
-// src/tools/beads-memory-sync.ts
-import * as path11 from "path";
-import * as fs10 from "fs";
-import { Database as Database5 } from "bun:sqlite";
-var BEADS_DIR = path11.join(process.cwd(), ".beads");
-function getMemoryDb2() {
-  return openMemoryDb();
-}
-function getBeadsDb() {
-  const beadsDbPath = path11.join(BEADS_DIR, "beads.db");
-  if (!fs10.existsSync(beadsDbPath)) {
-    return null;
-  }
-  return new Database5(beadsDbPath);
-}
-function beadsMemorySync(params) {
-  if (!params || typeof params !== "object") {
-    return { success: false, operation: "unknown", details: {} };
-  }
-  const p = params;
-  if (!p.operation) {
-    return { success: false, operation: "unknown", details: {} };
-  }
-  switch (p.operation) {
-    case "sync_to_memory":
-      return syncTasksToMemory();
-    case "sync_from_memory":
-      return syncMemoryToTasks();
-    case "link":
-      if (!p.beadId || !p.observationId) {
-        return { success: false, operation: "link", details: {} };
-      }
-      return linkObservationToTask(p.observationId, p.beadId);
-    case "status":
-      return getSyncStatus();
-    default:
-      return { success: false, operation: p.operation, details: {} };
-  }
-}
-function syncTasksToMemory() {
-  const beadsDb = getBeadsDb();
-  if (!beadsDb) {
-    return { success: false, operation: "sync_to_memory", details: { tasksSynced: 0 } };
-  }
-  const memoryDb = getMemoryDb2();
-  try {
-    const tasks = beadsDb.query(`
-      SELECT id, title, description, t, desc
-      FROM issues
-      WHERE status IN ('done', 'closed')
-    `).all();
-    let synced = 0;
-    const existsStmt = memoryDb.prepare(`
-      SELECT id FROM observations WHERE type = 'progress' AND bead_id = ? AND narrative = ? LIMIT 1
-    `);
-    const insertStmt = memoryDb.prepare(`
-      INSERT INTO observations (type, narrative, facts, bead_id)
-      VALUES ('progress', ?, '[]', ?)
-    `);
-    for (const task of tasks) {
-      const narrative = task.title || task.t || task.description || task.desc || task.id;
-      const existing = existsStmt.get(task.id, narrative);
-      if (existing) {
-        continue;
-      }
-      insertStmt.run(narrative, task.id);
-      synced += 1;
-    }
-    return {
-      success: true,
-      operation: "sync_to_memory",
-      details: { tasksSynced: synced }
-    };
-  } finally {
-    memoryDb.close();
-    beadsDb.close();
-  }
-}
-function syncMemoryToTasks() {
-  const beadsDb = getBeadsDb();
-  if (!beadsDb) {
-    return { success: false, operation: "sync_from_memory", details: {} };
-  }
-  const memoryDb = getMemoryDb2();
-  try {
-    beadsDb.exec(`
-      CREATE TABLE IF NOT EXISTS issue_observations (
-        issue_id TEXT NOT NULL,
-        observation_id INTEGER NOT NULL,
-        observation_type TEXT NOT NULL,
-        narrative TEXT NOT NULL,
-        synced_at TEXT DEFAULT CURRENT_TIMESTAMP,
-        PRIMARY KEY (issue_id, observation_id)
-      )
-    `);
-    const observations = memoryDb.query(`
-      SELECT id, type, narrative, bead_id
-      FROM observations
-      WHERE bead_id IS NOT NULL
-      AND type IN ('blocker', 'decision')
-    `).all();
-    let linked = 0;
-    const issueExistsStmt = beadsDb.prepare("SELECT id FROM issues WHERE id = ? LIMIT 1");
-    const linkStmt = beadsDb.prepare(`
-      INSERT OR IGNORE INTO issue_observations (issue_id, observation_id, observation_type, narrative)
-      VALUES (?, ?, ?, ?)
-    `);
-    for (const obs of observations) {
-      const existingIssue = issueExistsStmt.get(obs.bead_id);
-      if (!existingIssue) {
-        continue;
-      }
-      const result = linkStmt.run(obs.bead_id, obs.id, obs.type, obs.narrative);
-      if (result.changes > 0) {
-        linked += 1;
-      }
-    }
-    return {
-      success: true,
-      operation: "sync_from_memory",
-      details: { observationsLinked: linked }
-    };
-  } finally {
-    memoryDb.close();
-    beadsDb.close();
-  }
-}
-function linkObservationToTask(observationId, beadId) {
-  const memoryDb = getMemoryDb2();
-  try {
-    memoryDb.run("UPDATE observations SET bead_id = ? WHERE id = ?", [beadId, observationId]);
-    return {
-      success: true,
-      operation: "link",
-      details: { observationsLinked: 1 }
-    };
-  } finally {
-    memoryDb.close();
-  }
-}
-function getSyncStatus() {
-  const memoryDb = getMemoryDb2();
-  const beadsDb = getBeadsDb();
-  try {
-    const memoryCount = memoryDb.query("SELECT COUNT(*) as count FROM observations").get();
-    let activeTasks = 0;
-    if (beadsDb) {
-      const taskCount = beadsDb.query("SELECT COUNT(*) as count FROM issues WHERE status != 'closed'").get();
-      activeTasks = taskCount.count;
-    }
-    return {
-      success: true,
-      operation: "status",
-      details: {
-        memoryCount: memoryCount.count,
-        activeTasks
-      }
-    };
-  } finally {
-    memoryDb.close();
-    beadsDb?.close();
-  }
-}
-
 // src/index.ts
 var execFileAsync3 = promisify3(execFile3);
 var CliKitPlugin = async (ctx) => {
@@ -18348,6 +17967,127 @@ var CliKitPlugin = async (ctx) => {
     writeErrorLog(hookName, error45, ctx.directory, context);
     await cliLog("error", formatHookErrorLog(hookName, error45, context));
   }
+  function getEffectiveWorkflow() {
+    const raw = pluginConfig.workflow ?? {};
+    const classicMode = raw.mode === "classic";
+    return {
+      mode: classicMode ? "classic" : "compressed",
+      activeRoles: raw.active_roles || ["build", "plan", "review", "coordinator"],
+      usePackets: classicMode ? raw.use_packets === true : raw.use_packets !== false,
+      embedVerifyInStart: classicMode ? false : raw.embed_verify_in_start !== false,
+      verifyIsAudit: classicMode ? false : raw.verify_is_audit !== false,
+      subagentCallBudget: raw.subagent_call_budget ?? 2
+    };
+  }
+  function prependBlock(content, block) {
+    return `${block.trim()}
+
+${(content || "").trim()}`.trim();
+  }
+  function applyWorkflowOverridesToAgents(agents) {
+    const workflow = getEffectiveWorkflow();
+    const result = { ...agents };
+    const runtimeBlock = workflow.mode === "classic" ? [
+      "## Runtime Workflow Override",
+      "- Mode: classic",
+      `- Use packets: ${workflow.usePackets ? "yes" : "no"}`,
+      `- Subagent budget per unit of work: ${workflow.subagentCallBudget}`,
+      "- Do not assume `/start` embeds verification; `/verify` is the pre-ship gate \u2014 required before `/ship`."
+    ].join(`
+`) : [
+      "## Runtime Workflow Override",
+      "- Mode: compressed",
+      `- Use packets: ${workflow.usePackets ? "yes" : "no"}`,
+      `- Subagent budget per packet: ${workflow.subagentCallBudget}`,
+      workflow.embedVerifyInStart ? "- `/start` performs execute + verify loop." : "- `/start` performs execute only.",
+      workflow.verifyIsAudit ? "- `/verify` is optional deep audit." : "- `/verify` is the pre-ship gate \u2014 required before `/ship`."
+    ].join(`
+`);
+    for (const agentName of ["build", "plan", "review"]) {
+      const agent = result[agentName];
+      if (!agent)
+        continue;
+      result[agentName] = {
+        ...agent,
+        prompt: prependBlock(typeof agent.prompt === "string" ? agent.prompt : "", runtimeBlock)
+      };
+    }
+    return result;
+  }
+  function applyWorkflowOverridesToCommands(commands) {
+    const workflow = getEffectiveWorkflow();
+    const result = { ...commands };
+    if (workflow.mode === "classic") {
+      if (result.start?.template) {
+        result.start = {
+          ...result.start,
+          template: prependBlock(result.start.template, [
+            "## Runtime Workflow Override",
+            "- Classic mode is active.",
+            "- Implement using the approved plan/task boundaries.",
+            "- Verification remains a standalone `/verify` gate before `/ship`."
+          ].join(`
+`))
+        };
+      }
+      if (result.verify?.template) {
+        result.verify = {
+          ...result.verify,
+          template: prependBlock(result.verify.template, [
+            "## Runtime Workflow Override",
+            "- Classic mode is active.",
+            "- This verification pass is mandatory before ship."
+          ].join(`
+`))
+        };
+      }
+      if (result.ship?.template) {
+        result.ship = {
+          ...result.ship,
+          template: prependBlock(result.ship.template, [
+            "## Runtime Workflow Override",
+            "- Classic mode is active.",
+            "- Require `/verify` PASS before `/ship`."
+          ].join(`
+`))
+        };
+      }
+    }
+    if (!workflow.usePackets) {
+      for (const commandName of ["start"]) {
+        const command = result[commandName];
+        if (!command?.template)
+          continue;
+        result[commandName] = {
+          ...command,
+          template: prependBlock(command.template, [
+            "## Runtime Workflow Override",
+            "- Packetized execution is disabled.",
+            "- Fall back to approved task/file-impact boundaries from the plan."
+          ].join(`
+`))
+        };
+      }
+    }
+    return result;
+  }
+  function getWorkflowSystemCapsule() {
+    const workflow = getEffectiveWorkflow();
+    const roles = workflow.activeRoles.join(", ");
+    const budget = workflow.subagentCallBudget;
+    return [
+      "## CliKit Workflow Capsule",
+      "",
+      `Mode: ${workflow.mode}`,
+      `Active roles: ${roles}`,
+      workflow.usePackets ? "Execution unit: Task Packet (1 concern, 1-3 files, one verify bundle)" : "Execution unit: plan tasks with explicit file-impact boundaries",
+      "Source of truth: Beads live task state; OpenCode todos are informational only",
+      workflow.usePackets ? `Subagent budget per packet: ${budget}` : `Subagent budget per unit of work: ${budget}`,
+      workflow.embedVerifyInStart ? "`/start` performs execute + verify loop" : "`/start` performs execute only",
+      workflow.verifyIsAudit ? "`/verify` is an optional deep audit / pre-ship confidence pass" : "`/verify` is the mandatory pre-ship gate \u2014 ship only after SHIP_READY verdict"
+    ].join(`
+`);
+  }
   const pluginConfig = loadCliKitConfig(ctx.directory) ?? {};
   const debugLogsEnabled = pluginConfig.hooks?.session_logging === true && process.env.CLIKIT_DEBUG === "1";
   const toolLogsEnabled = pluginConfig.hooks?.tool_logging === true && process.env.CLIKIT_DEBUG === "1";
@@ -18359,8 +18099,8 @@ var CliKitPlugin = async (ctx) => {
   const builtinAgents = getBuiltinAgents();
   const builtinCommands = getBuiltinCommands();
   const builtinSkills = getBuiltinSkills();
-  const filteredAgents = filterAgents(builtinAgents, pluginConfig);
-  const filteredCommands = filterCommands(builtinCommands, pluginConfig);
+  const filteredAgents = applyWorkflowOverridesToAgents(filterAgents(builtinAgents, pluginConfig));
+  const filteredCommands = applyWorkflowOverridesToCommands(filterCommands(builtinCommands, pluginConfig));
   const filteredSkills = filterSkills(builtinSkills, pluginConfig);
   if (debugLogsEnabled) {
     cliLog("info", "[CliKit] Plugin initializing...");
@@ -18377,42 +18117,6 @@ var CliKitPlugin = async (ctx) => {
   }
   return {
     tool: {
-      swarm: tool({
-        description: "Plan, monitor, delegate, and abort tasks in a multi-agent swarm. Use operation=plan to decompose work into parallel tasks, operation=monitor to check progress, operation=delegate to assign a task to an agent role, operation=abort to cancel a task.",
-        args: {
-          operation: tool.schema.enum(["plan", "monitor", "delegate", "abort"]).describe("The swarm operation to perform"),
-          tasks: tool.schema.array(tool.schema.object({
-            id: tool.schema.string(),
-            title: tool.schema.string(),
-            description: tool.schema.string(),
-            dependencies: tool.schema.array(tool.schema.string()).optional(),
-            agentRole: tool.schema.enum(["fe", "be", "mobile", "devops", "qa"]).optional(),
-            files: tool.schema.array(tool.schema.string()).optional(),
-            status: tool.schema.enum(["pending", "in_progress", "completed", "failed", "blocked"])
-          })).optional().describe("Tasks for operation=plan"),
-          parallelism: tool.schema.number().optional().describe("Max parallel tasks (default 3)"),
-          taskId: tool.schema.string().optional().describe("Task ID for operation=monitor|delegate|abort"),
-          agentRole: tool.schema.enum(["fe", "be", "mobile", "devops", "qa"]).optional().describe("Role to delegate to for operation=delegate"),
-          reason: tool.schema.string().optional().describe("Abort reason for operation=abort")
-        },
-        async execute(args) {
-          const result = swarm(args);
-          return JSON.stringify(result, null, 2);
-        }
-      }),
-      quick_research: tool({
-        description: "Search local memory observations and get hints for context7 and GitHub code search. Use this before starting research to check what's already known.",
-        args: {
-          query: tool.schema.string().describe("Search query"),
-          sources: tool.schema.array(tool.schema.enum(["memory", "context7", "github"])).optional().describe("Sources to search (default: all)"),
-          language: tool.schema.string().optional().describe("Language filter for GitHub search"),
-          limit: tool.schema.number().optional().describe("Max memory results (default 5)")
-        },
-        async execute(args) {
-          const result = quickResearch(args);
-          return JSON.stringify(result, null, 2);
-        }
-      }),
       context_summary: tool({
         description: "Summarize memory observations (decisions, learnings, blockers, progress) into a structured context digest. Useful for compaction or session handoff.",
         args: {
@@ -18424,18 +18128,6 @@ var CliKitPlugin = async (ctx) => {
           const result = contextSummary(args);
           return JSON.stringify(result, null, 2);
         }
-      }),
-      beads_memory_sync: tool({
-        description: "Sync between Beads task database and memory observations. Use sync_to_memory to import completed tasks as progress observations, sync_from_memory to link observations back to tasks, link to associate an observation with a task, or status to check sync state.",
-        args: {
-          operation: tool.schema.enum(["sync_to_memory", "sync_from_memory", "link", "status"]).describe("Sync operation to perform"),
-          beadId: tool.schema.string().optional().describe("Bead/task ID for operation=link"),
-          observationId: tool.schema.number().optional().describe("Observation ID for operation=link")
-        },
-        async execute(args) {
-          const result = beadsMemorySync(args);
-          return JSON.stringify(result, null, 2);
-        }
       })
     },
     config: async (config2) => {
@@ -18561,7 +18253,7 @@ var CliKitPlugin = async (ctx) => {
           const todoHash = JSON.stringify([...todos].sort((a, b) => a.id.localeCompare(b.id)).map((t) => `${t.id}:${t.status}`));
           if (todoHash !== lastTodoHash) {
             lastTodoHash = todoHash;
-            if (pluginConfig.hooks?.todo_beads_sync?.enabled !== false) {
+            if (pluginConfig.hooks?.todo_beads_sync?.enabled !== false && pluginConfig.hooks?.todo_beads_sync?.mode !== "disabled") {
               try {
                 const result = syncTodosToBeads(ctx.directory, sessionID, todos, pluginConfig.hooks?.todo_beads_sync);
                 if (pluginConfig.hooks?.todo_beads_sync?.log === true) {
@@ -18589,7 +18281,7 @@ var CliKitPlugin = async (ctx) => {
             if (effectiveTodos.length > 0) {
               const result = checkTodoCompletion(effectiveTodos);
               if (!result.complete && todoConfig?.warn_on_incomplete !== false) {
-                await cliLog("warn", formatIncompleteWarning(result, sessionID));
+                await cliLog("warn", formatIncompleteWarning(result, sessionID, todoConfig?.beads_authoritative === true));
               }
             }
           } catch (error45) {
@@ -18717,32 +18409,6 @@ var CliKitPlugin = async (ctx) => {
           }
         }
       }
-      if (pluginConfig.hooks?.swarm_enforcer?.enabled !== false) {
-        const editTools = ["edit", "write", "bash"];
-        if (editTools.some((name) => isToolNamed(toolName, name))) {
-          const targetFile = extractFileFromToolInput(toolName, toolInput);
-          try {
-            if (targetFile) {
-              const taskScope = toolInput.taskScope || input.__taskScope;
-              const enforcement = checkEditPermission(targetFile, taskScope, pluginConfig.hooks?.swarm_enforcer);
-              if (!enforcement.allowed) {
-                await cliLog("warn", formatEnforcementWarning(enforcement));
-                if (pluginConfig.hooks?.swarm_enforcer?.block_unreserved_edits) {
-                  await showToast(enforcement.reason || "Edit blocked outside task scope", "warning", "CliKit Swarm");
-                  blockToolExecution(enforcement.reason || "Edit outside reserved task scope");
-                }
-              } else if (pluginConfig.hooks?.swarm_enforcer?.log === true) {
-                await cliLog("debug", `[CliKit:swarm-enforcer] Allowed edit: ${targetFile}`);
-              }
-            }
-          } catch (error45) {
-            if (isBlockedToolExecutionError(error45)) {
-              throw error45;
-            }
-            await hookErr("swarm-enforcer", error45, { tool: toolName, targetFile });
-          }
-        }
-      }
       if (pluginConfig.hooks?.subagent_question_blocker?.enabled !== false) {
         if (isSubagentTool(toolName)) {
           const prompt = toolInput.prompt;
@@ -18805,6 +18471,10 @@ var CliKitPlugin = async (ctx) => {
     },
     "experimental.chat.system.transform": async (_input, output) => {
       const beadsConfig = pluginConfig.hooks?.beads_context;
+      const workflowCapsule = getWorkflowSystemCapsule();
+      if (workflowCapsule) {
+        output.system.push(workflowCapsule);
+      }
       if (beadsConfig?.enabled === false) {
         return;
       }
@@ -18822,6 +18492,10 @@ var CliKitPlugin = async (ctx) => {
     },
     "experimental.session.compacting": async (_input, output) => {
       const beadsConfig = pluginConfig.hooks?.beads_context;
+      const workflowCapsule = getWorkflowSystemCapsule();
+      if (workflowCapsule) {
+        output.context.push(workflowCapsule);
+      }
       if (beadsConfig?.enabled === false) {
         return;
       }