@dv.nghiem/flowdeck 0.3.9 → 0.4.1

package/src/commands/fd-write-docs.md

@@ -14,7 +14,30 @@ Default: all formats
 
 ## Process
 
-### Step 1: Explore APIs
+### Step 1: CodeGraph Intelligence Check
+
+Before any file exploration, check if codegraph provides a pre-built symbol index:
+
+```
+codegraph action=check
+```
+
+- **If codegraph indexed (fresh)**: Use `codegraph_search`, `codegraph_explore`, `codegraph_node` to enumerate exported symbols and API entry points. This is faster and more complete than grep.
+  - Log: "codegraph available — using symbol index for API discovery"
+- **If codegraph absent or stale**: Fall through to @mapper-based exploration
+
+### Step 2: Explore APIs
+
+**If codegraph is available:**
+
+Use codegraph MCP tools to find all exported symbols:
+```
+codegraph_search("export ")           # exported symbols
+codegraph_explore("<scope or src/>")  # survey module structure
+codegraph_context("<key entry points>") # full context per area
+```
+
+**If codegraph is not available:**
 
 Spawn `@mapper` to:
 - Find all exported functions, classes, and types
@@ -28,7 +51,7 @@ grep -rn "export " src/ --include="*.ts"
 grep -rn "export interface\|export type\|export class" src/ --include="*.ts"
 ```
 
-### Step 2: Draft Documentation
+### Step 3: Draft Documentation
 
 Spawn `@writer` to produce:
 
@@ -57,7 +80,7 @@ const result = functionName(value);
 **Troubleshooting**
 - Common errors and their solutions
 
-### Step 3: Review for Accuracy
+### Step 4: Review for Accuracy
 
 Spawn `@reviewer` to verify:
 - Every documented function/method actually exists
@@ -65,7 +88,9 @@ Spawn `@reviewer` to verify:
 - Examples are syntactically correct
 - No outdated API references
 
-### Step 4: Finalize
+If codegraph is available: use `codegraph_node` to verify specific function signatures against documentation.
+
+### Step 5: Finalize
 
 Writer incorporates feedback and writes final docs to:
 - `README.md` — project overview and quick start
@@ -79,4 +104,4 @@ Updated documentation files with:
 - Working code examples
 - Clear explanations of behavior
 
-Report: files written/updated, public APIs documented, any gaps found.
+Report: files written/updated, public APIs documented, any gaps found, codegraph used ✅/❌.

package/src/skills/context-load/SKILL.md

@@ -60,4 +60,4 @@ After loading context, produce this briefing:
 **Key Conventions**: [2-3 most important patterns]
 ```
 
-If any file is missing, note it: "STATE.md not found — run `/fd-new-project` to initialize."
+If any file is missing, note it: "STATE.md not found — run `/fd-map-codebase` then `/fd-new-feature` to initialize."

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

@@ -1,28 +0,0 @@
-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;
-/**
- * Called when OpenCode compacts a session (session.compacted event).
- *
- * Previously this silently dropped the summary if the session was not in
- * activeSessions (e.g. after plugin reload or cross-process sessions). Now it
- * falls back to a DB lookup so the summary is never lost.
- */
-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

@@ -1 +0,0 @@
-{"version":3,"file":"memory-hook.d.ts","sourceRoot":"","sources":["../../src/hooks/memory-hook.ts"],"names":[],"mappings":"AAAA,OAAO,EAQL,KAAK,OAAO,EAGb,MAAM,0BAA0B,CAAA;AAgGjC,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,CA4BN;AAED,wBAAgB,gBAAgB,CAC9B,gBAAgB,EAAE,MAAM,EACxB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAChB,IAAI,CA6BN;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,gBAAgB,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CA+BhF;AAED,wBAAgB,YAAY,CAAC,gBAAgB,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CA2BjF;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG;IAC9E,OAAO,EAAE,MAAM,CAAA;IACf,gBAAgB,EAAE,OAAO,EAAE,CAAA;CAC5B,CAIA;AAED,wBAAgB,YAAY,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAE3D;AAED,eAAO,MAAM,UAAU;;;;;;;;CAQtB,CAAA"}

package/dist/services/memory-store.d.ts

