smol-symphony 0.2.0 → 0.3.1

package/dist/shell/main-orchestrator.js

@@ -0,0 +1,120 @@
+// FCIS rewrite — OrchestratorLoop deps construction (shell). Sliced out of
+// src/shell/main.ts so the composition root stays under the max-lines budget.
+//
+// Builds the OrchestratorLoopDeps bundle: the pure scheduler reducer (tick) is
+// injected as the loop's reducer; the loop owns the live running/claimed/retry
+// maps and drives the returned effects through the interpreter. `runWorker` (the
+// per-attempt runner pipeline) is owned by the runner slice and wired through the
+// root once it's stood up; until then a dispatch claims its slot then frees it,
+// exercising the reducer + slot accounting end-to-end without a live worker.
+//
+// It imports NO core (only the root may) — the pure reducer + the candidate
+// selector + the token-fold trio arrive injected as `OrchestratorCore`.
+//
+// Shell rule: imports from src/types/** ONLY (+ shell sibling type surfaces).
+import { NoHoldingStateError } from '../types/errors.js';
+/**
+ * Project the live config into the pure TickConfig the scheduler reducer folds
+ * over. The shell pre-resolves derived routing (spawn) + lowercased role sets so
+ * core never walks the config tree for derived data (REF buildReloadHandler).
+ *
+ * The role sets + the holding-state pick are derived by the CANONICAL core fns
+ * (`activeStateNames` / `terminalStateNames` / `pickHoldingState`), injected on
+ * `core`, rather than re-scanned by hand here (§4a). `pickHoldingState` THROWS
+ * `NoHoldingStateError` when none is declared; we catch that and project
+ * `holdingState: null` — the circuit-breaker then retains the claim instead of
+ * moving the issue (REF: pickHoldingState throwing → retain).
+ */
+export function buildTickConfig(cfg, core, 
+// The managed prebuilt-image store ref for this host (issue 224), or null when the
+// host arch has no published asset. Gated on `gondolin.managed_image` below so it
+// only rides the readiness path when the managed source is the active one.
+managedImageRef = null) {
+    const lc = (names) => new Set(names.map((n) => n.toLowerCase()));
+    let holdingState;
+    try {
+        holdingState = core.pickHoldingState(cfg.states);
+    }
+    catch (err) {
+        if (!(err instanceof NoHoldingStateError))
+            throw err;
+        holdingState = null;
+    }
+    return {
+        pollIntervalMs: cfg.polling.interval_ms,
+        staticCap: cfg.agent.max_concurrent_agents,
+        memoryAdmissionEnabled: cfg.agent.memory_admission_enabled,
+        hostMemoryReserveMib: cfg.agent.host_memory_reserve_mib,
+        perVmMib: cfg.gondolin.mem_mib,
+        maxRetryBackoffMs: cfg.agent.max_retry_backoff_ms,
+        circuitBreakerThreshold: cfg.agent.circuit_breaker_threshold,
+        activeStates: lc(core.activeStateNames(cfg.states)),
+        terminalStates: lc(core.terminalStateNames(cfg.states)),
+        states: cfg.states,
+        spawn: core.deriveSpawnRouting(cfg.states),
+        holdingState,
+        // The auto-convert-on-reconcile OCI ref (issue 206); the loop reads it to
+        // compute the image-readiness projection it folds onto the snapshot. The
+        // escape-hatch `image` rides alongside so core's gate mirrors runtime precedence.
+        ociImage: cfg.gondolin.oci_image,
+        image: cfg.gondolin.image,
+        // The managed source (issue 224) rides the same readiness path as oci_image, but
+        // only when it's the active source — an explicit `image`/`oci_image` keeps
+        // `managed_image` false in parse, so this is null whenever one of those wins.
+        managedImageRef: cfg.gondolin.managed_image ? managedImageRef : null,
+    };
+}
+/** Build the OrchestratorLoopDeps from the injected core fns + the live ports. */
+export function buildOrchestratorDeps(opts) {
+    const { core, ports, readConfig } = opts;
+    return {
+        tick: core.tick,
+        interpreter: ports.interpreter,
+        timers: ports.timer,
+        memProbe: ports.mem,
+        clock: ports.clock,
+        readConfig,
+        // ONE tracker read → the pure core picks the active-but-not-terminal
+        // candidates (core/issue/parse.ts:selectCandidateIssues). null on any IO miss.
+        fetchCandidates: async () => {
+            try {
+                const { raw, root } = await ports.tracker.loadAllIssues();
+                return { issues: core.selectCandidateIssues(raw, readConfig().states), root };
+            }
+            catch {
+                return null;
+            }
+        },
+        // The pure cancel-on-move decider shared with the operator-move reducer (issue 211).
+        reconcileIssue: core.decideReconcileForIssue,
+        // FRESH per-running tracker view across ALL states — the candidate scan above
+        // excludes an issue moved to a holding/terminal state, so the move-reconcile net
+        // needs its own by-id read. Keyed by canonical id; null on an IO miss so the loop
+        // skips the reconcile rather than spuriously terminating a live attempt.
+        fetchRunningViews: async (ids) => {
+            if (ids.length === 0)
+                return new Map();
+            try {
+                const { raw } = await ports.tracker.loadAllIssues();
+                return new Map(core.selectIssuesByIds(raw, [...ids]).map((i) => [i.id, i]));
+            }
+            catch {
+                return null;
+            }
+        },
+        runWorker: opts.runWorker ?? (async () => undefined),
+        buildEntry: opts.buildEntry,
+        tokenFold: core.tokenFold,
+        stall: { detectStall: core.detectStall, stallTimeoutMs: opts.stallTimeoutMs },
+        // Pure failure backoff pinned at the core base, so the loop's re-poll-failed
+        // path cannot fork the policy core uses for the same attempt (§4a).
+        backoff: (attempt, maxBackoffMs) => core.backoffDelayMs(attempt, core.failureBaseMs, maxBackoffMs),
+        // The poll-timer id + sleep-cycle spawn actor are the core constants, injected so
+        // the loop matches the ids/actors core stamps on its Effects (§4b — no hardcoded twin).
+        pollTimerId: core.pollTimerId,
+        spawnActor: core.spawnActor,
+        ensureImage: opts.ensureImage,
+        probeImage: opts.probeImage,
+    };
+}
+//# sourceMappingURL=main-orchestrator.js.map

