6baa2a8182
* test(#1961): add failing-first bug-taxonomy routing contract tests Epic #1957 Phase 2B. Source-text-is-the-product contract tests (3 taxonomy classes, explicit class->technique routing table, Bohrbug->repro+SBFL+bisect, Heisenbug->record-replay/stability+SKIP-SBFL, Concurrency->atomicity/order/ deadlock checklist, bug_class in DEBUG Current Focus, supersede-not-append) plus a routing-table specification object pinning the documented decisions (SBFL forbidden on Heisenbug is the load-bearing 1B/2B seam). Failing-first: reference, Phase 1.75, and routing-table reframe do not yet exist. * feat(#1961): add bug-taxonomy classification + strategy routing to gsd-debugger Epic #1957 Phase 2B (reliability-critical). Adds Phase 1.75: classify the failure as Bohrbug / Heisenbug-Mandelbug / Concurrency, then route the investigation technique via an explicit class->technique table (Kernighan: no opaque heuristic). Bohrbug -> reproduction + SBFL (Phase 1.25) + git bisect; Heisenbug/Mandelbug -> record-replay (rr) + stability-stress + statistical sampling, with SBFL explicitly SKIPPED (a flaky spectrum poisons the Ochiai ranking — the load-bearing 1B/2B seam); Concurrency -> the atomicity/order/deadlock checklist first. Reframes (supersedes, not appends — Zawinski) the flat 'Technique Selection by situation' table into a class-routed table; the 11 techniques remain as routed targets. bug_class recorded in Current Focus (DEBUG template); common-bug- patterns catalog cross-referenced to the taxonomy. Full rules extracted to gsd-core/references/debugger-bug-taxonomy.md. INVENTORY + manifest + agent-size baseline + install-parity goldens + AGENTS.md updated. * fix(#1961): address orthogonal review (phase-name drift, General lane, revoke framing, row-scoped tests, bounding) - HIGH: reference said 'Phase 1B' (epic shorthand); corrected to the deployed 'Phase 1.25' (matches the agent + SBFL reference). - HIGH: 6 of 11 techniques (Rubber duck, Delta, Working backwards, Differential, Comment-out, Follow-the-indirection) were orphaned by the situation-table reframe. Added a 'General (any class, situation-cued)' lane to BOTH the reference routing table and the agent's Technique Selection table that re-homes them — supersede-not-append now holds. - MEDIUM: the SBFL-skip is structurally retroactive (Phase 1.25 runs before Phase 1.75 classification), so reframed the table column from 'Do NOT use' to 'Revoke if already run' + an explicit 'retroactive revocation, not proactive skip' note stating the ordering honestly. - MEDIUM: contract tests are now row-scoped (parse the table by class, assert per-row) instead of presence-only; added a guard that the previously- orphaned techniques now have a General-lane route. - LOW: pinned the canonical bug_class value form (lowercase-kebab: bohrbug|heisenbug-mandelbug|concurrency; prose may use title-case). - NIT: added a 'Bound the Heisenbug-chase runs' note (rr/stability/sampling timeouts) per the unbounded-subprocess gauntlet. * chore(#1961): backfill changeset pr number (PR #2407)
486 lines
13 KiB
JSON
486 lines
13 KiB
JSON
{
|
|
"families": {
|
|
"agents": [
|
|
"gsd-advisor-researcher",
|
|
"gsd-ai-researcher",
|
|
"gsd-assumptions-analyzer",
|
|
"gsd-code-fixer",
|
|
"gsd-code-reviewer",
|
|
"gsd-codebase-mapper",
|
|
"gsd-debug-session-manager",
|
|
"gsd-debugger",
|
|
"gsd-doc-classifier",
|
|
"gsd-doc-synthesizer",
|
|
"gsd-doc-verifier",
|
|
"gsd-doc-writer",
|
|
"gsd-domain-researcher",
|
|
"gsd-eval-auditor",
|
|
"gsd-eval-planner",
|
|
"gsd-executor",
|
|
"gsd-framework-selector",
|
|
"gsd-integration-checker",
|
|
"gsd-intel-updater",
|
|
"gsd-mempalace-curator",
|
|
"gsd-nyquist-auditor",
|
|
"gsd-pattern-mapper",
|
|
"gsd-phase-researcher",
|
|
"gsd-plan-checker",
|
|
"gsd-planner",
|
|
"gsd-project-researcher",
|
|
"gsd-research-synthesizer",
|
|
"gsd-roadmapper",
|
|
"gsd-security-auditor",
|
|
"gsd-ui-auditor",
|
|
"gsd-ui-checker",
|
|
"gsd-ui-researcher",
|
|
"gsd-user-profiler",
|
|
"gsd-verifier"
|
|
],
|
|
"commands": [
|
|
"/gsd-add-tests",
|
|
"/gsd-ai-integration-phase",
|
|
"/gsd-audit-fix",
|
|
"/gsd-audit-milestone",
|
|
"/gsd-audit-uat",
|
|
"/gsd-autonomous",
|
|
"/gsd-capture",
|
|
"/gsd-cleanup",
|
|
"/gsd-code-review",
|
|
"/gsd-complete-milestone",
|
|
"/gsd-config",
|
|
"/gsd-debug",
|
|
"/gsd-discuss-phase",
|
|
"/gsd-docs-update",
|
|
"/gsd-eval-review",
|
|
"/gsd-execute-phase",
|
|
"/gsd-explore",
|
|
"/gsd-extract-learnings",
|
|
"/gsd-fast",
|
|
"/gsd-forensics",
|
|
"/gsd-graphify",
|
|
"/gsd-health",
|
|
"/gsd-help",
|
|
"/gsd-import",
|
|
"/gsd-inbox",
|
|
"/gsd-ingest-docs",
|
|
"/gsd-manager",
|
|
"/gsd-map-codebase",
|
|
"/gsd-mempalace-capture",
|
|
"/gsd-mempalace-recall",
|
|
"/gsd-milestone-summary",
|
|
"/gsd-mvp-phase",
|
|
"/gsd-new-milestone",
|
|
"/gsd-new-project",
|
|
"/gsd-next",
|
|
"/gsd-ns-context",
|
|
"/gsd-ns-ideate",
|
|
"/gsd-ns-manage",
|
|
"/gsd-ns-project",
|
|
"/gsd-ns-review",
|
|
"/gsd-ns-workflow",
|
|
"/gsd-onboard",
|
|
"/gsd-pause-work",
|
|
"/gsd-phase",
|
|
"/gsd-plan-phase",
|
|
"/gsd-plan-review-convergence",
|
|
"/gsd-pr-branch",
|
|
"/gsd-profile-user",
|
|
"/gsd-progress",
|
|
"/gsd-quick",
|
|
"/gsd-resume-work",
|
|
"/gsd-review",
|
|
"/gsd-review-backlog",
|
|
"/gsd-secure-phase",
|
|
"/gsd-settings",
|
|
"/gsd-ship",
|
|
"/gsd-sketch",
|
|
"/gsd-spec-phase",
|
|
"/gsd-spike",
|
|
"/gsd-stats",
|
|
"/gsd-surface",
|
|
"/gsd-thread",
|
|
"/gsd-ui-phase",
|
|
"/gsd-ui-review",
|
|
"/gsd-ultraplan-phase",
|
|
"/gsd-undo",
|
|
"/gsd-update",
|
|
"/gsd-validate-phase",
|
|
"/gsd-verify-work",
|
|
"/gsd-workspace",
|
|
"/gsd-workstreams"
|
|
],
|
|
"workflows": [
|
|
"add-backlog.md",
|
|
"add-phase.md",
|
|
"add-tests.md",
|
|
"add-todo.md",
|
|
"ai-integration-phase.md",
|
|
"analyze-dependencies.md",
|
|
"audit-fix.md",
|
|
"audit-milestone.md",
|
|
"audit-uat.md",
|
|
"autonomous.md",
|
|
"check-todos.md",
|
|
"cleanup.md",
|
|
"code-review-fix.md",
|
|
"code-review.md",
|
|
"complete-milestone.md",
|
|
"debug.md",
|
|
"diagnose-issues.md",
|
|
"discovery-phase.md",
|
|
"discuss-phase-assumptions.md",
|
|
"discuss-phase-power.md",
|
|
"discuss-phase.md",
|
|
"do.md",
|
|
"docs-update.md",
|
|
"edit-phase.md",
|
|
"eval-review.md",
|
|
"execute-phase.md",
|
|
"execute-plan.md",
|
|
"explore.md",
|
|
"extract-learnings.md",
|
|
"fast.md",
|
|
"forensics.md",
|
|
"graduation.md",
|
|
"health.md",
|
|
"help.md",
|
|
"import.md",
|
|
"inbox.md",
|
|
"ingest-docs.md",
|
|
"insert-phase.md",
|
|
"list-phase-assumptions.md",
|
|
"list-seeds.md",
|
|
"list-workspaces.md",
|
|
"manager.md",
|
|
"map-codebase.md",
|
|
"milestone-summary.md",
|
|
"mvp-phase.md",
|
|
"new-milestone.md",
|
|
"new-project.md",
|
|
"new-workspace.md",
|
|
"next.md",
|
|
"node-repair.md",
|
|
"note.md",
|
|
"onboard.md",
|
|
"pause-work.md",
|
|
"plan-milestone-gaps.md",
|
|
"plan-phase.md",
|
|
"plan-review-convergence.md",
|
|
"plant-seed.md",
|
|
"pr-branch.md",
|
|
"profile-user.md",
|
|
"progress.md",
|
|
"quick.md",
|
|
"reapply-patches.md",
|
|
"remove-phase.md",
|
|
"remove-workspace.md",
|
|
"resume-project.md",
|
|
"review.md",
|
|
"scan.md",
|
|
"secure-phase.md",
|
|
"session-report.md",
|
|
"settings-advanced.md",
|
|
"settings-integrations.md",
|
|
"settings.md",
|
|
"ship.md",
|
|
"sketch-wrap-up.md",
|
|
"sketch.md",
|
|
"smart-entry.md",
|
|
"spec-phase.md",
|
|
"spike-wrap-up.md",
|
|
"spike.md",
|
|
"stats.md",
|
|
"sync-skills.md",
|
|
"thread.md",
|
|
"transition.md",
|
|
"ui-phase.md",
|
|
"ui-review.md",
|
|
"ultraplan-phase.md",
|
|
"undo.md",
|
|
"update.md",
|
|
"validate-phase.md",
|
|
"verify-phase.md",
|
|
"verify-work.md"
|
|
],
|
|
"references": [
|
|
"agent-contracts.md",
|
|
"agent-skills-bootstrap.md",
|
|
"ai-evals.md",
|
|
"ai-frameworks.md",
|
|
"api-coverage.md",
|
|
"artifact-types.md",
|
|
"autonomous-smart-discuss.md",
|
|
"checkpoints.md",
|
|
"common-bug-patterns.md",
|
|
"context-budget.md",
|
|
"continuation-format.md",
|
|
"debugger-bug-taxonomy.md",
|
|
"debugger-fix-acceptance.md",
|
|
"debugger-philosophy.md",
|
|
"debugger-rca-branching.md",
|
|
"debugger-sbfl.md",
|
|
"decimal-phase-calculation.md",
|
|
"doc-conflict-engine.md",
|
|
"domain-probes.md",
|
|
"edge-probe.md",
|
|
"execute-mvp-tdd.md",
|
|
"execute-phase-between-wave-reset.md",
|
|
"execute-phase-context-guard.md",
|
|
"execute-phase-wave-guard.md",
|
|
"executor-examples.md",
|
|
"gate-prompts.md",
|
|
"gates.md",
|
|
"git-integration.md",
|
|
"git-planning-commit.md",
|
|
"gsd-run-resolver.md",
|
|
"honest-verifier.md",
|
|
"ios-scaffold.md",
|
|
"loop-hook-dispatch.md",
|
|
"mandatory-initial-read.md",
|
|
"model-profile-resolution.md",
|
|
"model-profiles.md",
|
|
"mvp-concepts.md",
|
|
"phase-argument-parsing.md",
|
|
"planner-antipatterns.md",
|
|
"planner-chunked.md",
|
|
"planner-gap-closure.md",
|
|
"planner-graphify-auto-update.md",
|
|
"planner-guidance.md",
|
|
"planner-human-verify-mode.md",
|
|
"planner-interface-context.md",
|
|
"planner-load-graph-context.md",
|
|
"planner-mvp-mode.md",
|
|
"planner-reviews.md",
|
|
"planner-revision.md",
|
|
"planner-source-audit.md",
|
|
"planning-config.md",
|
|
"prohibition-probe.md",
|
|
"project-skills-discovery.md",
|
|
"questioning.md",
|
|
"research-documentation-lookup.md",
|
|
"research-philosophy.md",
|
|
"research-verification-protocol.md",
|
|
"reviewer-instances.md",
|
|
"revision-loop.md",
|
|
"scout-codebase.md",
|
|
"security-asvs-levels.md",
|
|
"skeleton-template.md",
|
|
"sketch-interactivity.md",
|
|
"sketch-theme-system.md",
|
|
"sketch-tooling.md",
|
|
"sketch-variant-patterns.md",
|
|
"specless-probe-fallback.md",
|
|
"spidr-splitting.md",
|
|
"tdd.md",
|
|
"thinking-models-debug.md",
|
|
"thinking-models-execution.md",
|
|
"thinking-models-planning.md",
|
|
"thinking-models-research.md",
|
|
"thinking-models-verification.md",
|
|
"thinking-partner.md",
|
|
"ui-brand.md",
|
|
"ui-consideration-probe.md",
|
|
"universal-anti-patterns.md",
|
|
"untrusted-input-boundary.md",
|
|
"user-profiling.md",
|
|
"user-story-template.md",
|
|
"verification-overrides.md",
|
|
"verification-patterns.md",
|
|
"verify-mvp-mode.md",
|
|
"workstream-flag.md",
|
|
"worktree-branch-check.md",
|
|
"worktree-path-safety.md"
|
|
],
|
|
"cli_modules": [
|
|
"active-workstream-store.cjs",
|
|
"adapter-declarative.cjs",
|
|
"adapter-imperative.cjs",
|
|
"adr-parser.cjs",
|
|
"agent-command-router.cjs",
|
|
"agent-install-check.cjs",
|
|
"api-coverage.cjs",
|
|
"artifacts.cjs",
|
|
"assumption-delta.cjs",
|
|
"audit-command-router.cjs",
|
|
"audit.cjs",
|
|
"capability-activation.cjs",
|
|
"capability-command-router.cjs",
|
|
"capability-consent.cjs",
|
|
"capability-ledger.cjs",
|
|
"capability-lifecycle.cjs",
|
|
"capability-loader.cjs",
|
|
"capability-lock.cjs",
|
|
"capability-registry.cjs",
|
|
"capability-source.cjs",
|
|
"capability-state.cjs",
|
|
"capability-trust.cjs",
|
|
"capability-validator.cjs",
|
|
"capability-writer.cjs",
|
|
"check-command-router.cjs",
|
|
"cjs-command-router-adapter.cjs",
|
|
"claude-orchestration-command-router.cjs",
|
|
"claude-orchestration.cjs",
|
|
"cli-exit.cjs",
|
|
"cli-skew-check.cjs",
|
|
"clock.cjs",
|
|
"clusters.cjs",
|
|
"code-review-flags.cjs",
|
|
"command-aliases.cjs",
|
|
"command-arg-projection.cjs",
|
|
"command-roster.cjs",
|
|
"command-routing-hub.cjs",
|
|
"commands.cjs",
|
|
"config-loader.cjs",
|
|
"config-schema.cjs",
|
|
"config-types.cjs",
|
|
"config.cjs",
|
|
"configuration.cjs",
|
|
"context-utilization.cjs",
|
|
"core-utils.cjs",
|
|
"coverage.cjs",
|
|
"decisions.cjs",
|
|
"docs.cjs",
|
|
"drift.cjs",
|
|
"edge-probe.cjs",
|
|
"embedding-adapter.cjs",
|
|
"eval-command-router.cjs",
|
|
"eval.cjs",
|
|
"external-descriptor-trust.cjs",
|
|
"external-job.cjs",
|
|
"fallow-runner.cjs",
|
|
"federated-config.cjs",
|
|
"frontmatter.cjs",
|
|
"gap-checker.cjs",
|
|
"gate-predicate-evaluator.cjs",
|
|
"git-base-branch.cjs",
|
|
"graphify-command-router.cjs",
|
|
"graphify.cjs",
|
|
"gsd2-import.cjs",
|
|
"handshake-serialized.cjs",
|
|
"hook-bus.cjs",
|
|
"host-integration-sdk.cjs",
|
|
"host-integration.cjs",
|
|
"init-command-router.cjs",
|
|
"init.cjs",
|
|
"install-effort-resolver.cjs",
|
|
"install-engine.cjs",
|
|
"install-profiles.cjs",
|
|
"installer-migration-authoring.cjs",
|
|
"installer-migration-report.cjs",
|
|
"installer-migrations.cjs",
|
|
"intel-command-router.cjs",
|
|
"intel.cjs",
|
|
"io.cjs",
|
|
"learnings.cjs",
|
|
"legacy-cleanup.cjs",
|
|
"loop-host-contract.cjs",
|
|
"loop-resolver.cjs",
|
|
"markdown-sectionizer.cjs",
|
|
"markdown-table.cjs",
|
|
"mcp-server.cjs",
|
|
"milestone.cjs",
|
|
"model-adapter.cjs",
|
|
"model-catalog.cjs",
|
|
"model-profiles.cjs",
|
|
"model-resolver.cjs",
|
|
"normalize-test-command.cjs",
|
|
"onboard-projection.cjs",
|
|
"package-identity.cjs",
|
|
"package-legitimacy.cjs",
|
|
"phase-command-router.cjs",
|
|
"phase-id.cjs",
|
|
"phase-lifecycle.cjs",
|
|
"phase-locator.cjs",
|
|
"phase.cjs",
|
|
"phases-command-router.cjs",
|
|
"plan-drift-guard.cjs",
|
|
"plan-scan.cjs",
|
|
"planning-workspace.cjs",
|
|
"probe-core.cjs",
|
|
"profile-output.cjs",
|
|
"profile-pipeline-command-router.cjs",
|
|
"profile-pipeline.cjs",
|
|
"prohibition-enforcement.cjs",
|
|
"project-root.cjs",
|
|
"prompt-budget.cjs",
|
|
"research-provider.cjs",
|
|
"research-store.cjs",
|
|
"resolution.cjs",
|
|
"review-reviewer-selection.cjs",
|
|
"roadmap-command-router.cjs",
|
|
"roadmap-parser.cjs",
|
|
"roadmap-upgrade.cjs",
|
|
"roadmap.cjs",
|
|
"runtime-artifact-conversion.cjs",
|
|
"runtime-artifact-install-plan.cjs",
|
|
"runtime-artifact-layout.cjs",
|
|
"runtime-config-adapter-registry.cjs",
|
|
"runtime-homes.cjs",
|
|
"runtime-hooks-surface.cjs",
|
|
"runtime-name-policy.cjs",
|
|
"runtime-slash.cjs",
|
|
"schema-detect.cjs",
|
|
"secrets.cjs",
|
|
"security.cjs",
|
|
"semver-compare.cjs",
|
|
"shell-command-projection.cjs",
|
|
"smart-entry.cjs",
|
|
"spec-section.cjs",
|
|
"stale-bake-guard.cjs",
|
|
"state-command-router.cjs",
|
|
"state-document.cjs",
|
|
"state-io.cjs",
|
|
"state-transition.cjs",
|
|
"state.cjs",
|
|
"surface.cjs",
|
|
"task-command-router.cjs",
|
|
"teams-status.cjs",
|
|
"template.cjs",
|
|
"uat-predicate.cjs",
|
|
"uat.cjs",
|
|
"ui-consideration-probe.cjs",
|
|
"ui-safety-gate.cjs",
|
|
"update-context.cjs",
|
|
"validate-command-router.cjs",
|
|
"validate.cjs",
|
|
"verification-command-router.cjs",
|
|
"verification.cjs",
|
|
"verify-command-router.cjs",
|
|
"verify.cjs",
|
|
"workstream-inventory-builder.cjs",
|
|
"workstream-inventory.cjs",
|
|
"workstream-name-policy.cjs",
|
|
"workstream.cjs",
|
|
"worktree-base-ref.cjs",
|
|
"worktree-safety.cjs",
|
|
"write-set.cjs"
|
|
],
|
|
"hooks": [
|
|
"gsd-check-update-worker.js",
|
|
"gsd-check-update.js",
|
|
"gsd-config-reload.js",
|
|
"gsd-context-monitor.js",
|
|
"gsd-cursor-post-tool.js",
|
|
"gsd-cursor-pre-tool.js",
|
|
"gsd-cursor-session-start.js",
|
|
"gsd-cursor-stop.js",
|
|
"gsd-cursor-subagent-start.js",
|
|
"gsd-cursor-subagent-stop.js",
|
|
"gsd-ensure-canonical-path.js",
|
|
"gsd-graphify-update.sh",
|
|
"gsd-phase-boundary.sh",
|
|
"gsd-prompt-guard.js",
|
|
"gsd-read-guard.js",
|
|
"gsd-read-injection-scanner.js",
|
|
"gsd-session-state.sh",
|
|
"gsd-statusline.js",
|
|
"gsd-update-banner.js",
|
|
"gsd-validate-commit.sh",
|
|
"gsd-windsurf-pre-command.js",
|
|
"gsd-windsurf-pre-write.js",
|
|
"gsd-workflow-guard.js",
|
|
"gsd-worktree-path-guard.js"
|
|
]
|
|
}
|
|
}
|