@askdkc/kiokuko 0.1.0

package/dist/commands/use.js

@@ -0,0 +1,176 @@
+import { readFile, unlink } from 'node:fs/promises';
+import path from 'node:path';
+import { atomicWriteText, readRegularFile } from '../agent-file/atomic-write.js';
+import { AGENT_TEMPLATE_VERSION, renderAgentFile } from '../agent-file/render.js';
+import { getGlobalDatabasePath } from '../config/paths.js';
+import { readProjectConfig } from '../config/project-config.js';
+import { initializeDatabase } from './init.js';
+import { openConnection } from '../db/connection.js';
+import { registerRepositoryAndLocation } from '../repository/binding.js';
+import { detectRepositoryRoot } from '../repository/detect-root.js';
+import { createRepositoryIdentity } from '../repository/identity.js';
+import { KiokukoError } from '../errors.js';
+import { readGitOrigin } from '../repository/git-origin.js';
+function ensureChildPath(root, filePath) {
+    const resolvedRoot = path.resolve(root);
+    const resolvedPath = path.resolve(root, filePath);
+    if (resolvedPath !== resolvedRoot && !resolvedPath.startsWith(`${resolvedRoot}${path.sep}`)) {
+        throw new KiokukoError('VALIDATION_ERROR', 'agentFile must remain inside the repository root');
+    }
+    return resolvedPath;
+}
+async function readOptionalText(filePath) {
+    try {
+        return await readFile(filePath, 'utf8');
+    }
+    catch (error) {
+        if (error instanceof Error && 'code' in error && error.code === 'ENOENT')
+            return undefined;
+        throw error;
+    }
+}
+function bindingText(value) {
+    return `${JSON.stringify(value, null, 2)}\n`;
+}
+function bindingAction(existing, next) {
+    if (existing === undefined)
+        return 'created';
+    return existing === next ? 'unchanged' : 'updated';
+}
+function preferredCliCommand() {
+    return process.env.npm_command === 'exec' || process.env.npm_lifecycle_event === 'npx'
+        ? 'npm exec -- kiokuko'
+        : 'kiokuko';
+}
+export async function useRepository(options = {}) {
+    const rootOptions = {};
+    if (options.cwd !== undefined)
+        rootOptions.cwd = options.cwd;
+    if (options.root !== undefined)
+        rootOptions.root = options.root;
+    if (options.allowDirectory !== undefined)
+        rootOptions.allowDirectory = options.allowDirectory;
+    const detected = detectRepositoryRoot(rootOptions);
+    const repositoryRoot = detected.root;
+    const bindingFile = path.join(repositoryRoot, '.kiokuko.json');
+    const existingBindingText = await readOptionalText(bindingFile);
+    const existingBinding = existingBindingText === undefined ? undefined : await readProjectConfig(bindingFile);
+    if (existingBinding && options.workspace && existingBinding.workspace !== options.workspace && !options.forceRebind) {
+        throw new KiokukoError('CONFLICT', 'Existing binding uses another workspace; pass --force-rebind to change it');
+    }
+    const requestedAgentFile = options.agentFile ?? existingBinding?.agentFile ?? 'AGENTS.md';
+    const agentFile = ensureChildPath(repositoryRoot, requestedAgentFile);
+    const existingAgent = options.noAgentFile ? undefined : await readRegularFile(agentFile);
+    const identityOptions = { repositoryRoot };
+    const remote = readGitOrigin(repositoryRoot);
+    if (remote !== undefined)
+        identityOptions.remoteUrl = remote;
+    if (options.repositoryId !== undefined)
+        identityOptions.repositoryId = options.repositoryId;
+    if (existingBinding) {
+        identityOptions.existingBinding = {
+            repositoryId: existingBinding.repositoryId,
+            workspace: existingBinding.workspace,
+        };
+    }
+    if (options.workspace !== undefined)
+        identityOptions.workspace = options.workspace;
+    const identity = createRepositoryIdentity(identityOptions);
+    if (existingBinding && options.workspace && existingBinding.workspace !== identity.workspace && !options.forceRebind) {
+        throw new KiokukoError('CONFLICT', 'Existing binding uses another workspace; pass --force-rebind to change it');
+    }
+    const nextBinding = {
+        schemaVersion: 1,
+        repositoryId: identity.repositoryId,
+        workspace: identity.workspace,
+        agentFile: requestedAgentFile,
+        templateVersion: AGENT_TEMPLATE_VERSION,
+    };
+    const nextBindingText = bindingText(nextBinding);
+    const rendered = options.noAgentFile
+        ? undefined
+        : renderAgentFile(existingAgent?.content, {
+            repositoryId: identity.repositoryId,
+            workspace: identity.workspace,
+            cliCommand: preferredCliCommand(),
+            templateVersion: AGENT_TEMPLATE_VERSION,
+        });
+    const databasePath = options.databasePath ?? getGlobalDatabasePath();
+    const result = {
+        repositoryRoot,
+        repositoryId: identity.repositoryId,
+        workspace: identity.workspace,
+        databasePath,
+        bindingFile,
+        agentFile: options.noAgentFile ? null : agentFile,
+        agentFileAction: options.noAgentFile ? 'skipped' : rendered?.action ?? 'unchanged',
+        bindingAction: options.dryRun ? 'planned' : bindingAction(existingBindingText, nextBindingText),
+        dryRun: options.dryRun ?? false,
+        templateVersion: AGENT_TEMPLATE_VERSION,
+    };
+    if (options.dryRun)
+        return result;
+    const initOptions = { databasePath };
+    if (options.migrationsDirectory !== undefined)
+        initOptions.migrationsDirectory = options.migrationsDirectory;
+    await initializeDatabase(initOptions);
+    const database = openConnection(databasePath);
+    let retryBinding;
+    try {
+        try {
+            registerRepositoryAndLocation(database, {
+                repositoryId: identity.repositoryId,
+                workspace: identity.workspace,
+                displayName: identity.displayName,
+                canonicalRoot: repositoryRoot,
+                remoteFingerprint: identity.remoteFingerprint,
+                bindingSchemaVersion: 1,
+                agentTemplateVersion: AGENT_TEMPLATE_VERSION,
+            });
+        }
+        catch (error) {
+            if (error instanceof KiokukoError && error.code === 'CONFLICT' && options.repositoryId === undefined && options.workspace === undefined && existingBinding === undefined) {
+                retryBinding = database.prepare(`
+          SELECT r.repository_id AS repositoryId, r.workspace AS workspace
+          FROM repositories r JOIN repository_locations l ON l.repository_id = r.repository_id
+          WHERE l.canonical_root = ?
+        `).get(repositoryRoot);
+            }
+            if (!retryBinding)
+                throw error;
+        }
+    }
+    finally {
+        database.close();
+    }
+    if (retryBinding) {
+        return useRepository({ ...options, repositoryId: retryBinding.repositoryId, workspace: retryBinding.workspace });
+    }
+    const originalBinding = existingBindingText;
+    const originalAgent = existingAgent?.content;
+    try {
+        if (result.bindingAction !== 'unchanged')
+            await atomicWriteText(bindingFile, nextBindingText, 0o644);
+        if (rendered && rendered.action !== 'unchanged')
+            await atomicWriteText(agentFile, rendered.content, existingAgent?.mode ?? 0o644);
+    }
+    catch (error) {
+        if (originalBinding === undefined)
+            await unlink(bindingFile).catch(() => undefined);
+        else
+            await atomicWriteText(bindingFile, originalBinding, 0o644).catch(() => undefined);
+        if (options.noAgentFile) {
+            // No agent file was requested, so there is nothing to restore.
+        }
+        else if (originalAgent === undefined) {
+            await unlink(agentFile).catch(() => undefined);
+        }
+        else {
+            await atomicWriteText(agentFile, originalAgent, existingAgent?.mode ?? 0o644).catch(() => undefined);
+        }
+        throw error;
+    }
+    return result;
+}
+export const use = useRepository;
+//# sourceMappingURL=use.js.map

