devchain-cli 0.23.2 → 0.23.4

package/dist/server/modules/session-reader/services/bounded-anchor-proof.js

@@ -0,0 +1,103 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FILE_ANCHOR_BYTES = void 0;
+exports.anchorsEqual = anchorsEqual;
+exports.hashFileAnchors = hashFileAnchors;
+const node_crypto_1 = require("node:crypto");
+const fs = __importStar(require("node:fs/promises"));
+const FILE_HASH_CHUNK_BYTES = 64 * 1024;
+exports.FILE_ANCHOR_BYTES = 64 * 1024;
+function anchorsEqual(a, b) {
+    return (a !== undefined &&
+        b !== undefined &&
+        a.headDigest === b.headDigest &&
+        a.tailDigest === b.tailDigest);
+}
+async function hashFileAnchors(filePath, expected, offset, allowGrowth = false) {
+    if (!Number.isSafeInteger(offset) ||
+        offset < 0 ||
+        offset > expected.size ||
+        expected.fileIdentity === undefined) {
+        throw new Error('Invalid file anchor bounds');
+    }
+    const handle = await fs.open(filePath, 'r');
+    const assertStableSnapshot = async () => {
+        const current = await handle.stat();
+        const currentIdentity = `${current.dev}:${current.ino}`;
+        if (currentIdentity !== expected.fileIdentity) {
+            throw new Error('File identity changed while computing anchor proof');
+        }
+        if (allowGrowth) {
+            if (current.size < expected.size) {
+                throw new Error('File shrank while computing anchor proof');
+            }
+        }
+        else if (current.size !== expected.size || current.mtime.getTime() !== expected.mtimeMs) {
+            throw new Error('File changed while computing anchor proof');
+        }
+    };
+    try {
+        await assertStableSnapshot();
+        const headLength = Math.min(exports.FILE_ANCHOR_BYTES, offset);
+        const tailStart = Math.max(0, offset - exports.FILE_ANCHOR_BYTES);
+        const headDigest = await hashRange(handle, 0, headLength);
+        const tailDigest = await hashRange(handle, tailStart, offset - tailStart);
+        await assertStableSnapshot();
+        return { headDigest, tailDigest };
+    }
+    finally {
+        await handle.close();
+    }
+}
+async function hashRange(handle, start, length) {
+    const hash = (0, node_crypto_1.createHash)('sha256');
+    if (length <= 0)
+        return hash.digest('hex');
+    const buffer = Buffer.allocUnsafe(Math.min(FILE_HASH_CHUNK_BYTES, length));
+    const end = start + length;
+    let position = start;
+    while (position < end) {
+        const requested = Math.min(buffer.byteLength, end - position);
+        const { bytesRead } = await handle.read(buffer, 0, requested, position);
+        if (bytesRead === 0) {
+            throw new Error('File ended while computing anchor proof');
+        }
+        hash.update(buffer.subarray(0, bytesRead));
+        position += bytesRead;
+    }
+    return hash.digest('hex');
+}
+//# sourceMappingURL=bounded-anchor-proof.js.map

package/dist/server/modules/session-reader/services/bounded-anchor-proof.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bounded-anchor-proof.js","sourceRoot":"","sources":["../../../../src/modules/session-reader/services/bounded-anchor-proof.ts"],"names":[],"mappings":"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"}

package/dist/server/modules/session-reader/services/metrics-merge.d.ts

@@ -0,0 +1,17 @@
+import type { UnifiedMessage, UnifiedMetrics } from '../dtos/unified-session.types';
+import type { TailDescriptor } from '../adapters/session-reader-adapter.interface';
+export type { TailDescriptor };
+export declare function describeTail(message: UnifiedMessage | undefined): TailDescriptor | undefined;
+export interface LeadingContinuationFold {
+    foldCount: number;
+    tailMutatedWithoutNewMessage: boolean;
+    newTail: TailDescriptor | undefined;
+}
+export declare function computeLeadingContinuationFold(tail: TailDescriptor | undefined, newMessages: readonly UnifiedMessage[]): LeadingContinuationFold;
+export interface MergeDerivedInputs {
+    messageCount: number;
+    visibleContextTokens: number;
+    durationMs: number;
+}
+export declare function deriveMergeInputsFromMessages(existing: UnifiedMetrics, allMessages: UnifiedMessage[]): MergeDerivedInputs;
+export declare function mergeMetrics(existing: UnifiedMetrics, incremental: UnifiedMetrics, derived: MergeDerivedInputs): UnifiedMetrics;

package/dist/server/modules/session-reader/services/metrics-merge.js

