@rajat-rastogi/maestro 0.1.0

package/dist/executor/task.js

@@ -0,0 +1,119 @@
+import * as path from 'path';
+import { markTaskComplete, reloadPlan } from '../plan/updater.js';
+import { loadPrompt } from '../config/prompts.js';
+import { expandTemplate } from '../config/template.js';
+import { stageAndCommit, taskCommitMessage, hasChanges } from '../git/commit.js';
+import { git } from '../git/git.js';
+import { addNoisyArtifactPatterns } from '../git/gitignore.js';
+import { runValidationCommands } from './validation.js';
+import { analyzeValidationFailure, displayHint } from './hints.js';
+export class TaskExecutor {
+    opts;
+    constructor(opts) {
+        this.opts = opts;
+    }
+    async executeTask(plan, task) {
+        const { config, backend, logger, cwd } = this.opts;
+        const maxAttempts = config.task_retry_count + 1;
+        for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+            if (attempt > 1) {
+                logger.warn(`Retrying task ${task.index} (attempt ${attempt}/${maxAttempts})...`);
+            }
+            try {
+                await this.runTaskSession(plan, task);
+            }
+            catch (err) {
+                // Re-throw auth errors immediately — no point retrying
+                if (err instanceof Error && err.name === 'AIProviderError') {
+                    throw err;
+                }
+                if (attempt === maxAttempts)
+                    throw err;
+                logger.warn(`Task ${task.index} backend error: ${err instanceof Error ? err.message : String(err)}`);
+                continue;
+            }
+            // Reload plan to pick up checkbox updates made by Claude
+            reloadPlan(plan);
+            // Run validation commands (global + per-task)
+            const allValidationCommands = [
+                ...plan.validationCommands,
+                ...(task.validationCommands ?? []),
+            ];
+            if (allValidationCommands.length > 0) {
+                logger.log('Running validation commands...', 'task');
+                const summary = await runValidationCommands(allValidationCommands, cwd, config.validation_timeout_ms);
+                for (const result of summary.results) {
+                    if (result.passed) {
+                        logger.log(`  ✓ ${result.command}`, 'task');
+                    }
+                    else {
+                        const label = result.timedOut ? 'TIMEOUT' : `exit ${result.exitCode}`;
+                        logger.error(`  ✗ ${result.command} (${label})`);
+                        if (result.stdout)
+                            logger.error(`    stdout: ${result.stdout.slice(0, 500)}`);
+                        if (result.stderr)
+                            logger.error(`    stderr: ${result.stderr.slice(0, 500)}`);
+                    }
+                }
+                if (!summary.allPassed) {
+                    if (attempt === maxAttempts) {
+                        const hint = await analyzeValidationFailure(summary.results, plan, task, backend, config, logger);
+                        if (hint)
+                            displayHint(logger, hint);
+                        throw new Error(`Task ${task.index} validation failed after ${maxAttempts} attempt(s).`);
+                    }
+                    logger.warn(`Validation failed, will retry...`);
+                    continue;
+                }
+            }
+            // Mark checkboxes complete in plan file (if Claude didn't already)
+            markTaskComplete(plan, task);
+            // Commit
+            if (hasChanges(cwd)) {
+                // Auto-update .gitignore for well-known build artifacts before staging
+                const statusOutput = git(['status', '--porcelain'], cwd).stdout;
+                const addedPatterns = addNoisyArtifactPatterns(statusOutput, cwd);
+                if (addedPatterns.length > 0) {
+                    logger.warn(`Auto-added to .gitignore: ${addedPatterns.join(', ')}`);
+                }
+                const msg = taskCommitMessage(task.index, task.title);
+                stageAndCommit(msg, cwd);
+                logger.log(`Committed: ${msg}`, 'task');
+            }
+            else {
+                logger.warn(`Task ${task.index}: no file changes to commit.`);
+            }
+            return; // success
+        }
+    }
+    async runTaskSession(plan, task) {
+        const { config, backend, logger, defaultBranch, progressFilePath, cwd } = this.opts;
+        const promptTemplate = loadPrompt('task', config);
+        const prompt = expandTemplate(promptTemplate, {
+            PLAN_FILE: path.resolve(plan.filePath),
+            GOAL: plan.goal,
+            PROGRESS_FILE: progressFilePath,
+            DEFAULT_BRANCH: defaultBranch,
+            TASK_INDEX: task.index,
+            TASK_TITLE: task.title,
+            TASK_CONTENT: task.rawText,
+        });
+        await backend.run(prompt, (line) => {
+            if (line.type === 'text' && line.text.trim()) {
+                // Split multi-line text blocks into individual logged lines
+                for (const textLine of line.text.split('\n')) {
+                    if (textLine.trim()) {
+                        logger.log(textLine, 'task');
+                    }
+                }
+            }
+            else if (line.type === 'error') {
+                logger.error(line.text);
+            }
+            else if (line.type === 'debug' && config.debug) {
+                logger.debug(line.text);
+            }
+        });
+    }
+}
+//# sourceMappingURL=task.js.map

