kortext 2.2.3 → 3.0.0

package/dist/mcp/stdio.js

@@ -0,0 +1,44 @@
+/**
+ * Stdio entry — what `kortext mcp` spawns.
+ *
+ * Reads from stdin / writes JSON-RPC frames to stdout. CRITICAL: nothing
+ * besides MCP frames may go to stdout — every log line is routed to stderr.
+ * The CLI sets `console.log = console.error` defensively before this loads.
+ */
+import { resolve } from 'node:path';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { getDb } from "../server/db/client.js";
+import { loadWorkflowsFromDir } from "../server/engine/workflow-loader.js";
+import { loadPersonasFromDir } from "../server/engine/persona-registry.js";
+import { ApprovalQueue } from "../server/orchestrator/approval-queue.js";
+import { createKortextMcpServer } from "./server.js";
+export async function runStdioServer(opts = {}) {
+    const cwd = opts.cwd ?? process.cwd();
+    const log = (msg) => process.stderr.write(`[kortext-mcp] ${msg}\n`);
+    const { schemaVersion, repositories: repos } = getDb();
+    log(`db ready (schema v${schemaVersion})`);
+    const workflowsDir = resolve(cwd, 'workflows');
+    const agentsDir = resolve(cwd, 'agents');
+    const workflows = loadWorkflowsFromDir(workflowsDir);
+    const personas = loadPersonasFromDir(agentsDir);
+    log(`loaded ${workflows.list().length} workflow(s), ${personas.list().length} persona(s)`);
+    const queue = new ApprovalQueue({ repos });
+    const server = createKortextMcpServer({
+        repos,
+        workflows,
+        personas,
+        queue,
+        workspaceRoot: cwd,
+        workflowsDir,
+    });
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    log('mcp server connected on stdio');
+    const shutdown = (signal) => {
+        log(`received ${signal}, closing`);
+        void server.close().finally(() => process.exit(0));
+    };
+    process.on('SIGINT', () => shutdown('SIGINT'));
+    process.on('SIGTERM', () => shutdown('SIGTERM'));
+}
+//# sourceMappingURL=stdio.js.map

package/dist/mcp/stdio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio.js","sourceRoot":"","sources":["../../mcp/stdio.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAC3E,OAAO,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,MAAM,0CAA0C,CAAC;AACzE,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAErD,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAAyB,EAAE;IAC9D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACtC,MAAM,GAAG,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;IAE5E,MAAM,EAAE,aAAa,EAAE,YAAY,EAAE,KAAK,EAAE,GAAG,KAAK,EAAE,CAAC;IACvD,GAAG,CAAC,qBAAqB,aAAa,GAAG,CAAC,CAAC;IAE3C,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;IAC/C,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACzC,MAAM,SAAS,GAAG,oBAAoB,CAAC,YAAY,CAAC,CAAC;IACrD,MAAM,QAAQ,GAAG,mBAAmB,CAAC,SAAS,CAAC,CAAC;IAChD,GAAG,CACD,UAAU,SAAS,CAAC,IAAI,EAAE,CAAC,MAAM,iBAAiB,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,aAAa,CACtF,CAAC;IAEF,MAAM,KAAK,GAAG,IAAI,aAAa,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAG,sBAAsB,CAAC;QACpC,KAAK;QACL,SAAS;QACT,QAAQ;QACR,KAAK;QACL,aAAa,EAAE,GAAG;QAClB,YAAY;KACb,CAAC,CAAC;IAEH,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,GAAG,CAAC,+BAA+B,CAAC,CAAC;IAErC,MAAM,QAAQ,GAAG,CAAC,MAAc,EAAE,EAAE;QAClC,GAAG,CAAC,YAAY,MAAM,WAAW,CAAC,CAAC;QACnC,KAAK,MAAM,CAAC,KAAK,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IACrD,CAAC,CAAC;IACF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC/C,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;AACnD,CAAC"}

package/dist/server/cli/cleanup.js