package/dist/shell/main-orchestrator.js.map

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

package/dist/shell/main-preflight.js

@@ -0,0 +1,43 @@
+// FCIS rewrite — early-exit preflight subcommands (kind: shell helper).
+//
+// Sliced out of the composition root so the root keeps only its core-wiring under
+// the max-lines budget. Owns the subcommands that DON'T enter the orchestrator
+// graph: doctor (delegated to the injected runner) and a missing workflow file
+// (scaffold-on-interactive-serve, else fail). Ported 1:1 from REF handlePreflight.
+//
+// Shell rule: imports from src/types/** ONLY. The doctor runner is INJECTED by the
+// root (the one file allowed to import core).
+import path from 'node:path';
+import process from 'node:process';
+import { existsSync } from 'node:fs';
+import { promptYesNo, isInteractive } from './interp/tty.js';
+import { scaffoldWorkflow, scaffoldSkill } from './main-scaffold.js';
+/**
+ * Handle the early-exit subcommands that don't enter the orchestrator graph.
+ * Returns only on the happy path of serve/reconcile against an existing workflow;
+ * every other branch exits the process. Ported from REF handlePreflight.
+ */
+export async function handlePreflight(cli, workflowPath, deps) {
+    if (cli.subcommand === 'doctor') {
+        process.exit(await deps.runDoctor(workflowPath, cli.port));
+    }
+    if (!existsSync(workflowPath)) {
+        // Prompt only on the bare `serve` path (reconcile needs an existing workflow).
+        // A confirmed yes writes the bundled minimal scaffold then exits 0 so the
+        // operator can fill in gondolin.* before relaunching.
+        if (cli.subcommand === 'serve' && isInteractive()) {
+            const accept = await promptYesNo(`WORKFLOW.yaml not found at ${workflowPath}.\nScaffold a starter workflow file here? [Y/n] `);
+            if (accept && (await scaffoldWorkflow(workflowPath))) {
+                // Best-effort onboarding sugar: also install the issue-filing skill next
+                // to the new WORKFLOW.yaml. A failure / already-present skill must NOT
+                // block the workflow scaffold or the relaunch (scaffoldSkill never
+                // throws), so exit 0 regardless.
+                await scaffoldSkill(path.dirname(workflowPath));
+                process.exit(0);
+            }
+        }
+        process.stderr.write(`error: workflow file not found: ${workflowPath}\n`);
+        process.exit(2);
+    }
+}
+//# sourceMappingURL=main-preflight.js.map

