instar 1.3.236 → 1.3.237

package/dist/monitoring/GeminiLoopDriver.d.ts

@@ -0,0 +1,112 @@
+/**
+ * GeminiLoopDriver (need-gem-002) — multi-turn re-prompt engine for the Gemini
+ * mentee.
+ *
+ * A one-shot `gemini -p` runs one turn and exits, so a gemini mentee is bounded
+ * to one-shot tasks (the #1 maiden-voyage lesson). Unlike Claude/codex — which
+ * run as persistent hook-capable sessions and re-prompt via the autonomous Stop
+ * hook — gemini runs as one-shots, so the loop is driven EXTERNALLY: each turn
+ * re-spawns `gemini -m <model> -r <handle> -p "<nudge>"`, and gemini restores the
+ * session's full context natively (empirically proven, gemini-cli 0.25.2). That
+ * means the driver re-prompts with only the next instruction — never the
+ * accumulated transcript — which is the quota-efficient design that respects the
+ * no-overspend / subscription-auth rule.
+ *
+ * This is increment 1: the pure engine. Every side effect is INJECTED (the
+ * gemini spawn, the budget gate, the session-handle capture, sleep, clock), so
+ * the loop logic is fully unit-testable with zero real gemini calls / zero
+ * quota. Lifecycle invocation (a route / the apprenticeship machinery calling
+ * `run()`, plus the real `--list-sessions` handle parser) is increment 2.
+ *
+ * Spec: docs/specs/gemini-multi-turn-loop-driver.md
+ */
+/** Outcome of a single gemini spawn (subset of GeminiSpawnResult the loop needs). */
+export interface GeminiLoopSpawnResult {
+    exitCode: number | null;
+    stdout: string;
+    stderr: string;
+    truncated: boolean;
+}
+/**
+ * Injected gemini spawn. Receives the FULL argv (already including `-m`, and on
+ * resume turns `-r <handle>`) and runs gemini, returning the result. The real
+ * impl wraps `spawnGeminiAndWait` + `buildGeminiChildEnv` (which strips every
+ * billing env var → subscription auth is structural). A wiring-integrity test
+ * asserts the real driver routes through that transport, never a raw spawn.
+ */
+export type GeminiLoopSpawn = (argv: string[]) => Promise<GeminiLoopSpawnResult>;
+/**
+ * Injected budget gate — checked BEFORE every turn (including turn 1). `ok:false`
+ * halts the loop immediately (no spawn). The real impl reuses the existing
+ * QuotaTracker / autonomous can-start budget accounting; the engine stays
+ * number-agnostic so the §6 guardrail values live entirely in config/wiring.
+ */
+export type GeminiLoopBudgetGate = () => {
+    ok: boolean;
+    reason?: string;
+};
+/**
+ * Capture the stable session handle created by turn 1 (the real impl parses
+ * `gemini --list-sessions` for the newest row in the loop's dedicated cwd).
+ * Returns `null` when the handle cannot be resolved — in which case the loop
+ * ABORTS rather than silently falling back to `latest` (which could resume a
+ * foreign session). Injected so the engine never depends on parsing in tests.
+ */
+export type GeminiLoopHandleCapture = (turn1: GeminiLoopSpawnResult) => Promise<string | null>;
+export interface GeminiLoopDriverDeps {
+    spawn: GeminiLoopSpawn;
+    captureHandle: GeminiLoopHandleCapture;
+    budgetGate?: GeminiLoopBudgetGate;
+    /** Injectable for tests (default: real timer). */
+    sleep?: (ms: number) => Promise<void>;
+    /** Injectable clock (default: Date.now). */
+    now?: () => number;
+}
+export interface GeminiLoopRunOptions {
+    model: string;
+    /** The goal / framing for turn 1. */
+    goalPrompt: string;
+    /** Hard cap on total turns (including turn 1). Clamped to >= 1. */
+    maxTurns: number;
+    /** Token the mentee emits when the goal is complete. Default GEMINI_LOOP_DONE. */
+    doneSentinel?: string;
+    /** Continuation instruction sent on turns 2..N (context is already resumed). */
+    continuationPrompt?: string;
+    /** Min ms between turn spawns (anti-spin). Default 0. */
+    minTurnIntervalMs?: number;
+}
+export interface GeminiLoopTurn {
+    turn: number;
+    argv: string[];
+    exitCode: number | null;
+    stdout: string;
+    stderr: string;
+    truncated: boolean;
+    /** True when the doneSentinel appeared in this turn's stdout. */
+    done: boolean;
+}
+export type GeminiLoopStopReason = 'done-sentinel' | 'max-turns' | 'budget-halt' | 'spawn-failure' | 'handle-capture-failure';
+export interface GeminiLoopResult {
+    sessionHandle: string | null;
+    turns: GeminiLoopTurn[];
+    stopReason: GeminiLoopStopReason;
+    /** stdout of the last spawned turn ('' if none ran). */
+    finalOutput: string;
+    /** Reason text from the budget gate when stopReason === 'budget-halt'. */
+    haltReason?: string;
+}
+export declare const DEFAULT_DONE_SENTINEL = "GEMINI_LOOP_DONE";
+export declare class GeminiLoopDriver {
+    private readonly spawn;
+    private readonly captureHandle;
+    private readonly budgetGate;
+    private readonly sleep;
+    constructor(deps: GeminiLoopDriverDeps);
+    /**
+     * Drive a multi-turn gemini task to one of: done-sentinel, max-turns,
+     * budget-halt, spawn-failure, or handle-capture-failure. Pure orchestration —
+     * no I/O except via the injected deps.
+     */
+    run(opts: GeminiLoopRunOptions): Promise<GeminiLoopResult>;
+}
+//# sourceMappingURL=GeminiLoopDriver.d.ts.map

