kiokuko-dsh 0.1.0

package/dist/context/run-state.js

@@ -0,0 +1,399 @@
+import { KiokukoError } from '../errors.js';
+import { AKINATOR_POLICY_VERSION, evaluateProfile } from '../akinator/domain.js';
+import { readAkinatorSession, readRunIntakeLink } from '../akinator/store.js';
+import { GENESIS_HASH, hashLedgerEvent } from '../ledger/hash.js';
+import { projectLedger } from '../ledger/projection.js';
+import { LedgerStore } from '../ledger/store.js';
+import { COVERAGE_LEVELS, TERMINAL_RUN_STATUSES, } from '../ledger/types.js';
+import { validateEventInput, validateTimestamp } from '../ledger/validate.js';
+import { canonicalContentHash, canonicalJson } from '../serialization/validate.js';
+const HASH = /^[0-9a-f]{64}$/u;
+const CURRENT_PROFILE_SCHEMA_VERSION = 1;
+const REDACTION_KINDS = [
+    'sensitive_key',
+    'secret_pattern',
+    'url',
+    'home_path',
+    'preview_truncated',
+    'environment_value',
+    'hidden_reasoning',
+];
+function integrity(message = 'Stored context run is invalid') {
+    throw new KiokukoError('INTEGRITY_ERROR', message);
+}
+function storedRun(database, runId) {
+    let run;
+    try {
+        run = new LedgerStore(database).readRun(runId);
+    }
+    catch (error) {
+        if (error instanceof SyntaxError)
+            integrity();
+        throw error;
+    }
+    if (run === undefined)
+        throw new KiokukoError('NOT_FOUND', 'Context run was not found');
+    const coverageFields = ['run', 'tool', 'command', 'file', 'approval'];
+    if (typeof run.workspace !== 'string'
+        || run.workspace.length === 0
+        || (run.title !== null && typeof run.title !== 'string')
+        || !Number.isSafeInteger(run.lastSequence)
+        || run.lastSequence < 0
+        || typeof run.createdAt !== 'string'
+        || typeof run.updatedAt !== 'string'
+        || typeof run.coverage !== 'object'
+        || run.coverage === null
+        || Array.isArray(run.coverage)
+        || Object.keys(run.coverage).length !== coverageFields.length
+        || coverageFields.some((field) => !COVERAGE_LEVELS.includes(run.coverage[field]))) {
+        integrity();
+    }
+    try {
+        validateTimestamp(run.createdAt, 'createdAt');
+        validateTimestamp(run.updatedAt, 'updatedAt');
+    }
+    catch (error) {
+        if (error instanceof KiokukoError && error.code === 'VALIDATION_ERROR')
+            integrity();
+        throw error;
+    }
+    return run;
+}
+function parseCanonicalJson(value) {
+    if (typeof value !== 'string')
+        integrity('Stored context ledger event is invalid');
+    let parsed;
+    try {
+        parsed = JSON.parse(value);
+    }
+    catch (error) {
+        if (error instanceof SyntaxError)
+            integrity('Stored context ledger event is invalid');
+        throw error;
+    }
+    try {
+        if (canonicalJson(parsed) !== value)
+            integrity('Stored context ledger event is invalid');
+    }
+    catch (error) {
+        if (error instanceof KiokukoError && error.code === 'VALIDATION_ERROR') {
+            integrity('Stored context ledger event is invalid');
+        }
+        throw error;
+    }
+    return parsed;
+}
+function parsedRedactions(value) {
+    const parsed = parseCanonicalJson(value);
+    if (!Array.isArray(parsed))
+        integrity('Stored context ledger event is invalid');
+    return parsed.map((item) => {
+        if (typeof item !== 'object'
+            || item === null
+            || Array.isArray(item)
+            || Object.keys(item).length !== 2
+            || typeof item.path !== 'string'
+            || item.path.length === 0
+            || typeof item.kind !== 'string'
+            || !REDACTION_KINDS.includes(item.kind)) {
+            integrity('Stored context ledger event is invalid');
+        }
+        return { path: item.path, kind: item.kind };
+    });
+}
+function validatedLedgerEvents(database, run) {
+    const rows = new LedgerStore(database).readEvents(run.runId);
+    if (rows.length !== run.lastSequence)
+        integrity('Stored context ledger sequence is invalid');
+    const events = [];
+    let previousHash = GENESIS_HASH;
+    for (let index = 0; index < rows.length; index += 1) {
+        const row = rows[index];
+        if (row === undefined
+            || row.run_id !== run.runId
+            || row.sequence !== index + 1
+            || row.previous_hash !== previousHash
+            || typeof row.event_hash !== 'string'
+            || !HASH.test(row.event_hash)
+            || typeof row.ingested_at !== 'string') {
+            integrity('Stored context ledger sequence is invalid');
+        }
+        const payload = parseCanonicalJson(row.payload_json);
+        const redaction = parsedRedactions(row.redaction_json);
+        let event;
+        try {
+            event = validateEventInput({
+                eventId: row.event_id,
+                ...(row.source_event_id === null ? {} : { sourceEventId: row.source_event_id }),
+                ...(row.source_sequence === null ? {} : { sourceSequence: row.source_sequence }),
+                eventType: row.event_type,
+                ...(row.source_type === null ? {} : { sourceType: row.source_type }),
+                actor: row.actor,
+                outcome: row.outcome,
+                ...(row.occurred_at === null ? {} : { occurredAt: row.occurred_at }),
+                payload,
+            });
+            validateTimestamp(row.ingested_at, 'ingestedAt');
+        }
+        catch (error) {
+            if (error instanceof KiokukoError
+                && (error.code === 'VALIDATION_ERROR' || error.code === 'SECURITY_REJECTION')) {
+                integrity('Stored context ledger event is invalid');
+            }
+            throw error;
+        }
+        const calculated = hashLedgerEvent({
+            runId: run.runId,
+            sequence: row.sequence,
+            eventId: event.eventId,
+            previousHash: row.previous_hash,
+            eventType: event.eventType,
+            ...(event.sourceEventId === undefined ? {} : { sourceEventId: event.sourceEventId }),
+            ...(event.sourceSequence === undefined ? {} : { sourceSequence: event.sourceSequence }),
+            ...(event.sourceType === undefined ? {} : { sourceType: event.sourceType }),
+            actor: event.actor,
+            ...(event.outcome === undefined ? {} : { outcome: event.outcome }),
+            ...(event.occurredAt === undefined ? {} : { occurredAt: event.occurredAt }),
+            ingestedAt: row.ingested_at,
+            payload: event.payload,
+            redaction,
+        });
+        if (calculated !== row.event_hash)
+            integrity('Stored context ledger hash chain is invalid');
+        const projection = {
+            eventId: event.eventId,
+            sequence: row.sequence,
+            eventType: event.eventType,
+            ...(event.outcome === undefined || event.outcome === null ? {} : { outcome: event.outcome }),
+            payload: event.payload,
+        };
+        events.push({
+            projection,
+            hashInput: {
+                eventId: event.eventId,
+                sequence: row.sequence,
+                eventType: event.eventType,
+                sourceEventId: event.sourceEventId ?? null,
+                sourceSequence: event.sourceSequence ?? null,
+                sourceType: event.sourceType ?? null,
+                actor: event.actor,
+                outcome: event.outcome ?? null,
+                occurredAt: event.occurredAt ?? null,
+                ingestedAt: row.ingested_at,
+                payload: event.payload,
+                redaction,
+                previousHash: row.previous_hash,
+                eventHash: row.event_hash,
+            },
+        });
+        previousHash = row.event_hash;
+    }
+    return events;
+}
+function validatedFinalizedIntake(database, run) {
+    let link;
+    try {
+        link = readRunIntakeLink(database, { workspace: run.workspace, runId: run.runId });
+    }
+    catch (error) {
+        if (error instanceof KiokukoError && error.code === 'NOT_FOUND') {
+            integrity('Stored context run intake state is invalid');
+        }
+        throw error;
+    }
+    let session;
+    try {
+        session = readAkinatorSession(database, { workspace: run.workspace, sessionId: link.sessionId });
+    }
+    catch (error) {
+        if (error instanceof KiokukoError && error.code === 'NOT_FOUND') {
+            integrity('Stored context run intake state is invalid');
+        }
+        throw error;
+    }
+    if (link.runId !== run.runId
+        || link.workspace !== run.workspace
+        || session.id !== link.sessionId
+        || session.workspace !== run.workspace
+        || session.status === 'active') {
+        integrity('Stored context run intake state is invalid');
+    }
+    validatedCurrentIntakeMetadata(link, session);
+    const initialProfileHash = canonicalContentHash(session.profile);
+    if (link.initialProfileHash !== initialProfileHash || link.finalizedAt === null) {
+        integrity('Context run intake link does not match its session state');
+    }
+    return { link, session, initialProfileHash };
+}
+function validatedCurrentIntakeMetadata(link, session) {
+    if (link.policyVersion !== AKINATOR_POLICY_VERSION
+        || link.profileSchemaVersion !== CURRENT_PROFILE_SCHEMA_VERSION) {
+        integrity('Stored context run intake state is invalid');
+    }
+    let expected;
+    try {
+        expected = evaluateProfile(session.profile, session.questionCount);
+    }
+    catch (error) {
+        if (error instanceof KiokukoError && error.code === 'VALIDATION_ERROR') {
+            integrity('Stored context run intake state is invalid');
+        }
+        throw error;
+    }
+    if (session.status !== 'active'
+        && (link.recommendedTags.length !== expected.recommendedTags.length
+            || link.recommendedTags.some((tag, index) => tag !== expected.recommendedTags[index]))) {
+        integrity('Stored context run intake state is invalid');
+    }
+    return [...expected.recommendedTags];
+}
+/** Verify the exact intake/profile binding at a persisted delivery cursor. */
+export function readContextRunProfileBinding(database, runId, throughSequence) {
+    const run = storedRun(database, runId);
+    if (!Number.isSafeInteger(throughSequence)
+        || throughSequence < 0
+        || throughSequence > run.lastSequence) {
+        integrity('Stored context delivery sequence is invalid');
+    }
+    const { link, session, initialProfileHash } = validatedFinalizedIntake(database, run);
+    const events = validatedLedgerEvents(database, run);
+    let projection;
+    try {
+        projection = projectLedger({
+            initialProfile: session.profile,
+            intakeStatus: session.status,
+            coverage: run.coverage,
+            throughSequence,
+            events: events
+                .filter((event) => event.projection.sequence <= throughSequence)
+                .map((event) => event.projection),
+        });
+    }
+    catch (error) {
+        if (error instanceof KiokukoError && error.code === 'VALIDATION_ERROR') {
+            integrity('Stored context ledger projection state is invalid');
+        }
+        throw error;
+    }
+    return {
+        workspace: run.workspace,
+        intakeSessionId: link.sessionId,
+        intakePolicyVersion: link.policyVersion,
+        initialProfileHash,
+        profileHash: projection.profileHash,
+    };
+}
+/** Read and validate the complete immutable input used by broker ranking/recommendations. */
+export function readContextRunRetrievalState(database, runId) {
+    const run = storedRun(database, runId);
+    if (TERMINAL_RUN_STATUSES.includes(run.status)) {
+        throw new KiokukoError('CONFLICT', 'Task run is terminal');
+    }
+    let link;
+    try {
+        link = readRunIntakeLink(database, { workspace: run.workspace, runId });
+    }
+    catch (error) {
+        if (error instanceof KiokukoError && error.code === 'NOT_FOUND') {
+            integrity('Stored context run intake state is invalid');
+        }
+        throw error;
+    }
+    let session;
+    try {
+        session = readAkinatorSession(database, { workspace: run.workspace, sessionId: link.sessionId });
+    }
+    catch (error) {
+        if (error instanceof KiokukoError && error.code === 'NOT_FOUND') {
+            integrity('Stored context run intake state is invalid');
+        }
+        throw error;
+    }
+    if (link.runId !== run.runId
+        || link.workspace !== run.workspace
+        || session.id !== link.sessionId
+        || session.workspace !== run.workspace) {
+        integrity('Stored context run intake state is invalid');
+    }
+    const recommendedTags = validatedCurrentIntakeMetadata(link, session);
+    const expectedRunStatus = session.status === 'active' ? 'intake' : 'active';
+    if (run.status !== expectedRunStatus) {
+        integrity('Context run status does not match its intake state');
+    }
+    const sessionProfileHash = canonicalContentHash(session.profile);
+    if (session.status === 'active'
+        ? link.initialProfileHash !== null || link.finalizedAt !== null
+        : link.initialProfileHash !== sessionProfileHash || link.finalizedAt === null) {
+        integrity('Context run intake link does not match its session state');
+    }
+    const events = validatedLedgerEvents(database, run);
+    let projection = null;
+    if (session.status !== 'active') {
+        try {
+            projection = projectLedger({
+                initialProfile: session.profile,
+                intakeStatus: session.status,
+                coverage: run.coverage,
+                throughSequence: run.lastSequence,
+                events: events.map((event) => event.projection),
+            });
+        }
+        catch (error) {
+            if (error instanceof KiokukoError && error.code === 'VALIDATION_ERROR') {
+                integrity('Stored context ledger projection state is invalid');
+            }
+            throw error;
+        }
+    }
+    const profile = projection?.taskProfile ?? session.profile;
+    const profileHash = projection?.profileHash ?? sessionProfileHash;
+    const stateHash = canonicalContentHash({
+        run: {
+            runId: run.runId,
+            workspace: run.workspace,
+            status: run.status,
+            title: run.title,
+            coverage: run.coverage,
+            lastSequence: run.lastSequence,
+            createdAt: run.createdAt,
+            updatedAt: run.updatedAt,
+        },
+        intake: {
+            session: {
+                id: session.id,
+                workspace: session.workspace,
+                task: session.task,
+                profile: session.profile,
+                status: session.status,
+                questionCount: session.questionCount,
+                createdAt: session.createdAt,
+                updatedAt: session.updatedAt,
+            },
+            link: {
+                runId: link.runId,
+                sessionId: link.sessionId,
+                workspace: link.workspace,
+                policyVersion: link.policyVersion,
+                profileSchemaVersion: link.profileSchemaVersion,
+                profileSources: link.profileSources,
+                initialProfileHash: link.initialProfileHash,
+                recommendedTags: link.recommendedTags,
+                linkedAt: link.linkedAt,
+                finalizedAt: link.finalizedAt,
+            },
+        },
+        events: events.map((event) => event.hashInput),
+        projection,
+    });
+    return {
+        run,
+        profile,
+        profileHash,
+        recommendedTags,
+        intakeSessionId: link.sessionId,
+        intakeStatus: session.status,
+        projection,
+        stateHash,
+    };
+}
+//# sourceMappingURL=run-state.js.map

