xtrm-tools 0.5.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 (333) hide show
  1. package/CHANGELOG.md +504 -0
  2. package/README.md +201 -0
  3. package/cli/dist/index.cjs +57378 -0
  4. package/cli/dist/index.cjs.map +1 -0
  5. package/cli/dist/index.d.cts +2 -0
  6. package/cli/package.json +47 -0
  7. package/config/.env.example +40 -0
  8. package/config/hooks.json +72 -0
  9. package/config/instructions/agents-top.md +30 -0
  10. package/config/instructions/claude-top.md +30 -0
  11. package/config/mcp_servers.json +57 -0
  12. package/config/mcp_servers_optional.json +53 -0
  13. package/config/pi/auth.json.template +14 -0
  14. package/config/pi/extensions/auto-session-name/index.ts +29 -0
  15. package/config/pi/extensions/auto-session-name/package.json +16 -0
  16. package/config/pi/extensions/auto-update/index.ts +71 -0
  17. package/config/pi/extensions/auto-update/package.json +16 -0
  18. package/config/pi/extensions/beads/index.ts +166 -0
  19. package/config/pi/extensions/beads/package.json +16 -0
  20. package/config/pi/extensions/bg-process/index.ts +230 -0
  21. package/config/pi/extensions/bg-process/package.json +16 -0
  22. package/config/pi/extensions/compact-header/index.ts +69 -0
  23. package/config/pi/extensions/compact-header/package.json +16 -0
  24. package/config/pi/extensions/core/adapter.ts +52 -0
  25. package/config/pi/extensions/core/guard-rules.ts +102 -0
  26. package/config/pi/extensions/core/lib.ts +3 -0
  27. package/config/pi/extensions/core/logger.ts +45 -0
  28. package/config/pi/extensions/core/runner.ts +71 -0
  29. package/config/pi/extensions/core/session-state.ts +59 -0
  30. package/config/pi/extensions/custom-footer/index.ts +160 -0
  31. package/config/pi/extensions/custom-footer/package.json +16 -0
  32. package/config/pi/extensions/custom-provider-qwen-cli/index.ts +363 -0
  33. package/config/pi/extensions/custom-provider-qwen-cli/package.json +1 -0
  34. package/config/pi/extensions/git-checkpoint/index.ts +53 -0
  35. package/config/pi/extensions/git-checkpoint/package.json +16 -0
  36. package/config/pi/extensions/minimal-mode/index.ts +201 -0
  37. package/config/pi/extensions/minimal-mode/package.json +16 -0
  38. package/config/pi/extensions/plan-mode/README.md +65 -0
  39. package/config/pi/extensions/plan-mode/index.ts +417 -0
  40. package/config/pi/extensions/plan-mode/package.json +12 -0
  41. package/config/pi/extensions/plan-mode/utils.ts +324 -0
  42. package/config/pi/extensions/quality-gates/index.ts +67 -0
  43. package/config/pi/extensions/quality-gates/package.json +16 -0
  44. package/config/pi/extensions/service-skills/index.ts +108 -0
  45. package/config/pi/extensions/service-skills/package.json +16 -0
  46. package/config/pi/extensions/session-flow/index.ts +131 -0
  47. package/config/pi/extensions/session-flow/package.json +16 -0
  48. package/config/pi/extensions/todo/index.ts +299 -0
  49. package/config/pi/extensions/todo/package.json +16 -0
  50. package/config/pi/extensions/xtrm-loader/index.ts +89 -0
  51. package/config/pi/extensions/xtrm-loader/package.json +16 -0
  52. package/config/pi/install-schema.json +44 -0
  53. package/config/pi/models.json.template +76 -0
  54. package/config/pi/pi-worktrees-settings.json +6 -0
  55. package/config/pi/settings.json.template +16 -0
  56. package/config/settings.json +70 -0
  57. package/hooks/README.md +75 -0
  58. package/hooks/agent_context.py +105 -0
  59. package/hooks/beads-claim-sync.mjs +166 -0
  60. package/hooks/beads-commit-gate.mjs +55 -0
  61. package/hooks/beads-compact-restore.mjs +69 -0
  62. package/hooks/beads-compact-save.mjs +51 -0
  63. package/hooks/beads-edit-gate.mjs +45 -0
  64. package/hooks/beads-gate-core.mjs +215 -0
  65. package/hooks/beads-gate-messages.mjs +87 -0
  66. package/hooks/beads-gate-utils.mjs +185 -0
  67. package/hooks/beads-memory-gate.mjs +61 -0
  68. package/hooks/beads-stop-gate.mjs +32 -0
  69. package/hooks/branch-state.mjs +39 -0
  70. package/hooks/gitnexus/gitnexus-hook.cjs +222 -0
  71. package/hooks/guard-rules.mjs +118 -0
  72. package/hooks/hooks.json +116 -0
  73. package/hooks/main-guard-post-push.mjs +71 -0
  74. package/hooks/main-guard.mjs +119 -0
  75. package/hooks/quality-check.cjs +1286 -0
  76. package/hooks/quality-check.py +345 -0
  77. package/hooks/serena-workflow-reminder.py +74 -0
  78. package/package.json +77 -0
  79. package/project-skills/quality-gates/.claude/hooks/hook-config.json +66 -0
  80. package/project-skills/quality-gates/.claude/hooks/quality-check.cjs +1286 -0
  81. package/project-skills/quality-gates/.claude/hooks/quality-check.py +334 -0
  82. package/project-skills/quality-gates/.claude/settings.json +3 -0
  83. package/project-skills/quality-gates/.claude/skills/using-quality-gates/SKILL.md +254 -0
  84. package/project-skills/quality-gates/README.md +109 -0
  85. package/project-skills/quality-gates/evals/evals.json +181 -0
  86. package/project-skills/quality-gates/workspace/iteration-1/FINAL-EVAL-SUMMARY.md +75 -0
  87. package/project-skills/quality-gates/workspace/iteration-1/edge-case-auto-fix-verification/with_skill/outputs/response.md +59 -0
  88. package/project-skills/quality-gates/workspace/iteration-1/edge-case-mixed-language-project/with_skill/outputs/response.md +60 -0
  89. package/project-skills/quality-gates/workspace/iteration-1/eval-summary.md +105 -0
  90. package/project-skills/quality-gates/workspace/iteration-1/partial-install-python-only/with_skill/outputs/response.md +93 -0
  91. package/project-skills/quality-gates/workspace/iteration-1/python-refactor-request/with_skill/outputs/response.md +104 -0
  92. package/project-skills/quality-gates/workspace/iteration-1/quality-gate-error-fix/with_skill/outputs/response.md +74 -0
  93. package/project-skills/quality-gates/workspace/iteration-1/should-not-trigger-general-chat/with_skill/outputs/response.md +18 -0
  94. package/project-skills/quality-gates/workspace/iteration-1/should-not-trigger-math-question/with_skill/outputs/response.md +18 -0
  95. package/project-skills/quality-gates/workspace/iteration-1/should-not-trigger-unrelated-coding/with_skill/outputs/response.md +56 -0
  96. package/project-skills/quality-gates/workspace/iteration-1/tdd-guard-blocking-confusion/with_skill/outputs/response.md +67 -0
  97. package/project-skills/quality-gates/workspace/iteration-1/typescript-feature-with-tests/with_skill/outputs/response.md +97 -0
  98. package/project-skills/service-skills-set/.claude/git-hooks/doc_reminder.py +67 -0
  99. package/project-skills/service-skills-set/.claude/git-hooks/skill_staleness.py +194 -0
  100. package/project-skills/service-skills-set/.claude/service-registry.json +4 -0
  101. package/project-skills/service-skills-set/.claude/settings.json +37 -0
  102. package/project-skills/service-skills-set/.claude/skills/creating-service-skills/SKILL.md +433 -0
  103. package/project-skills/service-skills-set/.claude/skills/creating-service-skills/references/script_quality_standards.md +425 -0
  104. package/project-skills/service-skills-set/.claude/skills/creating-service-skills/references/service_skill_system_guide.md +278 -0
  105. package/project-skills/service-skills-set/.claude/skills/creating-service-skills/scripts/bootstrap.py +308 -0
  106. package/project-skills/service-skills-set/.claude/skills/creating-service-skills/scripts/deep_dive.py +304 -0
  107. package/project-skills/service-skills-set/.claude/skills/creating-service-skills/scripts/scaffolder.py +482 -0
  108. package/project-skills/service-skills-set/.claude/skills/scoping-service-skills/SKILL.md +231 -0
  109. package/project-skills/service-skills-set/.claude/skills/scoping-service-skills/scripts/scope.py +74 -0
  110. package/project-skills/service-skills-set/.claude/skills/updating-service-skills/SKILL.md +136 -0
  111. package/project-skills/service-skills-set/.claude/skills/updating-service-skills/scripts/drift_detector.py +222 -0
  112. package/project-skills/service-skills-set/.claude/skills/using-service-skills/SKILL.md +108 -0
  113. package/project-skills/service-skills-set/.claude/skills/using-service-skills/scripts/cataloger.py +74 -0
  114. package/project-skills/service-skills-set/.claude/skills/using-service-skills/scripts/skill_activator.py +152 -0
  115. package/project-skills/service-skills-set/README.md +93 -0
  116. package/project-skills/service-skills-set/install-service-skills.py +193 -0
  117. package/project-skills/service-skills-set/service-skills-readme.md +236 -0
  118. package/skills/README.txt +31 -0
  119. package/skills/clean-code/SKILL.md +201 -0
  120. package/skills/creating-service-skills/SKILL.md +433 -0
  121. package/skills/creating-service-skills/references/script_quality_standards.md +425 -0
  122. package/skills/creating-service-skills/references/service_skill_system_guide.md +278 -0
  123. package/skills/creating-service-skills/scripts/bootstrap.py +326 -0
  124. package/skills/creating-service-skills/scripts/deep_dive.py +304 -0
  125. package/skills/creating-service-skills/scripts/scaffolder.py +482 -0
  126. package/skills/delegating/SKILL.md +196 -0
  127. package/skills/delegating/config.yaml +210 -0
  128. package/skills/delegating/references/orchestration-protocols.md +41 -0
  129. package/skills/docker-expert/SKILL.md +409 -0
  130. package/skills/documenting/CHANGELOG.md +23 -0
  131. package/skills/documenting/README.md +148 -0
  132. package/skills/documenting/SKILL.md +113 -0
  133. package/skills/documenting/examples/example_pattern.md +70 -0
  134. package/skills/documenting/examples/example_reference.md +70 -0
  135. package/skills/documenting/examples/example_ssot_analytics.md +64 -0
  136. package/skills/documenting/examples/example_workflow.md +141 -0
  137. package/skills/documenting/references/changelog-format.md +97 -0
  138. package/skills/documenting/references/metadata-schema.md +136 -0
  139. package/skills/documenting/references/taxonomy.md +81 -0
  140. package/skills/documenting/references/versioning-rules.md +78 -0
  141. package/skills/documenting/scripts/bump_version.sh +60 -0
  142. package/skills/documenting/scripts/changelog/__init__.py +0 -0
  143. package/skills/documenting/scripts/changelog/add_entry.py +216 -0
  144. package/skills/documenting/scripts/changelog/bump_release.py +117 -0
  145. package/skills/documenting/scripts/changelog/init_changelog.py +54 -0
  146. package/skills/documenting/scripts/changelog/validate_changelog.py +128 -0
  147. package/skills/documenting/scripts/drift_detector.py +266 -0
  148. package/skills/documenting/scripts/generate_template.py +311 -0
  149. package/skills/documenting/scripts/list_by_category.sh +84 -0
  150. package/skills/documenting/scripts/orchestrator.py +255 -0
  151. package/skills/documenting/scripts/validate_metadata.py +242 -0
  152. package/skills/documenting/templates/CHANGELOG.md.template +13 -0
  153. package/skills/find-skills/SKILL.md +133 -0
  154. package/skills/gitnexus-debugging/SKILL.md +85 -0
  155. package/skills/gitnexus-exploring/SKILL.md +75 -0
  156. package/skills/gitnexus-impact-analysis/SKILL.md +94 -0
  157. package/skills/gitnexus-refactoring/SKILL.md +113 -0
  158. package/skills/hook-development/SKILL.md +797 -0
  159. package/skills/hook-development/examples/load-context.sh +55 -0
  160. package/skills/hook-development/examples/quality-check.js +1168 -0
  161. package/skills/hook-development/examples/validate-bash.sh +43 -0
  162. package/skills/hook-development/examples/validate-write.sh +38 -0
  163. package/skills/hook-development/references/advanced.md +527 -0
  164. package/skills/hook-development/references/migration.md +369 -0
  165. package/skills/hook-development/references/patterns.md +412 -0
  166. package/skills/hook-development/scripts/README.md +164 -0
  167. package/skills/hook-development/scripts/hook-linter.sh +153 -0
  168. package/skills/hook-development/scripts/test-hook.sh +252 -0
  169. package/skills/hook-development/scripts/validate-hook-schema.sh +159 -0
  170. package/skills/obsidian-cli/SKILL.md +106 -0
  171. package/skills/orchestrating-agents/SKILL.md +135 -0
  172. package/skills/orchestrating-agents/config.yaml +45 -0
  173. package/skills/orchestrating-agents/references/agent-context-integration.md +37 -0
  174. package/skills/orchestrating-agents/references/examples.md +45 -0
  175. package/skills/orchestrating-agents/references/handover-protocol.md +31 -0
  176. package/skills/orchestrating-agents/references/workflows.md +42 -0
  177. package/skills/orchestrating-agents/scripts/detect_neighbors.py +23 -0
  178. package/skills/prompt-improving/README.md +162 -0
  179. package/skills/prompt-improving/SKILL.md +74 -0
  180. package/skills/prompt-improving/references/analysis_commands.md +24 -0
  181. package/skills/prompt-improving/references/chain_of_thought.md +24 -0
  182. package/skills/prompt-improving/references/mcp_definitions.md +20 -0
  183. package/skills/prompt-improving/references/multishot.md +23 -0
  184. package/skills/prompt-improving/references/xml_core.md +60 -0
  185. package/skills/python-testing/SKILL.md +815 -0
  186. package/skills/scoping-service-skills/SKILL.md +231 -0
  187. package/skills/scoping-service-skills/scripts/scope.py +74 -0
  188. package/skills/senior-backend/SKILL.md +209 -0
  189. package/skills/senior-backend/references/api_design_patterns.md +103 -0
  190. package/skills/senior-backend/references/backend_security_practices.md +103 -0
  191. package/skills/senior-backend/references/database_optimization_guide.md +103 -0
  192. package/skills/senior-backend/scripts/api_load_tester.py +114 -0
  193. package/skills/senior-backend/scripts/api_scaffolder.py +114 -0
  194. package/skills/senior-backend/scripts/database_migration_tool.py +114 -0
  195. package/skills/senior-data-scientist/SKILL.md +226 -0
  196. package/skills/senior-data-scientist/references/experiment_design_frameworks.md +80 -0
  197. package/skills/senior-data-scientist/references/feature_engineering_patterns.md +80 -0
  198. package/skills/senior-data-scientist/references/statistical_methods_advanced.md +80 -0
  199. package/skills/senior-data-scientist/scripts/experiment_designer.py +100 -0
  200. package/skills/senior-data-scientist/scripts/feature_engineering_pipeline.py +100 -0
  201. package/skills/senior-data-scientist/scripts/model_evaluation_suite.py +100 -0
  202. package/skills/senior-devops/SKILL.md +209 -0
  203. package/skills/senior-devops/references/cicd_pipeline_guide.md +103 -0
  204. package/skills/senior-devops/references/deployment_strategies.md +103 -0
  205. package/skills/senior-devops/references/infrastructure_as_code.md +103 -0
  206. package/skills/senior-devops/scripts/deployment_manager.py +114 -0
  207. package/skills/senior-devops/scripts/pipeline_generator.py +114 -0
  208. package/skills/senior-devops/scripts/terraform_scaffolder.py +114 -0
  209. package/skills/senior-security/SKILL.md +209 -0
  210. package/skills/senior-security/references/cryptography_implementation.md +103 -0
  211. package/skills/senior-security/references/penetration_testing_guide.md +103 -0
  212. package/skills/senior-security/references/security_architecture_patterns.md +103 -0
  213. package/skills/senior-security/scripts/pentest_automator.py +114 -0
  214. package/skills/senior-security/scripts/security_auditor.py +114 -0
  215. package/skills/senior-security/scripts/threat_modeler.py +114 -0
  216. package/skills/skill-creator/LICENSE.txt +202 -0
  217. package/skills/skill-creator/SKILL.md +479 -0
  218. package/skills/skill-creator/agents/analyzer.md +274 -0
  219. package/skills/skill-creator/agents/comparator.md +202 -0
  220. package/skills/skill-creator/agents/grader.md +223 -0
  221. package/skills/skill-creator/assets/eval_review.html +146 -0
  222. package/skills/skill-creator/eval-viewer/generate_review.py +471 -0
  223. package/skills/skill-creator/eval-viewer/viewer.html +1325 -0
  224. package/skills/skill-creator/references/schemas.md +430 -0
  225. package/skills/skill-creator/scripts/__init__.py +0 -0
  226. package/skills/skill-creator/scripts/aggregate_benchmark.py +401 -0
  227. package/skills/skill-creator/scripts/generate_report.py +326 -0
  228. package/skills/skill-creator/scripts/improve_description.py +248 -0
  229. package/skills/skill-creator/scripts/package_skill.py +136 -0
  230. package/skills/skill-creator/scripts/quick_validate.py +103 -0
  231. package/skills/skill-creator/scripts/run_eval.py +310 -0
  232. package/skills/skill-creator/scripts/run_loop.py +332 -0
  233. package/skills/skill-creator/scripts/utils.py +47 -0
  234. package/skills/sync-docs/SKILL.md +132 -0
  235. package/skills/sync-docs/evals/evals.json +89 -0
  236. package/skills/sync-docs/references/doc-structure.md +99 -0
  237. package/skills/sync-docs/references/schema.md +103 -0
  238. package/skills/sync-docs/scripts/changelog/add_entry.py +216 -0
  239. package/skills/sync-docs/scripts/context_gatherer.py +240 -0
  240. package/skills/sync-docs/scripts/doc_structure_analyzer.py +495 -0
  241. package/skills/sync-docs/scripts/drift_detector.py +327 -0
  242. package/skills/sync-docs/scripts/validate_doc.py +365 -0
  243. package/skills/sync-docs/scripts/validate_metadata.py +185 -0
  244. package/skills/sync-docs-workspace/iteration-1/benchmark.json +293 -0
  245. package/skills/sync-docs-workspace/iteration-1/benchmark.md +13 -0
  246. package/skills/sync-docs-workspace/iteration-1/eval-doc-audit/eval_metadata.json +27 -0
  247. package/skills/sync-docs-workspace/iteration-1/eval-doc-audit/with_skill/outputs/result.md +210 -0
  248. package/skills/sync-docs-workspace/iteration-1/eval-doc-audit/with_skill/run-1/grading.json +28 -0
  249. package/skills/sync-docs-workspace/iteration-1/eval-doc-audit/with_skill/run-1/timing.json +1 -0
  250. package/skills/sync-docs-workspace/iteration-1/eval-doc-audit/without_skill/outputs/result.md +101 -0
  251. package/skills/sync-docs-workspace/iteration-1/eval-doc-audit/without_skill/run-1/grading.json +28 -0
  252. package/skills/sync-docs-workspace/iteration-1/eval-doc-audit/without_skill/run-1/timing.json +5 -0
  253. package/skills/sync-docs-workspace/iteration-1/eval-doc-audit/without_skill/timing.json +5 -0
  254. package/skills/sync-docs-workspace/iteration-1/eval-fix-mode/eval_metadata.json +27 -0
  255. package/skills/sync-docs-workspace/iteration-1/eval-fix-mode/with_skill/outputs/result.md +198 -0
  256. package/skills/sync-docs-workspace/iteration-1/eval-fix-mode/with_skill/run-1/grading.json +28 -0
  257. package/skills/sync-docs-workspace/iteration-1/eval-fix-mode/with_skill/run-1/timing.json +1 -0
  258. package/skills/sync-docs-workspace/iteration-1/eval-fix-mode/without_skill/outputs/result.md +94 -0
  259. package/skills/sync-docs-workspace/iteration-1/eval-fix-mode/without_skill/run-1/grading.json +28 -0
  260. package/skills/sync-docs-workspace/iteration-1/eval-fix-mode/without_skill/run-1/timing.json +1 -0
  261. package/skills/sync-docs-workspace/iteration-1/eval-sprint-closeout/eval_metadata.json +27 -0
  262. package/skills/sync-docs-workspace/iteration-1/eval-sprint-closeout/with_skill/outputs/result.md +237 -0
  263. package/skills/sync-docs-workspace/iteration-1/eval-sprint-closeout/with_skill/run-1/grading.json +28 -0
  264. package/skills/sync-docs-workspace/iteration-1/eval-sprint-closeout/with_skill/run-1/timing.json +1 -0
  265. package/skills/sync-docs-workspace/iteration-1/eval-sprint-closeout/without_skill/outputs/result.md +134 -0
  266. package/skills/sync-docs-workspace/iteration-1/eval-sprint-closeout/without_skill/run-1/grading.json +28 -0
  267. package/skills/sync-docs-workspace/iteration-1/eval-sprint-closeout/without_skill/run-1/timing.json +1 -0
  268. package/skills/sync-docs-workspace/iteration-2/benchmark.json +297 -0
  269. package/skills/sync-docs-workspace/iteration-2/benchmark.md +13 -0
  270. package/skills/sync-docs-workspace/iteration-2/eval-doc-audit/eval_metadata.json +27 -0
  271. package/skills/sync-docs-workspace/iteration-2/eval-doc-audit/with_skill/outputs/result.md +137 -0
  272. package/skills/sync-docs-workspace/iteration-2/eval-doc-audit/with_skill/run-1/grading.json +92 -0
  273. package/skills/sync-docs-workspace/iteration-2/eval-doc-audit/with_skill/run-1/timing.json +1 -0
  274. package/skills/sync-docs-workspace/iteration-2/eval-doc-audit/without_skill/outputs/result.md +134 -0
  275. package/skills/sync-docs-workspace/iteration-2/eval-doc-audit/without_skill/run-1/grading.json +86 -0
  276. package/skills/sync-docs-workspace/iteration-2/eval-doc-audit/without_skill/run-1/timing.json +1 -0
  277. package/skills/sync-docs-workspace/iteration-2/eval-fix-mode/eval_metadata.json +27 -0
  278. package/skills/sync-docs-workspace/iteration-2/eval-fix-mode/with_skill/outputs/result.md +193 -0
  279. package/skills/sync-docs-workspace/iteration-2/eval-fix-mode/with_skill/run-1/grading.json +72 -0
  280. package/skills/sync-docs-workspace/iteration-2/eval-fix-mode/with_skill/run-1/timing.json +1 -0
  281. package/skills/sync-docs-workspace/iteration-2/eval-fix-mode/without_skill/outputs/result.md +211 -0
  282. package/skills/sync-docs-workspace/iteration-2/eval-fix-mode/without_skill/run-1/grading.json +91 -0
  283. package/skills/sync-docs-workspace/iteration-2/eval-fix-mode/without_skill/run-1/timing.json +5 -0
  284. package/skills/sync-docs-workspace/iteration-2/eval-sprint-closeout/eval_metadata.json +27 -0
  285. package/skills/sync-docs-workspace/iteration-2/eval-sprint-closeout/with_skill/outputs/result.md +182 -0
  286. package/skills/sync-docs-workspace/iteration-2/eval-sprint-closeout/with_skill/run-1/grading.json +95 -0
  287. package/skills/sync-docs-workspace/iteration-2/eval-sprint-closeout/with_skill/run-1/timing.json +1 -0
  288. package/skills/sync-docs-workspace/iteration-2/eval-sprint-closeout/without_skill/outputs/result.md +222 -0
  289. package/skills/sync-docs-workspace/iteration-2/eval-sprint-closeout/without_skill/run-1/grading.json +88 -0
  290. package/skills/sync-docs-workspace/iteration-2/eval-sprint-closeout/without_skill/run-1/timing.json +5 -0
  291. package/skills/sync-docs-workspace/iteration-3/benchmark.json +298 -0
  292. package/skills/sync-docs-workspace/iteration-3/benchmark.md +13 -0
  293. package/skills/sync-docs-workspace/iteration-3/eval-doc-audit/eval_metadata.json +27 -0
  294. package/skills/sync-docs-workspace/iteration-3/eval-doc-audit/with_skill/outputs/result.md +125 -0
  295. package/skills/sync-docs-workspace/iteration-3/eval-doc-audit/with_skill/run-1/grading.json +97 -0
  296. package/skills/sync-docs-workspace/iteration-3/eval-doc-audit/with_skill/run-1/timing.json +5 -0
  297. package/skills/sync-docs-workspace/iteration-3/eval-doc-audit/without_skill/outputs/result.md +144 -0
  298. package/skills/sync-docs-workspace/iteration-3/eval-doc-audit/without_skill/run-1/grading.json +78 -0
  299. package/skills/sync-docs-workspace/iteration-3/eval-doc-audit/without_skill/run-1/timing.json +5 -0
  300. package/skills/sync-docs-workspace/iteration-3/eval-fix-mode/eval_metadata.json +27 -0
  301. package/skills/sync-docs-workspace/iteration-3/eval-fix-mode/with_skill/outputs/result.md +104 -0
  302. package/skills/sync-docs-workspace/iteration-3/eval-fix-mode/with_skill/run-1/grading.json +91 -0
  303. package/skills/sync-docs-workspace/iteration-3/eval-fix-mode/with_skill/run-1/timing.json +5 -0
  304. package/skills/sync-docs-workspace/iteration-3/eval-fix-mode/without_skill/outputs/result.md +79 -0
  305. package/skills/sync-docs-workspace/iteration-3/eval-fix-mode/without_skill/run-1/grading.json +82 -0
  306. package/skills/sync-docs-workspace/iteration-3/eval-fix-mode/without_skill/run-1/timing.json +5 -0
  307. package/skills/sync-docs-workspace/iteration-3/eval-sprint-closeout/eval_metadata.json +27 -0
  308. package/skills/sync-docs-workspace/iteration-3/eval-sprint-closeout/with_skill/outputs/phase1_context.json +302 -0
  309. package/skills/sync-docs-workspace/iteration-3/eval-sprint-closeout/with_skill/outputs/phase2_drift.txt +33 -0
  310. package/skills/sync-docs-workspace/iteration-3/eval-sprint-closeout/with_skill/outputs/phase3_analysis.json +114 -0
  311. package/skills/sync-docs-workspace/iteration-3/eval-sprint-closeout/with_skill/outputs/phase4_fix.txt +118 -0
  312. package/skills/sync-docs-workspace/iteration-3/eval-sprint-closeout/with_skill/outputs/phase5_validate.txt +38 -0
  313. package/skills/sync-docs-workspace/iteration-3/eval-sprint-closeout/with_skill/outputs/result.md +158 -0
  314. package/skills/sync-docs-workspace/iteration-3/eval-sprint-closeout/with_skill/run-1/grading.json +95 -0
  315. package/skills/sync-docs-workspace/iteration-3/eval-sprint-closeout/with_skill/run-1/timing.json +5 -0
  316. package/skills/sync-docs-workspace/iteration-3/eval-sprint-closeout/without_skill/outputs/result.md +71 -0
  317. package/skills/sync-docs-workspace/iteration-3/eval-sprint-closeout/without_skill/run-1/grading.json +90 -0
  318. package/skills/sync-docs-workspace/iteration-3/eval-sprint-closeout/without_skill/run-1/timing.json +5 -0
  319. package/skills/test-planning/SKILL.md +208 -0
  320. package/skills/test-planning/evals/evals.json +23 -0
  321. package/skills/updating-service-skills/SKILL.md +136 -0
  322. package/skills/updating-service-skills/scripts/drift_detector.py +222 -0
  323. package/skills/using-TDD/SKILL.md +410 -0
  324. package/skills/using-quality-gates/SKILL.md +254 -0
  325. package/skills/using-serena-lsp/README.md +8 -0
  326. package/skills/using-serena-lsp/REFERENCE.md +194 -0
  327. package/skills/using-serena-lsp/SKILL.md +82 -0
  328. package/skills/using-service-skills/SKILL.md +108 -0
  329. package/skills/using-service-skills/scripts/cataloger.py +74 -0
  330. package/skills/using-service-skills/scripts/skill_activator.py +152 -0
  331. package/skills/using-service-skills/scripts/test_skill_activator.py +58 -0
  332. package/skills/using-xtrm/SKILL.md +245 -0
  333. package/skills/xt-end/SKILL.md +128 -0
