kiokuko-dsh 0.1.0

package/dist/enno-oduno/validation-errors.d.ts

@@ -0,0 +1,93 @@
+import * as z from 'zod/v4';
+import { KiokukoError } from '../errors.js';
+export declare const ENNO_INPUT_INVALID_DETAIL_KEY: "publicEnnoValidationError";
+export declare const ENNO_VALIDATION_PRESENTATION_VERSION: 1;
+export declare const ENNO_MAX_PUBLIC_ISSUES = 16;
+export declare const ENNO_VALIDATION_OPERATIONS: readonly ["ideal_submit", "plan_submit", "advice_submit", "advice_read", "work_report", "verify_prepare", "finish", "meditation_submit"];
+export type EnnoValidationOperation = (typeof ENNO_VALIDATION_OPERATIONS)[number];
+export declare const ENNO_VALIDATION_REASONS: readonly ["missing_required_field", "unknown_field", "invalid_type", "invalid_enum", "non_canonical_text", "too_many_items", "too_few_items", "duplicate_id", "unknown_dependency", "dependency_cycle", "undeclared_skill", "unknown_expert", "duplicate_expert", "missing_code_expert", "missing_ui_expert", "invalid_work_unit_route", "invalid_verifier_directory", "duplicate_verifier_id", "advisory_digest_requires_disposition", "advisory_consumption_required", "advisory_slot_missing", "advisory_slot_duplicate", "advisory_digest_stale"];
+export type PublicEnnoValidationReason = (typeof ENNO_VALIDATION_REASONS)[number];
+export interface PublicEnnoValidationExpected {
+    minItems?: number;
+    maxItems?: number;
+    allowedValues?: string[];
+    requiredExpertKinds?: Array<'code' | 'ui'>;
+    requiredSlotIds?: string[];
+    directoryPolicy?: 'repository_relative';
+}
+export interface PublicEnnoValidationIssue {
+    path: Array<string | number>;
+    reasonCode: PublicEnnoValidationReason;
+    expected?: PublicEnnoValidationExpected;
+}
+export interface PublicEnnoValidationError {
+    code: 'ENNO_INPUT_INVALID';
+    operation: EnnoValidationOperation;
+    presentationVersion: typeof ENNO_VALIDATION_PRESENTATION_VERSION;
+    issues: PublicEnnoValidationIssue[];
+    retry: 'correct_input' | 'refresh_state' | 'stop';
+    mutationApplied: false;
+}
+export declare const publicEnnoValidationErrorSchema: z.ZodObject<{
+    code: z.ZodLiteral<"ENNO_INPUT_INVALID">;
+    operation: z.ZodEnum<{
+        finish: "finish";
+        ideal_submit: "ideal_submit";
+        plan_submit: "plan_submit";
+        advice_submit: "advice_submit";
+        advice_read: "advice_read";
+        work_report: "work_report";
+        verify_prepare: "verify_prepare";
+        meditation_submit: "meditation_submit";
+    }>;
+    presentationVersion: z.ZodLiteral<1>;
+    issues: z.ZodArray<z.ZodObject<{
+        path: z.ZodArray<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        reasonCode: z.ZodEnum<{
+            invalid_type: "invalid_type";
+            invalid_enum: "invalid_enum";
+            missing_required_field: "missing_required_field";
+            unknown_field: "unknown_field";
+            non_canonical_text: "non_canonical_text";
+            too_many_items: "too_many_items";
+            too_few_items: "too_few_items";
+            duplicate_id: "duplicate_id";
+            unknown_dependency: "unknown_dependency";
+            dependency_cycle: "dependency_cycle";
+            undeclared_skill: "undeclared_skill";
+            unknown_expert: "unknown_expert";
+            duplicate_expert: "duplicate_expert";
+            missing_code_expert: "missing_code_expert";
+            missing_ui_expert: "missing_ui_expert";
+            invalid_work_unit_route: "invalid_work_unit_route";
+            invalid_verifier_directory: "invalid_verifier_directory";
+            duplicate_verifier_id: "duplicate_verifier_id";
+            advisory_digest_requires_disposition: "advisory_digest_requires_disposition";
+            advisory_consumption_required: "advisory_consumption_required";
+            advisory_slot_missing: "advisory_slot_missing";
+            advisory_slot_duplicate: "advisory_slot_duplicate";
+            advisory_digest_stale: "advisory_digest_stale";
+        }>;
+        expected: z.ZodOptional<z.ZodObject<{
+            minItems: z.ZodOptional<z.ZodNumber>;
+            maxItems: z.ZodOptional<z.ZodNumber>;
+            allowedValues: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            requiredExpertKinds: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+                code: "code";
+                ui: "ui";
+            }>>>;
+            requiredSlotIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            directoryPolicy: z.ZodOptional<z.ZodLiteral<"repository_relative">>;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    retry: z.ZodEnum<{
+        stop: "stop";
+        correct_input: "correct_input";
+        refresh_state: "refresh_state";
+    }>;
+    mutationApplied: z.ZodLiteral<false>;
+}, z.core.$strict>;
+export declare function publicIssuesFromZod(error: z.ZodError): PublicEnnoValidationIssue[];
+export declare function ennoValidationError(operation: EnnoValidationOperation, issues: readonly PublicEnnoValidationIssue[], retry?: PublicEnnoValidationError['retry']): KiokukoError;
+export declare function ennoZodValidationError(operation: EnnoValidationOperation, error: z.ZodError): KiokukoError;
+//# sourceMappingURL=validation-errors.d.ts.map

package/dist/enno-oduno/validation-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-errors.d.ts","sourceRoot":"","sources":["../../src/enno-oduno/validation-errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,eAAO,MAAM,6BAA6B,EAAG,2BAAoC,CAAC;AAClF,eAAO,MAAM,oCAAoC,EAAG,CAAU,CAAC;AAC/D,eAAO,MAAM,sBAAsB,KAAK,CAAC;AAEzC,eAAO,MAAM,0BAA0B,0IAS7B,CAAC;AACX,MAAM,MAAM,uBAAuB,GAAG,CAAC,OAAO,0BAA0B,CAAC,CAAC,MAAM,CAAC,CAAC;AAElF,eAAO,MAAM,uBAAuB,uhBAwB1B,CAAC;AACX,MAAM,MAAM,0BAA0B,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AAElF,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,mBAAmB,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC3C,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,eAAe,CAAC,EAAE,qBAAqB,CAAC;CACzC;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IAC7B,UAAU,EAAE,0BAA0B,CAAC;IACvC,QAAQ,CAAC,EAAE,4BAA4B,CAAC;CACzC;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,oBAAoB,CAAC;IAC3B,SAAS,EAAE,uBAAuB,CAAC;IACnC,mBAAmB,EAAE,OAAO,oCAAoC,CAAC;IACjE,MAAM,EAAE,yBAAyB,EAAE,CAAC;IACpC,KAAK,EAAE,eAAe,GAAG,eAAe,GAAG,MAAM,CAAC;IAClD,eAAe,EAAE,KAAK,CAAC;CACxB;AAWD,eAAO,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAWjC,CAAC;AAoEZ,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,CAAC,CAAC,QAAQ,GAAG,yBAAyB,EAAE,CAElF;AAED,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,uBAAuB,EAClC,MAAM,EAAE,SAAS,yBAAyB,EAAE,EAC5C,KAAK,GAAE,yBAAyB,CAAC,OAAO,CAAmB,GAC1D,YAAY,CAkBd;AAED,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,uBAAuB,EAClC,KAAK,EAAE,CAAC,CAAC,QAAQ,GAChB,YAAY,CAEd"}

package/dist/enno-oduno/validation-errors.js

@@ -0,0 +1,152 @@
+import * as z from 'zod/v4';
+import { KiokukoError } from '../errors.js';
+export const ENNO_INPUT_INVALID_DETAIL_KEY = 'publicEnnoValidationError';
+export const ENNO_VALIDATION_PRESENTATION_VERSION = 1;
+export const ENNO_MAX_PUBLIC_ISSUES = 16;
+export const ENNO_VALIDATION_OPERATIONS = [
+    'ideal_submit',
+    'plan_submit',
+    'advice_submit',
+    'advice_read',
+    'work_report',
+    'verify_prepare',
+    'finish',
+    'meditation_submit',
+];
+export const ENNO_VALIDATION_REASONS = [
+    'missing_required_field',
+    'unknown_field',
+    'invalid_type',
+    'invalid_enum',
+    'non_canonical_text',
+    'too_many_items',
+    'too_few_items',
+    'duplicate_id',
+    'unknown_dependency',
+    'dependency_cycle',
+    'undeclared_skill',
+    'unknown_expert',
+    'duplicate_expert',
+    'missing_code_expert',
+    'missing_ui_expert',
+    'invalid_work_unit_route',
+    'invalid_verifier_directory',
+    'duplicate_verifier_id',
+    'advisory_digest_requires_disposition',
+    'advisory_consumption_required',
+    'advisory_slot_missing',
+    'advisory_slot_duplicate',
+    'advisory_digest_stale',
+];
+const publicExpectedSchema = z.object({
+    minItems: z.number().int().min(0).max(1_000_000).optional(),
+    maxItems: z.number().int().min(0).max(1_000_000).optional(),
+    allowedValues: z.array(z.string().min(1).max(100)).max(32).optional(),
+    requiredExpertKinds: z.array(z.enum(['code', 'ui'])).max(2).optional(),
+    requiredSlotIds: z.array(z.string().min(1).max(100)).max(3).optional(),
+    directoryPolicy: z.literal('repository_relative').optional(),
+}).strict();
+export const publicEnnoValidationErrorSchema = z.object({
+    code: z.literal('ENNO_INPUT_INVALID'),
+    operation: z.enum(ENNO_VALIDATION_OPERATIONS),
+    presentationVersion: z.literal(ENNO_VALIDATION_PRESENTATION_VERSION),
+    issues: z.array(z.object({
+        path: z.array(z.union([z.string().min(1).max(256), z.number().int().min(0).max(1_000)])).max(12),
+        reasonCode: z.enum(ENNO_VALIDATION_REASONS),
+        expected: publicExpectedSchema.optional(),
+    }).strict()).min(1).max(ENNO_MAX_PUBLIC_ISSUES),
+    retry: z.enum(['correct_input', 'refresh_state', 'stop']),
+    mutationApplied: z.literal(false),
+}).strict();
+function boundedPath(path) {
+    return path.slice(0, 12).map((segment) => {
+        if (typeof segment === 'number' && Number.isSafeInteger(segment) && segment >= 0)
+            return Math.min(segment, 1_000);
+        if (typeof segment !== 'string' || !/^[A-Za-z][A-Za-z0-9_-]{0,255}$/u.test(segment))
+            return 'field';
+        return segment;
+    });
+}
+const customReasons = [
+    [/canonical text/iu, 'non_canonical_text'],
+    [/Verifier IDs must be unique/iu, 'duplicate_verifier_id'],
+    [/WorkUnit IDs must be unique/iu, 'duplicate_id'],
+    [/invalid dependency/iu, 'unknown_dependency'],
+    [/dependencies must be acyclic/iu, 'dependency_cycle'],
+    [/undeclared Skill/iu, 'undeclared_skill'],
+    [/expertRefs must be unique/iu, 'duplicate_expert'],
+    [/repository-relative/iu, 'invalid_verifier_directory'],
+    [/advisoryDisposition is required/iu, 'advisory_digest_requires_disposition'],
+];
+function numericLimit(issue) {
+    const candidate = issue.maximum
+        ?? issue.minimum;
+    return typeof candidate === 'number' && Number.isFinite(candidate) ? Math.max(0, Math.trunc(candidate)) : undefined;
+}
+function issueProjection(issue) {
+    const path = boundedPath([...issue.path]);
+    if (issue.code === 'unrecognized_keys')
+        return { path, reasonCode: 'unknown_field' };
+    if (issue.code === 'invalid_type') {
+        return { path, reasonCode: /received undefined$/u.test(issue.message) ? 'missing_required_field' : 'invalid_type' };
+    }
+    if (issue.code === 'invalid_value') {
+        const values = issue.values;
+        const last = path.at(-1);
+        const reasonCode = last === 'id' && path.includes('expertRefs')
+            ? 'unknown_expert'
+            : last === 'slotId' && path.includes('advisoryDisposition')
+                ? 'advisory_slot_missing'
+                : path.includes('routes') ? 'invalid_work_unit_route' : 'invalid_enum';
+        return {
+            path,
+            reasonCode,
+            ...(Array.isArray(values) && values.every((value) => typeof value === 'string')
+                ? { expected: { allowedValues: values.slice(0, 32) } }
+                : {}),
+        };
+    }
+    if (issue.code === 'too_big') {
+        const maximum = numericLimit(issue);
+        return { path, reasonCode: 'too_many_items', ...(maximum === undefined ? {} : { expected: { maxItems: maximum } }) };
+    }
+    if (issue.code === 'too_small') {
+        const minimum = numericLimit(issue);
+        return { path, reasonCode: 'too_few_items', ...(minimum === undefined ? {} : { expected: { minItems: minimum } }) };
+    }
+    for (const [pattern, reasonCode] of customReasons) {
+        if (pattern.test(issue.message)) {
+            return reasonCode === 'invalid_verifier_directory'
+                ? { path, reasonCode, expected: { directoryPolicy: 'repository_relative' } }
+                : { path, reasonCode };
+        }
+    }
+    return { path, reasonCode: 'invalid_type' };
+}
+export function publicIssuesFromZod(error) {
+    return error.issues.slice(0, ENNO_MAX_PUBLIC_ISSUES).map(issueProjection);
+}
+export function ennoValidationError(operation, issues, retry = 'correct_input') {
+    const candidate = {
+        code: 'ENNO_INPUT_INVALID',
+        operation,
+        presentationVersion: ENNO_VALIDATION_PRESENTATION_VERSION,
+        issues: issues.slice(0, ENNO_MAX_PUBLIC_ISSUES).map((issue) => ({
+            path: [...issue.path],
+            reasonCode: issue.reasonCode,
+            ...(issue.expected === undefined ? {} : { expected: { ...issue.expected } }),
+        })),
+        retry,
+        mutationApplied: false,
+    };
+    const parsed = publicEnnoValidationErrorSchema.safeParse(candidate);
+    if (!parsed.success)
+        return new KiokukoError('INTEGRITY_ERROR', 'Public Enno validation projection is invalid');
+    return new KiokukoError('VALIDATION_ERROR', 'Enno input is invalid', {
+        [ENNO_INPUT_INVALID_DETAIL_KEY]: parsed.data,
+    });
+}
+export function ennoZodValidationError(operation, error) {
+    return ennoValidationError(operation, publicIssuesFromZod(error));
+}
+//# sourceMappingURL=validation-errors.js.map

package/dist/enno-oduno/validation-errors.js.map

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

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

@@ -0,0 +1,10 @@
+import { spawn } from 'node:child_process';
+import type { VerifierRunResult, VerifierSpec } from './types.js';
+export interface VerifierDependencies {
+    spawn?: typeof spawn;
+    now?: () => number;
+    descendantSettleMs?: number;
+}
+export declare function runVerifier(rawVerifier: VerifierSpec, repositoryRoot: string, dependencies?: VerifierDependencies): Promise<VerifierRunResult>;
+export declare function runVerifiers(verifiers: readonly VerifierSpec[], repositoryRoot: string, dependencies?: VerifierDependencies): Promise<VerifierRunResult[]>;
+//# sourceMappingURL=verifier.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"verifier.d.ts","sourceRoot":"","sources":["../../src/enno-oduno/verifier.ts"],"names":[],"mappings":"AACA,OAAO,EAAgB,KAAK,EAA4B,MAAM,oBAAoB,CAAC;AAQnF,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAKlE,MAAM,WAAW,oBAAoB;IACnC,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAmED,wBAAsB,WAAW,CAC/B,WAAW,EAAE,YAAY,EACzB,cAAc,EAAE,MAAM,EACtB,YAAY,GAAE,oBAAyB,GACtC,OAAO,CAAC,iBAAiB,CAAC,CA+G5B;AAED,wBAAsB,YAAY,CAChC,SAAS,EAAE,SAAS,YAAY,EAAE,EAClC,cAAc,EAAE,MAAM,EACtB,YAAY,GAAE,oBAAyB,GACtC,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAY9B"}

package/dist/enno-oduno/verifier.js

@@ -0,0 +1,214 @@
+import { createHash } from 'node:crypto';
+import { execFileSync, spawn } from 'node:child_process';
+import { unwatchFile, watchFile } from 'node:fs';
+import { performance } from 'node:perf_hooks';
+import path from 'node:path';
+import { canonicalDirectory } from '../repository/detect-root.js';
+import { captureRepositoryState } from './repository-state.js';
+import { assertVerifierCwd, parseVerifierSpec } from './schemas.js';
+const MAX_PREVIEW_BYTES = 8 * 1024;
+const DESCENDANT_SETTLE_MS = 500;
+function repositoryMutationAudit(repositoryRoot) {
+    let changed = false;
+    let baselineDigest;
+    const watched = [];
+    try {
+        baselineDigest = captureRepositoryState(repositoryRoot).digest;
+    }
+    catch {
+        changed = true;
+    }
+    const observeRepositoryState = () => {
+        if (changed || baselineDigest === undefined)
+            return;
+        try {
+            if (captureRepositoryState(repositoryRoot).digest !== baselineDigest)
+                changed = true;
+        }
+        catch {
+            changed = true;
+        }
+    };
+    try {
+        const paths = execFileSync('git', [
+            '-C', repositoryRoot, 'ls-files', '--cached', '--others', '--exclude-standard', '-z',
+        ], { encoding: 'utf8', maxBuffer: 16 * 1024 * 1024, stdio: ['ignore', 'pipe', 'ignore'] }).split('\0').filter(Boolean);
+        const targets = new Set([repositoryRoot]);
+        const trackedFiles = new Set();
+        for (const candidate of paths) {
+            const target = path.resolve(repositoryRoot, candidate);
+            if (target !== repositoryRoot && !target.startsWith(`${repositoryRoot}${path.sep}`))
+                throw new Error('invalid Git path');
+            targets.add(target);
+            trackedFiles.add(target);
+            targets.add(path.dirname(target));
+        }
+        for (const target of targets) {
+            const listener = (current, previous) => {
+                if (current.mtimeMs !== previous.mtimeMs || current.ctimeMs !== previous.ctimeMs
+                    || current.size !== previous.size || current.ino !== previous.ino) {
+                    if (trackedFiles.has(target))
+                        changed = true;
+                    else
+                        observeRepositoryState();
+                }
+            };
+            watchFile(target, { persistent: false, interval: 20 }, listener);
+            watched.push({ target, listener });
+        }
+    }
+    catch {
+        // Evidence cannot be called mutation-free when the audit boundary is unavailable.
+        changed = true;
+    }
+    return {
+        close: () => watched.forEach(({ target, listener }) => unwatchFile(target, listener)),
+        observed: () => {
+            // File notifications are an optimization, not the completeness boundary:
+            // a detached descendant can finish between polling callbacks.
+            observeRepositoryState();
+            return changed;
+        },
+    };
+}
+function appendPreview(current, chunk) {
+    if (current.byteLength >= MAX_PREVIEW_BYTES)
+        return current;
+    return Buffer.concat([current, chunk.subarray(0, MAX_PREVIEW_BYTES - current.byteLength)]);
+}
+function digestHex(hash) {
+    return hash.digest('hex');
+}
+export async function runVerifier(rawVerifier, repositoryRoot, dependencies = {}) {
+    const verifier = parseVerifierSpec(rawVerifier);
+    const canonicalRoot = canonicalDirectory(repositoryRoot);
+    const canonicalCwd = canonicalDirectory(path.isAbsolute(verifier.cwd)
+        ? verifier.cwd
+        : path.resolve(canonicalRoot, verifier.cwd));
+    const normalized = { ...verifier, cwd: canonicalCwd };
+    assertVerifierCwd(canonicalRoot, normalized);
+    const start = dependencies.now?.() ?? performance.now();
+    const stdoutHash = createHash('sha256');
+    const stderrHash = createHash('sha256');
+    let stdoutPreview = Buffer.alloc(0);
+    let stderrPreview = Buffer.alloc(0);
+    let child;
+    try {
+        child = (dependencies.spawn ?? spawn)(normalized.executable, normalized.args, {
+            cwd: normalized.cwd,
+            detached: process.platform !== 'win32',
+            shell: false,
+            stdio: ['ignore', 'pipe', 'pipe'],
+            windowsHide: true,
+        });
+    }
+    catch {
+        return {
+            verifier: { ...verifier, args: [...verifier.args] },
+            status: 'spawn_failed',
+            exitCode: null,
+            signal: null,
+            durationMs: Math.max(0, Math.round((dependencies.now?.() ?? performance.now()) - start)),
+            stdoutPreview: '',
+            stderrPreview: '',
+            stdoutDigest: createHash('sha256').digest('hex'),
+            stderrDigest: createHash('sha256').digest('hex'),
+        };
+    }
+    child.stdout.on('data', (chunk) => {
+        const bytes = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
+        stdoutHash.update(bytes);
+        stdoutPreview = appendPreview(stdoutPreview, bytes);
+    });
+    child.stderr.on('data', (chunk) => {
+        const bytes = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
+        stderrHash.update(bytes);
+        stderrPreview = appendPreview(stderrPreview, bytes);
+    });
+    const completion = await new Promise((resolve) => {
+        let settled = false;
+        let timedOut = false;
+        let killTimer;
+        let forceKillAttempted = false;
+        const settle = (value) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            if (killTimer !== undefined)
+                clearTimeout(killTimer);
+            resolve(value);
+        };
+        const tryKill = (signal) => {
+            try {
+                if (process.platform !== 'win32' && child.pid !== undefined) {
+                    process.kill(-child.pid, signal);
+                    return true;
+                }
+                return child.kill(signal);
+            }
+            catch {
+                return false;
+            }
+        };
+        const forceKill = () => {
+            if (settled || forceKillAttempted)
+                return;
+            forceKillAttempted = true;
+            tryKill('SIGKILL');
+        };
+        const timer = setTimeout(() => {
+            timedOut = true;
+            if (!tryKill('SIGTERM'))
+                forceKill();
+            if (!forceKillAttempted) {
+                killTimer = setTimeout(forceKill, 1_000);
+                killTimer.unref();
+            }
+        }, normalized.timeoutMs);
+        timer.unref();
+        child.on('error', () => {
+            if (timedOut) {
+                // A failed termination request is not completion; force the child down and wait for close.
+                forceKill();
+                return;
+            }
+            settle({ status: 'spawn_failed', exitCode: null, signal: null });
+        });
+        child.once('close', (code, signal) => {
+            if (!timedOut)
+                tryKill('SIGTERM');
+            settle({
+                status: timedOut ? 'timeout' : code === 0 ? 'passed' : 'failed',
+                exitCode: timedOut ? null : code,
+                signal: timedOut ? signal ?? 'SIGTERM' : signal,
+            });
+        });
+    });
+    return {
+        verifier: { ...verifier, args: [...verifier.args] },
+        ...completion,
+        durationMs: Math.max(0, Math.round((dependencies.now?.() ?? performance.now()) - start)),
+        stdoutPreview: stdoutPreview.toString('utf8'),
+        stderrPreview: stderrPreview.toString('utf8'),
+        stdoutDigest: digestHex(stdoutHash),
+        stderrDigest: digestHex(stderrHash),
+    };
+}
+export async function runVerifiers(verifiers, repositoryRoot, dependencies = {}) {
+    const audit = repositoryMutationAudit(repositoryRoot);
+    const results = [];
+    try {
+        for (const verifier of verifiers)
+            results.push(await runVerifier(verifier, repositoryRoot, dependencies));
+        const settleMs = dependencies.descendantSettleMs ?? DESCENDANT_SETTLE_MS;
+        if (settleMs > 0)
+            await new Promise((resolve) => setTimeout(resolve, settleMs));
+        const changedDuringVerification = audit.observed();
+        return results.map((result) => ({ ...result, changedDuringVerification }));
+    }
+    finally {
+        audit.close();
+    }
+}
+//# sourceMappingURL=verifier.js.map

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

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

