@brainpilot/app 0.0.1

package/dist/index.js

@@ -0,0 +1,19 @@
+/**
+ * @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 { down } from "./commands/down.js";
+export { status } from "./commands/status.js";
+export { init } from "./commands/init.js";
+export { logs, tailFile } from "./commands/logs.js";
+export { resolveDataDir, dataPaths, resolvePaths, DEFAULT_DATA_DIR_NAME, } from "./paths.js";
+export { scaffold, isScaffolded, DEFAULT_PORT } from "./scaffold.js";
+export { writePid, readPid, removePid, isRunning, stop, } from "./process-control.js";
+export { resolveWebDist } from "./web-dist.js";
+export { spawnDetachedBackend, resolveBackendServerPath } from "./spawn-backend.js";
+export { buildProgram, run } from "./program.js";
+export const CLI_NAME = "@brainpilot/cli";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,EAAE,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEjG,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAE1C,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAE9C,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAE1C,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAGpD,OAAO,EACL,cAAc,EACd,SAAS,EACT,YAAY,EACZ,qBAAqB,GACtB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAErE,OAAO,EACL,QAAQ,EACR,OAAO,EACP,SAAS,EACT,SAAS,EACT,IAAI,GACL,MAAM,sBAAsB,CAAC;AAE9B,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,MAAM,CAAC,MAAM,QAAQ,GAAG,iBAAiB,CAAC"}

package/dist/paths.d.ts

@@ -0,0 +1,38 @@
+export interface ResolveDataDirOptions {
+    /** Explicit `--dir <path>` value (highest priority). */
+    dir?: string;
+    /** Environment (defaults to `process.env`). */
+    env?: Record<string, string | undefined>;
+    /** Base for relative resolution (defaults to `process.cwd()`). */
+    cwd?: string;
+}
+/** Default data-root directory name created under the launch cwd. */
+export declare const DEFAULT_DATA_DIR_NAME = "brainpilot";
+/**
+ * Resolve the absolute data-root directory.
+ * Precedence: `--dir` > `BP_DATA_DIR` > `<cwd>/brainpilot`.
+ */
+export declare function resolveDataDir(options?: ResolveDataDirOptions): string;
+/** Well-known paths under a resolved data dir (§11A.2). */
+export interface DataPaths {
+    dataDir: string;
+    bpTemplate: string;
+    bpTemplateAgents: string;
+    bpTemplateSettings: string;
+    bpTemplateMcpServers: string;
+    bp: string;
+    workspaces: string;
+    brainpilotConfig: string;
+    dotenv: string;
+    runtimeDir: string;
+    logsDir: string;
+    backendLog: string;
+    runtimeLog: string;
+    backendPid: string;
+    runtimePid: string;
+}
+/** Build all derived paths from a data dir. Pure — no filesystem access. */
+export declare function dataPaths(dataDir: string): DataPaths;
+/** Convenience: resolve data dir + derived paths in one call. */
+export declare function resolvePaths(options?: ResolveDataDirOptions): DataPaths;
+//# sourceMappingURL=paths.d.ts.map

package/dist/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,qBAAqB;IACpC,wDAAwD;IACxD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACzC,kEAAkE;IAClE,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,qEAAqE;AACrE,eAAO,MAAM,qBAAqB,eAAe,CAAC;AAElD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,OAAO,GAAE,qBAA0B,GAAG,MAAM,CAQ1E;AAED,2DAA2D;AAC3D,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,4EAA4E;AAC5E,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,CAqBpD;AAED,iEAAiE;AACjE,wBAAgB,YAAY,CAAC,OAAO,GAAE,qBAA0B,GAAG,SAAS,CAE3E"}

package/dist/paths.js

