@promptwheel/cli 0.6.0

package/dist/lib/exclusion-index.js

@@ -0,0 +1,249 @@
+/**
+ * Exclusion index — discovers what artifact patterns a project generates
+ * by scanning for indicator files (lockfiles, configs, build manifests)
+ * and writes any patterns missing from .gitignore to the worktree's
+ * .git/info/exclude so `git status` filters them natively.
+ *
+ * Detection is organic: the project's own files tell us what frameworks
+ * and languages are in use, and therefore what artifact directories will
+ * exist.  The INDICATOR_MAP below is a knowledge base that drives
+ * detection — it only fires when we actually find the indicator file in
+ * the worktree, not unconditionally.
+ *
+ * As a second layer, solo-ticket.ts captures a baseline `git status`
+ * snapshot after dep install (before the agent runs).  Anything present
+ * in the baseline is subtracted from the post-agent status, so even
+ * artifacts the indicator map doesn't know about are filtered out.
+ *
+ * Note: the enterprise worker path (src/worker/) uses `git diff --name-only`
+ * which only shows tracked changes and is not affected by untracked
+ * artifacts.  This module is only used by the CLI solo path.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+// ─── Knowledge base ───────────────────────────────────────────────
+/**
+ * Map from indicator filenames to the artifact patterns that framework generates.
+ * When we find an indicator file in the worktree, we know those artifact paths
+ * may appear and should be excluded from scope validation.
+ */
+const INDICATOR_MAP = {
+    // ── Node.js / JavaScript / TypeScript ──
+    'package.json': ['node_modules/'],
+    'next.config.js': ['.next/'],
+    'next.config.mjs': ['.next/'],
+    'next.config.ts': ['.next/'],
+    'nuxt.config.ts': ['.nuxt/', '.output/'],
+    'nuxt.config.js': ['.nuxt/', '.output/'],
+    'svelte.config.js': ['.svelte-kit/'],
+    'turbo.json': ['.turbo/'],
+    'vite.config.ts': ['dist/'],
+    'vite.config.js': ['dist/'],
+    'rollup.config.js': ['dist/'],
+    'rollup.config.mjs': ['dist/'],
+    'webpack.config.js': ['dist/', 'build/'],
+    'webpack.config.ts': ['dist/', 'build/'],
+    '.parcelrc': ['.parcel-cache/'],
+    'tsconfig.json': ['*.tsbuildinfo'],
+    // ── Python ──
+    'pyproject.toml': ['__pycache__/', '*.pyc', '.venv/', 'venv/', '.pytest_cache/', '.mypy_cache/', '.ruff_cache/'],
+    'requirements.txt': ['__pycache__/', '*.pyc', '.venv/', 'venv/', '.eggs/', '*.egg-info/'],
+    'Pipfile': ['__pycache__/', '*.pyc', '.venv/'],
+    'setup.py': ['__pycache__/', '*.pyc', '*.egg-info/', 'dist/', 'build/'],
+    'setup.cfg': ['__pycache__/', '*.pyc', '*.egg-info/'],
+    // ── Rust ──
+    'Cargo.toml': ['target/'],
+    // ── Go ──
+    'go.mod': ['vendor/'],
+    // ── PHP ──
+    'composer.json': ['vendor/'],
+    // ── Ruby ──
+    'Gemfile': ['.bundle/', 'vendor/bundle/'],
+    // ── Elixir ──
+    'mix.exs': ['_build/', 'deps/', '.elixir_ls/'],
+    // ── Java / Kotlin / Scala ──
+    'pom.xml': ['target/'],
+    'build.gradle': ['build/', '.gradle/'],
+    'build.gradle.kts': ['build/', '.gradle/'],
+    // ── .NET / C# ──
+    // *.csproj and *.sln handled via extension check below
+    // ── Swift ──
+    'Package.swift': ['.build/', '.swiftpm/'],
+    // ── Dart / Flutter ──
+    'pubspec.yaml': ['.dart_tool/', 'build/'],
+    // ── Coverage / testing tools ──
+    'jest.config.js': ['coverage/'],
+    'jest.config.ts': ['coverage/'],
+    'vitest.config.ts': ['coverage/'],
+    'vitest.config.js': ['coverage/'],
+    'pytest.ini': ['.pytest_cache/'],
+    '.nycrc': ['coverage/', '.nyc_output/'],
+    '.nycrc.json': ['coverage/', '.nyc_output/'],
+    // ── PromptWheel internals ──
+    '.promptwheel': ['.promptwheel/'],
+};
+/**
+ * Extension-based indicators for project types where the config filename
+ * isn't fixed (e.g. *.csproj, *.sln for .NET).
+ */
+const EXTENSION_INDICATORS = {
+    '.csproj': ['bin/', 'obj/'],
+    '.fsproj': ['bin/', 'obj/'],
+    '.sln': ['bin/', 'obj/'],
+};
+// ─── Derived constants ────────────────────────────────────────────
+/**
+ * Directories to skip when scanning for indicators.
+ * Derived automatically from INDICATOR_MAP + EXTENSION_INDICATORS values
+ * so there is no separate list to maintain — if an artifact pattern is
+ * added above, the scanner will skip it during traversal too.
+ */
+const SCAN_SKIP = /* @__PURE__ */ (() => {
+    // VCS internals are always skipped even though they aren't in the map.
+    const dirs = new Set(['.git', '.hg', '.svn']);
+    const allPatterns = [
+        ...Object.values(INDICATOR_MAP).flat(),
+        ...Object.values(EXTENSION_INDICATORS).flat(),
+    ];
+    for (const p of allPatterns) {
+        // 'node_modules/' → 'node_modules', '.next/' → '.next'
+        if (p.endsWith('/'))
+            dirs.add(p.slice(0, -1));
+    }
+    return dirs;
+})();
+/** Marker written to the exclude file so we can detect prior runs. */
+const EXCLUDE_MARKER = '# Auto-discovered by PromptWheel exclusion index';
+// ─── Internal helpers ─────────────────────────────────────────────
+/**
+ * Scan a directory tree for indicator files and collect the artifact
+ * patterns they imply.
+ */
+function scanIndicators(dir, patterns, depth, maxDepth) {
+    if (depth > maxDepth)
+        return;
+    let entries;
+    try {
+        entries = fs.readdirSync(dir, { withFileTypes: true });
+    }
+    catch {
+        return;
+    }
+    for (const entry of entries) {
+        const name = entry.name;
+        // Check exact-name indicators
+        if (INDICATOR_MAP[name]) {
+            for (const p of INDICATOR_MAP[name])
+                patterns.add(p);
+        }
+        // Check extension-based indicators
+        for (const ext of Object.keys(EXTENSION_INDICATORS)) {
+            if (name.endsWith(ext)) {
+                for (const p of EXTENSION_INDICATORS[ext])
+                    patterns.add(p);
+                break;
+            }
+        }
+        // Recurse into subdirectories, skipping artifact dirs and hidden dirs
+        if (entry.isDirectory() && !SCAN_SKIP.has(name) && !name.startsWith('.')) {
+            scanIndicators(path.join(dir, name), patterns, depth + 1, maxDepth);
+        }
+    }
+}
+/**
+ * Resolve the git common directory for a worktree.
+ *
+ * Git reads `info/exclude` from the *common* dir — not the per-worktree
+ * dir.  For a normal repo `.git/` IS the common dir.  For a linked
+ * worktree `.git` is a file pointing to `.git/worktrees/<name>/`; the
+ * common dir is its grandparent (`.git/`).
+ *
+ * Exported for testing.
+ */
+export function resolveGitDir(worktreePath) {
+    const gitPath = path.join(worktreePath, '.git');
+    let stat;
+    try {
+        stat = fs.statSync(gitPath);
+    }
+    catch {
+        return gitPath; // Doesn't exist yet — return default path
+    }
+    // Normal repo — .git is already the common dir
+    if (stat.isDirectory())
+        return gitPath;
+    // Linked worktree: .git is a file containing "gitdir: /path/to/..."
+    // e.g. "gitdir: /repo/.git/worktrees/my-ticket"
+    const content = fs.readFileSync(gitPath, 'utf-8').trim();
+    const match = content.match(/^gitdir:\s+(.+)$/);
+    if (match) {
+        const worktreeGitDir = path.isAbsolute(match[1])
+            ? match[1]
+            : path.resolve(worktreePath, match[1]);
+        // Walk up to the common dir: .git/worktrees/<name> → .git/
+        // The worktree gitdir is always <common>/worktrees/<name>
+        const worktreesParent = path.dirname(worktreeGitDir);
+        if (path.basename(worktreesParent) === 'worktrees') {
+            return path.dirname(worktreesParent);
+        }
+        // Fallback: return the worktree gitdir itself
+        return worktreeGitDir;
+    }
+    return gitPath;
+}
+// ─── Public API ───────────────────────────────────────────────────
+/**
+ * Build an exclusion index for a worktree by scanning the project tree
+ * for indicator files and writing any inferred artifact patterns to
+ * `.git/info/exclude`.
+ *
+ * Call this after worktree creation but before installing dependencies
+ * or running the agent. After this, `git status --porcelain` natively
+ * filters out all discovered artifact directories.
+ *
+ * Idempotent — safe to call multiple times on the same worktree
+ * (e.g. on ticket retry).  Subsequent calls are no-ops.
+ *
+ * @param worktreePath - Absolute path to the worktree root
+ * @param maxDepth - How deep to scan for indicators (default 4, sufficient for monorepos)
+ * @returns List of patterns written to the exclude file (empty on no-op)
+ */
+export function buildExclusionIndex(worktreePath, maxDepth = 4) {
+    const patterns = new Set();
+    // Scan the worktree for indicator files
+    scanIndicators(worktreePath, patterns, 0, maxDepth);
+    if (patterns.size === 0)
+        return [];
+    const patternList = [...patterns].sort();
+    // Write to .git/info/exclude (worktree-local, never committed)
+    try {
+        const gitDir = resolveGitDir(worktreePath);
+        const infoDir = path.join(gitDir, 'info');
+        if (!fs.existsSync(infoDir)) {
+            fs.mkdirSync(infoDir, { recursive: true });
+        }
+        const excludePath = path.join(infoDir, 'exclude');
+        // Idempotency: if we've already written, don't append again
+        try {
+            const existing = fs.readFileSync(excludePath, 'utf-8');
+            if (existing.includes(EXCLUDE_MARKER)) {
+                return patternList;
+            }
+        }
+        catch {
+            // File doesn't exist yet — that's fine, we'll create it
+        }
+        const block = [
+            '',
+            EXCLUDE_MARKER,
+            ...patternList,
+            '',
+        ].join('\n');
+        fs.appendFileSync(excludePath, block);
+    }
+    catch {
+        // Non-fatal: scope check will still run, just might flag extra files
+    }
+    return patternList;
+}
+//# sourceMappingURL=exclusion-index.js.map