@@ -0,0 +1,73 @@
+import * as cp from 'node:child_process';
+import { existsSync, readdirSync, rmSync, statSync } from 'node:fs';
+import { join } from 'node:path';
+const runFile = cp.execFileSync;
+const TERMINAL_RUN_STATUSES = new Set([
+    'succeeded',
+    'failed',
+    'cancelled',
+]);
+export async function cleanupQuarantine(opts) {
+    if (!existsSync(opts.quarantineRoot)) {
+        return { deleted: [], kept: [], dryRun: opts.dryRun };
+    }
+    const cutoffMs = Date.now() - opts.olderThanDays * 86400 * 1000;
+    const deleted = [];
+    const kept = [];
+    for (const entry of readdirSync(opts.quarantineRoot)) {
+        const full = join(opts.quarantineRoot, entry);
+        let mtimeMs;
+        try {
+            mtimeMs = statSync(full).mtimeMs;
+        }
+        catch {
+            continue;
+        }
+        if (mtimeMs < cutoffMs) {
+            deleted.push(full);
+            if (!opts.dryRun)
+                rmSync(full, { recursive: true, force: true });
+        }
+        else {
+            kept.push(full);
+        }
+    }
+    return { deleted, kept, dryRun: opts.dryRun };
+}
+const BRANCH_NAME_RE = /^kortext\/run-(\d+)$/;
+export async function cleanupBranches(opts) {
+    const listed = runFile('git', ['branch', '--list', 'kortext/run-*', '--format=%(refname:short)'], { cwd: opts.repoRoot, encoding: 'utf8' });
+    const branches = listed
+        .split('\n')
+        .map((s) => s.trim())
+        .filter((s) => s.length > 0);
+    const deleted = [];
+    const kept = [];
+    for (const branch of branches) {
+        const match = BRANCH_NAME_RE.exec(branch);
+        if (!match || !match[1]) {
+            kept.push(branch);
+            continue;
+        }
+        const runId = Number(match[1]);
+        const run = opts.repos.runs.getRun(runId);
+        if (!run || !TERMINAL_RUN_STATUSES.has(run.status)) {
+            kept.push(branch);
+            continue;
+        }
+        deleted.push(branch);
+        if (!opts.dryRun) {
+            try {
+                runFile('git', ['branch', '-D', branch], {
+                    cwd: opts.repoRoot,
+                    stdio: ['ignore', 'ignore', 'pipe'],
+                });
+            }
+            catch {
+                // Branch may have been deleted between listing and now — non-fatal.
+            }
+        }
+    }
+    return { deleted, kept, dryRun: opts.dryRun };
+}
+//# sourceMappingURL=cleanup.js.map

package/dist/server/cli/cleanup.js.map

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

package/dist/server/cli/commands.js

@@ -0,0 +1,73 @@
+import { isAbsolute, resolve } from 'node:path';
+import { loadWorkflowsFromDir } from "../engine/workflow-loader.js";
+import { loadPersonasFromDir } from "../engine/persona-registry.js";
+import { buildGraph } from "../engine/dag.js";
+import { runWorkflow } from "../engine/worker-pool.js";
+import { createExecutor } from "./executor-factory.js";
+export async function startCommand(input) {
+    const workflowsDir = isAbsolute(input.workflowsDir)
+        ? input.workflowsDir
+        : resolve(process.cwd(), input.workflowsDir);
+    const registry = loadWorkflowsFromDir(workflowsDir);
+    const def = registry.get(input.workflowId);
+    if (!def) {
+        const loadError = registry.errors().find((e) => e.file === `${input.workflowId}.md`);
+        if (loadError) {
+            return {
+                ok: false,
+                errorMessage: `workflow '${input.workflowId}' not loadable: ${loadError.reason}`,
+            };
+        }
+        return {
+            ok: false,
+            errorMessage: `workflow not found: ${input.workflowId} (in ${workflowsDir})`,
+        };
+    }
+    if (input.executor !== 'mock' && !input.executorBinary) {
+        return {
+            ok: false,
+            errorMessage: `executor '${input.executor}' requires --binary (or KORTEXT_${input.executor.toUpperCase()}_BIN env var)`,
+        };
+    }
+    const graph = buildGraph(def);
+    const agentsDir = input.agentsDir ?? resolve(process.cwd(), 'agents');
+    // Mock executor doesn't read personas — skip the disk scan when possible.
+    const personaRegistry = input.executor === 'mock' ? undefined : loadPersonasFromDir(agentsDir);
+    const executor = createExecutor(input.executor, {
+        binary: input.executorBinary ?? '',
+        agentsDir,
+        logsDir: input.logsDir ?? resolve(process.cwd(), '.kortext', 'logs'),
+        personaRegistry,
+    });
+    const result = await runWorkflow(graph, executor, input.repos, {
+        concurrency: input.concurrency ?? 3,
+        triggeredBy: 'cli',
+    });
+    return {
+        ok: true,
+        runId: result.run.id,
+        status: result.run.status,
+        failedStepKey: result.failedStepKey,
+    };
+}
+export async function approveCommand(input) {
+    const open = input.queue.findOpenForRun(input.runId);
+    if (!open) {
+        return { ok: false, errorMessage: `no open question for run ${input.runId}` };
+    }
+    try {
+        const answered = input.queue.answer(open.id, input.answer, input.answeredBy);
+        return { ok: true, questionId: open.id, answer: answered.answer ?? input.answer };
+    }
+    catch (err) {
+        return { ok: false, errorMessage: err instanceof Error ? err.message : String(err) };
+    }
+}
+export function statusCommand(input) {
+    const limit = input.limit ?? 10;
+    return {
+        recentRuns: input.repos.runs.listRuns({ limit }),
+        openQuestions: input.repos.pendingQuestions.listOpen(),
+    };
+}
+//# sourceMappingURL=commands.js.map