package/dist/shell/main-preflight.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main-preflight.js","sourceRoot":"","sources":["../../src/shell/main-preflight.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,EAAE;AACF,kFAAkF;AAClF,+EAA+E;AAC/E,+EAA+E;AAC/E,mFAAmF;AACnF,EAAE;AACF,mFAAmF;AACnF,8CAA8C;AAE9C,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,OAAO,MAAM,cAAc,CAAC;AACnC,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAIrC,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AASrE;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,GAAQ,EAAE,YAAoB,EAAE,IAAmB;IACvF,IAAI,GAAG,CAAC,UAAU,KAAK,QAAQ,EAAE,CAAC;QAChC,OAAO,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,SAAS,CAAC,YAAY,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7D,CAAC;IACD,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC9B,+EAA+E;QAC/E,0EAA0E;QAC1E,sDAAsD;QACtD,IAAI,GAAG,CAAC,UAAU,KAAK,OAAO,IAAI,aAAa,EAAE,EAAE,CAAC;YAClD,MAAM,MAAM,GAAG,MAAM,WAAW,CAC9B,8BAA8B,YAAY,kDAAkD,CAC7F,CAAC;YACF,IAAI,MAAM,IAAI,CAAC,MAAM,gBAAgB,CAAC,YAAY,CAAC,CAAC,EAAE,CAAC;gBACrD,yEAAyE;gBACzE,uEAAuE;gBACvE,mEAAmE;gBACnE,iCAAiC;gBACjC,MAAM,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC;gBAChD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;QACH,CAAC;QACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,mCAAmC,YAAY,IAAI,CAAC,CAAC;QAC1E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}

package/dist/shell/main-reconcilers-helpers.js

