instar 0.28.95 → 0.28.97

package/dist/core/ProjectRoundCompleteMessage.d.ts

@@ -0,0 +1,158 @@
+/**
+ * ProjectRoundCompleteMessage — tone-gated round-complete delivery
+ * template + retry + idempotency for project rounds.
+ *
+ * Spec: docs/specs/PROJECT-SCOPE-SPEC.md § Phase 1.8.
+ *
+ * Two responsibilities:
+ *   1. `formatRoundCompleteMessage(input)` — pure template function
+ *      that validates required-field PRESENCE (never non-emptiness)
+ *      and returns a `{message, idempotencyKey}` pair. Pre-flight
+ *      halts have a documented empty-default for `whatLanded` so the
+ *      gate never silently rejects a legitimate halt event.
+ *   2. `RoundCompleteDeliveryHelper` — bookkeeping over the
+ *      idempotency key set with a `sendOnce` helper that delegates
+ *      actual transport to a caller-provided sender, retries on
+ *      transient failures with exponential backoff, and triggers the
+ *      caller's fallback (`onPermanentFail`) when all retries fail.
+ *
+ * What this file is NOT responsible for:
+ *   - Choosing WHEN to send a round-complete message. The autonomous
+ *     run loop (next PR) decides that.
+ *   - The actual Telegram transport. The caller passes a `send`
+ *     function — keeping the template + retry isolated from the
+ *     `TelegramAdapter` so tests don't need to spin up the adapter.
+ *   - Going through the `MessagingToneGate`. The gate operates on
+ *     final outbound text; the consumer is the one that calls
+ *     `gate.evaluate(message)` before passing the message to a
+ *     transport. We expose the formatted text so the consumer can
+ *     route it through the gate.
+ */
+import { SafeFsExecutor } from './SafeFsExecutor.js';
+/** Event kind the message describes. */
+export type RoundCompleteEventKind = 'round-complete' | 'round-partially-complete' | 'round-halted' | 'round-failed';
+/** Inputs to the template. Required-fields are enforced by the validator below. */
+export interface RoundCompleteMessageInput {
+    projectId: string;
+    projectTitle: string;
+    roundIndex: number;
+    /** Bumped on every project record write — part of the idempotency key. */
+    projectVersion: number;
+    eventKind: RoundCompleteEventKind;
+    /**
+     * Bullet list of merged itemIds with titles. May default to
+     * "No items shipped this round — halted at <step>" when the event
+     * is a pre-flight halt; presence is enforced, non-emptiness is not.
+     */
+    whatLanded: string;
+    /** Required for halt events (round-halted / round-failed). */
+    whatHalted?: string;
+    /**
+     * Verified citations (text excerpts the dashboard renders), or PR
+     * mergeCommit.oid values for shipped items. Empty array is allowed.
+     */
+    evidenceCited: string[];
+    /**
+     * Required for halt + failed events. For clean `round-complete`,
+     * the default `"(none)"` is accepted by the template.
+     */
+    rootCauseHypothesis: string;
+    /**
+     * Required. Tells the user how to act:
+     * `"Reply 'pause <project-id>' within 24 hours to hold"` is the
+     * canonical phrasing per spec.
+     */
+    concreteNextStep: string;
+    /** Optional dashboard deep link. */
+    overrideLink?: string;
+    /** Required. Canonical phrasing for the user's hold path. */
+    brakeHandlePhrase: string;
+}
+/** Stable key keyed off `(projectId, roundIndex, eventKind, projectVersion)`. */
+export declare function idempotencyKeyFor(input: Pick<RoundCompleteMessageInput, 'projectId' | 'roundIndex' | 'eventKind' | 'projectVersion'>): string;
+export type FormatResult = {
+    ok: true;
+    message: string;
+    idempotencyKey: string;
+} | {
+    ok: false;
+    missingFields: string[];
+};
+/**
+ * Build the user-facing message. Returns `{ok:false, missingFields}`
+ * when a required field is undefined / null. Returns `{ok:true, message,
+ * idempotencyKey}` otherwise. Empty strings are accepted by design — the
+ * template enforces *presence*, not *non-emptiness*. The empty-default
+ * for `whatLanded` on pre-flight halts is the responsibility of the
+ * caller (they should supply the documented default before calling
+ * this function — the validator just records that the field is present).
+ */
+export declare function formatRoundCompleteMessage(input: RoundCompleteMessageInput): FormatResult;
+export type SendResult = {
+    ok: true;
+} | {
+    ok: false;
+    transient: boolean;
+    error: Error;
+};
+export interface SendAttempt {
+    attempt: number;
+    ok: boolean;
+    error?: Error;
+    transient?: boolean;
+}
+export interface DeliveryReport {
+    sent: boolean;
+    attempts: SendAttempt[];
+    /** Set when send succeeded — null on failure. */
+    idempotencyKey: string | null;
+    /** Set when ALL attempts failed AND the caller's fallback ran. */
+    fallbackTriggered: boolean;
+}
+export interface RoundCompleteDeliveryHelperConfig {
+    /** Absolute path to the agent's `.instar/` directory (for the dedup file). */
+    stateDir: string;
+    /** Max attempts before the fallback fires. Default 3. */
+    maxAttempts?: number;
+    /** Backoff base in ms. Default 1000 (1s, 2s, 4s). */
+    backoffBaseMs?: number;
+    /** Override for tests. */
+    setTimeoutFn?: (cb: () => void, ms: number) => void;
+}
+declare const DEDUP_FILE = "round-complete-sent.json";
+export declare class RoundCompleteDeliveryHelper {
+    private stateDir;
+    private maxAttempts;
+    private backoffBaseMs;
+    private setTimeoutFn;
+    private sentKeys;
+    private loaded;
+    constructor(config: RoundCompleteDeliveryHelperConfig);
+    /**
+     * Send a round-complete message, with retry + idempotency.
+     *
+     * On the first call for an idempotency key:
+     *   - Calls `send(input, message)` up to `maxAttempts` times.
+     *   - Between attempts, waits `backoffBaseMs * 2^(attempt-1)` ms.
+     *   - Records the key after the first successful send.
+     *
+     * On subsequent calls with the same key:
+     *   - Returns `{sent: false, alreadySent: true}` without calling `send`.
+     *
+     * On permanent failure (all attempts return non-transient or transient
+     * exhausted), invokes `onPermanentFail(input, message, attempts)`.
+     */
+    sendOnce(input: RoundCompleteMessageInput, send: (input: RoundCompleteMessageInput, message: string) => Promise<SendResult>, onPermanentFail?: (input: RoundCompleteMessageInput, message: string, attempts: SendAttempt[]) => Promise<void>): Promise<DeliveryReport & {
+        alreadySent?: boolean;
+    }>;
+    /** Test-only: query whether a key was recorded. */
+    hasSent(key: string): boolean;
+    private loadIfNeeded;
+    private persist;
+    private dedupPath;
+}
+/** Re-export so tests can clean up the dedup file directly. */
+export { DEDUP_FILE };
+/** Re-export SafeFsExecutor namespace for callers that need to clean up safely. */
+export { SafeFsExecutor };
+//# sourceMappingURL=ProjectRoundCompleteMessage.d.ts.map

