@rpamis/comet 0.4.0-beta.6 → 0.4.0-beta.8

package/dist/domains/comet-native/native-trajectory-recovery.js

@@ -0,0 +1,133 @@
+import { createHash } from 'crypto';
+import path from 'path';
+import { NATIVE_RUN_STORAGE } from '../engine/storage-layout.js';
+import { withNativeMutationLock } from './native-mutation-lock.js';
+import { isInsidePath, resolveContainedNativePath } from './native-paths.js';
+import { readNativeTrajectoryText, replaceNativeTrajectoryText } from './native-run-store.js';
+const CHANGE_NAME_PATTERN = /^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/u;
+export class NativeTrajectoryRepairRequiredError extends Error {
+    inspection;
+    code = 'native-trajectory-tail-repair-required';
+    constructor(inspection) {
+        super(inspection.status === 'repairable'
+            ? `Native trajectory has an incomplete final line at ${inspection.file}:${inspection.line}; run doctor --repair`
+            : `Native trajectory is invalid at ${inspection.file}:${inspection.line}: ${inspection.message}`);
+        this.inspection = inspection;
+        this.name = 'NativeTrajectoryRepairRequiredError';
+    }
+}
+function sha256Buffer(value) {
+    return createHash('sha256').update(value).digest('hex');
+}
+function trajectoryFile(paths, name) {
+    if (!CHANGE_NAME_PATTERN.test(name))
+        throw new Error(`Invalid Native change name: ${name}`);
+    const changeDir = path.join(paths.changesDir, name);
+    if (!isInsidePath(paths.changesDir, changeDir))
+        throw new Error('Native change path escaped');
+    return path.join(changeDir, 'runtime', 'trajectory.jsonl');
+}
+function parseCompleteLines(content) {
+    const lines = content.split(/\n/u);
+    let count = 0;
+    for (let index = 0; index < lines.length; index += 1) {
+        const line = lines[index].endsWith('\r') ? lines[index].slice(0, -1) : lines[index];
+        if (line.length === 0)
+            continue;
+        count = index + 1;
+        try {
+            JSON.parse(line);
+        }
+        catch (error) {
+            return { status: 'invalid', line: index + 1, message: error.message };
+        }
+    }
+    return { status: 'valid', count };
+}
+function looksTruncated(error, content) {
+    if (/Unexpected end|Unterminated string/iu.test(error.message))
+        return true;
+    const position = /position (\d+)/iu.exec(error.message)?.[1];
+    return position !== undefined && Number(position) >= Math.max(0, content.length - 1);
+}
+function analyzeTrajectory(file, source) {
+    const lastNewline = source.lastIndexOf(0x0a);
+    const prefix = source.subarray(0, lastNewline + 1);
+    const complete = parseCompleteLines(prefix.toString('utf8'));
+    if (complete.status === 'invalid') {
+        return { status: 'invalid', file, line: complete.line, message: complete.message };
+    }
+    if (lastNewline === source.length - 1)
+        return { status: 'clean', file };
+    const tail = source.subarray(lastNewline + 1);
+    const tailText = tail.toString('utf8');
+    const line = complete.count + 1;
+    let reason;
+    let target;
+    try {
+        JSON.parse(tailText.endsWith('\r') ? tailText.slice(0, -1) : tailText);
+        reason = 'missing-newline';
+        target = Buffer.concat([source, Buffer.from('\n')]);
+    }
+    catch (error) {
+        if (!looksTruncated(error, tailText)) {
+            return { status: 'invalid', file, line, message: error.message };
+        }
+        reason = 'incomplete-json';
+        target = prefix;
+    }
+    const inspection = {
+        status: 'repairable',
+        file,
+        reason,
+        line,
+        originalHash: sha256Buffer(source),
+        targetHash: sha256Buffer(target),
+        tailHash: sha256Buffer(tail),
+        discardedBytes: reason === 'incomplete-json' ? tail.length : 0,
+    };
+    return { inspection, targetContent: target.toString('utf8') };
+}
+async function inspectFile(paths, name) {
+    const file = trajectoryFile(paths, name);
+    await resolveContainedNativePath(paths.nativeRoot, file);
+    const changeDir = path.join(paths.changesDir, name);
+    const content = await readNativeTrajectoryText(changeDir, NATIVE_RUN_STORAGE.trajectoryRef);
+    return content === null
+        ? { status: 'clean', file }
+        : analyzeTrajectory(file, Buffer.from(content));
+}
+export async function inspectNativeTrajectoryTail(paths, name) {
+    const result = await inspectFile(paths, name);
+    return 'inspection' in result ? result.inspection : result;
+}
+export async function assertNativeTrajectoryHealthy(paths, name) {
+    const inspection = await inspectNativeTrajectoryTail(paths, name);
+    if (inspection.status !== 'clean')
+        throw new NativeTrajectoryRepairRequiredError(inspection);
+}
+export async function repairNativeTrajectoryTail(paths, name, hooks) {
+    return withNativeMutationLock(paths, `repair trajectory tail for ${name}`, async () => {
+        const result = await inspectFile(paths, name);
+        if (!('inspection' in result)) {
+            if (result.status === 'clean')
+                return null;
+            throw new NativeTrajectoryRepairRequiredError(result);
+        }
+        try {
+            await replaceNativeTrajectoryText(path.join(paths.changesDir, name), NATIVE_RUN_STORAGE.trajectoryRef, result.targetContent, result.inspection.originalHash, { beforeCommit: hooks?.beforeCommit });
+        }
+        catch (error) {
+            if (/changed (?:before|while)/iu.test(error.message)) {
+                throw new Error(`Native trajectory changed while preparing tail repair for ${name}; inspect it again before retrying`, { cause: error });
+            }
+            throw error;
+        }
+        const repaired = await inspectNativeTrajectoryTail(paths, name);
+        if (repaired.status !== 'clean') {
+            throw new Error(`Native trajectory tail repair did not produce a clean file for ${name}`);
+        }
+        return result.inspection;
+    });
+}
+//# sourceMappingURL=native-trajectory-recovery.js.map

