@dv.nghiem/flowdeck 0.2.4 → 0.3.0

package/README.md

@@ -10,7 +10,7 @@ FlowDeck adds a structured, multi-agent development workflow to OpenCode. It coo
 
 - 🤖 **25 agents** — architect, planner, coder, reviewer, tester, debugger, risk-analyst, policy-enforcer, and more
 - 🛠️ **24 skills** — reusable workflow patterns (TDD, security scan, deploy check, code review, and more)
-- ⚡ **24 commands** — 19 workflow commands + 4 umbrella analysis commands + `/fd-ask` smart dispatch
+- ⚡ **17 commands** — workflow commands for all project operations
 - 📋 **15 workflows** — pre-built orchestration flows including Spec-Driven Development (SDD)
 - 🔄 **Persistent state** — resume exactly where you left off across sessions via `.planning/STATE.md`
 - 🔀 **Parallel execution** — independent tasks run simultaneously in wave-structured batches
@@ -21,6 +21,7 @@ FlowDeck adds a structured, multi-agent development workflow to OpenCode. It coo
 - 🪝 **Deep System Hooks** — context window monitoring, session idle summaries, shell environment injection, and structured compaction to prevent context loss
 - 🌐 **Built-in MCPs** — Context7 (docs), Exa (web search), and Grep.app (code search) included and enabled by default
 - 💎 **Ensemble Reasoning** — `/fd-council` tool for synthesized consensus from multiple specialized agents
+- 🧠 **Persistent Memory** — SQLite-based memory stores tool executions, assistant messages, and session summaries. Agents can search past observations with `memory-search` tool.
 
 ---
 
@@ -68,53 +69,35 @@ State is written to `.planning/STATE.md` after each phase. Use `/fd-checkpoint`
 | Command | Purpose |
 |---------|---------|
 | `/fd-new-project` | Bootstrap a new project with PROJECT.md, ROADMAP.md, STATE.md |
-| `/fd-map-codebase` | Analyse and index the codebase into ARCHITECTURE.md and MEMORY.json |
-| `/fd-discuss` | Pre-planning discussion with impact radar integration |
-| `/fd-plan` | Generate a wave-structured execution plan |
-| `/fd-new-feature` | Implement a feature with failure replay and post-execution recording |
-| `/fd-fix-bug` | Fix a bug with impact radar, failure replay, and 7-step workflow |
-| `/fd-review-code` | Code review with impact radar and trust scoring |
-| `/fd-write-docs` | Generate or update documentation |
-| `/fd-deploy-check` | Pre-deploy safety and readiness check |
-| `/fd-progress` | View project progress and completion metrics |
-| `/fd-checkpoint` | Save a session checkpoint for resumption |
-| `/fd-resume` | Resume from a previous checkpoint |
-| `/fd-roadmap` | View and update the project roadmap |
-| `/fd-dashboard` | Visual progress dashboard |
-| `/fd-settings` | Configure FlowDeck settings and execution mode |
-| `/fd-multi-repo` | Multi-repo management |
-| `/fd-ask` | Smart agent dispatch — routes to the right agent by keyword |
+| `/fd-map-codebase` | Analyse and index the codebase into structured `.codebase/` files |
+| `/fd-discuss` | Pre-planning structured Q&A to capture decisions |
+| `/fd-plan` | Generate a wave-structured execution plan from decisions |
+| `/fd-new-feature` | Implement a feature with TDD discipline and parallel agents |
+| `/fd-fix-bug` | Diagnose, fix, and verify a bug with regression test |
+| `/fd-write-docs` | Explore APIs and generate accurate documentation |
+| `/fd-deploy-check` | Pre-deploy safety check with test, security, and build verification |
+| `/fd-status` | View project progress, roadmap, and workspace overview |
+| `/fd-checkpoint` | Save a session checkpoint to STATE.md |
+| `/fd-resume` | Reload STATE.md and PLAN.md to continue interrupted session |
+| `/fd-reflect` | Post-session reflection or capture patterns as reusable skills |
+| `/fd-multi-repo` | Multi-repo orchestration — list, add, remove, or status |
+| `/fd-translate-intent` | Convert vague requests into ranked implementation options |
+| `/fd-ask` | Smart agent dispatch — routes to specialist by keyword |
+| `/fd-quick` | Focused task with automatic agent selection |
 | `/fd-doctor` | Check FlowDeck installation and environment health |
