kimaki 0.31.0 → 1.0.0

package/dist/onboarding-cli.e2e.test.js

@@ -0,0 +1,178 @@
+// Non-interactive gateway onboarding through the real CLI process, like a
+// cloud sandbox: stdout carries SSE events (install_url, authorized, ready).
+// A local fake kimaki.dev answers /api/onboarding/status and, like the real
+// OAuth callback, authorizes the new client in the twin, which plays
+// gateway-proxy (REST scope rules enforced).
+import { execFile, spawn } from 'node:child_process';
+import fs from 'node:fs';
+import http from 'node:http';
+import { createRequire } from 'node:module';
+import path from 'node:path';
+import { promisify } from 'node:util';
+import { afterAll, beforeAll, expect, test } from 'vitest';
+import { createApi } from "./project.js";
+import { freePort, startOpencodeTestServer, startTwin, tempDataDir, TEST_USER_ID, textParts, waitFor, waitForFooter, warmUp, } from "./test/harness.js";
+const execFileAsync = promisify(execFile);
+let server;
+let twin;
+let website;
+let websiteUrl;
+let dataDir;
+let child = null;
+beforeAll(async () => {
+    dataDir = tempDataDir();
+    [server, twin] = await Promise.all([
+        startOpencodeTestServer({
+            matchers: [
+                {
+                    id: 'onboarding-greeting',
+                    priority: 50,
+                    when: { latestUserTextIncludes: 'This is the Kimaki onboarding thread' },
+                    then: { parts: textParts('Want channels for your projects?') },
+                },
+            ],
+        }),
+        startTwin({ gateway: true }),
+    ]);
+    await warmUp({ server });
+    // Fake kimaki.dev: the user "installs" the bot as soon as the CLI polls.
+    website = http.createServer((request, response) => {
+        const url = new URL(request.url ?? '/', 'http://localhost');
+        if (url.pathname !== '/api/onboarding/status') {
+            response.writeHead(404).end();
+            return;
+        }
+        twin.discord.authorizeGatewayClient({
+            token: `${url.searchParams.get('client_id')}:${url.searchParams.get('secret')}`,
+            guildIds: [twin.discord.guildId],
+        });
+        response.setHeader('content-type', 'application/json');
+        response.end(JSON.stringify({ guild_id: twin.discord.guildId, discord_user_id: TEST_USER_ID }));
+    });
+    const port = await freePort();
+    await new Promise((resolve) => website.listen(port, '127.0.0.1', resolve));
+    websiteUrl = `http://127.0.0.1:${port}`;
+}, 60_000);
+afterAll(async () => {
+    if (child && child.exitCode === null) {
+        const exited = new Promise((resolve) => child?.once('exit', resolve));
+        child.kill('SIGTERM');
+        await exited;
+    }
+    await new Promise((resolve) => website?.close(() => resolve()));
+    await twin?.stop();
+    await server?.stop();
+    fs.rmSync(dataDir, { recursive: true, force: true });
+});
+function sseEvents(stdout) {
+    return stdout
+        .split('\n\n')
+        .filter((chunk) => chunk.startsWith('data: '))
+        .map((chunk) => JSON.parse(chunk.slice('data: '.length)));
+}
+test('kimaki --gateway without a TTY installs, onboards and reports ready on stdout', async () => {
+    const require = createRequire(import.meta.url);
+    const proxy = new URL('/', twin.discord.restUrl).toString();
+    const lockPort = await freePort();
+    child = spawn(process.execPath, ['--import', require.resolve('tsx'), path.resolve('src/cli.ts'), '--data-dir', dataDir, '--gateway', '--machine-name', 'test-machine'], {
+        env: {
+            ...process.env,
+            KIMAKI_WEBSITE_URL: websiteUrl,
+            KIMAKI_GATEWAY_PROXY_URL: proxy,
+            KIMAKI_LOCK_PORT: String(lockPort),
+            KIMAKI_OPENCODE_SERVICE_FILE: server.serviceFile,
+            OPENCODE_CONFIG_DIR: server.configDir,
+        },
+    });
+    const output = { stdout: '', stderr: '' };
+    child.stdout.on('data', (chunk) => (output.stdout += chunk.toString()));
+    child.stderr.on('data', (chunk) => (output.stderr += chunk.toString()));
+    await waitFor({
+        label: `ready event (stderr: ${output.stderr.slice(-500)})`,
+        timeout: 10_000,
+        check: async () => sseEvents(output.stdout).some((event) => event['type'] === 'ready'),
+    });
+    const token = (sseEvents(output.stdout)[0]?.['url']).match(/clientId=([^&]+)&clientSecret=([^&]+)/);
+    expect(sseEvents(output.stdout).map((event) => JSON.parse(JSON.stringify(event)
+        .replaceAll(websiteUrl, '<website>')
+        .replaceAll(token?.[1] ?? '-', '<clientId>')
+        .replaceAll(token?.[2] ?? '-', '<secret>')
+        .replaceAll(twin.discord.guildId, '<guild>')))).toMatchInlineSnapshot(`
+    [
+      {
+        "type": "install_url",
+        "url": "<website>/discord-install?clientId=<clientId>&clientSecret=<secret>",
+      },
+      {
+        "guild_id": "<guild>",
+        "type": "authorized",
+      },
+      {
+        "app_id": "1477605701202481173",
+        "guild_ids": [
+          "<guild>",
+        ],
+        "type": "ready",
+      },
+    ]
+  `);
+    const channels = await createApi({ token: twin.discord.botToken, restUrl: twin.discord.restUrl }).guilds.getChannels(twin.discord.guildId);
+    const names = new Map(channels.map((channel) => [channel.id, channel.name]));
+    expect(channels.map((channel) => `${channel.name}${channel.parent_id ? ` (in ${names.get(channel.parent_id)})` : ''}`)).toMatchInlineSnapshot(`
+    [
+      "project",
+      "random",
+      "quiet",
+      "Kimaki test-machine",
+      "kimaki (in Kimaki test-machine)",
+      "Kimaki voice test-machine",
+    ]
+  `);
+    const kimakiChannel = channels.find((channel) => channel.name === 'kimaki');
+    const thread = await twin.discord.channel(kimakiChannel.id).waitForThread({ timeout: 8_000 });
+    await waitForFooter({ discord: twin.discord, threadId: thread.id });
+    expect(await twin.discord.thread(thread.id).text()).toMatchInlineSnapshot(`
+    "--- from: assistant (TestBot)
+    **Kimaki** lets you code from Discord. Each project channel is linked to a folder on your computer. A message there starts an AI coding session in that folder.
+    Reply in the thread below to add channels for your projects. <@200000000000000001>
+    -# *using deterministic-provider/deterministic-v2 ⋅ build*
+    Want channels for your projects?
+    -# *kimaki ⋅ main ⋅ Ns ⋅ N% ⋅ deterministic-v2*"
+  `);
+    // `kimaki restart`: the supervisor starts a new bot process, which reports ready again.
+    const cli = (args) => execFileAsync(process.execPath, ['--import', require.resolve('tsx'), path.resolve('src/cli.ts'), ...args, '--data-dir', dataDir], {
+        env: { ...process.env, KIMAKI_LOCK_PORT: String(lockPort) },
+    });
+    const before = JSON.parse((await cli(['status', '--json'])).stdout);
+    await cli(['restart']);
+    await waitFor({
+        label: `second ready event (stderr: ${output.stderr.slice(-500)})`,
+        check: async () => sseEvents(output.stdout).filter((event) => event['type'] === 'ready').length === 2,
+    });
+    const after = JSON.parse((await cli(['status', '--json'])).stdout);
+    expect({ newPid: after.pid !== before.pid, supervisorAlive: child.exitCode === null }).toEqual({ newPid: true, supervisorAlive: true });
+}, 40_000);
+test('--install-url --gateway prints the install URL with the callback and exits', async () => {
+    const otherDataDir = tempDataDir();
+    const require = createRequire(import.meta.url);
+    const result = await new Promise((resolve) => {
+        const process_ = spawn(process.execPath, [
+            '--import', require.resolve('tsx'), path.resolve('src/cli.ts'),
+            '--data-dir', otherDataDir, '--install-url', '--gateway', '--gateway-callback-url', 'https://example.com/done',
+        ], { env: { ...process.env, KIMAKI_WEBSITE_URL: 'https://kimaki.test' } });
+        const output = { stdout: '' };
+        process_.stdout.on('data', (chunk) => (output.stdout += chunk.toString()));
+        process_.once('exit', (code) => resolve({ code, stdout: output.stdout }));
+    });
+    fs.rmSync(otherDataDir, { recursive: true, force: true });
+    expect({
+        code: result.code,
+        url: result.stdout.trim().replace(/clientId=[^&]+&clientSecret=[^&]+/, 'clientId=<clientId>&clientSecret=<secret>'),
+    }).toMatchInlineSnapshot(`
+    {
+      "code": 0,
+      "url": "https://kimaki.test/discord-install?clientId=<clientId>&clientSecret=<secret>&kimakiCallbackUrl=https%3A%2F%2Fexample.com%2Fdone",
+    }
+  `);
+});
+//# sourceMappingURL=onboarding-cli.e2e.test.js.map

