maestro-flow 0.1.3 → 0.2.0

package/dist/src/hooks/statusline.js

@@ -0,0 +1,319 @@
+/**
+ * Maestro Statusline Hook
+ *
+ * Displays: model | phase | task | directory | ASCII-face context bar
+ * Writes bridge file for context-monitor hook consumption.
+ *
+ * Input (stdin JSON from Claude Code):
+ *   { model, workspace, session_id, context_window }
+ *
+ * Output (stdout): formatted statusline string
+ */
+import { readFileSync, readdirSync, statSync, existsSync, writeFileSync } from 'node:fs';
+import { join, basename } from 'node:path';
+import { homedir, tmpdir } from 'node:os';
+import { AUTO_COMPACT_BUFFER_PCT, BRIDGE_PREFIX, FACES, FACE_COLORS, ANSI_RESET, ANSI_DIM, ANSI_BOLD, ANSI_CYAN, getFaceLevel, } from './constants.js';
+import { readCoordBridge } from './coordinator-tracker.js';
+import { resolveSelf } from '../tools/team-members.js';
+import { readRecentActivity } from '../tools/team-activity.js';
+import { findWorkspaceRoot } from './workspace.js';
+/** Normalize remaining% to usable context (accounts for autocompact buffer) */
+function normalizeUsage(remaining) {
+    const usableRemaining = Math.max(0, ((remaining - AUTO_COMPACT_BUFFER_PCT) / (100 - AUTO_COMPACT_BUFFER_PCT)) * 100);
+    return Math.max(0, Math.min(100, Math.round(100 - usableRemaining)));
+}
+/**
+ * Build the context bar: face [=====-----] 62%
+ */
+function buildContextBar(usedPct) {
+    const level = getFaceLevel(usedPct);
+    const face = FACES[level];
+    const color = FACE_COLORS[level];
+    const filled = Math.floor(usedPct / 10);
+    const bar = '='.repeat(filled) + '-'.repeat(10 - filled);
+    return ` ${color}${face} [${bar}] ${usedPct}%${ANSI_RESET}`;
+}
+/** Write bridge file for context-monitor to consume */
+function writeBridge(session, remaining, usedPct) {
+    try {
+        const bridgePath = join(tmpdir(), `${BRIDGE_PREFIX}${session}.json`);
+        const data = {
+            session_id: session,
+            remaining_percentage: remaining,
+            used_pct: usedPct,
+            timestamp: Math.floor(Date.now() / 1000),
+        };
+        writeFileSync(bridgePath, JSON.stringify(data));
+    }
+    catch {
+        // Silent fail — bridge is best-effort
+    }
+}
+/** Read current in-progress task from Claude Code todos */
+function readCurrentTask(session) {
+    const claudeDir = process.env.CLAUDE_CONFIG_DIR || join(homedir(), '.claude');
+    const todosDir = join(claudeDir, 'todos');
+    if (!existsSync(todosDir))
+        return '';
+    try {
+        const files = readdirSync(todosDir)
+            .filter((f) => f.startsWith(session) && f.includes('-agent-') && f.endsWith('.json'))
+            .map((f) => ({ name: f, mtime: statSync(join(todosDir, f)).mtime }))
+            .sort((a, b) => b.mtime.getTime() - a.mtime.getTime());
+        if (files.length > 0) {
+            const todos = JSON.parse(readFileSync(join(todosDir, files[0].name), 'utf8'));
+            const inProgress = todos.find((t) => t.status === 'in_progress');
+            if (inProgress)
+                return inProgress.activeForm || '';
+        }
+    }
+    catch {
+        // Silently fail
+    }
+    return '';
+}
+/** Read current phase from .workflow/state.json (using workspace resolver) */
+function readPhase(dir) {
+    const root = findWorkspaceRoot(dir);
+    if (!root)
+        return '';
+    const statePath = join(root, '.workflow', 'state.json');
+    if (!existsSync(statePath))
+        return '';
+    try {
+        const state = JSON.parse(readFileSync(statePath, 'utf8'));
+        if (state.current_phase) {
+            let label = `P${state.current_phase}`;
+            if (state.current_step)
+                label += `.${state.current_step}`;
+            return label;
+        }
+    }
+    catch {
+        // Silently fail
+    }
+    return '';
+}
+// ---------------------------------------------------------------------------
+// Teammate activity segment (team-lite Wave 3B)
+//
+// Shows a compact summary of recent teammate activity in the statusline:
+//   "\u{1F465} alice (P3/001) | bob (spec-auth) +2"
+//
+// Contract:
+//   - Must be cheap (statusline runs on every refresh).
+//   - Result is cached per-session for 10s in os.tmpdir().
+//   - Must never throw — any error maps to empty string.
+//   - Emits nothing if team mode is off or no teammate activity in 30m.
+// ---------------------------------------------------------------------------
+/** TTL for the per-session team segment cache. */
+const TEAM_CACHE_TTL_MS = 10_000;
+/** Recent-activity lookback window for the team segment. */
+const TEAM_WINDOW_MIN = 30;
+/** Max teammates rendered inline before collapsing to " +N". */
+const TEAM_MAX_INLINE = 3;
+function teamCachePath(session) {
+    return join(tmpdir(), `maestro-team-statusline-${session}.json`);
+}
+function writeTeamCache(path, segment) {
+    try {
+        const data = { ts: Date.now(), segment };
+        writeFileSync(path, JSON.stringify(data));
+    }
+    catch {
+        // Best-effort: cache write failure must not break statusline.
+    }
+    return segment;
+}
+/**
+ * Collapse a task id to its short tail.
+ *
+ *   "TASK-001"          -> "001"
+ *   "WFS-auth-refactor" -> "refactor"
+ *   "plain"             -> "plain"
+ */
+function shortTaskId(taskId) {
+    const idx = taskId.lastIndexOf('-');
+    if (idx < 0)
+        return taskId;
+    return taskId.slice(idx + 1) || taskId;
+}
+/**
+ * Format a single teammate's inline label from their most recent event.
+ *
+ * Rules (in priority order):
+ *   - phase_id + task_id -> "name (P{phase}/{short_task})"
+ *   - phase_id only      -> "name (P{phase})"
+ *   - target only        -> "name ({target})"
+ *   - otherwise          -> "name"
+ */
+function formatTeammate(name, evt) {
+    if (typeof evt.phase_id === 'number' && typeof evt.task_id === 'string' && evt.task_id) {
+        return `${name} (P${evt.phase_id}/${shortTaskId(evt.task_id)})`;
+    }
+    if (typeof evt.phase_id === 'number') {
+        return `${name} (P${evt.phase_id})`;
+    }
+    if (typeof evt.target === 'string' && evt.target) {
+        return `${name} (${evt.target})`;
+    }
+    return name;
+}
+/**
+ * Build the teammate activity segment. Returns empty string if:
+ *   - Team mode not enabled (no self record)
+ *   - No recent teammate activity in the last 30 minutes (excluding self)
+ *   - Any error (never throws)
+ *
+ * Result is cached per-session for 10 seconds via a JSON file in os.tmpdir().
+ */
+export function buildTeamSegment(session) {
+    try {
+        // ---- Cache check ----
+        const cachePath = teamCachePath(session);
+        if (existsSync(cachePath)) {
+            try {
+                const cached = JSON.parse(readFileSync(cachePath, 'utf8'));
+                if (cached &&
+                    typeof cached.ts === 'number' &&
+                    typeof cached.segment === 'string' &&
+                    Date.now() - cached.ts < TEAM_CACHE_TTL_MS) {
+                    return cached.segment;
+                }
+            }
+            catch {
+                // Corrupt cache file — fall through and recompute.
+            }
+        }
+        // ---- Team mode gate ----
+        const self = resolveSelf();
+        if (!self)
+            return writeTeamCache(cachePath, '');
+        // ---- Read recent activity ----
+        const events = readRecentActivity(TEAM_WINDOW_MIN);
+        if (events.length === 0)
+            return writeTeamCache(cachePath, '');
+        // Group by "user@host", keep the most recent event per teammate.
+        // Exclude self (match on both user and host to avoid cross-host uid collision).
+        const latest = new Map();
+        for (const evt of events) {
+            if (!evt || typeof evt.user !== 'string' || typeof evt.host !== 'string')
+                continue;
+            if (evt.user === self.uid && evt.host === self.host)
+                continue;
+            const key = `${evt.user}@${evt.host}`;
+            const prev = latest.get(key);
+            if (!prev) {
+                latest.set(key, evt);
+                continue;
+            }
+            const prevT = Date.parse(prev.ts);
+            const curT = Date.parse(evt.ts);
+            if (!Number.isNaN(curT) && (Number.isNaN(prevT) || curT >= prevT)) {
+                latest.set(key, evt);
+            }
+        }
+        if (latest.size === 0)
+            return writeTeamCache(cachePath, '');
+        // Sort teammates newest-first so the 3 most active show up inline.
+        const ordered = Array.from(latest.values()).sort((a, b) => {
+            const ta = Date.parse(a.ts);
+            const tb = Date.parse(b.ts);
+            const sa = Number.isNaN(ta) ? 0 : ta;
+            const sb = Number.isNaN(tb) ? 0 : tb;
+            return sb - sa;
+        });
+        const inline = ordered.slice(0, TEAM_MAX_INLINE).map((evt) => formatTeammate(evt.user, evt));
+        let body = inline.join(' | ');
+        const extra = ordered.length - inline.length;
+        if (extra > 0)
+            body += ` +${extra}`;
+        const segment = `\u{1F465} ${body}`;
+        return writeTeamCache(cachePath, segment);
+    }
+    catch {
+        // Hot path — never let statusline crash.
+        return '';
+    }
+}
+/**
+ * Build coordinator progress segment from bridge file.
+ * Returns e.g. "[3/6]verify" or "[P]review" (paused) or empty string.
+ */
+export function buildCoordinatorSegment(session) {
+    if (!session)
+        return '';
+    try {
+        const bridge = readCoordBridge(session);
+        if (!bridge)
+            return '';
+        const { status, steps_completed, steps_total, current_step } = bridge;
+        if (status === 'completed' || status === 'failed')
+            return '';
+        const stepLabel = current_step?.skill ?? '';
+        const isPaused = status === 'paused' || status === 'step_paused';
+        const prefix = isPaused ? 'P' : `${steps_completed}/${steps_total}`;
+        let seg = `[${prefix}]${stepLabel}`;
+        if (bridge.coord_session_id) {
+            const shortId = bridge.coord_session_id.slice(0, 12);
+            seg += ` (${shortId})`;
+        }
+        return seg;
+    }
+    catch {
+        return '';
+    }
+}
+/** Main statusline handler — processes input and returns formatted string */
+export function formatStatusline(data) {
+    const model = data.model?.display_name || 'Claude';
+    const dir = data.workspace?.current_dir || process.cwd();
+    const session = data.session_id || '';
+    const remaining = data.context_window?.remaining_percentage;
+    // Context bar + bridge write
+    let ctx = '';
+    if (remaining != null) {
+        const usedPct = normalizeUsage(remaining);
+        if (session)
+            writeBridge(session, remaining, usedPct);
+        ctx = buildContextBar(usedPct);
+    }
+    // Current task
+    const task = session ? readCurrentTask(session) : '';
+    // Phase from .workflow/
+    const phase = readPhase(dir);
+    // Coordinator progress
+    const coord = session ? buildCoordinatorSegment(session) : '';
+    // Teammate activity (team-lite Wave 3B)
+    const team = session ? buildTeamSegment(session) : '';
+    // Assemble segments
+    const parts = [`${ANSI_DIM}${model}${ANSI_RESET}`];
+    if (phase)
+        parts.push(`${ANSI_CYAN}${phase}${ANSI_RESET}`);
+    if (coord)
+        parts.push(`${ANSI_CYAN}${coord}${ANSI_RESET}`);
+    if (task)
+        parts.push(`${ANSI_BOLD}${task}${ANSI_RESET}`);
+    if (team)
+        parts.push(`${ANSI_DIM}${team}${ANSI_RESET}`);
+    parts.push(`${ANSI_DIM}${basename(dir)}${ANSI_RESET}`);
+    return parts.join(' | ') + ctx;
+}
+/** Entry point — reads stdin JSON, writes formatted statusline to stdout */
+export function runStatusline() {
+    let input = '';
+    const timeout = setTimeout(() => process.exit(0), 3000);
+    process.stdin.setEncoding('utf8');
+    process.stdin.on('data', (chunk) => (input += chunk));
+    process.stdin.on('end', () => {
+        clearTimeout(timeout);
+        try {
+            const data = JSON.parse(input);
+            process.stdout.write(formatStatusline(data));
+        }
+        catch {
+            // Silent fail
+        }
+    });
+}
+//# sourceMappingURL=statusline.js.map

