@retaw106/mmc-oc 0.0.0-stage → 1.2.2

package/dist/features/magic-context/search.d.ts

@@ -0,0 +1,118 @@
+import type { Database } from "../../shared/sqlite";
+import { type Note } from "./storage-notes";
+/**
+ * Upper bound on the results one search returns. The limit comes from the
+ * model, and each tier fetches three times it, so without a bound a call like
+ * `limit: 1e6` could dump the whole archive into one tool result. Matches the
+ * Rust module's ctx_search clamp.
+ */
+export declare const MAX_UNIFIED_SEARCH_LIMIT = 25;
+export type SearchSource = "memory" | "message" | "primer" | "note";
+export interface UnifiedSearchDiagnostics {
+    suppressedVisibleMemoryIds: number[];
+    suppressedLiveMessageMatches: number;
+}
+export declare function createUnifiedSearchDiagnostics(): UnifiedSearchDiagnostics;
+export interface UnifiedSearchOptions {
+    limit?: number;
+    /** Earliest persisted source timestamp in epoch milliseconds (inclusive). */
+    from?: number;
+    /** Latest persisted source timestamp in epoch milliseconds (inclusive). */
+    to?: number;
+    memoryEnabled?: boolean;
+    /** Deprecated: message search no longer reads raw messages on the hot path. */
+    readMessages?: (sessionId: string) => unknown[];
+    /** Only return message-history hits with ordinal ≤ this value (e.g. last compartment end). -1 or omit to search all. */
+    maxMessageOrdinal?: number;
+    /** Restrict results to these sources. Omit or pass undefined to search all
+     *  enabled sources. Empty array is treated as "no sources enabled" → [].
+     *  Facts are NOT a source — they're already always rendered in the
+     *  <session-history> block injected into message[0]. */
+    sources?: SearchSource[];
+    /** Hard-filter memories already rendered in <session-history>. The agent
+     *  can see them in message[0] — surfacing them via mmc_search wastes
+     *  tokens and crowds out high-signal raw-history hits. Pass null or omit
+     *  to disable filtering (for callers outside the transform context that
+     *  can't resolve the visible set). */
+    visibleMemoryIds?: Set<number> | null;
+    /** Optional mutable diagnostic sink for explicit tool calls. Search fills it
+     *  from the same candidate sets used by visibility filters; background
+     *  callers can omit it and retain the lean result-only path. */
+    diagnostics?: UnifiedSearchDiagnostics;
+    /** When true (default), increment retrieval_count on memory hits. Explicit
+     *  `mmc_search` tool calls from the agent SHOULD count — the agent asked
+     *  for the memory, saw it, and used it. Plugin-internal automatic surfacing
+     *  (e.g. auto-search hints appended to every user prompt) should NOT count
+     *  because the agent may never actually consume the hint, and even if they
+     *  do, automatic surfacing doesn't indicate usefulness. Mis-counting drives
+     *  spurious retrieval-count-based memory promotion decisions. */
+    countRetrievals?: boolean;
+    /** When true, run multi-probe message search: extract literal symbol/command/
+     *  path probes from the query and query each one separately (RRF-fused) so a
+     *  message containing the exact literal but not the query's other tokens is
+     *  still recalled. Default false — only explicit `mmc_search` tool calls opt
+     *  in; the auto-search hot path stays single-probe to protect its latency
+     *  budget. NL queries with no extractable probes are unaffected either way. */
+    explicitSearch?: boolean;
+}
+export interface MemorySearchResult {
+    source: "memory";
+    content: string;
+    score: number;
+    memoryId: number;
+    category: string;
+    matchType: "fts";
+    sourceName?: string;
+}
+export interface MessageSearchResult {
+    source: "message";
+    content: string;
+    score: number;
+    messageOrdinal: number;
+    messageId: string;
+    role: string;
+}
+export interface PrimerSearchResult {
+    source: "primer";
+    content: string;
+    score: number;
+    primerId: number;
+    question: string;
+    support: number;
+    lastObservedAt: number | null;
+    matchType: "fts";
+}
+export interface NoteSearchResult {
+    source: "note";
+    content: string;
+    score: number;
+    noteId: number;
+    status: Note["status"];
+    createdAt: number;
+    anchorOrdinal: number | null;
+    sourceSessionId: string | null;
+}
+export type UnifiedSearchResult = MemorySearchResult | MessageSearchResult | PrimerSearchResult | NoteSearchResult;
+export declare const ID_SHAPED_QUERY_MAX_TOKENS = 5;
+export declare function parseIdShapedQuery(query: string): number[] | null;
+/** Resolve a parsed id list through the session's visibility scope. Returns
+ *  MemorySearchResult rows in the caller's id order, or `null` when nothing
+ *  resolved (signals the caller to fall through to the normal search lanes). */
+export declare function resolveMemoriesByIdsForSearch(args: {
+    db: Database;
+    projectPath: string;
+    ids: readonly number[];
+    limit: number;
+    /** Optional filter mirroring the m[0] hard-filter — already-rendered
+     *  memories are skipped so the agent doesn't see the same content twice. */
+    visibleMemoryIds?: Set<number> | null;
+    diagnostics?: UnifiedSearchDiagnostics;
+    from?: number;
+    to?: number;
+}): MemorySearchResult[] | null;
+export declare function unifiedSearch(db: Database, sessionId: string, projectPath: string, query: string, options?: UnifiedSearchOptions): Promise<UnifiedSearchResult[]>;
+/** Render output for explicit `mmc_search` callers in OpenCode and Pi. Include
+ * diagnostics so intentional visibility suppression is explained while genuine
+ * empty corpora retain their established wording. */
+export declare function formatSearchResults(query: string, results: UnifiedSearchResult[], currentSessionId: string, diagnostics?: UnifiedSearchDiagnostics): string;
+//# sourceMappingURL=search.d.ts.map

