ds4-context-core 0.3.0-alpha.4 → 0.3.0-beta.1

package/dist/persistence/database-client-lease.js

@@ -0,0 +1,274 @@
+import { randomUUID } from "node:crypto";
+import { chmodSync, closeSync, existsSync, fsyncSync, mkdirSync, openSync, readFileSync, readdirSync, unlinkSync, writeFileSync, } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { sha256 } from "../shared/hash.js";
+const LEASE_PROTOCOL = "ds4-context-database-client-v1";
+const MAINTENANCE_PROTOCOL = "ds4-context-database-maintenance-v1";
+export class DatabaseProtocolError extends Error {
+    category;
+    constructor(category) {
+        super(`Database protocol refused the operation (category=${category})`);
+        this.category = category;
+        this.name = "DatabaseProtocolError";
+    }
+}
+export function databaseProtocolPaths(databasePath) {
+    return {
+        clientsDirectory: `${databasePath}.clients`,
+        maintenanceLock: `${databasePath}.maintenance.lock`,
+        maintenanceState: `${databasePath}.maintenance-state.json`,
+    };
+}
+export function databasePathFingerprint(databasePath) {
+    return sha256(resolve(databasePath));
+}
+function bestEffortChmod(path, mode) {
+    try {
+        chmodSync(path, mode);
+    }
+    catch (error) {
+        const code = error && typeof error === "object" && "code" in error ? String(error.code) : "";
+        if (code !== "ENOSYS" && code !== "EPERM" && code !== "EINVAL")
+            throw error;
+    }
+}
+function fsyncDirectory(path) {
+    let descriptor;
+    try {
+        descriptor = openSync(path, "r");
+        fsyncSync(descriptor);
+    }
+    catch (error) {
+        const code = error && typeof error === "object" && "code" in error ? String(error.code) : "";
+        if (code !== "EINVAL" && code !== "ENOTSUP" && code !== "EBADF" && code !== "EPERM")
+            throw error;
+    }
+    finally {
+        if (descriptor !== undefined)
+            closeSync(descriptor);
+    }
+}
+function writeExclusiveJson(path, value) {
+    const descriptor = openSync(path, "wx", 0o600);
+    try {
+        writeFileSync(descriptor, `${JSON.stringify(value)}\n`, "utf8");
+        fsyncSync(descriptor);
+    }
+    finally {
+        closeSync(descriptor);
+    }
+    bestEffortChmod(path, 0o600);
+    fsyncDirectory(dirname(path));
+}
+function parseJsonFile(path) {
+    return JSON.parse(readFileSync(path, "utf8"));
+}
+function isSafePid(value) {
+    return typeof value === "number" && Number.isSafeInteger(value) && value > 0;
+}
+function isBoundedIdentifier(value) {
+    return typeof value === "string" && /^[a-z0-9][a-z0-9._-]{0,127}$/iu.test(value);
+}
+function parseClientLease(value) {
+    if (!value || typeof value !== "object")
+        return undefined;
+    const record = value;
+    if (record.protocol !== LEASE_PROTOCOL
+        || !isBoundedIdentifier(record.clientId)
+        || !isSafePid(record.pid)
+        || !Number.isSafeInteger(record.createdAt)
+        || typeof record.databaseFingerprint !== "string"
+        || !/^[a-f0-9]{64}$/u.test(record.databaseFingerprint))
+        return undefined;
+    return record;
+}
+function parseMaintenanceLock(value) {
+    if (!value || typeof value !== "object")
+        return undefined;
+    const record = value;
+    if (record.protocol !== MAINTENANCE_PROTOCOL
+        || !isBoundedIdentifier(record.ownerId)
+        || !isSafePid(record.pid)
+        || !Number.isSafeInteger(record.createdAt)
+        || typeof record.databaseFingerprint !== "string"
+        || !/^[a-f0-9]{64}$/u.test(record.databaseFingerprint))
+        return undefined;
+    return record;
+}
+export function probeProcess(pid) {
+    try {
+        process.kill(pid, 0);
+        return "alive";
+    }
+    catch (error) {
+        const code = error && typeof error === "object" && "code" in error ? String(error.code) : "";
+        if (code === "ESRCH")
+            return "dead";
+        return "ambiguous";
+    }
+}
+function scanClientLeases(databasePath, processProbe) {
+    const paths = databaseProtocolPaths(databasePath);
+    if (!existsSync(paths.clientsDirectory))
+        return { active: 0, staleRemoved: 0, ambiguous: 0 };
+    const fingerprint = databasePathFingerprint(databasePath);
+    let active = 0;
+    let staleRemoved = 0;
+    let ambiguous = 0;
+    for (const name of readdirSync(paths.clientsDirectory).sort()) {
+        if (!name.endsWith(".json")) {
+            ambiguous++;
+            continue;
+        }
+        const path = `${paths.clientsDirectory}/${name}`;
+        let record;
+        try {
+            record = parseClientLease(parseJsonFile(path));
+        }
+        catch {
+            record = undefined;
+        }
+        if (!record || record.databaseFingerprint !== fingerprint) {
+            ambiguous++;
+            continue;
+        }
+        const status = processProbe(record.pid);
+        if (status === "alive") {
+            active++;
+        }
+        else if (status === "ambiguous") {
+            ambiguous++;
+        }
+        else {
+            try {
+                unlinkSync(path);
+                staleRemoved++;
+            }
+            catch {
+                ambiguous++;
+            }
+        }
+    }
+    if (staleRemoved > 0)
+        fsyncDirectory(paths.clientsDirectory);
+    return { active, staleRemoved, ambiguous };
+}
+export function createDatabaseClientLease(databasePath, options = {}) {
+    const paths = databaseProtocolPaths(databasePath);
+    if (existsSync(paths.maintenanceLock))
+        throw new DatabaseProtocolError("maintenance-active");
+    mkdirSync(paths.clientsDirectory, { recursive: true, mode: 0o700 });
+    bestEffortChmod(paths.clientsDirectory, 0o700);
+    const clientId = options.clientId ?? randomUUID();
+    if (!isBoundedIdentifier(clientId))
+        throw new DatabaseProtocolError("invalid-client-id");
+    const record = {
+        protocol: LEASE_PROTOCOL,
+        clientId,
+        pid: options.pid ?? process.pid,
+        createdAt: options.createdAt ?? Date.now(),
+        databaseFingerprint: databasePathFingerprint(databasePath),
+    };
+    if (!isSafePid(record.pid) || !Number.isSafeInteger(record.createdAt)) {
+        throw new DatabaseProtocolError("invalid-client-metadata");
+    }
+    const leasePath = `${paths.clientsDirectory}/${clientId}.json`;
+    try {
+        writeExclusiveJson(leasePath, record);
+    }
+    catch (error) {
+        const code = error && typeof error === "object" && "code" in error ? String(error.code) : "";
+        throw new DatabaseProtocolError(code === "EEXIST" ? "client-id-conflict" : "lease-create-failed");
+    }
+    let released = false;
+    const release = () => {
+        if (released)
+            return;
+        released = true;
+        try {
+            const current = parseClientLease(parseJsonFile(leasePath));
+            if (current?.clientId === clientId) {
+                unlinkSync(leasePath);
+                fsyncDirectory(paths.clientsDirectory);
+            }
+        }
+        catch {
+            // Idempotent release never removes an unverified replacement lease.
+        }
+    };
+    if (existsSync(paths.maintenanceLock)) {
+        release();
+        throw new DatabaseProtocolError("maintenance-active");
+    }
+    return { clientId, path: leasePath, release };
+}
+function removeVerifiedStaleMaintenanceLock(databasePath, processProbe) {
+    const path = databaseProtocolPaths(databasePath).maintenanceLock;
+    let record;
+    try {
+        record = parseMaintenanceLock(parseJsonFile(path));
+    }
+    catch {
+        record = undefined;
+    }
+    if (!record
+        || record.databaseFingerprint !== databasePathFingerprint(databasePath)
+        || processProbe(record.pid) !== "dead") {
+        throw new DatabaseProtocolError("maintenance-lock-active-or-ambiguous");
+    }
+    unlinkSync(path);
+    fsyncDirectory(dirname(path));
+}
+export function acquireDatabaseMaintenanceLock(databasePath, options = {}) {
+    const paths = databaseProtocolPaths(databasePath);
+    mkdirSync(dirname(databasePath), { recursive: true, mode: 0o700 });
+    const processProbe = options.processProbe ?? probeProcess;
+    if (existsSync(paths.maintenanceLock)) {
+        if (!options.replaceStaleLock)
+            throw new DatabaseProtocolError("maintenance-lock-exists");
+        removeVerifiedStaleMaintenanceLock(databasePath, processProbe);
+    }
+    const ownerId = options.ownerId ?? randomUUID();
+    if (!isBoundedIdentifier(ownerId))
+        throw new DatabaseProtocolError("invalid-owner-id");
+    const record = {
+        protocol: MAINTENANCE_PROTOCOL,
+        ownerId,
+        pid: options.pid ?? process.pid,
+        createdAt: options.createdAt ?? Date.now(),
+        databaseFingerprint: databasePathFingerprint(databasePath),
+    };
+    if (!isSafePid(record.pid) || !Number.isSafeInteger(record.createdAt)) {
+        throw new DatabaseProtocolError("invalid-owner-metadata");
+    }
+    try {
+        writeExclusiveJson(paths.maintenanceLock, record);
+    }
+    catch (error) {
+        const code = error && typeof error === "object" && "code" in error ? String(error.code) : "";
+        throw new DatabaseProtocolError(code === "EEXIST" ? "maintenance-lock-exists" : "maintenance-lock-create-failed");
+    }
+    let released = false;
+    const release = () => {
+        if (released)
+            return;
+        released = true;
+        try {
+            const current = parseMaintenanceLock(parseJsonFile(paths.maintenanceLock));
+            if (current?.ownerId === ownerId) {
+                unlinkSync(paths.maintenanceLock);
+                fsyncDirectory(dirname(paths.maintenanceLock));
+            }
+        }
+        catch {
+            // Never unlink an unverified lock owned by another process.
+        }
+    };
+    const clients = scanClientLeases(databasePath, processProbe);
+    if (clients.active > 0 || clients.ambiguous > 0) {
+        release();
+        throw new DatabaseProtocolError(clients.active > 0 ? "active-database-clients" : "ambiguous-database-clients");
+    }
+    return { ownerId, path: paths.maintenanceLock, clients, release };
+}
+//# sourceMappingURL=database-client-lease.js.map

