@dv.nghiem/flowdeck 0.3.7 → 0.3.9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (48) hide show
  1. package/README.md +0 -101
  2. package/dist/dashboard/server.mjs +789 -868
  3. package/dist/hooks/command-ref-guard.d.ts +21 -0
  4. package/dist/hooks/command-ref-guard.d.ts.map +1 -0
  5. package/dist/hooks/compaction-hook.d.ts +2 -1
  6. package/dist/hooks/compaction-hook.d.ts.map +1 -1
  7. package/dist/hooks/session-start.d.ts.map +1 -1
  8. package/dist/index.js +33 -14
  9. package/dist/lib/impact-radar.d.ts +2 -2
  10. package/dist/mcp/index.d.ts +3 -2
  11. package/dist/mcp/index.d.ts.map +1 -1
  12. package/dist/services/command-validator.d.ts +61 -0
  13. package/dist/services/command-validator.d.ts.map +1 -0
  14. package/dist/services/command-validator.test.d.ts +2 -0
  15. package/dist/services/command-validator.test.d.ts.map +1 -0
  16. package/dist/services/preflight-explorer.d.ts +130 -0
  17. package/dist/services/preflight-explorer.d.ts.map +1 -0
  18. package/dist/services/preflight-explorer.test.d.ts +25 -0
  19. package/dist/services/preflight-explorer.test.d.ts.map +1 -0
  20. package/dist/services/question-guard.d.ts +92 -0
  21. package/dist/services/question-guard.d.ts.map +1 -0
  22. package/dist/services/quick-router.d.ts +157 -0
  23. package/dist/services/quick-router.d.ts.map +1 -0
  24. package/dist/services/quick-router.test.d.ts +13 -0
  25. package/dist/services/quick-router.test.d.ts.map +1 -0
  26. package/docs/commands.md +43 -23
  27. package/docs/quick-start.md +2 -0
  28. package/docs/workflows.md +1 -1
  29. package/package.json +8 -8
  30. package/src/commands/fd-deploy-check.md +2 -2
  31. package/src/commands/fd-discuss.md +61 -4
  32. package/src/commands/fd-map-codebase.md +1 -1
  33. package/src/commands/fd-multi-repo.md +3 -3
  34. package/src/commands/fd-plan.md +1 -1
  35. package/src/commands/fd-quick.md +303 -55
  36. package/src/rules/common/behavioral.md +63 -0
  37. package/src/skills/blast-radius-preview/SKILL.md +1 -1
  38. package/src/skills/change-impact-radar/SKILL.md +2 -2
  39. package/src/skills/codebase-mapping/SKILL.md +1 -1
  40. package/src/skills/confidence-aware-planning/SKILL.md +1 -1
  41. package/src/skills/context-load/SKILL.md +1 -1
  42. package/src/skills/human-review-routing/SKILL.md +3 -3
  43. package/src/skills/intent-translator/SKILL.md +2 -2
  44. package/src/skills/multi-repo/SKILL.md +1 -1
  45. package/src/skills/regression-prediction/SKILL.md +1 -1
  46. package/src/skills/repo-memory-graph/SKILL.md +1 -1
  47. package/src/skills/test-gap-detector/SKILL.md +1 -1
  48. package/src/skills/volatility-map/SKILL.md +1 -1
