@output.ai/cli 0.0.6 → 0.0.8

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/generated/api.d.ts

@@ -198,26 +198,6 @@ export type getWorkflowIdOutputResponseError = (getWorkflowIdOutputResponse404)
 export type getWorkflowIdOutputResponse = (getWorkflowIdOutputResponseSuccess | getWorkflowIdOutputResponseError);
 export declare const getGetWorkflowIdOutputUrl: (id: string) => string;
 export declare const getWorkflowIdOutput: (id: string, options?: RequestInit) => Promise<getWorkflowIdOutputResponse>;
-/**
- * @summary Return the trace of a workflow execution
- */
-export type getWorkflowIdTraceResponse200 = {
-    data: string[];
-    status: 200;
-};
-export type getWorkflowIdTraceResponse404 = {
-    data: void;
-    status: 404;
-};
-export type getWorkflowIdTraceResponseSuccess = (getWorkflowIdTraceResponse200) & {
-    headers: Headers;
-};
-export type getWorkflowIdTraceResponseError = (getWorkflowIdTraceResponse404) & {
-    headers: Headers;
-};
-export type getWorkflowIdTraceResponse = (getWorkflowIdTraceResponseSuccess | getWorkflowIdTraceResponseError);
-export declare const getGetWorkflowIdTraceUrl: (id: string) => string;
-export declare const getWorkflowIdTrace: (id: string, options?: RequestInit) => Promise<getWorkflowIdTraceResponse>;
 /**
  * @summary Get a specific workflow catalog by ID
  */

package/dist/api/generated/api.js

