@retaw106/mmc-oc 0.0.0-stage → 1.2.2

package/dist/v2/store-reader.d.ts

@@ -0,0 +1,218 @@
+import type { Statement } from "better-sqlite3";
+import type { RawMessageOrdinalAnchor } from "../hooks/magic-context/read-session-raw";
+import { Database } from "../shared/sqlite";
+/** Compatibility export; shared/opencode-db-path.ts is the single filename authority. */
+export declare function sourceDatabaseFilename(channel: string, env?: NodeJS.ProcessEnv): string;
+/** GA data root resolved by the shared host-generation-aware resolver. */
+export declare function gaDatabasePath(dataHome: string, channel?: string, env?: NodeJS.ProcessEnv): string;
+export type MessageType = "agent-switched" | "model-switched" | "location-switched" | "user" | "synthetic" | "system" | "skill" | "shell" | "assistant" | "compaction" | "idle";
+export declare const RAW_MESSAGE_TYPES: readonly ["user", "synthetic", "assistant", "skill", "shell", "system"];
+export declare const V2_MESSAGE_PAGE_SQL: string;
+export interface MessageData {
+    [key: string]: unknown;
+    content?: Array<Record<string, unknown>>;
+    text?: string;
+    finish?: string;
+    outcome?: "succeeded" | "failed" | "interrupted";
+    error?: unknown;
+    model?: {
+        id: string;
+        providerID: string;
+        variant?: string;
+    };
+    tokens?: {
+        input: number;
+        output: number;
+        reasoning: number;
+        cache: {
+            read: number;
+            write: number;
+        };
+    };
+    time?: {
+        created: number;
+        completed?: number;
+        streamed?: number;
+    };
+}
+export interface IdleData extends MessageData {
+    outcome: "succeeded" | "failed" | "interrupted";
+}
+export interface CompactionData extends MessageData {
+    status: string;
+    summary?: string;
+    recent?: string;
+}
+export interface StoreRow<T extends MessageType = MessageType> {
+    id: string;
+    session_id: string;
+    type: T;
+    seq: number;
+    time_created?: number;
+    data: T extends "idle" ? IdleData : T extends "compaction" ? CompactionData : MessageData;
+}
+export declare const V2_STORE_READER_DEBUG_COUNTER_KEY = "magic-context.v2.store-reader-debug";
+export interface V2StoreReaderDebugOperation {
+    calls: number;
+    decodedRows: number;
+    maxDecodedRows: number;
+}
+export interface V2StoreReaderDebugQuery {
+    operation: string;
+    statement: string;
+    rows: number;
+    elapsedMs: number;
+}
+export interface V2StoreReaderDebugCounters {
+    decodedRows: number;
+    operations: Record<string, V2StoreReaderDebugOperation>;
+    openReaders: number;
+    maxOpenReaders: number;
+    readersOpened: number;
+    readersClosed: number;
+    queries?: V2StoreReaderDebugQuery[];
+    captureQueries?: boolean;
+}
+export interface V2MessageOrdinalAnchor {
+    timeCreated: number;
+    id: string;
+}
+export interface V2MessageOrdinalEntry extends V2MessageOrdinalAnchor {
+    contributesOrdinal: boolean;
+    hasValidInfo: boolean;
+}
+/** Where an OpenCode 2 fork was cut from its parent (`session_v2.fork_boundary`). */
+export interface V2ForkOrigin {
+    parentSessionID: string;
+    /** `before`: rows strictly before the message were copied; `through`: up to and including it. */
+    boundary: {
+        type: "before" | "through";
+        messageID: string;
+    };
+}
+/** The identity columns of one `session_message` row. */
+export interface V2RowStamp {
+    id: string;
+    type: MessageType;
+    seq: number;
+    time_created: number;
+}
+export declare function getV2StoreReaderDebugCounters(): V2StoreReaderDebugCounters;
+export declare function resetV2StoreReaderDebugCounters(options?: {
+    captureQueries?: boolean;
+}): void;
+interface ReaderConnection {
+    db: Database;
+    statements: Map<string, Statement>;
+    identity: string;
+    leases: number;
+    retired: boolean;
+}
+/** Boot-scoped read-only handles. Each lease still closes in the caller's finally block.
+ * Statements, not results, are cached: WAL updates are visible on the next query.
+ * A replaced/missing file cannot reuse the old inode, and disposal releases all handles. */
+export declare class V2StoreReaderPool {
+    private readonly capacity;
+    private readonly connections;
+    private closed;
+    constructor(capacity?: number);
+    open(path: string): V2StoreReader;
+    acquire(path: string): ReaderConnection;
+    release(connection: ReaderConnection): void;
+    private retire;
+    close(): void;
+}
+/** Opens an existing store read-only; missing/corrupt stores propagate errors, never an empty history. */
+export declare class V2StoreReader {
+    private readonly pool?;
+    private readonly db;
+    private readonly connection;
+    private closed;
+    constructor(path: string, pool?: V2StoreReaderPool | undefined);
+    private prepare;
+    close(): void;
+    /** Exclusive cursor, ascending seq. IDs are not chronological in the v2 store. */
+    page(sessionID: string, options?: {
+        after?: number;
+        through?: number;
+        limit?: number;
+        type?: MessageType;
+    }): {
+        rows: StoreRow[];
+        cursor: number | undefined;
+    };
+    /**
+     * Read one page from the contiguous raw-message ordinal space. OpenCode seq
+     * includes non-conversation rows, so the CTE maps the two ordinal boundaries
+     * to seq values without hydrating any row outside the requested page.
+     */
+    messagePage(sessionID: string, afterOrdinal: number, limit: number, finalWatermark: number, after?: RawMessageOrdinalAnchor): StoreRow[];
+    messageCount(sessionID: string): number;
+    /**
+     * One page of host sessions with the directory each was created in, in
+     * ascending id order after `afterSessionID` (exclusive; null starts at the
+     * beginning). Feeds the session-to-project backfill.
+     */
+    sessionDirectoryPage(afterSessionID: string | null, limit: number): Array<{
+        sessionId: string;
+        directory: string;
+    }>;
+    latestMessageTime(sessionID: string): number | undefined;
+    /** Parent links are recorded by the host before a child's first context pass. */
+    isSubagent(sessionID: string): boolean | null;
+    storedMessageCount(sessionID: string): number;
+    messageById(sessionID: string, id: string): StoreRow | null;
+    messageExistsById(sessionID: string, id: string): boolean;
+    messageOrdinalById(sessionID: string, id: string): number | null;
+    messageIdOrdinals(sessionID: string, fromOrdinal: number, toOrdinal: number): Map<string, number>;
+    messageOrdinalPage(sessionID: string, after: V2MessageOrdinalAnchor | null, limit: number): V2MessageOrdinalEntry[];
+    range(sessionID: string, after: number, through: number): StoreRow[];
+    /**
+     * One stamp per row with `after < seq <= through`, keyed by seq, built without
+     * decoding any row: the row id, its update time and the byte length of its data.
+     * A row deleted, added, or rewritten in place to a different size or with a new
+     * update time changes its stamp; comparing stamps row by row, not an aggregate,
+     * means two such changes cannot cancel out.
+     */
+    spanRowStamps(sessionID: string, after: number, through: number): Map<number, string>;
+    /** Conversational rows at or before `throughSeq`, newest first. */
+    rawRowsThrough(sessionID: string, throughSeq: number, limit: number): StoreRow[];
+    sequenceForId(sessionID: string, id: string | null | undefined): number | undefined;
+    /** Native synthetics are user-shaped on the wire; their store kind is unambiguous. */
+    syntheticMessageIDs(sessionID: string): Set<string>;
+    /**
+     * The session this one was forked from and where the fork was cut, as the
+     * host recorded them (`session_v2.fork_session_id` and `fork_boundary`).
+     * Null for a session that is not a fork, a store without the columns, or a
+     * boundary that does not parse.
+     */
+    forkOrigin(sessionID: string): V2ForkOrigin | null;
+    /** Whether the host still has a session row for this id. */
+    sessionExists(sessionID: string): boolean;
+    /**
+     * Identity columns of every row of a session up to and including `throughSeq`,
+     * in seq order, without decoding any message body.
+     */
+    rowStampsThrough(sessionID: string, throughSeq: number): V2RowStamp[];
+    latestSequenceForIds(sessionID: string, ids: readonly string[]): number;
+    private compactionByStatus;
+    latestCompaction(sessionID: string): StoreRow<"compaction"> | undefined;
+    latestRunningCompaction(sessionID: string): StoreRow<"compaction"> | undefined;
+    idleRows(sessionID: string, after?: number): StoreRow<"idle">[];
+    earliestSequence(sessionID: string): number | undefined;
+    latestSequence(sessionID: string): number;
+    assistantSince(sessionID: string, afterSeq: number): StoreRow<"assistant">[];
+    latestAssistant(sessionID: string): StoreRow<"assistant"> | undefined;
+    latestIdle(sessionID: string): StoreRow<"idle"> | undefined;
+    /** Include the completed checkpoint itself, matching the host history cut. */
+    window(sessionID: string): StoreRow[];
+    /**
+     * Read every retained row only for conversions between store generations and
+     * explicit diagnostics, because those operations need every part payload.
+     * Context passes use messagePage, messageCount, and range instead.
+     */
+    history(sessionID: string): StoreRow[];
+    private all;
+}
+export {};
+//# sourceMappingURL=store-reader.d.ts.map

