@cleocode/cleo 2026.4.161 → 2026.5.1

package/dist/backfill/audit-columns.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Backfill audit columns (modified_by / session_id) for pre-ADR-051 completed tasks.
+ *
+ * 176 completed tasks shipped before ADR-051 have `modified_by=NULL` and
+ * `session_id=NULL`. This module uses the T1322 `reconstructLineage` SDK
+ * to mine git history for Co-Authored-By trailers, infers the modifying agent,
+ * and writes the result back via `accessor.updateTaskFields`.
+ *
+ * **Inference strategy (in order)**:
+ * 1. Get direct commits via `reconstructLineage(taskId, repoRoot)`.
+ * 2. For each direct commit SHA, fetch the full commit body and parse
+ *    `Co-Authored-By:` trailers → agent name.
+ * 3. Use the earliest Co-Authored-By agent as `modified_by`.
+ * 4. Match `completedAt` against known sessions (±60 min window).
+ * 5. Fall back to `"unknown-pre-adr-051"` when no evidence is found.
+ *
+ * Security: git subprocess uses `execFileSync` with strict `argv` arrays —
+ * no shell interpolation or user-controlled string concatenation in the
+ * command string.
+ *
+ * **Idempotency**: tasks already having a non-null `modified_by` are skipped.
+ *
+ * @task T1321
+ * @epic T1415
+ */
+/** Outcome record for a single task. */
+export interface AuditColumnBackfillEntry {
+    /** Task ID. */
+    taskId: string;
+    /** Task title (for human-readable reports). */
+    title: string;
+    /** Inferred agent name, or null on no-evidence gap. */
+    modifiedBy: string | null;
+    /** Inferred session ID, or null. */
+    sessionId: string | null;
+    /** True if git evidence was found (at least one direct commit). */
+    hasGitEvidence: boolean;
+    /** Number of direct commits found. */
+    directCommitCount: number;
+    /** The Co-Authored-By value extracted from git, if any. */
+    coAuthoredBy: string | null;
+    /** True when this task was skipped because modified_by was already set. */
+    alreadySet: boolean;
+    /** True when changes were written (not dry-run, not already-set). */
+    written: boolean;
+    /** Error message if something went wrong. */
+    error?: string;
+}
+/** Summary returned by `backfillAuditColumns`. */
+export interface AuditColumnBackfillResult {
+    /** True when run in preview mode (no writes). */
+    dryRun: boolean;
+    /** Total tasks in scope (done + archived with null modified_by). */
+    tasksInScope: number;
+    /** Tasks already having modified_by — skipped. */
+    alreadySet: number;
+    /** Tasks where git evidence was found and modified_by was inferred. */
+    inferred: number;
+    /** Tasks where no git evidence existed — fell back to unknown marker. */
+    gapCount: number;
+    /** IDs of gap tasks (no inference possible). */
+    gapTaskIds: string[];
+    /** Full per-task results. */
+    entries: AuditColumnBackfillEntry[];
+}
+/** Options for `backfillAuditColumns`. */
+export interface AuditColumnBackfillOptions {
+    /** Preview mode: compute inference but do not write. Default: false. */
+    dryRun?: boolean;
+    /** Restrict processing to these task IDs (default: all eligible tasks). */
+    taskIds?: string[];
+    /** Absolute path to the git repo root. Defaults to projectRoot. */
+    repoRoot?: string;
+}
+/**
+ * Backfill `modified_by` and `session_id` for pre-ADR-051 completed tasks.
+ *
+ * Processes all tasks whose `status` is `done` or `archived` and whose
+ * `provenance.modifiedBy` is null. For each, calls `reconstructLineage` to
+ * mine git commit history, extracts the `Co-Authored-By` agent, and writes
+ * the inferred values via `accessor.updateTaskFields`.
+ *
+ * Tasks with no git evidence receive the fallback marker
+ * `"unknown-pre-adr-051"` as `modified_by` so they are no longer in the
+ * null cohort (and the gap is documented).
+ *
+ * @param projectRoot - Absolute path to the CLEO project root.
+ * @param options - Backfill options (dryRun, taskIds, repoRoot).
+ * @returns Full summary including per-task entries and gap list.
+ *
+ * @example
+ * ```ts
+ * // Dry run — preview only
+ * const result = await backfillAuditColumns('/my/project', { dryRun: true });
+ * console.log(`Would backfill ${result.inferred} tasks, ${result.gapCount} gaps`);
+ *
+ * // Apply
+ * await backfillAuditColumns('/my/project');
+ * ```
+ *
+ * @task T1321
+ * @epic T1415
+ */
+export declare function backfillAuditColumns(projectRoot: string, options?: AuditColumnBackfillOptions): Promise<AuditColumnBackfillResult>;
+//# sourceMappingURL=audit-columns.d.ts.map

