instar 1.3.774 → 1.3.776

package/dist/core/OrchestratorActuator.d.ts

@@ -0,0 +1,90 @@
+/**
+ * OrchestratorActuator — the guarded actuation layer for the seamless orchestrator
+ * (spec: llm-seamlessness-orchestrator.md, Phase 2 + Phase 3 dry-run gate).
+ *
+ * The engine (SeamlessOrchestratorEngine) PRODUCES proposals; this layer decides whether
+ * each one may act, AUDITS the decision BEFORE acting (so a crash mid-action leaves a
+ * trace), and — for the ONE ever-auto action, a side-effect-free `auto-prefetch` — executes
+ * it via the working-set fetch. A `placement-signal` NEVER moves anything: it only writes
+ * structured evidence into the deterministic planner's policy input (the planner alone
+ * decides moves, F3).
+ *
+ * Actuation guards (Design §Actuation guards), applied to EVERY proposal:
+ *  - Re-validate at execute (compare-and-act): a stale read is never ground truth — live
+ *    ownership/pin/episode is re-checked here, not trusted from the engine's read time.
+ *  - Yield to failure-movement: refuse any proposal for a topic in an active stale-owner-
+ *    release / lease-handback / lease-flap / splitBrain episode (failure movement wins).
+ *  - Respect pins + provenance: never actuate for a `pinned` or recently-user-moved topic.
+ *  - Audit-BEFORE-actuate to `logs/orchestrator-actions.jsonl` (machine-local).
+ *
+ * `auto-prefetch` side-effect-free contract (Design §invariants): bounded by a per-window
+ * disk-byte budget; inherits the coordinator's secretFlagged/tooLarge/oversized refusals;
+ * only a local copy lands (no ownership/lease mutation). Enforced here via the budget check
+ * + the injected fetch seam (which carries the coordinator's own refusals).
+ *
+ * dryRun (P3 soak): every admissible proposal is logged as `would-actuate` and actuates
+ * NOTHING. The dry-run audit trail IS the soak evidence for the operator-only live flip.
+ */
+import type { OrchestratorAction, OrchestratorAuthority, OrchestratorProposal } from './SeamlessOrchestratorEngine.js';
+/** Live placement facts for a topic, re-read at execute time (compare-and-act). */
+export interface TopicPlacementView {
+    pinned: boolean;
+    /** the topic was moved by the user recently (provenance) — never override a human move. */
+    recentlyUserMoved: boolean;
+    /** the topic is in an active stale-owner-release / lease-handback / lease-flap / splitBrain episode. */
+    inFailureEpisode: boolean;
+}
+/** The outcome of a real working-set fetch (mirrors the coordinator's FetchOutcome shape, loosely). */
+export interface FetchOutcome {
+    ok: boolean;
+    skipReason?: string;
+    bytes?: number;
+}
+/** One machine-local audit row (logs/orchestrator-actions.jsonl). */
+export interface ActuationAuditEntry {
+    ts: string;
+    action: OrchestratorAction;
+    targetTopic: number;
+    detail: string;
+    authorityLevel: OrchestratorAuthority;
+    decision: ActuationDecision;
+    refusalReason?: string;
+    dryRun: boolean;
+    bytes?: number;
+}
+export type ActuationDecision = 'would-actuate' | 'actuated' | 'refused' | 'signal-recorded' | 'would-signal';
+export interface ActuatorDeps {
+    /** re-validate at execute (compare-and-act) — live ownership/pin/episode for the topic. */
+    revalidate(topic: number): TopicPlacementView;
+    /** remaining per-window disk-byte budget for auto-prefetch. */
+    budgetRemainingBytes(): number;
+    /** estimated bytes a preload would land (from the working-set record size). */
+    estimatedBytes(proposal: OrchestratorProposal): number;
+    /** the real fetch — invoked ONLY in live mode for an admitted auto-prefetch. Carries the coordinator's refusals. */
+    fetchWorkingSet(topic: number): Promise<FetchOutcome>;
+    /** write structured evidence into the deterministic planner's policy input (placement-signal, live mode). */
+    recordPlacementSignal(proposal: OrchestratorProposal): void;
+    /** audit-BEFORE-actuate (machine-local JSONL append). */
+    audit(entry: ActuationAuditEntry): void;
+    now?: () => string;
+    log?: (msg: string) => void;
+    config: {
+        dryRun: boolean;
+    };
+}
+export interface ActuationResult {
+    decision: ActuationDecision;
+    refusalReason?: string;
+    bytes?: number;
+}
+export declare class OrchestratorActuator {
+    private readonly d;
+    private readonly now;
+    private readonly log;
+    constructor(deps: ActuatorDeps);
+    /** Actuate a single proposal through the guards. Never throws — a guard failure is a refusal. */
+    actuate(proposal: OrchestratorProposal): Promise<ActuationResult>;
+    private refuse;
+    private entry;
+}
+//# sourceMappingURL=OrchestratorActuator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"OrchestratorActuator.d.ts","sourceRoot":"","sources":["../../src/core/OrchestratorActuator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,OAAO,KAAK,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAEvH,mFAAmF;AACnF,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,OAAO,CAAC;IAChB,2FAA2F;IAC3F,iBAAiB,EAAE,OAAO,CAAC;IAC3B,wGAAwG;IACxG,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED,uGAAuG;AACvG,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,OAAO,CAAC;IACZ,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qEAAqE;AACrE,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,kBAAkB,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,qBAAqB,CAAC;IACtC,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,iBAAiB,GAAG,eAAe,GAAG,UAAU,GAAG,SAAS,GAAG,iBAAiB,GAAG,cAAc,CAAC;AAE9G,MAAM,WAAW,YAAY;IAC3B,2FAA2F;IAC3F,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,kBAAkB,CAAC;IAC9C,+DAA+D;IAC/D,oBAAoB,IAAI,MAAM,CAAC;IAC/B,+EAA+E;IAC/E,cAAc,CAAC,QAAQ,EAAE,oBAAoB,GAAG,MAAM,CAAC;IACvD,oHAAoH;IACpH,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IACtD,6GAA6G;IAC7G,qBAAqB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAC5D,yDAAyD;IACzD,KAAK,CAAC,KAAK,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACxC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,MAAM,EAAE;QAAE,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC;CAC7B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAe;IACjC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAwB;gBAEhC,IAAI,EAAE,YAAY;IAM9B,iGAAiG;IAC3F,OAAO,CAAC,QAAQ,EAAE,oBAAoB,GAAG,OAAO,CAAC,eAAe,CAAC;IA4DvE,OAAO,CAAC,MAAM;IAKd,OAAO,CAAC,KAAK;CAmBd"}

