@creativeintelligence/abbie 0.1.3 → 0.1.5

package/src/cli/commands/bridge.ts

@@ -1,233 +0,0 @@
-/**
- * abbie bridge — start the Pi bridge daemon.
- *
- * Connects this machine to Abbie by polling Convex for pending sessions
- * and spawning Pi RPC child processes to handle them.
- *
- * Requires:
- *   - `pi` CLI installed and in PATH (npm i -g @mariozechner/pi-coding-agent)
- *   - Authenticated via `abbie login`
- *
- * The bridge auto-discovers CONVEX_URL and BRIDGE_SECRET from:
- *   1. ~/.abbie/config.json (set by `abbie login`)
- *   2. Environment variables (CONVEX_URL, ABBIE_BRIDGE_SECRET)
- *   3. Local .env files (when running from a project directory)
- */
-
-import { existsSync, readFileSync } from "node:fs";
-import { homedir } from "node:os";
-import { join, resolve, dirname } from "node:path";
-import { fileURLToPath } from "node:url";
-import { spawnSync, type ChildProcess, spawn } from "node:child_process";
-import { Flags } from "@oclif/core";
-import { BaseCommand } from "../base-command.js";
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
-
-export default class BridgeCommand extends BaseCommand {
-  static override summary = "Start the Pi bridge daemon";
-
-  static override description = `Connects your machine to Abbie by running a bridge daemon that:
-
-• Polls Convex for pending sessions created from the web UI
-• Spawns Pi RPC processes to handle each session locally
-• Streams events (messages, tool calls, file changes) back to Convex
-• Syncs local skills and available models
-
-The bridge stays running until you stop it (Ctrl+C).
-
-Prerequisites:
-  1. pi CLI installed: npm i -g @mariozechner/pi-coding-agent
-  2. Authenticated: abbie login`;
-
-  static override examples = [
-    "$ abbie bridge",
-    "$ abbie bridge --env-file .env.prod",
-    "$ abbie bridge --model claude-sonnet-4.6",
-    "$ abbie bridge --provider anthropic",
-  ];
-
-  static override flags = {
-    ...BaseCommand.baseFlags,
-    "env-file": Flags.string({
-      description: "Extra .env file to load (overrides all other env sources)",
-    }),
-    model: Flags.string({
-      description: "Default model for new sessions (e.g. claude-sonnet-4.6)",
-    }),
-    provider: Flags.string({
-      description: "Default provider (e.g. anthropic, github-copilot, openai)",
-    }),
-    "pi-path": Flags.string({
-      description: "Path to pi binary (default: auto-detect from PATH)",
-    }),
-    "poll-interval": Flags.integer({
-      description: "Poll interval in ms (default: 2000)",
-      default: 2000,
-    }),
-  };
-
-  protected async execute(): Promise<unknown> {
-    const { flags } = await this.parse(BridgeCommand);
-    this.parsedFlags = flags;
-
-    // Step 1: Verify pi is installed
-    const piPath = flags["pi-path"] ?? "pi";
-    const piCheck = spawnSync(piPath, ["--version"], { encoding: "utf8" });
-    if (piCheck.error || piCheck.status !== 0) {
-      this.error(
-        `pi CLI not found at "${piPath}". Install it:\n\n  npm install -g @mariozechner/pi-coding-agent\n`,
-      );
-    }
-    const piVersion = piCheck.stdout?.trim() || "unknown";
-
-    // Step 2: Resolve config
-    const config = this.loadBridgeConfig(flags["env-file"]);
-    if (!config.convexUrl) {
-      this.error(
-        "Convex URL not configured. Run `abbie login` first, or set CONVEX_URL.",
-      );
-    }
-    if (!config.bridgeSecret) {
-      this.error(
-        "Bridge secret not configured. Set ABBIE_BRIDGE_SECRET in your environment or ~/.abbie/config.json.",
-      );
-    }
-
-    // Step 3: Build env for bridge subprocess
-    const bridgeScript = this.findBridgeScript();
-    if (!bridgeScript) {
-      this.error(
-        "Bridge script not found. This is a bug — please report it.",
-      );
-    }
-
-    this.log("");
-    this.log("  abbie bridge");
-    this.log(`  pi ${piVersion} · ${config.convexSiteUrl}`);
-    this.log("");
-
-    // Step 4: Spawn bridge as a child process with the resolved env
-    const childEnv: Record<string, string> = {
-      ...process.env as Record<string, string>,
-      NEXT_PUBLIC_CONVEX_URL: config.convexUrl,
-      ABBIE_BRIDGE_SECRET: config.bridgeSecret,
-    };
-    if (flags.model) childEnv.PI_MODEL = flags.model;
-    if (flags.provider) childEnv.PI_PROVIDER = flags.provider;
-    if (flags["pi-path"]) childEnv.PI_CLI_PATH = flags["pi-path"];
-
-    const args = ["--no-warnings", "--experimental-strip-types", bridgeScript];
-    if (flags["env-file"]) {
-      args.push("--env-file", resolve(flags["env-file"]));
-    }
-
-    const child = spawn("node", args, {
-      env: childEnv,
-      stdio: "inherit",
-      cwd: process.cwd(),
-    });
-
-    // Forward signals
-    const forward = (signal: NodeJS.Signals) => {
-      child.kill(signal);
-    };
-    process.on("SIGINT", () => forward("SIGINT"));
-    process.on("SIGTERM", () => forward("SIGTERM"));
-
-    return new Promise((resolve) => {
-      child.on("exit", (code) => {
-        resolve({ exitCode: code ?? 0 });
-      });
-    });
-  }
-
-  private loadBridgeConfig(envFile?: string): {
-    convexUrl: string;
-    bridgeSecret: string;
-    convexSiteUrl: string;
-  } {
-    // Priority: env-file > env vars > ~/.abbie/config.json > local .env files
-    const sources: Record<string, string>[] = [];
-
-    // Local .env files (lowest priority)
-    for (const name of [".env", ".env.local", "packages/backend/.env", "packages/backend/.env.local"]) {
-      const p = join(process.cwd(), name);
-      if (existsSync(p)) sources.push(this.parseDotEnv(p));
-    }
-
-    // ~/.abbie/config.json
-    const configPath = join(homedir(), ".abbie", "config.json");
-    if (existsSync(configPath)) {
-      try {
-        const cfg = JSON.parse(readFileSync(configPath, "utf8"));
-        if (cfg.convexUrl) sources.push({ CONVEX_URL: cfg.convexUrl, NEXT_PUBLIC_CONVEX_URL: cfg.convexUrl });
-        if (cfg.bridgeSecret) sources.push({ ABBIE_BRIDGE_SECRET: cfg.bridgeSecret });
-      } catch { /* ignore */ }
-    }
-
-    // Process env
-    sources.push(process.env as Record<string, string>);
-
-    // Extra env file (highest priority)
-    if (envFile) {
-      const p = resolve(envFile);
-      if (existsSync(p)) sources.push(this.parseDotEnv(p));
-    }
-
-    const merged: Record<string, string> = {};
-    for (const src of sources) {
-      for (const [k, v] of Object.entries(src)) {
-        if (v) merged[k] = v;
-      }
-    }
-
-    const convexUrl = merged.NEXT_PUBLIC_CONVEX_URL || merged.CONVEX_URL || "";
-    const bridgeSecret = merged.ABBIE_BRIDGE_SECRET || "";
-    const convexSiteUrl = merged.CONVEX_SITE_URL || convexUrl.replace(".convex.cloud", ".convex.site");
-
-    return { convexUrl, bridgeSecret, convexSiteUrl };
-  }
-
-  private findBridgeScript(): string | null {
-    // Look for the bridge script relative to the CLI package
-    const candidates = [
-      // When running from the monorepo
-      join(process.cwd(), "scripts", "pi-bridge.ts"),
-      // When installed globally — bridge script bundled with CLI
-      join(__dirname, "..", "..", "..", "scripts", "pi-bridge.ts"),
-      join(__dirname, "..", "..", "..", "scripts", "pi-bridge.js"),
-      // Fallback: look in the abbie-xyz repo structure
-      join(homedir(), "Developer", "apps", "abbie", "abbie-xyz", "scripts", "pi-bridge.ts"),
-    ];
-
-    for (const candidate of candidates) {
-      if (existsSync(candidate)) return candidate;
-    }
-    return null;
-  }
-
-  private parseDotEnv(filePath: string): Record<string, string> {
-    try {
-      const content = readFileSync(filePath, "utf8");
-      const env: Record<string, string> = {};
-      for (const rawLine of content.split("\n")) {
-        const line = rawLine.trim();
-        if (!line || line.startsWith("#")) continue;
-        const idx = line.indexOf("=");
-        if (idx <= 0) continue;
-        const key = line.slice(0, idx).trim();
-        let value = line.slice(idx + 1).trim();
-        if ((value.startsWith('"') && value.endsWith('"')) ||
-            (value.startsWith("'") && value.endsWith("'"))) {
-          value = value.slice(1, -1);
-        }
-        if (key) env[key] = value;
-      }
-      return env;
-    } catch {
-      return {};
-    }
-  }
-}