package/dist/onboarding-cli.e2e.test.js.map

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

package/dist/onboarding.d.ts

@@ -0,0 +1,36 @@
+import { type Client, type Guild } from 'discord.js';
+import { ConfigError, OpenCodeMissingError, type OpenCodeV1Error, type OpenCodeVersionError } from './errors.ts';
+import type { Bot } from './bot.ts';
+export declare function chooseGuild({ discord, guildId, installUrl, gateway, }: {
+    discord: Client;
+    guildId?: string;
+    installUrl: string;
+    gateway: boolean;
+}): Promise<ConfigError | Guild>;
+export declare function ensureOpencode({ serviceFile, }: {
+    serviceFile?: string;
+}): Promise<OpenCodeMissingError | OpenCodeV1Error | OpenCodeVersionError | ConfigError | void>;
+export declare function startCaffeinate(): void;
+export declare function shellQuote(arg: string): string;
+export declare function onboardingPrompt({ kimaki }: {
+    kimaki: string;
+}): string;
+export declare function kimakiShellCommand({ command }: {
+    command: readonly string[];
+}): string;
+export type OnboardingResult = {
+    guildId: string;
+    channelId: string;
+    threadId: string;
+} | null;
+export declare function runOnboarding({ bot, dataDir, guild, guildId, installUrl, kimaki, gateway, installerId, machine, }: {
+    bot: Bot;
+    dataDir: string;
+    guild?: Guild;
+    guildId?: string;
+    installUrl?: string;
+    kimaki: string;
+    gateway: boolean;
+    machine: string;
+    installerId?: string | null;
+}): Promise<Error | OnboardingResult>;