package/dist/src/hooks/statusline.js.map

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

package/dist/src/hooks/team-monitor.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Maestro Team Monitor — PostToolUse Hook (team-lite Wave 2b).
+ *
+ * Silent heartbeat: every PostToolUse event appends a line to the shared
+ * `.workflow/collab/activity.jsonl` so teammates can see who is active
+ * on which phase/task.
+ *
+ * Design constraints (docs/team-lite-design.md section "耦合 1"):
+ *   - Team mode off (no member record) -> silent exit 0.
+ *   - `user` / `host` come from `members/{uid}.json` via `resolveSelf()`.
+ *   - `phase_id` / `task_id` come from `.workflow/state.json` via
+ *     `readWorkflowContext()`.
+ *   - `action` comes from the hook payload's `tool_name`.
+ *   - Dedupe: same `(user, action, phase_id)` within 60s -> skip.
+ *     This defends against sub-agent Wave amplification.
+ *   - Never throw: this hook must never block the host tool call.
+ *   - No hook stdout output (unlike context-monitor / delegate-monitor,
+ *     which inject `additionalContext`). The heartbeat is side-effect only.
+ */
+interface HookInput {
+    session_id?: string;
+    cwd?: string;
+    tool_name?: string;
+    tool_input?: Record<string, unknown>;
+}
+/**
+ * Pure hook logic — takes parsed hook input, reports activity if
+ * team mode is enabled. Never throws.
+ */
+export declare function runTeamMonitor(input: HookInput): void;
+/** Entry point — reads stdin JSON with 3s timeout, runs monitor, exits 0. */
+export declare function runTeamMonitorFromStdin(): void;
+export {};
+//# sourceMappingURL=team-monitor.d.ts.map

