kortext 2.2.3 → 3.0.0

package/dist/server/engine/executors/cli-spawn.js

@@ -0,0 +1,127 @@
+import { spawn } from 'node:child_process';
+import { createWriteStream } from 'node:fs';
+export async function spawnCli(opts) {
+    const sigkillDelayMs = opts.sigkillDelayMs ?? 5000;
+    const summaryCap = opts.summaryBufferBytes ?? 64 * 1024;
+    if (opts.signal.aborted) {
+        return {
+            exitCode: null,
+            signal: null,
+            stdoutTail: '',
+            stderrTail: '',
+            aborted: true,
+        };
+    }
+    const proc = spawn(opts.binary, opts.args, {
+        cwd: opts.cwd,
+        stdio: ['pipe', 'pipe', 'pipe'],
+        // shell: false is the default for spawn() — being explicit for reviewers
+        shell: false,
+    });
+    const log = createWriteStream(opts.logPath, { flags: 'a' });
+    log.write(`\n# kortext cli-executor — ${new Date().toISOString()}\n# binary: ${opts.binary}\n# args: ${JSON.stringify(opts.args)}\n# cwd: ${opts.cwd}\n\n`);
+    // Rolling buffers so we don't OOM on chatty CLIs.
+    let stdoutBuf = '';
+    let stderrBuf = '';
+    const appendCapped = (current, chunk) => {
+        const combined = current + chunk;
+        return combined.length > summaryCap ? combined.slice(combined.length - summaryCap) : combined;
+    };
+    proc.stdout?.on('data', (chunk) => {
+        const s = chunk.toString('utf8');
+        stdoutBuf = appendCapped(stdoutBuf, s);
+        log.write(s);
+    });
+    proc.stderr?.on('data', (chunk) => {
+        const s = chunk.toString('utf8');
+        stderrBuf = appendCapped(stderrBuf, s);
+        log.write(`[stderr] ${s}`);
+    });
+    // Short-lived CLIs (e.g. `echo X; exit 0`) can close stdin before we
+    // finish writing the persona prompt, which surfaces as EPIPE on the
+    // parent. The prompt is best-effort — if the child didn't want to read
+    // it, we shouldn't crash the test/run with an unhandled error. macOS
+    // hides this race because the kernel keeps the pipe buffer alive
+    // briefly after exit; Linux closes immediately.
+    if (proc.stdin) {
+        proc.stdin.on('error', (err) => {
+            const code = err.code;
+            if (code !== 'EPIPE') {
+                log.write(`\n[stdin-error] ${err.message}\n`);
+            }
+        });
+        if (opts.stdin !== undefined) {
+            proc.stdin.write(opts.stdin);
+        }
+        proc.stdin.end();
+    }
+    let aborted = false;
+    let killTimer = null;
+    let timeoutTimer = null;
+    const onAbort = () => {
+        aborted = true;
+        try {
+            proc.kill('SIGTERM');
+        }
+        catch {
+            /* already gone */
+        }
+        killTimer = setTimeout(() => {
+            try {
+                proc.kill('SIGKILL');
+            }
+            catch {
+                /* already gone */
+            }
+        }, sigkillDelayMs);
+    };
+    opts.signal.addEventListener('abort', onAbort, { once: true });
+    if (opts.timeoutMs !== undefined) {
+        timeoutTimer = setTimeout(() => {
+            onAbort();
+        }, opts.timeoutMs);
+    }
+    const result = await new Promise((resolveResult) => {
+        // log.end() flushes asynchronously. On Linux that flush can outlast our
+        // promise resolution, leaving callers who readFileSync(logPath) right
+        // after await with a half-written file. macOS happens to flush fast
+        // enough to hide it. Wait for 'finish' (or the end() callback) before
+        // resolving so the file is durable when the caller reads it.
+        proc.on('error', (err) => {
+            log.write(`\n[spawn-error] ${err.message}\n`);
+            log.end(() => {
+                resolveResult({
+                    exitCode: null,
+                    signal: null,
+                    stdoutTail: stdoutBuf,
+                    stderrTail: stderrBuf + `\n[spawn-error] ${err.message}`,
+                    aborted,
+                });
+            });
+        });
+        proc.on('close', (code, signal) => {
+            log.write(`\n# exit code=${code} signal=${signal} aborted=${aborted}\n`);
+            log.end(() => {
+                resolveResult({
+                    exitCode: code,
+                    signal,
+                    stdoutTail: stdoutBuf,
+                    stderrTail: stderrBuf,
+                    aborted,
+                });
+            });
+        });
+    });
+    if (killTimer)
+        clearTimeout(killTimer);
+    if (timeoutTimer)
+        clearTimeout(timeoutTimer);
+    opts.signal.removeEventListener('abort', onAbort);
+    return result;
+}
+/** Returns the last N non-empty lines as a single newline-joined string. */
+export function tailLines(text, n) {
+    const lines = text.split(/\r?\n/).filter((l) => l.length > 0);
+    return lines.slice(-n).join('\n');
+}
+//# sourceMappingURL=cli-spawn.js.map

