kiokuko-dsh 0.1.0

package/dist/model-tools/contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../src/model-tools/contracts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAiB5B,eAAO,MAAM,0BAA0B,2RAe7B,CAAC;AAEX,MAAM,MAAM,sBAAsB,GAAG,CAAC,OAAO,0BAA0B,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjF,MAAM,MAAM,cAAc,GAAG,cAAc,CAAC;AAC5C,MAAM,MAAM,iBAAiB,GAAG,WAAW,GAAG,cAAc,CAAC;AAwB7D,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;kBASxB,CAAC;AAEZ,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;kBAQvB,CAAC;AAEZ,eAAO,MAAM,uBAAuB;;;;;kBAKzB,CAAC;AAEZ,eAAO,MAAM,2BAA2B;;;;;kBAK7B,CAAC;AAEZ,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAeyB,CAAC;AAE/D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAC;IACtC,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,CAAC;IACrC,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC;IAChC,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7C;AAID,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAegB,CAAC"}

package/dist/model-tools/contracts.js

@@ -0,0 +1,104 @@
+import * as z from 'zod/v4';
+import { TASK_TYPES } from '../akinator/types.js';
+import { TASK_ANSWER_CONTRACT_FRAGMENT } from '../ledger/checkpoint-contract.js';
+import { memoryCheckpointInputSchema } from '../memory/checkpoint-contract.js';
+import { absoluteCwdSchema } from '../repository/cwd-schema.js';
+import { adviceReadSchema, adviceSubmissionSchema, ennoAnswerSchema, finishSchema, idealSubmissionSchema, meditationSubmissionSchema, planSubmissionSchema, verificationPrepareSchema, workReportSchema, } from '../enno-oduno/schemas.js';
+export const MODEL_TOOL_OPERATION_NAMES = [
+    'task_prepare',
+    'task_answer',
+    'enno_plan_submit',
+    'enno_ideal_submit',
+    'enno_advice_submit',
+    'enno_advice_read',
+    'enno_answer',
+    'enno_work_report',
+    'enno_verify_prepare',
+    'enno_finish',
+    'enno_meditation_submit',
+    'curator_check',
+    'curator_globalize',
+    'memory_checkpoint',
+];
+function canonicalIdentity(maximum, label) {
+    return z.string().min(1).max(maximum).refine((value) => value.trim() === value && !/\p{Cc}/u.test(value), { message: `${label} must be a canonical bounded identity` });
+}
+const profileField = z.enum(['taskType', 'target', 'expected', 'constraints']);
+const requestId = canonicalIdentity(256, 'requestId');
+const runId = canonicalIdentity(256, 'runId');
+const clientSessionId = canonicalIdentity(256, 'client.sessionId');
+const intakeSessionId = canonicalIdentity(200, 'sessionId');
+const workspaceId = canonicalIdentity(256, 'workspace');
+const entryId = canonicalIdentity(256, 'entryId');
+const capabilityCatalog = z.array(z.unknown()).describe("Capability catalog contract: Array<{kind:'skill'|'mcp_tool';name:string;description?:string}>. Every item must include its kind and canonical name; description is an optional short one- or two-sentence summary. Any malformed or dropped item makes catalog availability unknown so required capabilities fail closed.");
+const profileHints = z.object({
+    taskType: z.enum(TASK_TYPES).nullable().optional(),
+    target: z.string().trim().max(4000).nullable().optional(),
+    expected: z.string().trim().max(4000).nullable().optional(),
+    constraints: z.string().trim().max(4000).nullable().optional(),
+}).strict();
+export const taskPrepareInputSchema = z.object({
+    soulRead: z.literal(true).describe('Required self-attestation that the client model read the complete exact local kiokuko-soul SKILL.md for this logical request before calling task_prepare; this is not remote proof of cognition'),
+    requestId: requestId.describe('Opaque identity for this logical user request. Use a new value for every new request and reuse it only for an exact retry; the raw value is not stored'),
+    task: z.string().trim().min(1).max(64 * 1024).describe('The user task, without hidden reasoning or full transcripts'),
+    cwd: absoluteCwdSchema.optional().describe('Absolute current working directory; defaults to the MCP process cwd and is returned in canonical form through executionContext'),
+    profileHints: profileHints.optional().describe('Task type, target, success condition, and constraints inferred from current evidence'),
+    capabilities: capabilityCatalog.optional().describe("Complete capability descriptors for every capability available in this client as Array<{kind:'skill'|'mcp_tool';name:string;description?:string}>. Every item must include its kind and canonical name; description is optional and bounded. An explicit empty array means known-empty; omission or any malformed/dropped item means unknown. The catalog is ephemeral and never stored"),
+    client: z.object({ kind: z.string().trim().min(1).max(200).optional(), version: z.string().trim().min(1).max(100).optional(), sessionId: clientSessionId.optional() }).strict().optional().describe('Optional explicit client routing metadata. Enno-Oduno normally identifies Codex, Claude Code, or OpenCode from the MCP initialize clientInfo and rejects a contradictory supported-client hint. The host session ID is not authorization ownership: continuation prefers the current opaque route-epoch-bound resume token, otherwise a matching hook may reroute the single unambiguous active run in the canonical repository when no WorkUnit execution lease is active.'),
+    maxContextChars: z.number().int().min(1000).max(50_000).default(12_000).describe('Maximum characters for each bounded context lane; this normalized value is bound to the run'),
+}).strict();
+export const taskAnswerInputSchema = z.object({
+    sessionId: intakeSessionId,
+    runId: runId.describe('Required run ID returned by task_prepare'),
+    questionId: profileField,
+    value: z.string().trim().min(1).max(64 * 1024).describe(TASK_ANSWER_CONTRACT_FRAGMENT),
+    cwd: absoluteCwdSchema.optional().describe('Absolute current working directory; defaults to the MCP process cwd and is returned in canonical form through executionContext'),
+    capabilities: capabilityCatalog.optional().describe("Complete current client capability catalog as Array<{kind:'skill'|'mcp_tool';name:string;description?:string}>. Repeat the exact list from task_prepare. Every item must include its kind and canonical name; description is optional and bounded. Any malformed or dropped item makes availability unknown. The catalog is ephemeral and never stored"),
+    maxContextChars: z.number().int().min(1000).max(50_000).default(12_000).describe('Must match the context budget bound by task_prepare'),
+}).strict();
+export const curatorCheckInputSchema = z.object({
+    cwd: absoluteCwdSchema.optional().describe('Absolute current working directory; defaults to the MCP process cwd'),
+    workspace: workspaceId.optional().describe('Exact project workspace; normally omit and resolve from cwd'),
+    limit: z.number().int().min(1).max(20).default(5),
+    includeUnready: z.boolean().default(false).describe('Include lower-evidence candidates for manual inspection; automated permission prompts should leave this false'),
+}).strict();
+export const curatorGlobalizeInputSchema = z.object({
+    workspace: workspaceId,
+    entryId,
+    expectedRevision: z.number().int().min(1),
+    confirmed: z.literal(true).describe('Must be true only after explicit user approval in the current conversation'),
+}).strict();
+export const MODEL_TOOL_INPUT_SCHEMAS = {
+    task_prepare: taskPrepareInputSchema,
+    task_answer: taskAnswerInputSchema,
+    enno_plan_submit: planSubmissionSchema,
+    enno_ideal_submit: idealSubmissionSchema,
+    enno_advice_submit: adviceSubmissionSchema,
+    enno_advice_read: adviceReadSchema,
+    enno_answer: ennoAnswerSchema,
+    enno_work_report: workReportSchema,
+    enno_verify_prepare: verificationPrepareSchema,
+    enno_finish: finishSchema,
+    enno_meditation_submit: meditationSubmissionSchema,
+    curator_check: curatorCheckInputSchema,
+    curator_globalize: curatorGlobalizeInputSchema,
+    memory_checkpoint: memoryCheckpointInputSchema,
+};
+const commonIdentityFields = ['runId', 'workspace', 'orchestrationId', 'resumeToken', 'expectedRevision', 'idempotencyKey'];
+export const MODEL_TOOL_CONTRACTS = [
+    { name: 'task_prepare', owner: 'kiokuko-core', exposure: 'host-only', inputSchema: taskPrepareInputSchema, hostOwnedFields: ['soulRead', 'requestId', 'task', 'cwd', 'profileHints', 'capabilities', 'client', 'maxContextChars'] },
+    { name: 'task_answer', owner: 'kiokuko-core', exposure: 'host-only', inputSchema: taskAnswerInputSchema, hostOwnedFields: ['sessionId', 'runId', 'questionId', 'value', 'cwd', 'capabilities', 'maxContextChars'] },
+    { name: 'enno_plan_submit', owner: 'kiokuko-core', exposure: 'model-facing', inputSchema: planSubmissionSchema, hostOwnedFields: [...commonIdentityFields, 'advisoryRoundDigest', 'advisoryDisposition', 'recoveryAction', 'capabilities'] },
+    { name: 'enno_ideal_submit', owner: 'kiokuko-core', exposure: 'model-facing', inputSchema: idealSubmissionSchema, hostOwnedFields: [...commonIdentityFields, 'advisoryRoundDigest', 'advisoryDisposition'] },
+    { name: 'enno_advice_submit', owner: 'kiokuko-core', exposure: 'host-only', inputSchema: adviceSubmissionSchema, hostOwnedFields: ['runId', 'workspace', 'orchestrationId', 'resumeToken', 'expectedRevision', 'mutationRevision', 'idempotencyKey', 'phase', 'allowlistedContext', 'contributions'] },
+    { name: 'enno_advice_read', owner: 'kiokuko-core', exposure: 'host-only', inputSchema: adviceReadSchema, hostOwnedFields: ['runId', 'workspace', 'orchestrationId', 'resumeToken', 'expectedRevision', 'advisoryRoundDigest'] },
+    { name: 'enno_answer', owner: 'kiokuko-core', exposure: 'host-only', inputSchema: ennoAnswerSchema, hostOwnedFields: [...commonIdentityFields, 'action', 'requestedChanges'] },
+    { name: 'enno_work_report', owner: 'kiokuko-core', exposure: 'model-facing', inputSchema: workReportSchema, hostOwnedFields: [...commonIdentityFields, 'leaseToken', 'routeEpoch', 'workUnitId'] },
+    { name: 'enno_verify_prepare', owner: 'kiokuko-core', exposure: 'host-only', inputSchema: verificationPrepareSchema, hostOwnedFields: [...commonIdentityFields] },
+    { name: 'enno_finish', owner: 'kiokuko-core', exposure: 'model-facing', inputSchema: finishSchema, hostOwnedFields: [...commonIdentityFields, 'advisoryRoundDigest', 'advisoryDisposition'] },
+    { name: 'enno_meditation_submit', owner: 'kiokuko-core', exposure: 'model-facing', inputSchema: meditationSubmissionSchema, hostOwnedFields: [...commonIdentityFields] },
+    { name: 'curator_check', owner: 'kiokuko-core', exposure: 'model-facing', inputSchema: curatorCheckInputSchema, hostOwnedFields: ['cwd', 'workspace'] },
+    { name: 'curator_globalize', owner: 'kiokuko-core', exposure: 'host-only', inputSchema: curatorGlobalizeInputSchema, hostOwnedFields: ['workspace', 'entryId', 'expectedRevision', 'confirmed'] },
+    { name: 'memory_checkpoint', owner: 'kiokuko-core', exposure: 'model-facing', inputSchema: memoryCheckpointInputSchema, hostOwnedFields: ['cwd', 'runId', 'deliveryId'] },
+];
+//# sourceMappingURL=contracts.js.map

