kiokuko-dsh 0.1.0

package/dist/enno-oduno/advisory-store.js

@@ -0,0 +1,105 @@
+import { KiokukoError } from '../errors.js';
+import { canonicalJson } from '../serialization/validate.js';
+import { parseStrictJson } from '../setup/strict-json.js';
+import { parseStoredAdvisoryContribution } from './schemas.js';
+import { ADVISORY_PHASES, ADVISORY_POLICY_VERSION, } from './types.js';
+import { advisoryRoundAggregate, normalizeAdvisoryContributions } from './advisory.js';
+function roundRow(database, input) {
+    return database.prepare(`
+    SELECT round_id, run_id, contract_revision, mutation_revision, phase,
+           input_digest, policy_version, source, state, degraded, aggregate_json
+    FROM enno_advisory_rounds
+    WHERE run_id = ? AND contract_revision = ? AND mutation_revision = ?
+      AND phase = ? AND input_digest = ?
+  `).get(input.runId, input.contractRevision, input.mutationRevision, input.phase, input.inputDigest);
+}
+function parseStoredRound(database, row) {
+    if (row.policy_version !== ADVISORY_POLICY_VERSION || row.source !== 'host_reported' || !ADVISORY_PHASES.includes(row.phase)) {
+        throw new KiokukoError('INTEGRITY_ERROR', 'Stored advisory round metadata is invalid');
+    }
+    const contributions = database.prepare(`
+    SELECT contribution_json
+    FROM enno_advisory_contributions
+    WHERE round_id = ? ORDER BY slot_rank
+  `).all(row.round_id).map((item) => {
+        let parsed;
+        try {
+            parsed = parseStrictJson(item.contribution_json, { allowTrailingComma: false, disallowComments: true, allowEmptyContent: false }, 'Stored advisory contribution is invalid');
+        }
+        catch {
+            throw new KiokukoError('INTEGRITY_ERROR', 'Stored advisory contribution is invalid');
+        }
+        return parseStoredAdvisoryContribution(parsed);
+    });
+    const normalized = normalizeAdvisoryContributions(row.phase, contributions);
+    const aggregate = advisoryRoundAggregate(normalized);
+    if (Boolean(row.degraded) !== aggregate.degraded || canonicalJson(aggregate) !== row.aggregate_json) {
+        throw new KiokukoError('INTEGRITY_ERROR', 'Stored advisory round aggregate is invalid');
+    }
+    return {
+        phase: row.phase,
+        contractRevision: row.contract_revision,
+        mutationRevision: row.mutation_revision,
+        inputDigest: row.input_digest,
+        policyVersion: row.policy_version,
+        source: row.source,
+        state: row.state,
+        degraded: aggregate.degraded,
+        contributions: normalized,
+    };
+}
+export function readAdvisoryRound(database, input) {
+    const row = roundRow(database, input);
+    return row === undefined ? undefined : parseStoredRound(database, row);
+}
+export function readSubmittedAdvisoryRound(database, input) {
+    const row = database.prepare(`
+    SELECT round_id, run_id, contract_revision, mutation_revision, phase,
+           input_digest, policy_version, source, state, degraded, aggregate_json
+    FROM enno_advisory_rounds
+    WHERE run_id = ? AND contract_revision = ? AND mutation_revision = ? AND phase = ?
+    ORDER BY created_at DESC, round_id DESC
+    LIMIT 1
+  `).get(input.runId, input.contractRevision, input.mutationRevision, input.phase);
+    return row === undefined ? undefined : parseStoredRound(database, row);
+}
+export function createAdvisoryRoundInTransaction(database, input) {
+    const normalized = normalizeAdvisoryContributions(input.phase, input.contributions);
+    const aggregate = advisoryRoundAggregate(normalized);
+    const now = new Date().toISOString();
+    const roundId = `${input.runId}-${input.phase}-${input.contractRevision}-${input.mutationRevision}-${input.inputDigest.slice(0, 16)}`;
+    database.prepare(`
+    INSERT INTO enno_advisory_rounds (
+      round_id, run_id, contract_revision, mutation_revision, phase,
+      input_digest, policy_version, source, state, degraded, aggregate_json, created_at, updated_at
+    ) VALUES (?, ?, ?, ?, ?, ?, ?, 'host_reported', 'aggregated', ?, ?, ?, ?)
+  `).run(roundId, input.runId, input.contractRevision, input.mutationRevision, input.phase, input.inputDigest, ADVISORY_POLICY_VERSION, aggregate.degraded ? 1 : 0, canonicalJson(aggregate), now, now);
+    const statement = database.prepare(`
+    INSERT INTO enno_advisory_contributions (
+      round_id, slot_id, slot_rank, outcome, contribution_json, created_at
+    ) VALUES (?, ?, ?, ?, ?, ?)
+  `);
+    normalized.forEach((contribution, rank) => statement.run(roundId, contribution.slotId, rank, contribution.outcome, canonicalJson(contribution), now));
+    const created = roundRow(database, input);
+    if (created === undefined)
+        throw new KiokukoError('INTEGRITY_ERROR', 'Advisory round was not persisted');
+    return parseStoredRound(database, created);
+}
+export function ensureAdvisoryRoundConsumedInTransaction(database, input) {
+    const existing = roundRow(database, input);
+    if (existing === undefined)
+        throw new KiokukoError('CONFLICT', 'Required advisory round was not submitted');
+    const round = parseStoredRound(database, existing);
+    if (round.state === 'consumed')
+        return round;
+    const updated = database.prepare(`
+    UPDATE enno_advisory_rounds
+    SET state = 'consumed', updated_at = ?
+    WHERE round_id = ? AND state = 'aggregated'
+    RETURNING round_id
+  `).get(new Date().toISOString(), existing.round_id);
+    if (updated?.round_id !== existing.round_id)
+        throw new KiokukoError('CONFLICT', 'Advisory round changed concurrently');
+    return { ...round, state: 'consumed' };
+}
+//# sourceMappingURL=advisory-store.js.map