package/dist/features/magic-context/search.d.ts.map

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

package/dist/features/magic-context/session-cache-ttl.d.ts

@@ -0,0 +1,10 @@
+import { type CacheTtlConfig, type ResolvedCacheTtl } from "../../shared/model-cache-ttl";
+import type { ContextDatabase } from "./storage-db";
+interface SessionCacheTtl extends ResolvedCacheTtl {
+    config: CacheTtlConfig;
+}
+export declare function readSessionCacheTtl(db: ContextDatabase, sessionId: string): SessionCacheTtl | undefined;
+/** Freeze config once the model is known; a real model switch still selects its own lifetime. */
+export declare function resolveSessionCacheTtl(db: ContextDatabase, sessionId: string, config: CacheTtlConfig | undefined, modelKey: string | undefined): ResolvedCacheTtl;
+export {};
+//# sourceMappingURL=session-cache-ttl.d.ts.map

package/dist/features/magic-context/session-cache-ttl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-cache-ttl.d.ts","sourceRoot":"","sources":["../../../src/features/magic-context/session-cache-ttl.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,KAAK,cAAc,EACnB,KAAK,gBAAgB,EAExB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAIpD,UAAU,eAAgB,SAAQ,gBAAgB;IAC9C,MAAM,EAAE,cAAc,CAAC;CAC1B;AAED,wBAAgB,mBAAmB,CAC/B,EAAE,EAAE,eAAe,EACnB,SAAS,EAAE,MAAM,GAClB,eAAe,GAAG,SAAS,CAK7B;AAED,iGAAiG;AACjG,wBAAgB,sBAAsB,CAClC,EAAE,EAAE,eAAe,EACnB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,cAAc,GAAG,SAAS,EAClC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAC7B,gBAAgB,CAsBlB"}

package/dist/features/magic-context/session-decision-calibration.d.ts

@@ -0,0 +1,31 @@
+import { type DecisionCalibration } from "../../hooks/magic-context/decision-calibration";
+import type { Database } from "../../shared/sqlite";
+export declare const HYGIENE_PROVIDER_UNITS_VERSION = 2;
+export interface FrozenSessionDecisionCalibration {
+    revision: string;
+    providerId: string;
+    modelId: string;
+    systemRatio: number;
+    toolsRatio: number;
+    proseRatio: number;
+    source: DecisionCalibration["source"];
+}
+export interface SessionDecisionCalibrationPass {
+    bustPermitted: boolean;
+    modelKey?: string | null;
+    bustReason?: string;
+    onAdopt?: (message: string) => void;
+}
+/**
+ * Read the calibration frozen with the active session generation. A new table is
+ * adopted only when the caller already has permission to replace cached decisions.
+ */
+export declare function sessionDecisionCalibration(db: Database, sessionId: string, pass?: SessionDecisionCalibrationPass): DecisionCalibration;
+/** Return the durable hygiene unit version without changing session state. */
+export declare function sessionHygieneUnitsVersion(db: Database, sessionId: string): number;
+/**
+ * Convert persisted Channel-1 U watermarks exactly once when provider hygiene
+ * units first become active. Defer passes leave both the stamp and old arithmetic untouched.
+ */
+export declare function transitionSessionHygieneUnits(db: Database, sessionId: string, bustPermitted: boolean, calibration: DecisionCalibration): number;
+//# sourceMappingURL=session-decision-calibration.d.ts.map