package/dist/v2/store-reader.d.ts.map

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

package/dist/web/api.d.ts

@@ -0,0 +1,40 @@
+/**
+ * JSON API handlers for the web panel (plan 11 P2a).
+ *
+ * Pure request→response functions: parse + validate inputs, open the P1 data
+ * layer fresh per request (D5 manual-refresh semantics — no caching layer),
+ * and return typed results. The HTTP layer (server.ts) maps these to wire
+ * responses; error classes from views.ts map to status codes.
+ */
+import type { WebSourceStatus } from "./types";
+import { type PanelSources } from "./views";
+export interface ApiResult {
+    status: number;
+    body: unknown;
+}
+export interface ApiRequest {
+    projectPath: string;
+    sessionId?: string;
+    memoryId?: number;
+    query: URLSearchParams;
+    now: number;
+}
+export type ApiHandler = (request: ApiRequest) => ApiResult;
+export declare function sourceStatuses(sources: PanelSources): {
+    context: WebSourceStatus;
+    oc2: WebSourceStatus;
+    pi: WebSourceStatus;
+};
+export declare function projectsHandler(sources: PanelSources): ApiHandler;
+export declare function sessionsHandler(sources: PanelSources): ApiHandler;
+export declare function messagesHandler(sources: PanelSources): ApiHandler;
+export declare function compartmentsHandler(sources: PanelSources): ApiHandler;
+export declare function notesHandler(sources: PanelSources): ApiHandler;
+export declare function memoriesHandler(sources: PanelSources): ApiHandler;
+export declare function memoryDetailHandler(sources: PanelSources): ApiHandler;
+export declare function piBranchesHandler(sources: PanelSources): ApiHandler;
+export declare function optionalQuery(query: URLSearchParams, name: string): string | undefined;
+export declare function optionalInt(query: URLSearchParams, name: string): number | undefined;
+export declare function badRequest(message: string): ApiResult;
+export { BadRequestError, ContextStoreUnavailableError, NotFoundError, SourceUnavailableError, } from "./views";
+//# sourceMappingURL=api.d.ts.map

