@creativeintelligence/abbie 0.1.0

package/bin/dev.js

@@ -0,0 +1,61 @@
+#!/usr/bin/env node
+
+// @ts-check
+
+import { execute, settings } from '@oclif/core';
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { Plugin } from "@oclif/core";
+
+settings.performanceEnabled = false;
+
+const root = resolve(dirname(fileURLToPath(import.meta.url)), "..");
+
+async function ensureManifestIsFresh() {
+  const manifestPath = join(root, "oclif.manifest.json");
+  const panesSnapshotPath = join(root, "dist", "cli", "commands", "panes", "snapshot.js");
+  const panesBrokerPath = join(root, "dist", "cli", "commands", "panes", "broker.js");
+  const panesPipeSinkPath = join(root, "dist", "cli", "commands", "panes", "pipe-sink.js");
+
+  if (!existsSync(panesSnapshotPath)) return;
+
+  try {
+    if (existsSync(manifestPath)) {
+      const parsed = JSON.parse(readFileSync(manifestPath, "utf8"));
+      const commands = parsed?.commands ?? {};
+      const hasSnapshot = Boolean(commands["panes:snapshot"]);
+      const hasBroker = Boolean(commands["panes:broker"]);
+      const hasPipeSink = Boolean(commands["panes:pipe-sink"]);
+
+      const distHasBroker = existsSync(panesBrokerPath);
+      const distHasPipeSink = existsSync(panesPipeSinkPath);
+
+      if (hasSnapshot && (!distHasBroker || hasBroker) && (!distHasPipeSink || hasPipeSink)) return;
+    }
+  } catch {
+    // fall through -> regenerate
+  }
+
+  try {
+    const pjson = JSON.parse(readFileSync(join(root, "package.json"), "utf8"));
+    const plugin = new Plugin({ root, pjson, isRoot: true, ignoreManifest: true });
+    await plugin.load();
+    writeFileSync(manifestPath, `${JSON.stringify(plugin.manifest, null, 2)}\n`);
+  } catch {
+    // Best-effort. If manifest regen fails, oclif will surface errors as usual.
+  }
+}
+
+await ensureManifestIsFresh();
+
+// Default command: if no args (or only flags), run "start"
+const userArgs = process.argv.slice(2);
+const firstArg = userArgs[0];
+const isSubcommand = firstArg && !firstArg.startsWith("-");
+
+if (!isSubcommand) {
+  process.argv.splice(2, 0, "start");
+}
+
+await execute({ development: true, dir: import.meta.url });

package/bin/run.js

@@ -0,0 +1,66 @@
+#!/usr/bin/env bun
+
+// @ts-check
+
+import { execute, Plugin, settings } from "@oclif/core";
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+
+settings.performanceEnabled = false;
+
+const root = resolve(dirname(fileURLToPath(import.meta.url)), "..");
+
+async function ensureManifestIsFresh() {
+  const manifestPath = join(root, "oclif.manifest.json");
+  const panesSnapshotPath = join(root, "dist", "cli", "commands", "panes", "snapshot.js");
+  const panesBrokerPath = join(root, "dist", "cli", "commands", "panes", "broker.js");
+  const panesPipeSinkPath = join(root, "dist", "cli", "commands", "panes", "pipe-sink.js");
+
+  // If the panes snapshot command isn't built, don't force manifest regeneration.
+  if (!existsSync(panesSnapshotPath)) return;
+
+  try {
+    if (existsSync(manifestPath)) {
+      const parsed = JSON.parse(readFileSync(manifestPath, "utf8"));
+      const commands = parsed?.commands ?? {};
+      const hasSnapshot = Boolean(commands["panes:snapshot"]);
+      const hasBroker = Boolean(commands["panes:broker"]);
+      const hasPipeSink = Boolean(commands["panes:pipe-sink"]);
+
+      // If dist contains the command but manifest doesn't, regenerate.
+      const distHasBroker = existsSync(panesBrokerPath);
+      const distHasPipeSink = existsSync(panesPipeSinkPath);
+
+      if (hasSnapshot && (!distHasBroker || hasBroker) && (!distHasPipeSink || hasPipeSink)) return;
+    }
+  } catch {
+    // fall through -> regenerate
+  }
+
+  try {
+    const pjson = JSON.parse(readFileSync(join(root, "package.json"), "utf8"));
+    const plugin = new Plugin({ root, pjson, isRoot: true, ignoreManifest: true });
+    await plugin.load();
+    writeFileSync(manifestPath, `${JSON.stringify(plugin.manifest, null, 2)}\n`);
+  } catch {
+    // Best-effort. If manifest regen fails, oclif will surface errors as usual.
+  }
+}
+
+await ensureManifestIsFresh();
+
+// Default command: if no args (or only flags like --status/--setup), run "start"
+const userArgs = process.argv.slice(2);
+const firstArg = userArgs[0];
+const isSubcommand = firstArg && !firstArg.startsWith("-");
+
+if (!isSubcommand) {
+  // No subcommand provided — inject "start" as the default
+  process.argv.splice(2, 0, "start");
+}
+
+await execute({
+  development: false,
+  loadOptions: { root },
+});