package/dist/enno-oduno/zenki.d.mts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=zenki.d.mts.map

package/dist/enno-oduno/zenki.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zenki.d.mts","sourceRoot":"","sources":["../../src/enno-oduno/zenki.mts"],"names":[],"mappings":""}

package/dist/enno-oduno/zenki.mjs

@@ -0,0 +1,3 @@
+import { runRoleScript } from './role-runner.js';
+await runRoleScript('zenki');
+//# sourceMappingURL=zenki.mjs.map

package/dist/enno-oduno/zenki.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"zenki.mjs","sourceRoot":"","sources":["../../src/enno-oduno/zenki.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,MAAM,aAAa,CAAC,OAAO,CAAC,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,13 @@
+export type ErrorCode = 'USAGE_ERROR' | 'VALIDATION_ERROR' | 'NOT_FOUND' | 'CONFLICT' | 'DATABASE_ERROR' | 'BACKPRESSURE' | 'SERVICE_UNAVAILABLE' | 'SECURITY_REJECTION' | 'AUTHENTICATION_ERROR' | 'INTEGRITY_ERROR' | 'PARTIAL_FAILURE' | 'NOT_IMPLEMENTED';
+export declare class KiokukoError extends Error {
+    readonly code: ErrorCode;
+    readonly details: Record<string, unknown>;
+    readonly exitCode: number;
+    constructor(code: ErrorCode, message: string, details?: Record<string, unknown>);
+}
+export declare const STORED_MEMORY_RECOVERY_MESSAGE: string;
+export declare function storedMemoryIntegrityError(): KiokukoError;
+export declare const DATABASE_BACKUP_RECOVERY_MESSAGE: string;
+export declare function databaseBackupIntegrityError(cause?: unknown): KiokukoError;
+export declare function exitCodeFor(error: unknown): number;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GACjB,aAAa,GACb,kBAAkB,GAClB,WAAW,GACX,UAAU,GACV,gBAAgB,GAChB,cAAc,GACd,qBAAqB,GACrB,oBAAoB,GACpB,sBAAsB,GACtB,iBAAiB,GACjB,iBAAiB,GACjB,iBAAiB,CAAC;AAiBtB,qBAAa,YAAa,SAAQ,KAAK;IAInC,QAAQ,CAAC,IAAI,EAAE,SAAS;IAExB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAL3C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAGf,IAAI,EAAE,SAAS,EACxB,OAAO,EAAE,MAAM,EACN,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;CAMjD;AAED,eAAO,MAAM,8BAA8B,QAa/B,CAAC;AAEb,wBAAgB,0BAA0B,IAAI,YAAY,CAEzD;AAED,eAAO,MAAM,gCAAgC,QAIjC,CAAC;AAEb,wBAAgB,4BAA4B,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,YAAY,CAI1E;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAGlD"}

package/dist/errors.js

@@ -0,0 +1,60 @@
+const EXIT_CODES = {
+    USAGE_ERROR: 2,
+    VALIDATION_ERROR: 3,
+    NOT_FOUND: 4,
+    CONFLICT: 5,
+    DATABASE_ERROR: 6,
+    BACKPRESSURE: 6,
+    SERVICE_UNAVAILABLE: 6,
+    SECURITY_REJECTION: 7,
+    AUTHENTICATION_ERROR: 7,
+    INTEGRITY_ERROR: 8,
+    PARTIAL_FAILURE: 9,
+    NOT_IMPLEMENTED: 2,
+};
+export class KiokukoError extends Error {
+    code;
+    details;
+    exitCode;
+    constructor(code, message, details = {}) {
+        super(message);
+        this.code = code;
+        this.details = details;
+        this.name = 'KiokukoError';
+        this.exitCode = EXIT_CODES[code];
+    }
+}
+export const STORED_MEMORY_RECOVERY_MESSAGE = [
+    'Stored entry or revision is invalid.',
+    'Kiokuko setup could not automatically recover existing saved memory.',
+    'Recovery:',
+    '1. Keep the latest verified SQLite backup; setup creates one automatically before a pending database upgrade.',
+    '2. If the memory is needed, keep the backup and do not delete database rows manually.',
+    '3. Restore the backup as one SQLite snapshot: move the current database and any -wal, -shm, or -journal sidecar files aside, copy the backup to the original database path, and rerun: kiokuko setup.',
+    '   macOS database path: "$HOME/Library/Application Support/kiokuko/kiokuko.sqlite3"',
+    '   Linux database path: "${XDG_DATA_HOME:-$HOME/.local/share}/kiokuko/kiokuko.sqlite3"',
+    '   Example (replace <new-backup.sqlite3> and choose an unused <timestamp>):',
+    '   DB="$HOME/Library/Application Support/kiokuko/kiokuko.sqlite3"; for SUFFIX in "" -wal -shm -journal; do [ -e "$DB$SUFFIX" ] && mv "$DB$SUFFIX" "$DB$SUFFIX.before-restore-<timestamp>"; done; cp "<new-backup.sqlite3>" "$DB"; kiokuko setup',
+    '4. If the old memory is disposable, moving the database file aside and rerunning kiokuko setup creates a new database.',
+    '5. Keep the .before-restore file until the restored memory has been verified. Do not delete database rows manually.',
+].join('\n');
+export function storedMemoryIntegrityError() {
+    return new KiokukoError('INTEGRITY_ERROR', STORED_MEMORY_RECOVERY_MESSAGE);
+}
+export const DATABASE_BACKUP_RECOVERY_MESSAGE = [
+    'Database backup could not be created; the source database was not changed.',
+    'Check that Node.js is version 24.16.0 or newer and that the backup destination is new and writable.',
+    'Do not delete or replace the source database. If backup still fails, preserve the original file for repair or recovery.',
+].join('\n');
+export function databaseBackupIntegrityError(cause) {
+    const error = new KiokukoError('INTEGRITY_ERROR', DATABASE_BACKUP_RECOVERY_MESSAGE);
+    if (cause !== undefined)
+        Object.defineProperty(error, 'cause', { value: cause });
+    return error;
+}
+export function exitCodeFor(error) {
+    if (error instanceof KiokukoError)
+        return error.exitCode;
+    return EXIT_CODES.INTEGRITY_ERROR;
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAcA,MAAM,UAAU,GAA8B;IAC5C,WAAW,EAAE,CAAC;IACd,gBAAgB,EAAE,CAAC;IACnB,SAAS,EAAE,CAAC;IACZ,QAAQ,EAAE,CAAC;IACX,cAAc,EAAE,CAAC;IACjB,YAAY,EAAE,CAAC;IACf,mBAAmB,EAAE,CAAC;IACtB,kBAAkB,EAAE,CAAC;IACrB,oBAAoB,EAAE,CAAC;IACvB,eAAe,EAAE,CAAC;IAClB,eAAe,EAAE,CAAC;IAClB,eAAe,EAAE,CAAC;CACnB,CAAC;AAEF,MAAM,OAAO,YAAa,SAAQ,KAAK;IAI1B;IAEA;IALF,QAAQ,CAAS;IAE1B,YACW,IAAe,EACxB,OAAe,EACN,UAAmC,EAAE;QAE9C,KAAK,CAAC,OAAO,CAAC,CAAC;QAJN,SAAI,GAAJ,IAAI,CAAW;QAEf,YAAO,GAAP,OAAO,CAA8B;QAG9C,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,QAAQ,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;CACF;AAED,MAAM,CAAC,MAAM,8BAA8B,GAAG;IAC5C,sCAAsC;IACtC,sEAAsE;IACtE,WAAW;IACX,+GAA+G;IAC/G,uFAAuF;IACvF,uMAAuM;IACvM,qFAAqF;IACrF,wFAAwF;IACxF,6EAA6E;IAC7E,iPAAiP;IACjP,wHAAwH;IACxH,qHAAqH;CACtH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,UAAU,0BAA0B;IACxC,OAAO,IAAI,YAAY,CAAC,iBAAiB,EAAE,8BAA8B,CAAC,CAAC;AAC7E,CAAC;AAED,MAAM,CAAC,MAAM,gCAAgC,GAAG;IAC9C,4EAA4E;IAC5E,qGAAqG;IACrG,yHAAyH;CAC1H,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,UAAU,4BAA4B,CAAC,KAAe;IAC1D,MAAM,KAAK,GAAG,IAAI,YAAY,CAAC,iBAAiB,EAAE,gCAAgC,CAAC,CAAC;IACpF,IAAI,KAAK,KAAK,SAAS;QAAE,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IACjF,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,IAAI,KAAK,YAAY,YAAY;QAAE,OAAO,KAAK,CAAC,QAAQ,CAAC;IACzD,OAAO,UAAU,CAAC,eAAe,CAAC;AACpC,CAAC"}