maestro-flow 0.1.4 → 0.2.0

package/dist/src/coordinator/prompt-assembler.js

@@ -0,0 +1,248 @@
+// Graph Coordinator — Prompt Assembler
+// 6-phase pipeline: resolve args → build command → inject context →
+// inject state → apply template → auto directive.
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+// Built-in default template (used when file template not found)
+const DEFAULT_TEMPLATE = `# Coordinate Step {{STEP_N}} — {{GRAPH_NAME}}
+
+## Command
+{{COMMAND}}
+
+{{#AUTO_DIRECTIVE}}
+**Mode:** {{AUTO_DIRECTIVE}}
+{{/AUTO_DIRECTIVE}}
+
+{{#PREVIOUS_CONTEXT}}
+## Context from Previous Step
+{{PREVIOUS_CONTEXT}}
+{{/PREVIOUS_CONTEXT}}
+
+{{#STATE_SNAPSHOT}}
+## Current State
+{{STATE_SNAPSHOT}}
+{{/STATE_SNAPSHOT}}
+
+{{#INTENT}}
+## Original Intent
+{{INTENT}}
+{{/INTENT}}
+
+## Report Status (Required)
+
+Before finishing, run exactly this command (substitute values based on what
+you accomplished). This is the ONLY way the coordinator learns your result —
+text output alone is not read.
+
+\`\`\`
+maestro coordinate report \\
+  --session {{SESSION_ID}} \\
+  --node {{NODE_ID}} \\
+  --status <SUCCESS|FAILURE> \\
+  [--verification <passed|failed|pending>] \\
+  [--review <PASS|WARN|BLOCK>] \\
+  [--uat <passed|failed|pending>] \\
+  [--phase <number>] \\
+  [--artifact <path>] [--artifact <path>] \\
+  [--summary "<one-line what was accomplished>"]
+\`\`\`
+
+Legacy fallback (only if the report command is unavailable): append this
+block at the end of your output. The coordinator will parse it as a
+last-resort contract.
+
+\`\`\`
+--- COORDINATE RESULT ---
+STATUS: <SUCCESS or FAILURE>
+PHASE: <number, or "none">
+VERIFICATION_STATUS: <passed or failed or pending, if applicable>
+REVIEW_VERDICT: <PASS or WARN or BLOCK, if applicable>
+UAT_STATUS: <passed or failed or pending, if applicable>
+ARTIFACTS: <comma-separated file paths, or "none">
+SUMMARY: <one-line what was accomplished>
+\`\`\`
+`;
+export class DefaultPromptAssembler {
+    workflowRoot;
+    templateDir;
+    constructor(workflowRoot, templateDir) {
+        this.workflowRoot = workflowRoot;
+        this.templateDir = templateDir;
+    }
+    async assemble(req) {
+        const { node, context: ctx, graph, auto_mode } = req;
+        const resolvedArgs = this.resolveArgs(node.args ?? '', ctx);
+        const command = this.buildCommand(node, resolvedArgs, auto_mode);
+        const previousContext = this.buildPreviousContext(req);
+        const stateSnapshot = this.buildStateSnapshot(ctx.project);
+        const autoDirective = auto_mode
+            ? 'Auto-confirm all prompts. No interactive questions. Skip clarifications.'
+            : '';
+        const vars = {
+            COMMAND: command,
+            STEP_N: `${req.command_index}/${req.command_total}`,
+            GRAPH_NAME: graph.name,
+            GRAPH_ID: graph.id,
+            NODE_ID: req.node_id,
+            SESSION_ID: req.session_id,
+            PREVIOUS_CONTEXT: previousContext,
+            STATE_SNAPSHOT: stateSnapshot,
+            AUTO_DIRECTIVE: autoDirective,
+            INTENT: ctx.inputs['intent'] ?? '',
+        };
+        const template = await this.loadTemplate();
+        return this.renderTemplate(template, vars);
+    }
+    // -- Phase 1: Resolve Args --
+    resolveArgs(args, ctx) {
+        return args.replace(/\{([^}]+)\}/g, (_match, key) => {
+            const value = this.resolveKey(key.trim(), ctx);
+            return value !== undefined ? String(value) : `{${key}}`;
+        });
+    }
+    resolveKey(key, ctx) {
+        // {var.xxx} or {var.xxx.yyy} — dig into ctx.var
+        if (key.startsWith('var.')) {
+            return dig(ctx.var, key.slice(4).split('.'));
+        }
+        // {word} — try ctx.inputs first, then ctx.var
+        if (!key.includes('.')) {
+            if (key in ctx.inputs)
+                return ctx.inputs[key];
+            if (key in ctx.var)
+                return ctx.var[key];
+            return undefined;
+        }
+        // {word.path} — try inputs[word] then var[word]
+        const [first, ...rest] = key.split('.');
+        if (first in ctx.inputs) {
+            const root = ctx.inputs[first];
+            return rest.length > 0 ? dig(root, rest) : root;
+        }
+        if (first in ctx.var) {
+            const root = ctx.var[first];
+            return rest.length > 0 ? dig(root, rest) : root;
+        }
+        return undefined;
+    }
+    // -- Phase 2: Build Command Block --
+    buildCommand(node, resolvedArgs, autoMode) {
+        const parts = [`/${node.cmd}`];
+        if (resolvedArgs)
+            parts.push(resolvedArgs);
+        if (autoMode && node.auto_flag)
+            parts.push(node.auto_flag);
+        return parts.join(' ').trim();
+    }
+    // -- Phase 3: Inject Previous Context --
+    buildPreviousContext(req) {
+        const sections = [];
+        const ctx = req.context;
+        // 3a: Previous command
+        if (req.previous_command) {
+            const pc = req.previous_command;
+            let section = `### Previous Step: ${pc.cmd} (${pc.outcome})`;
+            if (pc.summary)
+                section += `\n${pc.summary}`;
+            sections.push(section);
+        }
+        // 3b: Previous result
+        if (ctx.result) {
+            const lines = ['### Previous Result'];
+            const r = ctx.result;
+            if (r['status'])
+                lines.push(`- **Status:** ${r['status']}`);
+            if (r['phase'])
+                lines.push(`- **Phase:** ${r['phase']}`);
+            if (r['artifacts'])
+                lines.push(`- **Artifacts:** ${r['artifacts']}`);
+            if (r['summary'])
+                lines.push(`- **Summary:** ${r['summary']}`);
+            sections.push(lines.join('\n'));
+        }
+        // 3c: Analysis hints
+        if (ctx.analysis) {
+            const a = ctx.analysis;
+            const hints = a['next_step_hints'];
+            const lines = ['### Analysis Hints'];
+            if (hints) {
+                if (hints['prompt_additions']) {
+                    lines.push(String(hints['prompt_additions']));
+                }
+                if (Array.isArray(hints['cautions']) && hints['cautions'].length > 0) {
+                    lines.push(`**Cautions:** ${hints['cautions'].join('; ')}`);
+                }
+                if (hints['context_to_carry']) {
+                    lines.push(String(hints['context_to_carry']));
+                }
+            }
+            const score = a['quality_score'];
+            if (score !== undefined && score !== null) {
+                lines.push(`Previous step quality: ${score}/100`);
+            }
+            if (lines.length > 1)
+                sections.push(lines.join('\n'));
+        }
+        return sections.join('\n\n');
+    }
+    // -- Phase 4: Inject State Snapshot --
+    buildStateSnapshot(project) {
+        if (!project.initialized)
+            return 'Project not initialized.';
+        const lines = [];
+        lines.push(`Phase ${project.current_phase} | Status: ${project.phase_status}`);
+        lines.push(`Progress: ${project.phases_completed}/${project.phases_total} phases`);
+        if (project.execution.tasks_total > 0) {
+            lines.push(`Tasks: ${project.execution.tasks_completed}/${project.execution.tasks_total}`);
+        }
+        if (project.verification_status !== 'pending') {
+            lines.push(`Verification: ${project.verification_status}`);
+        }
+        if (project.review_verdict !== null) {
+            lines.push(`Review: ${project.review_verdict}`);
+        }
+        if (project.uat_status !== 'pending') {
+            lines.push(`UAT: ${project.uat_status}`);
+        }
+        const artifactList = Object.entries(project.artifacts)
+            .filter(([, v]) => v)
+            .map(([k]) => k);
+        if (artifactList.length > 0) {
+            lines.push(`Artifacts: ${artifactList.join(', ')}`);
+        }
+        return lines.join('\n');
+    }
+    // -- Phase 5: Apply Template --
+    async loadTemplate() {
+        const templatePath = join(this.templateDir, 'coordinate-step-v2.md');
+        try {
+            return await readFile(templatePath, 'utf-8');
+        }
+        catch {
+            return DEFAULT_TEMPLATE;
+        }
+    }
+    renderTemplate(template, vars) {
+        // Conditional blocks: {{#FIELD}}...content...{{/FIELD}}
+        let result = template.replace(/\{\{#(\w+)\}\}([\s\S]*?)\{\{\/\1\}\}/g, (_match, field, content) => {
+            return vars[field] ? content : '';
+        });
+        // Simple variable replacement: {{VAR}}
+        result = result.replace(/\{\{(\w+)\}\}/g, (_match, key) => {
+            return vars[key] ?? '';
+        });
+        // Clean up excess blank lines (more than 2 consecutive)
+        result = result.replace(/\n{3,}/g, '\n\n');
+        return result.trim() + '\n';
+    }
+}
+function dig(obj, path) {
+    let cur = obj;
+    for (const seg of path) {
+        if (cur == null || typeof cur !== 'object')
+            return undefined;
+        cur = cur[seg];
+    }
+    return cur;
+}
+//# sourceMappingURL=prompt-assembler.js.map

