@lmzhen/dsh-evolution-merge 0.47.0 → 0.49.0

package/lib/types/domain/commit-journal.js

@@ -1,26 +0,0 @@
-const NEXT = {
-    prepared: ['committed', 'target-written', 'failed'],
-    'target-written': ['sources-archived', 'rolled-back', 'failed'],
-    'sources-archived': ['committed', 'rolled-back', 'failed'],
-    committed: [],
-    'rolled-back': [],
-    failed: [],
-};
-export function advanceJournal(journal, phase, at) {
-    if (!NEXT[journal.phase].includes(phase))
-        throw new Error('invalid journal transition: ' + journal.phase + ' -> ' + phase);
-    return { ...journal, phase, updatedAt: at };
-}
-/** What a restart may do with the last durable phase. */
-export function recoveryFor(journal) {
-    switch (journal.phase) {
-        case 'prepared': return 'retry-commit';
-        case 'target-written': return 'rollback-target';
-        case 'sources-archived': return 'rollback-sources';
-        case 'committed':
-        case 'rolled-back':
-        case 'failed': return 'none';
-        default: return 'refuse';
-    }
-}
-//# sourceMappingURL=commit-journal.js.map

package/lib/types/domain/indexes.d.ts

@@ -1,21 +0,0 @@
-/** Pure pairKey result index and archived-history projection. No IO. */
-export interface PairIndexEntryV2 {
-    readonly pairKey: string;
-    readonly runId: string;
-    readonly result: 'merged' | 'kept' | 'failed' | 'cancelled' | 'undone';
-    readonly target?: string;
-    readonly reportRef?: string;
-}
-export type HistoryKind = 'merged' | 'deleted' | 'split' | 'other';
-export interface HistoryRecord {
-    readonly name: string;
-    readonly kind: HistoryKind;
-    readonly reason: string;
-    readonly lastVersion: number;
-    readonly archivedAt: string;
-    readonly sourceRunId?: string;
-}
-export declare function putPair(index: ReadonlyMap<string, PairIndexEntryV2>, entry: PairIndexEntryV2): Map<string, PairIndexEntryV2>;
-export declare function historyRecord(input: HistoryRecord): HistoryRecord;
-export declare function summarizeHistory(records: readonly HistoryRecord[]): Record<HistoryKind, number>;
-//# sourceMappingURL=indexes.d.ts.map

package/lib/types/domain/indexes.js

@@ -1,15 +0,0 @@
-export function putPair(index, entry) {
-    const next = new Map(index);
-    next.set(entry.pairKey, entry);
-    return next;
-}
-export function historyRecord(input) {
-    return { ...input, lastVersion: Math.max(1, Math.trunc(input.lastVersion)) };
-}
-export function summarizeHistory(records) {
-    const counts = { merged: 0, deleted: 0, split: 0, other: 0 };
-    for (const record of records)
-        counts[record.kind] += 1;
-    return counts;
-}
-//# sourceMappingURL=indexes.js.map

package/lib/types/domain/merge-report.d.ts

@@ -1,41 +0,0 @@
-/** 1b-1 additive report schema; values are filled by later batches. */
-export interface MergeReportLimits {
-    readonly maxSkillFileBytes?: number;
-    readonly maxTokenBytes?: number;
-    readonly pairTimeoutMinutes?: number;
-}
-export interface MergeReportValidation {
-    readonly ok: boolean;
-    readonly errors: readonly string[];
-}
-export interface MergeReport {
-    readonly schemaVersion: 2;
-    readonly reportId: string;
-    readonly runId: string;
-    readonly pairKey: string;
-    readonly target: string;
-    readonly sourceRevisions?: Readonly<Record<string, string>>;
-    readonly targetRevision?: string;
-    readonly validation: MergeReportValidation;
-    readonly limits: MergeReportLimits;
-    readonly q09?: {
-        readonly forwardRefs: readonly string[];
-        readonly reverseRefs: readonly string[];
-        readonly orphanFiles: readonly string[];
-    };
-    readonly threat?: {
-        readonly body: string;
-        readonly source: string;
-    };
-    readonly createdAt: string;
-}
-export interface MergeReportRef {
-    readonly path: string;
-    readonly digest: string;
-    readonly writtenAt: string;
-}
-export interface MergeReportWriter {
-    write(report: MergeReport): Promise<MergeReportRef>;
-    read(runId: string): Promise<MergeReport | null>;
-}
-//# sourceMappingURL=merge-report.d.ts.map

package/lib/types/domain/merge-report.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=merge-report.js.map

package/lib/types/domain/pair-index-store.d.ts

@@ -1,6 +0,0 @@
-import type { EvolutionIoLike } from '@lmzhen/dsh-evolution-core';
-import type { PairIndexEntryV2 } from './indexes.ts';
-export declare function pairIndexPath(home: string): string;
-export declare function loadPairIndex(io: EvolutionIoLike, home: string): Promise<Map<string, PairIndexEntryV2>>;
-export declare function recordPair(io: EvolutionIoLike, home: string, entry: PairIndexEntryV2): Promise<void>;
-//# sourceMappingURL=pair-index-store.d.ts.map