package/dist/model-tools/contracts.js.map

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

package/dist/model-tools/registry.d.ts

@@ -0,0 +1,8 @@
+import { MODEL_TOOL_INPUT_SCHEMAS, type ModelToolContract, type ModelToolOperationName } from './contracts.js';
+export type { ModelToolOperationName } from './contracts.js';
+export type JsonSchema = Record<string, unknown>;
+export declare const MODEL_TOOL_REGISTRY: Readonly<Record<ModelToolOperationName, ModelToolContract>>;
+export declare function modelToolContract(name: ModelToolOperationName): ModelToolContract;
+export declare function modelFacingInputSchema(name: ModelToolOperationName): JsonSchema;
+export declare function mcpInputSchema<Name extends ModelToolOperationName>(name: Name): typeof MODEL_TOOL_INPUT_SCHEMAS[Name];
+//# sourceMappingURL=registry.d.ts.map

package/dist/model-tools/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/model-tools/registry.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,wBAAwB,EAExB,KAAK,iBAAiB,EACtB,KAAK,sBAAsB,EAC5B,MAAM,gBAAgB,CAAC;AAExB,YAAY,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAE7D,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAkDjD,eAAO,MAAM,mBAAmB,EAE1B,QAAQ,CAAC,MAAM,CAAC,sBAAsB,EAAE,iBAAiB,CAAC,CAAC,CAAC;AAElE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,sBAAsB,GAAG,iBAAiB,CAEjF;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,sBAAsB,GAAG,UAAU,CAG/E;AAED,wBAAgB,cAAc,CAAC,IAAI,SAAS,sBAAsB,EAAE,IAAI,EAAE,IAAI,GAAG,OAAO,wBAAwB,CAAC,IAAI,CAAC,CAErH"}