package/dist/commands/use.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use.js","sourceRoot":"","sources":["../../src/commands/use.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACjF,OAAO,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAClF,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAsB,MAAM,6BAA6B,CAAC;AACpF,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,6BAA6B,EAAE,MAAM,0BAA0B,CAAC;AACzE,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,wBAAwB,EAAE,MAAM,2BAA2B,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AA6B5D,SAAS,eAAe,CAAC,IAAY,EAAE,QAAgB;IACrD,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAClD,IAAI,YAAY,KAAK,YAAY,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,GAAG,YAAY,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC;QAC5F,MAAM,IAAI,YAAY,CAAC,kBAAkB,EAAE,kDAAkD,CAAC,CAAC;IACjG,CAAC;IACD,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,KAAK,UAAU,gBAAgB,CAAC,QAAgB;IAC9C,IAAI,CAAC;QACH,OAAO,MAAM,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC1C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,KAAK,IAAI,MAAM,IAAI,KAAK,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,SAAS,CAAC;QACtH,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,KAAoB;IACvC,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;AAC/C,CAAC;AAED,SAAS,aAAa,CAAC,QAA4B,EAAE,IAAY;IAC/D,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC7C,OAAO,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC;AACrD,CAAC;AAED,SAAS,mBAAmB;IAC1B,OAAO,OAAO,CAAC,GAAG,CAAC,WAAW,KAAK,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,mBAAmB,KAAK,KAAK;QACpF,CAAC,CAAC,qBAAqB;QACvB,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,UAAsB,EAAE;IAC1D,MAAM,WAAW,GAA+C,EAAE,CAAC;IACnE,IAAI,OAAO,CAAC,GAAG,KAAK,SAAS;QAAE,WAAW,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IAC7D,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS;QAAE,WAAW,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAChE,IAAI,OAAO,CAAC,cAAc,KAAK,SAAS;QAAE,WAAW,CAAC,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;IAC9F,MAAM,QAAQ,GAAG,oBAAoB,CAAC,WAAW,CAAC,CAAC;IACnD,MAAM,cAAc,GAAG,QAAQ,CAAC,IAAI,CAAC;IACrC,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,eAAe,CAAC,CAAC;IAC/D,MAAM,mBAAmB,GAAG,MAAM,gBAAgB,CAAC,WAAW,CAAC,CAAC;IAChE,MAAM,eAAe,GAAG,mBAAmB,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,iBAAiB,CAAC,WAAW,CAAC,CAAC;IAC7G,IAAI,eAAe,IAAI,OAAO,CAAC,SAAS,IAAI,eAAe,CAAC,SAAS,KAAK,OAAO,CAAC,SAAS,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;QACpH,MAAM,IAAI,YAAY,CAAC,UAAU,EAAE,2EAA2E,CAAC,CAAC;IAClH,CAAC;IAED,MAAM,kBAAkB,GAAG,OAAO,CAAC,SAAS,IAAI,eAAe,EAAE,SAAS,IAAI,WAAW,CAAC;IAC1F,MAAM,SAAS,GAAG,eAAe,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAC;IACtE,MAAM,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,eAAe,CAAC,SAAS,CAAC,CAAC;IACzF,MAAM,eAAe,GAAmD,EAAE,cAAc,EAAE,CAAC;IAC3F,MAAM,MAAM,GAAG,aAAa,CAAC,cAAc,CAAC,CAAC;IAC7C,IAAI,MAAM,KAAK,SAAS;QAAE,eAAe,CAAC,SAAS,GAAG,MAAM,CAAC;IAC7D,IAAI,OAAO,CAAC,YAAY,KAAK,SAAS;QAAE,eAAe,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IAC5F,IAAI,eAAe,EAAE,CAAC;QACpB,eAAe,CAAC,eAAe,GAAG;YAChC,YAAY,EAAE,eAAe,CAAC,YAAY;YAC1C,SAAS,EAAE,eAAe,CAAC,SAAS;SACrC,CAAC;IACJ,CAAC;IACD,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS;QAAE,eAAe,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IACnF,MAAM,QAAQ,GAAG,wBAAwB,CAAC,eAAe,CAAC,CAAC;IAC3D,IAAI,eAAe,IAAI,OAAO,CAAC,SAAS,IAAI,eAAe,CAAC,SAAS,KAAK,QAAQ,CAAC,SAAS,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC;QACrH,MAAM,IAAI,YAAY,CAAC,UAAU,EAAE,2EAA2E,CAAC,CAAC;IAClH,CAAC;IAED,MAAM,WAAW,GAAkB;QACjC,aAAa,EAAE,CAAC;QAChB,YAAY,EAAE,QAAQ,CAAC,YAAY;QACnC,SAAS,EAAE,QAAQ,CAAC,SAAS;QAC7B,SAAS,EAAE,kBAAkB;QAC7B,eAAe,EAAE,sBAAsB;KACxC,CAAC;IACF,MAAM,eAAe,GAAG,WAAW,CAAC,WAAW,CAAC,CAAC;IACjD,MAAM,QAAQ,GAAG,OAAO,CAAC,WAAW;QAClC,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,eAAe,CAAC,aAAa,EAAE,OAAO,EAAE;YACtC,YAAY,EAAE,QAAQ,CAAC,YAAY;YACnC,SAAS,EAAE,QAAQ,CAAC,SAAS;YAC7B,UAAU,EAAE,mBAAmB,EAAE;YACjC,eAAe,EAAE,sBAAsB;SACxC,CAAC,CAAC;IACP,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,qBAAqB,EAAE,CAAC;IACrE,MAAM,MAAM,GAAc;QACxB,cAAc;QACd,YAAY,EAAE,QAAQ,CAAC,YAAY;QACnC,SAAS,EAAE,QAAQ,CAAC,SAAS;QAC7B,YAAY;QACZ,WAAW;QACX,SAAS,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;QACjD,eAAe,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,EAAE,MAAM,IAAI,WAAW;QAClF,aAAa,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa,CAAC,mBAAmB,EAAE,eAAe,CAAC;QAC/F,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,KAAK;QAC/B,eAAe,EAAE,sBAAsB;KACxC,CAAC;IACF,IAAI,OAAO,CAAC,MAAM;QAAE,OAAO,MAAM,CAAC;IAElC,MAAM,WAAW,GAA6C,EAAE,YAAY,EAAE,CAAC;IAC/E,IAAI,OAAO,CAAC,mBAAmB,KAAK,SAAS;QAAE,WAAW,CAAC,mBAAmB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAC7G,MAAM,kBAAkB,CAAC,WAAW,CAAC,CAAC;IACtC,MAAM,QAAQ,GAAG,cAAc,CAAC,YAAY,CAAC,CAAC;IAC9C,IAAI,YAAqE,CAAC;IAC1E,IAAI,CAAC;QACH,IAAI,CAAC;YACH,6BAA6B,CAAC,QAAQ,EAAE;gBACtC,YAAY,EAAE,QAAQ,CAAC,YAAY;gBACnC,SAAS,EAAE,QAAQ,CAAC,SAAS;gBAC7B,WAAW,EAAE,QAAQ,CAAC,WAAW;gBACjC,aAAa,EAAE,cAAc;gBAC7B,iBAAiB,EAAE,QAAQ,CAAC,iBAAiB;gBAC7C,oBAAoB,EAAE,CAAC;gBACvB,oBAAoB,EAAE,sBAAsB;aAC7C,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,YAAY,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,IAAI,OAAO,CAAC,YAAY,KAAK,SAAS,IAAI,OAAO,CAAC,SAAS,KAAK,SAAS,IAAI,eAAe,KAAK,SAAS,EAAE,CAAC;gBACzK,YAAY,GAAG,QAAQ,CAAC,OAAO,CAAC;;;;SAI/B,CAAC,CAAC,GAAG,CAA8C,cAAc,CAAC,CAAC;YACtE,CAAC;YACD,IAAI,CAAC,YAAY;gBAAE,MAAM,KAAK,CAAC;QACjC,CAAC;IACH,CAAC;YAAS,CAAC;QACT,QAAQ,CAAC,KAAK,EAAE,CAAC;IACnB,CAAC;IACD,IAAI,YAAY,EAAE,CAAC;QACjB,OAAO,aAAa,CAAC,EAAE,GAAG,OAAO,EAAE,YAAY,EAAE,YAAY,CAAC,YAAY,EAAE,SAAS,EAAE,YAAY,CAAC,SAAS,EAAE,CAAC,CAAC;IACnH,CAAC;IAED,MAAM,eAAe,GAAG,mBAAmB,CAAC;IAC5C,MAAM,aAAa,GAAG,aAAa,EAAE,OAAO,CAAC;IAC7C,IAAI,CAAC;QACH,IAAI,MAAM,CAAC,aAAa,KAAK,WAAW;YAAE,MAAM,eAAe,CAAC,WAAW,EAAE,eAAe,EAAE,KAAK,CAAC,CAAC;QACrG,IAAI,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,WAAW;YAAE,MAAM,eAAe,CAAC,SAAS,EAAE,QAAQ,CAAC,OAAO,EAAE,aAAa,EAAE,IAAI,IAAI,KAAK,CAAC,CAAC;IACpI,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,eAAe,KAAK,SAAS;YAAE,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;;YAC/E,MAAM,eAAe,CAAC,WAAW,EAAE,eAAe,EAAE,KAAK,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QACvF,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;YACxB,+DAA+D;QACjE,CAAC;aAAM,IAAI,aAAa,KAAK,SAAS,EAAE,CAAC;YACvC,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QACjD,CAAC;aAAM,CAAC;YACN,MAAM,eAAe,CAAC,SAAS,EAAE,aAAa,EAAE,aAAa,EAAE,IAAI,IAAI,KAAK,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QACvG,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,CAAC,MAAM,GAAG,GAAG,aAAa,CAAC"}