package/dist/enno-oduno/advisory-store.js.map

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

package/dist/enno-oduno/advisory.d.ts

@@ -0,0 +1,18 @@
+import { type AdvisoryContext, type AdvisoryContribution, type AdvisoryFanoutDirective, type AdvisoryPhase, type EnnoRunSnapshot } from './types.js';
+export declare function advisorySlotDefinitions(phase: AdvisoryPhase): AdvisoryFanoutDirective['slots'];
+export declare function advisoryInputDigest(input: {
+    phase: AdvisoryPhase;
+    contractRevision: number;
+    mutationRevision: number;
+    allowlistedContext: AdvisoryContext;
+}): string;
+export declare function advisoryPhaseForStatus(status: EnnoRunSnapshot['status']): AdvisoryPhase | null;
+export declare function projectRepositoryRelativePath(repositoryRoot: string, value: string): string;
+export declare function advisoryContextForSnapshot(snapshot: EnnoRunSnapshot, phase: AdvisoryPhase): AdvisoryContext;
+export declare function advisoryDirectiveForSnapshot(snapshot: EnnoRunSnapshot): AdvisoryFanoutDirective | undefined;
+export declare function normalizeAdvisoryContributions(phase: AdvisoryPhase, rawContributions: readonly AdvisoryContribution[]): AdvisoryContribution[];
+export declare function advisoryRoundAggregate(contributions: readonly AdvisoryContribution[]): {
+    contributions: AdvisoryContribution[];
+    degraded: boolean;
+};
+//# sourceMappingURL=advisory.d.ts.map