package/dist/src/hooks/team-monitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"team-monitor.d.ts","sourceRoot":"","sources":["../../../src/hooks/team-monitor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AASH,UAAU,SAAS;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AA0DD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAyBrD;AAED,6EAA6E;AAC7E,wBAAgB,uBAAuB,IAAI,IAAI,CAgB9C"}

package/dist/src/hooks/team-monitor.js

@@ -0,0 +1,116 @@
+/**
+ * Maestro Team Monitor — PostToolUse Hook (team-lite Wave 2b).
+ *
+ * Silent heartbeat: every PostToolUse event appends a line to the shared
+ * `.workflow/collab/activity.jsonl` so teammates can see who is active
+ * on which phase/task.
+ *
+ * Design constraints (docs/team-lite-design.md section "耦合 1"):
+ *   - Team mode off (no member record) -> silent exit 0.
+ *   - `user` / `host` come from `members/{uid}.json` via `resolveSelf()`.
+ *   - `phase_id` / `task_id` come from `.workflow/state.json` via
+ *     `readWorkflowContext()`.
+ *   - `action` comes from the hook payload's `tool_name`.
+ *   - Dedupe: same `(user, action, phase_id)` within 60s -> skip.
+ *     This defends against sub-agent Wave amplification.
+ *   - Never throw: this hook must never block the host tool call.
+ *   - No hook stdout output (unlike context-monitor / delegate-monitor,
+ *     which inject `additionalContext`). The heartbeat is side-effect only.
+ */
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { tmpdir } from 'node:os';
+import { resolveSelf } from '../tools/team-members.js';
+import { reportActivity, readWorkflowContext } from '../tools/team-activity.js';
+// 60 seconds — matches design doc "耦合 1" dedupe window.
+const DEDUPE_WINDOW_MS = 60_000;
+const DEDUPE_PREFIX = 'maestro-team-dedupe-';
+function getDedupePath(sessionId) {
+    return join(tmpdir(), `${DEDUPE_PREFIX}${sessionId}.json`);
+}
+/**
+ * Returns true if the (sessionId, key) combo was reported within the
+ * dedupe window and should be suppressed. Updates the state file on
+ * every call so the next check has a fresh baseline.
+ *
+ * If `sessionId` is missing we cannot persist per-session state, so we
+ * return `false` (never suppress) — better to log an extra heartbeat
+ * than to lose them all.
+ */
+function shouldSkipDuplicate(sessionId, key) {
+    if (!sessionId)
+        return false;
+    const path = getDedupePath(sessionId);
+    const now = Date.now();
+    if (existsSync(path)) {
+        try {
+            const raw = readFileSync(path, 'utf-8');
+            const prev = JSON.parse(raw);
+            if (prev &&
+                typeof prev.key === 'string' &&
+                typeof prev.ts === 'number' &&
+                prev.key === key &&
+                now - prev.ts < DEDUPE_WINDOW_MS) {
+                return true;
+            }
+        }
+        catch {
+            // Corrupted — fall through and overwrite.
+        }
+    }
+    try {
+        const next = { key, ts: now };
+        writeFileSync(path, JSON.stringify(next), 'utf-8');
+    }
+    catch {
+        // Best-effort: if we cannot persist, we still report the event.
+    }
+    return false;
+}
+/**
+ * Pure hook logic — takes parsed hook input, reports activity if
+ * team mode is enabled. Never throws.
+ */
+export function runTeamMonitor(input) {
+    try {
+        const self = resolveSelf();
+        if (!self)
+            return; // Team mode not enabled — silent exit.
+        const action = typeof input.tool_name === 'string' && input.tool_name.length > 0
+            ? input.tool_name
+            : 'unknown';
+        const ctx = readWorkflowContext();
+        const dedupeKey = `${self.uid}|${action}|${ctx.phase_id ?? ''}`;
+        if (shouldSkipDuplicate(input.session_id, dedupeKey))
+            return;
+        reportActivity({
+            user: self.uid,
+            host: self.host,
+            action,
+            ...(ctx.phase_id !== undefined ? { phase_id: ctx.phase_id } : {}),
+            ...(ctx.task_id !== undefined ? { task_id: ctx.task_id } : {}),
+        });
+    }
+    catch {
+        // Never block the host tool call.
+    }
+}
+/** Entry point — reads stdin JSON with 3s timeout, runs monitor, exits 0. */
+export function runTeamMonitorFromStdin() {
+    let input = '';
+    const timeout = setTimeout(() => process.exit(0), 3000);
+    process.stdin.setEncoding('utf8');
+    process.stdin.on('data', (chunk) => (input += chunk));
+    process.stdin.on('end', () => {
+        clearTimeout(timeout);
+        try {
+            const data = input ? JSON.parse(input) : {};
+            runTeamMonitor(data);
+        }
+        catch {
+            // Silent fail — never block tool execution.
+        }
+        process.exit(0);
+    });
+}
+//# sourceMappingURL=team-monitor.js.map

