@kynetic-ai/spec 0.1.0

package/dist/agents/adapters.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Agent adapter registry.
+ *
+ * Adapters define how to spawn and communicate with different ACP-compliant agents.
+ * Each adapter specifies the command, args, and optional configuration.
+ */
+/**
+ * Adapter definition for spawning ACP agents.
+ */
+export interface AgentAdapter {
+    /** Command to execute (e.g., 'npx', 'node') */
+    command: string;
+    /** Arguments to pass to the command */
+    args: string[];
+    /** Environment variables to set */
+    env?: Record<string, string>;
+    /** Whether to use shell (needed for npx on Windows) */
+    shell?: boolean;
+    /** Human-readable description */
+    description?: string;
+}
+/**
+ * Get an adapter by ID.
+ *
+ * @param id - Adapter identifier
+ * @returns Adapter definition or undefined if not found
+ */
+export declare function getAdapter(id: string): AgentAdapter | undefined;
+/**
+ * List all registered adapter IDs.
+ *
+ * @returns Array of adapter IDs
+ */
+export declare function listAdapters(): string[];
+/**
+ * Register a custom adapter at runtime.
+ *
+ * Useful for testing or dynamic adapter configuration.
+ *
+ * @param id - Adapter identifier
+ * @param adapter - Adapter definition
+ */
+export declare function registerAdapter(id: string, adapter: AgentAdapter): void;
+/**
+ * Resolve adapter by ID or use default.
+ *
+ * If the ID matches a registered adapter, returns that adapter.
+ * If not, treats the ID as an npm package name and creates an ad-hoc npx adapter.
+ * This allows users to use any ACP-compatible package without registering it.
+ *
+ * @param id - Optional adapter ID or npm package name
+ * @returns Adapter definition
+ */
+export declare function resolveAdapter(id?: string): AgentAdapter;
+//# sourceMappingURL=adapters.d.ts.map

package/dist/agents/adapters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapters.d.ts","sourceRoot":"","sources":["../../src/agents/adapters.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,mCAAmC;IACnC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,uDAAuD;IACvD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,iCAAiC;IACjC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AA6BD;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAE/D;AAED;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,MAAM,EAAE,CAEvC;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI,CAEvE;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,YAAY,CAexD"}

package/dist/agents/adapters.js

@@ -0,0 +1,84 @@
+/**
+ * Agent adapter registry.
+ *
+ * Adapters define how to spawn and communicate with different ACP-compliant agents.
+ * Each adapter specifies the command, args, and optional configuration.
+ */
+/**
+ * Built-in adapter registry.
+ */
+const ADAPTERS = {
+    /**
+     * Claude Code ACP adapter - the primary production adapter.
+     * Uses @zed-industries/claude-code-acp package.
+     */
+    'claude-code-acp': {
+        command: 'npx',
+        args: ['@zed-industries/claude-code-acp'],
+        shell: process.platform === 'win32',
+        description: 'Claude Code via ACP protocol',
+    },
+    /**
+     * Mock ACP adapter for testing.
+     * Uses a local mock script that simulates ACP behavior.
+     */
+    'mock-acp': {
+        command: 'node',
+        args: [], // Path to mock script set at runtime via env
+        env: {},
+        description: 'Mock ACP agent for testing',
+    },
+};
+/**
+ * Get an adapter by ID.
+ *
+ * @param id - Adapter identifier
+ * @returns Adapter definition or undefined if not found
+ */
+export function getAdapter(id) {
+    return ADAPTERS[id];
+}
+/**
+ * List all registered adapter IDs.
+ *
+ * @returns Array of adapter IDs
+ */
+export function listAdapters() {
+    return Object.keys(ADAPTERS);
+}
+/**
+ * Register a custom adapter at runtime.
+ *
+ * Useful for testing or dynamic adapter configuration.
+ *
+ * @param id - Adapter identifier
+ * @param adapter - Adapter definition
+ */
+export function registerAdapter(id, adapter) {
+    ADAPTERS[id] = adapter;
+}
+/**
+ * Resolve adapter by ID or use default.
+ *
+ * If the ID matches a registered adapter, returns that adapter.
+ * If not, treats the ID as an npm package name and creates an ad-hoc npx adapter.
+ * This allows users to use any ACP-compatible package without registering it.
+ *
+ * @param id - Optional adapter ID or npm package name
+ * @returns Adapter definition
+ */
+export function resolveAdapter(id) {
+    const adapterId = id ?? 'claude-code-acp';
+    const adapter = getAdapter(adapterId);
+    if (adapter) {
+        return adapter;
+    }
+    // Treat unknown IDs as npm package names - create ad-hoc npx adapter
+    return {
+        command: 'npx',
+        args: [adapterId],
+        shell: process.platform === 'win32',
+        description: `Ad-hoc adapter for ${adapterId}`,
+    };
+}
+//# sourceMappingURL=adapters.js.map

