@geohar/un-bien 0.9.0 → 0.16.0

package/dist/commands/housekeeping.d.ts

@@ -0,0 +1,34 @@
+/**
+ * `/unbien` housekeeping commands: service install/uninstall, the
+ * agent-network skill deploy, extension-dir/skill-path resolution, and the
+ * `unbien claude` CLI launcher.
+ *
+ * None of these touch index.ts module state, so they take no CommandDeps —
+ * everything they use is imported from pi-independent modules. Carved out
+ * of index.ts (phase 1 of the index.ts carve-up).
+ *
+ * NOTE: this file lives one directory deeper than index.ts used to, so the
+ * import.meta.url-based path math (extension dir, packaged skill, mesh
+ * server) climbs one extra level — behavior is otherwise identical.
+ */
+import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
+/**
+ * `linkCli` controls whether we symlink `un-bien` into `~/.local/bin/`. The
+ * slash-command path passes `true` (user is inside Pi's TUI — they installed
+ * via `pi install npm:un-bien` and need us to expose the CLI for them). The
+ * standalone-CLI path passes `false` because the user is already running our
+ * binary from PATH (they did `npm install -g un-bien`), so re-linking would
+ * point their `un-bien` at the Pi-extension copy and diverge on upgrades.
+ */
+/** Returns true on success, false when install failed (so the standalone CLI
+ *  can exit non-zero — e.g. the Cockpit / CI detect failure by exit code).
+ *  We do NOT process.exit here: this also runs inside the Pi TUI, where exiting
+ *  would kill the session. */
+export declare function _cmdInstall(ctx: Pick<ExtensionContext, "ui">, opts?: {
+    linkCli?: boolean;
+}): boolean;
+export declare function _cmdUninstall(ctx: Pick<ExtensionContext, "ui">, opts?: {
+    linkCli?: boolean;
+}): void;
+export declare function _deployAgentNetworkSkill(): void;
+export declare function _cmdClaudeCli(args: string[]): Promise<void>;

package/dist/commands/housekeeping.js