package/dist/src/hooks/team-monitor.js.map

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

package/dist/src/hooks/workflow-hooks.d.ts

@@ -0,0 +1,58 @@
+import { SyncHook, AsyncSeriesHook, AsyncSeriesBailHook, AsyncSeriesWaterfallHook } from './hook-engine.js';
+import type { MaestroPlugin } from '../types/index.js';
+import type { CommandNode, ExecuteResult, WalkerState } from '../coordinator/graph-types.js';
+export interface RunContext {
+    sessionId: string;
+    graphId: string;
+    intent: string;
+}
+export interface NodeContext {
+    nodeId: string;
+    node: CommandNode;
+    state: WalkerState;
+}
+export interface CommandContext {
+    nodeId: string;
+    cmd: string;
+    prompt: string;
+}
+export interface CommandResultContext {
+    nodeId: string;
+    cmd: string;
+    result: ExecuteResult;
+}
+export interface ErrorContext {
+    nodeId: string | null;
+    error: Error;
+    state: WalkerState;
+}
+export interface DecisionContext {
+    nodeId: string;
+    resolvedValue: unknown;
+    target: string;
+}
+export declare class WorkflowHookRegistry {
+    /** Fires before a workflow run starts. Bail to cancel. */
+    readonly beforeRun: AsyncSeriesBailHook<[RunContext]>;
+    /** Fires after a workflow run completes. */
+    readonly afterRun: AsyncSeriesHook<[RunContext, WalkerState]>;
+    /** Fires before entering a node. Bail to skip. */
+    readonly beforeNode: AsyncSeriesBailHook<[NodeContext]>;
+    /** Fires after exiting a node. */
+    readonly afterNode: AsyncSeriesHook<[NodeContext, string]>;
+    /** Fires before executing a command. Bail to skip execution. */
+    readonly beforeCommand: AsyncSeriesBailHook<[CommandContext]>;
+    /** Fires after a command completes. */
+    readonly afterCommand: AsyncSeriesHook<[CommandResultContext]>;
+    /** Fires when an error occurs during execution. */
+    readonly onError: AsyncSeriesHook<[ErrorContext]>;
+    /** Transforms the assembled prompt before sending to agent. */
+    readonly transformPrompt: AsyncSeriesWaterfallHook<string>;
+    /** Fires synchronously when a decision node resolves. */
+    readonly onDecision: SyncHook<[DecisionContext]>;
+    /** Apply a plugin — plugin taps into hooks via the registry. */
+    apply(plugin: MaestroPlugin): void;
+    /** Get a hook by name (for dynamic access). */
+    getHook(name: string): unknown;
+}
+//# sourceMappingURL=workflow-hooks.d.ts.map

