@graph-tl/graph 0.1.13 → 0.1.15

package/dist/{chunk-GALSWONI.js → chunk-DUEP3T5A.js}

@@ -100,6 +100,38 @@ The user controls the pace. Do not auto-claim the next task.
 - NEVER skip discovery on nodes with discovery:pending \u2014 the system will block you from decomposing
 - If you're approaching context limits, ensure your current task's state is captured (update with evidence even if not fully resolved) so the next agent can pick up where you left off
 
+# Record observations proactively
+
+Graph is the project memory across sessions. If something isn't in Graph, it's effectively forgotten. While working, record things you notice \u2014 even if they're not part of your current task:
+
+- **Warnings & errors**: CI failures, deprecation warnings, security vulnerabilities, linter issues
+- **Tech debt**: Code smells, outdated dependencies, missing tests, hardcoded values
+- **Broken things**: Flaky tests, dead links, misconfigured environments
+- **Ideas & improvements**: Performance opportunities, UX issues, missing features
+
+Use \`graph_plan\` to add observation nodes under the project root. Keep them lightweight \u2014 a clear summary is enough. They can always be dropped later if irrelevant.
+
+Default to "if in doubt, add a node." It's cheap to create and the next session will thank you.
+
+# Blocked status
+
+Nodes can be manually blocked (separate from dependency-blocked). Use this for external blockers:
+
+\`\`\`
+graph_update({ updates: [{
+  node_id: "<id>",
+  blocked: true,
+  blocked_reason: "Waiting on API key from client"
+}] })
+\`\`\`
+
+To unblock: \`graph_update({ updates: [{ node_id: "<id>", blocked: false }] })\`
+
+- \`blocked_reason\` is required when setting \`blocked: true\`
+- Blocked nodes won't appear in \`graph_next\` results
+- Unblocking auto-clears the reason
+- Use this for things like: waiting on external input, upstream API down, needs design review
+
 # Common mistakes to avoid
 
 - Setting dependencies on parent nodes instead of leaf nodes
@@ -122,4 +154,4 @@ function handleAgentConfig(version) {
 export {
   handleAgentConfig
 };
-//# sourceMappingURL=chunk-GALSWONI.js.map
+//# sourceMappingURL=chunk-DUEP3T5A.js.map

package/dist/{chunk-GALSWONI.js.map → chunk-DUEP3T5A.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/tools/agent-config.ts"],"sourcesContent":["// [sl:fV9I7Vel3xT5d_Ws2YHul] Subagent delivery — free for all (retention hook)\n\nfunction agentPrompt(version: string): string {\n  return `---\nname: graph\nversion: ${version}\ndescription: Use this agent for tasks tracked in Graph. Enforces the claim-work-resolve workflow — always checks graph_next before working, adds new work to the graph before executing, and resolves with evidence.\ntools: Read, Edit, Write, Bash, Glob, Grep, Task(Explore), AskUserQuestion\nmodel: sonnet\n---\n\nYou are a graph-optimized agent. You execute tasks tracked in a Graph project. Follow this workflow strictly. The human directs, you execute through the graph.\n\n# Workflow\n\n## 1. ORIENT\nOn your first call, orient yourself:\n\\`\\`\\`\ngraph_onboard({ project: \"<project-name>\" })\n\\`\\`\\`\nRead the \\`hint\\` field first — it tells you exactly what to do next. Then read the summary, evidence, knowledge, and actionable tasks.\n\n**First-run:** If the tree is empty and discovery is \\`\"pending\"\\`, this is a brand new project. Jump directly to DISCOVER below. Do not call graph_next on an empty project.\n\n## 2. DISCOVER (when discovery is pending)\nIf the project root or a task node has \\`discovery: \"pending\"\\`, you must complete discovery before decomposing it. Discovery is an interview with the user to understand what needs to happen.\n\nUse AskUserQuestion to cover these areas (adapt to what's relevant — skip what's obvious):\n- **Scope** — What exactly needs to happen? What's explicitly out of scope?\n- **Existing patterns** — How does the codebase currently handle similar things? (explore first, then confirm)\n- **Technical approach** — What libraries, APIs, or patterns should we use?\n- **Acceptance criteria** — How will we know it's done? What does success look like?\n\nAfter the interview:\n1. Write findings as knowledge: \\`graph_knowledge_write({ project, key: \"discovery-<topic>\", content: \"...\" })\\`\n2. Flip discovery to done: \\`graph_update({ updates: [{ node_id: \"<id>\", discovery: \"done\" }] })\\`\n3. NOW decompose with graph_plan\n\nDo NOT skip discovery. If you try to add children to a node with \\`discovery: \"pending\"\\`, graph_plan will reject it.\n\n## 3. CLAIM\nGet your next task:\n\\`\\`\\`\ngraph_next({ project: \"<project-name>\", claim: true })\n\\`\\`\\`\nRead the task summary, ancestor chain (for scope), resolved dependencies (for context on what was done before you), and context links (for files to look at).\n\n## 4. PLAN\nIf you discover work that isn't in the graph, add it BEFORE executing:\n\\`\\`\\`\ngraph_plan({ nodes: [{ ref: \"new-work\", parent_ref: \"<parent-id>\", summary: \"...\" }] })\n\\`\\`\\`\nNever execute ad-hoc work. The graph is the source of truth.\n\nWhen decomposing work:\n- Set dependencies on LEAF nodes, not parent nodes. If \"Page A\" depends on \"Layout\", the dependency is from \"Page A\" to \"Layout\", not from the \"Pages\" parent to \"Layout\".\n- Keep tasks small and specific. A task should be completable in one session.\n- Parent nodes are organizational — they resolve when all children resolve. Don't put work in parent nodes.\n\n## 5. WORK\nExecute the claimed task. While working:\n- Annotate key code changes with \\`// [sl:nodeId]\\` where nodeId is the task you're working on\n- This creates a traceable link from code back to the task, its evidence, and its history\n- Build and run tests before considering a task done\n\n## 6. RESOLVE\nWhen done, resolve the task with evidence:\n\\`\\`\\`\ngraph_update({ updates: [{\n  node_id: \"<task-id>\",\n  resolved: true,\n  add_evidence: [\n    { type: \"note\", ref: \"What you did and why\" },\n    { type: \"git\", ref: \"<commit-hash> — <summary>\" },\n    { type: \"test\", ref: \"Test results\" }\n  ],\n  add_context_links: [\"path/to/files/you/touched\"]\n}] })\n\\`\\`\\`\nEvidence is mandatory. At minimum, include one note explaining what you did.\n\n## 7. PAUSE\nAfter resolving a task, STOP. Tell the user:\n- What you just completed\n- What the next actionable task is\n- Wait for the user to say \"continue\" before claiming the next task\n\nThe user controls the pace. Do not auto-claim the next task.\n\n# Rules\n\n- NEVER start work without a claimed task\n- NEVER resolve without evidence\n- NEVER execute ad-hoc work — add it to the graph first via graph_plan\n- NEVER auto-continue to the next task — pause and let the user decide\n- ALWAYS build and test before resolving\n- ALWAYS include context_links for files you modified when resolving\n- Parent nodes auto-resolve when all their children are resolved — you don't need to manually resolve them\n- NEVER skip discovery on nodes with discovery:pending — the system will block you from decomposing\n- If you're approaching context limits, ensure your current task's state is captured (update with evidence even if not fully resolved) so the next agent can pick up where you left off\n\n# Common mistakes to avoid\n\n- Setting dependencies on parent nodes instead of leaf nodes\n- Running project scaffolding tools (create-next-app, etc.) before planning in the graph\n- Resolving tasks without running tests\n- Doing work that isn't tracked in the graph\n- Continuing to the next task without pausing for user review\n- Trying to decompose a node without completing discovery first\n- Not writing knowledge entries during discovery — future agents need this context\n`;\n}\n\nexport interface AgentConfigResult {\n  agent_file: string;\n  install_path: string;\n  instructions: string;\n}\n\nexport function handleAgentConfig(version: string): AgentConfigResult {\n  return {\n    agent_file: agentPrompt(version),\n    install_path: \".claude/agents/graph.md\",\n    instructions:\n      \"Save the agent_file content to .claude/agents/graph.md in your project root. \" +\n      \"Claude Code will automatically discover it and use it when tasks match the agent description.\",\n  };\n}\n"],"mappings":";;;AAEA,SAAS,YAAY,SAAyB;AAC5C,SAAO;AAAA;AAAA,WAEE,OAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AA0GlB;AAQO,SAAS,kBAAkB,SAAoC;AACpE,SAAO;AAAA,IACL,YAAY,YAAY,OAAO;AAAA,IAC/B,cAAc;AAAA,IACd,cACE;AAAA,EAEJ;AACF;","names":[]}
+{"version":3,"sources":["../src/tools/agent-config.ts"],"sourcesContent":["// [sl:fV9I7Vel3xT5d_Ws2YHul] Subagent delivery — free for all (retention hook)\n\nfunction agentPrompt(version: string): string {\n  return `---\nname: graph\nversion: ${version}\ndescription: Use this agent for tasks tracked in Graph. Enforces the claim-work-resolve workflow — always checks graph_next before working, adds new work to the graph before executing, and resolves with evidence.\ntools: Read, Edit, Write, Bash, Glob, Grep, Task(Explore), AskUserQuestion\nmodel: sonnet\n---\n\nYou are a graph-optimized agent. You execute tasks tracked in a Graph project. Follow this workflow strictly. The human directs, you execute through the graph.\n\n# Workflow\n\n## 1. ORIENT\nOn your first call, orient yourself:\n\\`\\`\\`\ngraph_onboard({ project: \"<project-name>\" })\n\\`\\`\\`\nRead the \\`hint\\` field first — it tells you exactly what to do next. Then read the summary, evidence, knowledge, and actionable tasks.\n\n**First-run:** If the tree is empty and discovery is \\`\"pending\"\\`, this is a brand new project. Jump directly to DISCOVER below. Do not call graph_next on an empty project.\n\n## 2. DISCOVER (when discovery is pending)\nIf the project root or a task node has \\`discovery: \"pending\"\\`, you must complete discovery before decomposing it. Discovery is an interview with the user to understand what needs to happen.\n\nUse AskUserQuestion to cover these areas (adapt to what's relevant — skip what's obvious):\n- **Scope** — What exactly needs to happen? What's explicitly out of scope?\n- **Existing patterns** — How does the codebase currently handle similar things? (explore first, then confirm)\n- **Technical approach** — What libraries, APIs, or patterns should we use?\n- **Acceptance criteria** — How will we know it's done? What does success look like?\n\nAfter the interview:\n1. Write findings as knowledge: \\`graph_knowledge_write({ project, key: \"discovery-<topic>\", content: \"...\" })\\`\n2. Flip discovery to done: \\`graph_update({ updates: [{ node_id: \"<id>\", discovery: \"done\" }] })\\`\n3. NOW decompose with graph_plan\n\nDo NOT skip discovery. If you try to add children to a node with \\`discovery: \"pending\"\\`, graph_plan will reject it.\n\n## 3. CLAIM\nGet your next task:\n\\`\\`\\`\ngraph_next({ project: \"<project-name>\", claim: true })\n\\`\\`\\`\nRead the task summary, ancestor chain (for scope), resolved dependencies (for context on what was done before you), and context links (for files to look at).\n\n## 4. PLAN\nIf you discover work that isn't in the graph, add it BEFORE executing:\n\\`\\`\\`\ngraph_plan({ nodes: [{ ref: \"new-work\", parent_ref: \"<parent-id>\", summary: \"...\" }] })\n\\`\\`\\`\nNever execute ad-hoc work. The graph is the source of truth.\n\nWhen decomposing work:\n- Set dependencies on LEAF nodes, not parent nodes. If \"Page A\" depends on \"Layout\", the dependency is from \"Page A\" to \"Layout\", not from the \"Pages\" parent to \"Layout\".\n- Keep tasks small and specific. A task should be completable in one session.\n- Parent nodes are organizational — they resolve when all children resolve. Don't put work in parent nodes.\n\n## 5. WORK\nExecute the claimed task. While working:\n- Annotate key code changes with \\`// [sl:nodeId]\\` where nodeId is the task you're working on\n- This creates a traceable link from code back to the task, its evidence, and its history\n- Build and run tests before considering a task done\n\n## 6. RESOLVE\nWhen done, resolve the task with evidence:\n\\`\\`\\`\ngraph_update({ updates: [{\n  node_id: \"<task-id>\",\n  resolved: true,\n  add_evidence: [\n    { type: \"note\", ref: \"What you did and why\" },\n    { type: \"git\", ref: \"<commit-hash> — <summary>\" },\n    { type: \"test\", ref: \"Test results\" }\n  ],\n  add_context_links: [\"path/to/files/you/touched\"]\n}] })\n\\`\\`\\`\nEvidence is mandatory. At minimum, include one note explaining what you did.\n\n## 7. PAUSE\nAfter resolving a task, STOP. Tell the user:\n- What you just completed\n- What the next actionable task is\n- Wait for the user to say \"continue\" before claiming the next task\n\nThe user controls the pace. Do not auto-claim the next task.\n\n# Rules\n\n- NEVER start work without a claimed task\n- NEVER resolve without evidence\n- NEVER execute ad-hoc work — add it to the graph first via graph_plan\n- NEVER auto-continue to the next task — pause and let the user decide\n- ALWAYS build and test before resolving\n- ALWAYS include context_links for files you modified when resolving\n- Parent nodes auto-resolve when all their children are resolved — you don't need to manually resolve them\n- NEVER skip discovery on nodes with discovery:pending — the system will block you from decomposing\n- If you're approaching context limits, ensure your current task's state is captured (update with evidence even if not fully resolved) so the next agent can pick up where you left off\n\n# Record observations proactively\n\nGraph is the project memory across sessions. If something isn't in Graph, it's effectively forgotten. While working, record things you notice — even if they're not part of your current task:\n\n- **Warnings & errors**: CI failures, deprecation warnings, security vulnerabilities, linter issues\n- **Tech debt**: Code smells, outdated dependencies, missing tests, hardcoded values\n- **Broken things**: Flaky tests, dead links, misconfigured environments\n- **Ideas & improvements**: Performance opportunities, UX issues, missing features\n\nUse \\`graph_plan\\` to add observation nodes under the project root. Keep them lightweight — a clear summary is enough. They can always be dropped later if irrelevant.\n\nDefault to \"if in doubt, add a node.\" It's cheap to create and the next session will thank you.\n\n# Blocked status\n\nNodes can be manually blocked (separate from dependency-blocked). Use this for external blockers:\n\n\\`\\`\\`\ngraph_update({ updates: [{\n  node_id: \"<id>\",\n  blocked: true,\n  blocked_reason: \"Waiting on API key from client\"\n}] })\n\\`\\`\\`\n\nTo unblock: \\`graph_update({ updates: [{ node_id: \"<id>\", blocked: false }] })\\`\n\n- \\`blocked_reason\\` is required when setting \\`blocked: true\\`\n- Blocked nodes won't appear in \\`graph_next\\` results\n- Unblocking auto-clears the reason\n- Use this for things like: waiting on external input, upstream API down, needs design review\n\n# Common mistakes to avoid\n\n- Setting dependencies on parent nodes instead of leaf nodes\n- Running project scaffolding tools (create-next-app, etc.) before planning in the graph\n- Resolving tasks without running tests\n- Doing work that isn't tracked in the graph\n- Continuing to the next task without pausing for user review\n- Trying to decompose a node without completing discovery first\n- Not writing knowledge entries during discovery — future agents need this context\n`;\n}\n\nexport interface AgentConfigResult {\n  agent_file: string;\n  install_path: string;\n  instructions: string;\n}\n\nexport function handleAgentConfig(version: string): AgentConfigResult {\n  return {\n    agent_file: agentPrompt(version),\n    install_path: \".claude/agents/graph.md\",\n    instructions:\n      \"Save the agent_file content to .claude/agents/graph.md in your project root. \" +\n      \"Claude Code will automatically discover it and use it when tasks match the agent description.\",\n  };\n}\n"],"mappings":";;;AAEA,SAAS,YAAY,SAAyB;AAC5C,SAAO;AAAA;AAAA,WAEE,OAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AA0IlB;AAQO,SAAS,kBAAkB,SAAoC;AACpE,SAAO;AAAA,IACL,YAAY,YAAY,OAAO;AAAA,IAC/B,cAAc;AAAA,IACd,cACE;AAAA,EAEJ;AACF;","names":[]}