package/dist/features/magic-context/session-decision-calibration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-decision-calibration.d.ts","sourceRoot":"","sources":["../../../src/features/magic-context/session-decision-calibration.ts"],"names":[],"mappings":"AAAA,OAAO,EAEH,KAAK,mBAAmB,EAE3B,MAAM,gDAAgD,CAAC;AAExD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAGpD,eAAO,MAAM,8BAA8B,IAAI,CAAC;AAEhD,MAAM,WAAW,gCAAgC;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,mBAAmB,CAAC,QAAQ,CAAC,CAAC;CACzC;AAcD,MAAM,WAAW,8BAA8B;IAC3C,aAAa,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACvC;AAgJD;;;GAGG;AACH,wBAAgB,0BAA0B,CACtC,EAAE,EAAE,QAAQ,EACZ,SAAS,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE,8BAA8B,GACtC,mBAAmB,CAsBrB;AAED,8EAA8E;AAC9E,wBAAgB,0BAA0B,CAAC,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAGlF;AAoBD;;;GAGG;AACH,wBAAgB,6BAA6B,CACzC,EAAE,EAAE,QAAQ,EACZ,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,OAAO,EACtB,WAAW,EAAE,mBAAmB,GACjC,MAAM,CAgCR"}

package/dist/features/magic-context/session-project-backfill.d.ts

@@ -0,0 +1,37 @@
+import type { Database } from "../../shared/sqlite";
+export interface SessionProjectBackfillSession {
+    sessionId: string;
+    directory: string;
+}
+export type SessionProjectBackfillSource = readonly SessionProjectBackfillSession[] | ((afterSessionId: string | null, limit: number) => readonly SessionProjectBackfillSession[] | Promise<readonly SessionProjectBackfillSession[]>);
+export interface BackfillResult {
+    status: "completed" | "already_completed" | "blocked_by_lease" | "lost_lease" | "retry_pending";
+    totalSessions: number;
+    alreadyMappedSessions: number;
+    unmappedSessions: number;
+    backfilledSessions: number;
+    skippedDeadDirectories: number;
+    skippedEmptyDirectories: number;
+    durationMs: number;
+}
+export interface SessionProjectBackfillStateRow {
+    harness: string;
+    status: "running" | "completed";
+    holder_id: string | null;
+    started_at: number | null;
+    lease_expires_at: number | null;
+    completed_at: number | null;
+}
+interface RunSessionProjectBackfillOptions {
+    resolveIdentity?: (directory: string) => string | undefined | Promise<string | undefined>;
+    now?: () => number;
+    yieldFn?: () => Promise<void>;
+    holderId?: string;
+    /** Separate a new one-time discovery pass from an older completed pass. */
+    leaseKey?: string;
+    allowHomeProject?: boolean;
+}
+export declare function runSessionProjectBackfill(db: Database, source: SessionProjectBackfillSource, options?: RunSessionProjectBackfillOptions): Promise<BackfillResult>;
+export declare function _getSessionProjectBackfillState(db: Database, harness?: import("../../shared/harness").HarnessId): SessionProjectBackfillStateRow | null;
+export {};
+//# sourceMappingURL=session-project-backfill.d.ts.map

package/dist/features/magic-context/session-project-backfill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-project-backfill.d.ts","sourceRoot":"","sources":["../../../src/features/magic-context/session-project-backfill.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAWpD,MAAM,WAAW,6BAA6B;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,4BAA4B,GAClC,SAAS,6BAA6B,EAAE,GACxC,CAAC,CACG,cAAc,EAAE,MAAM,GAAG,IAAI,EAC7B,KAAK,EAAE,MAAM,KAEX,SAAS,6BAA6B,EAAE,GACxC,OAAO,CAAC,SAAS,6BAA6B,EAAE,CAAC,CAAC,CAAC;AAE/D,MAAM,WAAW,cAAc;IAC3B,MAAM,EAAE,WAAW,GAAG,mBAAmB,GAAG,kBAAkB,GAAG,YAAY,GAAG,eAAe,CAAC;IAChG,aAAa,EAAE,MAAM,CAAC;IACtB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,gBAAgB,EAAE,MAAM,CAAC;IACzB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,uBAAuB,EAAE,MAAM,CAAC;IAChC,UAAU,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,8BAA8B;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,SAAS,GAAG,WAAW,CAAC;IAChC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,UAAU,gCAAgC;IACtC,eAAe,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;IAC1F,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC9B;AA4MD,wBAAsB,yBAAyB,CAC3C,EAAE,EAAE,QAAQ,EACZ,MAAM,EAAE,4BAA4B,EACpC,OAAO,GAAE,gCAAqC,GAC/C,OAAO,CAAC,cAAc,CAAC,CAkJzB;AAED,wBAAgB,+BAA+B,CAC3C,EAAE,EAAE,QAAQ,EACZ,OAAO,2CAAe,GACvB,8BAA8B,GAAG,IAAI,CAOvC"}

package/dist/features/magic-context/session-project-storage.d.ts

