@creativeintelligence/abbie 0.1.6 → 0.1.8

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@creativeintelligence/abbie",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "type": "module",
   "license": "MIT",
   "description": "Abbie — agent orchestration CLI",
@@ -42,11 +42,15 @@
     "dirname": "abbie",
     "plugins": [
       "@oclif/plugin-help",
-      "@oclif/plugin-not-found"
+      "@oclif/plugin-not-found",
+      "@oclif/plugin-version"
     ],
     "additionalHelpFlags": [
       "-h"
     ],
+    "additionalVersionFlags": [
+      "-v"
+    ],
     "topicSeparator": " ",
     "description": "Agent orchestration CLI",
     "commands": "./dist/cli/commands",
@@ -54,23 +58,29 @@
       "session": {
         "description": "Manage agent sessions"
       },
-      "windows": {
-        "description": "Workspace windows inventory"
-      },
       "report": {
         "description": "Lifecycle reporting"
       },
-      "auto": {
-        "description": "Auto-discover and spawn agents"
+      "context": {
+        "description": "Session context artifacts"
+      },
+      "project": {
+        "description": "Manage projects"
       },
-      "plan": {
-        "description": "Planning sessions"
+      "annotation": {
+        "description": "Preview annotations"
       },
       "hooks": {
-        "description": "Agent platform hooks"
+        "description": "Agent lifecycle hooks"
       },
       "reference": {
         "description": "Design reference bank"
+      },
+      "preview": {
+        "description": "Preview deployments"
+      },
+      "auto": {
+        "description": "Autonomous agent orchestration"
       }
     }
   },
@@ -90,6 +100,7 @@
     "@oclif/core": "^4",
     "@oclif/plugin-help": "^6",
     "@oclif/plugin-not-found": "^3",
+    "@oclif/plugin-version": "^2.2.36",
     "convex": "^1.31.6",
     "tar-fs": "^3"
   },

package/dist/cli/commands/backlog/add.d.ts