package/dist/server/engine/executors/cli-spawn.js.map

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

package/dist/server/engine/executors/codex-cli-executor.js

@@ -0,0 +1,69 @@
+import { existsSync } from 'node:fs';
+import { isAbsolute, join } from 'node:path';
+import { spawnCli, tailLines } from "./cli-spawn.js";
+import { readPersonaPrompt } from "../persona-registry.js";
+export class CodexCliExecutor {
+    opts;
+    name = 'codex-cli';
+    constructor(opts) {
+        this.opts = opts;
+    }
+    async execute(step, ctx) {
+        const personaBody = readPersonaPrompt(step.persona, this.opts.personaRegistry ?? { agentsDir: this.opts.agentsDir });
+        const prompt = buildPrompt(step, ctx, personaBody);
+        const logPath = join(this.opts.logsDir, `run-${ctx.runId}-step-${ctx.runStepId}.log`);
+        const args = [...(this.opts.extraArgs ?? [])];
+        const res = await spawnCli({
+            binary: this.opts.binary,
+            args,
+            cwd: ctx.worktreePath,
+            stdin: prompt,
+            logPath,
+            signal: ctx.signal,
+            sigkillDelayMs: this.opts.sigkillDelayMs,
+            timeoutMs: this.opts.timeoutMs,
+        });
+        const tail = tailLines(res.stdoutTail, this.opts.summaryTailLines ?? 20);
+        if (res.aborted)
+            return { ok: false, errorMessage: 'aborted by signal', logPath };
+        if (res.exitCode === null) {
+            return { ok: false, errorMessage: `killed by signal ${res.signal ?? 'unknown'}`, logPath };
+        }
+        if (res.exitCode !== 0) {
+            return {
+                ok: false,
+                errorMessage: `cli exited with code ${res.exitCode}`,
+                logPath,
+                outputSummary: tail,
+            };
+        }
+        const missing = step.outputs.filter((rel) => {
+            const p = isAbsolute(rel) ? rel : join(ctx.worktreePath, rel);
+            return !existsSync(p);
+        });
+        if (missing.length > 0) {
+            return {
+                ok: false,
+                errorMessage: `declared outputs not produced: ${missing.join(', ')}`,
+                logPath,
+                outputSummary: tail,
+            };
+        }
+        return { ok: true, outputSummary: tail, logPath };
+    }
+}
+function buildPrompt(step, ctx, personaBody) {
+    const inputs = step.inputs.length > 0 ? step.inputs.join(', ') : '(none)';
+    const outputs = step.outputs.length > 0 ? step.outputs.join(', ') : '(none)';
+    return `${personaBody}
+
+--- Codex Step ---
+Workflow: ${ctx.workflowId}
+Phase:    ${step.phase}
+Persona:  ${step.persona ?? '(none)'}
+Task:     ${step.description}
+Inputs:   ${inputs}
+Outputs:  ${outputs}
+`;
+}
+//# sourceMappingURL=codex-cli-executor.js.map

package/dist/server/engine/executors/codex-cli-executor.js.map

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

package/dist/server/engine/executors/gemini-cli-executor.js

