@retaw106/mmc-oc 0.0.0-stage → 1.2.2

package/dist/features/magic-context/memory-maintainer/lease.d.ts

@@ -0,0 +1,56 @@
+import { type Database } from "../../../shared/sqlite";
+/**
+ * Ported from the upstream dreamer's lease.ts (8a69b3a95c) with three fork
+ * changes (plan 10, decisions 13/15):
+ *   1. imports re-pointed at the fork's shared modules and ./dream-state;
+ *   2. the lease-guarded write re-validates the GENERATION inside the
+ *      BEGIN IMMEDIATE lock, not only holder+expiry (upstream lease.ts:206 only
+ *      checks holder+expiry — the fork's D4 red line requires generation
+ *      fencing under the write lock);
+ *   3. the legacy `dreaming` default key is gone: every caller passes an
+ *      explicit lease key, `mmc-maint:<projectPath>` (see maintLeaseKey), and
+ *      TTL / heartbeat interval are parameters with the upstream defaults
+ *      (2 min / 40 s) instead of module constants.
+ */
+/** Expires after 2 minutes unless the heartbeat renews it. */
+export declare const DEFAULT_LEASE_TTL_MS: number;
+/** Three beats per lease leave room for one contended or delayed renewal. */
+export declare const DEFAULT_LEASE_HEARTBEAT_INTERVAL_MS: number;
+/** The one lease key of the memory maintainer: one conflict domain per project. */
+export declare function maintLeaseKey(projectPath: string): string;
+export declare function isLeaseActive(db: Database, leaseKey: string): boolean;
+export declare function getLeaseHolder(db: Database, leaseKey: string): string | null;
+export declare function getLeaseGeneration(db: Database, leaseKey: string): number | null;
+export declare function peekLeaseHolderAndExpiry(db: Database, expectedHolder: string, leaseKey: string): boolean;
+export declare function leaseOwnershipMatches(db: Database, expectedHolder: string, expectedGeneration: number, leaseKey: string): boolean;
+export interface LeaseAcquisition {
+    acquiredAt: number;
+    generation: number;
+}
+export declare function acquireLeaseWithAcquisition(db: Database, holderId: string, leaseKey: string, ttlMs?: number): LeaseAcquisition | null;
+export declare function renewLease(db: Database, holderId: string, leaseKey: string, expectedGeneration?: number, ttlMs?: number): boolean;
+/**
+ * Fork D4 enhancement (plan 10 decision 13): `generation` is REQUIRED and is
+ * re-validated inside the BEGIN IMMEDIATE lock together with holder+expiry, so
+ * a stale holder cannot commit a write even if the holder/expiry rows still
+ * read as its own (upstream only checked holder+expiry here).
+ */
+export declare function runLeaseGuardedWrite<T>(db: Database, holderId: string, leaseKey: string, generation: number, fn: () => T, slowWriteThresholdMs?: number): T;
+/** Atomically refresh an expired lease only if its original holder and generation remain. */
+export declare function reacquireOwnedLease(db: Database, holderId: string, leaseKey: string, generation: number, ttlMs?: number): boolean;
+export interface LeaseHeartbeat {
+    /** Stop the heartbeat timer. Safe to call more than once. */
+    stop(): void;
+    /** True after this process no longer owns the lease and onLost was called. */
+    readonly lost: boolean;
+    /** Number of transient renewal/reacquisition errors observed by this heartbeat. */
+    readonly renewalFailures: number;
+}
+/**
+ * Keep a held lease alive on a background interval. Transient renewal errors are
+ * retried, an expired lease is reacquired when no other holder claimed it, and
+ * lease loss is reported once when ownership or generation no longer matches.
+ */
+export declare function startLeaseHeartbeat(db: Database, holderId: string, leaseKey: string, onLost: (reason: string) => void, intervalOrAcquisition?: number | LeaseAcquisition, ttlMs?: number): LeaseHeartbeat;
+export declare function releaseLease(db: Database, holderId: string, leaseKey: string): void;
+//# sourceMappingURL=lease.d.ts.map

