feat: consume gates in advance-pipeline smoke path

CHANGELOG.md

@@ -8,6 +8,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [Unreleased]
 
 ### Added
+- `scripts/advance-pipeline.py` gate consumption with STATE/STATUS updates, retry handling, and BLOCKED escalation after repeated gate failures.
+- Greenfield CLI smoke fixture and tests covering RESEARCH to SPEC advancement through `examples/greenfield-cli-tool`.
 - Framework-owned templates for status, state, agent instructions, ADRs, manual-engine specs, handoff schema, and cron prompt skeletons.
 - Machine-verifiable gate templates for all nine pipeline phases.
 - `scripts/validate-templates.py` and template tests for the M1 template set.

examples/greenfield-cli-tool/.sdd/gates/research.json

@@ -0,0 +1,10 @@
+{
+  "checks": {
+    "research_doc_exists": true,
+    "approaches_compared": 2,
+    "citations_present": true,
+    "tradeoffs_recorded": true,
+    "next_phase": "SPEC",
+    "next_step": "Draft the CLI tool spec from the accepted research direction."
+  }
+}

examples/greenfield-cli-tool/STATE.json

@@ -0,0 +1,21 @@
+{
+  "phase": "RESEARCH",
+  "next_step": "Review research evidence and advance to SPEC.",
+  "spec": "openspec/project.md",
+  "plan": ".sdd/plans/README.md",
+  "branch": "main",
+  "worktree": ".",
+  "last_commit": "0000000",
+  "last_agent": "human",
+  "last_update": "2026-05-12T10:00:00Z",
+  "lock": {
+    "agent": "none",
+    "started_at": "1970-01-01T00:00:00Z",
+    "ttl_minutes": 1
+  },
+  "retry_count": 0,
+  "last_error": null,
+  "flavor": "software",
+  "spec_engine": "manual",
+  "handoff_backend": "local"
+}

examples/greenfield-cli-tool/STATUS.md

@@ -0,0 +1,19 @@
+# Greenfield CLI Tool Status
+
+## Current state
+
+- Phase: RESEARCH
+- Next step: Review research evidence and advance to SPEC.
+- Blockers: none
+- Updated at: 2026-05-12T10:00:00Z
+- Owner: human
+
+## History
+
+| Date | Phase | Change | Agent/operator |
+|------|-------|--------|----------------|
+| 2026-05-12 | RESEARCH | Initial research fixture created. | human |
+
+## Notes
+
+Smoke fixture for `scripts/advance-pipeline.py`.

examples/greenfield-cli-tool/docs/research/2026-05-12-cli-tool.md

@@ -0,0 +1,29 @@
+# Greenfield CLI Tool Research
+
+## Problem
+
+Build a tiny CLI project fixture that can exercise the SDD Framework phase transition from RESEARCH to SPEC without external services.
+
+## Approaches Compared
+
+### Python argparse CLI
+
+Uses only the Python standard library, which keeps the fixture portable and aligned with the framework's no-runtime-dependency rule for scripts.
+
+### Click-based CLI
+
+Provides a richer command authoring model, but adds a dependency that is unnecessary for this fixture.
+
+## Decision
+
+Use a standard-library Python CLI fixture for the smoke path.
+
+## Tradeoffs
+
+- Standard-library code keeps the example easy to run in CI.
+- The example is intentionally minimal and does not represent a full application scaffold.
+
+## Citations
+
+- Python argparse documentation: https://docs.python.org/3/library/argparse.html
+- SDD Framework PLAN.md: ../../../../PLAN.md