@@ -0,0 +1,275 @@
+import { installService, uninstallService, linkCliBinaries, unlinkCliBinaries, } from "../daemon/install.js";
+import { defaultAgentName, localConfigExists, saveLocalConfig, } from "../session/local_config.js";
+import { skillsDir } from "../session/global_config.js";
+import { spawnSync } from "node:child_process";
+import { copyFileSync, existsSync, mkdirSync, unlinkSync, writeFileSync, } from "node:fs";
+import { tmpdir } from "node:os";
+import { dirname, join, resolve } from "node:path";
+import { createInterface } from "node:readline";
+import { fileURLToPath } from "node:url";
+// ── Install/uninstall the launcher-daemon service ────────────────────────────
+//
+// Installs the un-bien launcher daemon as a user-level system service (systemd
+// `--user` unit on Linux, launchd LaunchAgent on macOS, Task Scheduler on
+// Windows). Once installed the launcher daemon starts at login + survives
+// reboots. Uninstall is the inverse.
+/**
+ * `linkCli` controls whether we symlink `un-bien` into `~/.local/bin/`. The
+ * slash-command path passes `true` (user is inside Pi's TUI — they installed
+ * via `pi install npm:un-bien` and need us to expose the CLI for them). The
+ * standalone-CLI path passes `false` because the user is already running our
+ * binary from PATH (they did `npm install -g un-bien`), so re-linking would
+ * point their `un-bien` at the Pi-extension copy and diverge on upgrades.
+ */
+/** Returns true on success, false when install failed (so the standalone CLI
+ *  can exit non-zero — e.g. the Cockpit / CI detect failure by exit code).
+ *  We do NOT process.exit here: this also runs inside the Pi TUI, where exiting
+ *  would kill the session. */
+export function _cmdInstall(ctx, opts = {}) {
+    const linkCli = opts.linkCli ?? false;
+    try {
+        const result = installService();
+        const sections = [
+            `[un-bien] Launcher daemon service installed (${result.platform}).`,
+            `  Unit: ${result.unitPath}`,
+            `  Steps:\n${result.log.map((l) => "    " + l).join("\n")}`,
+        ];
+        if (linkCli) {
+            const link = linkCliBinaries();
+            sections.push(`  CLI bins linked into ${link.binDir}:`, link.links.map((l) => `    ${l.name} → ${l.target}`).join("\n"), `  Steps:\n${link.log.map((l) => "    " + l).join("\n")}`);
+            if (!link.onPath) {
+                if (process.platform === "win32") {
+                    sections.push(`  ⚠ ${link.binDir} was just added to your user PATH (it wasn't there yet).`, `    Open a NEW terminal and run \`unbien status\` to verify.`);
+                }
+                else {
+                    sections.push(`  ⚠ ${link.binDir} is not on $PATH yet. Add this line to ~/.zshrc / ~/.bashrc:`, `      export PATH="$HOME/.local/bin:$PATH"`, `    Then open a new terminal and run \`unbien status\` to verify.`);
+                }
+            }
+        }
+        ctx.ui.notify(sections.join("\n"), "info");
+        return true;
+    }
+    catch (err) {
+        ctx.ui.notify(`[un-bien] install failed: ${String(err)}`, "error");
+        return false;
+    }
+}
+export function _cmdUninstall(ctx, opts = {}) {
+    const linkCli = opts.linkCli ?? false;
+    try {
+        const result = uninstallService();
+        const sections = [
+            `[un-bien] Launcher daemon service uninstalled (${result.platform}).`,
+            `  Unit: ${result.unitPath} (${result.removed ? "removed" : "not present"})`,
+            `  Steps:\n${result.log.map((l) => "    " + l).join("\n")}`,
+        ];
+        if (linkCli) {
+            const unlink = unlinkCliBinaries();
+            sections.push(`  CLI bins cleanup (${unlink.binDir}):`, unlink.removed
+                .map((r) => `    ${r.name} (${r.existed ? "removed" : "not present"})`)
+                .join("\n"));
+        }
+        ctx.ui.notify(sections.join("\n"), "info");
+    }
+    catch (err) {
+        ctx.ui.notify(`[un-bien] uninstall failed: ${String(err)}`, "error");
+    }
+}
+// ── Agent-network commands (plano 19) ─────────────────────────────────────────
+function _resolveExtensionDir() {
+    // dist/commands/housekeeping.js → dist/commands; skills sit at
+    // <extensionRoot>/skills/. When we run from src/ via tsx (dev), this file
+    // is in src/commands/ and skills/ is two levels up. We detect by checking
+    // both locations.
+    const here = fileURLToPath(import.meta.url);
+    // dist/commands/housekeeping.js or src/commands/housekeeping.ts → parent =
+    // <dist or src>/commands; sibling = ../../skills (dist) / ../skills (src)
+    const parent = here.replace(/\/[^/]+$/, "");
+    const candidateA = join(parent, "..", "..", "skills"); // dist/commands → ../../skills
+    const candidateB = join(parent, "..", "skills"); // src/commands → ../skills
+    if (existsSync(candidateA))
+        return parent.replace(/\/(dist\/)?commands$/, "");
+    if (existsSync(candidateB))
+        return parent.replace(/\/commands$/, "");
+    return parent.replace(/\/commands$/, "");
+}
+export function _deployAgentNetworkSkill() {
+    // Pi SDK spec (core/skills.js): every skill must live at
+    //   <skillsRoot>/<skill-name>/SKILL.md
+    // The skill `name:` frontmatter must equal the parent directory name. We
+    // ship the source pre-arranged that way so deploy is a straight copy into
+    // `<state root>/skills/agent-network/SKILL.md`.
+    const root = _resolveExtensionDir();
+    const src1 = join(root, "skills", "agent-network", "SKILL.md");
+    const src2 = join(root, "..", "skills", "agent-network", "SKILL.md");
+    const src = existsSync(src1) ? src1 : existsSync(src2) ? src2 : null;
+    if (!src)
+        return;
+    const dstDir = join(skillsDir(), "agent-network");
+    const dst = join(dstDir, "SKILL.md");
+    try {
+        mkdirSync(dstDir, { recursive: true });
+        copyFileSync(src, dst);
+        // Cleanup legacy flat-layout deploy at `<state root>/skills/agent-network.md`
+        // (fails the Pi SDK's name-vs-parent-dir validation).
+        const legacy = join(skillsDir(), "agent-network.md");
+        if (existsSync(legacy)) {
+            try {
+                unlinkSync(legacy);
+            }
+            catch {
+                /* ignored */
+            }
+        }
+    }
+    catch {
+        /* best-effort */
+    }
+}
+// ── `unbien claude` — launch Claude Code connected to the mesh ─────────────
+/**
+ * Resolve the packaged agent-network skill path
+ * (`<pkgRoot>/skills/agent-network/SKILL.md`). Single source of truth shared
+ * by both runtimes: Pi discovers it via `resources_discover`, and the Claude
+ * launcher injects it as a system prompt (see `_cmdClaudeCli`). Returns null
+ * if the file is missing (e.g. running before `pnpm build`).
+ */
+function _agentNetworkSkillPath() {
+    const here = fileURLToPath(import.meta.url); // dist/commands/housekeeping.js (or src/ via tsx)
+    const pkgRoot = dirname(dirname(dirname(here))); // package root (dist/commands → ../..; src/commands → ../..)
+    const skill = join(pkgRoot, "skills", "agent-network", "SKILL.md");
+    return existsSync(skill) ? skill : null;
+}
+export async function _cmdClaudeCli(args) {
+    // Contract: `unbien claude [cwd] [claude-flags...]`. The optional cwd is
+    // ONLY the leading positional (first token, not a flag); everything after it
+    // is forwarded verbatim to the `claude` binary (e.g. `--resume`, `-c`,
+    // `-p "prompt"`). Restricting cwd to the leading token avoids mistaking a
+    // flag's value (e.g. the id in `--resume <id>`) for the cwd.
+    const hasCwdArg = args.length > 0 && !args[0].startsWith("-");
+    const targetCwd = hasCwdArg ? args[0] : process.cwd();
+    const passthroughArgs = hasCwdArg ? args.slice(1) : args;
+    // Wizard when no local config exists
+    if (!localConfigExists(targetCwd)) {
+        const suggested = defaultAgentName(targetCwd);
+        process.stdout.write(`\n[un-bien] No config found for ${targetCwd}\n`);
+        process.stdout.write("Let's set up this agent.\n\n");
+        const rl = createInterface({
+            input: process.stdin,
+            output: process.stdout,
+        });
+        const agentName = await new Promise((res) => rl.question(`Agent name [${suggested}]: `, (ans) => {
+            rl.close();
+            res(ans.trim() || suggested);
+        }));
+        saveLocalConfig(targetCwd, {
+            agent_name: agentName,
+            auto_start_relay: true,
+        });
+        process.stdout.write(`[un-bien] Config saved: agent="${agentName}"\n\n`);
+    }
+    // Resolve mesh server script path (dist/mcp/mesh_server.js)
+    const here = fileURLToPath(import.meta.url);
+    const distRoot = dirname(here); // dist/commands → mesh server at ../mcp/
+    const meshServerPath = resolve(distRoot, "..", "mcp/mesh_server.js");
+    if (!existsSync(meshServerPath)) {
+        console.log(`[un-bien] mesh server not found at ${meshServerPath}. Run pnpm build first.`);
+        process.exit(1);
+    }
+    const absCwd = resolve(targetCwd);
+    const SERVER_NAME = "un-bien-mesh";
+    // The mesh MCP must be visible ONLY inside a `unbien claude` session — a
+    // plain `claude` in the same repo must NOT inherit it (otherwise every
+    // ordinary session silently joins the mesh as a stray agent).
+    //
+    // Older builds registered the server with `claude mcp add -s local`. That
+    // scope lives in `~/.claude.json` keyed by the **git repo root** and is
+    // inherited by EVERY claude session under that root — which is exactly the
+    // leak we're closing. So we no longer write any persistent scope; we load
+    // the server through an ephemeral `--mcp-config <tmpfile>` passed on the
+    // launch command line (see below). That config is session-only: it is never
+    // recorded in any scope `claude mcp list` enumerates, so a normal `claude`
+    // sees nothing.
+    //
+    // Migration: best-effort scrub of the stale `-s local` entry that prior
+    // versions left behind (and that is the source of the inherited-mesh bug).
+    // Idempotent — a no-op (non-zero, ignored) when the entry is already gone.
+    spawnSync("claude", ["mcp", "remove", SERVER_NAME, "-s", "local"], {
+        cwd: absCwd,
+        stdio: "ignore",
+        shell: false,
+    });
+    // Ephemeral MCP config consumed by `--mcp-config` below. We do NOT bake a
+    // `cwd` into it: the server resolves its folder from its own `process.cwd()`,
+    // which Claude sets to the directory the session was launched in (verified
+    // empirically — NOT the git root, NOT CLAUDE_PROJECT_DIR). We spawn claude
+    // with `cwd: absCwd`, the MCP child inherits it, so the server self-identifies
+    // as the right agent without leaking that path to any other session.
+    // Unique per pid so concurrent `unbien claude` launches don't collide.
+    const mcpConfigPath = join(tmpdir(), `un-bien-mesh-mcp-${process.pid}.json`);
+    writeFileSync(mcpConfigPath, JSON.stringify({
+        mcpServers: {
+            [SERVER_NAME]: { command: process.execPath, args: [meshServerPath] },
+        },
+    }));
+    // Inject the agent-network protocol as a system prompt instead of deploying a
+    // skill file into ~/.claude. Anyone running `unbien claude` is here to use
+    // the mesh, so load the protocol unconditionally — no lazy skill gating, no
+    // global skills-dir pollution, and the packaged file is the single source of
+    // truth shared with the Pi runtime. Skipped only if the file is missing.
+    const skillPath = _agentNetworkSkillPath();
+    // Launch flags:
+    //   --mcp-config <tmpfile>                       — load the mesh server for
+    //       THIS session only (never a persistent scope). We intentionally omit
+    //       `--strict-mcp-config` so the user's own persistent MCP servers stay
+    //       available alongside the mesh.
+    //   --dangerously-load-development-channels TAG  — enable claude/channel push
+    //       for our local (non-allowlisted) server, so incoming mesh messages
+    //       wake Claude instead of waiting for a get_messages poll. Entries must
+    //       be tagged: `server:<name>` for a manually configured MCP server
+    //       (`plugin:<name>@<marketplace>` is the plugin form). Shows a one-time
+    //       confirmation dialog at startup. Works against the `--mcp-config`
+    //       server in current Claude Code; if a build ever fails to match it, the
+    //       per-turn `get_messages` poll (mandated by the mesh protocol) still
+    //       delivers — we lose the wake, not the messages.
+    //   --dangerously-skip-permissions               — auto-approve tool calls
+    //   --append-system-prompt-file=<skill>           — load the mesh protocol
+    // `--append-system-prompt-file` uses the glued `--flag=value` form (a SINGLE
+    // argv token) on purpose: tools that restore a session by capturing and
+    // replaying the live process's argv (e.g. cmux) drop the TRAILING token,
+    // which here was the skill path — leaving a dangling `--append-system-prompt-file`
+    // → `claude` aborts with "argument missing" and the session never comes back.
+    // As one token, the worst case is the whole flag being dropped: claude still
+    // starts (just without the injected protocol), which is recoverable instead
+    // of fatal. (The other flags stay separate pairs — never last, so unaffected,
+    // and we don't risk a parser that may not accept `=`.)
+    // Any extra args the user passed (e.g. `--resume`, `-c`) are appended last so
+    // they reach the claude binary; ours come first as sensible defaults.
+    try {
+        spawnSync("claude", [
+            "--mcp-config",
+            mcpConfigPath,
+            "--dangerously-load-development-channels",
+            `server:${SERVER_NAME}`,
+            "--dangerously-skip-permissions",
+            ...(skillPath ? [`--append-system-prompt-file=${skillPath}`] : []),
+            ...passthroughArgs,
+        ], {
+            cwd: absCwd,
+            stdio: "inherit",
+            shell: false,
+        });
+    }
+    finally {
+        // Session over — drop the ephemeral config so it never lingers as a stray
+        // file. spawnSync blocks until claude exits, so claude has long since read
+        // it. Best-effort: ignore if already gone.
+        try {
+            unlinkSync(mcpConfigPath);
+        }
+        catch {
+            /* already removed */
+        }
+    }
+}
+//# sourceMappingURL=housekeeping.js.map

