maestro-flow 0.3.45 → 0.3.47

package/dist/src/tools/impeccable/live/bootstrap.js

@@ -0,0 +1,244 @@
+// Copyright 2024 Paul Bakaus (https://github.com/pbakaus/impeccable)
+// Licensed under the Apache License, Version 2.0
+// Modifications: Converted to TypeScript, adapted for maestro CLI architecture.
+/**
+ * CLI entry point: prepare everything needed to enter the live variant poll loop.
+ *
+ * Does (all in one command):
+ *   1. Check .workflow/impeccable/live/config.json (returns config_missing if first-ever run)
+ *   2. Start the live server in the background (or reuse a running one)
+ *   3. Inject the browser script tag into the project's entry file
+ *   4. Read PRODUCT.md / DESIGN.md for project context
+ *   5. Print a single JSON blob with everything the agent needs
+ *
+ * After this, the agent's only remaining steps are:
+ *   - Open the project's live dev/preview URL in the browser (optional)
+ *   - Enter the poll loop: maestro impeccable live-poll
+ *
+ * Converted from live.mjs to TypeScript.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { loadContext } from '../load-context.js';
+import { readLiveServerInfo } from '../paths.js';
+import { injectCli, resolveFiles } from './inject.js';
+// ---------------------------------------------------------------------------
+// Drift-heal scan
+// ---------------------------------------------------------------------------
+const SCAN_ROOTS = ['public', 'src', 'app', 'pages'];
+const IGNORE_DIRS = new Set([
+    'node_modules', '.git', '.next', '.nuxt', '.svelte-kit', '.astro',
+    '.turbo', '.vercel', '.cache', 'coverage', 'dist', 'build',
+]);
+function scanForDrift(rootDir, resolvedFiles, config) {
+    const resolvedSet = new Set(resolvedFiles.map((f) => f.split(path.sep).join('/')));
+    // Files matching the user's `exclude` globs are intentional omissions,
+    // not drift. Compile them to regexes so the orphan list stays signal.
+    const userExcludeRegexes = (Array.isArray(config.exclude) ? config.exclude : [])
+        .map((p) => globToRegex(p));
+    const isUserExcluded = (rel) => userExcludeRegexes.some((re) => re.test(rel));
+    const orphans = [];
+    const walk = (dir, relBase) => {
+        let entries;
+        try {
+            entries = fs.readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const e of entries) {
+            const rel = relBase ? `${relBase}/${e.name}` : e.name;
+            if (e.isDirectory()) {
+                if (IGNORE_DIRS.has(e.name) || e.name.startsWith('.'))
+                    continue;
+                walk(path.join(dir, e.name), rel);
+            }
+            else if (e.isFile() && e.name.endsWith('.html')) {
+                if (resolvedSet.has(rel))
+                    continue;
+                if (isUserExcluded(rel))
+                    continue;
+                orphans.push(rel);
+            }
+        }
+    };
+    for (const root of SCAN_ROOTS) {
+        const abs = path.join(rootDir, root);
+        if (fs.existsSync(abs) && fs.statSync(abs).isDirectory()) {
+            walk(abs, root);
+        }
+    }
+    if (orphans.length === 0)
+        return null;
+    const capped = orphans.slice(0, 20);
+    return {
+        orphans: capped,
+        orphanCount: orphans.length,
+        hint: `${orphans.length} HTML file(s) exist but aren't in config.files. Consider adding them, or use a glob pattern like "public/**/*.html".`,
+    };
+}
+/**
+ * Same glob-to-regex mapping used by inject.ts. Kept inline here
+ * to avoid circular imports. The two must stay in sync.
+ */
+function globToRegex(pattern) {
+    let re = '';
+    let i = 0;
+    while (i < pattern.length) {
+        const c = pattern[i];
+        if (c === '*') {
+            if (pattern[i + 1] === '*') {
+                if (pattern[i + 2] === '/') {
+                    re += '(?:.*/)?';
+                    i += 3;
+                }
+                else {
+                    re += '.*';
+                    i += 2;
+                }
+            }
+            else {
+                re += '[^/]*';
+                i += 1;
+            }
+        }
+        else if (c === '?') {
+            re += '[^/]';
+            i += 1;
+        }
+        else if (/[.+^${}()|[\]\\]/.test(c)) {
+            re += '\\' + c;
+            i += 1;
+        }
+        else {
+            re += c;
+            i += 1;
+        }
+    }
+    return new RegExp('^' + re + '$');
+}
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function safeParse(out) {
+    try {
+        return JSON.parse(String(out).trim());
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Return server info for the running live server, starting one if needed.
+ */
+async function ensureServerRunning() {
+    // Try to reuse an existing server
+    try {
+        const record = readLiveServerInfo(process.cwd());
+        const existing = record?.info;
+        if (existing && existing.pid) {
+            try {
+                process.kill(existing.pid, 0); // throws if dead
+                return existing;
+            }
+            catch { /* stale PID file — the server script will clean it up */ }
+        }
+    }
+    catch { /* no PID file */ }
+    // Start a new server via serverCli in background mode
+    try {
+        const { serverCli } = await import('./server.js');
+        // Capture output by temporarily replacing console.log
+        let captured = '';
+        const origLog = console.log;
+        console.log = (...args) => { captured += args.map(String).join(' ') + '\n'; };
+        try {
+            await serverCli(undefined, { background: true });
+        }
+        catch {
+            // background mode spawns a child and exits; errors are printed to stderr
+        }
+        console.log = origLog;
+        const parsed = safeParse(captured.trim());
+        if (parsed && parsed.port && parsed.token) {
+            return parsed;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+// ---------------------------------------------------------------------------
+// Main
+// ---------------------------------------------------------------------------
+export async function bootstrapCli() {
+    // 1. Check config (fail fast if missing — no point starting anything else)
+    let checkResult = null;
+    // Capture injectCli --check output
+    let checkCaptured = '';
+    const origLog = console.log;
+    console.log = (...args) => { checkCaptured += args.map(String).join(' '); };
+    try {
+        await injectCli({ check: true });
+    }
+    catch {
+        // injectCli may exit(1) for missing config — that's expected
+    }
+    console.log = origLog;
+    checkResult = safeParse(checkCaptured);
+    if (!checkResult || !checkResult.ok) {
+        console.log(JSON.stringify(checkResult || { ok: false, error: 'check_failed', raw: checkCaptured }));
+        process.exit(0);
+    }
+    // 2. Start server (or reuse existing)
+    const serverInfo = await ensureServerRunning();
+    if (!serverInfo) {
+        console.log(JSON.stringify({ ok: false, error: 'server_start_failed' }));
+        process.exit(1);
+    }
+    // 3. Inject the script tag at the current port
+    let injectCaptured = '';
+    console.log = (...args) => { injectCaptured += args.map(String).join(' '); };
+    try {
+        await injectCli({ port: String(serverInfo.port) });
+    }
+    catch {
+        // injectCli exits(1) on failure
+    }
+    console.log = origLog;
+    const injectResult = safeParse(injectCaptured);
+    if (!injectResult || !injectResult.ok) {
+        console.log(JSON.stringify({
+            ok: false,
+            error: 'inject_failed',
+            detail: injectResult || injectCaptured,
+            serverPort: serverInfo.port,
+        }));
+        process.exit(1);
+    }
+    // 4. Load PRODUCT.md + DESIGN.md context (auto-migrates legacy .impeccable.md)
+    const ctx = loadContext(process.cwd());
+    // 5. Compute drift-heal: compare resolved inject targets against the
+    //    project's HTML files. Orphans are HTML files not covered by config.
+    //    Warning only — the agent decides whether to act.
+    const config = checkResult.config;
+    const resolvedFiles = resolveFiles(process.cwd(), config);
+    const drift = scanForDrift(process.cwd(), resolvedFiles, config);
+    // 6. Emit everything the agent needs
+    console.log(JSON.stringify({
+        ok: true,
+        serverPort: serverInfo.port,
+        serverToken: serverInfo.token,
+        pageFiles: resolvedFiles,
+        configDrift: drift,
+        hasProduct: ctx.hasProduct,
+        product: ctx.product,
+        productPath: ctx.productPath,
+        hasDesign: ctx.hasDesign,
+        design: ctx.design,
+        designPath: ctx.designPath,
+        migrated: ctx.migrated,
+    }, null, 2));
+}
+//# sourceMappingURL=bootstrap.js.map

package/dist/src/tools/impeccable/live/bootstrap.js.map

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

package/dist/src/tools/impeccable/live/complete.d.ts

@@ -0,0 +1,7 @@
+export interface CompleteOpts {
+    id: string;
+    discarded?: boolean;
+    error?: string | boolean;
+}
+export declare function completeCli(opts: CompleteOpts): Promise<void>;
+//# sourceMappingURL=complete.d.ts.map

package/dist/src/tools/impeccable/live/complete.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"complete.d.ts","sourceRoot":"","sources":["../../../../../src/tools/impeccable/live/complete.ts"],"names":[],"mappings":"AAgBA,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B;AAMD,wBAAsB,WAAW,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CA4CnE"}

package/dist/src/tools/impeccable/live/complete.js

@@ -0,0 +1,67 @@
+// Copyright 2024 Paul Bakaus (https://github.com/pbakaus/impeccable)
+// Licensed under the Apache License, Version 2.0
+// Modifications: Converted to TypeScript, adapted for maestro CLI architecture.
+/**
+ * Canonical durable completion acknowledgement for Impeccable live sessions.
+ */
+import { createLiveSessionStore } from './session-store.js';
+import { readLiveServerInfo } from '../paths.js';
+// ---------------------------------------------------------------------------
+// CLI entry point
+// ---------------------------------------------------------------------------
+export async function completeCli(opts) {
+    const store = createLiveSessionStore({ cwd: process.cwd(), sessionId: opts.id });
+    const status = opts.discarded === true
+        ? 'discarded'
+        : opts.error
+            ? 'agent_error'
+            : 'complete';
+    const message = typeof opts.error === 'string' ? opts.error : 'unknown error';
+    const serverInfo = readServerInfo();
+    const serverResult = serverInfo
+        ? await completeThroughServer(serverInfo, {
+            id: opts.id,
+            status,
+            message,
+        })
+        : null;
+    if (serverResult?.ok) {
+        const snapshot = store.getSnapshot(opts.id, { includeCompleted: true });
+        console.log(JSON.stringify({ ok: true, id: opts.id, phase: snapshot?.phase || status, snapshot }, null, 2));
+        return;
+    }
+    const event = status === 'discarded'
+        ? { type: 'discarded', id: opts.id }
+        : status === 'agent_error'
+            ? { type: 'agent_error', id: opts.id, message }
+            : { type: 'complete', id: opts.id };
+    const snapshot = store.appendEvent(event);
+    console.log(JSON.stringify({ ok: true, id: opts.id, phase: snapshot.phase, snapshot }, null, 2));
+}
+// ---------------------------------------------------------------------------
+// Server helpers
+// ---------------------------------------------------------------------------
+function readServerInfo() {
+    return readLiveServerInfo(process.cwd())?.info || null;
+}
+async function completeThroughServer(info, args) {
+    const type = args.status === 'discarded'
+        ? 'discarded'
+        : args.status === 'agent_error'
+            ? 'error'
+            : 'complete';
+    try {
+        const res = await fetch(`http://localhost:${info.port}/poll`, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ token: info.token, id: args.id, type, message: args.message }),
+        });
+        if (!res.ok)
+            return null;
+        return (await res.json());
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=complete.js.map

package/dist/src/tools/impeccable/live/complete.js.map

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

package/dist/src/tools/impeccable/live/completion.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Completion type mapping for Impeccable live-session accept results.
+ */
+export type EventType = string;
+export interface AcceptResult {
+    handled?: boolean;
+    carbonize?: boolean;
+    mode?: string;
+    error?: string;
+    file?: string;
+}
+export type CompletionType = 'discarded' | 'error' | 'agent_done' | 'complete';
+export interface CompletionAck {
+    ok: boolean;
+    type: CompletionType;
+    final?: boolean;
+    requiresComplete?: boolean;
+    nextCommand?: string;
+    message?: string;
+    error?: string;
+}
+export declare function completionTypeForAcceptResult(eventType: EventType, acceptResult: AcceptResult | undefined): CompletionType;
+export declare function completionAckForAcceptResult(eventId: string, completionType: CompletionType, acceptResult: AcceptResult | undefined): CompletionAck;
+//# sourceMappingURL=completion.d.ts.map

package/dist/src/tools/impeccable/live/completion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion.d.ts","sourceRoot":"","sources":["../../../../../src/tools/impeccable/live/completion.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,MAAM,MAAM,SAAS,GAAG,MAAM,CAAC;AAE/B,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,cAAc,GAAG,WAAW,GAAG,OAAO,GAAG,YAAY,GAAG,UAAU,CAAC;AAE/E,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,OAAO,CAAC;IACZ,IAAI,EAAE,cAAc,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,6BAA6B,CAC3C,SAAS,EAAE,SAAS,EACpB,YAAY,EAAE,YAAY,GAAG,SAAS,GACrC,cAAc,CAMhB;AAED,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,cAAc,EAC9B,YAAY,EAAE,YAAY,GAAG,SAAS,GACrC,aAAa,CAUf"}

package/dist/src/tools/impeccable/live/completion.js

@@ -0,0 +1,26 @@
+// Copyright 2024 Paul Bakaus (https://github.com/pbakaus/impeccable)
+// Licensed under the Apache License, Version 2.0
+// Modifications: Converted to TypeScript, adapted for maestro CLI architecture.
+export function completionTypeForAcceptResult(eventType, acceptResult) {
+    if (eventType === 'discard')
+        return acceptResult?.handled === true ? 'discarded' : 'error';
+    if (acceptResult?.handled === true && acceptResult?.carbonize === true)
+        return 'agent_done';
+    if (acceptResult?.handled === true)
+        return 'complete';
+    if (acceptResult?.mode === 'error')
+        return 'error';
+    return 'agent_done';
+}
+export function completionAckForAcceptResult(eventId, completionType, acceptResult) {
+    const ack = { ok: true, type: completionType };
+    if (acceptResult?.handled === true && acceptResult?.carbonize === true) {
+        ack.final = false;
+        ack.requiresComplete = true;
+        ack.nextCommand = `live-complete --id ${eventId}`;
+        ack.message =
+            'Carbonize cleanup must be verified, then the session must be completed explicitly before polling again.';
+    }
+    return ack;
+}
+//# sourceMappingURL=completion.js.map

package/dist/src/tools/impeccable/live/completion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion.js","sourceRoot":"","sources":["../../../../../src/tools/impeccable/live/completion.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,iDAAiD;AACjD,gFAAgF;AA4BhF,MAAM,UAAU,6BAA6B,CAC3C,SAAoB,EACpB,YAAsC;IAEtC,IAAI,SAAS,KAAK,SAAS;QAAE,OAAO,YAAY,EAAE,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC;IAC3F,IAAI,YAAY,EAAE,OAAO,KAAK,IAAI,IAAI,YAAY,EAAE,SAAS,KAAK,IAAI;QAAE,OAAO,YAAY,CAAC;IAC5F,IAAI,YAAY,EAAE,OAAO,KAAK,IAAI;QAAE,OAAO,UAAU,CAAC;IACtD,IAAI,YAAY,EAAE,IAAI,KAAK,OAAO;QAAE,OAAO,OAAO,CAAC;IACnD,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,4BAA4B,CAC1C,OAAe,EACf,cAA8B,EAC9B,YAAsC;IAEtC,MAAM,GAAG,GAAkB,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC;IAC9D,IAAI,YAAY,EAAE,OAAO,KAAK,IAAI,IAAI,YAAY,EAAE,SAAS,KAAK,IAAI,EAAE,CAAC;QACvE,GAAG,CAAC,KAAK,GAAG,KAAK,CAAC;QAClB,GAAG,CAAC,gBAAgB,GAAG,IAAI,CAAC;QAC5B,GAAG,CAAC,WAAW,GAAG,sBAAsB,OAAO,EAAE,CAAC;QAClD,GAAG,CAAC,OAAO;YACT,yGAAyG,CAAC;IAC9G,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/src/tools/impeccable/live/inject.d.ts

@@ -0,0 +1,41 @@
+interface InjectOpts {
+    port?: string;
+    remove?: boolean;
+    check?: boolean;
+}
+export interface LiveConfig {
+    files: string[];
+    exclude?: string[];
+    insertBefore?: string;
+    insertAfter?: string;
+    commentSyntax: 'html' | 'jsx';
+    cspChecked?: boolean;
+}
+export declare function injectCli(opts?: InjectOpts): Promise<void>;
+/**
+ * Expand config.files (which may contain glob patterns) into a literal list
+ * of existing file paths relative to rootDir. Literal entries pass through;
+ * glob patterns are expanded via fs.globSync. HARD_EXCLUDES and config.exclude
+ * are applied as filters. Duplicates are removed. Order is preserved by
+ * first appearance.
+ */
+export declare function resolveFiles(rootDir: string, config: LiveConfig): string[];
+declare function validateConfig(cfg: LiveConfig): void;
+export declare function buildTagBlock(syntax: string, port: number): string;
+export declare function insertTag(content: string, config: LiveConfig, port: number): string;
+/**
+ * Remove the live script block. Matches either HTML or JSX comment markers
+ * regardless of config (so stale tags from a wrong config can still be cleaned).
+ *
+ * Indent-preserving: captures any whitespace immediately preceding the opener
+ * marker and re-emits it in place of the removed block. `insertTag` inserted
+ * the block *after* the original line's indent and *before* the anchor (e.g.
+ * `</body>`), which moved the indent onto the opener line and left the anchor
+ * unindented. Replacing the whole block (plus its trailing newline) with just
+ * the captured indent hands the indent back to the anchor that follows.
+ */
+export declare function removeTag(content: string, _syntax: string): string;
+export declare function patchCspMeta(content: string, port: number): string;
+export declare function revertCspMeta(content: string): string;
+export { validateConfig };
+//# sourceMappingURL=inject.d.ts.map

package/dist/src/tools/impeccable/live/inject.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inject.d.ts","sourceRoot":"","sources":["../../../../../src/tools/impeccable/live/inject.ts"],"names":[],"mappings":"AAiCA,UAAU,UAAU;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,GAAG,KAAK,CAAC;IAC9B,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAeD,wBAAsB,SAAS,CAAC,IAAI,GAAE,UAAe,GAAG,OAAO,CAAC,IAAI,CAAC,CAmFpE;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,MAAM,EAAE,CAuC1E;AA+CD,iBAAS,cAAc,CAAC,GAAG,EAAE,UAAU,GAAG,IAAI,CAyB7C;AAKD,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAQlE;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAkBnF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAUlE;AAmED,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAyClE;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAyBrD;AAED,OAAO,EAAE,cAAc,EAAE,CAAC"}