planflow-ai 1.3.4 → 1.4.1

package/.claude/resources/skills/resume-work-skill.md

@@ -0,0 +1,159 @@
+
+# Resume Work Skill
+
+## Purpose
+
+Reconstruct full session context from `flow/STATE.md` after a context reset (compaction, new session, crash). This skill reads the unified state file, identifies the active work, cross-references with the plan file, and outputs a structured summary that enables the LLM to resume work seamlessly.
+
+**This skill is read-only** — it does not create, modify, or delete any files.
+
+---
+
+## Restrictions — READ-ONLY
+
+| Allowed Action | Purpose |
+|----------------|---------|
+| Read `flow/STATE.md` | Parse execution state |
+| Read plan files (`flow/plans/`) | Cross-reference progress |
+| Read discovery files (`flow/discovery/`) | Context for active discovery |
+| Read `flow/.scratchpad.md` | Restore ephemeral notes |
+| Read `flow/tasklist.md` | Check task status |
+
+| Forbidden Action | Reason |
+|------------------|--------|
+| Create/edit any files | Resume is observation-only |
+| Run build or test commands | No execution during resume |
+| Auto-invoke other skills | User decides next action |
+| Modify STATE.md | State persists until actively changed by a skill |
+
+---
+
+## Workflow
+
+### Step 1: Read STATE.md
+
+1. Check if `flow/STATE.md` exists — if not, inform user and stop
+2. Read the file and parse all sections:
+   - `**Updated**` timestamp
+   - `## Execution State` — active skill, plan, phase, task, completed phases
+   - `## Decisions` — decisions with rationale
+   - `## Blockers` — issues with status
+   - `## Files Modified` — changed file paths
+   - `## Next Action` — immediate next step
+
+---
+
+### Step 2: Staleness Check
+
+Parse the `**Updated**` timestamp and compare to current time.
+
+| Age | Behavior |
+|-----|----------|
+| < 24 hours | Continue silently |
+| 24-72 hours | Warn: "State is {N} hours old. Context may be outdated." Ask: resume or start fresh? |
+| > 72 hours | Strong warning: "State is {N} days old. Recommend starting fresh." Ask: resume or start fresh? |
+
+If user chooses "start fresh":
+1. Inform them to delete `flow/STATE.md` manually
+2. Stop — do not proceed with resume
+
+---
+
+### Step 3: Read Active Plan
+
+If `Active Plan` references a plan file:
+
+1. Read the plan file from `flow/plans/`
+2. Parse phase structure and task checkboxes
+3. Cross-reference:
+   - STATE.md `Completed Phases` → plan's `[x]` tasks should match
+   - STATE.md `Current Phase` → identify exact task position
+4. If discrepancies found, note them and trust the plan file
+
+If `Active Plan` is "none", skip this step.
+
+---
+
+### Step 4: Identify Next Task
+
+Based on STATE.md and plan cross-reference:
+
+1. If `Next Action` is set → use it as the recommended next step
+2. If `Current Task` is set → resume from that task
+3. If `Current Phase` is set but no task → start at the first unchecked task in that phase
+4. If no current phase → suggest continuing from the first unchecked phase
+
+---
+
+### Step 5: Output Context Summary
+
+Present a structured summary:
+
+```markdown
+## Session Resumed
+
+**Active Skill**: {skill name}
+**Active Plan**: `{plan file path}`
+**Progress**: Phase {current} of {total} — {phase name}
+**Last Updated**: {timestamp} ({relative time})
+
+### Completed Phases
+| Phase | Name | Outcome |
+|-------|------|---------|
+| 1 | Types and Schemas | done |
+| 2 | Backend Setup | done |
+
+### Decisions Made
+- {decision} — {choice} (reason: {reason})
+
+### Blockers
+| Issue | Status | Tried |
+|-------|--------|-------|
+| {issue} | {status} | {tried} |
+
+### Files Modified ({count})
+- `{file1}`
+- `{file2}`
+
+### Next Action
+> {next action description}
+
+---
+
+Ready to continue. Suggested command: `/execute-plan @{plan-file}`
+```
+
+---
+
+## Error Handling
+
+| Scenario | Behavior |
+|----------|----------|
+| STATE.md missing | Inform user: "No active state found." Stop. |
+| Plan file referenced but missing | Warn: "Plan file not found." Show state without plan cross-reference. |
+| STATE.md malformed | Parse what's possible, warn about missing sections. |
+| Active skill is unknown | Show state as-is, don't suggest a specific command. |
+| Scratchpad exists | Mention: "Session scratchpad has notes — read `flow/.scratchpad.md` for context." |
+
+---
+
+## Rules
+
+1. **Read-only** — never modify any files during resume
+2. **No auto-chaining** — present summary and stop
+3. **Plan file is truth** — if STATE.md and plan disagree, trust the plan
+4. **Graceful degradation** — parse what's available, skip missing sections
+5. **Staleness gate** — always check timestamp before proceeding
+6. **Complement scratchpad** — mention scratchpad if it exists, but don't merge content
+
+---
+
+## Related Files
+
+| File | Purpose |
+|------|---------|
+| `.claude/commands/resume-work.md` | Command file for /resume-work |
+| `.claude/resources/core/compaction-guide.md` | What to preserve during compaction |
+| `.claude/resources/core/session-scratchpad.md` | Complementary session notes |
+| `src/cli/state/state-md-parser.ts` | Programmatic parser for STATE.md |
+| `src/cli/state/types.ts` | ExecutionState type definition |