package/dist/features/magic-context/memory-maintainer/lease.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lease.d.ts","sourceRoot":"","sources":["../../../../src/features/magic-context/memory-maintainer/lease.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAA8B,MAAM,wBAAwB,CAAC;AAInF;;;;;;;;;;;;GAYG;AAEH,8DAA8D;AAC9D,eAAO,MAAM,oBAAoB,QAAgB,CAAC;AAElD,6EAA6E;AAC7E,eAAO,MAAM,mCAAmC,QAAY,CAAC;AAE7D,mFAAmF;AACnF,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEzD;AAgCD,wBAAgB,aAAa,CAAC,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAGrE;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAE5E;AAED,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAKhF;AAED,wBAAgB,wBAAwB,CACpC,EAAE,EAAE,QAAQ,EACZ,cAAc,EAAE,MAAM,EACtB,QAAQ,EAAE,MAAM,GACjB,OAAO,CAQT;AAED,wBAAgB,qBAAqB,CACjC,EAAE,EAAE,QAAQ,EACZ,cAAc,EAAE,MAAM,EACtB,kBAAkB,EAAE,MAAM,EAC1B,QAAQ,EAAE,MAAM,GACjB,OAAO,CAKT;AAmCD,MAAM,WAAW,gBAAgB;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,2BAA2B,CACvC,EAAE,EAAE,QAAQ,EACZ,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,KAAK,GAAE,MAA6B,GACrC,gBAAgB,GAAG,IAAI,CAkBzB;AAED,wBAAgB,UAAU,CACtB,EAAE,EAAE,QAAQ,EACZ,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,kBAAkB,CAAC,EAAE,MAAM,EAC3B,KAAK,GAAE,MAA6B,GACrC,OAAO,CAiBT;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,EAClC,EAAE,EAAE,QAAQ,EACZ,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,EAAE,EAAE,MAAM,CAAC,EACX,oBAAoB,CAAC,EAAE,MAAM,GAC9B,CAAC,CAgBH;AAED,6FAA6F;AAC7F,wBAAgB,mBAAmB,CAC/B,EAAE,EAAE,QAAQ,EACZ,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,KAAK,GAAE,MAA6B,GACrC,OAAO,CAcT;AAED,MAAM,WAAW,cAAc;IAC3B,6DAA6D;IAC7D,IAAI,IAAI,IAAI,CAAC;IACb,8EAA8E;IAC9E,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,mFAAmF;IACnF,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CACpC;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAC/B,EAAE,EAAE,QAAQ,EACZ,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,EAChC,qBAAqB,GAAE,MAAM,GAAG,gBAAsD,EACtF,KAAK,GAAE,MAA6B,GACrC,cAAc,CAuEhB;AAED,wBAAgB,YAAY,CAAC,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAWnF"}

package/dist/features/magic-context/memory-maintainer/manifest.d.ts