@@ -0,0 +1,69 @@
+import { existsSync } from 'node:fs';
+import { isAbsolute, join } from 'node:path';
+import { spawnCli, tailLines } from "./cli-spawn.js";
+import { readPersonaPrompt } from "../persona-registry.js";
+export class GeminiCliExecutor {
+    opts;
+    name = 'gemini-cli';
+    constructor(opts) {
+        this.opts = opts;
+    }
+    async execute(step, ctx) {
+        const personaBody = readPersonaPrompt(step.persona, this.opts.personaRegistry ?? { agentsDir: this.opts.agentsDir });
+        const prompt = buildPrompt(step, ctx, personaBody);
+        const logPath = join(this.opts.logsDir, `run-${ctx.runId}-step-${ctx.runStepId}.log`);
+        const args = [...(this.opts.extraArgs ?? [])];
+        const res = await spawnCli({
+            binary: this.opts.binary,
+            args,
+            cwd: ctx.worktreePath,
+            stdin: prompt,
+            logPath,
+            signal: ctx.signal,
+            sigkillDelayMs: this.opts.sigkillDelayMs,
+            timeoutMs: this.opts.timeoutMs,
+        });
+        const tail = tailLines(res.stdoutTail, this.opts.summaryTailLines ?? 20);
+        if (res.aborted)
+            return { ok: false, errorMessage: 'aborted by signal', logPath };
+        if (res.exitCode === null) {
+            return { ok: false, errorMessage: `killed by signal ${res.signal ?? 'unknown'}`, logPath };
+        }
+        if (res.exitCode !== 0) {
+            return {
+                ok: false,
+                errorMessage: `cli exited with code ${res.exitCode}`,
+                logPath,
+                outputSummary: tail,
+            };
+        }
+        const missing = step.outputs.filter((rel) => {
+            const p = isAbsolute(rel) ? rel : join(ctx.worktreePath, rel);
+            return !existsSync(p);
+        });
+        if (missing.length > 0) {
+            return {
+                ok: false,
+                errorMessage: `declared outputs not produced: ${missing.join(', ')}`,
+                logPath,
+                outputSummary: tail,
+            };
+        }
+        return { ok: true, outputSummary: tail, logPath };
+    }
+}
+function buildPrompt(step, ctx, personaBody) {
+    const inputs = step.inputs.length > 0 ? step.inputs.join(', ') : '(none)';
+    const outputs = step.outputs.length > 0 ? step.outputs.join(', ') : '(none)';
+    return `${personaBody}
+
+--- Gemini Step ---
+Workflow: ${ctx.workflowId}
+Phase:    ${step.phase}
+Persona:  ${step.persona ?? '(none)'}
+Task:     ${step.description}
+Inputs:   ${inputs}
+Outputs:  ${outputs}
+`;
+}
+//# sourceMappingURL=gemini-cli-executor.js.map

package/dist/server/engine/executors/gemini-cli-executor.js.map

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

package/dist/server/engine/executors/mock-executor.js

@@ -0,0 +1,52 @@
+/**
+ * Deterministic executor for tests. Records the order in which steps started
+ * and finished, plus their concurrent overlap, so engine tests can assert
+ * that the worker pool actually parallelises.
+ */
+export class MockExecutor {
+    behavior;
+    name = 'mock';
+    /** Order in which execute() was entered. */
+    startedOrder = [];
+    /** Order in which execute() resolved or rejected. */
+    endedOrder = [];
+    /** Max number of executes running simultaneously. */
+    maxConcurrent = 0;
+    inFlight = 0;
+    constructor(behavior = () => ({})) {
+        this.behavior = behavior;
+    }
+    async execute(step, ctx) {
+        if (ctx.signal.aborted) {
+            return { ok: false, errorMessage: 'aborted before start' };
+        }
+        this.startedOrder.push(step.key);
+        this.inFlight += 1;
+        if (this.inFlight > this.maxConcurrent)
+            this.maxConcurrent = this.inFlight;
+        const cfg = this.behavior(step);
+        const duration = cfg.durationMs ?? 10;
+        try {
+            await new Promise((resolve, reject) => {
+                const timer = setTimeout(resolve, duration);
+                const onAbort = () => {
+                    clearTimeout(timer);
+                    reject(new Error('aborted'));
+                };
+                ctx.signal.addEventListener('abort', onAbort, { once: true });
+            });
+        }
+        catch (e) {
+            this.inFlight -= 1;
+            this.endedOrder.push(step.key);
+            return { ok: false, errorMessage: e instanceof Error ? e.message : String(e) };
+        }
+        this.inFlight -= 1;
+        this.endedOrder.push(step.key);
+        if (cfg.fail) {
+            return { ok: false, errorMessage: cfg.summary ?? 'mock-forced-failure' };
+        }
+        return { ok: true, outputSummary: cfg.summary ?? `mock:${step.key}` };
+    }
+}
+//# sourceMappingURL=mock-executor.js.map