package/dist/commands/housekeeping.js.map

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

package/dist/commands/info.d.ts

@@ -0,0 +1,43 @@
+/**
+ * `/unbien` info commands: status, peers, devices/list, config, identity.
+ *
+ * Read-only views over the composition root's state — everything they need
+ * from index.ts's module scope comes through `CommandDeps` (see deps.ts).
+ * Carved out of index.ts (phase 1 of the index.ts carve-up).
+ */
+import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
+import type { CommandDeps } from "./deps.js";
+/**
+ * `/unbien status` — full state snapshot. Two lines: local mesh + relay.
+ *
+ * Always callable; safe when nothing is up (renders the off variants).
+ * Reuses the same icons as the footer so terminal + status output stay
+ * visually consistent.
+ */
+export declare function _cmdStatus(deps: CommandDeps, ctx: Pick<ExtensionContext, "ui">): void;
+/**
+ * Plan/25 Wave D: `/unbien peers`.
+ *
+ * Queries the local broker for the aggregated peer inventory (`list_peers`
+ * returns locals + cross-PC entries prefixed with `<pc_label>:`). Formats
+ * the result grouped by source so users can see at a glance who's on
+ * their machine vs. on a paired sibling Pi.
+ */
+export declare function _cmdPeers(deps: CommandDeps, ctx: Pick<ExtensionContext, "ui">): Promise<void>;
+export declare function _cmdList(deps: CommandDeps, ctx: Pick<ExtensionContext, "ui">): Promise<void>;
+/**
+ * `/unbien config` — print the effective relay URL and where it came from.
+ *
+ * Documented in the README ("Verify the active URL and its source") and in
+ * CLAUDE.md, but like the `relay` family (issue #119) it had no handler and
+ * fell through to the status panel, which shows the URL but not the source —
+ * so `env` vs `config` vs `default` was unverifiable without a restart.
+ */
+export declare function _cmdConfig(deps: CommandDeps, ctx: Pick<ExtensionContext, "ui">): void;
+/**
+ * `/unbien identity` — report NON-SECRET identity state (active EPK, backend,
+ * resolved source). The private seed is NEVER shown: command output is
+ * LLM-visible, so extraction stays a manual `cat`/keychain op. Read-only
+ * (never mints).
+ */
+export declare function _cmdIdentity(ctx: Pick<ExtensionContext, "ui">): Promise<void>;