@@ -0,0 +1,127 @@
+/**
+ * Structural validation for memory-maintainer suggestion manifests (plan 10
+ * §4.1/§4.4, D8). Zero-dependency pure functions: the model output is only
+ * trusted as a structured manifest, and validation splits outputs into two
+ * classes —
+ *   - ILLEGAL (malformed / out-of-contract): the whole batch is voided, bank
+ *     nothing, retry next round;
+ *   - OK: a legal (possibly partial) item list that the host applies item by
+ *     item.
+ *
+ * Ported from the upstream dreamer's manifest-parser.ts (8a69b3a95c) shape:
+ *   1. a missing closing root tag is truncation and rejects the whole output,
+ *      so a length-capped model response can never apply a prefix of mutations;
+ *   2. a missing complete root element rejects the output;
+ *   3. duplicate ids reject the output.
+ * Fork additions: action-enum check, id ⊆ requested pool, mandatory
+ * reason+evidence on archive/update, update content bounds, merge-group
+ * integrity (≥2 distinct in-pool sources), and the zero-entry rule (illegal
+ * against a non-empty pool request, a legal empty list against an empty one).
+ *
+ * F3 additive change (P1, plan 10 decisions 10/20 — documented in the P1
+ * report): the `<keep id="N"/>` no-action verdict entry. Without it a pool
+ * where every item is fine can only produce a zero-entry manifest, which the
+ * zero-entry rule rejects — "全池正确、零动作也计进度" would be inexpressible.
+ * keep is a per-id "explicitly no change needed" verdict: in-pool id required,
+ * no reason/evidence (nothing destructive), counts as a manifest item.
+ */
+export declare const MANIFEST_ROOT = "maintenance-manifest";
+export declare const MIN_UPDATE_CONTENT_LENGTH = 1;
+export declare const MAX_UPDATE_CONTENT_LENGTH = 20000;
+export type ManifestAction = "archive" | "update" | "merge";
+export interface ManifestArchiveItem {
+    action: "archive";
+    id: number;
+    reason: string;
+    evidence: string;
+}
+export interface ManifestUpdateItem {
+    action: "update";
+    id: number;
+    content: string;
+    reason: string;
+    evidence: string;
+    /** Declared by consolidation="true": the shrink gate below is bypassed. */
+    consolidation: boolean;
+}
+export interface ManifestMergeItem {
+    action: "merge";
+    targetId: number;
+    /** Merged content for the target; null lets the host synthesize from the sources. */
+    content: string | null;
+    reason: string;
+    evidence: string;
+    sources: number[];
+}
+/** F3 addition: explicit "reviewed, no change needed" verdict for one pool id. */
+export interface ManifestKeepItem {
+    action: "keep";
+    id: number;
+}
+export type ManifestItem = ManifestArchiveItem | ManifestUpdateItem | ManifestMergeItem | ManifestKeepItem;
+export type ParseManifestResult = {
+    kind: "ok";
+    items: ManifestItem[];
+} | {
+    kind: "illegal";
+    reason: string;
+};
+export type ContentShrinkVerdict = {
+    kind: "ok";
+} | {
+    kind: "refused";
+    reason: string;
+};
+/**
+ * Validate a manifest against a requested pool. Illegal = the whole batch is
+ * voided (fail-fast on the first violation). A zero-entry manifest is illegal
+ * against a non-empty pool request and a legal empty list against an empty one.
+ */
+export declare function parseManifest(text: string, poolIds: ReadonlySet<number>): ParseManifestResult;
+/**
+ * Content-shrink gate (upstream verify's content-loss door, fork shape): an
+ * update whose new content is less than HALF the original length, without a
+ * declared consolidation, is refused AS AN ITEM — never an illegal batch.
+ */
+export declare function screenContentShrink(item: ManifestItem, originalContent: string): ContentShrinkVerdict;
+/**
+ * AGENTS-citation structural backstop (plan 10 decision 12, P3 contract —
+ * "manifest 校验要求 AGENTS 来源建议必含引文（可校验约束，非纯 prompt 约定）").
+ *
+ * The stage-A prompt already requires an archive/update grounded in a conflict
+ * with the authoritative AGENTS text to quote it verbatim inside `evidence`.
+ * This screen turns that prompt convention into a host-side structural check.
+ * Convention (minimal additive to the manifest attribute surface — no new tag
+ * or attribute): the evidence carries the literal `AGENTS:` marker and the
+ * text after the FIRST marker occurrence is the citation.
+ *
+ * A marked item's citation must appear VERBATIM — after whitespace
+ * normalization — in this round's AGENTS source text (OC2: the probe-time host
+ * system snapshot; Pi: the project root AGENTS.md; delivered to this screen
+ * through the pipeline's `MaintenanceSeams.agentsSourceText`). Failure modes
+ * are refused AS AN ITEM, never an illegal batch (same per-item downgrade as
+ * {@link screenContentShrink}): no AGENTS source text available this round →
+ * every marked item is refused; a missing or too-short-to-be-a-quote citation
+ * → refused; a citation that does not appear verbatim in the source text →
+ * refused. Refused items are simply not banked — they stay uncovered and the
+ * next run may re-propose them.
+ *
+ * Items WITHOUT the marker make no explicit authority claim — but an
+ * evidence that still REFERENCES AGENTS without quoting it is an omission
+ * bypass (gate-4 S3): archive/update items whose evidence mentions `AGENTS`
+ * (case-insensitive, which covers `agents.md`) yet carries no marker are
+ * refused item by item, same as marked failures. Plain value archives
+ * (redundancy / low value) never mention AGENTS and pass untouched; merge
+ * groups cite redundancy, not authority, and are not netted.
+ */
+export declare const AGENTS_CITATION_MARKER = "AGENTS:";
+/** Floor for "a few words to one sentence" (whitespace-normalized characters). */
+export declare const MIN_AGENTS_CITATION_CHARS = 8;
+export type AgentsCitationVerdict = {
+    kind: "ok";
+} | {
+    kind: "refused";
+    reason: string;
+};
+export declare function screenAgentsCitation(item: ManifestItem, agentsSourceText: string | null | undefined): AgentsCitationVerdict;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/features/magic-context/memory-maintainer/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../../../src/features/magic-context/memory-maintainer/manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,eAAO,MAAM,aAAa,yBAAyB,CAAC;AAEpD,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAC3C,eAAO,MAAM,yBAAyB,QAAS,CAAC;AAEhD,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;AAE5D,MAAM,WAAW,mBAAmB;IAChC,MAAM,EAAE,SAAS,CAAC;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IAC/B,MAAM,EAAE,QAAQ,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,2EAA2E;IAC3E,aAAa,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAC9B,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,qFAAqF;IACrF,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,kFAAkF;AAClF,MAAM,WAAW,gBAAgB;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,YAAY,GAClB,mBAAmB,GACnB,kBAAkB,GAClB,iBAAiB,GACjB,gBAAgB,CAAC;AAEvB,MAAM,MAAM,mBAAmB,GACzB;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,YAAY,EAAE,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1C,MAAM,MAAM,oBAAoB,GAAG;IAAE,IAAI,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAgDxF;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,mBAAmB,CA+K7F;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAC/B,IAAI,EAAE,YAAY,EAClB,eAAe,EAAE,MAAM,GACxB,oBAAoB,CAUtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,eAAO,MAAM,sBAAsB,YAAY,CAAC;AAShD,kFAAkF;AAClF,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAE3C,MAAM,MAAM,qBAAqB,GAAG;IAAE,IAAI,EAAE,IAAI,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAkBzF,wBAAgB,oBAAoB,CAChC,IAAI,EAAE,YAAY,EAClB,gBAAgB,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC5C,qBAAqB,CA6CvB"}

package/dist/features/magic-context/memory-maintainer/manual-commands.d.ts