package/dist/core/ProjectRoundCompleteMessage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProjectRoundCompleteMessage.d.ts","sourceRoot":"","sources":["../../src/core/ProjectRoundCompleteMessage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAKH,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD,wCAAwC;AACxC,MAAM,MAAM,sBAAsB,GAC9B,gBAAgB,GAChB,0BAA0B,GAC1B,cAAc,GACd,cAAc,CAAC;AAEnB,mFAAmF;AACnF,MAAM,WAAW,yBAAyB;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,0EAA0E;IAC1E,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,sBAAsB,CAAC;IAClC;;;;OAIG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,8DAA8D;IAC9D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB;;;OAGG;IACH,mBAAmB,EAAE,MAAM,CAAC;IAC5B;;;;OAIG;IACH,gBAAgB,EAAE,MAAM,CAAC;IACzB,oCAAoC;IACpC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,6DAA6D;IAC7D,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,iFAAiF;AACjF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,IAAI,CAAC,yBAAyB,EAAE,WAAW,GAAG,YAAY,GAAG,WAAW,GAAG,gBAAgB,CAAC,GAAG,MAAM,CAE7I;AAED,MAAM,MAAM,YAAY,GACpB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GACrD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,aAAa,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAE3C;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,yBAAyB,GAAG,YAAY,CAwDzF;AAID,MAAM,MAAM,UAAU,GAClB;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GACZ;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,SAAS,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,CAAC;AAEpD,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,iDAAiD;IACjD,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,kEAAkE;IAClE,iBAAiB,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,iCAAiC;IAChD,8EAA8E;IAC9E,QAAQ,EAAE,MAAM,CAAC;IACjB,yDAAyD;IACzD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qDAAqD;IACrD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,0BAA0B;IAC1B,YAAY,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,IAAI,EAAE,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;CACrD;AAED,QAAA,MAAM,UAAU,6BAA6B,CAAC;AAS9C,qBAAa,2BAA2B;IACtC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,YAAY,CAAuC;IAC3D,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE,iCAAiC;IAOrD;;;;;;;;;;;;;OAaG;IACG,QAAQ,CACZ,KAAK,EAAE,yBAAyB,EAChC,IAAI,EAAE,CAAC,KAAK,EAAE,yBAAyB,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,UAAU,CAAC,EAChF,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,yBAAyB,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,GAC9G,OAAO,CAAC,cAAc,GAAG;QAAE,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IA6DtD,mDAAmD;IACnD,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAO7B,OAAO,CAAC,YAAY;IAcpB,OAAO,CAAC,OAAO;IAgBf,OAAO,CAAC,SAAS;CAGlB;AAED,+DAA+D;AAC/D,OAAO,EAAE,UAAU,EAAE,CAAC;AAEtB,mFAAmF;AACnF,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/dist/core/ProjectRoundCompleteMessage.js