package/dist/monitoring/GeminiLoopDriver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GeminiLoopDriver.d.ts","sourceRoot":"","sources":["../../src/monitoring/GeminiLoopDriver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAOH,qFAAqF;AACrF,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;GAMG;AACH,MAAM,MAAM,eAAe,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,qBAAqB,CAAC,CAAC;AAEjF;;;;;GAKG;AACH,MAAM,MAAM,oBAAoB,GAAG,MAAM;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1E;;;;;;GAMG;AACH,MAAM,MAAM,uBAAuB,GAAG,CACpC,KAAK,EAAE,qBAAqB,KACzB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;AAE5B,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,eAAe,CAAC;IACvB,aAAa,EAAE,uBAAuB,CAAC;IACvC,UAAU,CAAC,EAAE,oBAAoB,CAAC;IAClC,kDAAkD;IAClD,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,4CAA4C;IAC5C,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,MAAM,CAAC;IACd,qCAAqC;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,mEAAmE;IACnE,QAAQ,EAAE,MAAM,CAAC;IACjB,kFAAkF;IAClF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gFAAgF;IAChF,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,yDAAyD;IACzD,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;IACnB,iEAAiE;IACjE,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,MAAM,oBAAoB,GAC5B,eAAe,GACf,WAAW,GACX,aAAa,GACb,eAAe,GACf,wBAAwB,CAAC;AAE7B,MAAM,WAAW,gBAAgB;IAC/B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,UAAU,EAAE,oBAAoB,CAAC;IACjC,wDAAwD;IACxD,WAAW,EAAE,MAAM,CAAC;IACpB,0EAA0E;IAC1E,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,qBAAqB,qBAAqB,CAAC;AAMxD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAkB;IACxC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA0B;IACxD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAuB;IAClD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgC;gBAE1C,IAAI,EAAE,oBAAoB;IAOtC;;;;OAIG;IACG,GAAG,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,gBAAgB,CAAC;CA4EjE"}

package/dist/monitoring/GeminiLoopDriver.js

