@miller-tech/uap 1.150.0 → 1.150.1

package/dist/delivery/task-workspace.js

@@ -0,0 +1,305 @@
+/**
+ * Task Workspaces — git-worktree isolation for PARALLEL orchestrated tasks.
+ *
+ * The blackboard orchestrator can dispatch independent READY tasks
+ * concurrently (ATG dependency-aware parallel dispatch), but deliver's
+ * production runTask was not concurrency-safe: every loop mutated the same
+ * working tree and gates raced. This module gives each task its own detached
+ * git worktree — like the explorer's candidate workspaces, with one crucial
+ * difference: an orchestrated mission accumulates UNCOMMITTED work in the
+ * main tree (each merged task's files), so a bare worktree of HEAD would be a
+ * stale baseline from the second wave on. `acquire` therefore SYNCS the main
+ * tree's uncommitted state into the worktree and freezes it as a detached
+ * baseline commit; `mergeBack` applies only the task's own delta (diff vs
+ * that baseline) to the main tree.
+ *
+ * Merge-backs must be SERIALIZED by the caller (deliver holds a merge lock):
+ * the main tree changes one task at a time. A conflicting delta returns
+ * `{ok:false}` — the caller fails the task, and the orchestrator's minimal
+ * repair retries it in a FRESH workspace seeded with the updated baseline,
+ * so conflicts resolve themselves through the ATG repair path.
+ *
+ * Everything is fail-soft: manager construction returns null off-git;
+ * `acquire` returns null on any error (caller falls back to serialized
+ * in-tree execution); `cleanup` never throws.
+ *
+ * Known, accepted limitations (same class as candidate-workspace):
+ * - gitignored-but-required files (.env, local fixtures) are NOT seeded
+ *   (`--exclude-standard`) — a gate depending on them can fail here while
+ *   passing in-tree;
+ * - under parallel dispatch the mission's aggregate telemetry (history,
+ *   HALO traces, finalFeedback) interleaves across concurrent loops;
+ * - `parallelTasks` should be sized to CPU cores, not inference slots: the
+ *   model-slot lease bounds model calls, but concurrent GATE runs (npm
+ *   test/build per worktree) have no governor.
+ */
+import { execFileSync } from 'child_process';
+import { copyFileSync, existsSync, lstatSync, mkdirSync, mkdtempSync, readdirSync, readlinkSync, rmSync, statSync, symlinkSync, } from 'fs';
+import { tmpdir } from 'os';
+import { dirname, join } from 'path';
+const HARD_PARALLEL_CEILING = 8;
+/** Live workspaces for the exit sweep (a killed run must not leak /tmp trees). */
+const liveWorkspaces = new Set();
+let exitSweepInstalled = false;
+/** Remove abandoned uap-task-* tmp trees from crashed earlier runs (>24h old). */
+function sweepStaleWorkspaces() {
+    try {
+        const base = tmpdir();
+        const cutoff = Date.now() - 24 * 60 * 60 * 1000;
+        for (const name of readdirSync(base)) {
+            if (!name.startsWith('uap-task-'))
+                continue;
+            const p = join(base, name);
+            try {
+                if (statSync(p).mtimeMs < cutoff)
+                    rmSync(p, { recursive: true, force: true });
+            }
+            catch {
+                // best-effort
+            }
+        }
+    }
+    catch {
+        // best-effort
+    }
+}
+/**
+ * Clamp the `.uap.json` `deliver.parallelTasks` value to [1, 8]. Config-only
+ * by design (no env override) — see the concurrency notes in
+ * task-orchestrator.ts: an env knob would let one exported variable flip
+ * every deliver run into parallel execution.
+ */
+export function resolveParallelTasks(raw) {
+    const n = Number(raw);
+    if (!Number.isFinite(n) || n <= 1)
+        return 1;
+    return Math.min(Math.floor(n), HARD_PARALLEL_CEILING);
+}
+function git(cwd, args, input, timeoutMs = 120_000) {
+    return execFileSync('git', args, {
+        cwd,
+        encoding: 'utf-8',
+        timeout: timeoutMs,
+        // Binary deltas (assets, lockfiles) easily exceed node's 1 MiB default;
+        // an ENOBUFS here would misreport as a merge conflict.
+        maxBuffer: 64 * 1024 * 1024,
+        ...(input !== undefined ? { input } : {}),
+        stdio: [input !== undefined ? 'pipe' : 'ignore', 'pipe', 'pipe'],
+        // Never inherit a poisoned GIT_DIR from a hook environment.
+        env: { ...process.env, GIT_DIR: undefined, GIT_WORK_TREE: undefined, GIT_INDEX_FILE: undefined },
+    });
+}
+/** Tail of a git error, preferring stderr (execFileSync buries the detail there). */
+function gitErrorTail(err) {
+    const stderr = err.stderr;
+    const msg = err instanceof Error ? err.message : String(err);
+    return `${msg} ${stderr ?? ''}`.replace(/\s+/g, ' ').trim().slice(0, 300);
+}
+/** NUL-separated `git ls-files` output → clean path list. */
+function zList(out) {
+    return out.split('\0').map((s) => s.trim()).filter((s) => s.length > 0);
+}
+/**
+ * Build a task-workspace manager for `projectRoot`, or null when the project
+ * is not a git repo. Unlike the explorer's provider, a DIRTY tree is fine —
+ * that is the normal mid-mission state — because acquire syncs it.
+ */
+export function createTaskWorkspaceManager(projectRoot) {
+    try {
+        if (git(projectRoot, ['rev-parse', '--is-inside-work-tree']).trim() !== 'true')
+            return null;
+        git(projectRoot, ['rev-parse', 'HEAD']); // unborn HEAD ⇒ no baseline to worktree
+        git(projectRoot, ['worktree', 'prune']);
+        sweepStaleWorkspaces();
+    }
+    catch {
+        return null;
+    }
+    // A killed run leaks /tmp trees AND their worktree registrations (prune is
+    // a no-op while the dir exists). Live workspaces are tracked module-wide
+    // and swept on process exit; ancient orphans are swept at construction.
+    if (!exitSweepInstalled) {
+        exitSweepInstalled = true;
+        process.once('exit', () => {
+            for (const ws of [...liveWorkspaces]) {
+                try {
+                    ws.cleanup();
+                }
+                catch {
+                    // best-effort
+                }
+            }
+        });
+    }
+    const acquire = (taskId) => {
+        let dir = null;
+        try {
+            dir = mkdtempSync(join(tmpdir(), 'uap-task-'));
+            const root = join(dir, 'tree');
+            git(projectRoot, ['worktree', 'add', '--detach', root, 'HEAD']);
+            // Gates need dependencies; share the main tree's node_modules by
+            // symlink (same convention + caveats as candidate-workspace).
+            const mainModules = join(projectRoot, 'node_modules');
+            const wtModules = join(root, 'node_modules');
+            if (existsSync(mainModules) && !existsSync(wtModules)) {
+                try {
+                    symlinkSync(mainModules, wtModules, 'junction');
+                }
+                catch {
+                    // gates may still work without it
+                }
+            }
+            // Seed the worktree with the main tree's CURRENT uncommitted state:
+            // modified + untracked + STAGED files copied in, deletions mirrored.
+            // (Staged paths matter because a user may start the mission with a
+            // pre-staged index; our own merge-backs unstage themselves below.)
+            // This is what makes wave-2+ baselines include earlier tasks' merged
+            // (uncommitted) output.
+            const changed = [
+                ...new Set([
+                    ...zList(git(projectRoot, ['ls-files', '-mo', '--exclude-standard', '-z'])),
+                    ...zList(git(projectRoot, ['diff', '--cached', '--name-only', '--no-renames', '-z'])),
+                ]),
+            ];
+            for (const rel of changed) {
+                const from = join(projectRoot, rel);
+                let st;
+                try {
+                    st = lstatSync(from);
+                }
+                catch {
+                    continue; // deleted since listing — the deletion passes handle it
+                }
+                const to = join(root, rel);
+                mkdirSync(dirname(to), { recursive: true });
+                if (st.isSymbolicLink()) {
+                    // Recreate symlinks as symlinks: copyFileSync would FOLLOW the link
+                    // and materialize its target's content into the model's workspace.
+                    try {
+                        rmSync(to, { force: true });
+                        symlinkSync(readlinkSync(from), to);
+                    }
+                    catch {
+                        // an unreproducible link is skipped, not followed
+                    }
+                }
+                else if (st.isFile()) {
+                    copyFileSync(from, to);
+                }
+            }
+            // Deletions: unstaged (ls-files -d) AND staged (`git rm` shows only in
+            // the cached diff as D — without this pass the worktree resurrects the
+            // file from HEAD and merge-back can re-add it to the main tree).
+            const deleted = [
+                ...new Set([
+                    ...zList(git(projectRoot, ['ls-files', '-d', '-z'])),
+                    ...zList(git(projectRoot, ['diff', '--cached', '--name-only', '--no-renames', '--diff-filter=D', '-z'])),
+                ]),
+            ];
+            for (const rel of deleted) {
+                try {
+                    rmSync(join(root, rel), { force: true });
+                }
+                catch {
+                    // best-effort mirror of a deletion
+                }
+            }
+            // Freeze the seeded state as the task's BASELINE commit (detached — no
+            // branch moves). mergeBack diffs against this, so only the task's own
+            // work travels back. Identity flags keep this working on repos/CI with
+            // no git user configured.
+            git(root, ['add', '-A']);
+            git(root, [
+                '-c', 'user.email=uap-task@local',
+                '-c', 'user.name=uap-task-workspace',
+                'commit', '--allow-empty', '--no-verify', '-m', `uap task baseline: ${taskId}`,
+            ]);
+            const mergeBack = (isBlocked) => {
+                try {
+                    git(root, ['add', '-A']);
+                    // --no-renames: a task-side rename must travel as delete+add so the
+                    // file list (and any unstage below) covers BOTH paths.
+                    const files = zList(git(root, ['diff', '--cached', '--name-only', '--no-renames', '-z', 'HEAD']));
+                    if (files.length === 0)
+                        return { ok: true, files: [] };
+                    const blocked = isBlocked ? files.filter((f) => isBlocked(f)) : [];
+                    if (blocked.length > 0) {
+                        return { ok: false, files: [], reason: `delta touches protected file(s): ${blocked.slice(0, 5).join(', ')}` };
+                    }
+                    const patch = git(root, ['diff', '--cached', '--binary', '--no-renames', 'HEAD']);
+                    // Plain apply first: it is worktree-only (no index coupling), and the
+                    // seeded baseline guarantees the preimage matches whenever no sibling
+                    // touched the same files — INCLUDING dirty/untracked targets in the
+                    // main tree, which is the normal wave-2 state. `--3way` alone would
+                    // imply --index and systematically fail exactly those targets.
+                    try {
+                        git(projectRoot, ['apply', '--whitespace=nowarn'], patch);
+                        return { ok: true, files };
+                    }
+                    catch {
+                        // Preimage drift (a sibling merged first). --3way can resolve
+                        // non-overlapping drift via the shared object store (git >= 2.9.3
+                        // also gives us its path-safety checks); it stages what it
+                        // applies, so unstage the merged paths after (chunked — argv).
+                        git(projectRoot, ['apply', '--3way', '--whitespace=nowarn'], patch);
+                        try {
+                            for (let i = 0; i < files.length; i += 100) {
+                                git(projectRoot, ['reset', '-q', 'HEAD', '--', ...files.slice(i, i + 100)]);
+                            }
+                        }
+                        catch {
+                            // staged leftovers are re-caught by the next acquire's cached-diff sync
+                        }
+                        return { ok: true, files };
+                    }
+                }
+                catch (err) {
+                    return { ok: false, files: [], reason: gitErrorTail(err) };
+                }
+            };
+            const cleanup = () => {
+                liveWorkspaces.delete(workspace);
+                try {
+                    git(projectRoot, ['worktree', 'remove', '--force', root]);
+                }
+                catch {
+                    // fall through to raw dir removal
+                }
+                try {
+                    if (dir)
+                        rmSync(dir, { recursive: true, force: true });
+                }
+                catch {
+                    // best-effort
+                }
+                try {
+                    git(projectRoot, ['worktree', 'prune']);
+                }
+                catch {
+                    // best-effort
+                }
+            };
+            const workspace = { root, mergeBack, cleanup };
+            liveWorkspaces.add(workspace);
+            return workspace;
+        }
+        catch {
+            try {
+                if (dir)
+                    rmSync(dir, { recursive: true, force: true });
+            }
+            catch {
+                // best-effort
+            }
+            try {
+                git(projectRoot, ['worktree', 'prune']);
+            }
+            catch {
+                // best-effort
+            }
+            return null;
+        }
+    };
+    return { acquire };
+}
+//# sourceMappingURL=task-workspace.js.map