package/dist/onboarding.e2e.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/onboarding.e2e.test.js

@@ -0,0 +1,148 @@
+// First start in gateway mode (the twin plays gateway-proxy): the bot creates
+// the default channel with an onboarding thread, the onboarding session adds a
+// project channel with `kimaki project add` (real CLI process, run by the
+// agent's shell tool, reading the saved gateway credentials), and the new
+// channel answers without a bot restart.
+import { execFileSync } from 'node:child_process';
+import fs from 'node:fs';
+import { createRequire } from 'node:module';
+import path from 'node:path';
+import { API } from '@discordjs/core/http-only';
+import { ChannelType } from 'discord.js';
+import { afterAll, beforeAll, expect, test } from 'vitest';
+import { kimakiShellCommand, runOnboarding } from "./onboarding.js";
+import { TEST_USER_ID, scriptedTurn, startOpencodeTestServer, startTestBot, startTwin, tempDataDir, textParts, waitFor, waitForFooter, warmUp, } from "./test/harness.js";
+let server;
+let twin;
+let bot;
+let dataDir;
+let kimaki;
+let otherProject;
+beforeAll(async () => {
+    dataDir = tempDataDir();
+    twin = await startTwin({ gateway: true });
+    const require = createRequire(import.meta.url);
+    kimaki = kimakiShellCommand({
+        command: [process.execPath, require.resolve('tsx/cli'), path.join(import.meta.dirname, 'cli.ts')],
+    });
+    otherProject = path.join(dataDir, 'other-project');
+    fs.mkdirSync(otherProject);
+    execFileSync('git', ['init', '-q'], { cwd: otherProject });
+    server = await startOpencodeTestServer({
+        matchers: [
+            {
+                id: 'onboarding-greeting',
+                priority: 50,
+                when: { latestUserTextIncludes: 'This is the Kimaki onboarding thread' },
+                then: { parts: textParts('Want channels for your projects? I can search for git repositories.') },
+            },
+            ...scriptedTurn({
+                marker: 'add-other-project',
+                steps: [
+                    {
+                        id: 'call-project-add',
+                        tool: 'shell',
+                        input: { command: `${kimaki} project add ${otherProject}`, description: 'add project channel' },
+                    },
+                ],
+                finalText: 'Added the channel for other-project.',
+            }),
+        ],
+    });
+    await warmUp({ server });
+    bot = await startTestBot({ dataDir, twin, server });
+}, 120_000);
+afterAll(async () => {
+    await bot?.stop();
+    await twin?.stop();
+    await server?.stop();
+    fs.rmSync(dataDir, { recursive: true, force: true });
+});
+async function guildChannels() {
+    const channels = await new API(bot.discord.rest).guilds.getChannels(twin.discord.guildId);
+    const names = new Map(channels.map((channel) => [channel.id, channel.name]));
+    return channels.map((channel) => {
+        const parent = channel.parent_id ? names.get(channel.parent_id) : null;
+        return `${channel.name}${parent ? ` (in ${parent})` : ''}`;
+    });
+}
+test('onboarding thread adds a project channel through the kimaki CLI, which answers at once', async () => {
+    const { discord } = twin;
+    const guild = bot.discord.guilds.cache.get(discord.guildId);
+    const onboarded = await runOnboarding({ bot, dataDir, guild, kimaki, gateway: true, installerId: TEST_USER_ID, machine: 'test-machine' });
+    if (!onboarded || onboarded instanceof Error)
+        throw new Error(`onboarding failed: ${onboarded?.message}`, { cause: onboarded });
+    await waitForFooter({ discord, threadId: onboarded.threadId });
+    await discord.thread(onboarded.threadId).user(TEST_USER_ID).sendMessage({ content: 'yes, add-other-project' });
+    await waitForFooter({ discord, threadId: onboarded.threadId, count: 2 });
+    expect(await discord.channel(onboarded.channelId).text()).toMatchInlineSnapshot(`
+    "--- from: assistant (TestBot)
+    **Kimaki** lets you code from Discord. Each project channel is linked to a folder on your computer. A message there starts an AI coding session in that folder.
+    Reply in the thread below to add channels for your projects. <@200000000000000001>"
+  `);
+    expect(await discord.thread(onboarded.threadId).text()).toMatchInlineSnapshot(`
+    "--- from: assistant (TestBot)
+    **Kimaki** lets you code from Discord. Each project channel is linked to a folder on your computer. A message there starts an AI coding session in that folder.
+    Reply in the thread below to add channels for your projects. <@200000000000000001>
+    -# *using deterministic-provider/deterministic-v2 ⋅ build*
+    Want channels for your projects? I can search for git repositories.
+    -# *kimaki ⋅ main ⋅ Ns ⋅ N% ⋅ deterministic-v2*
+    --- from: user (tommy)
+    yes, add-other-project
+    --- from: assistant (TestBot)
+    -# ┣ shell _add project channel_
+
+    Added the channel for other-project.
+    -# *kimaki ⋅ main ⋅ Ns ⋅ N% ⋅ deterministic-v2*"
+  `);
+    expect(await guildChannels()).toMatchInlineSnapshot(`
+    [
+      "project",
+      "random",
+      "quiet",
+      "Kimaki test-machine",
+      "kimaki (in Kimaki test-machine)",
+      "other-project (in Kimaki test-machine)",
+    ]
+  `);
+    const rows = await bot.db.query.channel_directories.findMany({ orderBy: { created_at: 'asc' } });
+    expect(rows.map((row) => path.relative(dataDir, row.directory))).toMatchInlineSnapshot(`
+    [
+      "projects/kimaki",
+      "other-project",
+    ]
+  `);
+    // The new channel answers without restarting the bot.
+    const added = rows.find((row) => row.directory === otherProject);
+    await discord.channel(added.channel_id).user(TEST_USER_ID).sendMessage({ content: 'hello new channel' });
+    const thread = await discord.channel(added.channel_id).waitForThread({ timeout: 8_000 });
+    await waitForFooter({ discord, threadId: thread.id });
+    // Second start: nothing is created again.
+    expect(await runOnboarding({ bot, dataDir, guild, kimaki, gateway: true, machine: 'test-machine' })).toBe(null);
+    await waitFor({ label: 'no extra channels', check: async () => (await guildChannels()).length === 6 });
+    // An empty default channel means an earlier onboarding failed: retry in the same channel.
+    const defaultChannel = rows.find((row) => row.directory !== otherProject);
+    const channel = await bot.discord.channels.fetch(defaultChannel.channel_id);
+    if (channel?.type !== ChannelType.GuildText)
+        throw new Error('default channel is not a text channel');
+    for (const message of (await channel.messages.fetch()).values())
+        await message.delete();
+    const retried = await runOnboarding({ bot, dataDir, guild, kimaki, gateway: true, installerId: TEST_USER_ID, machine: 'test-machine' });
+    if (retried instanceof Error || !retried)
+        throw new Error(`expected a retried onboarding, got ${retried}`);
+    expect(retried.channelId).toBe(defaultChannel.channel_id);
+    await waitForFooter({ discord, threadId: retried.threadId });
+    expect((await guildChannels()).length).toBe(6);
+}, 30_000);
+test('an upgraded setup with project mappings skips onboarding without selecting a server', async () => {
+    const before = await guildChannels();
+    expect(await runOnboarding({
+        bot,
+        dataDir: path.join(dataDir, 'upgraded-layout'),
+        kimaki,
+        gateway: true,
+        machine: 'test-machine',
+    })).toBe(null);
+    expect(await guildChannels()).toEqual(before);
+});
+//# sourceMappingURL=onboarding.e2e.test.js.map