package/dist/web/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/web/api.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAcH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,EAYH,KAAK,YAAY,EAEpB,MAAM,SAAS,CAAC;AAEjB,MAAM,WAAW,SAAS;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,eAAe,CAAC;IACvB,GAAG,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,EAAE,UAAU,KAAK,SAAS,CAAC;AAS5D,wBAAgB,cAAc,CAAC,OAAO,EAAE,YAAY,GAAG;IACnD,OAAO,EAAE,eAAe,CAAC;IACzB,GAAG,EAAE,eAAe,CAAC;IACrB,EAAE,EAAE,eAAe,CAAC;CACvB,CAUA;AAKD,wBAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,UAAU,CAmBjE;AAUD,wBAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,UAAU,CAKjE;AAKD,wBAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,UAAU,CAgBjE;AAKD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,YAAY,GAAG,UAAU,CAarE;AAKD,wBAAgB,YAAY,CAAC,OAAO,EAAE,YAAY,GAAG,UAAU,CAM9D;AAKD,wBAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,GAAG,UAAU,CA2CjE;AAKD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,YAAY,GAAG,UAAU,CA8CrE;AAKD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,YAAY,GAAG,UAAU,CAqBnE;AAUD,wBAAgB,aAAa,CAAC,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGtF;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAQpF;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAErD;AAED,OAAO,EACH,eAAe,EACf,4BAA4B,EAC5B,aAAa,EACb,sBAAsB,GACzB,MAAM,SAAS,CAAC"}