package/dist/executor/task.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task.js","sourceRoot":"","sources":["../../src/executor/task.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAK7B,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAClE,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACjF,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AACpC,OAAO,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,wBAAwB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAWnE,MAAM,OAAO,YAAY;IACM;IAA7B,YAA6B,IAAyB;QAAzB,SAAI,GAAJ,IAAI,CAAqB;IAAG,CAAC;IAE1D,KAAK,CAAC,WAAW,CAAC,IAAU,EAAE,IAAU;QACtC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC;QACnD,MAAM,WAAW,GAAG,MAAM,CAAC,gBAAgB,GAAG,CAAC,CAAC;QAEhD,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,WAAW,EAAE,OAAO,EAAE,EAAE,CAAC;YACxD,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;gBAChB,MAAM,CAAC,IAAI,CAAC,iBAAiB,IAAI,CAAC,KAAK,aAAa,OAAO,IAAI,WAAW,MAAM,CAAC,CAAC;YACpF,CAAC;YAED,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YACxC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,uDAAuD;gBACvD,IAAI,GAAG,YAAY,KAAK,IAAI,GAAG,CAAC,IAAI,KAAK,iBAAiB,EAAE,CAAC;oBAC3D,MAAM,GAAG,CAAC;gBACZ,CAAC;gBACD,IAAI,OAAO,KAAK,WAAW;oBAAE,MAAM,GAAG,CAAC;gBACvC,MAAM,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,KAAK,mBAAmB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBACrG,SAAS;YACX,CAAC;YAED,yDAAyD;YACzD,UAAU,CAAC,IAAI,CAAC,CAAC;YAEjB,8CAA8C;YAC9C,MAAM,qBAAqB,GAAG;gBAC5B,GAAG,IAAI,CAAC,kBAAkB;gBAC1B,GAAG,CAAC,IAAI,CAAC,kBAAkB,IAAI,EAAE,CAAC;aACnC,CAAC;YACF,IAAI,qBAAqB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACrC,MAAM,CAAC,GAAG,CAAC,gCAAgC,EAAE,MAAM,CAAC,CAAC;gBACrD,MAAM,OAAO,GAAG,MAAM,qBAAqB,CAAC,qBAAqB,EAAE,GAAG,EAAE,MAAM,CAAC,qBAAqB,CAAC,CAAC;gBAEtG,KAAK,MAAM,MAAM,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;oBACrC,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;wBAClB,MAAM,CAAC,GAAG,CAAC,OAAO,MAAM,CAAC,OAAO,EAAE,EAAE,MAAM,CAAC,CAAC;oBAC9C,CAAC;yBAAM,CAAC;wBACN,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,MAAM,CAAC,QAAQ,EAAE,CAAC;wBACtE,MAAM,CAAC,KAAK,CAAC,OAAO,MAAM,CAAC,OAAO,KAAK,KAAK,GAAG,CAAC,CAAC;wBACjD,IAAI,MAAM,CAAC,MAAM;4BAAE,MAAM,CAAC,KAAK,CAAC,eAAe,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;wBAC9E,IAAI,MAAM,CAAC,MAAM;4BAAE,MAAM,CAAC,KAAK,CAAC,eAAe,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;oBAChF,CAAC;gBACH,CAAC;gBAED,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;oBACvB,IAAI,OAAO,KAAK,WAAW,EAAE,CAAC;wBAC5B,MAAM,IAAI,GAAG,MAAM,wBAAwB,CACzC,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CACrD,CAAC;wBACF,IAAI,IAAI;4BAAE,WAAW,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;wBACpC,MAAM,IAAI,KAAK,CAAC,QAAQ,IAAI,CAAC,KAAK,4BAA4B,WAAW,cAAc,CAAC,CAAC;oBAC3F,CAAC;oBACD,MAAM,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;oBAChD,SAAS;gBACX,CAAC;YACH,CAAC;YAED,mEAAmE;YACnE,gBAAgB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YAE7B,SAAS;YACT,IAAI,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBACpB,uEAAuE;gBACvE,MAAM,YAAY,GAAG,GAAG,CAAC,CAAC,QAAQ,EAAE,aAAa,CAAC,EAAE,GAAG,CAAC,CAAC,MAAM,CAAC;gBAChE,MAAM,aAAa,GAAG,wBAAwB,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC;gBAClE,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAC7B,MAAM,CAAC,IAAI,CAAC,6BAA6B,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;gBACvE,CAAC;gBAED,MAAM,GAAG,GAAG,iBAAiB,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;gBACtD,cAAc,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;gBACzB,MAAM,CAAC,GAAG,CAAC,cAAc,GAAG,EAAE,EAAE,MAAM,CAAC,CAAC;YAC1C,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,KAAK,8BAA8B,CAAC,CAAC;YAChE,CAAC;YAED,OAAO,CAAC,UAAU;QACpB,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,cAAc,CAAC,IAAU,EAAE,IAAU;QACjD,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,gBAAgB,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC;QAEpF,MAAM,cAAc,GAAG,UAAU,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAClD,MAAM,MAAM,GAAG,cAAc,CAAC,cAAc,EAAE;YAC5C,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC;YACtC,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,aAAa,EAAE,gBAAgB;YAC/B,cAAc,EAAE,aAAa;YAC7B,UAAU,EAAE,IAAI,CAAC,KAAK;YACtB,UAAU,EAAE,IAAI,CAAC,KAAK;YACtB,YAAY,EAAE,IAAI,CAAC,OAAO;SAC3B,CAAC,CAAC;QAEH,MAAM,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;YACjC,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;gBAC7C,4DAA4D;gBAC5D,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;oBAC7C,IAAI,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC;wBACpB,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;oBAC/B,CAAC;gBACH,CAAC;YACH,CAAC;iBAAM,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;gBACjC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC1B,CAAC;iBAAM,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;gBACjD,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/executor/validation.d.ts