package/dist/config/paths.d.ts

@@ -0,0 +1,18 @@
+export interface PathEnvironment {
+    platform?: NodeJS.Platform;
+    env?: NodeJS.ProcessEnv;
+}
+export declare function getPlatformDataDirectory(options?: PathEnvironment): string;
+export declare function getRuntimeDirectory(options?: PathEnvironment): string;
+export declare function getRuntimeDescriptorPath(options?: PathEnvironment): string;
+export declare function getDatabaseLockPath(databasePath: string, options?: PathEnvironment): string;
+export declare function getGlobalDatabasePath(options?: PathEnvironment): string;
+/** Global Codex configuration directory. CODEX_HOME intentionally takes precedence. */
+export declare function getCodexHome(options?: PathEnvironment): string;
+export declare function getCodexConfigPath(options?: PathEnvironment): string;
+export declare function getCodexInstructionsPath(options?: PathEnvironment): string;
+/** OpenCode's documented global configuration directory. */
+export declare function getOpenCodeConfigDirectory(options?: PathEnvironment): string;
+export declare function getOpenCodeInstructionsPath(options?: PathEnvironment): string;
+export declare function ensurePlatformDataDirectory(options?: PathEnvironment): Promise<string>;
+//# sourceMappingURL=paths.d.ts.map

