kiokuko-dsh 0.1.0

package/dist/context/recommendations.d.ts

@@ -0,0 +1,80 @@
+export declare const RECOMMENDATION_POLICY_VERSION: "recommendations.v1";
+export declare const RECOMMENDATION_CODES: readonly ["INTAKE_INCOMPLETE", "VERIFY_AFTER_MUTATION", "SIDE_EFFECT_OUTCOME_UNKNOWN", "UNRESOLVED_FAILURE", "COVERAGE_INCOMPLETE", "CONTEXT_STALE", "CONTRADICTORY_MEMORY", "PROMOTION_CANDIDATE"];
+export type RecommendationCode = (typeof RECOMMENDATION_CODES)[number];
+export declare const RECOMMENDATION_PRIORITY: Readonly<Record<RecommendationCode, number>>;
+export declare const MAX_RECOMMENDATIONS: 8;
+export declare const MAX_EVIDENCE_EVENT_IDS = 16;
+export declare const MAX_REFERENCE_IDS = 16;
+export declare const MAX_INPUT_ITEMS = 4096;
+export declare const RECOMMENDATION_MESSAGES: Readonly<Record<RecommendationCode, string>>;
+declare const COVERAGE_CATEGORIES: readonly ["approval", "command", "file", "run", "tool"];
+declare const COVERAGE_LEVELS: readonly ["complete", "best_effort", "declared", "unavailable"];
+declare const MISSING_PROFILE_FIELDS: readonly ["taskType", "target", "expected"];
+declare const EVIDENCE_STATES: readonly ["none", "failed", "fresh", "stale"];
+declare const TASK_TYPES: readonly ["build", "debug", "research", "review", "devops", "writing", "analysis"];
+type CoverageCategory = (typeof COVERAGE_CATEGORIES)[number];
+type CoverageLevel = (typeof COVERAGE_LEVELS)[number];
+type MissingProfileField = (typeof MISSING_PROFILE_FIELDS)[number];
+type EvidenceState = (typeof EVIDENCE_STATES)[number];
+export interface RecommendationMetadata {
+    truncated: boolean;
+    referenceIds: string[];
+    incompleteCoverageCategories?: CoverageCategory[];
+}
+export interface Recommendation {
+    code: RecommendationCode;
+    message: string;
+    evidenceEventIds: string[];
+    priority: number;
+    untrusted: true;
+    actionable: false;
+    metadata: RecommendationMetadata;
+}
+export interface RecommendationProjectionInput {
+    intakeIncomplete: boolean;
+    missingProfileFields: MissingProfileField[];
+    evidenceState: EvidenceState;
+    unresolvedFailureEventIds: string[];
+    unknownOutcomeEventIds: string[];
+    coverage: 'complete' | 'partial';
+    declaredCoverage?: Partial<Record<CoverageCategory, CoverageLevel>>;
+    incompleteCoverageCategories?: CoverageCategory[];
+    latestMutationEventIds?: string[];
+    latestPassingVerificationEventIds?: string[];
+    throughSequence?: number;
+    latestMutationSequence?: number | null;
+    latestPassingVerificationSequence?: number | null;
+    profileHash?: string;
+    taskProfile?: {
+        taskType: (typeof TASK_TYPES)[number] | null;
+        target: string | null;
+        expected: string | null;
+        constraints: string | null;
+    };
+}
+export interface RecommendationStaleDeliveredEntryInput {
+    entryId: string;
+    deliveredRevision: number;
+    currentRevision: number;
+    stale?: boolean;
+    evidenceEventIds?: string[];
+}
+export interface RecommendationContradictionPairInput {
+    leftEntryId: string;
+    rightEntryId: string;
+    verified: boolean;
+    evidenceEventIds?: string[];
+}
+export interface RecommendationPromotionCandidateInput {
+    eventId: string;
+    eligible: boolean;
+    evidenceEventIds?: string[];
+}
+export interface RecommendationBrokerInput {
+    staleDeliveredEntries?: RecommendationStaleDeliveredEntryInput[];
+    contradictoryMemoryPairs?: RecommendationContradictionPairInput[];
+    promotionCandidates?: RecommendationPromotionCandidateInput[];
+}
+export declare function buildRecommendations(input: unknown): Recommendation[];
+export {};
+//# sourceMappingURL=recommendations.d.ts.map