package/dist/web/context-store.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Read-only adapter for the mmc shared store (context.db).
+ *
+ * P1 is read-only end to end: the store is opened with SQLite readonly flags
+ * and NEVER through `openDatabase()` — no schema creation, no migrations, no
+ * WAL pragma writes. The persisted schema version is probed first (D28): a
+ * fence newer than this build's `LATEST_SUPPORTED_VERSION` disables every
+ * field read; the caller gets only the status.
+ *
+ * Project enumeration groups by the exact `project_path` identity string as
+ * stored (D7) — no path merging, normalization, or aliasing. Projects that
+ * hold only memories (no session rows) are listed like any other. The pool
+ * size metric reuses `countMaintenancePool` (active+permanent, no expiry
+ * filter) per the plan's #137 ruling — never `getMemoryCount`.
+ */
+import { Database } from "../shared/sqlite";
+import { type WebBoundaryLink, type WebSourceStatus } from "./types";
+export interface WebContextStore {
+    readonly db: Database;
+    readonly path: string;
+    readonly persistedSchemaVersion: number;
+}
+export type OpenContextStoreResult = {
+    status: WebSourceStatus;
+    store: WebContextStore;
+} | {
+    status: WebSourceStatus;
+    store: undefined;
+};
+/** Open context.db strictly read-only; probe the schema fence before any read. */
+export declare function openContextStoreReadonly(dbPath: string): OpenContextStoreResult;
+export interface WebProjectSummary {
+    /** Exact project identity string as stored (D7) — `git:<hash>` / `dir:<hash>` forms. */
+    projectPath: string;
+    /** Unarchived pool size: `countMaintenancePool` semantics (#137). */
+    poolSize: number;
+    /** Newest activity timestamp (epoch ms) across sessions/memories/notes, null when none. */
+    lastActivityAt: number | null;
+    sessionCount: number;
+    /** True when the project has memories but no session rows. */
+    memoryOnly: boolean;
+}
+/**
+ * Enumerate projects by exact-string grouping over every project-bearing
+ * table. A row-less project (nothing at all) naturally does not appear; a
+ * memory-only project does.
+ */
+export declare function listWebProjects(store: WebContextStore): WebProjectSummary[];
+export interface WebSessionRef {
+    sessionId: string;
+    harness: string;
+    lastActivityAt: number | null;
+    compartmentCount: number;
+}
+/** Sessions registered for one exact project identity, newest activity first. */
+export declare function listProjectSessions(store: WebContextStore, projectPath: string): WebSessionRef[];
+export interface WebCompartment {
+    id: number;
+    sessionId: string;
+    harness: string;
+    sequence: number;
+    title: string;
+    importance: number;
+    createdAt: number;
+    startMessage: number;
+    endMessage: number;
+    startMessageId: string;
+    endMessageId: string;
+    startLink: WebBoundaryLink;
+    endLink: WebBoundaryLink;
+}
+/** Compartments of one session in sequence order; empty boundary ids surface as `unlinked` (D14). */
+export declare function listSessionCompartments(store: WebContextStore, sessionId: string, harness: string): WebCompartment[];
+//# sourceMappingURL=context-store.d.ts.map

package/dist/web/context-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-store.d.ts","sourceRoot":"","sources":["../../src/web/context-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAQH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,KAAK,eAAe,EAAE,KAAK,eAAe,EAAmB,MAAM,SAAS,CAAC;AAEtF,MAAM,WAAW,eAAe;IAC5B,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;CAC3C;AAED,MAAM,MAAM,sBAAsB,GAC5B;IAAE,MAAM,EAAE,eAAe,CAAC;IAAC,KAAK,EAAE,eAAe,CAAA;CAAE,GACnD;IAAE,MAAM,EAAE,eAAe,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,CAAC;AAEpD,kFAAkF;AAClF,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,sBAAsB,CA+C/E;AAED,MAAM,WAAW,iBAAiB;IAC9B,wFAAwF;IACxF,WAAW,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,QAAQ,EAAE,MAAM,CAAC;IACjB,2FAA2F;IAC3F,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,8DAA8D;IAC9D,UAAU,EAAE,OAAO,CAAC;CACvB;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,eAAe,GAAG,iBAAiB,EAAE,CAkD3E;AAED,MAAM,WAAW,aAAa;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,gBAAgB,EAAE,MAAM,CAAC;CAC5B;AAED,iFAAiF;AACjF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,GAAG,aAAa,EAAE,CA4BhG;AAED,MAAM,WAAW,cAAc;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,eAAe,CAAC;IAC3B,OAAO,EAAE,eAAe,CAAC;CAC5B;AAED,qGAAqG;AACrG,wBAAgB,uBAAuB,CACnC,KAAK,EAAE,eAAe,EACtB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GAChB,cAAc,EAAE,CAqClB"}