@@ -0,0 +1,111 @@
+/**
+ * GeminiLoopDriver (need-gem-002) — multi-turn re-prompt engine for the Gemini
+ * mentee.
+ *
+ * A one-shot `gemini -p` runs one turn and exits, so a gemini mentee is bounded
+ * to one-shot tasks (the #1 maiden-voyage lesson). Unlike Claude/codex — which
+ * run as persistent hook-capable sessions and re-prompt via the autonomous Stop
+ * hook — gemini runs as one-shots, so the loop is driven EXTERNALLY: each turn
+ * re-spawns `gemini -m <model> -r <handle> -p "<nudge>"`, and gemini restores the
+ * session's full context natively (empirically proven, gemini-cli 0.25.2). That
+ * means the driver re-prompts with only the next instruction — never the
+ * accumulated transcript — which is the quota-efficient design that respects the
+ * no-overspend / subscription-auth rule.
+ *
+ * This is increment 1: the pure engine. Every side effect is INJECTED (the
+ * gemini spawn, the budget gate, the session-handle capture, sleep, clock), so
+ * the loop logic is fully unit-testable with zero real gemini calls / zero
+ * quota. Lifecycle invocation (a route / the apprenticeship machinery calling
+ * `run()`, plus the real `--list-sessions` handle parser) is increment 2.
+ *
+ * Spec: docs/specs/gemini-multi-turn-loop-driver.md
+ */
+import { buildGeminiOneShotArgv, buildGeminiResumeArgv, } from '../providers/adapters/gemini-cli/transport/geminiSpawn.js';
+export const DEFAULT_DONE_SENTINEL = 'GEMINI_LOOP_DONE';
+const DEFAULT_CONTINUATION = 'Continue toward the goal. If the goal is now fully complete, end your reply ' +
+    `with the exact token ${DEFAULT_DONE_SENTINEL} on its own line.`;
+export class GeminiLoopDriver {
+    spawn;
+    captureHandle;
+    budgetGate;
+    sleep;
+    constructor(deps) {
+        this.spawn = deps.spawn;
+        this.captureHandle = deps.captureHandle;
+        this.budgetGate = deps.budgetGate ?? (() => ({ ok: true }));
+        this.sleep = deps.sleep ?? ((ms) => new Promise((r) => setTimeout(r, ms)));
+    }
+    /**
+     * Drive a multi-turn gemini task to one of: done-sentinel, max-turns,
+     * budget-halt, spawn-failure, or handle-capture-failure. Pure orchestration —
+     * no I/O except via the injected deps.
+     */
+    async run(opts) {
+        const maxTurns = Math.max(1, Math.floor(opts.maxTurns));
+        const doneSentinel = opts.doneSentinel ?? DEFAULT_DONE_SENTINEL;
+        const continuation = opts.continuationPrompt ?? DEFAULT_CONTINUATION;
+        const minInterval = Math.max(0, opts.minTurnIntervalMs ?? 0);
+        const turns = [];
+        // --- Turn 1 (one-shot; establishes the session) ---
+        const gate0 = this.budgetGate();
+        if (!gate0.ok) {
+            return {
+                sessionHandle: null,
+                turns,
+                stopReason: 'budget-halt',
+                finalOutput: '',
+                haltReason: gate0.reason,
+            };
+        }
+        const argv1 = buildGeminiOneShotArgv(opts.model, opts.goalPrompt);
+        const r1 = await this.spawn(argv1);
+        const done1 = r1.stdout.includes(doneSentinel);
+        turns.push({ turn: 1, argv: argv1, ...r1, done: done1 });
+        if (r1.exitCode !== 0) {
+            return { sessionHandle: null, turns, stopReason: 'spawn-failure', finalOutput: r1.stdout };
+        }
+        if (done1) {
+            return { sessionHandle: null, turns, stopReason: 'done-sentinel', finalOutput: r1.stdout };
+        }
+        // --- Capture the stable handle (abort, never fall back to 'latest') ---
+        const handle = await this.captureHandle(r1);
+        if (!handle) {
+            return {
+                sessionHandle: null,
+                turns,
+                stopReason: 'handle-capture-failure',
+                finalOutput: r1.stdout,
+            };
+        }
+        // --- Turns 2..maxTurns (resume by stable handle) ---
+        let lastOutput = r1.stdout;
+        for (let turn = 2; turn <= maxTurns; turn++) {
+            const gate = this.budgetGate();
+            if (!gate.ok) {
+                return {
+                    sessionHandle: handle,
+                    turns,
+                    stopReason: 'budget-halt',
+                    finalOutput: lastOutput,
+                    haltReason: gate.reason,
+                };
+            }
+            if (minInterval > 0) {
+                await this.sleep(minInterval);
+            }
+            const argv = buildGeminiResumeArgv(opts.model, handle, continuation);
+            const r = await this.spawn(argv);
+            const done = r.stdout.includes(doneSentinel);
+            turns.push({ turn, argv, ...r, done });
+            lastOutput = r.stdout;
+            if (r.exitCode !== 0) {
+                return { sessionHandle: handle, turns, stopReason: 'spawn-failure', finalOutput: r.stdout };
+            }
+            if (done) {
+                return { sessionHandle: handle, turns, stopReason: 'done-sentinel', finalOutput: r.stdout };
+            }
+        }
+        return { sessionHandle: handle, turns, stopReason: 'max-turns', finalOutput: lastOutput };
+    }
+}
+//# sourceMappingURL=GeminiLoopDriver.js.map

package/dist/monitoring/GeminiLoopDriver.js.map

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

package/dist/monitoring/ParallelWorkOverlap.d.ts

