@openlife/cli 1.8.2 → 1.9.3

package/dist-templates/workflows/continuous-deployment.yaml

@@ -0,0 +1,139 @@
+workflow:
+  id: continuous-deployment
+  name: Continuous Deployment Pipeline
+  description: >-
+    Release pipeline for shipping completed work. Triggered when one or
+    more stories reach status Done (Sentinel verdict PASS). Vortex drives
+    the actual push / PR / merge / publish. Maestro logs the release event.
+  type: custom
+  version: "1.0"
+  framework: openlife-method
+  project_types:
+    - any
+
+  metadata:
+    elicit: false
+    confirmation_required: true
+
+  phases:
+    - phase_1: Pre-Release Checks
+    - phase_2: PR + Merge
+    - phase_3: Release Tag + Publish
+    - phase_4: Post-Release
+
+  success_criteria:
+    - id: all-stories-in-release-have-status-done
+      description: "All stories in release have status Done"
+    - id: pre-release-ci-is-green
+      description: "Pre-release CI is green"
+    - id: tag-is-semver-valid
+      description: "Tag is semver-valid"
+    - id: release-event-logged-in-framework-memory
+      description: "Release event logged in framework memory"
+
+  failure_handling:
+    on_ci_failure: rollback_via_vortex
+    on_publish_failure: investigate_then_retry
+
+  tools:
+    allowed:
+      - terminal
+      - git
+      - github-cli
+      - npm-publish
+    restricted:
+      - main-force-push
+
+  sequence:
+    - phase: 1
+      name: Pre-Release Checks
+
+    - id: gather-done-stories
+      agent: openlife-conductor
+      action: manage_sprint
+      creates:
+        - .openlife/releases/<tag>/stories.json
+      notes: Collect all stories with status=Done since last release tag.
+
+    - id: pre-release-qa
+      agent: openlife-sentinel
+      action: qa_gate
+      requires: gather-done-stories
+      creates:
+        - .openlife/releases/<tag>/qa-summary.md
+      notes: Final aggregated QA pass across all stories in the release window.
+
+    - phase: 2
+      name: PR + Merge
+
+    - id: open-release-pr
+      agent: openlife-vortex
+      action: open_pr
+      requires: pre-release-qa
+      creates:
+        - .openlife/releases/<tag>/pr-number.txt
+      notes: 'Title format: "release: vX.Y.Z — <one-liner summary>"'
+
+    - id: ci-wait
+      agent: openlife-vortex
+      action: ci_status
+      requires: open-release-pr
+      duration_estimate: "5-30 min"
+      notes: |
+        Wait for green. If CI fails, halt and route to Sentinel for analysis.
+        Do not auto-merge.
+
+    - id: merge-pr
+      agent: openlife-vortex
+      action: merge_pr
+      requires: ci-wait
+      elicit: true
+      notes: |
+        Operator confirms before merge.
+        Default: squash-merge for clean history.
+
+    - phase: 3
+      name: Release Tag + Publish
+
+    - id: version-bump
+      agent: openlife-vortex
+      action: github_devops_version_management
+      requires: merge-pr
+      creates:
+        - package.json (version bumped)
+      notes: 'Semver: patch (default) / minor (new feature) / major (breaking).'
+
+    - id: tag-and-push
+      agent: openlife-vortex
+      action: tag
+      requires: version-bump
+      notes: Annotated tag vX.Y.Z; push triggers publish workflow.
+
+    - id: verify-published
+      agent: openlife-vortex
+      action: ci_status
+      requires: tag-and-push
+      duration_estimate: "2-10 min"
+      notes: Watch the publish workflow until success. On failure, rollback.
+
+    - phase: 4
+      name: Post-Release
+
+    - id: release-notes
+      agent: openlife-lyra
+      action: write_release_notes
+      requires: verify-published
+      creates:
+        - CHANGELOG.md (entry added)
+
+    - id: log-event
+      agent: openlife-maestro
+      action: decision_log
+      requires: release-notes
+      creates:
+        - .openlife/decisions.jsonl (release event appended)
+
+  handoff_prompts:
+    phase_1_to_2: "Done stories collected, QA aggregated. Vortex, open the release PR."
+    phase_2_to_3: "Merged. Vortex, bump version and tag."
+    phase_3_to_4: "Published. Lyra, write release notes; Maestro, log the event."

