vgxness 1.20.4 → 1.20.6

package/dist/interfaces/cli/dispatcher.js

@@ -0,0 +1,247 @@
+// Thin CLI router -- all command handlers live in src/cli/commands/*.ts
+import { createRequire } from 'node:module';
+import { isWorkflowId } from '../../workflows/schema.js';
+import { runBootAgentSeedUpgrade } from '../../agents/boot-upgrade.js';
+import { databasePathFor, parseArgs, requiredFlag } from './cli-flags.js';
+import { okText, usageFailure, visibleHelpText } from './cli-help.js';
+import { openCliDatabase, resultFailure } from './cli-helpers.js';
+import { runAgentCommand, runApprovalsCommand, runDefaultInteractiveEntrypoint, runDoctorAliasCommand, runHomeTuiCommand, runInitCommand, runMcpDoctorCommand, runMcpInstallCommand, runMcpSetupCommand, runMemoryCommand, runMemoryImportCommand, runOpenCodeCommand, runOrchestratorCommand, runPermissionsCommand, runProductNextCommand, runProductResumeCommand, runProductStatusCommand, runRunsCommand, runSddCommand, runSetupApplyCommand, runSetupLifecycleCommand, runSetupPlanCommand, runSetupReinstallApplyCommand, runSetupRollbackCommand, runSkillCommand, runSubagentCommand, runVerificationPlanCommand, runVerificationReportCommand, runWorkflowExecuteCommand, runWorkflowPreviewCommand, runWorkflowRunCommand, } from './commands/index.js';
+import { canRunInteractiveTui } from './tui/terminal-capabilities.js';
+const _promptBuffers = new WeakMap();
+const require = createRequire(import.meta.url);
+const packageJson = require('../../../package.json');
+const cliVersion = typeof packageJson.version === 'string' ? packageJson.version : 'unknown';
+export function dispatchCli(argv, environment) {
+    if (isGlobalVersionRequest(argv))
+        return okText(`${cliVersion}\n`);
+    const parsed = parseArgs(argv);
+    const [area, command] = parsed.positionals;
+    if (!area || area === 'help' || area === '--help' || area === '-h')
+        return okText(visibleHelpText());
+    if (area === 'status')
+        return runProductStatusCommand(parsed, environment);
+    if (area === 'next')
+        return runProductNextCommand(parsed, environment);
+    if (area === 'resume')
+        return runProductResumeCommand(parsed, environment);
+    if (area === 'init')
+        return runSetupPlanCommand(parsed, environment);
+    if (area === 'doctor')
+        return usageFailure('doctor is available through the async CLI entrypoint; run vgxness doctor from the installed CLI.');
+    if (!command)
+        return usageFailure(`Missing command for ${area}`);
+    const commandValidation = validateCommand(area, command);
+    if (!commandValidation.ok)
+        return usageFailure(commandValidation.message);
+    if (area === 'setup')
+        return runSetupLifecycleCommand(parsed, environment);
+    if (area === 'verification' && command === 'plan')
+        return runVerificationPlanCommand(command, parsed);
+    if (isWorkflowId(area) && command === 'preview')
+        return runWorkflowPreviewCommand(area, parsed);
+    if (area === 'orchestrator' && command === 'preview') {
+        const project = requiredFlag(parsed.flags, 'project');
+        if (!project.ok)
+            return resultFailure(project);
+        const intent = requiredFlag(parsed.flags, 'intent');
+        if (!intent.ok)
+            return resultFailure(intent);
+    }
+    if (area === 'memory' && command === 'import')
+        return runMemoryImportCommand(parsed, environment);
+    const selectedDatabasePath = databasePathFor(parsed.flags, environment);
+    if (!selectedDatabasePath.ok)
+        return resultFailure(selectedDatabasePath);
+    const databasePath = selectedDatabasePath.value;
+    const opened = openCliDatabase(databasePath);
+    if (!opened.ok)
+        return resultFailure(opened);
+    if (!skipsBootAgentSeedUpgrade(area, command))
+        runBootAgentSeedUpgrade(opened.value, environment.env);
+    try {
+        if (isWorkflowId(area) && command === 'run')
+            return runWorkflowRunCommand(area, parsed, opened.value);
+        if (isWorkflowId(area) && command === 'execute')
+            return runWorkflowExecuteCommand(area, parsed, opened.value, environment);
+        if (area === 'agents')
+            return runAgentCommand(command, parsed, opened.value, environment);
+        if (area === 'subagents')
+            return runSubagentCommand(command, parsed, opened.value, environment);
+        if (area === 'memory')
+            return runMemoryCommand(command, parsed, opened.value);
+        if (area === 'approvals')
+            return runApprovalsCommand(command, parsed, opened.value);
+        if (area === 'runs')
+            return runRunsCommand(command, parsed, opened.value, environment);
+        if (area === 'permissions')
+            return runPermissionsCommand(command, parsed, opened.value, environment);
+        if (area === 'skills')
+            return runSkillCommand(command, parsed, opened.value, environment);
+        if (area === 'sdd')
+            return runSddCommand(command, parsed, opened.value, environment);
+        if (area === 'verification' && command === 'report')
+            return runVerificationReportCommand(command, parsed, opened.value, environment);
+        if (area === 'orchestrator')
+            return runOrchestratorCommand(command, parsed, opened.value);
+        if (area === 'opencode')
+            return runOpenCodeCommand(command, parsed, opened.value, environment);
+        return usageFailure(`Unknown command area: ${area}`);
+    }
+    finally {
+        opened.value.close();
+    }
+}
+function skipsBootAgentSeedUpgrade(area, command) {
+    return area === 'skills' && (command === 'index' || command === 'export');
+}
+function isGlobalVersionRequest(argv) {
+    return argv.length === 1 && (argv[0] === '--version' || argv[0] === '-v');
+}
+export async function dispatchCliAsync(argv, environment) {
+    const parsed = parseArgs(argv);
+    const [area, command] = parsed.positionals;
+    if (argv.length === 0) {
+        if (canRunInteractiveTui(environment.stdin, environment.stdout))
+            return runHomeTuiCommand({ positionals: [], flags: {} }, environment);
+        return runDefaultInteractiveEntrypoint(environment);
+    }
+    if (area === 'mcp') {
+        if (!command)
+            return usageFailure('Missing command for mcp');
+        if (command === 'install')
+            return runMcpInstallCommand(parsed, environment);
+        if (command === 'setup')
+            return runMcpSetupCommand(parsed, environment);
+        if (command === 'doctor')
+            return runMcpDoctorCommand(parsed, environment);
+        return usageFailure(`Unknown mcp command: ${command}`);
+    }
+    if (area === 'doctor')
+        return runDoctorAliasCommand(parsed, environment);
+    if (area === 'init')
+        return runInitCommand(parsed, environment);
+    if (area === 'setup' && command === 'apply')
+        return runSetupApplyCommand(parsed, environment);
+    if (area === 'setup' && command === 'reinstall' && parsed.flags.yes === true)
+        return runSetupReinstallApplyCommand(parsed, environment);
+    if (area === 'setup' && command === 'rollback')
+        return runSetupRollbackCommand(parsed, environment);
+    return dispatchCli(argv, environment);
+}
+function validateCommand(area, command) {
+    if (area === 'agents') {
+        return command === 'register' ||
+            command === 'list' ||
+            command === 'get' ||
+            command === 'render' ||
+            command === 'resolve' ||
+            command === 'seed' ||
+            command === 'manager-profile'
+            ? { ok: true }
+            : { ok: false, message: `Unknown agents command: ${command}` };
+    }
+    if (area === 'subagents') {
+        return command === 'register' || command === 'list' || command === 'get' ? { ok: true } : { ok: false, message: `Unknown subagents command: ${command}` };
+    }
+    if (area === 'memory') {
+        return command === 'save' || command === 'search' || command === 'import' ? { ok: true } : { ok: false, message: `Unknown memory command: ${command}` };
+    }
+    if (area === 'runs') {
+        return command === 'create' ||
+            command === 'list' ||
+            command === 'get' ||
+            command === 'timeline' ||
+            command === 'debug' ||
+            command === 'resume-plan' ||
+            command === 'resume-inspect' ||
+            command === 'export-snapshot' ||
+            command === 'checkpoint' ||
+            command === 'finish' ||
+            command === 'permission-check' ||
+            command === 'preflight' ||
+            command === 'approvals' ||
+            command === 'retry-check' ||
+            command === 'resume-gate' ||
+            command === 'approve' ||
+            command === 'reject' ||
+            command === 'cancel-approval' ||
+            command === 'task-grant-create' ||
+            command === 'task-grant-list' ||
+            command === 'task-grant-get' ||
+            command === 'task-grant-revoke' ||
+            command === 'task-grant-preview'
+            ? { ok: true }
+            : { ok: false, message: `Unknown runs command: ${command}` };
+    }
+    if (area === 'approvals') {
+        return command === 'list' || command === 'approve' || command === 'reject' ? { ok: true } : { ok: false, message: `Unknown approvals command: ${command}` };
+    }
+    if (area === 'permissions') {
+        return command === 'check' ? { ok: true } : { ok: false, message: `Unknown permissions command: ${command}` };
+    }
+    if (area === 'skills') {
+        return command === 'register' ||
+            command === 'list' ||
+            command === 'get' ||
+            command === 'add-version' ||
+            command === 'attach' ||
+            command === 'detach' ||
+            command === 'record-usage' ||
+            command === 'resolve' ||
+            command === 'index' ||
+            command === 'export' ||
+            command === 'status' ||
+            command === 'payload' ||
+            command === 'propose' ||
+            command === 'proposals' ||
+            command === 'create-scenario' ||
+            command === 'list-scenarios' ||
+            command === 'record-evaluation-result' ||
+            command === 'list-evaluation-results' ||
+            command === 'get-proposal' ||
+            command === 'submit-proposal' ||
+            command === 'approve-proposal' ||
+            command === 'reject-proposal' ||
+            command === 'cancel-proposal' ||
+            command === 'apply-proposal'
+            ? { ok: true }
+            : { ok: false, message: `Unknown skills command: ${command}` };
+    }
+    if (area === 'sdd') {
+        return command === 'preview' ||
+            command === 'run' ||
+            command === 'execute' ||
+            command === 'status' ||
+            command === 'next' ||
+            command === 'continue' ||
+            command === 'cockpit' ||
+            command === 'ready' ||
+            command === 'save-artifact' ||
+            command === 'accept-artifact' ||
+            command === 'reopen-artifact' ||
+            command === 'get-artifact' ||
+            command === 'list-artifacts' ||
+            command === 'export' ||
+            command === 'import'
+            ? { ok: true }
+            : { ok: false, message: `Unknown sdd command: ${command}` };
+    }
+    if (isWorkflowId(area)) {
+        return command === 'preview' || command === 'run' || command === 'execute' ? { ok: true } : { ok: false, message: `Unknown ${area} command: ${command}` };
+    }
+    if (area === 'orchestrator') {
+        return command === 'preview' ? { ok: true } : { ok: false, message: `Unknown orchestrator command: ${command}` };
+    }
+    if (area === 'opencode') {
+        return command === 'preview' ? { ok: true } : { ok: false, message: `Unknown opencode command: ${command}` };
+    }
+    if (area === 'setup') {
+        return command === 'status' || command === 'plan' || command === 'apply' || command === 'reinstall' || command === 'backup' || command === 'rollback'
+            ? { ok: true }
+            : { ok: false, message: `Unknown setup command: ${command}` };
+    }
+    if (area === 'verification') {
+        return command === 'plan' || command === 'report' ? { ok: true } : { ok: false, message: `Unknown verification command: ${command}` };
+    }
+    return { ok: false, message: `Unknown command area: ${area}` };
+}