@@ -0,0 +1,59 @@
+/**
+ * ParallelWorkOverlap — the pure cross-topic overlap detector that the
+ * ParallelWorkSentinel (Phase B) runs on a cadence (docs/specs/parallel-activity-coherence.md).
+ *
+ * Convergence hardened this against false-positive nudges (a noisy councilor gets
+ * muted, which is worse than silence). The containment lives HERE, in pure logic:
+ *  - ACTIVITY GATE: only topics worked within a recent window are compared (a dormant
+ *    overlap is not a live duplication risk — mirrors BurnDetector's activity gate).
+ *  - SPECIFICITY: overlap rests on shared HIGH-SPECIFICITY tags (entities/files/identifiers,
+ *    already filtered of boilerplate by extractTags) and requires ≥ minSharedSpecific of
+ *    them — never on generic words. Rarer shared tags weigh more (IDF over the candidate set).
+ *  - SELF-EXCLUSION: a topic never matches itself.
+ *  - SIGNATURE: the sorted shared-tag SET — the dedup key the sentinel uses (with hysteresis)
+ *    so a slowly-evolving focus does not re-nag and a genuinely new overlap is not suppressed.
+ *
+ * This module is PURE (no I/O, no time except the injected nowMs) so it is exhaustively
+ * unit-testable. The stateful dedup/cooldown/cadence/nudge lives in the sentinel.
+ */
+/** The subset of a TopicActivity this detector needs (structurally compatible with ParallelActivityIndex output). */
+export interface OverlapCandidate {
+    topicId: number;
+    tags: string[];
+    updatedAt: number | null;
+    running?: boolean;
+}
+export interface OverlapPair {
+    /** Lower topicId first (stable pair key). */
+    topicA: number;
+    topicB: number;
+    /** The high-specificity tokens both topics share (the genuine overlap). */
+    sharedTags: string[];
+    /** IDF-weighted overlap strength over the candidate set; higher = rarer shared tokens. */
+    score: number;
+    /** Sorted sharedTags joined — the dedup signature (the sentinel keys cooldown on the PAIR, hysteresis on this). */
+    signature: string;
+}
+export interface DetectOverlapsOptions {
+    nowMs: number;
+    /** Only compare topics whose updatedAt is within this window (default 4h). Null updatedAt ⇒ excluded. */
+    activityWindowMs?: number;
+    /** Require at least this many shared high-specificity tags (default 1). */
+    minSharedSpecific?: number;
+    /** When true, at least ONE side of each pair must be currently running (default true — we nudge live work). */
+    requireRunning?: boolean;
+}
+/**
+ * Detect overlapping work across topics. Returns one OverlapPair per genuinely-overlapping
+ * pair, strongest first. Pure: same inputs → same output.
+ */
+export declare function detectOverlaps(candidates: OverlapCandidate[], opts: DetectOverlapsOptions): OverlapPair[];
+/** Stable pair key for sentinel-side cooldown (survives focus edits / signature drift). */
+export declare function pairKey(topicA: number, topicB: number): string;
+/**
+ * Hysteresis: should a NEW overlap signature for an already-nudged pair re-fire? Only when
+ * the shared-tag set has changed materially (Jaccard(old,new) < threshold) — so a one-token
+ * focus tweak does not re-nag, but a genuinely different overlap does.
+ */
+export declare function signatureChangedMaterially(oldSig: string, newSig: string, jaccardThreshold?: number): boolean;
+//# sourceMappingURL=ParallelWorkOverlap.d.ts.map

package/dist/monitoring/ParallelWorkOverlap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ParallelWorkOverlap.d.ts","sourceRoot":"","sources":["../../src/monitoring/ParallelWorkOverlap.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,qHAAqH;AACrH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,2EAA2E;IAC3E,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,0FAA0F;IAC1F,KAAK,EAAE,MAAM,CAAC;IACd,mHAAmH;IACnH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,yGAAyG;IACzG,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,2EAA2E;IAC3E,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,+GAA+G;IAC/G,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAID;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,UAAU,EAAE,gBAAgB,EAAE,EAC9B,IAAI,EAAE,qBAAqB,GAC1B,WAAW,EAAE,CAqCf;AAED,2FAA2F;AAC3F,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,SAAM,GAAG,OAAO,CAU1G"}

package/dist/monitoring/ParallelWorkOverlap.js