package/dist/commands/info.js

@@ -0,0 +1,127 @@
+import { resolveRelayUrl } from "../config.js";
+import { describeIdentity, listPeers } from "../pairing/storage.js";
+import { _inspectPeerRecord } from "../pairing/peer_trust.js";
+import { formatPeerInventory } from "../session/peer_inventory.js";
+/**
+ * `/unbien status` — full state snapshot. Two lines: local mesh + relay.
+ *
+ * Always callable; safe when nothing is up (renders the off variants).
+ * Reuses the same icons as the footer so terminal + status output stay
+ * visually consistent.
+ */
+export function _cmdStatus(deps, ctx) {
+    const relayUrl = deps.relayUrl ?? resolveRelayUrl().url ?? "not configured";
+    // Mesh line
+    let meshLine;
+    if (deps.meshNode) {
+        const name = deps.meshNode.name();
+        meshLine = `🟢 Local mesh: connected as "${name}" (${deps.sessionPeerCount} peer${deps.sessionPeerCount === 1 ? "" : "s"})`;
+    }
+    else {
+        meshLine = "⚪ Local mesh: not connected";
+    }
+    // Relay line — paired state is derived from deps.activePeers.size now.
+    let relayLine;
+    if (deps.state === "idle") {
+        relayLine = `⚪ Relay: off (${relayUrl}) — run /unbien to start`;
+    }
+    else if (deps.activePeers.size > 0) {
+        const count = deps.activePeers.size;
+        const shortids = [...deps.activePeers.keys()]
+            .map((peerId) => peerId.slice(0, 8))
+            .join(", ");
+        relayLine = `🟢 Relay: ${count} owner${count === 1 ? "" : "s"} online (${shortids}) (${relayUrl})`;
+    }
+    else {
+        relayLine = deps.hasGlobalPairings
+            ? `🟢 Relay: on, waiting for an app to connect (${relayUrl})`
+            : `🟡 Relay: on, waiting for first pairing (${relayUrl})`;
+    }
+    ctx.ui.notify(`[un-bien]\n  ${meshLine}\n  ${relayLine}`, "info");
+}
+/**
+ * Plan/25 Wave D: `/unbien peers`.
+ *
+ * Queries the local broker for the aggregated peer inventory (`list_peers`
+ * returns locals + cross-PC entries prefixed with `<pc_label>:`). Formats
+ * the result grouped by source so users can see at a glance who's on
+ * their machine vs. on a paired sibling Pi.
+ */
+export async function _cmdPeers(deps, ctx) {
+    if (!deps.meshNode) {
+        ctx.ui.notify("[un-bien] Not on the local mesh. Run /unbien to join.", "warning");
+        return;
+    }
+    let peers;
+    try {
+        const reply = await deps.meshNode.request("broker", { type: "list_peers" }, 2000);
+        peers = reply.body?.peers ?? [];
+    }
+    catch (err) {
+        ctx.ui.notify(`[un-bien] peers list failed: ${String(err)}`, "error");
+        return;
+    }
+    // Exclude self from the printed list — `list_peers` returns every peer
+    // registered with the broker including the caller, which is noise here.
+    const selfName = deps.meshNode.name();
+    ctx.ui.notify(`[un-bien] peers:\n${formatPeerInventory(peers, selfName)}`, "info");
+}
+export async function _cmdList(deps, ctx) {
+    const peers = await listPeers();
+    if (peers.length === 0) {
+        ctx.ui.notify("[un-bien] No paired devices.", "info");
+        return;
+    }
+    // Multi-channel (W2D): each peer is either `online` (channel attached
+    // right now) or `offline` (in peers.json but not connected). Replaces
+    // the singleton " (active)" marker that only ever marked one peer.
+    const lines = peers
+        .flatMap((record) => {
+        const inspected = _inspectPeerRecord(record);
+        if (!inspected)
+            return [];
+        const tag = inspected.runtimeKey !== null &&
+            deps.activePeers.has(inspected.runtimeKey)
+            ? " 🟢 online"
+            : " ⚪ offline";
+        return `• ${inspected.rawHandle.slice(0, 8)} — ${inspected.record.name}${tag}`;
+    })
+        .join("\n");
+    ctx.ui.notify(`[un-bien] Paired devices:\n${lines}`, "info");
+}
+/**
+ * `/unbien config` — print the effective relay URL and where it came from.
+ *
+ * Documented in the README ("Verify the active URL and its source") and in
+ * CLAUDE.md, but like the `relay` family (issue #119) it had no handler and
+ * fell through to the status panel, which shows the URL but not the source —
+ * so `env` vs `config` vs `default` was unverifiable without a restart.
+ */
+export function _cmdConfig(deps, ctx) {
+    const { url, source } = resolveRelayUrl();
+    const origin = source === "env"
+        ? "UNBIEN_RELAY environment variable"
+        : source === "config"
+            ? "extensions/un-bien.json (set via /unbien set-relay)"
+            : "not set — run /unbien set-relay <url> or set UNBIEN_RELAY";
+    const live = deps.relayUrl && deps.relayUrl !== url
+        ? `\n  ⚠ Live connection still on ${deps.relayUrl} — run /unbien relay stop then /unbien relay start to apply.`
+        : "";
+    ctx.ui.notify(`[un-bien]\n  Relay URL: ${url ?? "(none)"}\n  Source: ${source} — ${origin}${live}`, "info");
+}
+/**
+ * `/unbien identity` — report NON-SECRET identity state (active EPK, backend,
+ * resolved source). The private seed is NEVER shown: command output is
+ * LLM-visible, so extraction stays a manual `cat`/keychain op. Read-only
+ * (never mints).
+ */
+export async function _cmdIdentity(ctx) {
+    const info = await describeIdentity();
+    const backendLine = info.backend === "file" ? `file (${info.filePath})` : "keychain";
+    const epkLine = info.epk ?? "(none yet — minted on first use)";
+    const sourceLine = info.detail
+        ? `${info.source} — ${info.detail}`
+        : info.source;
+    ctx.ui.notify(`[un-bien] identity\n  Backend: ${backendLine}\n  EPK (public): ${epkLine}\n  Source: ${sourceLine}`, info.source === "error" ? "error" : "info");
+}
+//# sourceMappingURL=info.js.map