-| `/fd-council` | Ensemble-based reasoning from multiple specialized agents |
 
 ### Analysis commands
 
-These umbrella commands consolidate the full analysis surface into four focused entry points:
+These umbrella commands consolidate multiple analysis modules into focused entry points:
 
 | Command | Purpose |
 |---------|---------|
-| `/fd-analyze-change` | Pre-change analysis — runs impact radar, blast radius, regression prediction, test gap detection, volatility mapping, and reviewer routing in one report |
-| `/fd-guarded-edit` | Edit gate — returns auto-approve / require-confirmation / require-review / block based on policy, trust score, volatility, and arch constraints |
-| `/fd-evaluate-risk` | Risk assessment — risk score, confidence, regression categories, approval needed, safer alternatives |
-| `/fd-translate-intent` | Intent translator — converts vague requests into 3–5 ranked implementation options with assumptions and clarifying questions |
+| `/fd-translate-intent` | Convert vague requests into ranked implementation options with tradeoffs |
+| `/fd-analyze-change` | Combined pre-change analysis (impact, blast radius, regression, test gaps, volatility) |
+| `/fd-guarded-edit` | Edit gate returning auto-approve / confirm / review / block |
+| `/fd-evaluate-risk` | Standalone risk assessment with confidence score |
 
-**Example pre-change workflow:**
-
-```bash
-# 1. Understand the intent
-/fd-translate-intent --intent "make checkout faster"
-
-# 2. Full pre-change analysis
-/fd-analyze-change --change "add Redis cache for checkout queries"
-
-# 3. Gate decision for the specific file
-/fd-guarded-edit --file "src/checkout/query.ts" --change "add Redis cache layer"
-
-# 4. Quantified risk estimate
-/fd-evaluate-risk --change "add Redis cache for checkout queries" --file "src/checkout/query.ts"
-```
-
-The individual analysis commands (`/fd-impact-radar`, `/fd-blast-radius`, `/fd-regression-predict`, `/fd-test-gap`, `/fd-volatility-map`, `/fd-review-route`) remain available for single-purpose use. See [docs/command-migration.md](docs/command-migration.md) for the full migration guide.
+See [docs/workflows.md](docs/workflows.md) for details on how analysis commands work.
 
 ---
 