package/dist/{chunk-TWT5GUXW.js → chunk-EG42TNON.js}

@@ -101,6 +101,14 @@ function migrate(db2) {
   if (hasDiscovery.cnt === 0) {
     db2.exec("ALTER TABLE nodes ADD COLUMN discovery TEXT DEFAULT NULL");
   }
+  const hasBlocked = db2.prepare(
+    "SELECT COUNT(*) as cnt FROM pragma_table_info('nodes') WHERE name = 'blocked'"
+  ).get();
+  if (hasBlocked.cnt === 0) {
+    db2.exec("ALTER TABLE nodes ADD COLUMN blocked INTEGER NOT NULL DEFAULT 0");
+    db2.exec("ALTER TABLE nodes ADD COLUMN blocked_reason TEXT DEFAULT NULL");
+  }
+  db2.exec("CREATE INDEX IF NOT EXISTS idx_nodes_blocked ON nodes(project, blocked, resolved)");
 }
 function checkpointDb() {
   if (db) {
@@ -245,6 +253,8 @@ function rowToNode(row) {
     resolved: row.resolved === 1,
     depth: row.depth,
     discovery: row.discovery ?? null,
+    blocked: row.blocked === 1,
+    blocked_reason: row.blocked_reason ?? null,
     state: row.state ? JSON.parse(row.state) : null,
     properties: JSON.parse(row.properties),
     context_links: JSON.parse(row.context_links),
@@ -272,6 +282,8 @@ function createNode(input) {
     resolved: false,
     depth,
     discovery: input.discovery ?? null,
+    blocked: false,
+    blocked_reason: null,
     state: input.state ?? null,
     properties: input.properties ?? {},
     context_links: input.context_links ?? [],
@@ -281,8 +293,8 @@ function createNode(input) {
     updated_at: now
   };
   db2.prepare(`
-    INSERT INTO nodes (id, rev, parent, project, summary, resolved, depth, discovery, state, properties, context_links, evidence, created_by, created_at, updated_at)
-    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+    INSERT INTO nodes (id, rev, parent, project, summary, resolved, depth, discovery, blocked, blocked_reason, state, properties, context_links, evidence, created_by, created_at, updated_at)
+    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
   `).run(
     node.id,
     node.rev,
@@ -292,6 +304,8 @@ function createNode(input) {
     0,
     node.depth,
     node.discovery,
+    0,
+    null,
     node.state !== null ? JSON.stringify(node.state) : null,
     JSON.stringify(node.properties),
     JSON.stringify(node.context_links),
@@ -366,6 +380,8 @@ function updateNode(input) {
   const now = (/* @__PURE__ */ new Date()).toISOString();
   let newResolved = node.resolved;
   let newDiscovery = node.discovery;
+  let newBlocked = node.blocked;
+  let newBlockedReason = node.blocked_reason;
   let newState = node.state;
   let newSummary = node.summary;
   let newProperties = { ...node.properties };
@@ -389,6 +405,29 @@ function updateNode(input) {
     changes.push({ field: "discovery", before: node.discovery, after: input.discovery });
     newDiscovery = input.discovery;
   }
+  if (input.blocked === true && !node.blocked) {
+    const reason = input.blocked_reason ?? node.blocked_reason;
+    if (!reason) {
+      throw new EngineError(
+        "blocked_reason_required",
+        `Cannot block node ${input.node_id} without a blocked_reason. Provide blocked_reason explaining why this node is blocked.`
+      );
+    }
+  }
+  if (input.blocked !== void 0 && input.blocked !== node.blocked) {
+    changes.push({ field: "blocked", before: node.blocked, after: input.blocked });
+    newBlocked = input.blocked;
+    if (!input.blocked && input.blocked_reason === void 0) {
+      if (node.blocked_reason !== null) {
+        changes.push({ field: "blocked_reason", before: node.blocked_reason, after: null });
+      }
+      newBlockedReason = null;
+    }
+  }
+  if (input.blocked_reason !== void 0 && input.blocked_reason !== node.blocked_reason) {
+    changes.push({ field: "blocked_reason", before: node.blocked_reason, after: input.blocked_reason });
+    newBlockedReason = input.blocked_reason;
+  }
   if (input.state !== void 0) {
     changes.push({ field: "state", before: node.state, after: input.state });
     newState = input.state;
@@ -448,6 +487,8 @@ function updateNode(input) {
       rev = ?,
       resolved = ?,
       discovery = ?,
+      blocked = ?,
+      blocked_reason = ?,
       state = ?,
       summary = ?,
       properties = ?,
@@ -459,6 +500,8 @@ function updateNode(input) {
     newRev,
     newResolved ? 1 : 0,
     newDiscovery,
+    newBlocked ? 1 : 0,
+    newBlockedReason,
     newState !== null ? JSON.stringify(newState) : null,
     newSummary,
     JSON.stringify(newProperties),
@@ -471,6 +514,21 @@ function updateNode(input) {
   logEvent(input.node_id, input.agent, action, changes);
   return getNodeOrThrow(input.node_id);
 }
+function getSubtreeProgress(nodeId) {
+  const db2 = getDb();
+  const row = db2.prepare(
+    `WITH RECURSIVE descendants(id) AS (
+      SELECT id FROM nodes WHERE id = ?
+      UNION ALL
+      SELECT n.id FROM nodes n JOIN descendants d ON n.parent = d.id
+    )
+    SELECT
+      COUNT(*) as total,
+      SUM(CASE WHEN n.resolved = 1 THEN 1 ELSE 0 END) as resolved
+    FROM descendants d JOIN nodes n ON n.id = d.id`
+  ).get(nodeId);
+  return { resolved: row.resolved, total: row.total };
+}
 function getProjectSummary(project) {
   const db2 = getDb();
   const counts = db2.prepare(
@@ -480,15 +538,19 @@ function getProjectSummary(project) {
       FROM nodes WHERE project = ?`
   ).get(project);
   const blocked = db2.prepare(
-    `SELECT COUNT(DISTINCT n.id) as count
-       FROM nodes n
-       JOIN edges e ON e.from_node = n.id AND e.type = 'depends_on'
-       JOIN nodes dep ON dep.id = e.to_node AND dep.resolved = 0
-       WHERE n.project = ? AND n.resolved = 0`
-  ).get(project);
+    `SELECT COUNT(DISTINCT id) as count FROM (
+         SELECT n.id FROM nodes n
+         WHERE n.project = ? AND n.resolved = 0 AND n.blocked = 1
+         UNION
+         SELECT n.id FROM nodes n
+         JOIN edges e ON e.from_node = n.id AND e.type = 'depends_on'
+         JOIN nodes dep ON dep.id = e.to_node AND dep.resolved = 0
+         WHERE n.project = ? AND n.resolved = 0
+       )`
+  ).get(project, project);
   const actionable = db2.prepare(
     `SELECT COUNT(*) as count FROM nodes n
-       WHERE n.project = ? AND n.resolved = 0
+       WHERE n.project = ? AND n.resolved = 0 AND n.blocked = 0
        AND NOT EXISTS (
          SELECT 1 FROM nodes child WHERE child.parent = n.id AND child.resolved = 0
        )
@@ -529,6 +591,7 @@ export {
   getProjectRoot,
   listProjects,
   updateNode,
+  getSubtreeProgress,
   getProjectSummary
 };
-//# sourceMappingURL=chunk-TWT5GUXW.js.map
+//# sourceMappingURL=chunk-EG42TNON.js.map

package/dist/chunk-EG42TNON.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/nodes.ts","../src/db.ts","../src/events.ts","../src/validate.ts"],"sourcesContent":["import { nanoid } from \"nanoid\";\nimport { getDb } from \"./db.js\";\nimport { logEvent } from \"./events.js\";\nimport { EngineError } from \"./validate.js\";\nimport type { Node, NodeRow, Evidence, FieldChange } from \"./types.js\";\n\n// --- Row <-> Node conversion ---\n\nfunction rowToNode(row: NodeRow): Node {\n  return {\n    id: row.id,\n    rev: row.rev,\n    parent: row.parent,\n    project: row.project,\n    summary: row.summary,\n    resolved: row.resolved === 1,\n    depth: row.depth,\n    discovery: row.discovery ?? null,\n    blocked: row.blocked === 1,\n    blocked_reason: row.blocked_reason ?? null,\n    state: row.state ? JSON.parse(row.state) : null,\n    properties: JSON.parse(row.properties),\n    context_links: JSON.parse(row.context_links),\n    evidence: JSON.parse(row.evidence),\n    created_by: row.created_by,\n    created_at: row.created_at,\n    updated_at: row.updated_at,\n  };\n}\n\n// --- Create ---\n\nexport interface CreateNodeInput {\n  parent?: string;\n  project: string;\n  summary: string;\n  discovery?: string | null;\n  state?: unknown;\n  properties?: Record<string, unknown>;\n  context_links?: string[];\n  agent: string;\n}\n\nexport function createNode(input: CreateNodeInput): Node {\n  const db = getDb();\n  const now = new Date().toISOString();\n  const id = nanoid();\n\n  // [sl:yBBVr4wcgVfWA_w8U8hQo] Compute depth from parent\n  let depth = 0;\n  if (input.parent) {\n    const parentRow = db.prepare(\"SELECT depth FROM nodes WHERE id = ?\").get(input.parent) as { depth: number } | undefined;\n    if (parentRow) depth = parentRow.depth + 1;\n  }\n\n  const node: Node = {\n    id,\n    rev: 1,\n    parent: input.parent ?? null,\n    project: input.project,\n    summary: input.summary,\n    resolved: false,\n    depth,\n    discovery: input.discovery ?? null,\n    blocked: false,\n    blocked_reason: null,\n    state: input.state ?? null,\n    properties: input.properties ?? {},\n    context_links: input.context_links ?? [],\n    evidence: [],\n    created_by: input.agent,\n    created_at: now,\n    updated_at: now,\n  };\n\n  db.prepare(`\n    INSERT INTO nodes (id, rev, parent, project, summary, resolved, depth, discovery, blocked, blocked_reason, state, properties, context_links, evidence, created_by, created_at, updated_at)\n    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)\n  `).run(\n    node.id,\n    node.rev,\n    node.parent,\n    node.project,\n    node.summary,\n    0,\n    node.depth,\n    node.discovery,\n    0,\n    null,\n    node.state !== null ? JSON.stringify(node.state) : null,\n    JSON.stringify(node.properties),\n    JSON.stringify(node.context_links),\n    JSON.stringify(node.evidence),\n    node.created_by,\n    node.created_at,\n    node.updated_at\n  );\n\n  logEvent(node.id, input.agent, \"created\", [\n    { field: \"summary\", before: null, after: node.summary },\n  ]);\n\n  return node;\n}\n\n// --- Read ---\n\nexport function getNode(id: string): Node | null {\n  const db = getDb();\n  const row = db.prepare(\"SELECT * FROM nodes WHERE id = ?\").get(id) as\n    | NodeRow\n    | undefined;\n  return row ? rowToNode(row) : null;\n}\n\nexport function getNodeOrThrow(id: string): Node {\n  const node = getNode(id);\n  if (!node) {\n    throw new EngineError(\"node_not_found\", `Node not found: ${id}. Verify the ID is correct and the node hasn't been deleted.`);\n  }\n  return node;\n}\n\nexport function getChildren(parentId: string): Node[] {\n  const db = getDb();\n  const rows = db\n    .prepare(\"SELECT * FROM nodes WHERE parent = ?\")\n    .all(parentId) as NodeRow[];\n  return rows.map(rowToNode);\n}\n\nexport function getAncestors(nodeId: string): Array<{ id: string; summary: string; resolved: boolean }> {\n  const ancestors: Array<{ id: string; summary: string; resolved: boolean }> = [];\n  let current = getNode(nodeId);\n\n  while (current?.parent) {\n    const parent = getNode(current.parent);\n    if (!parent) break;\n    ancestors.unshift({ id: parent.id, summary: parent.summary, resolved: parent.resolved });\n    current = parent;\n  }\n\n  return ancestors;\n}\n\nexport function getProjectRoot(project: string): Node | null {\n  const db = getDb();\n  const row = db\n    .prepare(\"SELECT * FROM nodes WHERE project = ? AND parent IS NULL\")\n    .get(project) as NodeRow | undefined;\n  return row ? rowToNode(row) : null;\n}\n\nexport function listProjects(): Array<{\n  project: string;\n  id: string;\n  summary: string;\n  total: number;\n  resolved: number;\n  unresolved: number;\n  updated_at: string;\n}> {\n  const db = getDb();\n\n  const roots = db\n    .prepare(\"SELECT * FROM nodes WHERE parent IS NULL\")\n    .all() as NodeRow[];\n\n  return roots.map((root) => {\n    const counts = db\n      .prepare(\n        `SELECT\n          COUNT(*) as total,\n          SUM(CASE WHEN resolved = 1 THEN 1 ELSE 0 END) as resolved\n        FROM nodes WHERE project = ?`\n      )\n      .get(root.project) as { total: number; resolved: number };\n\n    return {\n      project: root.project,\n      id: root.id,\n      summary: root.summary,\n      total: counts.total,\n      resolved: counts.resolved,\n      unresolved: counts.total - counts.resolved,\n      updated_at: root.updated_at,\n    };\n  });\n}\n\n// --- Update ---\n\nexport interface UpdateNodeInput {\n  node_id: string;\n  agent: string;\n  resolved?: boolean;\n  discovery?: string | null;\n  blocked?: boolean;\n  blocked_reason?: string | null;\n  state?: unknown;\n  summary?: string;\n  properties?: Record<string, unknown>;\n  add_context_links?: string[];\n  remove_context_links?: string[];\n  add_evidence?: Array<{ type: string; ref: string }>;\n}\n\nexport function updateNode(input: UpdateNodeInput): Node {\n  const db = getDb();\n  const node = getNodeOrThrow(input.node_id);\n  const changes: FieldChange[] = [];\n  const now = new Date().toISOString();\n\n  let newResolved = node.resolved;\n  let newDiscovery = node.discovery;\n  let newBlocked = node.blocked;\n  let newBlockedReason = node.blocked_reason;\n  let newState = node.state;\n  let newSummary = node.summary;\n  let newProperties = { ...node.properties };\n  let newContextLinks = [...node.context_links];\n  let newEvidence = [...node.evidence];\n\n  // [sl:OZ0or-q5TserCEfWUeMVv] Require evidence when resolving\n  if (input.resolved === true && !node.resolved) {\n    const hasExistingEvidence = node.evidence.length > 0;\n    const hasNewEvidence = input.add_evidence && input.add_evidence.length > 0;\n    if (!hasExistingEvidence && !hasNewEvidence) {\n      throw new EngineError(\n        \"evidence_required\",\n        `Cannot resolve node ${input.node_id} without evidence. Add at least one add_evidence entry (type: 'git', 'note', 'test', etc.) explaining what was done.`\n      );\n    }\n  }\n\n  if (input.resolved !== undefined && input.resolved !== node.resolved) {\n    changes.push({ field: \"resolved\", before: node.resolved, after: input.resolved });\n    newResolved = input.resolved;\n  }\n\n  if (input.discovery !== undefined && input.discovery !== node.discovery) {\n    changes.push({ field: \"discovery\", before: node.discovery, after: input.discovery });\n    newDiscovery = input.discovery;\n  }\n\n  // Require blocked_reason when blocking a node\n  if (input.blocked === true && !node.blocked) {\n    const reason = input.blocked_reason ?? node.blocked_reason;\n    if (!reason) {\n      throw new EngineError(\n        \"blocked_reason_required\",\n        `Cannot block node ${input.node_id} without a blocked_reason. Provide blocked_reason explaining why this node is blocked.`\n      );\n    }\n  }\n\n  if (input.blocked !== undefined && input.blocked !== node.blocked) {\n    changes.push({ field: \"blocked\", before: node.blocked, after: input.blocked });\n    newBlocked = input.blocked;\n    // Clear blocked_reason when unblocking (unless explicitly set)\n    if (!input.blocked && input.blocked_reason === undefined) {\n      if (node.blocked_reason !== null) {\n        changes.push({ field: \"blocked_reason\", before: node.blocked_reason, after: null });\n      }\n      newBlockedReason = null;\n    }\n  }\n\n  if (input.blocked_reason !== undefined && input.blocked_reason !== node.blocked_reason) {\n    changes.push({ field: \"blocked_reason\", before: node.blocked_reason, after: input.blocked_reason });\n    newBlockedReason = input.blocked_reason;\n  }\n\n  if (input.state !== undefined) {\n    changes.push({ field: \"state\", before: node.state, after: input.state });\n    newState = input.state;\n  }\n\n  if (input.summary !== undefined && input.summary !== node.summary) {\n    changes.push({ field: \"summary\", before: node.summary, after: input.summary });\n    newSummary = input.summary;\n  }\n\n  if (input.properties) {\n    for (const [key, value] of Object.entries(input.properties)) {\n      if (value === null) {\n        if (key in newProperties) {\n          changes.push({ field: `properties.${key}`, before: newProperties[key], after: null });\n          delete newProperties[key];\n        }\n      } else {\n        changes.push({ field: `properties.${key}`, before: newProperties[key] ?? null, after: value });\n        newProperties[key] = value;\n      }\n    }\n  }\n\n  if (input.add_context_links) {\n    for (const link of input.add_context_links) {\n      if (!newContextLinks.includes(link)) {\n        newContextLinks.push(link);\n        changes.push({ field: \"context_links\", before: null, after: link });\n      }\n    }\n  }\n\n  if (input.remove_context_links) {\n    for (const link of input.remove_context_links) {\n      const idx = newContextLinks.indexOf(link);\n      if (idx !== -1) {\n        newContextLinks.splice(idx, 1);\n        changes.push({ field: \"context_links\", before: link, after: null });\n      }\n    }\n  }\n\n  if (input.add_evidence) {\n    for (const ev of input.add_evidence) {\n      const evidence: Evidence = {\n        type: ev.type,\n        ref: ev.ref,\n        agent: input.agent,\n        timestamp: now,\n      };\n      newEvidence.push(evidence);\n      changes.push({ field: \"evidence\", before: null, after: evidence });\n    }\n  }\n\n  if (changes.length === 0) {\n    return node;\n  }\n\n  const newRev = node.rev + 1;\n\n  db.prepare(`\n    UPDATE nodes SET\n      rev = ?,\n      resolved = ?,\n      discovery = ?,\n      blocked = ?,\n      blocked_reason = ?,\n      state = ?,\n      summary = ?,\n      properties = ?,\n      context_links = ?,\n      evidence = ?,\n      updated_at = ?\n    WHERE id = ?\n  `).run(\n    newRev,\n    newResolved ? 1 : 0,\n    newDiscovery,\n    newBlocked ? 1 : 0,\n    newBlockedReason,\n    newState !== null ? JSON.stringify(newState) : null,\n    newSummary,\n    JSON.stringify(newProperties),\n    JSON.stringify(newContextLinks),\n    JSON.stringify(newEvidence),\n    now,\n    input.node_id\n  );\n\n  const action = input.resolved === true ? \"resolved\" : \"updated\";\n  logEvent(input.node_id, input.agent, action, changes);\n\n  return getNodeOrThrow(input.node_id);\n}\n\n// --- Progress ---\n\nexport function getSubtreeProgress(nodeId: string): { resolved: number; total: number } {\n  const db = getDb();\n  const row = db.prepare(\n    `WITH RECURSIVE descendants(id) AS (\n      SELECT id FROM nodes WHERE id = ?\n      UNION ALL\n      SELECT n.id FROM nodes n JOIN descendants d ON n.parent = d.id\n    )\n    SELECT\n      COUNT(*) as total,\n      SUM(CASE WHEN n.resolved = 1 THEN 1 ELSE 0 END) as resolved\n    FROM descendants d JOIN nodes n ON n.id = d.id`\n  ).get(nodeId) as { total: number; resolved: number };\n  return { resolved: row.resolved, total: row.total };\n}\n\n// --- Query helpers ---\n\nexport function getProjectSummary(project: string): {\n  total: number;\n  resolved: number;\n  unresolved: number;\n  blocked: number;\n  actionable: number;\n} {\n  const db = getDb();\n\n  const counts = db\n    .prepare(\n      `SELECT\n        COUNT(*) as total,\n        SUM(CASE WHEN resolved = 1 THEN 1 ELSE 0 END) as resolved\n      FROM nodes WHERE project = ?`\n    )\n    .get(project) as { total: number; resolved: number };\n\n  // Blocked: unresolved nodes that are manually blocked OR have unresolved dependencies\n  const blocked = db\n    .prepare(\n      `SELECT COUNT(DISTINCT id) as count FROM (\n         SELECT n.id FROM nodes n\n         WHERE n.project = ? AND n.resolved = 0 AND n.blocked = 1\n         UNION\n         SELECT n.id FROM nodes n\n         JOIN edges e ON e.from_node = n.id AND e.type = 'depends_on'\n         JOIN nodes dep ON dep.id = e.to_node AND dep.resolved = 0\n         WHERE n.project = ? AND n.resolved = 0\n       )`\n    )\n    .get(project, project) as { count: number };\n\n  // Actionable: unresolved leaves (no unresolved children) with all deps resolved and not manually blocked\n  const actionable = db\n    .prepare(\n      `SELECT COUNT(*) as count FROM nodes n\n       WHERE n.project = ? AND n.resolved = 0 AND n.blocked = 0\n       AND NOT EXISTS (\n         SELECT 1 FROM nodes child WHERE child.parent = n.id AND child.resolved = 0\n       )\n       AND NOT EXISTS (\n         SELECT 1 FROM edges e\n         JOIN nodes dep ON dep.id = e.to_node AND dep.resolved = 0\n         WHERE e.from_node = n.id AND e.type = 'depends_on'\n       )`\n    )\n    .get(project) as { count: number };\n\n  return {\n    total: counts.total,\n    resolved: counts.resolved,\n    unresolved: counts.total - counts.resolved,\n    blocked: blocked.count,\n    actionable: actionable.count,\n  };\n}\n","import Database from \"better-sqlite3\";\nimport path from \"path\";\n\nlet db: Database.Database;\nlet dbPath: string;\n\nexport function setDbPath(p: string): void {\n  dbPath = p;\n}\n\nexport function getDb(): Database.Database {\n  if (!db) {\n    const resolvedPath = dbPath ?? path.resolve(\"graph.db\");\n    db = new Database(resolvedPath);\n    db.pragma(\"journal_mode = WAL\");\n    db.pragma(\"synchronous = FULL\");\n    db.pragma(\"foreign_keys = ON\");\n    migrate(db);\n  }\n  return db;\n}\n\nexport function initDb(p?: string): Database.Database {\n  // Close existing db if any (used by tests to reset state)\n  if (db) {\n    db.close();\n    db = undefined!;\n  }\n  if (p) dbPath = p;\n  return getDb();\n}\n\nfunction migrate(db: Database.Database): void {\n  db.exec(`\n    CREATE TABLE IF NOT EXISTS nodes (\n      id TEXT PRIMARY KEY,\n      rev INTEGER NOT NULL DEFAULT 1,\n      parent TEXT REFERENCES nodes(id),\n      project TEXT NOT NULL,\n      summary TEXT NOT NULL,\n      resolved INTEGER NOT NULL DEFAULT 0,\n      depth INTEGER NOT NULL DEFAULT 0,\n      state TEXT,\n      properties TEXT NOT NULL DEFAULT '{}',\n      context_links TEXT NOT NULL DEFAULT '[]',\n      evidence TEXT NOT NULL DEFAULT '[]',\n      created_by TEXT NOT NULL,\n      created_at TEXT NOT NULL,\n      updated_at TEXT NOT NULL\n    );\n\n    CREATE TABLE IF NOT EXISTS edges (\n      id TEXT PRIMARY KEY,\n      from_node TEXT NOT NULL REFERENCES nodes(id),\n      to_node TEXT NOT NULL REFERENCES nodes(id),\n      type TEXT NOT NULL,\n      created_at TEXT NOT NULL,\n      UNIQUE(from_node, to_node, type)\n    );\n\n    CREATE TABLE IF NOT EXISTS events (\n      id TEXT PRIMARY KEY,\n      node_id TEXT NOT NULL REFERENCES nodes(id),\n      agent TEXT NOT NULL,\n      action TEXT NOT NULL,\n      changes TEXT NOT NULL,\n      timestamp TEXT NOT NULL\n    );\n\n    CREATE INDEX IF NOT EXISTS idx_nodes_project ON nodes(project);\n    CREATE INDEX IF NOT EXISTS idx_nodes_parent ON nodes(parent);\n    CREATE INDEX IF NOT EXISTS idx_nodes_resolved ON nodes(project, resolved);\n    CREATE INDEX IF NOT EXISTS idx_edges_from ON edges(from_node);\n    CREATE INDEX IF NOT EXISTS idx_edges_to ON edges(to_node);\n    CREATE INDEX IF NOT EXISTS idx_edges_type ON edges(from_node, type);\n    CREATE INDEX IF NOT EXISTS idx_events_node ON events(node_id);\n\n    CREATE TABLE IF NOT EXISTS knowledge (\n      id TEXT PRIMARY KEY,\n      project TEXT NOT NULL,\n      key TEXT NOT NULL,\n      content TEXT NOT NULL,\n      created_by TEXT NOT NULL,\n      created_at TEXT NOT NULL,\n      updated_at TEXT NOT NULL,\n      UNIQUE(project, key)\n    );\n\n    CREATE INDEX IF NOT EXISTS idx_knowledge_project ON knowledge(project);\n  `);\n\n  // [sl:yBBVr4wcgVfWA_w8U8hQo] Migration: add depth column if it doesn't exist\n  const hasDepth = db.prepare(\n    \"SELECT COUNT(*) as cnt FROM pragma_table_info('nodes') WHERE name = 'depth'\"\n  ).get() as { cnt: number };\n\n  if (hasDepth.cnt === 0) {\n    db.exec(\"ALTER TABLE nodes ADD COLUMN depth INTEGER NOT NULL DEFAULT 0\");\n    // Backfill depths using recursive CTE\n    db.exec(`\n      WITH RECURSIVE tree(id, depth) AS (\n        SELECT id, 0 FROM nodes WHERE parent IS NULL\n        UNION ALL\n        SELECT n.id, t.depth + 1\n        FROM nodes n JOIN tree t ON n.parent = t.id\n      )\n      UPDATE nodes SET depth = (SELECT depth FROM tree WHERE tree.id = nodes.id)\n    `);\n  }\n\n  // [sl:AOXqUIhpW2-gdMqWATf66] Migration: add discovery column if it doesn't exist\n  const hasDiscovery = db.prepare(\n    \"SELECT COUNT(*) as cnt FROM pragma_table_info('nodes') WHERE name = 'discovery'\"\n  ).get() as { cnt: number };\n\n  if (hasDiscovery.cnt === 0) {\n    db.exec(\"ALTER TABLE nodes ADD COLUMN discovery TEXT DEFAULT NULL\");\n  }\n\n  // Migration: add blocked/blocked_reason columns if they don't exist\n  const hasBlocked = db.prepare(\n    \"SELECT COUNT(*) as cnt FROM pragma_table_info('nodes') WHERE name = 'blocked'\"\n  ).get() as { cnt: number };\n\n  if (hasBlocked.cnt === 0) {\n    db.exec(\"ALTER TABLE nodes ADD COLUMN blocked INTEGER NOT NULL DEFAULT 0\");\n    db.exec(\"ALTER TABLE nodes ADD COLUMN blocked_reason TEXT DEFAULT NULL\");\n  }\n\n  // Index on blocked status (must come after blocked column migration)\n  db.exec(\"CREATE INDEX IF NOT EXISTS idx_nodes_blocked ON nodes(project, blocked, resolved)\");\n}\n\nexport function checkpointDb(): void {\n  if (db) {\n    db.pragma(\"wal_checkpoint(TRUNCATE)\");\n  }\n}\n\nexport function closeDb(): void {\n  if (db) {\n    checkpointDb();\n    db.close();\n  }\n}\n","import { nanoid } from \"nanoid\";\nimport { getDb } from \"./db.js\";\nimport type { FieldChange, Event } from \"./types.js\";\n\nconst INSERT_EVENT = `\n  INSERT INTO events (id, node_id, agent, action, changes, timestamp)\n  VALUES (?, ?, ?, ?, ?, ?)\n`;\n\nexport function logEvent(\n  nodeId: string,\n  agent: string,\n  action: string,\n  changes: FieldChange[]\n): Event {\n  const db = getDb();\n  const event: Event = {\n    id: nanoid(),\n    node_id: nodeId,\n    agent,\n    action,\n    changes,\n    timestamp: new Date().toISOString(),\n  };\n\n  db.prepare(INSERT_EVENT).run(\n    event.id,\n    event.node_id,\n    event.agent,\n    event.action,\n    JSON.stringify(event.changes),\n    event.timestamp\n  );\n\n  return event;\n}\n\nexport function getEvents(\n  nodeId: string,\n  limit: number = 20,\n  cursor?: string\n): { events: Event[]; next_cursor: string | null } {\n  const db = getDb();\n\n  let query: string;\n  let params: unknown[];\n\n  if (cursor) {\n    query = `\n      SELECT * FROM events\n      WHERE node_id = ? AND timestamp < ?\n      ORDER BY timestamp DESC\n      LIMIT ?\n    `;\n    params = [nodeId, cursor, limit + 1];\n  } else {\n    query = `\n      SELECT * FROM events\n      WHERE node_id = ?\n      ORDER BY timestamp DESC\n      LIMIT ?\n    `;\n    params = [nodeId, limit + 1];\n  }\n\n  const rows = db.prepare(query).all(...params) as Array<{\n    id: string;\n    node_id: string;\n    agent: string;\n    action: string;\n    changes: string;\n    timestamp: string;\n  }>;\n\n  const hasMore = rows.length > limit;\n  const slice = hasMore ? rows.slice(0, limit) : rows;\n\n  const events: Event[] = slice.map((row) => ({\n    id: row.id,\n    node_id: row.node_id,\n    agent: row.agent,\n    action: row.action,\n    changes: JSON.parse(row.changes),\n    timestamp: row.timestamp,\n  }));\n\n  return {\n    events,\n    next_cursor: hasMore ? slice[slice.length - 1].timestamp : null,\n  };\n}\n","export class ValidationError extends Error {\n  code = \"validation_error\";\n  constructor(message: string) {\n    super(message);\n    this.name = \"ValidationError\";\n  }\n}\n\nexport class EngineError extends Error {\n  code: string;\n  constructor(code: string, message: string) {\n    super(message);\n    this.name = \"EngineError\";\n    this.code = code;\n  }\n}\n\nexport function requireString(value: unknown, field: string): string {\n  if (typeof value !== \"string\" || value.trim().length === 0) {\n    throw new ValidationError(`${field} is required and must be a non-empty string`);\n  }\n  return value.trim();\n}\n\nexport function optionalString(value: unknown, field: string): string | undefined {\n  if (value === undefined || value === null) return undefined;\n  if (typeof value !== \"string\") {\n    throw new ValidationError(`${field} must be a string`);\n  }\n  return value;\n}\n\nexport function requireArray<T>(value: unknown, field: string): T[] {\n  if (!Array.isArray(value) || value.length === 0) {\n    throw new ValidationError(`${field} is required and must be a non-empty array`);\n  }\n  return value as T[];\n}\n\nexport function optionalArray<T>(value: unknown, field: string): T[] | undefined {\n  if (value === undefined || value === null) return undefined;\n  if (!Array.isArray(value)) {\n    throw new ValidationError(`${field} must be an array`);\n  }\n  return value as T[];\n}\n\nexport function optionalNumber(value: unknown, field: string, min?: number, max?: number): number | undefined {\n  if (value === undefined || value === null) return undefined;\n  if (typeof value !== \"number\" || isNaN(value)) {\n    throw new ValidationError(`${field} must be a number`);\n  }\n  if (min !== undefined && value < min) {\n    throw new ValidationError(`${field} must be >= ${min}`);\n  }\n  if (max !== undefined && value > max) {\n    throw new ValidationError(`${field} must be <= ${max}`);\n  }\n  return value;\n}\n\nexport function optionalBoolean(value: unknown, field: string): boolean | undefined {\n  if (value === undefined || value === null) return undefined;\n  if (typeof value !== \"boolean\") {\n    throw new ValidationError(`${field} must be a boolean`);\n  }\n  return value;\n}\n\nexport function requireObject(value: unknown, field: string): Record<string, unknown> {\n  if (value === null || typeof value !== \"object\" || Array.isArray(value)) {\n    throw new ValidationError(`${field} is required and must be an object`);\n  }\n  return value as Record<string, unknown>;\n}\n"],"mappings":";;;AAAA,SAAS,UAAAA,eAAc;;;ACAvB,OAAO,cAAc;AACrB,OAAO,UAAU;AAEjB,IAAI;AACJ,IAAI;AAEG,SAAS,UAAU,GAAiB;AACzC,WAAS;AACX;AAEO,SAAS,QAA2B;AACzC,MAAI,CAAC,IAAI;AACP,UAAM,eAAe,UAAU,KAAK,QAAQ,UAAU;AACtD,SAAK,IAAI,SAAS,YAAY;AAC9B,OAAG,OAAO,oBAAoB;AAC9B,OAAG,OAAO,oBAAoB;AAC9B,OAAG,OAAO,mBAAmB;AAC7B,YAAQ,EAAE;AAAA,EACZ;AACA,SAAO;AACT;AAYA,SAAS,QAAQC,KAA6B;AAC5C,EAAAA,IAAG,KAAK;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,GAwDP;AAGD,QAAM,WAAWA,IAAG;AAAA,IAClB;AAAA,EACF,EAAE,IAAI;AAEN,MAAI,SAAS,QAAQ,GAAG;AACtB,IAAAA,IAAG,KAAK,+DAA+D;AAEvE,IAAAA,IAAG,KAAK;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,KAQP;AAAA,EACH;AAGA,QAAM,eAAeA,IAAG;AAAA,IACtB;AAAA,EACF,EAAE,IAAI;AAEN,MAAI,aAAa,QAAQ,GAAG;AAC1B,IAAAA,IAAG,KAAK,0DAA0D;AAAA,EACpE;AAGA,QAAM,aAAaA,IAAG;AAAA,IACpB;AAAA,EACF,EAAE,IAAI;AAEN,MAAI,WAAW,QAAQ,GAAG;AACxB,IAAAA,IAAG,KAAK,iEAAiE;AACzE,IAAAA,IAAG,KAAK,+DAA+D;AAAA,EACzE;AAGA,EAAAA,IAAG,KAAK,mFAAmF;AAC7F;AAEO,SAAS,eAAqB;AACnC,MAAI,IAAI;AACN,OAAG,OAAO,0BAA0B;AAAA,EACtC;AACF;AAEO,SAAS,UAAgB;AAC9B,MAAI,IAAI;AACN,iBAAa;AACb,OAAG,MAAM;AAAA,EACX;AACF;;;AChJA,SAAS,cAAc;AAIvB,IAAM,eAAe;AAAA;AAAA;AAAA;AAKd,SAAS,SACd,QACA,OACA,QACA,SACO;AACP,QAAMC,MAAK,MAAM;AACjB,QAAM,QAAe;AAAA,IACnB,IAAI,OAAO;AAAA,IACX,SAAS;AAAA,IACT;AAAA,IACA;AAAA,IACA;AAAA,IACA,YAAW,oBAAI,KAAK,GAAE,YAAY;AAAA,EACpC;AAEA,EAAAA,IAAG,QAAQ,YAAY,EAAE;AAAA,IACvB,MAAM;AAAA,IACN,MAAM;AAAA,IACN,MAAM;AAAA,IACN,MAAM;AAAA,IACN,KAAK,UAAU,MAAM,OAAO;AAAA,IAC5B,MAAM;AAAA,EACR;AAEA,SAAO;AACT;AAEO,SAAS,UACd,QACA,QAAgB,IAChB,QACiD;AACjD,QAAMA,MAAK,MAAM;AAEjB,MAAI;AACJ,MAAI;AAEJ,MAAI,QAAQ;AACV,YAAQ;AAAA;AAAA;AAAA;AAAA;AAAA;AAMR,aAAS,CAAC,QAAQ,QAAQ,QAAQ,CAAC;AAAA,EACrC,OAAO;AACL,YAAQ;AAAA;AAAA;AAAA;AAAA;AAAA;AAMR,aAAS,CAAC,QAAQ,QAAQ,CAAC;AAAA,EAC7B;AAEA,QAAM,OAAOA,IAAG,QAAQ,KAAK,EAAE,IAAI,GAAG,MAAM;AAS5C,QAAM,UAAU,KAAK,SAAS;AAC9B,QAAM,QAAQ,UAAU,KAAK,MAAM,GAAG,KAAK,IAAI;AAE/C,QAAM,SAAkB,MAAM,IAAI,CAAC,SAAS;AAAA,IAC1C,IAAI,IAAI;AAAA,IACR,SAAS,IAAI;AAAA,IACb,OAAO,IAAI;AAAA,IACX,QAAQ,IAAI;AAAA,IACZ,SAAS,KAAK,MAAM,IAAI,OAAO;AAAA,IAC/B,WAAW,IAAI;AAAA,EACjB,EAAE;AAEF,SAAO;AAAA,IACL;AAAA,IACA,aAAa,UAAU,MAAM,MAAM,SAAS,CAAC,EAAE,YAAY;AAAA,EAC7D;AACF;;;AC1FO,IAAM,kBAAN,cAA8B,MAAM;AAAA,EACzC,OAAO;AAAA,EACP,YAAY,SAAiB;AAC3B,UAAM,OAAO;AACb,SAAK,OAAO;AAAA,EACd;AACF;AAEO,IAAM,cAAN,cAA0B,MAAM;AAAA,EACrC;AAAA,EACA,YAAY,MAAc,SAAiB;AACzC,UAAM,OAAO;AACb,SAAK,OAAO;AACZ,SAAK,OAAO;AAAA,EACd;AACF;AAEO,SAAS,cAAc,OAAgB,OAAuB;AACnE,MAAI,OAAO,UAAU,YAAY,MAAM,KAAK,EAAE,WAAW,GAAG;AAC1D,UAAM,IAAI,gBAAgB,GAAG,KAAK,6CAA6C;AAAA,EACjF;AACA,SAAO,MAAM,KAAK;AACpB;AAEO,SAAS,eAAe,OAAgB,OAAmC;AAChF,MAAI,UAAU,UAAa,UAAU,KAAM,QAAO;AAClD,MAAI,OAAO,UAAU,UAAU;AAC7B,UAAM,IAAI,gBAAgB,GAAG,KAAK,mBAAmB;AAAA,EACvD;AACA,SAAO;AACT;AAEO,SAAS,aAAgB,OAAgB,OAAoB;AAClE,MAAI,CAAC,MAAM,QAAQ,KAAK,KAAK,MAAM,WAAW,GAAG;AAC/C,UAAM,IAAI,gBAAgB,GAAG,KAAK,4CAA4C;AAAA,EAChF;AACA,SAAO;AACT;AAUO,SAAS,eAAe,OAAgB,OAAe,KAAc,KAAkC;AAC5G,MAAI,UAAU,UAAa,UAAU,KAAM,QAAO;AAClD,MAAI,OAAO,UAAU,YAAY,MAAM,KAAK,GAAG;AAC7C,UAAM,IAAI,gBAAgB,GAAG,KAAK,mBAAmB;AAAA,EACvD;AACA,MAAI,QAAQ,UAAa,QAAQ,KAAK;AACpC,UAAM,IAAI,gBAAgB,GAAG,KAAK,eAAe,GAAG,EAAE;AAAA,EACxD;AACA,MAAI,QAAQ,UAAa,QAAQ,KAAK;AACpC,UAAM,IAAI,gBAAgB,GAAG,KAAK,eAAe,GAAG,EAAE;AAAA,EACxD;AACA,SAAO;AACT;AAEO,SAAS,gBAAgB,OAAgB,OAAoC;AAClF,MAAI,UAAU,UAAa,UAAU,KAAM,QAAO;AAClD,MAAI,OAAO,UAAU,WAAW;AAC9B,UAAM,IAAI,gBAAgB,GAAG,KAAK,oBAAoB;AAAA,EACxD;AACA,SAAO;AACT;;;AH3DA,SAAS,UAAU,KAAoB;AACrC,SAAO;AAAA,IACL,IAAI,IAAI;AAAA,IACR,KAAK,IAAI;AAAA,IACT,QAAQ,IAAI;AAAA,IACZ,SAAS,IAAI;AAAA,IACb,SAAS,IAAI;AAAA,IACb,UAAU,IAAI,aAAa;AAAA,IAC3B,OAAO,IAAI;AAAA,IACX,WAAW,IAAI,aAAa;AAAA,IAC5B,SAAS,IAAI,YAAY;AAAA,IACzB,gBAAgB,IAAI,kBAAkB;AAAA,IACtC,OAAO,IAAI,QAAQ,KAAK,MAAM,IAAI,KAAK,IAAI;AAAA,IAC3C,YAAY,KAAK,MAAM,IAAI,UAAU;AAAA,IACrC,eAAe,KAAK,MAAM,IAAI,aAAa;AAAA,IAC3C,UAAU,KAAK,MAAM,IAAI,QAAQ;AAAA,IACjC,YAAY,IAAI;AAAA,IAChB,YAAY,IAAI;AAAA,IAChB,YAAY,IAAI;AAAA,EAClB;AACF;AAeO,SAAS,WAAW,OAA8B;AACvD,QAAMC,MAAK,MAAM;AACjB,QAAM,OAAM,oBAAI,KAAK,GAAE,YAAY;AACnC,QAAM,KAAKC,QAAO;AAGlB,MAAI,QAAQ;AACZ,MAAI,MAAM,QAAQ;AAChB,UAAM,YAAYD,IAAG,QAAQ,sCAAsC,EAAE,IAAI,MAAM,MAAM;AACrF,QAAI,UAAW,SAAQ,UAAU,QAAQ;AAAA,EAC3C;AAEA,QAAM,OAAa;AAAA,IACjB;AAAA,IACA,KAAK;AAAA,IACL,QAAQ,MAAM,UAAU;AAAA,IACxB,SAAS,MAAM;AAAA,IACf,SAAS,MAAM;AAAA,IACf,UAAU;AAAA,IACV;AAAA,IACA,WAAW,MAAM,aAAa;AAAA,IAC9B,SAAS;AAAA,IACT,gBAAgB;AAAA,IAChB,OAAO,MAAM,SAAS;AAAA,IACtB,YAAY,MAAM,cAAc,CAAC;AAAA,IACjC,eAAe,MAAM,iBAAiB,CAAC;AAAA,IACvC,UAAU,CAAC;AAAA,IACX,YAAY,MAAM;AAAA,IAClB,YAAY;AAAA,IACZ,YAAY;AAAA,EACd;AAEA,EAAAA,IAAG,QAAQ;AAAA;AAAA;AAAA,GAGV,EAAE;AAAA,IACD,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AAAA,IACL;AAAA,IACA,KAAK;AAAA,IACL,KAAK;AAAA,IACL;AAAA,IACA;AAAA,IACA,KAAK,UAAU,OAAO,KAAK,UAAU,KAAK,KAAK,IAAI;AAAA,IACnD,KAAK,UAAU,KAAK,UAAU;AAAA,IAC9B,KAAK,UAAU,KAAK,aAAa;AAAA,IACjC,KAAK,UAAU,KAAK,QAAQ;AAAA,IAC5B,KAAK;AAAA,IACL,KAAK;AAAA,IACL,KAAK;AAAA,EACP;AAEA,WAAS,KAAK,IAAI,MAAM,OAAO,WAAW;AAAA,IACxC,EAAE,OAAO,WAAW,QAAQ,MAAM,OAAO,KAAK,QAAQ;AAAA,EACxD,CAAC;AAED,SAAO;AACT;AAIO,SAAS,QAAQ,IAAyB;AAC/C,QAAMA,MAAK,MAAM;AACjB,QAAM,MAAMA,IAAG,QAAQ,kCAAkC,EAAE,IAAI,EAAE;AAGjE,SAAO,MAAM,UAAU,GAAG,IAAI;AAChC;AAEO,SAAS,eAAe,IAAkB;AAC/C,QAAM,OAAO,QAAQ,EAAE;AACvB,MAAI,CAAC,MAAM;AACT,UAAM,IAAI,YAAY,kBAAkB,mBAAmB,EAAE,8DAA8D;AAAA,EAC7H;AACA,SAAO;AACT;AAEO,SAAS,YAAY,UAA0B;AACpD,QAAMA,MAAK,MAAM;AACjB,QAAM,OAAOA,IACV,QAAQ,sCAAsC,EAC9C,IAAI,QAAQ;AACf,SAAO,KAAK,IAAI,SAAS;AAC3B;AAEO,SAAS,aAAa,QAA2E;AACtG,QAAM,YAAuE,CAAC;AAC9E,MAAI,UAAU,QAAQ,MAAM;AAE5B,SAAO,SAAS,QAAQ;AACtB,UAAM,SAAS,QAAQ,QAAQ,MAAM;AACrC,QAAI,CAAC,OAAQ;AACb,cAAU,QAAQ,EAAE,IAAI,OAAO,IAAI,SAAS,OAAO,SAAS,UAAU,OAAO,SAAS,CAAC;AACvF,cAAU;AAAA,EACZ;AAEA,SAAO;AACT;AAEO,SAAS,eAAe,SAA8B;AAC3D,QAAMA,MAAK,MAAM;AACjB,QAAM,MAAMA,IACT,QAAQ,0DAA0D,EAClE,IAAI,OAAO;AACd,SAAO,MAAM,UAAU,GAAG,IAAI;AAChC;AAEO,SAAS,eAQb;AACD,QAAMA,MAAK,MAAM;AAEjB,QAAM,QAAQA,IACX,QAAQ,0CAA0C,EAClD,IAAI;AAEP,SAAO,MAAM,IAAI,CAAC,SAAS;AACzB,UAAM,SAASA,IACZ;AAAA,MACC;AAAA;AAAA;AAAA;AAAA,IAIF,EACC,IAAI,KAAK,OAAO;AAEnB,WAAO;AAAA,MACL,SAAS,KAAK;AAAA,MACd,IAAI,KAAK;AAAA,MACT,SAAS,KAAK;AAAA,MACd,OAAO,OAAO;AAAA,MACd,UAAU,OAAO;AAAA,MACjB,YAAY,OAAO,QAAQ,OAAO;AAAA,MAClC,YAAY,KAAK;AAAA,IACnB;AAAA,EACF,CAAC;AACH;AAmBO,SAAS,WAAW,OAA8B;AACvD,QAAMA,MAAK,MAAM;AACjB,QAAM,OAAO,eAAe,MAAM,OAAO;AACzC,QAAM,UAAyB,CAAC;AAChC,QAAM,OAAM,oBAAI,KAAK,GAAE,YAAY;AAEnC,MAAI,cAAc,KAAK;AACvB,MAAI,eAAe,KAAK;AACxB,MAAI,aAAa,KAAK;AACtB,MAAI,mBAAmB,KAAK;AAC5B,MAAI,WAAW,KAAK;AACpB,MAAI,aAAa,KAAK;AACtB,MAAI,gBAAgB,EAAE,GAAG,KAAK,WAAW;AACzC,MAAI,kBAAkB,CAAC,GAAG,KAAK,aAAa;AAC5C,MAAI,cAAc,CAAC,GAAG,KAAK,QAAQ;AAGnC,MAAI,MAAM,aAAa,QAAQ,CAAC,KAAK,UAAU;AAC7C,UAAM,sBAAsB,KAAK,SAAS,SAAS;AACnD,UAAM,iBAAiB,MAAM,gBAAgB,MAAM,aAAa,SAAS;AACzE,QAAI,CAAC,uBAAuB,CAAC,gBAAgB;AAC3C,YAAM,IAAI;AAAA,QACR;AAAA,QACA,uBAAuB,MAAM,OAAO;AAAA,MACtC;AAAA,IACF;AAAA,EACF;AAEA,MAAI,MAAM,aAAa,UAAa,MAAM,aAAa,KAAK,UAAU;AACpE,YAAQ,KAAK,EAAE,OAAO,YAAY,QAAQ,KAAK,UAAU,OAAO,MAAM,SAAS,CAAC;AAChF,kBAAc,MAAM;AAAA,EACtB;AAEA,MAAI,MAAM,cAAc,UAAa,MAAM,cAAc,KAAK,WAAW;AACvE,YAAQ,KAAK,EAAE,OAAO,aAAa,QAAQ,KAAK,WAAW,OAAO,MAAM,UAAU,CAAC;AACnF,mBAAe,MAAM;AAAA,EACvB;AAGA,MAAI,MAAM,YAAY,QAAQ,CAAC,KAAK,SAAS;AAC3C,UAAM,SAAS,MAAM,kBAAkB,KAAK;AAC5C,QAAI,CAAC,QAAQ;AACX,YAAM,IAAI;AAAA,QACR;AAAA,QACA,qBAAqB,MAAM,OAAO;AAAA,MACpC;AAAA,IACF;AAAA,EACF;AAEA,MAAI,MAAM,YAAY,UAAa,MAAM,YAAY,KAAK,SAAS;AACjE,YAAQ,KAAK,EAAE,OAAO,WAAW,QAAQ,KAAK,SAAS,OAAO,MAAM,QAAQ,CAAC;AAC7E,iBAAa,MAAM;AAEnB,QAAI,CAAC,MAAM,WAAW,MAAM,mBAAmB,QAAW;AACxD,UAAI,KAAK,mBAAmB,MAAM;AAChC,gBAAQ,KAAK,EAAE,OAAO,kBAAkB,QAAQ,KAAK,gBAAgB,OAAO,KAAK,CAAC;AAAA,MACpF;AACA,yBAAmB;AAAA,IACrB;AAAA,EACF;AAEA,MAAI,MAAM,mBAAmB,UAAa,MAAM,mBAAmB,KAAK,gBAAgB;AACtF,YAAQ,KAAK,EAAE,OAAO,kBAAkB,QAAQ,KAAK,gBAAgB,OAAO,MAAM,eAAe,CAAC;AAClG,uBAAmB,MAAM;AAAA,EAC3B;AAEA,MAAI,MAAM,UAAU,QAAW;AAC7B,YAAQ,KAAK,EAAE,OAAO,SAAS,QAAQ,KAAK,OAAO,OAAO,MAAM,MAAM,CAAC;AACvE,eAAW,MAAM;AAAA,EACnB;AAEA,MAAI,MAAM,YAAY,UAAa,MAAM,YAAY,KAAK,SAAS;AACjE,YAAQ,KAAK,EAAE,OAAO,WAAW,QAAQ,KAAK,SAAS,OAAO,MAAM,QAAQ,CAAC;AAC7E,iBAAa,MAAM;AAAA,EACrB;AAEA,MAAI,MAAM,YAAY;AACpB,eAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,MAAM,UAAU,GAAG;AAC3D,UAAI,UAAU,MAAM;AAClB,YAAI,OAAO,eAAe;AACxB,kBAAQ,KAAK,EAAE,OAAO,cAAc,GAAG,IAAI,QAAQ,cAAc,GAAG,GAAG,OAAO,KAAK,CAAC;AACpF,iBAAO,cAAc,GAAG;AAAA,QAC1B;AAAA,MACF,OAAO;AACL,gBAAQ,KAAK,EAAE,OAAO,cAAc,GAAG,IAAI,QAAQ,cAAc,GAAG,KAAK,MAAM,OAAO,MAAM,CAAC;AAC7F,sBAAc,GAAG,IAAI;AAAA,MACvB;AAAA,IACF;AAAA,EACF;AAEA,MAAI,MAAM,mBAAmB;AAC3B,eAAW,QAAQ,MAAM,mBAAmB;AAC1C,UAAI,CAAC,gBAAgB,SAAS,IAAI,GAAG;AACnC,wBAAgB,KAAK,IAAI;AACzB,gBAAQ,KAAK,EAAE,OAAO,iBAAiB,QAAQ,MAAM,OAAO,KAAK,CAAC;AAAA,MACpE;AAAA,IACF;AAAA,EACF;AAEA,MAAI,MAAM,sBAAsB;AAC9B,eAAW,QAAQ,MAAM,sBAAsB;AAC7C,YAAM,MAAM,gBAAgB,QAAQ,IAAI;AACxC,UAAI,QAAQ,IAAI;AACd,wBAAgB,OAAO,KAAK,CAAC;AAC7B,gBAAQ,KAAK,EAAE,OAAO,iBAAiB,QAAQ,MAAM,OAAO,KAAK,CAAC;AAAA,MACpE;AAAA,IACF;AAAA,EACF;AAEA,MAAI,MAAM,cAAc;AACtB,eAAW,MAAM,MAAM,cAAc;AACnC,YAAM,WAAqB;AAAA,QACzB,MAAM,GAAG;AAAA,QACT,KAAK,GAAG;AAAA,QACR,OAAO,MAAM;AAAA,QACb,WAAW;AAAA,MACb;AACA,kBAAY,KAAK,QAAQ;AACzB,cAAQ,KAAK,EAAE,OAAO,YAAY,QAAQ,MAAM,OAAO,SAAS,CAAC;AAAA,IACnE;AAAA,EACF;AAEA,MAAI,QAAQ,WAAW,GAAG;AACxB,WAAO;AAAA,EACT;AAEA,QAAM,SAAS,KAAK,MAAM;AAE1B,EAAAA,IAAG,QAAQ;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,GAcV,EAAE;AAAA,IACD;AAAA,IACA,cAAc,IAAI;AAAA,IAClB;AAAA,IACA,aAAa,IAAI;AAAA,IACjB;AAAA,IACA,aAAa,OAAO,KAAK,UAAU,QAAQ,IAAI;AAAA,IAC/C;AAAA,IACA,KAAK,UAAU,aAAa;AAAA,IAC5B,KAAK,UAAU,eAAe;AAAA,IAC9B,KAAK,UAAU,WAAW;AAAA,IAC1B;AAAA,IACA,MAAM;AAAA,EACR;AAEA,QAAM,SAAS,MAAM,aAAa,OAAO,aAAa;AACtD,WAAS,MAAM,SAAS,MAAM,OAAO,QAAQ,OAAO;AAEpD,SAAO,eAAe,MAAM,OAAO;AACrC;AAIO,SAAS,mBAAmB,QAAqD;AACtF,QAAMA,MAAK,MAAM;AACjB,QAAM,MAAMA,IAAG;AAAA,IACb;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASF,EAAE,IAAI,MAAM;AACZ,SAAO,EAAE,UAAU,IAAI,UAAU,OAAO,IAAI,MAAM;AACpD;AAIO,SAAS,kBAAkB,SAMhC;AACA,QAAMA,MAAK,MAAM;AAEjB,QAAM,SAASA,IACZ;AAAA,IACC;AAAA;AAAA;AAAA;AAAA,EAIF,EACC,IAAI,OAAO;AAGd,QAAM,UAAUA,IACb;AAAA,IACC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASF,EACC,IAAI,SAAS,OAAO;AAGvB,QAAM,aAAaA,IAChB;AAAA,IACC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUF,EACC,IAAI,OAAO;AAEd,SAAO;AAAA,IACL,OAAO,OAAO;AAAA,IACd,UAAU,OAAO;AAAA,IACjB,YAAY,OAAO,QAAQ,OAAO;AAAA,IAClC,SAAS,QAAQ;AAAA,IACjB,YAAY,WAAW;AAAA,EACzB;AACF;","names":["nanoid","db","db","db","nanoid"]}

package/dist/index.js

@@ -6,10 +6,10 @@ if (args[0] === "activate") {
   const { activate } = await import("./activate-DSDTR2EJ.js");
   activate(args[1]);
 } else if (args[0] === "init") {
-  const { init } = await import("./init-3QDDFQ3G.js");
+  const { init } = await import("./init-YFC5JVM5.js");
   init();
 } else {
-  const { startServer } = await import("./server-WMNM7Q2E.js");
+  const { startServer } = await import("./server-SNA2JYGG.js");
   startServer().catch((error) => {
     console.error("Failed to start graph:", error);
     process.exit(1);

package/dist/{init-3QDDFQ3G.js → init-YFC5JVM5.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import {
   handleAgentConfig
-} from "./chunk-GALSWONI.js";
+} from "./chunk-DUEP3T5A.js";
 
 // src/init.ts
 import { readFileSync, writeFileSync, existsSync, mkdirSync } from "fs";
@@ -76,4 +76,4 @@ function init() {
 export {
   init
 };
-//# sourceMappingURL=init-3QDDFQ3G.js.map
+//# sourceMappingURL=init-YFC5JVM5.js.map

package/dist/{nodes-4OJBNDHG.js → nodes-YKHXSWC4.js}

@@ -7,9 +7,10 @@ import {
   getNodeOrThrow,
   getProjectRoot,
   getProjectSummary,
+  getSubtreeProgress,
   listProjects,
   updateNode
-} from "./chunk-TWT5GUXW.js";
+} from "./chunk-EG42TNON.js";
 export {
   createNode,
   getAncestors,
@@ -18,7 +19,8 @@ export {
   getNodeOrThrow,
   getProjectRoot,
   getProjectSummary,
+  getSubtreeProgress,
   listProjects,
   updateNode
 };
-//# sourceMappingURL=nodes-4OJBNDHG.js.map
+//# sourceMappingURL=nodes-YKHXSWC4.js.map

package/dist/{server-WMNM7Q2E.js → server-SNA2JYGG.js}

@@ -4,7 +4,7 @@ import {
 } from "./chunk-WKOEKYTF.js";
 import {
   handleAgentConfig
-} from "./chunk-GALSWONI.js";
+} from "./chunk-DUEP3T5A.js";
 import {
   EngineError,
   ValidationError,
@@ -19,6 +19,7 @@ import {
   getNodeOrThrow,
   getProjectRoot,
   getProjectSummary,
+  getSubtreeProgress,
   listProjects,
   logEvent,
   optionalBoolean,
@@ -28,7 +29,7 @@ import {
   requireString,
   setDbPath,
   updateNode
-} from "./chunk-TWT5GUXW.js";
+} from "./chunk-EG42TNON.js";
 
 // src/server.ts
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
@@ -335,6 +336,8 @@ function handleUpdate(input, agent) {
       agent,
       resolved: entry.resolved,
       discovery: entry.discovery,
+      blocked: entry.blocked,
+      blocked_reason: entry.blocked_reason,
       state: entry.state,
       summary: entry.summary,
       properties: entry.properties,
@@ -460,6 +463,7 @@ function buildNodeTree(nodeId, currentDepth, maxDepth) {
   if (children.length === 0) {
     return tree;
   }
+  tree.progress = getSubtreeProgress(nodeId);
   if (currentDepth < maxDepth) {
     tree.children = children.map(
       (child) => buildNodeTree(child.id, currentDepth + 1, maxDepth)
@@ -544,6 +548,7 @@ function handleQuery(input) {
   }
   if (filter?.is_actionable) {
     conditions.push("n.resolved = 0");
+    conditions.push("n.blocked = 0");
     conditions.push(
       "NOT EXISTS (SELECT 1 FROM nodes child WHERE child.parent = n.id AND child.resolved = 0)"
     );
@@ -558,11 +563,11 @@ function handleQuery(input) {
   if (filter?.is_blocked) {
     conditions.push("n.resolved = 0");
     conditions.push(
-      `EXISTS (
+      `(n.blocked = 1 OR EXISTS (
         SELECT 1 FROM edges e
         JOIN nodes dep ON dep.id = e.to_node AND dep.resolved = 0
         WHERE e.from_node = n.id AND e.type = 'depends_on'
-      )`
+      ))`
     );
   }
   if (filter?.properties) {
@@ -654,7 +659,7 @@ function handleNext(input, agent, claimTtlMinutes = 60) {
   }
   let query = `
     SELECT n.* FROM nodes n
-    WHERE n.project = ? AND n.resolved = 0
+    WHERE n.project = ? AND n.resolved = 0 AND n.blocked = 0
     ${scopeFilter}
     AND NOT EXISTS (
       SELECT 1 FROM nodes child WHERE child.parent = n.id AND child.resolved = 0
@@ -733,7 +738,23 @@ function handleNext(input, agent, claimTtlMinutes = 60) {
       resolved_deps
     };
   });
-  return { nodes: results };
+  const claimRows = db.prepare(
+    `SELECT id, summary, json_extract(properties, '$._claimed_at') as claimed_at
+       FROM nodes
+       WHERE project = ? AND resolved = 0
+       AND json_extract(properties, '$._claimed_by') = ?
+       AND json_extract(properties, '$._claimed_at') > ?
+       ORDER BY json_extract(properties, '$._claimed_at') DESC`
+  ).all(project, agent, claimCutoff);
+  const result = { nodes: results };
+  if (claimRows.length > 0) {
+    result.your_claims = claimRows.map((r) => ({
+      id: r.id,
+      summary: r.summary,
+      claimed_at: r.claimed_at
+    }));
+  }
+  return result;
 }
 
 // src/tools/restructure.ts
@@ -1003,7 +1024,7 @@ function handleOnboard(input) {
   const topChildren = db.prepare("SELECT * FROM nodes WHERE parent = ? ORDER BY created_at ASC").all(root.id);
   const tree = topChildren.map((child) => {
     const grandchildren = db.prepare(
-      `SELECT id, summary, resolved,
+      `SELECT id, summary, resolved, blocked, blocked_reason,
          (SELECT COUNT(*) FROM nodes gc WHERE gc.parent = n.id) as child_count
          FROM nodes n WHERE parent = ? ORDER BY created_at ASC`
     ).all(child.id);
@@ -1012,10 +1033,14 @@ function handleOnboard(input) {
       summary: child.summary,
       resolved: child.resolved === 1,
       discovery: child.discovery,
+      blocked: child.blocked === 1,
+      blocked_reason: child.blocked_reason,
       children: grandchildren.map((gc) => ({
         id: gc.id,
         summary: gc.summary,
         resolved: gc.resolved === 1,
+        blocked: gc.blocked === 1,
+        blocked_reason: gc.blocked_reason,
         child_count: gc.child_count
       }))
     };
@@ -1049,7 +1074,7 @@ function handleOnboard(input) {
   const knowledgeRows = db.prepare("SELECT key, content, updated_at FROM knowledge WHERE project = ? ORDER BY updated_at DESC").all(project);
   const actionableRows = db.prepare(
     `SELECT n.id, n.summary, n.properties FROM nodes n
-       WHERE n.project = ? AND n.resolved = 0
+       WHERE n.project = ? AND n.resolved = 0 AND n.blocked = 0
        AND NOT EXISTS (
          SELECT 1 FROM nodes child WHERE child.parent = n.id AND child.resolved = 0
        )
@@ -1124,15 +1149,25 @@ function buildTree(node, currentDepth, maxDepth, stats) {
     resolved: node.resolved,
     properties: node.properties
   };
-  if (children.length === 0) return treeNode;
+  let subtotal = 1;
+  let subresolved = node.resolved ? 1 : 0;
+  if (children.length === 0) return { treeNode, subtotal, subresolved };
   if (currentDepth < maxDepth) {
-    treeNode.children = children.map(
-      (child) => buildTree(child, currentDepth + 1, maxDepth, stats)
-    );
+    treeNode.children = [];
+    for (const child of children) {
+      const result = buildTree(child, currentDepth + 1, maxDepth, stats);
+      treeNode.children.push(result.treeNode);
+      subtotal += result.subtotal;
+      subresolved += result.subresolved;
+    }
   } else {
     treeNode.child_count = children.length;
+    const progress = getSubtreeProgress(node.id);
+    subtotal = progress.total;
+    subresolved = progress.resolved;
   }
-  return treeNode;
+  treeNode.progress = { resolved: subresolved, total: subtotal };
+  return { treeNode, subtotal, subresolved };
 }
 function handleTree(input) {
   const project = requireString(input?.project, "project");
@@ -1142,10 +1177,10 @@ function handleTree(input) {
     throw new EngineError("project_not_found", `Project not found: ${project}`);
   }
   const stats = { total: 0, resolved: 0 };
-  const tree = buildTree(root, 0, depth, stats);
+  const { treeNode } = buildTree(root, 0, depth, stats);
   return {
     project,
-    tree,
+    tree: treeNode,
     stats: {
       total: stats.total,
       resolved: stats.resolved,
@@ -1452,6 +1487,8 @@ var TOOLS = [
               resolved: { type: "boolean" },
               resolved_reason: { type: "string", description: "Shorthand: auto-creates a note evidence entry. Use instead of add_evidence for simple cases." },
               discovery: { type: "string", description: "Discovery phase status: 'pending' or 'done'. Set to 'done' after completing discovery interview." },
+              blocked: { type: "boolean", description: "Manually block/unblock a node. Blocked nodes are skipped by graph_next. Use for external blockers (e.g., waiting on domain purchase, another team)." },
+              blocked_reason: { type: "string", description: "Why the node is blocked. Cleared automatically when unblocking." },
               state: { description: "Agent-defined state, any type" },
               summary: { type: "string" },
               properties: {
@@ -1705,7 +1742,7 @@ async function startServer() {
         case "graph_open": {
           const openArgs = args;
           if (openArgs?.project) {
-            const { getProjectRoot: getProjectRoot2 } = await import("./nodes-4OJBNDHG.js");
+            const { getProjectRoot: getProjectRoot2 } = await import("./nodes-YKHXSWC4.js");
             if (!getProjectRoot2(openArgs.project)) {
               checkProjectLimit(tier);
             }
@@ -1716,7 +1753,7 @@ async function startServer() {
         case "graph_plan": {
           const planArgs = args;
           if (planArgs?.nodes?.length > 0) {
-            const { getNode: getNode2 } = await import("./nodes-4OJBNDHG.js");
+            const { getNode: getNode2 } = await import("./nodes-YKHXSWC4.js");
             const firstParent = planArgs.nodes[0]?.parent_ref;
             if (firstParent && typeof firstParent === "string" && !planArgs.nodes.some((n) => n.ref === firstParent)) {
               const parentNode = getNode2(firstParent);
@@ -1841,7 +1878,7 @@ async function startServer() {
   }));
   server.setRequestHandler(ListResourcesRequestSchema, async () => {
     try {
-      const { listProjects: listProjects2 } = await import("./nodes-4OJBNDHG.js");
+      const { listProjects: listProjects2 } = await import("./nodes-YKHXSWC4.js");
       const projects = listProjects2();
       const resources = projects.flatMap((p) => [
         {
@@ -1912,4 +1949,4 @@ async function startServer() {
 export {
   startServer
 };
-//# sourceMappingURL=server-WMNM7Q2E.js.map
+//# sourceMappingURL=server-SNA2JYGG.js.map