@juangcarmona/lighthouse-sdlc 0.7.0 → 0.9.0

package/workflows/lighthouse-sdlc-review.md

@@ -0,0 +1,41 @@
+---
+# Owned by @juangcarmona/lighthouse-sdlc. Compile with `gh aw compile`; do not edit the lock file.
+name: Lighthouse SDLC review
+description: Execute only the Lighthouse review stage and return its declared stage result.
+private: true
+runs-on: [self-hosted, linux, lighthouse-sdlc]
+runs-on-slim: ubuntu-24.04
+strict: true
+env:
+  LIGHTHOUSE_STAGE: review
+  LIGHTHOUSE_SKILL: node_modules/@juangcarmona/lighthouse-sdlc/skills/review/SKILL.md
+on:
+  workflow_call:
+    inputs:
+      route:
+        description: Lighthouse route selected by the host.
+        required: true
+        type: string
+      run-id:
+        description: Stable Lighthouse run identifier.
+        required: true
+        type: string
+      input:
+        description: Compact JSON input for this stage.
+        required: false
+        type: string
+        default: '{}'
+      previous-stage:
+        description: Previous stage artifact name.
+        required: false
+        type: string
+        default: integrate
+imports:
+  - shared/lighthouse-sdlc-stage.md
+---
+
+# Lighthouse SDLC review worker
+
+Execute only `review` by following `${{ env.LIGHTHOUSE_SKILL }}` and reading the integration result from `/tmp/gh-aw/agent/previous/stage-result.json` when present; for a supervised run, use the predecessor context in `/tmp/gh-aw/agent/input.json`. Preserve ProductShape and ArcShape citations in the delivery evidence.
+
+Classify findings, record the outcome and learning, and write one valid result to `/tmp/gh-aw/agent/stage-result.json` with `stage: review`, `gate: null`, the review record in `output`, and separate evidence arrays. Do not open another delivery gate or invoke another stage. Call `noop` exactly once after recording the closing result.

package/workflows/lighthouse-sdlc-router.yml