package/dist/src/coordinator/prompt-assembler.js.map

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

package/dist/src/coordinator/step-analyzer.d.ts

@@ -0,0 +1,8 @@
+import type { AnalysisResult, AssembleRequest, CommandNode, StepAnalyzer, WalkerContext } from './graph-types.js';
+import type { SpawnFn } from './cli-executor.js';
+export declare class GeminiStepAnalyzer implements StepAnalyzer {
+    private readonly spawnFn;
+    constructor(spawnFn: SpawnFn);
+    analyze(node: CommandNode, rawOutput: string, _ctx: WalkerContext, prevCmd?: AssembleRequest['previous_command']): Promise<AnalysisResult>;
+}
+//# sourceMappingURL=step-analyzer.d.ts.map

package/dist/src/coordinator/step-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-analyzer.d.ts","sourceRoot":"","sources":["../../../src/coordinator/step-analyzer.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EACf,WAAW,EACX,YAAY,EACZ,aAAa,EACd,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAUjD,qBAAa,kBAAmB,YAAW,YAAY;IACzC,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAAP,OAAO,EAAE,OAAO;IAEvC,OAAO,CACX,IAAI,EAAE,WAAW,EACjB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,aAAa,EACnB,OAAO,CAAC,EAAE,eAAe,CAAC,kBAAkB,CAAC,GAC5C,OAAO,CAAC,cAAc,CAAC;CA6C3B"}