@@ -0,0 +1,23 @@
+import type { Database } from "../../shared/sqlite";
+/**
+ * Persist the immutable session→project binding resolved from the host session.
+ * Chunk backfills use this mapping as the project-scope authority: without it, a
+ * project-wide drain cannot safely distinguish same-process sessions from other
+ * projects and must not stamp arbitrary compartments with its own identity.
+ */
+export declare function recordSessionProjectIdentity(db: Database, sessionId: string, projectPath: string | undefined): void;
+/**
+ * Whether a project binding has been stored for this session. Bindings are
+ * stored only from a directory the host returned for the session, so a session
+ * without one has only ever been rendered with the launch-directory fallback.
+ */
+export declare function hasRecordedSessionProjectIdentity(db: Database, sessionId: string): boolean;
+/**
+ * Idempotent project-scoped heal for historical chunk rows whose stored project
+ * stamp disagrees with the recorded owner. The WHERE clause is scoped to rows
+ * that either currently sit under this project or truly belong to it, so normal
+ * registration/backfill paths can run it cheaply without scanning unrelated
+ * project partitions for every tick.
+ */
+export declare function repairMisScopedCompartmentChunkEmbeddingsForProject(db: Database, projectPath: string): number;
+//# sourceMappingURL=session-project-storage.d.ts.map

package/dist/features/magic-context/session-project-storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-project-storage.d.ts","sourceRoot":"","sources":["../../../src/features/magic-context/session-project-storage.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAkC,MAAM,qBAAqB,CAAC;AA0EpF;;;;;GAKG;AACH,wBAAgB,4BAA4B,CACxC,EAAE,EAAE,QAAQ,EACZ,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,GAAG,SAAS,GAChC,IAAI,CA0BN;AAED;;;;GAIG;AACH,wBAAgB,iCAAiC,CAAC,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAK1F;AAED;;;;;;GAMG;AACH,wBAAgB,mDAAmD,CAC/D,EAAE,EAAE,QAAQ,EACZ,WAAW,EAAE,MAAM,GACpB,MAAM,CAGR"}

package/dist/features/magic-context/storage-caveman-rules.d.ts

@@ -0,0 +1,21 @@
+import type { Database } from "../../shared/sqlite";
+export interface CavemanReplayState {
+    currentRules: boolean;
+    englishWordRules: boolean;
+    legacyReasoningTags: ReadonlySet<number>;
+}
+/**
+ * The session's caveman replay state. A document that cannot be read answers
+ * with the original rules, which is what the session served before it recorded
+ * anything.
+ */
+export declare function getCavemanReplayState(db: Database, sessionId: string): CavemanReplayState;
+/**
+ * Record that the session's compressed text now uses the current rules with
+ * the given word rules. `legacyReasoningTags` is written only by the switch
+ * from the original rules; a session already on the current rules keeps the
+ * list it recorded then. Returns the persisted state, or null when the
+ * document could not be written; the caller must then keep the state it read.
+ */
+export declare function recordCavemanCurrentRules(db: Database, sessionId: string, englishWordRules: boolean, legacyReasoningTags: Iterable<number>): CavemanReplayState | null;
+//# sourceMappingURL=storage-caveman-rules.d.ts.map

package/dist/features/magic-context/storage-caveman-rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-caveman-rules.d.ts","sourceRoot":"","sources":["../../../src/features/magic-context/storage-caveman-rules.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAkCpD,MAAM,WAAW,kBAAkB;IAC/B,YAAY,EAAE,OAAO,CAAC;IACtB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,mBAAmB,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAC5C;AAoBD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,GAAG,kBAAkB,CAOzF;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CACrC,EAAE,EAAE,QAAQ,EACZ,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,OAAO,EACzB,mBAAmB,EAAE,QAAQ,CAAC,MAAM,CAAC,GACtC,kBAAkB,GAAG,IAAI,CAkB3B"}

package/dist/features/magic-context/storage-clone.d.ts

@@ -0,0 +1,44 @@
+import type { Database } from "../../shared/sqlite";
+export interface CloneCompartmentRow {
+    sequence: number;
+    startMessage: number;
+    endMessage: number;
+    startMessageId: string;
+    endMessageId: string;
+}
+export interface CloneTagRow {
+    messageId: string;
+    type: string;
+    tagNumber: number;
+    toolOwnerMessageId: string | null;
+}
+export interface CloneSessionStateFilter {
+    resolveBoundaryOrdinal(messageId: string): number | undefined;
+    includeTag(tag: CloneTagRow): boolean;
+    includeMessageId(messageId: string): boolean;
+    /** Map a source message/content id into the destination session. */
+    mapMessageId?: (messageId: string) => string;
+    /** Opt into remapping globally keyed tag ids; leave undefined for Pi compatibility. */
+    mapTagId?: (sourceTagId: number, destinationTagId: number) => number;
+    /** Pi forks inherit session notes/facts in the same atomic prefix copy. */
+    copySessionNotesAndFacts?: boolean;
+    /** Return the destination ordinal for an inherited source anchor. */
+    mapOrdinal?: (sourceOrdinal: number) => number | undefined;
+    selectPendingPiMarker(rawState: string | null, copiedCompartments: readonly CloneCompartmentRow[]): string | null;
+}
+export interface CopySessionStateForCloneResult {
+    kind: "migrated" | "destination-not-empty";
+    compartmentsCopied: number;
+    tagsCopied: number;
+    pendingOpsCopied: number;
+    notesCopied: number;
+    factsCopied: number;
+    pendingMarkerMigrated: boolean;
+}
+/**
+ * Copy durable session content into a clone under one immediate transaction.
+ * The destination guard runs after the write lock is acquired so two plugin
+ * processes cannot both observe an empty clone and duplicate its state.
+ */
+export declare function copySessionStateForClone(db: Database, sourceSessionId: string, destinationSessionId: string, filter: CloneSessionStateFilter): CopySessionStateForCloneResult;
+//# sourceMappingURL=storage-clone.d.ts.map