package/dist/enno-oduno/advisory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"advisory.d.ts","sourceRoot":"","sources":["../../src/enno-oduno/advisory.ts"],"names":[],"mappings":"AAMA,OAAO,EAQL,KAAK,eAAe,EACpB,KAAK,oBAAoB,EACzB,KAAK,uBAAuB,EAE5B,KAAK,aAAa,EAIlB,KAAK,eAAe,EAErB,MAAM,YAAY,CAAC;AAKpB,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,aAAa,GAAG,uBAAuB,CAAC,OAAO,CAAC,CAO9F;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE;IACzC,KAAK,EAAE,aAAa,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,kBAAkB,EAAE,eAAe,CAAC;CACrC,GAAG,MAAM,CAUT;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,eAAe,CAAC,QAAQ,CAAC,GAAG,aAAa,GAAG,IAAI,CAK9F;AAkBD,wBAAgB,6BAA6B,CAAC,cAAc,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAU3F;AAyFD,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,eAAe,EAAE,KAAK,EAAE,aAAa,GAAG,eAAe,CAmD3G;AAED,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,eAAe,GAAG,uBAAuB,GAAG,SAAS,CAe3G;AAoBD,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,aAAa,EACpB,gBAAgB,EAAE,SAAS,oBAAoB,EAAE,GAChD,oBAAoB,EAAE,CAmExB;AAED,wBAAgB,sBAAsB,CAAC,aAAa,EAAE,SAAS,oBAAoB,EAAE,GAAG;IACtF,aAAa,EAAE,oBAAoB,EAAE,CAAC;IACtC,QAAQ,EAAE,OAAO,CAAC;CACnB,CAUA"}

package/dist/enno-oduno/advisory.js