@@ -0,0 +1,86 @@
+/**
+ * ParallelWorkOverlap — the pure cross-topic overlap detector that the
+ * ParallelWorkSentinel (Phase B) runs on a cadence (docs/specs/parallel-activity-coherence.md).
+ *
+ * Convergence hardened this against false-positive nudges (a noisy councilor gets
+ * muted, which is worse than silence). The containment lives HERE, in pure logic:
+ *  - ACTIVITY GATE: only topics worked within a recent window are compared (a dormant
+ *    overlap is not a live duplication risk — mirrors BurnDetector's activity gate).
+ *  - SPECIFICITY: overlap rests on shared HIGH-SPECIFICITY tags (entities/files/identifiers,
+ *    already filtered of boilerplate by extractTags) and requires ≥ minSharedSpecific of
+ *    them — never on generic words. Rarer shared tags weigh more (IDF over the candidate set).
+ *  - SELF-EXCLUSION: a topic never matches itself.
+ *  - SIGNATURE: the sorted shared-tag SET — the dedup key the sentinel uses (with hysteresis)
+ *    so a slowly-evolving focus does not re-nag and a genuinely new overlap is not suppressed.
+ *
+ * This module is PURE (no I/O, no time except the injected nowMs) so it is exhaustively
+ * unit-testable. The stateful dedup/cooldown/cadence/nudge lives in the sentinel.
+ */
+const DEFAULT_WINDOW_MS = 4 * 60 * 60 * 1000; // 4h
+/**
+ * Detect overlapping work across topics. Returns one OverlapPair per genuinely-overlapping
+ * pair, strongest first. Pure: same inputs → same output.
+ */
+export function detectOverlaps(candidates, opts) {
+    const windowMs = opts.activityWindowMs ?? DEFAULT_WINDOW_MS;
+    const minShared = opts.minSharedSpecific ?? 1;
+    const requireRunning = opts.requireRunning ?? true;
+    const cutoff = opts.nowMs - windowMs;
+    // Activity gate: only recently-worked topics with at least one specific tag.
+    const active = candidates.filter((c) => c.updatedAt !== null && c.updatedAt >= cutoff && c.tags.length > 0);
+    // IDF: a tag shared by FEW topics is more meaningful than one shared by many.
+    const docFreq = new Map();
+    for (const c of active)
+        for (const t of new Set(c.tags))
+            docFreq.set(t, (docFreq.get(t) ?? 0) + 1);
+    const idf = (tag) => {
+        const df = docFreq.get(tag) ?? 1;
+        return Math.log(1 + active.length / df); // rarer ⇒ higher
+    };
+    const pairs = [];
+    for (let i = 0; i < active.length; i++) {
+        for (let j = i + 1; j < active.length; j++) {
+            const a = active[i];
+            const b = active[j];
+            if (a.topicId === b.topicId)
+                continue; // self-exclusion (defensive)
+            if (requireRunning && !a.running && !b.running)
+                continue;
+            const bTags = new Set(b.tags);
+            const shared = [...new Set(a.tags)].filter((t) => bTags.has(t));
+            if (shared.length < minShared)
+                continue;
+            const score = shared.reduce((s, t) => s + idf(t), 0);
+            const sorted = [...shared].sort();
+            const [topicA, topicB] = a.topicId < b.topicId ? [a.topicId, b.topicId] : [b.topicId, a.topicId];
+            pairs.push({ topicA, topicB, sharedTags: sorted, score, signature: sorted.join('|') });
+        }
+    }
+    pairs.sort((x, y) => y.score - x.score);
+    return pairs;
+}
+/** Stable pair key for sentinel-side cooldown (survives focus edits / signature drift). */
+export function pairKey(topicA, topicB) {
+    return topicA < topicB ? `${topicA}:${topicB}` : `${topicB}:${topicA}`;
+}
+/**
+ * Hysteresis: should a NEW overlap signature for an already-nudged pair re-fire? Only when
+ * the shared-tag set has changed materially (Jaccard(old,new) < threshold) — so a one-token
+ * focus tweak does not re-nag, but a genuinely different overlap does.
+ */
+export function signatureChangedMaterially(oldSig, newSig, jaccardThreshold = 0.6) {
+    if (oldSig === newSig)
+        return false;
+    const a = new Set(oldSig ? oldSig.split('|') : []);
+    const b = new Set(newSig ? newSig.split('|') : []);
+    if (a.size === 0 && b.size === 0)
+        return false;
+    let inter = 0;
+    for (const t of a)
+        if (b.has(t))
+            inter++;
+    const union = a.size + b.size - inter;
+    const jaccard = union === 0 ? 1 : inter / union;
+    return jaccard < jaccardThreshold;
+}
+//# sourceMappingURL=ParallelWorkOverlap.js.map

package/dist/monitoring/ParallelWorkOverlap.js.map

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

package/dist/monitoring/ParallelWorkSentinel.d.ts