@@ -0,0 +1,51 @@
+/**
+ * paths.ts — resolve the data dir and the well-known files/dirs underneath it
+ * (TS_PI_REFACTOR_DESIGN §11A.2). Precedence for the data dir:
+ *   explicit `--dir` > `BP_DATA_DIR` env > `./brainpilot` under cwd.
+ */
+import { resolve, join } from "node:path";
+/** Default data-root directory name created under the launch cwd. */
+export const DEFAULT_DATA_DIR_NAME = "brainpilot";
+/**
+ * Resolve the absolute data-root directory.
+ * Precedence: `--dir` > `BP_DATA_DIR` > `<cwd>/brainpilot`.
+ */
+export function resolveDataDir(options = {}) {
+    const env = options.env ?? process.env;
+    const cwd = options.cwd ?? process.cwd();
+    const explicit = options.dir?.trim();
+    if (explicit)
+        return resolve(cwd, explicit);
+    const fromEnv = env.BP_DATA_DIR?.trim();
+    if (fromEnv)
+        return resolve(cwd, fromEnv);
+    return resolve(cwd, DEFAULT_DATA_DIR_NAME);
+}
+/** Build all derived paths from a data dir. Pure — no filesystem access. */
+export function dataPaths(dataDir) {
+    const bpTemplate = join(dataDir, "bp_template");
+    const runtimeDir = join(dataDir, ".runtime");
+    const logsDir = join(runtimeDir, "logs");
+    return {
+        dataDir,
+        bpTemplate,
+        bpTemplateAgents: join(bpTemplate, "agents"),
+        bpTemplateSettings: join(bpTemplate, "settings.json"),
+        bpTemplateMcpServers: join(bpTemplate, "mcp_servers.json"),
+        bp: join(dataDir, ".bp"),
+        workspaces: join(dataDir, "workspaces"),
+        brainpilotConfig: join(dataDir, "brainpilot.config.json"),
+        dotenv: join(dataDir, ".env"),
+        runtimeDir,
+        logsDir,
+        backendLog: join(logsDir, "backend.log"),
+        runtimeLog: join(logsDir, "runtime.log"),
+        backendPid: join(runtimeDir, "backend.pid"),
+        runtimePid: join(runtimeDir, "runtime.pid"),
+    };
+}
+/** Convenience: resolve data dir + derived paths in one call. */
+export function resolvePaths(options = {}) {
+    return dataPaths(resolveDataDir(options));
+}
+//# sourceMappingURL=paths.js.map

package/dist/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAW1C,qEAAqE;AACrE,MAAM,CAAC,MAAM,qBAAqB,GAAG,YAAY,CAAC;AAElD;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,UAAiC,EAAE;IAChE,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IACvC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACzC,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;IACrC,IAAI,QAAQ;QAAE,OAAO,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAC5C,MAAM,OAAO,GAAG,GAAG,CAAC,WAAW,EAAE,IAAI,EAAE,CAAC;IACxC,IAAI,OAAO;QAAE,OAAO,OAAO,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IAC1C,OAAO,OAAO,CAAC,GAAG,EAAE,qBAAqB,CAAC,CAAC;AAC7C,CAAC;AAqBD,4EAA4E;AAC5E,MAAM,UAAU,SAAS,CAAC,OAAe;IACvC,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;IAChD,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IAC7C,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IACzC,OAAO;QACL,OAAO;QACP,UAAU;QACV,gBAAgB,EAAE,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC;QAC5C,kBAAkB,EAAE,IAAI,CAAC,UAAU,EAAE,eAAe,CAAC;QACrD,oBAAoB,EAAE,IAAI,CAAC,UAAU,EAAE,kBAAkB,CAAC;QAC1D,EAAE,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC;QACxB,UAAU,EAAE,IAAI,CAAC,OAAO,EAAE,YAAY,CAAC;QACvC,gBAAgB,EAAE,IAAI,CAAC,OAAO,EAAE,wBAAwB,CAAC;QACzD,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC;QAC7B,UAAU;QACV,OAAO;QACP,UAAU,EAAE,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC;QACxC,UAAU,EAAE,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC;QACxC,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC;QAC3C,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC;KAC5C,CAAC;AACJ,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,YAAY,CAAC,UAAiC,EAAE;IAC9D,OAAO,SAAS,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC;AAC5C,CAAC"}