@@ -0,0 +1,18 @@
+export interface ValidationResult {
+    command: string;
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+    passed: boolean;
+    timedOut?: boolean;
+}
+export interface ValidationSummary {
+    allPassed: boolean;
+    results: ValidationResult[];
+}
+/**
+ * Run all validation commands and return individual and overall results.
+ * All commands run even if earlier ones fail (to collect all errors).
+ */
+export declare function runValidationCommands(commands: string[], cwd?: string, timeout?: number): Promise<ValidationSummary>;
+//# sourceMappingURL=validation.d.ts.map

package/dist/executor/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/executor/validation.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,gBAAgB,EAAE,CAAC;CAC7B;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,EAAE,EAClB,GAAG,GAAE,MAAsB,EAC3B,OAAO,SAAQ,GACd,OAAO,CAAC,iBAAiB,CAAC,CAY5B"}

package/dist/executor/validation.js

@@ -0,0 +1,73 @@
+import { spawn } from 'child_process';
+/**
+ * Run all validation commands and return individual and overall results.
+ * All commands run even if earlier ones fail (to collect all errors).
+ */
+export async function runValidationCommands(commands, cwd = process.cwd(), timeout = 60000) {
+    const results = [];
+    for (const command of commands) {
+        const result = await runCommand(command, cwd, timeout);
+        results.push(result);
+    }
+    return {
+        allPassed: results.every(r => r.passed),
+        results,
+    };
+}
+function runCommand(command, cwd, timeout) {
+    return new Promise((resolve) => {
+        const proc = spawn(command, [], {
+            cwd,
+            shell: true, // use shell so npm/go/dotnet etc. work on Windows
+            stdio: ['ignore', 'pipe', 'pipe'],
+            windowsHide: true,
+        });
+        let stdout = '';
+        let stderr = '';
+        let timedOut = false;
+        const timer = timeout > 0
+            ? setTimeout(() => {
+                timedOut = true;
+                proc.kill();
+            }, timeout)
+            : undefined;
+        proc.stdout.on('data', (chunk) => { stdout += chunk.toString('utf8'); });
+        proc.stderr.on('data', (chunk) => { stderr += chunk.toString('utf8'); });
+        proc.on('close', () => {
+            if (timer)
+                clearTimeout(timer);
+            if (timedOut) {
+                resolve({
+                    command,
+                    exitCode: 1,
+                    stdout: stdout.trim(),
+                    stderr: `timed out after ${timeout}ms`,
+                    passed: false,
+                    timedOut: true,
+                });
+            }
+            else {
+                const exitCode = proc.exitCode ?? 1;
+                resolve({
+                    command,
+                    exitCode,
+                    stdout: stdout.trim(),
+                    stderr: stderr.trim(),
+                    passed: exitCode === 0,
+                });
+            }
+        });
+        proc.on('error', (err) => {
+            if (timer)
+                clearTimeout(timer);
+            resolve({
+                command,
+                exitCode: 1,
+                stdout: '',
+                stderr: `Spawn error: ${err.message}`,
+                passed: false,
+            });
+        });
+    });
+}
+//# sourceMappingURL=validation.js.map