@@ -0,0 +1,310 @@
+import path from 'node:path';
+import { canonicalContentHash, canonicalJson } from '../serialization/validate.js';
+import { findSecret, findSecretInValue } from '../memory/secrets.js';
+import { KiokukoError } from '../errors.js';
+import { ennoValidationError } from './validation-errors.js';
+import { verifierCommandContainsSecret } from './sanitize.js';
+import { ADVISORY_FAILURE_CODES, ADVISORY_MAX_ROUND_BYTES, ADVISORY_MAX_SLOT_BYTES, ADVISORY_OUTCOMES, ADVISORY_POLICY_VERSION, ADVISORY_SLOT_DEFINITIONS, } from './types.js';
+const phaseSlots = (phase) => ADVISORY_SLOT_DEFINITIONS.filter((slot) => slot.phase === phase);
+const secretArgument = /(?:^|\s)--?(?:api[-_]?key|access[-_]?token|refresh[-_]?token|client[-_]?secret|password|passwd|secret)(?:=|\s+)\S+/iu;
+export function advisorySlotDefinitions(phase) {
+    return phaseSlots(phase).map((slot) => ({
+        slotId: slot.slotId,
+        rank: slot.rank,
+        role: slot.role,
+        instructions: `Act only as the ${slot.role}. Read-only isolation must be provided and verified by the parent host. Return a structured contribution for slot ${slot.slotId}; do not edit files, call Kiokuko tools, or claim independent execution guarantees.`,
+    }));
+}
+export function advisoryInputDigest(input) {
+    return canonicalContentHash({
+        version: 1,
+        phase: input.phase,
+        contractRevision: input.contractRevision,
+        mutationRevision: input.mutationRevision,
+        slotDefinitions: advisorySlotDefinitions(input.phase),
+        advisoryPolicyVersion: ADVISORY_POLICY_VERSION,
+        allowlistedContext: input.allowlistedContext,
+    });
+}
+export function advisoryPhaseForStatus(status) {
+    if (status === 'oduno_ideal')
+        return 'ideal';
+    if (status === 'zenki_planning')
+        return 'planning';
+    if (status === 'enno_verifying')
+        return 'final_review';
+    return null;
+}
+function skillTrustFromEntries(entries) {
+    return entries.slice(0, 64).map((entry) => {
+        const trustStatus = entry.availability === 'external_reference'
+            ? 'reference_only'
+            : entry.availability === 'unavailable'
+                ? 'unavailable'
+                : 'available';
+        return {
+            name: entry.name,
+            source: entry.availability,
+            required: entry.required,
+            trustStatus,
+        };
+    });
+}
+export function projectRepositoryRelativePath(repositoryRoot, value) {
+    if (value.includes('\0'))
+        return '#redacted';
+    if (value.split(/[\\/]/).includes('..'))
+        return '#redacted';
+    if (path.win32.isAbsolute(value) && !path.posix.isAbsolute(value))
+        return '#redacted';
+    if (path.posix.isAbsolute(value)) {
+        const relative = path.relative(repositoryRoot, value).split(path.sep).join('/');
+        if (relative === '' || relative === '..' || relative.startsWith('../'))
+            return '#redacted';
+        return relative;
+    }
+    return value;
+}
+function projectChangedPaths(repositoryRoot, paths) {
+    return paths.map((value) => projectRepositoryRelativePath(repositoryRoot, value));
+}
+function truncateUtf8(value, maxBytes) {
+    if (Buffer.byteLength(value, 'utf8') <= maxBytes)
+        return value;
+    let projected = '';
+    let bytes = 0;
+    for (const character of value) {
+        const characterBytes = Buffer.byteLength(character, 'utf8');
+        if (bytes + characterBytes > maxBytes)
+            break;
+        projected += character;
+        bytes += characterBytes;
+    }
+    return projected;
+}
+function escapeRegExp(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/gu, '\\$&');
+}
+function projectRepositoryText(repositoryRoot, value) {
+    if (findSecret(value) !== undefined)
+        return '#redacted';
+    const canonicalRoot = path.resolve(repositoryRoot);
+    const variants = new Set([
+        canonicalRoot,
+        canonicalRoot.split(path.sep).join('/'),
+        canonicalRoot.split(path.sep).join('\\'),
+    ]);
+    let projected = value;
+    for (const variant of variants) {
+        if (variant.length === 0)
+            continue;
+        projected = projected.replace(new RegExp(`${escapeRegExp(variant)}(?=$|[\\\\/\\s:;,)}\\]])`, 'gu'), '.');
+    }
+    return projected;
+}
+function finalReviewEvidence(repositoryRoot, evidence) {
+    return evidence.map((result) => {
+        const unsafeCommand = verifierCommandContainsSecret(result.verifier);
+        return {
+            id: result.verifier.id,
+            kind: result.verifier.kind,
+            executable: unsafeCommand ? '#redacted' : projectRepositoryText(repositoryRoot, result.verifier.executable),
+            args: unsafeCommand ? ['#redacted'] : result.verifier.args.map((argument) => projectRepositoryText(repositoryRoot, argument)),
+            directory: projectRepositoryRelativePath(repositoryRoot, result.verifier.cwd),
+            timeoutMs: result.verifier.timeoutMs,
+            status: result.status,
+            exitCode: result.exitCode,
+            signal: result.signal,
+            stdoutDigest: result.stdoutDigest,
+            stderrDigest: result.stderrDigest,
+            stdoutPreview: truncateUtf8(projectRepositoryText(repositoryRoot, result.stdoutPreview), 2_048),
+            stderrPreview: truncateUtf8(projectRepositoryText(repositoryRoot, result.stderrPreview), 2_048),
+            repositoryStatePolicyVersion: result.repositoryStatePolicyVersion ?? null,
+            repositoryStateDigest: result.repositoryStateDigest ?? null,
+        };
+    });
+}
+function finalReviewOutcomes(snapshot) {
+    return snapshot.workUnits
+        .filter((unit) => unit.status === 'completed' && unit.result !== null)
+        .map((unit) => ({
+        id: unit.workUnit.id,
+        objective: projectRepositoryText(snapshot.repositoryRoot, unit.workUnit.objective),
+        acceptanceCriteria: unit.workUnit.acceptanceCriteria.map((criterion) => projectRepositoryText(snapshot.repositoryRoot, criterion)),
+        routes: [...(unit.workUnit.routes ?? [])],
+        status: unit.result.outcome,
+        summary: projectRepositoryText(snapshot.repositoryRoot, unit.result.summary),
+        mutated: unit.result.mutated,
+        changedPaths: projectChangedPaths(snapshot.repositoryRoot, unit.result.changedPaths),
+    }));
+}
+const ADVISORY_MAX_CONTEXT_BYTES = 64 * 1024;
+function boundedAdvisoryContext(context) {
+    if (Buffer.byteLength(canonicalJson(context), 'utf8') > ADVISORY_MAX_CONTEXT_BYTES) {
+        throw new KiokukoError('CONFLICT', 'Enno advisory context exceeds the safety limit');
+    }
+    return context;
+}
+export function advisoryContextForSnapshot(snapshot, phase) {
+    if (phase === 'ideal') {
+        return boundedAdvisoryContext({
+            phase: 'ideal',
+            objective: snapshot.handoff.objective,
+            constraints: [...snapshot.handoff.constraints],
+            expectedOutcome: snapshot.handoff.expected ?? '',
+            successSignals: [...snapshot.handoff.verification],
+            skillTrust: skillTrustFromEntries(snapshot.contract.skillSet.entries),
+        });
+    }
+    if (phase === 'planning') {
+        return boundedAdvisoryContext({
+            phase: 'planning',
+            idealObjective: snapshot.ideal?.objective ?? snapshot.handoff.objective,
+            acceptanceCriteria: snapshot.contract.acceptanceCriteria.map((criterion) => criterion.description),
+            planningConstraints: [...snapshot.handoff.constraints],
+            skillAvailability: skillTrustFromEntries(snapshot.contract.skillSet.entries),
+        });
+    }
+    const changedPaths = projectChangedPaths(snapshot.repositoryRoot, [...new Set(snapshot.workUnits.flatMap((unit) => unit.result?.changedPaths ?? []))]);
+    const verifierEvidence = finalReviewEvidence(snapshot.repositoryRoot, snapshot.finalEvidence);
+    const repositoryStateDigest = verifierEvidence[0]?.repositoryStateDigest;
+    const evidenceFreshnessPolicyVersion = verifierEvidence[0]?.repositoryStatePolicyVersion;
+    if (repositoryStateDigest === null || repositoryStateDigest === undefined
+        || evidenceFreshnessPolicyVersion === null || evidenceFreshnessPolicyVersion === undefined) {
+        throw new KiokukoError('CONFLICT', 'Final review requires repository-state-bound verifier evidence');
+    }
+    return boundedAdvisoryContext({
+        phase: 'final_review',
+        workPlanSummary: projectRepositoryText(snapshot.repositoryRoot, snapshot.contract.workPlan.objective),
+        acceptanceCriteria: snapshot.contract.acceptanceCriteria.map((criterion) => ({
+            ...criterion,
+            description: projectRepositoryText(snapshot.repositoryRoot, criterion.description),
+        })),
+        workUnitOutcomes: finalReviewOutcomes(snapshot),
+        changedPaths,
+        verifierEvidence,
+        evidenceSetDigest: canonicalContentHash(verifierEvidence),
+        repositoryStateDigest,
+        evidenceFreshnessPolicyVersion,
+        freshnessMarker: canonicalContentHash({
+            revision: snapshot.revision,
+            mutationRevision: snapshot.mutationRevision,
+            evidenceProjection: verifierEvidence,
+            repositoryStateDigest,
+        }),
+    });
+}
+export function advisoryDirectiveForSnapshot(snapshot) {
+    const phase = advisoryPhaseForStatus(snapshot.status);
+    if (phase === null)
+        return undefined;
+    if (phase === 'final_review' && !snapshot.finalEvidenceReady)
+        return undefined;
+    if (snapshot.advisoryPhaseState !== undefined
+        && snapshot.advisoryPhaseState.state !== 'fanout_requested')
+        return undefined;
+    return {
+        protocolVersion: 1,
+        phase,
+        policyVersion: ADVISORY_POLICY_VERSION,
+        readOnlyRequired: true,
+        hostMustVerifyIsolation: true,
+        context: advisoryContextForSnapshot(snapshot, phase),
+        slots: advisorySlotDefinitions(phase),
+    };
+}
+function unsafeText(value) {
+    if (typeof value !== 'string')
+        return false;
+    return findSecret(value) !== undefined || secretArgument.test(value);
+}
+function contributionContainsSecret(contribution) {
+    return findSecretInValue(contribution) !== undefined
+        || unsafeText(canonicalJson(contribution));
+}
+function unsafeContribution(slotId) {
+    return { slotId, outcome: 'failed', reasonCode: 'unsafe_output' };
+}
+function canonicalByteLength(value) {
+    return Buffer.byteLength(canonicalJson(value), 'utf8');
+}
+export function normalizeAdvisoryContributions(phase, rawContributions) {
+    const slots = phaseSlots(phase);
+    const expected = new Set(slots.map((slot) => slot.slotId));
+    if (rawContributions.length !== slots.length) {
+        throw ennoValidationError('advice_submit', [{
+                path: ['contributions'],
+                reasonCode: 'advisory_slot_missing',
+                expected: { requiredSlotIds: [...expected] },
+            }]);
+    }
+    const bySlot = new Map();
+    for (const [index, contribution] of rawContributions.entries()) {
+        if (!expected.has(contribution.slotId)) {
+            throw ennoValidationError('advice_submit', [{
+                    path: ['contributions', index, 'slotId'],
+                    reasonCode: 'advisory_slot_missing',
+                    expected: { requiredSlotIds: [...expected] },
+                }]);
+        }
+        if (bySlot.has(contribution.slotId)) {
+            throw ennoValidationError('advice_submit', [{
+                    path: ['contributions', index, 'slotId'],
+                    reasonCode: 'advisory_slot_duplicate',
+                    expected: { requiredSlotIds: [...expected] },
+                }]);
+        }
+        if (!ADVISORY_OUTCOMES.includes(contribution.outcome)) {
+            throw ennoValidationError('advice_submit', [{
+                    path: ['contributions', index, 'outcome'],
+                    reasonCode: 'invalid_enum',
+                    expected: { allowedValues: [...ADVISORY_OUTCOMES] },
+                }]);
+        }
+        if (contribution.outcome === 'completed' && contributionContainsSecret(contribution)) {
+            bySlot.set(contribution.slotId, unsafeContribution(contribution.slotId));
+            continue;
+        }
+        if (contribution.outcome !== 'completed'
+            && (!contribution.reasonCode || !ADVISORY_FAILURE_CODES.includes(contribution.reasonCode))) {
+            throw ennoValidationError('advice_submit', [{
+                    path: ['contributions', index, 'reasonCode'],
+                    reasonCode: 'missing_required_field',
+                }]);
+        }
+        bySlot.set(contribution.slotId, { ...contribution });
+    }
+    if (bySlot.size !== slots.length) {
+        throw ennoValidationError('advice_submit', [{
+                path: ['contributions'],
+                reasonCode: 'advisory_slot_missing',
+                expected: { requiredSlotIds: [...expected] },
+            }]);
+    }
+    const normalized = slots.map((slot) => bySlot.get(slot.slotId));
+    if (normalized.some((contribution) => canonicalByteLength(contribution) > ADVISORY_MAX_SLOT_BYTES)) {
+        throw ennoValidationError('advice_submit', [{
+                path: ['contributions'],
+                reasonCode: 'too_many_items',
+            }]);
+    }
+    if (canonicalByteLength(normalized) > ADVISORY_MAX_ROUND_BYTES) {
+        throw ennoValidationError('advice_submit', [{
+                path: ['contributions'],
+                reasonCode: 'too_many_items',
+            }]);
+    }
+    return normalized;
+}
+export function advisoryRoundAggregate(contributions) {
+    return {
+        contributions: contributions.map((contribution) => ({
+            ...contribution,
+            ...(contribution.recommendations === undefined ? {} : { recommendations: [...contribution.recommendations] }),
+            ...(contribution.risks === undefined ? {} : { risks: [...contribution.risks] }),
+            ...(contribution.evidence === undefined ? {} : { evidence: contribution.evidence.map((evidence) => ({ ...evidence })) }),
+        })),
+        degraded: contributions.every((contribution) => contribution.outcome !== 'completed'),
+    };
+}
+//# sourceMappingURL=advisory.js.map