package/dist/persistence/database-client-lease.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"database-client-lease.js","sourceRoot":"","sources":["../../src/persistence/database-client-lease.ts"],"names":[],"mappings":"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"}

package/dist/persistence/repositories/context-manifest-repository.d.ts

@@ -1,21 +1,41 @@
 import type { DatabaseSync } from "node:sqlite";
 import type { TokenCalibrationSample } from "../../core/model-awareness.ts";
-import { SqliteWriteCoordinator } from "../write-coordinator.ts";
 import type { ContextManifest } from "../../manifest/context-manifest.ts";
+import { type ManifestSaveResult, type StoredContextManifest } from "../../manifest/context-manifest-storage.ts";
+import { SqliteWriteCoordinator } from "../write-coordinator.ts";
+export declare const MAX_RETAINED_CONTEXT_MANIFESTS = 128;
+export declare const MAX_RETAINED_CALIBRATION_SAMPLES_PER_PROFILE = 200;
+export declare const RETENTION_PRUNE_BATCH_ROWS = 32;
+export declare const RETENTION_PRUNE_BATCH_BYTES: number;
+export declare const CALIBRATION_PRUNE_BATCH_ROWS = 32;
 export interface ProviderTokenUsage {
     inputTokens: number;
     cacheReadTokens: number;
     cacheWriteTokens: number;
 }