package/dist/model-tools/registry.js

@@ -0,0 +1,59 @@
+import * as z from 'zod/v4';
+import { MODEL_TOOL_CONTRACTS, MODEL_TOOL_INPUT_SCHEMAS, MODEL_TOOL_OPERATION_NAMES, } from './contracts.js';
+function jsonSchemaValue(value) {
+    if (value === null || typeof value === 'string' || typeof value === 'boolean')
+        return value;
+    if (typeof value === 'number' && Number.isFinite(value))
+        return value;
+    if (Array.isArray(value))
+        return value.map(jsonSchemaValue);
+    if (typeof value !== 'object')
+        throw new Error('Model tool schema is not JSON-compatible');
+    return Object.fromEntries(Object.entries(value).map(([key, child]) => [key, jsonSchemaValue(child)]));
+}
+function fullJsonSchema(contract) {
+    return jsonSchemaValue(z.toJSONSchema(contract.inputSchema, { unrepresentable: 'any' }));
+}
+function removeHostOwnedFields(schema, fields) {
+    const projected = structuredClone(schema);
+    const properties = projected.properties;
+    if (typeof properties === 'object' && properties !== null && !Array.isArray(properties)) {
+        const propertyMap = properties;
+        for (const field of fields)
+            delete propertyMap[field];
+    }
+    if (Array.isArray(projected.required)) {
+        projected.required = projected.required.filter((field) => (typeof field === 'string' && !fields.includes(field)));
+    }
+    return projected;
+}
+function assertContract(contract) {
+    const schema = fullJsonSchema(contract);
+    const properties = schema.properties;
+    const propertyNames = new Set(typeof properties === 'object' && properties !== null && !Array.isArray(properties)
+        ? Object.keys(properties)
+        : []);
+    for (const field of contract.hostOwnedFields) {
+        if (!propertyNames.has(field))
+            throw new Error(`${contract.name} host-owned field is absent from its schema: ${field}`);
+    }
+    return contract;
+}
+const validatedContracts = MODEL_TOOL_CONTRACTS.map(assertContract);
+if (validatedContracts.length !== MODEL_TOOL_OPERATION_NAMES.length
+    || new Set(validatedContracts.map((contract) => contract.name)).size !== validatedContracts.length
+    || validatedContracts.some((contract, index) => contract.name !== MODEL_TOOL_OPERATION_NAMES[index])) {
+    throw new Error('Model tool registry must contain the exact unique operation set');
+}
+export const MODEL_TOOL_REGISTRY = Object.freeze(Object.fromEntries(validatedContracts.map((contract) => [contract.name, Object.freeze(contract)])));
+export function modelToolContract(name) {
+    return MODEL_TOOL_REGISTRY[name];
+}
+export function modelFacingInputSchema(name) {
+    const contract = modelToolContract(name);
+    return removeHostOwnedFields(fullJsonSchema(contract), contract.hostOwnedFields);
+}
+export function mcpInputSchema(name) {
+    return MODEL_TOOL_INPUT_SCHEMAS[name];
+}
+//# sourceMappingURL=registry.js.map