package/dist/commands/info.js.map

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

package/dist/commands/lifecycle.d.ts

@@ -0,0 +1,45 @@
+/**
+ * `/unbien` lifecycle commands: root (connect-or-setup), rootInner, setup
+ * wizard, start (relay), stop (teardown), join (local UDS mesh).
+ *
+ * The heaviest handler lives here: `_cmdStart` touches relay startup, the
+ * auto-listener, SelfRevoke topology production, and the first-run model/
+ * thinking seeding. Everything it needs from index.ts's module scope comes
+ * through `CommandDeps` (see deps.ts). Carved out of index.ts (phase 1 of
+ * the index.ts carve-up).
+ */
+import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
+import type { CommandDeps } from "./deps.js";
+export type RootRestartAuthority = Readonly<{
+    rootLifecycleGeneration: number;
+}>;
+/**
+ * Root handler for `/unbien`. On first run (no local config) drops into
+ * the wizard; on subsequent runs auto-joins the local mesh + starts the
+ * relay (if opted in during setup), then prints the status.
+ *
+ * `/unbien` is intentionally the only command users need day-to-day:
+ * idempotent connect + status display.
+ */
+export declare function _cmdRoot(deps: CommandDeps, ctx: Pick<ExtensionContext, "ui" | "cwd">, restartAuthority?: RootRestartAuthority): Promise<void>;
+export declare function _cmdRootInner(deps: CommandDeps, ctx: Pick<ExtensionContext, "ui" | "cwd">, rootLifecycleGeneration: number): Promise<void>;
+/**
+ * `/unbien setup` — re-run the wizard. Defaults pre-fill from the
+ * existing config so it doubles as an "edit" flow.
+ */
+export declare function _cmdSetup(ctx: Pick<ExtensionContext, "ui" | "cwd">): Promise<void>;
+export declare function _cmdStart(deps: CommandDeps, ctx: Pick<ExtensionContext, "ui" | "cwd">): Promise<void>;
+/**
+ * `/unbien stop` — full teardown. Leaves the local UDS mesh AND closes
+ * the relay. Safe when one or both are already off. To resume, run
+ * `/unbien` again.
+ */
+export declare function _cmdStop(deps: CommandDeps, ctx: Pick<ExtensionContext, "ui">): Promise<void>;
+/**
+ * Joins the fixed local UDS mesh ("local" session — see LOCAL_SESSION_NAME).
+ * Called by `_cmdRoot` on first run and on subsequent runs when the relay
+ * is up and the user hasn't explicitly stopped. The session name is no
+ * longer user-configurable: every Pi on the same machine joins the same
+ * broker.
+ */
+export declare function _cmdJoin(deps: CommandDeps, ctx: Pick<ExtensionContext, "ui" | "cwd">): Promise<void>;