package/dist/lib/exclusion-index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exclusion-index.js","sourceRoot":"","sources":["../../src/lib/exclusion-index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,qEAAqE;AAErE;;;;GAIG;AACH,MAAM,aAAa,GAA6B;IAC9C,0CAA0C;IAC1C,cAAc,EAAS,CAAC,eAAe,CAAC;IACxC,gBAAgB,EAAO,CAAC,QAAQ,CAAC;IACjC,iBAAiB,EAAM,CAAC,QAAQ,CAAC;IACjC,gBAAgB,EAAO,CAAC,QAAQ,CAAC;IACjC,gBAAgB,EAAO,CAAC,QAAQ,EAAE,UAAU,CAAC;IAC7C,gBAAgB,EAAO,CAAC,QAAQ,EAAE,UAAU,CAAC;IAC7C,kBAAkB,EAAK,CAAC,cAAc,CAAC;IACvC,YAAY,EAAW,CAAC,SAAS,CAAC;IAClC,gBAAgB,EAAO,CAAC,OAAO,CAAC;IAChC,gBAAgB,EAAO,CAAC,OAAO,CAAC;IAChC,kBAAkB,EAAK,CAAC,OAAO,CAAC;IAChC,mBAAmB,EAAI,CAAC,OAAO,CAAC;IAChC,mBAAmB,EAAI,CAAC,OAAO,EAAE,QAAQ,CAAC;IAC1C,mBAAmB,EAAI,CAAC,OAAO,EAAE,QAAQ,CAAC;IAC1C,WAAW,EAAY,CAAC,gBAAgB,CAAC;IACzC,eAAe,EAAQ,CAAC,eAAe,CAAC;IAExC,eAAe;IACf,gBAAgB,EAAO,CAAC,cAAc,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,cAAc,CAAC;IACrH,kBAAkB,EAAK,CAAC,cAAc,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,aAAa,CAAC;IAC5F,SAAS,EAAc,CAAC,cAAc,EAAE,OAAO,EAAE,QAAQ,CAAC;IAC1D,UAAU,EAAa,CAAC,cAAc,EAAE,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,QAAQ,CAAC;IAClF,WAAW,EAAY,CAAC,cAAc,EAAE,OAAO,EAAE,aAAa,CAAC;IAE/D,aAAa;IACb,YAAY,EAAW,CAAC,SAAS,CAAC;IAElC,WAAW;IACX,QAAQ,EAAe,CAAC,SAAS,CAAC;IAElC,YAAY;IACZ,eAAe,EAAQ,CAAC,SAAS,CAAC;IAElC,aAAa;IACb,SAAS,EAAc,CAAC,UAAU,EAAE,gBAAgB,CAAC;IAErD,eAAe;IACf,SAAS,EAAc,CAAC,SAAS,EAAE,OAAO,EAAE,aAAa,CAAC;IAE1D,8BAA8B;IAC9B,SAAS,EAAc,CAAC,SAAS,CAAC;IAClC,cAAc,EAAS,CAAC,QAAQ,EAAE,UAAU,CAAC;IAC7C,kBAAkB,EAAK,CAAC,QAAQ,EAAE,UAAU,CAAC;IAE7C,kBAAkB;IAClB,uDAAuD;IAEvD,cAAc;IACd,eAAe,EAAQ,CAAC,SAAS,EAAE,WAAW,CAAC;IAE/C,uBAAuB;IACvB,cAAc,EAAS,CAAC,aAAa,EAAE,QAAQ,CAAC;IAEhD,iCAAiC;IACjC,gBAAgB,EAAO,CAAC,WAAW,CAAC;IACpC,gBAAgB,EAAO,CAAC,WAAW,CAAC;IACpC,kBAAkB,EAAK,CAAC,WAAW,CAAC;IACpC,kBAAkB,EAAK,CAAC,WAAW,CAAC;IACpC,YAAY,EAAW,CAAC,gBAAgB,CAAC;IACzC,QAAQ,EAAe,CAAC,WAAW,EAAE,cAAc,CAAC;IACpD,aAAa,EAAU,CAAC,WAAW,EAAE,cAAc,CAAC;IAEpD,8BAA8B;IAC9B,cAAc,EAAU,CAAC,eAAe,CAAC;CAC1C,CAAC;AAEF;;;GAGG;AACH,MAAM,oBAAoB,GAA6B;IACrD,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;IAC3B,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;IAC3B,MAAM,EAAK,CAAC,MAAM,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,qEAAqE;AAErE;;;;;GAKG;AACH,MAAM,SAAS,GAAgB,eAAe,CAAC,CAAC,GAAG,EAAE;IACnD,uEAAuE;IACvE,MAAM,IAAI,GAAG,IAAI,GAAG,CAAS,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;IACtD,MAAM,WAAW,GAAG;QAClB,GAAG,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,IAAI,EAAE;QACtC,GAAG,MAAM,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC,IAAI,EAAE;KAC9C,CAAC;IACF,KAAK,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC;QAC5B,uDAAuD;QACvD,IAAI,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IAChD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC,CAAC,EAAE,CAAC;AAEL,sEAAsE;AACtE,MAAM,cAAc,GAAG,kDAAkD,CAAC;AAE1E,qEAAqE;AAErE;;;GAGG;AACH,SAAS,cAAc,CACrB,GAAW,EACX,QAAqB,EACrB,KAAa,EACb,QAAgB;IAEhB,IAAI,KAAK,GAAG,QAAQ;QAAE,OAAO;IAE7B,IAAI,OAAoB,CAAC;IACzB,IAAI,CAAC;QACH,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IACzD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;IACT,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;QAExB,8BAA8B;QAC9B,IAAI,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,KAAK,MAAM,CAAC,IAAI,aAAa,CAAC,IAAI,CAAC;gBAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACvD,CAAC;QAED,mCAAmC;QACnC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,oBAAoB,CAAC,EAAE,CAAC;YACpD,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBACvB,KAAK,MAAM,CAAC,IAAI,oBAAoB,CAAC,GAAG,CAAC;oBAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;gBAC3D,MAAM;YACR,CAAC;QACH,CAAC;QAED,sEAAsE;QACtE,IAAI,KAAK,CAAC,WAAW,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACzE,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,QAAQ,EAAE,KAAK,GAAG,CAAC,EAAE,QAAQ,CAAC,CAAC;QACtE,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,aAAa,CAAC,YAAoB;IAChD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IAEhD,IAAI,IAAc,CAAC;IACnB,IAAI,CAAC;QACH,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC,CAAC,0CAA0C;IAC5D,CAAC;IAED,+CAA+C;IAC/C,IAAI,IAAI,CAAC,WAAW,EAAE;QAAE,OAAO,OAAO,CAAC;IAEvC,oEAAoE;IACpE,gDAAgD;IAChD,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;IACzD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;IAChD,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,cAAc,GAAG,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAC9C,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;YACV,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAEzC,2DAA2D;QAC3D,0DAA0D;QAC1D,MAAM,eAAe,GAAG,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;QACrD,IAAI,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,KAAK,WAAW,EAAE,CAAC;YACnD,OAAO,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;QACvC,CAAC;QAED,8CAA8C;QAC9C,OAAO,cAAc,CAAC;IACxB,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,qEAAqE;AAErE;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,mBAAmB,CAAC,YAAoB,EAAE,QAAQ,GAAG,CAAC;IACpE,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;IAEnC,wCAAwC;IACxC,cAAc,CAAC,YAAY,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,CAAC,CAAC;IAEpD,IAAI,QAAQ,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEnC,MAAM,WAAW,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;IAEzC,+DAA+D;IAC/D,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,aAAa,CAAC,YAAY,CAAC,CAAC;QAC3C,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC1C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5B,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7C,CAAC;QAED,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;QAElD,4DAA4D;QAC5D,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,EAAE,CAAC,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;YACvD,IAAI,QAAQ,CAAC,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC;gBACtC,OAAO,WAAW,CAAC;YACrB,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,wDAAwD;QAC1D,CAAC;QAED,MAAM,KAAK,GAAG;YACZ,EAAE;YACF,cAAc;YACd,GAAG,WAAW;YACd,EAAE;SACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAEb,EAAE,CAAC,cAAc,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,qEAAqE;IACvE,CAAC;IAED,OAAO,WAAW,CAAC;AACrB,CAAC"}