package/dist/model-tools/registry.js.map

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

package/dist/package-version.d.ts

@@ -0,0 +1,2 @@
+export declare const PACKAGE_VERSION: string;
+//# sourceMappingURL=package-version.d.ts.map

package/dist/package-version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-version.d.ts","sourceRoot":"","sources":["../src/package-version.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,eAAe,QAA0B,CAAC"}

package/dist/package-version.js

@@ -0,0 +1,7 @@
+import { createRequire } from 'node:module';
+const packageMetadata = createRequire(import.meta.url)('../package.json');
+if (typeof packageMetadata.version !== 'string' || packageMetadata.version.length === 0) {
+    throw new Error('Kiokuko package version is unavailable');
+}
+export const PACKAGE_VERSION = packageMetadata.version;
+//# sourceMappingURL=package-version.js.map

package/dist/package-version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-version.js","sourceRoot":"","sources":["../src/package-version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,eAAe,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,iBAAiB,CAA0B,CAAC;AAEnG,IAAI,OAAO,eAAe,CAAC,OAAO,KAAK,QAAQ,IAAI,eAAe,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;IACxF,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,CAAC,MAAM,eAAe,GAAG,eAAe,CAAC,OAAO,CAAC"}

package/dist/repository/binding.d.ts

@@ -0,0 +1,32 @@
+import type { SqliteDatabase } from '../db/adapter.js';
+export interface RepositoryRegistration {
+    repositoryId: string;
+    workspace: string;
+    displayName: string;
+    canonicalRoot: string;
+    remoteFingerprint: string | null;
+    bindingSchemaVersion: number;
+    agentTemplateVersion: number;
+    /** Exact current owner required before moving an existing canonical root. */
+    rebindFrom?: {
+        repositoryId: string;
+        workspace: string;
+    };
+    now?: string;
+}
+export interface RegistrationResult {
+    created: boolean;
+    repositoryId: string;
+    workspace: string;
+    canonicalRoot: string;
+}
+export interface RepositoryLocation extends Record<string, unknown> {
+    repositoryId: string;
+    canonicalRoot: string;
+}
+export declare function listRepositoryLocations(database: SqliteDatabase): RepositoryLocation[];
+export declare function findMissingRepositoryLocations(database: SqliteDatabase): RepositoryLocation[];
+/** Remove only confirmed location rows whose roots are still absent. */
+export declare function removeMissingRepositoryLocations(database: SqliteDatabase, candidates: readonly RepositoryLocation[]): number;
+export declare function registerRepositoryAndLocation(database: SqliteDatabase, registration: RepositoryRegistration): RegistrationResult;
+//# sourceMappingURL=binding.d.ts.map