@@ -0,0 +1,59 @@
+/**
+ * ParallelWorkSentinel — the proactive overlap councilor (Parallel-Work Awareness
+ * Phase B; docs/specs/parallel-activity-coherence.md, Part 2).
+ *
+ * On a cadence it reads the cross-topic activity index, runs the pure overlap detector,
+ * and — for genuinely-fresh overlaps — emits ONE 'overlap' nudge so the agent learns its
+ * other hand is already on the same work (the willpower-trap fix: the signal comes TO the
+ * agent, it doesn't rely on the agent remembering to query). SIGNAL-ONLY — it never gates,
+ * blocks, or mutates anything.
+ *
+ * Convergence-mandated containment (a noisy councilor gets muted, which is worse than
+ * silence), all enforced here statefully on top of the pure detector's containment:
+ *  - PAIR-KEYED COOLDOWN: at most one nudge per (topicA,topicB) per `nudgeCooldownMs`
+ *    (default 60min) — survives focus edits, so responding to a nudge can't re-trigger it.
+ *  - SIGNATURE HYSTERESIS: within the cooldown, a re-nudge only fires if the shared-tag SET
+ *    changed materially (a genuinely new overlap), not on a one-token focus tweak.
+ *  - It is the LEASE-HOLDER's job to run this (the caller gates ticks on holdsLease) so the
+ *    same overlap isn't nudged twice from two machines.
+ *
+ * Ships DARK (the route/config default is enabled:false) — graduate after it's proven quiet.
+ */
+import { EventEmitter } from 'node:events';
+import { type OverlapCandidate, type OverlapPair } from './ParallelWorkOverlap.js';
+export interface ParallelWorkSentinelOptions {
+    /** Pull the current cross-topic activities (e.g. ParallelActivityIndex.activities()). */
+    getActivities: (nowMs: number) => OverlapCandidate[];
+    /** Min ms between nudges for the same topic pair (default 60min). */
+    nudgeCooldownMs?: number;
+    /** Only compare topics worked within this window (passed to the detector; default 4h). */
+    activityWindowMs?: number;
+    /** Require ≥ this many shared high-specificity tags (default 1). */
+    minSharedSpecific?: number;
+    /** Audit sink for every transition (detected/nudged/deduped) — default-on housekeeping. */
+    audit?: (event: ParallelWorkAuditEvent) => void;
+}
+export interface ParallelWorkAuditEvent {
+    kind: 'nudged' | 'deduped-cooldown' | 'deduped-hysteresis';
+    pair: OverlapPair;
+    atMs: number;
+}
+/** Emitted to the agent when a fresh overlap is found. The one user-facing signal. */
+export interface OverlapNudge {
+    pair: OverlapPair;
+    atMs: number;
+    message: string;
+}
+export interface ParallelWorkSentinelEvents {
+    overlap: [nudge: OverlapNudge];
+}
+export declare class ParallelWorkSentinel extends EventEmitter {
+    private readonly opts;
+    private readonly state;
+    constructor(opts: ParallelWorkSentinelOptions);
+    /** Run one cadence tick. Pure-ish: side effects are the emitted nudges + the audit sink. */
+    tick(nowMs: number): OverlapNudge[];
+    /** Test/inspection helper: how many pairs are being tracked for dedup. */
+    trackedPairCount(): number;
+}
+//# sourceMappingURL=ParallelWorkSentinel.d.ts.map

package/dist/monitoring/ParallelWorkSentinel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ParallelWorkSentinel.d.ts","sourceRoot":"","sources":["../../src/monitoring/ParallelWorkSentinel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAIL,KAAK,gBAAgB,EACrB,KAAK,WAAW,EACjB,MAAM,0BAA0B,CAAC;AAElC,MAAM,WAAW,2BAA2B;IAC1C,yFAAyF;IACzF,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,gBAAgB,EAAE,CAAC;IACrD,qEAAqE;IACrE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,0FAA0F;IAC1F,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,oEAAoE;IACpE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,2FAA2F;IAC3F,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,sBAAsB,KAAK,IAAI,CAAC;CACjD;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,QAAQ,GAAG,kBAAkB,GAAG,oBAAoB,CAAC;IAC3D,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,sFAAsF;AACtF,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAOD,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC;CAChC;AAED,qBAAa,oBAAqB,SAAQ,YAAY;IAGxC,OAAO,CAAC,QAAQ,CAAC,IAAI;IAFjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAgC;gBAEzB,IAAI,EAAE,2BAA2B;IAI9D,4FAA4F;IAC5F,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,EAAE;IA6CnC,0EAA0E;IAC1E,gBAAgB,IAAI,MAAM;CAG3B"}

package/dist/monitoring/ParallelWorkSentinel.js

