@therocketcode/gsd-core 1.4.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 (568) hide show
  1. package/.claude-plugin/plugin.json +23 -0
  2. package/GEMINI.md +53 -0
  3. package/LICENSE +21 -0
  4. package/README.ja-JP.md +125 -0
  5. package/README.ko-KR.md +125 -0
  6. package/README.md +144 -0
  7. package/README.pt-BR.md +125 -0
  8. package/README.zh-CN.md +125 -0
  9. package/agents/gsd-advisor-researcher.md +108 -0
  10. package/agents/gsd-ai-researcher.md +114 -0
  11. package/agents/gsd-assumptions-analyzer.md +105 -0
  12. package/agents/gsd-code-fixer.md +668 -0
  13. package/agents/gsd-code-reviewer.md +387 -0
  14. package/agents/gsd-codebase-mapper.md +853 -0
  15. package/agents/gsd-debug-session-manager.md +314 -0
  16. package/agents/gsd-debugger.md +1452 -0
  17. package/agents/gsd-doc-classifier.md +168 -0
  18. package/agents/gsd-doc-synthesizer.md +204 -0
  19. package/agents/gsd-doc-verifier.md +217 -0
  20. package/agents/gsd-doc-writer.md +616 -0
  21. package/agents/gsd-domain-researcher.md +147 -0
  22. package/agents/gsd-eval-auditor.md +191 -0
  23. package/agents/gsd-eval-planner.md +154 -0
  24. package/agents/gsd-executor.md +785 -0
  25. package/agents/gsd-framework-selector.md +160 -0
  26. package/agents/gsd-integration-checker.md +470 -0
  27. package/agents/gsd-intel-updater.md +342 -0
  28. package/agents/gsd-nyquist-auditor.md +203 -0
  29. package/agents/gsd-pattern-mapper.md +335 -0
  30. package/agents/gsd-phase-researcher.md +867 -0
  31. package/agents/gsd-plan-checker.md +978 -0
  32. package/agents/gsd-planner.md +1204 -0
  33. package/agents/gsd-project-researcher.md +611 -0
  34. package/agents/gsd-research-synthesizer.md +259 -0
  35. package/agents/gsd-roadmapper.md +688 -0
  36. package/agents/gsd-security-auditor.md +155 -0
  37. package/agents/gsd-ui-auditor.md +495 -0
  38. package/agents/gsd-ui-checker.md +309 -0
  39. package/agents/gsd-ui-researcher.md +374 -0
  40. package/agents/gsd-user-profiler.md +171 -0
  41. package/agents/gsd-verifier.md +923 -0
  42. package/assets/gsd-logo-2000-transparent.png +0 -0
  43. package/assets/gsd-logo-2000-transparent.svg +17 -0
  44. package/assets/gsd-logo-2000.png +0 -0
  45. package/assets/gsd-logo-2000.svg +21 -0
  46. package/assets/terminal.svg +68 -0
  47. package/bin/install.js +12726 -0
  48. package/bin/lib/ui-safety-gate.cjs +107 -0
  49. package/commands/gsd/add-tests.md +42 -0
  50. package/commands/gsd/ai-integration-phase.md +37 -0
  51. package/commands/gsd/audit-fix.md +34 -0
  52. package/commands/gsd/audit-milestone.md +37 -0
  53. package/commands/gsd/audit-uat.md +24 -0
  54. package/commands/gsd/autonomous.md +48 -0
  55. package/commands/gsd/capture.md +62 -0
  56. package/commands/gsd/cleanup.md +24 -0
  57. package/commands/gsd/code-review.md +59 -0
  58. package/commands/gsd/complete-milestone.md +143 -0
  59. package/commands/gsd/config.md +56 -0
  60. package/commands/gsd/debug.md +52 -0
  61. package/commands/gsd/discover-product.md +65 -0
  62. package/commands/gsd/discuss-phase.md +77 -0
  63. package/commands/gsd/docs-update.md +49 -0
  64. package/commands/gsd/eval-review.md +33 -0
  65. package/commands/gsd/execute-phase.md +66 -0
  66. package/commands/gsd/explore.md +27 -0
  67. package/commands/gsd/extract-learnings.md +23 -0
  68. package/commands/gsd/fast.md +31 -0
  69. package/commands/gsd/forensics.md +57 -0
  70. package/commands/gsd/graphify.md +204 -0
  71. package/commands/gsd/health.md +31 -0
  72. package/commands/gsd/help.md +28 -0
  73. package/commands/gsd/import.md +45 -0
  74. package/commands/gsd/inbox.md +39 -0
  75. package/commands/gsd/ingest-docs.md +42 -0
  76. package/commands/gsd/manager.md +45 -0
  77. package/commands/gsd/map-codebase.md +83 -0
  78. package/commands/gsd/milestone-summary.md +51 -0
  79. package/commands/gsd/model-domain.md +65 -0
  80. package/commands/gsd/mvp-phase.md +45 -0
  81. package/commands/gsd/new-milestone.md +45 -0
  82. package/commands/gsd/new-project.md +47 -0
  83. package/commands/gsd/ns-context.md +23 -0
  84. package/commands/gsd/ns-ideate.md +24 -0
  85. package/commands/gsd/ns-manage.md +29 -0
  86. package/commands/gsd/ns-project.md +22 -0
  87. package/commands/gsd/ns-review.md +26 -0
  88. package/commands/gsd/ns-workflow.md +28 -0
  89. package/commands/gsd/pause-work.md +43 -0
  90. package/commands/gsd/phase.md +56 -0
  91. package/commands/gsd/plan-phase.md +64 -0
  92. package/commands/gsd/plan-review-convergence.md +59 -0
  93. package/commands/gsd/pr-branch.md +26 -0
  94. package/commands/gsd/profile-user.md +46 -0
  95. package/commands/gsd/progress.md +48 -0
  96. package/commands/gsd/quick.md +174 -0
  97. package/commands/gsd/recommend-architecture.md +64 -0
  98. package/commands/gsd/resume-work.md +30 -0
  99. package/commands/gsd/review-backlog.md +63 -0
  100. package/commands/gsd/review.md +42 -0
  101. package/commands/gsd/secure-phase.md +36 -0
  102. package/commands/gsd/settings.md +29 -0
  103. package/commands/gsd/ship.md +24 -0
  104. package/commands/gsd/sketch.md +60 -0
  105. package/commands/gsd/spec-phase.md +63 -0
  106. package/commands/gsd/spike.md +57 -0
  107. package/commands/gsd/stats.md +20 -0
  108. package/commands/gsd/surface.md +155 -0
  109. package/commands/gsd/testing-strategy.md +65 -0
  110. package/commands/gsd/thread.md +24 -0
  111. package/commands/gsd/ui-phase.md +35 -0
  112. package/commands/gsd/ui-review.md +33 -0
  113. package/commands/gsd/ultraplan-phase.md +34 -0
  114. package/commands/gsd/undo.md +35 -0
  115. package/commands/gsd/update.md +49 -0
  116. package/commands/gsd/validate-phase.md +36 -0
  117. package/commands/gsd/verify-work.md +39 -0
  118. package/commands/gsd/workspace.md +52 -0
  119. package/commands/gsd/workstreams.md +70 -0
  120. package/gemini-extension.json +6 -0
  121. package/gsd-core/bin/check-latest-version.cjs +161 -0
  122. package/gsd-core/bin/gsd-tools.cjs +1928 -0
  123. package/gsd-core/bin/lib/active-workstream-store.cjs +291 -0
  124. package/gsd-core/bin/lib/adr-parser.cjs +399 -0
  125. package/gsd-core/bin/lib/agent-command-router.cjs +68 -0
  126. package/gsd-core/bin/lib/artifacts.cjs +51 -0
  127. package/gsd-core/bin/lib/audit.cjs +743 -0
  128. package/gsd-core/bin/lib/check-command-router.cjs +343 -0
  129. package/gsd-core/bin/lib/cjs-command-router-adapter.cjs +81 -0
  130. package/gsd-core/bin/lib/cli-exit.cjs +42 -0
  131. package/gsd-core/bin/lib/clock.cjs +95 -0
  132. package/gsd-core/bin/lib/clusters.cjs +132 -0
  133. package/gsd-core/bin/lib/code-review-flags.cjs +59 -0
  134. package/gsd-core/bin/lib/command-aliases.cjs +809 -0
  135. package/gsd-core/bin/lib/command-arg-projection.cjs +55 -0
  136. package/gsd-core/bin/lib/command-routing-hub.cjs +300 -0
  137. package/gsd-core/bin/lib/commands.cjs +1203 -0
  138. package/gsd-core/bin/lib/config-schema.cjs +29 -0
  139. package/gsd-core/bin/lib/config-types.cjs +19 -0
  140. package/gsd-core/bin/lib/config.cjs +738 -0
  141. package/gsd-core/bin/lib/configuration.cjs +239 -0
  142. package/gsd-core/bin/lib/context-utilization.cjs +48 -0
  143. package/gsd-core/bin/lib/core.cjs +2051 -0
  144. package/gsd-core/bin/lib/decisions.cjs +118 -0
  145. package/gsd-core/bin/lib/docs.cjs +252 -0
  146. package/gsd-core/bin/lib/drift.cjs +364 -0
  147. package/gsd-core/bin/lib/fallow-runner.cjs +115 -0
  148. package/gsd-core/bin/lib/frontmatter.cjs +442 -0
  149. package/gsd-core/bin/lib/gap-checker.cjs +257 -0
  150. package/gsd-core/bin/lib/graphify.cjs +496 -0
  151. package/gsd-core/bin/lib/gsd2-import.cjs +456 -0
  152. package/gsd-core/bin/lib/init-command-router.cjs +62 -0
  153. package/gsd-core/bin/lib/init.cjs +1815 -0
  154. package/gsd-core/bin/lib/install-profiles.cjs +584 -0
  155. package/gsd-core/bin/lib/installer-migration-authoring.cjs +122 -0
  156. package/gsd-core/bin/lib/installer-migration-report.cjs +350 -0
  157. package/gsd-core/bin/lib/installer-migrations/000-first-time-baseline.cjs +218 -0
  158. package/gsd-core/bin/lib/installer-migrations/001-legacy-orphan-files.cjs +48 -0
  159. package/gsd-core/bin/lib/installer-migrations/002-codex-legacy-hooks-json.cjs +94 -0
  160. package/gsd-core/bin/lib/installer-migrations/003-rename-get-shit-done-to-gsd-core.cjs +108 -0
  161. package/gsd-core/bin/lib/installer-migrations.cjs +823 -0
  162. package/gsd-core/bin/lib/intel.cjs +590 -0
  163. package/gsd-core/bin/lib/learnings.cjs +270 -0
  164. package/gsd-core/bin/lib/legacy-cleanup.cjs +253 -0
  165. package/gsd-core/bin/lib/milestone.cjs +373 -0
  166. package/gsd-core/bin/lib/model-catalog.cjs +154 -0
  167. package/gsd-core/bin/lib/model-profiles.cjs +24 -0
  168. package/gsd-core/bin/lib/observability/event.cjs +51 -0
  169. package/gsd-core/bin/lib/observability/logger.cjs +146 -0
  170. package/gsd-core/bin/lib/observability/redaction.cjs +48 -0
  171. package/gsd-core/bin/lib/package-identity.cjs +35 -0
  172. package/gsd-core/bin/lib/package-legitimacy.cjs +368 -0
  173. package/gsd-core/bin/lib/phase-command-router.cjs +189 -0
  174. package/gsd-core/bin/lib/phase-lifecycle.cjs +74 -0
  175. package/gsd-core/bin/lib/phase.cjs +1307 -0
  176. package/gsd-core/bin/lib/phases-command-router.cjs +43 -0
  177. package/gsd-core/bin/lib/plan-scan.cjs +91 -0
  178. package/gsd-core/bin/lib/planning-workspace.cjs +245 -0
  179. package/gsd-core/bin/lib/profile-output.cjs +1120 -0
  180. package/gsd-core/bin/lib/profile-pipeline.cjs +517 -0
  181. package/gsd-core/bin/lib/project-root.cjs +119 -0
  182. package/gsd-core/bin/lib/prompt-budget.cjs +305 -0
  183. package/gsd-core/bin/lib/research-provider.cjs +137 -0
  184. package/gsd-core/bin/lib/research-store.cjs +167 -0
  185. package/gsd-core/bin/lib/review-reviewer-selection.cjs +121 -0
  186. package/gsd-core/bin/lib/roadmap-command-router.cjs +166 -0
  187. package/gsd-core/bin/lib/roadmap-upgrade.cjs +476 -0
  188. package/gsd-core/bin/lib/roadmap.cjs +600 -0
  189. package/gsd-core/bin/lib/runtime-artifact-layout.cjs +312 -0
  190. package/gsd-core/bin/lib/runtime-config-adapter-registry.cjs +56 -0
  191. package/gsd-core/bin/lib/runtime-homes.cjs +190 -0
  192. package/gsd-core/bin/lib/runtime-name-policy.cjs +96 -0
  193. package/gsd-core/bin/lib/runtime-slash.cjs +119 -0
  194. package/gsd-core/bin/lib/schema-detect.cjs +159 -0
  195. package/gsd-core/bin/lib/secrets.cjs +34 -0
  196. package/gsd-core/bin/lib/security.cjs +480 -0
  197. package/gsd-core/bin/lib/semver-compare.cjs +42 -0
  198. package/gsd-core/bin/lib/shell-command-projection.cjs +533 -0
  199. package/gsd-core/bin/lib/state-command-router.cjs +160 -0
  200. package/gsd-core/bin/lib/state-document.cjs +259 -0
  201. package/gsd-core/bin/lib/state.cjs +2010 -0
  202. package/gsd-core/bin/lib/surface.cjs +449 -0
  203. package/gsd-core/bin/lib/task-command-router.cjs +85 -0
  204. package/gsd-core/bin/lib/template.cjs +237 -0
  205. package/gsd-core/bin/lib/uat.cjs +297 -0
  206. package/gsd-core/bin/lib/ui-safety-gate.cjs +98 -0
  207. package/gsd-core/bin/lib/update-context.cjs +218 -0
  208. package/gsd-core/bin/lib/validate-command-router.cjs +91 -0
  209. package/gsd-core/bin/lib/validate.cjs +112 -0
  210. package/gsd-core/bin/lib/verification-command-router.cjs +31 -0
  211. package/gsd-core/bin/lib/verification.cjs +193 -0
  212. package/gsd-core/bin/lib/verify-command-router.cjs +44 -0
  213. package/gsd-core/bin/lib/verify.cjs +1451 -0
  214. package/gsd-core/bin/lib/workstream-inventory-builder.cjs +81 -0
  215. package/gsd-core/bin/lib/workstream-inventory.cjs +147 -0
  216. package/gsd-core/bin/lib/workstream-name-policy.cjs +91 -0
  217. package/gsd-core/bin/lib/workstream.cjs +380 -0
  218. package/gsd-core/bin/lib/worktree-base-ref.cjs +325 -0
  219. package/gsd-core/bin/lib/worktree-safety.cjs +943 -0
  220. package/gsd-core/bin/shared/config-defaults.manifest.json +98 -0
  221. package/gsd-core/bin/shared/config-schema.manifest.json +192 -0
  222. package/gsd-core/bin/shared/model-catalog.json +149 -0
  223. package/gsd-core/bin/shared/runtime-aliases.manifest.json +75 -0
  224. package/gsd-core/bin/verify-reapply-patches.cjs +349 -0
  225. package/gsd-core/contexts/dev.md +21 -0
  226. package/gsd-core/contexts/research.md +22 -0
  227. package/gsd-core/contexts/review.md +23 -0
  228. package/gsd-core/references/agent-contracts.md +79 -0
  229. package/gsd-core/references/ai-evals.md +156 -0
  230. package/gsd-core/references/ai-frameworks.md +186 -0
  231. package/gsd-core/references/architecture-decision.md +74 -0
  232. package/gsd-core/references/artifact-types.md +131 -0
  233. package/gsd-core/references/auth-in-tests.md +91 -0
  234. package/gsd-core/references/autonomous-smart-discuss.md +277 -0
  235. package/gsd-core/references/checkpoints.md +814 -0
  236. package/gsd-core/references/common-bug-patterns.md +114 -0
  237. package/gsd-core/references/context-budget.md +85 -0
  238. package/gsd-core/references/continuation-format.md +253 -0
  239. package/gsd-core/references/db-test-isolation.md +54 -0
  240. package/gsd-core/references/debugger-philosophy.md +76 -0
  241. package/gsd-core/references/decimal-phase-calculation.md +64 -0
  242. package/gsd-core/references/doc-conflict-engine.md +91 -0
  243. package/gsd-core/references/domain-modeling.md +80 -0
  244. package/gsd-core/references/domain-probes.md +125 -0
  245. package/gsd-core/references/e2e-tiering.md +35 -0
  246. package/gsd-core/references/execute-mvp-tdd.md +81 -0
  247. package/gsd-core/references/executor-examples.md +110 -0
  248. package/gsd-core/references/few-shot-examples/plan-checker.md +73 -0
  249. package/gsd-core/references/few-shot-examples/verifier.md +109 -0
  250. package/gsd-core/references/flaky-test-checklist.md +22 -0
  251. package/gsd-core/references/gate-prompts.md +100 -0
  252. package/gsd-core/references/gates.md +70 -0
  253. package/gsd-core/references/git-integration.md +298 -0
  254. package/gsd-core/references/git-planning-commit.md +40 -0
  255. package/gsd-core/references/ios-scaffold.md +123 -0
  256. package/gsd-core/references/mandatory-initial-read.md +2 -0
  257. package/gsd-core/references/model-profile-resolution.md +38 -0
  258. package/gsd-core/references/model-profiles.md +245 -0
  259. package/gsd-core/references/mvp-concepts.md +49 -0
  260. package/gsd-core/references/phase-argument-parsing.md +61 -0
  261. package/gsd-core/references/planner-antipatterns.md +89 -0
  262. package/gsd-core/references/planner-chunked.md +49 -0
  263. package/gsd-core/references/planner-gap-closure.md +62 -0
  264. package/gsd-core/references/planner-graphify-auto-update.md +67 -0
  265. package/gsd-core/references/planner-human-verify-mode.md +57 -0
  266. package/gsd-core/references/planner-interface-context.md +62 -0
  267. package/gsd-core/references/planner-load-graph-context.md +36 -0
  268. package/gsd-core/references/planner-mvp-mode.md +53 -0
  269. package/gsd-core/references/planner-reviews.md +39 -0
  270. package/gsd-core/references/planner-revision.md +87 -0
  271. package/gsd-core/references/planner-source-audit.md +73 -0
  272. package/gsd-core/references/planning-config.md +473 -0
  273. package/gsd-core/references/product-discovery.md +49 -0
  274. package/gsd-core/references/project-skills-discovery.md +19 -0
  275. package/gsd-core/references/questioning.md +162 -0
  276. package/gsd-core/references/realistic-test-data.md +44 -0
  277. package/gsd-core/references/research-documentation-lookup.md +29 -0
  278. package/gsd-core/references/research-philosophy.md +29 -0
  279. package/gsd-core/references/research-verification-protocol.md +27 -0
  280. package/gsd-core/references/revision-loop.md +97 -0
  281. package/gsd-core/references/scout-codebase.md +51 -0
  282. package/gsd-core/references/skeleton-template.md +48 -0
  283. package/gsd-core/references/sketch-interactivity.md +41 -0
  284. package/gsd-core/references/sketch-theme-system.md +94 -0
  285. package/gsd-core/references/sketch-tooling.md +45 -0
  286. package/gsd-core/references/sketch-variant-patterns.md +81 -0
  287. package/gsd-core/references/spidr-splitting.md +69 -0
  288. package/gsd-core/references/tdd.md +330 -0
  289. package/gsd-core/references/test-containers.md +55 -0
  290. package/gsd-core/references/test-strategy.md +75 -0
  291. package/gsd-core/references/thinking-models-debug.md +44 -0
  292. package/gsd-core/references/thinking-models-execution.md +50 -0
  293. package/gsd-core/references/thinking-models-planning.md +62 -0
  294. package/gsd-core/references/thinking-models-research.md +50 -0
  295. package/gsd-core/references/thinking-models-verification.md +55 -0
  296. package/gsd-core/references/thinking-partner.md +96 -0
  297. package/gsd-core/references/ui-brand.md +162 -0
  298. package/gsd-core/references/universal-anti-patterns.md +63 -0
  299. package/gsd-core/references/user-profiling.md +681 -0
  300. package/gsd-core/references/user-story-template.md +58 -0
  301. package/gsd-core/references/verification-overrides.md +227 -0
  302. package/gsd-core/references/verification-patterns.md +612 -0
  303. package/gsd-core/references/verify-mvp-mode.md +85 -0
  304. package/gsd-core/references/workstream-flag.md +111 -0
  305. package/gsd-core/references/worktree-branch-check.md +38 -0
  306. package/gsd-core/references/worktree-path-safety.md +67 -0
  307. package/gsd-core/templates/AI-SPEC.md +246 -0
  308. package/gsd-core/templates/DEBUG.md +169 -0
  309. package/gsd-core/templates/README.md +77 -0
  310. package/gsd-core/templates/SECURITY.md +61 -0
  311. package/gsd-core/templates/UAT.md +265 -0
  312. package/gsd-core/templates/UI-SPEC.md +100 -0
  313. package/gsd-core/templates/VALIDATION.md +76 -0
  314. package/gsd-core/templates/adr.md +58 -0
  315. package/gsd-core/templates/claude-md.md +145 -0
  316. package/gsd-core/templates/codebase/architecture.md +255 -0
  317. package/gsd-core/templates/codebase/concerns.md +310 -0
  318. package/gsd-core/templates/codebase/conventions.md +307 -0
  319. package/gsd-core/templates/codebase/integrations.md +280 -0
  320. package/gsd-core/templates/codebase/stack.md +186 -0
  321. package/gsd-core/templates/codebase/structure.md +285 -0
  322. package/gsd-core/templates/codebase/testing.md +480 -0
  323. package/gsd-core/templates/config.json +62 -0
  324. package/gsd-core/templates/context.md +352 -0
  325. package/gsd-core/templates/continue-here.md +78 -0
  326. package/gsd-core/templates/copilot-instructions.md +7 -0
  327. package/gsd-core/templates/debug-subagent-prompt.md +91 -0
  328. package/gsd-core/templates/dev-preferences.md +21 -0
  329. package/gsd-core/templates/discovery.md +146 -0
  330. package/gsd-core/templates/discussion-log.md +63 -0
  331. package/gsd-core/templates/domain-model.md +54 -0
  332. package/gsd-core/templates/milestone-archive.md +123 -0
  333. package/gsd-core/templates/milestone.md +115 -0
  334. package/gsd-core/templates/phase-prompt.md +610 -0
  335. package/gsd-core/templates/planner-subagent-prompt.md +117 -0
  336. package/gsd-core/templates/product-brief.md +55 -0
  337. package/gsd-core/templates/project.md +186 -0
  338. package/gsd-core/templates/requirements.md +231 -0
  339. package/gsd-core/templates/research-project/ARCHITECTURE.md +204 -0
  340. package/gsd-core/templates/research-project/FEATURES.md +147 -0
  341. package/gsd-core/templates/research-project/PITFALLS.md +200 -0
  342. package/gsd-core/templates/research-project/STACK.md +120 -0
  343. package/gsd-core/templates/research-project/SUMMARY.md +170 -0
  344. package/gsd-core/templates/research.md +592 -0
  345. package/gsd-core/templates/retrospective.md +54 -0
  346. package/gsd-core/templates/roadmap.md +202 -0
  347. package/gsd-core/templates/spec.md +307 -0
  348. package/gsd-core/templates/state.md +195 -0
  349. package/gsd-core/templates/summary-complex.md +59 -0
  350. package/gsd-core/templates/summary-minimal.md +41 -0
  351. package/gsd-core/templates/summary-standard.md +48 -0
  352. package/gsd-core/templates/summary.md +248 -0
  353. package/gsd-core/templates/test-strategy.md +50 -0
  354. package/gsd-core/templates/user-profile.md +146 -0
  355. package/gsd-core/templates/user-setup.md +311 -0
  356. package/gsd-core/templates/verification-report.md +322 -0
  357. package/gsd-core/workflows/_runtime-launcher.snippet.sh +1 -0
  358. package/gsd-core/workflows/add-backlog.md +91 -0
  359. package/gsd-core/workflows/add-phase.md +113 -0
  360. package/gsd-core/workflows/add-tests.md +355 -0
  361. package/gsd-core/workflows/add-todo.md +161 -0
  362. package/gsd-core/workflows/ai-integration-phase.md +295 -0
  363. package/gsd-core/workflows/analyze-dependencies.md +96 -0
  364. package/gsd-core/workflows/audit-fix.md +178 -0
  365. package/gsd-core/workflows/audit-milestone.md +360 -0
  366. package/gsd-core/workflows/audit-uat.md +110 -0
  367. package/gsd-core/workflows/autonomous.md +797 -0
  368. package/gsd-core/workflows/check-todos.md +180 -0
  369. package/gsd-core/workflows/cleanup.md +195 -0
  370. package/gsd-core/workflows/code-review-fix.md +502 -0
  371. package/gsd-core/workflows/code-review.md +658 -0
  372. package/gsd-core/workflows/complete-milestone.md +855 -0
  373. package/gsd-core/workflows/debug.md +237 -0
  374. package/gsd-core/workflows/diagnose-issues.md +245 -0
  375. package/gsd-core/workflows/discover-product.md +112 -0
  376. package/gsd-core/workflows/discovery-phase.md +291 -0
  377. package/gsd-core/workflows/discuss-phase/modes/advisor.md +176 -0
  378. package/gsd-core/workflows/discuss-phase/modes/all.md +28 -0
  379. package/gsd-core/workflows/discuss-phase/modes/analyze.md +44 -0
  380. package/gsd-core/workflows/discuss-phase/modes/auto.md +57 -0
  381. package/gsd-core/workflows/discuss-phase/modes/batch.md +52 -0
  382. package/gsd-core/workflows/discuss-phase/modes/chain.md +98 -0
  383. package/gsd-core/workflows/discuss-phase/modes/default.md +141 -0
  384. package/gsd-core/workflows/discuss-phase/modes/power.md +44 -0
  385. package/gsd-core/workflows/discuss-phase/modes/text.md +55 -0
  386. package/gsd-core/workflows/discuss-phase/templates/checkpoint.json +18 -0
  387. package/gsd-core/workflows/discuss-phase/templates/context.md +136 -0
  388. package/gsd-core/workflows/discuss-phase/templates/discussion-log.md +50 -0
  389. package/gsd-core/workflows/discuss-phase-assumptions.md +675 -0
  390. package/gsd-core/workflows/discuss-phase-power.md +291 -0
  391. package/gsd-core/workflows/discuss-phase.md +499 -0
  392. package/gsd-core/workflows/do.md +111 -0
  393. package/gsd-core/workflows/docs-update.md +1176 -0
  394. package/gsd-core/workflows/edit-phase.md +295 -0
  395. package/gsd-core/workflows/eval-review.md +156 -0
  396. package/gsd-core/workflows/execute-phase/steps/codebase-drift-gate.md +95 -0
  397. package/gsd-core/workflows/execute-phase/steps/per-plan-worktree-gate.md +94 -0
  398. package/gsd-core/workflows/execute-phase/steps/post-merge-gate.md +117 -0
  399. package/gsd-core/workflows/execute-phase.md +1752 -0
  400. package/gsd-core/workflows/execute-plan.md +526 -0
  401. package/gsd-core/workflows/explore.md +146 -0
  402. package/gsd-core/workflows/extract-learnings.md +243 -0
  403. package/gsd-core/workflows/fast.md +124 -0
  404. package/gsd-core/workflows/forensics.md +279 -0
  405. package/gsd-core/workflows/graduation.md +196 -0
  406. package/gsd-core/workflows/health.md +224 -0
  407. package/gsd-core/workflows/help/modes/brief.md +22 -0
  408. package/gsd-core/workflows/help/modes/default.md +50 -0
  409. package/gsd-core/workflows/help/modes/full.md +789 -0
  410. package/gsd-core/workflows/help/modes/topic.md +74 -0
  411. package/gsd-core/workflows/help.md +24 -0
  412. package/gsd-core/workflows/import.md +256 -0
  413. package/gsd-core/workflows/inbox.md +387 -0
  414. package/gsd-core/workflows/ingest-docs.md +340 -0
  415. package/gsd-core/workflows/insert-phase.md +152 -0
  416. package/gsd-core/workflows/list-phase-assumptions.md +178 -0
  417. package/gsd-core/workflows/list-workspaces.md +57 -0
  418. package/gsd-core/workflows/manager.md +393 -0
  419. package/gsd-core/workflows/map-codebase.md +446 -0
  420. package/gsd-core/workflows/milestone-summary.md +224 -0
  421. package/gsd-core/workflows/model-domain.md +162 -0
  422. package/gsd-core/workflows/mvp-phase.md +222 -0
  423. package/gsd-core/workflows/new-milestone.md +635 -0
  424. package/gsd-core/workflows/new-project.md +1555 -0
  425. package/gsd-core/workflows/new-workspace.md +240 -0
  426. package/gsd-core/workflows/next.md +299 -0
  427. package/gsd-core/workflows/node-repair.md +92 -0
  428. package/gsd-core/workflows/note.md +158 -0
  429. package/gsd-core/workflows/pause-work.md +244 -0
  430. package/gsd-core/workflows/plan-milestone-gaps.md +281 -0
  431. package/gsd-core/workflows/plan-phase.md +1814 -0
  432. package/gsd-core/workflows/plan-review-convergence.md +346 -0
  433. package/gsd-core/workflows/plant-seed.md +230 -0
  434. package/gsd-core/workflows/pr-branch.md +157 -0
  435. package/gsd-core/workflows/profile-user.md +453 -0
  436. package/gsd-core/workflows/progress.md +699 -0
  437. package/gsd-core/workflows/quick.md +1017 -0
  438. package/gsd-core/workflows/reapply-patches.md +426 -0
  439. package/gsd-core/workflows/recommend-architecture.md +135 -0
  440. package/gsd-core/workflows/remove-phase.md +156 -0
  441. package/gsd-core/workflows/remove-workspace.md +108 -0
  442. package/gsd-core/workflows/resume-project.md +332 -0
  443. package/gsd-core/workflows/review.md +748 -0
  444. package/gsd-core/workflows/scan.md +107 -0
  445. package/gsd-core/workflows/secure-phase.md +182 -0
  446. package/gsd-core/workflows/session-report.md +146 -0
  447. package/gsd-core/workflows/settings-advanced.md +810 -0
  448. package/gsd-core/workflows/settings-integrations.md +312 -0
  449. package/gsd-core/workflows/settings.md +566 -0
  450. package/gsd-core/workflows/ship.md +405 -0
  451. package/gsd-core/workflows/sketch-wrap-up.md +286 -0
  452. package/gsd-core/workflows/sketch.md +361 -0
  453. package/gsd-core/workflows/spec-phase.md +263 -0
  454. package/gsd-core/workflows/spike-wrap-up.md +307 -0
  455. package/gsd-core/workflows/spike.md +453 -0
  456. package/gsd-core/workflows/stats.md +80 -0
  457. package/gsd-core/workflows/sync-skills.md +182 -0
  458. package/gsd-core/workflows/testing-strategy.md +122 -0
  459. package/gsd-core/workflows/thread.md +222 -0
  460. package/gsd-core/workflows/transition.md +694 -0
  461. package/gsd-core/workflows/ui-phase.md +328 -0
  462. package/gsd-core/workflows/ui-review.md +193 -0
  463. package/gsd-core/workflows/ultraplan-phase.md +199 -0
  464. package/gsd-core/workflows/undo.md +314 -0
  465. package/gsd-core/workflows/update.md +496 -0
  466. package/gsd-core/workflows/validate-phase.md +181 -0
  467. package/gsd-core/workflows/verify-phase.md +544 -0
  468. package/gsd-core/workflows/verify-work.md +781 -0
  469. package/hooks/dist/gsd-check-update-worker.js +108 -0
  470. package/hooks/dist/gsd-check-update.js +66 -0
  471. package/hooks/dist/gsd-config-reload.js +133 -0
  472. package/hooks/dist/gsd-context-monitor.js +195 -0
  473. package/hooks/dist/gsd-cursor-post-tool.js +75 -0
  474. package/hooks/dist/gsd-cursor-session-start.js +52 -0
  475. package/hooks/dist/gsd-graphify-update.sh +158 -0
  476. package/hooks/dist/gsd-phase-boundary.sh +47 -0
  477. package/hooks/dist/gsd-prompt-guard.js +97 -0
  478. package/hooks/dist/gsd-read-guard.js +101 -0
  479. package/hooks/dist/gsd-read-injection-scanner.js +203 -0
  480. package/hooks/dist/gsd-session-state.sh +59 -0
  481. package/hooks/dist/gsd-statusline.js +566 -0
  482. package/hooks/dist/gsd-update-banner.js +138 -0
  483. package/hooks/dist/gsd-validate-commit.sh +57 -0
  484. package/hooks/dist/gsd-workflow-guard.js +167 -0
  485. package/hooks/dist/gsd-worktree-path-guard.js +169 -0
  486. package/hooks/dist/lib/git-cmd.js +150 -0
  487. package/hooks/dist/lib/gsd-graphify-rebuild.sh +65 -0
  488. package/hooks/dist/managed-hooks-registry.cjs +38 -0
  489. package/hooks/gsd-check-update-worker.js +108 -0
  490. package/hooks/gsd-check-update.js +66 -0
  491. package/hooks/gsd-config-reload.js +133 -0
  492. package/hooks/gsd-context-monitor.js +195 -0
  493. package/hooks/gsd-cursor-post-tool.js +75 -0
  494. package/hooks/gsd-cursor-session-start.js +52 -0
  495. package/hooks/gsd-graphify-update.sh +158 -0
  496. package/hooks/gsd-phase-boundary.sh +47 -0
  497. package/hooks/gsd-prompt-guard.js +97 -0
  498. package/hooks/gsd-read-guard.js +101 -0
  499. package/hooks/gsd-read-injection-scanner.js +203 -0
  500. package/hooks/gsd-session-state.sh +59 -0
  501. package/hooks/gsd-statusline.js +566 -0
  502. package/hooks/gsd-update-banner.js +138 -0
  503. package/hooks/gsd-validate-commit.sh +57 -0
  504. package/hooks/gsd-workflow-guard.js +167 -0
  505. package/hooks/gsd-worktree-path-guard.js +169 -0
  506. package/hooks/hooks.json +69 -0
  507. package/hooks/lib/git-cmd.js +150 -0
  508. package/hooks/lib/gsd-graphify-rebuild.sh +65 -0
  509. package/hooks/managed-hooks-registry.cjs +38 -0
  510. package/package.json +115 -0
  511. package/scripts/affected-tests-lib.cjs +542 -0
  512. package/scripts/audit-workflow-script-paths.cjs +73 -0
  513. package/scripts/base64-scan.sh +351 -0
  514. package/scripts/build-hooks.js +247 -0
  515. package/scripts/changeset/README.md +129 -0
  516. package/scripts/changeset/cli.cjs +590 -0
  517. package/scripts/changeset/github-release-notes.cjs +199 -0
  518. package/scripts/changeset/lint.cjs +111 -0
  519. package/scripts/changeset/new.cjs +137 -0
  520. package/scripts/changeset/parse.cjs +114 -0
  521. package/scripts/changeset/render.cjs +34 -0
  522. package/scripts/changeset/serialize.cjs +130 -0
  523. package/scripts/check-alias-drift.cjs +114 -0
  524. package/scripts/check-env.cjs +312 -0
  525. package/scripts/check-npm-integrity.cjs +215 -0
  526. package/scripts/ci-guard-runner.cjs +22 -0
  527. package/scripts/ci-prepare-test-scope.cjs +51 -0
  528. package/scripts/ci-rebase-check.cjs +86 -0
  529. package/scripts/ci-test-scope.cjs +431 -0
  530. package/scripts/command-contract-helpers.cjs +64 -0
  531. package/scripts/diff-touches-shipped-paths.cjs +155 -0
  532. package/scripts/fix-slash-commands.cjs +147 -0
  533. package/scripts/gen-inventory-manifest.cjs +115 -0
  534. package/scripts/gen-research-agents.cjs +276 -0
  535. package/scripts/generate-package-identity.cjs +125 -0
  536. package/scripts/issue-dedupe.cjs +278 -0
  537. package/scripts/lib/allowlist-ratchet.cjs +136 -0
  538. package/scripts/lib/cli-exit.cjs +56 -0
  539. package/scripts/lint-command-contract.cjs +114 -0
  540. package/scripts/lint-descriptions.cjs +87 -0
  541. package/scripts/lint-docs-required.cjs +222 -0
  542. package/scripts/lint-legacy-dir-name.cjs +160 -0
  543. package/scripts/lint-package-identity-drift.cjs +141 -0
  544. package/scripts/lint-pr-check-project-dir.cjs +99 -0
  545. package/scripts/lint-shell-command-projection-drift.cjs +62 -0
  546. package/scripts/lint-skill-deps.cjs +185 -0
  547. package/scripts/lint-test-file-count.allowlist.json +135 -0
  548. package/scripts/lint-test-file-count.cjs +246 -0
  549. package/scripts/mutation-matrix.cjs +222 -0
  550. package/scripts/pr-template-policy.cjs +268 -0
  551. package/scripts/prompt-injection-scan.sh +207 -0
  552. package/scripts/release-notes/discord-release-summary.cjs +373 -0
  553. package/scripts/release-notes/format-github-release-notes.cjs +261 -0
  554. package/scripts/release-tarball-smoke.cjs +629 -0
  555. package/scripts/research-profiles.cjs +149 -0
  556. package/scripts/run-affected-tests.cjs +7 -0
  557. package/scripts/run-cross-platform-tests.cjs +67 -0
  558. package/scripts/run-tests.cjs +315 -0
  559. package/scripts/secret-scan-lint.sh +231 -0
  560. package/scripts/secret-scan.sh +358 -0
  561. package/scripts/setup-branch-protection.sh +236 -0
  562. package/scripts/strip-prose-atrefs.cjs +106 -0
  563. package/scripts/sync-manifest-versions.cjs +119 -0
  564. package/scripts/sync-rulesets.sh +34 -0
  565. package/scripts/sync-runtime-launcher.cjs +399 -0
  566. package/scripts/test-failure-reasons.cjs +34 -0
  567. package/scripts/verify-npm-publish.cjs +240 -0
  568. package/scripts/workflow-policy.cjs +450 -0