package/dist/backfill/audit-columns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-columns.d.ts","sourceRoot":"","sources":["../../src/backfill/audit-columns.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAUH,wCAAwC;AACxC,MAAM,WAAW,wBAAwB;IACvC,eAAe;IACf,MAAM,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,uDAAuD;IACvD,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,oCAAoC;IACpC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,mEAAmE;IACnE,cAAc,EAAE,OAAO,CAAC;IACxB,sCAAsC;IACtC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,2DAA2D;IAC3D,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,2EAA2E;IAC3E,UAAU,EAAE,OAAO,CAAC;IACpB,qEAAqE;IACrE,OAAO,EAAE,OAAO,CAAC;IACjB,6CAA6C;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,kDAAkD;AAClD,MAAM,WAAW,yBAAyB;IACxC,iDAAiD;IACjD,MAAM,EAAE,OAAO,CAAC;IAChB,oEAAoE;IACpE,YAAY,EAAE,MAAM,CAAC;IACrB,kDAAkD;IAClD,UAAU,EAAE,MAAM,CAAC;IACnB,uEAAuE;IACvE,QAAQ,EAAE,MAAM,CAAC;IACjB,yEAAyE;IACzE,QAAQ,EAAE,MAAM,CAAC;IACjB,gDAAgD;IAChD,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,6BAA6B;IAC7B,OAAO,EAAE,wBAAwB,EAAE,CAAC;CACrC;AAED,0CAA0C;AAC1C,MAAM,WAAW,0BAA0B;IACzC,wEAAwE;IACxE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,mEAAmE;IACnE,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AA4FD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAsB,oBAAoB,CACxC,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,0BAA+B,GACvC,OAAO,CAAC,yBAAyB,CAAC,CAuIpC"}

package/dist/backfill/audit-columns.js