package/dist/interfaces/cli/doctor-renderer.js

@@ -0,0 +1,26 @@
+const checkLabels = {
+    pass: 'PASS',
+    fail: 'FAIL',
+    skip: 'SKIP',
+};
+export function renderDoctorReport(input) {
+    const failedCheckRemediation = input.report.checks.find((check) => check.status === 'fail' && check.remediation !== undefined)?.remediation;
+    const next = input.report.ready
+        ? 'VGXNESS doctor checks are ready; continue with your SDD workflow.'
+        : (failedCheckRemediation ?? 'Resolve failed or skipped checks, then rerun `vgxness doctor --json` or `vgxness doctor`.');
+    const lines = [
+        'VGXNESS Doctor',
+        `Project: ${input.project}`,
+        `Change: ${input.change}`,
+        `Status: ${input.report.ready ? 'ready' : 'not ready'}`,
+        '',
+        'Checks:',
+    ];
+    for (const check of input.report.checks) {
+        lines.push(`- [${checkLabels[check.status]}] ${check.id}: ${check.detail}`);
+        if (check.status !== 'pass' && check.remediation !== undefined)
+            lines.push(`  Fix: ${check.remediation}`);
+    }
+    lines.push('', 'Safety: [read-only] No provider config was written. This diagnostic does not install or repair provider config.', `Next: ${next}`);
+    return `${lines.join('\n')}\n`;
+}