@@ -0,0 +1,244 @@
+// FCIS rewrite — reconciler-pass IO helpers (shell). Sliced out of
+// main-reconcilers.ts to keep each file under the shell line/complexity budgets.
+//
+// These are the OBSERVE / APPLY-one-step / project-ledger primitives the three
+// passes compose. Each reads a live port or the injected clock; ZERO pure
+// decisions live here (those are the injected core deciders the passes call).
+//
+// Shell rule: imports from src/types/** ONLY. Ports are injected.
+import { sanitizeWorkspaceKey } from './workspace-key.js';
+/** Every `symphony-*` VM the orchestrator labels its dispatches with (matches the
+ *  runner's `sessionLabel`); the VM reaper compares the live session set to it. */
+const SYMPHONY_VM_PREFIX = 'symphony-';
+/**
+ * Project the orchestrator's live running + claimed dispatches into the
+ * reconciler's intended set. Running entries carry full pinned dispatch data
+ * (issue/state/branch/base/repo); a bare claim (claimed-but-not-yet-running) is
+ * carried with the live config's base/repo + a null issue so the VM reaper and
+ * workspace janitor still treat its `symphony-<id>` label + workspace as intended
+ * (covers the window between claim and the tracker reflecting it). The PR pass
+ * skips null-issue entries (it needs the issue's state to classify an intent).
+ */
+export function inFlightEntries(orchestrator, cfg) {
+    const out = [];
+    const seen = new Set();
+    for (const e of orchestrator.runningEntries()) {
+        seen.add(e.issue_id);
+        out.push({
+            identifier: e.identifier,
+            state: e.issue.state,
+            sessionLabel: `${SYMPHONY_VM_PREFIX}${e.identifier}`,
+            issue: { identifier: e.identifier, state: e.issue.state, branch_name: e.issue.branch_name },
+            baseBranch: e.base_branch_at_dispatch || cfg.workspace.base_branch,
+            githubRepo: e.github_repo_at_dispatch ?? cfg.workspace.github_repo,
+        });
+    }
+    for (const id of orchestrator.claimedIds()) {
+        if (seen.has(id))
+            continue;
+        out.push({ identifier: id, state: null, sessionLabel: `${SYMPHONY_VM_PREFIX}${id}`, issue: null, baseBranch: cfg.workspace.base_branch, githubRepo: cfg.workspace.github_repo });
+    }
+    return out;
+}
+// The workspace-key sanitizer lives in the single shell home (mirror of the
+// core util); re-exported so this module's importers keep their specifier
+// (imported above for this module's own internal use).
+export { sanitizeWorkspaceKey };
+/**
+ * Build the `applyKillStep` applier: ONE step's host IO → the observed
+ * `KillStepResult` the pure `foldKillStep` consumes.
+ *   • signal     → ProcessSignalPort.kill → signalled / gone(ESRCH) / no_perm(EPERM)
+ *   • wait_grace → TimerPort.sleep(ms)    → signalled (the fold advances to probe)
+ *   • probe      → ProcessSignalPort.probe (signal 0) → alive / gone / no_perm
+ *   • done       → terminal no-op
+ */
+export function buildApplyKillStep(deps) {
+    return async (step) => {
+        switch (step.kind) {
+            case 'signal': {
+                const r = deps.signal.kill(step.pid, step.signal);
+                if (r.ok)
+                    return { kind: 'signalled' };
+                if (r.noPerm)
+                    return { kind: 'no_perm' };
+                return { kind: 'gone' };
+            }
+            case 'wait_grace':
+                await deps.timer.sleep(step.ms);
+                return { kind: 'signalled' };
+            case 'probe': {
+                const r = deps.signal.probe(step.pid);
+                if (!r.alive)
+                    return { kind: 'gone' };
+                if (r.noPerm)
+                    return { kind: 'no_perm' };
+                return { kind: 'alive' };
+            }
+            case 'done':
+                return { kind: 'signalled' };
+        }
+    };
+}
+/** Fold one kill-step ledger op into the vm ledger (the clock is injected). */
+export function applyKillLedger(ledger, decision, core, clock) {
+    const op = decision.ledger;
+    const at = clock.iso();
+    if (op.op === 'start')
+        return core.ledgerStart(ledger, op.key, at);
+    if (op.op === 'done')
+        return core.ledgerDone(ledger, op.key, at);
+    if (op.op === 'error')
+        return core.ledgerError(ledger, op.key, op.message, at);
+    return ledger;
+}
+/**
+ * Enumerate PR-autopilot candidates by scanning the TRACKER for issues in the
+ * merge/close states — NOT the live-dispatch (`intended.inFlight()`) set.
+ *
+ * The merge state (e.g. `Done`) is terminal: its issues are never in-flight, so
+ * an in-flight scan surfaces zero merge intents and the autopilot never arms a
+ * single auto-merge (the issue-173 FCIS rewrite regressed exactly here — open
+ * PRs sat un-armed forever). This restores the pre-rewrite `prIntended()`
+ * tracker-state scan.
+ *
+ * The per-issue workspace is no longer consulted: the autopilot stopped
+ * rebasing from it (that is the dispatched agent's job now), and terminal-state
+ * workspaces are reaped by the janitor — so `gh`/`git` PR ops run from the
+ * stable source repo (`deps.sourceRepo()`), which always exists and carries the
+ * `origin` remote the verbs resolve the repository from. We hand that path in
+ * as `mergeWorkspacePath` so the intent's `workspace_path` (and thus `cwdFor`)
+ * points there.
+ */
+export async function collectPrIntents(deps, cfg, routing) {
+    const states = [routing.mergeState, routing.closeState].filter((s) => s !== null);
+    if (states.length === 0)
+        return [];
+    const repo = deps.sourceRepo();
+    const { raw } = await deps.tracker.loadAllIssues();
+    // selectIssuesByStates filters by state (case-insensitive) AND normalizes each
+    // raw file into an Issue — so `issue.identifier`/`issue.branch_name` are the
+    // canonical front-matter values dispatch/actions used to push the branch, not
+    // the bare filename stem. Mirrors the pre-rewrite `fetchIssuesByStates` feed.
+    const out = [];
+    const seen = new Set();
+    for (const issue of deps.core.selectIssuesByStates(raw, states)) {
+        if (seen.has(issue.identifier))
+            continue;
+        const intent = deps.core.classifyPrIntent({
+            issue,
+            // A null mergeState (close-only routing) must never match — pass a sentinel
+            // the tracker state can't equal (classify lower-cases both sides).
+            mergeState: routing.mergeState ?? ' no-merge-state ',
+            closeState: routing.closeState,
+            baseBranch: cfg.workspace.base_branch,
+            mergeWorkspacePath: repo,
+        });
+        if (!intent)
+            continue;
+        out.push(intent);
+        seen.add(issue.identifier);
+    }
+    return out;
+}
+/** First declared active state (the conflict-route fallback when none is configured). */
+export function firstActiveState(cfg) {
+    for (const [name, sc] of Object.entries(cfg.states))
+        if (sc.role === 'active')
+            return name;
+    return 'Todo';
+}
+/**
+ * Observe the desired workspace set: in-flight (orchestrator) first, then active
+ * (tracker) — active wins on overlap (decideWorkspace last-write-wins reproduces
+ * the precedence). Throws on the tracker read (the pass fails closed: it must NOT
+ * treat the empty set as desired — reaping every workspace on a transient hiccup
+ * is the regression this contract closes).
+ */
+export async function observeDesiredWorkspaces(deps, cfg) {
+    const out = [];
+    for (const e of deps.intended.inFlight())
+        out.push({ identifier: e.identifier, state: e.state });
+    const { raw } = await deps.tracker.loadAllIssues();
+    const activeStates = new Set(Object.entries(cfg.states).filter(([, c]) => c.role === 'active').map(([n]) => n.toLowerCase()));
+    for (const f of raw) {
+        if (activeStates.has(f.state.toLowerCase()))
+            out.push({ identifier: f.identifier, state: f.state });
+    }
+    return out;
+}
+/**
+ * Sanitized dir names whose terminal issue left a handoff-pending marker (issue
+ * 234). Only the reap CANDIDATES (dirs NOT in the desired set) can carry one — a
+ * wanted dir is never reaped, so its marker is irrelevant — so we stat only those.
+ * A stat error reads as "no marker" (the dir reaps as today).
+ */
+export async function observeHandoffMarkers(deps, desired, observed) {
+    const out = new Set();
+    const wanted = new Set(desired.map((d) => sanitizeWorkspaceKey(d.identifier)));
+    for (const { name, path } of observed) {
+        if (wanted.has(name))
+            continue;
+        try {
+            if (await deps.workspace.hasHandoffPendingMarker(path))
+                out.add(name);
+        }
+        catch {
+            // stat failed → treat as no marker (decider reaps as today).
+        }
+    }
+    return out;
+}
+/** Per-dir git inspection for the wanted dirs on disk (drift detection). */
+export async function observeInspections(deps, cfg, desired, observed) {
+    const inspections = {};
+    const wanted = new Set(desired.map((d) => sanitizeWorkspaceKey(d.identifier)));
+    for (const { name, path } of observed) {
+        if (!wanted.has(name))
+            continue;
+        try {
+            inspections[name] = await deps.workspace.inspect(path, cfg.workspace.base_branch);
+        }
+        catch {
+            // inspect failed → omit (decider skips drift for a missing inspection).
+        }
+    }
+    return inspections;
+}
+/** Source repo's current base-branch SHA (drift anchor); null skips drift detection. */
+export async function resolveBaseRefSha(deps, cfg) {
+    try {
+        const r = await deps.git.run(['rev-parse', cfg.workspace.base_branch], deps.sourceRepo());
+        if (r.exit_code === 0 && r.stdout.trim().length > 0)
+            return r.stdout.trim();
+    }
+    catch {
+        // fall through → null (drift detection skipped; orphan removal still fires)
+    }
+    return null;
+}
+/** Ledger the mutating PR verbs (mirror the reference's per-action keys). */
+export function recordPrLedger(ledger, effect, phase, clock, core) {
+    const key = prActionKey(effect);
+    if (key === null)
+        return ledger;
+    return phase === 'start' ? core.ledgerStart(ledger, key, clock.iso()) : core.ledgerDone(ledger, key, clock.iso());
+}
+function prActionKey(effect) {
+    switch (effect.kind) {
+        case 'arm_auto_merge':
+            return `arm_auto_merge:${effect.prNumber}`;
+        case 'update_branch':
+            return `update_branch:${effect.prNumber}`;
+        case 'close_pr':
+            return `close_pr:${effect.prNumber}`;
+        case 'delete_remote_branch':
+            return `delete_remote_branch:${effect.branch}`;
+        case 'cleanup_workspace':
+            return `cleanup_workspace:${effect.identifier}`;
+        case 'route_conflict':
+            return `route_to_conflict:${effect.identifier}:${effect.toState.toLowerCase()}`;
+        default:
+            return null;
+    }
+}
+//# sourceMappingURL=main-reconcilers-helpers.js.map