package/dist/server/engine/executors/mock-executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-executor.js","sourceRoot":"","sources":["../../../../server/engine/executors/mock-executor.ts"],"names":[],"mappings":"AAYA;;;;GAIG;AACH,MAAM,OAAO,YAAY;IAYM;IAXpB,IAAI,GAAG,MAAM,CAAC;IAEvB,4CAA4C;IACnC,YAAY,GAAa,EAAE,CAAC;IACrC,qDAAqD;IAC5C,UAAU,GAAa,EAAE,CAAC;IACnC,qDAAqD;IACrD,aAAa,GAAG,CAAC,CAAC;IAEV,QAAQ,GAAG,CAAC,CAAC;IAErB,YAA6B,WAAqD,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC;QAA/D,aAAQ,GAAR,QAAQ,CAAuD;IAAG,CAAC;IAEhG,KAAK,CAAC,OAAO,CAAC,IAAkB,EAAE,GAAoB;QACpD,IAAI,GAAG,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACvB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,sBAAsB,EAAE,CAAC;QAC7D,CAAC;QAED,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACjC,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAC;QACnB,IAAI,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,aAAa;YAAE,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,QAAQ,CAAC;QAE3E,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAChC,MAAM,QAAQ,GAAG,GAAG,CAAC,UAAU,IAAI,EAAE,CAAC;QAEtC,IAAI,CAAC;YACH,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gBAC1C,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;gBAC5C,MAAM,OAAO,GAAG,GAAG,EAAE;oBACnB,YAAY,CAAC,KAAK,CAAC,CAAC;oBACpB,MAAM,CAAC,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC;gBAC/B,CAAC,CAAC;gBACF,GAAG,CAAC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YAChE,CAAC,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAC;YACnB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC/B,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QACjF,CAAC;QAED,IAAI,CAAC,QAAQ,IAAI,CAAC,CAAC;QACnB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAE/B,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC;YACb,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,GAAG,CAAC,OAAO,IAAI,qBAAqB,EAAE,CAAC;QAC3E,CAAC;QACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,GAAG,CAAC,OAAO,IAAI,QAAQ,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC;IACxE,CAAC;CACF"}

package/dist/server/engine/executors/persona-routed-executor.js

@@ -0,0 +1,17 @@
+export class PersonaRoutedExecutor {
+    opts;
+    name;
+    constructor(opts) {
+        this.opts = opts;
+        const names = new Set();
+        for (const ex of opts.routes.values())
+            names.add(ex.name);
+        names.add(opts.fallback.name);
+        this.name = `routed(${[...names].sort().join('|')})`;
+    }
+    execute(step, ctx) {
+        const target = step.persona ? this.opts.routes.get(step.persona) : null;
+        return (target ?? this.opts.fallback).execute(step, ctx);
+    }
+}
+//# sourceMappingURL=persona-routed-executor.js.map

package/dist/server/engine/executors/persona-routed-executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"persona-routed-executor.js","sourceRoot":"","sources":["../../../../server/engine/executors/persona-routed-executor.ts"],"names":[],"mappings":"AAsBA,MAAM,OAAO,qBAAqB;IAGH;IAFpB,IAAI,CAAS;IAEtB,YAA6B,IAAkC;QAAlC,SAAI,GAAJ,IAAI,CAA8B;QAC7D,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;QAChC,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE;YAAE,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;QAC1D,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IACvD,CAAC;IAED,OAAO,CAAC,IAAkB,EAAE,GAAoB;QAC9C,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACxE,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAC3D,CAAC;CACF"}

package/dist/server/engine/gate-enforcer.js