package/dist/lib/exec.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Node.js ExecRunner implementation
+ *
+ * Spawns commands, captures output to artifact files,
+ * handles timeout/cancellation, and returns structured results.
+ */
+import type { ExecRunner, ExecSpec, ExecResult } from '@promptwheel/core';
+export interface NodeExecRunnerOptions {
+    defaultMaxLogBytes?: number;
+    defaultTailBytes?: number;
+    killGraceMs?: number;
+}
+export declare class NodeExecRunner implements ExecRunner {
+    private readonly defaultMaxLogBytes;
+    private readonly defaultTailBytes;
+    private readonly killGraceMs;
+    constructor(opts?: NodeExecRunnerOptions);
+    run(spec: ExecSpec): Promise<ExecResult>;
+}
+/**
+ * Create a Node exec runner with default options
+ */
+export declare function createExecRunner(opts?: NodeExecRunnerOptions): ExecRunner;
+//# sourceMappingURL=exec.d.ts.map

package/dist/lib/exec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exec.d.ts","sourceRoot":"","sources":["../../src/lib/exec.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EACV,UAAU,EACV,QAAQ,EACR,UAAU,EAGX,MAAM,mBAAmB,CAAC;AAE3B,MAAM,WAAW,qBAAqB;IACpC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AA0FD,qBAAa,cAAe,YAAW,UAAU;IAC/C,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAS;IAC5C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;gBAEzB,IAAI,GAAE,qBAA0B;IAMtC,GAAG,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC;CA8N/C;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,CAAC,EAAE,qBAAqB,GAAG,UAAU,CAEzE"}