package/dist/web/fixtures.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Synthetic isolated fixtures for the web panel (plan 11 P2a UI bootstrap).
+ *
+ * Seeds a throwaway data root — context.db (real fresh-baseline schema), an
+ * OC2-style host store, and a Pi jsonl sessions tree — covering every panel
+ * state the UI must render: multi-host sessions, linked + unlinked compartment
+ * boundaries, long tool outputs, all memory statuses (including
+ * expired-unarchived, D16), mutation/verification evidence, and Pi branch
+ * files (D13). Every §3.2 source status is constructible via `omit`,
+ * `contextFence`, and `oc2Generation`.
+ *
+ * Never touches live data: the caller decides the root; nothing here reads
+ * environment resolvers.
+ */
+export type WebFixtureSource = "context" | "oc2" | "pi";
+export interface WebFixtureOptions {
+    /** Fixture root directory; defaults to a fresh mkdtemp under tmp/. */
+    root?: string;
+    /** Skip creating a source entirely → that source reports `missing`. */
+    omit?: WebFixtureSource[];
+    /** "future" bumps the persisted schema version → fence-unsupported (read-only fence, no migration). */
+    contextFence?: "v1" | "future";
+    /** "v1" seeds a pre-v2 host store → store-generation-unsupported. */
+    oc2Generation?: "v2" | "v1";
+}
+export interface WebFixturePaths {
+    root: string;
+    contextDbPath: string;
+    oc2DbPath: string;
+    piSessionsRoot: string;
+}
+export interface WebFixture extends WebFixturePaths {
+    /** Session ids / identities referenced by the seed (handy for tests and docs). */
+    seed: {
+        projectCore: string;
+        projectMemoryOnly: string;
+        oc2Session: string;
+        oc2Historian: string;
+        oc2HostOnly: string;
+        piSessionId: string;
+        piBranchFiles: string[];
+    };
+}
+export declare const FIXTURE_SEED: {
+    readonly projectCore: "git:fixturecore0000000000000000000000000000000";
+    readonly projectMemoryOnly: "dir:fixturememoryonly000000000000000000000";
+    readonly oc2Session: "ses_fixturemain00000000000000000000";
+    readonly oc2Historian: "ses_fixturehistorian0000000000000000";
+    readonly oc2HostOnly: "ses_fixtureghost00000000000000000000";
+    readonly piSessionId: "f1a0c0de-0000-4000-8000-000000000001";
+};
+export declare function createWebFixture(options?: WebFixtureOptions): WebFixture;
+//# sourceMappingURL=fixtures.d.ts.map

package/dist/web/fixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixtures.d.ts","sourceRoot":"","sources":["../../src/web/fixtures.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAmBH,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,KAAK,GAAG,IAAI,CAAC;AAExD,MAAM,WAAW,iBAAiB;IAC9B,sEAAsE;IACtE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uEAAuE;IACvE,IAAI,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC1B,uGAAuG;IACvG,YAAY,CAAC,EAAE,IAAI,GAAG,QAAQ,CAAC;IAC/B,qEAAqE;IACrE,aAAa,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,eAAe;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,UAAW,SAAQ,eAAe;IAC/C,kFAAkF;IAClF,IAAI,EAAE;QACF,WAAW,EAAE,MAAM,CAAC;QACpB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,UAAU,EAAE,MAAM,CAAC;QACnB,YAAY,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;QACpB,aAAa,EAAE,MAAM,EAAE,CAAC;KAC3B,CAAC;CACL;AAED,eAAO,MAAM,YAAY;;;;;;;CAOf,CAAC;AAEX,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,iBAAsB,GAAG,UAAU,CAiC5E"}

