opencode-goopspec 0.1.3 → 0.1.4

package/templates/blueprint.md

@@ -2,6 +2,7 @@
 
 **Spec Version:** {{spec_version}}
 **Created:** {{created_date}}
+**Last Updated:** {{updated_date}}
 **Mode:** {{mode}}
 
 ---
@@ -12,8 +13,26 @@
 
 **Approach:** {{approach}}
 
-**Waves:** {{wave_count}}
-**Estimated Tasks:** {{task_count}}
+| Metric | Value |
+|--------|-------|
+| Waves | {{wave_count}} |
+| Total Tasks | {{task_count}} |
+| Parallel Execution | {{parallel_percentage}}% |
+| Estimated Effort | {{estimated_effort}} |
+
+---
+
+## Spec Mapping
+
+Every must-have from SPEC.md is covered:
+
+| Must-Have | Tasks | Coverage |
+|-----------|-------|----------|
+{{#spec_mapping}}
+| MH{{number}}: {{title}} | {{tasks}} | {{coverage}} |
+{{/spec_mapping}}
+
+**Total Coverage:** {{total_coverage}}%
 
 ---
 
@@ -21,8 +40,10 @@
 
 ```
 {{#waves}}
-Wave {{number}}: {{name}} {{#parallel}}(parallel){{/parallel}}{{^parallel}}(sequential){{/parallel}}
-{{#depends_on}}  └── depends on Wave {{.}}{{/depends_on}}
+Wave {{number}}: {{name}} {{#parallel}}[PARALLEL]{{/parallel}}{{^parallel}}[SEQUENTIAL]{{/parallel}}
+{{#tasks}}  ├── Task {{wave}}.{{number}}: {{name}}
+{{/tasks}}{{#depends_on}}  └── depends on Wave {{.}}
+{{/depends_on}}
 {{/waves}}
 ```
 
@@ -32,17 +53,31 @@ Wave {{number}}: {{name}} {{#parallel}}(parallel){{/parallel}}{{^parallel}}(sequ
 ## Wave {{number}}: {{name}}
 
 **Goal:** {{goal}}
-**Parallel:** {{#parallel}}Yes — tasks can run concurrently{{/parallel}}{{^parallel}}No — sequential execution{{/parallel}}
-{{#depends_on}}
-**Depends On:** Wave {{.}}
-{{/depends_on}}
 
-### Tasks
+**Execution:** {{#parallel}}Parallel — tasks can run concurrently{{/parallel}}{{^parallel}}Sequential — tasks must run in order{{/parallel}}
+
+{{#depends_on}}**Depends On:** Wave {{.}} must complete first{{/depends_on}}
+
+### Verification Matrix
+
+| Check | Command | Expected |
+|-------|---------|----------|
+{{#verification_matrix}}
+| {{check}} | `{{command}}` | {{expected}} |
+{{/verification_matrix}}
+
+---
 
 {{#tasks}}
 ### Task {{wave}}.{{number}}: {{name}}
 
-**Intent:** {{intent}}
+| Attribute | Value |
+|-----------|-------|
+| **Intent** | {{intent}} |
+| **Parallel** | {{#parallel}}Yes{{/parallel}}{{^parallel}}No{{/parallel}} |
+{{#depends_on}}| **Depends On** | Task {{depends_on}} |{{/depends_on}}
+{{#blocks}}| **Blocks** | Task {{blocks}} |{{/blocks}}
+| **Spec Coverage** | {{spec_coverage}} |
 
 **Deliverables:**
 {{#deliverables}}
@@ -51,30 +86,25 @@ Wave {{number}}: {{name}} {{#parallel}}(parallel){{/parallel}}{{^parallel}}(sequ
 
 **Files:**
 {{#files}}
-- `{{.}}`
+- `{{path}}` — {{action}}
 {{/files}}
 
 **Verification:**
 ```bash
-{{verification}}
+{{verification_command}}
 ```
 
 **Acceptance:**
 {{acceptance}}
 
-{{#blocks}}
-**Blocks:** {{blocks}}
-{{/blocks}}
-
 ---
 
 {{/tasks}}
-
 {{/waves}}
 
 ## Verification Checklist
 
-Before marking complete:
+Before marking blueprint complete:
 
 {{#verification_checklist}}
 - [ ] {{.}}
@@ -82,25 +112,22 @@ Before marking complete:
 
 ---
 
-## Must-Haves Traceability
+## Risk Assessment
 
-Mapping tasks to spec requirements:
+{{#risks}}
+### Risk: {{title}}
 
-| Must-Have | Covered By |
-|-----------|------------|
-{{#must_have_mapping}}
-| {{must_have}} | Wave {{wave}}, Task {{task}} |
-{{/must_have_mapping}}
+| Attribute | Value |
+|-----------|-------|
+| Likelihood | {{likelihood}} |
+| Impact | {{impact}} |
+| Affected Tasks | {{affected_tasks}} |
 
----
+**Mitigation:** {{mitigation}}
 
-## Risk Assessment
+**Contingency:** {{contingency}}
 
-{{#risks}}
-### {{risk}}
-- **Likelihood:** {{likelihood}}
-- **Impact:** {{impact}}
-- **Mitigation:** {{mitigation}}
+---
 {{/risks}}
 
 {{^risks}}
@@ -109,33 +136,53 @@ No significant risks identified.
 
 ---
 
+## Deviation Protocol
+
+If issues are encountered during execution:
+
+| Rule | Trigger | Action |
+|------|---------|--------|
+| **Rule 1** | Bug found in existing code | Auto-fix, document in CHRONICLE |
+| **Rule 2** | Missing critical functionality | Auto-add, document in CHRONICLE |
+| **Rule 3** | Blocking issue (deps, imports) | Auto-fix, document in CHRONICLE |
+| **Rule 4** | Architectural decision needed | **STOP**, ask user, log to memory |
+
+---
+
 ## Execution Notes
 
 ### For Orchestrator
 - Delegate ALL code tasks to executor agents
 - Track progress in CHRONICLE.md
-- Save to memory at wave boundaries
+- Save checkpoint at wave boundaries
+- Generate HANDOFF.md when suggesting new session
 - Confirm with user at CONTRACT GATES
 
 ### For Subagents
 - Read SPEC.md for requirements
 - Check CHRONICLE.md for context
+- Load PROJECT_KNOWLEDGE_BASE.md for conventions
 - Use memory_search before decisions
 - Persist learnings with memory_save
+- Return XML response envelope
 
----
+### Parallel Execution Rules
+- Tasks within a parallel wave can run concurrently
+- Wait for all tasks in wave before proceeding to next wave
+- If any task blocks, continue others and handle blocker separately
 
-## Deviation Protocol
+---
 
-If you encounter issues:
+## Handoff Protocol
 
-1. **Bug Found** → Auto-fix, document in CHRONICLE.md
-2. **Missing Functionality** → Auto-add if critical, document
-3. **Blocking Issue** → Auto-fix (deps, imports), document
-4. **Architectural Decision** → STOP, ask user, log to memory
+At wave boundaries:
+1. Update CHRONICLE.md with completed tasks
+2. Save checkpoint with goop_checkpoint
+3. If context full or natural pause, generate HANDOFF.md
+4. Suggest: "Start new session and run `/goop-execute`"
 
 ---
 
 *Blueprint derived from SPEC.md*
 *Execute with confidence — the plan is the contract*
-*GoopSpec v0.1.0*
+*GoopSpec v0.1.4*

package/templates/chronicle.md

@@ -2,6 +2,7 @@
 
 **Last Updated:** {{last_updated}}
 **Current Phase:** {{current_phase}}
+**Session:** {{session_id}}
 
 ---
 
@@ -15,10 +16,12 @@
 
 | Metric | Value |
 |--------|-------|
+| Phase | {{current_phase}} |
+| Interview Complete | {{interview_complete}} |
+| Spec Locked | {{spec_locked}} |
 | Waves Completed | {{waves_completed}}/{{waves_total}} |
-| Tasks Done | {{tasks_completed}} |
+| Tasks Done | {{tasks_completed}}/{{tasks_total}} |
 | Time Invested | {{total_time}} |
-| Current Mode | {{mode}} |
 
 ---
 
@@ -28,31 +31,93 @@
 
 **Status:** {{wave_status}}
 **Started:** {{wave_started}}
+**Execution:** {{#parallel}}Parallel{{/parallel}}{{^parallel}}Sequential{{/parallel}}
 
 **Tasks:**
 {{#wave_tasks}}
-- [{{status}}] {{name}}
+- [{{status}}] Task {{wave}}.{{number}}: {{name}} {{#commit}}(`{{commit}}`){{/commit}}
 {{/wave_tasks}}
 
-**Blockers:**
+**Progress:** {{wave_progress}}%
+
+---
+
+## Active Blockers
+
 {{#blockers}}
-- **[{{severity}}]** {{description}}
+### {{title}}
+
+| Attribute | Value |
+|-----------|-------|
+| Severity | {{severity}} |
+| Type | {{type}} |
+| Blocking | Task {{blocking_task}} |
+| Since | {{since}} |
+
+**Description:** {{description}}
+
+**Resolution:** {{resolution}}
+
+---
 {{/blockers}}
+
 {{^blockers}}
-None
+No active blockers.
 {{/blockers}}
 
 ---
 
+## Pending Decisions
+
+Decisions awaiting user input (Rule 4 deviations):
+
+{{#pending_decisions}}
+### {{title}}
+
+**Context:** {{context}}
+
+**Options:**
+{{#options}}
+- **{{label}}:** {{description}}
+{{/options}}
+
+**Recommendation:** {{recommendation}}
+
+**Impact:** {{impact}}
+
+---
+{{/pending_decisions}}
+
+{{^pending_decisions}}
+No pending decisions.
+{{/pending_decisions}}
+
+---
+
 ## Recent Activity
 
 {{#recent_activity}}
-### {{timestamp}}
-- **Action:** {{action}}
-- **Outcome:** {{outcome}}
+### {{timestamp}} — {{agent}}
+
+**Action:** {{action}}
+
+**Outcome:** {{outcome}}
+
+{{#files_changed}}
+**Files:** {{files_changed}}
+{{/files_changed}}
+
+{{#commit}}
+**Commit:** `{{commit}}` — {{commit_message}}
+{{/commit}}
+
 {{#decision}}
-- **Decision:** {{decision}} — *Reason: {{reason}}*
+**Decision:** {{decision}}
+- Reason: {{reason}}
+- Saved to memory: {{saved_to_memory}}
 {{/decision}}
+
+---
 {{/recent_activity}}
 
 ---
@@ -63,10 +128,18 @@ Significant choices captured for future reference.
 
 {{#decisions}}
 ### {{date}}: {{title}}
-- **Choice:** {{choice}}
-- **Alternatives:** {{alternatives}}
-- **Reasoning:** {{reasoning}}
-- **Impact:** {{impact}}
+
+| Attribute | Value |
+|-----------|-------|
+| Choice | {{choice}} |
+| Alternatives | {{alternatives}} |
+| Impact | {{impact}} |
+
+**Reasoning:** {{reasoning}}
+
+**Memory ID:** {{memory_id}}
+
+---
 {{/decisions}}
 
 {{^decisions}}
@@ -81,6 +154,8 @@ Insights gained during this journey.
 
 {{#learnings}}
 - **{{topic}}:** {{insight}}
+  - Discovered: {{discovered_at}}
+  - Memory: {{memory_id}}
 {{/learnings}}
 
 {{^learnings}}
@@ -89,6 +164,22 @@ No learnings captured yet.
 
 ---
 
+## Session History
+
+### Current Session
+- Started: {{session_start}}
+- Tasks Completed: {{session_tasks_completed}}
+- Commits: {{session_commits}}
+
+### Previous Sessions
+{{#previous_sessions}}
+| Session | Date | Accomplishments |
+|---------|------|-----------------|
+| {{session_id}} | {{date}} | {{accomplishments}} |
+{{/previous_sessions}}
+
+---
+
 ## Checkpoints
 
 Saved positions for recovery.
@@ -105,6 +196,21 @@ No checkpoints saved.
 
 ---
 
+## Handoff History
+
+{{#handoffs}}
+### {{timestamp}}
+- Phase: {{phase}}
+- Next Command: `{{next_command}}`
+- Handoff File: `{{handoff_file}}`
+{{/handoffs}}
+
+{{^handoffs}}
+No handoffs generated yet.
+{{/handoffs}}
+
+---
+
 ## Memory Integration
 
 ### Recent Memory Entries
@@ -131,6 +237,11 @@ No checkpoints saved.
 - {{.}}
 {{/after_wave}}
 
+### Suggested Command
+```
+{{next_command}}
+```
+
 ---
 
 ## Quick Commands
@@ -143,7 +254,10 @@ No checkpoints saved.
 /goop-execute
 
 # Save checkpoint
-/goop-checkpoint
+/goop-pause
+
+# Resume from checkpoint
+/goop-resume
 
 # Search past work
 /goop-recall "{{query}}"
@@ -153,4 +267,4 @@ No checkpoints saved.
 
 *Chronicle auto-updated by GoopSpec after each action*
 *This is your journey log — decisions persist, context flows*
-*GoopSpec v0.1.0*
+*GoopSpec v0.1.4*

package/templates/handoff.md

@@ -0,0 +1,140 @@
+# Session Handoff
+
+**Generated:** {{generated_timestamp}}
+**Phase:** {{current_phase}}
+**Session:** {{session_id}}
+
+---
+
+## Accomplished This Session
+
+### Completed Tasks
+{{#completed_tasks}}
+- [x] {{task_id}}: {{description}} {{#commit}}(commit: `{{commit}}`){{/commit}}
+{{/completed_tasks}}
+
+### Key Outcomes
+{{#key_outcomes}}
+- {{.}}
+{{/key_outcomes}}
+
+### Decisions Made
+{{#decisions}}
+- **{{title}}**: {{choice}} — {{rationale}}
+{{/decisions}}
+
+---
+
+## Current State
+
+### Workflow Position
+| Attribute | Value |
+|-----------|-------|
+| **Phase** | {{phase}} |
+| **Spec Locked** | {{spec_locked}} |
+| **Wave** | {{current_wave}} of {{total_waves}} |
+| **Task** | {{current_task}} of {{total_tasks}} |
+
+### Files Modified
+{{#files_modified}}
+- `{{path}}` — {{description}}
+{{/files_modified}}
+
+### Commits Made
+{{#commits}}
+- `{{sha}}` — {{message}}
+{{/commits}}
+
+---
+
+## Next Session Instructions
+
+### Command to Run
+```
+{{next_command}}
+```
+
+### Files to Read First
+{{#files_to_read}}
+1. `{{path}}` — {{reason}}
+{{/files_to_read}}
+
+### Context Summary
+
+{{context_summary}}
+
+### Immediate Next Task
+
+**Task:** {{next_task_id}} — {{next_task_name}}
+
+**Files:** 
+{{#next_task_files}}
+- `{{.}}`
+{{/next_task_files}}
+
+**Action:** {{next_task_action}}
+
+**Verify:** `{{next_task_verify}}`
+
+---
+
+## Warnings & Blockers
+
+### Active Blockers
+{{#blockers}}
+- **{{title}}**: {{description}}
+  - Type: {{type}}
+  - Resolution: {{resolution}}
+{{/blockers}}
+
+{{^blockers}}
+None — clear to proceed.
+{{/blockers}}
+
+### Gotchas Discovered
+{{#gotchas}}
+- {{.}}
+{{/gotchas}}
+
+{{^gotchas}}
+None discovered this session.
+{{/gotchas}}
+
+### Pending Decisions
+{{#pending_decisions}}
+- **{{title}}**: {{description}}
+  - Options: {{options}}
+  - Recommendation: {{recommendation}}
+{{/pending_decisions}}
+
+{{^pending_decisions}}
+None — no user input needed.
+{{/pending_decisions}}
+
+---
+
+## Memory Saved
+
+Key learnings persisted to memory this session:
+
+{{#memory_saved}}
+- **{{title}}** ({{type}}, importance: {{importance}})
+{{/memory_saved}}
+
+---
+
+## Resume Checklist
+
+For the next session:
+
+- [ ] Start new session for fresh context
+- [ ] Run: `{{next_command}}`
+- [ ] Read files listed above
+- [ ] Continue with immediate next task
+
+---
+
+*Start a new session for fresh 200k context window.*
+*All state is preserved in GoopSpec files.*
+
+*Session Handoff — GoopSpec v0.1.4*

package/templates/project.md

@@ -0,0 +1,114 @@
+# PROJECT: {{project_name}}
+
+**Type:** {{project_type}}
+**Created:** {{created_date}}
+**Status:** Active
+
+---
+
+## Vision
+
+{{vision_statement}}
+
+### Why This Matters
+{{why_it_matters}}
+
+### Target Users
+{{target_users}}
+
+---
+
+## Success Criteria
+
+When complete, we will have:
+
+{{#success_criteria}}
+- {{.}}
+{{/success_criteria}}
+
+---
+
+## Technical Foundation
+
+### Stack
+| Layer | Technology | Version |
+|-------|------------|---------|
+| Runtime | {{runtime}} | {{runtime_version}} |
+| Language | {{language}} | {{language_version}} |
+| Framework | {{framework}} | {{framework_version}} |
+| Database | {{database}} | {{database_version}} |
+| Testing | {{testing}} | {{testing_version}} |
+
+### Key Dependencies
+{{#dependencies}}
+- `{{name}}`: {{purpose}}
+{{/dependencies}}
+
+---
+
+## Conventions
+
+### Naming
+- **Files:** {{file_naming}}
+- **Functions:** {{function_naming}}
+- **Components:** {{component_naming}}
+- **Constants:** {{constant_naming}}
+
+### Code Style
+- **Exports:** {{export_style}}
+- **Types:** {{type_style}}
+- **Error Handling:** {{error_handling}}
+
+### Git
+- **Branch Format:** {{branch_format}}
+- **Commit Format:** {{commit_format}}
+- **PR Process:** {{pr_process}}
+
+---
+
+## Architecture Overview
+
+{{architecture_description}}
+
+### Directory Structure
+```
+{{directory_structure}}
+```
+
+### Key Integration Points
+{{#integration_points}}
+- **{{name}}:** {{description}}
+{{/integration_points}}
+
+---
+
+## Boundaries
+
+### Always Do
+{{#always_do}}
+- {{.}}
+{{/always_do}}
+
+### Ask First
+{{#ask_first}}
+- {{.}}
+{{/ask_first}}
+
+### Never Do
+{{#never_do}}
+- {{.}}
+{{/never_do}}
+
+---
+
+## Milestones
+
+| Milestone | Status | Target |
+|-----------|--------|--------|
+{{#milestones}}
+| {{name}} | {{status}} | {{target_date}} |
+{{/milestones}}
+
+---
+
+*Project foundation document - GoopSpec v0.1.4*