specky-sdd 3.2.0 → 3.2.2

package/dist/templates/templates/runbook.md

@@ -0,0 +1,40 @@
+<!-- markdownlint-disable -->
+# Operational Runbook: {{title}}
+
+**Feature**: {{feature_id}}
+**Date**: {{date}}
+**Version**: {{version}}
+
+---
+
+## Deployment
+
+{{deployment_steps}}
+
+## Health Checks
+
+| Endpoint | Expected | Interval |
+|----------|----------|----------|
+{{#each health_checks}}
+| {{endpoint}} | {{expected}} | {{interval}} |
+{{/each}}
+
+## Monitoring & Alerts
+
+{{monitoring}}
+
+## Troubleshooting
+
+| Symptom | Cause | Resolution |
+|---------|-------|-----------|
+{{#each troubleshooting}}
+| {{symptom}} | {{cause}} | {{resolution}} |
+{{/each}}
+
+## Rollback Procedure
+
+{{rollback}}
+
+## Contacts
+
+{{contacts}}

package/dist/templates/templates/specification.md

@@ -0,0 +1,50 @@
+<!-- markdownlint-disable -->
+# {{project_name}} — Specification
+
+> All requirements use **EARS notation** (Easy Approach to Requirements Syntax). Each requirement is testable, unambiguous, and traceable to the Constitution's success criteria.
+
+---
+
+## Table of Contents
+
+- [1. Core Requirements](#1-core-requirements)
+- [2. Functional Requirements](#2-functional-requirements)
+- [3. Non-Functional Requirements](#3-non-functional-requirements)
+- [Acceptance Criteria Summary](#acceptance-criteria-summary)
+
+---
+
+## 1. Core Requirements
+
+{{requirements_core}}
+
+---
+
+## 2. Functional Requirements
+
+{{requirements_functional}}
+
+---
+
+## 3. Non-Functional Requirements
+
+{{requirements_nonfunctional}}
+
+---
+
+## Acceptance Criteria Summary
+
+| ID | Requirement | Test Method |
+|----|-------------|-------------|
+{{acceptance_criteria_table}}
+
+---
+
+## Self-Assessment
+
+| Criterion | Score | Notes |
+|-----------|-------|-------|
+| EARS notation compliance | {{ears_compliance}} | |
+| Testability | {{testability_score}} | Every requirement has acceptance criteria |
+| Traceability | {{traceability_score}} | Every requirement traces to Constitution |
+| Uniqueness of IDs | {{uniqueness_score}} | No duplicate requirement IDs |

package/dist/templates/templates/sync-report.md

@@ -0,0 +1,44 @@
+<!-- markdownlint-disable -->
+# Sync Report: {{project_name}}
+
+> Drift analysis between specification and implementation.
+
+---
+
+## Summary
+
+- **In Sync:** {{in_sync}}
+- **Last Checked:** {{last_checked}}
+- **Drift Items:** {{drift_count}}
+
+---
+
+## Requirements Coverage
+
+| Requirement | Implementation | Status |
+|-------------|---------------|--------|
+{{coverage_table}}
+
+---
+
+## Drift Items
+
+{{#each drift_items}}
+- {{this}}
+{{/each}}
+
+---
+
+## Orphan Code
+
+Files not traced to any requirement:
+
+{{#each orphan_files}}
+- {{this}}
+{{/each}}
+
+---
+
+## Recommendation
+
+{{recommendation}}

package/dist/templates/templates/tasks.md

@@ -0,0 +1,39 @@
+<!-- markdownlint-disable -->
+# {{project_name}} — Tasks
+
+> Sequenced implementation tasks with pre-implementation gates, `[P]` parallel markers, effort estimates, and requirement traceability.
+
+---
+
+## Pre-Implementation Gates
+
+Before writing any code, the following gates must pass:
+
+{{#each gates}}
+- [ ] {{this}}
+{{/each}}
+
+---
+
+## Task Breakdown
+
+| ID | Task | [P] | Effort | Depends On | Traces To |
+|----|------|-----|--------|------------|-----------|
+| {{task_table}} | | | | | |
+
+---
+
+## Dependency Graph
+
+```
+{{dependency_graph}}
+```
+
+---
+
+## Effort Summary
+
+| Phase | Tasks | Parallel | Effort |
+|-------|-------|----------|--------|
+| {{effort_summary}} | | | |
+| **Total** | **{{total_tasks}}** | **{{parallel_tasks}}** | **{{total_effort}}** |

package/dist/templates/templates/terraform.md

@@ -0,0 +1,38 @@
+<!-- markdownlint-disable -->
+# Infrastructure as Code: {{title}}
+
+**Feature**: {{feature_id}}
+**Provider**: {{provider}}
+**Cloud**: {{cloud}}
+**Date**: {{date}}
+
+---
+
+## Modules
+
+{{#each modules}}
+### {{name}}
+
+{{description}}
+
+**Resources**: {{resources}}
+
+{{/each}}
+
+## Variables
+
+| Name | Type | Description | Default | Required |
+|------|------|-------------|---------|----------|
+{{#each variables}}
+| {{name}} | {{type}} | {{description}} | {{default}} | {{required}} |
+{{/each}}
+
+## Architecture Diagram
+
+```mermaid
+{{diagram}}
+```
+
+## Validation
+
+Run `sdd_validate_iac` to validate this configuration via Terraform MCP.

package/dist/templates/templates/test-stub.md

@@ -0,0 +1,34 @@
+# Test Stubs — {{feature_name}}
+
+> Auto-generated by Specky SDD from acceptance criteria in SPECIFICATION.md and TASKS.md.
+
+---
+
+## Framework: {{framework}}
+
+## Traceability
+
+| Test ID | Requirement | Description |
+|---------|-------------|-------------|
+{{#each stubs}}
+| {{id}} | {{requirement_id}} | {{description}} |
+{{/each}}
+
+## Generated File
+
+- **Output:** `{{output_file}}`
+- **Total Tests:** {{total_tests}}
+- **Framework:** {{framework}}
+
+## Next Steps
+
+1. Open the generated test file at `{{output_file}}`
+2. Replace each `TODO: implement test` placeholder with real assertions
+3. Run your test suite to verify all stubs execute
+4. Map each passing test back to its requirement ID for traceability
+
+## Notes
+
+- Each test stub traces to an acceptance criterion from SPECIFICATION.md
+- Test IDs (TC-001, TC-002, ...) map to requirement IDs (REQ-001, REQ-002, ...)
+- Stubs are intentionally minimal — add setup, teardown, and assertions as needed

package/dist/templates/templates/user-stories.md

@@ -0,0 +1,39 @@
+<!-- markdownlint-disable -->
+# User Stories: {{title}}
+
+**Feature**: {{feature_id}}
+**Date**: {{date}}
+**Total Stories**: {{total_count}}
+
+---
+
+{{#each stories}}
+## {{id}}: {{title}} (Priority: {{priority}})
+
+{{description}}
+
+### Acceptance Criteria
+
+{{#each acceptance_criteria}}
+- [ ] {{this}}
+{{/each}}
+
+### Independent Test
+
+{{independent_test}}
+
+### User Flow
+
+```mermaid
+{{flow_diagram}}
+```
+
+---
+
+{{/each}}
+
+## Overview Diagram
+
+```mermaid
+{{overview_diagram}}
+```

package/dist/templates/templates/verification.md

@@ -0,0 +1,33 @@
+<!-- markdownlint-disable -->
+# Task Verification Report: {{title}}
+
+**Feature**: {{feature_id}}
+**Date**: {{date}}
+**Pass Rate**: {{pass_rate}}%
+
+---
+
+## Verification Results
+
+| Task | Claimed | Verified | Phantom? | Evidence |
+|------|---------|----------|----------|----------|
+{{#each results}}
+| {{task_id}} | {{claimed_status}} | {{verified_status}} | {{phantom}} | {{evidence}} |
+{{/each}}
+
+## Summary
+
+- **Total Tasks**: {{total_tasks}}
+- **Verified**: {{verified_count}}
+- **Phantom Completions**: {{phantom_count}}
+- **Pass Rate**: {{pass_rate}}%
+
+## Diagram
+
+```mermaid
+{{diagram}}
+```
+
+## Gate Decision
+
+{{gate_decision}}

package/dist/templates/templates/work-items.md

@@ -0,0 +1,27 @@
+<!-- markdownlint-disable -->
+# Work Items Export: {{title}}
+
+**Feature**: {{feature_id}}
+**Platform**: {{platform}}
+**Date**: {{date}}
+**Total Items**: {{total_items}}
+
+---
+
+## Export Summary
+
+| Task ID | Title | Traces To | Effort |
+|---------|-------|-----------|--------|
+{{#each items}}
+| {{task_id}} | {{title}} | {{traces_to}} | {{effort}} |
+{{/each}}
+
+## Routing Instructions
+
+- **MCP Server**: {{mcp_server}}
+- **Tool**: {{tool_name}}
+- **Note**: {{routing_note}}
+
+## Next Steps
+
+The AI client should call the {{platform}} MCP server for each work item above.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "specky-sdd",
-  "version": "3.2.0",
+  "version": "3.2.2",
   "description": "Specky — 57 MCP tools for Spec-Driven Development. 10-phase pipeline, enterprise security (rate limiting, HMAC state integrity, RBAC, hash-chained audit), model routing guidance, context tiering, cognitive debt metrics, EARS notation, 17 diagram types.",
   "type": "module",
   "main": "dist/index.js",