@keel_flow/cli 0.2.0

package/dist/learn.js

@@ -0,0 +1,274 @@
+import { promises as fs } from "node:fs";
+import { resolve } from "node:path";
+import pc from "picocolors";
+import { applyAccepted, loadByStatus, loadPending, loadEmerging, markStatus, proposalToDiff, } from "@keel_flow/learn";
+import { createCliEmitter } from "./telemetry-helper.js";
+import { resolveProviderConfig } from "./orchestrate.js";
+async function defaultProviders() {
+    const mod = await import("@inquirer/prompts");
+    return {
+        select: (opts) => mod.select(opts),
+    };
+}
+function severityBadge(s) {
+    if (s === "high")
+        return pc.red(`[${s}]`);
+    if (s === "medium")
+        return pc.yellow(`[${s}]`);
+    return pc.dim(`[${s}]`);
+}
+function printRecordHeader(rec, idx, total) {
+    process.stdout.write(`\n${pc.bold(`Proposal ${idx + 1} of ${total}`)} ` +
+        `${pc.cyan(rec.proposal.id.slice(0, 12))} ` +
+        `${severityBadge(rec.proposal.severity)} ` +
+        `${pc.dim(`target=${rec.proposal.target}`)}\n` +
+        `  ${pc.bold(rec.suggestion.title)}\n` +
+        `  ${pc.dim("rationale:")} ${rec.suggestion.rationale}\n` +
+        `  ${pc.dim("change:")}    ${rec.suggestion.change}\n` +
+        `  ${pc.dim("from:")}      ${rec.reflectionPath}\n`);
+}
+export async function runLearn(opts, overrides = {}) {
+    const cwd = resolve(opts.cwd);
+    const pending = await loadPending({ cwd });
+    if (pending.length === 0) {
+        process.stdout.write(pc.dim("(no pending proposals)\n"));
+        return;
+    }
+    const providers = overrides.providers ?? (await defaultProviders());
+    const providerKindRaw = (opts.provider ?? process.env["KEEL_PROVIDER_KIND"] ?? "anthropic");
+    if (providerKindRaw !== "anthropic" && providerKindRaw !== "openai-compatible" && providerKindRaw !== "claude-bridge") {
+        throw new Error(`Unknown --provider kind: ${providerKindRaw}`);
+    }
+    const resolved = await resolveProviderConfig({
+        providerKind: providerKindRaw,
+        ...(opts.model ? { model: opts.model } : {}),
+    });
+    const { emitter, sessionId } = createCliEmitter({ command: "learn", cwd });
+    emitter?.emit({
+        sessionId,
+        parentEventId: null,
+        workspaceId: null,
+        triggeredBy: { kind: "user" },
+        kind: "session.start",
+        payload: { command: "learn", pendingCount: pending.length },
+    });
+    try {
+        for (let i = 0; i < pending.length; i += 1) {
+            const rec = pending[i];
+            emitter?.emit({
+                sessionId,
+                parentEventId: null,
+                workspaceId: null,
+                triggeredBy: { kind: "user" },
+                kind: "learn.proposal-loaded",
+                payload: { proposalId: rec.proposal.id, target: rec.proposal.target },
+            });
+            printRecordHeader(rec, i, pending.length);
+            let cachedDiff = null;
+            let next = "next";
+            while (true) {
+                const choice = await providers.select({
+                    message: "Action?",
+                    choices: [
+                        { name: "accept (generate diff, branch, verify)", value: "accept" },
+                        { name: "reject", value: "reject" },
+                        { name: "defer", value: "defer" },
+                        { name: "view full diff", value: "view" },
+                        { name: "skip (leave pending)", value: "skip" },
+                        { name: "quit", value: "quit" },
+                    ],
+                });
+                if (choice === "quit") {
+                    next = "stop";
+                    break;
+                }
+                if (choice === "skip") {
+                    break;
+                }
+                if (choice === "view") {
+                    const diff = cachedDiff ??
+                        (await (overrides.diffFn ?? proposalToDiff)({
+                            proposal: rec.proposal,
+                            suggestion: rec.suggestion,
+                            cwd,
+                            provider: resolved.provider,
+                            ...(opts.model ? { model: opts.model } : {}),
+                        }));
+                    cachedDiff = diff;
+                    process.stdout.write(`\n${pc.bold("--- proposed diff ---")}\n${diff.diff}\n${pc.bold("---")}\n\n`);
+                    continue;
+                }
+                if (choice === "reject") {
+                    await markStatus(rec.proposal.id, "rejected", cwd);
+                    emitter?.emit({
+                        sessionId,
+                        parentEventId: null,
+                        workspaceId: null,
+                        triggeredBy: { kind: "user" },
+                        kind: "learn.proposal-rejected",
+                        payload: { proposalId: rec.proposal.id },
+                    });
+                    process.stdout.write(pc.dim("(rejected)\n"));
+                    break;
+                }
+                if (choice === "defer") {
+                    await markStatus(rec.proposal.id, "deferred", cwd);
+                    emitter?.emit({
+                        sessionId,
+                        parentEventId: null,
+                        workspaceId: null,
+                        triggeredBy: { kind: "user" },
+                        kind: "learn.proposal-deferred",
+                        payload: { proposalId: rec.proposal.id },
+                    });
+                    process.stdout.write(pc.dim("(deferred)\n"));
+                    break;
+                }
+                if (choice === "accept") {
+                    const diff = cachedDiff ??
+                        (await (overrides.diffFn ?? proposalToDiff)({
+                            proposal: rec.proposal,
+                            suggestion: rec.suggestion,
+                            cwd,
+                            provider: resolved.provider,
+                            ...(opts.model ? { model: opts.model } : {}),
+                        }));
+                    cachedDiff = diff;
+                    const result = await (overrides.applyFn ?? applyAccepted)({
+                        proposal: rec.proposal,
+                        diff: diff.diff,
+                        cwd,
+                    });
+                    emitter?.emit({
+                        sessionId,
+                        parentEventId: null,
+                        workspaceId: null,
+                        triggeredBy: { kind: "user" },
+                        kind: result.deferred ? "learn.proposal-deferred" : "learn.proposal-accepted",
+                        payload: {
+                            proposalId: rec.proposal.id,
+                            branch: result.branch,
+                            verifyExitCode: result.verifyExitCode,
+                            reason: result.reason ?? null,
+                        },
+                    });
+                    emitter?.emit({
+                        sessionId,
+                        parentEventId: null,
+                        workspaceId: null,
+                        triggeredBy: { kind: "user" },
+                        kind: "learn.applied",
+                        payload: {
+                            proposalId: rec.proposal.id,
+                            branch: result.branch,
+                            applied: result.applied,
+                            verifyExitCode: result.verifyExitCode,
+                        },
+                    });
+                    if (result.deferred) {
+                        process.stdout.write(pc.yellow(`(deferred: ${result.reason ?? "see status log"})\n`));
+                    }
+                    else {
+                        process.stdout.write(pc.green(`(accepted; branch=${result.branch} verify=${String(result.verifyExitCode)})\n`));
+                    }
+                    break;
+                }
+            }
+            if (next === "stop")
+                break;
+        }
+    }
+    finally {
+        emitter?.emit({
+            sessionId,
+            parentEventId: null,
+            workspaceId: null,
+            triggeredBy: { kind: "user" },
+            kind: "session.end",
+            payload: { command: "learn" },
+        });
+        if (emitter)
+            await emitter.close();
+    }
+}
+export async function runLearnList(opts) {
+    const cwd = resolve(opts.cwd);
+    const status = opts.status ?? "pending";
+    // For the pending queue, apply the recurrence/severity gate (the review
+    // queue shows promoted lessons only) and surface the held "emerging" set
+    // below it so nothing is hidden. Other statuses list as before.
+    if (status === "pending") {
+        const promoted = await loadPending({ cwd });
+        const emerging = await loadEmerging({ cwd });
+        if (promoted.length === 0 && emerging.length === 0) {
+            process.stdout.write(pc.dim("(no pending proposals)\n"));
+            return;
+        }
+        if (promoted.length > 0) {
+            process.stdout.write(pc.bold("Promoted — ready for review:\n"));
+            for (const r of promoted) {
+                process.stdout.write(`${pc.cyan(r.proposal.id.slice(0, 12))}  ` +
+                    `${severityBadge(r.proposal.severity)}  ` +
+                    `${pc.dim(`target=${r.proposal.target}`)}  ` +
+                    `${r.suggestion.title}\n` +
+                    `  ${pc.dim("from:")} ${r.reflectionPath}\n`);
+            }
+        }
+        if (emerging.length > 0) {
+            process.stdout.write(pc.dim("\nEmerging — held until they recur across a second reflection or escalate to high severity:\n"));
+            for (const g of emerging) {
+                process.stdout.write(pc.dim(`  · ${g.record.suggestion.title} (target=${g.record.suggestion.target}, ${g.occurrences}×)\n`));
+            }
+        }
+        return;
+    }
+    const records = await loadByStatus({ cwd, status });
+    if (records.length === 0) {
+        process.stdout.write(pc.dim(`(no proposals with status=${status})\n`));
+        return;
+    }
+    for (const r of records) {
+        process.stdout.write(`${pc.cyan(r.proposal.id.slice(0, 12))}  ` +
+            `${severityBadge(r.proposal.severity)}  ` +
+            `${pc.dim(`target=${r.proposal.target}`)}  ` +
+            `${r.suggestion.title}\n` +
+            `  ${pc.dim("from:")} ${r.reflectionPath}\n`);
+    }
+}
+export async function runLearnApply(opts, overrides = {}) {
+    const cwd = resolve(opts.cwd);
+    const pending = await loadPending({ cwd });
+    const rec = pending.find((r) => r.proposal.id === opts.proposalId || r.proposal.id.startsWith(opts.proposalId)) ??
+        (await loadByStatus({ cwd, status: "deferred" })).find((r) => r.proposal.id === opts.proposalId || r.proposal.id.startsWith(opts.proposalId));
+    if (!rec) {
+        process.stderr.write(pc.red(`No matching proposal for id=${opts.proposalId}\n`));
+        process.exitCode = 1;
+        return;
+    }
+    const providerKindRaw = (opts.provider ?? process.env["KEEL_PROVIDER_KIND"] ?? "anthropic");
+    if (providerKindRaw !== "anthropic" && providerKindRaw !== "openai-compatible" && providerKindRaw !== "claude-bridge") {
+        throw new Error(`Unknown --provider kind: ${providerKindRaw}`);
+    }
+    const resolved = await resolveProviderConfig({
+        providerKind: providerKindRaw,
+        ...(opts.model ? { model: opts.model } : {}),
+    });
+    const diff = await (overrides.diffFn ?? proposalToDiff)({
+        proposal: rec.proposal,
+        suggestion: rec.suggestion,
+        cwd,
+        provider: resolved.provider,
+        ...(opts.model ? { model: opts.model } : {}),
+    });
+    await fs.mkdir(resolve(cwd, ".keel", "learn"), { recursive: true });
+    const result = await (overrides.applyFn ?? applyAccepted)({
+        proposal: rec.proposal,
+        diff: diff.diff,
+        cwd,
+    });
+    process.stdout.write(`branch=${result.branch} applied=${result.applied} verify=${String(result.verifyExitCode)} deferred=${result.deferred}\n`);
+    if (result.reason) {
+        process.stdout.write(pc.dim(`reason: ${result.reason}\n`));
+    }
+}
+//# sourceMappingURL=learn.js.map

