@pi-agents/orchid 0.1.0-beta.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (163) hide show
  1. package/CHANGELOG.md +41 -0
  2. package/LICENSE +21 -0
  3. package/README.md +246 -0
  4. package/agents/AGENTS-MANIFEST.md +42 -0
  5. package/agents/brain.md +42 -0
  6. package/agents/context-builder.md +46 -0
  7. package/agents/delegate.md +12 -0
  8. package/agents/dev-1.md +42 -0
  9. package/agents/oracle.md +73 -0
  10. package/agents/planner.md +55 -0
  11. package/agents/researcher.md +52 -0
  12. package/agents/reviewer.md +79 -0
  13. package/agents/scout.md +50 -0
  14. package/agents/tester.md +45 -0
  15. package/agents/worker.md +55 -0
  16. package/extensions/ralph.ts +1 -0
  17. package/extensions/reviewer-extension.ts +125 -0
  18. package/extensions/task-orchestrator.ts +28 -0
  19. package/package.json +63 -0
  20. package/prompts/gather-context-and-clarify.md +13 -0
  21. package/prompts/parallel-cleanup.md +59 -0
  22. package/prompts/parallel-context-build.md +53 -0
  23. package/prompts/parallel-handoff-plan.md +59 -0
  24. package/prompts/parallel-research.md +50 -0
  25. package/prompts/parallel-review.md +54 -0
  26. package/prompts/review-loop.md +41 -0
  27. package/skills/orchid/SKILL.md +214 -0
  28. package/skills/orchid/orchid-cleanup/SKILL.md +122 -0
  29. package/skills/orchid/orchid-converge/SKILL.md +124 -0
  30. package/skills/orchid/orchid-decompose/SKILL.md +201 -0
  31. package/skills/orchid/orchid-doctor/SKILL.md +162 -0
  32. package/skills/orchid/orchid-investigate/SKILL.md +102 -0
  33. package/skills/orchid/orchid-launch/SKILL.md +147 -0
  34. package/skills/ralph/SKILL.md +73 -0
  35. package/skills/subagents/pi-subagents/SKILL.md +813 -0
  36. package/src/index.ts +7 -0
  37. package/src/orchestrator/abort.ts +534 -0
  38. package/src/orchestrator/agent-bridge-extension.ts +1020 -0
  39. package/src/orchestrator/agent-host.ts +954 -0
  40. package/src/orchestrator/cleanup.ts +776 -0
  41. package/src/orchestrator/config-loader.ts +1412 -0
  42. package/src/orchestrator/config-schema.ts +690 -0
  43. package/src/orchestrator/config.ts +81 -0
  44. package/src/orchestrator/context-window.ts +66 -0
  45. package/src/orchestrator/diagnostic-reports.ts +475 -0
  46. package/src/orchestrator/diagnostics.ts +394 -0
  47. package/src/orchestrator/discovery.ts +1833 -0
  48. package/src/orchestrator/engine-worker.ts +415 -0
  49. package/src/orchestrator/engine.ts +5940 -0
  50. package/src/orchestrator/execution.ts +3104 -0
  51. package/src/orchestrator/extension.ts +5934 -0
  52. package/src/orchestrator/formatting.ts +785 -0
  53. package/src/orchestrator/git.ts +88 -0
  54. package/src/orchestrator/index.ts +28 -0
  55. package/src/orchestrator/lane-runner.ts +1787 -0
  56. package/src/orchestrator/mailbox.ts +780 -0
  57. package/src/orchestrator/merge.ts +3414 -0
  58. package/src/orchestrator/messages.ts +1062 -0
  59. package/src/orchestrator/migrations.ts +278 -0
  60. package/src/orchestrator/naming.ts +117 -0
  61. package/src/orchestrator/path-resolver.ts +275 -0
  62. package/src/orchestrator/persistence.ts +2625 -0
  63. package/src/orchestrator/process-registry.ts +452 -0
  64. package/src/orchestrator/quality-gate.ts +1085 -0
  65. package/src/orchestrator/resume.ts +3488 -0
  66. package/src/orchestrator/sessions.ts +57 -0
  67. package/src/orchestrator/settings-loader.ts +136 -0
  68. package/src/orchestrator/settings-tui.ts +2208 -0
  69. package/src/orchestrator/sidecar-telemetry.ts +267 -0
  70. package/src/orchestrator/supervisor.ts +4548 -0
  71. package/src/orchestrator/task-executor-core.ts +675 -0
  72. package/src/orchestrator/tmux-compat.ts +37 -0
  73. package/src/orchestrator/tool-allowlist-constants.ts +37 -0
  74. package/src/orchestrator/types.ts +4465 -0
  75. package/src/orchestrator/verification.ts +547 -0
  76. package/src/orchestrator/waves.ts +1564 -0
  77. package/src/orchestrator/workspace.ts +707 -0
  78. package/src/orchestrator/worktree.ts +2725 -0
  79. package/src/ralph/index.ts +825 -0
  80. package/src/subagents/agents/agent-management.ts +648 -0
  81. package/src/subagents/agents/agent-scope.ts +6 -0
  82. package/src/subagents/agents/agent-selection.ts +23 -0
  83. package/src/subagents/agents/agent-serializer.ts +86 -0
  84. package/src/subagents/agents/agents.ts +832 -0
  85. package/src/subagents/agents/chain-serializer.ts +137 -0
  86. package/src/subagents/agents/frontmatter.ts +29 -0
  87. package/src/subagents/agents/identity.ts +30 -0
  88. package/src/subagents/agents/skills.ts +632 -0
  89. package/src/subagents/extension/config.ts +16 -0
  90. package/src/subagents/extension/control-notices.ts +92 -0
  91. package/src/subagents/extension/doctor.ts +199 -0
  92. package/src/subagents/extension/fanout-child.ts +170 -0
  93. package/src/subagents/extension/index.ts +573 -0
  94. package/src/subagents/extension/schemas.ts +168 -0
  95. package/src/subagents/intercom/intercom-bridge.ts +379 -0
  96. package/src/subagents/intercom/result-intercom.ts +377 -0
  97. package/src/subagents/runs/background/async-execution.ts +712 -0
  98. package/src/subagents/runs/background/async-job-tracker.ts +310 -0
  99. package/src/subagents/runs/background/async-resume.ts +345 -0
  100. package/src/subagents/runs/background/async-status.ts +325 -0
  101. package/src/subagents/runs/background/completion-dedupe.ts +63 -0
  102. package/src/subagents/runs/background/notify.ts +108 -0
  103. package/src/subagents/runs/background/parallel-groups.ts +45 -0
  104. package/src/subagents/runs/background/result-watcher.ts +307 -0
  105. package/src/subagents/runs/background/run-id-resolver.ts +83 -0
  106. package/src/subagents/runs/background/run-status.ts +269 -0
  107. package/src/subagents/runs/background/stale-run-reconciler.ts +336 -0
  108. package/src/subagents/runs/background/subagent-runner.ts +1808 -0
  109. package/src/subagents/runs/background/top-level-async.ts +13 -0
  110. package/src/subagents/runs/foreground/chain-clarify.ts +1333 -0
  111. package/src/subagents/runs/foreground/chain-execution.ts +938 -0
  112. package/src/subagents/runs/foreground/execution.ts +918 -0
  113. package/src/subagents/runs/foreground/subagent-executor.ts +2527 -0
  114. package/src/subagents/runs/shared/completion-guard.ts +147 -0
  115. package/src/subagents/runs/shared/long-running-guard.ts +175 -0
  116. package/src/subagents/runs/shared/mcp-direct-tool-allowlist.ts +365 -0
  117. package/src/subagents/runs/shared/model-fallback.ts +103 -0
  118. package/src/subagents/runs/shared/nested-events.ts +819 -0
  119. package/src/subagents/runs/shared/nested-path.ts +52 -0
  120. package/src/subagents/runs/shared/nested-render.ts +115 -0
  121. package/src/subagents/runs/shared/parallel-utils.ts +109 -0
  122. package/src/subagents/runs/shared/pi-args.ts +220 -0
  123. package/src/subagents/runs/shared/pi-spawn.ts +115 -0
  124. package/src/subagents/runs/shared/run-history.ts +60 -0
  125. package/src/subagents/runs/shared/single-output.ts +164 -0
  126. package/src/subagents/runs/shared/subagent-control.ts +226 -0
  127. package/src/subagents/runs/shared/subagent-prompt-runtime.ts +170 -0
  128. package/src/subagents/runs/shared/worktree.ts +577 -0
  129. package/src/subagents/shared/artifacts.ts +98 -0
  130. package/src/subagents/shared/atomic-json.ts +16 -0
  131. package/src/subagents/shared/file-coalescer.ts +40 -0
  132. package/src/subagents/shared/fork-context.ts +76 -0
  133. package/src/subagents/shared/formatters.ts +133 -0
  134. package/src/subagents/shared/jsonl-writer.ts +81 -0
  135. package/src/subagents/shared/model-info.ts +78 -0
  136. package/src/subagents/shared/post-exit-stdio-guard.ts +85 -0
  137. package/src/subagents/shared/session-identity.ts +10 -0
  138. package/src/subagents/shared/session-tokens.ts +44 -0
  139. package/src/subagents/shared/settings.ts +397 -0
  140. package/src/subagents/shared/status-format.ts +49 -0
  141. package/src/subagents/shared/types.ts +822 -0
  142. package/src/subagents/shared/utils.ts +450 -0
  143. package/src/subagents/slash/prompt-template-bridge.ts +397 -0
  144. package/src/subagents/slash/slash-bridge.ts +174 -0
  145. package/src/subagents/slash/slash-commands.ts +528 -0
  146. package/src/subagents/slash/slash-live-state.ts +292 -0
  147. package/src/subagents/tui/render-helpers.ts +80 -0
  148. package/src/subagents/tui/render.ts +1358 -0
  149. package/templates/agents/local/supervisor.md +33 -0
  150. package/templates/agents/local/task-merger.md +27 -0
  151. package/templates/agents/local/task-reviewer.md +30 -0
  152. package/templates/agents/local/task-worker.md +34 -0
  153. package/templates/agents/supervisor-routing.md +92 -0
  154. package/templates/agents/supervisor.md +229 -0
  155. package/templates/agents/task-merger.md +214 -0
  156. package/templates/agents/task-reviewer.md +260 -0
  157. package/templates/agents/task-worker-segment.md +44 -0
  158. package/templates/agents/task-worker.md +557 -0
  159. package/templates/tasks/CONTEXT.md +30 -0
  160. package/templates/tasks/EXAMPLE-001-hello-world/PROMPT.md +98 -0
  161. package/templates/tasks/EXAMPLE-001-hello-world/STATUS.md +73 -0
  162. package/templates/tasks/EXAMPLE-002-parallel-smoke/PROMPT.md +97 -0
  163. package/templates/tasks/EXAMPLE-002-parallel-smoke/STATUS.md +73 -0