package/dist/delivery/task-workspace.js.map

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

package/docs/reference/CONFIGURATION.md

@@ -87,6 +87,15 @@ Top level: `version`, `project`, `memory`, `worktree`, `costOptimization`,
 | `UAP_AGENT_ID` | Agent id for MCP execute | `mcp-<pid>` |
 | `UAP_MAX_PARALLEL` | Override max parallel workers | auto |
 | `UAP_PARALLEL` | `false` disables parallelism | enabled |
+
+### `.uap.json` `deliver` section
+
+| Key | What it does | Default |
+|---|---|---|
+| `deliver.orchestrate` | Blackboard orchestration for decomposed missions (`"on"`/`"off"`) | `"on"` (preflight seeds it) |
+| `deliver.epics` | Epic controller outer loop (`"on"`/`"off"`) | `"on"` (preflight seeds it) |
+| `deliver.parallelTasks` | Worktree-isolated parallel dispatch: independent READY orchestrator tasks run concurrently, each convergence loop + its gates in a detached git worktree seeded with the mission's current state; deltas merge back serially, and a merge conflict fails the task into the minimal-repair retry. Clamped to 1–8. **Config-only by design — no env override** (an exported variable must never silently parallelize every run). | `1` (sequential) |
+| `deliver.autoSizeEpics` | Context auto-size for epic sessions (`false`/`"off"` disables) | enabled |
 | `UAP_BENCHMARK_MODE` | `true` enables benchmark template mode | off |
 | `UAP_BENCHMARK_PARALLEL` | Parallel model count in benchmarks | — |
 | `UAP_SNAPSHOT_DIR` | Base dir for `--keep-best` snapshots (absolute path) | `~/.cache/uap/snapshots` |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@miller-tech/uap",
-  "version": "1.150.0",
+  "version": "1.150.1",
   "description": "Autonomous AI agent memory system with CLAUDE.md protocol enforcement",
   "type": "module",
   "main": "dist/index.js",