package/dist/onboarding.e2e.test.js.map

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

package/dist/onboarding.js

@@ -0,0 +1,261 @@
+// First-run onboarding. Kimaki does not ask which projects to add. It creates
+// one default channel, backed by <dataDir>/projects/kimaki, posts a welcome
+// message, and starts a session in a thread under it. That session asks the
+// user which projects they want, searches for them, and adds channels with
+// `kimaki project add` (see project.ts).
+//
+//   credentials (credentials.ts) ─▶ bot ready ─▶ pick guild (gateway: the
+//     installed one) ─▶ "Kimaki <machine>" category + #kimaki channel ─▶ welcome message
+//     ─▶ "Kimaki onboarding" thread + session with ONBOARDING prompt
+//
+// Existing project mappings also mark an upgraded install as already configured.
+import { execFile, spawn } from 'node:child_process';
+import fs from 'node:fs';
+import path from 'node:path';
+import { promisify } from 'node:util';
+import * as clack from '@clack/prompts';
+import { ChannelType, Events } from 'discord.js';
+import * as errore from 'errore';
+import dedent from 'string-dedent';
+import { API } from '@discordjs/core/http-only';
+import { ConfigError, DbError, DiscordError, OpenCodeMissingError } from "./errors.js";
+import { NOTIFY_MESSAGE_FLAGS } from "./format-parts.js";
+import { createLogger } from "./logger.js";
+import { checkOpencode, findOpencodeBinary, installedOpencodeBinary, OPENCODE_INSTALL_COMMAND } from "./opencode-server.js";
+import { startSession } from "./sessions.js";
+import { addProjectChannel, defaultChannelName, defaultProjectDirectory } from "./project.js";
+const logger = createLogger('ONBOARD');
+const execFileAsync = promisify(execFile);
+const DEFAULT_CHANNEL_TOPIC = 'General channel for misc tasks with Kimaki. Not connected to a specific project or repository.';
+// Waits until a self-hosted bot is in at least one server. A gateway client
+// in no server cannot be fixed by waiting: the install URL must be opened
+// again (V1 behavior), so that is an error with the URL.
+async function waitForGuild({ discord, installUrl, gateway }) {
+    const first = discord.guilds.cache.first();
+    if (first)
+        return first;
+    if (gateway) {
+        return new ConfigError({ reason: `The Kimaki bot is in no Discord server. Open this URL to add it (do not share it, it contains your credentials), then run kimaki again: ${installUrl}` });
+    }
+    logger.log(`bot is in no server yet, install it: ${installUrl}`);
+    process.stderr.write(`\nAdd the bot to your Discord server:\n${installUrl}\n\nWaiting...\n`);
+    return new Promise((resolve) => discord.once(Events.GuildCreate, resolve));
+}
+// Many servers: --guild, else a prompt, else an error listing the choices.
+export async function chooseGuild({ discord, guildId, installUrl, gateway, }) {
+    if (guildId) {
+        const guild = discord.guilds.cache.get(guildId);
+        return guild ?? new ConfigError({ reason: `The bot is not in server ${guildId}` });
+    }
+    const guilds = [...discord.guilds.cache.values()];
+    if (guilds.length <= 1)
+        return waitForGuild({ discord, installUrl, gateway });
+    if (!process.stdin.isTTY) {
+        const choices = guilds.map((guild) => `${guild.id} (${guild.name})`).join(', ');
+        return new ConfigError({ reason: `The bot is in several servers: ${choices}. Pass --guild <id>.` });
+    }
+    const picked = await clack.select({
+        message: 'Which server should Kimaki use?',
+        options: guilds.map((guild) => ({ value: guild.id, label: guild.name })),
+    });
+    if (clack.isCancel(picked))
+        return new ConfigError({ reason: 'Onboarding cancelled' });
+    return discord.guilds.cache.get(picked) ?? new ConfigError({ reason: `Unknown server ${picked}` });
+}
+// Before the Discord install: a running OpenCode service, or a V2 binary to
+// start one. When OpenCode is missing it installs V2 with the official script,
+// like V1 installed its tools (asks first in a terminal). An OpenCode 1 or an
+// old V2 is never replaced: the error tells the user how to install V2.
+export async function ensureOpencode({ serviceFile, }) {
+    const checked = await checkOpencode({ serviceFile });
+    if (checked instanceof Error)
+        return checked;
+    if (checked === 'ready')
+        return;
+    const missing = new OpenCodeMissingError({ install: OPENCODE_INSTALL_COMMAND });
+    // The script is bash-only; OPENCODE_PATH points at a binary the user chose.
+    if (process.platform === 'win32' || process.env['OPENCODE_PATH'])
+        return missing;
+    if (process.stdin.isTTY) {
+        const confirmed = await clack.confirm({ message: `Kimaki requires OpenCode 2. Install it now with \`${OPENCODE_INSTALL_COMMAND}\`?` });
+        if (clack.isCancel(confirmed) || !confirmed)
+            return missing;
+    }
+    else {
+        logger.log(`OpenCode 2 not found, installing: ${OPENCODE_INSTALL_COMMAND}`);
+    }
+    // Script output goes to stderr: stdout is for `data:` events (logging rules in AGENTS.md).
+    const exitCode = await new Promise((resolve) => {
+        const child = spawn('/bin/bash', ['-c', OPENCODE_INSTALL_COMMAND], { stdio: ['ignore', 2, 2], signal: AbortSignal.timeout(600_000) });
+        child.on('error', (cause) => resolve(new ConfigError({ reason: 'OpenCode install failed to run', cause })));
+        child.on('close', (code) => resolve(code ?? 1));
+    });
+    if (exitCode instanceof Error)
+        return exitCode;
+    if (exitCode !== 0)
+        return new ConfigError({ reason: `OpenCode install exited with code ${exitCode}. ${missing.message}` });
+    const installed = await findOpencodeBinary();
+    if (installed instanceof Error)
+        return installed;
+    if (installed === null)
+        return new ConfigError({ reason: `OpenCode install finished but ${installedOpencodeBinary()} does not run. ${missing.message}` });
+    logger.info(`installed OpenCode 2 at ${installed}`);
+}
+// macOS: keep the machine awake while the bot runs (-s also on lid close on
+// AC power). -w exits caffeinate with this process, whatever ends it.
+export function startCaffeinate() {
+    if (process.platform !== 'darwin')
+        return;
+    const child = errore.try(() => spawn('caffeinate', ['-s', '-w', String(process.pid)], { stdio: 'ignore' }), (e) => new ConfigError({ reason: 'caffeinate failed to start', cause: e }));
+    if (child instanceof Error) {
+        logger.warn(child);
+        return;
+    }
+    child.on('error', (error) => logger.warn(`caffeinate`, error));
+    child.unref();
+}
+export function shellQuote(arg) {
+    return /^[\w@%+=:,./-]+$/.test(arg) ? arg : `'${arg.replaceAll("'", `'\\''`)}'`;
+}
+export function onboardingPrompt({ kimaki }) {
+    return dedent `
+    This is the Kimaki onboarding thread. Kimaki maps Discord channels to project folders on this computer:
+    a message in a project channel starts a coding session in that folder.
+
+    Help the user add channels for their projects:
+
+    1. Greet the user in one short sentence and ask if they want channels for their projects. Suggest
+       searching for git repositories on this computer.
+    2. If they agree, search. Only list folders that exist, most recently changed first, at most 15:
+       \`find ~/Documents ~/Projects ~/projects ~/code ~/dev ~/src ~/repos ~/GitHub ~/github -maxdepth 3 -name .git -prune 2>/dev/null\`
+       Skip folders that already have a channel: \`${kimaki} project list\`
+    3. Show the folders as a numbered list and ask the user to reply with the numbers to add.
+    4. Add each chosen folder with its absolute path: \`${kimaki} project add <absolute-directory>\`
+       The command prints the new channel as a mention like <#123>. Reply with the list of new channels.
+
+    Never add a channel the user did not choose. Keep every message short.
+  `;
+}
+// The shell command the agent runs to call this Kimaki install.
+// No --data-dir: agent shells get KIMAKI_DATA_DIR from the plugin, and not every command takes the flag.
+export function kimakiShellCommand({ command }) {
+    return command.map(shellQuote).join(' ');
+}
+class GitInitError extends errore.createTaggedError({
+    name: 'GitInitError',
+    message: 'Could not create $directory',
+}) {
+}
+async function createDefaultDirectory(directory) {
+    const created = errore.try(() => {
+        fs.mkdirSync(directory, { recursive: true });
+        const gitignore = path.join(directory, '.gitignore');
+        if (!fs.existsSync(gitignore))
+            fs.writeFileSync(gitignore, 'node_modules/\ntmp/\n*.log\n.DS_Store\n');
+    }, (e) => new GitInitError({ directory, cause: e }));
+    if (created instanceof Error)
+        return created;
+    if (fs.existsSync(path.join(directory, '.git')))
+        return;
+    // Without git the folder still works; only branch names in footers are missing.
+    const init = await execFileAsync('git', ['init', '-q'], { cwd: directory, timeout: 10_000 }).catch((e) => new GitInitError({ directory, cause: e }));
+    if (init instanceof Error)
+        logger.warn(`git init failed in ${directory}`, init);
+}
+export async function runOnboarding({ bot, dataDir, guild, guildId, installUrl, kimaki, gateway, installerId, machine, }) {
+    const { db } = bot;
+    const directory = defaultProjectDirectory({ dataDir });
+    const projects = await db.query.channel_directories
+        .findMany({ where: { channel_type: 'text' } })
+        .catch((e) => new DbError({ operation: 'read channel_directories', cause: e }));
+    if (projects instanceof Error)
+        return projects;
+    const mapped = projects.find((project) => project.directory === directory);
+    if (!mapped && projects.length > 0)
+        return null;
+    // Done once the default channel has a message (the welcome). An empty channel
+    // means an earlier onboarding failed: retry in it. A deleted one stays deleted.
+    if (mapped) {
+        const existing = await bot.discord.channels.fetch(mapped.channel_id).catch(() => null);
+        if (existing?.type !== ChannelType.GuildText)
+            return null;
+        const messages = await existing.messages
+            .fetch({ limit: 1 })
+            .catch((e) => new DiscordError({ operation: 'read default channel', cause: e }));
+        if (messages instanceof Error)
+            return messages;
+        if (messages.size > 0)
+            return null;
+    }
+    const selectedGuild = await (async () => {
+        if (guild)
+            return guild;
+        const saved = mapped?.guild_id ? bot.discord.guilds.cache.get(mapped.guild_id) : null;
+        if (saved)
+            return saved;
+        if (!installUrl)
+            return new ConfigError({ reason: 'No server configured for onboarding. Run kimaki --guild <id>.' });
+        return chooseGuild({ discord: bot.discord, guildId, installUrl, gateway });
+    })();
+    if (selectedGuild instanceof Error)
+        return selectedGuild;
+    const directoryReady = await createDefaultDirectory(directory);
+    if (directoryReady instanceof Error)
+        return directoryReady;
+    const botName = bot.discord.user?.username ?? 'kimaki';
+    const channel = await addProjectChannel({
+        api: new API(bot.discord.rest),
+        db,
+        guildId: selectedGuild.id,
+        directory,
+        name: defaultChannelName({ botName, gateway }),
+        topic: DEFAULT_CHANNEL_TOPIC,
+        machine,
+    });
+    if (channel instanceof Error)
+        return channel;
+    if (channel.created)
+        bot.analytics.track('project_registered', { project_kind: 'default', source: 'onboarding' });
+    const textChannel = await bot.discord.channels
+        .fetch(channel.channelId)
+        .catch((e) => new DiscordError({ operation: 'fetch default channel', cause: e }));
+    if (textChannel instanceof Error)
+        return textChannel;
+    if (textChannel?.type !== ChannelType.GuildText) {
+        return new DiscordError({ operation: `default channel ${channel.channelId} is not a text channel` });
+    }
+    const owner = await selectedGuild.members
+        .fetch(installerId ?? selectedGuild.ownerId)
+        .catch((e) => new DiscordError({ operation: 'fetch installer', cause: e }));
+    if (owner instanceof Error)
+        return owner;
+    const welcome = await textChannel
+        .send({
+        content: dedent `
+        **Kimaki** lets you code from Discord. Each project channel is linked to a folder on your computer. A message there starts an AI coding session in that folder.
+        Reply in the thread below to add channels for your projects. <@${owner.id}>
+      `,
+        allowedMentions: { users: [owner.id] },
+        flags: NOTIFY_MESSAGE_FLAGS,
+    })
+        .catch((e) => new DiscordError({ operation: 'send welcome message', cause: e }));
+    if (welcome instanceof Error)
+        return welcome;
+    const session = await startSession(bot, {
+        channelId: channel.channelId,
+        directory,
+        route: { kind: 'steer', text: onboardingPrompt({ kimaki }) },
+        author: { id: owner.id, username: owner.user.username },
+        messageId: welcome.id,
+        threadName: 'Kimaki onboarding',
+        worktree: false,
+    });
+    if (session instanceof Error) {
+        // Leaves the channel empty, so the next start onboards again.
+        await welcome.delete().catch((e) => logger.warn('delete welcome message', e));
+        return session;
+    }
+    logger.log(`onboarding thread ${session.threadId} in channel ${channel.channelId}`);
+    return { guildId: selectedGuild.id, channelId: channel.channelId, threadId: session.threadId };
+}
+//# sourceMappingURL=onboarding.js.map