package/dist/features/magic-context/storage-clone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-clone.d.ts","sourceRoot":"","sources":["../../../src/features/magic-context/storage-clone.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAmBpD,MAAM,WAAW,mBAAmB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;CACrC;AAED,MAAM,WAAW,uBAAuB;IACpC,sBAAsB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAC9D,UAAU,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC;IACtC,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;IAC7C,oEAAoE;IACpE,YAAY,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC;IAC7C,uFAAuF;IACvF,QAAQ,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,KAAK,MAAM,CAAC;IACrE,2EAA2E;IAC3E,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC,qEAAqE;IACrE,UAAU,CAAC,EAAE,CAAC,aAAa,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IAC3D,qBAAqB,CACjB,QAAQ,EAAE,MAAM,GAAG,IAAI,EACvB,kBAAkB,EAAE,SAAS,mBAAmB,EAAE,GACnD,MAAM,GAAG,IAAI,CAAC;CACpB;AAED,MAAM,WAAW,8BAA8B;IAC3C,IAAI,EAAE,UAAU,GAAG,uBAAuB,CAAC;IAC3C,kBAAkB,EAAE,MAAM,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,qBAAqB,EAAE,OAAO,CAAC;CAClC;AA0YD;;;;GAIG;AACH,wBAAgB,wBAAwB,CACpC,EAAE,EAAE,QAAQ,EACZ,eAAe,EAAE,MAAM,EACvB,oBAAoB,EAAE,MAAM,EAC5B,MAAM,EAAE,uBAAuB,GAChC,8BAA8B,CAqShC"}

package/dist/features/magic-context/storage-db.d.ts