package/dist/executor/validation.js.map

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

package/dist/git/branch.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Derive a branch name from a plan filename.
+ * docs/plans/add-jwt-authentication.md → feature/add-jwt-authentication
+ */
+export declare function branchNameFromPlan(planFile: string): string;
+/**
+ * Create and checkout a new branch, or checkout if it already exists.
+ */
+export declare function createOrCheckoutBranch(branchName: string, cwd?: string): void;
+/**
+ * Get current branch name.
+ */
+export declare function getCurrentBranch(cwd?: string): string;
+/**
+ * Auto-detect the default branch (main, master, or from remote HEAD).
+ * Returns empty string if detection fails.
+ */
+export declare function detectDefaultBranch(cwd?: string): string;
+/**
+ * Get the short commit hash of HEAD.
+ */
+export declare function getShortCommitHash(cwd?: string): string;
+//# sourceMappingURL=branch.d.ts.map

package/dist/git/branch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"branch.d.ts","sourceRoot":"","sources":["../../src/git/branch.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAU3D;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,GAAE,MAAsB,GAAG,IAAI,CAQ5F;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,GAAE,MAAsB,GAAG,MAAM,CAEpE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,GAAE,MAAsB,GAAG,MAAM,CAevE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,GAAE,MAAsB,GAAG,MAAM,CAGtE"}

package/dist/git/branch.js

@@ -0,0 +1,64 @@
+import * as path from 'path';
+import { git, gitRequired } from './git.js';
+/**
+ * Derive a branch name from a plan filename.
+ * docs/plans/add-jwt-authentication.md → feature/add-jwt-authentication
+ */
+export function branchNameFromPlan(planFile) {
+    const base = path.basename(planFile, '.md');
+    // Sanitize: lowercase, replace spaces/underscores with hyphens, strip unsafe chars
+    const sanitized = base
+        .toLowerCase()
+        .replace(/[\s_]+/g, '-')
+        .replace(/[^a-z0-9-]/g, '')
+        .replace(/-+/g, '-')
+        .replace(/^-|-$/g, '');
+    return `feature/${sanitized}`;
+}
+/**
+ * Create and checkout a new branch, or checkout if it already exists.
+ */
+export function createOrCheckoutBranch(branchName, cwd = process.cwd()) {
+    // Check if branch exists locally
+    const existing = git(['branch', '--list', branchName], cwd);
+    if (existing.stdout.includes(branchName)) {
+        gitRequired(['checkout', branchName], cwd);
+    }
+    else {
+        gitRequired(['checkout', '-b', branchName], cwd);
+    }
+}
+/**
+ * Get current branch name.
+ */
+export function getCurrentBranch(cwd = process.cwd()) {
+    return gitRequired(['rev-parse', '--abbrev-ref', 'HEAD'], cwd);
+}
+/**
+ * Auto-detect the default branch (main, master, or from remote HEAD).
+ * Returns empty string if detection fails.
+ */
+export function detectDefaultBranch(cwd = process.cwd()) {
+    // Try to read from remote HEAD symref
+    const remoteHead = git(['symbolic-ref', 'refs/remotes/origin/HEAD'], cwd);
+    if (remoteHead.success && remoteHead.stdout) {
+        const m = remoteHead.stdout.match(/refs\/remotes\/origin\/(.+)/);
+        if (m)
+            return m[1];
+    }
+    // Fallback: check if 'main' or 'master' exists
+    for (const candidate of ['main', 'master']) {
+        const r = git(['rev-parse', '--verify', candidate], cwd);
+        if (r.success)
+            return candidate;
+    }
+    return 'main';
+}
+/**
+ * Get the short commit hash of HEAD.
+ */
+export function getShortCommitHash(cwd = process.cwd()) {
+    const result = git(['rev-parse', '--short', 'HEAD'], cwd);
+    return result.success ? result.stdout : 'unknown';
+}
+//# sourceMappingURL=branch.js.map