package/dist/core/OrchestratorActuator.js

@@ -0,0 +1,88 @@
+export class OrchestratorActuator {
+    d;
+    now;
+    log;
+    constructor(deps) {
+        this.d = deps;
+        this.now = deps.now ?? (() => new Date().toISOString());
+        this.log = deps.log ?? (() => { });
+    }
+    /** Actuate a single proposal through the guards. Never throws — a guard failure is a refusal. */
+    async actuate(proposal) {
+        const dryRun = this.d.config.dryRun;
+        // ── Guard 1-3: re-validate at execute (compare-and-act) ──────────────────
+        let live;
+        try {
+            live = this.d.revalidate(proposal.targetTopic);
+        }
+        catch (err) {
+            // A failed re-validation is a REFUSAL (fail-closed) — never actuate on an unknown state.
+            return this.refuse(proposal, `revalidate-failed:${err instanceof Error ? err.message : String(err)}`, dryRun);
+        }
+        if (live.inFailureEpisode) {
+            return this.refuse(proposal, 'yield-to-failure-movement', dryRun); // failure movement wins
+        }
+        if (live.pinned) {
+            return this.refuse(proposal, 'topic-pinned', dryRun);
+        }
+        if (live.recentlyUserMoved) {
+            return this.refuse(proposal, 'respect-user-provenance', dryRun);
+        }
+        // ── placement-signal: write structured evidence to the planner; never a move ──
+        if (proposal.action === 'placement-signal') {
+            const decision = dryRun ? 'would-signal' : 'signal-recorded';
+            this.d.audit(this.entry(proposal, decision, dryRun));
+            if (!dryRun) {
+                try {
+                    this.d.recordPlacementSignal(proposal);
+                }
+                catch (err) {
+                    this.log(`orchestrator: recordPlacementSignal failed (${err instanceof Error ? err.message : String(err)})`);
+                }
+            }
+            return { decision };
+        }
+        // ── preload-artifact: the side-effect-free auto-prefetch. Budget-bound first. ──
+        const need = Math.max(0, this.d.estimatedBytes(proposal));
+        if (need > this.d.budgetRemainingBytes()) {
+            return this.refuse(proposal, 'disk-byte-budget-exhausted', dryRun);
+        }
+        if (dryRun) {
+            // P3 soak: log the would-actuate + audit; actuate NOTHING.
+            this.d.audit(this.entry(proposal, 'would-actuate', true, need));
+            return { decision: 'would-actuate', bytes: need };
+        }
+        // Live: AUDIT BEFORE the fetch (crash-mid-action leaves a trace), then fetch.
+        this.d.audit(this.entry(proposal, 'actuated', false, need));
+        try {
+            const outcome = await this.d.fetchWorkingSet(proposal.targetTopic);
+            if (!outcome.ok) {
+                // The coordinator refused (secretFlagged/tooLarge/oversized/rate-limited) — a bounded no-op.
+                return { decision: 'refused', refusalReason: `fetch-skip:${outcome.skipReason ?? 'unknown'}` };
+            }
+            return { decision: 'actuated', bytes: outcome.bytes ?? need };
+        }
+        catch (err) {
+            this.log(`orchestrator: fetch failed for topic ${proposal.targetTopic} (${err instanceof Error ? err.message : String(err)})`);
+            return { decision: 'refused', refusalReason: 'fetch-error' };
+        }
+    }
+    refuse(proposal, reason, dryRun) {
+        this.d.audit(this.entry(proposal, 'refused', dryRun, undefined, reason));
+        return { decision: 'refused', refusalReason: reason };
+    }
+    entry(proposal, decision, dryRun, bytes, refusalReason) {
+        return {
+            ts: this.now(),
+            action: proposal.action,
+            targetTopic: proposal.targetTopic,
+            detail: proposal.detail,
+            authorityLevel: proposal.authorityLevel,
+            decision,
+            refusalReason,
+            dryRun,
+            bytes,
+        };
+    }
+}
+//# sourceMappingURL=OrchestratorActuator.js.map