package/dist/enno-oduno/advisory.js.map

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

package/dist/enno-oduno/confirmation.d.ts

@@ -0,0 +1,4 @@
+import type { EnnoRunSnapshot, UserFacingConfirmation } from './types.js';
+export declare const MAX_CONFIRMATION_JSON_BYTES: number;
+export declare function buildUserFacingConfirmation(snapshot: EnnoRunSnapshot): UserFacingConfirmation | undefined;
+//# sourceMappingURL=confirmation.d.ts.map

package/dist/enno-oduno/confirmation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"confirmation.d.ts","sourceRoot":"","sources":["../../src/enno-oduno/confirmation.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAIV,eAAe,EAGf,sBAAsB,EAOvB,MAAM,YAAY,CAAC;AAEpB,eAAO,MAAM,2BAA2B,QAAY,CAAC;AA2GrD,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,eAAe,GAAG,sBAAsB,GAAG,SAAS,CA4BzG"}

package/dist/enno-oduno/confirmation.js

@@ -0,0 +1,127 @@
+import path from 'node:path';
+import { KiokukoError } from '../errors.js';
+import { findSecretInValue } from '../memory/secrets.js';
+import { canonicalJson } from '../serialization/validate.js';
+export const MAX_CONFIRMATION_JSON_BYTES = 64 * 1024;
+const BASIS_BY_PROVENANCE = {
+    explicit_user: 'user',
+    repository_evidence: 'repository',
+    inferred: 'proposal',
+};
+const EXPERT_AREAS = {
+    'code.boundary.v1': 'Input and data boundaries',
+    'code.domain.v1': 'Business rules and state transitions',
+    'code.effects.v1': 'Database, filesystem, network, and process effects',
+    'code.protocol.v1': 'Retries, conflicts, revisions, and compatibility',
+    'code.verification.v1': 'Regression prevention and verification design',
+    'code.modeling.v1': 'Problem shaping and representation design',
+    'ui.interaction.v1': 'Interaction states and feedback',
+    'ui.async.v1': 'Asynchronous work and recovery',
+    'ui.forms.v1': 'Forms and input validation',
+    'ui.accessibility.v1': 'Accessibility and navigation',
+    'ui.layout.v1': 'Responsive layout',
+    'ui.safety.v1': 'UI safety and review',
+};
+function basisFor(provenance, key) {
+    return BASIS_BY_PROVENANCE[provenance[key]];
+}
+function displayDirectory(cwd, repositoryRoot) {
+    if (!path.isAbsolute(cwd))
+        return cwd === '' ? '.' : cwd;
+    const relative = path.relative(repositoryRoot, cwd);
+    if (relative === '')
+        return '.';
+    if (relative === '..' || relative.startsWith(`..${path.sep}`) || path.isAbsolute(relative)) {
+        throw new KiokukoError('INTEGRITY_ERROR', 'Stored Enno verifier cwd escapes the repository root');
+    }
+    return relative;
+}
+function toUserFacingVerifier(verifier, repositoryRoot) {
+    return {
+        category: verifier.kind,
+        executable: verifier.executable,
+        arguments: [...verifier.args],
+        directory: displayDirectory(verifier.cwd, repositoryRoot),
+        timeoutMs: verifier.timeoutMs,
+    };
+}
+function toUserFacingSkill(entry, basis) {
+    return {
+        label: entry.name,
+        basis,
+        required: entry.required,
+        purposes: [...entry.purposes],
+        referenceOnly: entry.availability === 'external_reference',
+    };
+}
+function toUserFacingExpertise(reference, basis) {
+    const area = EXPERT_AREAS[reference.id];
+    if (area === undefined) {
+        throw new KiokukoError('INTEGRITY_ERROR', 'Stored Enno expert selection is outside the registered expert set');
+    }
+    return { area, basis, reason: reference.reason };
+}
+function workItemNumbers(units) {
+    const numbers = new Map();
+    units.forEach((unit, index) => {
+        numbers.set(unit.id, index + 1);
+    });
+    return numbers;
+}
+function toUserFacingWorkItem(unit, number, numbers, basis, repositoryRoot) {
+    return {
+        number,
+        summary: unit.objective,
+        paths: [...unit.scope],
+        dependsOn: unit.dependencies.map((dependency) => {
+            const resolved = numbers.get(dependency);
+            if (resolved === undefined) {
+                throw new KiokukoError('INTEGRITY_ERROR', 'Stored Enno WorkPlan dependency does not resolve to a displayed work item');
+            }
+            return resolved;
+        }),
+        doneWhen: [...unit.acceptanceCriteria],
+        checks: unit.focusedVerifiers.map((verifier) => toUserFacingVerifier(verifier, repositoryRoot)),
+        expertise: unit.expertRefs.map((reference) => toUserFacingExpertise(reference, basis)),
+    };
+}
+function assertDisplaySafety(confirmation) {
+    const secret = findSecretInValue(confirmation);
+    if (secret !== undefined) {
+        throw new KiokukoError('SECURITY_REJECTION', 'Plan confirmation resembles a secret and was not displayed', { kind: secret.kind });
+    }
+    if (Buffer.byteLength(canonicalJson(confirmation), 'utf8') > MAX_CONFIRMATION_JSON_BYTES) {
+        throw new KiokukoError('VALIDATION_ERROR', 'Plan confirmation exceeds the 64 KiB display limit and must be replanned');
+    }
+}
+export function buildUserFacingConfirmation(snapshot) {
+    if (snapshot.status !== 'needs_confirmation')
+        return undefined;
+    const contract = snapshot.contract;
+    const provenance = contract.provenance;
+    const workPlanBasis = basisFor(provenance, 'workPlan');
+    const skillBasis = basisFor(provenance, 'skillSet');
+    const numbers = workItemNumbers(contract.workPlan.units);
+    const confirmation = {
+        presentationVersion: 1,
+        title: 'Plan approval',
+        summary: { basis: workPlanBasis, text: contract.workPlan.objective },
+        scope: { basis: basisFor(provenance, 'scope'), paths: [...contract.scope] },
+        exclusions: { basis: basisFor(provenance, 'exclusions'), paths: [...contract.exclusions] },
+        completion: {
+            basis: basisFor(provenance, 'acceptanceCriteria'),
+            items: contract.acceptanceCriteria.map((criterion) => criterion.description),
+        },
+        skills: contract.skillSet.entries.map((entry) => toUserFacingSkill(entry, skillBasis)),
+        workItems: contract.workPlan.units.map((unit, index) => toUserFacingWorkItem(unit, index + 1, numbers, workPlanBasis, snapshot.repositoryRoot)),
+        finalChecks: {
+            basis: basisFor(provenance, 'finalVerifiers'),
+            checks: contract.finalVerifiers.map((verifier) => toUserFacingVerifier(verifier, snapshot.repositoryRoot)),
+        },
+        attemptLimit: { basis: basisFor(provenance, 'maxAttempts'), maxAttempts: contract.maxAttempts },
+        actions: ['approve', 'revise', 'cancel'],
+    };
+    assertDisplaySafety(confirmation);
+    return confirmation;
+}
+//# sourceMappingURL=confirmation.js.map