package/dist/cli/base-command.d.ts

@@ -0,0 +1,71 @@
+import { Command } from "@oclif/core";
+type ParsedFlags = {
+    format?: string;
+    quiet?: boolean;
+    "json-errors"?: boolean;
+    ndjson?: boolean;
+    json?: boolean;
+};
+/**
+ * Shared base command for abbie CLI.
+ *
+ * Commands should extend BaseCommand and implement `protected execute()`
+ * instead of overriding `run()`. The public `run()` method delegates to
+ * `execute()` and must not be overridden by subclasses.
+ */
+export declare abstract class BaseCommand extends Command {
+    static hidden: boolean;
+    static enableJsonFlag: boolean;
+    static baseFlags: {
+        format: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        quiet: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        "json-errors": import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        ndjson: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    /** Parsed flags available to subclasses and utility methods */
+    protected parsedFlags?: ParsedFlags & Record<string, unknown>;
+    /** Subclasses implement their logic here instead of overriding `run()`. */
+    protected abstract execute(): Promise<unknown>;
+    /** Final run implementation – do not override in subclasses. */
+    run(): Promise<unknown>;
+    /**
+     * Format error for display.
+     */
+    protected formatError(err: unknown): {
+        message: string;
+        cause?: unknown;
+    };
+    protected jsonErrorsEnabled(): boolean;
+    /**
+     * Get plans directory path.
+     * Uses ~/.abbie/plans/ (dotfile convention like ~/.claude, ~/.codex)
+     */
+    protected getPlansDir(): string;
+    /**
+     * Read from stdin if available (not a TTY).
+     * Returns empty string if stdin is a TTY or no data available.
+     */
+    protected readStdin(): Promise<string>;
+    /**
+     * Output JSON data.
+     */
+    protected output(data: unknown): void;
+    /**
+     * Log info (suppressed in quiet or JSON mode).
+     */
+    protected logInfo(message: string): void;
+    /**
+     * Log warning (suppressed in JSON mode).
+     */
+    protected logWarn(message: string): void;
+    /**
+     * Check if NDJSON output is enabled.
+     */
+    protected ndjsonEnabled(): boolean;
+    /**
+     * Output array items as NDJSON (one JSON object per line).
+     */
+    protected outputNdjson(items: unknown[]): void;
+}
+export {};
+//# sourceMappingURL=base-command.d.ts.map

package/dist/cli/base-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-command.d.ts","sourceRoot":"","sources":["../../src/cli/base-command.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAS,MAAM,aAAa,CAAC;AAO7C,KAAK,WAAW,GAAG;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF;;;;;;GAMG;AACH,8BAAsB,WAAY,SAAQ,OAAO;IAC/C,MAAM,CAAC,MAAM,UAAQ;IACrB,MAAM,CAAC,cAAc,UAAQ;IAE7B,MAAM,CAAC,SAAS;;;;;MAkBd;IAEF,+DAA+D;IAC/D,SAAS,CAAC,WAAW,CAAC,EAAE,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAE9D,2EAA2E;IAC3E,SAAS,CAAC,QAAQ,CAAC,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;IAE9C,gEAAgE;IACnD,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC;IA6DpC;;OAEG;IACH,SAAS,CAAC,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;IAOzE,SAAS,CAAC,iBAAiB,IAAI,OAAO;IAYtC;;;OAGG;IACH,SAAS,CAAC,WAAW,IAAI,MAAM;IAK/B;;;OAGG;cACa,SAAS,IAAI,OAAO,CAAC,MAAM,CAAC;IAgB5C;;OAEG;IACH,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IAIrC;;OAEG;IACH,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAMxC;;OAEG;IACH,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAKxC;;OAEG;IACH,SAAS,CAAC,aAAa,IAAI,OAAO;IAYlC;;OAEG;IACH,SAAS,CAAC,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,IAAI;CAK/C"}

package/dist/cli/base-command.js

@@ -0,0 +1,200 @@
+import { join } from "node:path";
+import { Command, Flags } from "@oclif/core";
+import { initAnalytics, registerShutdown, telemetry } from "../lib/analytics.js";
+import { errorToExitCode, toJsonError } from "../lib/errors.js";
+// Register shutdown handler once at module load
+let shutdownRegistered = false;
+/**
+ * Shared base command for abbie CLI.
+ *
+ * Commands should extend BaseCommand and implement `protected execute()`
+ * instead of overriding `run()`. The public `run()` method delegates to
+ * `execute()` and must not be overridden by subclasses.
+ */
+export class BaseCommand extends Command {
+    static hidden = true;
+    static enableJsonFlag = true;
+    static baseFlags = {
+        format: Flags.string({
+            description: "Output format",
+            options: ["text", "json", "yaml"],
+        }),
+        quiet: Flags.boolean({
+            char: "q",
+            description: "Suppress info messages",
+            default: false,
+        }),
+        "json-errors": Flags.boolean({
+            description: "Output errors as JSON",
+            default: false,
+        }),
+        ndjson: Flags.boolean({
+            description: "Output newline-delimited JSON (one object per line)",
+            default: false,
+        }),
+    };
+    /** Parsed flags available to subclasses and utility methods */
+    parsedFlags;
+    /** Final run implementation – do not override in subclasses. */
+    async run() {
+        // Register shutdown handler once
+        if (!shutdownRegistered) {
+            registerShutdown();
+            shutdownRegistered = true;
+        }
+        // Initialize analytics (fast no-op if disabled)
+        await initAnalytics();
+        // Extract command name from constructor
+        const commandName = this.constructor.name
+            .replace(/Command$/, "")
+            .replace(/([A-Z])/g, " $1")
+            .trim()
+            .toLowerCase();
+        const startTime = Date.now();
+        try {
+            const result = await this.execute();
+            // Track successful command
+            telemetry.trackCommand(commandName, {
+                success: true,
+                duration_ms: Date.now() - startTime,
+                exit_code: 0,
+            });
+            return result;
+        }
+        catch (err) {
+            const { message } = this.formatError(err);
+            const exitCode = getOclifExitCode(err) ?? errorToExitCode(err);
+            // Track failed command
+            telemetry.trackCommand(commandName, {
+                success: false,
+                duration_ms: Date.now() - startTime,
+                exit_code: exitCode,
+            });
+            // Track error type
+            const errorType = err instanceof Error ? err.constructor.name : "UnknownError";
+            telemetry.trackError(errorType, {
+                command: commandName,
+                recoverable: exitCode === 2, // Validation errors are recoverable
+            });
+            if (this.jsonErrorsEnabled()) {
+                console.error(JSON.stringify(toJsonError(err, exitCode), null, 2));
+                this.exit(exitCode);
+                return;
+            }
+            // If a subclass already called this.error(), rethrow unchanged
+            if (hasOclifExit(err)) {
+                throw err;
+            }
+            this.error(message, { exit: exitCode });
+        }
+    }
+    /**
+     * Format error for display.
+     */
+    formatError(err) {
+        if (err instanceof Error) {
+            return { message: err.message, cause: err.cause };
+        }
+        return { message: String(err) };
+    }
+    jsonErrorsEnabled() {
+        const flags = this.parsedFlags;
+        if (typeof flags?.["json-errors"] === "boolean") {
+            return flags["json-errors"];
+        }
+        const argv = process.argv.slice(2);
+        if (argv.includes("--no-json-errors") || argv.includes("--json-errors=false")) {
+            return false;
+        }
+        return argv.includes("--json-errors") || argv.includes("--json-errors=true");
+    }
+    /**
+     * Get plans directory path.
+     * Uses ~/.abbie/plans/ (dotfile convention like ~/.claude, ~/.codex)
+     */
+    getPlansDir() {
+        const home = process.env.HOME || "~";
+        return join(home, ".abbie", "plans");
+    }
+    /**
+     * Read from stdin if available (not a TTY).
+     * Returns empty string if stdin is a TTY or no data available.
+     */
+    async readStdin() {
+        const { stdin } = process;
+        let result = "";
+        // Skip stdin reading if it's a TTY
+        if (stdin.isTTY) {
+            return "";
+        }
+        for await (const chunk of stdin) {
+            result += chunk;
+        }
+        return result.trim();
+    }
+    /**
+     * Output JSON data.
+     */
+    output(data) {
+        this.log(JSON.stringify(data, null, 2));
+    }
+    /**
+     * Log info (suppressed in quiet or JSON mode).
+     */
+    logInfo(message) {
+        if (this.parsedFlags?.quiet)
+            return;
+        if (this.jsonEnabled?.())
+            return;
+        this.log(message);
+    }
+    /**
+     * Log warning (suppressed in JSON mode).
+     */
+    logWarn(message) {
+        if (this.jsonEnabled?.())
+            return;
+        this.warn(message);
+    }
+    /**
+     * Check if NDJSON output is enabled.
+     */
+    ndjsonEnabled() {
+        const flags = this.parsedFlags;
+        if (typeof flags?.ndjson === "boolean") {
+            return flags.ndjson;
+        }
+        const argv = process.argv.slice(2);
+        if (argv.includes("--no-ndjson") || argv.includes("--ndjson=false")) {
+            return false;
+        }
+        return argv.includes("--ndjson") || argv.includes("--ndjson=true");
+    }
+    /**
+     * Output array items as NDJSON (one JSON object per line).
+     */
+    outputNdjson(items) {
+        for (const item of items) {
+            this.log(JSON.stringify(item));
+        }
+    }
+}
+/**
+ * Type guard to check if error has oclif exit code.
+ */
+function hasOclifExit(err) {
+    if (typeof err !== "object" || err === null)
+        return false;
+    if (!("oclif" in err))
+        return false;
+    const oclif = err.oclif;
+    if (typeof oclif !== "object" || oclif === null)
+        return false;
+    const exit = oclif.exit;
+    return typeof exit === "number";
+}
+function getOclifExitCode(err) {
+    if (!hasOclifExit(err))
+        return undefined;
+    return err.oclif.exit;
+}

package/dist/cli/commands/agent/list.d.ts

@@ -0,0 +1,12 @@
+import { Command } from "@oclif/core";
+export default class AgentList extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        available: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        quiet: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=list.d.ts.map

package/dist/cli/commands/agent/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/agent/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAS,MAAM,aAAa,CAAC;AAI7C,MAAM,CAAC,OAAO,OAAO,SAAU,SAAQ,OAAO;IAC5C,OAAgB,WAAW,SAAqC;IAEhE,OAAgB,QAAQ,WAItB;IAEF,OAAgB,KAAK;;;;MAenB;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CA4C3B"}

package/dist/cli/commands/agent/list.js

@@ -0,0 +1,62 @@
+import { Command, Flags } from "@oclif/core";
+import { AGENT_METADATA, getAvailableAgents } from "../../../lib/agent-adapters.js";
+import { AGENTS } from "../../../lib/types.js";
+export default class AgentList extends Command {
+    static description = "List available AI coding agents";
+    static examples = [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --available",
+        "<%= config.bin %> <%= command.id %> --json --quiet",
+    ];
+    static flags = {
+        available: Flags.boolean({
+            char: "a",
+            description: "Only show installed/available agents",
+            default: false,
+        }),
+        json: Flags.boolean({
+            description: "Output as JSON",
+            default: false,
+        }),
+        quiet: Flags.boolean({
+            char: "q",
+            description: "Suppress info messages",
+            default: false,
+        }),
+    };
+    async run() {
+        const { flags } = await this.parse(AgentList);
+        const availableAgents = await getAvailableAgents();
+        const agents = AGENTS.map((type) => {
+            const meta = AGENT_METADATA[type];
+            const isAvailable = availableAgents.includes(type);
+            return {
+                type,
+                name: meta.name,
+                description: meta.description,
+                available: isAvailable,
+                installCmd: meta.installCmd,
+            };
+        });
+        const filtered = flags.available ? agents.filter((a) => a.available) : agents;
+        if (flags.json) {
+            this.log(JSON.stringify(filtered, null, 2));
+            return;
+        }
+        if (!flags.quiet) {
+            this.log("\nAI Coding Agents\n");
+        }
+        for (const agent of filtered) {
+            const status = agent.available ? "✓" : "✗";
+            const color = agent.available ? "\x1b[32m" : "\x1b[31m";
+            this.log(`  ${color}${status}\x1b[0m ${agent.type.padEnd(10)} ${agent.name} - ${agent.description}`);
+            if (!agent.available && agent.installCmd) {
+                this.log(`              Install: ${agent.installCmd}`);
+            }
+        }
+        if (!flags.quiet) {
+            const availableCount = filtered.filter((a) => a.available).length;
+            this.log(`\n${availableCount}/${filtered.length} agents available`);
+        }
+    }
+}

package/dist/cli/commands/annotation/ack.d.ts

@@ -0,0 +1,18 @@
+import { BaseCommand } from "../../base-command.js";
+export default class AnnotationAck extends BaseCommand {
+    static description: string;
+    static hidden: boolean;
+    static examples: string[];
+    static args: {
+        previewId: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+        annotationId: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        format: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        quiet: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        "json-errors": import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        ndjson: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    protected execute(): Promise<unknown>;
+}
+//# sourceMappingURL=ack.d.ts.map

package/dist/cli/commands/annotation/ack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ack.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/annotation/ack.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpD,MAAM,CAAC,OAAO,OAAO,aAAc,SAAQ,WAAW;IACpD,OAAgB,WAAW,SAA8C;IACzE,OAAgB,MAAM,UAAS;IAE/B,OAAgB,QAAQ,WAAiE;IAEzF,OAAgB,IAAI;;;MAGlB;IAEF,OAAgB,KAAK;;;;;MAEnB;cAEc,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;CAiB5C"}

package/dist/cli/commands/annotation/ack.js

@@ -0,0 +1,29 @@
+import { Args } from "@oclif/core";
+import { ConvexAnnotationClient } from "../../../lib/annotations-convex.js";
+import { BaseCommand } from "../../base-command.js";
+export default class AnnotationAck extends BaseCommand {
+    static description = "Acknowledge an annotation (mark as seen)";
+    static hidden = false;
+    static examples = ["<%= config.bin %> annotation ack PREVIEW_ID ANNOTATION_ID"];
+    static args = {
+        previewId: Args.string({ description: "Preview deployment ID", required: true }),
+        annotationId: Args.string({ description: "Annotation ID", required: true }),
+    };
+    static flags = {
+        ...BaseCommand.baseFlags,
+    };
+    async execute() {
+        const { args, flags } = await this.parse(AnnotationAck);
+        this.parsedFlags = flags;
+        const client = new ConvexAnnotationClient();
+        const annotation = await client.acknowledge(args.previewId, args.annotationId);
+        if (!annotation) {
+            this.error(`Annotation ${args.annotationId} not found`);
+        }
+        const isJson = flags.json || flags.format === "json";
+        if (isJson)
+            return annotation;
+        this.logInfo(`Acknowledged ${annotation.id.slice(0, 8)}`);
+        return annotation;
+    }
+}

package/dist/cli/commands/annotation/create.d.ts

@@ -0,0 +1,23 @@
+import { BaseCommand } from "../../base-command.js";
+export default class AnnotationCreate extends BaseCommand {
+    static description: string;
+    static hidden: boolean;
+    static examples: string[];
+    static args: {
+        previewId: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+        body: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        severity: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        intent: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        source: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        target: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        selector: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        format: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        quiet: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        "json-errors": import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        ndjson: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    protected execute(): Promise<unknown>;
+}
+//# sourceMappingURL=create.d.ts.map

package/dist/cli/commands/annotation/create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/annotation/create.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpD,MAAM,CAAC,OAAO,OAAO,gBAAiB,SAAQ,WAAW;IACvD,OAAgB,WAAW,SAAkD;IAC7E,OAAgB,MAAM,UAAS;IAE/B,OAAgB,QAAQ,WAItB;IAEF,OAAgB,IAAI;;;MAGlB;IAEF,OAAgB,KAAK;;;;;;;;;;MAsBnB;cAEc,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;CAsB5C"}

package/dist/cli/commands/annotation/create.js

@@ -0,0 +1,58 @@
+import { Args, Flags } from "@oclif/core";
+import { ConvexAnnotationClient } from "../../../lib/annotations-convex.js";
+import { BaseCommand } from "../../base-command.js";
+export default class AnnotationCreate extends BaseCommand {
+    static description = "Create an annotation on a preview deployment";
+    static hidden = false;
+    static examples = [
+        '<%= config.bin %> annotation create PREVIEW_ID "Button text is truncated on mobile"',
+        '<%= config.bin %> annotation create PREVIEW_ID "Auth redirect broken" --severity error --intent bug',
+        '<%= config.bin %> annotation create PREVIEW_ID "Consider lazy loading" --intent suggestion --target /dashboard',
+    ];
+    static args = {
+        previewId: Args.string({ description: "Preview deployment ID", required: true }),
+        body: Args.string({ description: "Annotation body (markdown)", required: true }),
+    };
+    static flags = {
+        ...BaseCommand.baseFlags,
+        severity: Flags.string({
+            description: "Severity level",
+            options: ["info", "warning", "error", "critical"],
+            default: "info",
+        }),
+        intent: Flags.string({
+            description: "Annotation intent",
+            options: ["feedback", "bug", "suggestion", "question", "blocker"],
+            default: "feedback",
+        }),
+        source: Flags.string({
+            description: "Source tool creating this annotation",
+            default: "cli",
+        }),
+        target: Flags.string({
+            description: "URL path or element being annotated",
+        }),
+        selector: Flags.string({
+            description: "CSS selector for the annotated element",
+        }),
+    };
+    async execute() {
+        const { args, flags } = await this.parse(AnnotationCreate);
+        this.parsedFlags = flags;
+        const client = new ConvexAnnotationClient();
+        const annotation = await client.create({
+            previewId: args.previewId,
+            body: args.body,
+            severity: flags.severity,
+            intent: flags.intent,
+            source: flags.source,
+            target: flags.target,
+            selector: flags.selector,
+        });
+        const isJson = flags.json || flags.format === "json";
+        if (isJson)
+            return annotation;
+        this.logInfo(`Created annotation ${annotation.id.slice(0, 8)} [${annotation.status}]`);
+        return annotation;
+    }
+}

package/dist/cli/commands/annotation/events.d.ts

@@ -0,0 +1,18 @@
+import { BaseCommand } from "../../base-command.js";
+export default class AnnotationEvents extends BaseCommand {
+    static description: string;
+    static hidden: boolean;
+    static examples: string[];
+    static args: {
+        previewId: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        "session-id": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        format: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        quiet: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        "json-errors": import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        ndjson: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    protected execute(): Promise<unknown>;
+}
+//# sourceMappingURL=events.d.ts.map

package/dist/cli/commands/annotation/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/annotation/events.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpD,MAAM,CAAC,OAAO,OAAO,gBAAiB,SAAQ,WAAW;IACvD,OAAgB,WAAW,SAC4C;IACvE,OAAgB,MAAM,UAAS;IAE/B,OAAgB,QAAQ,WAItB;IAEF,OAAgB,IAAI;;MAKlB;IAEF,OAAgB,KAAK;;;;;;MAMnB;cAEc,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;CAgC5C"}