package/dist/repository/binding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"binding.d.ts","sourceRoot":"","sources":["../../src/repository/binding.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAIvD,MAAM,WAAW,sBAAsB;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,oBAAoB,EAAE,MAAM,CAAC;IAC7B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,6EAA6E;IAC7E,UAAU,CAAC,EAAE;QACX,YAAY,EAAE,MAAM,CAAC;QACrB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;CACvB;AAmCD,MAAM,WAAW,kBAAmB,SAAQ,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IACjE,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,cAAc,GAAG,kBAAkB,EAAE,CAMtF;AAED,wBAAgB,8BAA8B,CAAC,QAAQ,EAAE,cAAc,GAAG,kBAAkB,EAAE,CAE7F;AAED,wEAAwE;AACxE,wBAAgB,gCAAgC,CAC9C,QAAQ,EAAE,cAAc,EACxB,UAAU,EAAE,SAAS,kBAAkB,EAAE,GACxC,MAAM,CAgBR;AA2BD,wBAAgB,6BAA6B,CAC3C,QAAQ,EAAE,cAAc,EACxB,YAAY,EAAE,sBAAsB,GACnC,kBAAkB,CA6KpB"}

package/dist/repository/binding.js

@@ -0,0 +1,208 @@
+import { existsSync } from 'node:fs';
+import { KiokukoError } from '../errors.js';
+import { withImmediateTransaction } from '../db/transaction.js';
+import { validateRepositoryBindingIdentity } from './identity-value.js';
+function conflict(message) {
+    throw new KiokukoError('CONFLICT', message);
+}
+function requireSingleChange(database, message) {
+    const changes = database.prepare('SELECT changes() AS changes').get()?.changes;
+    if (changes !== 1 && changes !== 1n)
+        conflict(message);
+}
+function validateRegistrationVersions(registration) {
+    if (!Number.isSafeInteger(registration.bindingSchemaVersion)
+        || registration.bindingSchemaVersion < 1) {
+        throw new KiokukoError('VALIDATION_ERROR', 'bindingSchemaVersion must be a positive safe integer');
+    }
+    // Zero is the explicit sentinel used by location-only discovery, which does
+    // not claim that an agent template was installed or request a downgrade.
+    if (!Number.isSafeInteger(registration.agentTemplateVersion)
+        || registration.agentTemplateVersion < 0) {
+        throw new KiokukoError('VALIDATION_ERROR', 'agentTemplateVersion must be a non-negative safe integer');
+    }
+}
+export function listRepositoryLocations(database) {
+    return database.prepare(`
+    SELECT repository_id AS repositoryId, canonical_root AS canonicalRoot
+      FROM repository_locations
+     ORDER BY canonical_root
+  `).all();
+}
+export function findMissingRepositoryLocations(database) {
+    return listRepositoryLocations(database).filter((location) => !existsSync(location.canonicalRoot));
+}
+/** Remove only confirmed location rows whose roots are still absent. */
+export function removeMissingRepositoryLocations(database, candidates) {
+    return withImmediateTransaction(database, () => {
+        let removed = 0;
+        for (const candidate of candidates) {
+            if (existsSync(candidate.canonicalRoot))
+                continue;
+            database
+                .prepare('DELETE FROM repository_locations WHERE repository_id = ? AND canonical_root = ?')
+                .run(candidate.repositoryId, candidate.canonicalRoot);
+            const changes = database.prepare('SELECT changes() AS changes').get()?.changes;
+            if (changes !== 1 && changes !== 1n) {
+                throw new KiokukoError('CONFLICT', 'Repository location changed before missing binding cleanup');
+            }
+            removed += 1;
+        }
+        return removed;
+    });
+}
+function validateStoredVersions(metadata) {
+    if (typeof metadata.bindingSchemaVersion !== 'number'
+        || !Number.isSafeInteger(metadata.bindingSchemaVersion)
+        || metadata.bindingSchemaVersion < 1
+        || typeof metadata.agentTemplateVersion !== 'number'
+        || !Number.isSafeInteger(metadata.agentTemplateVersion)
+        || metadata.agentTemplateVersion < 0) {
+        throw new KiokukoError('INTEGRITY_ERROR', 'Stored repository binding version metadata is invalid');
+    }
+}
+function rejectsStoredAgentVersion(storedAgentTemplateVersion, requestedAgentTemplateVersion) {
+    return requestedAgentTemplateVersion > 0
+        && storedAgentTemplateVersion > requestedAgentTemplateVersion;
+}
+export function registerRepositoryAndLocation(database, registration) {
+    validateRegistrationVersions(registration);
+    validateRepositoryBindingIdentity(registration.repositoryId, registration.workspace);
+    if (registration.rebindFrom !== undefined) {
+        validateRepositoryBindingIdentity(registration.rebindFrom.repositoryId, registration.rebindFrom.workspace);
+        if (registration.rebindFrom.repositoryId === registration.repositoryId
+            && registration.rebindFrom.workspace === registration.workspace) {
+            conflict('Rebind target must differ from the current project binding');
+        }
+    }
+    const now = registration.now ?? new Date().toISOString();
+    if (registration.remoteFingerprint !== null && !/^sha256:[a-f0-9]{64}$/.test(registration.remoteFingerprint)) {
+        throw new KiokukoError('VALIDATION_ERROR', 'remoteFingerprint must be a SHA-256 fingerprint');
+    }
+    return withImmediateTransaction(database, () => {
+        const location = database
+            .prepare(`
+        SELECT l.repository_id AS repositoryId, r.workspace AS workspace,
+               r.binding_schema_version AS bindingSchemaVersion,
+               r.agent_template_version AS agentTemplateVersion
+        FROM repository_locations l
+        JOIN repositories r ON r.repository_id = l.repository_id
+        WHERE l.canonical_root = ?
+      `)
+            .get(registration.canonicalRoot);
+        if (location !== undefined)
+            validateStoredVersions(location);
+        const rebindFrom = registration.rebindFrom;
+        if (rebindFrom !== undefined) {
+            if (location === undefined
+                || location.repositoryId !== rebindFrom.repositoryId
+                || location.workspace !== rebindFrom.workspace) {
+                conflict('Repository root changed after rebind planning');
+            }
+        }
+        else if (location && location.repositoryId !== registration.repositoryId) {
+            conflict('Repository root is already bound to another repository ID; rebind is required');
+        }
+        if (location !== undefined
+            && (location.bindingSchemaVersion > registration.bindingSchemaVersion
+                || rejectsStoredAgentVersion(location.agentTemplateVersion, registration.agentTemplateVersion))) {
+            conflict('Repository root is owned by a newer binding or agent-template version');
+        }
+        const repository = database
+            .prepare(`
+        SELECT workspace, binding_schema_version AS bindingSchemaVersion,
+               agent_template_version AS agentTemplateVersion
+        FROM repositories
+        WHERE repository_id = ?
+      `)
+            .get(registration.repositoryId);
+        if (repository !== undefined)
+            validateStoredVersions(repository);
+        if (repository && repository.workspace !== registration.workspace) {
+            conflict('Repository ID is already bound to another workspace');
+        }
+        if (repository !== undefined
+            && (repository.bindingSchemaVersion > registration.bindingSchemaVersion
+                || rejectsStoredAgentVersion(repository.agentTemplateVersion, registration.agentTemplateVersion))) {
+            conflict('Repository ID uses a newer binding or agent-template version');
+        }
+        const expectedAgentTemplateVersion = repository === undefined
+            ? registration.agentTemplateVersion
+            : Math.max(repository.agentTemplateVersion, registration.agentTemplateVersion);
+        const workspace = database
+            .prepare('SELECT repository_id FROM repositories WHERE workspace = ?')
+            .get(registration.workspace);
+        if (workspace && workspace.repository_id !== registration.repositoryId) {
+            conflict('Workspace is already bound to another repository ID');
+        }
+        const created = !repository;
+        if (created) {
+            database
+                .prepare(`
+          INSERT INTO repositories (
+            repository_id, workspace, display_name, remote_fingerprint,
+            binding_schema_version, agent_template_version, created_at, last_used_at
+          ) VALUES (?, ?, ?, ?, ?, ?, ?, ?)
+        `)
+                .run(registration.repositoryId, registration.workspace, registration.displayName, registration.remoteFingerprint, registration.bindingSchemaVersion, registration.agentTemplateVersion, now, now);
+        }
+        else {
+            database
+                .prepare('UPDATE repositories SET last_used_at = ?, display_name = ?, agent_template_version = MAX(agent_template_version, ?) WHERE repository_id = ?')
+                .run(now, registration.displayName, registration.agentTemplateVersion, registration.repositoryId);
+            requireSingleChange(database, 'Repository metadata changed after registration planning');
+        }
+        if (!location) {
+            database
+                .prepare(`
+          INSERT INTO repository_locations (
+            repository_id, canonical_root, first_seen_at, last_seen_at
+          ) VALUES (?, ?, ?, ?)
+        `)
+                .run(registration.repositoryId, registration.canonicalRoot, now, now);
+        }
+        else if (location.repositoryId === registration.repositoryId) {
+            database
+                .prepare('UPDATE repository_locations SET last_seen_at = ? WHERE repository_id = ? AND canonical_root = ?')
+                .run(now, registration.repositoryId, registration.canonicalRoot);
+            requireSingleChange(database, 'Repository location changed after registration planning');
+        }
+        else {
+            database
+                .prepare(`
+          UPDATE repository_locations
+          SET repository_id = ?, last_seen_at = ?
+          WHERE repository_id = ? AND canonical_root = ?
+        `)
+                .run(registration.repositoryId, now, location.repositoryId, registration.canonicalRoot);
+            requireSingleChange(database, 'Repository location changed after rebind planning');
+        }
+        const registeredLocation = database
+            .prepare(`
+        SELECT l.repository_id AS repositoryId, r.workspace AS workspace,
+               r.binding_schema_version AS bindingSchemaVersion,
+               r.agent_template_version AS agentTemplateVersion
+        FROM repository_locations l
+        JOIN repositories r ON r.repository_id = l.repository_id
+        WHERE l.canonical_root = ?
+      `)
+            .get(registration.canonicalRoot);
+        if (registeredLocation !== undefined)
+            validateStoredVersions(registeredLocation);
+        if (registeredLocation?.repositoryId !== registration.repositoryId
+            || registeredLocation.workspace !== registration.workspace) {
+            conflict('Repository location did not commit the planned binding identity');
+        }
+        if (registeredLocation.bindingSchemaVersion !== registration.bindingSchemaVersion
+            || registeredLocation.agentTemplateVersion !== expectedAgentTemplateVersion) {
+            conflict('Repository location did not commit the planned binding version metadata');
+        }
+        return {
+            created,
+            repositoryId: registration.repositoryId,
+            workspace: registration.workspace,
+            canonicalRoot: registration.canonicalRoot,
+        };
+    });
+}
+//# sourceMappingURL=binding.js.map