package/dist/config/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/config/paths.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB;AASD,wBAAgB,wBAAwB,CAAC,OAAO,GAAE,eAAoB,GAAG,MAAM,CAqB9E;AAED,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,eAAoB,GAAG,MAAM,CASzE;AAED,wBAAgB,wBAAwB,CAAC,OAAO,GAAE,eAAoB,GAAG,MAAM,CAI9E;AAED,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,MAAM,CAO/F;AAED,wBAAgB,qBAAqB,CAAC,OAAO,GAAE,eAAoB,GAAG,MAAM,CAI3E;AASD,uFAAuF;AACvF,wBAAgB,YAAY,CAAC,OAAO,GAAE,eAAoB,GAAG,MAAM,CAKlE;AAED,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,eAAoB,GAAG,MAAM,CAIxE;AAED,wBAAgB,wBAAwB,CAAC,OAAO,GAAE,eAAoB,GAAG,MAAM,CAI9E;AAED,4DAA4D;AAC5D,wBAAgB,0BAA0B,CAAC,OAAO,GAAE,eAAoB,GAAG,MAAM,CAUhF;AAED,wBAAgB,2BAA2B,CAAC,OAAO,GAAE,eAAoB,GAAG,MAAM,CAIjF;AAED,wBAAsB,2BAA2B,CAAC,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,CAIhG"}

