kiokuko 1.0.0

package/dist/memory/revisions.js

@@ -0,0 +1,409 @@
+import { KiokukoError, storedMemoryIntegrityError } from '../errors.js';
+import { canonicalEntryRevisionContentHash, canonicalJson, ENTRY_STATUSES, requireWorkspace, TRUST_LEVELS, validateRecordInput } from '../serialization/validate.js';
+import { buildStructuredScope, } from './structured-memory.js';
+const SQLITE_CONSTRAINT_PRIMARY_KEY = 1_555;
+const SQLITE_CONSTRAINT_UNIQUE = 2_067;
+const REVISION_UNIQUENESS_FAILURES = new Set([
+    'UNIQUE constraint failed: entry_revisions.entry_id, entry_revisions.revision',
+    'UNIQUE constraint failed: entry_revisions.workspace, entry_revisions.content_hash',
+]);
+function isExpectedRevisionConflict(error) {
+    if (!(error instanceof Error))
+        return false;
+    const failure = error;
+    return failure.code === 'ERR_SQLITE_ERROR'
+        && (failure.errcode === SQLITE_CONSTRAINT_PRIMARY_KEY || failure.errcode === SQLITE_CONSTRAINT_UNIQUE)
+        && REVISION_UNIQUENESS_FAILURES.has(failure.message);
+}
+function storedIntegrity() {
+    throw storedMemoryIntegrityError();
+}
+function isPlainObject(value) {
+    if (typeof value !== 'object' || value === null || Array.isArray(value))
+        return false;
+    const prototype = Object.getPrototypeOf(value);
+    return prototype === Object.prototype || prototype === null;
+}
+function hasOwn(value, field) {
+    return Object.prototype.hasOwnProperty.call(value, field);
+}
+function storedNonEmptyString(value) {
+    if (typeof value !== 'string' || value.trim().length === 0)
+        storedIntegrity();
+    return value;
+}
+function canonicalTimestamp(value) {
+    if (typeof value !== 'string' || !/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$/u.test(value))
+        return false;
+    const milliseconds = Date.parse(value);
+    return Number.isFinite(milliseconds) && new Date(milliseconds).toISOString() === value;
+}
+function parseStoredObject(value) {
+    if (typeof value !== 'string')
+        storedIntegrity();
+    let parsed;
+    try {
+        parsed = JSON.parse(value);
+    }
+    catch (error) {
+        if (error instanceof SyntaxError)
+            storedIntegrity();
+        throw error;
+    }
+    if (!isPlainObject(parsed))
+        storedIntegrity();
+    try {
+        if (canonicalJson(parsed) !== value)
+            storedIntegrity();
+    }
+    catch (error) {
+        if (error instanceof KiokukoError && error.code === 'VALIDATION_ERROR')
+            storedIntegrity();
+        throw error;
+    }
+    return parsed;
+}
+/** Normalize caller-supplied structured scope before it is persisted. */
+export function normalizeStructuredScopeInput(scope) {
+    if (!hasOwn(scope, 'schemaVersion')) {
+        return scope;
+    }
+    const allowed = new Set([
+        'schemaVersion', 'visibility', 'retrievalScope', 'repositoryId', 'memoryClass',
+        'applicability', 'signals', 'portableReason',
+    ]);
+    if (Object.keys(scope).some((field) => !allowed.has(field))) {
+        throw new KiokukoError('VALIDATION_ERROR', 'Structured memory scope contains an unknown field');
+    }
+    if (scope.schemaVersion !== 3) {
+        throw new KiokukoError('VALIDATION_ERROR', 'Structured memory scope schemaVersion is unsupported');
+    }
+    return buildStructuredScope({
+        visibility: scope.visibility,
+        ...(hasOwn(scope, 'retrievalScope') ? { retrievalScope: scope.retrievalScope } : {}),
+        ...(hasOwn(scope, 'repositoryId') ? { repositoryId: scope.repositoryId } : {}),
+        ...(hasOwn(scope, 'memoryClass') ? { memoryClass: scope.memoryClass } : {}),
+        ...(hasOwn(scope, 'applicability') ? { applicability: scope.applicability } : {}),
+        ...(hasOwn(scope, 'signals') ? { signals: scope.signals } : {}),
+        ...(hasOwn(scope, 'portableReason') ? { portableReason: scope.portableReason } : {}),
+    });
+}
+function normalizeStoredStructuredScope(scope, required) {
+    if (required && scope.schemaVersion !== 3)
+        storedIntegrity();
+    try {
+        return normalizeStructuredScopeInput(scope);
+    }
+    catch (error) {
+        if (error instanceof KiokukoError && (error.code === 'VALIDATION_ERROR' || error.code === 'SECURITY_REJECTION'))
+            storedIntegrity();
+        throw error;
+    }
+}
+/** Decode only the canonical persisted structured-scope representation. */
+export function decodeStoredStructuredScope(scope, required = false) {
+    const normalized = normalizeStoredStructuredScope(scope, required);
+    if (canonicalJson(normalized) !== canonicalJson(scope))
+        storedIntegrity();
+    return { scope: normalized, canonicalScope: normalized };
+}
+function normalizedStoredRecord(input, tags, options) {
+    const entryId = storedNonEmptyString(input.entryId);
+    const createdBy = storedNonEmptyString(input.createdBy);
+    const createdAt = storedNonEmptyString(input.createdAt);
+    if (!canonicalTimestamp(createdAt)
+        || !Number.isSafeInteger(input.revision) || Number(input.revision) < 1
+        || input.summary !== null && typeof input.summary !== 'string'
+        || !Array.isArray(tags))
+        storedIntegrity();
+    const decodedScope = decodeStoredStructuredScope(parseStoredObject(input.scopeJson), options.requireStructuredScope === true);
+    const scope = decodedScope.canonicalScope;
+    const provenance = parseStoredObject(input.provenanceJson);
+    let validated;
+    try {
+        validated = validateRecordInput({
+            workspace: input.workspace,
+            kind: input.kind,
+            status: 'candidate',
+            title: input.title,
+            body: input.body,
+            summary: input.summary,
+            scope,
+            provenance,
+            trustLevel: 'user_asserted',
+            confidence: 1,
+            tags,
+            createdBy,
+            actor: createdBy,
+        });
+    }
+    catch (error) {
+        if (error instanceof KiokukoError && (error.code === 'VALIDATION_ERROR' || error.code === 'SECURITY_REJECTION'))
+            storedIntegrity();
+        throw error;
+    }
+    if (validated.tags.length !== tags.length)
+        storedIntegrity();
+    const hashInput = {
+        kind: validated.kind,
+        title: validated.title,
+        body: validated.body,
+        summary: validated.summary,
+        scope: validated.scope,
+        provenance: validated.provenance,
+        tags: validated.tags,
+    };
+    const contentHash = canonicalEntryRevisionContentHash(hashInput);
+    if (input.contentHash !== contentHash)
+        storedIntegrity();
+    return {
+        entryId,
+        workspace: validated.workspace,
+        revision: Number(input.revision),
+        kind: validated.kind,
+        title: validated.title,
+        body: validated.body,
+        summary: validated.summary,
+        scope: decodedScope.canonicalScope,
+        provenance: validated.provenance,
+        tags: validated.tags,
+        contentHash,
+        createdBy,
+        createdAt,
+    };
+}
+function decodedStoredEntry(input, revision) {
+    const id = storedNonEmptyString(input.id);
+    const workspace = storedNonEmptyString(input.workspace);
+    const createdBy = storedNonEmptyString(input.createdBy);
+    const createdAt = storedNonEmptyString(input.createdAt);
+    const updatedAt = storedNonEmptyString(input.updatedAt);
+    if (id !== revision.entryId || workspace !== revision.workspace
+        || !Number.isSafeInteger(input.currentRevision) || input.currentRevision !== revision.revision
+        || input.minRevision !== 1
+        || !Number.isSafeInteger(input.maxRevision) || input.currentRevision !== input.maxRevision
+        || !Number.isSafeInteger(input.revisionCount) || input.revisionCount !== input.maxRevision
+        || input.invalidRevisionCount !== 0
+        || typeof input.status !== 'string' || !ENTRY_STATUSES.includes(input.status)
+        || typeof input.trustLevel !== 'string' || !TRUST_LEVELS.includes(input.trustLevel)
+        || typeof input.confidence !== 'number' || !Number.isFinite(input.confidence) || input.confidence < 0 || input.confidence > 1
+        || input.supersededBy !== null && (typeof input.supersededBy !== 'string' || input.supersededBy.trim().length === 0)
+        || input.verifiedAt !== null && (typeof input.verifiedAt !== 'string' || input.verifiedAt.trim().length === 0))
+        storedIntegrity();
+    const status = input.status;
+    const supersededBy = input.supersededBy;
+    const verifiedAt = input.verifiedAt;
+    if ((status === 'superseded') !== (supersededBy !== null)
+        || status === 'candidate' && verifiedAt !== null
+        || status === 'verified' && verifiedAt === null
+        || !canonicalTimestamp(createdAt) || !canonicalTimestamp(updatedAt)
+        || verifiedAt !== null && !canonicalTimestamp(verifiedAt)
+        || createdAt > revision.createdAt || revision.createdAt > updatedAt
+        || createdAt > updatedAt
+        || verifiedAt !== null && (verifiedAt < createdAt || verifiedAt > updatedAt))
+        storedIntegrity();
+    return {
+        id,
+        workspace,
+        status,
+        trustLevel: input.trustLevel,
+        confidence: input.confidence,
+        currentRevision: input.currentRevision,
+        supersededBy,
+        createdBy,
+        createdAt,
+        updatedAt,
+        verifiedAt,
+    };
+}
+/** Decode persisted entry/revision data without trusting TypeScript row casts. */
+export function decodeStoredMemoryRow(input) {
+    const revision = normalizedStoredRecord(input.revision, input.tags, input.options ?? {});
+    if (input.entry === undefined)
+        return { revision };
+    return { revision, entry: decodedStoredEntry(input.entry, revision) };
+}
+function revisionKey(input) {
+    if (typeof input.entryId !== 'string' || input.entryId.length === 0) {
+        throw new KiokukoError('VALIDATION_ERROR', 'entryId must be a non-empty string');
+    }
+    requireWorkspace(input.workspace);
+    if (!Number.isSafeInteger(input.revision) || input.revision < 1) {
+        throw new KiokukoError('VALIDATION_ERROR', 'revision must be a positive integer');
+    }
+}
+function completeRevisionChain(row) {
+    return Number.isSafeInteger(row.current_revision)
+        && row.min_revision === 1
+        && Number.isSafeInteger(row.max_revision)
+        && row.current_revision === row.max_revision
+        && Number.isSafeInteger(row.revision_count)
+        && row.revision_count === row.max_revision
+        && row.invalid_revision_count === 0;
+}
+function ownerRevisionChain(database, entryId) {
+    return database.prepare(`
+    SELECT e.workspace, e.current_revision,
+           MIN(r.revision) AS min_revision,
+           MAX(r.revision) AS max_revision,
+           COUNT(r.revision) AS revision_count,
+           COUNT(CASE
+             WHEN r.revision IS NOT NULL
+              AND (typeof(r.revision) <> 'integer' OR r.revision < 1)
+             THEN 1
+           END) AS invalid_revision_count
+      FROM entries AS e
+      LEFT JOIN entry_revisions AS r ON r.entry_id = e.id
+     WHERE e.id = ?
+     GROUP BY e.id
+  `).get(entryId);
+}
+function tagsFor(database, entryId, revision) {
+    return database
+        .prepare('SELECT tag FROM entry_revision_tags WHERE entry_id = ? AND revision = ? ORDER BY tag ASC')
+        .all(entryId, revision)
+        .map((row) => row.tag);
+}
+function rowToRevision(database, row, checkOwnerChronology = true) {
+    const entryId = storedNonEmptyString(row.entry_id);
+    if (!Number.isSafeInteger(row.revision))
+        storedIntegrity();
+    const tags = tagsFor(database, entryId, Number(row.revision));
+    const decoded = decodeStoredMemoryRow({
+        revision: {
+            entryId,
+            workspace: row.workspace,
+            revision: row.revision,
+            kind: row.kind,
+            title: row.title,
+            body: row.body,
+            summary: row.summary,
+            scopeJson: row.scope_json,
+            provenanceJson: row.provenance_json,
+            contentHash: row.content_hash,
+            createdBy: row.created_by,
+            createdAt: row.created_at,
+        },
+        tags,
+    }).revision;
+    if (checkOwnerChronology) {
+        const owner = database.prepare(`
+      SELECT e.created_at, e.updated_at, e.current_revision,
+             (SELECT MIN(all_revisions.revision)
+                FROM entry_revisions AS all_revisions
+               WHERE all_revisions.entry_id = e.id) AS min_revision,
+             (SELECT MAX(all_revisions.revision)
+                FROM entry_revisions AS all_revisions
+               WHERE all_revisions.entry_id = e.id) AS max_revision,
+             (SELECT COUNT(all_revisions.revision)
+                FROM entry_revisions AS all_revisions
+               WHERE all_revisions.entry_id = e.id) AS revision_count,
+             (SELECT COUNT(*)
+                FROM entry_revisions AS all_revisions
+               WHERE all_revisions.entry_id = e.id
+                 AND (typeof(all_revisions.revision) <> 'integer' OR all_revisions.revision < 1)) AS invalid_revision_count
+        FROM entries AS e
+       WHERE e.id = ? AND e.workspace = ?
+    `).get(decoded.entryId, decoded.workspace);
+        if (owner === undefined || !canonicalTimestamp(owner.created_at) || !canonicalTimestamp(owner.updated_at)
+            || !completeRevisionChain({ workspace: decoded.workspace, ...owner })
+            || owner.created_at > decoded.createdAt || decoded.createdAt > owner.updated_at)
+            storedIntegrity();
+    }
+    return decoded;
+}
+function selectRevision(database, input, checkOwnerChronology = true) {
+    const row = database.prepare(`
+    SELECT entry_id, workspace, revision, kind, title, body, summary,
+           scope_json, provenance_json, content_hash, created_by, created_at
+      FROM entry_revisions
+     WHERE entry_id = ? AND workspace = ? AND revision = ?
+  `).get(input.entryId, input.workspace, input.revision);
+    return row === undefined ? undefined : rowToRevision(database, row, checkOwnerChronology);
+}
+export function readEntryRevision(database, input) {
+    revisionKey(input);
+    const result = selectRevision(database, input);
+    if (result === undefined)
+        throw new KiokukoError('NOT_FOUND', 'Entry revision not found');
+    return result;
+}
+export function findEntryRevision(database, input) {
+    revisionKey(input);
+    return selectRevision(database, input);
+}
+export function insertEntryRevisionInTransaction(database, input) {
+    revisionKey(input);
+    if (typeof input.createdBy !== 'string' || input.createdBy.length === 0 || typeof input.createdAt !== 'string' || input.createdAt.length === 0) {
+        throw new KiokukoError('VALIDATION_ERROR', 'Revision creator and timestamp are required');
+    }
+    const owner = ownerRevisionChain(database, input.entryId);
+    if (owner === undefined)
+        throw new KiokukoError('NOT_FOUND', 'Entry not found');
+    if (owner.workspace !== input.workspace)
+        throw new KiokukoError('NOT_FOUND', 'Entry does not belong to workspace');
+    let nextRevision;
+    if (owner.revision_count === 0) {
+        if (owner.min_revision !== null || owner.max_revision !== null || owner.current_revision !== 1)
+            storedIntegrity();
+        nextRevision = 1;
+    }
+    else {
+        if (!completeRevisionChain(owner))
+            storedIntegrity();
+        nextRevision = Number(owner.max_revision) + 1;
+    }
+    if (input.revision !== nextRevision) {
+        throw new KiokukoError('CONFLICT', 'Entry revision must be the exact next revision', {
+            expectedRevision: nextRevision,
+            actualRevision: input.revision,
+        });
+    }
+    const validated = validateRecordInput({
+        workspace: input.workspace,
+        kind: input.kind,
+        title: input.title,
+        body: input.body,
+        summary: input.summary,
+        scope: input.scope,
+        provenance: input.provenance,
+        tags: input.tags,
+        createdBy: input.createdBy,
+        actor: input.createdBy,
+    });
+    const canonicalScope = normalizeStructuredScopeInput(validated.scope);
+    const contentHash = canonicalEntryRevisionContentHash({
+        kind: validated.kind,
+        title: validated.title,
+        body: validated.body,
+        summary: validated.summary,
+        scope: canonicalScope,
+        provenance: validated.provenance,
+        tags: validated.tags,
+    });
+    if (input.contentHash !== undefined && input.contentHash !== contentHash) {
+        throw new KiokukoError('INTEGRITY_ERROR', 'Entry revision content hash does not match its content');
+    }
+    try {
+        database.prepare(`
+      INSERT INTO entry_revisions (
+        entry_id, workspace, revision, kind, title, body, summary, scope_json,
+        provenance_json, content_hash, created_by, created_at
+      ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+    `).run(input.entryId, input.workspace, input.revision, validated.kind, validated.title, validated.body, validated.summary, canonicalJson(canonicalScope), canonicalJson(validated.provenance), contentHash, input.createdBy, input.createdAt);
+    }
+    catch (error) {
+        if (isExpectedRevisionConflict(error)) {
+            throw new KiokukoError('CONFLICT', 'Entry revision or content already exists');
+        }
+        throw error;
+    }
+    for (const tag of validated.tags) {
+        database.prepare('INSERT INTO entry_revision_tags (entry_id, revision, tag) VALUES (?, ?, ?)').run(input.entryId, input.revision, tag);
+    }
+    const result = selectRevision(database, input, false);
+    if (result === undefined)
+        throw new KiokukoError('INTEGRITY_ERROR', 'Inserted entry revision could not be read back');
+    return result;
+}
+//# sourceMappingURL=revisions.js.map