package/dist/agents/adapters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapters.js","sourceRoot":"","sources":["../../src/agents/adapters.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAkBH;;GAEG;AACH,MAAM,QAAQ,GAAiC;IAC7C;;;OAGG;IACH,iBAAiB,EAAE;QACjB,OAAO,EAAE,KAAK;QACd,IAAI,EAAE,CAAC,iCAAiC,CAAC;QACzC,KAAK,EAAE,OAAO,CAAC,QAAQ,KAAK,OAAO;QACnC,WAAW,EAAE,8BAA8B;KAC5C;IAED;;;OAGG;IACH,UAAU,EAAE;QACV,OAAO,EAAE,MAAM;QACf,IAAI,EAAE,EAAE,EAAE,6CAA6C;QACvD,GAAG,EAAE,EAAE;QACP,WAAW,EAAE,4BAA4B;KAC1C;CACF,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,UAAU,CAAC,EAAU;IACnC,OAAO,QAAQ,CAAC,EAAE,CAAC,CAAC;AACtB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY;IAC1B,OAAO,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AAC/B,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,EAAU,EAAE,OAAqB;IAC/D,QAAQ,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC;AACzB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,cAAc,CAAC,EAAW;IACxC,MAAM,SAAS,GAAG,EAAE,IAAI,iBAAiB,CAAC;IAC1C,MAAM,OAAO,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC;IAEtC,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,qEAAqE;IACrE,OAAO;QACL,OAAO,EAAE,KAAK;QACd,IAAI,EAAE,CAAC,SAAS,CAAC;QACjB,KAAK,EAAE,OAAO,CAAC,QAAQ,KAAK,OAAO;QACnC,WAAW,EAAE,sBAAsB,SAAS,EAAE;KAC/C,CAAC;AACJ,CAAC"}

package/dist/agents/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Agent module.
+ *
+ * Provides utilities for spawning and communicating with ACP-compliant agents.
+ */
+export { type AgentAdapter, getAdapter, listAdapters, registerAdapter, resolveAdapter, } from './adapters.js';
+export { type SpawnAgentOptions, type SpawnedAgent, spawnAgent, spawnAndInitialize, } from './spawner.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/agents/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACL,KAAK,YAAY,EACjB,UAAU,EACV,YAAY,EACZ,eAAe,EACf,cAAc,GACf,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,UAAU,EACV,kBAAkB,GACnB,MAAM,cAAc,CAAC"}

package/dist/agents/index.js

@@ -0,0 +1,10 @@
+/**
+ * Agent module.
+ *
+ * Provides utilities for spawning and communicating with ACP-compliant agents.
+ */
+// Adapters
+export { getAdapter, listAdapters, registerAdapter, resolveAdapter, } from './adapters.js';
+// Spawner
+export { spawnAgent, spawnAndInitialize, } from './spawner.js';
+//# sourceMappingURL=index.js.map

package/dist/agents/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,WAAW;AACX,OAAO,EAEL,UAAU,EACV,YAAY,EACZ,eAAe,EACf,cAAc,GACf,MAAM,eAAe,CAAC;AAEvB,UAAU;AACV,OAAO,EAGL,UAAU,EACV,kBAAkB,GACnB,MAAM,cAAc,CAAC"}