package/dist/web/host-opencode.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Read-only adapter for the OC2 host store (opencode.db).
+ *
+ * Path resolution is delegated to the single authority
+ * `resolveOpenCodeDbPath("v2", …)` — the panel never guesses host DB paths.
+ * Message reads go through the production `V2StoreReader` (readonly open with
+ * the generation assertion built in); session metadata (title/times) comes
+ * from the host's `session_v2` table through a second readonly handle because
+ * `V2StoreReader` exposes only message-shaped queries.
+ *
+ * Failure classification follows plan 11 §3.2 / D28: a missing store file is
+ * "missing"; a store whose generation is not v2 disables ONLY this host's raw
+ * reads (`store-generation-unsupported`, via the host-side
+ * `assertOpenCodeStoreGeneration` semantics); everything else is read-failed.
+ */
+import type { OpenCodeDbPathResolution } from "../shared/opencode-db-path";
+import { Database } from "../shared/sqlite";
+import { V2StoreReader } from "../v2/store-reader";
+import type { WebSourceStatus } from "./types";
+export interface Oc2HostStore {
+    readonly path: string;
+    readonly resolution: OpenCodeDbPathResolution;
+    /** Production message reader (readonly, generation-asserted). */
+    readonly reader: V2StoreReader;
+    /** Second readonly handle backing `session_v2` metadata reads; closed by `close()`. */
+    readonly metaDb: Database;
+    close(): void;
+}
+export type OpenOc2HostResult = {
+    status: WebSourceStatus;
+    resolution: OpenCodeDbPathResolution;
+    store: Oc2HostStore;
+} | {
+    status: WebSourceStatus;
+    resolution: OpenCodeDbPathResolution;
+    store: undefined;
+};
+/** Resolve and open the OC2 host store for reading; never writes. */
+export declare function openOc2HostStore(env?: NodeJS.ProcessEnv): OpenOc2HostResult;
+export interface Oc2SessionMeta {
+    sessionId: string;
+    title: string | null;
+    /** Host-side working directory; NOT the mmc project identity (D7 — never joined). */
+    directory: string | null;
+    parentId: string | null;
+    forkSessionId: string | null;
+    timeCreated: number | null;
+    timeUpdated: number | null;
+}
+/**
+ * Host session metadata (title/time) — confirmed against a real OpenCode 2
+ * 2.0.15 store (P1 probe): `session_v2(id, directory, title, parent_id,
+ * fork_session_id, time_created, time_updated, …)`, epoch-ms integers.
+ */
+export declare function listOc2SessionMeta(store: Oc2HostStore): Oc2SessionMeta[];
+//# sourceMappingURL=host-opencode.d.ts.map

package/dist/web/host-opencode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-opencode.d.ts","sourceRoot":"","sources":["../../src/web/host-opencode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAM3E,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,MAAM,WAAW,YAAY;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,wBAAwB,CAAC;IAC9C,iEAAiE;IACjE,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,uFAAuF;IACvF,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAC1B,KAAK,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,MAAM,iBAAiB,GACvB;IAAE,MAAM,EAAE,eAAe,CAAC;IAAC,UAAU,EAAE,wBAAwB,CAAC;IAAC,KAAK,EAAE,YAAY,CAAA;CAAE,GACtF;IAAE,MAAM,EAAE,eAAe,CAAC;IAAC,UAAU,EAAE,wBAAwB,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,CAAC;AAE1F,qEAAqE;AACrE,wBAAgB,gBAAgB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,iBAAiB,CAwDxF;AAqBD,MAAM,WAAW,cAAc;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,qFAAqF;IACrF,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,YAAY,GAAG,cAAc,EAAE,CAyBxE"}

package/dist/web/host-pi.d.ts