package/dist/enno-oduno/confirmation.js.map

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

package/dist/enno-oduno/directives.d.ts

@@ -0,0 +1,12 @@
+import type { AkinatorQuestion } from '../akinator/types.js';
+import type { EnnoClientKind, EnnoRunSnapshot, RoleDirective } from './types.js';
+export declare function directiveForRun(snapshot: EnnoRunSnapshot): RoleDirective | null;
+export declare function directiveForIntake(input: {
+    runId: string;
+    orchestrationId: string;
+    clientKind: EnnoClientKind | null;
+    clientVersion: string | null;
+    question: AkinatorQuestion | null;
+}): RoleDirective;
+export declare function assertDirectiveRevision(snapshot: EnnoRunSnapshot, revision: number): void;
+//# sourceMappingURL=directives.d.ts.map

package/dist/enno-oduno/directives.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"directives.d.ts","sourceRoot":"","sources":["../../src/enno-oduno/directives.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAQ7D,OAAO,KAAK,EACV,cAAc,EAEd,eAAe,EAEf,aAAa,EAKd,MAAM,YAAY,CAAC;AAqKpB,wBAAgB,eAAe,CAAC,QAAQ,EAAE,eAAe,GAAG,aAAa,GAAG,IAAI,CA6G/E;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,cAAc,GAAG,IAAI,CAAC;IAClC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,EAAE,gBAAgB,GAAG,IAAI,CAAC;CACnC,GAAG,aAAa,CAsBhB;AAED,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAIzF"}