@@ -0,0 +1,46 @@
+import type { Database } from "../../../shared/sqlite";
+import type { MaintenanceLauncher, MaintenanceLaunchRunContext } from "./launcher";
+/**
+ * Host-agnostic core of the manual `/mmc-memory-maintain` command (plan 10
+ * decision 22, G3). The command is ONLY a host-side orchestration entry: it
+ * adds no write path of its own — `run` goes through the project's wired
+ * launcher (manual launch, scheduling gates overridden, every safety gate
+ * kept), `resume` is {@link resumeMaintenance}, `status` is pure read. Both
+ * hosts (OC2 RPC handler, Pi command) render the returned message text.
+ */
+export type MaintenanceCommandAction = "run" | "status" | "resume";
+export interface ManualMaintenanceCommandResult {
+    action: MaintenanceCommandAction;
+    /** False when the requested action could not take effect at all. */
+    ok: boolean;
+    /** For "run": whether a run was actually fired. */
+    launched?: boolean;
+    /** Pre-formatted multi-line report for the command result surface. */
+    message: string;
+}
+/** Schedule row + recent runs + pause report as readable text (read-only). */
+export declare function formatMaintenanceStatus(db: Database, projectPath: string): string;
+/**
+ * One manual sub-operation. `run` requires the host's wired launcher: it
+ * writes `next_due_at` to now (immediately due — clearing stale backoff and
+ * persisting the intent if the in-flight mutex blocks this attempt) and then
+ * launches through {@link MaintenanceLauncher.launchManual}, which overrides
+ * the scheduling gates but never the master switch, the pause, the pool
+ * check, or the pipeline's lease / budget / anomaly doors.
+ */
+export declare function runManualMaintenanceCommand(args: {
+    db: Database;
+    projectPath: string;
+    action: MaintenanceCommandAction;
+    /** Required for "run"; ignored otherwise. */
+    launcher?: MaintenanceLauncher;
+    /**
+     * Gate-4 M1: the manual run's explicit run context, built by the host
+     * from the REQUESTING session (never a shared slot — a stale slot would
+     * run this request against another session's directory/system text).
+     * Carried into the launch signals the run factory consumes.
+     */
+    runContext?: MaintenanceLaunchRunContext;
+    nowMs?: () => number;
+}): ManualMaintenanceCommandResult;
+//# sourceMappingURL=manual-commands.d.ts.map

package/dist/features/magic-context/memory-maintainer/manual-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manual-commands.d.ts","sourceRoot":"","sources":["../../../../src/features/magic-context/memory-maintainer/manual-commands.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,KAAK,EACR,mBAAmB,EACnB,2BAA2B,EAE9B,MAAM,YAAY,CAAC;AAapB;;;;;;;GAOG;AAEH,MAAM,MAAM,wBAAwB,GAAG,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEnE,MAAM,WAAW,8BAA8B;IAC3C,MAAM,EAAE,wBAAwB,CAAC;IACjC,oEAAoE;IACpE,EAAE,EAAE,OAAO,CAAC;IACZ,mDAAmD;IACnD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,sEAAsE;IACtE,OAAO,EAAE,MAAM,CAAC;CACnB;AA2BD,8EAA8E;AAC9E,wBAAgB,uBAAuB,CAAC,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAiCjF;AAED;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE;IAC9C,EAAE,EAAE,QAAQ,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,wBAAwB,CAAC;IACjC,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,mBAAmB,CAAC;IAC/B;;;;;OAKG;IACH,UAAU,CAAC,EAAE,2BAA2B,CAAC;IACzC,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;CACxB,GAAG,8BAA8B,CA2EjC"}

package/dist/features/magic-context/memory-maintainer/oc2-adapter.d.ts