@@ -1,22 +0,0 @@
-import { BaseCommand } from "../../base-command.js";
-export default class BacklogAdd extends BaseCommand {
-    static description: string;
-    static hidden: boolean;
-    static examples: string[];
-    static args: {
-        project: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
-    };
-    static flags: {
-        ref: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
-        title: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
-        type: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
-        priority: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
-        source: import("@oclif/core/interfaces").OptionFlag<string, 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=add.d.ts.map

package/dist/cli/commands/backlog/add.js

@@ -1,65 +0,0 @@
-import { Args, Flags } from "@oclif/core";
-import { getBacklogManager } from "../../../lib/backlog.js";
-import { BaseCommand } from "../../base-command.js";
-export default class BacklogAdd extends BaseCommand {
-    static description = "Add an item to the backlog";
-    static hidden = false;
-    static examples = [
-        '<%= config.bin %> backlog add hostagent --ref ZO-123 --title "Fix auth bug"',
-        '<%= config.bin %> backlog add hostagent --ref task-1 --title "Refactor API" --type task --priority 2',
-        '<%= config.bin %> backlog add hostagent --ref "#456" --title "PR review" --type pr --source github',
-    ];
-    static args = {
-        project: Args.string({
-            description: "Project name",
-            required: true,
-        }),
-    };
-    static flags = {
-        ...BaseCommand.baseFlags,
-        ref: Flags.string({
-            char: "r",
-            description: "Reference (e.g., ZO-123, #456)",
-            required: true,
-        }),
-        title: Flags.string({
-            char: "t",
-            description: "Item title",
-            required: true,
-        }),
-        type: Flags.string({
-            description: "Item type",
-            options: ["issue", "pr", "task"],
-            default: "task",
-        }),
-        priority: Flags.integer({
-            char: "p",
-            description: "Priority (1=urgent, 4=low)",
-            default: 3,
-        }),
-        source: Flags.string({
-            char: "s",
-            description: "Source",
-            options: ["linear", "github", "manual"],
-            default: "manual",
-        }),
-    };
-    async execute() {
-        const { args, flags } = await this.parse(BacklogAdd);
-        this.parsedFlags = flags;
-        const backlog = getBacklogManager();
-        const item = backlog.add({
-            type: flags.type,
-            ref: flags.ref,
-            title: flags.title,
-            project: args.project,
-            priority: flags.priority,
-            source: flags.source,
-        });
-        if (flags.json || flags.format === "json") {
-            return item;
-        }
-        this.logInfo(`Added: ${item.ref} (${item.id})`);
-        return item;
-    }
-}

package/dist/cli/commands/backlog/claim.d.ts

@@ -1,19 +0,0 @@
-import { BaseCommand } from "../../base-command.js";
-export default class BacklogClaim extends BaseCommand {
-    static description: string;
-    static hidden: boolean;
-    static examples: string[];
-    static args: {
-        project: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
-        item_id: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
-    };
-    static flags: {
-        session: import("@oclif/core/interfaces").OptionFlag<string, 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=claim.d.ts.map

package/dist/cli/commands/backlog/claim.js

@@ -1,45 +0,0 @@
-import { Args, Flags } from "@oclif/core";
-import { getBacklogManager } from "../../../lib/backlog.js";
-import { BaseCommand } from "../../base-command.js";
-export default class BacklogClaim extends BaseCommand {
-    static description = "Claim a backlog item for a session";
-    static hidden = false;
-    static examples = [
-        "<%= config.bin %> backlog claim hostagent ITEM_ID --session SESSION_ID",
-        "<%= config.bin %> backlog claim hostagent ITEM_ID --session SESSION_ID --json",
-    ];
-    static args = {
-        project: Args.string({
-            description: "Project name",
-            required: true,
-        }),
-        item_id: Args.string({
-            description: "Item ID to claim",
-            required: true,
-        }),
-    };
-    static flags = {
-        ...BaseCommand.baseFlags,
-        session: Flags.string({
-            char: "s",
-            description: "Session ID claiming the item",
-            required: true,
-        }),
-    };
-    async execute() {
-        const { args, flags } = await this.parse(BacklogClaim);
-        this.parsedFlags = flags;
-        const backlog = getBacklogManager();
-        const result = backlog.claim(args.project, args.item_id, flags.session);
-        if (flags.json || flags.format === "json") {
-            return result;
-        }
-        if (result.success) {
-            this.logInfo(`Claimed: ${result.item?.ref}`);
-        }
-        else {
-            this.logInfo(`Failed to claim: ${result.reason}`);
-        }
-        return result;
-    }
-}

package/dist/cli/commands/backlog/complete.d.ts

@@ -1,18 +0,0 @@
-import { BaseCommand } from "../../base-command.js";
-export default class BacklogComplete extends BaseCommand {
-    static description: string;
-    static hidden: boolean;
-    static examples: string[];
-    static args: {
-        project: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
-        item_id: 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=complete.d.ts.map

package/dist/cli/commands/backlog/complete.js

@@ -1,42 +0,0 @@
-import { Args } from "@oclif/core";
-import { getBacklogManager } from "../../../lib/backlog.js";
-import { BaseCommand } from "../../base-command.js";
-export default class BacklogComplete extends BaseCommand {
-    static description = "Mark a backlog item as complete";
-    static hidden = false;
-    static examples = [
-        "<%= config.bin %> backlog complete hostagent ITEM_ID",
-        "<%= config.bin %> backlog complete hostagent ITEM_ID --json",
-    ];
-    static args = {
-        project: Args.string({
-            description: "Project name",
-            required: true,
-        }),
-        item_id: Args.string({
-            description: "Item ID to complete",
-            required: true,
-        }),
-    };
-    static flags = {
-        ...BaseCommand.baseFlags,
-    };
-    async execute() {
-        const { args, flags } = await this.parse(BacklogComplete);
-        this.parsedFlags = flags;
-        const backlog = getBacklogManager();
-        const item = backlog.complete(args.project, args.item_id);
-        if (!item) {
-            if (flags.json || flags.format === "json") {
-                return { success: false, reason: "Item not found" };
-            }
-            this.logInfo("Item not found");
-            return { success: false };
-        }
-        if (flags.json || flags.format === "json") {
-            return { success: true, item };
-        }
-        this.logInfo(`Completed: ${item.ref}`);
-        return { success: true, item };
-    }
-}

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

@@ -1,20 +0,0 @@
-import { BaseCommand } from "../../base-command.js";
-export default class BacklogList extends BaseCommand {
-    static description: string;
-    static hidden: boolean;
-    static examples: string[];
-    static args: {
-        project: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
-    };
-    static flags: {
-        status: 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>;
-    private getStatusIcon;
-    private getPriorityIcon;
-}
-//# sourceMappingURL=list.d.ts.map

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

@@ -1,91 +0,0 @@
-import { Args, Flags } from "@oclif/core";
-import { getBacklogManager } from "../../../lib/backlog.js";
-import { BaseCommand } from "../../base-command.js";
-export default class BacklogList extends BaseCommand {
-    static description = "List backlog items for a project";
-    static hidden = false;
-    static examples = [
-        "<%= config.bin %> backlog list hostagent",
-        "<%= config.bin %> backlog list hostagent --status pending",
-        "<%= config.bin %> backlog list hostagent --json",
-    ];
-    static args = {
-        project: Args.string({
-            description: "Project name",
-            required: true,
-        }),
-    };
-    static flags = {
-        ...BaseCommand.baseFlags,
-        status: Flags.string({
-            char: "s",
-            description: "Filter by status",
-            options: ["pending", "claimed", "in_progress", "blocked", "completed", "abandoned"],
-        }),
-    };
-    async execute() {
-        const { args, flags } = await this.parse(BacklogList);
-        this.parsedFlags = flags;
-        const backlog = getBacklogManager();
-        let items = backlog.listItems(args.project);
-        if (flags.status) {
-            items = items.filter((item) => item.status === flags.status);
-        }
-        if (flags.json || flags.format === "json") {
-            return items;
-        }
-        // NDJSON: one item per line
-        if (this.ndjsonEnabled()) {
-            this.outputNdjson(items);
-            return items;
-        }
-        if (items.length === 0) {
-            this.logInfo(`No items in ${args.project} backlog`);
-            return [];
-        }
-        this.logInfo(`${args.project} backlog (${items.length} items):\n`);
-        for (const item of items) {
-            const statusIcon = this.getStatusIcon(item.status);
-            const priorityIcon = this.getPriorityIcon(item.priority);
-            this.log(`${statusIcon} ${item.ref}: ${item.title}`);
-            this.log(`   ${priorityIcon} Priority ${item.priority} | Source: ${item.source}`);
-            if (item.claimed_by) {
-                this.log(`   Claimed by: ${item.claimed_by}`);
-            }
-            this.log("");
-        }
-        return items;
-    }
-    getStatusIcon(status) {
-        switch (status) {
-            case "pending":
-                return "⏳";
-            case "claimed":
-                return "🔒";
-            case "in_progress":
-                return "🚀";
-            case "blocked":
-                return "🔴";
-            case "completed":
-                return "✅";
-            case "abandoned":
-                return "❌";
-            default:
-                return "•";
-        }
-    }
-    getPriorityIcon(priority) {
-        switch (priority) {
-            case 1:
-                return "🔥";
-            case 2:
-                return "⚡";
-            case 3:
-                return "📌";
-            case 4:
-                return "📋";
-            default:
-                return "•";
-        }
-    }
-}

package/dist/cli/commands/backlog/pick.d.ts

@@ -1,18 +0,0 @@
-import { BaseCommand } from "../../base-command.js";
-export default class BacklogPick extends BaseCommand {
-    static description: string;
-    static hidden: boolean;
-    static examples: string[];
-    static args: {
-        project: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
-    };
-    static flags: {
-        session: import("@oclif/core/interfaces").OptionFlag<string, 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=pick.d.ts.map

package/dist/cli/commands/backlog/pick.js

@@ -1,42 +0,0 @@
-import { Args, Flags } from "@oclif/core";
-import { getBacklogManager } from "../../../lib/backlog.js";
-import { BaseCommand } from "../../base-command.js";
-export default class BacklogPick extends BaseCommand {
-    static description = "Pick and claim the next available backlog item";
-    static hidden = false;
-    static examples = [
-        "<%= config.bin %> backlog pick hostagent --session SESSION_ID",
-        "<%= config.bin %> backlog pick hostagent --session SESSION_ID --json",
-    ];
-    static args = {
-        project: Args.string({
-            description: "Project name",
-            required: true,
-        }),
-    };
-    static flags = {
-        ...BaseCommand.baseFlags,
-        session: Flags.string({
-            char: "s",
-            description: "Session ID claiming the item",
-            required: true,
-        }),
-    };
-    async execute() {
-        const { args, flags } = await this.parse(BacklogPick);
-        this.parsedFlags = flags;
-        const backlog = getBacklogManager();
-        const result = backlog.pickNext(args.project, flags.session);
-        if (flags.json || flags.format === "json") {
-            return result;
-        }
-        if (result.success && result.item) {
-            this.logInfo(`Picked: ${result.item.ref} - ${result.item.title}`);
-            this.log(result.item.id);
-        }
-        else {
-            this.logInfo(result.reason || "No items available");
-        }
-        return result;
-    }
-}

package/dist/cli/commands/backlog/sync.d.ts

@@ -1,24 +0,0 @@
-import { BaseCommand } from "../../base-command.js";
-export default class BacklogSync extends BaseCommand {
-    static description: string;
-    static hidden: boolean;
-    static examples: string[];
-    static args: {
-        project: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
-    };
-    static flags: {
-        source: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
-        team: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        repo: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        state: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
-        workspace: 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>;
-    private fetchLinearIssues;
-    private fetchGitHubItems;
-}
-//# sourceMappingURL=sync.d.ts.map

package/dist/cli/commands/backlog/sync.js

@@ -1,109 +0,0 @@
-import { execSync } from "node:child_process";
-import { Args, Flags } from "@oclif/core";
-import { getBacklogManager } from "../../../lib/backlog.js";
-import { BaseCommand } from "../../base-command.js";
-export default class BacklogSync extends BaseCommand {
-    static description = "Sync backlog from Linear or GitHub";
-    static hidden = false;
-    static examples = [
-        "<%= config.bin %> backlog sync hostagent --source linear --team ZO",
-        "<%= config.bin %> backlog sync hostagent --source github --repo owner/repo",
-        '<%= config.bin %> backlog sync hostagent --source linear --team ZO --state "Ready"',
-    ];
-    static args = {
-        project: Args.string({
-            description: "Project name",
-            required: true,
-        }),
-    };
-    static flags = {
-        ...BaseCommand.baseFlags,
-        source: Flags.string({
-            char: "s",
-            description: "Source to sync from",
-            required: true,
-            options: ["linear", "github"],
-        }),
-        team: Flags.string({
-            char: "t",
-            description: "Linear team (required for linear source)",
-        }),
-        repo: Flags.string({
-            char: "r",
-            description: "GitHub repo (required for github source)",
-        }),
-        state: Flags.string({
-            description: "Linear state filter",
-            default: "Ready",
-        }),
-        workspace: Flags.string({
-            char: "w",
-            description: "Linear workspace",
-        }),
-    };
-    async execute() {
-        const { args, flags } = await this.parse(BacklogSync);
-        this.parsedFlags = flags;
-        const backlog = getBacklogManager();
-        let added = 0;
-        if (flags.source === "linear") {
-            if (!flags.team) {
-                this.error("--team is required for linear source");
-            }
-            const issues = this.fetchLinearIssues(flags.team, flags.state, flags.workspace);
-            added = backlog.syncFromLinear(args.project, issues);
-        }
-        else if (flags.source === "github") {
-            if (!flags.repo) {
-                this.error("--repo is required for github source");
-            }
-            const items = this.fetchGitHubItems(flags.repo);
-            added = backlog.syncFromGitHub(args.project, items);
-        }
-        const result = { source: flags.source, added };
-        if (flags.json || flags.format === "json") {
-            return result;
-        }
-        this.logInfo(`Synced from ${flags.source}: ${added} items added`);
-        return result;
-    }
-    fetchLinearIssues(team, state, workspace) {
-        try {
-            const wsFlag = workspace ? `--workspace ${workspace}` : "";
-            const cmd = `linear issue list --team ${team} --state "${state}" ${wsFlag} --json --quiet`;
-            const output = execSync(cmd, { encoding: "utf-8" });
-            const issues = JSON.parse(output);
-            return issues.map((issue) => ({
-                id: issue.id,
-                title: issue.title,
-                priority: issue.priority || 3,
-                identifier: issue.identifier,
-            }));
-        }
-        catch {
-            return [];
-        }
-    }
-    fetchGitHubItems(repo) {
-        try {
-            // Fetch issues
-            const issuesCmd = `gh issue list --repo ${repo} --json number,title --limit 50`;
-            const issuesOutput = execSync(issuesCmd, { encoding: "utf-8" });
-            const issues = JSON.parse(issuesOutput).map((i) => ({
-                ...i,
-                type: "issue",
-            }));
-            // Fetch PRs
-            const prsCmd = `gh pr list --repo ${repo} --json number,title --limit 50`;
-            const prsOutput = execSync(prsCmd, { encoding: "utf-8" });
-            const prs = JSON.parse(prsOutput).map((p) => ({
-                ...p,
-                type: "pr",
-            }));
-            return [...issues, ...prs];
-        }
-        catch {
-            return [];
-        }
-    }
-}

package/dist/cli/commands/daemon.d.ts

@@ -1,56 +0,0 @@
-import { BaseCommand } from "../base-command.js";
-export default class DaemonCommand extends BaseCommand {
-    static description: string;
-    static hidden: boolean;
-    static flags: {
-        interval: import("@oclif/core/interfaces").OptionFlag<number, import("@oclif/core/interfaces").CustomOptions>;
-        "tmux-session": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
-        "all-sessions": import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        "windows-only": import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        redact: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
-        "enable-input": import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        "input-token": 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>;
-    private syncWindows;
-    private syncPanes;
-    private syncNvimBufferContent;
-    private syncDeviceHeartbeat;
-    private syncDesktopHeartbeat;
-    private syncSessions;
-    private lastProjectsHash;
-    private desktopProviderRegistered;
-    private clerkId;
-    private desktopProviderId;
-    private desktopConnectionId;
-    private sandboxServerProcesses;
-    private syncProjects;
-    private lastProjectsPushHash;
-    /**
-     * Push local project configs (.abbie/config.json) UP to Convex projects table.
-     * Idempotent — uses hash dedup to avoid redundant mutations.
-     */
-    private pushLocalProjects;
-    private runCommandQueueWorker;
-    /**
-     * Background worker that polls the sandbox command queue for pending
-     * commands (startServer, stopServer, exec) and executes them locally.
-     */
-    private runSandboxCommandWorker;
-    /**
-     * Execute a single sandbox command locally.
-     * Handles startServer (spawn detached process), stopServer (kill by PID),
-     * and exec (run command and capture output).
-     */
-    private executeSandboxCommand;
-    /**
-     * Execute a queued command from the chat agent.
-     * Currently supports "abbie session start" for spawning local agent sessions.
-     */
-    private executeQueuedCommand;
-}
-//# sourceMappingURL=daemon.d.ts.map