@outputai/cli 0.1.12 → 0.1.13-dev.98dfd72.0

package/dist/services/coding_agents.spec.js

@@ -19,7 +19,7 @@ vi.mock('@oclif/core', () => ({
         colorize: vi.fn().mockImplementation((_color, text) => text)
     }
 }));
-vi.mock('@inquirer/prompts', () => ({
+vi.mock('#utils/prompt.js', () => ({
     confirm: vi.fn()
 }));
 describe('coding_agents service', () => {
@@ -157,7 +157,7 @@ describe('coding_agents service', () => {
         });
         it('should show error and prompt user when plugin commands fail', async () => {
             const { executeClaudeCommand } = await import('../utils/claude.js');
-            const { confirm } = await import('@inquirer/prompts');
+            const { confirm } = await import('#utils/prompt.js');
             vi.mocked(executeClaudeCommand)
                 .mockResolvedValueOnce(undefined) // marketplace add
                 .mockRejectedValueOnce(new Error('Plugin update failed')); // marketplace update
@@ -169,7 +169,7 @@ describe('coding_agents service', () => {
         });
         it('should allow user to proceed without plugin setup if they confirm', async () => {
             const { executeClaudeCommand } = await import('../utils/claude.js');
-            const { confirm } = await import('@inquirer/prompts');
+            const { confirm } = await import('#utils/prompt.js');
             vi.mocked(executeClaudeCommand)
                 .mockRejectedValue(new Error('All plugin commands fail'));
             vi.mocked(confirm).mockResolvedValue(true);
@@ -219,7 +219,7 @@ describe('coding_agents service', () => {
         });
         it('should show error and prompt user when registerPluginMarketplace fails', async () => {
             const { executeClaudeCommand } = await import('../utils/claude.js');
-            const { confirm } = await import('@inquirer/prompts');
+            const { confirm } = await import('#utils/prompt.js');
             vi.mocked(executeClaudeCommand)
                 .mockResolvedValueOnce(undefined) // marketplace add
                 .mockRejectedValueOnce(new Error('Plugin update failed')); // marketplace update
@@ -231,7 +231,7 @@ describe('coding_agents service', () => {
         });
         it('should show error and prompt user when installOutputAIPlugin fails', async () => {
             const { executeClaudeCommand } = await import('../utils/claude.js');
-            const { confirm } = await import('@inquirer/prompts');
+            const { confirm } = await import('#utils/prompt.js');
             vi.mocked(executeClaudeCommand)
                 .mockResolvedValueOnce(undefined) // marketplace add
                 .mockResolvedValueOnce(undefined) // marketplace update
@@ -244,7 +244,7 @@ describe('coding_agents service', () => {
         });
         it('should allow user to proceed without plugin setup if they confirm', async () => {
             const { executeClaudeCommand } = await import('../utils/claude.js');
-            const { confirm } = await import('@inquirer/prompts');
+            const { confirm } = await import('#utils/prompt.js');
             vi.mocked(executeClaudeCommand)
                 .mockRejectedValue(new Error('All plugin commands fail'));
             vi.mocked(confirm).mockResolvedValue(true);

package/dist/services/credentials_configurator.js

@@ -1,4 +1,4 @@
-import { password, confirm } from '@inquirer/prompts';
+import { password, confirm } from '#utils/prompt.js';
 import fs from 'node:fs';
 import path from 'node:path';
 import { ux } from '@oclif/core';

package/dist/services/docker.d.ts

@@ -21,8 +21,6 @@ export declare class DockerComposeConfigNotFoundError extends Error {
     constructor(dockerComposePath: string);
 }
 declare const isDockerInstalled: () => boolean;
-declare const isDockerComposeAvailable: () => boolean;
-declare const isDockerDaemonRunning: () => boolean;
 export declare function validateDockerEnvironment(): void;
 export declare function getDefaultDockerComposePath(): string;
 export declare function parseServiceStatus(jsonOutput: string): ServiceStatus[];
@@ -37,4 +35,4 @@ export type PullPolicy = 'always' | 'missing' | 'never';
 export declare function startDockerCompose(dockerComposePath: string, pullPolicy?: PullPolicy): Promise<DockerComposeProcess>;
 export declare function startDockerComposeDetached(dockerComposePath: string, pullPolicy?: PullPolicy): void;
 export declare function stopDockerCompose(dockerComposePath: string): Promise<void>;
-export { isDockerInstalled, isDockerComposeAvailable, isDockerDaemonRunning, DockerValidationError };
+export { isDockerInstalled, DockerValidationError };

package/dist/services/docker.js

@@ -2,6 +2,7 @@ import { execFileSync, execSync, spawn } from 'node:child_process';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { ux } from '@oclif/core';
+import semver from 'semver';
 const DEFAULT_COMPOSE_PATH = '../assets/docker/docker-compose-dev.yml';
 export const SERVICE_HEALTH = {
     HEALTHY: 'healthy',
@@ -30,27 +31,51 @@ const checkDockerCommand = (command) => {
         return false;
     }
 };
+const getCommandVersion = (command, pattern = /(\d+\.\d+\.\d+)/) => {
+    try {
+        const output = execSync(command, { stdio: 'pipe', encoding: 'utf-8' }).trim();
+        const match = output.match(pattern);
+        return match ? match[1] : null;
+    }
+    catch {
+        return null;
+    }
+};
 const isDockerInstalled = () => checkDockerCommand('docker --version');
-const isDockerComposeAvailable = () => checkDockerCommand('docker compose version');
-const isDockerDaemonRunning = () => checkDockerCommand('docker ps');
-const DOCKER_VALIDATIONS = [
+const PREREQUISITES = [
     {
-        check: isDockerInstalled,
-        error: 'Docker is not installed. Please install Docker to use the dev command.\nVisit: https://docs.docker.com/get-docker/'
+        name: 'Docker',
+        semverRange: '>=20.0.0',
+        getVersion: () => getCommandVersion('docker --version'),
+        errorMessage: (current, required) => current === null ?
+            'Docker is not installed. Please install Docker to use the dev command.\nVisit: https://docs.docker.com/get-docker/' :
+            `Docker version ${required} is required (found v${current}).\nVisit: https://docs.docker.com/get-docker/`
     },
     {
-        check: isDockerComposeAvailable,
-        error: 'Docker Compose is not installed. Please install Docker Compose to use the dev command.\nVisit: https://docs.docker.com/compose/install/'
+        name: 'Docker Compose',
+        semverRange: '>=2.24.0',
+        getVersion: () => getCommandVersion('docker compose version --short'),
+        errorMessage: (current, required) => current === null ?
+            'Docker Compose is not installed. Please install Docker Compose to use the dev command.\nVisit: https://docs.docker.com/compose/install/' :
+            `Docker Compose ${required} is required (found v${current}).\nPlease update Docker Compose: https://docs.docker.com/compose/install/`
     },
     {
-        check: isDockerDaemonRunning,
-        error: 'Docker daemon is not running. Please start Docker and try again.'
+        name: 'Docker Daemon',
+        semverRange: '*',
+        getVersion: () => checkDockerCommand('docker ps') ? '0.0.0' : null,
+        errorMessage: () => 'Docker daemon is not running. Please start Docker and try again.'
     }
 ];
 export function validateDockerEnvironment() {
-    const failedValidation = DOCKER_VALIDATIONS.find(v => !v.check());
-    if (failedValidation) {
-        throw new DockerValidationError(failedValidation.error);
+    for (const prereq of PREREQUISITES) {
+        const raw = prereq.getVersion();
+        const version = raw ? semver.valid(semver.coerce(raw)) : null;
+        if (!version) {
+            throw new DockerValidationError(prereq.errorMessage(null, prereq.semverRange));
+        }
+        if (!semver.satisfies(version, prereq.semverRange)) {
+            throw new DockerValidationError(prereq.errorMessage(version, prereq.semverRange));
+        }
     }
 }
 export function getDefaultDockerComposePath() {
@@ -129,4 +154,4 @@ export async function stopDockerCompose(dockerComposePath) {
     ux.stdout('⏹️  Stopping services...\n');
     execFileSync('docker', ['compose', '-f', dockerComposePath, 'down'], { stdio: 'inherit', cwd: process.cwd() });
 }
-export { isDockerInstalled, isDockerComposeAvailable, isDockerDaemonRunning, DockerValidationError };
+export { isDockerInstalled, DockerValidationError };

package/dist/services/env_configurator.js

@@ -1,4 +1,4 @@
-import { input, confirm, password } from '@inquirer/prompts';
+import { input, confirm, password } from '#utils/prompt.js';
 import fs from 'node:fs/promises';
 import path from 'node:path';
 import { ux } from '@oclif/core';

package/dist/services/env_configurator.spec.js

@@ -3,7 +3,7 @@ import fs from 'node:fs/promises';
 import path from 'node:path';
 import { configureEnvironmentVariables } from './env_configurator.js';
 // Mock inquirer prompts
-vi.mock('@inquirer/prompts', () => ({
+vi.mock('#utils/prompt.js', () => ({
     input: vi.fn(),
     confirm: vi.fn(),
     password: vi.fn()
@@ -45,7 +45,7 @@ describe('configureEnvironmentVariables', () => {
         expect(result).toBe(false);
     });
     it('should return false if user declines configuration', async () => {
-        const { confirm } = await import('@inquirer/prompts');
+        const { confirm } = await import('#utils/prompt.js');
         vi.mocked(confirm).mockResolvedValue(false);
         await fs.writeFile(testState.envExamplePath, '# API key\nAPIKEY=');
         const result = await configureEnvironmentVariables(testState.tempDir, false);
@@ -53,14 +53,14 @@ describe('configureEnvironmentVariables', () => {
         expect(vi.mocked(confirm)).toHaveBeenCalled();
     });
     it('should return false if no empty variables exist', async () => {
-        const { confirm } = await import('@inquirer/prompts');
+        const { confirm } = await import('#utils/prompt.js');
         vi.mocked(confirm).mockResolvedValue(true);
         await fs.writeFile(testState.envExamplePath, 'APIKEY=my-secret-key');
         const result = await configureEnvironmentVariables(testState.tempDir, false);
         expect(result).toBe(false);
     });
     it('should copy .env.example to .env when user confirms configuration', async () => {
-        const { input, confirm } = await import('@inquirer/prompts');
+        const { input, confirm } = await import('#utils/prompt.js');
         vi.mocked(confirm).mockResolvedValue(true);
         vi.mocked(input).mockResolvedValueOnce('sk-proj-123');
         const originalContent = `# API key
@@ -72,7 +72,7 @@ APIKEY=`;
         await expect(fs.access(testState.envPath)).resolves.toBeUndefined();
     });
     it('should write configured values to .env while leaving .env.example unchanged', async () => {
-        const { input, confirm } = await import('@inquirer/prompts');
+        const { input, confirm } = await import('#utils/prompt.js');
         vi.mocked(confirm).mockResolvedValue(true);
         vi.mocked(input).mockResolvedValueOnce('sk-proj-123');
         const originalContent = `# API key
@@ -88,7 +88,7 @@ APIKEY=`;
         expect(envExampleContent).toBe(originalContent);
     });
     it('should prompt for empty variables and update .env', async () => {
-        const { input, confirm } = await import('@inquirer/prompts');
+        const { input, confirm } = await import('#utils/prompt.js');
         vi.mocked(confirm).mockResolvedValue(true);
         vi.mocked(input).mockResolvedValueOnce('sk-proj-123');
         vi.mocked(input).mockResolvedValueOnce('');
@@ -105,7 +105,7 @@ OPENAI_API_KEY=`);
         expect(content).toContain('OPENAI_API_KEY=');
     });
     it('should preserve comments in .env file', async () => {
-        const { input, confirm } = await import('@inquirer/prompts');
+        const { input, confirm } = await import('#utils/prompt.js');
         vi.mocked(confirm).mockResolvedValue(true);
         vi.mocked(input).mockResolvedValueOnce('test-key');
         const originalContent = `# This is a comment
@@ -123,7 +123,7 @@ OTHER=value`;
         expect(content).toContain('OTHER=value');
     });
     it('should skip placeholder values and only prompt for truly empty variables', async () => {
-        const { input, confirm } = await import('@inquirer/prompts');
+        const { input, confirm } = await import('#utils/prompt.js');
         vi.mocked(confirm).mockResolvedValue(true);
         vi.mocked(input).mockResolvedValueOnce('new-key');
         await fs.writeFile(testState.envExamplePath, `APIKEY=your_api_key_here
@@ -136,7 +136,7 @@ EMPTY_KEY=`);
         }));
     });
     it('should skip variables with existing values', async () => {
-        const { input, confirm } = await import('@inquirer/prompts');
+        const { input, confirm } = await import('#utils/prompt.js');
         vi.mocked(confirm).mockResolvedValue(true);
         vi.mocked(input).mockResolvedValueOnce('new-key');
         await fs.writeFile(testState.envExamplePath, `EXISTING_KEY=existing-value
@@ -147,7 +147,7 @@ EMPTY_KEY=`);
         expect(vi.mocked(input)).toHaveBeenCalledTimes(1);
     });
     it('should handle case where .env already exists (overwrite with copy)', async () => {
-        const { input, confirm } = await import('@inquirer/prompts');
+        const { input, confirm } = await import('#utils/prompt.js');
         vi.mocked(confirm).mockResolvedValue(true);
         vi.mocked(input).mockResolvedValueOnce('new-configured-value');
         // Create existing .env with old content
@@ -162,7 +162,7 @@ EMPTY_KEY=`);
         expect(envContent).not.toContain('OLD_KEY');
     });
     it('should return false if an error occurs during parsing', async () => {
-        const { confirm } = await import('@inquirer/prompts');
+        const { confirm } = await import('#utils/prompt.js');
         vi.mocked(confirm).mockResolvedValue(true);
         await fs.writeFile(testState.envExamplePath, 'KEY=');
         // Delete the .env.example file after access check but before parsing would happen
@@ -178,7 +178,7 @@ EMPTY_KEY=`);
         vi.mocked(fs.copyFile).mockImplementation(originalCopyFile);
     });
     it('should prompt for SECRET marker values with password input', async () => {
-        const { password, confirm } = await import('@inquirer/prompts');
+        const { password, confirm } = await import('#utils/prompt.js');
         vi.mocked(confirm).mockResolvedValue(true);
         vi.mocked(password).mockResolvedValueOnce('my-secret-api-key');
         await fs.writeFile(testState.envExamplePath, `# API Key

package/dist/services/messages.d.ts

@@ -3,4 +3,4 @@
  */
 export declare const getEjectSuccessMessage: (destPath: string, outputFile: string, binName: string) => string;
 export declare const getProjectSuccessMessage: (folderName: string, installSuccess: boolean, credentialsConfigured?: boolean) => string;
-export declare const getWorkflowGenerateSuccessMessage: (workflowName: string, targetDir: string, filesCreated: string[]) => string;
+export declare const getWorkflowGenerateSuccessMessage: (workflowName: string, workflowId: string, scenarioName: string | undefined, targetDir: string, filesCreated: string[]) => string;

package/dist/services/messages.js

@@ -234,7 +234,7 @@ ${ux.colorize('dim', '         to manage your project secrets.')}
 ${ux.colorize('green', ux.colorize('bold', 'Happy building with Output! 🚀'))}
 `;
 };
-export const getWorkflowGenerateSuccessMessage = (workflowName, targetDir, filesCreated) => {
+export const getWorkflowGenerateSuccessMessage = (workflowName, workflowId, scenarioName, targetDir, filesCreated) => {
     const divider = ux.colorize('dim', '─'.repeat(80));
     const bulletPoint = ux.colorize('green', '▸');
     const formattedFiles = filesCreated.map(file => {
@@ -256,7 +256,7 @@ export const getWorkflowGenerateSuccessMessage = (workflowName, targetDir, files
         },
         {
             step: 'Test your workflow',
-            command: `npx output workflow run ${workflowName} test_input`,
+            command: `npx output workflow run ${workflowId}${scenarioName ? ` ${scenarioName}` : ''}`,
             note: 'Run after starting services with "npx output dev"'
         }
     ];

package/dist/services/project_scaffold.js

@@ -1,4 +1,4 @@
-import { input, confirm } from '@inquirer/prompts';
+import { input, confirm } from '#utils/prompt.js';
 import { ux } from '@oclif/core';
 import { kebabCase, pascalCase } from 'change-case';
 import fs from 'node:fs/promises';
@@ -41,7 +41,7 @@ export async function checkDependencies() {
     try {
         const shouldProceed = await confirm({
             message: 'Would you like to proceed anyway?',
-            default: false
+            default: true
         });
         if (!shouldProceed) {
             throw new UserCancelledError();

package/dist/services/project_scaffold.spec.js

@@ -8,7 +8,7 @@ vi.mock('#utils/framework_version.js', () => ({
     })
 }));
 // Mock other dependencies
-vi.mock('@inquirer/prompts', () => ({
+vi.mock('#utils/prompt.js', () => ({
     input: vi.fn(),
     confirm: vi.fn()
 }));
@@ -47,7 +47,7 @@ describe('project_scaffold', () => {
     });
     describe('getProjectConfig', () => {
         it('should skip all prompts when folderName is provided', async () => {
-            const { input } = await import('@inquirer/prompts');
+            const { input } = await import('#utils/prompt.js');
             const config = await getProjectConfig('my-project');
             expect(config.folderName).toBe('my-project');
             expect(config.projectName).toBe('my-project');
@@ -58,7 +58,7 @@ describe('project_scaffold', () => {
             expect(config.description).toBe('AI Agents & Workflows built with Output.ai for test-folder');
         });
         it('should prompt for project name and folder name when not provided', async () => {
-            const { input } = await import('@inquirer/prompts');
+            const { input } = await import('#utils/prompt.js');
             vi.mocked(input)
                 .mockResolvedValueOnce('Test Project')
                 .mockResolvedValueOnce('test-project');
@@ -73,7 +73,7 @@ describe('project_scaffold', () => {
         it('should not prompt when all dependencies are available', async () => {
             const { isDockerInstalled } = await import('#services/docker.js');
             const { isClaudeCliAvailable } = await import('#utils/claude.js');
-            const { confirm } = await import('@inquirer/prompts');
+            const { confirm } = await import('#utils/prompt.js');
             vi.mocked(isDockerInstalled).mockReturnValue(true);
             vi.mocked(isClaudeCliAvailable).mockReturnValue(true);
             await checkDependencies();
@@ -82,7 +82,7 @@ describe('project_scaffold', () => {
         it('should prompt user when docker is missing', async () => {
             const { isDockerInstalled } = await import('#services/docker.js');
             const { isClaudeCliAvailable } = await import('#utils/claude.js');
-            const { confirm } = await import('@inquirer/prompts');
+            const { confirm } = await import('#utils/prompt.js');
             vi.mocked(isDockerInstalled).mockReturnValue(false);
             vi.mocked(isClaudeCliAvailable).mockReturnValue(true);
             vi.mocked(confirm).mockResolvedValue(true);
@@ -94,7 +94,7 @@ describe('project_scaffold', () => {
         it('should throw UserCancelledError when user declines to proceed', async () => {
             const { isDockerInstalled } = await import('#services/docker.js');
             const { isClaudeCliAvailable } = await import('#utils/claude.js');
-            const { confirm } = await import('@inquirer/prompts');
+            const { confirm } = await import('#utils/prompt.js');
             vi.mocked(isDockerInstalled).mockReturnValue(false);
             vi.mocked(isClaudeCliAvailable).mockReturnValue(true);
             vi.mocked(confirm).mockResolvedValue(false);

package/dist/services/workflow_builder.js

@@ -2,7 +2,8 @@
  * Workflow builder service for implementing workflows from plan files
  */
 import { ADDITIONAL_INSTRUCTIONS, BUILD_COMMAND_OPTIONS, invokeBuildWorkflow as invokeBuildWorkflowFromClient, replyToClaude } from './claude_client.js';
-import { input } from '@inquirer/prompts';
+import { input } from '#utils/prompt.js';
+import { isInteractive } from '#utils/interactive.js';
 import { ux } from '@oclif/core';
 import fs from 'node:fs/promises';
 import path from 'node:path';
@@ -70,6 +71,9 @@ async function processModification(modification, currentOutput) {
     }
 }
 async function interactiveRefinementLoop(currentOutput) {
+    if (!isInteractive()) {
+        return currentOutput;
+    }
     const modification = await promptForModification();
     if (isAcceptCommand(modification)) {
         return currentOutput;

package/dist/services/workflow_builder.spec.js

@@ -1,11 +1,12 @@
 import { describe, it, expect, beforeEach, vi } from 'vitest';
 import { buildWorkflow, buildWorkflowInteractiveLoop } from './workflow_builder.js';
 import { ADDITIONAL_INSTRUCTIONS, BUILD_COMMAND_OPTIONS, invokeBuildWorkflow, replyToClaude } from './claude_client.js';
-import { input } from '@inquirer/prompts';
+import { input } from '#utils/prompt.js';
 import { ux } from '@oclif/core';
 import fs from 'node:fs/promises';
 vi.mock('./claude_client.js');
-vi.mock('@inquirer/prompts');
+vi.mock('#utils/prompt.js');
+vi.mock('#utils/interactive.js', () => ({ isInteractive: () => true }));
 vi.mock('@oclif/core', () => ({
     ux: {
         stdout: vi.fn(),

package/dist/templates/agent_instructions/CLAUDE.md.template

@@ -4,16 +4,50 @@ This is an **Output.ai** project - a framework for building reliable, production
 
 ## Getting Started
 
-For full framework documentation, commands, and AI-assisted workflow development, install our Claude Code plugins:
+Install Claude Code plugins for full framework documentation and AI-assisted development:
 
 ```bash
 claude plugin marketplace add growthxai/output
 claude plugin install outputai@outputai --scope project
 ```
 
+## Commands
+
+```bash
+npm run output:dev           # Start dev environment (worker + Temporal)
+npm run output:worker:build  # Build TypeScript to dist/
+npm run output:worker:watch  # Build + restart on file changes
+npm run output:worker        # Install, build, and start worker
+```
+
+## Project Structure
+
+```
+src/
+  workflows/         # Each subfolder is one workflow
+    <name>/
+      workflow.ts    # Workflow orchestration (must be deterministic - no I/O)
+      steps.ts       # Step functions (all I/O: HTTP, LLM, DB)
+      evaluators.ts  # Evaluator functions (LLM-based quality assessment)
+      types.ts       # Zod schemas and TypeScript types
+      prompts/       # .prompt files (Liquid.js templates with YAML frontmatter)
+      scenarios/     # Test scenario JSON files
+  clients/           # Shared HTTP clients (use @outputai/http, not fetch/axios)
+  shared/            # Shared utilities across workflows
+config/
+  costs.yml              # Token/API pricing overrides
+  credentials.yml.enc    # Encrypted secrets (edit via: output credentials edit)
+  credentials.yml.template  # Credential structure reference
+```
+
+## Key Conventions
+
+- **Workflows are deterministic**: No I/O, no `Date.now()`, no `Math.random()` in `workflow.ts`. All side effects go in steps or evaluators.
+- **HTTP clients**: Always use `httpClient` from `@outputai/http` -- never raw `fetch` or `axios`. This enables automatic tracing and cost tracking.
+- **LLM calls**: Use `generateText` from `@outputai/llm` with `.prompt` files. Never call LLM APIs directly.
+
 ---
 
 ## Project-Specific Instructions
 
 <!-- Add your project-specific instructions below -->
-

package/dist/templates/agent_instructions/dotclaude/settings.json.template

@@ -4,8 +4,8 @@
       "WebFetch",
       "Bash(npx output:*)",
       "Bash(npm run output:*)",
-      "Skills(output*)",
-      "Skills(flow*)"
+      "Skill(output*)",
+      "Skill(outputai:*)"
     ]
   },
   "enabledPlugins": {

package/dist/utils/date_formatter.d.ts

@@ -14,7 +14,17 @@ export declare function formatDuration(ms: number): string;
  */
 export declare function formatDate(isoString: string | null | undefined): string;
 /**
- * Format a duration between two ISO timestamps
+ * Calculate elapsed milliseconds between two ISO timestamps.
+ * If completedAt is null/undefined, uses current time (for in-progress durations).
+ */
+export declare function elapsedMs(startedAt: string, completedAt?: string | null): number;
+/**
+ * Format a duration in milliseconds to a compact string that fits in narrow columns.
+ * Always returns a short single-token string (e.g., "150ms", "7.56s", "24.2m", "1.3h").
+ */
+export declare function formatDurationCompact(ms: number): string;
+/**
+ * Format a duration between two ISO timestamps.
  *
  * @param startedAt - ISO 8601 start timestamp
  * @param completedAt - ISO 8601 end timestamp (or null if still running)

package/dist/utils/date_formatter.js

@@ -33,7 +33,32 @@ export function formatDate(isoString) {
     return format(parseISO(isoString), 'MMM d, yyyy h:mm a');
 }
 /**
- * Format a duration between two ISO timestamps
+ * Calculate elapsed milliseconds between two ISO timestamps.
+ * If completedAt is null/undefined, uses current time (for in-progress durations).
+ */
+export function elapsedMs(startedAt, completedAt) {
+    const start = parseISO(startedAt).getTime();
+    const end = completedAt ? parseISO(completedAt).getTime() : Date.now();
+    return end - start;
+}
+/**
+ * Format a duration in milliseconds to a compact string that fits in narrow columns.
+ * Always returns a short single-token string (e.g., "150ms", "7.56s", "24.2m", "1.3h").
+ */
+export function formatDurationCompact(ms) {
+    if (ms < 1000) {
+        return `${ms}ms`;
+    }
+    if (ms < 60_000) {
+        return `${(ms / 1000).toFixed(2)}s`;
+    }
+    if (ms < 3_600_000) {
+        return `${(ms / 60_000).toFixed(1)}m`;
+    }
+    return `${(ms / 3_600_000).toFixed(1)}h`;
+}
+/**
+ * Format a duration between two ISO timestamps.
  *
  * @param startedAt - ISO 8601 start timestamp
  * @param completedAt - ISO 8601 end timestamp (or null if still running)

package/dist/utils/interactive.d.ts

@@ -0,0 +1,2 @@
+export declare const setNonInteractive: (value: boolean) => void;
+export declare const isInteractive: () => boolean;

package/dist/utils/interactive.js

@@ -0,0 +1,5 @@
+const state = { nonInteractive: false };
+export const setNonInteractive = (value) => {
+    state.nonInteractive = value;
+};
+export const isInteractive = () => !state.nonInteractive && !!process.stdin.isTTY;

package/dist/utils/interactive.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/utils/interactive.spec.js

@@ -0,0 +1,40 @@
+import { describe, it, expect, beforeEach } from 'vitest';
+describe('interactive', () => {
+    beforeEach(async () => {
+        // Re-import to reset singleton state
+        const mod = await import('./interactive.js');
+        mod.setNonInteractive(false);
+    });
+    it('isInteractive returns true by default when TTY is available', async () => {
+        const originalIsTTY = process.stdin.isTTY;
+        Object.defineProperty(process.stdin, 'isTTY', { value: true, configurable: true });
+        const { isInteractive } = await import('./interactive.js');
+        expect(isInteractive()).toBe(true);
+        Object.defineProperty(process.stdin, 'isTTY', { value: originalIsTTY, configurable: true });
+    });
+    it('isInteractive returns false when no TTY', async () => {
+        const originalIsTTY = process.stdin.isTTY;
+        Object.defineProperty(process.stdin, 'isTTY', { value: undefined, configurable: true });
+        const { isInteractive } = await import('./interactive.js');
+        expect(isInteractive()).toBe(false);
+        Object.defineProperty(process.stdin, 'isTTY', { value: originalIsTTY, configurable: true });
+    });
+    it('isInteractive returns false after setNonInteractive(true)', async () => {
+        const originalIsTTY = process.stdin.isTTY;
+        Object.defineProperty(process.stdin, 'isTTY', { value: true, configurable: true });
+        const { isInteractive, setNonInteractive } = await import('./interactive.js');
+        setNonInteractive(true);
+        expect(isInteractive()).toBe(false);
+        Object.defineProperty(process.stdin, 'isTTY', { value: originalIsTTY, configurable: true });
+    });
+    it('setNonInteractive(false) restores interactive mode', async () => {
+        const originalIsTTY = process.stdin.isTTY;
+        Object.defineProperty(process.stdin, 'isTTY', { value: true, configurable: true });
+        const { isInteractive, setNonInteractive } = await import('./interactive.js');
+        setNonInteractive(true);
+        expect(isInteractive()).toBe(false);
+        setNonInteractive(false);
+        expect(isInteractive()).toBe(true);
+        Object.defineProperty(process.stdin, 'isTTY', { value: originalIsTTY, configurable: true });
+    });
+});

package/dist/utils/open_url.d.ts

@@ -0,0 +1 @@
+export declare const openUrl: (url: string) => void;

package/dist/utils/open_url.js

@@ -0,0 +1,12 @@
+import { execFile } from 'node:child_process';
+export const openUrl = (url) => {
+    if (process.platform === 'darwin') {
+        execFile('open', [url]);
+    }
+    else if (process.platform === 'win32') {
+        execFile('cmd', ['/c', 'start', url]);
+    }
+    else {
+        execFile('xdg-open', [url]);
+    }
+};

package/dist/utils/prompt.d.ts

@@ -0,0 +1,17 @@
+type ConfirmOptions = {
+    message: string;
+    default?: boolean;
+};
+type InputOptions = {
+    message: string;
+    default?: string;
+    validate?: (value: string) => boolean | string;
+};
+type PasswordOptions = {
+    message: string;
+    mask?: boolean;
+};
+export declare const confirm: (options: ConfirmOptions) => Promise<boolean>;
+export declare const input: (options: InputOptions) => Promise<string>;
+export declare const password: (options: PasswordOptions) => Promise<string>;
+export {};

package/dist/utils/prompt.js

@@ -0,0 +1,20 @@
+import { confirm as inquirerConfirm, input as inquirerInput, password as inquirerPassword } from '@inquirer/prompts';
+import { isInteractive } from './interactive.js';
+export const confirm = async (options) => {
+    if (!isInteractive()) {
+        return options.default ?? true;
+    }
+    return inquirerConfirm(options);
+};
+export const input = async (options) => {
+    if (!isInteractive()) {
+        return options.default ?? '';
+    }
+    return inquirerInput(options);
+};
+export const password = async (options) => {
+    if (!isInteractive()) {
+        return '';
+    }
+    return inquirerPassword(options);
+};

package/dist/utils/prompt.spec.d.ts

@@ -0,0 +1 @@
+export {};