d1f7ba82f2
Add a non-blocking, warn-only codebase-drift gate at plan:pre so a stale STRUCTURE.md is surfaced before /gsd:plan-phase spawns the planner, instead of being discovered mid-execution by the existing execute:wave:post gate. Gated on a dedicated workflow.plan_drift_precheck toggle (default true), independent of schema_drift_gate. Never blocks planning, never spawns the mapper agent at plan time. Review feedback (#1595): - Use a documented conventional-commit type (feat, not enhance) per CONTRIBUTING.md / gsd-validate-commit.sh. - Normalize the plan_drift_precheck command references to the colon prose form (/gsd:plan-phase, /gsd:map-codebase) to match plan-phase.md §5.65; registry regenerated from capability.json. - Make the test temp dirs hermetic: drain mkdtemp dirs in an after() hook via the helpers.cleanup() budget (local/no-raw-rmsync-in-tests-compliant). Closes #1592 Claude-Session: https://claude.ai/code/session_016JBiXEAofvB3prJim29XMS
79 lines
3.0 KiB
JSON
79 lines
3.0 KiB
JSON
{
|
|
"id": "drift",
|
|
"role": "feature",
|
|
"version": "1.6.0-rc.2",
|
|
"title": "Drift detection gates",
|
|
"description": "Drift detection gates for the planning loop. At execute:wave:post: a blocking schema drift gate (detects schema files changed without a database push) and a non-blocking codebase drift gate (detects structural additions not reflected in STRUCTURE.md). At plan:pre: a non-blocking, warn-only codebase drift gate (gated on workflow.plan_drift_precheck) that flags a stale codebase map before planning, so plans are authored against a fresh STRUCTURE.md instead of discovering drift mid-execution.",
|
|
"tier": "full",
|
|
"requires": [],
|
|
"engines": {
|
|
"gsd": ">=1.6.0"
|
|
},
|
|
"runtimeCompat": {
|
|
"supported": [
|
|
"*"
|
|
],
|
|
"unsupported": []
|
|
},
|
|
"skills": [],
|
|
"agents": [],
|
|
"hooks": [],
|
|
"config": {
|
|
"workflow.drift_threshold": {
|
|
"type": "number",
|
|
"default": 3,
|
|
"description": "Minimum number of new structural elements (directories, barrel exports, migrations, routes) before the codebase drift gate triggers a warn or auto-remap action."
|
|
},
|
|
"workflow.drift_action": {
|
|
"type": "enum",
|
|
"values": [
|
|
"warn",
|
|
"auto-remap"
|
|
],
|
|
"default": "warn",
|
|
"description": "Action taken by the codebase drift gate when the threshold is exceeded: warn (advisory message) or auto-remap (spawn gsd-codebase-mapper agent to refresh STRUCTURE.md)."
|
|
},
|
|
"workflow.schema_drift_gate": {
|
|
"type": "boolean",
|
|
"default": true,
|
|
"description": "Enable the drift gates at execute:wave:post. When enabled, the schema drift gate blocks verification if schema-relevant files changed during execution but no database push command was executed; the codebase drift gate (non-blocking) warns when structural additions exceed the drift_threshold."
|
|
},
|
|
"workflow.plan_drift_precheck": {
|
|
"type": "boolean",
|
|
"default": true,
|
|
"description": "Enable the non-blocking codebase drift pre-check at plan:pre, before /gsd:plan-phase spawns the planner. When enabled, a stale STRUCTURE.md (structural additions exceeding drift_threshold) is surfaced up front as a warn-only advisory pointing to /gsd:map-codebase; it never blocks planning and never spawns the mapper agent. Separate from schema_drift_gate so autonomous/CI runs can silence the plan-time advisory while keeping the execute:wave:post gates enabled."
|
|
}
|
|
},
|
|
"steps": [],
|
|
"contributions": [],
|
|
"gates": [
|
|
{
|
|
"point": "execute:wave:post",
|
|
"check": {
|
|
"query": "verify.schema-drift"
|
|
},
|
|
"when": "workflow.schema_drift_gate",
|
|
"blocking": true,
|
|
"onError": "skip"
|
|
},
|
|
{
|
|
"point": "execute:wave:post",
|
|
"check": {
|
|
"query": "verify.codebase-drift"
|
|
},
|
|
"when": "workflow.schema_drift_gate",
|
|
"blocking": false,
|
|
"onError": "skip"
|
|
},
|
|
{
|
|
"point": "plan:pre",
|
|
"check": {
|
|
"query": "verify.codebase-drift"
|
|
},
|
|
"when": "workflow.plan_drift_precheck",
|
|
"blocking": false,
|
|
"onError": "skip"
|
|
}
|
|
]
|
|
}
|