@@ -127,7 +110,7 @@ The individual analysis commands (`/fd-impact-radar`, `/fd-blast-radius`, `/fd-r
 | [docs/quick-start.md](docs/quick-start.md) | First 15 minutes — step-by-step walkthrough |
 | [docs/configuration.md](docs/configuration.md) | `opencode.json`, project config, environment variables, plugin tools |
 | [docs/USER_GUIDE.md](docs/USER_GUIDE.md) | Full agent and skill usage reference with examples |
-| [docs/command-migration.md](docs/command-migration.md) | Command map, architecture overview, and migration guide |
+| [docs/workflows.md](docs/workflows.md) | Command architecture and workflow patterns |
 
 ---
 

package/dist/hooks/memory-hook.d.ts

@@ -0,0 +1,21 @@
+import { type Session } from "../services/memory-store";
+export declare function onSessionCreated(directory: string, contentSessionId: string, prompt?: string): Session;
+export declare function onToolExecuted(contentSessionId: string, toolName: string, toolInput: Record<string, unknown>, toolResponse: string | null, directory: string): void;
+export declare function onMessageUpdated(contentSessionId: string, role: string, content: string, directory: string): void;
+export declare function onSessionCompact(contentSessionId: string, summary: string): void;
+export declare function onSessionEnd(contentSessionId: string, lastMessage?: string): void;
+export declare function getSessionContext(directory: string, contentSessionId: string): {
+    context: string;
+    previousSessions: Session[];
+};
+export declare function clearSession(contentSessionId: string): void;
+export declare const memoryHook: {
+    onSessionCreated: typeof onSessionCreated;
+    onToolExecuted: typeof onToolExecuted;
+    onMessageUpdated: typeof onMessageUpdated;
+    onSessionCompact: typeof onSessionCompact;
+    onSessionEnd: typeof onSessionEnd;
+    getSessionContext: typeof getSessionContext;
+    clearSession: typeof clearSession;
+};
+//# sourceMappingURL=memory-hook.d.ts.map

package/dist/hooks/memory-hook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-hook.d.ts","sourceRoot":"","sources":["../../src/hooks/memory-hook.ts"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,OAAO,EACb,MAAM,0BAA0B,CAAA;AAwBjC,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAYtG;AAED,wBAAgB,cAAc,CAC5B,gBAAgB,EAAE,MAAM,EACxB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,YAAY,EAAE,MAAM,GAAG,IAAI,EAC3B,SAAS,EAAE,MAAM,GAChB,IAAI,CAsBN;AAED,wBAAgB,gBAAgB,CAC9B,gBAAgB,EAAE,MAAM,EACxB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAChB,IAAI,CAyBN;AAED,wBAAgB,gBAAgB,CAAC,gBAAgB,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAKhF;AAED,wBAAgB,YAAY,CAAC,gBAAgB,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CASjF;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG;IAC9E,OAAO,EAAE,MAAM,CAAA;IACf,gBAAgB,EAAE,OAAO,EAAE,CAAA;CAC5B,CAYA;AAED,wBAAgB,YAAY,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAE3D;AAED,eAAO,MAAM,UAAU;;;;;;;;CAQtB,CAAA"}

package/dist/hooks/orchestrator-guard-hook.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"orchestrator-guard-hook.d.ts","sourceRoot":"","sources":["../../src/hooks/orchestrator-guard-hook.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAuEH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,gBAAgB,CAAsB;IAE9C;;;OAGG;IACH,OAAO,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI;IAa5D;;;OAGG;IACH,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;CASjD"}
+{"version":3,"file":"orchestrator-guard-hook.d.ts","sourceRoot":"","sources":["../../src/hooks/orchestrator-guard-hook.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAsEH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,gBAAgB,CAAsB;IAE9C;;;OAGG;IACH,OAAO,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI;IAa5D;;;OAGG;IACH,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;CASjD"}

package/dist/hooks/todo-hook.d.ts

@@ -3,11 +3,6 @@
  * Logs FlowDeck planning progress whenever OpenCode's todo list is updated.
  * Ported from ECC's todo.updated handler.
  */
-type Todo = {
-    text: string;
-    done: boolean;
-    status?: string;
-};
 export declare function createTodoHook(client: {
     app: {
         log: (args: {
@@ -19,7 +14,6 @@ export declare function createTodoHook(client: {
         }) => Promise<any>;
     };
 }): (event: {
-    todos: Todo[];
+    todos?: unknown;
 }) => Promise<void>;
-export {};
 //# sourceMappingURL=todo-hook.d.ts.map

package/dist/hooks/todo-hook.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"todo-hook.d.ts","sourceRoot":"","sources":["../../src/hooks/todo-hook.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,KAAK,IAAI,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAE5D,wBAAgB,cAAc,CAAC,MAAM,EAAE;IAAE,GAAG,EAAE;QAAE,GAAG,EAAE,CAAC,IAAI,EAAE;YAAE,IAAI,EAAE;gBAAE,OAAO,EAAE,MAAM,CAAC;gBAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;gBAAC,OAAO,EAAE,MAAM,CAAA;aAAE,CAAA;SAAE,KAAK,OAAO,CAAC,GAAG,CAAC,CAAA;KAAE,CAAA;CAAE,IAG3J,OAAO;IAAE,KAAK,EAAE,IAAI,EAAE,CAAA;CAAE,mBAavC"}
+{"version":3,"file":"todo-hook.d.ts","sourceRoot":"","sources":["../../src/hooks/todo-hook.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,wBAAgB,cAAc,CAAC,MAAM,EAAE;IAAE,GAAG,EAAE;QAAE,GAAG,EAAE,CAAC,IAAI,EAAE;YAAE,IAAI,EAAE;gBAAE,OAAO,EAAE,MAAM,CAAC;gBAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;gBAAC,OAAO,EAAE,MAAM,CAAA;aAAE,CAAA;SAAE,KAAK,OAAO,CAAC,GAAG,CAAC,CAAA;KAAE,CAAA;CAAE,IAG3J,OAAO;IAAE,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,mBAezC"}

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AA2EjD,QAAA,MAAM,MAAM,EAAE,MAoKb,CAAA;AAED,eAAe,MAAM,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAiGjD,QAAA,MAAM,MAAM,EAAE,MAqNb,CAAA;AAED,eAAe,MAAM,CAAA"}