@@ -0,0 +1,258 @@
+/**
+ * Backfill audit columns (modified_by / session_id) for pre-ADR-051 completed tasks.
+ *
+ * 176 completed tasks shipped before ADR-051 have `modified_by=NULL` and
+ * `session_id=NULL`. This module uses the T1322 `reconstructLineage` SDK
+ * to mine git history for Co-Authored-By trailers, infers the modifying agent,
+ * and writes the result back via `accessor.updateTaskFields`.
+ *
+ * **Inference strategy (in order)**:
+ * 1. Get direct commits via `reconstructLineage(taskId, repoRoot)`.
+ * 2. For each direct commit SHA, fetch the full commit body and parse
+ *    `Co-Authored-By:` trailers → agent name.
+ * 3. Use the earliest Co-Authored-By agent as `modified_by`.
+ * 4. Match `completedAt` against known sessions (±60 min window).
+ * 5. Fall back to `"unknown-pre-adr-051"` when no evidence is found.
+ *
+ * Security: git subprocess uses `execFileSync` with strict `argv` arrays —
+ * no shell interpolation or user-controlled string concatenation in the
+ * command string.
+ *
+ * **Idempotency**: tasks already having a non-null `modified_by` are skipped.
+ *
+ * @task T1321
+ * @epic T1415
+ */
+import { execFileSync } from 'node:child_process';
+import { getAccessor, reconstructLineage } from '@cleocode/core/internal';
+// ---------------------------------------------------------------------------
+// Internal helpers — git subprocess (strict argv, no shell interpolation)
+// ---------------------------------------------------------------------------
+/**
+ * Run a git command with strict argv (no shell interpolation).
+ *
+ * @param cwd - Working directory.
+ * @param args - Argument list passed directly to git.
+ * @returns stdout as a trimmed UTF-8 string, or `""` on error.
+ */
+function runGit(cwd, args) {
+    try {
+        const output = execFileSync('git', [...args], {
+            cwd,
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+            maxBuffer: 4 * 1024 * 1024,
+        });
+        return output.trim();
+    }
+    catch {
+        return '';
+    }
+}
+/**
+ * Fetch the full commit body for a SHA and extract `Co-Authored-By:` trailers.
+ *
+ * Returns the first Co-Authored-By name found (e.g. `"Claude Sonnet 4.6"`),
+ * or `null` when none is present.
+ *
+ * @param repoRoot - Absolute path to the git repository.
+ * @param sha - Full commit SHA.
+ */
+function extractCoAuthoredBy(repoRoot, sha) {
+    const body = runGit(repoRoot, ['log', '-1', '--format=%B', sha]);
+    if (!body)
+        return null;
+    for (const line of body.split('\n')) {
+        const trimmed = line.trim();
+        // Match both "Co-Authored-By:" and "Co-authored-by:" (case-insensitive)
+        const match = trimmed.match(/^Co-Authored-By:\s*(.+?)\s*<[^>]+>\s*$/i);
+        if (match?.[1]) {
+            return match[1].trim();
+        }
+    }
+    return null;
+}
+// ---------------------------------------------------------------------------
+// Session lookup helpers
+// ---------------------------------------------------------------------------
+/**
+ * Find a session whose `endedAt` or `startedAt` window overlaps the given
+ * task `completedAt` timestamp (±60 minutes tolerance).
+ *
+ * Returns the session ID string, or `null` when no match is found.
+ *
+ * @param sessions - All sessions loaded from the accessor.
+ * @param completedAt - ISO-8601 timestamp of when the task was completed.
+ */
+function findSessionForCompletedAt(sessions, completedAt) {
+    if (!completedAt)
+        return null;
+    const completedMs = Date.parse(completedAt);
+    if (Number.isNaN(completedMs))
+        return null;
+    const WINDOW_MS = 60 * 60 * 1000; // 60 minutes
+    for (const session of sessions) {
+        const startMs = Date.parse(session.startedAt);
+        const endMs = session.endedAt ? Date.parse(session.endedAt) : null;
+        // Task was completed inside or near this session's time range
+        if (!Number.isNaN(startMs)) {
+            const sessionEnd = endMs ?? startMs + 24 * 60 * 60 * 1000; // 24h fallback
+            if (completedMs >= startMs - WINDOW_MS && completedMs <= sessionEnd + WINDOW_MS) {
+                return session.id;
+            }
+        }
+    }
+    return null;
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Backfill `modified_by` and `session_id` for pre-ADR-051 completed tasks.
+ *
+ * Processes all tasks whose `status` is `done` or `archived` and whose
+ * `provenance.modifiedBy` is null. For each, calls `reconstructLineage` to
+ * mine git commit history, extracts the `Co-Authored-By` agent, and writes
+ * the inferred values via `accessor.updateTaskFields`.
+ *
+ * Tasks with no git evidence receive the fallback marker
+ * `"unknown-pre-adr-051"` as `modified_by` so they are no longer in the
+ * null cohort (and the gap is documented).
+ *
+ * @param projectRoot - Absolute path to the CLEO project root.
+ * @param options - Backfill options (dryRun, taskIds, repoRoot).
+ * @returns Full summary including per-task entries and gap list.
+ *
+ * @example
+ * ```ts
+ * // Dry run — preview only
+ * const result = await backfillAuditColumns('/my/project', { dryRun: true });
+ * console.log(`Would backfill ${result.inferred} tasks, ${result.gapCount} gaps`);
+ *
+ * // Apply
+ * await backfillAuditColumns('/my/project');
+ * ```
+ *
+ * @task T1321
+ * @epic T1415
+ */
+export async function backfillAuditColumns(projectRoot, options = {}) {
+    const { dryRun = false, taskIds, repoRoot = projectRoot } = options;
+    const accessor = await getAccessor(projectRoot);
+    // --- Load sessions for window-based session_id lookup ---
+    const sessions = await accessor.loadSessions();
+    // --- Collect eligible tasks: done + archived, NULL modified_by ---
+    // Query done tasks
+    const { tasks: doneTasks } = await accessor.queryTasks({ status: 'done' });
+    // Query archived tasks (need to include archived in status)
+    const { tasks: archivedTasks } = await accessor.queryTasks({ status: 'archived' });
+    const allCompletedTasks = [...doneTasks, ...archivedTasks];
+    // Filter: null or missing modifiedBy only
+    const eligible = allCompletedTasks.filter((t) => !t.provenance?.modifiedBy);
+    // Optionally restrict to provided task IDs
+    const inScope = taskIds ? eligible.filter((t) => taskIds.includes(t.id)) : eligible;
+    const entries = [];
+    let alreadySetCount = 0;
+    let inferredCount = 0;
+    let gapCount = 0;
+    const gapTaskIds = [];
+    const now = new Date().toISOString();
+    for (const task of inScope) {
+        // Double-check: skip if already set (idempotent guard)
+        if (task.provenance?.modifiedBy) {
+            entries.push({
+                taskId: task.id,
+                title: task.title,
+                modifiedBy: task.provenance.modifiedBy,
+                sessionId: task.provenance.sessionId ?? null,
+                hasGitEvidence: false,
+                directCommitCount: 0,
+                coAuthoredBy: null,
+                alreadySet: true,
+                written: false,
+            });
+            alreadySetCount++;
+            continue;
+        }
+        let coAuthoredBy = null;
+        let hasGitEvidence = false;
+        let directCommitCount = 0;
+        let errorMsg;
+        try {
+            // Mine git history via T1322 reconstructLineage SDK
+            const lineage = await reconstructLineage(task.id, repoRoot);
+            directCommitCount = lineage.directCommits.length;
+            hasGitEvidence = directCommitCount > 0;
+            // Extract Co-Authored-By from earliest direct commit
+            if (hasGitEvidence) {
+                // Sort by authorDate ascending to get the earliest commit first
+                const sorted = [...lineage.directCommits].sort((a, b) => a.authorDate < b.authorDate ? -1 : a.authorDate > b.authorDate ? 1 : 0);
+                for (const commit of sorted) {
+                    const coAuthor = extractCoAuthoredBy(repoRoot, commit.sha);
+                    if (coAuthor) {
+                        coAuthoredBy = coAuthor;
+                        break;
+                    }
+                }
+                // If no Co-Authored-By trailer found, use the commit author as fallback
+                if (!coAuthoredBy && sorted[0]) {
+                    coAuthoredBy = sorted[0].author;
+                }
+            }
+        }
+        catch (err) {
+            errorMsg = err instanceof Error ? err.message : String(err);
+        }
+        // Determine final modifiedBy value
+        const modifiedBy = coAuthoredBy ?? 'unknown-pre-adr-051';
+        const isGap = !hasGitEvidence || !coAuthoredBy;
+        if (isGap) {
+            gapCount++;
+            gapTaskIds.push(task.id);
+        }
+        else {
+            inferredCount++;
+        }
+        // Session ID: window-based lookup against task completedAt
+        const sessionId = findSessionForCompletedAt(sessions, task.completedAt ?? null);
+        const entry = {
+            taskId: task.id,
+            title: task.title,
+            modifiedBy,
+            sessionId,
+            hasGitEvidence,
+            directCommitCount,
+            coAuthoredBy,
+            alreadySet: false,
+            written: false,
+            error: errorMsg,
+        };
+        // Write unless dry-run
+        if (!dryRun) {
+            try {
+                await accessor.updateTaskFields(task.id, {
+                    modifiedBy,
+                    sessionId: sessionId ?? null,
+                    updatedAt: now,
+                });
+                entry.written = true;
+            }
+            catch (writeErr) {
+                entry.error =
+                    (entry.error ? `${entry.error}; ` : '') +
+                        `write failed: ${writeErr instanceof Error ? writeErr.message : String(writeErr)}`;
+            }
+        }
+        entries.push(entry);
+    }
+    return {
+        dryRun,
+        tasksInScope: inScope.length,
+        alreadySet: alreadySetCount,
+        inferred: inferredCount,
+        gapCount,
+        gapTaskIds,
+        entries,
+    };
+}
+//# sourceMappingURL=audit-columns.js.map

package/dist/backfill/audit-columns.js.map

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

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

@@ -0,0 +1,28 @@
+/**
+ * CLI command group for provider adapter management operations.
+ *
+ * Exposes all tools.adapter.* operations as a native citty subcommand group:
+ *
+ *   cleo adapter list     — list all discovered provider adapters
+ *   cleo adapter show     — show details for a specific adapter
+ *   cleo adapter detect   — detect active providers in current environment
+ *   cleo adapter health   — health status for adapters
+ *   cleo adapter activate — load and activate a provider adapter
+ *   cleo adapter dispose  — dispose one or all adapters
+ *
+ * Default action (no subcommand) delegates to adapter.list.
+ *
+ * @task T479
+ * @epic T443
+ */
+/**
+ * Root adapter command group — registers all adapter subcommands.
+ *
+ * Default run (no subcommand) delegates to adapter.list.
+ * Dispatches to `tools.adapter.*` registry operations.
+ *
+ * @task T479
+ * @epic T443
+ */
+export declare const adapterCommand: import("citty").CommandDef<import("citty").ArgsDef>;
+//# sourceMappingURL=adapter.d.ts.map

package/dist/cli/commands/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAoHH;;;;;;;;GAQG;AACH,eAAO,MAAM,cAAc,qDAyBzB,CAAC"}

package/dist/cli/commands/adapter.js

@@ -0,0 +1,119 @@
+/**
+ * CLI command group for provider adapter management operations.
+ *
+ * Exposes all tools.adapter.* operations as a native citty subcommand group:
+ *
+ *   cleo adapter list     — list all discovered provider adapters
+ *   cleo adapter show     — show details for a specific adapter
+ *   cleo adapter detect   — detect active providers in current environment
+ *   cleo adapter health   — health status for adapters
+ *   cleo adapter activate — load and activate a provider adapter
+ *   cleo adapter dispose  — dispose one or all adapters
+ *
+ * Default action (no subcommand) delegates to adapter.list.
+ *
+ * @task T479
+ * @epic T443
+ */
+import { defineCommand } from 'citty';
+import { dispatchFromCli } from '../../dispatch/adapters/cli.js';
+import { isSubCommandDispatch } from '../lib/subcommand-guard.js';
+/** cleo adapter list — list all discovered provider adapters */
+const listCommand = defineCommand({
+    meta: { name: 'list', description: 'List all discovered provider adapters' },
+    async run() {
+        await dispatchFromCli('query', 'tools', 'adapter.list', {}, { command: 'adapter', operation: 'tools.adapter.list' });
+    },
+});
+/** cleo adapter show — show details for a specific adapter */
+const showCommand = defineCommand({
+    meta: { name: 'show', description: 'Show details for a specific adapter' },
+    args: {
+        adapterId: {
+            type: 'positional',
+            description: 'Adapter ID to inspect',
+            required: true,
+        },
+    },
+    async run({ args }) {
+        await dispatchFromCli('query', 'tools', 'adapter.show', { id: args.adapterId }, { command: 'adapter', operation: 'tools.adapter.show' });
+    },
+});
+/** cleo adapter detect — detect active providers in the current environment */
+const detectCommand = defineCommand({
+    meta: { name: 'detect', description: 'Detect active providers in the current environment' },
+    async run() {
+        await dispatchFromCli('query', 'tools', 'adapter.detect', {}, { command: 'adapter', operation: 'tools.adapter.detect' });
+    },
+});
+/** cleo adapter health — show health status for adapters */
+const healthCommand = defineCommand({
+    meta: { name: 'health', description: 'Show health status for adapters' },
+    args: {
+        id: {
+            type: 'string',
+            description: 'Specific adapter ID (omit for all adapters)',
+        },
+    },
+    async run({ args }) {
+        await dispatchFromCli('query', 'tools', 'adapter.health', { id: args.id }, { command: 'adapter', operation: 'tools.adapter.health' });
+    },
+});
+/** cleo adapter activate — load and activate a provider adapter */
+const activateCommand = defineCommand({
+    meta: { name: 'activate', description: 'Load and activate a provider adapter' },
+    args: {
+        adapterId: {
+            type: 'positional',
+            description: 'Adapter ID to activate',
+            required: true,
+        },
+    },
+    async run({ args }) {
+        await dispatchFromCli('mutate', 'tools', 'adapter.activate', { id: args.adapterId }, { command: 'adapter', operation: 'tools.adapter.activate' });
+    },
+});
+/** cleo adapter dispose — dispose one or all adapters */
+const disposeCommand = defineCommand({
+    meta: { name: 'dispose', description: 'Dispose one or all adapters' },
+    args: {
+        id: {
+            type: 'string',
+            description: 'Specific adapter ID to dispose (omit to dispose all)',
+        },
+    },
+    async run({ args }) {
+        await dispatchFromCli('mutate', 'tools', 'adapter.dispose', { id: args.id }, { command: 'adapter', operation: 'tools.adapter.dispose' });
+    },
+});
+/**
+ * Root adapter command group — registers all adapter subcommands.
+ *
+ * Default run (no subcommand) delegates to adapter.list.
+ * Dispatches to `tools.adapter.*` registry operations.
+ *
+ * @task T479
+ * @epic T443
+ */
+export const adapterCommand = defineCommand({
+    meta: {
+        name: 'adapter',
+        description: 'Provider adapter management: list, show, detect, health, activate, dispose',
+    },
+    subCommands: {
+        list: listCommand,
+        show: showCommand,
+        detect: detectCommand,
+        health: healthCommand,
+        activate: activateCommand,
+        dispose: disposeCommand,
+    },
+    async run({ cmd, rawArgs }) {
+        // Skip default dispatch when citty routes to a subcommand
+        // (parent run() fires AFTER subcommand per citty@0.2.x). T1187-followup.
+        if (isSubCommandDispatch(rawArgs, cmd.subCommands))
+            return;
+        await dispatchFromCli('query', 'tools', 'adapter.list', {}, { command: 'adapter', operation: 'tools.adapter.list' });
+    },
+});
+//# sourceMappingURL=adapter.js.map

package/dist/cli/commands/adapter.js.map

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

package/dist/cli/commands/add-batch.d.ts

@@ -0,0 +1,33 @@
+/**
+ * CLI add-batch command — atomic batch creation of multiple tasks.
+ *
+ * Reads a JSON array of task definitions from a file or stdin and creates
+ * them atomically. More reliable than N sequential `cleo add` calls during
+ * epic decomposition.
+ *
+ * @task T090
+ */
+/**
+ * Native citty command for atomic batch creation of multiple tasks.
+ *
+ * Reads a JSON array of task definitions from a file or stdin and dispatches
+ * each as a `tasks.add` mutation. Partial failures are reported with a
+ * non-zero exit code while still reporting successful creations.
+ *
+ * @task T090
+ */
+export declare const addBatchCommand: import("citty").CommandDef<{
+    readonly file: {
+        readonly type: "string";
+        readonly description: "Path to JSON file (array of task objects). Use - for stdin.";
+    };
+    readonly parent: {
+        readonly type: "string";
+        readonly description: "Default parent for all tasks (overridden by per-task parent)";
+    };
+    readonly 'dry-run': {
+        readonly type: "boolean";
+        readonly description: "Preview what would be created without making changes";
+    };
+}>;
+//# sourceMappingURL=add-batch.d.ts.map

package/dist/cli/commands/add-batch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add-batch.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/add-batch.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAuBH;;;;;;;;GAQG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;EAqJ1B,CAAC"}