package/dist/domains/comet-native/native-trajectory-recovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-trajectory-recovery.js","sourceRoot":"","sources":["../../../domains/comet-native/native-trajectory-recovery.ts"],"names":[],"mappings":"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"}

package/dist/domains/comet-native/native-trajectory.d.ts

@@ -0,0 +1,16 @@
+import type { Checkpoint, RunState, TrajectoryEvent } from '../engine/types.js';
+export declare function appendNativeTrajectoryEvent(options: {
+    changeDir: string;
+    run: RunState;
+    type: TrajectoryEvent['type'];
+    data: Record<string, unknown>;
+    now?: Date;
+}): Promise<TrajectoryEvent>;
+export declare function writeNativeCheckpoint(options: {
+    changeDir: string;
+    run: RunState;
+    trajectoryOffset: number;
+    evidenceHash: string;
+    now?: Date;
+}): Promise<Checkpoint>;
+//# sourceMappingURL=native-trajectory.d.ts.map

package/dist/domains/comet-native/native-trajectory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-trajectory.d.ts","sourceRoot":"","sources":["../../../domains/comet-native/native-trajectory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAQhF,wBAAsB,2BAA2B,CAAC,OAAO,EAAE;IACzD,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,QAAQ,CAAC;IACd,IAAI,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ,GAAG,OAAO,CAAC,eAAe,CAAC,CAW3B;AAED,wBAAsB,qBAAqB,CAAC,OAAO,EAAE;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,QAAQ,CAAC;IACd,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,IAAI,CAAC;CACZ,GAAG,OAAO,CAAC,UAAU,CAAC,CAWtB"}

package/dist/domains/comet-native/native-trajectory.js

@@ -0,0 +1,27 @@
+import { sha256Text } from './native-hash.js';
+import { appendNativeTrajectory, readNativeTrajectory, writeNativeCheckpoint as persistNativeRunCheckpoint, } from './native-run-store.js';
+export async function appendNativeTrajectoryEvent(options) {
+    const trajectory = await readNativeTrajectory(options.changeDir, options.run.trajectoryRef);
+    const event = {
+        sequence: trajectory.length + 1,
+        timestamp: (options.now ?? new Date()).toISOString(),
+        type: options.type,
+        runId: options.run.runId,
+        data: options.data,
+    };
+    await appendNativeTrajectory(options.changeDir, options.run.trajectoryRef, event);
+    return event;
+}
+export async function writeNativeCheckpoint(options) {
+    const checkpoint = {
+        runId: options.run.runId,
+        stateVersion: options.run.iteration,
+        trajectoryOffset: options.trajectoryOffset,
+        contextHash: null,
+        artifactsHash: sha256Text(options.evidenceHash),
+        createdAt: (options.now ?? new Date()).toISOString(),
+    };
+    await persistNativeRunCheckpoint(options.changeDir, options.run.checkpointRef, checkpoint);
+    return checkpoint;
+}
+//# sourceMappingURL=native-trajectory.js.map