package/dist/learn.js.map

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

package/dist/lifecycle.d.ts

@@ -0,0 +1,27 @@
+export interface UpLock {
+    apiPort: number;
+    uiPort: number;
+    apiUrl: string;
+    uiUrl: string;
+    dockerContainer: string | null;
+    repoRoot: string;
+    startedAt: string;
+}
+export declare function keelStateDir(): string;
+export declare function lockfilePath(apiPort: number): string;
+export declare function writeLock(lock: UpLock): void;
+export declare function readLock(apiPort: number): UpLock | null;
+export declare function removeLock(apiPort: number): void;
+export declare function listLocks(): UpLock[];
+export declare function listenerPidsOnPort(port: number): number[];
+export declare function pgidOf(pid: number): number | null;
+export declare function processAlive(pid: number): boolean;
+export interface StopOutcome {
+    killedGroups: number[];
+    warnings: string[];
+}
+export declare function stopListenersOnPorts(ports: number[], graceMs?: number, sleep?: (ms: number) => Promise<void>): Promise<StopOutcome>;
+export declare function dockerContainerStatus(container: string): "running" | "exited" | "absent";
+export declare function stopDockerContainer(container: string): boolean;
+export declare function lockExists(apiPort: number): boolean;
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../src/lifecycle.ts"],"names":[],"mappings":"AAyBA,MAAM,WAAW,MAAM;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAID,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAG5C;AAED,wBAAgB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMvD;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAMhD;AAED,wBAAgB,SAAS,IAAI,MAAM,EAAE,CAepC;AAKD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAazD;AAKD,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAajD;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CASjD;AAED,MAAM,WAAW,WAAW;IAC1B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAKD,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,MAAM,EAAE,EACf,OAAO,SAAO,EACd,KAAK,GAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAiD,GACnF,OAAO,CAAC,WAAW,CAAC,CA0CtB;AAED,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAWxF;AAED,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAO9D;AAED,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEnD"}