@@ -0,0 +1,116 @@
+/**
+ * Read-only adapter for Pi host sessions (jsonl).
+ *
+ * Format facts pinned by the P1 probe against real Pi 0.83.0 session files:
+ *   - One JSON object per line; line 1 is the session header
+ *     `{type:"session", version, id:<uuid>, timestamp:<ISO>, cwd:<path>}`.
+ *   - Entries: `{type:"message", id:<8-hex>, parentId, timestamp:<ISO>,
+ *     message:{role, content, …}}` plus protocol entries (model_change,
+ *     thinking_level_change, compaction, …) that carry no conversation parts.
+ *   - A session's header UUID can span MULTIPLE jsonl files (fork/clone);
+ *     the filename suffix after `_` is that UUID. Branches are listed, never
+ *     merged or guessed (D13).
+ *   - Empty/missing message ids must surface as unlinked data, never be
+ *     mapped onto ordinals (D14).
+ *
+ * The line reader here only splits lines and JSON.parses them — no Pi format
+ * semantics live in this file. All projection semantics (tool arc merge,
+ * synth-user ids, ordinals) are reused from the in-repo runtime parser via
+ * the injected `PiEntriesConverter` (pi-plugin's `convertEntriesToRawMessages`);
+ * zero new external dependencies.
+ */
+import type { RawMessage } from "../hooks/magic-context/read-session-raw";
+import type { WebSourceStatus } from "./types";
+/** The converter port implemented by pi-plugin with the reused runtime parser. */
+export type PiEntriesConverter = (entries: readonly unknown[]) => RawMessage[];
+export interface PiMessageEntry {
+    type: "message";
+    id: string;
+    parentId: string | null;
+    timestamp: string | number | null;
+    message: unknown;
+}
+export interface PiSessionFileInfo {
+    filePath: string;
+    fileName: string;
+    /** Encoded project directory name (one level under the sessions root). */
+    directoryName: string;
+    /** Header UUID (from the header line, not the filename); null when unparseable. */
+    sessionId: string | null;
+    headerTimestamp: string | null;
+    /** Non-null when the header line exists but is not a valid session header. */
+    headerError: string | null;
+}
+export interface PiSessionBranchGroup {
+    /** Header UUID shared by every file in the group. */
+    sessionId: string;
+    /** Branch files for this session, name-sorted (D13: listed, never merged). */
+    files: PiSessionFileInfo[];
+}
+export interface PiSessionListing {
+    status: WebSourceStatus;
+    /** Sessions whose header UUID resolved; one group per UUID. */
+    groups: PiSessionBranchGroup[];
+    /** Files whose first line is not a valid session header. */
+    unparseable: PiSessionFileInfo[];
+}
+/**
+ * Scan `<sessionsRoot>/<encoded-cwd>/<file>.jsonl` and group files by header
+ * UUID. The root itself is the default trusted data root (`~/.pi/agent/sessions`
+ * via HOME) — no arbitrary path input is accepted at this layer (D30).
+ */
+export declare function listPiSessionFiles(sessionsRoot: string): PiSessionListing;
+/** Default trusted Pi data root (D30): `~/.pi/agent/sessions` under the given env's HOME. */
+export declare function piSessionsRoot(env?: NodeJS.ProcessEnv): string;
+export interface PiFileProjection {
+    filePath: string;
+    status: WebSourceStatus;
+    /** True when the file ended mid-line or with an unparseable tail (partially written). */
+    truncated: boolean;
+    /** Count of interior lines that failed to parse (file kept reading past them). */
+    malformedLineCount: number;
+    /** Message entries in file order; protocol entries are skipped. */
+    entries: PiMessageEntry[];
+}
+/**
+ * Read one session file's message entries. A trailing line that fails to parse
+ * marks the file `truncated` (the host writes lines atomically, so a broken
+ * tail means the file was observed mid-write) — everything before it is still
+ * usable and is returned (§3.2: 详情按可读部分展示).
+ */
+export declare function readPiSessionFileEntries(filePath: string): PiFileProjection;
+export interface PiSessionProjection {
+    filePath: string;
+    status: WebSourceStatus;
+    truncated: boolean;
+    malformedLineCount: number;
+    /** Message entries as read (input to the converter); enables alias re-derivation. */
+    entries: PiMessageEntry[];
+    /** Reused runtime-parser projection (RawMessage[] with ordinals from 1). */
+    messages: RawMessage[];
+}
+/** Read one file and project it through the injected (reused) Pi parser. */
+export declare function projectPiSessionFile(filePath: string, converter: PiEntriesConverter): PiSessionProjection;
+/**
+ * Where a compartment boundary id lands in a projected Pi session (D14).
+ * `empty-id` → the compartment is unlinked; `resolved`/`synth-resolved` name a
+ * projected message id; `unresolved` means the id is present but no longer
+ * projects (never faked onto an ordinal).
+ */
+export type PiBoundaryResolution = {
+    state: "empty-id";
+} | {
+    state: "resolved";
+    messageId: string;
+    ordinal: number;
+} | {
+    state: "synth-resolved";
+    messageId: string;
+    ordinal: number;
+    aliasedTo: string;
+} | {
+    state: "unresolved";
+    messageId: string;
+};
+export declare function resolvePiBoundary(messageId: string | null | undefined, messages: readonly RawMessage[], synthIdAliases?: ReadonlyMap<string, string>): PiBoundaryResolution;
+//# sourceMappingURL=host-pi.d.ts.map