package/README.md CHANGED
@@ -172,104 +172,3 @@ Agents not listed in `agents` inherit the active OpenCode model. See [Configurat
172
172
  ## License
173
173
 
174
174
  MIT
175
-
176
-
177
- ---
178
-
179
- ## Quick Install
180
-
181
- ### Method 1: curl (recommended)
182
-
183
- ```bash
184
- curl -fsSL https://raw.githubusercontent.com/DVNghiem/flowdeck/main/install.sh | bash
185
- ```
186
-
187
- ### Method 2: npx (no git required)
188
-
189
- ```bash
190
- npx @dv.nghiem/flowdeck install
191
- ```
192
-
193
- See [Installation](docs/installation.md) for prerequisites, verification steps, and environment variables.
194
-
195
- ---
196
-
197
- ## Core Workflow
198
-
199
- FlowDeck structures every feature through a six-step cycle:
200
-
201
- ```
202
- /fd-new-project → /fd-new-feature → /fd-discuss → /fd-plan → /fd-execute → /fd-verify
203
- ```
204
-
205
- | Step | Command | What happens |
206
- |------|---------|--------------|
207
- | **Setup** | `/fd-new-project MyApp` | Creates `.planning/` directory with `PROJECT.md`, `STATE.md`, and `ROADMAP.md` |
208
- | **Define Feature** | `/fd-new-feature "…"` | Initialize feature context, creates `FEATURE.md` in current phase |
209
- | **Discuss** | `/fd-discuss` | `@discusser` runs structured Q&A, saves decisions to `DISCUSS.md` |
210
- | **Plan** | `/fd-plan` | `@planner` builds a wave-structured `PLAN.md`; you type `CONFIRM` to proceed |
211
- | **Execute** | `/fd-execute` | `@orchestrator` delegates to `@architect`, `@backend-coder`, `@tester`, `@reviewer` via TDD |
212
- | **Verify** | `/fd-verify` | Full test suite, code review, security scan, and deploy check |
213
-
214
- State is written to `.planning/STATE.md` after each phase. Use `/fd-checkpoint` to save mid-session and `/fd-resume` to reload context in a new session.
215
-
216
- ---
217
-
218
- ## Command Reference
219
-
220
- ### Workflow commands
221
-
222
- | Command | Purpose |
223
- |---------|---------|
224
- | `/fd-new-project` | Bootstrap a new project with PROJECT.md, ROADMAP.md, STATE.md |
225
- | `/fd-map-codebase` | Analyse and index the codebase into structured `.codebase/` files |
226
- | `/fd-new-feature` | Define a new feature and initialize feature context |
227
- | `/fd-discuss` | Pre-planning structured Q&A to capture decisions |
228
- | `/fd-plan` | Generate a wave-structured execution plan from decisions |
229
- | `/fd-execute` | Implement feature with TDD discipline and parallel agents |
230
- | `/fd-verify` | Full verification pipeline: tests, code review, security scan, deploy check |
231
- | `/fd-fix-bug` | Diagnose, fix, and verify a bug with regression test |
232
- | `/fd-write-docs` | Explore APIs and generate accurate documentation |
233
- | `/fd-deploy-check` | Pre-deploy safety check with test, security, and build verification |
234
- | `/fd-status` | View project progress, roadmap, and workspace overview |
235
- | `/fd-checkpoint` | Save a session checkpoint to STATE.md |
236
- | `/fd-resume` | Reload STATE.md and PLAN.md to continue interrupted session |
237
- | `/fd-reflect` | Post-session reflection or capture patterns as reusable skills |
238
- | `/fd-multi-repo` | Multi-repo orchestration — list, add, remove, or status |
239
- | `/fd-translate-intent` | Convert vague requests into ranked implementation options |
240
- | `/fd-suggest` | Analyze the codebase and suggest high-value feature opportunities |
241
- | `/fd-ask` | Smart agent dispatch — routes to specialist by keyword |
242
- | `/fd-quick` | Focused task with automatic agent selection |
243
- | `/fd-doctor` | Check FlowDeck installation and environment health |
244
-
245
- ### Analysis commands
246
-
247
- These umbrella commands consolidate multiple analysis modules into focused entry points:
248
-
249
- | Command | Purpose |
250
- |---------|---------|
251
- | `/fd-translate-intent` | Convert vague requests into ranked implementation options with tradeoffs |
252
- | `/fd-suggest` | Combined opportunity and risk analysis (impact, volatility, failures, and skill gaps) |
253
- | `/fd-deploy-check` | Pre-change release safety checks and review routing |
254
- | `/fd-verify` | Standalone verification for tests, review, and security checks |
255
-
256
- See [docs/workflows.md](docs/workflows.md) for details on how analysis commands work.
257
-
258
- ---
259
-
260
- ## Documentation
261
-
262
- | File | Description |
263
- |------|-------------|
264
- | [docs/index.md](docs/index.md) | Full documentation table of contents |
265
- | [docs/installation.md](docs/installation.md) | Prerequisites, install methods, verification, and uninstall |
266
- | [docs/quick-start.md](docs/quick-start.md) | First 15 minutes — step-by-step walkthrough |
267
- | [docs/configuration.md](docs/configuration.md) | `opencode.json`, project config, environment variables, plugin tools |
268
- | [docs/USER_GUIDE.md](docs/USER_GUIDE.md) | Full agent and skill usage reference with examples |
269
- | [docs/workflows.md](docs/workflows.md) | Command architecture and workflow patterns |
270
-
271
- ---
272
-
273
- ## License
274
-
275
- MIT