package/dist/config/paths.js

@@ -0,0 +1,104 @@
+import path from 'node:path';
+import { createHash } from 'node:crypto';
+import { mkdir } from 'node:fs/promises';
+import { KiokukoError } from '../errors.js';
+function selectedEnvironment({ platform = process.platform, env = process.env }) {
+    return { platform, env };
+}
+export function getPlatformDataDirectory(options = {}) {
+    const { platform, env } = selectedEnvironment(options);
+    const join = platform === 'win32' ? path.win32.join : path.posix.join;
+    if (platform === 'win32') {
+        const root = env.LOCALAPPDATA ?? env.APPDATA ?? env.USERPROFILE;
+        if (!root) {
+            throw new KiokukoError('VALIDATION_ERROR', 'A Windows user data directory is unavailable');
+        }
+        return join(root, 'kiokuko');
+    }
+    if (platform === 'darwin') {
+        const home = env.HOME;
+        if (!home)
+            throw new KiokukoError('VALIDATION_ERROR', 'HOME is unavailable');
+        return join(home, 'Library', 'Application Support', 'kiokuko');
+    }
+    const root = env.XDG_DATA_HOME || (env.HOME ? join(env.HOME, '.local', 'share') : undefined);
+    if (!root)
+        throw new KiokukoError('VALIDATION_ERROR', 'XDG_DATA_HOME or HOME is unavailable');
+    return join(root, 'kiokuko');
+}
+export function getRuntimeDirectory(options = {}) {
+    const { platform, env } = selectedEnvironment(options);
+    const join = platform === 'win32' ? path.win32.join : path.posix.join;
+    if (platform === 'linux' && env.XDG_RUNTIME_DIR) {
+        return join(env.XDG_RUNTIME_DIR, 'kiokuko');
+    }
+    return getPlatformDataDirectory(options);
+}
+export function getRuntimeDescriptorPath(options = {}) {
+    const { platform } = selectedEnvironment(options);
+    const join = platform === 'win32' ? path.win32.join : path.posix.join;
+    return join(getRuntimeDirectory(options), 'server.json');
+}
+export function getDatabaseLockPath(databasePath, options = {}) {
+    const { platform } = selectedEnvironment(options);
+    const platformPath = platform === 'win32' ? path.win32 : path.posix;
+    const resolvedPath = platformPath.resolve(databasePath);
+    const fingerprint = createHash('sha256').update(resolvedPath, 'utf8').digest('hex');
+    const join = platform === 'win32' ? path.win32.join : path.posix.join;
+    return join(getRuntimeDirectory(options), `${fingerprint}.lock`);
+}
+export function getGlobalDatabasePath(options = {}) {
+    const { platform } = selectedEnvironment(options);
+    const join = platform === 'win32' ? path.win32.join : path.posix.join;
+    return join(getPlatformDataDirectory(options), 'kiokuko.sqlite3');
+}
+function requireHome(options) {
+    const { platform, env } = selectedEnvironment(options);
+    const home = platform === 'win32' ? (env.USERPROFILE ?? env.HOME) : env.HOME;
+    if (!home)
+        throw new KiokukoError('VALIDATION_ERROR', 'The user home directory is unavailable');
+    return { home, join: platform === 'win32' ? path.win32.join : path.posix.join };
+}
+/** Global Codex configuration directory. CODEX_HOME intentionally takes precedence. */
+export function getCodexHome(options = {}) {
+    const { platform, env } = selectedEnvironment(options);
+    if (env.CODEX_HOME)
+        return env.CODEX_HOME;
+    const { home, join } = requireHome(options);
+    return join(home, '.codex');
+}
+export function getCodexConfigPath(options = {}) {
+    const { platform } = selectedEnvironment(options);
+    const join = platform === 'win32' ? path.win32.join : path.posix.join;
+    return join(getCodexHome(options), 'config.toml');
+}
+export function getCodexInstructionsPath(options = {}) {
+    const { platform } = selectedEnvironment(options);
+    const join = platform === 'win32' ? path.win32.join : path.posix.join;
+    return join(getCodexHome(options), 'AGENTS.md');
+}
+/** OpenCode's documented global configuration directory. */
+export function getOpenCodeConfigDirectory(options = {}) {
+    const { platform, env } = selectedEnvironment(options);
+    const join = platform === 'win32' ? path.win32.join : path.posix.join;
+    if (platform === 'win32') {
+        const root = env.APPDATA ?? env.LOCALAPPDATA;
+        if (root)
+            return join(root, 'opencode');
+    }
+    if (env.XDG_CONFIG_HOME)
+        return join(env.XDG_CONFIG_HOME, 'opencode');
+    const { home } = requireHome(options);
+    return join(home, '.config', 'opencode');
+}
+export function getOpenCodeInstructionsPath(options = {}) {
+    const { platform } = selectedEnvironment(options);
+    const join = platform === 'win32' ? path.win32.join : path.posix.join;
+    return join(getOpenCodeConfigDirectory(options), 'AGENTS.md');
+}
+export async function ensurePlatformDataDirectory(options = {}) {
+    const directory = getPlatformDataDirectory(options);
+    await mkdir(directory, { recursive: true, mode: 0o700 });
+    return directory;
+}
+//# sourceMappingURL=paths.js.map