package/.claude/rules/core/forbidden-patterns.md

@@ -256,4 +256,42 @@ const badExample = problematicCode()
 
 ## Project Anti-Patterns
 
+### 6. DON'T Execute ORM/Database Migration Commands Directly
+
+**Problem**: Running ORM tools (Prisma, Drizzle, TypeORM, Sequelize, Knex, Django ORM, Alembic, etc.) directly can cause irreversible data loss, schema corruption, or unintended migrations in production environments.
+
+```bash
+# BAD - Never run these directly
+npx prisma migrate dev
+npx prisma db push
+npx prisma db seed
+npx drizzle-kit push
+npx drizzle-kit migrate
+npx typeorm migration:run
+python manage.py migrate
+alembic upgrade head
+npx knex migrate:latest
+```
+
+**Why This is Wrong**:
+
+- Database migrations can be destructive and irreversible (dropping columns, tables, data)
+- ORM commands may connect to production databases if environment is misconfigured
+- Schema changes need human review before execution
+- Seed commands can overwrite existing data
+- The AI agent has no way to verify which database environment it's targeting
+
+**Fix**: Always present the command to the user and ask them to execute it manually.
+
+```markdown
+<!-- GOOD - Ask the user to run it -->
+"Please run the following command to apply the migration:"
+
+`npx prisma migrate dev --name add_users_table`
+
+"Review the generated migration SQL before confirming."
+```
+
+**Scope**: This applies to ALL ORM and database tools — Prisma, Drizzle, TypeORM, Sequelize, Knex, Django ORM, Alembic, SQLAlchemy, ActiveRecord, and any other database migration or seeding tool.
+
 <!-- auto-captured anti-patterns below this line -->

package/dist/cli/commands/init.js