package/dist/context/recommendations.d.ts.map

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

package/dist/context/recommendations.js

@@ -0,0 +1,341 @@
+import { KiokukoError } from '../errors.js';
+export const RECOMMENDATION_POLICY_VERSION = 'recommendations.v1';
+export const RECOMMENDATION_CODES = [
+    'INTAKE_INCOMPLETE',
+    'VERIFY_AFTER_MUTATION',
+    'SIDE_EFFECT_OUTCOME_UNKNOWN',
+    'UNRESOLVED_FAILURE',
+    'COVERAGE_INCOMPLETE',
+    'CONTEXT_STALE',
+    'CONTRADICTORY_MEMORY',
+    'PROMOTION_CANDIDATE',
+];
+export const RECOMMENDATION_PRIORITY = Object.freeze({
+    INTAKE_INCOMPLETE: 1,
+    VERIFY_AFTER_MUTATION: 2,
+    SIDE_EFFECT_OUTCOME_UNKNOWN: 3,
+    UNRESOLVED_FAILURE: 4,
+    COVERAGE_INCOMPLETE: 5,
+    CONTEXT_STALE: 6,
+    CONTRADICTORY_MEMORY: 7,
+    PROMOTION_CANDIDATE: 8,
+});
+export const MAX_RECOMMENDATIONS = RECOMMENDATION_CODES.length;
+export const MAX_EVIDENCE_EVENT_IDS = 16;
+export const MAX_REFERENCE_IDS = 16;
+export const MAX_INPUT_ITEMS = 4096;
+export const RECOMMENDATION_MESSAGES = Object.freeze({
+    INTAKE_INCOMPLETE: 'Intake is incomplete; required task details remain unanswered',
+    VERIFY_AFTER_MUTATION: 'Passing evidence predates the latest mutation',
+    SIDE_EFFECT_OUTCOME_UNKNOWN: 'A side effect has no known outcome',
+    UNRESOLVED_FAILURE: 'Unresolved failures remain',
+    COVERAGE_INCOMPLETE: 'Observed coverage is incomplete',
+    CONTEXT_STALE: 'Previously delivered context may be stale',
+    CONTRADICTORY_MEMORY: 'Verified memory entries contain a contradiction',
+    PROMOTION_CANDIDATE: 'A durable proposal is eligible for candidate promotion only',
+});
+const COVERAGE_CATEGORIES = ['approval', 'command', 'file', 'run', 'tool'];
+const COVERAGE_LEVELS = ['complete', 'best_effort', 'declared', 'unavailable'];
+const MISSING_PROFILE_FIELDS = ['taskType', 'target', 'expected'];
+const EVIDENCE_STATES = ['none', 'failed', 'fresh', 'stale'];
+const TASK_TYPES = ['build', 'debug', 'research', 'review', 'devops', 'writing', 'analysis'];
+const TOP_LEVEL_FIELDS = ['projection', 'broker'];
+const PROJECTION_FIELDS = [
+    'intakeIncomplete', 'missingProfileFields', 'evidenceState', 'unresolvedFailureEventIds',
+    'unknownOutcomeEventIds', 'coverage', 'declaredCoverage', 'incompleteCoverageCategories',
+    'latestMutationEventIds', 'latestPassingVerificationEventIds', 'throughSequence',
+    'latestMutationSequence', 'latestPassingVerificationSequence', 'profileHash', 'taskProfile',
+];
+const BROKER_FIELDS = ['staleDeliveredEntries', 'contradictoryMemoryPairs', 'promotionCandidates'];
+const STALE_ENTRY_FIELDS = ['entryId', 'deliveredRevision', 'currentRevision', 'stale', 'evidenceEventIds'];
+const CONTRADICTION_FIELDS = ['leftEntryId', 'rightEntryId', 'verified', 'evidenceEventIds'];
+const PROMOTION_FIELDS = ['eventId', 'eligible', 'evidenceEventIds'];
+const COVERAGE_FIELDS = COVERAGE_CATEGORIES;
+const TASK_PROFILE_FIELDS = ['taskType', 'target', 'expected', 'constraints'];
+function validation() {
+    throw new KiokukoError('VALIDATION_ERROR', 'Invalid recommendation input');
+}
+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, key) {
+    return Object.prototype.hasOwnProperty.call(value, key);
+}
+function knownFields(value, allowed) {
+    const allowedSet = new Set(allowed);
+    if (Object.keys(value).some((key) => !allowedSet.has(key)))
+        validation();
+}
+function requiredFields(value, required) {
+    if (required.some((key) => !hasOwn(value, key)))
+        validation();
+}
+function safeIdentifier(value) {
+    if (typeof value !== 'string' || value.length === 0 || value.length > 256)
+        validation();
+    if (/\s|:\/\/|[;&|<>`$]/u.test(value))
+        validation();
+    if (/(?:bearer|basic)\s|(?:ghp_|github_pat_|xox[baprs]-|sk-[A-Za-z0-9]|AKIA[0-9A-Z]{16})/iu.test(value))
+        validation();
+    return value;
+}
+function idList(value, required) {
+    if (value === undefined && !required)
+        return [];
+    if (!Array.isArray(value) || value.length > MAX_INPUT_ITEMS)
+        validation();
+    return [...new Set(value.map((item) => safeIdentifier(item)))].sort();
+}
+function bounded(values, maximum) {
+    const unique = [...new Set(values)].sort();
+    return { values: unique.slice(0, maximum), truncated: unique.length > maximum };
+}
+function enumValue(value, values) {
+    if (typeof value !== 'string' || !values.includes(value))
+        validation();
+    return value;
+}
+function booleanValue(value) {
+    if (typeof value !== 'boolean')
+        validation();
+    return value;
+}
+function sequence(value, optional) {
+    if (value === undefined && optional)
+        return null;
+    if (value === null && optional)
+        return null;
+    if (typeof value !== 'number' || !Number.isSafeInteger(value) || value < 0)
+        validation();
+    return value;
+}
+function parseTaskProfile(value) {
+    if (!isPlainObject(value))
+        validation();
+    knownFields(value, TASK_PROFILE_FIELDS);
+    requiredFields(value, TASK_PROFILE_FIELDS);
+    const taskType = value.taskType === null ? null : enumValue(value.taskType, TASK_TYPES);
+    for (const field of ['target', 'expected', 'constraints']) {
+        if (value[field] !== null && typeof value[field] !== 'string')
+            validation();
+    }
+    return {
+        taskType,
+        target: value.target,
+        expected: value.expected,
+        constraints: value.constraints,
+    };
+}
+function parseDeclaredCoverage(value) {
+    if (value === undefined)
+        return undefined;
+    if (!isPlainObject(value))
+        validation();
+    knownFields(value, COVERAGE_FIELDS);
+    const result = {};
+    for (const category of COVERAGE_CATEGORIES) {
+        if (hasOwn(value, category))
+            result[category] = enumValue(value[category], COVERAGE_LEVELS);
+    }
+    return result;
+}
+function parseProjection(value) {
+    if (!isPlainObject(value))
+        validation();
+    knownFields(value, PROJECTION_FIELDS);
+    requiredFields(value, [
+        'intakeIncomplete', 'missingProfileFields', 'evidenceState', 'unresolvedFailureEventIds',
+        'unknownOutcomeEventIds', 'coverage',
+    ]);
+    const intakeIncomplete = booleanValue(value.intakeIncomplete);
+    const missingProfileFields = idList(value.missingProfileFields, true);
+    if (missingProfileFields.some((field) => !MISSING_PROFILE_FIELDS.includes(field)))
+        validation();
+    const evidenceState = enumValue(value.evidenceState, EVIDENCE_STATES);
+    const coverage = enumValue(value.coverage, ['complete', 'partial']);
+    const declaredCoverage = parseDeclaredCoverage(value.declaredCoverage);
+    const incompleteCoverageCategories = idList(value.incompleteCoverageCategories, false);
+    if (incompleteCoverageCategories.some((category) => !COVERAGE_CATEGORIES.includes(category)))
+        validation();
+    if (intakeIncomplete && missingProfileFields.length === 0)
+        validation();
+    if (hasOwn(value, 'throughSequence'))
+        sequence(value.throughSequence, false);
+    if (hasOwn(value, 'latestMutationSequence'))
+        sequence(value.latestMutationSequence, true);
+    if (hasOwn(value, 'latestPassingVerificationSequence'))
+        sequence(value.latestPassingVerificationSequence, true);
+    if (hasOwn(value, 'profileHash'))
+        safeIdentifier(value.profileHash);
+    if (hasOwn(value, 'taskProfile'))
+        parseTaskProfile(value.taskProfile);
+    return {
+        intakeIncomplete,
+        missingProfileFields,
+        evidenceState,
+        unresolvedFailureEventIds: idList(value.unresolvedFailureEventIds, true),
+        unknownOutcomeEventIds: idList(value.unknownOutcomeEventIds, true),
+        coverage,
+        ...(declaredCoverage === undefined ? {} : { declaredCoverage }),
+        incompleteCoverageCategories,
+        latestMutationEventIds: idList(value.latestMutationEventIds, false),
+        latestPassingVerificationEventIds: idList(value.latestPassingVerificationEventIds, false),
+    };
+}
+function parseStaleEntries(value) {
+    if (value === undefined)
+        return [];
+    if (!Array.isArray(value) || value.length > MAX_INPUT_ITEMS)
+        validation();
+    return value.map((item) => {
+        if (!isPlainObject(item))
+            validation();
+        knownFields(item, STALE_ENTRY_FIELDS);
+        requiredFields(item, ['entryId', 'deliveredRevision', 'currentRevision']);
+        if (sequence(item.deliveredRevision, false) === null || sequence(item.currentRevision, false) === null)
+            validation();
+        return {
+            entryId: safeIdentifier(item.entryId),
+            stale: hasOwn(item, 'stale') ? booleanValue(item.stale) : true,
+            evidenceEventIds: idList(item.evidenceEventIds, false),
+        };
+    });
+}
+function parseContradictions(value) {
+    if (value === undefined)
+        return [];
+    if (!Array.isArray(value) || value.length > MAX_INPUT_ITEMS)
+        validation();
+    return value.map((item) => {
+        if (!isPlainObject(item))
+            validation();
+        knownFields(item, CONTRADICTION_FIELDS);
+        requiredFields(item, ['leftEntryId', 'rightEntryId', 'verified']);
+        return {
+            leftEntryId: safeIdentifier(item.leftEntryId),
+            rightEntryId: safeIdentifier(item.rightEntryId),
+            verified: booleanValue(item.verified),
+            evidenceEventIds: idList(item.evidenceEventIds, false),
+        };
+    });
+}
+function parsePromotionCandidates(value) {
+    if (value === undefined)
+        return [];
+    if (!Array.isArray(value) || value.length > MAX_INPUT_ITEMS)
+        validation();
+    return value.map((item) => {
+        if (!isPlainObject(item))
+            validation();
+        knownFields(item, PROMOTION_FIELDS);
+        requiredFields(item, ['eventId', 'eligible']);
+        return {
+            eventId: safeIdentifier(item.eventId),
+            eligible: booleanValue(item.eligible),
+            evidenceEventIds: idList(item.evidenceEventIds, false),
+        };
+    });
+}
+function parseBroker(value) {
+    if (value === undefined)
+        return { staleDeliveredEntries: [], contradictoryMemoryPairs: [], promotionCandidates: [] };
+    if (!isPlainObject(value))
+        validation();
+    knownFields(value, BROKER_FIELDS);
+    return {
+        staleDeliveredEntries: parseStaleEntries(value.staleDeliveredEntries),
+        contradictoryMemoryPairs: parseContradictions(value.contradictoryMemoryPairs),
+        promotionCandidates: parsePromotionCandidates(value.promotionCandidates),
+    };
+}
+function parseInput(value) {
+    if (!isPlainObject(value))
+        validation();
+    knownFields(value, TOP_LEVEL_FIELDS);
+    requiredFields(value, ['projection']);
+    return {
+        projection: parseProjection(value.projection),
+        broker: parseBroker(value.broker),
+    };
+}
+function makeRecommendation(code, evidenceEventIds, referenceIds = [], extraMetadata = {}) {
+    const evidence = bounded(evidenceEventIds, MAX_EVIDENCE_EVENT_IDS);
+    const references = bounded(referenceIds, MAX_REFERENCE_IDS);
+    const categories = extraMetadata.incompleteCoverageCategories === undefined
+        ? undefined
+        : bounded(extraMetadata.incompleteCoverageCategories, MAX_REFERENCE_IDS);
+    return {
+        code,
+        message: RECOMMENDATION_MESSAGES[code],
+        evidenceEventIds: evidence.values,
+        priority: RECOMMENDATION_PRIORITY[code],
+        untrusted: true,
+        actionable: false,
+        metadata: {
+            truncated: evidence.truncated || references.truncated || (categories?.truncated ?? false),
+            ...(categories === undefined || categories.values.length === 0 ? {} : { incompleteCoverageCategories: categories.values }),
+            referenceIds: references.values,
+        },
+    };
+}
+function sortRecommendations(recommendations) {
+    const ordered = [...recommendations].sort((left, right) => left.priority - right.priority);
+    if (ordered.length <= MAX_RECOMMENDATIONS)
+        return ordered;
+    const truncated = ordered.slice(0, MAX_RECOMMENDATIONS);
+    return truncated.map((recommendation) => ({
+        ...recommendation,
+        metadata: {
+            truncated: true,
+            referenceIds: [...recommendation.metadata.referenceIds],
+            ...(recommendation.metadata.incompleteCoverageCategories === undefined
+                ? {}
+                : { incompleteCoverageCategories: [...recommendation.metadata.incompleteCoverageCategories] }),
+        },
+    }));
+}
+export function buildRecommendations(input) {
+    const normalized = parseInput(input);
+    const { projection, broker } = normalized;
+    const recommendations = [];
+    if (projection.intakeIncomplete) {
+        recommendations.push(makeRecommendation('INTAKE_INCOMPLETE', []));
+    }
+    if (projection.evidenceState === 'stale') {
+        recommendations.push(makeRecommendation('VERIFY_AFTER_MUTATION', [
+            ...projection.latestMutationEventIds,
+            ...projection.latestPassingVerificationEventIds,
+        ]));
+    }
+    if (projection.unknownOutcomeEventIds.length > 0) {
+        recommendations.push(makeRecommendation('SIDE_EFFECT_OUTCOME_UNKNOWN', projection.unknownOutcomeEventIds));
+    }
+    if (projection.unresolvedFailureEventIds.length > 0) {
+        recommendations.push(makeRecommendation('UNRESOLVED_FAILURE', projection.unresolvedFailureEventIds));
+    }
+    if (projection.coverage === 'partial') {
+        const declaredCoverage = projection.declaredCoverage;
+        const declaredCategories = declaredCoverage === undefined
+            ? []
+            : COVERAGE_CATEGORIES.filter((category) => (Object.prototype.hasOwnProperty.call(declaredCoverage, category)
+                && declaredCoverage[category] !== 'complete'));
+        recommendations.push(makeRecommendation('COVERAGE_INCOMPLETE', [], [], { incompleteCoverageCategories: [...declaredCategories, ...projection.incompleteCoverageCategories] }));
+    }
+    const staleEntries = broker.staleDeliveredEntries.filter((entry) => entry.stale);
+    if (staleEntries.length > 0) {
+        recommendations.push(makeRecommendation('CONTEXT_STALE', staleEntries.flatMap((entry) => entry.evidenceEventIds), staleEntries.map((entry) => entry.entryId)));
+    }
+    const verifiedPairs = broker.contradictoryMemoryPairs.filter((pair) => pair.verified);
+    if (verifiedPairs.length > 0) {
+        recommendations.push(makeRecommendation('CONTRADICTORY_MEMORY', verifiedPairs.flatMap((pair) => pair.evidenceEventIds), verifiedPairs.flatMap((pair) => [pair.leftEntryId, pair.rightEntryId])));
+    }
+    const eligibleCandidates = broker.promotionCandidates.filter((candidate) => candidate.eligible);
+    if (eligibleCandidates.length > 0) {
+        recommendations.push(makeRecommendation('PROMOTION_CANDIDATE', eligibleCandidates.flatMap((candidate) => [candidate.eventId, ...candidate.evidenceEventIds])));
+    }
+    return sortRecommendations(recommendations);
+}
+//# sourceMappingURL=recommendations.js.map

package/dist/context/recommendations.js.map

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

package/dist/context/run-state.d.ts

@@ -0,0 +1,26 @@
+import type { SqliteDatabase } from '../db/adapter.js';
+import type { TaskProfile } from '../akinator/types.js';
+import { type LedgerProjection } from '../ledger/projection.js';
+import { type RunRecord } from '../ledger/types.js';
+export interface ContextRunRetrievalState {
+    run: RunRecord;
+    profile: TaskProfile;
+    profileHash: string;
+    recommendedTags: string[];
+    intakeSessionId: string;
+    intakeStatus: 'active' | 'ready' | 'exhausted';
+    projection: LedgerProjection | null;
+    stateHash: string;
+}
+export interface ContextRunProfileBinding {
+    workspace: string;
+    intakeSessionId: string;
+    intakePolicyVersion: string;
+    initialProfileHash: string;
+    profileHash: string;
+}
+/** Verify the exact intake/profile binding at a persisted delivery cursor. */
+export declare function readContextRunProfileBinding(database: SqliteDatabase, runId: string, throughSequence: number): ContextRunProfileBinding;
+/** Read and validate the complete immutable input used by broker ranking/recommendations. */
+export declare function readContextRunRetrievalState(database: SqliteDatabase, runId: string): ContextRunRetrievalState;
+//# sourceMappingURL=run-state.d.ts.map

package/dist/context/run-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-state.d.ts","sourceRoot":"","sources":["../../src/context/run-state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAIvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD,OAAO,EAA2C,KAAK,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEzG,OAAO,EAKL,KAAK,SAAS,EACf,MAAM,oBAAoB,CAAC;AAgB5B,MAAM,WAAW,wBAAwB;IACvC,GAAG,EAAE,SAAS,CAAC;IACf,OAAO,EAAE,WAAW,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,QAAQ,GAAG,OAAO,GAAG,WAAW,CAAC;IAC/C,UAAU,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACpC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;IACxB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,WAAW,EAAE,MAAM,CAAC;CACrB;AA2PD,8EAA8E;AAC9E,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,cAAc,EACxB,KAAK,EAAE,MAAM,EACb,eAAe,EAAE,MAAM,GACtB,wBAAwB,CAiC1B;AAED,6FAA6F;AAC7F,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,cAAc,EACxB,KAAK,EAAE,MAAM,GACZ,wBAAwB,CA4G1B"}