package/dist/agents/spawner.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Agent spawner.
+ *
+ * Spawns ACP-compliant agent processes and initializes the ACP client
+ * for bidirectional JSON-RPC communication.
+ */
+import { type ChildProcess } from 'node:child_process';
+import { ACPClient, type ACPClientOptions } from '../acp/index.js';
+import type { AgentAdapter } from './adapters.js';
+/**
+ * Options for spawning an agent.
+ */
+export interface SpawnAgentOptions {
+    /** Working directory for the agent */
+    cwd: string;
+    /** Additional environment variables */
+    env?: Record<string, string>;
+    /** ACP client options */
+    clientOptions?: Omit<ACPClientOptions, 'stdin' | 'stdout'>;
+}
+/**
+ * Result of spawning an agent.
+ */
+export interface SpawnedAgent {
+    /** The ACP client for communication */
+    client: ACPClient;
+    /** The child process handle */
+    process: ChildProcess;
+    /** Kill the agent process */
+    kill: (signal?: NodeJS.Signals) => void;
+}
+/**
+ * Spawn an ACP agent using the specified adapter.
+ *
+ * Creates a child process and wraps its stdio with an ACPClient.
+ * The caller is responsible for calling client.initialize() after spawning.
+ *
+ * @param adapter - Adapter definition specifying how to spawn the agent
+ * @param options - Spawn options including cwd and environment
+ * @returns SpawnedAgent with client, process, and kill function
+ */
+export declare function spawnAgent(adapter: AgentAdapter, options: SpawnAgentOptions): SpawnedAgent;
+/**
+ * Spawn and initialize an ACP agent.
+ *
+ * Convenience function that spawns an agent and calls initialize().
+ *
+ * @param adapter - Adapter definition
+ * @param options - Spawn options
+ * @returns Initialized SpawnedAgent
+ */
+export declare function spawnAndInitialize(adapter: AgentAdapter, options: SpawnAgentOptions): Promise<SpawnedAgent>;
+//# sourceMappingURL=spawner.d.ts.map

package/dist/agents/spawner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawner.d.ts","sourceRoot":"","sources":["../../src/agents/spawner.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAS,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAE,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,sCAAsC;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,uCAAuC;IACvC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,yBAAyB;IACzB,aAAa,CAAC,EAAE,IAAI,CAAC,gBAAgB,EAAE,OAAO,GAAG,QAAQ,CAAC,CAAC;CAC5D;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,uCAAuC;IACvC,MAAM,EAAE,SAAS,CAAC;IAClB,+BAA+B;IAC/B,OAAO,EAAE,YAAY,CAAC;IACtB,6BAA6B;IAC7B,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,OAAO,KAAK,IAAI,CAAC;CACzC;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CACxB,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,iBAAiB,GACzB,YAAY,CAiDd;AAED;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,YAAY,CAAC,CAWvB"}

package/dist/agents/spawner.js

@@ -0,0 +1,83 @@
+/**
+ * Agent spawner.
+ *
+ * Spawns ACP-compliant agent processes and initializes the ACP client
+ * for bidirectional JSON-RPC communication.
+ */
+import { spawn } from 'node:child_process';
+import { ACPClient } from '../acp/index.js';
+/**
+ * Spawn an ACP agent using the specified adapter.
+ *
+ * Creates a child process and wraps its stdio with an ACPClient.
+ * The caller is responsible for calling client.initialize() after spawning.
+ *
+ * @param adapter - Adapter definition specifying how to spawn the agent
+ * @param options - Spawn options including cwd and environment
+ * @returns SpawnedAgent with client, process, and kill function
+ */
+export function spawnAgent(adapter, options) {
+    const { cwd, env = {}, clientOptions = {} } = options;
+    // Merge environment variables
+    const processEnv = {
+        ...process.env,
+        ...adapter.env,
+        ...env,
+    };
+    // Spawn the agent process
+    const child = spawn(adapter.command, adapter.args, {
+        cwd,
+        env: processEnv,
+        shell: adapter.shell,
+        stdio: ['pipe', 'pipe', 'inherit'], // pipe stdin/stdout, inherit stderr
+    });
+    // Ensure stdin/stdout are available
+    if (!child.stdin || !child.stdout) {
+        child.kill();
+        throw new Error('Failed to create pipes for agent process');
+    }
+    // Create ACP client connected to child's stdio
+    // Note: From the client's perspective:
+    // - stdin is where we READ from (child's stdout)
+    // - stdout is where we WRITE to (child's stdin)
+    const client = new ACPClient({
+        ...clientOptions,
+        stdin: child.stdout, // We read from child's stdout
+        stdout: child.stdin, // We write to child's stdin
+    });
+    // Forward process exit to client close
+    child.on('exit', () => {
+        if (!client.isClosed()) {
+            client.close();
+        }
+    });
+    // Kill function with graceful shutdown
+    const kill = (signal = 'SIGTERM') => {
+        if (!child.killed) {
+            child.kill(signal);
+        }
+    };
+    return { client, process: child, kill };
+}
+/**
+ * Spawn and initialize an ACP agent.
+ *
+ * Convenience function that spawns an agent and calls initialize().
+ *
+ * @param adapter - Adapter definition
+ * @param options - Spawn options
+ * @returns Initialized SpawnedAgent
+ */
+export async function spawnAndInitialize(adapter, options) {
+    const agent = spawnAgent(adapter, options);
+    try {
+        await agent.client.initialize();
+        return agent;
+    }
+    catch (err) {
+        // Clean up on initialization failure
+        agent.kill();
+        throw err;
+    }
+}
+//# sourceMappingURL=spawner.js.map

