@planu/cli 0.90.2 → 0.91.0

package/dist/tools/facilitate.js

@@ -1,13 +1,15 @@
 import { scoreAmbiguity, shouldBlock } from '../engine/ambiguity-detector.js';
 import { setFocus, getFocus, checkFocusDrift, parseChangeFocusDirective, } from '../engine/focus-tracker.js';
 import { getParadigmRecommendations, formatParadigmObservations, } from '../engine/paradigm-advisor.js';
+import { classifyIntent } from '../engine/facilitate/intent-classifier.js';
+import { loadContext } from '../engine/facilitate/context-loader.js';
+import { route } from '../engine/facilitate/router.js';
+import { parsePlanContent } from '../engine/facilitate/plan-parser.js';
 // ---------------------------------------------------------------------------
-// Scenario detection
+// Scenario detection (SPEC-037 legacy — kept for backward compatibility)
 // ---------------------------------------------------------------------------
 function detectScenario(description) {
     const lower = description.toLowerCase();
-    // Concrete problem indicators — check before existing_project to avoid
-    // false positives with phrases like "existing spec"
     if (lower.includes('how to') ||
         lower.includes('how do i') ||
         lower.includes('what tool') ||
@@ -17,13 +19,11 @@ function detectScenario(description) {
         lower.includes('problem')) {
         return 'concrete_problem';
     }
-    // Existing project indicators
     if (lower.includes('already have') ||
         lower.includes('my project') ||
         lower.includes('our project') ||
         /existing project/i.test(description) ||
-        lower.includes('/') // path-like input
-    ) {
+        lower.includes('/')) {
         return 'existing_project';
     }
     return 'new_project';
@@ -44,7 +44,6 @@ function buildNewProjectResponse(step, collectedInfo) {
             : `Got it! ${Object.values(collectedInfo).join(', ')}\n\n`;
         return `${intro}Step ${step + 1}/3: ${question}`;
     }
-    // All 3 steps complete — suggest create_spec
     const info = Object.values(collectedInfo).join(' | ');
     return (`Great — I have enough context to generate your spec.\n\n` +
         `Summary: ${info}\n\n` +
@@ -97,10 +96,6 @@ function buildConcreteProblemResponse(description) {
 // ---------------------------------------------------------------------------
 // Paradigm observations (SPEC-035b)
 // ---------------------------------------------------------------------------
-/**
- * Builds paradigm expert voice observations from a pre-computed ParadigmReport.
- * Degrades gracefully when no detection data is available.
- */
 export function buildParadigmObservations(paradigmReport) {
     if (!paradigmReport) {
         return '';
@@ -145,11 +140,97 @@ function generateExpertObservations(description) {
     return observations;
 }
 // ---------------------------------------------------------------------------
+// SPEC-264: Routing suggestion text
+// ---------------------------------------------------------------------------
+function buildRoutingSuggestion(decision) {
+    switch (decision.action) {
+        case 'resume':
+            return `Resume work on spec ${decision.specId} — it matches your request and is in progress.`;
+        case 'create-spec':
+            return `Create a new spec for this ${decision.type} request using \`create_spec\`.`;
+        case 'direct':
+            return decision.reason;
+        case 'clarify':
+            return decision.question;
+    }
+}
+// ---------------------------------------------------------------------------
+// SPEC-264: Smart orchestrator path
+// ---------------------------------------------------------------------------
+async function runSmartOrchestrator(description, projectId, planContent) {
+    // 1. Classify intent
+    const intent = classifyIntent(description);
+    // 2. Load context from project data
+    const projectPath = projectId ?? process.cwd();
+    const ctx = await loadContext(projectPath, intent.keywords);
+    // 3. Handle Plan Mode content
+    let parsedPlan = null;
+    let effectiveDescription = description;
+    if (planContent) {
+        parsedPlan = parsePlanContent(planContent);
+        if (parsedPlan) {
+            effectiveDescription =
+                `${parsedPlan.title}: ` + parsedPlan.acceptanceCriteria.slice(0, 3).join('; ');
+        }
+    }
+    // 4. Route
+    const decision = route(intent, ctx, effectiveDescription);
+    // 5. Build compact response (≤150 tokens main content)
+    const result = {
+        action: 'facilitate',
+        routing: decision,
+        context: {
+            activeCount: ctx.activeSpecs.length,
+            relatedFound: ctx.relatedSpecs.map((s) => s.id),
+        },
+        intent: {
+            type: intent.type,
+            complexity: intent.complexity,
+            confidence: intent.confidence,
+        },
+        suggestion: buildRoutingSuggestion(decision),
+    };
+    if (parsedPlan) {
+        result.parsedPlan = {
+            title: parsedPlan.title,
+            acCount: parsedPlan.acceptanceCriteria.length,
+            estimatedComplexity: parsedPlan.estimatedComplexity,
+        };
+    }
+    return result;
+}
+// ---------------------------------------------------------------------------
 // Main handler
 // ---------------------------------------------------------------------------
-export function handleFacilitate(params) {
-    const { description, projectId, sessionId, scenario: explicitScenario, collectedInfo = {}, step = 0, targetTool, checkFocus = false, changeFocus, paradigmReport, } = params;
+export async function handleFacilitate(params) {
+    const { description, projectId, sessionId, scenario: explicitScenario, collectedInfo = {}, step = 0, targetTool, checkFocus = false, changeFocus, paradigmReport, planContent, } = params;
     const sessionKey = sessionId ?? projectId ?? 'default';
+    // SPEC-264: When planContent provided OR no explicit scenario/control params given,
+    // use the smart orchestrator path.
+    const useSmartOrchestrator = planContent !== undefined ||
+        (explicitScenario === undefined &&
+            targetTool === undefined &&
+            !checkFocus &&
+            changeFocus === undefined);
+    if (useSmartOrchestrator) {
+        try {
+            const orchestratorResult = await runSmartOrchestrator(description, projectId, planContent);
+            const observations = generateExpertObservations(description);
+            const paradigmObs = buildParadigmObservations(paradigmReport);
+            const merged = { ...orchestratorResult };
+            if (observations.length > 0) {
+                merged.expertObservations = observations;
+            }
+            if (paradigmObs) {
+                merged.paradigmObservations = paradigmObs;
+            }
+            return ok(merged);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return ok({ action: 'facilitate', error: message, fallback: true });
+        }
+    }
     try {
         // --- Focus change directive ---
         const changeFocusText = changeFocus ?? parseChangeFocusDirective(description);
@@ -204,9 +285,8 @@ export function handleFacilitate(params) {
                 message: `Request is clear enough for \`${targetTool}\`. Proceed.`,
             });
         }
-        // --- Main facilitate flow ---
+        // --- Main facilitate flow (legacy scenario-based) ---
         const scenario = explicitScenario ?? detectScenario(description);
-        // Set initial focus for new sessions
         const existingFocus = getFocus(sessionKey);
         if (!existingFocus) {
             setFocus(sessionKey, {
@@ -214,12 +294,10 @@ export function handleFacilitate(params) {
                 startedAt: new Date().toISOString(),
             });
         }
-        // Generate expert observations (non-blocking)
         const observations = generateExpertObservations(description);
         let guidance;
         switch (scenario) {
             case 'new_project': {
-                // Merge current description into collectedInfo for current step
                 const updatedInfo = step === 0
                     ? { ...collectedInfo, step0: description }
                     : { ...collectedInfo, [`step${step}`]: description };
@@ -233,22 +311,21 @@ export function handleFacilitate(params) {
                 guidance = buildConcreteProblemResponse(description);
                 break;
         }
-        const result = {
+        const legacyResult = {
             action: 'facilitate',
             scenario,
             step,
             guidance,
         };
         if (observations.length > 0) {
-            result.expertObservations = observations;
-            result.expertNote = 'Expert observations added below — these do not block execution.';
+            legacyResult.expertObservations = observations;
+            legacyResult.expertNote = 'Expert observations added below — these do not block execution.';
         }
-        // SPEC-035b: Append paradigm expert voice observations when detection data is available
         const paradigmObservations = buildParadigmObservations(paradigmReport);
         if (paradigmObservations) {
-            result.paradigmObservations = paradigmObservations;
+            legacyResult.paradigmObservations = paradigmObservations;
         }
-        return ok(result);
+        return ok(legacyResult);
     }
     catch (error) {
         const message = error instanceof Error ? error.message : String(error);

package/dist/tools/facilitate.js.map

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

package/dist/tools/generate-automation-guide.d.ts

@@ -0,0 +1,10 @@
+import { z } from 'zod';
+import type { ToolResult } from '../types/index.js';
+export declare const GenerateAutomationGuideInputSchema: z.ZodObject<{
+    projectPath: z.ZodString;
+    saveToDisk: z.ZodOptional<z.ZodBoolean>;
+    includeExamples: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type GenerateAutomationGuideInput = z.infer<typeof GenerateAutomationGuideInputSchema>;
+export declare function handleGenerateAutomationGuide(args: GenerateAutomationGuideInput): Promise<ToolResult>;
+//# sourceMappingURL=generate-automation-guide.d.ts.map

package/dist/tools/generate-automation-guide.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-automation-guide.d.ts","sourceRoot":"","sources":["../../src/tools/generate-automation-guide.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAOpD,eAAO,MAAM,kCAAkC;;;;iBAO7C,CAAC;AAEH,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kCAAkC,CAAC,CAAC;AAiQ9F,wBAAsB,6BAA6B,CACjD,IAAI,EAAE,4BAA4B,GACjC,OAAO,CAAC,UAAU,CAAC,CAiCrB"}

package/dist/tools/generate-automation-guide.js

@@ -0,0 +1,222 @@
+// tools/generate-automation-guide.ts — Generate Claude Code automation guide (SPEC-257)
+import { mkdir, writeFile } from 'fs/promises';
+import { dirname } from 'path';
+import { z } from 'zod';
+import { buildClaudeCommand, generateStreamJsonPipeline, getJobPermissionMode, } from '../engine/ci-generator/output-formats.js';
+export const GenerateAutomationGuideInputSchema = z.object({
+    projectPath: z.string().describe('Absolute path to the project root'),
+    saveToDisk: z.boolean().optional().describe('Save guide to docs/automation-guide.md'),
+    includeExamples: z
+        .boolean()
+        .optional()
+        .describe('Include code examples for each section (default: true)'),
+});
+function buildGuide(includeExamples) {
+    const sections = [];
+    sections.push('# Claude Code Automation Guide');
+    sections.push('');
+    sections.push('> This guide covers how to automate Claude Code in CI pipelines, scheduled tasks, and non-interactive workflows.');
+    sections.push('');
+    // Section 1: Non-interactive mode
+    sections.push('## 1. Non-Interactive Mode (`claude -p`)');
+    sections.push('');
+    sections.push('The `-p` flag runs Claude non-interactively — a single prompt, then Claude exits. Ideal for one-off queries and CI pipelines.');
+    sections.push('');
+    if (includeExamples) {
+        sections.push('```bash');
+        sections.push(buildClaudeCommand({ prompt: 'Summarize all failing tests', nonInteractive: true }));
+        sections.push(buildClaudeCommand({
+            prompt: 'Check for security issues',
+            nonInteractive: true,
+            permissionMode: 'plan',
+        }));
+        sections.push('```');
+        sections.push('');
+    }
+    // Section 2: Output formats
+    sections.push('## 2. Output Formats');
+    sections.push('');
+    sections.push('Three output formats are available. Choose based on your integration needs:');
+    sections.push('');
+    sections.push('| Format | Description | Best for |');
+    sections.push('|--------|-------------|----------|');
+    sections.push('| `text` | Plain text response (default) | Human-readable output, logs |');
+    sections.push('| `json` | Full conversation as JSON | Structured parsing, audit trails |');
+    sections.push('| `stream-json` | Real-time JSON events streamed | Live dashboards, piping to `jq` |');
+    sections.push('');
+    if (includeExamples) {
+        sections.push('```bash');
+        sections.push('# text (default)');
+        sections.push(buildClaudeCommand({ prompt: 'List all TODOs', nonInteractive: true }));
+        sections.push('');
+        sections.push('# json — full conversation object');
+        sections.push(buildClaudeCommand({
+            prompt: 'Audit dependencies',
+            nonInteractive: true,
+            outputFormat: 'json',
+        }));
+        sections.push('');
+        sections.push('# stream-json — pipe to jq for filtering');
+        sections.push(generateStreamJsonPipeline('Run linter and report issues', '.content'));
+        sections.push('```');
+        sections.push('');
+    }
+    // Section 3: Permission modes
+    sections.push('## 3. Permission Modes');
+    sections.push('');
+    sections.push('Permission modes control what actions Claude can take without asking for confirmation:');
+    sections.push('');
+    sections.push('| Mode | Description | When to use |');
+    sections.push('|------|-------------|-------------|');
+    sections.push('| `plan` | Read-only analysis — no file writes | Safe exploration, spec validation |');
+    sections.push('| `acceptEdits` | Can edit files, asks before running commands | Iterating on code while reviewing |');
+    sections.push('| `auto` | Long tasks, reduces prompt fatigue | Requires Team plan + Sonnet/Opus 4.6 |');
+    sections.push('| `dontAsk` | Pre-approved tools only, no confirmations | Locked CI environments |');
+    sections.push('| `bypassPermissions` | No safety checks — full autonomy | Containers/VMs only |');
+    sections.push('');
+    sections.push('**Recommended modes per CI job type:**');
+    sections.push('');
+    sections.push(`- validate → \`${getJobPermissionMode('validate')}\` — safe, read-only spec checks`);
+    sections.push(`- lint → \`${getJobPermissionMode('lint')}\` — pre-approved linting tools only`);
+    sections.push(`- migrate → \`${getJobPermissionMode('migrate')}\` — automated migrations with Team plan`);
+    sections.push(`- container → \`${getJobPermissionMode('container')}\` — full autonomy inside isolated VMs`);
+    sections.push(`- review → \`${getJobPermissionMode('review')}\` — edits files while you review commands`);
+    sections.push('');
+    if (includeExamples) {
+        sections.push('```bash');
+        sections.push(buildClaudeCommand({
+            prompt: 'validate all specs',
+            nonInteractive: true,
+            permissionMode: 'plan',
+        }));
+        sections.push('```');
+        sections.push('');
+    }
+    // Section 4: Scheduled tasks
+    sections.push('## 4. Scheduled Tasks');
+    sections.push('');
+    sections.push('Multiple scheduling options exist — choose based on your access requirements:');
+    sections.push('');
+    sections.push('| Method | Runs when offline | Access to | Best for |');
+    sections.push('|--------|-------------------|-----------|----------|');
+    sections.push('| **Cloud** (`claude.ai/code`) | Yes | Remote repos only | Background jobs independent of your machine |');
+    sections.push('| **Desktop** | No (requires local machine) | Local files, uncommitted changes | Dev-time checks on local work |');
+    sections.push('| **GitHub Actions** | Yes | Repo at event time | Repo-event-driven automation |');
+    sections.push('| **`/loop`** | No (session only) | Current context | Quick session-scoped repetition |');
+    sections.push('');
+    sections.push('> **Note**: `/loop` is cancelled when the session exits — not suitable for production automation.');
+    sections.push('');
+    // Section 5: Fan-out pattern
+    sections.push('## 5. Fan-Out Pattern');
+    sections.push('');
+    sections.push('Process multiple files in parallel by looping with `claude -p` and `--allowedTools`:');
+    sections.push('');
+    if (includeExamples) {
+        sections.push('```bash');
+        sections.push('# Fan-out: lint every changed file independently');
+        sections.push('for file in $(git diff --name-only HEAD~1); do');
+        sections.push(`  ${buildClaudeCommand({
+            prompt: 'Review this file for issues: $file',
+            nonInteractive: true,
+            permissionMode: 'plan',
+            allowedTools: ['Read', 'Grep'],
+        })} &`);
+        sections.push('done');
+        sections.push('wait  # wait for all parallel jobs');
+        sections.push('```');
+        sections.push('');
+    }
+    // Section 6: Session resume
+    sections.push('## 6. Session Resume');
+    sections.push('');
+    sections.push('Resume previous Claude sessions to maintain context across invocations:');
+    sections.push('');
+    sections.push('| Flag | Behavior |');
+    sections.push('|------|----------|');
+    sections.push('| `--continue` | Resume the most recent session |');
+    sections.push('| `--resume <name>` | Resume a named session by identifier |');
+    sections.push('| `--from-pr <N>` | Start a session pre-loaded with PR #N context |');
+    sections.push('');
+    if (includeExamples) {
+        sections.push('```bash');
+        sections.push('# Continue the last session and run non-interactively');
+        sections.push('claude --continue -p "Summarize what was accomplished in the last session"');
+        sections.push('');
+        sections.push('# Resume a named session');
+        sections.push('claude --resume my-migration-session -p "Continue the migration"');
+        sections.push('');
+        sections.push('# Start from a PR context');
+        sections.push('claude --from-pr 42 -p "Review the changes in this PR"');
+        sections.push('```');
+        sections.push('');
+    }
+    // Section 7: dontAsk for CI
+    sections.push('## 7. `dontAsk` for CI Environments');
+    sections.push('');
+    sections.push('Use `dontAsk` permission mode in locked CI environments where only pre-approved tools should run. Combined with `--allowedTools`, this gives deterministic, safe automation:');
+    sections.push('');
+    if (includeExamples) {
+        sections.push('```yaml');
+        sections.push('# .github/workflows/planu-validate.yml');
+        sections.push('name: Planu Spec Validation');
+        sections.push('');
+        sections.push('on:');
+        sections.push('  pull_request:');
+        sections.push('    branches: [main, develop]');
+        sections.push('');
+        sections.push('jobs:');
+        sections.push('  validate:');
+        sections.push('    name: Validate Specs');
+        sections.push('    runs-on: ubuntu-latest');
+        sections.push('    steps:');
+        sections.push('      - uses: actions/checkout@v4');
+        sections.push('');
+        sections.push('      - name: Install Claude Code');
+        sections.push('        run: npm install -g @anthropic-ai/claude-code');
+        sections.push('');
+        sections.push('      - name: Validate all specs');
+        sections.push(`        run: ${buildClaudeCommand({
+            prompt: 'validate all specs and report any issues',
+            nonInteractive: true,
+            permissionMode: 'dontAsk',
+            allowedTools: ['Read', 'Glob', 'Grep'],
+        })}`);
+        sections.push('        env:');
+        sections.push('          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}');
+        sections.push('```');
+        sections.push('');
+    }
+    return sections.join('\n');
+}
+export async function handleGenerateAutomationGuide(args) {
+    const includeExamples = args.includeExamples ?? true;
+    const guide = buildGuide(includeExamples);
+    if (args.saveToDisk === true) {
+        const outputPath = `${args.projectPath}/docs/automation-guide.md`;
+        await mkdir(dirname(outputPath), { recursive: true });
+        await writeFile(outputPath, guide, 'utf-8');
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: [
+                        '## Automation Guide Generated',
+                        '',
+                        `Saved to: \`${outputPath}\``,
+                        '',
+                        guide,
+                    ].join('\n'),
+                },
+            ],
+        };
+    }
+    return {
+        content: [
+            {
+                type: 'text',
+                text: guide,
+            },
+        ],
+    };
+}
+//# sourceMappingURL=generate-automation-guide.js.map

package/dist/tools/generate-automation-guide.js.map

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

package/dist/tools/generate-batch-script.d.ts

@@ -0,0 +1,27 @@
+import { z } from 'zod';
+import type { BatchScriptInput, ToolResult } from '../types/index.js';
+export declare const GenerateBatchScriptInputSchema: z.ZodObject<{
+    projectPath: z.ZodString;
+    taskDescription: z.ZodString;
+    fileGlob: z.ZodString;
+    specId: z.ZodOptional<z.ZodString>;
+    allowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    outputFormat: z.ZodOptional<z.ZodEnum<{
+        text: "text";
+        json: "json";
+        "stream-json": "stream-json";
+    }>>;
+    permissionMode: z.ZodOptional<z.ZodEnum<{
+        auto: "auto";
+        dontAsk: "dontAsk";
+        default: "default";
+    }>>;
+    pilotCount: z.ZodOptional<z.ZodNumber>;
+    dryRun: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+/**
+ * Handle the generate_batch_script tool.
+ * Generates full and pilot bash scripts for fan-out batch processing with claude -p.
+ */
+export declare function handleGenerateBatchScript(args: BatchScriptInput): Promise<ToolResult>;
+//# sourceMappingURL=generate-batch-script.d.ts.map

package/dist/tools/generate-batch-script.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-batch-script.d.ts","sourceRoot":"","sources":["../../src/tools/generate-batch-script.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAGtE,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;;;;iBAsCzC,CAAC;AAEH;;;GAGG;AACH,wBAAsB,yBAAyB,CAC7C,IAAI,EAAE,gBAAgB,GACrB,OAAO,CAAC,UAAU,CAAC,CAsCrB"}

package/dist/tools/generate-batch-script.js

@@ -0,0 +1,77 @@
+// tools/generate-batch-script.ts — Handle generate_batch_script tool calls (SPEC-253)
+import { z } from 'zod';
+import { generateBatchScript } from '../engine/batch-script-generator/index.js';
+export const GenerateBatchScriptInputSchema = z.object({
+    projectPath: z.string().describe('Absolute path to the project root'),
+    taskDescription: z
+        .string()
+        .describe('What claude -p should do to each file'),
+    fileGlob: z
+        .string()
+        .describe("Glob pattern for files, e.g. 'src/**/*.ts'"),
+    specId: z
+        .string()
+        .optional()
+        .describe('SPEC ID for naming the output script, e.g. SPEC-253'),
+    allowedTools: z
+        .array(z.string())
+        .optional()
+        .describe("List of allowed tools passed to claude -p, e.g. ['Edit', 'Bash(git commit *)']"),
+    outputFormat: z
+        .enum(['text', 'json', 'stream-json'])
+        .optional()
+        .describe('Output format for claude -p: text (default) | json | stream-json'),
+    permissionMode: z
+        .enum(['auto', 'dontAsk', 'default'])
+        .optional()
+        .describe('Permission mode for claude -p: auto (default, unattended) | dontAsk (pre-approved tools only) | default'),
+    pilotCount: z
+        .number()
+        .optional()
+        .describe('Number of files in the pilot script (default: 3)'),
+    dryRun: z
+        .boolean()
+        .optional()
+        .describe('Return script content without writing to disk (default: false)'),
+});
+/**
+ * Handle the generate_batch_script tool.
+ * Generates full and pilot bash scripts for fan-out batch processing with claude -p.
+ */
+export async function handleGenerateBatchScript(args) {
+    const result = await generateBatchScript(args);
+    const lines = [
+        '## Batch Script Generated',
+        '',
+        `**Task**: ${args.taskDescription}`,
+        `**File glob**: \`${args.fileGlob}\``,
+        `**Estimated files**: ~${String(result.estimatedFiles)}`,
+        `**Pilot size**: ${String(args.pilotCount ?? 3)} files`,
+        '',
+    ];
+    if (args.dryRun) {
+        lines.push('> **dry-run mode** — scripts not written to disk');
+        lines.push('');
+    }
+    else {
+        lines.push(`**Full script**: \`${result.fullScriptPath}\``);
+        lines.push(`**Pilot script**: \`${result.pilotScriptPath}\``);
+        lines.push('');
+    }
+    lines.push('### Recommended workflow');
+    lines.push('');
+    lines.push('1. **Run pilot first** (validates the task on a small sample):');
+    lines.push(`   \`\`\`bash\n   ${result.suggestedPilotCommand}\n   \`\`\``);
+    lines.push('2. **Scale up** (run on all files once pilot looks good):');
+    lines.push(`   \`\`\`bash\n   ${result.scaleUpCommand}\n   \`\`\``);
+    lines.push('');
+    lines.push('### Pilot script preview');
+    lines.push('');
+    lines.push('```bash');
+    lines.push(result.pilotScript.trimEnd());
+    lines.push('```');
+    return {
+        content: [{ type: 'text', text: lines.join('\n') }],
+    };
+}
+//# sourceMappingURL=generate-batch-script.js.map

package/dist/tools/generate-batch-script.js.map

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

package/dist/tools/generate-sub-agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generate-sub-agent.d.ts","sourceRoot":"","sources":["../../src/tools/generate-sub-agent.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,qBAAqB,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE3E,wBAAsB,sBAAsB,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,UAAU,CAAC,CA8F7F"}
+{"version":3,"file":"generate-sub-agent.d.ts","sourceRoot":"","sources":["../../src/tools/generate-sub-agent.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,qBAAqB,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAE3E,wBAAsB,sBAAsB,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC,UAAU,CAAC,CA2H7F"}