@@ -0,0 +1,79 @@
+/**
+ * ParallelWorkSentinel — the proactive overlap councilor (Parallel-Work Awareness
+ * Phase B; docs/specs/parallel-activity-coherence.md, Part 2).
+ *
+ * On a cadence it reads the cross-topic activity index, runs the pure overlap detector,
+ * and — for genuinely-fresh overlaps — emits ONE 'overlap' nudge so the agent learns its
+ * other hand is already on the same work (the willpower-trap fix: the signal comes TO the
+ * agent, it doesn't rely on the agent remembering to query). SIGNAL-ONLY — it never gates,
+ * blocks, or mutates anything.
+ *
+ * Convergence-mandated containment (a noisy councilor gets muted, which is worse than
+ * silence), all enforced here statefully on top of the pure detector's containment:
+ *  - PAIR-KEYED COOLDOWN: at most one nudge per (topicA,topicB) per `nudgeCooldownMs`
+ *    (default 60min) — survives focus edits, so responding to a nudge can't re-trigger it.
+ *  - SIGNATURE HYSTERESIS: within the cooldown, a re-nudge only fires if the shared-tag SET
+ *    changed materially (a genuinely new overlap), not on a one-token focus tweak.
+ *  - It is the LEASE-HOLDER's job to run this (the caller gates ticks on holdsLease) so the
+ *    same overlap isn't nudged twice from two machines.
+ *
+ * Ships DARK (the route/config default is enabled:false) — graduate after it's proven quiet.
+ */
+import { EventEmitter } from 'node:events';
+import { detectOverlaps, pairKey, signatureChangedMaterially, } from './ParallelWorkOverlap.js';
+export class ParallelWorkSentinel extends EventEmitter {
+    opts;
+    state = new Map();
+    constructor(opts) {
+        super();
+        this.opts = opts;
+    }
+    /** Run one cadence tick. Pure-ish: side effects are the emitted nudges + the audit sink. */
+    tick(nowMs) {
+        const activities = this.opts.getActivities(nowMs);
+        const pairs = detectOverlaps(activities, {
+            nowMs,
+            activityWindowMs: this.opts.activityWindowMs,
+            minSharedSpecific: this.opts.minSharedSpecific,
+            requireRunning: true,
+        });
+        const cooldown = this.opts.nudgeCooldownMs ?? 60 * 60 * 1000;
+        const fired = [];
+        for (const pair of pairs) {
+            const key = pairKey(pair.topicA, pair.topicB);
+            const prev = this.state.get(key);
+            if (prev) {
+                const withinCooldown = nowMs - prev.lastNudgedMs < cooldown;
+                if (withinCooldown && !signatureChangedMaterially(prev.lastSignature, pair.signature)) {
+                    this.opts.audit?.({ kind: 'deduped-hysteresis', pair, atMs: nowMs });
+                    // refresh the stored signature (track drift) but do NOT re-nudge
+                    this.state.set(key, { lastSignature: pair.signature, lastNudgedMs: prev.lastNudgedMs });
+                    continue;
+                }
+                if (withinCooldown && signatureChangedMaterially(prev.lastSignature, pair.signature)) {
+                    // Material change but still inside the cooldown window: suppress, record drift.
+                    this.opts.audit?.({ kind: 'deduped-cooldown', pair, atMs: nowMs });
+                    this.state.set(key, { lastSignature: pair.signature, lastNudgedMs: prev.lastNudgedMs });
+                    continue;
+                }
+            }
+            // Fresh (never nudged, or past cooldown) → nudge.
+            this.state.set(key, { lastSignature: pair.signature, lastNudgedMs: nowMs });
+            const nudge = {
+                pair,
+                atMs: nowMs,
+                message: `Heads up: topics ${pair.topicA} and ${pair.topicB} look like overlapping work ` +
+                    `(shared: ${pair.sharedTags.join(', ')}). You may be duplicating — worth aligning before you go further.`,
+            };
+            this.opts.audit?.({ kind: 'nudged', pair, atMs: nowMs });
+            this.emit('overlap', nudge);
+            fired.push(nudge);
+        }
+        return fired;
+    }
+    /** Test/inspection helper: how many pairs are being tracked for dedup. */
+    trackedPairCount() {
+        return this.state.size;
+    }
+}
+//# sourceMappingURL=ParallelWorkSentinel.js.map

package/dist/monitoring/ParallelWorkSentinel.js.map

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

package/dist/providers/adapters/gemini-cli/transport/geminiSpawn.d.ts

@@ -36,6 +36,20 @@ export declare const DEFAULT_MAX_OUTPUT_BYTES: number;
  *   `--sandbox read-only` pin at the call site.)
  */
 export declare function buildGeminiOneShotArgv(model: string, prompt: string): string[];