package/dist/core/OrchestratorActuator.js.map

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

package/dist/core/OscillationBreaker.d.ts

@@ -0,0 +1,46 @@
+/**
+ * OscillationBreaker — the F6 oscillation brake for the seamless orchestrator
+ * (spec: llm-seamlessness-orchestrator.md §F6 + Tier-1 "oscillation breaker blacklists + raises one item").
+ *
+ * A topic that thrashes — ≥ maxActuationsPerWindow actuations inside oscillationWindowMs — is
+ * BLACKLISTED for blacklistTtlMs: the engine suppresses it from proposals (via the injected
+ * `isBlacklisted` seam) and stops churning it. The blacklist trip is reported ONCE per episode
+ * (`recordActuation` returns true exactly on the transition into blacklisted) so the wiring raises
+ * exactly ONE deduped attention item, never a per-tick flood (No-Unbounded-Loops / Bounded
+ * Notification Surface).
+ *
+ * Machine-local for the first (dark/dryRun) ship: in dryRun nothing actuates, so the window is
+ * always empty and the breaker is inert — it only becomes load-bearing once the operator flips the
+ * P4 auto-prefetch increment live. Replicating this blacklist via the WS2 store (so "don't move
+ * topic T again" survives a lease failover, spec line 85) is a TRACKED follow-up gated on that same
+ * P4-live flip; a machine-local breaker degrades safely (a failover re-learns the thrash) and never
+ * moves anything on its own.
+ */
+export interface OscillationBreakerConfig {
+    /** actuations within the window that trip the blacklist. Default 3 (spec F6: "3 moves in a window"). */
+    maxActuationsPerWindow: number;
+    /** the sliding window (ms) over which actuations are counted. Default 1h. */
+    oscillationWindowMs: number;
+    /** how long a blacklisted topic stays suppressed (ms). Default 24h. */
+    blacklistTtlMs: number;
+}
+export declare const DEFAULT_OSCILLATION_CONFIG: OscillationBreakerConfig;
+export declare class OscillationBreaker {
+    private readonly cfg;
+    private readonly now;
+    /** per-topic actuation timestamps (sliding window; pruned on each record/query). */
+    private readonly history;
+    /** per-topic blacklist-until timestamp. */
+    private readonly blacklistedUntil;
+    constructor(config?: Partial<OscillationBreakerConfig>, now?: () => number);
+    /**
+     * Record an actuation for a topic. Returns TRUE only on the transition INTO blacklisted
+     * (so the caller raises exactly one attention item per episode); false otherwise.
+     */
+    recordActuation(topic: number, at?: number): boolean;
+    /** True while the topic's blacklist window is active (expired entries self-clear). */
+    isBlacklisted(topic: number, at?: number): boolean;
+    /** The currently-blacklisted topics (for the /audit surface). */
+    blacklistedTopics(at?: number): number[];
+}
+//# sourceMappingURL=OscillationBreaker.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"OscillationBreaker.d.ts","sourceRoot":"","sources":["../../src/core/OscillationBreaker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,wBAAwB;IACvC,wGAAwG;IACxG,sBAAsB,EAAE,MAAM,CAAC;IAC/B,6EAA6E;IAC7E,mBAAmB,EAAE,MAAM,CAAC;IAC5B,uEAAuE;IACvE,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,eAAO,MAAM,0BAA0B,EAAE,wBAIxC,CAAC;AAEF,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAA2B;IAC/C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,oFAAoF;IACpF,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA+B;IACvD,2CAA2C;IAC3C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA6B;gBAElD,MAAM,CAAC,EAAE,OAAO,CAAC,wBAAwB,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,MAAM;IAK1E;;;OAGG;IACH,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO;IAepD,sFAAsF;IACtF,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO;IAQlD,iEAAiE;IACjE,iBAAiB,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE;CAIzC"}

