@brainpilot/app 0.0.1

package/dist/bin.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=bin.d.ts.map

package/dist/bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":""}

package/dist/bin.js

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+/**
+ * bin.ts — the `brainpilot` / `bnpt` executable entry. Thin: delegates to the
+ * commander program and maps thrown errors to a non-zero exit (§11A.4).
+ */
+import { run } from "./program.js";
+run(process.argv.slice(2)).catch(() => {
+    process.exitCode = 1;
+});
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AACA;;;GAGG;AACH,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAEnC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;IACpC,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CAAC,CAAC"}

package/dist/commands/down.d.ts

@@ -0,0 +1,17 @@
+import { type ProcessControlDeps } from "../process-control.js";
+export interface DownOptions {
+    dir?: string;
+    timeoutMs?: number;
+}
+export interface DownDeps extends ProcessControlDeps {
+    env?: Record<string, string | undefined>;
+    cwd?: string;
+    log?: (msg: string) => void;
+}
+export interface DownResult {
+    stopped: boolean;
+    pid: number | null;
+    forced: boolean;
+}
+export declare function down(options?: DownOptions, deps?: DownDeps): Promise<DownResult>;
+//# sourceMappingURL=down.d.ts.map

package/dist/commands/down.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"down.d.ts","sourceRoot":"","sources":["../../src/commands/down.ts"],"names":[],"mappings":"AAQA,OAAO,EAAmB,KAAK,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAEjF,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,QAAS,SAAQ,kBAAkB;IAClD,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACzC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7B;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,wBAAsB,IAAI,CACxB,OAAO,GAAE,WAAgB,EACzB,IAAI,GAAE,QAAa,GAClB,OAAO,CAAC,UAAU,CAAC,CAuBrB"}

package/dist/commands/down.js

@@ -0,0 +1,33 @@
+/**
+ * commands/down.ts — stop the detached backend (TS_PI_REFACTOR_DESIGN §11A.4).
+ * Reads `.runtime/backend.pid`, gracefully stops it (SIGTERM→SIGKILL). The
+ * backend's own LocalProcessOrchestrator stops the runtime child on shutdown,
+ * but we also clean up a stale runtime.pid if present.
+ */
+import pc from "picocolors";
+import { resolveDataDir, dataPaths } from "../paths.js";
+import { stop, removePid } from "../process-control.js";
+export async function down(options = {}, deps = {}) {
+    const log = deps.log ?? ((m) => console.log(m));
+    const dataDir = resolveDataDir({ dir: options.dir, env: deps.env, cwd: deps.cwd });
+    const p = dataPaths(dataDir);
+    const result = await stop(p.backendPid, {
+        timeoutMs: options.timeoutMs,
+        isAlive: deps.isAlive,
+        signal: deps.signal,
+        sleep: deps.sleep,
+    });
+    // Backend owns the runtime; clean any leftover runtime pid file regardless.
+    await removePid(p.runtimePid);
+    if (result.pid === null) {
+        log(pc.yellow("No running backend found (no pid file)."));
+    }
+    else if (result.forced) {
+        log(pc.yellow(`Backend (pid ${result.pid}) force-killed after timeout.`));
+    }
+    else {
+        log(pc.green(`Backend (pid ${result.pid}) stopped.`));
+    }
+    return result;
+}
+//# sourceMappingURL=down.js.map

