feat(flowctl): event-sourced pipeline-first architecture

.github/workflows/ci.yml

@@ -5,11 +5,15 @@ on:
     branches: [main]
     paths:
       - "flowctl/**"
+      - "scripts/**"
+      - "hooks/**"
       - ".github/workflows/ci.yml"
   pull_request:
     branches: [main]
     paths:
       - "flowctl/**"
+      - "scripts/**"
+      - "hooks/**"
       - ".github/workflows/ci.yml"
 
 env:
@@ -25,6 +29,20 @@ jobs:
     steps:
       - uses: actions/checkout@v4
 
+      - name: Install shellcheck
+        working-directory: .
+        run: sudo apt-get install -y shellcheck
+
+      - name: Lint shell scripts
+        working-directory: .
+        run: shellcheck scripts/*.sh scripts/hooks/*.sh flowctl/install.sh
+
+      - name: Validate JSON configs
+        working-directory: .
+        run: |
+          python3 -c "import json; json.load(open('hooks/hooks.json'))"
+          python3 -c "import json; json.load(open('.claude-plugin/plugin.json'))"
+
       - name: Install Rust toolchain
         uses: dtolnay/rust-toolchain@stable
         with:
@@ -53,6 +71,40 @@ jobs:
       - name: Clippy
         run: cargo clippy --all-targets -- -D warnings
 
+      - name: Audit dependencies
+        run: cargo install cargo-audit && cargo audit
+
+  integration:
+    name: Shell Integration Tests
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install Rust toolchain
+        uses: dtolnay/rust-toolchain@stable
+
+      - name: Cache cargo registry & build
+        uses: actions/cache@v4
+        with:
+          path: |
+            ~/.cargo/registry
+            ~/.cargo/git
+            flowctl/target
+          key: ${{ runner.os }}-cargo-integration-${{ hashFiles('flowctl/Cargo.lock') }}
+          restore-keys: |
+            ${{ runner.os }}-cargo-integration-
+
+      - name: Build flowctl
+        run: cd flowctl && cargo build --release
+
+      - name: Configure git for tests
+        run: |
+          git config --global user.email "ci@test.local"
+          git config --global user.name "CI Test"
+
+      - name: Run shell integration tests
+        run: bash scripts/tests/run_all.sh
+
   coverage:
     name: Test Coverage
     runs-on: ubuntu-latest

.shellcheckrc

@@ -0,0 +1 @@
+shell=bash

CLAUDE.md

@@ -13,12 +13,12 @@ commands/flow-code/*.md  → Slash command definitions (user-invocable entry poi
 skills/*/SKILL.md        → Skill implementations (loaded by Skill tool, never Read directly)
 agents/*.md              → Subagent definitions (research scouts, worker, plan-sync, etc.)
 bin/flowctl               → Rust binary (built from flowctl/ workspace)
-flowctl/                  → Rust Cargo workspace (3 crates: core, db, cli)
+flowctl/                  → Rust Cargo workspace (4 crates: core, db, service, cli)
 hooks/hooks.json         → Ralph workflow guards (active when FLOW_RALPH=1)
 docs/                    → Architecture docs, CI examples
 ```
 
-**Skills**: 8 core + 16 extensions. See `docs/skills.md` for the full classification. Core workflow: plan → plan-review → work → impl-review → epic-review.
+**Skills**: 8 core + 22 extensions. See `docs/skills.md` for the full classification. Core workflow: `flow-code-run` (unified phase loop) or individual skills: plan → plan-review → work → impl-review → epic-review.
 
 **Key invariant**: The `bin/flowctl` Rust binary is the single source of truth for `.flow/` state. Always invoke as:
 ```bash
@@ -28,6 +28,9 @@ $FLOWCTL <command>
 
 ## Primary Workflow
 
+**Unified entry point** (preferred): `/flow-code:run "description"` — drives the entire pipeline (plan → plan-review → work → impl-review → close) via `flowctl phase next/done`. One command, zero manual phase transitions.
+
+Individual phase commands (deprecated, still functional):
 1. `/flow-code:plan "description"` → creates epic + tasks in `.flow/`
 2. `/flow-code:plan-review` → Carmack-level review via RepoPrompt or Codex
 3. `/flow-code:work <epic-id>` → executes tasks with Teams mode (auto-parallel with file locking)

README.md

@@ -7,9 +7,9 @@
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](../../LICENSE)
 [![Claude Code](https://img.shields.io/badge/Claude_Code-Plugin-blueviolet)](https://claude.ai/code)
 
-[![Version](https://img.shields.io/badge/Version-0.1.27-green)](../../CHANGELOG.md)
+[![Version](https://img.shields.io/badge/Version-0.1.31-green)](https://github.com/z23cc/flow-code/releases)
 
-[![Status](https://img.shields.io/badge/Status-Active_Development-brightgreen)](../../CHANGELOG.md)
+[![Status](https://img.shields.io/badge/Status-Active_Development-brightgreen)](https://github.com/z23cc/flow-code/releases)
 
 **A production-grade harness for Claude Code. Full-auto development from idea to PR.**
 

commands/flow-code/run.md

@@ -0,0 +1,12 @@
+---
+name: run
+description: Unified pipeline entry point for plan-first development
+---
+
+# IMPORTANT: This command MUST invoke the skill flow-code-run
+
+The ONLY purpose of this command is to call the flow-code-run skill. You MUST use that skill now.
+
+**User request:** $ARGUMENTS
+
+Pass the user request to the skill. The skill handles all pipeline logic.