package/dist/core/OscillationBreaker.js

@@ -0,0 +1,52 @@
+export const DEFAULT_OSCILLATION_CONFIG = {
+    maxActuationsPerWindow: 3,
+    oscillationWindowMs: 60 * 60_000,
+    blacklistTtlMs: 24 * 60 * 60_000,
+};
+export class OscillationBreaker {
+    cfg;
+    now;
+    /** per-topic actuation timestamps (sliding window; pruned on each record/query). */
+    history = new Map();
+    /** per-topic blacklist-until timestamp. */
+    blacklistedUntil = new Map();
+    constructor(config, now) {
+        this.cfg = { ...DEFAULT_OSCILLATION_CONFIG, ...config };
+        this.now = now ?? (() => Date.now());
+    }
+    /**
+     * Record an actuation for a topic. Returns TRUE only on the transition INTO blacklisted
+     * (so the caller raises exactly one attention item per episode); false otherwise.
+     */
+    recordActuation(topic, at) {
+        const t = at ?? this.now();
+        const cutoff = t - this.cfg.oscillationWindowMs;
+        const times = (this.history.get(topic) ?? []).filter((ts) => ts > cutoff);
+        times.push(t);
+        this.history.set(topic, times);
+        const already = this.isBlacklisted(topic, t);
+        if (!already && times.length >= this.cfg.maxActuationsPerWindow) {
+            this.blacklistedUntil.set(topic, t + this.cfg.blacklistTtlMs);
+            return true; // the one-shot trip signal
+        }
+        return false;
+    }
+    /** True while the topic's blacklist window is active (expired entries self-clear). */
+    isBlacklisted(topic, at) {
+        const until = this.blacklistedUntil.get(topic);
+        if (until === undefined)
+            return false;
+        const t = at ?? this.now();
+        if (t >= until) {
+            this.blacklistedUntil.delete(topic);
+            return false;
+        }
+        return true;
+    }
+    /** The currently-blacklisted topics (for the /audit surface). */
+    blacklistedTopics(at) {
+        const t = at ?? this.now();
+        return [...this.blacklistedUntil.keys()].filter((topic) => this.isBlacklisted(topic, t));
+    }
+}
+//# sourceMappingURL=OscillationBreaker.js.map