@@ -101,7 +101,7 @@ function printNextSteps(platforms) {
     log.blank();
     log.header('Heartbeat Daemon');
     log.info('The heartbeat daemon runs in the background to execute scheduled tasks.');
-    log.info('Manage it with: npx plan-flow heartbeat start|stop|status');
+    log.info('Manage it with: npx planflow-ai heartbeat start|stop|status');
     log.blank();
     log.header('Brain & Obsidian Vault');
     log.info('Your project brain lives at flow/brain/ — features, errors, and decisions are tracked here.');

package/dist/cli/commands/init.js.map

@@ -1 +1 @@
-{"version":3,"file":"init.js","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/state.d.ts

@@ -0,0 +1,12 @@
+/**
+ * State CLI command
+ *
+ * Outputs deterministic JSON representing current plan-flow state.
+ * Composes all parsers: config, session, heartbeat (always),
+ * and plan/waves/tiers (when --plan is provided).
+ */
+export declare function runState(options: {
+    plan?: string;
+    target: string;
+}): Promise<void>;
+//# sourceMappingURL=state.d.ts.map

package/dist/cli/commands/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/state.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAYH,wBAAsB,QAAQ,CAAC,OAAO,EAAE;IACtC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC,IAAI,CAAC,CAmChB"}

package/dist/cli/commands/state.js

@@ -0,0 +1,47 @@
+/**
+ * State CLI command
+ *
+ * Outputs deterministic JSON representing current plan-flow state.
+ * Composes all parsers: config, session, heartbeat (always),
+ * and plan/waves/tiers (when --plan is provided).
+ */
+import { join } from 'node:path';
+import { parseFlowConfig } from '../state/flowconfig-parser.js';
+import { getSessionState } from '../state/session-state.js';
+import { getHeartbeatSummary } from '../state/heartbeat-state.js';
+import { parseStateMd } from '../state/state-md-parser.js';
+import { parsePlan } from '../state/plan-parser.js';
+import { calculateWaves } from '../state/wave-calculator.js';
+import { calculateModelTiers } from '../state/model-router.js';
+export async function runState(options) {
+    try {
+        const flowDir = join(options.target, 'flow');
+        const config = parseFlowConfig(flowDir);
+        const session = getSessionState(flowDir);
+        const heartbeat = getHeartbeatSummary(flowDir);
+        const execution = parseStateMd(flowDir);
+        const output = {
+            config,
+            session,
+            heartbeat,
+            ...(execution ? { execution } : {}),
+        };
+        if (options.plan) {
+            const phases = parsePlan(options.plan);
+            const waves = calculateWaves(phases);
+            const model_tiers = calculateModelTiers(phases, config.model_routing);
+            output.plan = {
+                phases,
+                waves,
+                model_tiers,
+            };
+        }
+        process.stdout.write(JSON.stringify(output, null, 2) + '\n');
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        process.stdout.write(JSON.stringify({ error: message }, null, 2) + '\n');
+        process.exitCode = 1;
+    }
+}
+//# sourceMappingURL=state.js.map

package/dist/cli/commands/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../../src/cli/commands/state.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAG/D,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,OAG9B;IACC,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAE7C,MAAM,MAAM,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;QACxC,MAAM,OAAO,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;QACzC,MAAM,SAAS,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;QAE/C,MAAM,SAAS,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;QAExC,MAAM,MAAM,GAAgB;YAC1B,MAAM;YACN,OAAO;YACP,SAAS;YACT,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACpC,CAAC;QAEF,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACvC,MAAM,KAAK,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;YACrC,MAAM,WAAW,GAAG,mBAAmB,CAAC,MAAM,EAAE,MAAM,CAAC,aAAa,CAAC,CAAC;YAEtE,MAAM,CAAC,IAAI,GAAG;gBACZ,MAAM;gBACN,KAAK;gBACL,WAAW;aACZ,CAAC;QACJ,CAAC;QAED,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAC/D,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;QACzE,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACvB,CAAC;AACH,CAAC"}

package/dist/cli/daemon/desktop-notifier.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Desktop notifier — thin wrapper around node-notifier.
+ * Fire-and-forget: never throws, never blocks.
+ * Degrades silently on headless servers or when node-notifier is unavailable.
+ */
+import type { NotificationEvent } from '../types.js';
+/**
+ * Send a desktop notification for the given event.
+ *
+ * - Title: "Plan-Flow Heartbeat"
+ * - Message: "{task}: {message}"
+ * - Fire-and-forget — does not await the OS notification result
+ * - Catches ALL errors; logs to console.error but never throws
+ */
+export declare function sendDesktopNotification(event: NotificationEvent): void;
+//# sourceMappingURL=desktop-notifier.d.ts.map

package/dist/cli/daemon/desktop-notifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"desktop-notifier.d.ts","sourceRoot":"","sources":["../../../src/cli/daemon/desktop-notifier.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AA6BrD;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI,CAetE"}

package/dist/cli/daemon/desktop-notifier.js

@@ -0,0 +1,53 @@
+/**
+ * Desktop notifier — thin wrapper around node-notifier.
+ * Fire-and-forget: never throws, never blocks.
+ * Degrades silently on headless servers or when node-notifier is unavailable.
+ */
+const NOTIFICATION_TITLE = 'Plan-Flow Heartbeat';
+/**
+ * Lazily resolved notifier instance.
+ * `null` means the import failed (headless server, missing native deps, etc.)
+ */
+let cachedNotifier;
+async function getNotifier() {
+    if (cachedNotifier !== undefined)
+        return cachedNotifier;
+    try {
+        // Dynamic import — may fail on headless systems
+        const mod = await import('node-notifier');
+        // node-notifier exports its instance as both default and named
+        cachedNotifier = (mod.default ?? mod);
+        return cachedNotifier;
+    }
+    catch {
+        // node-notifier unavailable — degrade silently
+        cachedNotifier = null;
+        return null;
+    }
+}
+/**
+ * Send a desktop notification for the given event.
+ *
+ * - Title: "Plan-Flow Heartbeat"
+ * - Message: "{task}: {message}"
+ * - Fire-and-forget — does not await the OS notification result
+ * - Catches ALL errors; logs to console.error but never throws
+ */
+export function sendDesktopNotification(event) {
+    // Intentionally not awaited — fire-and-forget
+    void (async () => {
+        try {
+            const notifier = await getNotifier();
+            if (!notifier)
+                return;
+            notifier.notify({
+                title: NOTIFICATION_TITLE,
+                message: `${event.task}: ${event.message}`,
+            });
+        }
+        catch (error) {
+            console.error('Desktop notification failed (non-fatal):', error);
+        }
+    })();
+}
+//# sourceMappingURL=desktop-notifier.js.map

package/dist/cli/daemon/desktop-notifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"desktop-notifier.js","sourceRoot":"","sources":["../../../src/cli/daemon/desktop-notifier.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,kBAAkB,GAAG,qBAAqB,CAAC;AAKjD;;;GAGG;AACH,IAAI,cAA+C,CAAC;AAEpD,KAAK,UAAU,WAAW;IACxB,IAAI,cAAc,KAAK,SAAS;QAAE,OAAO,cAAc,CAAC;IAExD,IAAI,CAAC;QACH,gDAAgD;QAChD,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,CAAC;QAC1C,+DAA+D;QAC/D,cAAc,GAAG,CAAC,GAAG,CAAC,OAAO,IAAI,GAAG,CAAiB,CAAC;QACtD,OAAO,cAAc,CAAC;IACxB,CAAC;IAAC,MAAM,CAAC;QACP,+CAA+C;QAC/C,cAAc,GAAG,IAAI,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,uBAAuB,CAAC,KAAwB;IAC9D,8CAA8C;IAC9C,KAAK,CAAC,KAAK,IAAI,EAAE;QACf,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,WAAW,EAAE,CAAC;YACrC,IAAI,CAAC,QAAQ;gBAAE,OAAO;YAEtB,QAAQ,CAAC,MAAM,CAAC;gBACd,KAAK,EAAE,kBAAkB;gBACzB,OAAO,EAAE,GAAG,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE;aAC3C,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,0CAA0C,EAAE,KAAK,CAAC,CAAC;QACnE,CAAC;IACH,CAAC,CAAC,EAAE,CAAC;AACP,CAAC"}

package/dist/cli/daemon/event-writer.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Event writer — appends NotificationEvent records to a JSONL file.
+ * Uses atomic write (write-to-temp then rename) to prevent corruption.
+ */
+import type { NotificationEvent, NotificationLevel, NotificationType } from '../types.js';
+/**
+ * Create a NotificationEvent with an auto-generated id and current timestamp.
+ */
+export declare function createEvent(task: string, type: NotificationType, level: NotificationLevel, message: string, phase?: string): NotificationEvent;
+/**
+ * Append a single event to the JSONL file using atomic write.
+ *
+ * Reads the existing file (if any), appends the new JSON line,
+ * writes to a temp file, then renames over the original.
+ */
+export declare function appendEvent(flowDir: string, event: NotificationEvent): Promise<void>;
+/**
+ * Read all events from the JSONL file. Returns an empty array if the file
+ * does not exist.
+ */
+export declare function readEvents(flowDir: string): Promise<NotificationEvent[]>;
+//# sourceMappingURL=event-writer.d.ts.map

package/dist/cli/daemon/event-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-writer.d.ts","sourceRoot":"","sources":["../../../src/cli/daemon/event-writer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAW1F;;GAEG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,gBAAgB,EACtB,KAAK,EAAE,iBAAiB,EACxB,OAAO,EAAE,MAAM,EACf,KAAK,CAAC,EAAE,MAAM,GACb,iBAAiB,CAUnB;AAED;;;;;GAKG;AACH,wBAAsB,WAAW,CAC/B,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,iBAAiB,GACvB,OAAO,CAAC,IAAI,CAAC,CAuBf;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAiB9E"}

package/dist/cli/daemon/event-writer.js

@@ -0,0 +1,76 @@
+/**
+ * Event writer — appends NotificationEvent records to a JSONL file.
+ * Uses atomic write (write-to-temp then rename) to prevent corruption.
+ */
+import { readFile, writeFile, rename, mkdir } from 'node:fs/promises';
+import { randomUUID } from 'node:crypto';
+import { dirname, join } from 'node:path';
+const EVENTS_FILENAME = '.heartbeat-events.jsonl';
+/**
+ * Build the full path to the events file for a given flow directory.
+ */
+function eventsPath(flowDir) {
+    return join(flowDir, EVENTS_FILENAME);
+}
+/**
+ * Create a NotificationEvent with an auto-generated id and current timestamp.
+ */
+export function createEvent(task, type, level, message, phase) {
+    return {
+        id: randomUUID(),
+        timestamp: new Date(),
+        task,
+        type,
+        level,
+        phase,
+        message,
+    };
+}
+/**
+ * Append a single event to the JSONL file using atomic write.
+ *
+ * Reads the existing file (if any), appends the new JSON line,
+ * writes to a temp file, then renames over the original.
+ */
+export async function appendEvent(flowDir, event) {
+    const filePath = eventsPath(flowDir);
+    const dir = dirname(filePath);
+    await mkdir(dir, { recursive: true });
+    let existing = '';
+    try {
+        existing = await readFile(filePath, 'utf-8');
+    }
+    catch {
+        // File does not exist yet — start fresh
+    }
+    const line = JSON.stringify({
+        ...event,
+        timestamp: event.timestamp instanceof Date ? event.timestamp.toISOString() : event.timestamp,
+    });
+    const updated = existing ? `${existing.trimEnd()}\n${line}\n` : `${line}\n`;
+    const tempPath = `${filePath}.tmp`;
+    await writeFile(tempPath, updated, 'utf-8');
+    await rename(tempPath, filePath);
+}
+/**
+ * Read all events from the JSONL file. Returns an empty array if the file
+ * does not exist.
+ */
+export async function readEvents(flowDir) {
+    const filePath = eventsPath(flowDir);
+    let content;
+    try {
+        content = await readFile(filePath, 'utf-8');
+    }
+    catch {
+        return [];
+    }
+    return content
+        .split('\n')
+        .filter((line) => line.trim().length > 0)
+        .map((line) => {
+        const parsed = JSON.parse(line);
+        return { ...parsed, timestamp: new Date(parsed.timestamp) };
+    });
+}
+//# sourceMappingURL=event-writer.js.map

package/dist/cli/daemon/event-writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-writer.js","sourceRoot":"","sources":["../../../src/cli/daemon/event-writer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAG1C,MAAM,eAAe,GAAG,yBAAyB,CAAC;AAElD;;GAEG;AACH,SAAS,UAAU,CAAC,OAAe;IACjC,OAAO,IAAI,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;AACxC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CACzB,IAAY,EACZ,IAAsB,EACtB,KAAwB,EACxB,OAAe,EACf,KAAc;IAEd,OAAO;QACL,EAAE,EAAE,UAAU,EAAE;QAChB,SAAS,EAAE,IAAI,IAAI,EAAE;QACrB,IAAI;QACJ,IAAI;QACJ,KAAK;QACL,KAAK;QACL,OAAO;KACR,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,OAAe,EACf,KAAwB;IAExB,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IACrC,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAE9B,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEtC,IAAI,QAAQ,GAAG,EAAE,CAAC;IAClB,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC/C,CAAC;IAAC,MAAM,CAAC;QACP,wCAAwC;IAC1C,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC;QAC1B,GAAG,KAAK;QACR,SAAS,EAAE,KAAK,CAAC,SAAS,YAAY,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS;KAC7F,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,OAAO,EAAE,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,CAAC;IAE5E,MAAM,QAAQ,GAAG,GAAG,QAAQ,MAAM,CAAC;IACnC,MAAM,SAAS,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;IAC5C,MAAM,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;AACnC,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,OAAe;IAC9C,MAAM,QAAQ,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC;IAErC,IAAI,OAAe,CAAC;IACpB,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC9C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO,OAAO;SACX,KAAK,CAAC,IAAI,CAAC;SACX,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;SACxC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACZ,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAChC,OAAO,EAAE,GAAG,MAAM,EAAE,SAAS,EAAE,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;IAC9D,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/cli/daemon/heartbeat-daemon.js

@@ -8,7 +8,10 @@
 import { readFileSync, writeFileSync, existsSync, unlinkSync, watch, appendFileSync, statSync } from 'node:fs';
 import { join } from 'node:path';
 import { spawn } from 'node:child_process';
+import { randomUUID } from 'node:crypto';
 import { parseHeartbeatFile } from './heartbeat-parser.js';
+import { notify } from './notification-router.js';
+import { writePrompt } from './prompt-manager.js';
 const target = process.argv[2] || process.cwd();
 const heartbeatPath = join(target, 'flow', 'heartbeat.md');
 const pidPath = join(target, 'flow', '.heartbeat.pid');
@@ -18,7 +21,47 @@ let taskRunning = false;
 const ACTIVE_SESSION_ERROR = 'cannot be launched inside another Claude Code session';
 const MAX_RETRIES = 5;
 const RETRY_DELAY_MS = 60_000;
+const TAIL_LINES = 20;
 const retryCountMap = new Map();
+const flowDir = join(target, 'flow');
+/**
+ * Create a NotificationEvent with consistent structure.
+ */
+function createEvent(task, type, level, message, phase) {
+    return {
+        id: randomUUID(),
+        timestamp: new Date(),
+        task: task.name,
+        type,
+        level,
+        message,
+        ...(phase ? { phase } : {}),
+    };
+}
+/**
+ * Return the last N lines from a string.
+ */
+function tailLines(text, n) {
+    const lines = text.split('\n');
+    return lines.slice(-n).join('\n');
+}
+/**
+ * Read the autopilot setting from flow/.flowconfig.
+ * Returns true if autopilot is enabled, false otherwise.
+ */
+function readAutopilot() {
+    try {
+        const configPath = join(flowDir, '.flowconfig');
+        if (!existsSync(configPath))
+            return false;
+        const content = readFileSync(configPath, 'utf-8');
+        const match = content.match(/^autopilot:\s*(true|false)/m);
+        return match?.[1] === 'true';
+    }
+    catch {
+        return false;
+    }
+}
 function log(message) {
     const timestamp = new Date().toISOString();
     const line = `[${timestamp}] ${message}\n`;
@@ -86,6 +129,10 @@ function executeTask(task) {
     }
     taskRunning = true;
     log(`Executing "${task.name}": ${task.command}`);
+    // Snapshot prompt file state before task runs
+    const promptExistedBefore = existsSync(join(flowDir, '.heartbeat-prompt.md'));
+    // Emit task_started notification (fire-and-forget)
+    void notify(createEvent(task, 'task_started', 'info', `Starting task: ${task.name}`), flowDir);
     // Strip CLAUDECODE env var to avoid "nested session" detection.
     // The daemon runs detached — it's not actually nested.
     const cleanEnv = { ...process.env };
@@ -118,13 +165,42 @@ function executeTask(task) {
     });
     child.on('close', (code) => {
         taskRunning = false;
+        const outputTail = tailLines(stdout, TAIL_LINES);
+        const errorTail = tailLines(stderr, TAIL_LINES);
         if (code === 0) {
-            log(`Task "${task.name}" completed successfully`);
             retryCountMap.delete(task.name);
+            // Check if the task created a NEW prompt file (blocked via file, not exit code)
+            const promptPath = join(flowDir, '.heartbeat-prompt.md');
+            if (!promptExistedBefore && existsSync(promptPath)) {
+                log(`Task "${task.name}" completed but created prompt file — treating as blocked`);
+                void notify(createEvent(task, 'task_blocked', 'error', `Task needs input: ${task.name}`), flowDir);
+            }
+            else {
+                log(`Task "${task.name}" completed successfully`);
+                // Emit task_complete notification (fire-and-forget)
+                void notify(createEvent(task, 'task_complete', 'info', `Task completed: ${task.name}`), flowDir);
+            }
             if (task.oneShot) {
                 disableOneShotTask(task.name);
             }
         }
+        else if (code === 2) {
+            // Exit code 2 — task needs human input
+            log(`Task "${task.name}" blocked — needs input (exit code 2)`);
+            if (stderr)
+                log(`  stderr: ${stderr.slice(0, 500)}`);
+            const isAutopilot = readAutopilot();
+            // Emit task_blocked notification (fire-and-forget)
+            void notify(createEvent(task, 'task_blocked', 'error', `Task blocked (needs input): ${task.name}${isAutopilot ? ' [autopilot ON]' : ''}`), flowDir);
+            if (!isAutopilot) {
+                void writePrompt(task.name, outputTail, errorTail, flowDir);
+                log(`  prompt written to flow/${'.heartbeat-prompt.md'} — waiting for human input`);
+            }
+            else {
+                log(`  Autopilot ON — skipping prompt, continuing`);
+            }
+            log(`  context (last ${TAIL_LINES} lines): ${outputTail.slice(0, 500)}`);
+        }
         else if (stderr.includes(ACTIVE_SESSION_ERROR)) {
             scheduleRetry(task);
         }
@@ -132,6 +208,8 @@ function executeTask(task) {
             log(`Task "${task.name}" failed with code ${code}`);
             if (stderr)
                 log(`  stderr: ${stderr.slice(0, 500)}`);
+            // Emit task_failed notification (fire-and-forget)
+            void notify(createEvent(task, 'task_failed', 'error', `Task failed (exit ${code}): ${task.name}${errorTail ? '\n' + errorTail.slice(0, 300) : ''}`), flowDir);
         }
         if (stdout)
             log(`  output: ${stdout.slice(0, 500)}`);
@@ -139,6 +217,8 @@ function executeTask(task) {
     child.on('error', (err) => {
         taskRunning = false;
         log(`Task "${task.name}" error: ${err.message}`);
+        // Emit task_failed notification for spawn errors (fire-and-forget)
+        void notify(createEvent(task, 'task_failed', 'error', `Task spawn error: ${task.name} — ${err.message}`), flowDir);
     });
 }
 function scheduleRetry(task) {