package/dist/agents/spawner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawner.js","sourceRoot":"","sources":["../../src/agents/spawner.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,EAAqB,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,SAAS,EAAyB,MAAM,iBAAiB,CAAC;AA2BnE;;;;;;;;;GASG;AACH,MAAM,UAAU,UAAU,CACxB,OAAqB,EACrB,OAA0B;IAE1B,MAAM,EAAE,GAAG,EAAE,GAAG,GAAG,EAAE,EAAE,aAAa,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC;IAEtD,8BAA8B;IAC9B,MAAM,UAAU,GAAG;QACjB,GAAG,OAAO,CAAC,GAAG;QACd,GAAG,OAAO,CAAC,GAAG;QACd,GAAG,GAAG;KACP,CAAC;IAEF,0BAA0B;IAC1B,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE;QACjD,GAAG;QACH,GAAG,EAAE,UAAU;QACf,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,oCAAoC;KACzE,CAAC,CAAC;IAEH,oCAAoC;IACpC,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QAClC,KAAK,CAAC,IAAI,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,0CAA0C,CAAC,CAAC;IAC9D,CAAC;IAED,+CAA+C;IAC/C,uCAAuC;IACvC,iDAAiD;IACjD,gDAAgD;IAChD,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,GAAG,aAAa;QAChB,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,8BAA8B;QACnD,MAAM,EAAE,KAAK,CAAC,KAA8B,EAAE,4BAA4B;KAC3E,CAAC,CAAC;IAEH,uCAAuC;IACvC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE;QACpB,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE,CAAC;YACvB,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,uCAAuC;IACvC,MAAM,IAAI,GAAG,CAAC,SAAyB,SAAS,EAAQ,EAAE;QACxD,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YAClB,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACrB,CAAC;IACH,CAAC,CAAC;IAEF,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAC1C,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,OAAqB,EACrB,OAA0B;IAE1B,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAE3C,IAAI,CAAC;QACH,MAAM,KAAK,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;QAChC,OAAO,KAAK,CAAC;IACf,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,qCAAqC;QACrC,KAAK,CAAC,IAAI,EAAE,CAAC;QACb,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/cli/batch.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Shared utilities for batch operations on multiple refs.
+ * Supports --refs @a @b @c flag pattern for commands like task complete, cancel, etc.
+ */
+import type { ReferenceIndex } from '../parser/index.js';
+/**
+ * Result of a single ref operation within a batch
+ */
+export interface BatchOperationResult {
+    ref: string;
+    ulid: string | null;
+    status: 'success' | 'error';
+    error?: string;
+    message?: string;
+    data?: unknown;
+}
+/**
+ * Summary of batch operation results
+ */
+export interface BatchSummary {
+    total: number;
+    succeeded: number;
+    failed: number;
+}
+/**
+ * Complete result of a batch operation
+ */
+export interface BatchResult {
+    success: boolean;
+    summary: BatchSummary;
+    results: BatchOperationResult[];
+}
+/**
+ * Options for executeBatchOperation
+ */
+export interface BatchOperationOptions<TItem, TContext> {
+    /** The positional ref argument (if provided) */
+    positionalRef?: string;
+    /** The --refs flag values (if provided) */
+    refsFlag?: string[];
+    /** Context needed for operations */
+    context: TContext;
+    /** All items to search through */
+    items: TItem[];
+    /** Reference index for resolution */
+    index: ReferenceIndex;
+    /** Function to resolve a ref to an item - returns { item, error? } */
+    resolveRef: (ref: string, items: TItem[], index: ReferenceIndex) => {
+        item: TItem | null;
+        error?: string;
+    };
+    /** Function to execute the operation on a single item */
+    executeOperation: (item: TItem, context: TContext) => Promise<{
+        success: boolean;
+        message?: string;
+        error?: string;
+        data?: unknown;
+    }>;
+    /** Function to extract ULID from an item */
+    getUlid: (item: TItem) => string;
+}
+/**
+ * Execute a batch operation with support for single-ref (positional) or multi-ref (--refs flag).
+ * Handles mutual exclusion, partial failures, and unified output formatting.
+ *
+ * Returns a BatchResult object. Caller should use formatBatchOutput() to render results.
+ */
+export declare function executeBatchOperation<TItem, TContext>(options: BatchOperationOptions<TItem, TContext>): Promise<BatchResult>;
+/**
+ * Format and output batch operation results.
+ * Handles both human-readable and JSON output formats.
+ * Sets appropriate exit code based on results.
+ *
+ * AC: @multi-ref-batch ac-5 - Human output format
+ * AC: @multi-ref-batch ac-6 - JSON output format
+ */
+export declare function formatBatchOutput(result: BatchResult, operationName: string): void;
+/**
+ * Helper to check if refs flag is being used (for backward compatibility checks)
+ */
+export declare function isBatchMode(refsFlag?: string[]): boolean;
+//# sourceMappingURL=batch.d.ts.map