package/dist/core/OscillationBreaker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OscillationBreaker.js","sourceRoot":"","sources":["../../src/core/OscillationBreaker.ts"],"names":[],"mappings":"AA2BA,MAAM,CAAC,MAAM,0BAA0B,GAA6B;IAClE,sBAAsB,EAAE,CAAC;IACzB,mBAAmB,EAAE,EAAE,GAAG,MAAM;IAChC,cAAc,EAAE,EAAE,GAAG,EAAE,GAAG,MAAM;CACjC,CAAC;AAEF,MAAM,OAAO,kBAAkB;IACZ,GAAG,CAA2B;IAC9B,GAAG,CAAe;IACnC,oFAAoF;IACnE,OAAO,GAAG,IAAI,GAAG,EAAoB,CAAC;IACvD,2CAA2C;IAC1B,gBAAgB,GAAG,IAAI,GAAG,EAAkB,CAAC;IAE9D,YAAY,MAA0C,EAAE,GAAkB;QACxE,IAAI,CAAC,GAAG,GAAG,EAAE,GAAG,0BAA0B,EAAE,GAAG,MAAM,EAAE,CAAC;QACxD,IAAI,CAAC,GAAG,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IACvC,CAAC;IAED;;;OAGG;IACH,eAAe,CAAC,KAAa,EAAE,EAAW;QACxC,MAAM,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,mBAAmB,CAAC;QAChD,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,GAAG,MAAM,CAAC,CAAC;QAC1E,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACd,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QAE/B,MAAM,OAAO,GAAG,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QAC7C,IAAI,CAAC,OAAO,IAAI,KAAK,CAAC,MAAM,IAAI,IAAI,CAAC,GAAG,CAAC,sBAAsB,EAAE,CAAC;YAChE,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;YAC9D,OAAO,IAAI,CAAC,CAAC,2BAA2B;QAC1C,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,sFAAsF;IACtF,aAAa,CAAC,KAAa,EAAE,EAAW;QACtC,MAAM,KAAK,GAAG,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC/C,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC;QACtC,MAAM,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;QAC3B,IAAI,CAAC,IAAI,KAAK,EAAE,CAAC;YAAC,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAAC,OAAO,KAAK,CAAC;QAAC,CAAC;QACtE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,iEAAiE;IACjE,iBAAiB,CAAC,EAAW;QAC3B,MAAM,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;QAC3B,OAAO,CAAC,GAAG,IAAI,CAAC,gBAAgB,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;IAC3F,CAAC;CACF"}

package/dist/core/PostUpdateMigrator.d.ts