package/dist/context/run-state.js.map

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

package/dist/context/scoped-broker.d.ts

@@ -0,0 +1,77 @@
+import type { SqliteDatabase } from '../db/adapter.js';
+import { type ResolvedProjectWorkspace } from '../memory/workspaces.js';
+import { type FederatedOrigin } from '../memory/federated-retrieval.js';
+import type { TaskProfile } from '../akinator/types.js';
+import { type ProjectFingerprint } from '../repository/project-fingerprint.js';
+import type { HybridSearchRuntime } from '../memory/hybrid-retrieval.js';
+export declare const SCOPED_CONTEXT_POLICY_VERSION: "context-ranking-v6";
+export declare const SCOPED_CONTEXT_DEFAULT_CHARACTER_BUDGET = 8000;
+export declare const SCOPED_CONTEXT_MAX_CHARACTER_BUDGET = 100000;
+export interface ScopedContextQuery {
+    cwd?: string;
+    project?: ResolvedProjectWorkspace;
+    fingerprint?: ProjectFingerprint;
+    task: string;
+    taskProfile: TaskProfile;
+    recommendedTags?: string[];
+    changedPaths?: string[];
+    errorSignatures?: string[];
+    limit?: number;
+    characterBudget?: number;
+    runId?: string;
+}
+export interface ScopedContextItem {
+    entryId: string;
+    revision: number;
+    origin: FederatedOrigin;
+    title: string;
+    summary: string | null;
+    bodyPreview: string;
+    score: number;
+    scoreComponents: {
+        status: number;
+        trust: number;
+        confidence: number;
+        retrieval: number;
+        taskAffinity: number;
+        recommendedTags: number;
+        scopeAffinity: number;
+        applicability: number;
+        pathOverlap: number;
+        errorSignature: number;
+        exactSignal: number;
+        feedback: number;
+        recency: number;
+        contradiction: number;
+    };
+    selectionReasons: string[];
+    metadata: {
+        storedData: true;
+        untrusted: true;
+        instructions: false;
+    };
+}
+export interface ScopedContextResult {
+    project: ResolvedProjectWorkspace | null;
+    taskProfileHash: string;
+    queryHash: string;
+    policyVersion: typeof SCOPED_CONTEXT_POLICY_VERSION;
+    items: ScopedContextItem[];
+    deliveryId: string | null;
+    truncated: boolean;
+    untrusted: true;
+}
+export interface ScopedContextGateDecision<T> {
+    persist: boolean;
+    value: T;
+    assertBeforePersist?: () => void;
+}
+export interface ScopedContextGatedResult<T> {
+    context: ScopedContextResult | null;
+    value: T;
+    /** Internal corpus generation used by callers that guard later side effects. */
+    selectionStateHash: string;
+}
+export declare function queryScopedContext(database: SqliteDatabase, raw: ScopedContextQuery, runtime?: HybridSearchRuntime): Promise<ScopedContextResult>;
+export declare function queryScopedContextGated<T>(database: SqliteDatabase, raw: ScopedContextQuery, decide: (candidate: ScopedContextResult) => ScopedContextGateDecision<T>, runtime?: HybridSearchRuntime): Promise<ScopedContextGatedResult<T>>;
+//# sourceMappingURL=scoped-broker.d.ts.map

package/dist/context/scoped-broker.d.ts.map

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