11# Agent task prompts — ` trace ` tool (PR-TRACE-1a → PR-TRACE-4)
22
3- Status: ** active ** . Plan:
4- [ ` plans/active /PLAN-TRACE-TOOL.md ` ] ( PLAN-TRACE-TOOL.md ) ; propose:
3+ Status: ** completed ** . Plan:
4+ [ ` plans/completed /PLAN-TRACE-TOOL.md ` ] ( PLAN-TRACE-TOOL.md ) ; propose:
55[ ` propose/active/TRACE-TOOL-PROPOSE.md ` ] ( ../../propose/active/TRACE-TOOL-PROPOSE.md ) .
66
77One prompt per PR. Copy the prompt verbatim into Cursor agent mode with the
@@ -28,12 +28,12 @@ listed `@-files` attached.
2828
2929** Branch:** ` feat/trace-core-bfs ` off ` experimental ` .
3030** Base:** ` experimental ` .
31- ** Plan section:** ` plans/active /PLAN-TRACE-TOOL.md ` § PR-TRACE-1a.
31+ ** Plan section:** ` plans/completed /PLAN-TRACE-TOOL.md ` § PR-TRACE-1a.
3232** PR title:** ` add trace tool core BFS engine (PR-TRACE-1a) `
3333
3434** Attach (` @-files ` ):**
3535
36- - ` @plans/active /PLAN-TRACE-TOOL.md ` (PR-TRACE-1a section only)
36+ - ` @plans/completed /PLAN-TRACE-TOOL.md ` (PR-TRACE-1a section only)
3737- ` @propose/active/TRACE-TOOL-PROPOSE.md ` (§ "Signature", § "Result format", § "Core algorithm")
3838- ` @mcp_v2.py ` (read-only — import types only: ` NodeFilter ` , ` EdgeFilter ` , ` NodeRef ` , ` _node_ref_from_row ` , ` _node_kind_from_id ` )
3939- ` @kuzu_queries.py ` (read-only — reuse ` g._rows ` query pattern; do not modify)
@@ -44,7 +44,7 @@ listed `@-files` attached.
4444** Prompt:**
4545
4646````
47- You are implementing PR-TRACE-1a from `plans/active /PLAN-TRACE-TOOL.md`.
47+ You are implementing PR-TRACE-1a from `plans/completed /PLAN-TRACE-TOOL.md`.
4848
4949Read the **PR-TRACE-1a** section and the propose § "Signature", "Result format", and
5050"Core algorithm" sections before writing code. If this prompt and the plan disagree,
@@ -186,12 +186,12 @@ for e in out.edges[:5]:
186186** Branch:** ` feat/trace-pruning ` off ` experimental ` (after PR-TRACE-1a merged).
187187** Base:** ` experimental ` (with PR-TRACE-1a merged).
188188** Blocked on:** PR-TRACE-1a merged to ` experimental ` .
189- ** Plan section:** ` plans/active /PLAN-TRACE-TOOL.md ` § PR-TRACE-1b.
189+ ** Plan section:** ` plans/completed /PLAN-TRACE-TOOL.md ` § PR-TRACE-1b.
190190** PR title:** ` add trace pruning collapsing cross-service (PR-TRACE-1b) `
191191
192192** Attach (` @-files ` ):**
193193
194- - ` @plans/active /PLAN-TRACE-TOOL.md ` (PR-TRACE-1b section only)
194+ - ` @plans/completed /PLAN-TRACE-TOOL.md ` (PR-TRACE-1b section only)
195195- ` @propose/active/TRACE-TOOL-PROPOSE.md ` (§ "Server-side pruning", § "Cross-service traversal")
196196- ` @mcp_trace.py ` (from PR-TRACE-1a — this is the file you are extending)
197197- ` @mcp_v2.py ` (read-only — reference for ` NodeFilter ` , ` EdgeFilter ` semantics)
@@ -201,7 +201,7 @@ for e in out.edges[:5]:
201201** Prompt:**
202202
203203````
204- You are implementing PR-TRACE-1b from `plans/active /PLAN-TRACE-TOOL.md`.
204+ You are implementing PR-TRACE-1b from `plans/completed /PLAN-TRACE-TOOL.md`.
205205
206206PR-TRACE-1a (core BFS engine) is already merged to `experimental`. This PR extends
207207`mcp_trace.py` with pruning, collapsing, and cross-service features. Read the
@@ -355,12 +355,12 @@ print('collapsed:', out.stats.edges_collapsed_trivial, 'trivial chains collapsed
355355** Branch:** ` feat/trace-mcp-registration ` off ` experimental ` (after PR-TRACE-1b merged).
356356** Base:** ` experimental ` (with PR-TRACE-1b merged).
357357** Blocked on:** PR-TRACE-1b merged to ` experimental ` .
358- ** Plan section:** ` plans/active /PLAN-TRACE-TOOL.md ` § PR-TRACE-2.
358+ ** Plan section:** ` plans/completed /PLAN-TRACE-TOOL.md ` § PR-TRACE-2.
359359** PR title:** ` register trace as sixth MCP tool (PR-TRACE-2) `
360360
361361** Attach (` @-files ` ):**
362362
363- - ` @plans/active /PLAN-TRACE-TOOL.md ` (PR-TRACE-2 section only)
363+ - ` @plans/completed /PLAN-TRACE-TOOL.md ` (PR-TRACE-2 section only)
364364- ` @propose/active/TRACE-TOOL-PROPOSE.md ` (§ "Agent tool selection" for description guidance)
365365- ` @server.py `
366366- ` @mcp_trace.py ` (read-only — already shipped via PR-TRACE-1a/1b)
@@ -371,7 +371,7 @@ print('collapsed:', out.stats.edges_collapsed_trivial, 'trivial chains collapsed
371371** Prompt:**
372372
373373````
374- You are implementing PR-TRACE-2 from `plans/active /PLAN-TRACE-TOOL.md`.
374+ You are implementing PR-TRACE-2 from `plans/completed /PLAN-TRACE-TOOL.md`.
375375
376376PR-TRACE-1a + 1b (`mcp_trace.py` with full BFS + pruning) is already merged to
377377`experimental`. This PR wires `trace` into the MCP surface in `server.py`.
@@ -476,12 +476,12 @@ print('ok: trace registered as 6th tool')
476476** Branch:** ` feat/trace-hints-skill ` off ` experimental ` (after PR-TRACE-1b merged).
477477** Base:** ` experimental ` (with PR-TRACE-1b merged).
478478** Blocked on:** PR-TRACE-1b merged to ` experimental ` . Independent of PR-TRACE-2.
479- ** Plan section:** ` plans/active /PLAN-TRACE-TOOL.md ` § PR-TRACE-3.
479+ ** Plan section:** ` plans/completed /PLAN-TRACE-TOOL.md ` § PR-TRACE-3.
480480** PR title:** ` add trace hints and skill integration (PR-TRACE-3) `
481481
482482** Attach (` @-files ` ):**
483483
484- - ` @plans/active /PLAN-TRACE-TOOL.md ` (PR-TRACE-3 section only)
484+ - ` @plans/completed /PLAN-TRACE-TOOL.md ` (PR-TRACE-3 section only)
485485- ` @propose/active/TRACE-TOOL-PROPOSE.md ` (§ "Hint system updates", § "Skill decision tree update")
486486- ` @mcp_hints.py `
487487- ` @mcp_trace.py ` (read-only — reference for ` TraceOutput ` shape)
@@ -492,7 +492,7 @@ print('ok: trace registered as 6th tool')
492492** Prompt:**
493493
494494````
495- You are implementing PR-TRACE-3 from `plans/active /PLAN-TRACE-TOOL.md`.
495+ You are implementing PR-TRACE-3 from `plans/completed /PLAN-TRACE-TOOL.md`.
496496
497497PR-TRACE-1a + 1b (`mcp_trace.py`) is merged to `experimental`. PR-TRACE-2 (server
498498registration) may or may not be merged — this PR is independent of it. This PR adds
@@ -635,12 +635,12 @@ print('ok')
635635** Branch:** ` feat/trace-docs ` off ` experimental ` (after PR-TRACE-3 merged).
636636** Base:** ` experimental ` (with PR-TRACE-3 merged).
637637** Blocked on:** PR-TRACE-3 merged to ` experimental ` .
638- ** Plan section:** ` plans/active /PLAN-TRACE-TOOL.md ` § PR-TRACE-4.
638+ ** Plan section:** ` plans/completed /PLAN-TRACE-TOOL.md ` § PR-TRACE-4.
639639** PR title:** ` update docs for trace tool (PR-TRACE-4) `
640640
641641** Attach (` @-files ` ):**
642642
643- - ` @plans/active /PLAN-TRACE-TOOL.md ` (PR-TRACE-4 section only)
643+ - ` @plans/completed /PLAN-TRACE-TOOL.md ` (PR-TRACE-4 section only)
644644- ` @README.md `
645645- ` @docs/AGENT-GUIDE.md `
646646- ` @AGENTS.md `
@@ -649,7 +649,7 @@ print('ok')
649649** Prompt:**
650650
651651````
652- You are implementing PR-TRACE-4 from `plans/active /PLAN-TRACE-TOOL.md`.
652+ You are implementing PR-TRACE-4 from `plans/completed /PLAN-TRACE-TOOL.md`.
653653
654654PR-TRACE-1a, 1b, 2, and 3 are merged to `experimental`. This PR is documentation-only.
655655
0 commit comments