@@ -0,0 +1,183 @@
+import { type Dirent } from "node:fs";
+import { type AsyncProcessInspection, type PidLiveness } from "../../shared/rpc-utils";
+import { Database } from "../../shared/sqlite";
+import { type FailClosedBlockingProcess } from "./fail-closed-block";
+import { FORK_MIGRATION_VERSION_FLOOR } from "./migrations";
+import { ensureColumn, healAllNullColumns } from "./storage-schema-helpers";
+export { ensureColumn, FORK_MIGRATION_VERSION_FLOOR, healAllNullColumns };
+export interface MigrationOnOpenRefusal {
+    persistedVersion: number;
+    supportedVersion: number;
+    serverPids: number[];
+    /** Process kinds may be omitted when older test fixtures provide only serverPids. */
+    blockingProcesses?: FailClosedBlockingProcess[];
+    unreadableFile?: string;
+    unreadableArm?: "parse" | "io";
+}
+export declare function getSchemaFenceRejection(): {
+    persistedVersion: number;
+    supportedVersion: number;
+} | null;
+export declare function getMigrationOnOpenRefusal(): MigrationOnOpenRefusal | null;
+/** Test seam for isolated schema-fence and migration-guard scenarios. */
+export declare function __resetSchemaFenceStateForTests(): void;
+export declare const LATEST_SUPPORTED_VERSION = 2;
+/**
+ * Every runtime backend receives the same finite wait before the first schema
+ * read. Five seconds preserves the established contention tolerance while
+ * remaining well inside the server-wide 15 second boot budget.
+ */
+export declare const BOOT_SQLITE_BUSY_TIMEOUT_MS = 5000;
+export interface DatabaseBootTimings {
+    openMs: number;
+    guardMs: number;
+    migrateMs: number;
+}
+export interface OpenDatabaseOptions {
+    dbPath?: string;
+    latestSupportedVersion?: number;
+    /** Test/diagnostic override; production uses BOOT_SQLITE_BUSY_TIMEOUT_MS. */
+    busyTimeoutMs?: number;
+    /** Boot-only timing sink; omitted by ordinary storage callers. */
+    onBootTimings?: (timings: DatabaseBootTimings) => void;
+    /** Receives the exact busy-timeout diagnostic emitted during a fresh database open. */
+    onBootBusyTimeout?: (message: string) => void;
+}
+export declare function resolveDatabasePath(dbPathOverride?: string): {
+    dbDir: string;
+    dbPath: string;
+};
+export declare function getDatabasePath(db: Database): string | null;
+export declare function getPersistedSchemaVersion(db: Database): number;
+export declare function schemaVersionIsSupported(db: Database, latestSupportedVersion?: number): boolean;
+/** Log the upstream-lane version so operators can compare it to this build's fence. */
+export declare function formatSchemaFenceBootLog(persistedVersion: number, supportedVersion: number): string;
+export declare function enforceSchemaFence(db: Database, dbPath: string, latestSupportedVersion: number): boolean;
+export type RpcDiscoveryUnreadableArm = "parse" | "io";
+export interface RpcServerDiscovery {
+    state: "absent" | "stale" | "live" | "unreadable" | "inconclusive";
+    serverPids: number[];
+    /** Per-PID labels captured while the discovery record was validated. */
+    serverProcesses?: FailClosedBlockingProcess[];
+    staleFiles: string[];
+    /**
+     * PIDs for which the process-existence or process-identity check could not
+     * run. That failure does not prove that the process is actively using RPC.
+     */
+    inconclusivePids?: number[];
+    /** The records behind `inconclusivePids`, with the process evidence that was read. */
+    inconclusiveRecords?: RpcDiscoveryRecordEvidence[];
+    unreadableFile?: string;
+    unreadableArm?: RpcDiscoveryUnreadableArm;
+}
+/**
+ * A discovery record that was kept because nothing proved it stale, with what
+ * was read about the process now using its PID. Doctor shows this so a user
+ * can decide whether to remove the record.
+ */
+export interface RpcDiscoveryRecordEvidence {
+    file: string;
+    pid: number;
+    /** The record's `started_at` (epoch ms), or null when the record has none. */
+    recordedStartedAt: number | null;
+    /** When the process now using the PID started (epoch ms), or null when unreadable. */
+    processStartTime: number | null;
+    imageName: string | null;
+    commandLine: string | null;
+    liveness: PidLiveness;
+}
+export interface RpcDiscoveryFs {
+    readdirSync(path: string, options?: {
+        withFileTypes?: boolean;
+    }): string[] | Dirent[];
+    readFileSync(path: string, encoding: "utf8"): string;
+    statSync(path: string): {
+        mtimeMs: number;
+    };
+    unlinkSync(path: string): void;
+}
+/** Allows tests to simulate discovery filesystem errors and verify they reject the result rather than treating it as a valid server record. */
+export declare function __setRpcDiscoveryFsForTests(overrides: Partial<RpcDiscoveryFs>): void;
+export declare function __resetRpcDiscoveryFsForTests(): void;
+/**
+ * Inspect the shared RPC discovery tree without treating partial evidence as
+ * proof that no server is running. A missing/empty tree is a clean machine;
+ * dead-PID and old malformed files are removed; fresh malformed or unreadable
+ * evidence is fail-closed because it could be a concurrent write or an I/O
+ * permission problem.
+ */
+export declare function inspectRpcServerDiscovery(storageDir: string, processes?: AsyncProcessInspection): RpcServerDiscovery;
+/** Return the live processes that would block an on-open migration. */
+export declare function getLiveMigrationBlockingProcesses(storageDir: string): FailClosedBlockingProcess[];
+/**
+ * Refuse an on-open migration while another long-lived harness may still run an
+ * older build. OpenCode servers keep their plugin loaded, and a live Pi process
+ * can spawn a child with its loaded extension after another process migrates.
+ */
+export declare function formatInconclusiveOpenCodeMigrationWarning(dbPath: string, pids: readonly number[]): string;
+export declare function formatInconclusivePiMigrationWarning(dbPath: string, pids: readonly number[]): string;
+export declare function formatLiveProcessMigrationRefusal(dbPath: string, persistedVersion: number, latestSupportedVersion: number, serverPids: readonly number[], piPids: readonly number[]): string;
+export declare function setSqlitePragmaConfig(config: {
+    cacheSizeMb: number;
+    mmapSizeMb: number;
+}): void;
+/**
+ * Apply the tunable per-connection PRAGMAs (cache_size, mmap_size,
+ * analysis_limit) from the current `sqlitePragmaConfig`. Idempotent and safe on
+ * an already-open connection — cache_size/mmap_size take effect immediately —
+ * so harnesses that open the DB before loading config (Pi) can call this once
+ * config is available without reopening.
+ */
+export declare function applySqliteTuningPragmas(db: Database): void;
+/**
+ * Run SQLite's self-gating planner-stats refresh. `analysis_limit=400` caps the
+ * rows sampled per index so even a huge table can't cause a multi-second
+ * ANALYZE; `optimize` then re-analyzes only tables whose row counts drifted
+ * since the last ANALYZE (a no-op otherwise). Cheap to call periodically.
+ */
+export declare function runSqliteOptimize(db: Database): void;
+export declare function initializeDatabase(db: Database, busyTimeoutMs?: number): void;
+/**
+ * Open the persistent Magic Context SQLite database.
+ *
+ * Fails closed: if the database cannot be opened (binary ABI mismatch,
+ * unwritable path, corrupted file, etc.), this throws. Magic Context CANNOT
+ * silently fall back to an in-memory database, because:
+ *   1. An in-memory DB has no project memories, no historian state, no
+ *      tag persistence — features that depend on durable storage become
+ *      silently broken instead of explicitly disabled.
+ *   2. More importantly, an in-memory DB across process restarts effectively
+ *      means "no Magic Context", but the plugin still tags messages and
+ *      tries to drive transforms. On Pi/OpenCode this can let the full
+ *      raw history reach the model and overflow the context window — the
+ *      exact failure mode that broke a real test session.
+ *
+ * Two failure modes, both fail-closed:
+ *   - **Schema fence** (the on-disk DB is newer than this binary supports, e.g.
+ *     a stale process after a rolling upgrade): returns `null`. This is an
+ *     expected, recoverable condition (restart onto the newer binary), so it is
+ *     not exceptional.
+ *   - **Fatal open error** (ABI mismatch, unwritable path, corrupt file):
+ *     throws. The thrown message carries the failure detail for surfacing.
+ *
+ * The return type is therefore `Database | null`, and callers MUST both
+ * null-check the result AND be prepared for a throw (typically a try/catch that
+ * also treats a null result as "storage unavailable"). On either outcome the
+ * caller disables Magic Context for that run (server plugin: registers a
+ * startup warning + skips the runtime; Pi plugin: logs warning + skips the
+ * extension). There is NEVER a silent in-memory fallback.
+ */
+export declare function openDatabase(): Database | null;
+export declare function openDatabase(dbPath: string): Database | null;
+export declare function openDatabase(options: OpenDatabaseOptions): Database | null;
+/**
+ * Async boot variant of openDatabase. SQLite calls remain synchronous, but the
+ * bounded migration-lock waits yield to the host between attempts so a busy
+ * sibling cannot freeze plugin startup for the whole retry budget.
+ */
+export declare function openDatabaseAsync(dbPathOrOptions?: string | OpenDatabaseOptions): Promise<Database | null>;
+export declare function isDatabasePersisted(db: Database | null): boolean;
+export declare function getDatabasePersistenceError(db: Database | null): string | null;
+export declare function closeDatabase(): void;
+export type ContextDatabase = Database;
+//# sourceMappingURL=storage-db.d.ts.map