package/dist/src/hooks/workflow-hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-hooks.d.ts","sourceRoot":"","sources":["../../../src/hooks/workflow-hooks.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,QAAQ,EACR,eAAe,EACf,mBAAmB,EACnB,wBAAwB,EACzB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EACV,WAAW,EACX,aAAa,EACb,WAAW,EACZ,MAAM,+BAA+B,CAAC;AAMvC,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,WAAW,CAAC;IAClB,KAAK,EAAE,WAAW,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,aAAa,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,EAAE,WAAW,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,OAAO,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;CAChB;AAMD,qBAAa,oBAAoB;IAC/B,0DAA0D;IAC1D,QAAQ,CAAC,SAAS,oCAA2C;IAE7D,4CAA4C;IAC5C,QAAQ,CAAC,QAAQ,6CAAoD;IAErE,kDAAkD;IAClD,QAAQ,CAAC,UAAU,qCAA4C;IAE/D,kCAAkC;IAClC,QAAQ,CAAC,SAAS,yCAAgD;IAElE,gEAAgE;IAChE,QAAQ,CAAC,aAAa,wCAA+C;IAErE,uCAAuC;IACvC,QAAQ,CAAC,YAAY,0CAAiD;IAEtE,mDAAmD;IACnD,QAAQ,CAAC,OAAO,kCAAyC;IAEzD,+DAA+D;IAC/D,QAAQ,CAAC,eAAe,mCAA0C;IAElE,yDAAyD;IACzD,QAAQ,CAAC,UAAU,8BAAqC;IAExD,gEAAgE;IAChE,KAAK,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI;IAIlC,+CAA+C;IAC/C,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;CAc/B"}

