agentic-orchestrator 0.1.2 → 0.1.4

package/dist/apps/control-plane/cli/help-command-handler.js

@@ -0,0 +1,146 @@
+import { CliCommand } from './types.js';
+const COMMAND_HELP = {
+    [CliCommand.Run]: {
+        usage: 'aop run [flags]',
+        description: 'Ingest spec files and start the agent supervisor.',
+        flags: [
+            { flag: '-fi <path>', description: 'Input spec file path' },
+            { flag: '-fl <path>', description: 'Input spec folder path' },
+            { flag: '--batch', description: 'Batch-ingest all specs in the folder (skip already-active features)' },
+            { flag: '--agent-provider <name>', description: 'Override agent provider (claude, codex, gemini, …)' },
+            { flag: '--agent-model <name>', description: 'Override agent model' },
+            { flag: '--agent-config <path>', description: 'Path to agent config file' },
+            { flag: '--provider-config-env <var>', description: 'Env var name that holds provider API key' },
+            { flag: '--transport <inprocess|mcp>', description: 'Tool transport layer (default: mcp)' },
+            { flag: '--takeover-stale-run', description: 'Take over a stale run lease' },
+            { flag: '--project <name>', description: 'Select project from multi-project.yaml' }
+        ]
+    },
+    [CliCommand.Status]: {
+        usage: 'aop status [flags]',
+        description: 'Show live status of all tracked features.',
+        flags: [
+            { flag: '--summary', description: 'Print a condensed one-line-per-feature summary' },
+            { flag: '--all', description: 'Aggregate status across all projects in multi-project.yaml' },
+            { flag: '--project <name>', description: 'Scope to a specific project' }
+        ]
+    },
+    [CliCommand.Resume]: {
+        usage: 'aop resume [flags]',
+        description: 'Resume blocked or stalled features.',
+        flags: [
+            { flag: '--feature-id <id>', description: 'Resume a specific feature' },
+            { flag: '--force', description: 'Force-resume even if the feature is not blocked' },
+            { flag: '--transport <inprocess|mcp>', description: 'Tool transport layer (default: mcp)' }
+        ]
+    },
+    [CliCommand.Stop]: {
+        usage: 'aop stop',
+        description: 'Signal the running supervisor to stop gracefully.'
+    },
+    [CliCommand.Delete]: {
+        usage: 'aop delete [flags]',
+        description: 'Delete one or all features from the index.',
+        flags: [
+            { flag: '--feature-id <id>', description: 'Feature to delete' },
+            { flag: '--all', description: 'Delete all features' },
+            { flag: '--dry-run', description: 'Preview what would be deleted without making changes' }
+        ]
+    },
+    [CliCommand.Cleanup]: {
+        usage: 'aop cleanup [flags]',
+        description: 'Clean up merged or stale feature state and worktrees.',
+        flags: [
+            { flag: '--feature-id <id>', description: 'Clean up a specific feature' },
+            { flag: '--all', description: 'Clean up all eligible features' },
+            { flag: '--remove-worktree', description: 'Remove the git worktree after cleanup' },
+            { flag: '--remove-branch <none|safe|force>', description: 'Branch removal mode after cleanup' },
+            { flag: '--dry-run', description: 'Preview what would be cleaned without making changes' },
+            { flag: '--yes', description: 'Skip confirmation prompts' }
+        ]
+    },
+    [CliCommand.Init]: {
+        usage: 'aop init [flags]',
+        description: 'Initialise agentic orchestrator configuration in the current directory.',
+        flags: [
+            { flag: '--auto', description: 'Run non-interactively with defaults' },
+            { flag: '--force', description: 'Overwrite existing configuration' }
+        ]
+    },
+    [CliCommand.Dashboard]: {
+        usage: 'aop dashboard [flags]',
+        description: 'Start the web dashboard server.',
+        flags: [
+            { flag: '--port <number>', description: 'Port to listen on (default: 3000)' },
+            { flag: '--foreground', description: 'Keep the server in the foreground' },
+            { flag: '--dev', description: 'Start in Next.js dev mode' }
+        ]
+    },
+    [CliCommand.Retry]: {
+        usage: 'aop retry [flags]',
+        description: 'Retry a failed gate or step for a feature.',
+        flags: [
+            { flag: '--feature-id <id>', description: 'Feature to retry' },
+            { flag: '--force', description: 'Force retry even if the feature is not in a failed state' }
+        ]
+    },
+    [CliCommand.Send]: {
+        usage: 'aop send <feature-id> <message>',
+        description: 'Send a message to an active agent for a feature.',
+        flags: [
+            { flag: '--feature-id <id>', description: 'Target feature (can also be the first positional argument)' },
+            { flag: '--message <text>', description: 'Message to deliver (can also be the remaining positional arguments)' }
+        ]
+    },
+    [CliCommand.Attach]: {
+        usage: 'aop attach <feature-id>',
+        description: 'Attach to the running agent session for a feature (interactive).',
+        flags: [
+            { flag: '--feature-id <id>', description: 'Feature to attach to (can also be the first positional argument)' }
+        ]
+    },
+    [CliCommand.Help]: {
+        usage: 'aop help [command]',
+        description: 'Show this help text, or detailed help for a specific command.',
+        flags: [{ flag: '--help, -h', description: 'Can also be used with any command' }]
+    }
+};
+function pad(str, width) {
+    return str + ' '.repeat(Math.max(0, width - str.length));
+}
+function renderCommand(cmd, help) {
+    const lines = [`  ${pad(cmd, 12)}${help.description}`];
+    return lines.join('\n');
+}
+function renderCommandDetail(help) {
+    const lines = [`Usage: ${help.usage}`, '', `  ${help.description}`];
+    if (help.flags && help.flags.length > 0) {
+        lines.push('', 'Flags:');
+        const colWidth = Math.max(...help.flags.map((f) => f.flag.length)) + 4;
+        for (const { flag, description } of help.flags) {
+            lines.push(`  ${pad(flag, colWidth)}${description}`);
+        }
+    }
+    return lines.join('\n');
+}
+export class HelpCommandHandler {
+    execute(subcommand) {
+        const target = subcommand;
+        if (target && target in COMMAND_HELP) {
+            const help = renderCommandDetail(COMMAND_HELP[target]);
+            return { ok: true, data: { help } };
+        }
+        const header = [
+            'aop — Agentic Orchestrator control plane',
+            '',
+            'Usage: aop <command> [flags]',
+            '',
+            'Commands:'
+        ];
+        const commandLines = Object.entries(COMMAND_HELP).map(([cmd, help]) => renderCommand(cmd, help));
+        const footer = ['', 'Run `aop help <command>` for detailed help on any command.', 'Flags: --help, -h'];
+        const help = [...header, ...commandLines, ...footer].join('\n');
+        return { ok: true, data: { help } };
+    }
+}
+//# sourceMappingURL=help-command-handler.js.map

package/dist/apps/control-plane/cli/help-command-handler.js.map

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

package/dist/apps/control-plane/cli/init-command-handler.d.ts

@@ -0,0 +1,26 @@
+export interface InitOptions {
+    auto?: boolean;
+    force?: boolean;
+}
+interface PromptSession {
+    question(query: string): Promise<string>;
+    close(): void;
+}
+export interface InitCommandResult {
+    ok: true;
+    data: {
+        command: 'init';
+        created: string[];
+        updated: string[];
+        skipped: string[];
+        validation_warnings: string[];
+        next_steps: string[];
+    };
+}
+export declare class InitCommandHandler {
+    private readonly repoRoot;
+    private readonly promptFactory;
+    constructor(repoRoot: string, promptFactory?: () => PromptSession);
+    execute(options: InitOptions): Promise<InitCommandResult>;
+}
+export {};