@dv.nghiem/flowdeck 0.2.4 → 0.3.1

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 (82) hide show
  1. package/README.md +24 -41
  2. package/dist/hooks/approval-hook.d.ts +6 -0
  3. package/dist/hooks/approval-hook.d.ts.map +1 -1
  4. package/dist/hooks/guard-rails.d.ts +0 -8
  5. package/dist/hooks/guard-rails.d.ts.map +1 -1
  6. package/dist/hooks/memory-hook.d.ts +21 -0
  7. package/dist/hooks/memory-hook.d.ts.map +1 -0
  8. package/dist/hooks/orchestrator-guard-hook.d.ts.map +1 -1
  9. package/dist/hooks/patch-trust.d.ts.map +1 -1
  10. package/dist/hooks/todo-hook.d.ts +1 -7
  11. package/dist/hooks/todo-hook.d.ts.map +1 -1
  12. package/dist/hooks/tool-guard.d.ts +1 -0
  13. package/dist/hooks/tool-guard.d.ts.map +1 -1
  14. package/dist/index.d.ts.map +1 -1
  15. package/dist/index.js +728 -428
  16. package/dist/services/memory-store.d.ts +40 -0
  17. package/dist/services/memory-store.d.ts.map +1 -0
  18. package/dist/services/policy-compiler.d.ts.map +1 -1
  19. package/dist/tools/memory-search.d.ts +3 -0
  20. package/dist/tools/memory-search.d.ts.map +1 -0
  21. package/docs/commands/fd-doctor.md +21 -0
  22. package/docs/commands/fd-quick.md +33 -0
  23. package/docs/commands/fd-reflect.md +23 -0
  24. package/docs/commands/fd-status.md +31 -0
  25. package/docs/commands/fd-translate-intent.md +17 -0
  26. package/docs/commands.md +209 -271
  27. package/docs/configuration.md +5 -2
  28. package/docs/index.md +22 -28
  29. package/docs/memory.md +69 -0
  30. package/docs/quick-start.md +1 -1
  31. package/package.json +1 -1
  32. package/src/commands/fd-deploy-check.md +131 -11
  33. package/src/commands/fd-new-project.md +14 -1
  34. package/src/commands/fd-quick.md +60 -0
  35. package/src/commands/fd-reflect.md +41 -2
  36. package/src/commands/fd-status.md +84 -0
  37. package/src/rules/README.md +8 -7
  38. package/src/skills/agent-harness-construction/SKILL.md +227 -0
  39. package/src/skills/api-design/SKILL.md +5 -0
  40. package/src/skills/backend-patterns/SKILL.md +105 -0
  41. package/src/skills/clean-architecture/SKILL.md +85 -0
  42. package/src/skills/cqrs/SKILL.md +230 -0
  43. package/src/skills/ddd-architecture/SKILL.md +104 -0
  44. package/src/skills/django-patterns/SKILL.md +304 -0
  45. package/src/skills/django-tdd/SKILL.md +297 -0
  46. package/src/skills/event-driven-architecture/SKILL.md +152 -0
  47. package/src/skills/frontend-pattern/SKILL.md +159 -0
  48. package/src/skills/hexagonal-architecture/SKILL.md +80 -0
  49. package/src/skills/layered-architecture/SKILL.md +64 -0
  50. package/src/skills/postgres-patterns/SKILL.md +74 -0
  51. package/src/skills/python-patterns/SKILL.md +5 -0
  52. package/src/skills/saga-architecture/SKILL.md +113 -0
  53. package/dist/tools/run-parallel.d.ts +0 -4
  54. package/dist/tools/run-parallel.d.ts.map +0 -1
  55. package/docs/command-migration.md +0 -175
  56. package/docs/commands/fd-analyze-change.md +0 -107
  57. package/docs/commands/fd-dashboard.md +0 -11
  58. package/docs/commands/fd-evaluate-risk.md +0 -134
  59. package/docs/commands/fd-guarded-edit.md +0 -105
  60. package/docs/commands/fd-progress.md +0 -11
  61. package/docs/commands/fd-review-code.md +0 -29
  62. package/docs/commands/fd-roadmap.md +0 -10
  63. package/docs/commands/fd-settings.md +0 -10
  64. package/docs/parallel-execution.md +0 -255
  65. package/src/commands/fd-analyze-change.md +0 -57
  66. package/src/commands/fd-approve.md +0 -64
  67. package/src/commands/fd-blast-radius.md +0 -49
  68. package/src/commands/fd-dashboard.md +0 -57
  69. package/src/commands/fd-evaluate-risk.md +0 -62
  70. package/src/commands/fd-guarded-edit.md +0 -69
  71. package/src/commands/fd-impact-radar.md +0 -51
  72. package/src/commands/fd-learn.md +0 -36
  73. package/src/commands/fd-progress.md +0 -50
  74. package/src/commands/fd-regression-predict.md +0 -57
  75. package/src/commands/fd-review-code.md +0 -96
  76. package/src/commands/fd-review-route.md +0 -54
  77. package/src/commands/fd-roadmap.md +0 -46
  78. package/src/commands/fd-settings.md +0 -57
  79. package/src/commands/fd-test-gap.md +0 -54
  80. package/src/commands/fd-volatility-map.md +0 -64
  81. package/src/commands/fd-workspace-status.md +0 -34
  82. package/src/skills/parallel-execute/SKILL.md +0 -92