@@ -0,0 +1,114 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.describeTail = describeTail;
+exports.computeLeadingContinuationFold = computeLeadingContinuationFold;
+exports.deriveMergeInputsFromMessages = deriveMergeInputsFromMessages;
+exports.mergeMetrics = mergeMetrics;
+const estimate_content_tokens_1 = require("../adapters/utils/estimate-content-tokens");
+const tool_result_fold_1 = require("../adapters/utils/tool-result-fold");
+function describeTail(message) {
+    if (!message)
+        return undefined;
+    return {
+        role: message.role,
+        isSidechain: message.isSidechain,
+        stopReason: message.stopReason ?? null,
+        isCompactSummary: message.isCompactSummary ?? false,
+    };
+}
+function computeLeadingContinuationFold(tail, newMessages) {
+    if (!tail || tail.role !== 'assistant' || newMessages.length === 0) {
+        return {
+            foldCount: 0,
+            tailMutatedWithoutNewMessage: false,
+            newTail: newMessages.length > 0 ? describeTail(newMessages[newMessages.length - 1]) : tail,
+        };
+    }
+    let foldCount = 0;
+    let tailStopReason = tail.stopReason;
+    while (foldCount < newMessages.length) {
+        const m = newMessages[foldCount];
+        if (m.isSidechain !== tail.isSidechain)
+            break;
+        if (m.isCompactSummary)
+            break;
+        const isToolResult = (0, tool_result_fold_1.isToolResultOnlyMessage)(m);
+        const isContinuationAssistant = m.role === 'assistant';
+        if (!isToolResult && !isContinuationAssistant)
+            break;
+        if (isContinuationAssistant && tailStopReason === 'end_turn')
+            break;
+        if (isContinuationAssistant)
+            tailStopReason = m.stopReason ?? null;
+        foldCount += 1;
+    }
+    const remaining = newMessages.length - foldCount;
+    const newTail = remaining > 0
+        ? describeTail(newMessages[newMessages.length - 1])
+        :
+            {
+                role: 'assistant',
+                isSidechain: tail.isSidechain,
+                stopReason: tailStopReason,
+                isCompactSummary: false,
+            };
+    return {
+        foldCount,
+        tailMutatedWithoutNewMessage: foldCount > 0 && remaining === 0,
+        newTail,
+    };
+}
+function deriveMergeInputsFromMessages(existing, allMessages) {
+    let durationMs = existing.durationMs;
+    if (allMessages.length >= 2) {
+        durationMs =
+            allMessages[allMessages.length - 1].timestamp.getTime() - allMessages[0].timestamp.getTime();
+    }
+    return {
+        messageCount: allMessages.length,
+        visibleContextTokens: (0, estimate_content_tokens_1.estimateVisibleFromMessages)(allMessages),
+        durationMs,
+    };
+}
+function mergeMetrics(existing, incremental, derived) {
+    const inputTokens = existing.inputTokens + incremental.inputTokens;
+    const outputTokens = existing.outputTokens + incremental.outputTokens;
+    const cacheReadTokens = existing.cacheReadTokens + incremental.cacheReadTokens;
+    const cacheCreationTokens = existing.cacheCreationTokens + incremental.cacheCreationTokens;
+    const totalTokens = inputTokens + outputTokens + cacheReadTokens + cacheCreationTokens;
+    const modelsSet = new Set();
+    if (existing.primaryModel)
+        modelsSet.add(existing.primaryModel);
+    if (incremental.primaryModel)
+        modelsSet.add(incremental.primaryModel);
+    if (existing.modelsUsed)
+        existing.modelsUsed.forEach((m) => modelsSet.add(m));
+    if (incremental.modelsUsed)
+        incremental.modelsUsed.forEach((m) => modelsSet.add(m));
+    const modelsUsed = modelsSet.size > 1 ? Array.from(modelsSet) : undefined;
+    const sliceHasModel = Boolean(incremental.primaryModel);
+    return {
+        inputTokens,
+        outputTokens,
+        cacheReadTokens,
+        cacheCreationTokens,
+        totalTokens,
+        costUsd: existing.costUsd + incremental.costUsd,
+        primaryModel: sliceHasModel ? incremental.primaryModel : existing.primaryModel,
+        modelsUsed,
+        isOngoing: incremental.isOngoing,
+        visibleContextTokens: derived.visibleContextTokens,
+        totalContextTokens: incremental.totalContextTokens > 0
+            ? incremental.totalContextTokens
+            : existing.totalContextTokens,
+        contextWindowTokens: sliceHasModel || !existing.primaryModel
+            ? (incremental.contextWindowTokens ?? existing.contextWindowTokens)
+            : existing.contextWindowTokens,
+        messageCount: derived.messageCount,
+        durationMs: derived.durationMs,
+        totalContextConsumption: existing.totalContextConsumption,
+        compactionCount: existing.compactionCount,
+        phaseBreakdowns: existing.phaseBreakdowns,
+    };
+}
+//# sourceMappingURL=metrics-merge.js.map