package/dist-templates/workflows/epic-orchestration.yaml

@@ -0,0 +1,101 @@
+workflow:
+  id: epic-orchestration
+  name: Epic Orchestration
+  description: >-
+    Coordinate multiple dependent stories within an epic. Genesis owns the
+    epic-level outcome; Conductor drives per-story execution; Maestro
+    arbitrates cross-story decisions.
+  type: custom
+  version: "1.0"
+  framework: openlife-method
+  project_types:
+    - multi-story-epic
+    - feature-set
+    - release-train
+
+  metadata:
+    elicit: true
+
+  phases:
+    - phase_1: Epic Setup
+    - phase_2: Story Sequencing
+    - phase_3: Story-by-Story Execution
+    - phase_4: Epic Closure
+
+  success_criteria:
+    - id: every-story-in-epic-completes-via-story-
+      description: "Every story in epic completes via story-development-cycle"
+    - id: inter-story-dependencies-are-explicit-an
+      description: "Inter-story dependencies are explicit and respected"
+    - id: epic-outcome-measured-against-original-p
+      description: "Epic outcome measured against original PRD success metric"
+    - id: retro-captures-cross-story-learnings
+      description: "Retro captures cross-story learnings"
+
+  failure_handling:
+    on_story_blocked: escalate_to_maestro
+    on_epic_descope: regenerate_remaining_stories
+
+  sequence:
+    - phase: 1
+      name: Epic Setup
+
+    - id: epic-load
+      agent: openlife-genesis
+      action: create_epic
+      creates:
+        - docs/epics/<id>/EPIC.md
+        - docs/epics/<id>/STORY-INDEX.md
+      elicit: true
+      notes: |
+        Confirms PRD, success metrics, scope boundaries.
+        Lists all candidate stories with rough complexity score.
+
+    - phase: 2
+      name: Story Sequencing
+
+    - id: sequence-stories
+      agent: openlife-conductor
+      action: manage_sprint
+      requires: epic-load
+      creates:
+        - docs/epics/<id>/sequence.yaml
+      notes: |
+        Topologically sort stories by dependencies.
+        Mark parallel-safe stories for concurrent execution.
+
+    - phase: 3
+      name: Story-by-Story Execution
+
+    - id: story-cycle-loop
+      agent: openlife-conductor
+      action: story_development_cycle
+      requires: sequence-stories
+      notes: |
+        For each story in sequence, run story-development-cycle.
+        On any story's QA gate FAIL: re-enter qa-loop.
+        On any story's epic-level blocker: escalate to maestro.
+
+    - phase: 4
+      name: Epic Closure
+
+    - id: epic-verify
+      agent: openlife-sentinel
+      action: qa_gate
+      requires: story-cycle-loop
+      creates:
+        - docs/epics/<id>/CLOSURE.md
+      notes: Verify epic-level success metric (not just individual stories' AC).
+
+    - id: epic-retro
+      agent: openlife-maestro
+      action: retrospective
+      requires: epic-verify
+      creates:
+        - docs/epics/<id>/RETRO.md
+      notes: Capture cross-story learnings into framework memory.
+
+  handoff_prompts:
+    phase_1_to_2: "Epic established. Conductor, sequence the stories."
+    phase_2_to_3: "Sequence ready. Conductor, drive each story through SDC."
+    phase_3_to_4: "All stories Done. Sentinel, verify epic-level success metric."

package/dist-templates/workflows/greenfield-service.yaml

@@ -0,0 +1,154 @@
+workflow:
+  id: greenfield-service
+  name: Greenfield Service / API Development
+  description: >-
+    Backend-only workflow for building a new service or API from scratch.
+    No frontend phase. Driven by Atlas for architecture, Mesh for data
+    layer, Builder for implementation, Sentinel for QA.
+  type: greenfield
+  version: "1.0"
+  framework: openlife-method
+  project_types:
+    - api
+    - microservice
+    - cli
+    - worker
+    - mcp-server
+
+  metadata:
+    elicit: true
+    confirmation_required: true
+
+  phases:
+    - phase_0: Environment Bootstrap
+    - phase_1: Service Architecture
+    - phase_2: Data Layer Design
+    - phase_3: Implementation Stories
+
+  success_criteria:
+    - id: service-compiles-and-starts-cleanly
+      description: "Service compiles and starts cleanly"
+    - id: all-endpoints-have-integration-tests
+      description: "All endpoints have integration tests"
+    - id: health-check-endpoint-returns-200
+      description: "Health check endpoint returns 200"
+    - id: logs-are-structured-and-queryable
+      description: "Logs are structured and queryable"
+
+  failure_handling:
+    on_phase_failure: escalate_to_maestro
+    max_retries_per_step: 2
+
+  tools:
+    allowed:
+      - terminal
+      - git
+      - schema-migration
+    restricted:
+      - production-deploy
+
+  sequence:
+    - phase: 0
+      name: Environment Bootstrap
+
+    - id: bootstrap
+      agent: openlife-vortex
+      action: environment_bootstrap
+      task: greenfield-bootstrap.md
+      creates:
+        - .openlife/config.yaml
+        - .openlife/project.json
+        - README.md
+        - package.json
+      duration_estimate: "10-20 min"
+      idempotent: true
+      notes: |
+        Initialize repo, install minimum deps (no UI framework).
+        Set up CI skeleton.
+
+    - phase: 1
+      name: Service Architecture
+
+    - id: arch-design
+      agent: openlife-atlas
+      action: design_architecture
+      task: greenfield-architecture.md
+      requires: bootstrap
+      creates:
+        - docs/architecture.md
+        - docs/adr/0001-initial-stack.md
+      duration_estimate: "1-3 hours"
+      elicit: true
+      notes: |
+        Choose framework (Express/Fastify/Hono/...), language, deployment target.
+        Write an ADR for each major decision.
+
+    - id: research-deps
+      agent: openlife-lyra
+      action: research_dependencies
+      task: spec-research-dependencies.md
+      requires: arch-design
+      creates:
+        - docs/research/dependency-options.md
+      optional: true
+      duration_estimate: "30-60 min"
+      notes: Only run if architecture choice surfaces unknowns.
+
+    - phase: 2
+      name: Data Layer Design
+
+    - id: data-model
+      agent: openlife-mesh
+      action: db_domain_modeling
+      task: db-bootstrap.md
+      requires: arch-design
+      creates:
+        - docs/schema.md
+        - migrations/0001_init.sql
+      duration_estimate: "1-2 hours"
+      elicit: true
+      notes: Design entities + relationships from gathered requirements.
+
+    - id: rls-policies
+      agent: openlife-mesh
+      action: db_rls_audit
+      task: db-rls-audit.md
+      requires: data-model
+      creates:
+        - docs/security/rls-policies.md
+      optional: true
+      notes: Only when multi-tenant or row-level access control needed.
+
+    - phase: 3
+      name: Implementation Stories
+
+    - id: shard-prd
+      agent: openlife-lyra
+      action: write_prd
+      requires: arch-design
+      creates:
+        - docs/prd.md
+      duration_estimate: "1-2 hours"
+
+    - id: epic-creation
+      agent: openlife-genesis
+      action: create_epic
+      requires: shard-prd
+      creates:
+        - docs/epics/epic-001.md
+      duration_estimate: "30 min"
+
+    - id: story-loop
+      agent: openlife-conductor
+      action: story_development_cycle
+      requires: epic-creation
+      creates:
+        - docs/stories/*.story.md
+      notes: |
+        Hand off to story-development-cycle workflow per story.
+        Continue until epic complete.
+
+  handoff_prompts:
+    phase_0_to_1: "Bootstrap complete. Atlas, design the service architecture."
+    phase_1_to_2: "Architecture done. Mesh, model the data layer."
+    phase_2_to_3: "Data layer ready. Conductor, slice into stories."

package/dist-templates/workflows/greenfield-ui.yaml

@@ -0,0 +1,140 @@
+workflow:
+  id: greenfield-ui
+  name: Greenfield UI / Frontend Development
+  description: >-
+    Frontend-only workflow for building a new UI application from scratch.
+    No backend phase (assumes an API already exists or is being built in
+    parallel via greenfield-service). Driven by Prism for design, Atlas
+    for component architecture, Builder for implementation.
+  type: greenfield
+  version: "1.0"
+  framework: openlife-method
+  project_types:
+    - web-app
+    - spa
+    - landing-page
+    - admin-panel
+    - documentation-site
+
+  metadata:
+    elicit: true
+    confirmation_required: true
+
+  phases:
+    - phase_0: Environment Bootstrap
+    - phase_1: Design System & UX
+    - phase_2: Component Architecture
+    - phase_3: Implementation Stories
+
+  success_criteria:
+    - id: app-builds-and-serves-cleanly
+      description: "App builds and serves cleanly"
+    - id: design-tokens-extracted-and-applied
+      description: "Design tokens extracted and applied"
+    - id: accessibility-audit-passes-wcag-2-2-aa
+      description: "Accessibility audit passes (WCAG 2.2 AA)"
+    - id: core-user-flows-have-e2e-tests
+      description: "Core user flows have e2e tests"
+
+  failure_handling:
+    on_phase_failure: escalate_to_maestro
+    max_retries_per_step: 2
+
+  tools:
+    allowed:
+      - terminal
+      - git
+      - figma-mcp
+      - browser-testing
+    restricted: []
+
+  sequence:
+    - phase: 0
+      name: Environment Bootstrap
+
+    - id: bootstrap
+      agent: openlife-vortex
+      action: environment_bootstrap
+      task: greenfield-bootstrap.md
+      creates:
+        - .openlife/config.yaml
+        - .openlife/project.json
+        - package.json
+      duration_estimate: "10-20 min"
+      idempotent: true
+      notes: Initialize repo, install framework (React/Vue/Svelte/etc.) and styling stack.
+
+    - phase: 1
+      name: Design System & UX
+
+    - id: design-tokens
+      agent: openlife-prism
+      action: ux_design_tokens_extract
+      requires: bootstrap
+      creates:
+        - design-system/tokens.json
+        - design-system/README.md
+      duration_estimate: "1-2 hours"
+      elicit: true
+      notes: Extract from Figma file if available; otherwise establish brand baseline.
+
+    - id: wireframes
+      agent: openlife-prism
+      action: ux_create_wireframe
+      requires: design-tokens
+      creates:
+        - design/wireframes.md
+      duration_estimate: "2-4 hours"
+      elicit: true
+      notes: Wireframe primary user flows before code starts.
+
+    - id: accessibility-baseline
+      agent: openlife-prism
+      action: ux_accessibility_audit
+      requires: wireframes
+      creates:
+        - docs/accessibility-checklist.md
+      optional: true
+
+    - phase: 2
+      name: Component Architecture
+
+    - id: component-tree
+      agent: openlife-atlas
+      action: design_architecture
+      requires: wireframes
+      creates:
+        - docs/component-architecture.md
+        - docs/adr/0001-frontend-stack.md
+      duration_estimate: "1-2 hours"
+      notes: Component hierarchy, state management choice, routing strategy.
+
+    - phase: 3
+      name: Implementation Stories
+
+    - id: shard-prd
+      agent: openlife-lyra
+      action: write_prd
+      requires: component-tree
+      creates:
+        - docs/prd.md
+
+    - id: epic-creation
+      agent: openlife-genesis
+      action: create_epic
+      requires: shard-prd
+      creates:
+        - docs/epics/epic-001.md
+
+    - id: story-loop
+      agent: openlife-conductor
+      action: story_development_cycle
+      requires: epic-creation
+      creates:
+        - docs/stories/*.story.md
+      notes: Each story flows through story-development-cycle. Sentinel includes accessibility checks in QA gate.
+
+  handoff_prompts:
+    phase_0_to_1: "Bootstrap done. Prism, establish the design system."
+    phase_1_to_2: "Design system ready. Atlas, decide component architecture."
+    phase_2_to_3: "Architecture set. Conductor, draft the first epic."

package/dist-templates/workflows/spec-pipeline.yaml

@@ -0,0 +1,135 @@
+workflow:
+  id: spec-pipeline
+  name: Specification Pipeline
+  description: >-
+    Transform informal requirements into an executable spec. 6-phase
+    pipeline: gather → assess → research → write → critique → plan.
+    Complexity assessment routes between SIMPLE (3 phases) and COMPLEX
+    (6 phases + revision cycles).
+  type: custom
+  version: "1.0"
+  framework: openlife-method
+  project_types:
+    - feature-spec
+    - integration-spec
+    - migration-spec
+
+  metadata:
+    elicit: true
+
+  phases:
+    - phase_1: Gather Requirements
+    - phase_2: Assess Complexity
+    - phase_3: Research Dependencies
+    - phase_4: Write Spec
+    - phase_5: Critique
+    - phase_6: Plan Implementation
+
+  success_criteria:
+    - id: spec-traces-every-claim-to-a-fr-nfr-cons
+      description: "Spec traces every claim to a FR/NFR/Constraint or research finding"
+    - id: no-invented-requirements-constitution-ar
+      description: "No invented requirements (Constitution Article IV — No Invention)"
+    - id: complexity-assessment-is-documented
+      description: "Complexity assessment is documented"
+    - id: critique-verdict-is-approved-before-impl
+      description: "Critique verdict is APPROVED before implementation begins"
+
+  failure_handling:
+    on_critique_blocked: escalate_to_maestro
+    on_needs_revision: rerun_phase_4_5
+
+  sequence:
+    - phase: 1
+      name: Gather Requirements
+
+    - id: gather
+      agent: openlife-genesis
+      action: spec_gather_requirements
+      task: spec-gather-requirements.md
+      creates:
+        - .openlife/specs/<id>/requirements.json
+      duration_estimate: "30-90 min"
+      elicit: true
+
+    - phase: 2
+      name: Assess Complexity
+
+    - id: assess
+      agent: openlife-atlas
+      action: spec_assess_complexity
+      task: spec-assess-complexity.md
+      requires: gather
+      creates:
+        - .openlife/specs/<id>/complexity.json
+      duration_estimate: "15-30 min"
+      notes: |
+        Scores 5 dimensions (1-5 each): scope, integration, infrastructure,
+        knowledge, risk. Sum → complexity class:
+        ≤ 8 SIMPLE (skip phases 3, 5b)
+        9-15 STANDARD (all 6 phases)
+        ≥ 16 COMPLEX (6 phases + revision cycle)
+
+    - phase: 3
+      name: Research Dependencies
+
+    - id: research
+      agent: openlife-lyra
+      action: research
+      task: spec-research-dependencies.md
+      requires: assess
+      creates:
+        - .openlife/specs/<id>/research.json
+      duration_estimate: "1-3 hours"
+      condition: complexity_not_simple
+      optional: true
+
+    - phase: 4
+      name: Write Spec
+
+    - id: write
+      agent: openlife-genesis
+      action: spec_write_spec
+      task: spec-write-spec.md
+      requires: assess
+      creates:
+        - .openlife/specs/<id>/spec.md
+      duration_estimate: "1-3 hours"
+      elicit: true
+
+    - phase: 5
+      name: Critique
+
+    - id: critique
+      agent: openlife-sentinel
+      action: spec_critique
+      task: spec-critique.md
+      requires: write
+      creates:
+        - .openlife/specs/<id>/critique.json
+      duration_estimate: "30-60 min"
+      notes: |
+        Critique verdicts:
+        APPROVED (≥ 4.0 avg) → proceed to phase 6
+        NEEDS_REVISION (3.0-3.9) → return to phase 4 (max 2 revisions)
+        BLOCKED (< 3.0) → escalate to maestro
+
+    - phase: 6
+      name: Plan Implementation
+
+    - id: plan
+      agent: openlife-atlas
+      action: plan_implementation
+      requires: critique
+      creates:
+        - .openlife/specs/<id>/implementation.yaml
+      duration_estimate: "30-60 min"
+      condition: critique_approved
+      notes: Output is consumed by greenfield-fullstack / story-development-cycle.
+
+  handoff_prompts:
+    phase_1_to_2: "Requirements gathered. Atlas, assess complexity."
+    phase_2_to_3: "Complexity scored. Lyra, research dependencies (if not SIMPLE)."
+    phase_3_to_4: "Research done. Genesis, draft the spec."
+    phase_4_to_5: "Spec drafted. Sentinel, critique."
+    phase_5_to_6: "Critique APPROVED. Atlas, plan implementation."