package/src/cli/commands/context/inject.ts

@@ -1,103 +0,0 @@
-import { getHttpClient, api, type ContextBusEntryType } from "@creativeintelligence/sdk/convex";
-import { Flags } from "@oclif/core";
-import { BaseCommand } from "../../base-command.js";
-
-export default class ContextInject extends BaseCommand {
-  static override description =
-    "Output prior artifacts as context for re-injection into a new session";
-  static override hidden = false;
-
-  static override examples = [
-    "<%= config.bin %> context inject --trace-id tr_abc | abbie session start -a copilot -p arbor",
-    "<%= config.bin %> context inject --trace-id tr_abc --type artifact --format json",
-    "<%= config.bin %> context inject --session arbor-20260128-abc1",
-  ];
-
-  static override flags = {
-    ...BaseCommand.baseFlags,
-    "trace-id": Flags.string({
-      description: "Trace ID to read artifacts from",
-      env: "AGENTS_TRACE_ID",
-    }),
-    session: Flags.string({
-      description: "Session ID to read artifacts from",
-    }),
-    type: Flags.string({
-      description: "Filter by entry type",
-      options: [
-        "decision",
-        "artifact",
-        "constraint",
-        "progress",
-        "directive",
-        "file_activity",
-        "annotation",
-      ],
-      default: "artifact",
-    }),
-    limit: Flags.integer({
-      description: "Max entries to include",
-      default: 20,
-    }),
-  };
-
-  protected async execute(): Promise<unknown> {
-    const { flags } = await this.parse(ContextInject);
-    this.parsedFlags = flags;
-
-    if (!flags["trace-id"] && !flags.session) {
-      this.error("Either --trace-id or --session is required");
-    }
-
-    const client = getHttpClient();
-    const entries = flags.session
-      ? await client.query(api.contextBus.readBySession, {
-          sessionId: flags.session,
-          type: flags.type as ContextBusEntryType | undefined,
-          limit: flags.limit,
-        })
-      : await client.query(api.contextBus.read, {
-          traceId: flags["trace-id"]!,
-          type: flags.type as ContextBusEntryType | undefined,
-          limit: flags.limit,
-        });
-
-    if (entries.length === 0) {
-      this.logInfo("No entries found to inject");
-      return { count: 0, entries: [] };
-    }
-
-    // JSON mode: output raw entries
-    if (flags.json || flags.format === "json") {
-      return { count: entries.length, entries };
-    }
-
-    // Default: XML-structured context for agent consumption
-    const traceId = flags["trace-id"] || entries[0]?.traceId || "unknown";
-    const lines: string[] = [];
-    lines.push(`<prior_artifacts trace_id="${traceId}" count="${entries.length}">`);
-
-    for (const entry of entries) {
-      const session = entry.sessionId ? ` session="${entry.sessionId}"` : "";
-      const agent = entry.metadata?.agent ? ` agent="${entry.metadata.agent}"` : "";
-      const title = entry.title ? ` title="${escapeXml(entry.title)}"` : "";
-      lines.push(`  <${entry.type}${session}${agent}${title}>`);
-      lines.push(`    ${entry.content}`);
-      lines.push(`  </${entry.type}>`);
-    }
-
-    lines.push("</prior_artifacts>");
-
-    const output = lines.join("\n");
-    this.log(output);
-    return { count: entries.length, output };
-  }
-}
-
-function escapeXml(s: string): string {
-  return s
-    .replace(/&/g, "&amp;")
-    .replace(/"/g, "&quot;")
-    .replace(/</g, "&lt;")
-    .replace(/>/g, "&gt;");
-}

package/src/cli/commands/context/list.ts

@@ -1,112 +0,0 @@
-import { getHttpClient, api, type ContextBusEntryType } from "@creativeintelligence/sdk/convex";
-import { Flags } from "@oclif/core";
-import { BaseCommand } from "../../base-command.js";
-
-export default class ContextList extends BaseCommand {
-  static override description = "List context bus entries by project, session, or type";
-  static override hidden = false;
-
-  static override examples = [
-    "<%= config.bin %> context list --project arbor --type artifact",
-    "<%= config.bin %> context list --project sine --since 24h --limit 20",
-    "<%= config.bin %> context list --session arbor-20260128-abc1 --json",
-  ];
-
-  static override flags = {
-    ...BaseCommand.baseFlags,
-    project: Flags.string({
-      char: "p",
-      description: "Filter by project name",
-    }),
-    session: Flags.string({
-      description: "Filter by session ID",
-    }),
-    type: Flags.string({
-      description: "Filter by entry type",
-      options: [
-        "decision",
-        "artifact",
-        "constraint",
-        "progress",
-        "directive",
-        "file_activity",
-        "annotation",
-      ],
-    }),
-    since: Flags.string({
-      description: "Only entries after this time (ms timestamp or relative: 1h, 24h, 7d)",
-    }),
-    limit: Flags.integer({
-      description: "Max entries to return",
-      default: 50,
-    }),
-  };
-
-  protected async execute(): Promise<unknown> {
-    const { flags } = await this.parse(ContextList);
-    this.parsedFlags = flags;
-
-    if (!flags.project && !flags.session) {
-      this.error("Either --project or --session is required");
-    }
-
-    const sinceMs = flags.since ? parseSince(flags.since) : undefined;
-
-    const client = getHttpClient();
-    const entries = await client.query(api.contextBus.search, {
-      project: flags.project,
-      sessionId: flags.session,
-      type: flags.type as ContextBusEntryType | undefined,
-      since: sinceMs,
-      limit: flags.limit,
-    });
-
-    if (flags.json || flags.format === "json") {
-      return entries;
-    }
-
-    if (this.ndjsonEnabled()) {
-      this.outputNdjson(entries);
-      return entries;
-    }
-
-    if (entries.length === 0) {
-      this.logInfo("No context bus entries found");
-      return [];
-    }
-
-    for (const entry of entries) {
-      const time = new Date(entry.timestamp).toISOString().slice(11, 19);
-      const session = entry.sessionId ? ` [${entry.sessionId}]` : "";
-      const project = entry.project ? ` (${entry.project})` : "";
-      const title = entry.title ? ` ${entry.title}:` : "";
-      this.log(
-        `${time} [${entry.type}]${project}${session}${title} ${entry.content.slice(0, 200)}`,
-      );
-    }
-
-    return entries;
-  }
-}
-
-/** Parse relative time strings (1h, 24h, 7d) or absolute ms timestamps. */
-function parseSince(value: string): number {
-  // Absolute timestamp
-  const num = Number(value);
-  if (!Number.isNaN(num) && num > 1e12) return num;
-
-  // Relative time
-  const match = value.match(/^(\d+)(m|h|d)$/);
-  if (match) {
-    const amount = parseInt(match[1], 10);
-    const unit = match[2];
-    const multipliers: Record<string, number> = { m: 60_000, h: 3_600_000, d: 86_400_000 };
-    return Date.now() - amount * (multipliers[unit] || 3_600_000);
-  }
-
-  // Fallback: treat as hours
-  const hours = parseInt(value, 10);
-  if (!Number.isNaN(hours)) return Date.now() - hours * 3_600_000;
-
-  return 0;
-}

package/src/cli/commands/context/publish.ts

@@ -1,83 +0,0 @@
-import { api, type ContextBusEntryType, getHttpClient } from "@creativeintelligence/sdk/convex";
-import { Args, Flags } from "@oclif/core";
-import { BaseCommand } from "../../base-command.js";
-
-export default class ContextPublish extends BaseCommand {
-  static override description = "Publish an entry to the context bus";
-  static override hidden = false;
-
-  static override examples = [
-    '<%= config.bin %> context publish --trace-id tr_abc --type decision --content "Using JWT auth"',
-    '<%= config.bin %> context publish --trace-id tr_abc --type file_activity --content "editing src/auth.ts" --session my-session',
-    'echo "constraint text" | <%= config.bin %> context publish --trace-id tr_abc --type constraint',
-  ];
-
-  static override args = {
-    content: Args.string({ description: "Entry content (or pipe via stdin)" }),
-  };
-
-  static override flags = {
-    ...BaseCommand.baseFlags,
-    "trace-id": Flags.string({
-      description: "Trace ID for correlation",
-      required: true,
-      env: "AGENTS_TRACE_ID",
-    }),
-    type: Flags.string({
-      description: "Entry type",
-      required: true,
-      options: [
-        "decision",
-        "artifact",
-        "constraint",
-        "progress",
-        "directive",
-        "file_activity",
-        "annotation",
-      ],
-    }),
-    title: Flags.string({ description: "Entry title" }),
-    content: Flags.string({
-      description: "Entry content (alternative to positional arg or stdin)",
-    }),
-    session: Flags.string({ description: "Publisher session ID" }),
-    parent: Flags.string({ description: "Parent session ID" }),
-  };
-
-  protected async execute(): Promise<unknown> {
-    const { args, flags } = await this.parse(ContextPublish);
-    this.parsedFlags = flags;
-
-    let content = flags.content ?? args.content;
-
-    // Read from stdin if no content arg
-    if (!content) {
-      const chunks: Buffer[] = [];
-      for await (const chunk of process.stdin) {
-        chunks.push(chunk as Buffer);
-      }
-      content = Buffer.concat(chunks).toString("utf-8").trim();
-    }
-
-    if (!content) {
-      this.error("Content is required (pass as arg or pipe via stdin)");
-    }
-
-    const client = getHttpClient();
-    const result = await client.mutation(api.contextBus.publish, {
-      traceId: flags["trace-id"],
-      type: flags.type as ContextBusEntryType,
-      title: flags.title,
-      content,
-      sessionId: flags.session,
-      parentSessionId: flags.parent,
-    });
-
-    if (flags.json || flags.format === "json") {
-      return result;
-    }
-
-    this.logInfo(`Published ${flags.type} entry: ${result.id}`);
-    return result;
-  }
-}

package/src/cli/commands/context/read.ts

@@ -1,85 +0,0 @@
-import { getHttpClient, api, type ContextBusEntryType } from "@creativeintelligence/sdk/convex";
-import { Flags } from "@oclif/core";
-import { BaseCommand } from "../../base-command.js";
-
-export default class ContextRead extends BaseCommand {
-  static override description = "Read entries from the context bus";
-  static override hidden = false;
-
-  static override examples = [
-    "<%= config.bin %> context read --trace-id tr_abc",
-    "<%= config.bin %> context read --session arbor-20260128-abc1",
-    "<%= config.bin %> context read --trace-id tr_abc --type artifact --limit 20 --json",
-  ];
-
-  static override flags = {
-    ...BaseCommand.baseFlags,
-    "trace-id": Flags.string({
-      description: "Trace ID to read entries for",
-      env: "AGENTS_TRACE_ID",
-    }),
-    session: Flags.string({
-      description: "Session ID to read entries for (alternative to --trace-id)",
-    }),
-    type: Flags.string({
-      description: "Filter by entry type",
-      options: [
-        "decision",
-        "artifact",
-        "constraint",
-        "progress",
-        "directive",
-        "file_activity",
-        "annotation",
-      ],
-    }),
-    since: Flags.integer({ description: "Only entries after this timestamp (ms)" }),
-    limit: Flags.integer({ description: "Max entries to return", default: 50 }),
-  };
-
-  protected async execute(): Promise<unknown> {
-    const { flags } = await this.parse(ContextRead);
-    this.parsedFlags = flags;
-
-    if (!flags["trace-id"] && !flags.session) {
-      this.error("Either --trace-id or --session is required");
-    }
-
-    const client = getHttpClient();
-    const entries = flags.session
-      ? await client.query(api.contextBus.readBySession, {
-          sessionId: flags.session,
-          type: flags.type as ContextBusEntryType | undefined,
-          limit: flags.limit,
-        })
-      : await client.query(api.contextBus.read, {
-          traceId: flags["trace-id"]!,
-          type: flags.type as ContextBusEntryType | undefined,
-          since: flags.since,
-          limit: flags.limit,
-        });
-
-    if (flags.json || flags.format === "json") {
-      return entries;
-    }
-
-    if (this.ndjsonEnabled()) {
-      this.outputNdjson(entries);
-      return entries;
-    }
-
-    if (entries.length === 0) {
-      this.logInfo("No context bus entries found");
-      return [];
-    }
-
-    for (const entry of entries) {
-      const time = new Date(entry.timestamp).toISOString().slice(11, 19);
-      const session = entry.sessionId ? ` [${entry.sessionId}]` : "";
-      const title = entry.title ? ` ${entry.title}:` : "";
-      this.log(`${time} [${entry.type}]${session}${title} ${entry.content.slice(0, 200)}`);
-    }
-
-    return entries;
-  }
-}