package/dist/config/paths.js.map

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

package/dist/config/project-config.d.ts

@@ -0,0 +1,10 @@
+export interface ProjectConfig {
+    schemaVersion: 1;
+    repositoryId: string;
+    workspace: string;
+    agentFile: string;
+    templateVersion: number;
+}
+export declare function parseProjectConfig(value: unknown): ProjectConfig;
+export declare function readProjectConfig(filePath: string): Promise<ProjectConfig>;
+//# sourceMappingURL=project-config.d.ts.map

package/dist/config/project-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-config.d.ts","sourceRoot":"","sources":["../../src/config/project-config.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,aAAa;IAC5B,aAAa,EAAE,CAAC,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,CAAC;CACzB;AAmBD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa,CA8BhE;AAED,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAOhF"}

package/dist/config/project-config.js

@@ -0,0 +1,59 @@
+import { readFile } from 'node:fs/promises';
+import path from 'node:path';
+import { KiokukoError } from '../errors.js';
+// Binding validation is deliberately strict: unknown fields are rejected rather than ignored.
+const REQUIRED_FIELDS = new Set(['schemaVersion', 'repositoryId', 'workspace', 'agentFile', 'templateVersion']);
+function isPlainObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function validateAgentFile(agentFile) {
+    if (typeof agentFile !== 'string' || agentFile.length === 0 || agentFile.includes('\0')) {
+        throw new KiokukoError('VALIDATION_ERROR', 'agentFile must be a non-empty relative path');
+    }
+    const normalized = agentFile.replaceAll('\\', '/');
+    if (path.posix.isAbsolute(normalized) || /^[A-Za-z]:\//.test(normalized) || normalized.split('/').includes('..')) {
+        throw new KiokukoError('VALIDATION_ERROR', 'agentFile must remain inside the repository root');
+    }
+}
+export function parseProjectConfig(value) {
+    if (!isPlainObject(value)) {
+        throw new KiokukoError('VALIDATION_ERROR', 'binding must be a JSON object');
+    }
+    for (const field of Object.keys(value)) {
+        if (!REQUIRED_FIELDS.has(field)) {
+            throw new KiokukoError('VALIDATION_ERROR', `Unknown binding field: ${field}`);
+        }
+    }
+    if (value.schemaVersion !== 1) {
+        throw new KiokukoError('VALIDATION_ERROR', 'Unsupported binding schemaVersion');
+    }
+    if (typeof value.repositoryId !== 'string' || value.repositoryId.length === 0) {
+        throw new KiokukoError('VALIDATION_ERROR', 'repositoryId must be a non-empty string');
+    }
+    if (typeof value.workspace !== 'string' || value.workspace.length === 0) {
+        throw new KiokukoError('VALIDATION_ERROR', 'workspace must be a non-empty string');
+    }
+    validateAgentFile(value.agentFile);
+    const templateVersion = value.templateVersion;
+    if (typeof templateVersion !== 'number' || !Number.isInteger(templateVersion) || templateVersion < 1) {
+        throw new KiokukoError('VALIDATION_ERROR', 'templateVersion must be a positive integer');
+    }
+    return {
+        schemaVersion: 1,
+        repositoryId: value.repositoryId,
+        workspace: value.workspace,
+        agentFile: value.agentFile,
+        templateVersion,
+    };
+}
+export async function readProjectConfig(filePath) {
+    try {
+        return parseProjectConfig(JSON.parse(await readFile(filePath, 'utf8')));
+    }
+    catch (error) {
+        if (error instanceof KiokukoError)
+            throw error;
+        throw new KiokukoError('VALIDATION_ERROR', 'Unable to read project binding JSON');
+    }
+}
+//# sourceMappingURL=project-config.js.map