package/dist/features/magic-context/storage-db.d.ts.map

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

package/dist/features/magic-context/storage-historian-runs.d.ts

@@ -0,0 +1,79 @@
+import type { Database } from "../../shared/sqlite";
+/**
+ * Per historian-invocation telemetry.
+ *
+ * One row per attempted historian run (incremental publish or recomp pass),
+ * recording the INPUT (chunk range) and OUTPUT shape
+ * (compartments / facts / events / importance) plus success/failure. Tokens and
+ * the model used live on the FK-linked `subagent_invocations` row
+ * (`subagentInvocationId`) — join to get cost/model.
+ *
+ * Purpose: debugging (which range produced what), quality analysis (facts per
+ * output token, importance distribution by model), and the productization /
+ * training-data roadmap.
+ */
+export type HistorianRunStatus = 
+/** Compartments were validated + published. */
+"success"
+/** A real failure (validation / coverage / no-progress / exception). */
+ | "failed"
+/** A successful no-op (nothing eligible to compact, empty chunk). */
+ | "noop";
+/** "upgrade" is only read, never written: rows from the removed session-upgrade
+ *  command are still in existing databases. */
+export type HistorianRunKind = "incremental" | "recomp" | "partial-recomp" | "upgrade";
+export interface HistorianRunInput {
+    sessionId: string;
+    harness: string;
+    /** FK to subagent_invocations.id (tokens/model/timing). NULL if no invocation. */
+    subagentInvocationId?: number | null;
+    runKind: HistorianRunKind;
+    status: HistorianRunStatus;
+    /** Failure reason for `failed` (and optionally a no-op explanation). */
+    failureReason?: string | null;
+    /** Raw-ordinal range of the input chunk. */
+    chunkStartOrdinal?: number | null;
+    chunkEndOrdinal?: number | null;
+    /** Historian's reported next-start (its `<unprocessed_from>`). */
+    unprocessedFrom?: number | null;
+    /** Compartments actually persisted (post discard-last). */
+    compartmentsProduced?: number;
+    /** Durable id range of the persisted compartments. */
+    compartmentIdMin?: number | null;
+    compartmentIdMax?: number | null;
+    /** Facts emitted in the `<facts>` block. */
+    factsEmitted?: number;
+    /** `{ [category]: count }` of emitted facts. */
+    factsByCategory?: Record<string, number> | null;
+    /** Valid emitted facts persisted as new memories or re-observations. */
+    factsPromoted?: number;
+    /** Events emitted (causal_incident / trajectory_correction). */
+    eventsEmitted?: number;
+    /** Events successfully inserted into compartment_events. */
+    eventsPublished?: number;
+    /** Importance distribution across persisted compartments. */
+    importanceMin?: number | null;
+    importanceMax?: number | null;
+    importanceAvg?: number | null;
+    /** Whether the lookahead-free last compartment was discarded (boundary healing). */
+    discardedLast?: boolean;
+    /** Whether the run produced/processed legacy (pre-v2) compartments. */
+    legacy?: boolean;
+}
+/**
+ * Record one historian run. Best-effort: never throws into the historian path —
+ * telemetry must not break compaction. Returns the new row id, or null on
+ * failure.
+ */
+export declare function recordHistorianRun(db: Database, input: HistorianRunInput): number | null;
+/** Summarize a list of importance values into min/max/avg (null on empty). */
+export declare function summarizeImportance(values: readonly number[]): {
+    min: number | null;
+    max: number | null;
+    avg: number | null;
+};
+/** Tally facts by their category for `factsByCategory`. */
+export declare function tallyFactsByCategory(facts: ReadonlyArray<{
+    category?: string | null;
+}>): Record<string, number>;
+//# sourceMappingURL=storage-historian-runs.d.ts.map

