@lmzhen/dsh-evolution-merge 0.45.0 → 0.47.0

package/lib/types/merge-routes.d.ts

@@ -1,11 +1,11 @@
 /**
  * Four read-only merge routes: view / rows / body / history.
- * The host loads rows and runs; these handlers only project wire envelopes.
+ * The host loads one snapshot; these handlers only project wire envelopes.
+ * There is no second (legacy rows/runs/history) source: the production constructor has
+ * always provided the snapshot, and the legacy branches were the only consumers of
+ * facts.ts / wire-projection.ts (W11 D2b).
  */
-import type { RunRecord } from '@lmzhen/dsh-evolution-core';
 import { type ConnectionFetchRouteLike, type DecisionAudit } from '@lmzhen/dsh-evolution-core/http-routes';
-import type { MergeRow } from './contracts.ts';
-import type { StateReadiness } from './domain/state-bootstrap.ts';
 import type { MergeSnapshot, BodyRef } from './domain/merge-snapshot.ts';
 export declare const MERGE_ROUTES: {
     view: `/api/dsh-evolution/${string}`;
@@ -25,25 +25,9 @@ export interface MergeDecisionResult {
     readonly code?: string;
     readonly runId?: string;
 }
-export interface MergeHistoryItem {
-    readonly name: string;
-    readonly kind: 'merged' | 'deleted' | 'split' | 'other';
-    readonly reason: string;
-    readonly lastVersion: number;
-    readonly archivedAt: string | null;
-    readonly sourceRunId?: string;
-}
 export interface MergeRouteSource {
-    snapshot?(): Promise<MergeSnapshot>;
+    snapshot(): Promise<MergeSnapshot>;
     bodyRef?(ref: BodyRef): Promise<string | null>;
-    rows?(): Promise<readonly MergeRow[]>;
-    run?(id: string): Promise<RunRecord | undefined>;
-    runs?(cursor?: string, limit?: number): Promise<readonly RunRecord[]>;
-    body?(id: string, side: 'a' | 'b'): Promise<string | null>;
-    history?(): Promise<readonly MergeHistoryItem[]>;
-    commands(): readonly string[];
-    approval?(): boolean;
-    readiness?(): Promise<StateReadiness>;
 }
 export declare function makeMergeRoutes(deps: {
     getSource: () => MergeRouteSource | undefined;

package/lib/types/merge-routes.js

@@ -1,6 +1,11 @@
+/**
+ * Four read-only merge routes: view / rows / body / history.
+ * The host loads one snapshot; these handlers only project wire envelopes.
+ * There is no second (legacy rows/runs/history) source: the production constructor has
+ * always provided the snapshot, and the legacy branches were the only consumers of
+ * facts.ts / wire-projection.ts (W11 D2b).
+ */
 import { HOST_ROUTES, json, methodNotAllowed } from '@lmzhen/dsh-evolution-core/http-routes';
-import { buildFacts as buildLegacyFacts } from "./facts.js";
-import { toBodyView, toHistoryView, toQueuePage } from "./wire-projection.js";
 import { buildBodyView, buildFacts as buildSnapshotFacts, buildHistoryView, buildQueuePage } from "./surface/merge-view.js";
 const MERGE_PATHS = HOST_ROUTES.merge;
 const MERGE_BASE = MERGE_PATHS.view.slice(0, -'view'.length);
@@ -13,17 +18,16 @@ export const MERGE_ROUTES = {
 };
 export function makeMergeRoutes(deps, _audit) {
     const absent = () => json(404, { wireVersion: 1, code: 'E-325', message: 'merge service is not mounted' });
-    const blocked = (readiness) => json(503, { wireVersion: 1, code: 'merge-state-blocked', readiness });
+    const blocked = (snapshot) => snapshot.blocked === undefined ? null : json(503, { wireVersion: 1, code: 'merge-state-blocked', readiness: snapshot.blocked.readiness });
     const hostOnly = (snapshot) => snapshot.hostOnly === undefined ? null : json(503, { wireVersion: 1, code: 'E-323', message: snapshot.hostOnly.detail ?? 'host data plane unavailable' });
-    const notReady = async (source) => {
-        if (source.readiness === undefined)
-            return null;
-        const readiness = await source.readiness();
-        return readiness.ok ? null : blocked(readiness);
-    };
     const bad = (message) => json(400, { wireVersion: 1, code: 'merge-bad-query', message });
     const get = (request) => (request.method === 'GET' ? null : methodNotAllowed(['GET']));
     const url = (request) => new URL(request.url, 'http://local');
+    const snapshotOf = async () => {
+        const source = deps.getSource();
+        return source === undefined ? null : await source.snapshot();
+    };
+    const unavailable = (snapshot) => snapshot === null ? absent() : blocked(snapshot) ?? hostOnly(snapshot);
     return [
         {
             path: MERGE_ROUTES.view,
@@ -33,25 +37,11 @@ export function makeMergeRoutes(deps, _audit) {
                 const denied = get(request);
                 if (denied !== null)
                     return denied;
-                const source = deps.getSource();
-                if (source === undefined)
-                    return absent();
-                if (source.snapshot !== undefined) {
-                    const snapshot = await source.snapshot();
-                    if (snapshot.blocked !== undefined)
-                        return json(503, { wireVersion: 1, code: 'merge-state-blocked', readiness: snapshot.blocked.readiness });
-                    const capability = hostOnly(snapshot);
-                    if (capability !== null)
-                        return capability;
-                    return json(200, buildSnapshotFacts(snapshot));
-                }
-                const readiness = await notReady(source);
-                if (readiness !== null)
-                    return readiness;
-                const readAt = Date.now();
-                const rows = await source.rows?.() ?? [];
-                const runs = await source.runs?.(undefined, 20) ?? [];
-                return json(200, buildLegacyFacts({ rows, runs, approval: source.approval?.() === true, readAt }));
+                const snapshot = await snapshotOf();
+                const notReady = unavailable(snapshot);
+                if (notReady !== null)
+                    return notReady;
+                return json(200, buildSnapshotFacts(snapshot));
             },
         },
         {
@@ -62,9 +52,6 @@ export function makeMergeRoutes(deps, _audit) {
                 const denied = get(request);
                 if (denied !== null)
                     return denied;
-                const source = deps.getSource();
-                if (source === undefined)
-                    return absent();
                 const query = url(request).searchParams;
                 const queue = query.get('queue') ?? 'verify';
                 if (queue !== 'verify' && queue !== 'pending' && queue !== 'fuse' && queue !== 'skipped')
@@ -73,27 +60,16 @@ export function makeMergeRoutes(deps, _audit) {
                 if (expiredOnly && queue !== 'pending')
                     return bad('expired is only allowed for pending');
                 const limit = Number.parseInt(query.get('limit') ?? '50', 10);
-                if (source.snapshot !== undefined) {
-                    const snapshot = await source.snapshot();
-                    if (snapshot.blocked !== undefined)
-                        return json(503, { wireVersion: 1, code: 'merge-state-blocked', readiness: snapshot.blocked.readiness });
-                    const capability = hostOnly(snapshot);
-                    if (capability !== null)
-                        return capability;
-                    try {
-                        return json(200, buildQueuePage(snapshot, queue, expiredOnly, query.get('cursor') ?? undefined, Number.isFinite(limit) ? limit : 50));
-                    }
-                    catch (error) {
-                        return bad(error instanceof Error ? error.message : 'queue cursor is stale');
-                    }
+                const snapshot = await snapshotOf();
+                const notReady = unavailable(snapshot);
+                if (notReady !== null)
+                    return notReady;
+                try {
+                    return json(200, buildQueuePage(snapshot, queue, expiredOnly, query.get('cursor') ?? undefined, Number.isFinite(limit) ? limit : 50));
+                }
+                catch (error) {
+                    return bad(error instanceof Error ? error.message : 'queue cursor is stale');
                 }
-                const readiness = await notReady(source);
-                if (readiness !== null)
-                    return readiness;
-                const offset = Number.parseInt(query.get('cursor') ?? '0', 10);
-                const rows = await source.rows?.() ?? [];
-                const page = toQueuePage(rows, queue, expiredOnly, Date.now(), Number.isFinite(limit) ? limit : 50);
-                return json(200, Number.isFinite(offset) && offset > 0 ? { ...page, rows: page.rows.slice(offset) } : page);
             },
         },
         {
@@ -113,36 +89,26 @@ export function makeMergeRoutes(deps, _audit) {
                 const side = query.get('side');
                 if ((id === null || id === '') && (name === null || name === ''))
                     return json(404, { wireVersion: 1, code: 'merge-body-not-found', message: 'merge body requires id or name' });
-                if (source.snapshot !== undefined) {
-                    const snapshot = await source.snapshot();
-                    if (snapshot.blocked !== undefined)
-                        return json(503, { wireVersion: 1, code: 'merge-state-blocked', readiness: snapshot.blocked.readiness });
-                    // Body/history are read-only projections of already-written files; a host without
-                    // the live agent data plane can still read past reports and archived bodies.
-                    const sideFilter = side === 'a' ? 'live' : side === 'b' ? 'archive' : side === 'live' || side === 'archive' ? side : undefined;
-                    const refs = snapshot.bodyRefs.filter(ref => (id === null || id === '' || ref.rowId === id)
-                        && (name === null || name === '' || ref.name === name)
-                        && (sideFilter === undefined || ref.side === sideFilter));
-                    if (refs.length === 0)
-                        return json(404, { wireVersion: 1, code: 'merge-body-not-found', message: 'merge body not found' });
-                    if (refs.length > 1)
-                        return bad('merge body is ambiguous; pass id, name and side');
-                    const row = snapshot.rows.find(item => item.row.id === refs[0].rowId);
-                    if (row?.stage?.state === 'lost' || row?.stage?.state === 'expired')
-                        return json(404, { wireVersion: 1, code: 'merge-body-not-found', message: 'merge stage is lost' });
-                    const ref = refs[0];
-                    const content = source.bodyRef === undefined ? null : await source.bodyRef(ref);
-                    return json(200, buildBodyView(snapshot, ref, content ?? ''));
-                }
-                const readiness = await notReady(source);
-                if (readiness !== null)
-                    return readiness;
-                if (id === null || id === '' || (side !== 'a' && side !== 'b'))
-                    return bad('id and side=a|b are required');
-                const content = await source.body?.(id, side) ?? null;
-                return content === null
-                    ? json(200, { wireVersion: 1, code: 'merge-body-missing', message: 'merge body not found: ' + id })
-                    : json(200, toBodyView(id, side === 'a' ? 'live' : 'archive', content, Date.now()));
+                const snapshot = await source.snapshot();
+                const notReady = blocked(snapshot);
+                if (notReady !== null)
+                    return notReady;
+                // Body/history are read-only projections of already-written files; a host without
+                // the live agent data plane can still read past reports and archived bodies.
+                const sideFilter = side === 'a' ? 'live' : side === 'b' ? 'archive' : side === 'live' || side === 'archive' ? side : undefined;
+                const refs = snapshot.bodyRefs.filter(ref => (id === null || id === '' || ref.rowId === id)
+                    && (name === null || name === '' || ref.name === name)
+                    && (sideFilter === undefined || ref.side === sideFilter));
+                if (refs.length === 0)
+                    return json(404, { wireVersion: 1, code: 'merge-body-not-found', message: 'merge body not found' });
+                if (refs.length > 1)
+                    return bad('merge body is ambiguous; pass id, name and side');
+                const row = snapshot.rows.find(item => item.row.id === refs[0].rowId);
+                if (row?.stage?.state === 'lost' || row?.stage?.state === 'expired')
+                    return json(404, { wireVersion: 1, code: 'merge-body-not-found', message: 'merge stage is lost' });
+                const ref = refs[0];
+                const content = source.bodyRef === undefined ? null : await source.bodyRef(ref);
+                return json(200, buildBodyView(snapshot, ref, content ?? ''));
             },
         },
         {
@@ -153,19 +119,13 @@ export function makeMergeRoutes(deps, _audit) {
                 const denied = get(request);
                 if (denied !== null)
                     return denied;
-                const source = deps.getSource();
-                if (source === undefined)
+                const snapshot = await snapshotOf();
+                if (snapshot === null)
                     return absent();
-                if (source.snapshot !== undefined) {
-                    const snapshot = await source.snapshot();
-                    if (snapshot.blocked !== undefined)
-                        return json(503, { wireVersion: 1, code: 'merge-state-blocked', readiness: snapshot.blocked.readiness });
-                    return json(200, buildHistoryView(snapshot));
-                }
-                const readiness = await notReady(source);
-                if (readiness !== null)
-                    return readiness;
-                return json(200, toHistoryView(await source.history?.() ?? [], Date.now()));
+                const notReady = blocked(snapshot);
+                if (notReady !== null)
+                    return notReady;
+                return json(200, buildHistoryView(snapshot));
             },
         },
         {

package/lib/types/state.d.ts

@@ -1,7 +1,5 @@
 import type { EvolutionIoLike } from '@lmzhen/dsh-evolution-core';
-import { type MergePairState, type MergeQueue, type MergeRow, type MergeState } from './contracts.ts';
-import type { RowWriteResult } from './domain/row-tx.ts';
-import type { SkippedRowV3, V3Event, V3Row, VerifyRowV3 } from './domain/row-v3.ts';
+import { type MergeQueue, type MergeRow, type MergeState } from './contracts.ts';
 export declare function mergeStatePath(home: string): string;
 export interface LoadMergeStateResult {
     readonly ok: boolean;
@@ -12,39 +10,5 @@ export interface LoadMergeStateResult {
 export declare function loadMergeState(io: EvolutionIoLike, home: string): Promise<LoadMergeStateResult>;
 /** Schema probe for doctor; the only other reader of mergeStatePath. */
 export declare function loadStateSchema(io: EvolutionIoLike, home: string): Promise<number | null>;
-export interface RowTx {
-    rows(): readonly V3Row[];
-    createVerify(row: VerifyRowV3): RowWriteResult;
-    createSkipped(row: SkippedRowV3): RowWriteResult;
-    transition(id: string, event: V3Event, expectedVersion: number): RowWriteResult;
-}
-/** G3-5 runtime write API: only createVerify/createSkipped/transition. v2 writes are rejected. */
-export declare function transactRows<T>(_io: EvolutionIoLike, _home: string, _fn: (tx: RowTx) => T): Promise<T>;
-/** The ONE write point. The callback returns the whole row set, not a delta. */
-export declare function mutateMergeState<T>(_io: EvolutionIoLike, _home: string, _now: () => number, _fn: (rows: readonly MergeRow[]) => {
-    rows: readonly MergeRow[];
-    result: T;
-}): Promise<T>;
-export interface MoveRowPatch {
-    readonly queue: MergeQueue;
-    readonly state?: MergePairState;
-    readonly failure?: MergeRow['failure'];
-    readonly runId?: string;
-    readonly unitId?: string;
-    readonly origin?: MergeRow['origin'];
-    readonly attempts?: number;
-}
-export type UpsertExpect = 'any' | 'absent' | 'verify' | 'pending' | 'fuse' | 'skipped';
-export type UpsertResult = {
-    readonly ok: true;
-} | {
-    readonly ok: false;
-    readonly current: MergeRow;
-};
-export declare function upsertRow(io: EvolutionIoLike, home: string, now: () => number, row: MergeRow, expect?: UpsertExpect, cas?: string | null): Promise<UpsertResult>;
-export declare function moveRow(io: EvolutionIoLike, home: string, now: () => number, id: string, patch: MoveRowPatch): Promise<MergeRow | undefined>;
-/** G3-5 v3-aware drop: only terminal events. */
-export declare function dropRowV3(_io: EvolutionIoLike, _home: string, _id: string, _event: 'committed' | 'superseded' | 'restored', _unitId?: string): Promise<boolean>;
-export declare function dropRow(io: EvolutionIoLike, home: string, now: () => number, id: string): Promise<boolean>;
 export declare function rowsOf(io: EvolutionIoLike, home: string, queue?: MergeQueue): Promise<readonly MergeRow[]>;
 //# sourceMappingURL=state.d.ts.map

package/lib/types/state.js

@@ -2,12 +2,12 @@
  * The one merge-state ledger: <home>/merge/merge-state.json.
  *
  * Reads are pure projections (no write, no reconciliation side effect). Every write goes
- * through mutateMergeState and a single transactIo, so there is no second file and no
+ * through pairLedger and a single transactIo, so there is no second file and no
  * incremental writer. A row's queue is always derived from its state on read; a hand-edited
  * mismatch is repaired by the next write, never by a GET.
  */
 import { join } from 'node:path';
-import { MERGE_STATE_VERSION, queueOf, } from "./contracts.js";
+import { MERGE_STATE_VERSION, } from "./contracts.js";
 import { parseLedger } from "./domain/ledger.js";
 import { parseV4State } from "./domain/schema4.js";
 import { v4ToLegacy } from "./domain/row-v4.js";
@@ -67,69 +67,6 @@ export async function loadStateSchema(io, home) {
         return null;
     }
 }
-/** G3-5 runtime write API: only createVerify/createSkipped/transition. v2 writes are rejected. */
-export async function transactRows(_io, _home, _fn) {
-    throw new Error('legacy-writer-removed');
-}
-/** The ONE write point. The callback returns the whole row set, not a delta. */
-export async function mutateMergeState(_io, _home, _now, _fn) {
-    throw new Error('legacy-writer-removed');
-}
-export async function upsertRow(io, home, now, row, expect = 'any', cas) {
-    return await mutateMergeState(io, home, now, (rows) => {
-        const index = rows.findIndex(item => item.pairKey === row.pairKey);
-        const current = index < 0 ? undefined : rows[index];
-        if (cas !== undefined && ((cas === null && current !== undefined) || (cas !== null && current?.updatedAt !== cas))) {
-            return { rows, result: { ok: false, current: current ?? row } };
-        }
-        if (current !== undefined && expect !== 'any' && (expect === 'absent' || queueOf(current.state) !== expect)) {
-            return { rows, result: { ok: false, current } };
-        }
-        if (current === undefined && expect !== 'any' && expect !== 'absent' && expect !== 'verify') {
-            return { rows, result: { ok: false, current: row } };
-        }
-        const normalized = { ...row, queue: queueOf(row.state) };
-        const next = [...rows];
-        if (current === undefined)
-            next.push(normalized);
-        else
-            next[index] = { ...normalized, createdAt: current.createdAt };
-        return { rows: next, result: { ok: true } };
-    });
-}
-export async function moveRow(io, home, now, id, patch) {
-    return await mutateMergeState(io, home, now, (rows) => {
-        const index = rows.findIndex(item => item.id === id);
-        if (index < 0)
-            return { rows, result: undefined };
-        const current = rows[index];
-        const state = patch.state ?? current.state;
-        const next = {
-            ...current,
-            state,
-            queue: queueOf(state),
-            updatedAt: new Date(now()).toISOString(),
-            ...(patch.failure === undefined ? {} : { failure: patch.failure }),
-            ...(patch.runId === undefined ? {} : { runId: patch.runId }),
-            ...(patch.unitId === undefined ? {} : { unitId: patch.unitId }),
-            ...(patch.origin === undefined ? {} : { origin: patch.origin }),
-            ...(patch.attempts === undefined ? {} : { attempts: patch.attempts }),
-        };
-        const copy = [...rows];
-        copy[index] = next;
-        return { rows: copy, result: next };
-    });
-}
-/** G3-5 v3-aware drop: only terminal events. */
-export async function dropRowV3(_io, _home, _id, _event, _unitId = 'unknown') {
-    throw new Error('legacy-writer-removed');
-}
-export async function dropRow(io, home, now, id) {
-    return await mutateMergeState(io, home, now, (rows) => {
-        const next = rows.filter(item => item.id !== id);
-        return { rows: next, result: next.length !== rows.length };
-    });
-}
 export async function rowsOf(io, home, queue) {
     const loaded = await loadMergeState(io, home);
     return queue === undefined ? loaded.state.rows : loaded.state.rows.filter(row => row.queue === queue);

package/lib/types/surface/merge-view.js

@@ -135,7 +135,7 @@ export function buildRunDetail(snapshot, runId) {
     const run = snapshot.runs.find(item => item.record.id === runId);
     if (run === undefined)
         return null;
-    return { ...runView(run, snapshot.readAt, true), ...(run.meta === null ? {} : { meta: { phase: run.meta.phase, ...(run.meta.approval === undefined ? {} : { approval: run.meta.approval }) } }), ...(run.reportRef === null ? {} : { reportRef: run.reportRef }), pairs: run.pairs.map(pair => ({ pairKey: pair.pairKey, a: pair.pairKey.split('\u0000')[0] ?? '', b: pair.pairKey.split('\u0000')[1] ?? '', outcome: pair.result === 'kept' ? 'kept' : pair.result === 'failed' ? 'failed' : pair.result === 'cancelled' ? 'cancelled' : 'merged', ...(pair.target === undefined ? {} : { target: { requested: pair.target } }) })), pairsTruncated: false };
+    return { ...runView(run, snapshot.readAt, true), ...(run.meta === null ? {} : { meta: { phase: run.meta.phase, ...(run.meta.approval === undefined ? {} : { approval: run.meta.approval }) } }), ...(run.reportRef === null ? {} : { reportRef: run.reportRef }), pairs: run.pairs.map(pair => ({ pairKey: pair.pairKey, a: pair.pairKey.split('\u0000')[0] ?? '', b: pair.pairKey.split('\u0000')[1] ?? '', outcome: pair.result === 'kept' ? 'kept' : pair.result === 'failed' ? 'failed' : pair.result === 'cancelled' ? 'cancelled' : pair.result === 'undone' ? 'undone' : 'merged', ...(pair.target === undefined ? {} : { target: { requested: pair.target } }) })), pairsTruncated: false };
 }
 export function buildRunsView(snapshot) { return { wireVersion: 1, readAt: snapshot.readAt, runs: [...snapshot.runs].sort((a, b) => b.record.startedAt - a.record.startedAt).map(run => runView(run, snapshot.readAt, true)) }; }
 export function buildDoctorView(snapshot) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@lmzhen/dsh-evolution-merge",
   "description": "Skill auto-merge domain: screening, two-round authoring, queues and commit orchestration (community build)",
-  "version": "0.45.0",
+  "version": "0.47.0",
   "publishConfig": {
     "access": "public"
   },
@@ -34,9 +34,9 @@
   },
   "dependencies": {
     "@deepseek-ai/schemastery": "^3.18.5",
-    "@lmzhen/dsh-evolution-core": "^0.45.0",
-    "@lmzhen/dsh-evolution-commands": "^0.45.0",
-    "@lmzhen/dsh-evolution-merge-engine": "0.45.0"
+    "@lmzhen/dsh-evolution-core": "^0.47.0",
+    "@lmzhen/dsh-evolution-commands": "^0.47.0",
+    "@lmzhen/dsh-evolution-merge-engine": "0.47.0"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.5"

package/lib/types/facts.d.ts

@@ -1,26 +0,0 @@
-/** G5-2 Facts pure projection. Reads a snapshot; never writes. */
-import type { EvolutionIoLike, RunRecord } from '@lmzhen/dsh-evolution-core';
-import type { MergeRow } from './contracts.ts';
-import type { Facts, MergeCounts, RunView } from './wire.ts';
-import type { MergeRunMeta } from './domain/run-coordinator.ts';
-export declare function countsOf(rows: readonly MergeRow[]): MergeCounts;
-export declare function toRunView(record: RunRecord, readAt: number, meta?: MergeRunMeta | null): RunView;
-export interface FactsInput {
-    readonly rows: readonly MergeRow[];
-    readonly runs: readonly RunRecord[];
-    readonly runMeta?: ReadonlyMap<string, MergeRunMeta>;
-    readonly approval: boolean;
-    readonly readAt: number;
-    readonly notes?: readonly string[];
-}
-export interface ReadFactsOptions {
-    readonly io: EvolutionIoLike;
-    readonly home: string;
-    readonly runs: readonly RunRecord[];
-    readonly approval: boolean;
-    readonly readAt: number;
-}
-/** GET projection: reads state + runs; never writes. */
-export declare function readFacts(options: ReadFactsOptions): Promise<Facts>;
-export declare function buildFacts(input: FactsInput): Facts;
-//# sourceMappingURL=facts.d.ts.map

package/lib/types/facts.js

@@ -1,65 +0,0 @@
-import { MERGE_COMMAND_SURFACE } from "./command-surface.js";
-import { readMergeSnapshot } from "./domain/merge-snapshot.js";
-import { buildFacts as buildSnapshotFacts } from "./surface/merge-view.js";
-const queueOf = (row) => row.state === 'approved' ? 'fuse' : row.queue;
-const isExpired = (row) => row.expired !== undefined;
-export function countsOf(rows) {
-    const active = { verify: 0, pending: 0, fuse: 0, skipped: 0 };
-    let expired = 0;
-    for (const row of rows) {
-        if (isExpired(row)) {
-            expired += 1;
-            continue;
-        }
-        active[queueOf(row)] += 1;
-    }
-    return { active, expired };
-}
-export function toRunView(record, readAt, meta = null) {
-    const state = record.state;
-    void meta;
-    return {
-        wireVersion: 1,
-        readAt,
-        id: record.id,
-        state,
-        command: record.command ?? 'scan',
-        ...(record.stage === undefined ? {} : { stage: record.stage }),
-        progress: record.progress === undefined ? null : { done: record.progress.done, total: record.progress.total },
-        startedAt: record.startedAt,
-        ...(record.endedAt === undefined ? {} : { endedAt: record.endedAt }),
-        ...(record.failure === undefined ? {} : { failure: { stage: 'settle', code: 'run-failed', retryable: false, retryFrom: 'none', detail: record.failure } }),
-        ...(record.parentRunId === undefined ? {} : { parentRunId: record.parentRunId }),
-        actions: [
-            { id: 'status', command: '/evolution merge status ' + record.id, confirm: false, enabled: true },
-            { id: 'report', command: '/evolution merge report ' + record.id, confirm: false, enabled: record.resultRef !== undefined },
-            { id: 'cancel', command: '/evolution merge cancel ' + record.id, confirm: false, enabled: state === 'running' },
-        ],
-    };
-}
-/** GET projection: reads state + runs; never writes. */
-export async function readFacts(options) {
-    const snapshot = await readMergeSnapshot({ io: options.io, home: options.home, runs: options.runs, approval: options.approval, now: () => options.readAt });
-    if (snapshot.blocked !== undefined)
-        throw new Error(snapshot.blocked.code + ': ' + snapshot.blocked.message);
-    return buildSnapshotFacts(snapshot);
-}
-export function buildFacts(input) {
-    const ordered = [...input.runs].sort((a, b) => b.startedAt - a.startedAt);
-    const active = ordered.find(run => run.state === 'running');
-    const last = ordered.find(run => run.state !== 'running');
-    const notes = input.notes ?? [];
-    return {
-        wireVersion: 1,
-        readAt: input.readAt,
-        approval: { mergeApproval: input.approval },
-        counts: countsOf(input.rows),
-        active: active === undefined ? null : toRunView(active, input.readAt, input.runMeta?.get(active.id) ?? null),
-        last: last === undefined ? null : toRunView(last, input.readAt, input.runMeta?.get(last.id) ?? null),
-        startCommands: { scan: '/evolution merge scan', pair: '/evolution merge pair <a> <b>' },
-        fallback: MERGE_COMMAND_SURFACE.fallback,
-        notes,
-        degraded: notes.length > 0,
-    };
-}
-//# sourceMappingURL=facts.js.map

package/lib/types/metrics.d.ts

@@ -1,16 +0,0 @@
-/** RG6 merge metrics projection: stable names/labels from state + runs. */
-import type { RunRecord } from '@lmzhen/dsh-evolution-core';
-import type { MergeRow } from './contracts.ts';
-export interface MetricSample {
-    readonly name: string;
-    readonly labels: Readonly<Record<string, string>>;
-    readonly value: number;
-}
-export interface MergeMetricCounters {
-    readonly lockWaitMs?: number;
-    readonly claimConflict?: number;
-    readonly recoveryFail?: number;
-}
-export declare const MERGE_METRIC_NAMES: readonly ["merge_queue_depth", "merge_run_total", "merge_run_duration_ms", "merge_lock_wait_ms", "merge_claim_conflict_total", "merge_recovery_fail_total"];
-export declare function buildMergeMetrics(rows: readonly MergeRow[], runs: readonly RunRecord[], counters?: MergeMetricCounters): readonly MetricSample[];
-//# sourceMappingURL=metrics.d.ts.map

package/lib/types/metrics.js

@@ -1,27 +0,0 @@
-import { countsOf } from "./facts.js";
-export const MERGE_METRIC_NAMES = [
-    'merge_queue_depth',
-    'merge_run_total',
-    'merge_run_duration_ms',
-    'merge_lock_wait_ms',
-    'merge_claim_conflict_total',
-    'merge_recovery_fail_total',
-];
-export function buildMergeMetrics(rows, runs, counters = {}) {
-    const counts = countsOf(rows);
-    const samples = [];
-    for (const queue of ['verify', 'pending', 'fuse', 'skipped'])
-        samples.push({ name: 'merge_queue_depth', labels: { queue, kind: 'active' }, value: counts.active[queue] });
-    samples.push({ name: 'merge_queue_depth', labels: { queue: 'pending', kind: 'expired' }, value: counts.expired });
-    for (const run of runs) {
-        const state = run.state;
-        samples.push({ name: 'merge_run_total', labels: { state }, value: 1 });
-        if (run.endedAt !== undefined)
-            samples.push({ name: 'merge_run_duration_ms', labels: { state }, value: Math.max(0, run.endedAt - run.startedAt) });
-    }
-    samples.push({ name: 'merge_lock_wait_ms', labels: {}, value: counters.lockWaitMs ?? 0 });
-    samples.push({ name: 'merge_claim_conflict_total', labels: {}, value: counters.claimConflict ?? 0 });
-    samples.push({ name: 'merge_recovery_fail_total', labels: {}, value: counters.recoveryFail ?? 0 });
-    return samples;
-}
-//# sourceMappingURL=metrics.js.map

package/lib/types/wire-projection.d.ts

@@ -1,36 +0,0 @@
-/** G5-4 wire projections from merge rows to the frozen envelopes. */
-import type { RunRecord } from '@lmzhen/dsh-evolution-core';
-import type { MergeRow } from './contracts.ts';
-import type { BodyView, DoctorView, HistoryView, MergeCounts, QueueId, QueuePage, RowFact, RunView, RunsView } from './wire.ts';
-/** Host-owned row actions; client only renders/copies them. */
-export declare function actionRefs(row: MergeRow): RowFact['actions'];
-export declare function toRowFact(row: MergeRow, actions?: RowFact['actions']): RowFact;
-export declare function toQueuePage(rows: readonly MergeRow[], queue: QueueId, expiredOnly: boolean, readAt: number, limit?: number): QueuePage;
-export declare function toRunsView(runs: readonly RunRecord[], readAt: number): RunsView;
-export interface DoctorSourceFact {
-    readonly key: string;
-    readonly status: 'ok' | 'warn' | 'fail' | 'unknown';
-    readonly count?: number;
-    readonly detail?: string;
-}
-export declare function toDoctorView(input: {
-    readonly readAt: number;
-    readonly counts: MergeCounts;
-    readonly latestRun?: RunView;
-    readonly approval: {
-        mergeApproval: boolean;
-        writeApproval?: boolean;
-    };
-    readonly staging: DoctorView['staging'];
-    readonly rows: readonly DoctorSourceFact[];
-}): DoctorView;
-export declare function toBodyView(name: string, side: 'live' | 'archive', text: string, readAt: number): BodyView;
-export declare function toHistoryView(items: readonly {
-    name: string;
-    kind: 'merged' | 'deleted' | 'split' | 'other';
-    reason: string;
-    lastVersion: number;
-    archivedAt: string | number | null;
-    sourceRunId?: string;
-}[], readAt: number): HistoryView;
-//# sourceMappingURL=wire-projection.d.ts.map