package/dist/config/project-config.js.map

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

package/dist/context/broker.d.ts

@@ -0,0 +1,80 @@
+import type { SqliteDatabase } from '../db/adapter.js';
+import type { TaskProfile } from '../akinator/types.js';
+import { listContextDeliveries, type ContextDeliveryInput, type ContextDeliveryView, type ExternalSyncSummary } from './delivery.js';
+import { type Recommendation } from './recommendations.js';
+import { type RankedCandidate } from './ranking.js';
+import { type LedgerProjection } from '../ledger/projection.js';
+import { type PreparedOfficialSourceSync, type SourceSyncResult } from '../knowledge/sources.js';
+export declare const CONTEXT_BROKER_POLICY_VERSION: "context-ranking-v1+recommendations.v1";
+export declare const CONTEXT_BROKER_DEFAULT_LIMIT = 20;
+export declare const CONTEXT_BROKER_MAX_LIMIT = 100;
+export declare const CONTEXT_BROKER_DEFAULT_CHARACTER_BUDGET = 8000;
+export declare const CONTEXT_BROKER_MAX_CHARACTER_BUDGET = 100000;
+export interface ContextBrokerQueryInput {
+    workspace?: string;
+    runId?: string;
+    task?: string;
+    taskProfile?: TaskProfile;
+    recommendedTags?: string[];
+    changedPaths?: string[];
+    errorSignatures?: string[];
+    limit?: number;
+    characterBudget?: number;
+}
+export interface ContextBrokerContextItem {
+    entryId: string;
+    entryRevision: number;
+    rank: number;
+    scoreComponents: RankedCandidate['scoreComponents'];
+    selectionReasons: string[];
+    content: RankedCandidate['content'];
+    untrusted: true;
+}
+export interface ContextBrokerContext {
+    deliveryId: string | null;
+    runId: string | null;
+    throughSequence: number;
+    taskProfileHash: string;
+    queryHash: string;
+    policyVersion: typeof CONTEXT_BROKER_POLICY_VERSION;
+    items: ContextBrokerContextItem[];
+    untrusted: true;
+}
+export interface ContextBrokerResult {
+    status: 'needs_answer' | 'ready' | 'exhausted' | 'unbound';
+    taskProfile: TaskProfile;
+    profileHash: string;
+    acceptedThrough: number;
+    intakeSessionId: string | null;
+    recommendedTags: string[];
+    projection: LedgerProjection | null;
+    context: ContextBrokerContext | null;
+    recommendations: Recommendation[];
+    externalSyncSummary: ExternalSyncSummary;
+}
+export interface ContextBrokerPersistence {
+    persistSources?: (workspace: string, prepared: PreparedOfficialSourceSync) => Promise<SourceSyncResult> | SourceSyncResult;
+    persistDelivery?: (input: ContextDeliveryInput) => Promise<ContextDeliveryView> | ContextDeliveryView;
+}
+export interface ContextBrokerOptions {
+    readonly now?: () => string;
+    readonly fetchImpl?: typeof fetch;
+}
+export declare class ContextBroker {
+    private readonly database;
+    private readonly options;
+    private readonly inFlight;
+    constructor(database: SqliteDatabase, options?: ContextBrokerOptions);
+    listDeliveries(input: {
+        runId: string;
+        cursor?: string;
+        limit?: number;
+    }): ReturnType<typeof listContextDeliveries> & {
+        untrusted: true;
+    };
+    query(rawInput: unknown, persistence?: ContextBrokerPersistence): Promise<ContextBrokerResult>;
+    private queryPrepared;
+}
+export declare function contextBrokerQueryHash(input: unknown): string;
+export declare function newContextDeliveryId(): string;
+//# sourceMappingURL=broker.d.ts.map

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

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