@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.
- package/.claude-plugin/plugin.json +23 -0
- package/GEMINI.md +53 -0
- package/LICENSE +21 -0
- package/README.ja-JP.md +125 -0
- package/README.ko-KR.md +125 -0
- package/README.md +144 -0
- package/README.pt-BR.md +125 -0
- package/README.zh-CN.md +125 -0
- package/agents/gsd-advisor-researcher.md +108 -0
- package/agents/gsd-ai-researcher.md +114 -0
- package/agents/gsd-assumptions-analyzer.md +105 -0
- package/agents/gsd-code-fixer.md +668 -0
- package/agents/gsd-code-reviewer.md +387 -0
- package/agents/gsd-codebase-mapper.md +853 -0
- package/agents/gsd-debug-session-manager.md +314 -0
- package/agents/gsd-debugger.md +1452 -0
- package/agents/gsd-doc-classifier.md +168 -0
- package/agents/gsd-doc-synthesizer.md +204 -0
- package/agents/gsd-doc-verifier.md +217 -0
- package/agents/gsd-doc-writer.md +616 -0
- package/agents/gsd-domain-researcher.md +147 -0
- package/agents/gsd-eval-auditor.md +191 -0
- package/agents/gsd-eval-planner.md +154 -0
- package/agents/gsd-executor.md +785 -0
- package/agents/gsd-framework-selector.md +160 -0
- package/agents/gsd-integration-checker.md +470 -0
- package/agents/gsd-intel-updater.md +342 -0
- package/agents/gsd-nyquist-auditor.md +203 -0
- package/agents/gsd-pattern-mapper.md +335 -0
- package/agents/gsd-phase-researcher.md +867 -0
- package/agents/gsd-plan-checker.md +978 -0
- package/agents/gsd-planner.md +1204 -0
- package/agents/gsd-project-researcher.md +611 -0
- package/agents/gsd-research-synthesizer.md +259 -0
- package/agents/gsd-roadmapper.md +688 -0
- package/agents/gsd-security-auditor.md +155 -0
- package/agents/gsd-ui-auditor.md +495 -0
- package/agents/gsd-ui-checker.md +309 -0
- package/agents/gsd-ui-researcher.md +374 -0
- package/agents/gsd-user-profiler.md +171 -0
- package/agents/gsd-verifier.md +923 -0
- package/assets/gsd-logo-2000-transparent.png +0 -0
- package/assets/gsd-logo-2000-transparent.svg +17 -0
- package/assets/gsd-logo-2000.png +0 -0
- package/assets/gsd-logo-2000.svg +21 -0
- package/assets/terminal.svg +68 -0
- package/bin/install.js +12726 -0
- package/bin/lib/ui-safety-gate.cjs +107 -0
- package/commands/gsd/add-tests.md +42 -0
- package/commands/gsd/ai-integration-phase.md +37 -0
- package/commands/gsd/audit-fix.md +34 -0
- package/commands/gsd/audit-milestone.md +37 -0
- package/commands/gsd/audit-uat.md +24 -0
- package/commands/gsd/autonomous.md +48 -0
- package/commands/gsd/capture.md +62 -0
- package/commands/gsd/cleanup.md +24 -0
- package/commands/gsd/code-review.md +59 -0
- package/commands/gsd/complete-milestone.md +143 -0
- package/commands/gsd/config.md +56 -0
- package/commands/gsd/debug.md +52 -0
- package/commands/gsd/discover-product.md +65 -0
- package/commands/gsd/discuss-phase.md +77 -0
- package/commands/gsd/docs-update.md +49 -0
- package/commands/gsd/eval-review.md +33 -0
- package/commands/gsd/execute-phase.md +66 -0
- package/commands/gsd/explore.md +27 -0
- package/commands/gsd/extract-learnings.md +23 -0
- package/commands/gsd/fast.md +31 -0
- package/commands/gsd/forensics.md +57 -0
- package/commands/gsd/graphify.md +204 -0
- package/commands/gsd/health.md +31 -0
- package/commands/gsd/help.md +28 -0
- package/commands/gsd/import.md +45 -0
- package/commands/gsd/inbox.md +39 -0
- package/commands/gsd/ingest-docs.md +42 -0
- package/commands/gsd/manager.md +45 -0
- package/commands/gsd/map-codebase.md +83 -0
- package/commands/gsd/milestone-summary.md +51 -0
- package/commands/gsd/model-domain.md +65 -0
- package/commands/gsd/mvp-phase.md +45 -0
- package/commands/gsd/new-milestone.md +45 -0
- package/commands/gsd/new-project.md +47 -0
- package/commands/gsd/ns-context.md +23 -0
- package/commands/gsd/ns-ideate.md +24 -0
- package/commands/gsd/ns-manage.md +29 -0
- package/commands/gsd/ns-project.md +22 -0
- package/commands/gsd/ns-review.md +26 -0
- package/commands/gsd/ns-workflow.md +28 -0
- package/commands/gsd/pause-work.md +43 -0
- package/commands/gsd/phase.md +56 -0
- package/commands/gsd/plan-phase.md +64 -0
- package/commands/gsd/plan-review-convergence.md +59 -0
- package/commands/gsd/pr-branch.md +26 -0
- package/commands/gsd/profile-user.md +46 -0
- package/commands/gsd/progress.md +48 -0
- package/commands/gsd/quick.md +174 -0
- package/commands/gsd/recommend-architecture.md +64 -0
- package/commands/gsd/resume-work.md +30 -0
- package/commands/gsd/review-backlog.md +63 -0
- package/commands/gsd/review.md +42 -0
- package/commands/gsd/secure-phase.md +36 -0
- package/commands/gsd/settings.md +29 -0
- package/commands/gsd/ship.md +24 -0
- package/commands/gsd/sketch.md +60 -0
- package/commands/gsd/spec-phase.md +63 -0
- package/commands/gsd/spike.md +57 -0
- package/commands/gsd/stats.md +20 -0
- package/commands/gsd/surface.md +155 -0
- package/commands/gsd/testing-strategy.md +65 -0
- package/commands/gsd/thread.md +24 -0
- package/commands/gsd/ui-phase.md +35 -0
- package/commands/gsd/ui-review.md +33 -0
- package/commands/gsd/ultraplan-phase.md +34 -0
- package/commands/gsd/undo.md +35 -0
- package/commands/gsd/update.md +49 -0
- package/commands/gsd/validate-phase.md +36 -0
- package/commands/gsd/verify-work.md +39 -0
- package/commands/gsd/workspace.md +52 -0
- package/commands/gsd/workstreams.md +70 -0
- package/gemini-extension.json +6 -0
- package/gsd-core/bin/check-latest-version.cjs +161 -0
- package/gsd-core/bin/gsd-tools.cjs +1928 -0
- package/gsd-core/bin/lib/active-workstream-store.cjs +291 -0
- package/gsd-core/bin/lib/adr-parser.cjs +399 -0
- package/gsd-core/bin/lib/agent-command-router.cjs +68 -0
- package/gsd-core/bin/lib/artifacts.cjs +51 -0
- package/gsd-core/bin/lib/audit.cjs +743 -0
- package/gsd-core/bin/lib/check-command-router.cjs +343 -0
- package/gsd-core/bin/lib/cjs-command-router-adapter.cjs +81 -0
- package/gsd-core/bin/lib/cli-exit.cjs +42 -0
- package/gsd-core/bin/lib/clock.cjs +95 -0
- package/gsd-core/bin/lib/clusters.cjs +132 -0
- package/gsd-core/bin/lib/code-review-flags.cjs +59 -0
- package/gsd-core/bin/lib/command-aliases.cjs +809 -0
- package/gsd-core/bin/lib/command-arg-projection.cjs +55 -0
- package/gsd-core/bin/lib/command-routing-hub.cjs +300 -0
- package/gsd-core/bin/lib/commands.cjs +1203 -0
- package/gsd-core/bin/lib/config-schema.cjs +29 -0
- package/gsd-core/bin/lib/config-types.cjs +19 -0
- package/gsd-core/bin/lib/config.cjs +738 -0
- package/gsd-core/bin/lib/configuration.cjs +239 -0
- package/gsd-core/bin/lib/context-utilization.cjs +48 -0
- package/gsd-core/bin/lib/core.cjs +2051 -0
- package/gsd-core/bin/lib/decisions.cjs +118 -0
- package/gsd-core/bin/lib/docs.cjs +252 -0
- package/gsd-core/bin/lib/drift.cjs +364 -0
- package/gsd-core/bin/lib/fallow-runner.cjs +115 -0
- package/gsd-core/bin/lib/frontmatter.cjs +442 -0
- package/gsd-core/bin/lib/gap-checker.cjs +257 -0
- package/gsd-core/bin/lib/graphify.cjs +496 -0
- package/gsd-core/bin/lib/gsd2-import.cjs +456 -0
- package/gsd-core/bin/lib/init-command-router.cjs +62 -0
- package/gsd-core/bin/lib/init.cjs +1815 -0
- package/gsd-core/bin/lib/install-profiles.cjs +584 -0
- package/gsd-core/bin/lib/installer-migration-authoring.cjs +122 -0
- package/gsd-core/bin/lib/installer-migration-report.cjs +350 -0
- package/gsd-core/bin/lib/installer-migrations/000-first-time-baseline.cjs +218 -0
- package/gsd-core/bin/lib/installer-migrations/001-legacy-orphan-files.cjs +48 -0
- package/gsd-core/bin/lib/installer-migrations/002-codex-legacy-hooks-json.cjs +94 -0
- package/gsd-core/bin/lib/installer-migrations/003-rename-get-shit-done-to-gsd-core.cjs +108 -0
- package/gsd-core/bin/lib/installer-migrations.cjs +823 -0
- package/gsd-core/bin/lib/intel.cjs +590 -0
- package/gsd-core/bin/lib/learnings.cjs +270 -0
- package/gsd-core/bin/lib/legacy-cleanup.cjs +253 -0
- package/gsd-core/bin/lib/milestone.cjs +373 -0
- package/gsd-core/bin/lib/model-catalog.cjs +154 -0
- package/gsd-core/bin/lib/model-profiles.cjs +24 -0
- package/gsd-core/bin/lib/observability/event.cjs +51 -0
- package/gsd-core/bin/lib/observability/logger.cjs +146 -0
- package/gsd-core/bin/lib/observability/redaction.cjs +48 -0
- package/gsd-core/bin/lib/package-identity.cjs +35 -0
- package/gsd-core/bin/lib/package-legitimacy.cjs +368 -0
- package/gsd-core/bin/lib/phase-command-router.cjs +189 -0
- package/gsd-core/bin/lib/phase-lifecycle.cjs +74 -0
- package/gsd-core/bin/lib/phase.cjs +1307 -0
- package/gsd-core/bin/lib/phases-command-router.cjs +43 -0
- package/gsd-core/bin/lib/plan-scan.cjs +91 -0
- package/gsd-core/bin/lib/planning-workspace.cjs +245 -0
- package/gsd-core/bin/lib/profile-output.cjs +1120 -0
- package/gsd-core/bin/lib/profile-pipeline.cjs +517 -0
- package/gsd-core/bin/lib/project-root.cjs +119 -0
- package/gsd-core/bin/lib/prompt-budget.cjs +305 -0
- package/gsd-core/bin/lib/research-provider.cjs +137 -0
- package/gsd-core/bin/lib/research-store.cjs +167 -0
- package/gsd-core/bin/lib/review-reviewer-selection.cjs +121 -0
- package/gsd-core/bin/lib/roadmap-command-router.cjs +166 -0
- package/gsd-core/bin/lib/roadmap-upgrade.cjs +476 -0
- package/gsd-core/bin/lib/roadmap.cjs +600 -0
- package/gsd-core/bin/lib/runtime-artifact-layout.cjs +312 -0
- package/gsd-core/bin/lib/runtime-config-adapter-registry.cjs +56 -0
- package/gsd-core/bin/lib/runtime-homes.cjs +190 -0
- package/gsd-core/bin/lib/runtime-name-policy.cjs +96 -0
- package/gsd-core/bin/lib/runtime-slash.cjs +119 -0
- package/gsd-core/bin/lib/schema-detect.cjs +159 -0
- package/gsd-core/bin/lib/secrets.cjs +34 -0
- package/gsd-core/bin/lib/security.cjs +480 -0
- package/gsd-core/bin/lib/semver-compare.cjs +42 -0
- package/gsd-core/bin/lib/shell-command-projection.cjs +533 -0
- package/gsd-core/bin/lib/state-command-router.cjs +160 -0
- package/gsd-core/bin/lib/state-document.cjs +259 -0
- package/gsd-core/bin/lib/state.cjs +2010 -0
- package/gsd-core/bin/lib/surface.cjs +449 -0
- package/gsd-core/bin/lib/task-command-router.cjs +85 -0
- package/gsd-core/bin/lib/template.cjs +237 -0
- package/gsd-core/bin/lib/uat.cjs +297 -0
- package/gsd-core/bin/lib/ui-safety-gate.cjs +98 -0
- package/gsd-core/bin/lib/update-context.cjs +218 -0
- package/gsd-core/bin/lib/validate-command-router.cjs +91 -0
- package/gsd-core/bin/lib/validate.cjs +112 -0
- package/gsd-core/bin/lib/verification-command-router.cjs +31 -0
- package/gsd-core/bin/lib/verification.cjs +193 -0
- package/gsd-core/bin/lib/verify-command-router.cjs +44 -0
- package/gsd-core/bin/lib/verify.cjs +1451 -0
- package/gsd-core/bin/lib/workstream-inventory-builder.cjs +81 -0
- package/gsd-core/bin/lib/workstream-inventory.cjs +147 -0
- package/gsd-core/bin/lib/workstream-name-policy.cjs +91 -0
- package/gsd-core/bin/lib/workstream.cjs +380 -0
- package/gsd-core/bin/lib/worktree-base-ref.cjs +325 -0
- package/gsd-core/bin/lib/worktree-safety.cjs +943 -0
- package/gsd-core/bin/shared/config-defaults.manifest.json +98 -0
- package/gsd-core/bin/shared/config-schema.manifest.json +192 -0
- package/gsd-core/bin/shared/model-catalog.json +149 -0
- package/gsd-core/bin/shared/runtime-aliases.manifest.json +75 -0
- package/gsd-core/bin/verify-reapply-patches.cjs +349 -0
- package/gsd-core/contexts/dev.md +21 -0
- package/gsd-core/contexts/research.md +22 -0
- package/gsd-core/contexts/review.md +23 -0
- package/gsd-core/references/agent-contracts.md +79 -0
- package/gsd-core/references/ai-evals.md +156 -0
- package/gsd-core/references/ai-frameworks.md +186 -0
- package/gsd-core/references/architecture-decision.md +74 -0
- package/gsd-core/references/artifact-types.md +131 -0
- package/gsd-core/references/auth-in-tests.md +91 -0
- package/gsd-core/references/autonomous-smart-discuss.md +277 -0
- package/gsd-core/references/checkpoints.md +814 -0
- package/gsd-core/references/common-bug-patterns.md +114 -0
- package/gsd-core/references/context-budget.md +85 -0
- package/gsd-core/references/continuation-format.md +253 -0
- package/gsd-core/references/db-test-isolation.md +54 -0
- package/gsd-core/references/debugger-philosophy.md +76 -0
- package/gsd-core/references/decimal-phase-calculation.md +64 -0
- package/gsd-core/references/doc-conflict-engine.md +91 -0
- package/gsd-core/references/domain-modeling.md +80 -0
- package/gsd-core/references/domain-probes.md +125 -0
- package/gsd-core/references/e2e-tiering.md +35 -0
- package/gsd-core/references/execute-mvp-tdd.md +81 -0
- package/gsd-core/references/executor-examples.md +110 -0
- package/gsd-core/references/few-shot-examples/plan-checker.md +73 -0
- package/gsd-core/references/few-shot-examples/verifier.md +109 -0
- package/gsd-core/references/flaky-test-checklist.md +22 -0
- package/gsd-core/references/gate-prompts.md +100 -0
- package/gsd-core/references/gates.md +70 -0
- package/gsd-core/references/git-integration.md +298 -0
- package/gsd-core/references/git-planning-commit.md +40 -0
- package/gsd-core/references/ios-scaffold.md +123 -0
- package/gsd-core/references/mandatory-initial-read.md +2 -0
- package/gsd-core/references/model-profile-resolution.md +38 -0
- package/gsd-core/references/model-profiles.md +245 -0
- package/gsd-core/references/mvp-concepts.md +49 -0
- package/gsd-core/references/phase-argument-parsing.md +61 -0
- package/gsd-core/references/planner-antipatterns.md +89 -0
- package/gsd-core/references/planner-chunked.md +49 -0
- package/gsd-core/references/planner-gap-closure.md +62 -0
- package/gsd-core/references/planner-graphify-auto-update.md +67 -0
- package/gsd-core/references/planner-human-verify-mode.md +57 -0
- package/gsd-core/references/planner-interface-context.md +62 -0
- package/gsd-core/references/planner-load-graph-context.md +36 -0
- package/gsd-core/references/planner-mvp-mode.md +53 -0
- package/gsd-core/references/planner-reviews.md +39 -0
- package/gsd-core/references/planner-revision.md +87 -0
- package/gsd-core/references/planner-source-audit.md +73 -0
- package/gsd-core/references/planning-config.md +473 -0
- package/gsd-core/references/product-discovery.md +49 -0
- package/gsd-core/references/project-skills-discovery.md +19 -0
- package/gsd-core/references/questioning.md +162 -0
- package/gsd-core/references/realistic-test-data.md +44 -0
- package/gsd-core/references/research-documentation-lookup.md +29 -0
- package/gsd-core/references/research-philosophy.md +29 -0
- package/gsd-core/references/research-verification-protocol.md +27 -0
- package/gsd-core/references/revision-loop.md +97 -0
- package/gsd-core/references/scout-codebase.md +51 -0
- package/gsd-core/references/skeleton-template.md +48 -0
- package/gsd-core/references/sketch-interactivity.md +41 -0
- package/gsd-core/references/sketch-theme-system.md +94 -0
- package/gsd-core/references/sketch-tooling.md +45 -0
- package/gsd-core/references/sketch-variant-patterns.md +81 -0
- package/gsd-core/references/spidr-splitting.md +69 -0
- package/gsd-core/references/tdd.md +330 -0
- package/gsd-core/references/test-containers.md +55 -0
- package/gsd-core/references/test-strategy.md +75 -0
- package/gsd-core/references/thinking-models-debug.md +44 -0
- package/gsd-core/references/thinking-models-execution.md +50 -0
- package/gsd-core/references/thinking-models-planning.md +62 -0
- package/gsd-core/references/thinking-models-research.md +50 -0
- package/gsd-core/references/thinking-models-verification.md +55 -0
- package/gsd-core/references/thinking-partner.md +96 -0
- package/gsd-core/references/ui-brand.md +162 -0
- package/gsd-core/references/universal-anti-patterns.md +63 -0
- package/gsd-core/references/user-profiling.md +681 -0
- package/gsd-core/references/user-story-template.md +58 -0
- package/gsd-core/references/verification-overrides.md +227 -0
- package/gsd-core/references/verification-patterns.md +612 -0
- package/gsd-core/references/verify-mvp-mode.md +85 -0
- package/gsd-core/references/workstream-flag.md +111 -0
- package/gsd-core/references/worktree-branch-check.md +38 -0
- package/gsd-core/references/worktree-path-safety.md +67 -0
- package/gsd-core/templates/AI-SPEC.md +246 -0
- package/gsd-core/templates/DEBUG.md +169 -0
- package/gsd-core/templates/README.md +77 -0
- package/gsd-core/templates/SECURITY.md +61 -0
- package/gsd-core/templates/UAT.md +265 -0
- package/gsd-core/templates/UI-SPEC.md +100 -0
- package/gsd-core/templates/VALIDATION.md +76 -0
- package/gsd-core/templates/adr.md +58 -0
- package/gsd-core/templates/claude-md.md +145 -0
- package/gsd-core/templates/codebase/architecture.md +255 -0
- package/gsd-core/templates/codebase/concerns.md +310 -0
- package/gsd-core/templates/codebase/conventions.md +307 -0
- package/gsd-core/templates/codebase/integrations.md +280 -0
- package/gsd-core/templates/codebase/stack.md +186 -0
- package/gsd-core/templates/codebase/structure.md +285 -0
- package/gsd-core/templates/codebase/testing.md +480 -0
- package/gsd-core/templates/config.json +62 -0
- package/gsd-core/templates/context.md +352 -0
- package/gsd-core/templates/continue-here.md +78 -0
- package/gsd-core/templates/copilot-instructions.md +7 -0
- package/gsd-core/templates/debug-subagent-prompt.md +91 -0
- package/gsd-core/templates/dev-preferences.md +21 -0
- package/gsd-core/templates/discovery.md +146 -0
- package/gsd-core/templates/discussion-log.md +63 -0
- package/gsd-core/templates/domain-model.md +54 -0
- package/gsd-core/templates/milestone-archive.md +123 -0
- package/gsd-core/templates/milestone.md +115 -0
- package/gsd-core/templates/phase-prompt.md +610 -0
- package/gsd-core/templates/planner-subagent-prompt.md +117 -0
- package/gsd-core/templates/product-brief.md +55 -0
- package/gsd-core/templates/project.md +186 -0
- package/gsd-core/templates/requirements.md +231 -0
- package/gsd-core/templates/research-project/ARCHITECTURE.md +204 -0
- package/gsd-core/templates/research-project/FEATURES.md +147 -0
- package/gsd-core/templates/research-project/PITFALLS.md +200 -0
- package/gsd-core/templates/research-project/STACK.md +120 -0
- package/gsd-core/templates/research-project/SUMMARY.md +170 -0
- package/gsd-core/templates/research.md +592 -0
- package/gsd-core/templates/retrospective.md +54 -0
- package/gsd-core/templates/roadmap.md +202 -0
- package/gsd-core/templates/spec.md +307 -0
- package/gsd-core/templates/state.md +195 -0
- package/gsd-core/templates/summary-complex.md +59 -0
- package/gsd-core/templates/summary-minimal.md +41 -0
- package/gsd-core/templates/summary-standard.md +48 -0
- package/gsd-core/templates/summary.md +248 -0
- package/gsd-core/templates/test-strategy.md +50 -0
- package/gsd-core/templates/user-profile.md +146 -0
- package/gsd-core/templates/user-setup.md +311 -0
- package/gsd-core/templates/verification-report.md +322 -0
- package/gsd-core/workflows/_runtime-launcher.snippet.sh +1 -0
- package/gsd-core/workflows/add-backlog.md +91 -0
- package/gsd-core/workflows/add-phase.md +113 -0
- package/gsd-core/workflows/add-tests.md +355 -0
- package/gsd-core/workflows/add-todo.md +161 -0
- package/gsd-core/workflows/ai-integration-phase.md +295 -0
- package/gsd-core/workflows/analyze-dependencies.md +96 -0
- package/gsd-core/workflows/audit-fix.md +178 -0
- package/gsd-core/workflows/audit-milestone.md +360 -0
- package/gsd-core/workflows/audit-uat.md +110 -0
- package/gsd-core/workflows/autonomous.md +797 -0
- package/gsd-core/workflows/check-todos.md +180 -0
- package/gsd-core/workflows/cleanup.md +195 -0
- package/gsd-core/workflows/code-review-fix.md +502 -0
- package/gsd-core/workflows/code-review.md +658 -0
- package/gsd-core/workflows/complete-milestone.md +855 -0
- package/gsd-core/workflows/debug.md +237 -0
- package/gsd-core/workflows/diagnose-issues.md +245 -0
- package/gsd-core/workflows/discover-product.md +112 -0
- package/gsd-core/workflows/discovery-phase.md +291 -0
- package/gsd-core/workflows/discuss-phase/modes/advisor.md +176 -0
- package/gsd-core/workflows/discuss-phase/modes/all.md +28 -0
- package/gsd-core/workflows/discuss-phase/modes/analyze.md +44 -0
- package/gsd-core/workflows/discuss-phase/modes/auto.md +57 -0
- package/gsd-core/workflows/discuss-phase/modes/batch.md +52 -0
- package/gsd-core/workflows/discuss-phase/modes/chain.md +98 -0
- package/gsd-core/workflows/discuss-phase/modes/default.md +141 -0
- package/gsd-core/workflows/discuss-phase/modes/power.md +44 -0
- package/gsd-core/workflows/discuss-phase/modes/text.md +55 -0
- package/gsd-core/workflows/discuss-phase/templates/checkpoint.json +18 -0
- package/gsd-core/workflows/discuss-phase/templates/context.md +136 -0
- package/gsd-core/workflows/discuss-phase/templates/discussion-log.md +50 -0
- package/gsd-core/workflows/discuss-phase-assumptions.md +675 -0
- package/gsd-core/workflows/discuss-phase-power.md +291 -0
- package/gsd-core/workflows/discuss-phase.md +499 -0
- package/gsd-core/workflows/do.md +111 -0
- package/gsd-core/workflows/docs-update.md +1176 -0
- package/gsd-core/workflows/edit-phase.md +295 -0
- package/gsd-core/workflows/eval-review.md +156 -0
- package/gsd-core/workflows/execute-phase/steps/codebase-drift-gate.md +95 -0
- package/gsd-core/workflows/execute-phase/steps/per-plan-worktree-gate.md +94 -0
- package/gsd-core/workflows/execute-phase/steps/post-merge-gate.md +117 -0
- package/gsd-core/workflows/execute-phase.md +1752 -0
- package/gsd-core/workflows/execute-plan.md +526 -0
- package/gsd-core/workflows/explore.md +146 -0
- package/gsd-core/workflows/extract-learnings.md +243 -0
- package/gsd-core/workflows/fast.md +124 -0
- package/gsd-core/workflows/forensics.md +279 -0
- package/gsd-core/workflows/graduation.md +196 -0
- package/gsd-core/workflows/health.md +224 -0
- package/gsd-core/workflows/help/modes/brief.md +22 -0
- package/gsd-core/workflows/help/modes/default.md +50 -0
- package/gsd-core/workflows/help/modes/full.md +789 -0
- package/gsd-core/workflows/help/modes/topic.md +74 -0
- package/gsd-core/workflows/help.md +24 -0
- package/gsd-core/workflows/import.md +256 -0
- package/gsd-core/workflows/inbox.md +387 -0
- package/gsd-core/workflows/ingest-docs.md +340 -0
- package/gsd-core/workflows/insert-phase.md +152 -0
- package/gsd-core/workflows/list-phase-assumptions.md +178 -0
- package/gsd-core/workflows/list-workspaces.md +57 -0
- package/gsd-core/workflows/manager.md +393 -0
- package/gsd-core/workflows/map-codebase.md +446 -0
- package/gsd-core/workflows/milestone-summary.md +224 -0
- package/gsd-core/workflows/model-domain.md +162 -0
- package/gsd-core/workflows/mvp-phase.md +222 -0
- package/gsd-core/workflows/new-milestone.md +635 -0
- package/gsd-core/workflows/new-project.md +1555 -0
- package/gsd-core/workflows/new-workspace.md +240 -0
- package/gsd-core/workflows/next.md +299 -0
- package/gsd-core/workflows/node-repair.md +92 -0
- package/gsd-core/workflows/note.md +158 -0
- package/gsd-core/workflows/pause-work.md +244 -0
- package/gsd-core/workflows/plan-milestone-gaps.md +281 -0
- package/gsd-core/workflows/plan-phase.md +1814 -0
- package/gsd-core/workflows/plan-review-convergence.md +346 -0
- package/gsd-core/workflows/plant-seed.md +230 -0
- package/gsd-core/workflows/pr-branch.md +157 -0
- package/gsd-core/workflows/profile-user.md +453 -0
- package/gsd-core/workflows/progress.md +699 -0
- package/gsd-core/workflows/quick.md +1017 -0
- package/gsd-core/workflows/reapply-patches.md +426 -0
- package/gsd-core/workflows/recommend-architecture.md +135 -0
- package/gsd-core/workflows/remove-phase.md +156 -0
- package/gsd-core/workflows/remove-workspace.md +108 -0
- package/gsd-core/workflows/resume-project.md +332 -0
- package/gsd-core/workflows/review.md +748 -0
- package/gsd-core/workflows/scan.md +107 -0
- package/gsd-core/workflows/secure-phase.md +182 -0
- package/gsd-core/workflows/session-report.md +146 -0
- package/gsd-core/workflows/settings-advanced.md +810 -0
- package/gsd-core/workflows/settings-integrations.md +312 -0
- package/gsd-core/workflows/settings.md +566 -0
- package/gsd-core/workflows/ship.md +405 -0
- package/gsd-core/workflows/sketch-wrap-up.md +286 -0
- package/gsd-core/workflows/sketch.md +361 -0
- package/gsd-core/workflows/spec-phase.md +263 -0
- package/gsd-core/workflows/spike-wrap-up.md +307 -0
- package/gsd-core/workflows/spike.md +453 -0
- package/gsd-core/workflows/stats.md +80 -0
- package/gsd-core/workflows/sync-skills.md +182 -0
- package/gsd-core/workflows/testing-strategy.md +122 -0
- package/gsd-core/workflows/thread.md +222 -0
- package/gsd-core/workflows/transition.md +694 -0
- package/gsd-core/workflows/ui-phase.md +328 -0
- package/gsd-core/workflows/ui-review.md +193 -0
- package/gsd-core/workflows/ultraplan-phase.md +199 -0
- package/gsd-core/workflows/undo.md +314 -0
- package/gsd-core/workflows/update.md +496 -0
- package/gsd-core/workflows/validate-phase.md +181 -0
- package/gsd-core/workflows/verify-phase.md +544 -0
- package/gsd-core/workflows/verify-work.md +781 -0
- package/hooks/dist/gsd-check-update-worker.js +108 -0
- package/hooks/dist/gsd-check-update.js +66 -0
- package/hooks/dist/gsd-config-reload.js +133 -0
- package/hooks/dist/gsd-context-monitor.js +195 -0
- package/hooks/dist/gsd-cursor-post-tool.js +75 -0
- package/hooks/dist/gsd-cursor-session-start.js +52 -0
- package/hooks/dist/gsd-graphify-update.sh +158 -0
- package/hooks/dist/gsd-phase-boundary.sh +47 -0
- package/hooks/dist/gsd-prompt-guard.js +97 -0
- package/hooks/dist/gsd-read-guard.js +101 -0
- package/hooks/dist/gsd-read-injection-scanner.js +203 -0
- package/hooks/dist/gsd-session-state.sh +59 -0
- package/hooks/dist/gsd-statusline.js +566 -0
- package/hooks/dist/gsd-update-banner.js +138 -0
- package/hooks/dist/gsd-validate-commit.sh +57 -0
- package/hooks/dist/gsd-workflow-guard.js +167 -0
- package/hooks/dist/gsd-worktree-path-guard.js +169 -0
- package/hooks/dist/lib/git-cmd.js +150 -0
- package/hooks/dist/lib/gsd-graphify-rebuild.sh +65 -0
- package/hooks/dist/managed-hooks-registry.cjs +38 -0
- package/hooks/gsd-check-update-worker.js +108 -0
- package/hooks/gsd-check-update.js +66 -0
- package/hooks/gsd-config-reload.js +133 -0
- package/hooks/gsd-context-monitor.js +195 -0
- package/hooks/gsd-cursor-post-tool.js +75 -0
- package/hooks/gsd-cursor-session-start.js +52 -0
- package/hooks/gsd-graphify-update.sh +158 -0
- package/hooks/gsd-phase-boundary.sh +47 -0
- package/hooks/gsd-prompt-guard.js +97 -0
- package/hooks/gsd-read-guard.js +101 -0
- package/hooks/gsd-read-injection-scanner.js +203 -0
- package/hooks/gsd-session-state.sh +59 -0
- package/hooks/gsd-statusline.js +566 -0
- package/hooks/gsd-update-banner.js +138 -0
- package/hooks/gsd-validate-commit.sh +57 -0
- package/hooks/gsd-workflow-guard.js +167 -0
- package/hooks/gsd-worktree-path-guard.js +169 -0
- package/hooks/hooks.json +69 -0
- package/hooks/lib/git-cmd.js +150 -0
- package/hooks/lib/gsd-graphify-rebuild.sh +65 -0
- package/hooks/managed-hooks-registry.cjs +38 -0
- package/package.json +115 -0
- package/scripts/affected-tests-lib.cjs +542 -0
- package/scripts/audit-workflow-script-paths.cjs +73 -0
- package/scripts/base64-scan.sh +351 -0
- package/scripts/build-hooks.js +247 -0
- package/scripts/changeset/README.md +129 -0
- package/scripts/changeset/cli.cjs +590 -0
- package/scripts/changeset/github-release-notes.cjs +199 -0
- package/scripts/changeset/lint.cjs +111 -0
- package/scripts/changeset/new.cjs +137 -0
- package/scripts/changeset/parse.cjs +114 -0
- package/scripts/changeset/render.cjs +34 -0
- package/scripts/changeset/serialize.cjs +130 -0
- package/scripts/check-alias-drift.cjs +114 -0
- package/scripts/check-env.cjs +312 -0
- package/scripts/check-npm-integrity.cjs +215 -0
- package/scripts/ci-guard-runner.cjs +22 -0
- package/scripts/ci-prepare-test-scope.cjs +51 -0
- package/scripts/ci-rebase-check.cjs +86 -0
- package/scripts/ci-test-scope.cjs +431 -0
- package/scripts/command-contract-helpers.cjs +64 -0
- package/scripts/diff-touches-shipped-paths.cjs +155 -0
- package/scripts/fix-slash-commands.cjs +147 -0
- package/scripts/gen-inventory-manifest.cjs +115 -0
- package/scripts/gen-research-agents.cjs +276 -0
- package/scripts/generate-package-identity.cjs +125 -0
- package/scripts/issue-dedupe.cjs +278 -0
- package/scripts/lib/allowlist-ratchet.cjs +136 -0
- package/scripts/lib/cli-exit.cjs +56 -0
- package/scripts/lint-command-contract.cjs +114 -0
- package/scripts/lint-descriptions.cjs +87 -0
- package/scripts/lint-docs-required.cjs +222 -0
- package/scripts/lint-legacy-dir-name.cjs +160 -0
- package/scripts/lint-package-identity-drift.cjs +141 -0
- package/scripts/lint-pr-check-project-dir.cjs +99 -0
- package/scripts/lint-shell-command-projection-drift.cjs +62 -0
- package/scripts/lint-skill-deps.cjs +185 -0
- package/scripts/lint-test-file-count.allowlist.json +135 -0
- package/scripts/lint-test-file-count.cjs +246 -0
- package/scripts/mutation-matrix.cjs +222 -0
- package/scripts/pr-template-policy.cjs +268 -0
- package/scripts/prompt-injection-scan.sh +207 -0
- package/scripts/release-notes/discord-release-summary.cjs +373 -0
- package/scripts/release-notes/format-github-release-notes.cjs +261 -0
- package/scripts/release-tarball-smoke.cjs +629 -0
- package/scripts/research-profiles.cjs +149 -0
- package/scripts/run-affected-tests.cjs +7 -0
- package/scripts/run-cross-platform-tests.cjs +67 -0
- package/scripts/run-tests.cjs +315 -0
- package/scripts/secret-scan-lint.sh +231 -0
- package/scripts/secret-scan.sh +358 -0
- package/scripts/setup-branch-protection.sh +236 -0
- package/scripts/strip-prose-atrefs.cjs +106 -0
- package/scripts/sync-manifest-versions.cjs +119 -0
- package/scripts/sync-rulesets.sh +34 -0
- package/scripts/sync-runtime-launcher.cjs +399 -0
- package/scripts/test-failure-reasons.cjs +34 -0
- package/scripts/verify-npm-publish.cjs +240 -0
- 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
|
+
};
|