@dragonflymcp/plugin 1.0.0

package/templates/synchronizations/main.sync.template

@@ -0,0 +1,319 @@
+# Consolidated Synchronization DSL
+# Replaces 20 YAML files (~11,000 lines) with compact rule definitions
+#
+# WYSIWID Principle: This file IS the workflow logic
+# Read this file to understand exactly what happens and when
+#
+# DSL Syntax:
+#   trigger -> action @slo [condition]
+#
+# Examples:
+#   story.create:completed -> architecture.design:opus @architecture
+#   code-analysis:completed -> architecture.design:opus @architecture [parallel]
+#
+# Version: 1.0.0
+# Generated: 2026-01-30
+
+# === IMPORTS ===
+# SLO profiles defined in slo-registry.yaml
+# Error policies defined in error-policy.yaml
+
+# ============================================================================
+# WORKFLOWS - Named pipeline configurations
+# ============================================================================
+
+workflows:
+  # Standard feature workflow (full pipeline)
+  feature:
+    pipeline: story | parallel(code-analysis, security) | architecture | verification[2] | implementation | parallel(quality.review, quality.test) | version
+    slo: standard
+    errors: graceful
+
+  # Quick bugfix (skip verification)
+  bugfix:
+    pipeline: story | implementation | quality | version
+    slo: fast
+    errors: strict
+
+  # Documentation-only workflow
+  docs:
+    pipeline: story | implementation | version
+    slo: fast
+    errors: lenient
+
+  # Refactoring workflow (thorough verification)
+  refactor:
+    pipeline: story | code-analysis | architecture | verification[2] | implementation | quality | version
+    slo: thorough
+    errors: strict
+
+# ============================================================================
+# CORE WORKFLOW RULES
+# ============================================================================
+
+rules:
+  # --- Phase 0: Story Clarification (Optional) ---
+
+  # Ask for clarification when story is ambiguous
+  - story.create[clarity=ambiguous]:completed -> ask_user(story_ambiguous) @quick
+
+  # --- Phase 1A: Story -> Parallel Analysis ---
+
+  # Story ready triggers parallel code analysis and security
+  - story.create[ready]:completed -> code-analysis.context:sonnet @mcp [parallel]
+  - story.create[ready]:completed -> security.threat_model:sonnet @mcp [parallel]
+
+  # --- Phase 1B: Context Injection ---
+
+  # Inject global learnings before architecture design starts
+  - architecture.design:starting -> inject_context(global_patterns) @zero
+
+  # --- Phase 1C: Analysis -> Architecture ---
+
+  # Code analysis triggers architecture (waits for both parallel steps)
+  - code-analysis.context:completed -> architecture.design:opus @architecture
+  - code-analysis.context:failed -> architecture.design:opus @architecture [skip_analysis=true]
+  - code-analysis.context:skipped -> architecture.design:opus @architecture [skip_analysis=true]
+
+  # --- Phase 2: Architecture -> Verification ---
+
+  # Multi-pass verification for non-trivial architectures
+  - architecture.design:completed -> verification.verify[pass=1]:sonnet @verification [risk != low]
+  - verification.verify[pass=1]:completed -> verification.verify[pass=2]:sonnet @verification
+  - verification.verify[pass=2]:completed -> verification.consensus:sonnet @quick
+
+  # Skip verification for low-risk changes
+  - architecture.design[risk=low]:completed -> implementation.generate:sonnet @implementation
+
+  # --- Phase 2.5: Verification Outcomes ---
+
+  # Verification approved -> implementation
+  - verification.consensus[approve]:completed -> implementation.generate:sonnet @implementation
+  - verification.consensus[approve_with_notes]:completed -> implementation.generate:sonnet @implementation
+
+  # Verification blocked -> architecture revision
+  - verification.consensus[block]:completed -> architecture.revise:opus @architecture
+  - verification.consensus[revise]:completed -> architecture.revise:opus @architecture
+
+  # --- Phase 2.7: Auto Test Generation (MCP) ---
+
+  # Generate tests in parallel with implementation
+  - implementation.generate:completed -> quality.generate_tests:sonnet @test_generation [parallel, mcp]
+
+  # --- Phase 3: Implementation -> Quality ---
+
+  # Implementation triggers parallel quality checks
+  - implementation.generate:completed -> quality.review:sonnet @quality [parallel]
+  - implementation.generate:completed -> quality.test:sonnet @quality [parallel, test_files.length > 0]
+
+  # --- Phase 3.5: Self-Repair Loop (MCP) ---
+
+  # Test failures trigger self-repair
+  - quality.test:failed -> quality.self_repair:sonnet @execution_loop [repair_attempts < 3, mcp]
+  - quality.self_repair:succeeded -> quality.test:sonnet @quality
+  - quality.self_repair:failed -> ask_user(repair_failed) @quick [repair_attempts >= 3]
+
+  # --- Phase 4: Quality -> Version ---
+
+  # Commit when both quality checks pass
+  - quality.all:completed -> version.commit:sonnet @quick [review.approved, test.passed]
+  - quality.review:approved -> version.commit:sonnet @quick [test.skipped OR test.passed]
+
+  # --- Phase 4B: Auto-complete Story ---
+
+  # Mark story complete after successful commit
+  - version.commit:completed -> story.complete:sonnet @quick [flow.completed]
+
+# ============================================================================
+# CONTEXT MANAGEMENT RULES
+# ============================================================================
+
+context:
+  # Create checkpoint before compression
+  - usage >= 70% AND last_checkpoint < 70% -> checkpoint.create:haiku @quick [name="pre-compress"]
+
+  # Compress context when approaching limit
+  - usage >= 75% -> context.compress:sonnet @context
+
+  # Emergency snapshot at high usage
+  - usage >= 90% -> context.snapshot:sonnet @context [reset_to="5K_summary"]
+
+# ============================================================================
+# LEARNING LOOP RULES
+# ============================================================================
+
+learning:
+  # Extract patterns from successful zero-rework implementations
+  - quality.review[approved, rework_cycles=0]:completed -> retrospective.extract_pattern:sonnet @quick
+
+  # Extract learnings from implementations that needed changes
+  - quality.review[needs_changes]:completed -> retrospective.extract_learning:sonnet @quick
+
+  # Analyze workflow after completion
+  - version.commit[flow.completed]:completed -> retrospective.analyze_workflow:sonnet @quick
+
+  # Auto-remember architecture decisions
+  - architecture.design:completed -> memory.store(architecture_decision) @zero
+
+  # Auto-remember successful patterns
+  - quality.review[approved]:completed -> memory.store(successful_pattern) @zero
+
+# ============================================================================
+# CHECKPOINT RULES
+# ============================================================================
+
+checkpoints:
+  # Checkpoint on git commit
+  - git.commit:completed -> checkpoint.create:haiku @quick [type="commit"]
+
+  # Checkpoint on workflow milestone completion
+  - version.commit[flow.completed]:completed -> checkpoint.create:haiku @quick [type="milestone"]
+
+  # Pre-architecture checkpoint (expensive operation coming)
+  - architecture.design:starting -> checkpoint.create:haiku @quick [type="pre-architecture"]
+
+# ============================================================================
+# ERROR RECOVERY RULES
+# ============================================================================
+
+recovery:
+  # Story errors -> ask user
+  - story.create:failed -> ask_user(story_error) @quick [error.classification == permanent]
+
+  # Code analysis errors -> skip and continue
+  - code-analysis.context:failed -> set_flag(code_analysis.skipped=true) @zero
+
+  # Architecture errors -> escalate (critical)
+  - architecture.design:failed -> escalate(architecture_failed) @quick
+
+  # Implementation errors -> retry then ask user
+  - implementation.generate:failed -> implementation.generate:sonnet @implementation [retry, attempts < 2]
+  - implementation.generate:failed -> ask_user(implementation_failed) @quick [attempts >= 2]
+
+  # Quality errors -> self-repair via MCP
+  - quality.test:failed -> quality.self_repair:sonnet @execution_loop [mcp, attempts < 3]
+
+  # Version errors -> retry then escalate
+  - version.commit:failed -> version.commit:sonnet @quick [retry, attempts < 3]
+  - version.commit:failed -> escalate(commit_failed) @quick [attempts >= 3]
+
+# ============================================================================
+# REACT FALLBACK RULES (Phase 3: Hybrid Declarative/Imperative)
+# ============================================================================
+
+fallback:
+  # Sync blocked after max retries -> trigger ReAct
+  - sync.blocked[retry_count >= 3]:triggered -> react-fallback.handle_blocked:sonnet @fallback
+
+  # Sync rule not found -> ReAct infers next step
+  - sync.no_match:detected -> react-fallback.handle_blocked:sonnet @fallback [reason="no_matching_rule"]
+
+  # Circular dependency -> ReAct breaks cycle
+  - sync.circular_dependency:detected -> react-fallback.handle_blocked:sonnet @fallback [reason="circular"]
+
+  # Ambiguous state -> ReAct analyzes and chooses
+  - workflow.ambiguous_state:detected -> react-fallback.handle_blocked:sonnet @fallback [reason="ambiguous"]
+
+  # ReAct resolved -> resume workflow
+  - react-fallback.handle_blocked[status=resolved]:completed -> resume_workflow @zero
+
+  # ReAct failed -> send to DLQ
+  - react-fallback.handle_blocked[status=unresolved]:completed -> dlq.add_entry @zero
+  - react-fallback.handle_blocked[iterations >= 5]:completed -> dlq.add_entry @zero [reason="max_iterations"]
+
+  # DLQ threshold exceeded -> alert user
+  - dlq.add_entry[entries.length >= 10]:completed -> alert_user(high_dlq_rate) @quick
+
+# ============================================================================
+# USER DECISION POINTS
+# ============================================================================
+
+decisions:
+  story_ambiguous:
+    trigger: story.clarity == ambiguous OR story.confidence < 0.7
+    question: "Story is ambiguous. What's the primary goal?"
+    options:
+      - "New feature" -> story.update(goal_type=feature)
+      - "Bug fix" -> story.update(goal_type=fix)
+      - "Refactor" -> story.update(goal_type=refactor)
+      - "Performance" -> story.update(goal_type=performance)
+
+  high_risk_architecture:
+    trigger: architecture.risk == high
+    question: "Architecture has HIGH RISK. How to proceed?"
+    options:
+      - "Approve anyway" -> implementation.generate(user_approval=approved_high_risk)
+      - "Request revision" -> architecture.revise(constraint="lower risk")
+      - "Cancel workflow" -> story.cancel(reason="high risk rejected")
+
+  repair_failed:
+    trigger: quality.self_repair.attempts >= 3
+    question: "Auto-repair failed after ${repair_attempts} attempts. What next?"
+    options:
+      - "Show errors and continue manually" -> display(test.failures, diagnosis)
+      - "Try different implementation approach" -> implementation.revise(constraint="different approach")
+      - "Skip tests (not recommended)" -> version.commit(warning="TESTS SKIPPED")
+
+  story_error:
+    trigger: story.create.failed AND error.classification == permanent
+    question: "Story creation failed: ${error.message}. How to proceed?"
+    options:
+      - "Provide more details" -> story.update(needs_clarification=true)
+      - "Skip story capture" -> architecture.design(skip_story=true)
+      - "Cancel" -> workflow.cancel(reason="story failed")
+
+  implementation_failed:
+    trigger: implementation.generate.failed AND attempts >= 2
+    question: "Implementation failed after ${attempts} attempts."
+    options:
+      - "Show error and retry manually" -> display(error.details)
+      - "Revise architecture" -> architecture.revise(constraint="simpler implementation")
+      - "Cancel workflow" -> workflow.cancel(reason="implementation failed")
+
+  react_fallback_failed:
+    trigger: react-fallback.handle_blocked.iterations >= 3
+    question: "ReAct fallback could not resolve after ${iterations} attempts. What next?"
+    options:
+      - "Continue trying (2 more iterations)" -> react-fallback.continue(max_iterations=5)
+      - "Show diagnostic info" -> display(fallback.log, suggestions)
+      - "Send to dead letter queue" -> dlq.add_entry(fallback_exhausted)
+      - "Resume workflow manually" -> workflow.resume(skip_blocked_step=true)
+
+  high_dlq_rate:
+    trigger: dlq.entries.length >= 10
+    question: "High dead letter queue rate (${dlq.entries.length} entries). Review needed."
+    options:
+      - "Show all DLQ entries" -> display(dlq.entries)
+      - "Review sync rules for improvements" -> display(dlq.patterns)
+      - "Clear resolved entries" -> dlq.cleanup(status=resolved)
+
+# ============================================================================
+# MCP INTEGRATION
+# ============================================================================
+
+mcp:
+  servers:
+    - name: ast-index
+      tools: [find_symbol, get_symbol_info, find_references, get_call_graph, get_file_symbols]
+      used_by: [code-analysis]
+
+    - name: semantic-rag
+      tools: [semantic_search, find_similar_code]
+      used_by: [code-analysis, implementation]
+
+  fallback:
+    # When MCP unavailable, use legacy manual paths
+    ast-index: skip_code_analysis
+    semantic-rag: skip_context_gathering
+
+# ============================================================================
+# PROVENANCE CATEGORIES
+# ============================================================================
+# All rules automatically track provenance with these categories:
+#
+# core       - Main workflow transitions
+# recovery   - Error handling and retry paths
+# learning   - Pattern extraction and memory storage
+# intelligence - Context gathering and enrichment
+# memory     - Semantic memory operations
+# checkpoint - State preservation