@@ -0,0 +1,73 @@
1
+ # EXAMPLE-001: Hello World — Status
2
+
3
+ **Current Step:** Not Started
4
+ **Status:** 🔵 Ready for Execution
5
+ **Last Updated:** {{date}}
6
+ **Review Level:** 0
7
+ **Review Counter:** 0
8
+ **Iteration:** 0
9
+ **Size:** S
10
+
11
+ ---
12
+
13
+ ### Step 0: Preflight
14
+ **Status:** ⬜ Not Started
15
+
16
+ - [ ] Verify PROMPT.md is readable
17
+ - [ ] Verify STATUS.md exists
18
+
19
+ ---
20
+
21
+ ### Step 1: Create Hello File
22
+ **Status:** ⬜ Not Started
23
+
24
+ - [ ] Create `hello-taskplane.md` in project root
25
+ - [ ] Add title, date, and task ID (EXAMPLE-001)
26
+
27
+ ---
28
+
29
+ ### Step 2: Verification
30
+ **Status:** ⬜ Not Started
31
+
32
+ - [ ] Verify file exists and matches expected content
33
+
34
+ ---
35
+
36
+ ### Step 3: Delivery
37
+ **Status:** ⬜ Not Started
38
+
39
+
40
+
41
+ ---
42
+
43
+ ## Reviews
44
+
45
+ | # | Type | Step | Verdict | File |
46
+ |---|------|------|---------|------|
47
+
48
+ ---
49
+
50
+ ## Discoveries
51
+
52
+ | Discovery | Disposition | Location |
53
+ |-----------|-------------|----------|
54
+
55
+ ---
56
+
57
+ ## Execution Log
58
+
59
+ | Timestamp | Action | Outcome |
60
+ |-----------|--------|---------|
61
+ | {{date}} | Task staged | PROMPT.md and STATUS.md created |
62
+
63
+ ---
64
+
65
+ ## Blockers
66
+
67
+ *None*
68
+
69
+ ---
70
+
71
+ ## Notes
72
+
73
+ *This is an example task created by `taskplane init`. Delete it after verifying your setup works.*
@@ -0,0 +1,97 @@
1
+ # Task: EXAMPLE-002 — Parallel Smoke
2
+
3
+ **Created:** {{date}}
4
+ **Size:** S
5
+
6
+ ## Review Level: 0 (None)
7
+
8
+ **Assessment:** Trivial parallel-safe smoke task to demonstrate orchestrator lanes.
9
+ **Score:** 0/8 — Blast radius: 0, Pattern novelty: 0, Security: 0, Reversibility: 0
10
+
11
+ ## Canonical Task Folder
12
+
13
+ ```
14
+ {{tasks_root}}/EXAMPLE-002-parallel-smoke/
15
+ ├── PROMPT.md ← This file (immutable above --- divider)
16
+ ├── STATUS.md ← Execution state (worker updates this)
17
+ ├── .reviews/ ← Reviewer output (task-runner creates this)
18
+ └── .DONE ← Created when complete
19
+ ```
20
+
21
+ ## Mission
22
+
23
+ Create a simple `hello-taskplane-2.md` file in the project root. This task is
24
+ intentionally independent from EXAMPLE-001 so both can run in parallel when
25
+ using `/orch`.
26
+
27
+ ## Expected File Content
28
+
29
+ `hello-taskplane-2.md` should include:
30
+
31
+ - A title line (for example: `# Parallel Hello from Taskplane`)
32
+ - A line containing the task ID: `EXAMPLE-002`
33
+ - A short note that this task is parallel-safe
34
+
35
+ ## Dependencies
36
+
37
+ - **None**
38
+
39
+ ## Context to Read First
40
+
41
+ _No additional context needed._
42
+
43
+ ## Environment
44
+
45
+ - **Workspace:** Project root
46
+ - **Services required:** None
47
+
48
+ ## File Scope
49
+
50
+ - `hello-taskplane-2.md`
51
+
52
+ ## Steps
53
+
54
+ ### Step 0: Preflight
55
+
56
+ - [ ] Verify this PROMPT.md is readable
57
+ - [ ] Verify STATUS.md exists in the same folder
58
+
59
+ ### Step 1: Create Parallel Hello File
60
+
61
+ - [ ] Create `hello-taskplane-2.md` in the project root
62
+ - [ ] Add title plus lines containing task ID `EXAMPLE-002` and a parallel-safe note
63
+
64
+ ### Step 2: Verification
65
+
66
+ - [ ] Verify `hello-taskplane-2.md` exists and matches the expected content
67
+
68
+ ### Step 3: Delivery
69
+
70
+
71
+
72
+ ## Documentation Requirements
73
+
74
+ **Must Update:** None
75
+ **Check If Affected:** None
76
+
77
+ ## Completion Criteria
78
+
79
+ - [ ] `hello-taskplane-2.md` exists in the project root
80
+ - [ ] `hello-taskplane-2.md` includes a title, task ID (`EXAMPLE-002`), and a parallel-safe note
81
+
82
+ ## Git Commit Convention
83
+
84
+ - **Implementation:** `feat(EXAMPLE-002): description`
85
+ - **Checkpoints:** `checkpoint: EXAMPLE-002 description`
86
+
87
+ ## Do NOT
88
+
89
+ - Modify any existing project files
90
+ - Create files outside the project root
91
+ - Add dependencies between EXAMPLE-001 and EXAMPLE-002
92
+
93
+ ---
94
+
95
+ ## Amendments (Added During Execution)
96
+
97
+ <!-- Workers add amendments here if issues discovered during execution. -->
@@ -0,0 +1,73 @@
1
+ # EXAMPLE-002: Parallel Smoke — Status
2
+
3
+ **Current Step:** Not Started
4
+ **Status:** 🔵 Ready for Execution
5
+ **Last Updated:** {{date}}
6
+ **Review Level:** 0
7
+ **Review Counter:** 0
8
+ **Iteration:** 0
9
+ **Size:** S
10
+
11
+ ---
12
+
13
+ ### Step 0: Preflight
14
+ **Status:** ⬜ Not Started
15
+
16
+ - [ ] Verify PROMPT.md is readable
17
+ - [ ] Verify STATUS.md exists
18
+
19
+ ---
20
+
21
+ ### Step 1: Create Parallel Hello File
22
+ **Status:** ⬜ Not Started
23
+
24
+ - [ ] Create `hello-taskplane-2.md` in project root
25
+ - [ ] Add title, task ID (EXAMPLE-002), and parallel-safe note
26
+
27
+ ---
28
+
29
+ ### Step 2: Verification
30
+ **Status:** ⬜ Not Started
31
+
32
+ - [ ] Verify file exists and matches expected content
33
+
34
+ ---
35
+
36
+ ### Step 3: Delivery
37
+ **Status:** ⬜ Not Started
38
+
39
+
40
+
41
+ ---
42
+
43
+ ## Reviews
44
+
45
+ | # | Type | Step | Verdict | File |
46
+ |---|------|------|---------|------|
47
+
48
+ ---
49
+
50
+ ## Discoveries
51
+
52
+ | Discovery | Disposition | Location |
53
+ |-----------|-------------|----------|
54
+
55
+ ---
56
+
57
+ ## Execution Log
58
+
59
+ | Timestamp | Action | Outcome |
60
+ |-----------|--------|---------|
61
+ | {{date}} | Task staged | PROMPT.md and STATUS.md created |
62
+
63
+ ---
64
+
65
+ ## Blockers
66
+
67
+ *None*
68
+
69
+ ---
70
+
71
+ ## Notes
72
+
73
+ *This is an example task created by `taskplane init` to demonstrate orchestrator-first onboarding.*