@@ -1,5 +1,5 @@
 /**
- * Generated by orval v7.13.0 🍺
+ * Generated by orval v7.13.2 🍺
  * Do not edit manually.
  * Output.ai SDK API
  * API for managing and executing Temporal workflows through Output SDK
@@ -78,15 +78,6 @@ export const getWorkflowIdOutput = async (id, options) => {
         method: 'GET'
     });
 };
-export const getGetWorkflowIdTraceUrl = (id) => {
-    return `/workflow/${id}/trace`;
-};
-export const getWorkflowIdTrace = async (id, options) => {
-    return customFetchInstance(getGetWorkflowIdTraceUrl(id), {
-        ...options,
-        method: 'GET'
-    });
-};
 ;
 export const getGetWorkflowCatalogIdUrl = (id) => {
     return `/workflow/catalog/${id}`;

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

@@ -7,6 +7,7 @@ export default class Generate extends Command {
         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").Arg<string, Record<string, unknown>>;

package/dist/commands/workflow/generate.js

@@ -1,12 +1,16 @@
-import { Args, Command, Flags } from '@oclif/core';
+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/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 { 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/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

@@ -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,8 +88,11 @@ function getTodoWriteMessage(message) {
     const todoWriteMessage = message.message.content.find((c) => c?.type === 'tool_use' && c.name === 'TodoWrite');
     return todoWriteMessage ?? null;
 }
-function applyInstructions(initialMessage) {
-    return `${initialMessage}\n\n${ADDITIONAL_INSTRUCTIONS}`;
+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({
@@ -109,6 +129,13 @@ function getProgressUpdate(message) {
         total: allTodos.length
     };
 }
+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 progressBar = createProgressBar();
@@ -118,8 +145,10 @@ async function singleQuery(prompt, options = {}) {
             prompt,
             options: applyDefaultOptions(options)
         })) {
+            debugMessage(message);
             if (message.type === 'system' && message.subtype === 'init') {
-                validateSystem(message);
+                const validation = validateSystem(message);
+                displaySystemValidationWarnings(validation);
                 progressBar.update(1, { message: 'Diving in...' });
             }
             const progressUpdate = getProgressUpdate(message);
@@ -140,8 +169,8 @@ async function singleQuery(prompt, options = {}) {
         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
@@ -151,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>;

package/dist/services/coding_agents.js

@@ -7,6 +7,7 @@ import { access } from 'node:fs/promises';
 import path from 'node:path';
 import { join } from 'node:path';
 import { ux } from '@oclif/core';
+import { confirm } from '@inquirer/prompts';
 import { AGENT_CONFIG_DIR } from '#config.js';
 import { getTemplateDir } from '#utils/paths.js';
 import { processTemplate } from '#utils/template.js';
@@ -33,6 +34,11 @@ export const AGENT_CONFIGS = {
                 from: 'commands/plan_workflow.md.template',
                 to: `${AGENT_CONFIG_DIR}/commands/plan_workflow.md`
             },
+            {
+                type: 'template',
+                from: 'commands/build_workflow.md.template',
+                to: `${AGENT_CONFIG_DIR}/commands/build_workflow.md`
+            },
             {
                 type: 'template',
                 from: 'meta/pre_flight.md.template',
@@ -63,6 +69,11 @@ export const AGENT_CONFIGS = {
                 type: 'symlink',
                 from: `${AGENT_CONFIG_DIR}/commands/plan_workflow.md`,
                 to: '.claude/commands/plan_workflow.md'
+            },
+            {
+                type: 'symlink',
+                from: `${AGENT_CONFIG_DIR}/commands/build_workflow.md`,
+                to: '.claude/commands/build_workflow.md'
             }
         ]
     }
@@ -100,6 +111,15 @@ async function fileExists(filePath) {
         return false;
     }
 }
+async function findMissingFiles(files, projectRoot) {
+    const checks = await Promise.all(files.map(async (file) => ({
+        file,
+        missing: !await fileExists(join(projectRoot, file))
+    })));
+    return checks
+        .filter(check => check.missing)
+        .map(check => check.file);
+}
 export async function checkAgentStructure(projectRoot) {
     const requiredFiles = getRequiredFiles();
     const dirExists = await checkAgentConfigDirExists(projectRoot);
@@ -110,13 +130,7 @@ export async function checkAgentStructure(projectRoot) {
             isComplete: false
         };
     }
-    const missingChecks = await Promise.all(requiredFiles.map(async (file) => ({
-        file,
-        exists: await fileExists(join(projectRoot, file))
-    })));
-    const missingFiles = missingChecks
-        .filter(check => !check.exists)
-        .map(check => check.file);
+    const missingFiles = await findMissingFiles(requiredFiles, projectRoot);
     return {
         dirExists: true,
         missingFiles,
@@ -228,3 +242,46 @@ export async function initializeAgentConfig(options) {
     await processMappings(AGENT_CONFIGS.outputai, variables, force, projectRoot);
     await processMappings(AGENT_CONFIGS[agentProvider], variables, force, projectRoot);
 }
+function formatMissingFilesList(files) {
+    return files.map(f => `  • ${f}`).join('\n');
+}
+async function promptForReinitialize() {
+    return confirm({
+        message: 'Would you like to run "agents init --force" to recreate missing files?',
+        default: true
+    });
+}
+async function initializeAgentStructure(projectRoot, force) {
+    await initializeAgentConfig({
+        projectRoot,
+        force,
+        agentProvider: 'claude-code'
+    });
+}
+function createIncompleteConfigError(missingFiles) {
+    return new Error(`Agent configuration incomplete. Missing files:\n${missingFiles.join('\n')}\n\n` +
+        'Run "output-cli agents init --force" to recreate them.');
+}
+/**
+ * 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 async function ensureOutputAIStructure(projectRoot) {
+    const structureCheck = await checkAgentStructure(projectRoot);
+    if (structureCheck.isComplete) {
+        return;
+    }
+    if (!structureCheck.dirExists) {
+        await initializeAgentStructure(projectRoot, false);
+        return;
+    }
+    const missingList = formatMissingFilesList(structureCheck.missingFiles);
+    ux.warn(`\n⚠️  Agent configuration is incomplete. Missing files:\n${missingList}\n`);
+    const shouldReinit = await promptForReinitialize();
+    if (!shouldReinit) {
+        throw createIncompleteConfigError(structureCheck.missingFiles);
+    }
+    await initializeAgentStructure(projectRoot, true);
+}