package/dist/cli/batch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch.d.ts","sourceRoot":"","sources":["../../src/cli/batch.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAIzD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC;IAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,YAAY,CAAC;IACtB,OAAO,EAAE,oBAAoB,EAAE,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB,CAAC,KAAK,EAAE,QAAQ;IACpD,gDAAgD;IAChD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,oCAAoC;IACpC,OAAO,EAAE,QAAQ,CAAC;IAClB,kCAAkC;IAClC,KAAK,EAAE,KAAK,EAAE,CAAC;IACf,qCAAqC;IACrC,KAAK,EAAE,cAAc,CAAC;IACtB,sEAAsE;IACtE,UAAU,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,cAAc,KAAK;QAAE,IAAI,EAAE,KAAK,GAAG,IAAI,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3G,yDAAyD;IACzD,gBAAgB,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,KAAK,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACtI,4CAA4C;IAC5C,OAAO,EAAE,CAAC,IAAI,EAAE,KAAK,KAAK,MAAM,CAAC;CAClC;AAED;;;;;GAKG;AACH,wBAAsB,qBAAqB,CAAC,KAAK,EAAE,QAAQ,EACzD,OAAO,EAAE,qBAAqB,CAAC,KAAK,EAAE,QAAQ,CAAC,GAC9C,OAAO,CAAC,WAAW,CAAC,CAkFtB;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI,CAyDlF;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAExD"}

package/dist/cli/batch.js