@@ -0,0 +1,201 @@
1
+ import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
2
+ import {
3
+ createBashTool,
4
+ createEditTool,
5
+ createFindTool,
6
+ createGrepTool,
7
+ createLsTool,
8
+ createReadTool,
9
+ createWriteTool,
10
+ } from "@mariozechner/pi-coding-agent";
11
+ import { Text } from "@mariozechner/pi-tui";
12
+
13
+ function getTextContent(result: any): string {
14
+ if (!result?.content || !Array.isArray(result.content)) return "";
15
+ return result.content
16
+ .filter((c: any) => c?.type === "text" && typeof c.text === "string")
17
+ .map((c: any) => c.text)
18
+ .join("\n")
19
+ .trim();
20
+ }
21
+
22
+ function oneLine(s: string): string {
23
+ return (s || "").replace(/\s+/g, " ").trim();
24
+ }
25
+
26
+ function summarize(result: any): { text: string; isError: boolean } {
27
+ const raw = getTextContent(result);
28
+ if (!raw) return { text: "done", isError: false };
29
+ const line = oneLine(raw.split("\n").find((l) => l.trim()) || "");
30
+ const lower = line.toLowerCase();
31
+ const isError = lower.includes("error") || lower.includes("failed") || lower.includes("exception");
32
+ return { text: line.slice(0, 140) || "done", isError };
33
+ }
34
+
35
+ const toolCache = new Map<string, ReturnType<typeof createBuiltInTools>>();
36
+ function createBuiltInTools(cwd: string) {
37
+ return {
38
+ read: createReadTool(cwd),
39
+ bash: createBashTool(cwd),
40
+ edit: createEditTool(cwd),
41
+ write: createWriteTool(cwd),
42
+ find: createFindTool(cwd),
43
+ grep: createGrepTool(cwd),
44
+ ls: createLsTool(cwd),
45
+ };
46
+ }
47
+ function getBuiltInTools(cwd: string) {
48
+ let tools = toolCache.get(cwd);
49
+ if (!tools) {
50
+ tools = createBuiltInTools(cwd);
51
+ toolCache.set(cwd, tools);
52
+ }
53
+ return tools;
54
+ }
55
+
56
+ export default function (pi: ExtensionAPI) {
57
+ let minimalEnabled = true;
58
+ let thinkingStatusEnabled = true;
59
+ let spinnerTimer: NodeJS.Timeout | null = null;
60
+ let spinnerIndex = 0;
61
+ const frames = ["thinking ", "thinking. ", "thinking.. ", "thinking..."];
62
+
63
+ const clearSpinner = (ctx: any) => {
64
+ if (spinnerTimer) {
65
+ clearInterval(spinnerTimer);
66
+ spinnerTimer = null;
67
+ }
68
+ if (ctx?.hasUI) {
69
+ ctx.ui.setStatus("thinking", undefined);
70
+ ctx.ui.setHeader(undefined);
71
+ }
72
+ };
73
+
74
+ const mountThinkingHeader = (ctx: any) => {
75
+ if (!ctx?.hasUI) return;
76
+ ctx.ui.setHeader((_tui: any, theme: any) => ({
77
+ invalidate() {},
78
+ render(width: number): string[] {
79
+ const text = frames[spinnerIndex];
80
+ return [oneLine(theme.fg("accent", text)).slice(0, width)];
81
+ },
82
+ }));
83
+ };
84
+
85
+ const startSpinner = (ctx: any) => {
86
+ if (!thinkingStatusEnabled || !ctx?.hasUI) return;
87
+ clearSpinner(ctx);
88
+ spinnerIndex = 0;
89
+ ctx.ui.setStatus("thinking", frames[spinnerIndex]);
90
+ mountThinkingHeader(ctx);
91
+ spinnerTimer = setInterval(() => {
92
+ spinnerIndex = (spinnerIndex + 1) % frames.length;
93
+ ctx.ui.setStatus("thinking", frames[spinnerIndex]);
94
+ mountThinkingHeader(ctx);
95
+ }, 220);
96
+ };
97
+
98
+ const renderCollapsedResult = (result: any, theme: any) => {
99
+ const s = summarize(result);
100
+ const icon = s.isError ? theme.fg("error", "✗") : theme.fg("success", "✓");
101
+ const text = s.isError ? theme.fg("error", s.text) : theme.fg("muted", s.text);
102
+ if (minimalEnabled) return new Text(` ${icon} ${text}`, 0, 0);
103
+ return new Text(theme.fg("muted", ` → ${s.text}`), 0, 0);
104
+ };
105
+
106
+ const renderExpandedResult = (result: any, theme: any) => {
107
+ const text = getTextContent(result);
108
+ if (!text) return new Text("", 0, 0);
109
+ const output = text.split("\n").map((line) => theme.fg("toolOutput", line)).join("\n");
110
+ return new Text(`\n${output}`, 0, 0);
111
+ };
112
+
113
+ pi.registerTool({
114
+ name: "bash",
115
+ label: "bash",
116
+ description: getBuiltInTools(process.cwd()).bash.description,
117
+ parameters: getBuiltInTools(process.cwd()).bash.parameters,
118
+ async execute(toolCallId, params, signal, onUpdate, ctx) {
119
+ return getBuiltInTools(ctx.cwd).bash.execute(toolCallId, params, signal, onUpdate);
120
+ },
121
+ renderCall(args, theme) {
122
+ const cmd = oneLine(args.command || "");
123
+ return new Text(`${theme.fg("toolTitle", theme.bold("bash"))}(${theme.fg("accent", cmd || "...")})`, 0, 0);
124
+ },
125
+ renderResult(result, { expanded }, theme) {
126
+ return expanded ? renderExpandedResult(result, theme) : renderCollapsedResult(result, theme);
127
+ },
128
+ });
129
+
130
+ for (const name of ["read", "write", "edit", "find", "grep", "ls"] as const) {
131
+ pi.registerTool({
132
+ name,
133
+ label: name,
134
+ description: (getBuiltInTools(process.cwd()) as any)[name].description,
135
+ parameters: (getBuiltInTools(process.cwd()) as any)[name].parameters,
136
+ async execute(toolCallId, params, signal, onUpdate, ctx) {
137
+ return (getBuiltInTools(ctx.cwd) as any)[name].execute(toolCallId, params, signal, onUpdate);
138
+ },
139
+ renderCall(args, theme) {
140
+ const suffix = oneLine(args.path || args.pattern || "");
141
+ return new Text(`${theme.fg("toolTitle", theme.bold(name))}${suffix ? `(${theme.fg("accent", suffix)})` : ""}`, 0, 0);
142
+ },
143
+ renderResult(result, { expanded }, theme) {
144
+ return expanded ? renderExpandedResult(result, theme) : renderCollapsedResult(result, theme);
145
+ },
146
+ });
147
+ }
148
+
149
+ pi.registerCommand("minimal-on", {
150
+ description: "Enable minimal collapsed tool output",
151
+ handler: async (_args, ctx) => {
152
+ minimalEnabled = true;
153
+ ctx.ui.notify("Minimal mode enabled", "info");
154
+ },
155
+ });
156
+
157
+ pi.registerCommand("minimal-off", {
158
+ description: "Disable minimal collapsed tool output",
159
+ handler: async (_args, ctx) => {
160
+ minimalEnabled = false;
161
+ ctx.ui.notify("Minimal mode disabled", "info");
162
+ },
163
+ });
164
+
165
+ pi.registerCommand("minimal-toggle", {
166
+ description: "Toggle minimal collapsed tool output",
167
+ handler: async (_args, ctx) => {
168
+ minimalEnabled = !minimalEnabled;
169
+ ctx.ui.notify(`Minimal mode ${minimalEnabled ? "enabled" : "disabled"}`, "info");
170
+ },
171
+ });
172
+
173
+ pi.registerCommand("thinking-status-toggle", {
174
+ description: "Toggle flashing thinking status indicator",
175
+ handler: async (_args, ctx) => {
176
+ thinkingStatusEnabled = !thinkingStatusEnabled;
177
+ if (!thinkingStatusEnabled) clearSpinner(ctx);
178
+ ctx.ui.notify(`Thinking status ${thinkingStatusEnabled ? "enabled" : "disabled"}`, "info");
179
+ },
180
+ });
181
+
182
+ pi.on("turn_start", async (_event, ctx) => {
183
+ startSpinner(ctx);
184
+ return undefined;
185
+ });
186
+
187
+ pi.on("turn_end", async (_event, ctx) => {
188
+ clearSpinner(ctx);
189
+ return undefined;
190
+ });
191
+
192
+ pi.on("agent_end", async (_event, ctx) => {
193
+ clearSpinner(ctx);
194
+ return undefined;
195
+ });
196
+
197
+ pi.on("session_shutdown", async (_event, ctx) => {
198
+ clearSpinner(ctx);
199
+ return undefined;
200
+ });
201
+ }
@@ -0,0 +1,16 @@
1
+ {
2
+ "name": "@xtrm/pi-minimal-mode",
3
+ "version": "1.0.0",
4
+ "description": "xtrm Pi extension: minimal-mode",
5
+ "type": "module",
6
+ "exports": {
7
+ ".": "./index.ts"
8
+ },
9
+ "keywords": [
10
+ "pi",
11
+ "extension",
12
+ "xtrm"
13
+ ],
14
+ "author": "xtrm",
15
+ "license": "MIT"
16
+ }
@@ -0,0 +1,65 @@
1
+ # Plan Mode Extension
2
+
3
+ Read-only exploration mode for safe code analysis.
4
+
5
+ ## Features
6
+
7
+ - **Read-only tools**: Restricts available tools to read, bash, grep, find, ls, question
8
+ - **Bash allowlist**: Only read-only bash commands are allowed
9
+ - **Plan extraction**: Extracts numbered steps from `Plan:` sections
10
+ - **Progress tracking**: Widget shows completion status during execution
11
+ - **[DONE:n] markers**: Explicit step completion tracking
12
+ - **Session persistence**: State survives session resume
13
+
14
+ ## Commands
15
+
16
+ - `/plan` - Toggle plan mode
17
+ - `/todos` - Show current plan progress
18
+ - `Ctrl+Alt+P` - Toggle plan mode (shortcut)
19
+
20
+ ## Usage
21
+
22
+ 1. Enable plan mode with `/plan` or `--plan` flag
23
+ 2. Ask the agent to analyze code and create a plan
24
+ 3. The agent should output a numbered plan under a `Plan:` header:
25
+
26
+ ```
27
+ Plan:
28
+ 1. First step description
29
+ 2. Second step description
30
+ 3. Third step description
31
+ ```
32
+
33
+ 4. Choose "Execute the plan" when prompted
34
+ 5. During execution, the agent marks steps complete with `[DONE:n]` tags
35
+ 6. Progress widget shows completion status
36
+
37
+ ## How It Works
38
+
39
+ ### Plan Mode (Read-Only)
40
+ - Only read-only tools available
41
+ - Bash commands filtered through allowlist
42
+ - Agent creates a plan without making changes
43
+
44
+ ### Execution Mode
45
+ - Full tool access restored
46
+ - Agent executes steps in order
47
+ - `[DONE:n]` markers track completion
48
+ - Widget shows progress
49
+
50
+ ### Command Allowlist
51
+
52
+ Safe commands (allowed):
53
+ - File inspection: `cat`, `head`, `tail`, `less`, `more`
54
+ - Search: `grep`, `find`, `rg`, `fd`
55
+ - Directory: `ls`, `pwd`, `tree`
56
+ - Git read: `git status`, `git log`, `git diff`, `git branch`
57
+ - Package info: `npm list`, `npm outdated`, `yarn info`
58
+ - System info: `uname`, `whoami`, `date`, `uptime`
59
+
60
+ Blocked commands:
61
+ - File modification: `rm`, `mv`, `cp`, `mkdir`, `touch`
62
+ - Git write: `git add`, `git commit`, `git push`
63
+ - Package install: `npm install`, `yarn add`, `pip install`
64
+ - System: `sudo`, `kill`, `reboot`
65
+ - Editors: `vim`, `nano`, `code`
@@ -0,0 +1,417 @@
1
+ /**
2
+ * Plan Mode Extension
3
+ *
4
+ * Read-only exploration mode for safe code analysis.
5
+ * When enabled, only read-only tools are available.
6
+ *
7
+ * Features:
8
+ * - /plan command or Ctrl+Alt+P to toggle
9
+ * - Bash restricted to allowlisted read-only commands
10
+ * - Extracts numbered plan steps from "Plan:" sections
11
+ * - [DONE:n] markers to complete steps during execution
12
+ * - Progress tracking widget during execution
13
+ */
14
+
15
+ import type { AgentMessage } from "@mariozechner/pi-agent-core";
16
+ import type { AssistantMessage, TextContent } from "@mariozechner/pi-ai";
17
+ import type { ExtensionAPI, ExtensionContext } from "@mariozechner/pi-coding-agent";
18
+ import { Key } from "@mariozechner/pi-tui";
19
+ import {
20
+ extractTodoItems,
21
+ isSafeCommand,
22
+ markCompletedSteps,
23
+ type TodoItem,
24
+ getShortId,
25
+ isBeadsProject,
26
+ deriveEpicTitle,
27
+ createPlanIssues,
28
+ bdClaim,
29
+ } from "./utils.js";
30
+
31
+ // Tools
32
+ const PLAN_MODE_TOOLS = ["read", "bash", "grep", "find", "ls", "questionnaire"];
33
+ const NORMAL_MODE_TOOLS = ["read", "bash", "edit", "write"];
34
+
35
+ // Type guard for assistant messages
36
+ function isAssistantMessage(m: AgentMessage): m is AssistantMessage {
37
+ return m.role === "assistant" && Array.isArray(m.content);
38
+ }
39
+
40
+ // Extract text content from an assistant message
41
+ function getTextContent(message: AssistantMessage): string {
42
+ return message.content
43
+ .filter((block): block is TextContent => block.type === "text")
44
+ .map((block) => block.text)
45
+ .join("\n");
46
+ }
47
+
48
+ export default function planModeExtension(pi: ExtensionAPI): void {
49
+ let planModeEnabled = false;
50
+ let executionMode = false;
51
+ let todoItems: TodoItem[] = [];
52
+ let epicId: string | null = null;
53
+ let issueIds: Map<number, string> = new Map(); // step -> issue ID
54
+
55
+ pi.registerFlag("plan", {
56
+ description: "Start in plan mode (read-only exploration)",
57
+ type: "boolean",
58
+ default: false,
59
+ });
60
+
61
+ function updateStatus(ctx: ExtensionContext): void {
62
+ // Footer status
63
+ if (executionMode && todoItems.length > 0) {
64
+ const completed = todoItems.filter((t) => t.completed).length;
65
+ ctx.ui.setStatus("plan-mode", ctx.ui.theme.fg("accent", `📋 ${completed}/${todoItems.length}`));
66
+ } else if (planModeEnabled) {
67
+ ctx.ui.setStatus("plan-mode", ctx.ui.theme.fg("warning", "⏸ plan"));
68
+ } else {
69
+ ctx.ui.setStatus("plan-mode", undefined);
70
+ }
71
+
72
+ // Widget showing todo list with bd issue IDs
73
+ if (executionMode && todoItems.length > 0) {
74
+ const lines = todoItems.map((item) => {
75
+ const issueId = issueIds.get(item.step);
76
+ const idLabel = issueId ? `[${getShortId(issueId)}] ` : "";
77
+ if (item.completed) {
78
+ return (
79
+ ctx.ui.theme.fg("success", "☑ ") + ctx.ui.theme.fg("muted", ctx.ui.theme.strikethrough(`${idLabel}${item.text}`))
80
+ );
81
+ }
82
+ return `${ctx.ui.theme.fg("muted", "☐ ")}${idLabel}${item.text}`;
83
+ });
84
+ ctx.ui.setWidget("plan-todos", lines);
85
+ } else {
86
+ ctx.ui.setWidget("plan-todos", undefined);
87
+ }
88
+ }
89
+
90
+ function togglePlanMode(ctx: ExtensionContext): void {
91
+ planModeEnabled = !planModeEnabled;
92
+ executionMode = false;
93
+ todoItems = [];
94
+ epicId = null;
95
+ issueIds.clear();
96
+
97
+ if (planModeEnabled) {
98
+ pi.setActiveTools(PLAN_MODE_TOOLS);
99
+ ctx.ui.notify(`Plan mode enabled. Tools: ${PLAN_MODE_TOOLS.join(", ")}`);
100
+ } else {
101
+ pi.setActiveTools(NORMAL_MODE_TOOLS);
102
+ ctx.ui.notify("Plan mode disabled. Full access restored.");
103
+ }
104
+ updateStatus(ctx);
105
+ }
106
+
107
+ function persistState(): void {
108
+ pi.appendEntry("plan-mode", {
109
+ enabled: planModeEnabled,
110
+ todos: todoItems,
111
+ executing: executionMode,
112
+ epicId,
113
+ issueIds: Object.fromEntries(issueIds),
114
+ });
115
+ }
116
+
117
+ pi.registerCommand("plan", {
118
+ description: "Toggle plan mode (read-only exploration)",
119
+ handler: async (_args, ctx) => togglePlanMode(ctx),
120
+ });
121
+
122
+ pi.registerCommand("todos", {
123
+ description: "Show current plan todo list",
124
+ handler: async (_args, ctx) => {
125
+ if (todoItems.length === 0) {
126
+ ctx.ui.notify("No todos. Create a plan first with /plan", "info");
127
+ return;
128
+ }
129
+ const list = todoItems.map((item, i) => {
130
+ const issueId = issueIds.get(item.step);
131
+ const idLabel = issueId ? `[${getShortId(issueId)}] ` : "";
132
+ return `${i + 1}. ${item.completed ? "✓" : "○"} ${idLabel}${item.text}`;
133
+ }).join("\n");
134
+ ctx.ui.notify(`Plan Progress:\n${list}`, "info");
135
+ },
136
+ });
137
+
138
+ pi.registerShortcut(Key.ctrlAlt("p"), {
139
+ description: "Toggle plan mode",
140
+ handler: async (ctx) => togglePlanMode(ctx),
141
+ });
142
+
143
+ // Block destructive bash commands in plan mode
144
+ pi.on("tool_call", async (event) => {
145
+ if (!planModeEnabled || event.toolName !== "bash") return;
146
+
147
+ const command = event.input.command as string;
148
+ if (!isSafeCommand(command)) {
149
+ return {
150
+ block: true,
151
+ reason: `Plan mode: command blocked (not allowlisted). Use /plan to disable plan mode first.\nCommand: ${command}`,
152
+ };
153
+ }
154
+ });
155
+
156
+ // Filter out stale plan mode context when not in plan mode
157
+ pi.on("context", async (event) => {
158
+ if (planModeEnabled) return;
159
+
160
+ return {
161
+ messages: event.messages.filter((m) => {
162
+ const msg = m as AgentMessage & { customType?: string };
163
+ if (msg.customType === "plan-mode-context") return false;
164
+ if (msg.role !== "user") return true;
165
+
166
+ const content = msg.content;
167
+ if (typeof content === "string") {
168
+ return !content.includes("[PLAN MODE ACTIVE]");
169
+ }
170
+ if (Array.isArray(content)) {
171
+ return !content.some(
172
+ (c) => c.type === "text" && (c as TextContent).text?.includes("[PLAN MODE ACTIVE]"),
173
+ );
174
+ }
175
+ return true;
176
+ }),
177
+ };
178
+ });
179
+
180
+ // Inject plan/execution context before agent starts
181
+ pi.on("before_agent_start", async () => {
182
+ if (planModeEnabled) {
183
+ return {
184
+ message: {
185
+ customType: "plan-mode-context",
186
+ content: `[PLAN MODE ACTIVE]
187
+ You are in plan mode - a read-only exploration mode for safe code analysis.
188
+
189
+ Restrictions:
190
+ - You can only use: read, bash, grep, find, ls, questionnaire
191
+ - You CANNOT use: edit, write (file modifications are disabled)
192
+ - Bash is restricted to an allowlist of read-only commands
193
+
194
+ Ask clarifying questions using the questionnaire tool.
195
+ Use brave-search skill via bash for web research.
196
+
197
+ Create a detailed numbered plan under a "Plan:" header:
198
+
199
+ Plan:
200
+ 1. First step description
201
+ 2. Second step description
202
+ ...
203
+
204
+ Do NOT attempt to make changes - just describe what you would do.`,
205
+ display: false,
206
+ },
207
+ };
208
+ }
209
+
210
+ if (executionMode && todoItems.length > 0) {
211
+ const remaining = todoItems.filter((t) => !t.completed);
212
+ const todoList = remaining.map((t) => {
213
+ const issueId = issueIds.get(t.step);
214
+ const idLabel = issueId ? `[${getShortId(issueId)}] ` : "";
215
+ return `${t.step}. ${idLabel}${t.text}`;
216
+ }).join("\n");
217
+ return {
218
+ message: {
219
+ customType: "plan-execution-context",
220
+ content: `[EXECUTING PLAN - Full tool access enabled]
221
+
222
+ Remaining steps:
223
+ ${todoList}
224
+
225
+ Execute each step in order.
226
+ After completing a step, include a [DONE:n] tag in your response.`,
227
+ display: false,
228
+ },
229
+ };
230
+ }
231
+ });
232
+
233
+ // Track progress after each turn
234
+ pi.on("turn_end", async (event, ctx) => {
235
+ if (!executionMode || todoItems.length === 0) return;
236
+ if (!isAssistantMessage(event.message)) return;
237
+
238
+ const text = getTextContent(event.message);
239
+ if (markCompletedSteps(text, todoItems) > 0) {
240
+ updateStatus(ctx);
241
+ }
242
+ persistState();
243
+ });
244
+
245
+ // Handle plan completion and plan mode UI
246
+ pi.on("agent_end", async (event, ctx) => {
247
+ // Check if execution is complete
248
+ if (executionMode && todoItems.length > 0) {
249
+ if (todoItems.every((t) => t.completed)) {
250
+ const completedList = todoItems.map((t) => {
251
+ const issueId = issueIds.get(t.step);
252
+ const idLabel = issueId ? `[${getShortId(issueId)}] ` : "";
253
+ return `~~${idLabel}${t.text}~~`;
254
+ }).join("\n");
255
+ pi.sendMessage(
256
+ { customType: "plan-complete", content: `**Plan Complete!** ✓\n\n${completedList}`, display: true },
257
+ { triggerTurn: false },
258
+ );
259
+ executionMode = false;
260
+ todoItems = [];
261
+ epicId = null;
262
+ issueIds.clear();
263
+ pi.setActiveTools(NORMAL_MODE_TOOLS);
264
+ updateStatus(ctx);
265
+ persistState(); // Save cleared state so resume doesn't restore old execution mode
266
+ }
267
+ return;
268
+ }
269
+
270
+ if (!planModeEnabled || !ctx.hasUI) return;
271
+
272
+ // Extract todos from last assistant message
273
+ const lastAssistant = [...event.messages].reverse().find(isAssistantMessage);
274
+ if (lastAssistant) {
275
+ const extracted = extractTodoItems(getTextContent(lastAssistant));
276
+ if (extracted.length > 0) {
277
+ todoItems = extracted;
278
+ }
279
+ }
280
+
281
+ // Auto-create epic + issues if in a beads project
282
+ const cwd = ctx.cwd || process.cwd();
283
+ if (todoItems.length > 0 && isBeadsProject(cwd) && !epicId) {
284
+ // Derive epic title from user prompt or first step
285
+ const epicTitle = deriveEpicTitle(event.messages);
286
+
287
+ ctx.ui.notify("Creating epic and issues in bd...", "info");
288
+ const result = await createPlanIssues(epicTitle, todoItems, cwd);
289
+
290
+ if (result) {
291
+ epicId = result.epic.id;
292
+ for (const issue of result.issues) {
293
+ // Match issue to todo by title similarity
294
+ const matchingTodo = todoItems.find(t =>
295
+ issue.title.toLowerCase().includes(t.text.toLowerCase().slice(0, 30)) ||
296
+ t.text.toLowerCase().includes(issue.title.toLowerCase().slice(0, 30))
297
+ );
298
+ if (matchingTodo) {
299
+ issueIds.set(matchingTodo.step, issue.id);
300
+ }
301
+ }
302
+ ctx.ui.notify(`Created epic ${getShortId(epicId)} with ${result.issues.length} issues`, "info");
303
+ }
304
+ }
305
+
306
+ // Show plan steps with bd issue IDs
307
+ if (todoItems.length > 0) {
308
+ const todoListText = todoItems.map((t, i) => {
309
+ const issueId = issueIds.get(t.step);
310
+ const idLabel = issueId ? `[${getShortId(issueId)}] ` : "";
311
+ return `${i + 1}. ☐ ${idLabel}${t.text}`;
312
+ }).join("\n");
313
+
314
+ const epicLabel = epicId ? `\n\nEpic: ${getShortId(epicId)}` : "";
315
+ pi.sendMessage(
316
+ {
317
+ customType: "plan-todo-list",
318
+ content: `**Plan Steps (${todoItems.length}):**${epicLabel}\n\n${todoListText}`,
319
+ display: true,
320
+ },
321
+ { triggerTurn: false },
322
+ );
323
+ }
324
+
325
+ // Show "Start implementation?" prompt (no approval dialog for issue creation)
326
+ const choice = await ctx.ui.select("Start implementation?", [
327
+ todoItems.length > 0 ? "Yes, start with first step" : "Yes",
328
+ "Stay in plan mode",
329
+ "Refine the plan",
330
+ ]);
331
+
332
+ if (choice?.startsWith("Yes")) {
333
+ // Auto-exit plan mode and start execution
334
+ planModeEnabled = false;
335
+ executionMode = todoItems.length > 0;
336
+ pi.setActiveTools(NORMAL_MODE_TOOLS);
337
+ updateStatus(ctx);
338
+
339
+ // Auto-claim first issue if available
340
+ if (todoItems.length > 0 && issueIds.size > 0) {
341
+ const firstIssueId = issueIds.get(todoItems[0].step);
342
+ if (firstIssueId) {
343
+ await bdClaim(firstIssueId, cwd);
344
+ }
345
+ }
346
+
347
+ const execMessage =
348
+ todoItems.length > 0
349
+ ? `Execute the plan. Start with: ${todoItems[0].text}`
350
+ : "Execute the plan you just created.";
351
+ pi.sendMessage(
352
+ { customType: "plan-mode-execute", content: execMessage, display: true },
353
+ { triggerTurn: true },
354
+ );
355
+ } else if (choice === "Refine the plan") {
356
+ const refinement = await ctx.ui.editor("Refine the plan:", "");
357
+ if (refinement?.trim()) {
358
+ pi.sendUserMessage(refinement.trim());
359
+ }
360
+ }
361
+ });
362
+
363
+ // Restore state on session start/resume
364
+ pi.on("session_start", async (_event, ctx) => {
365
+ if (pi.getFlag("plan") === true) {
366
+ planModeEnabled = true;
367
+ }
368
+
369
+ const entries = ctx.sessionManager.getEntries();
370
+
371
+ // Restore persisted state
372
+ const planModeEntry = entries
373
+ .filter((e: { type: string; customType?: string }) => e.type === "custom" && e.customType === "plan-mode")
374
+ .pop() as { data?: { enabled: boolean; todos?: TodoItem[]; executing?: boolean; epicId?: string; issueIds?: Record<number, string> } } | undefined;
375
+
376
+ if (planModeEntry?.data) {
377
+ planModeEnabled = planModeEntry.data.enabled ?? planModeEnabled;
378
+ todoItems = planModeEntry.data.todos ?? todoItems;
379
+ executionMode = planModeEntry.data.executing ?? executionMode;
380
+ epicId = planModeEntry.data.epicId ?? null;
381
+ if (planModeEntry.data.issueIds) {
382
+ issueIds = new Map(Object.entries(planModeEntry.data.issueIds).map(([k, v]) => [Number(k), v]));
383
+ }
384
+ }
385
+
386
+ // On resume: re-scan messages to rebuild completion state
387
+ // Only scan messages AFTER the last "plan-mode-execute" to avoid picking up [DONE:n] from previous plans
388
+ const isResume = planModeEntry !== undefined;
389
+ if (isResume && executionMode && todoItems.length > 0) {
390
+ // Find the index of the last plan-mode-execute entry (marks when current execution started)
391
+ let executeIndex = -1;
392
+ for (let i = entries.length - 1; i >= 0; i--) {
393
+ const entry = entries[i] as { type: string; customType?: string };
394
+ if (entry.customType === "plan-mode-execute") {
395
+ executeIndex = i;
396
+ break;
397
+ }
398
+ }
399
+
400
+ // Only scan messages after the execute marker
401
+ const messages: AssistantMessage[] = [];
402
+ for (let i = executeIndex + 1; i < entries.length; i++) {
403
+ const entry = entries[i];
404
+ if (entry.type === "message" && "message" in entry && isAssistantMessage(entry.message as AgentMessage)) {
405
+ messages.push(entry.message as AssistantMessage);
406
+ }
407
+ }
408
+ const allText = messages.map(getTextContent).join("\n");
409
+ markCompletedSteps(allText, todoItems);
410
+ }
411
+
412
+ if (planModeEnabled) {
413
+ pi.setActiveTools(PLAN_MODE_TOOLS);
414
+ }
415
+ updateStatus(ctx);
416
+ });
417
+ }