package/dist/git/branch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"branch.js","sourceRoot":"","sources":["../../src/git/branch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE5C;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAAgB;IACjD,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAC5C,mFAAmF;IACnF,MAAM,SAAS,GAAG,IAAI;SACnB,WAAW,EAAE;SACb,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC;SAC1B,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC;SACnB,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IACzB,OAAO,WAAW,SAAS,EAAE,CAAC;AAChC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,UAAkB,EAAE,MAAc,OAAO,CAAC,GAAG,EAAE;IACpF,iCAAiC;IACjC,MAAM,QAAQ,GAAG,GAAG,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,UAAU,CAAC,EAAE,GAAG,CAAC,CAAC;IAC5D,IAAI,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QACzC,WAAW,CAAC,CAAC,UAAU,EAAE,UAAU,CAAC,EAAE,GAAG,CAAC,CAAC;IAC7C,CAAC;SAAM,CAAC;QACN,WAAW,CAAC,CAAC,UAAU,EAAE,IAAI,EAAE,UAAU,CAAC,EAAE,GAAG,CAAC,CAAC;IACnD,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAc,OAAO,CAAC,GAAG,EAAE;IAC1D,OAAO,WAAW,CAAC,CAAC,WAAW,EAAE,cAAc,EAAE,MAAM,CAAC,EAAE,GAAG,CAAC,CAAC;AACjE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAc,OAAO,CAAC,GAAG,EAAE;IAC7D,sCAAsC;IACtC,MAAM,UAAU,GAAG,GAAG,CAAC,CAAC,cAAc,EAAE,0BAA0B,CAAC,EAAE,GAAG,CAAC,CAAC;IAC1E,IAAI,UAAU,CAAC,OAAO,IAAI,UAAU,CAAC,MAAM,EAAE,CAAC;QAC5C,MAAM,CAAC,GAAG,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;QACjE,IAAI,CAAC;YAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IACrB,CAAC;IAED,+CAA+C;IAC/C,KAAK,MAAM,SAAS,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC;QAC3C,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,WAAW,EAAE,UAAU,EAAE,SAAS,CAAC,EAAE,GAAG,CAAC,CAAC;QACzD,IAAI,CAAC,CAAC,OAAO;YAAE,OAAO,SAAS,CAAC;IAClC,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAc,OAAO,CAAC,GAAG,EAAE;IAC5D,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,WAAW,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,GAAG,CAAC,CAAC;IAC1D,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;AACpD,CAAC"}

package/dist/git/commit.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Stage all changes and create a commit.
+ */
+export declare function stageAndCommit(message: string, cwd?: string): void;
+/**
+ * Format a task completion commit message.
+ */
+export declare function taskCommitMessage(taskIndex: string, taskTitle: string): string;
+/**
+ * Format a review fix commit message.
+ */
+export declare function reviewCommitMessage(phase: 'first' | 'second', iteration: number): string;
+/**
+ * Push a branch to origin.
+ */
+export declare function pushBranch(branchName: string, cwd?: string): void;
+/**
+ * Check if there are any staged or unstaged changes to commit.
+ */
+export declare function hasChanges(cwd?: string): boolean;
+//# sourceMappingURL=commit.d.ts.map

package/dist/git/commit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"commit.d.ts","sourceRoot":"","sources":["../../src/git/commit.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,GAAE,MAAsB,GAAG,IAAI,CAGjF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAE9E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,QAAQ,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAKxF;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,GAAE,MAAsB,GAAG,IAAI,CAEhF;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,GAAG,GAAE,MAAsB,GAAG,OAAO,CAG/D"}

package/dist/git/commit.js