package/templates/synchronizations/slo-registry.yaml.template

@@ -0,0 +1,229 @@
+# SLO Registry - Central definitions for all workflow SLOs
+# Consolidates 186 duplicate SLO definitions across 20 sync files
+#
+# Usage in sync rules: @slo:architecture, @slo:quick, etc.
+
+version: "1.0.0"
+
+# Default SLO (fallback when no profile specified)
+defaults:
+  expected_duration_ms: 5000
+  max_duration_ms: 60000
+  expected_cost_usd: 0.002
+  max_cost_usd: 0.02
+  expected_context_tokens: 1500
+  success_rate_target: 0.95
+  on_timeout:
+    action: retry
+    max_retries: 1
+    backoff_ms: 2000
+    on_exhausted: escalate
+  on_cost_exceeded:
+    action: alert
+    continue: true
+
+# Named SLO profiles
+slos:
+  # Architecture design with Opus (deep reasoning)
+  architecture:
+    expected_duration_ms: 15000
+    max_duration_ms: 90000
+    expected_cost_usd: 0.015
+    max_cost_usd: 0.050
+    expected_context_tokens: 1500
+    success_rate_target: 0.95
+    on_timeout:
+      action: retry
+      max_retries: 1
+      backoff_ms: 2000
+      on_exhausted: escalate
+    on_cost_exceeded:
+      action: alert
+      continue: true
+
+  # Verification passes (Sonnet reasoning)
+  verification:
+    expected_duration_ms: 12000
+    max_duration_ms: 60000
+    expected_cost_usd: 0.003
+    max_cost_usd: 0.015
+    expected_context_tokens: 2500
+    success_rate_target: 0.95
+    on_timeout:
+      action: skip
+      fallback: "Proceed without verification"
+
+  # Implementation generation (Sonnet)
+  implementation:
+    expected_duration_ms: 3000
+    max_duration_ms: 30000
+    expected_cost_usd: 0.000175
+    max_cost_usd: 0.001
+    expected_context_tokens: 1000
+    success_rate_target: 0.90
+    on_timeout:
+      action: retry
+      max_retries: 1
+      backoff_ms: 1000
+      on_exhausted: escalate
+
+  # Quality review/test (Sonnet)
+  quality:
+    expected_duration_ms: 2500
+    max_duration_ms: 20000
+    expected_cost_usd: 0.000175
+    max_cost_usd: 0.001
+    expected_context_tokens: 800
+    success_rate_target: 0.95
+    on_timeout:
+      action: retry
+      max_retries: 1
+      backoff_ms: 1000
+      on_exhausted: escalate
+
+  # Quick operations (commit, context inject, etc.)
+  quick:
+    expected_duration_ms: 1000
+    max_duration_ms: 10000
+    expected_cost_usd: 0.000175
+    max_cost_usd: 0.0005
+    expected_context_tokens: 300
+    success_rate_target: 0.99
+    on_timeout:
+      action: retry
+      max_retries: 2
+      backoff_ms: 500
+      on_exhausted: escalate
+
+  # Context operations (compression, snapshot)
+  context:
+    expected_duration_ms: 1500
+    max_duration_ms: 10000
+    expected_cost_usd: 0.000175
+    max_cost_usd: 0.0005
+    expected_context_tokens: 500
+    success_rate_target: 0.99
+    on_timeout:
+      action: escalate
+
+  # MCP-based code analysis
+  mcp:
+    expected_duration_ms: 2000
+    max_duration_ms: 10000
+    expected_cost_usd: 0.0002
+    max_cost_usd: 0.001
+    expected_context_tokens: 500
+    success_rate_target: 0.90
+    on_timeout:
+      action: skip
+      fallback: "Proceed without MCP analysis"
+    on_mcp_unavailable:
+      action: skip
+      fallback: "MCP server unavailable"
+
+  # Zero-cost operations (inject context, set flag)
+  zero:
+    expected_duration_ms: 100
+    max_duration_ms: 500
+    expected_cost_usd: 0.0
+    max_cost_usd: 0.0
+    expected_context_tokens: 200
+    on_timeout:
+      action: skip
+      fallback: "Proceed without context"
+
+  # Test generation via MCP
+  test_generation:
+    expected_duration_ms: 5000
+    max_duration_ms: 30000
+    expected_cost_usd: 0.0005
+    max_cost_usd: 0.002
+    expected_context_tokens: 800
+    success_rate_target: 0.90
+    on_timeout:
+      action: skip
+      fallback: "Proceed without auto-generated tests"
+    on_mcp_unavailable:
+      action: skip
+      fallback: "MCP server unavailable - manual test creation needed"
+
+  # Execution loop / self-repair via MCP
+  execution_loop:
+    expected_duration_ms: 15000
+    max_duration_ms: 120000
+    expected_cost_usd: 0.001
+    max_cost_usd: 0.005
+    expected_context_tokens: 1500
+    success_rate_target: 0.85
+    on_timeout:
+      action: escalate
+      message: "Self-repair loop exceeded timeout"
+    on_mcp_unavailable:
+      action: fallback
+      fallback_rule: "quality-tests-failed"
+
+  # Coverage analysis via MCP
+  coverage:
+    expected_duration_ms: 3000
+    max_duration_ms: 20000
+    expected_cost_usd: 0.0002
+    max_cost_usd: 0.001
+    expected_context_tokens: 500
+    success_rate_target: 0.95
+    on_timeout:
+      action: skip
+      fallback: "Proceed without coverage analysis"
+
+  # Security scanning
+  security:
+    expected_duration_ms: 8000
+    max_duration_ms: 45000
+    expected_cost_usd: 0.002
+    max_cost_usd: 0.01
+    expected_context_tokens: 1200
+    success_rate_target: 0.95
+    on_timeout:
+      action: retry
+      max_retries: 1
+      backoff_ms: 2000
+      on_exhausted: escalate
+
+  # Documentation generation
+  documentation:
+    expected_duration_ms: 2000
+    max_duration_ms: 15000
+    expected_cost_usd: 0.0005
+    max_cost_usd: 0.002
+    expected_context_tokens: 600
+    success_rate_target: 0.95
+    on_timeout:
+      action: skip
+      fallback: "Proceed without documentation"
+
+# Workflow profiles (combine SLOs for common patterns)
+profiles:
+  standard:
+    story: quick
+    code-analysis: mcp
+    security: security
+    architecture: architecture
+    verification: verification
+    implementation: implementation
+    quality: quality
+    version: quick
+
+  fast:
+    story: quick
+    implementation: quick
+    quality: quick
+    version: quick
+
+  thorough:
+    story: quick
+    code-analysis: mcp
+    security: security
+    architecture: architecture
+    verification: verification  # Will run 2 passes
+    implementation: implementation
+    quality: quality
+    version: quick