package/dist/web/host-pi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"host-pi.d.ts","sourceRoot":"","sources":["../../src/web/host-pi.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAKH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yCAAyC,CAAC;AAC1E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,kFAAkF;AAClF,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,EAAE,SAAS,OAAO,EAAE,KAAK,UAAU,EAAE,CAAC;AAE/E,MAAM,WAAW,cAAc;IAC3B,IAAI,EAAE,SAAS,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAClC,OAAO,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,0EAA0E;IAC1E,aAAa,EAAE,MAAM,CAAC;IACtB,mFAAmF;IACnF,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,8EAA8E;IAC9E,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,oBAAoB;IACjC,qDAAqD;IACrD,SAAS,EAAE,MAAM,CAAC;IAClB,8EAA8E;IAC9E,KAAK,EAAE,iBAAiB,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,gBAAgB;IAC7B,MAAM,EAAE,eAAe,CAAC;IACxB,+DAA+D;IAC/D,MAAM,EAAE,oBAAoB,EAAE,CAAC;IAC/B,4DAA4D;IAC5D,WAAW,EAAE,iBAAiB,EAAE,CAAC;CACpC;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,gBAAgB,CA6DzE;AAKD,6FAA6F;AAC7F,wBAAgB,cAAc,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAE3E;AA6DD,MAAM,WAAW,gBAAgB;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,eAAe,CAAC;IACxB,yFAAyF;IACzF,SAAS,EAAE,OAAO,CAAC;IACnB,kFAAkF;IAClF,kBAAkB,EAAE,MAAM,CAAC;IAC3B,mEAAmE;IACnE,OAAO,EAAE,cAAc,EAAE,CAAC;CAC7B;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,CAiE3E;AAoBD,MAAM,WAAW,mBAAmB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,eAAe,CAAC;IACxB,SAAS,EAAE,OAAO,CAAC;IACnB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,qFAAqF;IACrF,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,4EAA4E;IAC5E,QAAQ,EAAE,UAAU,EAAE,CAAC;CAC1B;AAED,4EAA4E;AAC5E,wBAAgB,oBAAoB,CAChC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,kBAAkB,GAC9B,mBAAmB,CAkCrB;AAED;;;;;GAKG;AACH,MAAM,MAAM,oBAAoB,GAC1B;IAAE,KAAK,EAAE,UAAU,CAAA;CAAE,GACrB;IAAE,KAAK,EAAE,UAAU,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACzD;IAAE,KAAK,EAAE,gBAAgB,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAClF;IAAE,KAAK,EAAE,YAAY,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjD,wBAAgB,iBAAiB,CAC7B,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACpC,QAAQ,EAAE,SAAS,UAAU,EAAE,EAC/B,cAAc,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,GAC7C,oBAAoB,CAuBtB"}

package/dist/web/main.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Web panel entry for @retaw106/mmc-oc (plan 11 P2a).
+ *
+ * Modes:
+ *  - default: serve the read-only panel on 127.0.0.1 (port via --port or
+ *    MMC_WEB_PORT, default 4180). No browser is opened.
+ *  - --smoke: the P1 probe — print the JSON data summary and exit 0; every
+ *    failure surfaces as a typed status inside the summary, never as a crash
+ *    and never as a write.
+ *  - --fixture [--fixture-root <dir>]: seed the synthetic isolated fixture
+ *    (fixtures.ts) into a throwaway root and serve against it — the designer
+ *    lane's bootstrap. Never touches live data.
+ *
+ * Isolation: all paths come from the standard resolvers (MMC_STORAGE_DIR /
+ * XDG_DATA_HOME / HOME / OPENCODE_DB), so redirecting env isolates the
+ * process completely (oracle spawn isolation() pattern).
+ */
+export declare function parseEntryArgs(args: string[]): {
+    mode: "serve" | "smoke";
+    port: number | undefined;
+    fixture: boolean;
+    fixtureRoot: string | undefined;
+};
+//# sourceMappingURL=main.d.ts.map

package/dist/web/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../src/web/main.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AA8LH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG;IAC5C,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC;IACxB,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC,CAwBA"}