@@ -0,0 +1,79 @@
+import type { MagicContextConfig } from "../../../config/schema/magic-context";
+import type { HiddenCompletionExecutor } from "../../../hooks/magic-context/compartment-runner-types";
+import type { Database } from "../../../shared/sqlite";
+import type { MaintenanceRunFactory } from "./launcher";
+import { type MaintenancePhaseResult, type PhaseContext } from "./pipeline";
+export { countMaintenancePool } from "./schedule-storage";
+/**
+ * The `maintenance.*` config slice (user-tier only; project tier is stripped).
+ */
+export type MaintenanceHostConfig = MagicContextConfig["maintenance"];
+/**
+ * Host adapter for the OpenCode 2 lane (plan 10 P2/F4b; P3 prompt assembly +
+ * P3 real apply). Wires the shared pipeline to this host's hidden-completion
+ * executor: stages A/B run as hidden child sessions on the maintainer agent
+ * ids (decision 3) over the shared prompt core (agents/memory-maintainer.ts),
+ * tool steps and usage stream through the pipeline's PhaseContext meter, and
+ * the apply seam is the P3 audited host apply (makeValidatingApplySeam):
+ * applied suggestions really write, audited per decision 17, with the run's
+ * lease context re-validated inside every write transaction (D4).
+ *
+ * Model chain (decision 2): the child resolves its head from the parent
+ * session's model (executor fallback), exactly like the historian — no new
+ * routing surface.
+ */
+export interface Oc2MaintenanceRunFactoryOptions {
+    db: Database;
+    projectPath: string;
+    /**
+     * The host's hidden-completion executor. Production always passes the
+     * wired executor (the transform tail only arms when one exists); absent
+     * means the run factory refuses cleanly instead of failing a stage.
+     */
+    executor?: HiddenCompletionExecutor;
+    config: () => MaintenanceHostConfig;
+    nowMs?: () => number;
+}
+/** Raw apply rounds the current run's child for `agent` already consumed. */
+export declare function readMaintenanceChildStepsConsumed(agent: string): number;
+/** Clear the per-agent consumed counters (run-factory start; exported for tests). */
+export declare function resetMaintenanceChildStepsConsumed(): void;
+/**
+ * The next attempt's physical cap: the budget minus what earlier rounds of
+ * this agent already consumed, floored at 1 — even a fully consumed budget
+ * still owes the child one apply to emit its final manifest.
+ */
+export declare function resolveMaintenanceStepCap(baseSteps: number, consumedSteps: number): number;
+interface PhaseExecutorDeps {
+    executor?: HiddenCompletionExecutor;
+    /** Run budget; wallMs caps each attempt, toolSteps caps stage B's child. */
+    budget: MaintenanceHostConfig["budgets"];
+    parentSessionId: () => string | undefined;
+    directory: () => string | undefined;
+    /** Probe-time host system-prompt snapshot; absent → no AGENTS block. */
+    hostSystemText?: () => string | undefined;
+    nowMs: () => number;
+}
+export type { PhaseExecutorDeps };
+/**
+ * One maintainer stage over the hidden-completion executor. Streaming
+ * accounting mode: usage and tool steps are charged to ctx AS consumed, so
+ * the follow-up round sees live meter state (N7 finalize contract) and the
+ * returned phase result carries zero deltas — the pipeline's post-hoc
+ * recording then adds nothing ("never both").
+ *
+ * Round shape (≤2 attempts): round 0 runs the base prompt (plus the finalize
+ * instruction when the window opened before the stage); if the window opened
+ * during round 0 and nothing banked, round 1 re-prompts with the finalize
+ * instruction (N7: shouldContinue()=='finalize' is passed to the model
+ * explicitly as the wind-down directive).
+ */
+export declare function runOc2MaintenancePhase(ctx: PhaseContext, phase: "A" | "B", deps: PhaseExecutorDeps, stageAManifest?: string): Promise<MaintenancePhaseResult>;
+/**
+ * Build the launcher's run factory for the OC2 lane: one bounded maintenance
+ * run over the shared pipeline, shaped into the launcher's summary. All
+ * failures land in the summary (ok:false) — the launcher never rethrows and
+ * the pass that triggered the launch never observes them.
+ */
+export declare function createOc2MaintenanceRunFactory(options: Oc2MaintenanceRunFactoryOptions): MaintenanceRunFactory;
+//# sourceMappingURL=oc2-adapter.d.ts.map

package/dist/features/magic-context/memory-maintainer/oc2-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"oc2-adapter.d.ts","sourceRoot":"","sources":["../../../../src/features/magic-context/memory-maintainer/oc2-adapter.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAC/E,OAAO,KAAK,EAER,wBAAwB,EAE3B,MAAM,uDAAuD,CAAC;AAG/D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAIvD,OAAO,KAAK,EAER,qBAAqB,EAExB,MAAM,YAAY,CAAC;AACpB,OAAO,EAEH,KAAK,sBAAsB,EAG3B,KAAK,YAAY,EAEpB,MAAM,YAAY,CAAC;AAKpB,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE1D;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,kBAAkB,CAAC,aAAa,CAAC,CAAC;AAEtE;;;;;;;;;;;;;GAaG;AAEH,MAAM,WAAW,+BAA+B;IAC5C,EAAE,EAAE,QAAQ,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,wBAAwB,CAAC;IACpC,MAAM,EAAE,MAAM,qBAAqB,CAAC;IACpC,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;CACxB;AAmBD,6EAA6E;AAC7E,wBAAgB,iCAAiC,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEvE;AAED,qFAAqF;AACrF,wBAAgB,kCAAkC,IAAI,IAAI,CAEzD;AASD;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM,CAE1F;AAkDD,UAAU,iBAAiB;IACvB,QAAQ,CAAC,EAAE,wBAAwB,CAAC;IACpC,4EAA4E;IAC5E,MAAM,EAAE,qBAAqB,CAAC,SAAS,CAAC,CAAC;IACzC,eAAe,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IAC1C,SAAS,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IACpC,wEAAwE;IACxE,cAAc,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IAC1C,KAAK,EAAE,MAAM,MAAM,CAAC;CACvB;AAED,YAAY,EAAE,iBAAiB,EAAE,CAAC;AA0BlC;;;;;;;;;;;;GAYG;AACH,wBAAsB,sBAAsB,CACxC,GAAG,EAAE,YAAY,EACjB,KAAK,EAAE,GAAG,GAAG,GAAG,EAChB,IAAI,EAAE,iBAAiB,EACvB,cAAc,SAAK,GACpB,OAAO,CAAC,sBAAsB,CAAC,CA8FjC;AAuCD;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAC1C,OAAO,EAAE,+BAA+B,GACzC,qBAAqB,CAwCvB"}

