6addeccd19
Full API Coverage by Default — Opt Out, Never Opt In. A phase that integrates an external API/SDK/service can no longer seal without a decided coverage matrix. - src/api-coverage.cts: deterministic detector (compound verb+noun signal + <Service> API/SDK surface; stopword-guarded; strips fenced code) + matrix parse/validate/render with field-length caps. - check api-coverage.verify-pre: blocking seal-time gate; phase arg resolved as a token under .planning/phases/ only (traversal-neutralized); validates COVERAGE.md or blocks iff a strong integration signal is detected and no matrix exists; fail-closed when phases tree exists but phase unresolvable. - capabilities/ai-integration: workflow.api_coverage_gate config key (default true), plan:pre contribution, blocking verify:pre gate. Data-driven. - gsd-core/workflows/verify-work.md: generic verify:pre gate dispatch. - Tests: detector FP/FN + matrix validation + fast-check bijection; gate e2e. Code+security review findings fixed (stopword FP, scope containment, pipe/cap rejection, prompt-injection message hygiene). - Regenerated registry/matrix/loop-host-contract/goldens/baseline + docs. Closes #1562
85 lines
2.2 KiB
JSON
85 lines
2.2 KiB
JSON
{
|
|
"id": "ai-integration",
|
|
"role": "feature",
|
|
"version": "1.7.0-rc.4",
|
|
"title": "AI design contract",
|
|
"description": "AI-SPEC design contract workflow for phases that build AI systems; owns the AI integration command, agents, and workflow.ai_integration_phase activation key.",
|
|
"tier": "full",
|
|
"requires": [],
|
|
"engines": {
|
|
"gsd": ">=1.6.0"
|
|
},
|
|
"runtimeCompat": {
|
|
"supported": [
|
|
"*"
|
|
],
|
|
"unsupported": []
|
|
},
|
|
"skills": [
|
|
"ai-integration-phase"
|
|
],
|
|
"agents": [
|
|
"gsd-framework-selector",
|
|
"gsd-ai-researcher",
|
|
"gsd-domain-researcher",
|
|
"gsd-eval-planner"
|
|
],
|
|
"hooks": [],
|
|
"config": {
|
|
"workflow.ai_integration_phase": {
|
|
"type": "boolean",
|
|
"default": true,
|
|
"description": "Prompt for an AI-SPEC design contract before planning phases that involve AI systems."
|
|
},
|
|
"workflow.api_coverage_gate": {
|
|
"type": "boolean",
|
|
"default": true,
|
|
"description": "Require an explicit API-coverage decision (full-by-default, opt-out-not-opt-in) before a phase that integrates an external API/SDK/service can seal. At plan:pre the planner is prompted to enumerate the API surface into COVERAGE.md; at verify:pre a blocking gate fails the seal unless the matrix exists with every non-integrated capability an explicit, reasoned opt-out. Independent of ai_integration_phase (applies to any external-API integration, not only AI)."
|
|
}
|
|
},
|
|
"steps": [
|
|
{
|
|
"point": "plan:pre",
|
|
"ref": {
|
|
"skill": "ai-integration-phase"
|
|
},
|
|
"produces": [
|
|
"AI-SPEC.md"
|
|
],
|
|
"consumes": [
|
|
"CONTEXT.md"
|
|
],
|
|
"when": "workflow.ai_integration_phase",
|
|
"onError": "skip"
|
|
}
|
|
],
|
|
"contributions": [
|
|
{
|
|
"point": "plan:pre",
|
|
"into": "planner",
|
|
"fragment": {
|
|
"path": "fragments/api-coverage-plan-pre.md"
|
|
},
|
|
"produces": [
|
|
"COVERAGE.md"
|
|
],
|
|
"consumes": [
|
|
"CONTEXT.md"
|
|
],
|
|
"when": "workflow.api_coverage_gate",
|
|
"onError": "skip"
|
|
}
|
|
],
|
|
"gates": [
|
|
{
|
|
"point": "verify:pre",
|
|
"check": {
|
|
"query": "api-coverage.verify-pre"
|
|
},
|
|
"when": "workflow.api_coverage_gate",
|
|
"blocking": true,
|
|
"onError": "halt"
|
|
}
|
|
]
|
|
}
|