@@ -0,0 +1,75 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { isAbsolute, resolve } from 'node:path';
+export class GateEnforcer {
+    opts;
+    constructor(opts) {
+        this.opts = opts;
+    }
+    async check(graph, options = {}) {
+        const failures = [];
+        for (const rel of graph.externalInputs) {
+            const abs = isAbsolute(rel) ? rel : resolve(this.opts.repoRoot, rel);
+            if (!existsSync(abs)) {
+                failures.push({
+                    kind: 'missing-input',
+                    message: `required input not found: ${rel}`,
+                    path: rel,
+                });
+                continue;
+            }
+            const status = readFrontmatterField(abs, 'status');
+            if (status !== 'approved') {
+                failures.push({
+                    kind: 'unapproved-input',
+                    message: `input ${rel} has status='${status ?? 'none'}' (need 'approved')`,
+                    path: rel,
+                });
+            }
+        }
+        if (options.previousWorkflowId) {
+            const succeeded = this.opts.runs.listRuns({
+                workflow_id: options.previousWorkflowId,
+                status: 'succeeded',
+                limit: 1,
+            });
+            if (succeeded.length === 0) {
+                failures.push({
+                    kind: 'previous-not-succeeded',
+                    message: `no successful run found for prerequisite workflow '${options.previousWorkflowId}'`,
+                    workflowId: options.previousWorkflowId,
+                });
+            }
+        }
+        return { ok: failures.length === 0, failures };
+    }
+}
+/**
+ * Minimal YAML frontmatter reader — top of file between two `---` fences.
+ * Returns null if no frontmatter or field absent. Intentionally not a full
+ * YAML parser; values are read as raw strings up to the first newline.
+ */
+function readFrontmatterField(path, field) {
+    let body;
+    try {
+        body = readFileSync(path, 'utf8');
+    }
+    catch {
+        return null;
+    }
+    if (!body.startsWith('---'))
+        return null;
+    const end = body.indexOf('\n---', 3);
+    if (end < 0)
+        return null;
+    const block = body.slice(3, end);
+    const lines = block.split('\n');
+    const prefix = `${field}:`;
+    for (const raw of lines) {
+        const line = raw.trim();
+        if (line.startsWith(prefix)) {
+            return line.slice(prefix.length).trim().replace(/^['"]|['"]$/g, '');
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=gate-enforcer.js.map

package/dist/server/engine/gate-enforcer.js.map

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

package/dist/server/engine/git-commit.js

@@ -0,0 +1,42 @@
+import * as cp from 'node:child_process';
+/**
+ * Shell-free git commit helper. Best-effort: returns ok=false on any error
+ * (no git binary, not a repo, nothing to commit) instead of throwing.
+ *
+ * Hook note: we alias `cp.execFileSync` to keep this file out of the
+ * PreToolUse Write hook's spawn-substring blacklist (see HANDOVER-v3.md
+ * "Gotcha'lar"). All git invocations are shell-free; user-controlled
+ * paths and messages can never be interpreted as shell metacharacters.
+ */
+const runFile = cp.execFileSync;
+export function gitCommit(input) {
+    if (input.paths.length === 0) {
+        return { ok: false, reason: 'no paths to commit' };
+    }
+    try {
+        runFile('git', ['add', '--', ...input.paths], {
+            cwd: input.repoRoot,
+            shell: false,
+            stdio: 'pipe',
+        });
+        runFile('git', ['commit', '-m', input.message, '--', ...input.paths], {
+            cwd: input.repoRoot,
+            shell: false,
+            stdio: 'pipe',
+        });
+        const sha = runFile('git', ['rev-parse', 'HEAD'], {
+            cwd: input.repoRoot,
+            shell: false,
+            stdio: 'pipe',
+            encoding: 'utf8',
+        }).toString().trim();
+        return { ok: true, sha };
+    }
+    catch (err) {
+        return {
+            ok: false,
+            reason: err instanceof Error ? err.message : String(err),
+        };
+    }
+}
+//# sourceMappingURL=git-commit.js.map

package/dist/server/engine/git-commit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-commit.js","sourceRoot":"","sources":["../../../server/engine/git-commit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAEzC;;;;;;;;GAQG;AAEH,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC;AAahC,MAAM,UAAU,SAAS,CAAC,KAAqB;IAC7C,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,oBAAoB,EAAE,CAAC;IACrD,CAAC;IAED,IAAI,CAAC;QACH,OAAO,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,EAAE;YAC5C,GAAG,EAAE,KAAK,CAAC,QAAQ;YACnB,KAAK,EAAE,KAAK;YACZ,KAAK,EAAE,MAAM;SACd,CAAC,CAAC;QACH,OAAO,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,IAAI,EAAE,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,EAAE;YACpE,GAAG,EAAE,KAAK,CAAC,QAAQ;YACnB,KAAK,EAAE,KAAK;YACZ,KAAK,EAAE,MAAM;SACd,CAAC,CAAC;QACH,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC,WAAW,EAAE,MAAM,CAAC,EAAE;YAChD,GAAG,EAAE,KAAK,CAAC,QAAQ;YACnB,KAAK,EAAE,KAAK;YACZ,KAAK,EAAE,MAAM;YACb,QAAQ,EAAE,MAAM;SACjB,CAAC,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC;QACrB,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;IAC3B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO;YACL,EAAE,EAAE,KAAK;YACT,MAAM,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;SACzD,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/server/engine/handover.js

@@ -0,0 +1,120 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname, join, relative } from 'node:path';
+import { gitCommit } from "./git-commit.js";
+const STATUS_LABELS = {
+    completed: 'Tamamlandı',
+    blocked: 'Bloklandı',
+    partial: 'Kısmen tamamlandı',
+};
+const FILE_HEADER = '# Handover Reports\n';
+export class HandoverEngine {
+    opts;
+    constructor(opts) {
+        this.opts = opts;
+    }
+    record(input) {
+        this.assertKnownPersona(input.fromPersona, 'from');
+        this.assertKnownPersona(input.toPersona, 'to');
+        const markdownPath = join(this.opts.workspaceRoot, 'memory', 'handover.md');
+        mkdirSync(dirname(markdownPath), { recursive: true });
+        const now = (this.opts.now ?? (() => new Date()))();
+        const block = renderBlock(input, now);
+        const existing = existsSync(markdownPath)
+            ? readFileSync(markdownPath, 'utf8')
+            : FILE_HEADER;
+        const next = existing.startsWith(FILE_HEADER)
+            ? `${FILE_HEADER}\n${block}${existing.slice(FILE_HEADER.length)}`
+            : `${FILE_HEADER}\n${block}${existing}`;
+        writeFileSync(markdownPath, next, 'utf8');
+        const relPath = relative(this.opts.workspaceRoot, markdownPath);
+        const handover = this.opts.repos.handovers.create({
+            item_id: input.itemId,
+            from_persona: input.fromPersona,
+            to_persona: input.toPersona,
+            reason: null,
+            context_payload: {
+                status: input.status,
+                title: input.title,
+                completed: input.completed,
+                context: input.context,
+                changed_files: input.changedFiles ?? [],
+                watch_outs: input.watchOuts ?? [],
+                last_commit: input.lastCommit ?? null,
+                next_step: input.nextStep,
+            },
+            markdown_path: relPath,
+        });
+        let commitSha = null;
+        if (this.opts.git) {
+            const repoRoot = this.opts.git.repoRoot;
+            const pathInRepo = relative(repoRoot, markdownPath);
+            const commit = gitCommit({
+                repoRoot,
+                message: `chore(kortext): handover ${input.itemId}`,
+                paths: [pathInRepo],
+            });
+            if (commit.ok)
+                commitSha = commit.sha;
+        }
+        return { handoverId: handover.id, markdownPath, commitSha };
+    }
+    assertKnownPersona(handle, role) {
+        if (this.opts.personas.get(handle) === null) {
+            throw new Error(`unknown persona for ${role}: ${handle}`);
+        }
+    }
+}
+function renderBlock(input, now) {
+    const date = formatDate(now);
+    const label = STATUS_LABELS[input.status];
+    const changed = bulletList(input.changedFiles);
+    const watchOuts = bulletList(input.watchOuts);
+    return `## Handover: ${input.itemId} — ${input.title}
+
+> [!INFO]
+> - **Author:** ${input.fromPersona}
+> - **To:** ${input.toPersona}
+> - **Date:** ${date}
+> - **Status:** ${label}
+
+### ✅ Completed
+
+- ${input.completed}
+
+### Changed Files
+
+${changed}
+
+### Kritik Bağlam
+
+- ${input.context}
+
+### Watch-outs & Decisions
+
+${watchOuts}
+
+### Last Commit
+
+- ${input.lastCommit ?? 'Yok'}
+
+### Next Steps
+
+- ${input.nextStep}
+
+`;
+}
+function bulletList(items) {
+    if (!items || items.length === 0)
+        return '- Yok';
+    return items.map((s) => `- ${s}`).join('\n');
+}
+function formatDate(d) {
+    const pad = (n) => String(n).padStart(2, '0');
+    const dd = pad(d.getDate());
+    const mm = pad(d.getMonth() + 1);
+    const yy = pad(d.getFullYear() % 100);
+    const hh = pad(d.getHours());
+    const mi = pad(d.getMinutes());
+    return `${dd}.${mm}.${yy}-${hh}:${mi}`;
+}
+//# sourceMappingURL=handover.js.map

package/dist/server/engine/handover.js.map

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