package/dist/shell/main-reconcilers-helpers.js.map

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

package/dist/shell/main-reconcilers-pr.js

@@ -0,0 +1,148 @@
+// FCIS rewrite — PR-autopilot effect applier (shell side of the reconciler PR
+// pass). Sliced out of main-reconcilers.ts to keep each file under the shell
+// line/complexity budgets.
+//
+// Runs the gh/git/tracker IO for one `PrEffect` against the live per-issue sticky
+// cache (issue 70: a FOUND PR is sticky forever; the `gh pr view` TTL is
+// independent of the cache-miss re-poll) and returns the `PrEffectOutcome` the
+// pure `foldPrEffectOutcome` consumes. The PR pass drives the
+// decide→apply→re-decide loop directly with `apply` so the cache stays
+// single-owner; `applyFamily` is the interpreter's `pr`-family fallback (it
+// reconstructs the last-seen intent for a core-emitted bare `pr` Effect).
+//
+// Shell rule: imports from src/types/** ONLY. Ports are injected.
+function initPrState() {
+    return { prSummary: undefined, lastLookupAt: 0, prView: null, lastViewAt: 0, lastObservedHeadSha: null, armed: false, completed: false };
+}
+function cacheViewOf(st) {
+    return { completed: st.completed, armed: st.armed, lastObservedHeadSha: st.lastObservedHeadSha };
+}
+export const EMPTY_PR_CACHE = { completed: false, armed: false, lastObservedHeadSha: null };
+const pollMs = (ctx) => ctx.deps.getCfg().pr.poll_interval_ms;
+// gh/git PR ops run from the stable source repo (it always exists and carries
+// the `origin` remote the verbs resolve the repository from). The per-issue
+// workspace is NOT used: the autopilot no longer rebases from it and terminal
+// workspaces are reaped, so a workspace cwd would ENOENT on `gh` spawn.
+const cwdFor = (ctx) => ctx.deps.sourceRepo();
+function getOrInit(ctx, id) {
+    let st = ctx.states.get(id);
+    if (!st) {
+        st = initPrState();
+        ctx.states.set(id, st);
+    }
+    return st;
+}
+async function observeSummary(ctx, intent, st) {
+    const fresh = ctx.deps.core.decidePrSummaryFreshness({ summary: st.prSummary, now: ctx.deps.clock.now(), lastLookupAt: st.lastLookupAt, pollIntervalMs: pollMs(ctx) });
+    if (fresh.kind === 'reuse')
+        return fresh.summary;
+    if (fresh.kind === 'defer')
+        return null;
+    const summary = await ctx.deps.gh.prListForBranch(cwdFor(ctx), intent.branch);
+    st.prSummary = summary;
+    st.lastLookupAt = ctx.deps.clock.now();
+    return summary;
+}
+async function fetchView(ctx, intent, prNumber, st) {
+    const fresh = ctx.deps.core.decidePrViewFreshness({ view: st.prView, now: ctx.deps.clock.now(), lastViewAt: st.lastViewAt, pollIntervalMs: pollMs(ctx) });
+    if (fresh.kind === 'reuse')
+        return fresh.view;
+    const view = await ctx.deps.gh.prView(cwdFor(ctx), prNumber);
+    if (view !== null) {
+        st.prView = view;
+        st.lastViewAt = ctx.deps.clock.now();
+        st.lastObservedHeadSha = view.head_ref_oid;
+        st.armed = view.auto_merge_armed;
+    }
+    return view;
+}
+async function routeConflict(ctx, e) {
+    if (!ctx.deps.tracker.moveIssueToState)
+        return;
+    await ctx.deps.tracker.moveIssueToState(e.identifier, e.toState, { fromState: e.fromState, notes: e.notes, actor: ctx.actor });
+}
+/** gh/git mutating verbs (arm/update/close/delete/cleanup/route). */
+async function applyGhVerb(ctx, effect, st, cwd) {
+    const gh = ctx.deps.gh;
+    switch (effect.kind) {
+        case 'arm_auto_merge':
+            await gh.run(['pr', 'merge', String(effect.prNumber), '--auto', `--${effect.strategy}`, '--delete-branch'], cwd);
+            st.armed = true;
+            return { kind: 'cache', cache: cacheViewOf(st) };
+        case 'update_branch':
+            await gh.run(['pr', 'update-branch', String(effect.prNumber)], cwd);
+            return { kind: 'halted' };
+        case 'close_pr':
+            return { kind: 'close', ok: (await gh.run(['pr', 'close', String(effect.prNumber)], cwd)).exit_code === 0 };
+        case 'delete_remote_branch': {
+            // Scope deletion to the configured PR repo so it matches the gh `--repo`
+            // targeting (the out-of-repo / origin-less layout): `gh api DELETE` uses
+            // host auth, not cwd `origin`, so it can't push to the wrong remote. A
+            // 404 from an already-deleted branch (e.g. `--delete-branch` on merge) is
+            // ignored — the result is not folded. Local-only (no slug) → `git push`.
+            const slug = ctx.deps.getCfg().workspace.github_repo;
+            if (slug)
+                await gh.run(['api', '--method', 'DELETE', `repos/${slug}/git/refs/heads/${effect.branch}`], cwd);
+            else
+                await ctx.deps.git.run(['push', 'origin', '--delete', effect.branch], cwd);
+            return { kind: 'none' };
+        }
+        case 'cleanup_workspace':
+            await ctx.deps.workspace.remove(effect.identifier, 'stale_issue');
+            return { kind: 'none' };
+        case 'route_conflict':
+            await routeConflict(ctx, effect);
+            return { kind: 'halted' };
+        default:
+            return { kind: 'none' };
+    }
+}
+/** Cache-mutating latches that touch no port (update_observed_head/mark/reset). */
+function applyCacheLatch(ctx, effect, st) {
+    switch (effect.kind) {
+        case 'update_observed_head':
+            st.lastObservedHeadSha = effect.sha;
+            return { kind: 'cache', cache: cacheViewOf(st) };
+        case 'mark_completed':
+            st.completed = true;
+            return { kind: 'cache', cache: cacheViewOf(st) };
+        case 'reset_transient': {
+            // Wipe everything (reference resetTransient) so the next return re-resolves.
+            if (ctx.states.has(effect.identifier))
+                ctx.states.set(effect.identifier, initPrState());
+            const next = ctx.states.get(effect.identifier);
+            return { kind: 'cache', cache: next ? cacheViewOf(next) : EMPTY_PR_CACHE };
+        }
+        default:
+            return null;
+    }
+}
+async function apply(ctx, intent, effect) {
+    ctx.intents.set(intent.identifier, intent);
+    const st = getOrInit(ctx, intent.identifier);
+    if (effect.kind === 'observe_summary')
+        return { kind: 'summary', summary: await observeSummary(ctx, intent, st), cache: cacheViewOf(st) };
+    if (effect.kind === 'observe_view')
+        return { kind: 'view', view: await fetchView(ctx, intent, effect.prNumber, st), cache: cacheViewOf(st) };
+    return applyCacheLatch(ctx, effect, st) ?? applyGhVerb(ctx, effect, st, cwdFor(ctx));
+}
+export function buildPrApplier(deps) {
+    const ctx = { deps, states: new Map(), intents: new Map(), actor: deps.actor ?? 'pr-autopilot' };
+    const applyFamily = async (effect) => {
+        const intent = ctx.intents.get(effect.identifier);
+        if (!intent)
+            return { ok: false, error: 'pr effect for unknown intent (no live PR pass observation)' };
+        await apply(ctx, intent, effect);
+        return { ok: true };
+    };
+    const dropExcept = (wanted) => {
+        for (const id of [...ctx.states.keys()])
+            if (!wanted.has(id))
+                ctx.states.delete(id);
+        for (const id of [...ctx.intents.keys()])
+            if (!wanted.has(id))
+                ctx.intents.delete(id);
+    };
+    return { apply: (intent, effect) => apply(ctx, intent, effect), applyFamily, dropExcept };
+}
+//# sourceMappingURL=main-reconcilers-pr.js.map