@@ -0,0 +1,449 @@
1
+ "use strict";
2
+ /**
3
+ * Runtime surface module — ADR-0011 Phase 2 (Option B).
4
+ *
5
+ * Manages the runtime enable/disable surface state (the `.gsd-surface.json` marker in
6
+ * each runtime's config dir root (e.g., ~/.claude)) independently of the install-time profile marker
7
+ * (`.gsd-profile`). Runtime config locations are resolved by callers.
8
+ *
9
+ * Effective skill set = base profile ∪ explicitAdds − disabledClusters − explicitRemoves,
10
+ * then transitively closed via the manifest.
11
+ *
12
+ * Exports:
13
+ * readSurface(runtimeConfigDir)
14
+ * writeSurface(runtimeConfigDir, surfaceState)
15
+ * resolveSurface(runtimeConfigDir, manifest, clusterMap)
16
+ * applySurface(runtimeConfigDir, layout, manifest, clusterMap)
17
+ * listSurface(runtimeConfigDir, manifest, clusterMap)
18
+ * pruneSkillDirs(skillsDir, retainedNames, prefix, manifest)
19
+ *
20
+ * ADR-457 build-at-publish: the hand-written bin/lib/surface.cjs collapsed
21
+ * to a TypeScript source of truth. Behaviour is preserved byte-for-behaviour
22
+ * from the prior hand-written .cjs; only types are added.
23
+ */
24
+ var __importDefault = (this && this.__importDefault) || function (mod) {
25
+ return (mod && mod.__esModule) ? mod : { "default": mod };
26
+ };
27
+ const node_fs_1 = __importDefault(require("node:fs"));
28
+ const node_path_1 = __importDefault(require("node:path"));
29
+ const node_os_1 = __importDefault(require("node:os"));
30
+ const shell_command_projection_cjs_1 = require("./shell-command-projection.cjs");
31
+ // eslint-disable-next-line @typescript-eslint/no-require-imports
32
+ const installProfiles = require("./install-profiles.cjs");
33
+ const { readActiveProfile, resolveProfile, loadSkillsManifest, } = installProfiles;
34
+ const clusters_cjs_1 = require("./clusters.cjs");
35
+ // eslint-disable-next-line @typescript-eslint/no-require-imports
36
+ const runtimeArtifactLayout = require("./runtime-artifact-layout.cjs");
37
+ const { findInstallSourceRoot, getInstallExports } = runtimeArtifactLayout;
38
+ const SURFACE_FILE_NAME = '.gsd-surface.json';
39
+ /**
40
+ * Read the surface state from a runtime config directory.
41
+ *
42
+ * @param runtimeConfigDir
43
+ * @returns null if file missing or corrupt
44
+ */
45
+ function readSurface(runtimeConfigDir) {
46
+ const filePath = node_path_1.default.join(runtimeConfigDir, SURFACE_FILE_NAME);
47
+ try {
48
+ const raw = node_fs_1.default.readFileSync(filePath, 'utf8');
49
+ const parsed = JSON.parse(raw);
50
+ // Structural validation — must have these fields with expected types
51
+ if (typeof parsed !== 'object' || parsed === null)
52
+ return null;
53
+ const p = parsed;
54
+ if (typeof p['baseProfile'] !== 'string')
55
+ return null;
56
+ if (!Array.isArray(p['disabledClusters']))
57
+ return null;
58
+ if (!Array.isArray(p['explicitAdds']))
59
+ return null;
60
+ if (!Array.isArray(p['explicitRemoves']))
61
+ return null;
62
+ return {
63
+ baseProfile: p['baseProfile'],
64
+ disabledClusters: p['disabledClusters'],
65
+ explicitAdds: p['explicitAdds'],
66
+ explicitRemoves: p['explicitRemoves'],
67
+ };
68
+ }
69
+ catch {
70
+ return null;
71
+ }
72
+ }
73
+ /**
74
+ * Write the surface state atomically via the platform seam (mkdir + tmp+rename).
75
+ */
76
+ function writeSurface(runtimeConfigDir, surfaceState) {
77
+ (0, shell_command_projection_cjs_1.platformWriteSync)(node_path_1.default.join(runtimeConfigDir, SURFACE_FILE_NAME), JSON.stringify(surfaceState, null, 2) + '\n');
78
+ }
79
+ // ---------------------------------------------------------------------------
80
+ // Resolution
81
+ // ---------------------------------------------------------------------------
82
+ /**
83
+ * Expand cluster names to skill stems using the provided clusterMap.
84
+ */
85
+ function clustersToSkills(clusterNames, clusterMap) {
86
+ const result = new Set();
87
+ for (const name of clusterNames) {
88
+ const members = clusterMap[name];
89
+ if (members) {
90
+ for (const s of members)
91
+ result.add(s);
92
+ }
93
+ }
94
+ return result;
95
+ }
96
+ /**
97
+ * Normalize manifest inputs to the skill-dependency Map shape expected by
98
+ * resolveProfile/computeClosure.
99
+ *
100
+ * Supports:
101
+ * - canonical Map<string, string[]>
102
+ * - legacy plain object map: { [stem]: string[] }
103
+ * - parsed gsd-file-manifest.json object ({ files: { ... } }) by rebuilding
104
+ * the dependency manifest from the install source tree
105
+ */
106
+ function normalizeSkillManifest(runtimeConfigDir, manifest) {
107
+ if (manifest instanceof Map) {
108
+ return manifest;
109
+ }
110
+ if (!manifest || typeof manifest !== 'object') {
111
+ return new Map();
112
+ }
113
+ // Legacy/ad-hoc object map: stem -> requires[]
114
+ const arrayEntries = Object.entries(manifest).filter(([, value]) => Array.isArray(value));
115
+ if (arrayEntries.length > 0) {
116
+ return new Map(arrayEntries.map(([stem, deps]) => [stem, deps]));
117
+ }
118
+ // Parsed gsd-file-manifest.json shape: rebuild the dependency map from source.
119
+ const manifestObj = manifest;
120
+ if (manifestObj['files'] && typeof manifestObj['files'] === 'object') {
121
+ const srcCommandsDir = findInstallSourceRoot(runtimeConfigDir);
122
+ return loadSkillsManifest(srcCommandsDir);
123
+ }
124
+ return new Map();
125
+ }
126
+ /**
127
+ * Resolve the effective surface to a typed profile-like object.
128
+ * Shape: { name, skills: Set<string>|'*', agents: Set<string> }
129
+ *
130
+ * Resolution order:
131
+ * 1. Start with base profile resolved via resolveProfile()
132
+ * 2. Remove skills in disabled clusters
133
+ * 3. Add explicitAdds (and their transitive closure)
134
+ * 4. Remove explicitRemoves (only the stem itself, no cascade)
135
+ */
136
+ function resolveSurface(runtimeConfigDir, manifest, clusterMap) {
137
+ const cm = clusterMap || clusters_cjs_1.CLUSTERS;
138
+ const skillManifest = normalizeSkillManifest(runtimeConfigDir, manifest);
139
+ const surface = readSurface(runtimeConfigDir);
140
+ // Determine base profile name: from surface state or from .gsd-profile marker
141
+ const baseProfileName = (surface && surface.baseProfile)
142
+ ? surface.baseProfile
143
+ : (readActiveProfile(runtimeConfigDir) || 'full');
144
+ // Resolve base profile
145
+ const baseResolved = resolveProfile({
146
+ modes: baseProfileName.split(',').map((s) => s.trim()),
147
+ manifest: skillManifest,
148
+ });
149
+ // If full, we need to enumerate all skills from the manifest
150
+ let skills;
151
+ if (baseResolved.skills === '*') {
152
+ // Materialize all skill stems from manifest
153
+ skills = new Set();
154
+ for (const [key] of skillManifest) {
155
+ if (!key.startsWith('_calls_agents_'))
156
+ skills.add(key);
157
+ }
158
+ }
159
+ else {
160
+ skills = new Set(baseResolved.skills);
161
+ }
162
+ if (surface) {
163
+ // Step 2: remove disabled cluster members
164
+ const disabledSkills = clustersToSkills(surface.disabledClusters, cm);
165
+ for (const s of disabledSkills)
166
+ skills.delete(s);
167
+ // Step 3: add explicitAdds with transitive closure
168
+ if (surface.explicitAdds.length > 0) {
169
+ const addSet = new Set(surface.explicitAdds);
170
+ // Compute closure of adds
171
+ const queue = [...addSet];
172
+ const visited = new Set(addSet);
173
+ while (queue.length > 0) {
174
+ const stem = queue.pop();
175
+ const deps = skillManifest.get(stem) || [];
176
+ for (const dep of deps) {
177
+ if (!visited.has(dep)) {
178
+ visited.add(dep);
179
+ queue.push(dep);
180
+ }
181
+ }
182
+ }
183
+ for (const s of visited)
184
+ skills.add(s);
185
+ }
186
+ // Step 4: remove explicitRemoves (stem only, no cascade)
187
+ for (const s of surface.explicitRemoves) {
188
+ skills.delete(s);
189
+ }
190
+ }
191
+ // Derive agents from skills
192
+ const agents = new Set();
193
+ for (const skillStem of skills) {
194
+ const agentRefs = skillManifest.get(`_calls_agents_${skillStem}`) || [];
195
+ for (const agentStem of agentRefs)
196
+ agents.add(agentStem);
197
+ }
198
+ const name = surface ? `surface:${surface.baseProfile}` : `profile:${baseProfileName}`;
199
+ return { name, skills, agents };
200
+ }
201
+ // ---------------------------------------------------------------------------
202
+ // Apply
203
+ // ---------------------------------------------------------------------------
204
+ /**
205
+ * Re-stage the active surface using the resolved layout.
206
+ * Iterates layout.kinds and syncs each artifact kind to its destination.
207
+ */
208
+ function applySurface(runtimeConfigDir, layout, manifest, clusterMap) {
209
+ if (node_path_1.default.resolve(runtimeConfigDir) !== node_path_1.default.resolve(layout.configDir)) {
210
+ throw new TypeError('applySurface runtimeConfigDir must match layout.configDir');
211
+ }
212
+ const skillManifest = normalizeSkillManifest(layout.configDir, manifest);
213
+ const resolved = resolveSurface(layout.configDir, skillManifest, clusterMap);
214
+ // Mirror installRuntimeArtifacts: skills kinds get per-runtime path rewrites
215
+ // so SKILL.md bodies reference the install target (pathPrefix), not the
216
+ // converter's default ~/.claude paths (#813). Computed lazily so command-only
217
+ // runtimes do not trigger the install.js require.
218
+ let pathPrefix = null;
219
+ for (const kind of layout.kinds) {
220
+ const staged = kind.stage(resolved);
221
+ if (kind.kind === 'skills') {
222
+ const installExports = getInstallExports();
223
+ if (pathPrefix === null) {
224
+ const scope = layout.scope ?? 'global';
225
+ const resolvedTarget = node_path_1.default.resolve(layout.configDir).replace(/\\/g, '/');
226
+ const homeDir = node_os_1.default.homedir().replace(/\\/g, '/');
227
+ pathPrefix = installExports.computePathPrefix({
228
+ isGlobal: scope === 'global',
229
+ isOpencode: layout.runtime === 'opencode',
230
+ isWindowsHost: process.platform === 'win32',
231
+ resolvedTarget,
232
+ homeDir,
233
+ });
234
+ }
235
+ installExports.applyRuntimeContentRewritesInPlace(staged, layout.runtime, pathPrefix);
236
+ }
237
+ const dest = node_path_1.default.join(layout.configDir, kind.destSubpath);
238
+ _syncGsdDir(staged, dest, kind, skillManifest);
239
+ }
240
+ return resolved;
241
+ }
242
+ /**
243
+ * Prune GSD-managed skill directories from a skills directory.
244
+ *
245
+ * Removes every directory in `skillsDir` that is GSD-owned but NOT listed
246
+ * in `retainedNames`. User-owned dirs (not matching the GSD ownership criteria)
247
+ * are always preserved.
248
+ *
249
+ * Ownership criteria:
250
+ * - Non-empty prefix (e.g. 'gsd-'): dir name starts with that prefix AND
251
+ * appears in the manifest (manifest membership is required). Dirs that match
252
+ * the prefix but are NOT in the manifest are treated as user-owned and
253
+ * preserved — this prevents data loss for user-created gsd-* directories.
254
+ * A warning is written to stderr when such a dir is encountered.
255
+ * - Empty prefix (Hermes): dir name appears as a canonical skill stem in the
256
+ * manifest. User dirs not in the manifest are preserved.
257
+ * - Empty prefix without manifest, or manifest not a Map: conservative; no
258
+ * dirs are removed.
259
+ *
260
+ * This is the single point of truth for skill-dir pruning. Both _syncGsdDir
261
+ * (surface apply) and callers that need stand-alone pruning use this function.
262
+ *
263
+ * @param skillsDir directory that contains the gsd-STEM sub-dirs
264
+ * @param retainedNames set of directory names to keep (e.g. 'gsd-help')
265
+ * @param prefix GSD dir prefix, e.g. 'gsd-' (or '' for Hermes)
266
+ * @param manifest optional; required for Hermes empty-prefix case
267
+ * and for manifest-membership gate in prefixed case.
268
+ * Must be a Map; any other type is treated as missing.
269
+ */
270
+ function pruneSkillDirs(skillsDir, retainedNames, prefix, manifest) {
271
+ if (!node_fs_1.default.existsSync(skillsDir))
272
+ return;
273
+ // Finding 2: guard against callers passing a truthy non-Map as manifest.
274
+ // A non-Map manifest would throw on .keys(); treat it as absent and be conservative.
275
+ const safeManifest = (manifest instanceof Map) ? manifest : null;
276
+ // Build the canonical stem set from the manifest (used for both prefixed and Hermes paths).
277
+ // Deletion requires manifest membership — without a valid manifest, be conservative.
278
+ const canonicalStems = safeManifest
279
+ ? new Set([...safeManifest.keys()].filter(k => !k.startsWith('_calls_agents_')))
280
+ : null;
281
+ for (const entry of node_fs_1.default.readdirSync(skillsDir)) {
282
+ const entryPath = node_path_1.default.join(skillsDir, entry);
283
+ if (!node_fs_1.default.statSync(entryPath).isDirectory())
284
+ continue;
285
+ let isGsdOwned;
286
+ if (prefix !== '') {
287
+ if (!entry.startsWith(prefix)) {
288
+ // Does not match prefix at all — user-owned, preserve.
289
+ continue;
290
+ }
291
+ if (!canonicalStems) {
292
+ // No manifest available: cannot confirm ownership — preserve conservatively.
293
+ continue;
294
+ }
295
+ // Finding 1 fix: prefix match is necessary but NOT sufficient.
296
+ // The dir must also be in the manifest to be considered GSD-owned.
297
+ // A user-created gsd-* dir that isn't in the manifest is preserved with a warning.
298
+ if (!canonicalStems.has(entry.slice(prefix.length))) {
299
+ process.stderr.write(`[gsd] Warning: ${entry} matches GSD prefix '${prefix}' but is not in the manifest — preserving (user-owned or unknown)\n`);
300
+ continue;
301
+ }
302
+ isGsdOwned = true;
303
+ }
304
+ else if (canonicalStems) {
305
+ // Hermes: GSD-owned iff the directory name appears in the canonical manifest.
306
+ isGsdOwned = canonicalStems.has(entry);
307
+ }
308
+ else {
309
+ // No manifest available: be conservative, don't remove anything.
310
+ continue;
311
+ }
312
+ if (!isGsdOwned)
313
+ continue; // Hermes path only: preserve user-owned dirs not in manifest
314
+ if (retainedNames.has(entry))
315
+ continue; // GSD-owned and in retain set
316
+ try {
317
+ node_fs_1.default.rmSync(entryPath, { recursive: true, force: true });
318
+ }
319
+ catch (err) {
320
+ process.stderr.write(`surface: failed to prune ${entryPath}: ${err.message}\n`);
321
+ }
322
+ }
323
+ }
324
+ /**
325
+ * Sync destination directory from staged source.
326
+ *
327
+ * For 'commands' kind: iterate *.md files in destDir, remove if not in staged set.
328
+ * For 'agents' kind: same, but only remove files starting with 'gsd-' prefix.
329
+ * For 'skills' kind: iterate directories in destDir matching kind.prefix; add missing
330
+ * by copying recursively; remove dirs not in staged set. Preserves dirs not matching
331
+ * the prefix (user-owned skills). Pruning is delegated to pruneSkillDirs().
332
+ *
333
+ * For Hermes (empty prefix): uses manifest membership to discriminate GSD-owned vs
334
+ * user-owned dirs. GSD-owned = stem in manifest; removal targets = in manifest AND
335
+ * not in staged set. User-owned (not in manifest) are always preserved.
336
+ */
337
+ function _syncGsdDir(stagedDir, destDir, kind, manifest) {
338
+ if (!node_fs_1.default.existsSync(stagedDir))
339
+ return;
340
+ node_fs_1.default.mkdirSync(destDir, { recursive: true });
341
+ // Normalize: allow legacy string context for backward-compat with internal callers
342
+ const kindName = (typeof kind === 'string') ? kind : kind.kind;
343
+ const kindPrefix = (typeof kind === 'object' && kind !== null) ? kind.prefix : 'gsd-';
344
+ if (kindName === 'skills') {
345
+ // Skills kind: work with directories, not files.
346
+ // Each staged entry is a directory named ${prefix}${stem}.
347
+ const stagedDirs = new Set(node_fs_1.default.readdirSync(stagedDir).filter(entry => {
348
+ return node_fs_1.default.statSync(node_path_1.default.join(stagedDir, entry)).isDirectory();
349
+ }));
350
+ // Copy missing dirs from staged to dest (always overwrite to ensure content is current)
351
+ for (const dirName of stagedDirs) {
352
+ const destSubDir = node_path_1.default.join(destDir, dirName);
353
+ node_fs_1.default.cpSync(node_path_1.default.join(stagedDir, dirName), destSubDir, { recursive: true });
354
+ }
355
+ // Prune GSD-owned dirs that are no longer in the staged set.
356
+ // pruneSkillDirs() is the single point of truth for this logic.
357
+ pruneSkillDirs(destDir, stagedDirs, kindPrefix, manifest);
358
+ }
359
+ else {
360
+ // commands / agents kind: mirror installRuntimeArtifacts (_copyStaged /
361
+ // _removeGsdEntries in bin/install.js) so surface produces the SAME files as a
362
+ // fresh install (#816). Flat command dirs (opencode/cursor/augment/kilo) take
363
+ // the gsd- prefix on copy; namespaced command dirs (commands/gsd) and agents
364
+ // keep their staged names. Copying staged names verbatim previously diverged
365
+ // from install and orphaned the installed gsd-*.md files, and the unscoped
366
+ // prune deleted user-owned command files.
367
+ //
368
+ // NOTE: the destName rule below intentionally mirrors bin/install.js
369
+ // `_copyStaged` (the `namespacedByDir` decision). Keep them in sync.
370
+ const destLast = (typeof kind === 'object' && kind !== null && kind.destSubpath)
371
+ ? node_path_1.default.basename(kind.destSubpath)
372
+ : '';
373
+ const prefixStem = kindPrefix ? kindPrefix.replace(/-$/, '') : '';
374
+ const namespacedByDir = kindName === 'commands' && destLast === prefixStem;
375
+ const stagedFiles = node_fs_1.default.readdirSync(stagedDir).filter(f => f.endsWith('.md'));
376
+ const stagedDestNames = new Set();
377
+ for (const file of stagedFiles) {
378
+ const destName = (kindName === 'agents' || namespacedByDir)
379
+ ? file
380
+ : `${kindPrefix}${file.slice(0, -3)}.md`;
381
+ node_fs_1.default.copyFileSync(node_path_1.default.join(stagedDir, file), node_path_1.default.join(destDir, destName));
382
+ stagedDestNames.add(destName);
383
+ }
384
+ // Prune stale GSD-owned files not in the staged set, preserving user-owned files
385
+ // (mirrors install's prefix-scoped _removeGsdEntries):
386
+ // - agents: only gsd-* are GSD-owned
387
+ // - flat command dirs: only `${kindPrefix}`-prefixed are GSD-owned
388
+ // - namespaced command dirs: the whole dir is GSD-owned
389
+ for (const file of node_fs_1.default.readdirSync(destDir).filter(f => f.endsWith('.md'))) {
390
+ if (kindName === 'agents' && !file.startsWith('gsd-'))
391
+ continue;
392
+ if (kindName === 'commands' && !namespacedByDir && kindPrefix && !file.startsWith(kindPrefix))
393
+ continue;
394
+ if (!stagedDestNames.has(file)) {
395
+ try {
396
+ node_fs_1.default.unlinkSync(node_path_1.default.join(destDir, file));
397
+ }
398
+ catch { /* ignore */ }
399
+ }
400
+ }
401
+ }
402
+ }
403
+ // ---------------------------------------------------------------------------
404
+ // List
405
+ // ---------------------------------------------------------------------------
406
+ /**
407
+ * List the currently enabled and disabled skills with token cost.
408
+ *
409
+ * Token cost = sum of description lengths ÷ 4 (mirrors audit script).
410
+ * Descriptions are read from the install source (findInstallSourceRoot).
411
+ */
412
+ function listSurface(runtimeConfigDir, manifest, clusterMap) {
413
+ const skillManifest = normalizeSkillManifest(runtimeConfigDir, manifest);
414
+ const resolved = resolveSurface(runtimeConfigDir, skillManifest, clusterMap);
415
+ // All known stems from manifest (exclude _calls_agents_ meta keys)
416
+ const allStems = [];
417
+ for (const [key] of skillManifest) {
418
+ if (!key.startsWith('_calls_agents_'))
419
+ allStems.push(key);
420
+ }
421
+ const enabledSet = resolved.skills instanceof Set ? resolved.skills : new Set(allStems);
422
+ const enabled = allStems.filter(s => enabledSet.has(s)).sort();
423
+ const disabled = allStems.filter(s => !enabledSet.has(s)).sort();
424
+ // Compute token cost by reading descriptions from the install source
425
+ const srcCommandsDir = findInstallSourceRoot(runtimeConfigDir);
426
+ let tokenCost = 0;
427
+ for (const stem of enabled) {
428
+ const filePath = node_path_1.default.join(srcCommandsDir, `${stem}.md`);
429
+ try {
430
+ const content = node_fs_1.default.readFileSync(filePath, 'utf8');
431
+ const descMatch = content.match(/^description:\s*(.+)$/m);
432
+ if (descMatch) {
433
+ tokenCost += Math.ceil(descMatch[1].trim().length / 4);
434
+ }
435
+ }
436
+ catch { /* ignore */ }
437
+ }
438
+ return { enabled, disabled, tokenCost };
439
+ }
440
+ module.exports = {
441
+ readSurface,
442
+ writeSurface,
443
+ resolveSurface,
444
+ applySurface,
445
+ listSurface,
446
+ // Exported for testing and for callers that need stand-alone pruning
447
+ pruneSkillDirs,
448
+ _syncGsdDir,
449
+ };
@@ -0,0 +1,85 @@
1
+ "use strict";
2
+ /**
3
+ * Task command router — is-behavior-adding subcommand handler.
4
+ *
5
+ * ADR-457 build-at-publish: the hand-written bin/lib/task-command-router.cjs
6
+ * collapsed to a TypeScript source of truth. Behaviour is preserved byte-for-behaviour
7
+ * from the prior hand-written .cjs; only types are added.
8
+ */
9
+ var __importDefault = (this && this.__importDefault) || function (mod) {
10
+ return (mod && mod.__esModule) ? mod : { "default": mod };
11
+ };
12
+ const node_fs_1 = __importDefault(require("node:fs"));
13
+ const node_path_1 = __importDefault(require("node:path"));
14
+ // eslint-disable-next-line @typescript-eslint/no-require-imports
15
+ const core = require("./core.cjs");
16
+ const { output, error, ERROR_REASON } = core;
17
+ // ─── Implementation ───────────────────────────────────────────────────────────
18
+ function isBehaviorAddingTaskContent(content) {
19
+ const tddTrue = /\btdd\s*=\s*["']true["']/i.test(content);
20
+ const behaviorMatch = content.match(/<behavior>([\s\S]*?)<\/behavior>/i);
21
+ const hasBehaviorBlock = Boolean(behaviorMatch && behaviorMatch[1].trim().length > 0);
22
+ const filesMatch = content.match(/<files>([\s\S]*?)<\/files>/i);
23
+ let hasSourceFiles = false;
24
+ if (filesMatch) {
25
+ const fileLines = filesMatch[1]
26
+ .split(/[\n,]/)
27
+ .map((line) => line.trim().replace(/^[-*]\s*/, ''))
28
+ .filter(Boolean);
29
+ hasSourceFiles = fileLines.some((file) => !/\.md$/i.test(file) &&
30
+ !/\.json$/i.test(file) &&
31
+ !/\.test\.[^.]+$/i.test(file) &&
32
+ !/\.spec\.[^.]+$/i.test(file) &&
33
+ !/(^|[\\/])tests?[\\/]/i.test(file) &&
34
+ !/\.(yml|yaml|toml|ini|cfg|conf|properties)$/i.test(file) &&
35
+ !/(^|[\\/])\.env(\..+)?$/i.test(file));
36
+ }
37
+ const isBehaviorAdding = tddTrue && hasBehaviorBlock && hasSourceFiles;
38
+ const missing = [];
39
+ if (!tddTrue)
40
+ missing.push('tdd="true" frontmatter absent');
41
+ if (!hasBehaviorBlock)
42
+ missing.push('<behavior> block missing or empty');
43
+ if (!hasSourceFiles)
44
+ missing.push('<files> has no non-test source file');
45
+ return {
46
+ is_behavior_adding: isBehaviorAdding,
47
+ checks: {
48
+ tdd_true: tddTrue,
49
+ has_behavior_block: hasBehaviorBlock,
50
+ has_source_files: hasSourceFiles,
51
+ },
52
+ reason: isBehaviorAdding ? null : `Not behavior-adding: ${missing.join('; ')}`,
53
+ };
54
+ }
55
+ function routeTaskCommand({ args, cwd, raw }) {
56
+ const subcommand = args[1];
57
+ if (subcommand !== 'is-behavior-adding') {
58
+ error('Unknown task subcommand. Available: is-behavior-adding', ERROR_REASON.SDK_UNKNOWN_COMMAND);
59
+ }
60
+ let content = null;
61
+ if (args[2] === '--task-content') {
62
+ content = args[3] || null;
63
+ }
64
+ else if (args[2]) {
65
+ const projectRoot = node_path_1.default.resolve(cwd || process.cwd());
66
+ const requestedPath = args[2];
67
+ const resolvedTaskPath = node_path_1.default.resolve(projectRoot, requestedPath);
68
+ const rel = node_path_1.default.relative(projectRoot, resolvedTaskPath);
69
+ if (rel === '..' || rel.startsWith(`..${node_path_1.default.sep}`)) {
70
+ error(`Task file is outside project scope: ${requestedPath}`, ERROR_REASON.USAGE);
71
+ }
72
+ if (!node_fs_1.default.existsSync(resolvedTaskPath)) {
73
+ error(`Task file not found: ${requestedPath}`, ERROR_REASON.USAGE);
74
+ }
75
+ content = node_fs_1.default.readFileSync(resolvedTaskPath, 'utf-8');
76
+ }
77
+ if (!content) {
78
+ error('Usage: task.is-behavior-adding <plan-file-path> | --task-content "<xml>"', ERROR_REASON.USAGE);
79
+ }
80
+ output(isBehaviorAddingTaskContent(content), raw, undefined);
81
+ }
82
+ module.exports = {
83
+ isBehaviorAddingTaskContent,
84
+ routeTaskCommand,
85
+ };