package/dist/features/magic-context/memory-maintainer/pause-report.d.ts

@@ -0,0 +1,37 @@
+import type { Database } from "../../../shared/sqlite";
+/**
+ * Human-visible face of the maintenance anomaly pause (plan 10 decision 11:
+ * pause + visible report, EXPLICIT resume only — the next run never
+ * auto-bypasses a pause). Assembles the pause state plus the run telemetry
+ * that tripped the threshold into a readable report, announces it on the
+ * shared log for high visibility, and provides the minimal resume wrapper:
+ * a logged clear plus a `next_due_at` reset that re-arms the launcher. The
+ * command/UI entry point that calls these lives with the host adapters (G3).
+ */
+export interface MaintenancePauseReport {
+    projectPath: string;
+    reason: string;
+    pausedAt: number;
+    /** The raw pause payload written by the anomaly guard (pipeline shape). */
+    pauseReport: unknown;
+    /** `dream_runs` id of the run that tripped the threshold, when identifiable. */
+    runId: number | null;
+    runFinishedAt: number | null;
+    /** Human-readable lines (also returned pre-formatted via {@link formatMaintenancePauseReport}). */
+    lines: string[];
+}
+/**
+ * Assemble the pause report, or null when the project is not paused. A pause
+ * always logs one high-visibility line — this is the "something needs a
+ * human" signal an operator scanning mmc.log must not miss.
+ */
+export declare function getMaintenancePauseReport(db: Database, projectPath: string): MaintenancePauseReport | null;
+/** Pre-formatted multi-line report for command output / logs. */
+export declare function formatMaintenancePauseReport(report: MaintenancePauseReport): string;
+/**
+ * Explicit resume (decision 11): log the clear, drop the pause state, and
+ * reset `next_due_at` so the launcher re-arms immediately. Returns false when
+ * there was no pause to clear (schedule untouched).
+ */
+export declare function resumeMaintenance(db: Database, projectPath: string): boolean;
+//# sourceMappingURL=pause-report.d.ts.map

package/dist/features/magic-context/memory-maintainer/pause-report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pause-report.d.ts","sourceRoot":"","sources":["../../../../src/features/magic-context/memory-maintainer/pause-report.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAQvD;;;;;;;;GAQG;AAEH,MAAM,WAAW,sBAAsB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,2EAA2E;IAC3E,WAAW,EAAE,OAAO,CAAC;IACrB,gFAAgF;IAChF,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,mGAAmG;IACnG,KAAK,EAAE,MAAM,EAAE,CAAC;CACnB;AAwBD;;;;GAIG;AACH,wBAAgB,yBAAyB,CACrC,EAAE,EAAE,QAAQ,EACZ,WAAW,EAAE,MAAM,GACpB,sBAAsB,GAAG,IAAI,CA6B/B;AAqED,iEAAiE;AACjE,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,sBAAsB,GAAG,MAAM,CAEnF;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAa5E"}

package/dist/features/magic-context/memory-maintainer/pipeline.d.ts

