@dv.nghiem/flowdeck 0.3.9 → 0.4.1

package/README.md

@@ -9,8 +9,8 @@ FlowDeck adds a structured, multi-agent development workflow to OpenCode. It coo
 ## Features
 
 - 🤖 **25 agents** — architect, planner, coder, reviewer, tester, debugger, risk-analyst, policy-enforcer, and more
-- 🛠️ **59 skills** — reusable workflow patterns (TDD, security scan, deploy check, code review, and more)
-- ⚡ **20 commands** — workflow commands for all project operations
+- 🛠️ **64 skills** — reusable workflow patterns (TDD, security scan, deploy check, code review, and more)
+- ⚡ **21 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
@@ -22,7 +22,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** — `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.
+- 🗺️ **Codegraph Integration** — Codegraph-backed code understanding maps the codebase at indexing time and serves as the shared intelligence layer for all commands and agents.
 - ⚙️ **Model-agnostic** — no model is hardcoded. Every agent uses your currently selected OpenCode model. Override per-agent in `flowdeck.json`.
 
 ---
@@ -50,16 +50,18 @@ See [Installation](docs/installation.md) for prerequisites, verification steps,
 FlowDeck structures every feature through a six-step cycle:
 
 ```
-/fd-new-project → /fd-new-feature → /fd-discuss → /fd-plan → /fd-execute → /fd-verify
+/fd-map-codebase → /fd-new-feature → /fd-discuss → /fd-design → /fd-plan → /fd-execute → /fd-verify → /fd-done
 ```
 
 | Step | Command | What happens |
 |------|---------|--------------|
-| **Setup** | `/fd-new-project MyApp` | Creates `.planning/` directory with `PROJECT.md`, `STATE.md`, and `ROADMAP.md` |
+| **Map** | `/fd-map-codebase` | Analyses and indexes the codebase into structured `.codebase/` files |
 | **Define Feature** | `/fd-new-feature "…"` | Initialize feature context, creates `FEATURE.md` in current phase |
 | **Discuss** | `/fd-discuss` | `@discusser` runs structured Q&A, saves decisions to `DISCUSS.md` |
+| **Design** | `/fd-design` | `@design` produces UI artifacts — wireframes, visual system, approval gate |
 | **Plan** | `/fd-plan` | `@planner` builds a wave-structured `PLAN.md`; you type `CONFIRM` to proceed |
 | **Execute** | `/fd-execute` | `@orchestrator` delegates to `@architect`, `@backend-coder`, `@tester`, `@reviewer` via TDD |
+| **Done** | `/fd-done` | Mark complete — validates readiness, finalizes state, refreshes mapping |
 | **Verify** | `/fd-verify` | Full test suite, code review, security scan, and deploy check |
 
 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.
@@ -72,39 +74,29 @@ 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 structured `.codebase/` files |
 | `/fd-new-feature` | Define a new feature and initialize feature context |
 | `/fd-discuss` | Pre-planning structured Q&A to capture decisions |
+| `/fd-design` | Design-first workflow for UI-heavy tasks — draft, review, or define design system rules |
 | `/fd-plan` | Generate a wave-structured execution plan from decisions |
 | `/fd-execute` | Implement feature with TDD discipline and parallel agents |
+| `/fd-done` | Mark feature/phase complete — validates readiness, finalizes state, refreshes mapping |
 | `/fd-verify` | Full verification pipeline: tests, code review, security scan, deploy check |
 | `/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-deploy-check` | Pre-change release safety checks and review routing |
 | `/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-suggest` | Analyze the codebase and suggest high-value feature opportunities |
+| `/fd-translate-intent` | Convert vague requests into ranked implementation options with tradeoffs |
+| `/fd-suggest` | Combined opportunity and risk analysis (impact, volatility, failures, skill gaps) |
 | `/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 |
 
-### Analysis commands
-
-These umbrella commands consolidate multiple analysis modules into focused entry points:
-
-| Command | Purpose |
-|---------|---------|
-| `/fd-translate-intent` | Convert vague requests into ranked implementation options with tradeoffs |
-| `/fd-suggest` | Combined opportunity and risk analysis (impact, volatility, failures, and skill gaps) |
-| `/fd-deploy-check` | Pre-change release safety checks and review routing |
-| `/fd-verify` | Standalone verification for tests, review, and security checks |
-
-See [docs/workflows.md](docs/workflows.md) for details on how analysis commands work.
+See [docs/workflows.md](docs/workflows.md) for details on how commands work.
 
 ---
 