package/dist/lib/exec.js

@@ -0,0 +1,295 @@
+/**
+ * Node.js ExecRunner implementation
+ *
+ * Spawns commands, captures output to artifact files,
+ * handles timeout/cancellation, and returns structured results.
+ */
+import { spawn } from 'node:child_process';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+/**
+ * Configuration constants for ExecRunner
+ */
+/** Maximum bytes to write per output stream (stdout/stderr). Prevents runaway disk usage. */
+const DEFAULT_MAX_LOG_BYTES = 2_000_000; // 2MB per stream
+/** Bytes to retain in memory for the tail buffer, used for fast UI display. */
+const DEFAULT_TAIL_BYTES = 65_536; // 64KB tail for fast UI
+/** Grace period in ms between SIGTERM and SIGKILL when killing a child process. */
+const DEFAULT_KILL_GRACE_MS = 1_500;
+/** Maximum length for sanitized file name segments. Prevents overly long artifact paths. */
+const MAX_FILE_SEGMENT_LENGTH = 64;
+function isProbablyAbsolute(p) {
+    return path.isAbsolute(p);
+}
+function sanitizeFileSegment(s) {
+    return s
+        .trim()
+        .toLowerCase()
+        .replace(/[^a-z0-9._-]+/g, '-')
+        .replace(/-+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .slice(0, MAX_FILE_SEGMENT_LENGTH) || 'step';
+}
+function pad2(n) {
+    return n < 10 ? `0${n}` : `${n}`;
+}
+function appendTail(current, chunk, tailBytes) {
+    if (tailBytes <= 0)
+        return Buffer.alloc(0);
+    if (chunk.length >= tailBytes) {
+        return Buffer.from(chunk.subarray(chunk.length - tailBytes));
+    }
+    if (current.length === 0)
+        return Buffer.from(chunk);
+    const combined = Buffer.concat([current, chunk]);
+    if (combined.length <= tailBytes)
+        return combined;
+    return Buffer.from(combined.subarray(combined.length - tailBytes));
+}
+async function ensureDir(absDir) {
+    await fs.promises.mkdir(absDir, { recursive: true });
+}
+function writeCapped(stream, chunk, state, maxBytes) {
+    if (maxBytes <= 0) {
+        state.truncated = true;
+        return;
+    }
+    if (state.truncated)
+        return;
+    const remaining = maxBytes - state.bytesWritten;
+    if (remaining <= 0) {
+        state.truncated = true;
+        return;
+    }
+    if (chunk.length <= remaining) {
+        stream.write(chunk);
+        state.bytesWritten += chunk.length;
+        return;
+    }
+    // partial write, then truncate
+    stream.write(chunk.subarray(0, remaining));
+    state.bytesWritten += remaining;
+    state.truncated = true;
+}
+function waitForStreamClose(stream) {
+    return new Promise((resolve, reject) => {
+        stream.once('close', () => resolve());
+        stream.once('error', (err) => reject(err));
+    });
+}
+export class NodeExecRunner {
+    defaultMaxLogBytes;
+    defaultTailBytes;
+    killGraceMs;
+    constructor(opts = {}) {
+        this.defaultMaxLogBytes = opts.defaultMaxLogBytes ?? DEFAULT_MAX_LOG_BYTES;
+        this.defaultTailBytes = opts.defaultTailBytes ?? DEFAULT_TAIL_BYTES;
+        this.killGraceMs = opts.killGraceMs ?? DEFAULT_KILL_GRACE_MS;
+    }
+    async run(spec) {
+        const startedAtMs = Date.now();
+        const maxLogBytes = spec.maxLogBytes ?? this.defaultMaxLogBytes;
+        const tailBytes = spec.tailBytes ?? this.defaultTailBytes;
+        const repoRoot = spec.repoRoot;
+        const artifactsDirAbs = isProbablyAbsolute(spec.artifactsDir)
+            ? spec.artifactsDir
+            : path.join(repoRoot, spec.artifactsDir);
+        // Layout: .promptwheel/artifacts/<runId>/attempt-<n>/
+        const attemptDirAbs = path.join(artifactsDirAbs, spec.runId, `attempt-${spec.attempt}`);
+        await ensureDir(attemptDirAbs);
+        const safeName = sanitizeFileSegment(spec.stepName);
+        const base = `${pad2(spec.ordinal)}-${safeName}`;
+        const stdoutAbs = path.join(attemptDirAbs, `${base}.stdout.log`);
+        const stderrAbs = path.join(attemptDirAbs, `${base}.stderr.log`);
+        const stdoutPathDb = isProbablyAbsolute(spec.artifactsDir)
+            ? stdoutAbs
+            : path.join(spec.artifactsDir, spec.runId, `attempt-${spec.attempt}`, `${base}.stdout.log`);
+        const stderrPathDb = isProbablyAbsolute(spec.artifactsDir)
+            ? stderrAbs
+            : path.join(spec.artifactsDir, spec.runId, `attempt-${spec.attempt}`, `${base}.stderr.log`);
+        const stdoutStream = fs.createWriteStream(stdoutAbs, { flags: 'w' });
+        const stderrStream = fs.createWriteStream(stderrAbs, { flags: 'w' });
+        let stdoutTail = Buffer.alloc(0);
+        let stderrTail = Buffer.alloc(0);
+        const stdoutState = { bytesWritten: 0, truncated: false };
+        const stderrState = { bytesWritten: 0, truncated: false };
+        let timedOut = false;
+        let canceled = false;
+        let errorMessage;
+        let exitCode = null;
+        let signal = null;
+        let pid = null;
+        let timeoutHandle;
+        const endAndWaitStreams = async () => {
+            try {
+                stdoutStream.end();
+            }
+            catch { /* ignore */ }
+            try {
+                stderrStream.end();
+            }
+            catch { /* ignore */ }
+            await Promise.allSettled([
+                waitForStreamClose(stdoutStream),
+                waitForStreamClose(stderrStream),
+            ]);
+        };
+        const makeOutput = (stream) => {
+            const isStdout = stream === 'stdout';
+            const absPath = isStdout ? stdoutAbs : stderrAbs;
+            const pathDb = isStdout ? stdoutPathDb : stderrPathDb;
+            const bytes = isStdout ? stdoutState.bytesWritten : stderrState.bytesWritten;
+            const truncated = isStdout ? stdoutState.truncated : stderrState.truncated;
+            const tailBuf = isStdout ? stdoutTail : stderrTail;
+            return {
+                absPath,
+                path: pathDb,
+                bytes,
+                truncated,
+                tail: tailBuf.toString('utf8'),
+            };
+        };
+        const finalize = async (status) => {
+            const endedAtMs = Date.now();
+            await endAndWaitStreams();
+            return {
+                status,
+                exitCode,
+                signal,
+                errorMessage,
+                pid,
+                startedAtMs,
+                endedAtMs,
+                durationMs: Math.max(0, endedAtMs - startedAtMs),
+                stdout: makeOutput('stdout'),
+                stderr: makeOutput('stderr'),
+            };
+        };
+        let child;
+        const killChild = (_why) => {
+            if (!child || child.killed)
+                return;
+            try {
+                child.kill('SIGTERM');
+            }
+            catch { /* ignore */ }
+            // Escalate after grace period
+            setTimeout(() => {
+                if (!child || child.killed)
+                    return;
+                try {
+                    child.kill('SIGKILL');
+                }
+                catch { /* ignore */ }
+            }, this.killGraceMs);
+        };
+        const onAbort = () => {
+            canceled = true;
+            errorMessage = errorMessage ?? 'Canceled';
+            killChild('canceled');
+        };
+        // Shared cleanup: clears timeout, removes abort listener, then finalizes
+        const cleanupAndFinalize = async (status) => {
+            if (timeoutHandle)
+                clearTimeout(timeoutHandle);
+            if (spec.signal)
+                spec.signal.removeEventListener('abort', onAbort);
+            return await finalize(status);
+        };
+        try {
+            const env = { ...process.env, ...(spec.env ?? {}) };
+            const cwd = spec.cwd ?? repoRoot;
+            // If already aborted, short-circuit
+            if (spec.signal?.aborted) {
+                canceled = true;
+                errorMessage = 'Canceled (signal already aborted)';
+                return await finalize('canceled');
+            }
+            if (spec.signal) {
+                spec.signal.addEventListener('abort', onAbort, { once: true });
+            }
+            child = spawn(spec.cmd, {
+                cwd,
+                env,
+                shell: spec.shell ?? true,
+                stdio: ['ignore', 'pipe', 'pipe'],
+            });
+            pid = child.pid ?? null;
+            // Timeout handling
+            if (spec.timeoutMs && spec.timeoutMs > 0) {
+                timeoutHandle = setTimeout(() => {
+                    timedOut = true;
+                    errorMessage = errorMessage ?? `Timed out after ${spec.timeoutMs}ms`;
+                    killChild('timeout');
+                }, spec.timeoutMs);
+            }
+            // Stream piping + tail capture
+            if (child.stdout) {
+                child.stdout.on('data', (chunk) => {
+                    const buf = Buffer.from(chunk);
+                    spec.onStdoutChunk?.(buf);
+                    stdoutTail = appendTail(stdoutTail, buf, tailBytes);
+                    writeCapped(stdoutStream, buf, stdoutState, maxLogBytes);
+                });
+            }
+            if (child.stderr) {
+                child.stderr.on('data', (chunk) => {
+                    const buf = Buffer.from(chunk);
+                    spec.onStderrChunk?.(buf);
+                    stderrTail = appendTail(stderrTail, buf, tailBytes);
+                    writeCapped(stderrStream, buf, stderrState, maxLogBytes);
+                });
+            }
+            // Spawn error (ENOENT, permissions, etc.)
+            const spawnErrorPromise = new Promise((resolve) => {
+                child.once('error', async (err) => {
+                    errorMessage = errorMessage ?? err.message;
+                    exitCode = null;
+                    signal = null;
+                    killChild('error');
+                    resolve(await cleanupAndFinalize('failed'));
+                });
+            });
+            // Normal close path
+            const closePromise = new Promise((resolve) => {
+                child.once('close', async (code, sig) => {
+                    exitCode = code;
+                    signal = sig ?? null;
+                    let status;
+                    if (canceled)
+                        status = 'canceled';
+                    else if (timedOut)
+                        status = 'timeout';
+                    else if (code === 0)
+                        status = 'success';
+                    else
+                        status = 'failed';
+                    resolve(await cleanupAndFinalize(status));
+                });
+            });
+            // Write stream error (disk issue)
+            const writeErrorPromise = new Promise((resolve) => {
+                const onWriteError = async (err) => {
+                    errorMessage = errorMessage ?? `Artifact write error: ${err.message}`;
+                    killChild('error');
+                    resolve(await cleanupAndFinalize('failed'));
+                };
+                stdoutStream.once('error', onWriteError);
+                stderrStream.once('error', onWriteError);
+            });
+            // First one wins
+            return await Promise.race([spawnErrorPromise, closePromise, writeErrorPromise]);
+        }
+        catch (err) {
+            errorMessage = errorMessage ?? (err instanceof Error ? err.message : String(err));
+            return await cleanupAndFinalize('failed');
+        }
+    }
+}
+/**
+ * Create a Node exec runner with default options
+ */
+export function createExecRunner(opts) {
+    return new NodeExecRunner(opts);
+}
+//# sourceMappingURL=exec.js.map

package/dist/lib/exec.js.map

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

package/dist/lib/execution-backends/claude.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Claude Code CLI execution backend
+ */
+import type { ClaudeResult, ExecutionBackend } from './types.js';
+export declare class ClaudeExecutionBackend implements ExecutionBackend {
+    readonly name = "claude";
+    run(opts: {
+        worktreePath: string;
+        prompt: string;
+        timeoutMs: number;
+        verbose: boolean;
+        onProgress: (msg: string) => void;
+        onRawOutput?: (chunk: string) => void;
+    }): Promise<ClaudeResult>;
+}
+/**
+ * Run Claude Code CLI
+ */
+export declare function runClaude(opts: {
+    worktreePath: string;
+    prompt: string;
+    timeoutMs: number;
+    verbose: boolean;
+    onProgress: (msg: string) => void;
+    onRawOutput?: (chunk: string) => void;
+}): Promise<ClaudeResult>;
+//# sourceMappingURL=claude.d.ts.map

package/dist/lib/execution-backends/claude.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude.d.ts","sourceRoot":"","sources":["../../../src/lib/execution-backends/claude.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAgCjE,qBAAa,sBAAuB,YAAW,gBAAgB;IAC7D,QAAQ,CAAC,IAAI,YAAY;IAEzB,GAAG,CAAC,IAAI,EAAE;QACR,YAAY,EAAE,MAAM,CAAC;QACrB,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,OAAO,CAAC;QACjB,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;QAClC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;KACvC,GAAG,OAAO,CAAC,YAAY,CAAC;CAG1B;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,IAAI,EAAE;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACvC,GAAG,OAAO,CAAC,YAAY,CAAC,CAwIxB"}