@@ -0,0 +1,40 @@
1
+ export interface Observation {
2
+ id?: number;
3
+ session_id: number;
4
+ tool_name: string;
5
+ tool_input: Record<string, unknown> | null;
6
+ tool_response: string | null;
7
+ directory: string;
8
+ created_at?: string;
9
+ }
10
+ export interface Session {
11
+ id?: number;
12
+ content_session_id: string;
13
+ project: string;
14
+ directory: string;
15
+ created_at?: string;
16
+ last_active_at?: string;
17
+ summary?: string | null;
18
+ prompt_count?: number;
19
+ }
20
+ export interface Summary {
21
+ id?: number;
22
+ session_id: number;
23
+ content: string;
24
+ created_at?: string;
25
+ }
26
+ export interface SearchResult {
27
+ observation: Observation;
28
+ session: Session;
29
+ }
30
+ export declare function initSession(contentSessionId: string, project: string, directory: string): Session;
31
+ export declare function storeObservation(sessionId: number, toolName: string, toolInput: unknown, toolResponse: string | null, directory: string): Observation;
32
+ export declare function storeSummary(sessionId: number, content: string): Summary;
33
+ export declare function getRecentSessions(directory: string, limit?: number): Session[];
34
+ export declare function getObservationsForSession(sessionId: number): Observation[];
35
+ export declare function getSessionSummary(sessionId: number): Summary | null;
36
+ export declare function getRecentObservations(directory: string, limit?: number): SearchResult[];
37
+ export declare function searchObservations(directory: string, query: string, limit?: number): SearchResult[];
38
+ export declare function getContextForDirectory(directory: string, maxObservations?: number): string;
39
+ export declare function closeDatabase(): void;
40
+ //# sourceMappingURL=memory-store.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"memory-store.d.ts","sourceRoot":"","sources":["../../src/services/memory-store.ts"],"names":[],"mappings":"AAkEA,MAAM,WAAW,WAAW;IAC1B,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;IAC1C,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,OAAO;IACtB,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,kBAAkB,EAAE,MAAM,CAAA;IAC1B,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,OAAO;IACtB,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,WAAW,CAAA;IACxB,OAAO,EAAE,OAAO,CAAA;CACjB;AAoBD,wBAAgB,WAAW,CAAC,gBAAgB,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CA8BjG;AAED,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,OAAO,EAClB,YAAY,EAAE,MAAM,GAAG,IAAI,EAC3B,SAAS,EAAE,MAAM,GAChB,WAAW,CAqBb;AAED,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAgBxE;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,OAAO,EAAE,CAUzE;AAED,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,EAAE,CAU1E;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAGnE;AAED,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,YAAY,EAAE,CAyBnF;AAED,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,YAAY,EAAE,CA2B/F;AAED,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,eAAe,SAAK,GAAG,MAAM,CAwCtF;AAED,wBAAgB,aAAa,IAAI,IAAI,CAKpC"}
@@ -1 +1 @@
1
- {"version":3,"file":"policy-compiler.d.ts","sourceRoot":"","sources":["../../src/services/policy-compiler.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,OAAO,GAAG,MAAM,CAAA;CAC3B;AAiCD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,GAAG,eAAe,EAAE,CA8BnF;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,SAAS,CAAA;IACjB,aAAa,EAAE,MAAM,CAAA;IACrB,SAAS,EAAE,MAAM,CAAA;CAClB;AA8FD,wBAAgB,gBAAgB,CAC9B,YAAY,EAAE,MAAM,EACpB,cAAc,EAAE,MAAM,EAAE,EACxB,UAAU,CAAC,EAAE,MAAM,GAClB,cAAc,GAAG,IAAI,CAmBvB;AAED,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,eAAe,EAAE,GAAG,MAAM,CAUtE"}
1
+ {"version":3,"file":"policy-compiler.d.ts","sourceRoot":"","sources":["../../src/services/policy-compiler.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,aAAa;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,QAAQ,EAAE,OAAO,GAAG,MAAM,CAAA;CAC3B;AAiCD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,GAAG,eAAe,EAAE,CA8BnF;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,SAAS,CAAA;IACjB,aAAa,EAAE,MAAM,CAAA;IACrB,SAAS,EAAE,MAAM,CAAA;CAClB;AA+FD,wBAAgB,gBAAgB,CAC9B,YAAY,EAAE,MAAM,EACpB,cAAc,EAAE,MAAM,EAAE,EACxB,UAAU,CAAC,EAAE,MAAM,GAClB,cAAc,GAAG,IAAI,CAmBvB;AAED,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,eAAe,EAAE,GAAG,MAAM,CAUtE"}
@@ -0,0 +1,3 @@
1
+ import { type ToolDefinition } from "@opencode-ai/plugin";
2
+ export declare const memorySearchTool: ToolDefinition;
3
+ //# sourceMappingURL=memory-search.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"memory-search.d.ts","sourceRoot":"","sources":["../../src/tools/memory-search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAG/D,eAAO,MAAM,gBAAgB,EAAE,cAwE7B,CAAA"}
@@ -0,0 +1,21 @@
1
+ ---
2
+ description: Check FlowDeck installation and environment health
3
+ ---
4
+
5
+ # Doctor
6
+
7
+ Check FlowDeck installation and environment health.
8
+
9
+ ## Checks
10
+
11
+ - OpenCode CLI version
12
+ - FlowDeck plugin registration
13
+ - Workspace state (STATE.md)
14
+ - Codebase map (ARCHITECTURE.md)
15
+ - Planning phases directory
16
+
17
+ ## Example
18
+
19
+ ```
20
+ /fd-doctor
21
+ ```
@@ -0,0 +1,33 @@
1
+ ---
2
+ description: Quick task execution — analyze, implement, review, or investigate a specific piece of work without the full discuss -> plan -> execute workflow
3
+ argument-hint: [task description]
4
+ ---
5
+
6
+ # Quick Task
7
+
8
+ Execute a focused task without the full workflow. Analyzes the request, selects the best specialist agent, and returns the result directly.
9
+
10
+ ## Agent Selection Matrix
11
+
12
+ | Task Type | Agent |
13
+ |-----------|-------|
14
+ | Write/edit code | @coder |
15
+ | Explore/understand | @code-explorer |
16
+ | Review code | @reviewer |
17
+ | Security review | @security-auditor |
18
+ | Design/architecture | @architect |
19
+ | Write tests | @tester |
20
+ | Documentation | @doc-updater |
21
+ | Research | @researcher |
22
+ | Debug | @debug-specialist |
23
+ | Performance | @performance-optimizer |
24
+ | Build error | @build-error-resolver |
25
+
26
+ ## Examples
27
+
28
+ ```
29
+ /fd-quick find where session validation happens
30
+ /fd-quick add rate limiting to the API
31
+ ```
32
+
33
+ **Note:** Use for small tasks only (~15 min). For larger work, use `/fd-new-feature`.
@@ -0,0 +1,23 @@
1
+ ---
2
+ description: Post-session reflection and skill capture — analyse artifacts, propose improvements, capture session patterns
3
+ argument-hint: [--mode=reflect,learn]
4
+ ---
5
+
6
+ # Reflect
7
+
8
+ Post-session reflection to analyse artifacts and propose improvements, or capture learnings as reusable skills.
9
+
10
+ ## Modes
11
+
12
+ ### Reflect (default)
13
+ Analyzes session artifacts, proposes skills/policies/workflow changes.
14
+
15
+ ### Learn (`--mode=learn`)
16
+ Captures a repeatable pattern as a reusable FlowDeck skill.
17
+
18
+ ## Examples
19
+
20
+ ```
21
+ /fd-reflect
22
+ /fd-reflect --mode=learn auth-pattern
23
+ ```
@@ -0,0 +1,31 @@
1
+ ---
2
+ description: View project status — combined status, roadmap, workspace overview, and progress
3
+ argument-hint: [--roadmap | --workspace | --phase=N]
4
+ ---
5
+
6
+ # Status
7
+
8
+ View project status combining progress, roadmap, and workspace overview.
9
+
10
+ ## Modes
11
+
12
+ ### Default (no flags)
13
+ Show current phase status summary from STATE.md.
14
+
15
+ ### Roadmap (`--roadmap`)
16
+ Display project roadmap with phase statuses.
17
+
18
+ ### Workspace (`--workspace`)
19
+ Display overview of all registered repositories.
20
+
21
+ ### Phase Detail (`--phase=N`)
22
+ Show detailed progress for a specific phase.
23
+
24
+ ## Examples
25
+
26
+ ```
27
+ /fd-status
28
+ /fd-status --roadmap
29
+ /fd-status --workspace
30
+ /fd-status --phase=2
31
+ ```
@@ -0,0 +1,17 @@
1
+ ---
2
+ description: Intent-to-Change Translator — convert vague requests into 3–5 concrete, ranked implementation options with tradeoffs
3
+ argument-hint: [vague intent, e.g. "make checkout faster"]
4
+ ---
5
+
6
+ # Translate Intent
7
+
8
+ Convert a vague or high-level request into concrete ranked implementation options with tradeoffs.
9
+
10
+ ## Examples
11
+
12
+ ```
13
+ /fd-translate-intent make checkout faster
14
+ /fd-translate-intent improve auth security
15
+ ```
16
+
17
+ Returns 3-5 options with description, files affected, effort, risk, and tradeoffs.