@@ -1,73 +0,0 @@
-/**
- * Structured handoff artifact persisted alongside the text summary.
- * Derived from observations + LLM compaction output.
- */
-export interface HandoffMetadata {
-    workflow_name: string | null;
-    current_status: string;
-    current_stage: string | null;
-    completed_stages: string[];
-    pending_stages: string[];
-    key_decisions: string[];
-    blockers: string[];
-    important_files: string[];
-    approvals: string[];
-    open_questions: string[];
-    next_steps: string[];
-    tool_names_used: string[];
-    observation_count: number;
-    updated_at: string;
-}
-export interface Observation {
-    id?: number;
-    session_id: number;
-    tool_name: string;
-    tool_input: Record<string, unknown> | null;
-    tool_response: string | null;
-    directory: string;
-    created_at?: string;
-}
-export interface Session {
-    id?: number;
-    content_session_id: string;
-    project: string;
-    directory: string;
-    created_at?: string;
-    last_active_at?: string;
-    summary?: string | null;
-    prompt_count?: number;
-}
-export interface Summary {
-    id?: number;
-    session_id: number;
-    content: string;
-    metadata?: HandoffMetadata | null;
-    created_at?: string;
-}
-export interface SearchResult {
-    observation: Observation;
-    session: Session;
-}
-export declare function initSession(contentSessionId: string, project: string, directory: string): Session;
-export declare function storeObservation(sessionId: number, toolName: string, toolInput: unknown, toolResponse: string | null, directory: string): Observation;
-export declare function storeSummary(sessionId: number, content: string, metadata?: HandoffMetadata | null): Summary;
-export declare function getRecentSessions(directory: string, limit?: number): Session[];
-export declare function getObservationsForSession(sessionId: number): Observation[];
-export declare function getSessionSummary(sessionId: number): Summary | null;
-export declare function getSessionByContentSessionId(contentSessionId: string): Session | null;
-export declare function getRecentObservations(directory: string, limit?: number): SearchResult[];
-export declare function searchObservations(directory: string, query: string, limit?: number): SearchResult[];
-export declare function getContextForDirectory(directory: string, maxObservations?: number): string;
-export declare function closeDatabase(): void;
-/**
- * Returns current connection-level PRAGMA values.
- * Intended for diagnostics and tests — queries via the shared singleton so the
- * values reflect what this module actually set, not a second connection.
- */
-export declare function getDbSettings(): {
-    journal_mode: string;
-    busy_timeout: number;
-    synchronous: number;
-    wal_autocheckpoint: number;
-};
-//# sourceMappingURL=memory-store.d.ts.map

package/dist/services/memory-store.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"memory-store.d.ts","sourceRoot":"","sources":["../../src/services/memory-store.ts"],"names":[],"mappings":"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"}

package/dist/services/memory-store.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=memory-store.test.d.ts.map

package/dist/services/memory-store.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"memory-store.test.d.ts","sourceRoot":"","sources":["../../src/services/memory-store.test.ts"],"names":[],"mappings":""}

package/dist/tools/memory-search.d.ts

@@ -1,3 +0,0 @@
-import { type ToolDefinition } from "@opencode-ai/plugin";
-export declare const memorySearchTool: ToolDefinition;
-//# sourceMappingURL=memory-search.d.ts.map

package/dist/tools/memory-search.d.ts.map

@@ -1 +0,0 @@
-{"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;AAQ/D,eAAO,MAAM,gBAAgB,EAAE,cAgF7B,CAAA"}

package/dist/tools/memory-status.d.ts

@@ -1,3 +0,0 @@
-import { type ToolDefinition } from "@opencode-ai/plugin";
-export declare const memoryStatusTool: ToolDefinition;
-//# sourceMappingURL=memory-status.d.ts.map

package/dist/tools/memory-status.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"memory-status.d.ts","sourceRoot":"","sources":["../../src/tools/memory-status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAU/D,eAAO,MAAM,gBAAgB,EAAE,cAkE7B,CAAA"}

package/docs/USER_GUIDE.md

@@ -1,20 +0,0 @@
-# FlowDeck User Guide
-
-> **This file is superseded by the modular documentation.**
-> See **[docs/index.md](./index.md)** for the full table of contents.
-
-## Quick links
-
-| Topic | File |
-|-------|------|
-| Installation & setup | [installation.md](./installation.md) |
-| First 15 minutes | [quick-start.md](./quick-start.md) |
-| Configuration reference | [configuration.md](./configuration.md) |
-| All agents | [agents.md](./agents.md) |
-| All skills | [skills.md](./skills.md) |
-| All workflows | [workflows.md](./workflows.md) |
-| All commands | [commands.md](./commands.md) |
-| Language rules | [rules.md](./rules.md) |
-| Parallel execution | [parallel-execution.md](./parallel-execution.md) |
-| Multi-repo / microservices | [multi-repo.md](./fd-multi-repo.md) |
-| System notifications | [notifications.md](./notifications.md) |