package/dist/server/modules/session-reader/services/metrics-merge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics-merge.js","sourceRoot":"","sources":["../../../../src/modules/session-reader/services/metrics-merge.ts"],"names":[],"mappings":"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"}

package/dist/server/modules/session-reader/services/session-cache.service.d.ts

@@ -1,6 +1,7 @@
 import { OnModuleDestroy, OnModuleInit } from '@nestjs/common';
 import type { SessionReaderAdapter, SessionSourceRef } from '../adapters/session-reader-adapter.interface';
 import type { UnifiedSession } from '../dtos/unified-session.types';
+import { type FileContentAnchors } from './bounded-anchor-proof';
 import { MetricsService } from '../../metrics/services/metrics.service';
 import type { CacheStats } from '../../metrics/types/metrics.types';
 import type { UnifiedChunk } from '../dtos/unified-chunk.types';
@@ -33,7 +34,7 @@ export interface SessionCacheEntry {
     lastSize: number;
     lastMtime: number;
     fileIdentity?: string;
-    fileContentDigest?: string;
+    fileContentAnchors?: FileContentAnchors;
     sourceVersion: number;
     freshnessToken: unknown;
     lastAccessedAt: number;
@@ -42,6 +43,7 @@ export interface SessionCacheEntry {
     chunks?: CachedChunks;
     dto?: CachedTranscriptDto;
     boundaryFold: boolean;
+    continuationState?: unknown;
 }
 export type SourceChangeKind = 'cache-hit' | 'same-file-append' | 'file-replacement' | 'file-truncation' | 'same-file-rewrite' | 'db-update' | 'unknown-full-parse';
 export interface GetOrParseResult {
@@ -53,7 +55,25 @@ export interface GetOrParseResult {
     lastMtime: number;
     sourceVersion: number;
     boundaryFold: boolean;
+    fileContentAnchors?: FileContentAnchors;
+    continuationState?: unknown;
 }
+export interface PreParseGeneration {
+    sourceVersion: number;
+    messageCount: number;
+    chunkCount: number;
+}
+export type RefreshIfPresentResult = {
+    present: false;
+    lastFullParse?: {
+        seq: number;
+        durationMs: number;
+    };
+} | {
+    present: true;
+    preParse: PreParseGeneration;
+    result: GetOrParseResult;
+};
 export declare class SessionCacheService implements OnModuleDestroy, OnModuleInit {
     private readonly metricsService;
     private readonly logger;
@@ -68,6 +88,8 @@ export declare class SessionCacheService implements OnModuleDestroy, OnModuleIni
     private dtoMisses;
     private budgetUsedBytes;
     private evictions;
+    private fullParseSeq;
+    private readonly fullParseCosts;
     private idleSweepTimer?;
     private readonly config;
     constructor(metricsService: MetricsService, config?: TranscriptCacheConfig);
@@ -80,10 +102,17 @@ export declare class SessionCacheService implements OnModuleDestroy, OnModuleIni
     getOrParse(sessionId: string, source: string | SessionSourceRef, adapter: SessionReaderAdapter): Promise<UnifiedSession>;
     getOrParseWithMeta(sessionId: string, source: string | SessionSourceRef, adapter: SessionReaderAdapter): Promise<GetOrParseResult>;
     private getOrParseResult;
+    refreshIfPresent(sessionId: string, source: string | SessionSourceRef, adapter: SessionReaderAdapter): Promise<RefreshIfPresentResult>;
+    private resolveIfPresentFlight;
+    private toRefreshResult;
     private startParseFlight;
     private sharedResult;
+    private timedFullParse;
+    private recordFullParse;
     private parseSession;
     getEntry(sessionId: string): SessionCacheEntry | undefined;
+    private preParseGeneration;
+    private preParseFromResult;
     getChunks(sessionId: string, sourceVersion: number): UnifiedChunk[] | undefined;
     setChunks(sessionId: string, sourceVersion: number, chunks: UnifiedChunk[]): void;
     getDto(sessionId: string, maxToolResultLength: number, enrichmentFingerprint: string): CachedTranscriptDto | undefined;
@@ -104,12 +133,12 @@ export declare class SessionCacheService implements OnModuleDestroy, OnModuleIni
     private estimateSourceWeight;
     private withoutDerivedChunks;
     private foldLeadingContinuationIntoCachedTail;
-    private mergeMetrics;
     private mergeWarnings;
     private statFile;
     private classifyUnsafeFileChange;
-    private tryHashFileContent;
-    private hashFileContent;
+    private tryHashFileAnchors;
+    private resolveStoredAnchors;
+    private snapshotEndsOnLineBoundary;
     private toSourceRef;
     private sourceIdentity;
     private computeFreshness;