package/dist/domains/comet-native/native-trajectory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-trajectory.js","sourceRoot":"","sources":["../../../domains/comet-native/native-trajectory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,qBAAqB,IAAI,0BAA0B,GACpD,MAAM,uBAAuB,CAAC;AAE/B,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAAC,OAMjD;IACC,MAAM,UAAU,GAAG,MAAM,oBAAoB,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;IAC5F,MAAM,KAAK,GAAoB;QAC7B,QAAQ,EAAE,UAAU,CAAC,MAAM,GAAG,CAAC;QAC/B,SAAS,EAAE,CAAC,OAAO,CAAC,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE;QACpD,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,KAAK;QACxB,IAAI,EAAE,OAAO,CAAC,IAAI;KACnB,CAAC;IACF,MAAM,sBAAsB,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;IAClF,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,OAM3C;IACC,MAAM,UAAU,GAAe;QAC7B,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,KAAK;QACxB,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,SAAS;QACnC,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;QAC1C,WAAW,EAAE,IAAI;QACjB,aAAa,EAAE,UAAU,CAAC,OAAO,CAAC,YAAY,CAAC;QAC/C,SAAS,EAAE,CAAC,OAAO,CAAC,GAAG,IAAI,IAAI,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE;KACrD,CAAC;IACF,MAAM,0BAA0B,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC;IAC3F,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/domains/comet-native/native-transaction.d.ts

@@ -0,0 +1,45 @@
+import { type NativeProtectedFileHooks } from './native-protected-file.js';
+import type { NativeProjectPaths, NativeTransactionEvent, NativeTransactionHooks, NativeTransactionJournal, NativeTransactionStatus } from './native-types.js';
+export interface NativeTransactionReadOptions {
+    hooks?: NativeProtectedFileHooks;
+}
+export interface NativeArchiveTransactionOperationV2 {
+    id: string;
+    type: 'write' | 'remove' | 'move';
+    source?: string;
+    target: string;
+    staged?: string;
+    backup?: string;
+    expectedSourceHash?: string;
+    expectedTargetHash: string | null;
+    stagedHash?: string;
+}
+export interface NativeArchiveTransactionJournalV2 {
+    schema: 'comet.native.transaction.v2';
+    id: string;
+    kind: 'archive';
+    status: NativeTransactionStatus;
+    change: string;
+    createdAt: string;
+    preflightHash: string;
+    operations: NativeArchiveTransactionOperationV2[];
+}
+export declare function parseNativeArchiveTransactionJournalV2(value: unknown): NativeArchiveTransactionJournalV2;
+export declare function nativeTransactionPaths(paths: NativeProjectPaths, id: string): {
+    directory: string;
+    journal: string;
+    events: string;
+    staged: string;
+    backups: string;
+};
+export declare function resolveNativeTransactionPaths(paths: NativeProjectPaths, id: string): Promise<ReturnType<typeof nativeTransactionPaths>>;
+export declare function appendNativeTransactionEvent(paths: NativeProjectPaths, id: string, type: NativeTransactionEvent['type'], operationId?: string): Promise<NativeTransactionEvent>;
+export declare function createNativeTransaction(paths: NativeProjectPaths, journal: NativeTransactionJournal): Promise<void>;
+export declare function readNativeTransaction(paths: NativeProjectPaths, id: string, options?: NativeTransactionReadOptions): Promise<NativeTransactionJournal>;
+export declare function readNativeTransactionEvents(paths: NativeProjectPaths, id: string, options?: NativeTransactionReadOptions): Promise<NativeTransactionEvent[]>;
+export declare function setNativeTransactionStatus(paths: NativeProjectPaths, journal: NativeTransactionJournal, status: NativeTransactionStatus): Promise<NativeTransactionJournal>;
+export declare function applyNativeTransaction(paths: NativeProjectPaths, journal: NativeTransactionJournal, hooks?: NativeTransactionHooks): Promise<NativeTransactionJournal>;
+export declare function rollbackNativeTransaction(paths: NativeProjectPaths, journal: NativeTransactionJournal): Promise<NativeTransactionJournal>;
+export declare function finalizeNativeTransaction(paths: NativeProjectPaths, journal: NativeTransactionJournal, event: 'archive-finalization-started' | 'archive-finalized' | 'commit'): Promise<NativeTransactionJournal>;
+export declare function nativeRootRef(paths: NativeProjectPaths, target: string): string;
+//# sourceMappingURL=native-transaction.d.ts.map

package/dist/domains/comet-native/native-transaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-transaction.d.ts","sourceRoot":"","sources":["../../../domains/comet-native/native-transaction.ts"],"names":[],"mappings":"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"}