@@ -0,0 +1,181 @@
+name: Lighthouse SDLC router
+
+# This router owns the only automatic composition boundary. A normal dispatch calls exactly one
+# worker. `ff` is blocked for routes with human gates until approvals can be verified.
+on:
+  workflow_dispatch:
+    inputs:
+      route:
+        description: Lighthouse route from the installed SDLC package.
+        required: true
+        type: choice
+        options: [supervised, plan-only, unattended, hotfix, stacked]
+      stage:
+        description: One declared stage to run, or the first stage when composition is ff.
+        required: true
+        default: triage
+        type: choice
+        options: [triage, refine, propose, implement, integrate, review]
+      composition:
+        description: Run one stage, or explicitly compose the selected route through ff.
+        required: true
+        default: stage
+        type: choice
+        options: [stage, ff]
+      available:
+        description: Comma-separated route prerequisites already available to the host.
+        required: false
+        default: ''
+        type: string
+      run-id:
+        description: Stable Lighthouse run identifier; defaults to the GitHub run id.
+        required: false
+        default: ''
+        type: string
+      input:
+        description: Compact JSON input for the first stage.
+        required: false
+        default: '{}'
+        type: string
+
+permissions:
+  contents: read
+
+concurrency:
+  group: lighthouse-sdlc-${{ inputs.run-id || github.run_id }}
+  cancel-in-progress: false
+
+jobs:
+  validate:
+    name: Validate Lighthouse route
+    runs-on: ubuntu-24.04
+    outputs:
+      valid: ${{ steps.route.outputs.valid }}
+      triage: ${{ steps.route.outputs.triage }}
+      refine: ${{ steps.route.outputs.refine }}
+      propose: ${{ steps.route.outputs.propose }}
+      implement: ${{ steps.route.outputs.implement }}
+      integrate: ${{ steps.route.outputs.integrate }}
+      review: ${{ steps.route.outputs.review }}
+    steps:
+      - uses: actions/checkout@v5
+      - uses: actions/setup-node@v5
+        with:
+          node-version: 24
+      - run: npm ci --ignore-scripts
+      - run: node node_modules/@juangcarmona/lighthouse-sdlc/src/installation.mjs
+      - name: Validate route, prerequisites and selected composition
+        id: route
+        env:
+          ROUTE: ${{ inputs.route }}
+          STAGE: ${{ inputs.stage }}
+          COMPOSITION: ${{ inputs.composition }}
+          AVAILABLE: ${{ inputs.available }}
+        run: |
+          set -euo pipefail
+          node node_modules/@juangcarmona/lighthouse-sdlc/src/sdlc.mjs route --route "$ROUTE" --available "$AVAILABLE" --composition "$COMPOSITION" --format json > route.json
+          jq -e '.valid == true and .canRun == true' route.json >/dev/null
+          jq -e --arg stage "$STAGE" '.stages | index($stage) != null' route.json >/dev/null
+          if [ "$COMPOSITION" = ff ]; then
+            first_stage=$(jq -r '.stages[0]' route.json)
+            [ "$STAGE" = "$first_stage" ] || { echo "ff must start at $first_stage" >&2; exit 1; }
+          fi
+          echo 'valid=true' >> "$GITHUB_OUTPUT"
+          for stage in triage refine propose implement integrate review; do
+            printf '%s=%s\n' "$stage" "$(jq -r --arg stage "$stage" 'if (.stages | index($stage)) then "true" else "false" end' route.json)" >> "$GITHUB_OUTPUT"
+          done
+
+  call-triage:
+    needs: validate
+    if: >-
+      always() && needs.validate.outputs.valid == 'true' &&
+      ((inputs.composition == 'stage' && inputs.stage == 'triage') || inputs.composition == 'ff')
+    uses: ./.github/workflows/lighthouse-sdlc-triage.lock.yml
+    permissions: write-all # gh-aw workers request read-all; the reusable-workflow caller must satisfy it.
+    with:
+      route: ${{ inputs.route }}
+      run-id: ${{ inputs.run-id || github.run_id }}
+      input: ${{ inputs.input }}
+      previous-stage: ''
+
+  call-refine:
+    needs: [validate, call-triage]
+    if: >-
+      always() && needs.validate.outputs.valid == 'true' &&
+      ((inputs.composition == 'stage' && inputs.stage == 'refine') ||
+      (inputs.composition == 'ff' && needs.validate.outputs.refine == 'true' && needs.call-triage.result == 'success'))
+    uses: ./.github/workflows/lighthouse-sdlc-refine.lock.yml
+    permissions: write-all
+    with:
+      route: ${{ inputs.route }}
+      run-id: ${{ inputs.run-id || github.run_id }}
+      input: ${{ inputs.input }}
+      previous-stage: ${{ inputs.composition == 'ff' && 'triage' || '' }}
+
+  call-propose:
+    needs: [validate, call-triage, call-refine]
+    if: >-
+      always() && needs.validate.outputs.valid == 'true' &&
+      ((inputs.composition == 'stage' && inputs.stage == 'propose') ||
+      (inputs.composition == 'ff' && needs.validate.outputs.propose == 'true' &&
+      needs.call-triage.result == 'success' && needs.call-refine.result == 'success'))
+    uses: ./.github/workflows/lighthouse-sdlc-propose.lock.yml
+    permissions: write-all
+    with:
+      route: ${{ inputs.route }}
+      run-id: ${{ inputs.run-id || github.run_id }}
+      input: ${{ inputs.input }}
+      previous-stage: ${{ inputs.composition == 'ff' && 'refine' || '' }}
+
+  call-implement:
+    needs: [validate, call-triage, call-refine, call-propose]
+    if: >-
+      always() && needs.validate.outputs.valid == 'true' &&
+      ((inputs.composition == 'stage' && inputs.stage == 'implement') ||
+      (inputs.composition == 'ff' && needs.validate.outputs.implement == 'true' &&
+      needs.call-triage.result == 'success' &&
+      (needs.validate.outputs.refine != 'true' || needs.call-refine.result == 'success') &&
+      (needs.validate.outputs.propose != 'true' || needs.call-propose.result == 'success')))
+    uses: ./.github/workflows/lighthouse-sdlc-implement.lock.yml
+    permissions: write-all
+    with:
+      route: ${{ inputs.route }}
+      run-id: ${{ inputs.run-id || github.run_id }}
+      input: ${{ inputs.input }}
+      previous-stage: ${{ inputs.composition == 'ff' && 'propose' || '' }}
+
+  call-integrate:
+    needs: [validate, call-triage, call-refine, call-propose, call-implement]
+    if: >-
+      always() && needs.validate.outputs.valid == 'true' &&
+      ((inputs.composition == 'stage' && inputs.stage == 'integrate') ||
+      (inputs.composition == 'ff' && needs.validate.outputs.integrate == 'true' &&
+      needs.call-triage.result == 'success' &&
+      (needs.validate.outputs.refine != 'true' || needs.call-refine.result == 'success') &&
+      (needs.validate.outputs.propose != 'true' || needs.call-propose.result == 'success') &&
+      needs.call-implement.result == 'success'))
+    uses: ./.github/workflows/lighthouse-sdlc-integrate.lock.yml
+    permissions: write-all
+    with:
+      route: ${{ inputs.route }}
+      run-id: ${{ inputs.run-id || github.run_id }}
+      input: ${{ inputs.input }}
+      previous-stage: ${{ inputs.composition == 'ff' && 'implement' || '' }}
+
+  call-review:
+    needs: [validate, call-triage, call-refine, call-propose, call-implement, call-integrate]
+    if: >-
+      always() && needs.validate.outputs.valid == 'true' &&
+      ((inputs.composition == 'stage' && inputs.stage == 'review') ||
+      (inputs.composition == 'ff' && needs.validate.outputs.review == 'true' &&
+      needs.call-triage.result == 'success' &&
+      (needs.validate.outputs.refine != 'true' || needs.call-refine.result == 'success') &&
+      (needs.validate.outputs.propose != 'true' || needs.call-propose.result == 'success') &&
+      needs.call-implement.result == 'success' && needs.call-integrate.result == 'success'))
+    uses: ./.github/workflows/lighthouse-sdlc-review.lock.yml
+    permissions: write-all
+    with:
+      route: ${{ inputs.route }}
+      run-id: ${{ inputs.run-id || github.run_id }}
+      input: ${{ inputs.input }}
+      previous-stage: ${{ inputs.composition == 'ff' && 'integrate' || '' }}