package/dist/src/hooks/workflow-hooks.js

@@ -0,0 +1,47 @@
+// ---------------------------------------------------------------------------
+// WorkflowHookRegistry — Central registry of 9 workflow hooks
+// ---------------------------------------------------------------------------
+import { SyncHook, AsyncSeriesHook, AsyncSeriesBailHook, AsyncSeriesWaterfallHook, } from './hook-engine.js';
+// ---------------------------------------------------------------------------
+// WorkflowHookRegistry
+// ---------------------------------------------------------------------------
+export class WorkflowHookRegistry {
+    /** Fires before a workflow run starts. Bail to cancel. */
+    beforeRun = new AsyncSeriesBailHook();
+    /** Fires after a workflow run completes. */
+    afterRun = new AsyncSeriesHook();
+    /** Fires before entering a node. Bail to skip. */
+    beforeNode = new AsyncSeriesBailHook();
+    /** Fires after exiting a node. */
+    afterNode = new AsyncSeriesHook();
+    /** Fires before executing a command. Bail to skip execution. */
+    beforeCommand = new AsyncSeriesBailHook();
+    /** Fires after a command completes. */
+    afterCommand = new AsyncSeriesHook();
+    /** Fires when an error occurs during execution. */
+    onError = new AsyncSeriesHook();
+    /** Transforms the assembled prompt before sending to agent. */
+    transformPrompt = new AsyncSeriesWaterfallHook();
+    /** Fires synchronously when a decision node resolves. */
+    onDecision = new SyncHook();
+    /** Apply a plugin — plugin taps into hooks via the registry. */
+    apply(plugin) {
+        plugin.apply(this);
+    }
+    /** Get a hook by name (for dynamic access). */
+    getHook(name) {
+        const hooks = {
+            beforeRun: this.beforeRun,
+            afterRun: this.afterRun,
+            beforeNode: this.beforeNode,
+            afterNode: this.afterNode,
+            beforeCommand: this.beforeCommand,
+            afterCommand: this.afterCommand,
+            onError: this.onError,
+            transformPrompt: this.transformPrompt,
+            onDecision: this.onDecision,
+        };
+        return hooks[name];
+    }
+}
+//# sourceMappingURL=workflow-hooks.js.map

