@openlife/cli 1.8.3 → 1.9.3

package/dist-templates/workflows/brownfield-fullstack.yaml

@@ -0,0 +1,131 @@
+workflow:
+  id: brownfield-fullstack
+  name: Brownfield Full-Stack Enhancement
+  description: >-
+    Enhance an existing full-stack application. Assumes brownfield-discovery
+    has already produced the technical-debt-assessment.md and frontend-spec.md.
+    This workflow takes a specific enhancement request and drives it through
+    architecture review → impact analysis → story creation → SDC.
+  type: brownfield
+  version: "1.0"
+  framework: openlife-method
+  project_types:
+    - existing-fullstack
+    - legacy-modernization
+    - feature-addition
+
+  metadata:
+    elicit: true
+    confirmation_required: true
+    requires_prior_workflow: brownfield-discovery
+
+  phases:
+    - phase_0: Context Load
+    - phase_1: Impact Analysis
+    - phase_2: Story Slicing
+    - phase_3: Development Cycle
+
+  success_criteria:
+    - id: impact-on-existing-code-schema-ui-is-doc
+      description: "Impact on existing code/schema/UI is documented"
+    - id: no-regression-on-existing-test-suite
+      description: "No regression on existing test suite"
+    - id: schema-migrations-are-reversible
+      description: "Schema migrations are reversible"
+    - id: performance-baseline-maintained-or-impro
+      description: "Performance baseline maintained or improved"
+
+  failure_handling:
+    on_phase_failure: escalate_to_maestro
+    on_regression_detected: rollback_via_vortex
+
+  tools:
+    allowed:
+      - terminal
+      - git
+      - schema-migration
+      - browser-testing
+    restricted:
+      - drop-table
+      - delete-component
+
+  sequence:
+    - phase: 0
+      name: Context Load
+
+    - id: load-context
+      agent: openlife-maestro
+      action: route
+      creates:
+        - .openlife/brownfield-context.json
+      notes: |
+        Load technical-debt-assessment.md + frontend-spec.md + SCHEMA.md.
+        Confirm prior brownfield-discovery completed. If not, halt and route
+        user to brownfield-discovery workflow.
+
+    - phase: 1
+      name: Impact Analysis
+
+    - id: impact-arch
+      agent: openlife-atlas
+      action: analyze_impact
+      requires: load-context
+      creates:
+        - docs/impact/architecture.md
+      duration_estimate: "1-2 hours"
+      notes: What architectural surfaces are touched? What ADRs need updating?
+
+    - id: impact-data
+      agent: openlife-mesh
+      action: db_schema_audit
+      requires: impact-arch
+      creates:
+        - docs/impact/schema-delta.md
+      optional: true
+      notes: Only if enhancement touches data layer.
+
+    - id: impact-ui
+      agent: openlife-prism
+      action: ux_ds_scan_artifact
+      requires: impact-arch
+      creates:
+        - docs/impact/ui-delta.md
+      optional: true
+      notes: Only if enhancement touches UI.
+
+    - phase: 2
+      name: Story Slicing
+
+    - id: brownfield-epic
+      agent: openlife-genesis
+      action: brownfield_create_epic
+      requires: impact-arch
+      creates:
+        - docs/epics/brownfield-*.md
+      elicit: true
+      notes: Epic explicitly references the brownfield context.
+
+    - id: brownfield-stories
+      agent: openlife-conductor
+      action: brownfield_create_story
+      requires: brownfield-epic
+      creates:
+        - docs/stories/*.story.md
+      notes: Stories include "what NOT to break" in their scope/AC.
+
+    - phase: 3
+      name: Development Cycle
+
+    - id: story-loop
+      agent: openlife-conductor
+      action: story_development_cycle
+      requires: brownfield-stories
+      notes: |
+        Each story flows through story-development-cycle.
+        Sentinel's QA gate includes regression-suite verification.
+        Vortex's push includes a feature-flag fallback when applicable.
+
+  handoff_prompts:
+    phase_0_to_1: "Context loaded. Atlas, run impact analysis."
+    phase_1_to_2: "Impact mapped. Genesis, draft the brownfield epic."
+    phase_2_to_3: "Stories sliced. Conductor, drive through SDC."

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

@@ -0,0 +1,111 @@
+workflow:
+  id: brownfield-service
+  name: Brownfield Service / API Modification
+  description: >-
+    Modify an existing service or API. No UI phase. Focus on architectural
+    impact, data-layer compatibility (RLS, migrations, query plans), and
+    integration-pattern preservation.
+  type: brownfield
+  version: "1.0"
+  framework: openlife-method
+  project_types:
+    - existing-api
+    - existing-microservice
+    - existing-worker
+
+  metadata:
+    elicit: true
+    requires_prior_workflow: brownfield-discovery
+
+  phases:
+    - phase_0: Context Load
+    - phase_1: Service Impact
+    - phase_2: Story Slicing
+    - phase_3: Development Cycle
+
+  success_criteria:
+    - id: api-contract-is-preserved-or-versioned-n
+      description: "API contract is preserved OR versioned (no silent break)"
+    - id: integration-tests-cover-the-changed-endp
+      description: "Integration tests cover the changed endpoint(s)"
+    - id: database-migrations-have-rollback-script
+      description: "Database migrations have rollback scripts"
+    - id: performance-regression-10-on-hot-paths
+      description: "Performance regression < 10% on hot paths"
+
+  failure_handling:
+    on_phase_failure: escalate_to_maestro
+    on_regression_detected: rollback_via_vortex
+
+  sequence:
+    - phase: 0
+      name: Context Load
+
+    - id: load-context
+      agent: openlife-maestro
+      action: route
+      creates:
+        - .openlife/brownfield-context.json
+
+    - phase: 1
+      name: Service Impact
+
+    - id: impact-arch
+      agent: openlife-atlas
+      action: analyze_impact
+      requires: load-context
+      creates:
+        - docs/impact/service-architecture.md
+      notes: Which endpoints, which integration patterns, which contracts.
+
+    - id: impact-schema
+      agent: openlife-mesh
+      action: db_schema_audit
+      requires: impact-arch
+      creates:
+        - docs/impact/schema-delta.md
+      notes: Schema changes, indexes affected, query plan delta.
+
+    - id: api-contract-check
+      agent: openlife-atlas
+      action: analyze_cross_artifact
+      requires: impact-arch
+      creates:
+        - docs/impact/api-contract-delta.md
+      notes: |
+        Detect breaking API changes. If breaking, REQUIRE either versioning
+        strategy or deprecation timeline before proceeding.
+
+    - phase: 2
+      name: Story Slicing
+
+    - id: brownfield-epic
+      agent: openlife-genesis
+      action: brownfield_create_epic
+      requires: api-contract-check
+      creates:
+        - docs/epics/brownfield-service-*.md
+
+    - id: brownfield-stories
+      agent: openlife-conductor
+      action: brownfield_create_story
+      requires: brownfield-epic
+      creates:
+        - docs/stories/*.story.md
+
+    - phase: 3
+      name: Development Cycle
+
+    - id: story-loop
+      agent: openlife-conductor
+      action: story_development_cycle
+      requires: brownfield-stories
+      notes: |
+        Sentinel's QA gate emphasizes integration tests + regression suite.
+        Mesh runs migrations in dry-run mode first.
+        Vortex's release uses canary / blue-green when infrastructure supports it.
+
+  handoff_prompts:
+    phase_0_to_1: "Context loaded. Atlas, scope the service impact."
+    phase_1_to_2: "Impact analyzed. Genesis, draft the brownfield epic."
+    phase_2_to_3: "Stories ready. Conductor, drive through SDC."

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

@@ -0,0 +1,115 @@
+workflow:
+  id: brownfield-ui
+  name: Brownfield UI Refactor / Enhancement
+  description: >-
+    Modify an existing UI. Focus on design-system compliance, accessibility
+    regression, and component-tree impact. Assumes brownfield-discovery
+    produced frontend-spec.md.
+  type: brownfield
+  version: "1.0"
+  framework: openlife-method
+  project_types:
+    - existing-spa
+    - existing-web-app
+    - legacy-ui-modernization
+
+  metadata:
+    elicit: true
+    requires_prior_workflow: brownfield-discovery
+
+  phases:
+    - phase_0: Context Load
+    - phase_1: UI Impact
+    - phase_2: Design System Reconciliation
+    - phase_3: Story Slicing
+    - phase_4: Development Cycle
+
+  success_criteria:
+    - id: existing-user-flows-still-pass-e2e-suite
+      description: "Existing user flows still pass e2e suite"
+    - id: design-system-tokens-not-violated-or-vio
+      description: "Design system tokens not violated (or violations are tracked)"
+    - id: accessibility-regression-check-passes
+      description: "Accessibility regression check passes"
+    - id: bundle-size-delta-within-budget
+      description: "Bundle size delta within budget"
+
+  failure_handling:
+    on_phase_failure: escalate_to_maestro
+
+  sequence:
+    - phase: 0
+      name: Context Load
+
+    - id: load-context
+      agent: openlife-maestro
+      action: route
+      creates:
+        - .openlife/brownfield-context.json
+
+    - phase: 1
+      name: UI Impact
+
+    - id: ds-scan
+      agent: openlife-prism
+      action: ux_ds_scan_artifact
+      requires: load-context
+      creates:
+        - docs/impact/design-system-delta.md
+      notes: Detect existing drift; reconcile before adding new.
+
+    - id: a11y-baseline
+      agent: openlife-prism
+      action: ux_accessibility_audit
+      requires: ds-scan
+      creates:
+        - docs/impact/accessibility-baseline.md
+
+    - id: component-impact
+      agent: openlife-atlas
+      action: analyze_impact
+      requires: ds-scan
+      creates:
+        - docs/impact/component-tree-delta.md
+
+    - phase: 2
+      name: Design System Reconciliation
+
+    - id: reconcile-tokens
+      agent: openlife-prism
+      action: ux_design_tokens_extract
+      requires: ds-scan
+      creates:
+        - design-system/tokens.json
+      optional: true
+      notes: Only if drift is significant enough to warrant a tokens update.
+
+    - phase: 3
+      name: Story Slicing
+
+    - id: brownfield-epic
+      agent: openlife-genesis
+      action: brownfield_create_epic
+      requires: component-impact
+
+    - id: brownfield-stories
+      agent: openlife-conductor
+      action: brownfield_create_story
+      requires: brownfield-epic
+      creates:
+        - docs/stories/*.story.md
+
+    - phase: 4
+      name: Development Cycle
+
+    - id: story-loop
+      agent: openlife-conductor
+      action: story_development_cycle
+      requires: brownfield-stories
+      notes: Sentinel runs a11y + visual-regression checks.
+
+  handoff_prompts:
+    phase_0_to_1: "Context loaded. Prism, scan the UI."
+    phase_1_to_2: "UI scanned. Prism, reconcile tokens if needed."
+    phase_2_to_3: "Reconciliation done. Genesis, draft the epic."
+    phase_3_to_4: "Stories ready. Conductor, drive through SDC."

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."