+/**
+ * Argv for a RESUME turn — continue an existing gemini session by its stable
+ * handle (a session UUID, or `latest`/index per `gemini --resume`).
+ *
+ * Empirically proven (gemini-cli 0.25.2, 2026-06-04): `gemini -m <model> -r
+ * <uuid> -p "<next>"` restores the full prior context of that session across a
+ * SEPARATE process invocation — so a multi-turn driver re-prompts with only the
+ * next instruction, never the accumulated transcript (the quota-efficient path;
+ * see `docs/specs/gemini-multi-turn-loop-driver.md`). The explicit `-m` is kept
+ * because it ALSO bypasses gemini-cli's flaky pre-turn ModelRouterService
+ * classifier (`generateJson` can exhaust retries on invalid-content and kill the
+ * turn pre-generation); mirroring `buildGeminiOneShotArgv` keeps that bypass.
+ */
+export declare function buildGeminiResumeArgv(model: string, sessionHandle: string, prompt: string): string[];
 /**
  * The Google/Gemini billing-capable vars that are UNCONDITIONALLY deleted
  * from the child env, regardless of allowlist contents. Any of these present

package/dist/providers/adapters/gemini-cli/transport/geminiSpawn.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"geminiSpawn.d.ts","sourceRoot":"","sources":["../../../../../src/providers/adapters/gemini-cli/transport/geminiSpawn.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH;qDACqD;AACrD,eAAO,MAAM,wBAAwB,QAAkB,CAAC;AAExD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAE9E;AAyCD;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB,sIAM1B,CAAC;AAEX;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,GAAE,MAAM,CAAC,UAAwB,GACzC,MAAM,CAAC,UAAU,CAiBnB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,6EAA6E;IAC7E,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,8DAA8D;IAC9D,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;GASG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,iBAAiB,CAAC,CAsG5B"}
+{"version":3,"file":"geminiSpawn.d.ts","sourceRoot":"","sources":["../../../../../src/providers/adapters/gemini-cli/transport/geminiSpawn.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH;qDACqD;AACrD,eAAO,MAAM,wBAAwB,QAAkB,CAAC;AAExD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAE9E;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,MAAM,EACb,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,MAAM,GACb,MAAM,EAAE,CAEV;AAyCD;;;;;;;GAOG;AACH,eAAO,MAAM,uBAAuB,sIAM1B,CAAC;AAEX;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,GAAE,MAAM,CAAC,UAAwB,GACzC,MAAM,CAAC,UAAU,CAiBnB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,6EAA6E;IAC7E,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,8DAA8D;IAC9D,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;;GASG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,iBAAiB,CAAC,CAsG5B"}

package/dist/providers/adapters/gemini-cli/transport/geminiSpawn.js

@@ -39,6 +39,22 @@ export const DEFAULT_MAX_OUTPUT_BYTES = 8 * 1024 * 1024;
 export function buildGeminiOneShotArgv(model, prompt) {
     return ['-m', model, '--approval-mode', 'default', '-p', prompt];
 }
+/**
+ * Argv for a RESUME turn — continue an existing gemini session by its stable
+ * handle (a session UUID, or `latest`/index per `gemini --resume`).
+ *
+ * Empirically proven (gemini-cli 0.25.2, 2026-06-04): `gemini -m <model> -r
+ * <uuid> -p "<next>"` restores the full prior context of that session across a
+ * SEPARATE process invocation — so a multi-turn driver re-prompts with only the
+ * next instruction, never the accumulated transcript (the quota-efficient path;
+ * see `docs/specs/gemini-multi-turn-loop-driver.md`). The explicit `-m` is kept
+ * because it ALSO bypasses gemini-cli's flaky pre-turn ModelRouterService
+ * classifier (`generateJson` can exhaust retries on invalid-content and kill the
+ * turn pre-generation); mirroring `buildGeminiOneShotArgv` keeps that bypass.
+ */
+export function buildGeminiResumeArgv(model, sessionHandle, prompt) {
+    return ['-m', model, '-r', sessionHandle, '--approval-mode', 'default', '-p', prompt];
+}
 /**
  * Rule-1a analog — env allowlist for Gemini child processes.
  *

package/dist/providers/adapters/gemini-cli/transport/geminiSpawn.js.map

@@ -1 +1 @@
-{"version":3,"file":"geminiSpawn.js","sourceRoot":"","sources":["../../../../../src/providers/adapters/gemini-cli/transport/geminiSpawn.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"geminiSpawn.js","sourceRoot":"","sources":["../../../../../src/providers/adapters/gemini-cli/transport/geminiSpawn.ts"],"names":[],"mappings":"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"}

package/dist/scaffold/templates.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/scaffold/templates.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,CAgG/D;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CA2E/F;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAiBvD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CA2B1D;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,OAAO,EACpB,WAAW,GAAE,OAAe,EAC5B,WAAW,GAAE,OAAe,GAC3B,MAAM,CAiwCR;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,OAAO,EACpB,WAAW,GAAE,OAAe,GAC3B,MAAM,CAuSR"}
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/scaffold/templates.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,CAgG/D;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CA2E/F;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAiBvD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CA2B1D;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,OAAO,EACpB,WAAW,GAAE,OAAe,EAC5B,WAAW,GAAE,OAAe,GAC3B,MAAM,CAqwCR;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,OAAO,EACpB,WAAW,GAAE,OAAe,GAC3B,MAAM,CAuSR"}