package/dist/agents/code-explorer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"code-explorer.d.ts","sourceRoot":"","sources":["../../src/agents/code-explorer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAmB,YAAY,EAAE,MAAM,SAAS,CAAC;AA8F7D,eAAO,MAAM,uBAAuB,EAAE,YAqBrC,CAAC"}
+{"version":3,"file":"code-explorer.d.ts","sourceRoot":"","sources":["../../src/agents/code-explorer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAmB,YAAY,EAAE,MAAM,SAAS,CAAC;AA6I7D,eAAO,MAAM,uBAAuB,EAAE,YAqBrC,CAAC"}

package/dist/agents/mapper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mapper.d.ts","sourceRoot":"","sources":["../../src/agents/mapper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAmB,YAAY,EAAE,MAAM,SAAS,CAAC;AAsE7D,eAAO,MAAM,iBAAiB,EAAE,YAiB/B,CAAC"}
+{"version":3,"file":"mapper.d.ts","sourceRoot":"","sources":["../../src/agents/mapper.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAmB,YAAY,EAAE,MAAM,SAAS,CAAC;AA8F7D,eAAO,MAAM,iBAAiB,EAAE,YAiB/B,CAAC"}

package/dist/agents/orchestrator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../src/agents/orchestrator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AA2Q/C;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,cAAc,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,MAAM,CAsB5E;AAED,wBAAgB,uBAAuB,CACrC,KAAK,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,EACjE,YAAY,CAAC,EAAE,MAAM,EACrB,kBAAkB,CAAC,EAAE,MAAM,EAC3B,cAAc,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAC3B,eAAe,CAuBjB"}
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../src/agents/orchestrator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAmS/C;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,cAAc,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,MAAM,CAsB5E;AAED,wBAAgB,uBAAuB,CACrC,KAAK,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,EACjE,YAAY,CAAC,EAAE,MAAM,EACrB,kBAAkB,CAAC,EAAE,MAAM,EAC3B,cAAc,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAC3B,eAAe,CAuBjB"}

package/dist/agents/planner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"planner.d.ts","sourceRoot":"","sources":["../../src/agents/planner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAmB,YAAY,EAAE,MAAM,SAAS,CAAC;AA+N7D,eAAO,MAAM,kBAAkB,EAAE,YAiBhC,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,YAqBpC,CAAC"}
+{"version":3,"file":"planner.d.ts","sourceRoot":"","sources":["../../src/agents/planner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAmB,YAAY,EAAE,MAAM,SAAS,CAAC;AAoO7D,eAAO,MAAM,kBAAkB,EAAE,YAiBhC,CAAC;AAEF,eAAO,MAAM,sBAAsB,EAAE,YAqBpC,CAAC"}

package/dist/agents/specialist.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"specialist.d.ts","sourceRoot":"","sources":["../../src/agents/specialist.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAmB,YAAY,EAAE,MAAM,SAAS,CAAC;AAuN7D,eAAO,MAAM,uBAAuB,EAAE,YAqBrC,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,YAiBlC,CAAC"}
+{"version":3,"file":"specialist.d.ts","sourceRoot":"","sources":["../../src/agents/specialist.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAmB,YAAY,EAAE,MAAM,SAAS,CAAC;AA2Q7D,eAAO,MAAM,uBAAuB,EAAE,YAqBrC,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,YAiBlC,CAAC"}

package/dist/dashboard/server.mjs

@@ -12482,7 +12482,12 @@ function readPlanningState(dir) {
       last_action: "",
       next_action: "",
       blockers: [],
-      tdd: undefined
+      tdd: undefined,
+      lastUpdatedAt: "",
+      lastUpdatedBy: "",
+      lastUpdatedPhase: 1,
+      summaryVersion: 0,
+      freshnessStatus: "unknown"
     };
   }
   const content = readFileSync2(sp, "utf-8");
@@ -12503,7 +12508,12 @@ function readPlanningState(dir) {
     last_action: parsed.last_action || "",
     next_action: parsed.next_action || "",
     blockers: parsed.blockers || [],
-    tdd: parseTDDState(parsed)
+    tdd: parseTDDState(parsed),
+    lastUpdatedAt: parsed.lastUpdatedAt || "",
+    lastUpdatedBy: parsed.lastUpdatedBy || "",
+    lastUpdatedPhase: parsed.lastUpdatedPhase || 1,
+    summaryVersion: parsed.summaryVersion || 0,
+    freshnessStatus: parsed.freshnessStatus || "unknown"
   };
 }
 function parseTDDState(parsed) {

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

@@ -6,8 +6,7 @@
  * Context includes:
  * 1. FlowDeck planning state (phase, status, pending steps)
  * 2. Recently edited files (from SessionFileTracker)
- * 3. Historical session summaries from memory store
- * 4. Structured 8-section summary prompt
+ * 3. Structured 8-section summary prompt
  *
  * Inspired by oh-my-openagent's compaction-context-injector and
  * ECC's experimental.session.compacting handler.

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

@@ -1 +1 @@
-{"version":3,"file":"compaction-hook.d.ts","sourceRoot":"","sources":["../../src/hooks/compaction-hook.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AAqDxD,wBAAgB,oBAAoB,CAClC,GAAG,EAAE;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,EAC1B,OAAO,EAAE,kBAAkB,IAGzB,QAAQ;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,EAC7B,QAAQ;IAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,mBAsCjD"}
+{"version":3,"file":"compaction-hook.d.ts","sourceRoot":"","sources":["../../src/hooks/compaction-hook.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AAoDxD,wBAAgB,oBAAoB,CAClC,GAAG,EAAE;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,EAC1B,OAAO,EAAE,kBAAkB,IAGzB,QAAQ;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,EAC7B,QAAQ;IAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,mBA8CjD"}

package/dist/hooks/file-tracker.d.ts

@@ -12,6 +12,8 @@ export interface FileChange {
 }
 export declare class SessionFileTracker {
     private changes;
+    private onFileChange?;
+    setOnFileChange(callback: (path: string, type: ChangeType) => void): void;
     record(path: string, type: ChangeType): void;
     getChanges(): FileChange[];
     getEditedPaths(): string[];
@@ -26,4 +28,8 @@ export declare function createFileTrackerHooks(tracker: SessionFileTracker): {
         type: string;
     }) => void;
 };
+export declare function createCodebaseIndexFileTracker(directory: string): {
+    tracker: SessionFileTracker;
+    publishToIndex: (agent: string, stage: string) => void;
+};
 //# sourceMappingURL=file-tracker.d.ts.map

package/dist/hooks/file-tracker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-tracker.d.ts","sourceRoot":"","sources":["../../src/hooks/file-tracker.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,CAAA;AAEzD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,UAAU,CAAA;CACjB;AAED,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,OAAO,CAAgC;IAE/C,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,IAAI;IAI5C,UAAU,IAAI,UAAU,EAAE;IAI1B,cAAc,IAAI,MAAM,EAAE;IAM1B,KAAK,IAAI,IAAI;CAGd;AAGD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,kBAAkB;wBACrC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE;gCAIR;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE;EAQlE"}
+{"version":3,"file":"file-tracker.d.ts","sourceRoot":"","sources":["../../src/hooks/file-tracker.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,MAAM,UAAU,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,CAAA;AAEzD,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,UAAU,CAAA;CACjB;AAED,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,OAAO,CAAgC;IAC/C,OAAO,CAAC,YAAY,CAAC,CAA0C;IAE/D,eAAe,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,KAAK,IAAI,GAAG,IAAI;IAIzE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,IAAI;IAO5C,UAAU,IAAI,UAAU,EAAE;IAI1B,cAAc,IAAI,MAAM,EAAE;IAM1B,KAAK,IAAI,IAAI;CAGd;AAGD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,kBAAkB;wBACrC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE;gCAIR;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE;EAQlE;AAED,wBAAgB,8BAA8B,CAAC,SAAS,EAAE,MAAM,GAAG;IACjE,OAAO,EAAE,kBAAkB,CAAA;IAC3B,cAAc,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;CACvD,CAkBA"}

package/dist/hooks/notifications.d.ts

@@ -1,21 +1,86 @@
-type NotifyLevel = "info" | "critical";
+export type NotifyLevel = "info" | "critical";
+/**
+ * Structured reasons that can trigger a notification.
+ * Helps consumers understand why a notification fired.
+ */
+export type NotificationReason = "completed" | "input_required" | "confirmation_required" | "error";
+/**
+ * Normalise a raw command string to a bare command name.
+ * "/fd-discuss" → "discuss", "fd-plan" → "plan", "new-feature" → "new-feature"
+ */
+export declare function normalizeCommandName(raw: string): string;
 /**
  * Fire a desktop notification without blocking the caller.
  * Silently ignores failures — notification is best-effort only.
  */
 export declare function notify(title: string, body: string, level?: NotifyLevel): void;
+export type NotifyFn = (title: string, body: string, level?: NotifyLevel) => void;
+/**
+ * Event-driven notification controller.
+ *
+ * Lifecycle:
+ *   1. onCommandExecuted() — records that a command was dispatched (NOT yet processed)
+ *   2. onSessionIdle()     — fires notification when the agent finishes processing
+ *   3. onSessionError()    — fires notification on critical failure
+ *
+ * Deduplication: the same (command + lifecycle-state) pair is never notified twice,
+ * even if session.idle fires multiple times in a row.
+ *
+ * @param notifyFn — injectable notify function (defaults to the real OS notifier; pass
+ *                   a test stub to avoid spawning OS processes in tests).
+ * @param log      — optional diagnostic logger.
+ */
+export declare class NotificationController {
+    /** The command currently awaiting a session.idle notification, or null. */
+    private pendingCommand;
+    /** Key of the last notification that was fired; used for deduplication. */
+    private lastNotifiedKey;
+    private readonly notifyFn;
+    private readonly log;
+    constructor(notifyFn?: NotifyFn, log?: (msg: string) => void);
+    /**
+     * Called when the `command.executed` event fires.
+     * Records the command so the next session.idle can produce the right notification.
+     * Must NOT fire a notification — the command has only been dispatched, not completed.
+     */
+    onCommandExecuted(rawCommand: string): void;
+    /**
+     * Called when the `session.idle` event fires.
+     * Fires at most one notification per pending command.
+     * If no command is pending, fires a generic completion notification only when
+     * the agent actually edited files (hasEdits = true).
+     *
+     * @param hasEdits — true when the session file tracker has recorded edits this turn.
+     */
+    onSessionIdle(hasEdits: boolean): void;
+    /**
+     * Called when the `session.error` event fires.
+     * Always fires unless the identical error was already reported.
+     */
+    onSessionError(errorMsg: string): void;
+    /**
+     * Reset all state. Useful in tests or when starting a new session.
+     */
+    reset(): void;
+    getPendingCommand(): string | null;
+    getLastNotifiedKey(): string | null;
+}
 /**
- * Fires a notification when a command that needs user interaction starts.
- * Call this from command.execute.before after the command result is generated.
+ * Fires a notification when a permission is requested.
+ * This is event-driven (permission.ask hook fires after the agent's request)
+ * so it does not need to go through the NotificationController.
  */
-export declare function notifyCommandInteraction(command: string): void;
+export declare function notifyPermissionNeeded(tool: string): void;
 /**
- * Fires a notification when the session becomes idle (task complete).
+ * @deprecated Use NotificationController.onSessionIdle() instead.
+ * Kept for backward compatibility — does nothing now that the controller
+ * handles all session-idle notifications.
  */
 export declare function notifySessionIdle(): void;
 /**
- * Fires a notification when a permission is requested.
+ * @deprecated Use NotificationController.onCommandExecuted() + onSessionIdle() instead.
+ * This function fired notifications on command ENTRY (too early).
+ * It is preserved as a no-op so that any lingering callers compile without error.
  */
-export declare function notifyPermissionNeeded(tool: string): void;
-export {};
+export declare function notifyCommandInteraction(_command: string): void;
 //# sourceMappingURL=notifications.d.ts.map

package/dist/hooks/notifications.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"notifications.d.ts","sourceRoot":"","sources":["../../src/hooks/notifications.ts"],"names":[],"mappings":"AAmBA,KAAK,WAAW,GAAG,MAAM,GAAG,UAAU,CAAA;AAEtC;;;GAGG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,WAAoB,GAAG,IAAI,CAoCrF;AAUD;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAgB9D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAMxC;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAMzD"}
+{"version":3,"file":"notifications.d.ts","sourceRoot":"","sources":["../../src/hooks/notifications.ts"],"names":[],"mappings":"AAsBA,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,UAAU,CAAA;AAE7C;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAC1B,WAAW,GACX,gBAAgB,GAChB,uBAAuB,GACvB,OAAO,CAAA;AAEX;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;;GAGG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,WAAoB,GAAG,IAAI,CAoCrF;AAUD,MAAM,MAAM,QAAQ,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,WAAW,KAAK,IAAI,CAAA;AAEjF;;;;;;;;;;;;;;GAcG;AACH,qBAAa,sBAAsB;IACjC,2EAA2E;IAC3E,OAAO,CAAC,cAAc,CAAsB;IAC5C,2EAA2E;IAC3E,OAAO,CAAC,eAAe,CAAsB;IAC7C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAU;IACnC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAuB;gBAE/B,QAAQ,GAAE,QAAiB,EAAE,GAAG,GAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAe;IAK9E;;;;OAIG;IACH,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAc3C;;;;;;;OAOG;IACH,aAAa,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI;IA4CtC;;;OAGG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAgBtC;;OAEG;IACH,KAAK,IAAI,IAAI;IAOb,iBAAiB,IAAI,MAAM,GAAG,IAAI;IAClC,kBAAkB,IAAI,MAAM,GAAG,IAAI;CACpC;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAMzD;AAID;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAExC;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAE/D"}

package/dist/hooks/notifications.test.d.ts

@@ -0,0 +1,14 @@
+/**
+ * NotificationController Tests
+ *
+ * Covers the core timing contract:
+ * - No notification when a command is merely entered (command.execute.before)
+ * - Notification fires on session.idle after a completion command
+ * - Notification fires on session.idle after an interactive command
+ * - Notification fires on session.error
+ * - Duplicate notifications are suppressed
+ * - Long-running command only notifies at the correct lifecycle point
+ * - Generic (non-command) idle notification fires only when edits exist
+ */
+export {};
+//# sourceMappingURL=notifications.test.d.ts.map

package/dist/hooks/notifications.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifications.test.d.ts","sourceRoot":"","sources":["../../src/hooks/notifications.test.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG"}

package/dist/hooks/session-idle-hook.d.ts

@@ -1,10 +1,12 @@
 /**
  * Session Idle Hook
  * Fires when OpenCode's session becomes idle (task completed).
- * 1. Sends a desktop notification (if notify() succeeds)
- * 2. Logs a summary of edited files via client.app.log
+ * Logs a summary of edited files via client.app.log.
  *
- * Inspired by oh-my-openagent's session notification + ECC's session.idle handler.
+ * NOTE: Desktop notifications are no longer sent from this hook.
+ * They are handled by NotificationController in notifications.ts, which
+ * fires at the correct lifecycle points (session.idle after a command,
+ * session.error on failure) and deduplicates properly.
  */
 import type { SessionFileTracker } from "./file-tracker";
 export declare function createSessionIdleHook(client: {

package/dist/hooks/session-idle-hook.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-idle-hook.d.ts","sourceRoot":"","sources":["../../src/hooks/session-idle-hook.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AAExD,wBAAgB,qBAAqB,CACnC,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,EAC5I,OAAO,EAAE,kBAAkB,uBAiC5B"}
+{"version":3,"file":"session-idle-hook.d.ts","sourceRoot":"","sources":["../../src/hooks/session-idle-hook.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AAExD,wBAAgB,qBAAqB,CACnC,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,EAC5I,OAAO,EAAE,kBAAkB,uBA0B5B"}

package/dist/hooks/session-start.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session-start.d.ts","sourceRoot":"","sources":["../../src/hooks/session-start.ts"],"names":[],"mappings":"AAMA;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,GACzB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAwElC"}
+{"version":3,"file":"session-start.d.ts","sourceRoot":"","sources":["../../src/hooks/session-start.ts"],"names":[],"mappings":"AAKA;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,GACzB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAkElC"}

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;AAmGjD,QAAA,MAAM,MAAM,EAAE,MA+Vb,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;AAgGjD,QAAA,MAAM,MAAM,EAAE,MAkVb,CAAA;AAED,eAAe,MAAM,CAAA"}