+export interface ManifestMaintenanceResult {
+    prunedManifests: number;
+    prunedManifestBytes: number;
+    prunedCalibrationSamples: number;
+    rewrittenManifests: number;
+    rolledUpManifests: number;
+    skippedOversizeManifests: number;
+}
 export declare class ContextManifestRepository {
     private readonly database;
     private readonly writes;
     constructor(database: DatabaseSync, writes?: SqliteWriteCoordinator);
-    save(manifest: ContextManifest): void;
+    save(manifest: ContextManifest): ManifestSaveResult;
     get(manifestId: string): ContextManifest | undefined;
+    getStored(manifestId: string): StoredContextManifest | undefined;
     getLatest(sessionId: string): ContextManifest | undefined;
-    recordProviderUsage(manifestId: string, usage: ProviderTokenUsage, createdAt: number): ContextManifest | undefined;
-    recordActualInput(manifestId: string, actualInputTokens: number, createdAt: number): ContextManifest | undefined;
+    getLatestStored(sessionId: string): StoredContextManifest | undefined;
+    recordProviderUsage(manifestId: string, usage: ProviderTokenUsage, createdAt: number, estimatorVersion?: string): ContextManifest | undefined;
+    recordActualInput(manifestId: string, actualInputTokens: number, createdAt: number, estimatorVersion?: string): ContextManifest | undefined;
+    /** Applies unbounded retention only to an explicitly selected offline working copy. */
+    applyMaintenanceRetention(): ManifestMaintenanceResult;
     listCalibrationSamples(provider: string, model: string, limit: number, estimatorVersion?: string): TokenCalibrationSample[];
+    private pruneContextManifests;
+    private pruneCalibrationSamples;
 }
 //# sourceMappingURL=context-manifest-repository.d.ts.map

