maestro-flow 0.1.4 → 0.2.0

package/dist/src/hooks/coordinator-tracker.js

@@ -0,0 +1,331 @@
+/**
+ * Coordinator Tracker — Unified progress tracking for maestro coordinators
+ *
+ * Tracks session state across three coordinator types:
+ *   A) maestro & maestro-coordinate — reads .workflow/.maestro/status.json
+ *   B) maestro-link-coordinate — captures coord session_id from Bash output,
+ *      reads .workflow/.maestro-coordinate/walker-state.json
+ *
+ * Bridge file: {tmpdir}/maestro-coord-{cc_session_id}.json
+ */
+import { readFileSync, readdirSync, statSync, writeFileSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { tmpdir } from 'node:os';
+import { homedir } from 'node:os';
+import { COORD_BRIDGE_PREFIX } from './constants.js';
+/**
+ * Scan .workflow/.maestro/ for the most recently modified status.json.
+ * Returns parsed bridge data or null if none found.
+ */
+export function readMaestroSession(workspaceRoot) {
+    const maestroDir = join(workspaceRoot, '.workflow', '.maestro');
+    if (!existsSync(maestroDir))
+        return null;
+    try {
+        const sessions = readdirSync(maestroDir)
+            .map(name => {
+            const statusPath = join(maestroDir, name, 'status.json');
+            if (!existsSync(statusPath))
+                return null;
+            try {
+                return { name, mtime: statSync(statusPath).mtimeMs, path: statusPath };
+            }
+            catch {
+                return null;
+            }
+        })
+            .filter((s) => s !== null)
+            .sort((a, b) => b.mtime - a.mtime);
+        if (sessions.length === 0)
+            return null;
+        const raw = JSON.parse(readFileSync(sessions[0].path, 'utf8'));
+        return parseMaestroStatus(raw, sessions[0].mtime, sessions[0].name);
+    }
+    catch {
+        return null;
+    }
+}
+function parseMaestroStatus(raw, mtime, dirName) {
+    const steps = raw.steps ?? [];
+    const currentIdx = raw.current_step ?? 0;
+    const completed = steps.filter(s => s.status === 'completed').length;
+    const currentStep = steps[currentIdx]
+        ? { index: currentIdx, skill: steps[currentIdx].skill ?? '', args: steps[currentIdx].args ?? '' }
+        : null;
+    const nextIdx = currentIdx + 1;
+    const nextStep = steps[nextIdx]
+        ? { index: nextIdx, skill: steps[nextIdx].skill ?? '', args: steps[nextIdx].args ?? '' }
+        : null;
+    const remaining = steps.slice(nextIdx).map(s => ({
+        skill: s.skill ?? '',
+        args: s.args ?? '',
+    }));
+    return {
+        session_id: '',
+        maestro_session_id: raw.session_id ?? dirName ?? undefined,
+        coordinator: 'maestro',
+        chain_name: raw.chain_name ?? '',
+        intent: raw.intent ?? '',
+        phase: raw.phase ?? null,
+        steps_total: steps.length,
+        steps_completed: completed,
+        current_step: currentStep,
+        next_step: nextStep,
+        remaining_steps: remaining,
+        status: raw.status ?? 'unknown',
+        updated_at: Math.floor(mtime),
+    };
+}
+// ---------------------------------------------------------------------------
+// B: Parse coordinate CLI output (maestro-link-coordinate)
+// ---------------------------------------------------------------------------
+/**
+ * Parse Bash tool output for coordinate session JSON.
+ * Looks for JSON containing "session_id":"coord-..." pattern.
+ * Returns parsed output or null if not coordinate output.
+ */
+export function parseCoordinateOutput(toolOutput) {
+    if (!toolOutput || !toolOutput.includes('"session_id"'))
+        return null;
+    // Find JSON object in output (may be preceded by stderr lines)
+    const jsonStart = toolOutput.indexOf('{');
+    if (jsonStart < 0)
+        return null;
+    try {
+        const parsed = JSON.parse(toolOutput.slice(jsonStart));
+        if (typeof parsed.session_id !== 'string' || !parsed.session_id.startsWith('coord-')) {
+            return null;
+        }
+        return {
+            session_id: parsed.session_id,
+            status: parsed.status ?? 'unknown',
+            graph_id: parsed.graph_id ?? '',
+            current_node: parsed.current_node ?? '',
+            steps_completed: parsed.steps_completed ?? 0,
+            steps_failed: parsed.steps_failed ?? 0,
+            history: Array.isArray(parsed.history) ? parsed.history : [],
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Read walker-state.json for a specific coordinate session.
+ * Resolves next node from the chain graph.
+ */
+export function readWalkerState(workspaceRoot, coordSessionId) {
+    const coordDir = join(workspaceRoot, '.workflow', '.maestro-coordinate');
+    const statePath = join(coordDir, coordSessionId, 'walker-state.json');
+    if (!existsSync(statePath))
+        return null;
+    try {
+        const raw = JSON.parse(readFileSync(statePath, 'utf8'));
+        const history = Array.isArray(raw.history) ? raw.history : [];
+        const commandNodes = history.filter(h => h.node_type === 'command');
+        const completed = commandNodes.filter(h => h.outcome === 'success').length;
+        // Count total command nodes in graph to estimate steps_total
+        const graphId = raw.graph_id ?? '';
+        const currentNode = raw.current_node ?? '';
+        // Resolve next step from chain graph
+        const nextNode = resolveNextNode(workspaceRoot, graphId, currentNode);
+        return {
+            session_id: '',
+            coord_session_id: coordSessionId,
+            coordinator: 'maestro-link-coordinate',
+            chain_name: graphId,
+            intent: raw.intent ?? '',
+            phase: raw.context?.project?.current_phase ?? null,
+            steps_total: countGraphCommands(workspaceRoot, graphId),
+            steps_completed: completed,
+            current_step: currentNode ? { index: completed, skill: currentNode, args: '' } : null,
+            next_step: nextNode ? { index: completed + 1, skill: nextNode.skill, args: nextNode.args } : null,
+            remaining_steps: nextNode ? [{ skill: nextNode.skill, args: nextNode.args }] : [],
+            status: raw.status ?? 'unknown',
+            updated_at: Math.floor(statSync(statePath).mtimeMs),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+// ---------------------------------------------------------------------------
+// Chain graph resolution
+// ---------------------------------------------------------------------------
+/**
+ * Resolve the next command node from a chain graph JSON file.
+ * Follows `node.next` edges, skipping decision/gate/eval nodes.
+ */
+export function resolveNextNode(workspaceRoot, graphId, currentNode) {
+    const graph = loadChainGraph(workspaceRoot, graphId);
+    if (!graph)
+        return null;
+    const node = graph.nodes?.[currentNode];
+    if (!node)
+        return null;
+    // Follow next edge, skip non-command nodes
+    let nextId = node.next;
+    for (let i = 0; i < 10 && nextId; i++) {
+        const next = graph.nodes?.[nextId];
+        if (!next)
+            break;
+        if (next.type === 'command') {
+            return { skill: next.cmd ?? nextId, args: next.args ?? '' };
+        }
+        // Decision/gate/eval/terminal — try following default edge
+        if (next.type === 'decision' && Array.isArray(next.edges)) {
+            const defaultEdge = next.edges.find((e) => e.default);
+            nextId = defaultEdge?.target ?? next.edges[0]?.target;
+        }
+        else if (next.type === 'terminal') {
+            break;
+        }
+        else {
+            nextId = next.next;
+        }
+    }
+    return null;
+}
+/** Count total command nodes in a chain graph. */
+function countGraphCommands(workspaceRoot, graphId) {
+    const graph = loadChainGraph(workspaceRoot, graphId);
+    if (!graph?.nodes)
+        return 0;
+    return Object.values(graph.nodes).filter(n => n.type === 'command').length;
+}
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+function loadChainGraph(workspaceRoot, graphId) {
+    if (!graphId)
+        return null;
+    // Try local chains/ first, then global ~/.maestro/chains/
+    const localPath = join(workspaceRoot, 'chains', `${graphId}.json`);
+    const globalPath = join(homedir(), '.maestro', 'chains', `${graphId}.json`);
+    for (const p of [localPath, globalPath]) {
+        if (existsSync(p)) {
+            try {
+                return JSON.parse(readFileSync(p, 'utf8'));
+            }
+            catch { /* skip */ }
+        }
+    }
+    // Try singles/ subdirectory
+    const localSingles = join(workspaceRoot, 'chains', 'singles', `${graphId}.json`);
+    const globalSingles = join(homedir(), '.maestro', 'chains', 'singles', `${graphId}.json`);
+    for (const p of [localSingles, globalSingles]) {
+        if (existsSync(p)) {
+            try {
+                return JSON.parse(readFileSync(p, 'utf8'));
+            }
+            catch { /* skip */ }
+        }
+    }
+    return null;
+}
+// ---------------------------------------------------------------------------
+// Bridge file I/O
+// ---------------------------------------------------------------------------
+function bridgePath(sessionId) {
+    return join(tmpdir(), `${COORD_BRIDGE_PREFIX}${sessionId}.json`);
+}
+/** Write bridge file to tmpdir. */
+export function writeCoordBridge(sessionId, data) {
+    try {
+        writeFileSync(bridgePath(sessionId), JSON.stringify(data));
+    }
+    catch {
+        // Best-effort — bridge write must not break hook
+    }
+}
+/** Read bridge file from tmpdir. Returns null if missing/corrupt. */
+export function readCoordBridge(sessionId) {
+    const p = bridgePath(sessionId);
+    if (!existsSync(p))
+        return null;
+    try {
+        return JSON.parse(readFileSync(p, 'utf8'));
+    }
+    catch {
+        return null;
+    }
+}
+// ---------------------------------------------------------------------------
+// Latest session resolver
+// ---------------------------------------------------------------------------
+/**
+ * Pick the most recently updated session across maestro and coordinate types.
+ * Compares file mtime to determine which is newest.
+ */
+export function readLatestSession(workspaceRoot, existingBridge) {
+    const maestro = readMaestroSession(workspaceRoot);
+    const coord = readLatestCoordinateSession(workspaceRoot);
+    const candidates = [maestro, coord, existingBridge ?? null].filter((c) => c !== null);
+    if (candidates.length === 0)
+        return null;
+    return candidates.sort((a, b) => b.updated_at - a.updated_at)[0];
+}
+/** Find the latest walker-state.json across all coordinate sessions. */
+function readLatestCoordinateSession(workspaceRoot) {
+    const coordDir = join(workspaceRoot, '.workflow', '.maestro-coordinate');
+    if (!existsSync(coordDir))
+        return null;
+    try {
+        const sessions = readdirSync(coordDir)
+            .filter(name => name.startsWith('coord-'))
+            .map(name => {
+            const statePath = join(coordDir, name, 'walker-state.json');
+            if (!existsSync(statePath))
+                return null;
+            try {
+                return { name, mtime: statSync(statePath).mtimeMs };
+            }
+            catch {
+                return null;
+            }
+        })
+            .filter((s) => s !== null)
+            .sort((a, b) => b.mtime - a.mtime);
+        if (sessions.length === 0)
+            return null;
+        return readWalkerState(workspaceRoot, sessions[0].name);
+    }
+    catch {
+        return null;
+    }
+}
+// ---------------------------------------------------------------------------
+// Next-step hint builder
+// ---------------------------------------------------------------------------
+/**
+ * Build a "next step" hint string for additionalContext injection.
+ * Returns null if session is completed/failed or has no next step.
+ */
+export function buildNextStepHint(data) {
+    const isPaused = data.status === 'paused' || data.status === 'step_paused';
+    if (!isPaused && data.status !== 'running')
+        return null;
+    if (!data.next_step)
+        return null;
+    const progress = `[${data.steps_completed}/${data.steps_total}]`;
+    const lastSkill = data.current_step?.skill ?? '(unknown)';
+    const nextSkill = data.next_step.skill;
+    const nextArgs = data.next_step.args ? ` ${data.next_step.args}` : '';
+    const lines = [
+        `## Coordinator Session Active`,
+        `Chain: ${data.chain_name} ${progress} | Status: ${data.status}`,
+        `Last: ${lastSkill}`,
+        `Next: ${nextSkill}${nextArgs}`,
+    ];
+    if (data.remaining_steps.length > 1) {
+        const remaining = data.remaining_steps.slice(1, 4).map(s => s.skill).join(' → ');
+        lines.push(`Then: ${remaining}${data.remaining_steps.length > 4 ? ' …' : ''}`);
+    }
+    // Resume hint
+    if (data.coord_session_id) {
+        lines.push(`Resume: /maestro-link-coordinate -c ${data.coord_session_id}`);
+    }
+    else {
+        lines.push(`Resume: /maestro -c`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=coordinator-tracker.js.map

package/dist/src/hooks/coordinator-tracker.js.map

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

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

@@ -0,0 +1,24 @@
+/**
+ * Maestro Delegate Monitor — PostToolUse Hook (fallback)
+ *
+ * Checks /tmp/maestro-notify-{session_id}.jsonl for unread delegate
+ * completion notifications. When found, injects additionalContext to inform
+ * the model that a delegated task has finished.
+ *
+ * Primary path: MCP channel notification (notifications/claude/channel).
+ * This hook is the fallback when channel is not available.
+ */
+interface MonitorInput {
+    session_id?: string;
+    cwd?: string;
+}
+interface HookOutput {
+    hookSpecificOutput: {
+        hookEventName: string;
+        additionalContext: string;
+    };
+}
+export declare function evaluateDelegateNotifications(data: MonitorInput): HookOutput | null;
+export declare function runDelegateMonitor(): void;
+export {};
+//# sourceMappingURL=delegate-monitor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"delegate-monitor.d.ts","sourceRoot":"","sources":["../../../src/hooks/delegate-monitor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAOH,UAAU,YAAY;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAYD,UAAU,UAAU;IAClB,kBAAkB,EAAE;QAClB,aAAa,EAAE,MAAM,CAAC;QACtB,iBAAiB,EAAE,MAAM,CAAC;KAC3B,CAAC;CACH;AAkBD,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,YAAY,GAAG,UAAU,GAAG,IAAI,CAsBnF;AAED,wBAAgB,kBAAkB,IAAI,IAAI,CAkBzC"}

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

@@ -0,0 +1,76 @@
+/**
+ * Maestro Delegate Monitor — PostToolUse Hook (fallback)
+ *
+ * Checks /tmp/maestro-notify-{session_id}.jsonl for unread delegate
+ * completion notifications. When found, injects additionalContext to inform
+ * the model that a delegated task has finished.
+ *
+ * Primary path: MCP channel notification (notifications/claude/channel).
+ * This hook is the fallback when channel is not available.
+ */
+import { readFileSync, existsSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { tmpdir } from 'node:os';
+import { NOTIFY_PREFIX } from './constants.js';
+function readNotifications(sessionId) {
+    const path = join(tmpdir(), `${NOTIFY_PREFIX}${sessionId}.jsonl`);
+    if (!existsSync(path))
+        return [];
+    const content = readFileSync(path, 'utf-8').trim();
+    if (!content)
+        return [];
+    return content.split('\n')
+        .map(line => { try {
+        return JSON.parse(line);
+    }
+    catch {
+        return null;
+    } })
+        .filter((e) => e !== null);
+}
+function markRead(sessionId, entries) {
+    const path = join(tmpdir(), `${NOTIFY_PREFIX}${sessionId}.jsonl`);
+    const marked = entries.map(e => ({ ...e, read: true }));
+    writeFileSync(path, marked.map(e => JSON.stringify(e)).join('\n') + '\n', 'utf-8');
+}
+export function evaluateDelegateNotifications(data) {
+    const sessionId = data.session_id;
+    if (!sessionId)
+        return null;
+    const entries = readNotifications(sessionId);
+    const unread = entries.filter(e => !e.read);
+    if (unread.length === 0)
+        return null;
+    markRead(sessionId, entries);
+    const lines = unread.map(e => {
+        const status = e.exitCode === 0 ? 'done' : `exit:${e.exitCode}`;
+        const preview = e.prompt.length > 80 ? e.prompt.slice(0, 77) + '...' : e.prompt;
+        return `[DELEGATE ${status}] ${e.execId} (${e.tool}/${e.mode})\n  Prompt: "${preview}"\n  Use \`maestro delegate output ${e.execId}\` for full result.`;
+    });
+    return {
+        hookSpecificOutput: {
+            hookEventName: 'PostToolUse',
+            additionalContext: lines.join('\n'),
+        },
+    };
+}
+export function runDelegateMonitor() {
+    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);
+            const result = evaluateDelegateNotifications(data);
+            if (result) {
+                process.stdout.write(JSON.stringify(result));
+            }
+        }
+        catch {
+            process.exit(0);
+        }
+    });
+}
+//# sourceMappingURL=delegate-monitor.js.map

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

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

package/dist/src/hooks/guards/index.d.ts

@@ -0,0 +1,3 @@
+export { WorkflowGuard } from './workflow-guard.js';
+export { PromptGuard } from './prompt-guard.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/hooks/guards/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/hooks/guards/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/src/hooks/guards/index.js

@@ -0,0 +1,3 @@
+export { WorkflowGuard } from './workflow-guard.js';
+export { PromptGuard } from './prompt-guard.js';
+//# sourceMappingURL=index.js.map

package/dist/src/hooks/guards/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/hooks/guards/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/src/hooks/guards/prompt-guard.d.ts

@@ -0,0 +1,18 @@
+import type { MaestroPlugin } from '../../types/index.js';
+import type { WorkflowHookRegistry } from '../workflow-hooks.js';
+export interface PromptGuardResult {
+    flagged: boolean;
+    labels: string[];
+    warning?: string;
+}
+/**
+ * Pure evaluation function — portable, no I/O dependencies.
+ * @param prompt The user prompt text to scan
+ */
+export declare function evaluatePromptGuard(prompt: string): PromptGuardResult;
+/** In-process plugin for coordinator graph-walker */
+export declare class PromptGuard implements MaestroPlugin {
+    readonly name = "promptGuard";
+    apply(registry: WorkflowHookRegistry): void;
+}
+//# sourceMappingURL=prompt-guard.d.ts.map

package/dist/src/hooks/guards/prompt-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-guard.d.ts","sourceRoot":"","sources":["../../../../src/hooks/guards/prompt-guard.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAkBjE,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,iBAAiB,CAerE;AAED,qDAAqD;AACrD,qBAAa,WAAY,YAAW,aAAa;IAC/C,QAAQ,CAAC,IAAI,iBAAiB;IAE9B,KAAK,CAAC,QAAQ,EAAE,oBAAoB,GAAG,IAAI;CAS5C"}

package/dist/src/hooks/guards/prompt-guard.js

@@ -0,0 +1,52 @@
+// ---------------------------------------------------------------------------
+// PromptGuard — Detects prompt injection patterns
+// ---------------------------------------------------------------------------
+const INJECTION_PATTERNS = [
+    { pattern: /ignore\s+(all\s+)?previous\s+instructions/i, label: 'instruction-override' },
+    { pattern: /you\s+are\s+now\s+/i, label: 'role-confusion' },
+    { pattern: /^system:/mi, label: 'system-prompt-injection' },
+    { pattern: /forget\s+(everything|all|your)\s/i, label: 'memory-wipe' },
+    { pattern: /pretend\s+(you\s+are|to\s+be)/i, label: 'role-impersonation' },
+    { pattern: /do\s+not\s+follow\s+(any|your)\s/i, label: 'instruction-bypass' },
+    { pattern: /override\s+(your|the)\s+(instructions|rules|guidelines)/i, label: 'rule-override' },
+    { pattern: /\bbase64\s*[:=]\s*[A-Za-z0-9+/]{20,}/i, label: 'encoded-command' },
+    { pattern: /\]\s*\(\s*data:/i, label: 'data-uri-injection' },
+    { pattern: /new\s+instructions?\s*:/i, label: 'new-instruction' },
+    { pattern: /disregard\s+(the\s+)?(above|previous)/i, label: 'disregard' },
+    { pattern: /act\s+as\s+(if|though)\s+you/i, label: 'behavior-override' },
+    { pattern: /translate\s+.*\bto\s+(shell|bash|python|javascript)\b/i, label: 'code-execution-via-translate' },
+];
+/**
+ * Pure evaluation function — portable, no I/O dependencies.
+ * @param prompt The user prompt text to scan
+ */
+export function evaluatePromptGuard(prompt) {
+    const detected = [];
+    for (const { pattern, label } of INJECTION_PATTERNS) {
+        if (pattern.test(prompt)) {
+            detected.push(label);
+        }
+    }
+    if (detected.length > 0) {
+        return {
+            flagged: true,
+            labels: detected,
+            warning: `[PromptGuard] WARNING: Potential prompt injection detected (${detected.join(', ')}). Proceeding with caution.`,
+        };
+    }
+    return { flagged: false, labels: [] };
+}
+/** In-process plugin for coordinator graph-walker */
+export class PromptGuard {
+    name = 'promptGuard';
+    apply(registry) {
+        registry.transformPrompt.tap(this.name, (promptText) => {
+            const result = evaluatePromptGuard(promptText);
+            if (result.flagged) {
+                return `\n${result.warning}\n` + promptText;
+            }
+            return promptText;
+        });
+    }
+}
+//# sourceMappingURL=prompt-guard.js.map

package/dist/src/hooks/guards/prompt-guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-guard.js","sourceRoot":"","sources":["../../../../src/hooks/guards/prompt-guard.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,kDAAkD;AAClD,8EAA8E;AAK9E,MAAM,kBAAkB,GAA8C;IACpE,EAAE,OAAO,EAAE,4CAA4C,EAAE,KAAK,EAAE,sBAAsB,EAAE;IACxF,EAAE,OAAO,EAAE,qBAAqB,EAAE,KAAK,EAAE,gBAAgB,EAAE;IAC3D,EAAE,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,yBAAyB,EAAE;IAC3D,EAAE,OAAO,EAAE,mCAAmC,EAAE,KAAK,EAAE,aAAa,EAAE;IACtE,EAAE,OAAO,EAAE,gCAAgC,EAAE,KAAK,EAAE,oBAAoB,EAAE;IAC1E,EAAE,OAAO,EAAE,mCAAmC,EAAE,KAAK,EAAE,oBAAoB,EAAE;IAC7E,EAAE,OAAO,EAAE,0DAA0D,EAAE,KAAK,EAAE,eAAe,EAAE;IAC/F,EAAE,OAAO,EAAE,uCAAuC,EAAE,KAAK,EAAE,iBAAiB,EAAE;IAC9E,EAAE,OAAO,EAAE,kBAAkB,EAAE,KAAK,EAAE,oBAAoB,EAAE;IAC5D,EAAE,OAAO,EAAE,0BAA0B,EAAE,KAAK,EAAE,iBAAiB,EAAE;IACjE,EAAE,OAAO,EAAE,wCAAwC,EAAE,KAAK,EAAE,WAAW,EAAE;IACzE,EAAE,OAAO,EAAE,+BAA+B,EAAE,KAAK,EAAE,mBAAmB,EAAE;IACxE,EAAE,OAAO,EAAE,wDAAwD,EAAE,KAAK,EAAE,8BAA8B,EAAE;CAC7G,CAAC;AAQF;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAc;IAChD,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,KAAK,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,kBAAkB,EAAE,CAAC;QACpD,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YACzB,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IACD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,OAAO;YACL,OAAO,EAAE,IAAI;YACb,MAAM,EAAE,QAAQ;YAChB,OAAO,EAAE,+DAA+D,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,6BAA6B;SACzH,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;AACxC,CAAC;AAED,qDAAqD;AACrD,MAAM,OAAO,WAAW;IACb,IAAI,GAAG,aAAa,CAAC;IAE9B,KAAK,CAAC,QAA8B;QAClC,QAAQ,CAAC,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,UAAkB,EAAU,EAAE;YACrE,MAAM,MAAM,GAAG,mBAAmB,CAAC,UAAU,CAAC,CAAC;YAC/C,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACnB,OAAO,KAAK,MAAM,CAAC,OAAO,IAAI,GAAG,UAAU,CAAC;YAC9C,CAAC;YACD,OAAO,UAAU,CAAC;QACpB,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

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

@@ -0,0 +1,21 @@
+import type { MaestroPlugin } from '../../types/index.js';
+import type { WorkflowHookRegistry } from '../workflow-hooks.js';
+export interface WorkflowGuardResult {
+    blocked: boolean;
+    reason?: string;
+}
+/**
+ * Pure evaluation function — portable, no I/O dependencies.
+ * @param toolName  The tool or command name (e.g. "Bash", "Write")
+ * @param input     The command string or tool input to check
+ * @param allowlist Tool names that bypass the check
+ */
+export declare function evaluateWorkflowGuard(toolName: string, input: string, allowlist?: string[]): WorkflowGuardResult;
+/** In-process plugin for coordinator graph-walker */
+export declare class WorkflowGuard implements MaestroPlugin {
+    readonly name = "workflowGuard";
+    private readonly allowlist;
+    constructor(allowlist?: string[]);
+    apply(registry: WorkflowHookRegistry): void;
+}
+//# sourceMappingURL=workflow-guard.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-guard.d.ts","sourceRoot":"","sources":["../../../../src/hooks/guards/workflow-guard.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAajE,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,SAAS,GAAE,MAAM,EAAO,GACvB,mBAAmB,CAWrB;AAED,qDAAqD;AACrD,qBAAa,aAAc,YAAW,aAAa;IACjD,QAAQ,CAAC,IAAI,mBAAmB;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAW;gBAEzB,SAAS,CAAC,EAAE,MAAM,EAAE;IAIhC,KAAK,CAAC,QAAQ,EAAE,oBAAoB,GAAG,IAAI;CAM5C"}

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

@@ -0,0 +1,47 @@
+// ---------------------------------------------------------------------------
+// WorkflowGuard — Blocks dangerous operations
+// ---------------------------------------------------------------------------
+const DANGEROUS_PATTERNS = [
+    /\brm\s+-rf\s+[\/~]/,
+    /\bgit\s+push\s+--force\b/,
+    /\bgit\s+reset\s+--hard\b/,
+    /\bgit\s+clean\s+-[a-z]*f/,
+    /\bdrop\s+table\b/i,
+    /\btruncate\s+table\b/i,
+    /\bformat\s+[a-z]:/i,
+    /\bchmod\s+777\b/,
+];
+/**
+ * Pure evaluation function — portable, no I/O dependencies.
+ * @param toolName  The tool or command name (e.g. "Bash", "Write")
+ * @param input     The command string or tool input to check
+ * @param allowlist Tool names that bypass the check
+ */
+export function evaluateWorkflowGuard(toolName, input, allowlist = []) {
+    if (allowlist.includes(toolName))
+        return { blocked: false };
+    for (const pattern of DANGEROUS_PATTERNS) {
+        if (pattern.test(input)) {
+            return {
+                blocked: true,
+                reason: `[WorkflowGuard] Blocked: dangerous operation detected in "${toolName}" matching ${pattern}`,
+            };
+        }
+    }
+    return { blocked: false };
+}
+/** In-process plugin for coordinator graph-walker */
+export class WorkflowGuard {
+    name = 'workflowGuard';
+    allowlist;
+    constructor(allowlist) {
+        this.allowlist = allowlist ?? [];
+    }
+    apply(registry) {
+        registry.beforeCommand.tap(this.name, (ctx) => {
+            const result = evaluateWorkflowGuard(ctx.cmd, ctx.prompt, this.allowlist);
+            return result.blocked ? result.reason : undefined;
+        });
+    }
+}
+//# sourceMappingURL=workflow-guard.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-guard.js","sourceRoot":"","sources":["../../../../src/hooks/guards/workflow-guard.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,8CAA8C;AAC9C,8EAA8E;AAK9E,MAAM,kBAAkB,GAAa;IACnC,oBAAoB;IACpB,0BAA0B;IAC1B,0BAA0B;IAC1B,0BAA0B;IAC1B,mBAAmB;IACnB,uBAAuB;IACvB,oBAAoB;IACpB,iBAAiB;CAClB,CAAC;AAOF;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CACnC,QAAgB,EAChB,KAAa,EACb,YAAsB,EAAE;IAExB,IAAI,SAAS,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IAC5D,KAAK,MAAM,OAAO,IAAI,kBAAkB,EAAE,CAAC;QACzC,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YACxB,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,6DAA6D,QAAQ,cAAc,OAAO,EAAE;aACrG,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AAC5B,CAAC;AAED,qDAAqD;AACrD,MAAM,OAAO,aAAa;IACf,IAAI,GAAG,eAAe,CAAC;IACf,SAAS,CAAW;IAErC,YAAY,SAAoB;QAC9B,IAAI,CAAC,SAAS,GAAG,SAAS,IAAI,EAAE,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,QAA8B;QAClC,QAAQ,CAAC,aAAa,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE;YAC5C,MAAM,MAAM,GAAG,qBAAqB,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;YAC1E,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;QACpD,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}