package/lib/types/domain/pair-index-store.js

@@ -1,25 +0,0 @@
-/** Durable pairKey index at <home>/merge/pair-index.json. */
-import { join } from 'node:path';
-import { transactIo } from '@lmzhen/dsh-evolution-core';
-import { parsePairIndex, serializePairIndex } from "./pair-index.js";
-export function pairIndexPath(home) {
-    return join(home, 'merge', 'pair-index.json');
-}
-export async function loadPairIndex(io, home) {
-    let raw = null;
-    try {
-        raw = await io.readText(pairIndexPath(home));
-    }
-    catch {
-        return new Map();
-    }
-    return parsePairIndex(raw);
-}
-export async function recordPair(io, home, entry) {
-    await transactIo(io, pairIndexPath(home), (current) => {
-        const index = parsePairIndex(current);
-        index.set(entry.pairKey, entry);
-        return serializePairIndex(index);
-    });
-}
-//# sourceMappingURL=pair-index-store.js.map

package/lib/types/domain/pair-index.d.ts

@@ -1,9 +0,0 @@
-/** Pure pairKey index serialization. No IO. */
-import type { PairIndexEntryV2 } from './indexes.ts';
-export interface PairIndexFile {
-    readonly schemaVersion: 1;
-    readonly entries: readonly PairIndexEntryV2[];
-}
-export declare function parsePairIndex(raw: string | null): Map<string, PairIndexEntryV2>;
-export declare function serializePairIndex(index: ReadonlyMap<string, PairIndexEntryV2>): string;
-//# sourceMappingURL=pair-index.d.ts.map

package/lib/types/domain/pair-index.js

@@ -1,28 +0,0 @@
-export function parsePairIndex(raw) {
-    const index = new Map();
-    if (raw === null)
-        return index;
-    let parsed;
-    try {
-        parsed = JSON.parse(raw);
-    }
-    catch {
-        return index;
-    }
-    const body = parsed;
-    if (!Array.isArray(body.entries))
-        return index;
-    for (const value of body.entries) {
-        const entry = value;
-        if (typeof entry.pairKey !== 'string' || typeof entry.runId !== 'string' || typeof entry.result !== 'string')
-            continue;
-        if (!['merged', 'kept', 'failed', 'cancelled', 'undone'].includes(entry.result))
-            continue;
-        index.set(entry.pairKey, entry);
-    }
-    return index;
-}
-export function serializePairIndex(index) {
-    return JSON.stringify({ schemaVersion: 1, entries: [...index.values()] }, null, 2);
-}
-//# sourceMappingURL=pair-index.js.map

package/lib/types/domain/resolve-pair.d.ts

@@ -1,4 +0,0 @@
-/** Pure pair-index lookup. No run-record merge fields. */
-import type { PairIndexEntryV2 } from './indexes.ts';
-export declare function findPairRun(pairs: readonly PairIndexEntryV2[], pairKey: string): PairIndexEntryV2 | undefined;
-//# sourceMappingURL=resolve-pair.d.ts.map

package/lib/types/domain/resolve-pair.js

@@ -1,4 +0,0 @@
-export function findPairRun(pairs, pairKey) {
-    return pairs.find(entry => entry.pairKey === pairKey);
-}
-//# sourceMappingURL=resolve-pair.js.map

package/lib/types/domain/row-tx.d.ts

@@ -1,27 +0,0 @@
-/** G3-5 RowTx pure write API: only createVerify/createSkipped/transition. */
-import { type SkippedRowV3, type V3Event, type V3Row, type VerifyRowV3 } from './row-v3.ts';
-export type RowWrite = {
-    readonly kind: 'createVerify';
-    readonly row: VerifyRowV3;
-} | {
-    readonly kind: 'createSkipped';
-    readonly row: SkippedRowV3;
-} | {
-    readonly kind: 'transition';
-    readonly id: string;
-    readonly event: V3Event;
-    readonly expectedVersion: number;
-};
-type RowWriteErrorCode = 'row-invalid' | 'row-duplicate' | 'row-not-found' | 'version-conflict' | 'illegal-transition';
-export type RowWriteResult = {
-    readonly ok: true;
-    readonly rows: readonly V3Row[];
-    readonly row: V3Row | null;
-} | {
-    readonly ok: false;
-    readonly code: RowWriteErrorCode;
-    readonly message: string;
-};
-export declare function applyRowWrite(rows: readonly V3Row[], write: RowWrite, at: string): RowWriteResult;
-export {};
-//# sourceMappingURL=row-tx.d.ts.map

package/lib/types/domain/row-tx.js