@@ -0,0 +1,37 @@
+import { gitRequired } from './git.js';
+/**
+ * Stage all changes and create a commit.
+ */
+export function stageAndCommit(message, cwd = process.cwd()) {
+    gitRequired(['add', '-A'], cwd);
+    gitRequired(['commit', '-m', message], cwd);
+}
+/**
+ * Format a task completion commit message.
+ */
+export function taskCommitMessage(taskIndex, taskTitle) {
+    return `feat: Task ${taskIndex} — ${taskTitle} [maestro]`;
+}
+/**
+ * Format a review fix commit message.
+ */
+export function reviewCommitMessage(phase, iteration) {
+    if (phase === 'first') {
+        return `fix(review): first review pass ${iteration} [maestro]`;
+    }
+    return `fix(review): second review pass ${iteration} [maestro]`;
+}
+/**
+ * Push a branch to origin.
+ */
+export function pushBranch(branchName, cwd = process.cwd()) {
+    gitRequired(['push', '-u', 'origin', branchName], cwd);
+}
+/**
+ * Check if there are any staged or unstaged changes to commit.
+ */
+export function hasChanges(cwd = process.cwd()) {
+    const result = gitRequired(['status', '--porcelain'], cwd);
+    return result.trim().length > 0;
+}
+//# sourceMappingURL=commit.js.map

package/dist/git/commit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commit.js","sourceRoot":"","sources":["../../src/git/commit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEvC;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,OAAe,EAAE,MAAc,OAAO,CAAC,GAAG,EAAE;IACzE,WAAW,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,GAAG,CAAC,CAAC;IAChC,WAAW,CAAC,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,GAAG,CAAC,CAAC;AAC9C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,SAAiB,EAAE,SAAiB;IACpE,OAAO,cAAc,SAAS,MAAM,SAAS,YAAY,CAAC;AAC5D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAyB,EAAE,SAAiB;IAC9E,IAAI,KAAK,KAAK,OAAO,EAAE,CAAC;QACtB,OAAO,kCAAkC,SAAS,YAAY,CAAC;IACjE,CAAC;IACD,OAAO,mCAAmC,SAAS,YAAY,CAAC;AAClE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,UAAkB,EAAE,MAAc,OAAO,CAAC,GAAG,EAAE;IACxE,WAAW,CAAC,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,CAAC,EAAE,GAAG,CAAC,CAAC;AACzD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,MAAc,OAAO,CAAC,GAAG,EAAE;IACpD,MAAM,MAAM,GAAG,WAAW,CAAC,CAAC,QAAQ,EAAE,aAAa,CAAC,EAAE,GAAG,CAAC,CAAC;IAC3D,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;AAClC,CAAC"}

package/dist/git/diff.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Get the full diff of the current branch against the base branch.
+ * Used as context for review prompts.
+ */
+export declare function getBranchDiff(baseBranch: string, cwd?: string): string;
+/**
+ * Get the diff of uncommitted changes (working tree + staged).
+ * Used on subsequent review iterations.
+ */
+export declare function getUncommittedDiff(cwd?: string): string;
+/**
+ * Get a stat summary of changed files for logging.
+ */
+export declare function getDiffStat(baseBranch: string, cwd?: string): string;
+//# sourceMappingURL=diff.d.ts.map

package/dist/git/diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../src/git/diff.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,GAAE,MAAsB,GAAG,MAAM,CAGrF;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,GAAE,MAAsB,GAAG,MAAM,CAItE;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,GAAE,MAAsB,GAAG,MAAM,CAGnF"}

package/dist/git/diff.js

@@ -0,0 +1,26 @@
+import { git } from './git.js';
+/**
+ * Get the full diff of the current branch against the base branch.
+ * Used as context for review prompts.
+ */
+export function getBranchDiff(baseBranch, cwd = process.cwd()) {
+    const result = git(['diff', `${baseBranch}...HEAD`], cwd);
+    return result.stdout;
+}
+/**
+ * Get the diff of uncommitted changes (working tree + staged).
+ * Used on subsequent review iterations.
+ */
+export function getUncommittedDiff(cwd = process.cwd()) {
+    const staged = git(['diff', '--cached'], cwd);
+    const unstaged = git(['diff'], cwd);
+    return [staged.stdout, unstaged.stdout].filter(Boolean).join('\n');
+}
+/**
+ * Get a stat summary of changed files for logging.
+ */
+export function getDiffStat(baseBranch, cwd = process.cwd()) {
+    const result = git(['diff', '--stat', `${baseBranch}...HEAD`], cwd);
+    return result.stdout;
+}
+//# sourceMappingURL=diff.js.map