package/dist/memory/revisions.js.map

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

package/dist/memory/scoped-memory.d.ts

@@ -0,0 +1,76 @@
+import type { SqliteDatabase } from '../db/adapter.js';
+import { type EntryRecord } from './entries.js';
+import { type ResolvedProjectWorkspace } from './workspaces.js';
+import { type EntryKind } from '../serialization/validate.js';
+import { type Applicability, type MemoryClass, type MemorySignals, type RetrievalScope } from './structured-memory.js';
+import { type FederatedScope, type FederatedRecallResult } from './federated-retrieval.js';
+import type { HybridSearchRuntime } from './hybrid-retrieval.js';
+import type { ProjectFingerprint } from '../repository/project-fingerprint.js';
+import { type CheckpointOutcome } from '../ledger/checkpoint-contract.js';
+interface GitProvenanceExecOptions {
+    cwd: string;
+    encoding: 'utf8';
+    stdio: ['ignore', 'pipe', 'pipe'];
+    timeout: number;
+    maxBuffer: number;
+    env: NodeJS.ProcessEnv;
+}
+type GitProvenanceExecutor = (executable: string, args: string[], options: GitProvenanceExecOptions) => string;
+/** Resolve immutable checkpoint provenance without treating Git failures as an absent commit. */
+export declare function resolveCheckpointSourceCommit(repositoryRoot: string, execute?: GitProvenanceExecutor): string | null;
+export type MemoryScope = FederatedScope;
+export interface ScopedRecallInput {
+    query: string;
+    cwd?: string;
+    project?: ResolvedProjectWorkspace;
+    fingerprint?: ProjectFingerprint;
+    scope?: MemoryScope;
+    limit?: number;
+    maxChars?: number;
+    readOnly?: boolean;
+}
+export type ScopedRecallResult = FederatedRecallResult;
+export interface CheckpointMemory {
+    kind: EntryKind;
+    title: string;
+    body: string;
+    summary?: string;
+    scope?: 'project' | 'global';
+    retrievalScope?: RetrievalScope;
+    tags?: string[];
+    confidence?: number;
+    memoryClass?: MemoryClass;
+    applicability?: Applicability;
+    signals?: MemorySignals;
+    portableReason?: string;
+}
+export interface ScopedCheckpointStandaloneInput {
+    cwd?: string;
+    memories: CheckpointMemory[];
+}
+export interface ScopedCheckpointRunInput {
+    cwd?: string;
+    memories: CheckpointMemory[];
+    runId: string;
+    deliveryId?: string;
+    outcome: CheckpointOutcome;
+    feedback?: unknown[];
+    evidence?: unknown;
+}
+export type ScopedCheckpointInput = ScopedCheckpointStandaloneInput | ScopedCheckpointRunInput;
+export interface ScopedCheckpointResult {
+    project: ResolvedProjectWorkspace | null;
+    entries: Array<Pick<EntryRecord, 'id' | 'workspace' | 'kind' | 'status' | 'title' | 'revision'>>;
+    run?: {
+        runId: string;
+        status: string;
+        feedbackCount: number;
+        evidenceCount: number;
+        reasoningPaths: number;
+        qualifiedReasoningPaths: number;
+    };
+}
+export declare function recallScopedMemory(database: SqliteDatabase, input: ScopedRecallInput, runtime?: HybridSearchRuntime): Promise<ScopedRecallResult>;
+export declare function checkpointScopedMemory(database: SqliteDatabase, input: ScopedCheckpointInput, signal?: AbortSignal): Promise<ScopedCheckpointResult>;
+export {};
+//# sourceMappingURL=scoped-memory.d.ts.map

package/dist/memory/scoped-memory.d.ts.map

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