@output.ai/cli 0.0.5 → 0.0.7

package/README.md

@@ -67,7 +67,7 @@ output workflow generate my-workflow --force
 
 - `--description, -d` - Description of the workflow
 - `--skeleton, -s` - Generate minimal skeleton without example steps
-- `--output-dir, -o` - Output directory (default: `output-workflows/src`)
+- `--output-dir, -o` - Output directory (default: `src/`)
 - `--force, -f` - Overwrite existing directory
 
 #### Generated Structure
@@ -76,9 +76,8 @@ The CLI creates a complete workflow structure:
 
 ```
 my-workflow/
-├── index.ts          # Main workflow definition
+├── workflow.ts          # Main workflow definition
 ├── steps.ts          # Activity/step implementations
-├── types.ts          # TypeScript interfaces
 ├── prompt@v1.prompt  # LLM prompt template (if not skeleton)
 └── README.md         # Workflow documentation
 ```

package/dist/api/http_client.js

@@ -2,7 +2,7 @@
  * Custom ky-based HTTP client for Orval-generated API
  */
 import ky from 'ky';
-import { config } from '../config.js';
+import { config } from '#config.js';
 const api = ky.create({
     prefixUrl: config.apiUrl,
     timeout: config.requestTimeout,

package/dist/commands/agents/init.d.ts

@@ -4,8 +4,8 @@ export default class Init extends Command {
     static examples: string[];
     static args: {};
     static flags: {
-        'agent-provider': import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
-        force: import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
+        'agent-provider': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        force: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<void>;
 }

package/dist/commands/agents/init.js

@@ -1,6 +1,6 @@
 import { Command, Flags } from '@oclif/core';
-import { AGENT_CONFIG_DIR } from '../../config.js';
-import { initializeAgentConfig, AGENT_CONFIGS } from '../../services/coding_agents.js';
+import { AGENT_CONFIG_DIR } from '#config.js';
+import { initializeAgentConfig, AGENT_CONFIGS } from '#services/coding_agents.js';
 export default class Init extends Command {
     static description = 'Initialize agent configuration files for AI assistant integration';
     static examples = [

package/dist/commands/agents/init.spec.js

@@ -3,8 +3,8 @@ import { describe, it, expect, beforeEach, afterEach, vi } from 'vitest';
 import fs from 'node:fs/promises';
 import path from 'node:path';
 import Init from './init.js';
-import { getTemplateDir } from '../../utils/paths.js';
-import { processTemplate } from '../../utils/template.js';
+import { getTemplateDir } from '#utils/paths.js';
+import { processTemplate } from '#utils/template.js';
 vi.mock('node:fs/promises');
 vi.mock('node:path', async () => {
     const actual = await vi.importActual('node:path');

package/dist/commands/workflow/generate.d.ts

@@ -3,13 +3,14 @@ export default class Generate extends Command {
     static description: string;
     static examples: string[];
     static flags: {
-        skeleton: import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
-        description: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
-        'output-dir': import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
-        force: import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
+        skeleton: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        description: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'output-dir': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        force: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        'plan-file': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
     };
     static args: {
-        name: import("@oclif/core/lib/interfaces/parser.js").Arg<string, Record<string, unknown>>;
+        name: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
     };
     run(): Promise<void>;
     private displaySuccess;

package/dist/commands/workflow/generate.js

@@ -1,12 +1,16 @@
-import { Args, Command, Flags } from '@oclif/core';
-import { generateWorkflow } from '../../services/workflow_generator.js';
-import { DEFAULT_OUTPUT_DIRS } from '../../utils/paths.js';
+import { Args, Command, Flags, ux } from '@oclif/core';
+import { generateWorkflow } from '#services/workflow_generator.js';
+import { buildWorkflow, buildWorkflowInteractiveLoop } from '#services/workflow_builder.js';
+import { ensureOutputAIStructure } from '#services/coding_agents.js';
+import { DEFAULT_OUTPUT_DIRS } from '#utils/paths.js';
+import path from 'node:path';
 export default class Generate extends Command {
     static description = 'Generate a new Output SDK workflow';
     static examples = [
         '<%= config.bin %> <%= command.id %> my-workflow',
         '<%= config.bin %> <%= command.id %> my-workflow --skeleton',
-        '<%= config.bin %> <%= command.id %> data-processing --description "Process and transform data"'
+        '<%= config.bin %> <%= command.id %> data-processing --description "Process and transform data"',
+        '<%= config.bin %> <%= command.id %> my-workflow --plan-file .outputai/plans/2025_10_09_my_workflow/PLAN.md'
     ];
     static flags = {
         skeleton: Flags.boolean({
@@ -28,6 +32,11 @@ export default class Generate extends Command {
             char: 'f',
             description: 'Overwrite existing directory',
             default: false
+        }),
+        'plan-file': Flags.string({
+            char: 'p',
+            description: 'Path to plan file for AI-assisted workflow implementation',
+            required: false
         })
     };
     static args = {
@@ -38,8 +47,9 @@ export default class Generate extends Command {
     };
     async run() {
         const { args, flags } = await this.parse(Generate);
-        if (!flags.skeleton) {
-            this.error('Full workflow generation not implemented yet. Please use --skeleton flag');
+        const planFile = flags['plan-file'];
+        if (!flags.skeleton && !planFile) {
+            this.error('Full workflow generation not implemented yet. Please use --skeleton flag or --plan-file');
         }
         try {
             const result = await generateWorkflow({
@@ -49,6 +59,15 @@ export default class Generate extends Command {
                 skeleton: flags.skeleton,
                 force: flags.force
             });
+            if (planFile) {
+                this.log('\nStarting AI-assisted workflow implementation...\n');
+                const projectRoot = process.cwd();
+                await ensureOutputAIStructure(projectRoot);
+                const absolutePlanPath = path.resolve(projectRoot, planFile);
+                const buildOutput = await buildWorkflow(absolutePlanPath, result.targetDir, args.name);
+                await buildWorkflowInteractiveLoop(buildOutput);
+                this.log(ux.colorize('green', '\nWorkflow implementation complete!\n'));
+            }
             this.displaySuccess(result);
         }
         catch (error) {

package/dist/commands/workflow/generate.spec.js

@@ -1,8 +1,8 @@
 /* eslint-disable no-restricted-syntax, @typescript-eslint/no-explicit-any, init-declarations */
 import { describe, it, expect, beforeEach, vi } from 'vitest';
 import Generate from './generate.js';
-import { generateWorkflow } from '../../services/workflow_generator.js';
-import { InvalidNameError, WorkflowExistsError } from '../../types/errors.js';
+import { generateWorkflow } from '#services/workflow_generator.js';
+import { InvalidNameError, WorkflowExistsError } from '#types/errors.js';
 vi.mock('../../services/workflow_generator.js');
 describe('Generate Command', () => {
     let mockGenerateWorkflow;

package/dist/commands/workflow/list.d.ts

@@ -1,5 +1,5 @@
 import { Command } from '@oclif/core';
-import { type Workflow } from '../../api/generated/api.js';
+import { type Workflow } from '#api/generated/api.js';
 interface WorkflowDisplay {
     name: string;
     description: string;
@@ -11,9 +11,9 @@ export default class WorkflowList extends Command {
     static description: string;
     static examples: string[];
     static flags: {
-        format: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
-        detailed: import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
-        filter: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        format: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        detailed: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        filter: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
     };
     run(): Promise<void>;
     catch(error: Error): Promise<void>;

package/dist/commands/workflow/list.js

@@ -1,8 +1,8 @@
 import { Command, Flags } from '@oclif/core';
 import Table from 'cli-table3';
-import { getWorkflowCatalog } from '../../api/generated/api.js';
-import { parseWorkflowDefinition, formatParameters } from '../../api/parser.js';
-import { handleApiError } from '../../utils/error_handler.js';
+import { getWorkflowCatalog } from '#api/generated/api.js';
+import { parseWorkflowDefinition, formatParameters } from '#api/parser.js';
+import { handleApiError } from '#utils/error_handler.js';
 const OUTPUT_FORMAT = {
     LIST: 'list',
     TABLE: 'table',

package/dist/commands/workflow/output.d.ts

@@ -3,10 +3,10 @@ export default class WorkflowOutput extends Command {
     static description: string;
     static examples: string[];
     static args: {
-        workflowId: import("@oclif/core/lib/interfaces/parser.js").Arg<string, Record<string, unknown>>;
+        workflowId: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
     };
     static flags: {
-        format: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        format: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
     };
     run(): Promise<void>;
     catch(error: Error): Promise<void>;

package/dist/commands/workflow/output.js

@@ -1,8 +1,8 @@
 import { Args, Command, Flags } from '@oclif/core';
-import { getWorkflowIdOutput } from '../../api/generated/api.js';
-import { OUTPUT_FORMAT } from '../../utils/constants.js';
-import { formatOutput } from '../../utils/output_formatter.js';
-import { handleApiError } from '../../utils/error_handler.js';
+import { getWorkflowIdOutput } from '#api/generated/api.js';
+import { OUTPUT_FORMAT } from '#utils/constants.js';
+import { formatOutput } from '#utils/output_formatter.js';
+import { handleApiError } from '#utils/error_handler.js';
 export default class WorkflowOutput extends Command {
     static description = 'Get workflow execution output';
     static examples = [

package/dist/commands/workflow/plan.d.ts

@@ -3,8 +3,8 @@ export default class WorkflowPlan extends Command {
     static description: string;
     static examples: string[];
     static flags: {
-        'force-agent-file-write': import("@oclif/core/lib/interfaces/parser.js").BooleanFlag<boolean>;
-        description: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        'force-agent-file-write': import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
+        description: import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
     };
     run(): Promise<void>;
     private planModificationLoop;

package/dist/commands/workflow/plan.js

@@ -1,7 +1,8 @@
 import { Command, Flags, ux } from '@oclif/core';
 import { input } from '@inquirer/prompts';
-import { ensureOutputAIStructure, generatePlanName, updateAgentTemplates, writePlanFile } from '../../services/workflow_planner.js';
-import { invokePlanWorkflow, replyToClaude } from '../../services/claude_client.js';
+import { generatePlanName, updateAgentTemplates, writePlanFile } from '#services/workflow_planner.js';
+import { ensureOutputAIStructure } from '#services/coding_agents.js';
+import { invokePlanWorkflow, PLAN_COMMAND_OPTIONS, replyToClaude } from '#services/claude_client.js';
 export default class WorkflowPlan extends Command {
     static description = 'Generate a workflow plan from a description';
     static examples = [
@@ -51,7 +52,7 @@ export default class WorkflowPlan extends Command {
         if (modifications === acceptKey) {
             return originalPlanContent;
         }
-        const modifiedPlanContent = await replyToClaude(modifications);
+        const modifiedPlanContent = await replyToClaude(modifications, PLAN_COMMAND_OPTIONS);
         return this.planModificationLoop(modifiedPlanContent);
     }
     async planGenerationLoop(promptDescription, planName, projectRoot) {

package/dist/commands/workflow/plan.spec.js

@@ -1,10 +1,12 @@
 import { describe, it, expect, beforeEach, vi, afterEach } from 'vitest';
 import WorkflowPlan from './plan.js';
-import { ensureOutputAIStructure, generatePlanName, writePlanFile, updateAgentTemplates } from '../../services/workflow_planner.js';
-import { invokePlanWorkflow, replyToClaude, ClaudeInvocationError } from '../../services/claude_client.js';
+import { generatePlanName, writePlanFile, updateAgentTemplates } from '#services/workflow_planner.js';
+import { ensureOutputAIStructure } from '#services/coding_agents.js';
+import { invokePlanWorkflow, replyToClaude, ClaudeInvocationError } from '#services/claude_client.js';
 import { input } from '@inquirer/prompts';
-vi.mock('../../services/workflow_planner.js');
-vi.mock('../../services/claude_client.js');
+vi.mock('#services/workflow_planner.js');
+vi.mock('#services/coding_agents.js');
+vi.mock('#services/claude_client.js');
 vi.mock('@inquirer/prompts');
 describe('WorkflowPlan Command', () => {
     const createCommand = () => {

package/dist/commands/workflow/run.d.ts

@@ -3,12 +3,12 @@ export default class WorkflowRun extends Command {
     static description: string;
     static examples: string[];
     static args: {
-        workflowName: import("@oclif/core/lib/interfaces/parser.js").Arg<string, Record<string, unknown>>;
+        workflowName: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
     };
     static flags: {
-        input: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
-        'task-queue': import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
-        format: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        input: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'task-queue': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
+        format: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
     };
     run(): Promise<void>;
     catch(error: Error): Promise<void>;

package/dist/commands/workflow/run.js

@@ -1,9 +1,9 @@
 import { Args, Command, Flags } from '@oclif/core';
-import { postWorkflowRun } from '../../api/generated/api.js';
-import { OUTPUT_FORMAT } from '../../utils/constants.js';
-import { parseInputFlag } from '../../utils/input_parser.js';
-import { formatOutput } from '../../utils/output_formatter.js';
-import { handleApiError } from '../../utils/error_handler.js';
+import { postWorkflowRun } from '#api/generated/api.js';
+import { OUTPUT_FORMAT } from '#utils/constants.js';
+import { parseInputFlag } from '#utils/input_parser.js';
+import { formatOutput } from '#utils/output_formatter.js';
+import { handleApiError } from '#utils/error_handler.js';
 export default class WorkflowRun extends Command {
     static description = 'Execute a workflow synchronously and wait for completion';
     static examples = [

package/dist/commands/workflow/start.d.ts

@@ -3,11 +3,11 @@ export default class WorkflowStart extends Command {
     static description: string;
     static examples: string[];
     static args: {
-        workflowName: import("@oclif/core/lib/interfaces/parser.js").Arg<string, Record<string, unknown>>;
+        workflowName: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
     };
     static flags: {
-        input: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
-        'task-queue': import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        input: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
+        'task-queue': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;
     };
     run(): Promise<void>;
     catch(error: Error): Promise<void>;

package/dist/commands/workflow/start.js

@@ -1,7 +1,7 @@
 import { Args, Command, Flags } from '@oclif/core';
-import { postWorkflowStart } from '../../api/generated/api.js';
-import { parseInputFlag } from '../../utils/input_parser.js';
-import { handleApiError } from '../../utils/error_handler.js';
+import { postWorkflowStart } from '#api/generated/api.js';
+import { parseInputFlag } from '#utils/input_parser.js';
+import { handleApiError } from '#utils/error_handler.js';
 export default class WorkflowStart extends Command {
     static description = 'Start a workflow asynchronously without waiting for completion';
     static examples = [

package/dist/commands/workflow/status.d.ts

@@ -3,10 +3,10 @@ export default class WorkflowStatus extends Command {
     static description: string;
     static examples: string[];
     static args: {
-        workflowId: import("@oclif/core/lib/interfaces/parser.js").Arg<string, Record<string, unknown>>;
+        workflowId: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
     };
     static flags: {
-        format: import("@oclif/core/lib/interfaces/parser.js").OptionFlag<string, import("@oclif/core/lib/interfaces/parser.js").CustomOptions>;
+        format: import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
     };
     run(): Promise<void>;
     catch(error: Error): Promise<void>;

package/dist/commands/workflow/status.js

@@ -1,8 +1,8 @@
 import { Args, Command, Flags } from '@oclif/core';
-import { getWorkflowIdStatus } from '../../api/generated/api.js';
-import { OUTPUT_FORMAT } from '../../utils/constants.js';
-import { formatOutput } from '../../utils/output_formatter.js';
-import { handleApiError } from '../../utils/error_handler.js';
+import { getWorkflowIdStatus } from '#api/generated/api.js';
+import { OUTPUT_FORMAT } from '#utils/constants.js';
+import { formatOutput } from '#utils/output_formatter.js';
+import { handleApiError } from '#utils/error_handler.js';
 export default class WorkflowStatus extends Command {
     static description = 'Get workflow execution status';
     static examples = [

package/dist/commands/workflow/stop.d.ts

@@ -3,7 +3,7 @@ export default class WorkflowStop extends Command {
     static description: string;
     static examples: string[];
     static args: {
-        workflowId: import("@oclif/core/lib/interfaces/parser.js").Arg<string, Record<string, unknown>>;
+        workflowId: import("@oclif/core/lib/interfaces").Arg<string, Record<string, unknown>>;
     };
     run(): Promise<void>;
     catch(error: Error): Promise<void>;

package/dist/commands/workflow/stop.js

@@ -1,6 +1,6 @@
 import { Args, Command } from '@oclif/core';
-import { patchWorkflowIdStop } from '../../api/generated/api.js';
-import { handleApiError } from '../../utils/error_handler.js';
+import { patchWorkflowIdStop } from '#api/generated/api.js';
+import { handleApiError } from '#utils/error_handler.js';
 export default class WorkflowStop extends Command {
     static description = 'Stop a workflow execution';
     static examples = [

package/dist/services/claude_client.d.ts

@@ -1,8 +1,14 @@
+/**
+ * Claude Agent SDK client for workflow planning
+ */
+import { Options } from '@anthropic-ai/claude-agent-sdk';
+export declare const PLAN_COMMAND_OPTIONS: Options;
+export declare const BUILD_COMMAND_OPTIONS: Options;
 export declare class ClaudeInvocationError extends Error {
     cause?: Error | undefined;
     constructor(message: string, cause?: Error | undefined);
 }
-export declare function replyToClaude(message: string): Promise<string>;
+export declare function replyToClaude(message: string, options?: Options): Promise<string>;
 /**
  * Invoke claude-code with /plan_workflow slash command
  * The SDK loads custom commands from .claude/commands/ when settingSources includes 'project'.
@@ -11,3 +17,14 @@ export declare function replyToClaude(message: string): Promise<string>;
  * @returns Plan output from claude-code
  */
 export declare function invokePlanWorkflow(description: string): Promise<string>;
+/**
+ * Invoke claude-code with /build_workflow slash command
+ * The SDK loads custom commands from .claude/commands/ when settingSources includes 'project'.
+ * ensureOutputAIStructure() scaffolds the command files to that location.
+ * @param planFilePath - Absolute path to the plan file
+ * @param workflowDir - Absolute path to the workflow directory
+ * @param workflowName - Name of the workflow
+ * @param additionalInstructions - Optional additional instructions
+ * @returns Implementation output from claude-code
+ */
+export declare function invokeBuildWorkflow(planFilePath: string, workflowDir: string, workflowName: string, additionalInstructions?: string): Promise<string>;

package/dist/services/claude_client.js

@@ -3,7 +3,7 @@
  */
 import { query } from '@anthropic-ai/claude-agent-sdk';
 import { ux } from '@oclif/core';
-import ora from 'ora';
+import * as cliProgress from 'cli-progress';
 const ADDITIONAL_INSTRUCTIONS = `
 ! IMPORTANT !
 1. Use TodoWrite to track your progress through plan creation.
@@ -22,16 +22,26 @@ date: <plan-date>
 
 4. After you mark all todos as complete, you must respond with the final version of the plan.
 `;
+const ADDITIONAL_INSTRUCTIONS_BUILD = `
+! IMPORTANT !
+1. Use TodoWrite to track your progress through workflow implementation.
+
+2. Follow the implementation plan exactly as specified in the plan file.
+
+3. Implement all workflow files following Output SDK patterns and best practices.
+
+4. After you mark all todos as complete, provide a summary of what was implemented.
+`;
 const PLAN_COMMAND = 'plan_workflow';
+const BUILD_COMMAND = 'build_workflow';
 const GLOBAL_CLAUDE_OPTIONS = {
-    settingSources: ['user', 'project', 'local'],
-    allowedTools: [
-        'Read',
-        'Grep',
-        'WebSearch',
-        'WebFetch',
-        'TodoWrite'
-    ]
+    settingSources: ['user', 'project', 'local']
+};
+export const PLAN_COMMAND_OPTIONS = {
+    allowedTools: ['Read', 'Grep', 'WebSearch', 'WebFetch', 'TodoWrite']
+};
+export const BUILD_COMMAND_OPTIONS = {
+    permissionMode: 'bypassPermissions'
 };
 export class ClaudeInvocationError extends Error {
     cause;
@@ -47,16 +57,23 @@ function validateEnvironment() {
     }
 }
 function validateSystem(systemMessage) {
-    const requiredCommands = [PLAN_COMMAND];
+    const requiredCommands = [PLAN_COMMAND, BUILD_COMMAND];
     const availableCommands = systemMessage.slash_commands;
     const missingCommands = requiredCommands.filter(command => !availableCommands.includes(command));
-    for (const command of missingCommands) {
-        ux.warn(`Missing required claude-code slash command: /${command}`);
-    }
-    if (missingCommands.length > 0) {
-        ux.warn('Your claude-code agent is missing key configurations, it may not behave as expected.');
-        ux.warn('Please run "output-cli agents init" to fix this.');
+    return {
+        missingCommands,
+        hasIssues: missingCommands.length > 0
+    };
+}
+function displaySystemValidationWarnings(validation) {
+    if (!validation.hasIssues) {
+        return;
     }
+    validation.missingCommands.forEach(command => {
+        ux.warn(`Missing required claude-code slash command: /${command}`);
+    });
+    ux.warn('Your claude-code agent is missing key configurations, it may not behave as expected.');
+    ux.warn('Please run "output-cli agents init" to fix this.');
 }
 function applyDefaultOptions(options) {
     return {
@@ -71,46 +88,89 @@ function getTodoWriteMessage(message) {
     const todoWriteMessage = message.message.content.find((c) => c?.type === 'tool_use' && c.name === 'TodoWrite');
     return todoWriteMessage ?? null;
 }
-function getInProgressTodo(message) {
+function applyInstructions(initialMessage, instructionsType = 'plan') {
+    const instructions = instructionsType === 'build' ?
+        ADDITIONAL_INSTRUCTIONS_BUILD :
+        ADDITIONAL_INSTRUCTIONS;
+    return `${initialMessage}\n\n${instructions}`;
+}
+function createProgressBar() {
+    return new cliProgress.SingleBar({
+        format: '{bar} | {message} ({percentage}%)',
+        barCompleteChar: '█',
+        barIncompleteChar: '░',
+        hideCursor: true,
+        barsize: 40,
+        fps: 10,
+        stopOnComplete: false
+    });
+}
+function calculateProgress(completedCount, totalCount) {
+    if (totalCount === 0) {
+        return 0;
+    }
+    const percentage = ((completedCount + 1) / (totalCount + 1)) * 100;
+    return Math.round(percentage * 10) / 10;
+}
+function getProgressUpdate(message) {
     const todoWriteMessage = getTodoWriteMessage(message);
     if (!todoWriteMessage) {
         return null;
     }
-    const inProgressTodo = todoWriteMessage.input.todos.find(t => t.status === 'in_progress');
-    return inProgressTodo?.content ?? null;
+    const allTodos = todoWriteMessage.input.todos;
+    const inProgressTodo = allTodos.find(t => t.status === 'in_progress');
+    if (!inProgressTodo?.content) {
+        return null;
+    }
+    const completedTodos = allTodos.filter(t => t.status === 'completed');
+    return {
+        message: `${inProgressTodo.content}...`,
+        completed: completedTodos.length,
+        total: allTodos.length
+    };
 }
-function applyInstructions(initialMessage) {
-    return `${initialMessage}\n\n${ADDITIONAL_INSTRUCTIONS}`;
+function debugMessage(message) {
+    if (process.env.DEBUG !== 'true') {
+        return;
+    }
+    ux.stdout(ux.colorize('teal', `[Message]: ${message.type}`));
+    ux.stdout(ux.colorize('teal', `[JSON]: ${JSON.stringify(message, null, 2)}`));
 }
 async function singleQuery(prompt, options = {}) {
     validateEnvironment();
-    const spinner = ora('Thinking...').start();
+    const progressBar = createProgressBar();
+    progressBar.start(100, 0, { message: 'Thinking...' });
     try {
         for await (const message of query({
             prompt,
             options: applyDefaultOptions(options)
         })) {
+            debugMessage(message);
             if (message.type === 'system' && message.subtype === 'init') {
-                validateSystem(message);
-                spinner.text = 'Diving in...';
+                const validation = validateSystem(message);
+                displaySystemValidationWarnings(validation);
+                progressBar.update(1, { message: 'Diving in...' });
             }
-            const inProgressTodo = getInProgressTodo(message);
-            if (inProgressTodo) {
-                spinner.text = `${inProgressTodo}...`;
+            const progressUpdate = getProgressUpdate(message);
+            if (progressUpdate) {
+                const percentage = calculateProgress(progressUpdate.completed, progressUpdate.total);
+                progressBar.update(percentage, { message: progressUpdate.message });
             }
             if (message.type === 'result' && message.subtype === 'success') {
-                spinner.stop();
+                progressBar.update(100, { message: 'Complete!' });
+                progressBar.stop();
                 return message.result;
             }
         }
         throw new Error('No output received from claude-code');
     }
     catch (error) {
+        progressBar.stop();
         throw new ClaudeInvocationError(`Failed to invoke claude-code: ${error.message}`, error);
     }
 }
-export async function replyToClaude(message) {
-    return singleQuery(applyInstructions(message), { continue: true });
+export async function replyToClaude(message, options = {}) {
+    return singleQuery(applyInstructions(message), { continue: true, ...options });
 }
 /**
  * Invoke claude-code with /plan_workflow slash command
@@ -120,5 +180,22 @@ export async function replyToClaude(message) {
  * @returns Plan output from claude-code
  */
 export async function invokePlanWorkflow(description) {
-    return singleQuery(applyInstructions(`/${PLAN_COMMAND} ${description}`));
+    return singleQuery(applyInstructions(`/${PLAN_COMMAND} ${description}`), PLAN_COMMAND_OPTIONS);
+}
+/**
+ * Invoke claude-code with /build_workflow slash command
+ * The SDK loads custom commands from .claude/commands/ when settingSources includes 'project'.
+ * ensureOutputAIStructure() scaffolds the command files to that location.
+ * @param planFilePath - Absolute path to the plan file
+ * @param workflowDir - Absolute path to the workflow directory
+ * @param workflowName - Name of the workflow
+ * @param additionalInstructions - Optional additional instructions
+ * @returns Implementation output from claude-code
+ */
+export async function invokeBuildWorkflow(planFilePath, workflowDir, workflowName, additionalInstructions) {
+    const commandArgs = `${planFilePath} ${workflowName} ${workflowDir}`;
+    const fullCommand = additionalInstructions ?
+        `/${BUILD_COMMAND} ${commandArgs} ${additionalInstructions}` :
+        `/${BUILD_COMMAND} ${commandArgs}`;
+    return singleQuery(applyInstructions(fullCommand, 'build'), BUILD_COMMAND_OPTIONS);
 }

package/dist/services/coding_agents.d.ts

@@ -41,3 +41,10 @@ export declare function prepareTemplateVariables(): Record<string, string>;
  * Main entry point for agent initialization logic
  */
 export declare function initializeAgentConfig(options: InitOptions): Promise<void>;
+/**
+ * Ensure .outputai directory structure exists by invoking agents init if needed
+ * Displays warnings for missing files and prompts for reinitialization
+ * @param projectRoot - Root directory of the project
+ * @throws Error if user declines to initialize or if initialization fails
+ */
+export declare function ensureOutputAIStructure(projectRoot: string): Promise<void>;