package/templates/tasks/task.yaml.template

@@ -0,0 +1,67 @@
+# Zen Task Tracking Schema
+# Location: koan/tasks/task-{id}.yaml
+# Purpose: Track work items for GitOps-based Kanban visualization
+
+task_id: "${TASK_ID}"
+title: "${TITLE}"
+description: |
+  ${DESCRIPTION}
+
+# Status: todo | in_progress | done | blocked
+status: "todo"
+
+# Priority: low | medium | high | critical
+priority: "medium"
+
+# Type: feature | bug | chore | spike | refactor
+type: "feature"
+
+# Timestamps
+created_at: "${TIMESTAMP}"
+updated_at: "${TIMESTAMP}"
+
+# Provenance - links to Zen workflow artifacts
+provenance:
+  story_id: null
+  architecture_id: null
+  implementation_id: null
+  review_id: null
+
+# Subtasks for progress tracking
+subtasks: []
+# Example:
+# - id: "sub-001"
+#   title: "Design the interface"
+#   status: "done"
+# - id: "sub-002"
+#   title: "Implement core logic"
+#   status: "in_progress"
+
+# Git integration
+git:
+  branch: null
+  commits: []
+  pull_request: null
+
+# AI metadata (populated by Claude)
+ai_metadata:
+  concept_name: null
+  model_used: null
+  cost_usd: null
+  context_tokens: null
+
+# Labels for filtering
+labels: []
+
+# Assignee (optional)
+assignee: null
+
+# Due date (optional)
+due_date: null
+
+# Notes and comments
+notes: []
+# Example:
+# - timestamp: "2025-12-08T10:00:00Z"
+#   content: "Started implementation"
+#   author: "claude"

package/templates/zen-profile.yaml.template

@@ -0,0 +1,14 @@
+# Zen Installation Profile
+# Place this file in your project root before running install.sh
+# Options: minimal, standard (default), full
+#
+# minimal  — 5 concepts, 10 commands, 6 skills, 5 agents, 6 hooks.
+#             Memory + code intel + checkpoints. Core CLI only.
+#             ~40 files deployed (vs ~200 for full).
+# standard — 21 concepts, 28 commands, 43 skills, 12 agents, 22 hooks.
+#             Full framework minus debate agents and reasoning hooks.
+#             All CLI tools installed.
+# full     — 21 concepts, 28 commands, 43 skills, 15 agents, 27 hooks.
+#             Everything including debate, reasoning hooks, SLO registry.
+#             All CLI tools installed.
+profile: standard