package/dist/features/magic-context/storage-historian-runs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-historian-runs.d.ts","sourceRoot":"","sources":["../../../src/features/magic-context/storage-historian-runs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpD;;;;;;;;;;;;GAYG;AAEH,MAAM,MAAM,kBAAkB;AAC1B,+CAA+C;AAC7C,SAAS;AACX,wEAAwE;GACtE,QAAQ;AACV,qEAAqE;GACnE,MAAM,CAAC;AAEb;+CAC+C;AAC/C,MAAM,MAAM,gBAAgB,GAAG,aAAa,GAAG,QAAQ,GAAG,gBAAgB,GAAG,SAAS,CAAC;AAEvF,MAAM,WAAW,iBAAiB;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,kFAAkF;IAClF,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,OAAO,EAAE,gBAAgB,CAAC;IAC1B,MAAM,EAAE,kBAAkB,CAAC;IAC3B,wEAAwE;IACxE,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,4CAA4C;IAC5C,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,kEAAkE;IAClE,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,2DAA2D;IAC3D,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,sDAAsD;IACtD,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,4CAA4C;IAC5C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gDAAgD;IAChD,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;IAChD,wEAAwE;IACxE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gEAAgE;IAChE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,4DAA4D;IAC5D,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,6DAA6D;IAC7D,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,oFAAoF;IACpF,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,uEAAuE;IACvE,MAAM,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,iBAAiB,GAAG,MAAM,GAAG,IAAI,CA4CxF;AAED,8EAA8E;AAC9E,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG;IAC5D,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB,CAYA;AAED,2DAA2D;AAC3D,wBAAgB,oBAAoB,CAChC,KAAK,EAAE,aAAa,CAAC;IAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,GACnD,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAOxB"}

package/dist/features/magic-context/storage-identity-merge.d.ts

@@ -0,0 +1,26 @@
+import type { Database } from "../../shared/sqlite";
+export interface IdentityMergeTableReport {
+    tableName: string;
+    identityColumn: string;
+    derived: boolean;
+    sourceRows: number;
+    changedRows: number;
+}
+export interface IdentityMergeReport {
+    fromIdentity: string;
+    toIdentity: string;
+    auditedTables: IdentityMergeTableReport[];
+    changedRows: number;
+    dryRun: boolean;
+}
+/**
+ * Rows an identity owns in every non-derived table keyed by project identity: the rows a
+ * merge from this identity would move.
+ */
+export declare function countIdentityRows(db: Database, identity: string): number;
+export declare function auditIdentityMerge(db: Database, fromIdentity: string, toIdentity: string): IdentityMergeReport;
+export declare function mergeProjectIdentities(db: Database, fromIdentity: string, toIdentity: string, options?: {
+    dryRun?: boolean;
+    now?: number;
+}): IdentityMergeReport;
+//# sourceMappingURL=storage-identity-merge.d.ts.map

package/dist/features/magic-context/storage-identity-merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage-identity-merge.d.ts","sourceRoot":"","sources":["../../../src/features/magic-context/storage-identity-merge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAiBpD,MAAM,WAAW,wBAAwB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,wBAAwB,EAAE,CAAC;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,OAAO,CAAC;CACnB;AA4WD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAYxE;AAsBD,wBAAgB,kBAAkB,CAC9B,EAAE,EAAE,QAAQ,EACZ,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,GACnB,mBAAmB,CAerB;AAED,wBAAgB,sBAAsB,CAClC,EAAE,EAAE,QAAQ,EACZ,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAO,GACjD,mBAAmB,CA6DrB"}