@@ -0,0 +1,199 @@
+import type { Database } from "../../../shared/sqlite";
+import type { ValidatingApplyLease } from "./apply";
+import { type BudgetDecision, type MaintenanceBudget, type ToolStepRefusal } from "./budget";
+import { type AnomalyThreshold, type PoolItemRef } from "./coverage";
+import { type ManifestItem } from "./manifest";
+import { type MaintenanceCooldownConfig, type RunOutcome } from "./schedule";
+/** §4.2: consecutive runs without a newly processed snapshot item circuit-break the round. */
+export declare const ZERO_PROGRESS_CIRCUIT_BREAK_RUNS = 2;
+export interface MaintenanceUsageDelta {
+    inputTokens?: number;
+    outputTokens?: number;
+}
+export interface PhaseContext {
+    db: Database;
+    projectPath: string;
+    /** Decision 6 recursion flag surfaced to seams (real seams must refuse to nest). */
+    childSession: boolean;
+    /** The unprocessed snapshot subset this run must judge. */
+    pending: readonly PoolItemRef[];
+    fullPool: readonly PoolItemRef[];
+    /** Budget gate: "continue" while new work may still be opened. */
+    shouldContinue(): BudgetDecision;
+    recordUsage(delta: MaintenanceUsageDelta): void;
+    recordToolStep(): void;
+    refuseToolStep(): ToolStepRefusal;
+}
+export interface MaintenancePhaseResult {
+    /** Raw stage output; parsed with parseManifest against the pending pool ids. */
+    manifestText: string;
+    usage: MaintenanceUsageDelta;
+    /**
+     * Tool steps the stage consumed (stage B typically). AUTHORITATIVE: the
+     * pipeline records this count into the budget meter after the phase
+     * returns. Seams that stream steps through ctx.recordToolStep instead must
+     * return toolSteps: 0 — never both.
+     */
+    toolSteps?: number;
+    /**
+     * Raw hidden-child transcript for provider-outout classification
+     * (providerOutputFailureFromInvalidManifest). Fake seams omit it: an
+     * illegal manifest then stays a plain (retryable) illegal batch.
+     */
+    messages?: unknown;
+}
+export interface ApplyOutcome {
+    /** Primary id (targetId for merge groups). */
+    id: number;
+    result: "applied" | "skipped";
+    /** Skip reason: "concurrent-modification" → deferred_concurrent; anything else → skipped + audit. */
+    skipReason?: string;
+    detail?: string;
+    /** Rows actually changed (merge groups touch several). */
+    changedRows?: number;
+    /**
+     * Every round-snapshot id the outcome settles — merge groups report the
+     * target AND all sources (applied merges only). The coverage ledger marks
+     * each member `actioned`; a source listed here was superseded/archived by
+     * the merge, so marking only the primary id would strand it: the archived
+     * row drops below the loadPool waterline yet keeps its unprocessed ledger
+     * slot, re-entering every later round's pending as a ghost row the prompt
+     * can never show (the round never completes).
+     */
+    memberIds?: number[];
+}
+export type ApplyItemsResult = ApplyOutcome[] | Promise<ApplyOutcome[]>;
+export interface MaintenanceSeams {
+    /** Load the review pool (decision 19: every non-archived row). */
+    loadPool(db: Database, projectPath: string): PoolItemRef[];
+    /** Stage A: full-pool value screen / dedup / AGENTS reconcile (zero tools). */
+    runPhaseA(ctx: PhaseContext): Promise<MaintenancePhaseResult>;
+    /** Stage B: read-only verification of fact-bearing candidates. */
+    runPhaseB(ctx: PhaseContext): Promise<MaintenancePhaseResult>;
+    /**
+     * Apply merged suggestions item by item. The pre-apply semantic-snapshot
+     * check happens INSIDE the seam (decision 13). P3 ships
+     * {@link makeValidatingApplySeam} (`apply.ts`): the audited host apply —
+     * every applied action writes, in a short transaction that re-validates
+     * the round snapshot AND, when the pipeline hands it the run's lease
+     * context, the claim's holder + generation inside the lock (D4 fencing).
+     */
+    applyItems(items: readonly ManifestItem[], lease?: ValidatingApplyLease): ApplyItemsResult;
+    /**
+     * Decision 12: this round's authoritative AGENTS text (OC2: the probe-time
+     * host system snapshot; Pi: the project root AGENTS.md), or null when
+     * unavailable. Consumed by the AGENTS-citation structural backstop
+     * (manifest.screenAgentsCitation): suggestions marked with the `AGENTS:`
+     * citation marker that fail the verbatim-quote check are refused item by
+     * item before they ever reach the apply seam.
+     */
+    agentsSourceText?(): string | null;
+    /** Injected clock — never a bare Date.now (test determinism). */
+    nowMs(): number;
+}
+export interface MaintenanceRunConfig {
+    budgets: MaintenanceBudget;
+    cooldowns: MaintenanceCooldownConfig;
+    anomalyThreshold: AnomalyThreshold;
+}
+export interface MaintenanceRunOptions {
+    db: Database;
+    projectPath: string;
+    config: MaintenanceRunConfig;
+    seams: MaintenanceSeams;
+    /** Decision 6: a maintenance hidden child must never re-trigger a run. */
+    childFlag?: boolean;
+    /** Lease holder id; defaults to a fresh random UUID. */
+    holderId?: string;
+    parentSessionId?: string | null;
+    /**
+     * Lease TTL for acquisition AND heartbeat renewal; defaults to the lease
+     * module's 2min. The wall-clock budget (15min) far exceeds the TTL — the
+     * run ALWAYS holds a heartbeat for its whole lifetime (gate-2 fix).
+     */
+    leaseTtlMs?: number;
+    /** Heartbeat cadence; defaults to the lease module's 40s (tests inject a fast tick). */
+    leaseHeartbeatIntervalMs?: number;
+}
+export type MaintenanceStageStatus = "ok" | "illegal" | "provider-failure" | "skipped-budget" | "circuit-broken";
+export interface MaintenanceRunCompleted {
+    kind: "completed";
+    outcome: RunOutcome;
+    /** Failure-family detail (illegal manifests, no progress, provider outage). */
+    reason: string | null;
+    processedDelta: number;
+    changedRows: number;
+    anomalyPaused: boolean;
+    /** `dream_runs` telemetry row id, when the telemetry write landed. */
+    runId: number | null;
+    leaseGeneration: number;
+    stages: {
+        A: MaintenanceStageStatus;
+        B: MaintenanceStageStatus;
+    };
+}
+export type MaintenanceRunResult = {
+    kind: "child-session";
+} | {
+    kind: "lease-busy";
+} | {
+    kind: "failed";
+    error: string;
+} | MaintenanceRunCompleted;
+export type MaintenanceStageTelemetry = {
+    stage: "A" | "B";
+    status: MaintenanceStageStatus;
+    illegalReason?: string;
+    providerFingerprint?: string;
+    /** AGENTS-citation backstop refusals (decision 12), when any. */
+    refusedItems?: Array<{
+        id: number;
+        reason: string;
+    }>;
+    budget: {
+        budget: MaintenanceBudget;
+        spent: {
+            inputTokens: number;
+            outputTokens: number;
+            toolSteps: number;
+            wallMs: number;
+        };
+        finalizeFired: boolean;
+        banked: number;
+    };
+};
+/**
+ * Real pool loader (decision 19): every non-archived row — active + permanent,
+ * permanent NOT exempt. Expired-but-unarchived rows deliberately stay in the
+ * pool: the maintainer is the path that archives them (the "stranded expired
+ * rows" incident), so the expiry render filter is bypassed here.
+ */
+export declare function defaultLoadPool(db: Database, projectPath: string): PoolItemRef[];
+/**
+ * P1 apply seam: a BOOKKEEPING stub. It performs the real per-item semantic
+ * snapshot check (decision 13 — content hash + category + status, never
+ * `updated_at`) against the round snapshot and reports what WOULD happen, but
+ * writes nothing: P3 replaces it with the audited host apply.
+ */
+export declare function makeBookkeepingApplySeam(options: {
+    db: Database;
+    snapshotRef(id: number): PoolItemRef | undefined;
+}): (items: readonly ManifestItem[]) => ApplyOutcome[];
+/**
+ * Host-side merge of the two stage lists (plan §4.1): same id + same action +
+ * identical payload → dedupe (first occurrence wins); same id with a
+ * different action OR a different payload → conflict: the item is dropped and
+ * the caller records ledger "unknown" (conservative).
+ */
+export declare function mergeStageManifests(stageA: readonly ManifestItem[], stageB: readonly ManifestItem[]): {
+    merged: ManifestItem[];
+    conflicts: number[];
+};
+/**
+ * One bounded maintenance run: acquire the project lease → start/resume the
+ * coverage round → budgeted phases A and B → manifest validation and host-side
+ * merge → itemized apply → ledger + anomaly guard → telemetry → schedule
+ * outcome → release. Lease busy is a clean no-op (the next trigger retries).
+ */
+export declare function runMaintenanceRun(opts: MaintenanceRunOptions): Promise<MaintenanceRunResult>;
+//# sourceMappingURL=pipeline.d.ts.map