package/dist/server/cli/commands.js.map

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

package/dist/server/cli/doctor.js

@@ -0,0 +1,118 @@
+import { findUnknownPersonas } from "../engine/consistency.js";
+const DEFAULT_ALLOWED_MISSING = ['+prime'];
+export function runDoctor(opts) {
+    const allowedMissing = new Set(opts.allowedMissingPersonas ?? DEFAULT_ALLOWED_MISSING);
+    const now = (opts.now ?? (() => new Date()))().getTime();
+    const findings = [];
+    // ---- workflows ----
+    const wfErrors = opts.workflows.errors();
+    const wfList = opts.workflows.list();
+    if (wfErrors.length === 0) {
+        findings.push({
+            category: 'workflow',
+            severity: 'ok',
+            message: `${wfList.length} workflow(s) loaded`,
+        });
+    }
+    else {
+        for (const e of wfErrors) {
+            findings.push({
+                category: 'workflow',
+                severity: 'error',
+                message: `${e.file}: ${e.reason}`,
+                details: e,
+            });
+        }
+    }
+    // ---- personas ----
+    const personaErrors = opts.personas.errors();
+    const personaList = opts.personas.list();
+    if (personaErrors.length === 0) {
+        findings.push({
+            category: 'persona',
+            severity: 'ok',
+            message: `${personaList.length} persona(s) loaded`,
+        });
+    }
+    else {
+        for (const e of personaErrors) {
+            findings.push({
+                category: 'persona',
+                severity: 'error',
+                message: `${e.file}: ${e.reason}`,
+                details: e,
+            });
+        }
+    }
+    // ---- cross-references ----
+    const unknownRefs = findUnknownPersonas(opts.workflows, opts.personas).filter((f) => !allowedMissing.has(f.persona));
+    if (unknownRefs.length === 0) {
+        findings.push({
+            category: 'cross-ref',
+            severity: 'ok',
+            message: 'all persona handles resolve',
+        });
+    }
+    else {
+        for (const ref of unknownRefs) {
+            findings.push({
+                category: 'cross-ref',
+                severity: 'error',
+                message: `workflow '${ref.workflowId}' step ${ref.stepKey} references unknown persona ${ref.persona}`,
+                details: ref,
+            });
+        }
+    }
+    // ---- stale locks ----
+    const allLocks = opts.repos.locks.list();
+    const staleLocks = allLocks.filter((l) => l.expires_at !== null && l.expires_at < now);
+    if (staleLocks.length === 0) {
+        findings.push({ category: 'lock', severity: 'ok', message: 'no stale locks' });
+    }
+    else {
+        findings.push({
+            category: 'lock',
+            severity: 'warn',
+            message: `${staleLocks.length} stale lock(s): ${staleLocks.map((l) => l.resource).join(', ')}`,
+            details: staleLocks,
+        });
+    }
+    // ---- blocked items ----
+    const blockedCount = opts.repos.backlog.countByStatus('blocked');
+    if (blockedCount === 0) {
+        findings.push({ category: 'item', severity: 'ok', message: 'no blocked items' });
+    }
+    else {
+        findings.push({
+            category: 'item',
+            severity: 'warn',
+            message: `${blockedCount} blocked item(s)`,
+        });
+    }
+    const summary = {
+        workflowsLoaded: wfList.length,
+        workflowErrors: wfErrors.length,
+        personasLoaded: personaList.length,
+        personaErrors: personaErrors.length,
+        unknownPersonaRefs: unknownRefs.length,
+        staleLocks: staleLocks.length,
+        blockedItems: blockedCount,
+    };
+    return {
+        findings,
+        summary,
+        hasErrors: findings.some((f) => f.severity === 'error'),
+    };
+}
+/**
+ * Human-readable text format. Used by `bin/kortext.ts` doctor command.
+ */
+export function formatDoctorReport(report) {
+    const lines = [];
+    const icon = (s) => (s === 'ok' ? '✔' : s === 'warn' ? '⚠' : '✖');
+    for (const f of report.findings) {
+        lines.push(`${icon(f.severity)} [${f.category}] ${f.message}`);
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=doctor.js.map

package/dist/server/cli/doctor.js.map

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

package/dist/server/cli/executor-factory.js

@@ -0,0 +1,39 @@
+import { MockExecutor } from "../engine/executors/mock-executor.js";
+import { ClaudeCliExecutor } from "../engine/executors/claude-cli-executor.js";
+import { CodexCliExecutor } from "../engine/executors/codex-cli-executor.js";
+import { GeminiCliExecutor } from "../engine/executors/gemini-cli-executor.js";
+export function createExecutor(kind, opts) {
+    switch (kind) {
+        case 'mock':
+            return new MockExecutor();
+        case 'claude':
+            return new ClaudeCliExecutor({
+                binary: opts.binary,
+                agentsDir: opts.agentsDir,
+                logsDir: opts.logsDir,
+                extraArgs: opts.extraArgs,
+                personaRegistry: opts.personaRegistry,
+            });
+        case 'codex':
+            return new CodexCliExecutor({
+                binary: opts.binary,
+                agentsDir: opts.agentsDir,
+                logsDir: opts.logsDir,
+                extraArgs: opts.extraArgs,
+                personaRegistry: opts.personaRegistry,
+            });
+        case 'gemini':
+            return new GeminiCliExecutor({
+                binary: opts.binary,
+                agentsDir: opts.agentsDir,
+                logsDir: opts.logsDir,
+                extraArgs: opts.extraArgs,
+                personaRegistry: opts.personaRegistry,
+            });
+        default: {
+            const exhaustive = kind;
+            throw new Error(`unknown executor kind: ${String(exhaustive)}`);
+        }
+    }
+}
+//# sourceMappingURL=executor-factory.js.map

package/dist/server/cli/executor-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executor-factory.js","sourceRoot":"","sources":["../../../server/cli/executor-factory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,4CAA4C,CAAC;AAC/E,OAAO,EAAE,gBAAgB,EAAE,MAAM,2CAA2C,CAAC;AAC7E,OAAO,EAAE,iBAAiB,EAAE,MAAM,4CAA4C,CAAC;AA2B/E,MAAM,UAAU,cAAc,CAC5B,IAAkB,EAClB,IAA4B;IAE5B,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,MAAM;YACT,OAAO,IAAI,YAAY,EAAE,CAAC;QAC5B,KAAK,QAAQ;YACX,OAAO,IAAI,iBAAiB,CAAC;gBAC3B,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,eAAe,EAAE,IAAI,CAAC,eAAe;aACtC,CAAC,CAAC;QACL,KAAK,OAAO;YACV,OAAO,IAAI,gBAAgB,CAAC;gBAC1B,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,eAAe,EAAE,IAAI,CAAC,eAAe;aACtC,CAAC,CAAC;QACL,KAAK,QAAQ;YACX,OAAO,IAAI,iBAAiB,CAAC;gBAC3B,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,SAAS,EAAE,IAAI,CAAC,SAAS;gBACzB,eAAe,EAAE,IAAI,CAAC,eAAe;aACtC,CAAC,CAAC;QACL,OAAO,CAAC,CAAC,CAAC;YACR,MAAM,UAAU,GAAU,IAAI,CAAC;YAC/B,MAAM,IAAI,KAAK,CAAC,0BAA0B,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;QAClE,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/server/cli/init.js

@@ -0,0 +1,121 @@
+import { cpSync, existsSync, mkdirSync, readFileSync, writeFileSync, } from 'node:fs';
+import { dirname, join, relative, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { openDb } from "../db/client.js";
+const SCAFFOLD_DIRS = ['agents', 'workflows', 'rules', 'workspace'];
+const DEFAULT_AGENTS_MD = `# AGENTS.md
+
+> Kortext v3 — autonomous AI agent runtime. Run \`kortext serve\` to launch
+> the dashboard + backend, or \`kortext mcp\` to expose tools over MCP.
+
+## Quick start
+
+\`\`\`bash
+kortext serve     # backend + dashboard (default port 3200)
+kortext status    # recent runs + open approval questions
+kortext logs      # tail of the audit log
+kortext doctor    # workflow / persona / lock consistency scan
+\`\`\`
+
+## Where things live
+
+- \`agents/\` — persona definitions (one markdown file per role)
+- \`workflows/\` — pipeline definitions, executed via the worker pool
+- \`rules/\` — project-wide behavior, branching, commands, models, emergency
+- \`workspace/references/blueprint.md\` — product blueprint; approving it
+  triggers the analysis → planning → development pipeline chain
+- \`.kortext/runtime/kortext.db\` — SQLite state (runs, items, audit log)
+`;
+function packageRootFromHere() {
+    // Source path is `server/cli/init.ts` (root two levels up). Compiled path is
+    // `dist/server/cli/init.js` (root three levels up). Walking up until we find
+    // a package.json keeps both layouts working without special-casing — the same
+    // pattern bin/kortext.ts uses for version reporting.
+    const here = dirname(fileURLToPath(import.meta.url));
+    let cursor = here;
+    for (let i = 0; i < 6; i++) {
+        if (existsSync(join(cursor, 'package.json')))
+            return cursor;
+        const parent = resolve(cursor, '..');
+        if (parent === cursor)
+            break;
+        cursor = parent;
+    }
+    return resolve(here, '..', '..');
+}
+function copyTemplateDir(sourceRoot, targetRoot, relPath, force, created, skipped) {
+    const source = join(sourceRoot, relPath);
+    const target = join(targetRoot, relPath);
+    if (!existsSync(source)) {
+        // Templates dir lacks this entry — nothing to scaffold.
+        return;
+    }
+    if (existsSync(target) && !force) {
+        skipped.push(relPath);
+        return;
+    }
+    cpSync(source, target, { recursive: true, force });
+    created.push(relPath);
+}
+export function initCommand(input) {
+    const targetDir = resolve(input.targetDir);
+    const templatesDir = resolve(input.templatesDir ?? packageRootFromHere());
+    if (resolve(templatesDir) === targetDir && !input.force) {
+        return {
+            ok: false,
+            errorMessage: 'refusing to init into the templates directory itself (use --force to override)',
+        };
+    }
+    mkdirSync(targetDir, { recursive: true });
+    const created = [];
+    const skipped = [];
+    const force = input.force === true;
+    for (const rel of SCAFFOLD_DIRS) {
+        copyTemplateDir(templatesDir, targetDir, rel, force, created, skipped);
+    }
+    // AGENTS.md: prefer the template's copy when present, otherwise write a
+    // minimal default so `claude` / `codex` agents can discover the project.
+    const agentsMdPath = join(targetDir, 'AGENTS.md');
+    if (existsSync(agentsMdPath) && !force) {
+        skipped.push('AGENTS.md');
+    }
+    else {
+        const templateAgentsMd = join(templatesDir, 'AGENTS.md');
+        const content = existsSync(templateAgentsMd)
+            ? readFileSync(templateAgentsMd, 'utf8')
+            : DEFAULT_AGENTS_MD;
+        writeFileSync(agentsMdPath, content, 'utf8');
+        created.push('AGENTS.md');
+    }
+    // Runtime dir + DB (migrations run inside openDb).
+    const runtimeDir = join(targetDir, '.kortext', 'runtime');
+    mkdirSync(runtimeDir, { recursive: true });
+    const dbPath = join(runtimeDir, 'kortext.db');
+    const dbExisted = existsSync(dbPath);
+    let schemaVersion = 0;
+    try {
+        const bundle = openDb({ path: dbPath });
+        schemaVersion = bundle.schemaVersion;
+        bundle.db.close();
+    }
+    catch (err) {
+        return {
+            ok: false,
+            errorMessage: `db init failed: ${err instanceof Error ? err.message : String(err)}`,
+        };
+    }
+    if (dbExisted) {
+        skipped.push(relative(targetDir, dbPath));
+    }
+    else {
+        created.push(relative(targetDir, dbPath));
+    }
+    return {
+        ok: true,
+        created,
+        skipped,
+        dbPath,
+        schemaVersion,
+    };
+}
+//# sourceMappingURL=init.js.map

package/dist/server/cli/init.js.map

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

package/dist/server/cli/logs.js

@@ -0,0 +1,28 @@
+export function logsCommand(input) {
+    const limit = input.limit ?? 50;
+    const rows = input.repos.auditLog.list({
+        actor: input.actor ?? null,
+        action: input.action ?? null,
+        resource_type: input.resourceType ?? null,
+        resource_id: input.resourceId ?? null,
+        since: input.sinceMs ?? null,
+        limit,
+    });
+    return { rows };
+}
+export function formatLogsForCli(rows) {
+    if (rows.length === 0)
+        return '(no audit log entries)';
+    return rows
+        .map((row) => {
+        const ts = new Date(row.created_at).toISOString();
+        const resource = row.resource_type
+            ? ` ${row.resource_type}:${row.resource_id ?? '-'}`
+            : '';
+        const payloadKeys = Object.keys(row.payload ?? {});
+        const payload = payloadKeys.length > 0 ? ` {${payloadKeys.join(',')}}` : '';
+        return `[${row.id}] ${ts}  ${row.actor.padEnd(18)} ${row.action}${resource}${payload}`;
+    })
+        .join('\n');
+}
+//# sourceMappingURL=logs.js.map

package/dist/server/cli/logs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.js","sourceRoot":"","sources":["../../../server/cli/logs.ts"],"names":[],"mappings":"AAuBA,MAAM,UAAU,WAAW,CAAC,KAAuB;IACjD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC;IAChC,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC;QACrC,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,IAAI;QAC1B,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,IAAI;QAC5B,aAAa,EAAE,KAAK,CAAC,YAAY,IAAI,IAAI;QACzC,WAAW,EAAE,KAAK,CAAC,UAAU,IAAI,IAAI;QACrC,KAAK,EAAE,KAAK,CAAC,OAAO,IAAI,IAAI;QAC5B,KAAK;KACN,CAAC,CAAC;IACH,OAAO,EAAE,IAAI,EAAE,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAmB;IAClD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,wBAAwB,CAAC;IACvD,OAAO,IAAI;SACR,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QACX,MAAM,EAAE,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,WAAW,EAAE,CAAC;QAClD,MAAM,QAAQ,GAAG,GAAG,CAAC,aAAa;YAChC,CAAC,CAAC,IAAI,GAAG,CAAC,aAAa,IAAI,GAAG,CAAC,WAAW,IAAI,GAAG,EAAE;YACnD,CAAC,CAAC,EAAE,CAAC;QACP,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;QACnD,MAAM,OAAO,GAAG,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5E,OAAO,IAAI,GAAG,CAAC,EAAE,KAAK,EAAE,KAAK,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,GAAG,CAAC,MAAM,GAAG,QAAQ,GAAG,OAAO,EAAE,CAAC;IACzF,CAAC,CAAC;SACD,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC"}

package/dist/server/cli/serve.js

@@ -0,0 +1,72 @@
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+/**
+ * Resolve dev vs prod from package state when caller passes 'auto':
+ * - prod when both compiled server (`dist/server/index.js`) and built web
+ *   (`dist/web/index.html`) are present
+ * - dev otherwise (uses tsx + vite from devDependencies)
+ */
+export function buildServeCommands(input) {
+    const exists = input.existsImpl ?? existsSync;
+    const mode = resolveMode(input.packageRoot, input.mode ?? 'auto', exists);
+    const baseEnv = {};
+    if (input.port !== undefined) {
+        baseEnv.KORTEXT_PORT = String(input.port);
+    }
+    if (mode === 'prod') {
+        return {
+            mode,
+            commands: [
+                {
+                    name: 'server',
+                    command: process.execPath,
+                    args: [join(input.packageRoot, 'dist', 'server', 'index.js')],
+                    cwd: input.projectDir,
+                    env: baseEnv,
+                },
+                {
+                    name: 'web',
+                    command: 'npx',
+                    args: [
+                        'vite',
+                        'preview',
+                        '--host',
+                        '--port',
+                        String(input.port ? input.port + 1 : 5173),
+                    ],
+                    cwd: input.packageRoot,
+                    env: baseEnv,
+                },
+            ],
+        };
+    }
+    return {
+        mode,
+        commands: [
+            {
+                name: 'server',
+                command: 'npx',
+                args: ['tsx', join(input.packageRoot, 'server', 'index.ts')],
+                cwd: input.projectDir,
+                env: baseEnv,
+            },
+            {
+                name: 'web',
+                command: 'npx',
+                args: ['vite', '--host'],
+                cwd: input.packageRoot,
+                env: baseEnv,
+            },
+        ],
+    };
+}
+function resolveMode(packageRoot, requested, exists) {
+    if (requested === 'dev')
+        return 'dev';
+    if (requested === 'prod')
+        return 'prod';
+    const compiledServer = join(packageRoot, 'dist', 'server', 'index.js');
+    const builtWeb = join(packageRoot, 'dist', 'web', 'index.html');
+    return exists(compiledServer) && exists(builtWeb) ? 'prod' : 'dev';
+}
+//# sourceMappingURL=serve.js.map

package/dist/server/cli/serve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve.js","sourceRoot":"","sources":["../../../server/cli/serve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAqCjC;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAA8B;IAC/D,MAAM,MAAM,GAAG,KAAK,CAAC,UAAU,IAAI,UAAU,CAAC;IAC9C,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,IAAI,MAAM,EAAE,MAAM,CAAC,CAAC;IAE1E,MAAM,OAAO,GAA2B,EAAE,CAAC;IAC3C,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC7B,OAAO,CAAC,YAAY,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5C,CAAC;IAED,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;QACpB,OAAO;YACL,IAAI;YACJ,QAAQ,EAAE;gBACR;oBACE,IAAI,EAAE,QAAQ;oBACd,OAAO,EAAE,OAAO,CAAC,QAAQ;oBACzB,IAAI,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;oBAC7D,GAAG,EAAE,KAAK,CAAC,UAAU;oBACrB,GAAG,EAAE,OAAO;iBACb;gBACD;oBACE,IAAI,EAAE,KAAK;oBACX,OAAO,EAAE,KAAK;oBACd,IAAI,EAAE;wBACJ,MAAM;wBACN,SAAS;wBACT,QAAQ;wBACR,QAAQ;wBACR,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;qBAC3C;oBACD,GAAG,EAAE,KAAK,CAAC,WAAW;oBACtB,GAAG,EAAE,OAAO;iBACb;aACF;SACF,CAAC;IACJ,CAAC;IAED,OAAO;QACL,IAAI;QACJ,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,KAAK;gBACd,IAAI,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;gBAC5D,GAAG,EAAE,KAAK,CAAC,UAAU;gBACrB,GAAG,EAAE,OAAO;aACb;YACD;gBACE,IAAI,EAAE,KAAK;gBACX,OAAO,EAAE,KAAK;gBACd,IAAI,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC;gBACxB,GAAG,EAAE,KAAK,CAAC,WAAW;gBACtB,GAAG,EAAE,OAAO;aACb;SACF;KACF,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAClB,WAAmB,EACnB,SAAoB,EACpB,MAAiC;IAEjC,IAAI,SAAS,KAAK,KAAK;QAAE,OAAO,KAAK,CAAC;IACtC,IAAI,SAAS,KAAK,MAAM;QAAE,OAAO,MAAM,CAAC;IACxC,MAAM,cAAc,GAAG,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;IACvE,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC;IAChE,OAAO,MAAM,CAAC,cAAc,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC;AACrE,CAAC"}

package/dist/server/config/env.js

@@ -0,0 +1,12 @@
+import { z } from 'zod';
+const EnvSchema = z.object({
+    NODE_ENV: z.enum(['development', 'test', 'production']).default('development'),
+    KORTEXT_PORT: z.coerce.number().int().positive().default(3200),
+    KORTEXT_DB_PATH: z.string().default('.kortext/runtime/kortext.db'),
+    SLACK_WEBHOOK_URL: z.string().url().optional(),
+    SLACK_CHANNEL: z.string().optional(),
+    TELEGRAM_BOT_TOKEN: z.string().optional(),
+    TELEGRAM_CHAT_ID: z.string().optional(),
+});
+export const env = EnvSchema.parse(process.env);
+//# sourceMappingURL=env.js.map

package/dist/server/config/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../../server/config/env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC;IACzB,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,aAAa,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC;IAC9E,YAAY,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IAC9D,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,6BAA6B,CAAC;IAClE,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;IAC9C,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACpC,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACzC,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACxC,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,GAAG,GAAQ,SAAS,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC"}