@@ -1,31 +0,0 @@
-/** G3-5 RowTx pure write API: only createVerify/createSkipped/transition. */
-import { isV3Row, transitionV3 } from "./row-v3.js";
-function bad(code, message) { return { ok: false, code, message }; }
-export function applyRowWrite(rows, write, at) {
-    if (write.kind === 'transition') {
-        const index = rows.findIndex(row => row.id === write.id);
-        if (index < 0)
-            return bad('row-not-found', 'row not found: ' + write.id);
-        const current = rows[index];
-        const moved = transitionV3(current, write.event, write.expectedVersion, at);
-        if (!moved.ok)
-            return bad(moved.code, moved.message);
-        if (moved.row === null)
-            return { ok: true, rows: rows.filter((_, atIndex) => atIndex !== index), row: null };
-        const next = [...rows];
-        next[index] = moved.row;
-        return { ok: true, rows: next, row: moved.row };
-    }
-    if (write.row.version !== 0)
-        return bad('row-invalid', 'create requires version 0');
-    if (write.kind === 'createVerify' && (write.row.state !== 'verify' || write.row.verifySubState !== 'unverified'))
-        return bad('row-invalid', 'createVerify requires verify/unverified');
-    if (write.kind === 'createSkipped' && write.row.state !== 'skipped')
-        return bad('row-invalid', 'createSkipped requires skipped');
-    if (!isV3Row(write.row))
-        return bad('row-invalid', 'created row is invalid');
-    if (rows.some(row => row.id === write.row.id))
-        return bad('row-duplicate', 'duplicate row id: ' + write.row.id);
-    return { ok: true, rows: [...rows, write.row], row: write.row };
-}
-//# sourceMappingURL=row-tx.js.map

package/lib/types/domain/run-record.d.ts

@@ -1,45 +0,0 @@
-/** Pure RunRecord v2 types and derived 9-state projection. No IO. */
-export type RunStatus = 'running' | 'succeeded' | 'failed' | 'cancelled' | 'interrupted' | 'orphan';
-export type MergeStatus = 'running' | 'succeeded' | 'failed' | 'cancelled' | 'awaiting-approval' | 'undone' | 'superseded' | 'interrupted' | 'orphan';
-export type PairResult = 'pending' | 'merged' | 'kept' | 'failed' | 'cancelled' | 'undone';
-export interface PairRecord {
-    readonly pairKey: string;
-    readonly a: string;
-    readonly b: string;
-    readonly result: PairResult;
-    readonly target?: {
-        readonly requested: string;
-        readonly actual?: string;
-        readonly created?: boolean;
-    };
-    readonly stagingRef?: string;
-    readonly committed?: boolean;
-}
-export interface PairIndexEntry {
-    readonly pairKey: string;
-    readonly runId: string;
-    readonly result: PairResult;
-    readonly target?: string;
-    readonly reportRef?: string;
-}
-export interface RunRecordV2 {
-    readonly id: string;
-    readonly kind: 'merge';
-    readonly status: RunStatus;
-    readonly stage?: 'screening' | 'decide' | 'author' | 'commit' | 'settle';
-    readonly approval?: 'on' | 'off';
-    readonly parentRunId?: string;
-    readonly pairKey?: string;
-    readonly plane?: 'local' | 'foreign';
-    readonly startedAt: number;
-    readonly updatedAt: number;
-    readonly endedAt?: number;
-    readonly resultRef?: string;
-    readonly failure?: string;
-    readonly stagingRef?: string;
-    readonly pairs: readonly PairRecord[];
-    readonly supersededAt?: number;
-}
-export declare function deriveMergeStatus(record: RunRecordV2): MergeStatus;
-export declare function allCommittedUndone(record: RunRecordV2): boolean;
-//# sourceMappingURL=run-record.d.ts.map

package/lib/types/domain/run-record.js

@@ -1,24 +0,0 @@
-export function deriveMergeStatus(record) {
-    if (record.supersededAt !== undefined)
-        return 'superseded';
-    if (record.status === 'interrupted')
-        return 'interrupted';
-    if (record.status === 'orphan')
-        return 'orphan';
-    if (record.status === 'failed' || record.status === 'cancelled')
-        return record.status;
-    if (record.status === 'running') {
-        return record.approval === 'on' && record.pairs.some(pair => pair.result === 'pending')
-            ? 'awaiting-approval'
-            : 'running';
-    }
-    const committed = record.pairs.filter(pair => pair.committed === true);
-    if (committed.length > 0 && committed.every(pair => pair.result === 'undone'))
-        return 'undone';
-    return 'succeeded';
-}
-export function allCommittedUndone(record) {
-    const committed = record.pairs.filter(pair => pair.committed === true);
-    return committed.length > 0 && committed.every(pair => pair.result === 'undone');
-}
-//# sourceMappingURL=run-record.js.map

package/lib/types/domain/state-v3.d.ts

@@ -1,4 +0,0 @@
-/** G3 schema-3 migration path constants; the only production gate is state-bootstrap. */
-import { v2BackupPath } from './state-bootstrap.ts';
-export { v2BackupPath };
-//# sourceMappingURL=state-v3.d.ts.map

package/lib/types/domain/state-v3.js

@@ -1,4 +0,0 @@
-/** G3 schema-3 migration path constants; the only production gate is state-bootstrap. */
-import { v2BackupPath } from "./state-bootstrap.js";
-export { v2BackupPath };
-//# sourceMappingURL=state-v3.js.map