package/dist/src/hooks/workflow-hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-hooks.js","sourceRoot":"","sources":["../../../src/hooks/workflow-hooks.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,8DAA8D;AAC9D,8EAA8E;AAE9E,OAAO,EACL,QAAQ,EACR,eAAe,EACf,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,kBAAkB,CAAC;AAiD1B,8EAA8E;AAC9E,uBAAuB;AACvB,8EAA8E;AAE9E,MAAM,OAAO,oBAAoB;IAC/B,0DAA0D;IACjD,SAAS,GAAG,IAAI,mBAAmB,EAAgB,CAAC;IAE7D,4CAA4C;IACnC,QAAQ,GAAG,IAAI,eAAe,EAA6B,CAAC;IAErE,kDAAkD;IACzC,UAAU,GAAG,IAAI,mBAAmB,EAAiB,CAAC;IAE/D,kCAAkC;IACzB,SAAS,GAAG,IAAI,eAAe,EAAyB,CAAC;IAElE,gEAAgE;IACvD,aAAa,GAAG,IAAI,mBAAmB,EAAoB,CAAC;IAErE,uCAAuC;IAC9B,YAAY,GAAG,IAAI,eAAe,EAA0B,CAAC;IAEtE,mDAAmD;IAC1C,OAAO,GAAG,IAAI,eAAe,EAAkB,CAAC;IAEzD,+DAA+D;IACtD,eAAe,GAAG,IAAI,wBAAwB,EAAU,CAAC;IAElE,yDAAyD;IAChD,UAAU,GAAG,IAAI,QAAQ,EAAqB,CAAC;IAExD,gEAAgE;IAChE,KAAK,CAAC,MAAqB;QACzB,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACrB,CAAC;IAED,+CAA+C;IAC/C,OAAO,CAAC,IAAY;QAClB,MAAM,KAAK,GAA4B;YACrC,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,YAAY,EAAE,IAAI,CAAC,YAAY;YAC/B,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,eAAe,EAAE,IAAI,CAAC,eAAe;YACrC,UAAU,EAAE,IAAI,CAAC,UAAU;SAC5B,CAAC;QACF,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC;IACrB,CAAC;CACF"}

package/dist/src/hooks/workspace.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Workspace Resolver — Finds the project root containing `.workflow/`
+ *
+ * Walks up from the given directory to find the nearest ancestor
+ * containing a `.workflow` directory. Similar to how git finds `.git/`.
+ *
+ * Used by all workflow-aware hooks to resolve artifact paths correctly
+ * regardless of the working directory Claude Code reports.
+ */
+/**
+ * Check if a `.workflow/` directory is a Maestro workspace by verifying
+ * `state.json` contains Maestro-specific fields (`version` + `phases_summary`).
+ * This prevents false positives from other tools that use `.workflow/`.
+ */
+export declare function isMaestroWorkspace(dir: string): boolean;
+/**
+ * Find the nearest ancestor directory containing a valid Maestro `.workflow/`.
+ * Returns null if no workspace is found (walks up to filesystem root).
+ *
+ * Prefers a directory that also contains `.git/` (project root heuristic).
+ * Walks up at most 10 levels.
+ */
+export declare function findWorkspaceRoot(startDir: string): string | null;
+/**
+ * Resolve the workspace root from hook input data.
+ * Tries data.cwd first, falls back to process.cwd().
+ * Returns null if no workspace found.
+ */
+export declare function resolveWorkspace(data: {
+    cwd?: string;
+}): string | null;
+//# sourceMappingURL=workspace.d.ts.map

package/dist/src/hooks/workspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace.d.ts","sourceRoot":"","sources":["../../../src/hooks/workspace.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CASvD;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAiBjE;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,GAAG,IAAI,CAGtE"}