@@ -0,0 +1,253 @@
+/**
+ * ProjectRoundCompleteMessage — tone-gated round-complete delivery
+ * template + retry + idempotency for project rounds.
+ *
+ * Spec: docs/specs/PROJECT-SCOPE-SPEC.md § Phase 1.8.
+ *
+ * Two responsibilities:
+ *   1. `formatRoundCompleteMessage(input)` — pure template function
+ *      that validates required-field PRESENCE (never non-emptiness)
+ *      and returns a `{message, idempotencyKey}` pair. Pre-flight
+ *      halts have a documented empty-default for `whatLanded` so the
+ *      gate never silently rejects a legitimate halt event.
+ *   2. `RoundCompleteDeliveryHelper` — bookkeeping over the
+ *      idempotency key set with a `sendOnce` helper that delegates
+ *      actual transport to a caller-provided sender, retries on
+ *      transient failures with exponential backoff, and triggers the
+ *      caller's fallback (`onPermanentFail`) when all retries fail.
+ *
+ * What this file is NOT responsible for:
+ *   - Choosing WHEN to send a round-complete message. The autonomous
+ *     run loop (next PR) decides that.
+ *   - The actual Telegram transport. The caller passes a `send`
+ *     function — keeping the template + retry isolated from the
+ *     `TelegramAdapter` so tests don't need to spin up the adapter.
+ *   - Going through the `MessagingToneGate`. The gate operates on
+ *     final outbound text; the consumer is the one that calls
+ *     `gate.evaluate(message)` before passing the message to a
+ *     transport. We expose the formatted text so the consumer can
+ *     route it through the gate.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { SafeFsExecutor } from './SafeFsExecutor.js';
+/** Stable key keyed off `(projectId, roundIndex, eventKind, projectVersion)`. */
+export function idempotencyKeyFor(input) {
+    return `${input.projectId}::${input.roundIndex}::${input.eventKind}::v${input.projectVersion}`;
+}
+/**
+ * Build the user-facing message. Returns `{ok:false, missingFields}`
+ * when a required field is undefined / null. Returns `{ok:true, message,
+ * idempotencyKey}` otherwise. Empty strings are accepted by design — the
+ * template enforces *presence*, not *non-emptiness*. The empty-default
+ * for `whatLanded` on pre-flight halts is the responsibility of the
+ * caller (they should supply the documented default before calling
+ * this function — the validator just records that the field is present).
+ */
+export function formatRoundCompleteMessage(input) {
+    const missing = [];
+    if (typeof input.projectId !== 'string')
+        missing.push('projectId');
+    if (typeof input.projectTitle !== 'string')
+        missing.push('projectTitle');
+    if (!Number.isInteger(input.roundIndex))
+        missing.push('roundIndex');
+    if (!Number.isInteger(input.projectVersion))
+        missing.push('projectVersion');
+    if (typeof input.eventKind !== 'string')
+        missing.push('eventKind');
+    if (typeof input.whatLanded !== 'string')
+        missing.push('whatLanded');
+    if (typeof input.rootCauseHypothesis !== 'string')
+        missing.push('rootCauseHypothesis');
+    if (typeof input.concreteNextStep !== 'string')
+        missing.push('concreteNextStep');
+    if (typeof input.brakeHandlePhrase !== 'string')
+        missing.push('brakeHandlePhrase');
+    if (!Array.isArray(input.evidenceCited))
+        missing.push('evidenceCited');
+    // halt-flavor events also require whatHalted to be present (string).
+    const haltLike = input.eventKind === 'round-halted' || input.eventKind === 'round-failed';
+    if (haltLike && typeof input.whatHalted !== 'string')
+        missing.push('whatHalted');
+    if (missing.length > 0) {
+        return { ok: false, missingFields: missing };
+    }
+    const lines = [];
+    const headlineByKind = {
+        'round-complete': 'Round complete',
+        'round-partially-complete': 'Round partially complete',
+        'round-halted': 'Round halted',
+        'round-failed': 'Round failed',
+    };
+    lines.push(`${headlineByKind[input.eventKind]}: ${input.projectTitle} (round ${input.roundIndex}).`);
+    lines.push('');
+    lines.push('What landed:');
+    lines.push(input.whatLanded);
+    if (haltLike && input.whatHalted) {
+        lines.push('');
+        lines.push('What halted:');
+        lines.push(input.whatHalted);
+    }
+    if (input.evidenceCited.length > 0) {
+        lines.push('');
+        lines.push('Evidence cited:');
+        for (const e of input.evidenceCited.slice(0, 10))
+            lines.push(`• ${e}`);
+    }
+    if (input.rootCauseHypothesis && input.rootCauseHypothesis !== '(none)') {
+        lines.push('');
+        lines.push(`Root cause hypothesis: ${input.rootCauseHypothesis}`);
+    }
+    lines.push('');
+    lines.push(`Next step: ${input.concreteNextStep}`);
+    lines.push(`To hold: ${input.brakeHandlePhrase}`);
+    if (input.overrideLink) {
+        lines.push(`Dashboard: ${input.overrideLink}`);
+    }
+    return {
+        ok: true,
+        message: lines.join('\n'),
+        idempotencyKey: idempotencyKeyFor(input),
+    };
+}
+const DEDUP_FILE = 'round-complete-sent.json';
+/** Bounded set so dedupe state doesn't grow forever. */
+const DEDUP_RING_SIZE = 1000;
+export class RoundCompleteDeliveryHelper {
+    stateDir;
+    maxAttempts;
+    backoffBaseMs;
+    setTimeoutFn;
+    sentKeys = new Set();
+    loaded = false;
+    constructor(config) {
+        this.stateDir = config.stateDir;
+        this.maxAttempts = config.maxAttempts ?? 3;
+        this.backoffBaseMs = config.backoffBaseMs ?? 1000;
+        this.setTimeoutFn = config.setTimeoutFn ?? ((cb, ms) => setTimeout(cb, ms).unref());
+    }
+    /**
+     * Send a round-complete message, with retry + idempotency.
+     *
+     * On the first call for an idempotency key:
+     *   - Calls `send(input, message)` up to `maxAttempts` times.
+     *   - Between attempts, waits `backoffBaseMs * 2^(attempt-1)` ms.
+     *   - Records the key after the first successful send.
+     *
+     * On subsequent calls with the same key:
+     *   - Returns `{sent: false, alreadySent: true}` without calling `send`.
+     *
+     * On permanent failure (all attempts return non-transient or transient
+     * exhausted), invokes `onPermanentFail(input, message, attempts)`.
+     */
+    async sendOnce(input, send, onPermanentFail) {
+        this.loadIfNeeded();
+        const formatted = formatRoundCompleteMessage(input);
+        if (!formatted.ok) {
+            return { sent: false, attempts: [], idempotencyKey: null, fallbackTriggered: false };
+        }
+        if (this.sentKeys.has(formatted.idempotencyKey)) {
+            return {
+                sent: true,
+                attempts: [{ attempt: 0, ok: true }],
+                idempotencyKey: formatted.idempotencyKey,
+                fallbackTriggered: false,
+                alreadySent: true,
+            };
+        }
+        const attempts = [];
+        for (let i = 1; i <= this.maxAttempts; i++) {
+            let result;
+            try {
+                result = await send(input, formatted.message);
+            }
+            catch (err) {
+                result = { ok: false, transient: true, error: err instanceof Error ? err : new Error(String(err)) };
+            }
+            if (result.ok) {
+                attempts.push({ attempt: i, ok: true });
+                this.sentKeys.add(formatted.idempotencyKey);
+                this.persist();
+                return {
+                    sent: true,
+                    attempts,
+                    idempotencyKey: formatted.idempotencyKey,
+                    fallbackTriggered: false,
+                };
+            }
+            attempts.push({ attempt: i, ok: false, error: result.error, transient: result.transient });
+            // Non-transient → bail immediately.
+            if (!result.transient)
+                break;
+            // Transient → backoff before next attempt, unless this was the last.
+            if (i < this.maxAttempts) {
+                const delay = this.backoffBaseMs * Math.pow(2, i - 1);
+                await new Promise((resolve) => this.setTimeoutFn(resolve, delay));
+            }
+        }
+        if (onPermanentFail) {
+            try {
+                await onPermanentFail(input, formatted.message, attempts);
+            }
+            catch {
+                // Fallback's own failure is logged at the call site; we don't
+                // double-fail the delivery report.
+            }
+        }
+        return {
+            sent: false,
+            attempts,
+            idempotencyKey: null,
+            fallbackTriggered: !!onPermanentFail,
+        };
+    }
+    /** Test-only: query whether a key was recorded. */
+    hasSent(key) {
+        this.loadIfNeeded();
+        return this.sentKeys.has(key);
+    }
+    // ── Internals ─────────────────────────────────────────────────────
+    loadIfNeeded() {
+        if (this.loaded)
+            return;
+        this.loaded = true;
+        try {
+            const raw = fs.readFileSync(this.dedupPath(), 'utf-8');
+            const obj = JSON.parse(raw);
+            if (obj && Array.isArray(obj.sent)) {
+                for (const k of obj.sent)
+                    if (typeof k === 'string')
+                        this.sentKeys.add(k);
+            }
+        }
+        catch {
+            // Missing or malformed dedup file — start fresh.
+        }
+    }
+    persist() {
+        try {
+            const dir = path.join(this.stateDir, 'local');
+            if (!fs.existsSync(dir))
+                fs.mkdirSync(dir, { recursive: true });
+            // Cap the ring so the file doesn't grow forever.
+            const list = Array.from(this.sentKeys).slice(-DEDUP_RING_SIZE);
+            this.sentKeys = new Set(list);
+            const tmp = this.dedupPath() + '.tmp';
+            fs.writeFileSync(tmp, JSON.stringify({ sent: list }, null, 2), { mode: 0o600 });
+            fs.renameSync(tmp, this.dedupPath());
+        }
+        catch {
+            // Best-effort persistence; in-memory set still works for the lifetime
+            // of the process.
+        }
+    }
+    dedupPath() {
+        return path.join(this.stateDir, 'local', DEDUP_FILE);
+    }
+}
+/** Re-export so tests can clean up the dedup file directly. */
+export { DEDUP_FILE };
+/** Re-export SafeFsExecutor namespace for callers that need to clean up safely. */
+export { SafeFsExecutor };
+//# sourceMappingURL=ProjectRoundCompleteMessage.js.map