package/dist/repository/binding.js.map

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

package/dist/repository/cwd-schema.d.ts

@@ -0,0 +1,4 @@
+import * as z from 'zod/v4';
+/** Validate one explicitly supplied MCP working directory before filesystem access. */
+export declare const absoluteCwdSchema: z.ZodString;
+//# sourceMappingURL=cwd-schema.d.ts.map

package/dist/repository/cwd-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cwd-schema.d.ts","sourceRoot":"","sources":["../../src/repository/cwd-schema.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,uFAAuF;AACvF,eAAO,MAAM,iBAAiB,aAGsD,CAAC"}

package/dist/repository/cwd-schema.js

@@ -0,0 +1,8 @@
+import path from 'node:path';
+import * as z from 'zod/v4';
+/** Validate one explicitly supplied MCP working directory before filesystem access. */
+export const absoluteCwdSchema = z.string()
+    .min(1)
+    .refine(path.isAbsolute, { message: 'cwd must be an absolute path' })
+    .refine((value) => !value.includes('\0'), { message: 'cwd must not contain NUL' });
+//# sourceMappingURL=cwd-schema.js.map

package/dist/repository/cwd-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cwd-schema.js","sourceRoot":"","sources":["../../src/repository/cwd-schema.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,uFAAuF;AACvF,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,EAAE;KACxC,GAAG,CAAC,CAAC,CAAC;KACN,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,OAAO,EAAE,8BAA8B,EAAE,CAAC;KACpE,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,EAAE,OAAO,EAAE,0BAA0B,EAAE,CAAC,CAAC"}

