@dsh-cc/compaction-cost-gate 0.8.0-rc.1

package/lib/index.js

@@ -0,0 +1,368 @@
+/**
+ * Cost-gated plan-step compaction service (design
+ * docs/plans/2026-09-20-cost-gated-plan-step-compaction.md §3.4–§3.6).
+ *
+ * Two seams: a mid-turn `tools/post-execute` listener ARMS a boundary when a
+ * `todo_write` transitions a todo to completed (observe-only, decision
+ * untouched); an `agent/status` idle listener runs the §3.3 cost gate for the
+ * latched root session only and, on a pass in `mode: 'on'`, calls
+ * `ctx.compaction.compactNow` with a preservation hint parked immediately
+ * before the call and a fresh abort signal (the turn-scoped signal is dead by
+ * idle). Subagent agents never arm, count, or trigger.
+ *
+ * The compaction engine is deliberately NOT injected (cordis strict-read
+ * would kill the service where compaction is absent); it is read through the
+ * guarded {@link optionalCompaction} accessor, and absence inactivates the
+ * gate with one log line and one ledger row.
+ *
+ * @module @dsh-cc/compaction-cost-gate
+ */
+import { Service } from '@deepseek-ai/cordis';
+import { CommandId } from '@deepseek-ai/dsh-commands';
+import { ManualCompactionError } from '@deepseek-ai/dsh-compaction';
+import { deriveEventMessage } from '@deepseek-ai/dsh-session';
+import { setCompactHint, takeCompactHint } from '@dsh-cc/compaction-basic';
+import { resolvePrice } from '@dsh-cc/command-cost';
+import { createUserMessage } from '@deepseek-ai/dsh-llm';
+import { evaluateGate } from "./gate.js";
+import { CostGateLedger, projectKeyOf } from "./ledger.js";
+import { registerCostGateSettings } from "./settings.js";
+import { diffTodos } from "./todo-diff.js";
+import { FAILURE_FUSE, } from "./types.js";
+export { CostGateLedger, projectKeyOf } from "./ledger.js";
+export { evaluateGate } from "./gate.js";
+export { foldCounters } from "./fold-counters.js";
+export { diffTodos } from "./todo-diff.js";
+export { SETTINGS_NAMESPACE, registerCostGateSettings } from "./settings.js";
+export * from "./types.js";
+function dshHomeFn(ctx) {
+    try {
+        return ctx.dshHomePath;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * The compaction service is optional at mount: reading an uninjected cordis
+ * context property throws, so the read is guarded (never `inject`ed).
+ */
+function optionalCompaction(ctx) {
+    try {
+        return ctx.compaction;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Cost-gated plan-step compaction service. One instance per mounted plugin;
+ * state is keyed by the latched root session id and lives in memory only.
+ */
+export class CompactionCostGate extends Service {
+    /** The token meter prices surface nodes for the gate arithmetic. */
+    static inject = ['tokenMeter'];
+    readSettings;
+    ledger;
+    now;
+    /** Content of the todo whose completion armed the current boundary. */
+    rootLatch;
+    stats = new Map();
+    constructor(ctx, deps = {}) {
+        super(ctx, 'compactionCostGate');
+        this.ctx = ctx;
+        this.readSettings = deps.readSettings ?? registerCostGateSettings(ctx);
+        this.now = deps.now ?? Date.now;
+        const home = dshHomeFn(ctx);
+        this.ledger = deps.ledger
+            ?? (home === undefined
+                ? undefined
+                : new CostGateLedger(home('compaction-cost-gate'), (error) => {
+                    ctx.logger.warn(`compaction-cost-gate: ledger write failed: ${error instanceof Error ? error.message : String(error)}`);
+                }));
+        this.registerListeners();
+    }
+    /** Register the observe-only listeners (two-seam split, §3.4). */
+    registerListeners() {
+        this.ctx.on('llm/stream', (options, next) => {
+            this.observeStream(options);
+            return next();
+        }, { global: true, prepend: true });
+        this.ctx.on('tools/post-execute', async (exec, _result, next) => {
+            this.observePostExecute(exec);
+            // Observe-only: the downstream decision passes through unchanged.
+            return next();
+        });
+        this.ctx.on('agent/status', ({ agent, status }) => {
+            if (status === 'idle')
+                void this.evaluateIdle(agent);
+        });
+        this.ctx.on('session/disposed', (session) => {
+            const id = String(session.header.id);
+            if (id === this.rootLatch) {
+                this.rootLatch = undefined;
+                this.stats.delete(id);
+            }
+        });
+    }
+    /** Fresh per-root-session state (§3.2). */
+    freshStats() {
+        return {
+            boundaryArmed: false,
+            streamRequestCount: 0,
+            completedSteps: 0,
+            lastTodoSnapshot: new Map(),
+            rewriteDebt: [],
+            cooldownUntil: 0,
+            consecutiveFailures: 0,
+            paused: false,
+        };
+    }
+    /**
+     * Latch the root session on the first main-loop observation and count
+     * main-loop requests for it (auxiliary purposes never latch or count);
+     * amortize rewrite debt by the requests it has since observed.
+     */
+    observeStream(options) {
+        if (options.purpose !== undefined || options.sessionId === undefined)
+            return;
+        const id = String(options.sessionId);
+        if (this.rootLatch === undefined) {
+            this.rootLatch = id;
+            this.stats.set(id, this.freshStats());
+        }
+        const state = this.stats.get(id);
+        if (state === undefined)
+            return;
+        state.streamRequestCount += 1;
+        state.lastProvider = options.provider;
+        state.lastModel = options.model;
+        for (const entry of state.rewriteDebt)
+            entry.requestsSince += 1;
+    }
+    /**
+     * Detection seam: filter `todo_write`, diff the snapshot, and arm the
+     * boundary on any transition to completed — for the latched root session
+     * only. Never mutates the tool decision.
+     */
+    observePostExecute(exec) {
+        if (exec.name !== 'todo_write')
+            return;
+        if (this.rootLatch === undefined)
+            return;
+        const agentSession = exec.agent?.session;
+        if (agentSession === undefined || String(agentSession.header.id) !== this.rootLatch)
+            return;
+        const state = this.stats.get(this.rootLatch);
+        if (state === undefined)
+            return;
+        const todos = this.parseTodos(exec.arguments);
+        if (todos === undefined)
+            return;
+        const result = diffTodos(state.lastTodoSnapshot, todos);
+        if (result.armed) {
+            state.boundaryArmed = true;
+            state.lastCompletedTitle = result.newlyCompleted[result.newlyCompleted.length - 1] ?? '';
+        }
+        state.lastTodoSnapshot = new Map(result.snapshot);
+        state.completedSteps = result.completedSteps;
+    }
+    /** Action seam: evaluate the gate at idle for the latched root session only. */
+    async evaluateIdle(agent) {
+        const settings = this.readSettings();
+        if (!settings.enabled)
+            return; // ships dark
+        if (this.rootLatch === undefined)
+            return;
+        if (String(agent.session.header.id) !== this.rootLatch)
+            return;
+        const state = this.stats.get(this.rootLatch);
+        if (state === undefined)
+            return;
+        // Measure the last compaction's reduction at the next idle evaluation.
+        if (state.preCompactContextTokens !== undefined && state.preCompactContextTokens > 0) {
+            const current = this.contextTokens(agent.session);
+            const measured = Math.max(0, (state.preCompactContextTokens - current) / state.preCompactContextTokens);
+            state.lastShrink = measured;
+            delete state.preCompactContextTokens;
+        }
+        if (!state.boundaryArmed)
+            return;
+        state.boundaryArmed = false; // disarm unconditionally: one evaluation per boundary
+        if (state.paused)
+            return;
+        const now = this.now();
+        if (now < state.cooldownUntil) {
+            this.write('skipped:cooldown', { mode: settings.mode, reason: 'cooldown active' });
+            return;
+        }
+        const engine = optionalCompaction(this.ctx);
+        if (engine === undefined) {
+            this.ctx.logger.warn('compaction-cost-gate: no compaction service on the host context; gate inactive');
+            this.write('compaction-unavailable', { mode: settings.mode, reason: 'compaction-unavailable' });
+            return;
+        }
+        const contextTokens = this.contextTokens(agent.session);
+        const pendingSteps = this.pendingSteps(state);
+        const price = this.resolvePriceFor(settings, state);
+        const outcome = evaluateGate({
+            contextTokens,
+            streamRequestCount: state.streamRequestCount,
+            completedSteps: state.completedSteps,
+            pendingSteps,
+            ...(state.lastShrink !== undefined ? { lastShrink: state.lastShrink } : {}),
+            rewriteDebt: state.rewriteDebt,
+            margin: settings.margin,
+            ...(price !== undefined ? { price } : {}),
+            ...(settings.windowPressureTokens !== undefined
+                ? { windowPressureTokens: settings.windowPressureTokens }
+                : {}),
+        });
+        const row = {
+            mode: settings.mode,
+            contextTokens,
+            projectedSavedInput: outcome.projectedSavedInput,
+            rewriteCost: outcome.rewriteCost,
+            debtTokens: outcome.debtTokens,
+            pendingSteps: outcome.pendingSteps,
+            requestsPerStep: outcome.requestsPerStep,
+            shrink: outcome.shrink,
+            margin: settings.margin,
+            pass: outcome.pass,
+            windowPressureOverride: outcome.windowPressureOverride,
+            provider: state.lastProvider,
+            model: state.lastModel,
+        };
+        this.write('gate', row);
+        if (!outcome.pass)
+            return;
+        if (settings.mode === 'dry-run')
+            return;
+        await this.compactNow(engine, agent, contextTokens, settings, outcome.rewriteCost);
+    }
+    /**
+     * Hint-then-call: the hint must survive only the instant between set and
+     * consume; it is cleared on every exit path. A fresh AbortController (the
+     * turn-scoped signal is dead by idle and must never be reused).
+     */
+    async compactNow(engine, agent, contextTokens, settings, rewriteCost) {
+        const state = this.stats.get(this.rootLatch ?? '');
+        setCompactHint(agent, `plan-step-complete:${state?.lastCompletedTitle ?? 'todo'}`);
+        try {
+            const result = await engine.compactNow(agent, new AbortController().signal, CommandId('compaction-cost-gate'));
+            // Success resets the fuse and starts cooldown + debt amortization.
+            if (state !== undefined) {
+                state.consecutiveFailures = 0;
+                state.cooldownUntil = this.now() + settings.cooldownMs;
+                state.rewriteDebt.push({ tokens: rewriteCost, requestsSince: 0 });
+                state.preCompactContextTokens = contextTokens;
+            }
+            this.write('compacted', {
+                mode: settings.mode,
+                contextTokens,
+                rewriteCost,
+                reason: result === null ? 'no-compactable-history' : 'compacted',
+            });
+            this.ctx.logger.info(`compaction-cost-gate: compacted at plan-step boundary `
+                + `(context ~${contextTokens} tokens, debt ${rewriteCost})`);
+        }
+        catch (error) {
+            if (error instanceof ManualCompactionError && (error.code === 'busy' || error.code === 'cancelled')) {
+                // Expected classes: count toward nothing, reset nothing.
+                this.write(`skipped:${error.code}`, { mode: settings.mode, reason: error.message });
+                return;
+            }
+            const code = error instanceof ManualCompactionError ? error.code : 'unexpected';
+            this.write(`failed:${code}`, { mode: settings.mode, reason: error instanceof Error ? error.message : String(error) });
+            if (state !== undefined) {
+                state.consecutiveFailures += 1;
+                if (state.consecutiveFailures >= FAILURE_FUSE) {
+                    state.paused = true;
+                    this.notifyPaused(agent, state.consecutiveFailures);
+                }
+            }
+        }
+        finally {
+            // Cleared on ANY failure path (and after success) so a stale hint can
+            // never ride a later turn.
+            takeCompactHint(agent);
+        }
+    }
+    /** One durable model-visible pause notice pointing at manual `/compact`. */
+    notifyPaused(agent, failures) {
+        const text = `compaction-cost-gate: failed ${failures} consecutive time(s); `
+            + 'auto compaction paused for this session — run /compact manually';
+        try {
+            agent.inject?.(createUserMessage({
+                content: [{ type: 'text', text }],
+                source: { kind: 'plugin', plugin: 'compaction-cost-gate' },
+            }));
+        }
+        catch (error) {
+            this.ctx.logger.warn(`compaction-cost-gate: failed to inject pause notice: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    /** Resolve the optional pricing layer from the last observed provider/model. */
+    resolvePriceFor(settings, state) {
+        if (settings.modelTable === undefined || state.lastProvider === undefined || state.lastModel === undefined) {
+            return undefined;
+        }
+        const price = resolvePrice(settings.modelTable, state.lastProvider, state.lastModel);
+        if (price === undefined)
+            return undefined;
+        return { cacheReadPerMTok: price.cacheReadPerMTok, cacheWritePerMTok: price.cacheWritePerMTok };
+    }
+    /**
+     * Σ estimateMessage over message-carrying surface nodes — the shadow-aware
+     * accessor (`session.surface.nodes` + `eventAt`), never raw events, so
+     * spans shadowed by prior compactions are not double-counted.
+     */
+    contextTokens(session) {
+        let total = 0;
+        for (const seq of [...session.surface.nodes]) {
+            const event = session.eventAt(seq);
+            const message = event === undefined ? null : deriveEventMessage(event);
+            if (message !== undefined && message !== null) {
+                total += this.ctx.tokenMeter.estimateMessage(message);
+            }
+        }
+        return total;
+    }
+    /** Non-completed todos in the latest snapshot. */
+    pendingSteps(state) {
+        let pending = 0;
+        for (const status of state.lastTodoSnapshot.values()) {
+            if (status !== 'completed')
+                pending += 1;
+        }
+        return pending;
+    }
+    /** Parse the todos array out of the `todo_write` tool arguments. */
+    parseTodos(arguments_) {
+        const todos = arguments_?.todos;
+        if (!Array.isArray(todos))
+            return undefined;
+        const items = [];
+        for (const item of todos) {
+            const candidate = item;
+            if (typeof candidate.content !== 'string' || typeof candidate.status !== 'string')
+                return undefined;
+            if (candidate.status !== 'pending' && candidate.status !== 'in_progress' && candidate.status !== 'completed') {
+                return undefined;
+            }
+            items.push({ content: candidate.content, status: candidate.status });
+        }
+        return todos;
+    }
+    /** Fire-and-forget ledger append; errors are swallowed by the ledger. */
+    write(kind, extra) {
+        this.ledger?.append(projectKeyOf(process.cwd()), {
+            ts: new Date().toISOString(),
+            sessionId: this.rootLatch ?? '',
+            kind,
+            ...extra,
+        });
+    }
+}
+export default CompactionCostGate;
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

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

package/lib/invariant.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Package-owned invariant companion for `@dsh-cc/compaction-cost-gate`.
+ * @module @dsh-cc/compaction-cost-gate/invariant
+ */
+import type { Context } from '@deepseek-ai/cordis';
+/** Cordis companion plugin name. */
+export declare const name = "compaction-cost-gate-invariant";
+/** Services required before the companion can register. */
+export declare const inject: string[];
+/**
+ * Register this package's invariant companion.
+ * @param ctx - Cordis context carrying the invariant service.
+ * @returns the installed registration's disposer after setup succeeds.
+ */
+export declare const apply: (ctx: Context) => Promise<() => void>;
+//# sourceMappingURL=invariant.d.ts.map

package/lib/invariant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invariant.d.ts","sourceRoot":"","sources":["../src/invariant.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAKlD,oCAAoC;AACpC,eAAO,MAAM,IAAI,mCAAmC,CAAA;AACpD,2DAA2D;AAC3D,eAAO,MAAM,MAAM,UAAiB,CAAA;AAUpC;;;;GAIG;AACH,eAAO,MAAM,KAAK,GAAI,KAAK,OAAO,KAAG,OAAO,CAAC,MAAM,IAAI,CACU,CAAA"}

package/lib/invariant.js

@@ -0,0 +1,24 @@
+/**
+ * Package-owned invariant companion for `@dsh-cc/compaction-cost-gate`.
+ * @module @dsh-cc/compaction-cost-gate/invariant
+ */
+const PACKAGE_NAME = '@dsh-cc/compaction-cost-gate';
+/** Cordis companion plugin name. */
+export const name = 'compaction-cost-gate-invariant';
+/** Services required before the companion can register. */
+export const inject = ['invariants'];
+/**
+ * No runtime invariant: the gate is a pure arithmetic fold unit-tested
+ * table-side, the two-seam split (post-execute arming / idle action) is
+ * pinned by the service and composition specs, and the harness compaction
+ * engine already enforces the idle-only `compactNow` contract itself.
+ */
+const install = () => { };
+/**
+ * Register this package's invariant companion.
+ * @param ctx - Cordis context carrying the invariant service.
+ * @returns the installed registration's disposer after setup succeeds.
+ */
+export const apply = (ctx) => Promise.resolve(ctx.invariants.register(PACKAGE_NAME, install));
+/* jscpd:ignore-end */
+//# sourceMappingURL=invariant.js.map

package/lib/invariant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invariant.js","sourceRoot":"","sources":["../src/invariant.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,YAAY,GAAG,8BAA8B,CAAA;AAEnD,oCAAoC;AACpC,MAAM,CAAC,MAAM,IAAI,GAAG,gCAAgC,CAAA;AACpD,2DAA2D;AAC3D,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,YAAY,CAAC,CAAA;AAEpC;;;;;GAKG;AACH,MAAM,OAAO,GAAuB,GAAG,EAAE,GAAE,CAAC,CAAA;AAE5C;;;;GAIG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,GAAY,EAAuB,EAAE,CACzD,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,CAAA;AACjE,sBAAsB"}

package/lib/ledger.d.ts

@@ -0,0 +1,60 @@
+/**
+ * JSONL ledger for cost-gate decisions: `<dshHome>/compaction-cost-gate/<projectKey>.jsonl`.
+ * Append-only, fire-and-forget (the arming/action paths never await on it),
+ * error-swallowing into the injected sink (cache-health ledger discipline).
+ * @module @dsh-cc/compaction-cost-gate/ledger
+ */
+/** One ledger row (one JSON object per jsonl line). */
+export interface LedgerRow {
+    /** ISO timestamp of the observation. */
+    readonly ts: string;
+    /** Root session the row belongs to. */
+    readonly sessionId: string;
+    /**
+     * Row kind: `gate` (an idle evaluation with both sides of the inequality),
+     * `compacted`, `skipped:<class>` (expected busy/cancelled/cooldown), or
+     * `compaction-unavailable`.
+     */
+    readonly kind: string;
+    /** Mode in effect at evaluation time. */
+    readonly mode: 'dry-run' | 'on';
+    /** Σ estimateMessage over message-carrying surface nodes at the boundary. */
+    readonly contextTokens?: number;
+    readonly projectedSavedInput?: number;
+    readonly rewriteCost?: number;
+    readonly debtTokens?: number;
+    readonly pendingSteps?: number;
+    readonly requestsPerStep?: number;
+    readonly shrink?: number;
+    readonly margin?: number;
+    /** Whether the gate passed (undefined for rows without a gate decision). */
+    readonly pass?: boolean;
+    /** Window-pressure override in effect for this evaluation. */
+    readonly windowPressureOverride?: boolean;
+    readonly provider?: string;
+    readonly model?: string;
+    /** Free-text reason for skip/failure rows. */
+    readonly reason?: string;
+}
+/** Error sink (the plugin passes a warn-logger); never throws. */
+export type LedgerErrorSink = (error: unknown) => void;
+/** projectKey = 8-hex sha256 of the session cwd (cache-health idiom). */
+export declare function projectKeyOf(cwd: string): string;
+/**
+ * Append-only ledger store. One instance per mounted plugin; `root` is
+ * `dshHomePath('compaction-cost-gate')`.
+ */
+export declare class CostGateLedger {
+    readonly root: string;
+    private readonly onError;
+    /** Per-file write chain: serializes appends so rows keep decision order (still floating). */
+    private readonly pending;
+    constructor(root: string, onError?: LedgerErrorSink);
+    /** Ledger file path for one project. */
+    pathFor(projectKey: string): string;
+    /** Await all outstanding appends (test/diagnostic seam; never used on event paths). */
+    flush(): Promise<void>;
+    /** Append one row as a FLOATING promise chained per file (call order preserved). Never await on an event path. */
+    append(projectKey: string, row: LedgerRow): void;
+}
+//# sourceMappingURL=ledger.d.ts.map

package/lib/ledger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ledger.d.ts","sourceRoot":"","sources":["../src/ledger.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,uDAAuD;AACvD,MAAM,WAAW,SAAS;IACxB,wCAAwC;IACxC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,uCAAuC;IACvC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,yCAAyC;IACzC,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,IAAI,CAAA;IAC/B,6EAA6E;IAC7E,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;IAC/B,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAA;IACrC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAA;IACjC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,4EAA4E;IAC5E,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAA;IACvB,8DAA8D;IAC9D,QAAQ,CAAC,sBAAsB,CAAC,EAAE,OAAO,CAAA;IACzC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,8CAA8C;IAC9C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CACzB;AAED,kEAAkE;AAClE,MAAM,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;AAEtD,yEAAyE;AACzE,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED;;;GAGG;AACH,qBAAa,cAAc;IAKvB,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAL1B,6FAA6F;IAC7F,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmC;gBAGhD,IAAI,EAAE,MAAM,EACJ,OAAO,GAAE,eAA0B;IAGtD,wCAAwC;IACxC,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IAInC,uFAAuF;IACjF,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B,kHAAkH;IAClH,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,GAAG,IAAI;CAiBjD"}

package/lib/ledger.js

@@ -0,0 +1,55 @@
+/**
+ * JSONL ledger for cost-gate decisions: `<dshHome>/compaction-cost-gate/<projectKey>.jsonl`.
+ * Append-only, fire-and-forget (the arming/action paths never await on it),
+ * error-swallowing into the injected sink (cache-health ledger discipline).
+ * @module @dsh-cc/compaction-cost-gate/ledger
+ */
+import { appendFile, mkdir } from 'node:fs/promises';
+import { createHash } from 'node:crypto';
+import { dirname, join } from 'node:path';
+/** projectKey = 8-hex sha256 of the session cwd (cache-health idiom). */
+export function projectKeyOf(cwd) {
+    return createHash('sha256').update(cwd).digest('hex').slice(0, 8);
+}
+/**
+ * Append-only ledger store. One instance per mounted plugin; `root` is
+ * `dshHomePath('compaction-cost-gate')`.
+ */
+export class CostGateLedger {
+    root;
+    onError;
+    /** Per-file write chain: serializes appends so rows keep decision order (still floating). */
+    pending = new Map();
+    constructor(root, onError = () => { }) {
+        this.root = root;
+        this.onError = onError;
+    }
+    /** Ledger file path for one project. */
+    pathFor(projectKey) {
+        return join(this.root, `${projectKey}.jsonl`);
+    }
+    /** Await all outstanding appends (test/diagnostic seam; never used on event paths). */
+    async flush() {
+        await Promise.all([...this.pending.values()]);
+    }
+    /** Append one row as a FLOATING promise chained per file (call order preserved). Never await on an event path. */
+    append(projectKey, row) {
+        const file = this.pathFor(projectKey);
+        const write = async () => {
+            await mkdir(dirname(file), { recursive: true });
+            await appendFile(file, `${JSON.stringify(row)}\n`, 'utf8');
+        };
+        const prev = this.pending.get(file) ?? Promise.resolve();
+        const next = prev.then(write, write);
+        this.pending.set(file, next);
+        next.catch((error) => {
+            try {
+                this.onError(error);
+            }
+            catch {
+                // sink failure must never propagate
+            }
+        });
+    }
+}
+//# sourceMappingURL=ledger.js.map

package/lib/ledger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ledger.js","sourceRoot":"","sources":["../src/ledger.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAA;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAsCzC,yEAAyE;AACzE,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;AACnE,CAAC;AAED;;;GAGG;AACH,MAAM,OAAO,cAAc;IAKd;IACQ;IALnB,6FAA6F;IAC5E,OAAO,GAAG,IAAI,GAAG,EAAyB,CAAA;IAE3D,YACW,IAAY,EACJ,UAA2B,GAAG,EAAE,GAAE,CAAC;QAD3C,SAAI,GAAJ,IAAI,CAAQ;QACJ,YAAO,GAAP,OAAO,CAA4B;IACnD,CAAC;IAEJ,wCAAwC;IACxC,OAAO,CAAC,UAAkB;QACxB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,UAAU,QAAQ,CAAC,CAAA;IAC/C,CAAC;IAED,uFAAuF;IACvF,KAAK,CAAC,KAAK;QACT,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAA;IAC/C,CAAC;IAED,kHAAkH;IAClH,MAAM,CAAC,UAAkB,EAAE,GAAc;QACvC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAA;QACrC,MAAM,KAAK,GAAG,KAAK,IAAmB,EAAE;YACtC,MAAM,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;YAC/C,MAAM,UAAU,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;QAC5D,CAAC,CAAA;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,CAAA;QACxD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,CAAA;QACpC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;QAC5B,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;YACnB,IAAI,CAAC;gBACH,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;YACrB,CAAC;YAAC,MAAM,CAAC;gBACP,oCAAoC;YACtC,CAAC;QACH,CAAC,CAAC,CAAA;IACJ,CAAC;CACF"}

package/lib/settings.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Settings namespace `cc-compaction-cost-gate` (design §3.6), registered
+ * idempotently through the `@dsh-cc/settings-ns` safe helpers (PR #82
+ * collision rules — mounted inside the cc preset beside ten other settings
+ * users). Without a settings provider the schema defaults apply.
+ * @module @dsh-cc/compaction-cost-gate/settings
+ */
+import z from '@deepseek-ai/schemastery';
+import type { Context } from '@deepseek-ai/cordis';
+import type { SettingsNamespace } from '@deepseek-ai/dsh-settings';
+import type { CostGateSettings } from './types.ts';
+/** The settings namespace carrying the cost-gate settings. */
+export declare const SETTINGS_NAMESPACE: SettingsNamespace;
+export declare const DEFAULT_SETTINGS: CostGateSettings;
+export declare const SettingsSchema: z<CostGateSettings>;
+/**
+ * Register the namespace and return the live settings reader. Idempotent
+ * through the shared `registerNamespaceSafe` helper: a duplicate mount under
+ * the /clear create-before-dispose overlap window degrades to a live read of
+ * the already-registered namespace instead of failing the preset mount.
+ * @param ctx - the host context.
+ * @returns a per-use settings reader (never undefined); hyphenated settings
+ * keys are mapped onto the camelCase resolved shape.
+ */
+export declare function registerCostGateSettings(ctx: Context): () => CostGateSettings;
+//# sourceMappingURL=settings.d.ts.map

package/lib/settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../src/settings.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,CAAC,MAAM,0BAA0B,CAAA;AACxC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAA;AAClD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAA;AAGlE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAElD,8DAA8D;AAC9D,eAAO,MAAM,kBAAkB,EAAgC,iBAAiB,CAAA;AAEhF,eAAO,MAAM,gBAAgB,EAAE,gBAK9B,CAAA;AAED,eAAO,MAAM,cAAc,EAAE,CAAC,CAAC,gBAAgB,CAOX,CAAA;AAEpC;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,gBAAgB,CAwB7E"}

package/lib/settings.js

@@ -0,0 +1,57 @@
+/**
+ * Settings namespace `cc-compaction-cost-gate` (design §3.6), registered
+ * idempotently through the `@dsh-cc/settings-ns` safe helpers (PR #82
+ * collision rules — mounted inside the cc preset beside ten other settings
+ * users). Without a settings provider the schema defaults apply.
+ * @module @dsh-cc/compaction-cost-gate/settings
+ */
+import z from '@deepseek-ai/schemastery';
+import { registerNamespaceSafe } from '@dsh-cc/settings-ns';
+/** The settings namespace carrying the cost-gate settings. */
+export const SETTINGS_NAMESPACE = 'cc-compaction-cost-gate';
+export const DEFAULT_SETTINGS = {
+    enabled: false,
+    mode: 'dry-run',
+    margin: 1.0,
+    cooldownMs: 600_000,
+};
+export const SettingsSchema = z.object({
+    enabled: z.boolean().default(false),
+    mode: z.union(['dry-run', 'on']).default('dry-run'),
+    margin: z.number().default(1.0),
+    'cooldown-ms': z.number().default(600_000),
+    'window-pressure-tokens': z.number(),
+    'model-table': z.any(),
+});
+/**
+ * Register the namespace and return the live settings reader. Idempotent
+ * through the shared `registerNamespaceSafe` helper: a duplicate mount under
+ * the /clear create-before-dispose overlap window degrades to a live read of
+ * the already-registered namespace instead of failing the preset mount.
+ * @param ctx - the host context.
+ * @returns a per-use settings reader (never undefined); hyphenated settings
+ * keys are mapped onto the camelCase resolved shape.
+ */
+export function registerCostGateSettings(ctx) {
+    const read = registerNamespaceSafe(ctx, SETTINGS_NAMESPACE, SettingsSchema);
+    return () => {
+        const raw = read();
+        if (raw === undefined)
+            return { ...DEFAULT_SETTINGS };
+        return {
+            enabled: raw.enabled === true,
+            mode: raw.mode === 'on' ? 'on' : 'dry-run',
+            margin: typeof raw.margin === 'number' ? raw.margin : DEFAULT_SETTINGS.margin,
+            cooldownMs: typeof raw['cooldown-ms'] === 'number'
+                ? raw['cooldown-ms']
+                : DEFAULT_SETTINGS.cooldownMs,
+            ...(typeof raw['window-pressure-tokens'] === 'number'
+                ? { windowPressureTokens: raw['window-pressure-tokens'] }
+                : {}),
+            ...(Array.isArray(raw['model-table'])
+                ? { modelTable: raw['model-table'] }
+                : {}),
+        };
+    };
+}
+//# sourceMappingURL=settings.js.map