package/dist/core/ProjectRoundCompleteMessage.js.map

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

package/dist/core/ProjectRoundExecution.d.ts

@@ -0,0 +1,111 @@
+/**
+ * ProjectRoundExecution — the autonomous run loop for a project round.
+ *
+ * Spec: docs/specs/PROJECT-SCOPE-SPEC.md § Phase 1.5 ("Run loop", steps 1-11).
+ *
+ * What this module is responsible for:
+ *   1. Acquiring the round-runner lock (delegated to ProjectRoundLock).
+ *   2. Spawning the autonomous child process in a detached process
+ *      group, so SIGTERM/SIGKILL of the group never reaps the runner.
+ *   3. Polling the project record every `pollIntervalMs` to detect
+ *      mid-round mutations to the round's itemIds (e.g., a user
+ *      manually skips an item) — when detected, SIGTERM the group
+ *      (5s grace, then SIGKILL) and relaunch with a recomputed stop
+ *      condition.
+ *   4. On the autonomous child's NATURAL exit, verify per-item
+ *      artifacts and set round.status = complete | partially-complete.
+ *   5. Cleanup: `git worktree prune` for the round namespace.
+ *   6. Release the lock.
+ *
+ * What this module is NOT responsible for:
+ *   - The preflight gate. That's `ProjectRoundRunner.preflight`. The
+ *     caller (the auto-advance poller, the /project run-round skill,
+ *     a future HTTP endpoint) is expected to preflight before calling
+ *     `runRound(input)`.
+ *   - Drift checking. Same — preflight handles it.
+ *   - Choosing the autonomous command. The `spawnCommand` is injected,
+ *     defaulting to `claude` (which invokes the local /autonomous skill).
+ *     Tests pass a custom command so they don't depend on the skill.
+ *
+ * Process group safety:
+ *   The child is spawned with `detached: true` so it gets its own
+ *   process group. `kill(-pgid, signal)` (Node passes negative PIDs
+ *   for group signals) targets only the child's group — never reaps
+ *   the runner.
+ */
+import type { InitiativeTracker } from './InitiativeTracker.js';
+/** Per-spec defaults. Tests dial both down to keep the suite fast. */
+export declare const DEFAULT_POLL_INTERVAL_MS = 60000;
+export declare const DEFAULT_SIGTERM_GRACE_MS = 5000;
+/** Resume cap from spec § Phase 1.5 step 11. */
+export declare const DEFAULT_MAX_RESUME_ATTEMPTS = 3;
+export interface RunRoundInput {
+    tracker: InitiativeTracker;
+    projectId: string;
+    roundIndex: number;
+    /**
+     * Absolute target repo path; required (the spec's `targetRepoPath`).
+     * The caller must have verified it points at a git repo (preflight does this).
+     */
+    targetRepoPath: string;
+    /**
+     * `process.cwd()` for the spawned autonomous child. Defaults to the
+     * first item's worktree path. The autonomous child opens additional
+     * worktrees as it works through items.
+     */
+    initialWorkdir?: string;
+    /**
+     * Command + args to spawn. Default is the production invocation:
+     * `claude --skill autonomous` (resolved via PATH). Tests pass a
+     * harmless command (`bash -c "exit 0"`) so the test doesn't actually
+     * invoke claude.
+     *
+     * Stop condition + project/round identifiers are passed via env:
+     *   INSTAR_PROJECT_ID, INSTAR_ROUND_INDEX, INSTAR_STOP_CONDITION
+     *   INSTAR_ROUND_ITEM_IDS (JSON-encoded array)
+     */
+    spawnCommand?: string;
+    spawnArgs?: string[];
+    /** Poll cadence; defaults to 60s. */
+    pollIntervalMs?: number;
+    /** SIGTERM→SIGKILL grace; defaults to 5s. */
+    sigtermGraceMs?: number;
+    /** Max resume attempts on transient failures; defaults to 3. */
+    maxResumeAttempts?: number;
+    /**
+     * Test hook: shell out to verify per-item artifacts. Defaults to a
+     * real `gh pr view` shell-out via SafeGitExecutor. Tests inject a
+     * stub. The function returns the set of itemIds whose artifact
+     * is verified merged-on-main-with-CI-green.
+     */
+    verifyMergedItems?: (childIds: string[]) => Promise<Set<string>>;
+}
+export type RoundOutcome = 'complete' | 'partially-complete' | 'failed' | 'halted';
+export interface RunRoundResult {
+    outcome: RoundOutcome;
+    /** Verified-merged itemIds. */
+    mergedItemIds: string[];
+    /** itemIds that did NOT verify (only populated for partially-complete / halted). */
+    unmergedItemIds: string[];
+    /** Number of times the runner relaunched the child due to dynamic-stop changes. */
+    relaunchCount: number;
+    /** Number of times the round resumed after a transient child failure. */
+    resumeAttempts: number;
+    /** Human-readable reason — useful for halted / failed outcomes. */
+    reason?: string;
+}
+/**
+ * Lock that the runner needs but is too high-level to require here as
+ * a positional parameter. Wires through the standard
+ * `.instar/local/round-runner.lock` location.
+ */
+export interface RunRoundDeps {
+    stateDir: string;
+}
+/**
+ * Run one round to completion. Caller is expected to preflight first.
+ */
+export declare function runRound(input: RunRoundInput, deps: RunRoundDeps): Promise<RunRoundResult>;
+/** Helper exported so callers can wire a SafeGit-backed verifier. */
+export declare function verifyMergedItemsViaGit(targetRepoPath: string, childIds: string[], tracker: InitiativeTracker): Promise<Set<string>>;
+//# sourceMappingURL=ProjectRoundExecution.d.ts.map