package/dist/commands/down.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"down.js","sourceRoot":"","sources":["../../src/commands/down.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,IAAI,EAAE,SAAS,EAA2B,MAAM,uBAAuB,CAAC;AAmBjF,MAAM,CAAC,KAAK,UAAU,IAAI,CACxB,UAAuB,EAAE,EACzB,OAAiB,EAAE;IAEnB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACxD,MAAM,OAAO,GAAG,cAAc,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IACnF,MAAM,CAAC,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IAE7B,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,CAAC,CAAC,UAAU,EAAE;QACtC,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,KAAK,EAAE,IAAI,CAAC,KAAK;KAClB,CAAC,CAAC;IAEH,4EAA4E;IAC5E,MAAM,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IAE9B,IAAI,MAAM,CAAC,GAAG,KAAK,IAAI,EAAE,CAAC;QACxB,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,yCAAyC,CAAC,CAAC,CAAC;IAC5D,CAAC;SAAM,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;QACzB,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,gBAAgB,MAAM,CAAC,GAAG,+BAA+B,CAAC,CAAC,CAAC;IAC5E,CAAC;SAAM,CAAC;QACN,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,gBAAgB,MAAM,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC;IACxD,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/commands/init.d.ts

@@ -0,0 +1,23 @@
+import { writeLocalSettings } from "@brainpilot/backend-core";
+export interface InitOptions {
+    dir?: string;
+    port?: number;
+    /** Optional API key to persist into bp_template/settings.json. */
+    apiKey?: string;
+    /** Optional model id to persist. */
+    model?: string;
+}
+export interface InitDeps {
+    env?: Record<string, string | undefined>;
+    cwd?: string;
+    log?: (msg: string) => void;
+    /** Injectable settings writer (defaults to backend-core writeLocalSettings). */
+    writeSettings?: typeof writeLocalSettings;
+}
+export interface InitResult {
+    dataDir: string;
+    created: string[];
+    keyPersisted: boolean;
+}
+export declare function init(options?: InitOptions, deps?: InitDeps): Promise<InitResult>;
+//# sourceMappingURL=init.d.ts.map

package/dist/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAI9D,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kEAAkE;IAClE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oCAAoC;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,QAAQ;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACzC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,gFAAgF;IAChF,aAAa,CAAC,EAAE,OAAO,kBAAkB,CAAC;CAC3C;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,wBAAsB,IAAI,CACxB,OAAO,GAAE,WAAgB,EACzB,IAAI,GAAE,QAAa,GAClB,OAAO,CAAC,UAAU,CAAC,CA8BrB"}

package/dist/commands/init.js

@@ -0,0 +1,32 @@
+/**
+ * commands/init.ts — scaffold the launch dir + optionally persist a provider
+ * key, without starting anything (TS_PI_REFACTOR_DESIGN §11A.4).
+ */
+import pc from "picocolors";
+import { writeLocalSettings } from "@brainpilot/backend-core";
+import { resolveDataDir } from "../paths.js";
+import { scaffold } from "../scaffold.js";
+export async function init(options = {}, deps = {}) {
+    const log = deps.log ?? ((m) => console.log(m));
+    const dataDir = resolveDataDir({ dir: options.dir, env: deps.env, cwd: deps.cwd });
+    const { created } = await scaffold(dataDir, { port: options.port });
+    log(created.length > 0
+        ? pc.green(`Initialized ${dataDir} (${created.length} files created).`)
+        : pc.dim(`${dataDir} already initialized — nothing to do.`));
+    let keyPersisted = false;
+    if (options.apiKey || options.model) {
+        const writeSettings = deps.writeSettings ?? writeLocalSettings;
+        await writeSettings(dataDir, {
+            ...(options.apiKey ? { apiKey: options.apiKey } : {}),
+            ...(options.model ? { model: options.model } : {}),
+        });
+        keyPersisted = Boolean(options.apiKey);
+        log(pc.green("Provider settings saved to bp_template/settings.json."));
+    }
+    else {
+        log(pc.dim("No --api-key given. Set ANTHROPIC_API_KEY in your env, " +
+            "or re-run `brainpilot init --api-key <key>`."));
+    }
+    return { dataDir, created, keyPersisted };
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAyB1C,MAAM,CAAC,KAAK,UAAU,IAAI,CACxB,UAAuB,EAAE,EACzB,OAAiB,EAAE;IAEnB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACxD,MAAM,OAAO,GAAG,cAAc,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IAEnF,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,QAAQ,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IACpE,GAAG,CACD,OAAO,CAAC,MAAM,GAAG,CAAC;QAChB,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,eAAe,OAAO,KAAK,OAAO,CAAC,MAAM,kBAAkB,CAAC;QACvE,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,OAAO,uCAAuC,CAAC,CAC9D,CAAC;IAEF,IAAI,YAAY,GAAG,KAAK,CAAC;IACzB,IAAI,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QACpC,MAAM,aAAa,GAAG,IAAI,CAAC,aAAa,IAAI,kBAAkB,CAAC;QAC/D,MAAM,aAAa,CAAC,OAAO,EAAE;YAC3B,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACrD,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACnD,CAAC,CAAC;QACH,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QACvC,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC,uDAAuD,CAAC,CAAC,CAAC;IACzE,CAAC;SAAM,CAAC;QACN,GAAG,CACD,EAAE,CAAC,GAAG,CACJ,yDAAyD;YACvD,8CAA8C,CACjD,CACF,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC;AAC5C,CAAC"}

package/dist/commands/logs.d.ts

@@ -0,0 +1,18 @@
+export interface LogsOptions {
+    dir?: string;
+    /** Which log to read. Default `backend`. */
+    which?: "backend" | "runtime";
+    /** Number of trailing lines to print. Default 200. */
+    lines?: number;
+    /** Follow (`tail -f`). Default false. */
+    follow?: boolean;
+}
+export interface LogsDeps {
+    env?: Record<string, string | undefined>;
+    cwd?: string;
+    log?: (msg: string) => void;
+}
+/** Read the last `n` lines of a file; returns "" if the file is missing. */
+export declare function tailFile(path: string, n: number): Promise<string>;
+export declare function logs(options?: LogsOptions, deps?: LogsDeps): Promise<string>;
+//# sourceMappingURL=logs.d.ts.map

package/dist/commands/logs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.d.ts","sourceRoot":"","sources":["../../src/commands/logs.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,KAAK,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IAC9B,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,yCAAyC;IACzC,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,QAAQ;IACvB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACzC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7B;AAED,4EAA4E;AAC5E,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAWvE;AAED,wBAAsB,IAAI,CACxB,OAAO,GAAE,WAAgB,EACzB,IAAI,GAAE,QAAa,GAClB,OAAO,CAAC,MAAM,CAAC,CAmBjB"}

package/dist/commands/logs.js

@@ -0,0 +1,78 @@
+/**
+ * commands/logs.ts — tail the backend/runtime logs under `.runtime/logs/`
+ * (TS_PI_REFACTOR_DESIGN §11A.4 / §11A.5).
+ */
+import { readFile } from "node:fs/promises";
+import { createReadStream } from "node:fs";
+import { watch } from "node:fs";
+import pc from "picocolors";
+import { resolveDataDir, dataPaths } from "../paths.js";
+/** Read the last `n` lines of a file; returns "" if the file is missing. */
+export async function tailFile(path, n) {
+    let content;
+    try {
+        content = await readFile(path, "utf8");
+    }
+    catch {
+        return "";
+    }
+    const lines = content.split(/\r?\n/);
+    // Drop a trailing empty element from a final newline.
+    if (lines.length > 0 && lines[lines.length - 1] === "")
+        lines.pop();
+    return lines.slice(-n).join("\n");
+}
+export async function logs(options = {}, deps = {}) {
+    const log = deps.log ?? ((m) => console.log(m));
+    const dataDir = resolveDataDir({ dir: options.dir, env: deps.env, cwd: deps.cwd });
+    const p = dataPaths(dataDir);
+    const which = options.which ?? "backend";
+    const file = which === "runtime" ? p.runtimeLog : p.backendLog;
+    const lines = options.lines ?? 200;
+    const tail = await tailFile(file, lines);
+    if (tail === "") {
+        log(pc.yellow(`No ${which} log at ${file}.`));
+    }
+    else {
+        log(tail);
+    }
+    if (options.follow) {
+        await followFile(file, log);
+    }
+    return tail;
+}
+/** Follow a file, emitting appended bytes. Runs until the process exits. */
+async function followFile(file, emit) {
+    let pos = (await safeSize(file)) ?? 0;
+    await new Promise(() => {
+        const watcher = watch(file, { persistent: true }, async () => {
+            const size = (await safeSize(file)) ?? pos;
+            if (size < pos)
+                pos = 0; // truncated/rotated
+            if (size > pos) {
+                const stream = createReadStream(file, { start: pos, end: size - 1, encoding: "utf8" });
+                let chunk = "";
+                for await (const part of stream)
+                    chunk += part;
+                if (chunk)
+                    emit(chunk.replace(/\n$/, ""));
+                pos = size;
+            }
+        });
+        // never resolves — Ctrl-C ends the process; ensure cleanup on signals.
+        process.once("SIGINT", () => {
+            watcher.close();
+            process.exit(0);
+        });
+    });
+}
+async function safeSize(file) {
+    try {
+        const { stat } = await import("node:fs/promises");
+        return (await stat(file)).size;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=logs.js.map

package/dist/commands/logs.js.map

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

package/dist/commands/status.d.ts

@@ -0,0 +1,26 @@
+import { type ProcessControlDeps } from "../process-control.js";
+export interface StatusOptions {
+    dir?: string;
+    port?: number;
+}
+export interface StatusDeps extends ProcessControlDeps {
+    env?: Record<string, string | undefined>;
+    cwd?: string;
+    log?: (msg: string) => void;
+    /** Injectable fetch for health/metrics. Defaults to global fetch. */
+    fetchFn?: typeof fetch;
+}
+export interface StatusReport {
+    running: boolean;
+    pid: number | null;
+    backendPort: number;
+    runtimePort: number;
+    url: string;
+    healthy: boolean;
+    metrics?: {
+        activeSessions?: number;
+        runningAgents?: number;
+    };
+}
+export declare function status(options?: StatusOptions, deps?: StatusDeps): Promise<StatusReport>;
+//# sourceMappingURL=status.d.ts.map

package/dist/commands/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"AAOA,OAAO,EAAsB,KAAK,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAGpF,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,UAAW,SAAQ,kBAAkB;IACpD,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACzC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,qEAAqE;IACrE,OAAO,CAAC,EAAE,OAAO,KAAK,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE;QAAE,cAAc,CAAC,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC/D;AAED,wBAAsB,MAAM,CAC1B,OAAO,GAAE,aAAkB,EAC3B,IAAI,GAAE,UAAe,GACpB,OAAO,CAAC,YAAY,CAAC,CA4DvB"}

package/dist/commands/status.js

@@ -0,0 +1,71 @@
+/**
+ * commands/status.ts — report process liveness + ports + health/metrics
+ * (TS_PI_REFACTOR_DESIGN §11A.4). Reads the backend pid file, probes
+ * GET /health and GET /metrics on the backend.
+ */
+import pc from "picocolors";
+import { resolveDataDir, dataPaths } from "../paths.js";
+import { readPid, isRunning } from "../process-control.js";
+import { DEFAULT_PORT } from "../scaffold.js";
+export async function status(options = {}, deps = {}) {
+    const log = deps.log ?? ((m) => console.log(m));
+    const env = deps.env ?? process.env;
+    const fetchFn = deps.fetchFn ?? fetch;
+    const dataDir = resolveDataDir({ dir: options.dir, env, cwd: deps.cwd });
+    const p = dataPaths(dataDir);
+    const port = options.port ?? (Number(env.BP_PORT) || DEFAULT_PORT);
+    const host = "127.0.0.1";
+    const url = `http://${host}:${port}`;
+    const pid = await readPid(p.backendPid);
+    const running = await isRunning(p.backendPid, { isAlive: deps.isAlive });
+    let healthy = false;
+    let metrics;
+    if (running) {
+        try {
+            const h = await fetchFn(`${url}/api/health`);
+            healthy = h.ok;
+        }
+        catch {
+            healthy = false;
+        }
+        try {
+            const m = await fetchFn(`${url}/api/metrics`);
+            if (m.ok) {
+                const body = (await m.json());
+                metrics = {
+                    activeSessions: numOrUndef(body.activeSessions),
+                    runningAgents: numOrUndef(body.runningAgents),
+                };
+            }
+        }
+        catch {
+            // metrics optional
+        }
+    }
+    const report = {
+        running,
+        pid,
+        backendPort: port,
+        runtimePort: port + 1,
+        url,
+        healthy,
+        ...(metrics ? { metrics } : {}),
+    };
+    if (!running) {
+        log(pc.yellow("BrainPilot is not running."));
+    }
+    else {
+        log(pc.green(`BrainPilot running (pid ${pid}) at ${url}`));
+        log(`  backend port: ${report.backendPort}  runtime port: ${report.runtimePort}`);
+        log(`  health: ${healthy ? pc.green("ok") : pc.red("unreachable")}`);
+        if (metrics) {
+            log(`  sessions: ${metrics.activeSessions ?? "?"}  ` +
+                `running agents: ${metrics.runningAgents ?? "?"}`);
+        }
+    }
+    return report;
+}
+function numOrUndef(v) {
+    return typeof v === "number" ? v : undefined;
+}
+//# sourceMappingURL=status.js.map

package/dist/commands/status.js.map

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

package/dist/commands/up.d.ts

@@ -0,0 +1,61 @@
+import type { StartServerOptions, RunningServer } from "@brainpilot/backend-core";
+export interface UpOptions {
+    /** `--dir <path>` data root. */
+    dir?: string;
+    /** `--port <n>` backend port (runtime = port+1). */
+    port?: number;
+    /** `--foreground` run the backend in-process (default true for tests). */
+    foreground?: boolean;
+    /** `--no-open` to suppress the browser. */
+    open?: boolean;
+}
+/** Injectable collaborators (defaults wire to real implementations). */
+export interface UpDeps {
+    env?: Record<string, string | undefined>;
+    cwd?: string;
+    /** Start the backend in-process. Defaults to backend-core `startServer`. */
+    startServer?: (opts: StartServerOptions) => Promise<RunningServer>;
+    /** Spawn a detached backend child. Required when `foreground` is false. */
+    spawnDetached?: (opts: ResolvedUpConfig) => Promise<number>;
+    /** Probe whether a TCP port is free. Defaults to a real net check. */
+    isPortFree?: (port: number, host: string) => Promise<boolean>;
+    /** Open a URL in the browser. Defaults to the OS launcher (open/start/xdg-open). */
+    openBrowser?: (url: string) => Promise<void>;
+    /** Resolve the web dist dir. Defaults to `resolveWebDist()`. */
+    webDist?: () => string | null;
+    log?: (msg: string) => void;
+}
+/** The fully-resolved config `up` computes before starting anything. */
+export interface ResolvedUpConfig {
+    dataDir: string;
+    port: number;
+    runtimePort: number;
+    host: string;
+    webDist: string | null;
+    foreground: boolean;
+    open: boolean;
+}
+/** Build the StartServerOptions from resolved config — exposed for tests. */
+export declare function buildStartServerOptions(cfg: ResolvedUpConfig): StartServerOptions;
+export declare class ProviderKeyError extends Error {
+    readonly dataDir: string;
+    constructor(dataDir: string);
+}
+export declare class PortInUseError extends Error {
+    readonly port: number;
+    constructor(port: number);
+}
+export interface UpResult {
+    config: ResolvedUpConfig;
+    url: string;
+    /** Present only in foreground mode — the in-process server handle. */
+    server?: RunningServer;
+    /** Present only in detached mode — the backend child pid. */
+    pid?: number;
+}
+/**
+ * Run the `up` command. Returns once the backend is started (foreground: the
+ * server handle; detached: the child pid + pid file written).
+ */
+export declare function up(options?: UpOptions, deps?: UpDeps): Promise<UpResult>;
+//# sourceMappingURL=up.d.ts.map

package/dist/commands/up.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"up.d.ts","sourceRoot":"","sources":["../../src/commands/up.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAOlF,MAAM,WAAW,SAAS;IACxB,gCAAgC;IAChC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0EAA0E;IAC1E,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,2CAA2C;IAC3C,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,wEAAwE;AACxE,MAAM,WAAW,MAAM;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACzC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,4EAA4E;IAC5E,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,kBAAkB,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;IACnE,2EAA2E;IAC3E,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,gBAAgB,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5D,sEAAsE;IACtE,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9D,oFAAoF;IACpF,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IAC9B,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7B;AAED,wEAAwE;AACxE,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,UAAU,EAAE,OAAO,CAAC;IACpB,IAAI,EAAE,OAAO,CAAC;CACf;AAED,6EAA6E;AAC7E,wBAAgB,uBAAuB,CACrC,GAAG,EAAE,gBAAgB,GACpB,kBAAkB,CASpB;AAED,qBAAa,gBAAiB,SAAQ,KAAK;aACb,OAAO,EAAE,MAAM;gBAAf,OAAO,EAAE,MAAM;CAQ5C;AAED,qBAAa,cAAe,SAAQ,KAAK;aACX,IAAI,EAAE,MAAM;gBAAZ,IAAI,EAAE,MAAM;CAQzC;AAYD,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,gBAAgB,CAAC;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,sEAAsE;IACtE,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,6DAA6D;IAC7D,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED;;;GAGG;AACH,wBAAsB,EAAE,CACtB,OAAO,GAAE,SAAc,EACvB,IAAI,GAAE,MAAW,GAChB,OAAO,CAAC,QAAQ,CAAC,CA8DnB"}

package/dist/commands/up.js

@@ -0,0 +1,150 @@
+/**
+ * commands/up.ts — the main command (TS_PI_REFACTOR_DESIGN §11A.4).
+ *
+ * Sequence:
+ *   1. resolve config (dir/port/env)
+ *   2. scaffold bp_template if absent (idempotent)
+ *   3. resolve provider key (env > bp_template/settings.json > config > .env);
+ *      error with guidance if none
+ *   4. pre-check the backend + runtime ports are free
+ *   5. start the backend (foreground in-process, or detached child)
+ *      — backend itself spawns the runtime via LocalProcessOrchestrator
+ *   6. print URL (+ optionally open browser)
+ *
+ * Everything external (startServer, port probing, browser open, child spawn)
+ * is injectable so tests drive it without a real server.
+ */
+import { resolveProvider } from "@brainpilot/backend-core";
+import pc from "picocolors";
+import { resolveDataDir, dataPaths } from "../paths.js";
+import { scaffold, isScaffolded, DEFAULT_PORT } from "../scaffold.js";
+import { writePid } from "../process-control.js";
+import { resolveWebDist } from "../web-dist.js";
+/** Build the StartServerOptions from resolved config — exposed for tests. */
+export function buildStartServerOptions(cfg) {
+    return {
+        port: cfg.port,
+        hostname: cfg.host,
+        dataDir: cfg.dataDir,
+        serveWeb: cfg.webDist !== null,
+        ...(cfg.webDist ? { webRoot: cfg.webDist } : {}),
+        // The backend creates a LocalProcessOrchestrator from env (BP_MODE=single).
+    };
+}
+export class ProviderKeyError extends Error {
+    dataDir;
+    constructor(dataDir) {
+        super("No provider API key found.\n" +
+            "  Set ANTHROPIC_API_KEY in your environment, or run `brainpilot init`,\n" +
+            `  or add it to ${dataDir}/bp_template/settings.json or ${dataDir}/.env.`);
+        this.dataDir = dataDir;
+        this.name = "ProviderKeyError";
+    }
+}
+export class PortInUseError extends Error {
+    port;
+    constructor(port) {
+        super(`Port ${port} is already in use.\n` +
+            "  Choose another with `brainpilot up --port <n>` " +
+            "(the runtime uses port+1).");
+        this.port = port;
+        this.name = "PortInUseError";
+    }
+}
+const realIsPortFree = async (port, host) => {
+    const net = await import("node:net");
+    return new Promise((resolve) => {
+        const srv = net.createServer();
+        srv.once("error", () => resolve(false));
+        srv.once("listening", () => srv.close(() => resolve(true)));
+        srv.listen(port, host);
+    });
+};
+/**
+ * Run the `up` command. Returns once the backend is started (foreground: the
+ * server handle; detached: the child pid + pid file written).
+ */
+export async function up(options = {}, deps = {}) {
+    const env = deps.env ?? process.env;
+    const log = deps.log ?? ((m) => console.log(m));
+    const isPortFree = deps.isPortFree ?? realIsPortFree;
+    const webDistFn = deps.webDist ?? (() => resolveWebDist());
+    // 1. Resolve config.
+    const dataDir = resolveDataDir({ dir: options.dir, env, cwd: deps.cwd });
+    const port = options.port ?? (Number(env.BP_PORT) || DEFAULT_PORT);
+    const host = "127.0.0.1";
+    const foreground = options.foreground ?? false;
+    const open = options.open ?? true;
+    const cfg = {
+        dataDir,
+        port,
+        runtimePort: port + 1,
+        host,
+        webDist: webDistFn(),
+        foreground,
+        open,
+    };
+    // 2. Scaffold if absent (idempotent).
+    if (!(await isScaffolded(dataDir))) {
+        log(pc.dim(`Scaffolding ${dataDir} ...`));
+        await scaffold(dataDir, { port });
+    }
+    // 3. Resolve provider key.
+    const provider = await resolveProvider({ dataDir, env });
+    if (!provider.apiKey) {
+        throw new ProviderKeyError(dataDir);
+    }
+    // 4. Pre-check ports (backend + runtime, §11A.5).
+    for (const p of [cfg.port, cfg.runtimePort]) {
+        if (!(await isPortFree(p, host)))
+            throw new PortInUseError(p);
+    }
+    const url = `http://${host}:${cfg.port}`;
+    // 5. Start the backend.
+    if (foreground) {
+        const start = deps.startServer ?? (await defaultStartServer());
+        const server = await start(buildStartServerOptions(cfg));
+        log(pc.green(`BrainPilot backend running at ${pc.bold(url)}`));
+        if (open)
+            await maybeOpen(deps, url);
+        return { config: cfg, url, server };
+    }
+    // Detached.
+    if (!deps.spawnDetached) {
+        throw new Error("Detached `up` requires a spawnDetached hook (none provided).");
+    }
+    const pid = await deps.spawnDetached(cfg);
+    await writePid(dataPaths(dataDir).backendPid, pid);
+    log(pc.green(`BrainPilot backend started (pid ${pid}) at ${pc.bold(url)}`));
+    if (open)
+        await maybeOpen(deps, url);
+    return { config: cfg, url, pid };
+}
+async function maybeOpen(deps, url) {
+    const open = deps.openBrowser ?? defaultOpenBrowser;
+    try {
+        await open(url);
+    }
+    catch {
+        /* opening the browser is best-effort; never fail `up` over it */
+    }
+}
+/** Open a URL in the OS default browser using the platform launcher (no deps). */
+const defaultOpenBrowser = async (url) => {
+    const { spawn } = await import("node:child_process");
+    const platform = process.platform;
+    const [cmd, args] = platform === "darwin"
+        ? ["open", [url]]
+        : platform === "win32"
+            ? ["cmd", ["/c", "start", "", url]]
+            : ["xdg-open", [url]];
+    const child = spawn(cmd, args, { stdio: "ignore", detached: true });
+    child.on("error", () => { }); // launcher missing (e.g. headless Linux) — ignore
+    child.unref();
+};
+/** Lazy import of backend-core startServer (keeps it out of the hot path/tests). */
+async function defaultStartServer() {
+    const mod = await import("@brainpilot/backend-core");
+    return mod.startServer;
+}
+//# sourceMappingURL=up.js.map

package/dist/commands/up.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @brainpilot/cli — Docker-free local one-click launch (§11A).
+ *
+ * Public surface: the command functions (for programmatic/test use) plus a
+ * `run(argv)` that drives the commander program.
+ */
+export { up, buildStartServerOptions, ProviderKeyError, PortInUseError } from "./commands/up.js";
+export type { UpOptions, UpDeps, UpResult, ResolvedUpConfig } from "./commands/up.js";
+export { down } from "./commands/down.js";
+export type { DownOptions, DownDeps, DownResult } from "./commands/down.js";
+export { status } from "./commands/status.js";
+export type { StatusOptions, StatusDeps, StatusReport } from "./commands/status.js";
+export { init } from "./commands/init.js";
+export type { InitOptions, InitDeps, InitResult } from "./commands/init.js";
+export { logs, tailFile } from "./commands/logs.js";
+export type { LogsOptions, LogsDeps } from "./commands/logs.js";
+export { resolveDataDir, dataPaths, resolvePaths, DEFAULT_DATA_DIR_NAME, } from "./paths.js";
+export type { DataPaths, ResolveDataDirOptions } from "./paths.js";
+export { scaffold, isScaffolded, DEFAULT_PORT } from "./scaffold.js";
+export type { ScaffoldOptions, ScaffoldResult } from "./scaffold.js";
+export { writePid, readPid, removePid, isRunning, stop, } from "./process-control.js";
+export type { ProcessControlDeps, StopResult } from "./process-control.js";
+export { resolveWebDist } from "./web-dist.js";
+export { spawnDetachedBackend, resolveBackendServerPath } from "./spawn-backend.js";
+export { buildProgram, run } from "./program.js";
+export declare const CLI_NAME = "@brainpilot/cli";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,EAAE,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACjG,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACtF,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC1C,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC5E,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpF,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC1C,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAC5E,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACpD,YAAY,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEhE,OAAO,EACL,cAAc,EACd,SAAS,EACT,YAAY,EACZ,qBAAqB,GACtB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,SAAS,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACnE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AACrE,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACrE,OAAO,EACL,QAAQ,EACR,OAAO,EACP,SAAS,EACT,SAAS,EACT,IAAI,GACL,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAC3E,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,wBAAwB,EAAE,MAAM,oBAAoB,CAAC;AAEpF,OAAO,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAEjD,eAAO,MAAM,QAAQ,oBAAoB,CAAC"}