package/dist/src/coordinator/step-analyzer.js

@@ -0,0 +1,82 @@
+// ---------------------------------------------------------------------------
+// Step Analyzer — Optional quality analysis via gemini after each command step.
+// Never throws; analysis failure returns a safe default result.
+// ---------------------------------------------------------------------------
+const MAX_OUTPUT_CHARS = 4000;
+const DEFAULT_RESULT = {
+    quality_score: 50,
+    issues: ['Analysis parsing failed'],
+    next_step_hints: {},
+};
+export class GeminiStepAnalyzer {
+    spawnFn;
+    constructor(spawnFn) {
+        this.spawnFn = spawnFn;
+    }
+    async analyze(node, rawOutput, _ctx, prevCmd) {
+        const outputTail = rawOutput.length > MAX_OUTPUT_CHARS
+            ? rawOutput.slice(-MAX_OUTPUT_CHARS)
+            : rawOutput;
+        const prevLine = prevCmd
+            ? `Previous step: ${prevCmd.cmd} (${prevCmd.outcome})`
+            : 'Previous step: none';
+        const prompt = [
+            'Analyze the following maestro command output.',
+            '',
+            `Command: ${node.cmd}${node.args ? ' ' + node.args : ''}`,
+            prevLine,
+            '',
+            'Output (last 4000 chars):',
+            outputTail,
+            '',
+            'Return a JSON block with this exact format:',
+            '```json',
+            '{',
+            '  "quality_score": <0-100>,',
+            '  "issues": ["issue1", "issue2"],',
+            '  "next_step_hints": {',
+            '    "prompt_additions": "suggestions for next step",',
+            '    "cautions": ["caution1"],',
+            '    "context_to_carry": "key context"',
+            '  }',
+            '}',
+            '```',
+        ].join('\n');
+        try {
+            const result = await this.spawnFn({
+                type: 'gemini',
+                prompt,
+                workDir: process.cwd(),
+                approvalMode: 'suggest',
+            });
+            return parseAnalysis(result.output);
+        }
+        catch {
+            return { ...DEFAULT_RESULT };
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// JSON extraction from gemini output
+// ---------------------------------------------------------------------------
+function parseAnalysis(output) {
+    const match = output.match(/```json\s*([\s\S]*?)```/);
+    if (!match)
+        return { ...DEFAULT_RESULT };
+    try {
+        const parsed = JSON.parse(match[1].trim());
+        if (typeof parsed.quality_score !== 'number' ||
+            !Array.isArray(parsed.issues)) {
+            return { ...DEFAULT_RESULT };
+        }
+        return {
+            quality_score: parsed.quality_score,
+            issues: parsed.issues,
+            next_step_hints: (parsed.next_step_hints ?? {}),
+        };
+    }
+    catch {
+        return { ...DEFAULT_RESULT };
+    }
+}
+//# sourceMappingURL=step-analyzer.js.map

package/dist/src/coordinator/step-analyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-analyzer.js","sourceRoot":"","sources":["../../../src/coordinator/step-analyzer.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,gFAAgF;AAChF,gEAAgE;AAChE,8EAA8E;AAW9E,MAAM,gBAAgB,GAAG,IAAI,CAAC;AAE9B,MAAM,cAAc,GAAmB;IACrC,aAAa,EAAE,EAAE;IACjB,MAAM,EAAE,CAAC,yBAAyB,CAAC;IACnC,eAAe,EAAE,EAAE;CACpB,CAAC;AAEF,MAAM,OAAO,kBAAkB;IACA;IAA7B,YAA6B,OAAgB;QAAhB,YAAO,GAAP,OAAO,CAAS;IAAG,CAAC;IAEjD,KAAK,CAAC,OAAO,CACX,IAAiB,EACjB,SAAiB,EACjB,IAAmB,EACnB,OAA6C;QAE7C,MAAM,UAAU,GAAG,SAAS,CAAC,MAAM,GAAG,gBAAgB;YACpD,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,gBAAgB,CAAC;YACpC,CAAC,CAAC,SAAS,CAAC;QAEd,MAAM,QAAQ,GAAG,OAAO;YACtB,CAAC,CAAC,kBAAkB,OAAO,CAAC,GAAG,KAAK,OAAO,CAAC,OAAO,GAAG;YACtD,CAAC,CAAC,qBAAqB,CAAC;QAE1B,MAAM,MAAM,GAAG;YACb,+CAA+C;YAC/C,EAAE;YACF,YAAY,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE;YACzD,QAAQ;YACR,EAAE;YACF,2BAA2B;YAC3B,UAAU;YACV,EAAE;YACF,6CAA6C;YAC7C,SAAS;YACT,GAAG;YACH,6BAA6B;YAC7B,mCAAmC;YACnC,wBAAwB;YACxB,sDAAsD;YACtD,+BAA+B;YAC/B,uCAAuC;YACvC,KAAK;YACL,GAAG;YACH,KAAK;SACN,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEb,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC;gBAChC,IAAI,EAAE,QAAQ;gBACd,MAAM;gBACN,OAAO,EAAE,OAAO,CAAC,GAAG,EAAE;gBACtB,YAAY,EAAE,SAAS;aACxB,CAAC,CAAC;YAEH,OAAO,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACtC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,GAAG,cAAc,EAAE,CAAC;QAC/B,CAAC;IACH,CAAC;CACF;AAED,8EAA8E;AAC9E,qCAAqC;AACrC,8EAA8E;AAE9E,SAAS,aAAa,CAAC,MAAc;IACnC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,yBAAyB,CAAC,CAAC;IACtD,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,GAAG,cAAc,EAAE,CAAC;IAEzC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAA4B,CAAC;QAEtE,IACE,OAAO,MAAM,CAAC,aAAa,KAAK,QAAQ;YACxC,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAC7B,CAAC;YACD,OAAO,EAAE,GAAG,cAAc,EAAE,CAAC;QAC/B,CAAC;QAED,OAAO;YACL,aAAa,EAAE,MAAM,CAAC,aAAa;YACnC,MAAM,EAAE,MAAM,CAAC,MAAkB;YACjC,eAAe,EAAE,CAAC,MAAM,CAAC,eAAe,IAAI,EAAE,CAAsC;SACrF,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,GAAG,cAAc,EAAE,CAAC;IAC/B,CAAC;AACH,CAAC"}

package/dist/src/core/extension-loader.d.ts

@@ -0,0 +1,11 @@
+import type { ToolRegistry } from './tool-registry.js';
+export declare class ExtensionLoader {
+    private registry;
+    private loaded;
+    constructor(registry: ToolRegistry);
+    loadFromDir(dir: string): Promise<void>;
+    loadExtension(extPath: string): Promise<void>;
+    unloadAll(): Promise<void>;
+    listLoaded(): string[];
+}
+//# sourceMappingURL=extension-loader.d.ts.map

package/dist/src/core/extension-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-loader.d.ts","sourceRoot":"","sources":["../../../src/core/extension-loader.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,qBAAa,eAAe;IAGd,OAAO,CAAC,QAAQ;IAF5B,OAAO,CAAC,MAAM,CAAgC;gBAE1B,QAAQ,EAAE,YAAY;IAEpC,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWvC,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAyB7C,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAShC,UAAU,IAAI,MAAM,EAAE;CAGvB"}

package/dist/src/core/extension-loader.js

@@ -0,0 +1,54 @@
+import { readdirSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+export class ExtensionLoader {
+    registry;
+    loaded = new Map();
+    constructor(registry) {
+        this.registry = registry;
+    }
+    async loadFromDir(dir) {
+        if (!existsSync(dir))
+            return;
+        const entries = readdirSync(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (!entry.isDirectory())
+                continue;
+            const extPath = join(dir, entry.name);
+            await this.loadExtension(extPath);
+        }
+    }
+    async loadExtension(extPath) {
+        const entryFile = join(extPath, 'index.js');
+        if (!existsSync(entryFile)) {
+            console.warn(`Extension at ${extPath} missing index.js, skipping`);
+            return;
+        }
+        try {
+            const mod = await import(`file://${entryFile}`);
+            const ext = mod.default ?? mod;
+            const ctx = {
+                registerTool: (tool) => this.registry.register(tool),
+                config: {},
+                log: (msg) => console.log(`[ext:${ext.name}] ${msg}`),
+            };
+            await ext.activate(ctx);
+            this.loaded.set(ext.name, ext);
+            console.log(`Loaded extension: ${ext.name}@${ext.version}`);
+        }
+        catch (err) {
+            console.error(`Failed to load extension at ${extPath}:`, err);
+        }
+    }
+    async unloadAll() {
+        for (const [name, ext] of this.loaded) {
+            if (ext.deactivate) {
+                await ext.deactivate();
+            }
+            this.loaded.delete(name);
+        }
+    }
+    listLoaded() {
+        return Array.from(this.loaded.keys());
+    }
+}
+//# sourceMappingURL=extension-loader.js.map

package/dist/src/core/extension-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension-loader.js","sourceRoot":"","sources":["../../../src/core/extension-loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAClD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAIjC,MAAM,OAAO,eAAe;IAGN;IAFZ,MAAM,GAAG,IAAI,GAAG,EAAqB,CAAC;IAE9C,YAAoB,QAAsB;QAAtB,aAAQ,GAAR,QAAQ,CAAc;IAAG,CAAC;IAE9C,KAAK,CAAC,WAAW,CAAC,GAAW;QAC3B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,OAAO;QAE7B,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1D,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE;gBAAE,SAAS;YACnC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YACtC,MAAM,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,OAAe;QACjC,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QAC5C,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC3B,OAAO,CAAC,IAAI,CAAC,gBAAgB,OAAO,6BAA6B,CAAC,CAAC;YACnE,OAAO;QACT,CAAC;QAED,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,UAAU,SAAS,EAAE,CAAC,CAAC;YAChD,MAAM,GAAG,GAAc,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC;YAE1C,MAAM,GAAG,GAAqB;gBAC5B,YAAY,EAAE,CAAC,IAAU,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC;gBAC1D,MAAM,EAAE,EAAE;gBACV,GAAG,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,GAAG,CAAC,IAAI,KAAK,GAAG,EAAE,CAAC;aAC9D,CAAC;YAEF,MAAM,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;YACxB,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YAC/B,OAAO,CAAC,GAAG,CAAC,qBAAqB,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;QAC9D,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,+BAA+B,OAAO,GAAG,EAAE,GAAG,CAAC,CAAC;QAChE,CAAC;IACH,CAAC;IAED,KAAK,CAAC,SAAS;QACb,KAAK,MAAM,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACtC,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC;gBACnB,MAAM,GAAG,CAAC,UAAU,EAAE,CAAC;YACzB,CAAC;YACD,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,UAAU;QACR,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IACxC,CAAC;CACF"}

package/dist/src/core/manifest.d.ts

@@ -0,0 +1,24 @@
+export interface ManifestEntry {
+    path: string;
+    type: 'file' | 'dir';
+}
+export interface Manifest {
+    id: string;
+    version: string;
+    scope: 'global' | 'project';
+    targetPath: string;
+    installedAt: string;
+    entries: ManifestEntry[];
+}
+export declare function createManifest(scope: 'global' | 'project', targetPath: string): Manifest;
+export declare function addFile(manifest: Manifest, filePath: string): void;
+export declare function addDir(manifest: Manifest, dirPath: string): void;
+export declare function saveManifest(manifest: Manifest): string;
+export declare function findManifest(scope: 'global' | 'project', targetPath: string): Manifest | null;
+export declare function getAllManifests(): Manifest[];
+export declare function deleteManifest(manifest: Manifest): void;
+export declare function cleanManifestFiles(manifest: Manifest): {
+    removed: number;
+    skipped: number;
+};
+//# sourceMappingURL=manifest.d.ts.map

package/dist/src/core/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../../src/core/manifest.ts"],"names":[],"mappings":"AAuBA,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC;CACtB;AAED,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,aAAa,EAAE,CAAC;CAC1B;AAsBD,wBAAgB,cAAc,CAAC,KAAK,EAAE,QAAQ,GAAG,SAAS,EAAE,UAAU,EAAE,MAAM,GAAG,QAAQ,CAUxF;AAED,wBAAgB,OAAO,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAElE;AAED,wBAAgB,MAAM,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAEhE;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAOvD;AAeD,wBAAgB,YAAY,CAAC,KAAK,EAAE,QAAQ,GAAG,SAAS,EAAE,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAY7F;AAED,wBAAgB,eAAe,IAAI,QAAQ,EAAE,CAS5C;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI,CAGvD;AASD,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,QAAQ,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAsC3F"}

package/dist/src/core/manifest.js

@@ -0,0 +1,139 @@
+// ---------------------------------------------------------------------------
+// Installation Manifest
+// Tracks installed files for clean reinstall and uninstall.
+// Manifests stored at ~/.maestro/manifests/{id}.json
+// ---------------------------------------------------------------------------
+import { join } from 'node:path';
+import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync, unlinkSync, rmSync, } from 'node:fs';
+import { paths } from '../config/paths.js';
+// ---------------------------------------------------------------------------
+// Paths
+// ---------------------------------------------------------------------------
+const MANIFESTS_DIR = join(paths.home, 'manifests');
+function ensureDir() {
+    if (!existsSync(MANIFESTS_DIR)) {
+        mkdirSync(MANIFESTS_DIR, { recursive: true });
+    }
+}
+function manifestFile(id) {
+    return join(MANIFESTS_DIR, `${id}.json`);
+}
+// ---------------------------------------------------------------------------
+// CRUD
+// ---------------------------------------------------------------------------
+export function createManifest(scope, targetPath) {
+    const ts = new Date().toISOString().replace(/[-:]/g, '').replace('T', '-').split('.')[0];
+    return {
+        id: `${scope}-${ts}`,
+        version: '1.0',
+        scope,
+        targetPath,
+        installedAt: new Date().toISOString(),
+        entries: [],
+    };
+}
+export function addFile(manifest, filePath) {
+    manifest.entries.push({ path: filePath, type: 'file' });
+}
+export function addDir(manifest, dirPath) {
+    manifest.entries.push({ path: dirPath, type: 'dir' });
+}
+export function saveManifest(manifest) {
+    ensureDir();
+    // Remove old manifests for same scope+path
+    removeOld(manifest.scope, manifest.targetPath);
+    const fp = manifestFile(manifest.id);
+    writeFileSync(fp, JSON.stringify(manifest, null, 2), 'utf-8');
+    return fp;
+}
+function removeOld(scope, targetPath) {
+    if (!existsSync(MANIFESTS_DIR))
+        return;
+    const norm = targetPath.toLowerCase().replace(/[\\/]+$/, '');
+    for (const f of readdirSync(MANIFESTS_DIR).filter(f => f.endsWith('.json'))) {
+        try {
+            const m = JSON.parse(readFileSync(join(MANIFESTS_DIR, f), 'utf-8'));
+            if (m.scope === scope && m.targetPath.toLowerCase().replace(/[\\/]+$/, '') === norm) {
+                unlinkSync(join(MANIFESTS_DIR, f));
+            }
+        }
+        catch { /* skip */ }
+    }
+}
+export function findManifest(scope, targetPath) {
+    if (!existsSync(MANIFESTS_DIR))
+        return null;
+    const norm = targetPath.toLowerCase().replace(/[\\/]+$/, '');
+    for (const f of readdirSync(MANIFESTS_DIR).filter(f => f.endsWith('.json'))) {
+        try {
+            const m = JSON.parse(readFileSync(join(MANIFESTS_DIR, f), 'utf-8'));
+            if (m.scope === scope && m.targetPath.toLowerCase().replace(/[\\/]+$/, '') === norm) {
+                return m;
+            }
+        }
+        catch { /* skip */ }
+    }
+    return null;
+}
+export function getAllManifests() {
+    if (!existsSync(MANIFESTS_DIR))
+        return [];
+    const results = [];
+    for (const f of readdirSync(MANIFESTS_DIR).filter(f => f.endsWith('.json'))) {
+        try {
+            results.push(JSON.parse(readFileSync(join(MANIFESTS_DIR, f), 'utf-8')));
+        }
+        catch { /* skip */ }
+    }
+    return results.sort((a, b) => b.installedAt.localeCompare(a.installedAt));
+}
+export function deleteManifest(manifest) {
+    const fp = manifestFile(manifest.id);
+    if (existsSync(fp))
+        unlinkSync(fp);
+}
+// ---------------------------------------------------------------------------
+// Cleanup — remove files recorded in a manifest
+// ---------------------------------------------------------------------------
+/** Files to preserve even during cleanup. */
+const PRESERVE = new Set(['settings.json', 'settings.local.json']);
+export function cleanManifestFiles(manifest) {
+    let removed = 0;
+    let skipped = 0;
+    // Remove files first (deepest paths first)
+    const files = manifest.entries
+        .filter(e => e.type === 'file')
+        .sort((a, b) => b.path.length - a.path.length);
+    for (const entry of files) {
+        const name = entry.path.split(/[\\/]/).pop() ?? '';
+        if (PRESERVE.has(name)) {
+            skipped++;
+            continue;
+        }
+        try {
+            if (existsSync(entry.path)) {
+                unlinkSync(entry.path);
+                removed++;
+            }
+        }
+        catch { /* skip */ }
+    }
+    // Remove empty directories (deepest first)
+    const dirs = manifest.entries
+        .filter(e => e.type === 'dir')
+        .sort((a, b) => b.path.length - a.path.length);
+    for (const entry of dirs) {
+        try {
+            if (existsSync(entry.path)) {
+                const contents = readdirSync(entry.path);
+                if (contents.length === 0) {
+                    rmSync(entry.path, { recursive: true });
+                    removed++;
+                }
+            }
+        }
+        catch { /* skip */ }
+    }
+    return { removed, skipped };
+}
+//# sourceMappingURL=manifest.js.map

package/dist/src/core/manifest.js.map

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