package/dist/git/diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.js","sourceRoot":"","sources":["../../src/git/diff.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAE/B;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,UAAkB,EAAE,MAAc,OAAO,CAAC,GAAG,EAAE;IAC3E,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,MAAM,EAAE,GAAG,UAAU,SAAS,CAAC,EAAE,GAAG,CAAC,CAAC;IAC1D,OAAO,MAAM,CAAC,MAAM,CAAC;AACvB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAc,OAAO,CAAC,GAAG,EAAE;IAC5D,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,MAAM,EAAE,UAAU,CAAC,EAAE,GAAG,CAAC,CAAC;IAC9C,MAAM,QAAQ,GAAG,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,CAAC;IACpC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACrE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,UAAkB,EAAE,MAAc,OAAO,CAAC,GAAG,EAAE;IACzE,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,UAAU,SAAS,CAAC,EAAE,GAAG,CAAC,CAAC;IACpE,OAAO,MAAM,CAAC,MAAM,CAAC;AACvB,CAAC"}

package/dist/git/git.d.ts

@@ -0,0 +1,9 @@
+export interface GitResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+    success: boolean;
+}
+export declare function git(args: string[], cwd?: string): GitResult;
+export declare function gitRequired(args: string[], cwd?: string): string;
+//# sourceMappingURL=git.d.ts.map

package/dist/git/git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../src/git/git.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,wBAAgB,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,GAAE,MAAsB,GAAG,SAAS,CAY1E;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,GAAE,MAAsB,GAAG,MAAM,CAM/E"}

package/dist/git/git.js

@@ -0,0 +1,20 @@
+import { spawnSync } from 'child_process';
+export function git(args, cwd = process.cwd()) {
+    const result = spawnSync('git', args, {
+        cwd,
+        encoding: 'utf8',
+        windowsHide: true,
+    });
+    const stdout = (result.stdout ?? '').trim();
+    const stderr = (result.stderr ?? '').trim();
+    const exitCode = result.status ?? 1;
+    return { stdout, stderr, exitCode, success: exitCode === 0 };
+}
+export function gitRequired(args, cwd = process.cwd()) {
+    const result = git(args, cwd);
+    if (!result.success) {
+        throw new Error(`git ${args.join(' ')} failed (exit ${result.exitCode}): ${result.stderr || result.stdout}`);
+    }
+    return result.stdout;
+}
+//# sourceMappingURL=git.js.map

package/dist/git/git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../../src/git/git.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAS1C,MAAM,UAAU,GAAG,CAAC,IAAc,EAAE,MAAc,OAAO,CAAC,GAAG,EAAE;IAC7D,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE;QACpC,GAAG;QACH,QAAQ,EAAE,MAAM;QAChB,WAAW,EAAE,IAAI;KAClB,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC5C,MAAM,MAAM,GAAG,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC5C,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,IAAI,CAAC,CAAC;IAEpC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,KAAK,CAAC,EAAE,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,IAAc,EAAE,MAAc,OAAO,CAAC,GAAG,EAAE;IACrE,MAAM,MAAM,GAAG,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC9B,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,iBAAiB,MAAM,CAAC,QAAQ,MAAM,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;IAC/G,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC;AACvB,CAAC"}

package/dist/git/gitignore.d.ts

@@ -0,0 +1,2 @@
+export declare function addNoisyArtifactPatterns(porcelainOutput: string, cwd: string): string[];
+//# sourceMappingURL=gitignore.d.ts.map

package/dist/git/gitignore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitignore.d.ts","sourceRoot":"","sources":["../../src/git/gitignore.ts"],"names":[],"mappings":"AAgCA,wBAAgB,wBAAwB,CAAC,eAAe,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CA2CvF"}

package/dist/git/gitignore.js