package/dist/process-control.d.ts

@@ -0,0 +1,33 @@
+export interface ProcessControlDeps {
+    /** Probe liveness. Defaults to `process.kill(pid, 0)`. */
+    isAlive?: (pid: number) => boolean;
+    /** Send a signal. Defaults to `process.kill`. */
+    signal?: (pid: number, sig: NodeJS.Signals) => void;
+    /** Sleep impl (injectable for tests). */
+    sleep?: (ms: number) => Promise<void>;
+}
+/** Write a pid to a file, creating parent dirs. */
+export declare function writePid(pidFile: string, pid: number): Promise<void>;
+/** Read a pid from a file, or null if missing/unparseable. */
+export declare function readPid(pidFile: string): Promise<number | null>;
+/** Remove a pid file (no error if absent). */
+export declare function removePid(pidFile: string): Promise<void>;
+/** Is the process recorded in `pidFile` currently alive? */
+export declare function isRunning(pidFile: string, deps?: ProcessControlDeps): Promise<boolean>;
+export interface StopResult {
+    /** Was a live process found and stopped (or already gone)? */
+    stopped: boolean;
+    /** The pid that was targeted, if any. */
+    pid: number | null;
+    /** True if SIGKILL was needed after SIGTERM timed out. */
+    forced: boolean;
+}
+/**
+ * Gracefully stop the process recorded in `pidFile`: SIGTERM, wait up to
+ * `timeoutMs`, then SIGKILL. Removes the pid file afterward.
+ */
+export declare function stop(pidFile: string, options?: {
+    timeoutMs?: number;
+    pollMs?: number;
+} & ProcessControlDeps): Promise<StopResult>;
+//# sourceMappingURL=process-control.d.ts.map

package/dist/process-control.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-control.d.ts","sourceRoot":"","sources":["../src/process-control.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,kBAAkB;IACjC,0DAA0D;IAC1D,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;IACnC,iDAAiD;IACjD,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,CAAC,OAAO,KAAK,IAAI,CAAC;IACpD,yCAAyC;IACzC,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC;AAmBD,mDAAmD;AACnD,wBAAsB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAG1E;AAED,8DAA8D;AAC9D,wBAAsB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAQrE;AAED,8CAA8C;AAC9C,wBAAsB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE9D;AAED,4DAA4D;AAC5D,wBAAsB,SAAS,CAC7B,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,kBAAuB,GAC5B,OAAO,CAAC,OAAO,CAAC,CAIlB;AAED,MAAM,WAAW,UAAU;IACzB,8DAA8D;IAC9D,OAAO,EAAE,OAAO,CAAC;IACjB,yCAAyC;IACzC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,0DAA0D;IAC1D,MAAM,EAAE,OAAO,CAAC;CACjB;AAED;;;GAGG;AACH,wBAAsB,IAAI,CACxB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,kBAAuB,GACzE,OAAO,CAAC,UAAU,CAAC,CA2CrB"}

package/dist/process-control.js