package/dist/lifecycle.js

@@ -0,0 +1,193 @@
+// Lifecycle substrate for `keel down` / `keel status` / `keel restart`.
+//
+// Design decision — kill by PORT, not by stored PID. An earlier sketch recorded
+// the spawned child PIDs in a lockfile and SIGTERMed them on `down`. That is
+// fragile two ways: (1) `keel up` spawns the API/UI via a `pnpm --filter ... dev`
+// wrapper, so the recorded PID is the wrapper, not the `next dev`/api server it
+// forks — SIGTERMing the wrapper orphans the real listener; (2) PIDs are
+// recycled, so a stale lockfile can name a PID the OS has since reassigned to an
+// unrelated process, and `down` would kill a stranger.
+//
+// Instead, `down` resolves the process actually LISTENING on keel's API/UI port
+// (lsof), confirms via the /health fingerprint that the API port is really keel,
+// and kills that listener's whole process GROUP (the job group `keel up` created,
+// which contains the wrapper + the dev server + its compiler workers). This
+// targets exactly what is bound to keel's ports, verified to be keel, with no
+// reliance on a possibly-stale recorded PID.
+//
+// The lockfile (~/.keel/up-<apiPort>.json) is kept only as an informational index
+// — it lets `status` enumerate instances and tells `down` which docker container
+// to stop — and is never trusted for the kill decision.
+import { execFileSync } from "node:child_process";
+import { existsSync, mkdirSync, readFileSync, readdirSync, rmSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+export function keelStateDir() {
+    return join(homedir(), ".keel");
+}
+// One lockfile per API port so multiple workspaces on different ports — a
+// documented single-user-mode use case — don't clobber each other's state.
+export function lockfilePath(apiPort) {
+    return join(keelStateDir(), `up-${apiPort}.json`);
+}
+export function writeLock(lock) {
+    mkdirSync(keelStateDir(), { recursive: true });
+    writeFileSync(lockfilePath(lock.apiPort), JSON.stringify(lock, null, 2), "utf8");
+}
+export function readLock(apiPort) {
+    try {
+        return JSON.parse(readFileSync(lockfilePath(apiPort), "utf8"));
+    }
+    catch {
+        return null;
+    }
+}
+export function removeLock(apiPort) {
+    try {
+        rmSync(lockfilePath(apiPort), { force: true });
+    }
+    catch {
+        /* best-effort */
+    }
+}
+export function listLocks() {
+    try {
+        return readdirSync(keelStateDir())
+            .filter((f) => /^up-\d+\.json$/.test(f))
+            .map((f) => {
+            try {
+                return JSON.parse(readFileSync(join(keelStateDir(), f), "utf8"));
+            }
+            catch {
+                return null;
+            }
+        })
+            .filter((l) => l !== null);
+    }
+    catch {
+        return [];
+    }
+}
+// PIDs listening on a TCP port (POSIX, via lsof). Empty on Windows or when
+// nothing listens. We intentionally resolve the live listener rather than trust a
+// recorded PID — see the module header.
+export function listenerPidsOnPort(port) {
+    if (process.platform === "win32")
+        return [];
+    try {
+        const out = execFileSync("lsof", ["-nP", `-iTCP:${port}`, "-sTCP:LISTEN", "-t"], {
+            stdio: ["ignore", "pipe", "ignore"],
+        })
+            .toString()
+            .trim();
+        if (out.length === 0)
+            return [];
+        return [...new Set(out.split(/\s+/).map((s) => Number(s)).filter((n) => Number.isInteger(n) && n > 0))];
+    }
+    catch {
+        return [];
+    }
+}
+// The process-group id of a pid (POSIX). Killing the group (`kill -<pgid>`) reaps
+// the whole `keel up` job — the pnpm wrapper, the dev server, and its workers —
+// in one shot. Returns null if the pid is gone or on Windows.
+export function pgidOf(pid) {
+    if (process.platform === "win32")
+        return null;
+    try {
+        const out = execFileSync("ps", ["-o", "pgid=", "-p", String(pid)], {
+            stdio: ["ignore", "pipe", "ignore"],
+        })
+            .toString()
+            .trim();
+        const pgid = Number(out);
+        return Number.isInteger(pgid) && pgid > 0 ? pgid : null;
+    }
+    catch {
+        return null;
+    }
+}
+export function processAlive(pid) {
+    try {
+        // Signal 0 doesn't deliver — it only tests existence/permission.
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (err) {
+        // EPERM means it exists but we can't signal it; ESRCH means it's gone.
+        return err.code === "EPERM";
+    }
+}
+// Stop the keel processes bound to the given ports by killing their process
+// group(s): SIGTERM, then SIGKILL after a grace period for any survivors. Returns
+// the pgids actioned plus any warnings. Pure POSIX; the caller gates Windows.
+export async function stopListenersOnPorts(ports, graceMs = 4000, sleep = (ms) => new Promise((r) => setTimeout(r, ms))) {
+    const warnings = [];
+    const pgids = new Set();
+    for (const port of ports) {
+        for (const pid of listenerPidsOnPort(port)) {
+            const pgid = pgidOf(pid);
+            // Fall back to the pid itself only if we couldn't resolve a group.
+            pgids.add(pgid ?? pid);
+        }
+    }
+    if (pgids.size === 0)
+        return { killedGroups: [], warnings };
+    for (const pgid of pgids) {
+        try {
+            process.kill(-pgid, "SIGTERM");
+        }
+        catch {
+            try {
+                process.kill(pgid, "SIGTERM");
+            }
+            catch {
+                /* already gone */
+            }
+        }
+    }
+    await sleep(graceMs);
+    // Escalate to SIGKILL for any group still holding a listener.
+    for (const pgid of pgids) {
+        if (processAlive(pgid)) {
+            try {
+                process.kill(-pgid, "SIGKILL");
+            }
+            catch {
+                try {
+                    process.kill(pgid, "SIGKILL");
+                }
+                catch {
+                    /* gone between checks */
+                }
+            }
+        }
+    }
+    return { killedGroups: [...pgids], warnings };
+}
+export function dockerContainerStatus(container) {
+    try {
+        const out = execFileSync("docker", ["inspect", "--format", "{{.State.Status}}", container], {
+            stdio: ["ignore", "pipe", "ignore"],
+        })
+            .toString()
+            .trim();
+        return out === "running" ? "running" : "exited";
+    }
+    catch {
+        return "absent";
+    }
+}
+export function stopDockerContainer(container) {
+    try {
+        execFileSync("docker", ["stop", container], { stdio: ["ignore", "pipe", "ignore"] });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function lockExists(apiPort) {
+    return existsSync(lockfilePath(apiPort));
+}
+//# sourceMappingURL=lifecycle.js.map

package/dist/lifecycle.js.map

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

package/dist/load-ts.d.ts

@@ -0,0 +1,2 @@
+export declare function importTsConfig(url: string): Promise<Record<string, unknown>>;
+//# sourceMappingURL=load-ts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"load-ts.d.ts","sourceRoot":"","sources":["../src/load-ts.ts"],"names":[],"mappings":"AAgBA,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAGlF"}

package/dist/load-ts.js

@@ -0,0 +1,20 @@
+let registered = false;
+// architecture/data.ts and principles/index.ts are authored as TypeScript and
+// imported at runtime. Node 22.6+/24 strip types natively, but the supported
+// runtime floor is Node 20 (see CLAUDE.md), which throws ERR_UNKNOWN_FILE_EXTENSION
+// on a bare `import()` of a .ts file. Registering the tsx ESM loader once, lazily,
+// makes those imports work on every supported Node without changing how callers
+// invoke the CLI. The register is idempotent and harmless on runtimes that already
+// strip types.
+async function ensureTsLoader() {
+    if (registered)
+        return;
+    registered = true;
+    const { register } = await import("tsx/esm/api");
+    register();
+}
+export async function importTsConfig(url) {
+    await ensureTsLoader();
+    return (await import(url));
+}
+//# sourceMappingURL=load-ts.js.map

package/dist/load-ts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-ts.js","sourceRoot":"","sources":["../src/load-ts.ts"],"names":[],"mappings":"AAAA,IAAI,UAAU,GAAG,KAAK,CAAC;AAEvB,8EAA8E;AAC9E,6EAA6E;AAC7E,oFAAoF;AACpF,mFAAmF;AACnF,gFAAgF;AAChF,mFAAmF;AACnF,eAAe;AACf,KAAK,UAAU,cAAc;IAC3B,IAAI,UAAU;QAAE,OAAO;IACvB,UAAU,GAAG,IAAI,CAAC;IAClB,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;IACjD,QAAQ,EAAE,CAAC;AACb,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,GAAW;IAC9C,MAAM,cAAc,EAAE,CAAC;IACvB,OAAO,CAAC,MAAM,MAAM,CAAC,GAAG,CAAC,CAA4B,CAAC;AACxD,CAAC"}

package/dist/map-repo.d.ts

@@ -0,0 +1,15 @@
+import { type RepoMap } from "@keel_flow/repo-map";
+export interface RunMapRepoArgs {
+    cwd: string;
+    noCache?: boolean;
+    output?: string;
+    json?: boolean;
+    maxTokens?: number;
+}
+export interface MapRepoResult {
+    map: RepoMap;
+    cacheHit: boolean;
+    ageMs: number | null;
+}
+export declare function runMapRepo(args: RunMapRepoArgs): Promise<MapRepoResult>;
+//# sourceMappingURL=map-repo.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"map-repo.d.ts","sourceRoot":"","sources":["../src/map-repo.ts"],"names":[],"mappings":"AAEA,OAAO,EAOL,KAAK,OAAO,EACb,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,OAAO,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED,wBAAsB,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CA+B7E"}

package/dist/map-repo.js

@@ -0,0 +1,36 @@
+import { writeFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { buildRepoMap, cacheAgeMs, isCacheStale, loadCache, saveCache, toMarkdown, } from "@keel_flow/repo-map";
+export async function runMapRepo(args) {
+    const cwd = resolve(args.cwd);
+    let map = null;
+    let cacheHit = false;
+    if (!args.noCache) {
+        const cached = loadCache(cwd);
+        if (cached && !isCacheStale(cwd, cached.files)) {
+            map = cached;
+            cacheHit = true;
+        }
+    }
+    if (!map) {
+        map = await buildRepoMap({
+            cwd,
+            ...(args.maxTokens !== undefined ? { maxTokens: args.maxTokens } : {}),
+        });
+        if (!args.noCache)
+            saveCache(cwd, map);
+    }
+    const out = args.json
+        ? JSON.stringify(map, null, 2)
+        : toMarkdown(map.entries);
+    if (args.output) {
+        writeFileSync(resolve(args.output), out, "utf-8");
+    }
+    else {
+        process.stdout.write(out);
+        if (!out.endsWith("\n"))
+            process.stdout.write("\n");
+    }
+    return { map, cacheHit, ageMs: cacheHit ? cacheAgeMs(cwd) : 0 };
+}
+//# sourceMappingURL=map-repo.js.map

package/dist/map-repo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-repo.js","sourceRoot":"","sources":["../src/map-repo.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EACL,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,SAAS,EACT,SAAS,EACT,UAAU,GAEX,MAAM,qBAAqB,CAAC;AAgB7B,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAoB;IACnD,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC9B,IAAI,GAAG,GAAmB,IAAI,CAAC;IAC/B,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QAClB,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;QAC9B,IAAI,MAAM,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;YAC/C,GAAG,GAAG,MAAM,CAAC;YACb,QAAQ,GAAG,IAAI,CAAC;QAClB,CAAC;IACH,CAAC;IACD,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,GAAG,GAAG,MAAM,YAAY,CAAC;YACvB,GAAG;YACH,GAAG,CAAC,IAAI,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACvE,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IACzC,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI;QACnB,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9B,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAE5B,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;IACpD,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC1B,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC;YAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACtD,CAAC;IAED,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAClE,CAAC"}

package/dist/memory.d.ts

@@ -0,0 +1,23 @@
+export interface MemoryListOptions {
+    cwd: string;
+    global?: boolean;
+}
+export declare function runMemoryList(opts: MemoryListOptions): Promise<void>;
+export interface MemoryAddOptions {
+    cwd: string;
+    global?: boolean;
+    fact: string;
+}
+export declare function runMemoryAdd(opts: MemoryAddOptions): Promise<void>;
+export interface MemoryShowOptions {
+    cwd: string;
+    global?: boolean;
+    pattern: string;
+}
+export declare function runMemoryShow(opts: MemoryShowOptions): Promise<void>;
+export interface MemoryRemoveOptions {
+    cwd: string;
+    id: string;
+}
+export declare function runMemoryRemove(opts: MemoryRemoveOptions): Promise<void>;
+//# sourceMappingURL=memory.d.ts.map

package/dist/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../src/memory.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAMD,wBAAsB,aAAa,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAc1E;AAED,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoBxE;AAED,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAc1E;AAED,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAgC9E"}