package/dist/core/ProjectRoundExecution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProjectRoundExecution.d.ts","sourceRoot":"","sources":["../../src/core/ProjectRoundExecution.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAIH,OAAO,KAAK,EAAc,iBAAiB,EAAe,MAAM,wBAAwB,CAAC;AAKzF,sEAAsE;AACtE,eAAO,MAAM,wBAAwB,QAAS,CAAC;AAC/C,eAAO,MAAM,wBAAwB,OAAQ,CAAC;AAC9C,gDAAgD;AAChD,eAAO,MAAM,2BAA2B,IAAI,CAAC;AAE7C,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,iBAAiB,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,cAAc,EAAE,MAAM,CAAC;IAEvB;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;;;;;;;;OASG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IAErB,qCAAqC;IACrC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,6CAA6C;IAC7C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gEAAgE;IAChE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;CAClE;AAED,MAAM,MAAM,YAAY,GAAG,UAAU,GAAG,oBAAoB,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEnF,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,YAAY,CAAC;IACtB,+BAA+B;IAC/B,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,oFAAoF;IACpF,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,mFAAmF;IACnF,aAAa,EAAE,MAAM,CAAC;IACtB,yEAAyE;IACzE,cAAc,EAAE,MAAM,CAAC;IACvB,mEAAmE;IACnE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAAC,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,cAAc,CAAC,CA2JhG;AAqMD,qEAAqE;AACrE,wBAAsB,uBAAuB,CAC3C,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,EAAE,EAClB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAgBtB"}