package/dist/shell/main-reconcilers-pr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main-reconcilers-pr.js","sourceRoot":"","sources":["../../src/shell/main-reconcilers-pr.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,6EAA6E;AAC7E,2BAA2B;AAC3B,EAAE;AACF,kFAAkF;AAClF,yEAAyE;AACzE,+EAA+E;AAC/E,8DAA8D;AAC9D,uEAAuE;AACvE,4EAA4E;AAC5E,0EAA0E;AAC1E,EAAE;AACF,kEAAkE;AAkBlE,SAAS,WAAW;IAClB,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,EAAE,mBAAmB,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;AAC3I,CAAC;AAED,SAAS,WAAW,CAAC,EAAmB;IACtC,OAAO,EAAE,SAAS,EAAE,EAAE,CAAC,SAAS,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,EAAE,mBAAmB,EAAE,EAAE,CAAC,mBAAmB,EAAE,CAAC;AACnG,CAAC;AAED,MAAM,CAAC,MAAM,cAAc,GAAgB,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,mBAAmB,EAAE,IAAI,EAAE,CAAC;AAUzG,MAAM,MAAM,GAAG,CAAC,GAAU,EAAU,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,gBAAgB,CAAC;AAC7E,8EAA8E;AAC9E,4EAA4E;AAC5E,8EAA8E;AAC9E,wEAAwE;AACxE,MAAM,MAAM,GAAG,CAAC,GAAU,EAAU,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;AAE7D,SAAS,SAAS,CAAC,GAAU,EAAE,EAAU;IACvC,IAAI,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC5B,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,EAAE,GAAG,WAAW,EAAE,CAAC;QACnB,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IACzB,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,KAAK,UAAU,cAAc,CAAC,GAAU,EAAE,MAAgB,EAAE,EAAmB;IAC7E,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,wBAAwB,CAAC,EAAE,OAAO,EAAE,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,YAAY,EAAE,EAAE,CAAC,YAAY,EAAE,cAAc,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACvK,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO;QAAE,OAAO,KAAK,CAAC,OAAO,CAAC;IACjD,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO;QAAE,OAAO,IAAI,CAAC;IACxC,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,eAAe,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IAC9E,EAAE,CAAC,SAAS,GAAG,OAAO,CAAC;IACvB,EAAE,CAAC,YAAY,GAAG,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;IACvC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,KAAK,UAAU,SAAS,CAAC,GAAU,EAAE,MAAgB,EAAE,QAAgB,EAAE,EAAmB;IAC1F,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,qBAAqB,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,EAAE,UAAU,EAAE,EAAE,CAAC,UAAU,EAAE,cAAc,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC1J,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO;QAAE,OAAO,KAAK,CAAC,IAAI,CAAC;IAC9C,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,CAAC;IAC7D,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAClB,EAAE,CAAC,MAAM,GAAG,IAAI,CAAC;QACjB,EAAE,CAAC,UAAU,GAAG,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC;QACrC,EAAE,CAAC,mBAAmB,GAAG,IAAI,CAAC,YAAY,CAAC;QAC3C,EAAE,CAAC,KAAK,GAAG,IAAI,CAAC,gBAAgB,CAAC;IACnC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,KAAK,UAAU,aAAa,CAAC,GAAU,EAAE,CAAgD;IACvF,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,gBAAgB;QAAE,OAAO;IAC/C,MAAM,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC;AACjI,CAAC;AAED,qEAAqE;AACrE,KAAK,UAAU,WAAW,CAAC,GAAU,EAAE,MAAgB,EAAE,EAAmB,EAAE,GAAW;IACvF,MAAM,EAAE,GAAG,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;IACvB,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,gBAAgB;YACnB,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE,KAAK,MAAM,CAAC,QAAQ,EAAE,EAAE,iBAAiB,CAAC,EAAE,GAAG,CAAC,CAAC;YACjH,EAAE,CAAC,KAAK,GAAG,IAAI,CAAC;YAChB,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,CAAC,EAAE,CAAC,EAAE,CAAC;QACnD,KAAK,eAAe;YAClB,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,eAAe,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;YACpE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QAC5B,KAAK,UAAU;YACb,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,SAAS,KAAK,CAAC,EAAE,CAAC;QAC9G,KAAK,sBAAsB,CAAC,CAAC,CAAC;YAC5B,yEAAyE;YACzE,yEAAyE;YACzE,uEAAuE;YACvE,0EAA0E;YAC1E,yEAAyE;YACzE,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,SAAS,CAAC,WAAW,CAAC;YACrD,IAAI,IAAI;gBAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,SAAS,IAAI,mBAAmB,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;;gBACvG,MAAM,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,CAAC;YAChF,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QAC1B,CAAC;QACD,KAAK,mBAAmB;YACtB,MAAM,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;YAClE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QAC1B,KAAK,gBAAgB;YACnB,MAAM,aAAa,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YACjC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QAC5B;YACE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC5B,CAAC;AACH,CAAC;AAED,mFAAmF;AACnF,SAAS,eAAe,CAAC,GAAU,EAAE,MAAgB,EAAE,EAAmB;IACxE,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,sBAAsB;YACzB,EAAE,CAAC,mBAAmB,GAAG,MAAM,CAAC,GAAG,CAAC;YACpC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,CAAC,EAAE,CAAC,EAAE,CAAC;QACnD,KAAK,gBAAgB;YACnB,EAAE,CAAC,SAAS,GAAG,IAAI,CAAC;YACpB,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,CAAC,EAAE,CAAC,EAAE,CAAC;QACnD,KAAK,iBAAiB,CAAC,CAAC,CAAC;YACvB,6EAA6E;YAC7E,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC;gBAAE,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,EAAE,WAAW,EAAE,CAAC,CAAC;YACxF,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YAC/C,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,cAAc,EAAE,CAAC;QAC7E,CAAC;QACD;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC;AAED,KAAK,UAAU,KAAK,CAAC,GAAU,EAAE,MAAgB,EAAE,MAAgB;IACjE,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IAC3C,MAAM,EAAE,GAAG,SAAS,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;IAC7C,IAAI,MAAM,CAAC,IAAI,KAAK,iBAAiB;QAAE,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,KAAK,EAAE,WAAW,CAAC,EAAE,CAAC,EAAE,CAAC;IAC1I,IAAI,MAAM,CAAC,IAAI,KAAK,cAAc;QAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC,EAAE,KAAK,EAAE,WAAW,CAAC,EAAE,CAAC,EAAE,CAAC;IAC7I,OAAO,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC,IAAI,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;AACvF,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAwB;IACrD,MAAM,GAAG,GAAU,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,GAAG,EAAE,EAAE,OAAO,EAAE,IAAI,GAAG,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,cAAc,EAAE,CAAC;IACxG,MAAM,WAAW,GAAkB,KAAK,EAAE,MAAgB,EAAyB,EAAE;QACnF,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAClD,IAAI,CAAC,MAAM;YAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,4DAA4D,EAAE,CAAC;QACvG,MAAM,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QACjC,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;IACtB,CAAC,CAAC;IACF,MAAM,UAAU,GAAG,CAAC,MAA2B,EAAQ,EAAE;QACvD,KAAK,MAAM,EAAE,IAAI,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;gBAAE,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACpF,KAAK,MAAM,EAAE,IAAI,CAAC,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YAAE,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;gBAAE,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACxF,CAAC,CAAC;IACF,OAAO,EAAE,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC;AAC5F,CAAC"}