package/dist/features/magic-context/memory-maintainer/pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../../../src/features/magic-context/memory-maintainer/pipeline.ts"],"names":[],"mappings":"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"}

package/dist/features/magic-context/memory-maintainer/provider-output-failure.d.ts

@@ -0,0 +1,15 @@
+/** A provider transport failure that arrived as an ordinary assistant completion. */
+export declare class DreamerProviderOutputFailureError extends Error {
+    readonly fingerprint: string;
+    readonly outputTokens: number;
+    readonly reasoningTokens: number;
+    readonly transient = true;
+    constructor(fingerprint: string, outputTokens: number, reasoningTokens: number, responseText: string);
+}
+/**
+ * OpenCode can serialize a provider outage as a successful `finish=stop` assistant
+ * message. Only classify that shape after manifest validation has already failed:
+ * a real manifest remains authoritative regardless of its token counts.
+ */
+export declare function providerOutputFailureFromInvalidManifest(messages: unknown, responseText: string): DreamerProviderOutputFailureError | null;
+//# sourceMappingURL=provider-output-failure.d.ts.map

package/dist/features/magic-context/memory-maintainer/provider-output-failure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-output-failure.d.ts","sourceRoot":"","sources":["../../../../src/features/magic-context/memory-maintainer/provider-output-failure.ts"],"names":[],"mappings":"AAcA,qFAAqF;AACrF,qBAAa,iCAAkC,SAAQ,KAAK;IAIpD,QAAQ,CAAC,WAAW,EAAE,MAAM;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM;IAC7B,QAAQ,CAAC,eAAe,EAAE,MAAM;IALpC,QAAQ,CAAC,SAAS,QAAQ;gBAGb,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,eAAe,EAAE,MAAM,EAChC,YAAY,EAAE,MAAM;CAQ3B;AAwCD;;;;GAIG;AACH,wBAAgB,wCAAwC,CACpD,QAAQ,EAAE,OAAO,EACjB,YAAY,EAAE,MAAM,GACrB,iCAAiC,GAAG,IAAI,CAqB1C"}