package/dist/persistence/repositories/context-manifest-repository.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context-manifest-repository.d.ts","sourceRoot":"","sources":["../../../src/persistence/repositories/context-manifest-repository.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAC5E,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,KAAK,EACV,eAAe,EAEhB,MAAM,oCAAoC,CAAC;AAgB5C,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAiBD,qBAAa,yBAAyB;IAElC,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBADN,QAAQ,EAAE,YAAY,EACtB,MAAM,yBAAuC;IAGhE,IAAI,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI;IA2CrC,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAOpD,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAWzD,mBAAmB,CACjB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,kBAAkB,EACzB,SAAS,EAAE,MAAM,GAChB,eAAe,GAAG,SAAS;IAkE9B,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAQhH,sBAAsB,CACpB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,gBAAgB,SAAa,GAC5B,sBAAsB,EAAE;CAmB5B"}
+{"version":3,"file":"context-manifest-repository.d.ts","sourceRoot":"","sources":["../../../src/persistence/repositories/context-manifest-repository.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAC;AAC5E,OAAO,KAAK,EACV,eAAe,EAEhB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAIL,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC3B,MAAM,4CAA4C,CAAC;AACpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AA4CjE,eAAO,MAAM,8BAA8B,MAAM,CAAC;AAClD,eAAO,MAAM,4CAA4C,MAAM,CAAC;AAChE,eAAO,MAAM,0BAA0B,KAAK,CAAC;AAC7C,eAAO,MAAM,2BAA2B,QAAkB,CAAC;AAC3D,eAAO,MAAM,4BAA4B,KAAK,CAAC;AAE/C,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,yBAAyB;IACxC,eAAe,EAAE,MAAM,CAAC;IACxB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,wBAAwB,EAAE,MAAM,CAAC;IACjC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,wBAAwB,EAAE,MAAM,CAAC;CAClC;AAoCD,qBAAa,yBAAyB;IAElC,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBADN,QAAQ,EAAE,YAAY,EACtB,MAAM,yBAAuC;IAGhE,IAAI,CAAC,QAAQ,EAAE,eAAe,GAAG,kBAAkB;IAqEnD,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAIpD,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,qBAAqB,GAAG,SAAS;IAQhE,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS;IAIzD,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,qBAAqB,GAAG,SAAS;IAWrE,mBAAmB,CACjB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,kBAAkB,EACzB,SAAS,EAAE,MAAM,EACjB,gBAAgB,SAAa,GAC5B,eAAe,GAAG,SAAS;IA6D9B,iBAAiB,CACf,UAAU,EAAE,MAAM,EAClB,iBAAiB,EAAE,MAAM,EACzB,SAAS,EAAE,MAAM,EACjB,gBAAgB,SAAa,GAC5B,eAAe,GAAG,SAAS;IAQ9B,uFAAuF;IACvF,yBAAyB,IAAI,yBAAyB;IA4FtD,sBAAsB,CACpB,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,gBAAgB,SAAa,GAC5B,sBAAsB,EAAE;IAoB3B,OAAO,CAAC,qBAAqB;IAoC7B,OAAO,CAAC,uBAAuB;CA2BhC"}