@@ -0,0 +1,162 @@
+/**
+ * Shared utilities for batch operations on multiple refs.
+ * Supports --refs @a @b @c flag pattern for commands like task complete, cancel, etc.
+ */
+import chalk from 'chalk';
+import { error, isJsonMode } from './output.js';
+import { EXIT_CODES } from './exit-codes.js';
+/**
+ * Execute a batch operation with support for single-ref (positional) or multi-ref (--refs flag).
+ * Handles mutual exclusion, partial failures, and unified output formatting.
+ *
+ * Returns a BatchResult object. Caller should use formatBatchOutput() to render results.
+ */
+export async function executeBatchOperation(options) {
+    const { positionalRef, refsFlag, context, items, index, resolveRef, executeOperation, getUlid } = options;
+    // AC: @multi-ref-batch ac-3 - Mutual exclusion check
+    if (positionalRef && refsFlag && refsFlag.length > 0) {
+        error('Cannot use both positional ref and --refs flag');
+        process.exit(EXIT_CODES.USAGE_ERROR);
+    }
+    // Determine which refs to process
+    let refs;
+    if (refsFlag && refsFlag.length > 0) {
+        refs = refsFlag;
+    }
+    else if (positionalRef) {
+        refs = [positionalRef];
+    }
+    else {
+        // AC: @multi-ref-batch ac-7 - Empty refs error
+        error('--refs requires at least one reference');
+        process.exit(EXIT_CODES.USAGE_ERROR);
+    }
+    // Process each ref
+    const results = [];
+    // AC: @multi-ref-batch ac-4 - Continue processing after errors (partial failure handling)
+    for (const ref of refs) {
+        try {
+            // AC: @multi-ref-batch ac-8 - Ref resolution uses existing logic
+            const resolved = resolveRef(ref, items, index);
+            if (!resolved.item) {
+                // Resolution failed - record error and continue to next ref
+                results.push({
+                    ref,
+                    ulid: null,
+                    status: 'error',
+                    error: resolved.error || `Failed to resolve reference: ${ref}`,
+                });
+                continue;
+            }
+            const ulid = getUlid(resolved.item);
+            // Execute the operation
+            const opResult = await executeOperation(resolved.item, context);
+            results.push({
+                ref,
+                ulid: index.shortUlid(ulid),
+                status: opResult.success ? 'success' : 'error',
+                message: opResult.message,
+                error: opResult.error,
+                data: opResult.data,
+            });
+        }
+        catch (err) {
+            // Unexpected error during operation
+            results.push({
+                ref,
+                ulid: null,
+                status: 'error',
+                error: err instanceof Error ? err.message : String(err),
+            });
+        }
+    }
+    // Calculate summary
+    const succeeded = results.filter(r => r.status === 'success').length;
+    const failed = results.filter(r => r.status === 'error').length;
+    const summary = {
+        total: results.length,
+        succeeded,
+        failed,
+    };
+    // Determine overall success
+    const success = failed === 0;
+    return {
+        success,
+        summary,
+        results,
+    };
+}
+/**
+ * Format and output batch operation results.
+ * Handles both human-readable and JSON output formats.
+ * Sets appropriate exit code based on results.
+ *
+ * AC: @multi-ref-batch ac-5 - Human output format
+ * AC: @multi-ref-batch ac-6 - JSON output format
+ */
+export function formatBatchOutput(result, operationName) {
+    if (isJsonMode()) {
+        // AC: @multi-ref-batch ac-6 - JSON output
+        console.log(JSON.stringify(result, null, 2));
+    }
+    else {
+        // AC: @multi-ref-batch ac-5 - Human output format
+        const { summary, results } = result;
+        // Summary line
+        if (summary.total === 1) {
+            // Single item - no summary needed, just show result
+            const r = results[0];
+            if (r.status === 'success') {
+                console.log(chalk.green(`✓ ${operationName}: ${r.ulid || r.ref}`));
+                if (r.message) {
+                    console.log(`  ${r.message}`);
+                }
+            }
+            else {
+                console.log(chalk.red(`✗ ${operationName} failed: ${r.ref}`));
+                if (r.error) {
+                    console.log(chalk.red(`  ${r.error}`));
+                }
+            }
+        }
+        else {
+            // Multiple items - show summary
+            const verb = operationName.toLowerCase();
+            console.log(`${chalk.bold(`${operationName}d ${summary.succeeded} of ${summary.total}:`)}\n`);
+            // List each result
+            for (const r of results) {
+                if (r.status === 'success') {
+                    console.log(chalk.green(`✓ ${r.ulid || r.ref}`));
+                    if (r.message) {
+                        console.log(`  ${r.message}`);
+                    }
+                }
+                else {
+                    console.log(chalk.red(`✗ ${r.ref}`));
+                    if (r.error) {
+                        console.log(chalk.red(`  ${r.error}`));
+                    }
+                }
+            }
+        }
+    }
+    // Set exit code
+    // AC: @multi-ref-batch ac-4 - Partial failure exit code
+    if (!result.success) {
+        if (result.summary.succeeded > 0) {
+            // Partial failure
+            process.exit(EXIT_CODES.ERROR);
+        }
+        else {
+            // Complete failure
+            process.exit(EXIT_CODES.ERROR);
+        }
+    }
+}
+/**
+ * Helper to check if refs flag is being used (for backward compatibility checks)
+ */
+export function isBatchMode(refsFlag) {
+    return Boolean(refsFlag && refsFlag.length > 0);
+}
+//# sourceMappingURL=batch.js.map

package/dist/cli/batch.js.map

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

package/dist/cli/commands/clone-for-testing.d.ts

@@ -0,0 +1,6 @@
+import { Command } from 'commander';
+/**
+ * Register the 'clone-for-testing' command
+ */
+export declare function registerCloneForTestingCommand(program: Command): void;
+//# sourceMappingURL=clone-for-testing.d.ts.map

package/dist/cli/commands/clone-for-testing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clone-for-testing.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/clone-for-testing.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA0IpC;;GAEG;AACH,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA6DrE"}