@@ -1064,6 +1064,7 @@ export declare class PostUpdateMigrator {
     private getPostActionReflectionHook;
     private getExternalCommunicationGuardHook;
     private getActionClaimFollowthroughHook;
+    private getWorkingSetArtifactRecorderHook;
     private getPrHandLeaseGuardHook;
     private getDoorwayScanGuardHook;
     private getExternalOperationGateHook;

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

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

package/dist/core/PostUpdateMigrator.js

@@ -3627,6 +3627,13 @@ export class PostUpdateMigrator {
         catch (err) {
             result.errors.push(`pr-hand-lease-guard.js: ${err instanceof Error ? err.message : String(err)}`);
         }
+        try {
+            fs.writeFileSync(path.join(instarHooksDir, 'working-set-artifact-recorder.js'), this.getWorkingSetArtifactRecorderHook(), { mode: 0o755 });
+            result.upgraded.push('hooks/instar/working-set-artifact-recorder.js (interactive working-set artifact recorder, PostToolUse Write/Edit, fire-and-forget, dark by default)');
+        }
+        catch (err) {
+            result.errors.push(`working-set-artifact-recorder.js: ${err instanceof Error ? err.message : String(err)}`);
+        }
         try {
             fs.writeFileSync(path.join(instarHooksDir, 'doorway-scan-guard.js'), this.getDoorwayScanGuardHook(), { mode: 0o755 });
             result.upgraded.push('hooks/instar/doorway-scan-guard.js (doorway-scan command-allowlist guard, PreToolUse Bash, scope-fail-open/match-fail-closed)');
@@ -8286,6 +8293,32 @@ Two layers keep my machine-to-machine \"ropes\" (Tailscale / LAN / Cloudflare) h
         else {
             result.skipped.push('.claude/settings.json: PreToolUse MCP matcher already present');
         }
+        // Add PostToolUse Write/Edit matcher for the working-set artifact recorder
+        // (intelligent-working-set-lazy-sync F8). Fire-and-forget + non-blocking; the
+        // hook itself early-exits fast when the feature is off (dark by default:
+        // coherenceJournal.workingSet.recordInteractive), so a default install pays only
+        // a quick no-op node spawn. Idempotent (keyed on the script name).
+        if (!hooks.PostToolUse) {
+            hooks.PostToolUse = [];
+        }
+        const postToolUseRec = hooks.PostToolUse;
+        this.migrateSettingsHookPaths(postToolUseRec, result);
+        const hasWsRecorder = postToolUseRec.some(e => e.hooks?.some(h => h.command?.includes('working-set-artifact-recorder.js')));
+        if (!hasWsRecorder) {
+            postToolUseRec.push({
+                matcher: 'Write|Edit|MultiEdit',
+                hooks: [{
+                        type: 'command',
+                        command: 'node ${CLAUDE_PROJECT_DIR}/.instar/hooks/instar/working-set-artifact-recorder.js',
+                        timeout: 5000,
+                    }],
+            });
+            patched = true;
+            result.upgraded.push('.claude/settings.json: added PostToolUse Write/Edit matcher (working-set artifact recorder)');
+        }
+        else {
+            result.skipped.push('.claude/settings.json: PostToolUse working-set recorder already present');
+        }
         // Clean up legacy PostToolUse session-start (was noisy — fired every tool use)
         if (hooks.PostToolUse) {
             const postToolUse = hooks.PostToolUse;
@@ -9855,6 +9888,35 @@ except Exception:
   fi
 fi
 
+# WORKING-SET ARTIFACT grounding (spec: intelligent-working-set-lazy-sync.md, Layer-3 /
+# Component6). Fetches /coherence/working-set/session-context for THIS topic and injects the
+# <replicated-untrusted-data source="working-set-artifacts"> block so the agent is GROUNDED
+# that interactive artifacts it recorded for this conversation exist (the whole point on a
+# topic-move: "you wrote these; re-verify/fetch them"). ADVISORY ONLY — a path is untrusted
+# data, never an instruction. Fail-open: no topic / route 503 (feature dark / manager unwired) /
+# no ready artifacts (present:false) / unreachable -> silent skip; -sf makes a non-2xx emit
+# nothing, so an absent/empty/oversized manifest degrades to no-block.
+if [ -n "\$INSTAR_TELEGRAM_TOPIC" ] && [ -n "\$PORT" ] && [ -n "\$TOKEN" ]; then
+  WS_ART_RESPONSE=\$(curl -sf --max-time 4 -H "Authorization: Bearer \$TOKEN" \\
+    "http://localhost:\${PORT}/coherence/working-set/session-context?topic=\${INSTAR_TELEGRAM_TOPIC}" 2>/dev/null)
+  if [ -n "\$WS_ART_RESPONSE" ]; then
+    WS_ART_BLOCK=\$(echo "\$WS_ART_RESPONSE" | python3 -c "
+import sys, json
+try:
+    d = json.load(sys.stdin)
+    if d.get('present') and d.get('block'):
+        print(d['block'])
+except Exception:
+    pass
+" 2>/dev/null)
+    if [ -n "\$WS_ART_BLOCK" ]; then
+      echo ""
+      echo "\$WS_ART_BLOCK"
+      echo ""
+    fi
+  fi
+fi
+
 # SESSION BOOT SELF-KNOWLEDGE injection (spec: session-boot-self-knowledge.md).
 # Fetches /self-knowledge/session-context and injects the deterministic "what I
 # already have" block: vault secret NAMES (never values) + self-asserted
@@ -11081,6 +11143,38 @@ except Exception:
   fi
 fi
 
+# WORKING-SET ARTIFACT grounding twin (Compaction Parity — intelligent-working-set-lazy-sync
+# Layer-3). Mirrors the session-start injection so after a compaction the agent is RE-grounded
+# on the interactive artifacts it recorded for this conversation. ADVISORY only (a path is
+# untrusted data). Fail-open: no topic / 503 (feature dark) / no ready artifacts / unreachable -> skip.
+if [ -n "\$INSTAR_TELEGRAM_TOPIC" ] && [ -f "$INSTAR_DIR/config.json" ]; then
+  WS_ART_PORT=\${PORT:-\$(grep -oE '"port"[[:space:]]*:[[:space:]]*[0-9]+' "$INSTAR_DIR/config.json" | head -1 | grep -oE '[0-9]+' | head -1)}
+  WS_ART_TOKEN="\${INSTAR_AUTH_TOKEN:-}"
+  if [ -z "\$WS_ART_TOKEN" ]; then
+    WS_ART_TOKEN=\$(python3 -c "import json; v=json.load(open('$INSTAR_DIR/config.json')).get('authToken',''); print(v if isinstance(v, str) else '')" 2>/dev/null)
+  fi
+  if [ -n "\$WS_ART_PORT" ] && [ -n "\$WS_ART_TOKEN" ]; then
+    WS_ART_RESPONSE=\$(curl -sf --max-time 4 --connect-timeout 1 -H "Authorization: Bearer \$WS_ART_TOKEN" \\
+      "http://localhost:\${WS_ART_PORT}/coherence/working-set/session-context?topic=\${INSTAR_TELEGRAM_TOPIC}" 2>/dev/null)
+    if [ -n "\$WS_ART_RESPONSE" ]; then
+      WS_ART_BLOCK=\$(echo "\$WS_ART_RESPONSE" | python3 -c "
+import sys, json
+try:
+    d = json.load(sys.stdin)
+    if d.get('present') and d.get('block'):
+        print(d['block'])
+except Exception:
+    pass
+" 2>/dev/null)
+      if [ -n "\$WS_ART_BLOCK" ]; then
+        echo ""
+        echo "\$WS_ART_BLOCK"
+        echo ""
+      fi
+    fi
+  fi
+fi
+
 echo "=== END IDENTITY RECOVERY ==="
 `;
     }
@@ -11848,6 +11942,87 @@ process.stdin.on('end', async () => {
   }
   process.exit(0); // ALWAYS exit 0 — never block a turn
 });
+`;
+    }
+    getWorkingSetArtifactRecorderHook() {
+        return `#!/usr/bin/env node
+// Working-Set Artifact Recorder — PostToolUse Write/Edit hook (spec: intelligent-working-set-lazy-sync.md, F8).
+//
+// SIGNAL-ONLY / fire-and-forget: on a SUCCESSFUL Write/Edit/MultiEdit under the .instar/ jail,
+// POSTs {topicId, relPath} to the server's POST /coherence/working-set/record so the INTERACTIVE
+// artifact (a file the agent wrote conversationally, with NO autonomous run) enters the computed
+// working-set manifest — the exact case WorkingSetManifest.computeWorkingSet misses. It NEVER
+// blocks — ALWAYS exit(0), pass or fail. Records NOTHING for a file OUTSIDE the .instar/ jail
+// (project files are git-synced; F10) or when the feature is off (code-default OFF ⇒ dark:
+// coherenceJournal.workingSet.recordInteractive). relPath is stateDir-relative + forward-slash
+// normalized — the exact convention computeWorkingSet Source-3 resolves (path.resolve(stateDir,rel)).
+//
+// ESM-safe: node: imports INSIDE the async handler (works in BOTH CJS and ESM host agents); a
+// bare top-level require(...) crashes an ESM-mode agent — see the 2026-05-27 silent-stall postmortem.
+
+let data = '';
+process.stdin.on('data', (chunk) => (data += chunk));
+process.stdin.on('end', async () => {
+  try {
+    const { readFileSync } = await import('node:fs');
+    const { join, resolve, relative, isAbsolute } = await import('node:path');
+
+    const projectDir = process.env.CLAUDE_PROJECT_DIR || '.';
+    let serverPort = 4040;
+    let authToken = '';
+    let enabled = false;
+    try {
+      const cfg = JSON.parse(readFileSync(join(projectDir, '.instar', 'config.json'), 'utf-8'));
+      serverPort = cfg.port || 4040;
+      authToken = cfg.authToken || '';
+      enabled = !!(cfg.coherenceJournal && cfg.coherenceJournal.workingSet && cfg.coherenceJournal.workingSet.recordInteractive);
+    } catch {}
+    if (!enabled) process.exit(0);
+
+    const input = JSON.parse(data);
+    const tool = input.tool_name || '';
+    if (tool !== 'Write' && tool !== 'Edit' && tool !== 'MultiEdit') process.exit(0);
+    // A failed tool-call records nothing (F8) — deletes are NOT inferred from a write.
+    const resp = input.tool_response;
+    if (resp && (resp.error || resp.success === false)) process.exit(0);
+
+    const filePath = input.tool_input && input.tool_input.file_path;
+    if (!filePath || typeof filePath !== 'string') process.exit(0);
+
+    // Conversation id — key from INSTAR_CONVERSATION_ID ONLY (a shared/lifeline session carries
+    // none → records nothing, a safe miss). Number.isFinite admits a minted-negative (Slack) id.
+    const topicRaw = process.env.INSTAR_CONVERSATION_ID;
+    if (!topicRaw) process.exit(0);
+    const topicId = parseInt(topicRaw, 10);
+    if (!Number.isFinite(topicId)) process.exit(0);
+
+    // Derive relPath vs the .instar/ jail (stateDir-relative). Outside the jail ⇒ skip (F10).
+    const stateDir = resolve(projectDir, '.instar');
+    const rawRel = relative(stateDir, resolve(filePath));
+    if (!rawRel || rawRel.startsWith('..') || isAbsolute(rawRel)) process.exit(0);
+    const segs = rawRel.split(/[/\\\\]+/);
+    if (segs.includes('.git')) process.exit(0); // never a git internal
+    const relPath = segs.join('/'); // forward-slash normalized for cross-machine identity
+
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), 5000);
+    try {
+      await fetch('http://127.0.0.1:' + serverPort + '/coherence/working-set/record', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json', 'Authorization': 'Bearer ' + authToken },
+        body: JSON.stringify({ topicId, relPath }),
+        signal: controller.signal,
+      });
+    } catch {
+      // network/timeout — fire-and-forget, ignore
+    } finally {
+      clearTimeout(timeout);
+    }
+  } catch {
+    // bad stdin — ignore
+  }
+  process.exit(0); // ALWAYS exit 0 — never block a tool
+});
 `;
     }
     getPrHandLeaseGuardHook() {