package/dist/repository/detect-root.d.ts

@@ -0,0 +1,13 @@
+export type RootSource = 'explicit' | 'binding' | 'git' | 'git-marker' | 'directory';
+export interface DetectedRepositoryRoot {
+    root: string;
+    source: RootSource;
+}
+export interface DetectRepositoryRootOptions {
+    cwd?: string;
+    root?: string;
+    allowDirectory?: boolean;
+}
+export declare function canonicalDirectory(directory: string): string;
+export declare function detectRepositoryRoot(options?: DetectRepositoryRootOptions): DetectedRepositoryRoot;
+//# sourceMappingURL=detect-root.d.ts.map

package/dist/repository/detect-root.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-root.d.ts","sourceRoot":"","sources":["../../src/repository/detect-root.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,SAAS,GAAG,KAAK,GAAG,YAAY,GAAG,WAAW,CAAC;AAErF,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,CAAC;CACpB;AAED,MAAM,WAAW,2BAA2B;IAC1C,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAuB5D;AA0BD,wBAAgB,oBAAoB,CAAC,OAAO,GAAE,2BAAgC,GAAG,sBAAsB,CAuBtG"}

package/dist/repository/detect-root.js

@@ -0,0 +1,77 @@
+import { execFileSync } from 'node:child_process';
+import { existsSync, realpathSync, statSync } from 'node:fs';
+import path from 'node:path';
+import { KiokukoError } from '../errors.js';
+export function canonicalDirectory(directory) {
+    if (!path.isAbsolute(directory)) {
+        throw new KiokukoError('VALIDATION_ERROR', 'Directory path must be absolute');
+    }
+    try {
+        const resolved = realpathSync(directory);
+        if (!statSync(resolved).isDirectory()) {
+            throw new KiokukoError('VALIDATION_ERROR', 'Repository root must be a directory');
+        }
+        return resolved;
+    }
+    catch (error) {
+        if (error instanceof KiokukoError)
+            throw error;
+        const code = error instanceof Error && 'code' in error
+            ? error.code
+            : undefined;
+        if (code === 'ENOENT' || code === 'ENOTDIR') {
+            throw new KiokukoError('NOT_FOUND', 'Directory was not found');
+        }
+        if (code === 'EACCES' || code === 'EPERM') {
+            throw new KiokukoError('VALIDATION_ERROR', 'Directory is not accessible');
+        }
+        throw error;
+    }
+}
+function ancestorDirectories(start) {
+    const directories = [];
+    let current = canonicalDirectory(start);
+    for (;;) {
+        directories.push(current);
+        const parent = path.dirname(current);
+        if (parent === current)
+            return directories;
+        current = parent;
+    }
+}
+function gitRoot(cwd) {
+    try {
+        const output = execFileSync('git', ['rev-parse', '--show-toplevel'], {
+            cwd,
+            encoding: 'utf8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+        }).trim();
+        return output ? canonicalDirectory(output) : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+export function detectRepositoryRoot(options = {}) {
+    const cwd = canonicalDirectory(options.cwd ?? process.cwd());
+    if (options.root !== undefined) {
+        return { root: canonicalDirectory(options.root), source: 'explicit' };
+    }
+    for (const directory of ancestorDirectories(cwd)) {
+        if (existsSync(path.join(directory, '.kiokuko.json'))) {
+            return { root: directory, source: 'binding' };
+        }
+    }
+    const discoveredGitRoot = gitRoot(cwd);
+    if (discoveredGitRoot)
+        return { root: discoveredGitRoot, source: 'git' };
+    for (const directory of ancestorDirectories(cwd)) {
+        if (existsSync(path.join(directory, '.git'))) {
+            return { root: directory, source: 'git-marker' };
+        }
+    }
+    if (options.allowDirectory)
+        return { root: cwd, source: 'directory' };
+    throw new KiokukoError('NOT_FOUND', 'No repository root found; pass --root or --allow-directory');
+}
+//# sourceMappingURL=detect-root.js.map

package/dist/repository/detect-root.js.map

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