@@ -0,0 +1,66 @@
+import * as fs from 'fs';
+import * as path from 'path';
+const NOISY_PATTERNS = [
+    'node_modules/', // npm/yarn/pnpm packages
+    '__pycache__/', // Python bytecode cache
+    '*.pyc', // Python compiled files
+    '.venv/', // Python virtual environment
+    'venv/', // Python virtual environment (alternate name)
+    '.DS_Store', // macOS Finder metadata
+    'Thumbs.db', // Windows thumbnail cache
+    '*.tsbuildinfo', // TypeScript incremental build info
+];
+function normalize(s) {
+    return s.endsWith('/') ? s.slice(0, -1) : s;
+}
+function matchesPattern(entry, pattern) {
+    if (pattern.startsWith('*.')) {
+        // Glob: *.ext
+        const ext = pattern.slice(1); // e.g. ".pyc"
+        return path.basename(entry).endsWith(ext);
+    }
+    else if (pattern.endsWith('/')) {
+        // Directory pattern
+        return normalize(entry) === normalize(pattern);
+    }
+    else {
+        // Exact match on basename
+        return path.basename(entry) === pattern;
+    }
+}
+export function addNoisyArtifactPatterns(porcelainOutput, cwd) {
+    // Extract untracked paths from `git status --porcelain`
+    const untracked = porcelainOutput
+        .split('\n')
+        .filter(line => line.startsWith('?? '))
+        .map(line => line.slice(3).trim());
+    // Find which NOISY_PATTERNS are triggered by any untracked path
+    const triggered = NOISY_PATTERNS.filter(pattern => untracked.some(entry => matchesPattern(entry, pattern)));
+    if (triggered.length === 0)
+        return [];
+    // Read existing .gitignore
+    const gitignorePath = path.join(cwd, '.gitignore');
+    let existing = '';
+    try {
+        existing = fs.readFileSync(gitignorePath, 'utf8');
+    }
+    catch {
+        // File doesn't exist yet — that's fine
+    }
+    // Build set of normalized existing entries
+    const existingNormalized = new Set(existing
+        .split('\n')
+        .map(line => line.trim())
+        .filter(line => line.length > 0 && !line.startsWith('#'))
+        .map(normalize));
+    // Filter to patterns not already covered
+    const toAdd = triggered.filter(p => !existingNormalized.has(normalize(p)));
+    if (toAdd.length === 0)
+        return [];
+    // Append block to .gitignore
+    const prefix = existing.length > 0 && !existing.endsWith('\n') ? '\n' : '';
+    const block = `${prefix}\n# Auto-added by maestro — build artifacts\n${toAdd.join('\n')}\n`;
+    fs.appendFileSync(gitignorePath, block, 'utf8');
+    return toAdd;
+}
+//# sourceMappingURL=gitignore.js.map

package/dist/git/gitignore.js.map

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

package/dist/git/worktree.d.ts

@@ -0,0 +1,3 @@
+export declare function createWorktree(branchName: string, cwd: string): string;
+export declare function removeWorktree(worktreePath: string, cwd: string): void;
+//# sourceMappingURL=worktree.d.ts.map

package/dist/git/worktree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree.d.ts","sourceRoot":"","sources":["../../src/git/worktree.ts"],"names":[],"mappings":"AAIA,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAWtE;AAED,wBAAgB,cAAc,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAEtE"}

package/dist/git/worktree.js

@@ -0,0 +1,17 @@
+import * as path from 'path';
+import * as fs from 'fs';
+import { git, gitRequired } from './git.js';
+export function createWorktree(branchName, cwd) {
+    const worktreePath = path.join(cwd, '.maestro', 'worktrees', branchName.replace(/\//g, '-'));
+    fs.mkdirSync(path.dirname(worktreePath), { recursive: true });
+    // Try create new branch in worktree; fall back to checkout if branch exists
+    const result = git(['worktree', 'add', '-b', branchName, worktreePath], cwd);
+    if (!result.success) {
+        gitRequired(['worktree', 'add', worktreePath, branchName], cwd);
+    }
+    return worktreePath;
+}
+export function removeWorktree(worktreePath, cwd) {
+    git(['worktree', 'remove', '--force', worktreePath], cwd);
+}
+//# sourceMappingURL=worktree.js.map

package/dist/git/worktree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree.js","sourceRoot":"","sources":["../../src/git/worktree.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE5C,MAAM,UAAU,cAAc,CAAC,UAAkB,EAAE,GAAW;IAC5D,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,UAAU,EAAE,WAAW,EACzD,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;IAClC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE9D,4EAA4E;IAC5E,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,YAAY,CAAC,EAAE,GAAG,CAAC,CAAC;IAC7E,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,WAAW,CAAC,CAAC,UAAU,EAAE,KAAK,EAAE,YAAY,EAAE,UAAU,CAAC,EAAE,GAAG,CAAC,CAAC;IAClE,CAAC;IACD,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,YAAoB,EAAE,GAAW;IAC9D,GAAG,CAAC,CAAC,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,YAAY,CAAC,EAAE,GAAG,CAAC,CAAC;AAC5D,CAAC"}

package/dist/main.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=main.d.ts.map

package/dist/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":""}