@@ -0,0 +1,95 @@
+/**
+ * process-control.ts — pid file lifecycle for detached `up` + `down`/`status`
+ * (TS_PI_REFACTOR_DESIGN §11A.5). Pure-ish: process probing/signalling is
+ * injectable so tests run against a fake process table.
+ */
+import { writeFile, readFile, rm, mkdir } from "node:fs/promises";
+import { dirname } from "node:path";
+const realIsAlive = (pid) => {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (err) {
+        // ESRCH = no such process; EPERM = exists but not ours (treat as alive).
+        return err.code === "EPERM";
+    }
+};
+const realSignal = (pid, sig) => {
+    process.kill(pid, sig);
+};
+const realSleep = (ms) => new Promise((r) => setTimeout(r, ms));
+/** Write a pid to a file, creating parent dirs. */
+export async function writePid(pidFile, pid) {
+    await mkdir(dirname(pidFile), { recursive: true });
+    await writeFile(pidFile, String(pid), "utf8");
+}
+/** Read a pid from a file, or null if missing/unparseable. */
+export async function readPid(pidFile) {
+    try {
+        const raw = (await readFile(pidFile, "utf8")).trim();
+        const pid = Number.parseInt(raw, 10);
+        return Number.isInteger(pid) && pid > 0 ? pid : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** Remove a pid file (no error if absent). */
+export async function removePid(pidFile) {
+    await rm(pidFile, { force: true });
+}
+/** Is the process recorded in `pidFile` currently alive? */
+export async function isRunning(pidFile, deps = {}) {
+    const pid = await readPid(pidFile);
+    if (pid === null)
+        return false;
+    return (deps.isAlive ?? realIsAlive)(pid);
+}
+/**
+ * Gracefully stop the process recorded in `pidFile`: SIGTERM, wait up to
+ * `timeoutMs`, then SIGKILL. Removes the pid file afterward.
+ */
+export async function stop(pidFile, options = {}) {
+    const isAlive = options.isAlive ?? realIsAlive;
+    const signal = options.signal ?? realSignal;
+    const sleep = options.sleep ?? realSleep;
+    const timeoutMs = options.timeoutMs ?? 10_000;
+    const pollMs = options.pollMs ?? 100;
+    const pid = await readPid(pidFile);
+    if (pid === null) {
+        return { stopped: false, pid: null, forced: false };
+    }
+    if (!isAlive(pid)) {
+        await removePid(pidFile);
+        return { stopped: true, pid, forced: false };
+    }
+    try {
+        signal(pid, "SIGTERM");
+    }
+    catch {
+        // process vanished between probe and signal — treat as stopped.
+        await removePid(pidFile);
+        return { stopped: true, pid, forced: false };
+    }
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        if (!isAlive(pid)) {
+            await removePid(pidFile);
+            return { stopped: true, pid, forced: false };
+        }
+        await sleep(pollMs);
+    }
+    // Still alive — force kill.
+    let forced = false;
+    try {
+        signal(pid, "SIGKILL");
+        forced = true;
+    }
+    catch {
+        // already gone
+    }
+    await removePid(pidFile);
+    return { stopped: true, pid, forced };
+}
+//# sourceMappingURL=process-control.js.map

package/dist/process-control.js.map

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

package/dist/program.d.ts

@@ -0,0 +1,30 @@
+/**
+ * program.ts — commander wiring for the `brainpilot` / `bnpt` CLI (§11A.4).
+ * `buildProgram()` returns a configured Command; `run(argv)` parses + dispatches.
+ * Kept separate from bin.ts so it can be invoked programmatically in tests.
+ */
+import { Command } from "commander";
+import { up } from "./commands/up.js";
+import { down } from "./commands/down.js";
+import { status } from "./commands/status.js";
+import { init } from "./commands/init.js";
+import { logs } from "./commands/logs.js";
+/** Hooks injectable for tests so `run()` never touches a real server/process. */
+export interface ProgramDeps {
+    upFn?: typeof up;
+    downFn?: typeof down;
+    statusFn?: typeof status;
+    initFn?: typeof init;
+    logsFn?: typeof logs;
+    log?: (msg: string) => void;
+    /** Override process.exit (tests). */
+    onError?: (err: Error) => void;
+}
+export declare function buildProgram(deps?: ProgramDeps): Command;
+/**
+ * Parse `argv` and dispatch. `argv` excludes node + script (commander's
+ * `from: "user"`). Returns the commander result; throws are surfaced unless an
+ * `onError` hook is provided.
+ */
+export declare function run(argv: string[], deps?: ProgramDeps): Promise<void>;
+//# sourceMappingURL=program.d.ts.map

package/dist/program.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"program.d.ts","sourceRoot":"","sources":["../src/program.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AACtC,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC1C,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAG1C,iFAAiF;AACjF,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,IAAI,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE,OAAO,IAAI,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,IAAI,CAAC;IACrB,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,qCAAqC;IACrC,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAC;CAChC;AAUD,wBAAgB,YAAY,CAAC,IAAI,GAAE,WAAgB,GAAG,OAAO,CAqF5D;AAED;;;;GAIG;AACH,wBAAsB,GAAG,CACvB,IAAI,EAAE,MAAM,EAAE,EACd,IAAI,GAAE,WAAgB,GACrB,OAAO,CAAC,IAAI,CAAC,CAmBf"}

package/dist/program.js

@@ -0,0 +1,123 @@
+/**
+ * program.ts — commander wiring for the `brainpilot` / `bnpt` CLI (§11A.4).
+ * `buildProgram()` returns a configured Command; `run(argv)` parses + dispatches.
+ * Kept separate from bin.ts so it can be invoked programmatically in tests.
+ */
+import { Command } from "commander";
+import pc from "picocolors";
+import { up } from "./commands/up.js";
+import { down } from "./commands/down.js";
+import { status } from "./commands/status.js";
+import { init } from "./commands/init.js";
+import { logs } from "./commands/logs.js";
+import { spawnDetachedBackend } from "./spawn-backend.js";
+function parsePort(value) {
+    const n = Number.parseInt(value, 10);
+    if (!Number.isInteger(n) || n <= 0 || n > 65535) {
+        throw new Error(`Invalid port: ${value}`);
+    }
+    return n;
+}
+export function buildProgram(deps = {}) {
+    const program = new Command();
+    const upFn = deps.upFn ?? up;
+    const downFn = deps.downFn ?? down;
+    const statusFn = deps.statusFn ?? status;
+    const initFn = deps.initFn ?? init;
+    const logsFn = deps.logsFn ?? logs;
+    program
+        .name("brainpilot")
+        .description("BrainPilot — Docker-free local launcher (§11A)")
+        .version("0.1.0");
+    program
+        .command("up")
+        .description("Start the BrainPilot backend (+runtime) and open the UI")
+        .option("-d, --dir <path>", "data directory (default ./brainpilot)")
+        .option("-p, --port <n>", "backend port (runtime uses port+1)", parsePort)
+        .option("--foreground", "run the backend in-process (do not detach)", false)
+        .option("--detach", "run the backend as a background process", false)
+        .option("--no-open", "do not open the browser")
+        .action(async (opts) => {
+        const foreground = Boolean(opts.foreground) && !opts.detach;
+        await upFn({
+            dir: opts.dir,
+            port: opts.port,
+            foreground,
+            open: opts.open,
+        }, { spawnDetached: spawnDetachedBackend });
+        // In foreground mode the server keeps the event loop alive.
+    });
+    program
+        .command("down")
+        .description("Stop the background BrainPilot backend")
+        .option("-d, --dir <path>", "data directory (default ./brainpilot)")
+        .action(async (opts) => {
+        await downFn({ dir: opts.dir });
+    });
+    program
+        .command("status")
+        .description("Report whether BrainPilot is running + health/metrics")
+        .option("-d, --dir <path>", "data directory (default ./brainpilot)")
+        .option("-p, --port <n>", "backend port", parsePort)
+        .action(async (opts) => {
+        await statusFn({ dir: opts.dir, port: opts.port });
+    });
+    program
+        .command("init")
+        .description("Scaffold the launch directory + persist a provider key")
+        .option("-d, --dir <path>", "data directory (default ./brainpilot)")
+        .option("-p, --port <n>", "default backend port", parsePort)
+        .option("--api-key <key>", "provider API key to persist")
+        .option("--model <id>", "default model id")
+        .action(async (opts) => {
+        await initFn({
+            dir: opts.dir,
+            port: opts.port,
+            apiKey: opts.apiKey,
+            model: opts.model,
+        });
+    });
+    program
+        .command("logs")
+        .description("Tail the backend/runtime logs")
+        .option("-d, --dir <path>", "data directory (default ./brainpilot)")
+        .option("--runtime", "show the runtime log instead of the backend log", false)
+        .option("-n, --lines <n>", "trailing lines to show", (v) => parseInt(v, 10), 200)
+        .option("-f, --follow", "follow the log (tail -f)", false)
+        .action(async (opts) => {
+        await logsFn({
+            dir: opts.dir,
+            which: opts.runtime ? "runtime" : "backend",
+            lines: opts.lines,
+            follow: opts.follow,
+        });
+    });
+    return program;
+}
+/**
+ * Parse `argv` and dispatch. `argv` excludes node + script (commander's
+ * `from: "user"`). Returns the commander result; throws are surfaced unless an
+ * `onError` hook is provided.
+ */
+export async function run(argv, deps = {}) {
+    const program = buildProgram(deps);
+    program.exitOverride();
+    try {
+        await program.parseAsync(argv, { from: "user" });
+    }
+    catch (err) {
+        const log = deps.log ?? ((m) => console.error(m));
+        // commander's help/version throw with these codes — not real errors.
+        const code = err.code;
+        if (code === "commander.helpDisplayed" || code === "commander.version") {
+            return;
+        }
+        if (deps.onError) {
+            deps.onError(err);
+            return;
+        }
+        log(pc.red(err.message));
+        throw err;
+    }
+}
+//# sourceMappingURL=program.js.map

package/dist/program.js.map

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

package/dist/scaffold.d.ts

@@ -0,0 +1,23 @@
+import { type DataPaths } from "./paths.js";
+/** Default backend port (§11A.5 决策 D). Runtime uses port+1 (stride-2 §16). */
+export declare const DEFAULT_PORT = 9001;
+export interface ScaffoldOptions {
+    /** Default backend port baked into brainpilot.config.json. */
+    port?: number;
+    /** Default provider name baked into brainpilot.config.json. */
+    provider?: string;
+}
+export interface ScaffoldResult {
+    paths: DataPaths;
+    /** Files that were freshly created (absent before). */
+    created: string[];
+}
+/**
+ * Create the launch directory tree under `dataDir`. Idempotent — only writes
+ * files that don't yet exist. Returns the list of newly created files so the
+ * caller can report "scaffolded" vs "already present".
+ */
+export declare function scaffold(dataDir: string, options?: ScaffoldOptions): Promise<ScaffoldResult>;
+/** Whether the data dir already has a `bp_template/` (used by `up` to decide). */
+export declare function isScaffolded(dataDir: string): Promise<boolean>;
+//# sourceMappingURL=scaffold.d.ts.map

package/dist/scaffold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../src/scaffold.ts"],"names":[],"mappings":"AAYA,OAAO,EAAa,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvD,8EAA8E;AAC9E,eAAO,MAAM,YAAY,OAAO,CAAC;AAuEjC,MAAM,WAAW,eAAe;IAC9B,8DAA8D;IAC9D,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,SAAS,CAAC;IACjB,uDAAuD;IACvD,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;;GAIG;AACH,wBAAsB,QAAQ,CAC5B,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,cAAc,CAAC,CA2CzB;AAED,kFAAkF;AAClF,wBAAsB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAEpE"}

package/dist/scaffold.js

@@ -0,0 +1,110 @@
+/**
+ * scaffold.ts — materialize the `./brainpilot/` launch directory tree
+ * (TS_PI_REFACTOR_DESIGN §11A.2). Creating a default editable `bp_template/`
+ * (agents prompts + example settings/mcp config) and a default
+ * `brainpilot.config.json`.
+ *
+ * Idempotent: existing files are never overwritten, protecting user edits
+ * (§11A.4 step 2 "幂等，已存在不覆盖").
+ */
+import { mkdir, writeFile, access } from "node:fs/promises";
+import { constants as FS } from "node:fs";
+import { join } from "node:path";
+import { dataPaths } from "./paths.js";
+/** Default backend port (§11A.5 决策 D). Runtime uses port+1 (stride-2 §16). */
+export const DEFAULT_PORT = 9001;
+async function exists(path) {
+    try {
+        await access(path, FS.F_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** Write a file only if it does not already exist. Returns true if written. */
+async function writeIfAbsent(path, content) {
+    if (await exists(path))
+        return false;
+    await writeFile(path, content, "utf8");
+    return true;
+}
+/** Default principal agent prompt — minimal, user-editable. */
+const PRINCIPAL_PROMPT = `# Principal Agent (PI)
+
+You are the Principal Investigator — the user-facing orchestrator of the
+BrainPilot multi-agent system. You decompose the user's request, delegate to
+expert agents via \`send_message\`, and synthesize their results into a final
+answer.
+
+Keep the user informed of progress. Be concise and rigorous.
+`;
+const PRINCIPAL_SETTINGS = JSON.stringify({
+    provider: "anthropic",
+    model: "claude-sonnet-4-6",
+    timeoutMs: 120000,
+    maxRetries: 2,
+}, null, 2);
+const PRINCIPAL_MANIFEST = JSON.stringify({
+    role: "principal",
+    parent: null,
+    allowedTools: ["send_message", "create_agent", "destroy_agent", "record_trace"],
+}, null, 2);
+/** session-level default Pi SDK settings template (§11A.2). */
+const TEMPLATE_SETTINGS_EXAMPLE = JSON.stringify({
+    provider: "anthropic",
+    model: "claude-sonnet-4-6",
+    apiKey: "",
+    baseUrl: "",
+}, null, 2);
+/** MCP server config template (§11A.2). */
+const TEMPLATE_MCP_EXAMPLE = JSON.stringify({
+    mcpServers: {},
+}, null, 2);
+/**
+ * Create the launch directory tree under `dataDir`. Idempotent — only writes
+ * files that don't yet exist. Returns the list of newly created files so the
+ * caller can report "scaffolded" vs "already present".
+ */
+export async function scaffold(dataDir, options = {}) {
+    const p = dataPaths(dataDir);
+    const created = [];
+    // ① Directory skeleton.
+    const principalDir = join(p.bpTemplateAgents, "principal");
+    await mkdir(p.dataDir, { recursive: true });
+    await mkdir(principalDir, { recursive: true });
+    await mkdir(p.bp, { recursive: true });
+    await mkdir(p.workspaces, { recursive: true });
+    await mkdir(p.logsDir, { recursive: true });
+    // ② Default bp_template/agents/principal/* (user-editable).
+    const writes = [
+        [join(principalDir, "prompt.md"), PRINCIPAL_PROMPT],
+        [join(principalDir, "settings.json"), PRINCIPAL_SETTINGS],
+        [join(principalDir, "manifest.json"), PRINCIPAL_MANIFEST],
+        // ③ session-level template defaults.
+        [p.bpTemplateSettings, TEMPLATE_SETTINGS_EXAMPLE],
+        [join(p.bpTemplate, "settings.example.json"), TEMPLATE_SETTINGS_EXAMPLE],
+        [p.bpTemplateMcpServers, TEMPLATE_MCP_EXAMPLE],
+        [join(p.bpTemplate, "mcp_servers.example.json"), TEMPLATE_MCP_EXAMPLE],
+        // ④ CLI global config.
+        [
+            p.brainpilotConfig,
+            JSON.stringify({
+                port: options.port ?? DEFAULT_PORT,
+                dataDir: ".",
+                provider: { name: options.provider ?? "anthropic" },
+                logLevel: "info",
+            }, null, 2),
+        ],
+    ];
+    for (const [path, content] of writes) {
+        if (await writeIfAbsent(path, content))
+            created.push(path);
+    }
+    return { paths: p, created };
+}
+/** Whether the data dir already has a `bp_template/` (used by `up` to decide). */
+export async function isScaffolded(dataDir) {
+    return exists(dataPaths(dataDir).bpTemplate);
+}
+//# sourceMappingURL=scaffold.js.map

package/dist/scaffold.js.map

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

package/dist/spawn-backend.d.ts

@@ -0,0 +1,9 @@
+import type { ResolvedUpConfig } from "./commands/up.js";
+/** Resolve `@brainpilot/backend-core/server` to an absolute path. */
+export declare function resolveBackendServerPath(from?: string): string;
+/**
+ * Spawn the backend as a detached child. Returns the child pid. Env injects
+ * BP_DATA_DIR + BP_MODE=single + the resolved ports (§11A.4 step 4).
+ */
+export declare function spawnDetachedBackend(cfg: ResolvedUpConfig): Promise<number>;
+//# sourceMappingURL=spawn-backend.d.ts.map

package/dist/spawn-backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn-backend.d.ts","sourceRoot":"","sources":["../src/spawn-backend.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEzD,qEAAqE;AACrE,wBAAgB,wBAAwB,CAAC,IAAI,GAAE,MAAwB,GAAG,MAAM,CAG/E;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,gBAAgB,GACpB,OAAO,CAAC,MAAM,CAAC,CAyBjB"}

package/dist/spawn-backend.js

@@ -0,0 +1,48 @@
+/**
+ * spawn-backend.ts — default detached spawn used by `up --detach`. Launches the
+ * backend-core server entry as a background process, redirecting stdout/stderr
+ * to `.runtime/logs/backend.log`, and returns its pid (§11A.4 step 7 / §11A.5).
+ *
+ * The backend's own LocalProcessOrchestrator spawns the runtime; we only manage
+ * the backend process here.
+ */
+import { spawn } from "node:child_process";
+import { openSync, mkdirSync } from "node:fs";
+import { createRequire } from "node:module";
+import { dirname } from "node:path";
+import { dataPaths } from "./paths.js";
+/** Resolve `@brainpilot/backend-core/server` to an absolute path. */
+export function resolveBackendServerPath(from = import.meta.url) {
+    const require = createRequire(from);
+    return require.resolve("@brainpilot/backend-core/server");
+}
+/**
+ * Spawn the backend as a detached child. Returns the child pid. Env injects
+ * BP_DATA_DIR + BP_MODE=single + the resolved ports (§11A.4 step 4).
+ */
+export async function spawnDetachedBackend(cfg) {
+    const p = dataPaths(cfg.dataDir);
+    mkdirSync(p.logsDir, { recursive: true });
+    const out = openSync(p.backendLog, "a");
+    const serverPath = resolveBackendServerPath();
+    const child = spawn(process.execPath, [serverPath], {
+        detached: true,
+        stdio: ["ignore", out, out],
+        cwd: dirname(cfg.dataDir),
+        env: {
+            ...process.env,
+            BP_DATA_DIR: cfg.dataDir,
+            BP_MODE: "single",
+            BP_PORT: String(cfg.port),
+            PORT: String(cfg.port),
+            AGENT_RUNTIME_PORT: String(cfg.runtimePort),
+            ...(cfg.webDist ? { BP_WEB_ROOT: cfg.webDist } : {}),
+        },
+    });
+    child.unref();
+    if (child.pid === undefined) {
+        throw new Error("Failed to spawn backend process (no pid).");
+    }
+    return child.pid;
+}
+//# sourceMappingURL=spawn-backend.js.map