@hongmaple0820/scale-engine 0.27.0 → 0.28.0

package/dist/api/cli.js

@@ -65,7 +65,7 @@ import { doctorHtmlArtifacts, renderHtmlArtifact, resolveHtmlArtifactForOpen, se
 import { renderGovernanceDashboard } from '../output/GovernanceDashboard.js';
 import { cleanupWorkspaceLifecycle, inspectWorkspaceLifecycle, } from '../workflow/WorkspaceLifecycle.js';
 import { inspectWorkspaceSafety } from '../workflow/WorkspaceSafety.js';
-import { RuntimeEvidenceLedger, SessionLedger, createAiOsPlan, doctorRuntimeEvidence, evaluateFinalReportReadiness, } from '../runtime/index.js';
+import { RuntimeEvidenceLedger, SessionLedger, createAiOsAdoption, createAiOsBenchmark, createAiOsDashboard, createAiOsDoctor, createAiOsMigration, createAiOsPlan, createAiOsRun, createAiOsStatus, doctorRuntimeEvidence, evaluateFinalReportReadiness, } from '../runtime/index.js';
 import { MemoryFabric, MemoryBrain, doctorMemoryFabric, renderContextPackMarkdown, renderMemoryLearningCandidateMarkdown, inspectMemoryProviders, recallMemoryProviders, settleMemoryLearning, writeMemoryProvidersConfig, } from '../memory/index.js';
 import { resolveWorkspaceTopology, workspaceTopologyPath, workspaceTopologyTemplate, } from '../workflow/WorkspaceTopology.js';
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
@@ -2950,9 +2950,342 @@ const aiOsPlanCommand = defineCommand({
             console.log(`  recommendation: ${recommendation}`);
     },
 });
+const aiOsRunCommand = defineCommand({
+    meta: { name: 'run', description: 'Run the AI OS beta loop in dry-run or guarded mode and write an execution report' },
+    args: {
+        dir: { type: 'string', default: PROJECT_DIR, description: 'Project directory' },
+        'task-id': { type: 'string', description: 'Task id' },
+        task: { type: 'string', required: true, description: 'Task or requirement description' },
+        level: { type: 'string', default: 'M', description: 'Task level: S, M, L, or CRITICAL' },
+        files: { type: 'string', description: 'Comma-separated changed or target files' },
+        services: { type: 'string', description: 'Comma-separated affected services' },
+        budget: { type: 'string', description: 'Maximum estimated tokens for the context compiler' },
+        'requested-mode': { type: 'string', description: 'Requested governance mode: minimal, standard, expanded, or critical' },
+        verify: { type: 'string', description: 'Comma-separated guarded verification commands to run without shell by default' },
+        timeout: { type: 'string', description: 'Verification command timeout in milliseconds' },
+        mode: { type: 'string', description: 'Run mode: dry-run or guarded' },
+        'dry-run': { type: 'boolean', default: false, description: 'Force dry-run mode without executing external commands' },
+        'allow-shell': { type: 'boolean', default: false, description: 'Allow shell execution for trusted local guarded runs' },
+        json: { type: 'boolean', default: false },
+    },
+    async run({ args }) {
+        const projectDir = resolve(String(args.dir ?? PROJECT_DIR));
+        const scaleDir = resolveScaleDirForProject(projectDir);
+        const report = await createAiOsRun({
+            projectDir,
+            scaleDir,
+            taskId: args['task-id'] ? String(args['task-id']) : undefined,
+            task: String(args.task),
+            level: normalizeTaskArtifactLevel(args.level),
+            files: parseCommaList(args.files),
+            services: parseCommaList(args.services),
+            budget: parsePositiveIntArg(args.budget, '--budget'),
+            requestedMode: normalizeGovernanceMode(args['requested-mode']),
+            mode: normalizeAiOsRunMode(args.mode, Boolean(args['dry-run'])),
+            verificationCommands: parseCommaList(args.verify),
+            commandTimeoutMs: parsePositiveIntArg(args.timeout, '--timeout'),
+            allowShell: Boolean(args['allow-shell']),
+        });
+        if (args.json) {
+            console.log(JSON.stringify(report, null, 2));
+            if (report.status === 'blocked')
+                process.exitCode = 1;
+            return;
+        }
+        console.log('SCALE AI OS Runtime Run');
+        console.log(`  Version: ${report.version}`);
+        console.log(`  Mode: ${report.mode}`);
+        console.log(`  Status: ${report.status}`);
+        console.log(`  Task: ${report.plan.task.taskId ?? 'n/a'} ${report.plan.task.task}`);
+        console.log(`  Steps: ${report.steps.filter(step => step.status === 'passed').length} passed, ${report.steps.filter(step => step.status === 'planned').length} planned, ${report.steps.filter(step => step.status === 'blocked').length} blocked`);
+        console.log(`  Verification: ${report.verification.commands.filter(command => command.status === 'passed').length}/${report.verification.commands.length} passed`);
+        console.log(`  Evidence: ${report.evidence.produced.length} produced, ${report.evidence.pending.length} pending`);
+        console.log(`  Report: ${report.artifacts.runReport}`);
+        for (const action of report.nextActions.slice(0, 6))
+            console.log(`  next: ${action}`);
+        if (report.status === 'blocked')
+            process.exitCode = 1;
+    },
+});
+const aiOsDashboardCommand = defineCommand({
+    meta: { name: 'dashboard', description: 'Summarize AI OS runtime run reports and verification health' },
+    args: {
+        dir: { type: 'string', default: PROJECT_DIR, description: 'Project directory' },
+        limit: { type: 'string', description: 'Maximum latest run rows to include' },
+        json: { type: 'boolean', default: false },
+    },
+    run({ args }) {
+        const projectDir = resolve(String(args.dir ?? PROJECT_DIR));
+        const scaleDir = resolveScaleDirForProject(projectDir);
+        const dashboard = createAiOsDashboard({
+            projectDir,
+            scaleDir,
+            limit: parsePositiveIntArg(args.limit, '--limit'),
+        });
+        if (args.json) {
+            console.log(JSON.stringify(dashboard, null, 2));
+            return;
+        }
+        console.log('SCALE AI OS Dashboard');
+        console.log(`  Health: ${dashboard.health.status} (${dashboard.health.score})`);
+        console.log(`  Runs: ${dashboard.summary.totalRuns} total, ${dashboard.summary.readyRuns} ready, ${dashboard.summary.blockedRuns} blocked`);
+        console.log(`  Verification: ${dashboard.summary.verificationCommands} command(s), ${dashboard.summary.failedVerificationCommands} failed`);
+        console.log(`  Failure learning: ${dashboard.summary.failureLearningCandidates} candidate(s)`);
+        for (const run of dashboard.latestRuns) {
+            console.log(`  [${run.status}] ${run.taskId ?? 'n/a'} ${run.task}`);
+        }
+        for (const recommendation of dashboard.recommendations)
+            console.log(`  recommendation: ${recommendation}`);
+        for (const warning of dashboard.warnings)
+            console.log(`  warning: ${warning}`);
+    },
+});
+const aiOsBenchmarkCommand = defineCommand({
+    meta: { name: 'benchmark', description: 'Run fixed AI OS beta benchmark scenarios for context, memory, skill, governance, and dashboard metrics' },
+    args: {
+        dir: { type: 'string', default: PROJECT_DIR, description: 'Project directory' },
+        budget: { type: 'string', description: 'Scenario context budget' },
+        json: { type: 'boolean', default: false },
+    },
+    async run({ args }) {
+        const projectDir = resolve(String(args.dir ?? PROJECT_DIR));
+        const scaleDir = resolveScaleDirForProject(projectDir);
+        const benchmark = await createAiOsBenchmark({
+            projectDir,
+            scaleDir,
+            budget: parsePositiveIntArg(args.budget, '--budget'),
+        });
+        if (args.json) {
+            console.log(JSON.stringify(benchmark, null, 2));
+            return;
+        }
+        console.log('SCALE AI OS Benchmark');
+        console.log(`  Scenarios: ${benchmark.summary.scenarios}`);
+        console.log(`  Tokens: ${benchmark.summary.totalEstimatedTokens}/${benchmark.summary.totalBudget}; saved ${benchmark.summary.totalEstimatedTokenSavings}`);
+        console.log(`  Memory items: ${benchmark.summary.totalMemoryItems}`);
+        console.log(`  Skill steps: ${benchmark.summary.totalSkillSteps} (${benchmark.summary.requiredSkillSteps} required)`);
+        console.log(`  Governance modes: ${benchmark.summary.governanceModes.join(', ') || 'none'}`);
+        console.log(`  Dashboard health: ${benchmark.dashboard.health.status}`);
+        for (const scenario of benchmark.scenarios) {
+            console.log(`  [${scenario.governanceMode}] ${scenario.id}: tokens=${scenario.metrics.estimatedTokens}, skills=${scenario.metrics.skillSteps}, memory=${scenario.metrics.memoryItems}`);
+        }
+        for (const recommendation of benchmark.recommendations)
+            console.log(`  recommendation: ${recommendation}`);
+    },
+});
+const aiOsMigrateCommand = defineCommand({
+    meta: { name: 'migrate', description: 'Create or verify AI OS runtime state directories for this project' },
+    args: {
+        dir: { type: 'string', default: PROJECT_DIR, description: 'Project directory' },
+        json: { type: 'boolean', default: false },
+    },
+    run({ args }) {
+        const projectDir = resolve(String(args.dir ?? PROJECT_DIR));
+        const scaleDir = resolveScaleDirForProject(projectDir);
+        const report = createAiOsMigration({ projectDir, scaleDir });
+        if (args.json) {
+            console.log(JSON.stringify(report, null, 2));
+            return;
+        }
+        console.log('SCALE AI OS Migration');
+        console.log(`  Status: ${report.status}`);
+        console.log(`  Created: ${report.created.length}`);
+        console.log(`  Existing: ${report.existing.length}`);
+        console.log(`  Report: ${report.files.migrationReport}`);
+        for (const action of report.nextActions)
+            console.log(`  next: ${action}`);
+        for (const warning of report.warnings)
+            console.log(`  warning: ${warning}`);
+    },
+});
+const aiOsDoctorCommand = defineCommand({
+    meta: { name: 'doctor', description: 'Check AI OS beta runtime readiness, dashboard health, and benchmark freshness' },
+    args: {
+        dir: { type: 'string', default: PROJECT_DIR, description: 'Project directory' },
+        lang: { type: 'string', default: 'en', description: 'Output language zh/en' },
+        'benchmark-max-age-hours': { type: 'string', description: 'Maximum accepted benchmark report age in hours' },
+        json: { type: 'boolean', default: false },
+    },
+    run({ args }) {
+        const projectDir = resolve(String(args.dir ?? PROJECT_DIR));
+        const scaleDir = resolveScaleDirForProject(projectDir);
+        const report = createAiOsDoctor({
+            projectDir,
+            scaleDir,
+            lang: normalizeLangArg(args.lang),
+            benchmarkMaxAgeHours: parsePositiveIntArg(args['benchmark-max-age-hours'], '--benchmark-max-age-hours'),
+        });
+        if (args.json) {
+            console.log(JSON.stringify(report, null, 2));
+            if (report.status === 'blocked')
+                process.exitCode = 1;
+            return;
+        }
+        console.log('SCALE AI OS Doctor');
+        console.log(`  Status: ${report.status}`);
+        console.log(`  Checks: ${report.summary.passedChecks} passed, ${report.summary.warningChecks} warning, ${report.summary.blockedChecks} blocked`);
+        console.log(`  Dashboard: ${report.dashboard.health.status} (${report.dashboard.health.score})`);
+        console.log(`  Benchmark: ${report.benchmark.status}`);
+        for (const check of report.checks)
+            console.log(`  [${check.status}] ${check.id}: ${check.summary}`);
+        for (const action of report.nextActions)
+            console.log(`  next: ${action}`);
+        for (const warning of report.warnings)
+            console.log(`  warning: ${warning}`);
+        if (report.status === 'blocked')
+            process.exitCode = 1;
+    },
+});
+const aiOsAdoptCommand = defineCommand({
+    meta: { name: 'adopt', description: 'Prepare a project for AI OS runtime use by running migrate, first dry-run, benchmark, and doctor' },
+    args: {
+        dir: { type: 'string', default: PROJECT_DIR, description: 'Project directory' },
+        'task-id': { type: 'string', description: 'Task id for the first adoption dry-run report' },
+        task: { type: 'string', required: true, description: 'Task or adoption scenario description' },
+        level: { type: 'string', default: 'M', description: 'Task level: S, M, L, or CRITICAL' },
+        files: { type: 'string', description: 'Comma-separated changed or target files' },
+        services: { type: 'string', description: 'Comma-separated affected services' },
+        budget: { type: 'string', description: 'Maximum estimated tokens for the adoption plan and benchmark' },
+        'requested-mode': { type: 'string', description: 'Requested governance mode: minimal, standard, expanded, or critical' },
+        lang: { type: 'string', default: 'en', description: 'Output language zh/en' },
+        'benchmark-max-age-hours': { type: 'string', description: 'Maximum accepted benchmark report age in hours' },
+        json: { type: 'boolean', default: false },
+    },
+    async run({ args }) {
+        const projectDir = resolve(String(args.dir ?? PROJECT_DIR));
+        const scaleDir = resolveScaleDirForProject(projectDir);
+        const lang = normalizeLangArg(args.lang);
+        const report = await createAiOsAdoption({
+            projectDir,
+            scaleDir,
+            taskId: args['task-id'] ? String(args['task-id']) : undefined,
+            task: String(args.task),
+            level: normalizeTaskArtifactLevel(args.level),
+            files: parseCommaList(args.files),
+            services: parseCommaList(args.services),
+            budget: parsePositiveIntArg(args.budget, '--budget'),
+            requestedMode: normalizeGovernanceMode(args['requested-mode']),
+            lang,
+            benchmarkMaxAgeHours: parsePositiveIntArg(args['benchmark-max-age-hours'], '--benchmark-max-age-hours'),
+        });
+        if (args.json) {
+            console.log(JSON.stringify(report, null, 2));
+            if (report.status === 'blocked')
+                process.exitCode = 1;
+            return;
+        }
+        if (lang === 'zh') {
+            console.log('SCALE AI OS 接入');
+            console.log(`  状态: ${report.status}`);
+            console.log(`  迁移: ${report.migration.status}`);
+            console.log(`  首次运行: ${report.run.status} (${report.run.mode})`);
+            console.log(`  基准: ${report.benchmark.summary.scenarios} 个场景`);
+            console.log(`  Doctor: ${report.doctor.status}`);
+            console.log(`  报告: ${report.artifacts.adoptionReport}`);
+            for (const phase of report.phases)
+                console.log(`  [${phase.status}] ${phase.id}: ${phase.summary}`);
+            for (const action of report.nextActions)
+                console.log(`  下一步: ${action}`);
+            for (const warning of report.warnings)
+                console.log(`  警告: ${warning}`);
+        }
+        else {
+            console.log('SCALE AI OS Adoption');
+            console.log(`  Status: ${report.status}`);
+            console.log(`  Migration: ${report.migration.status}`);
+            console.log(`  First run: ${report.run.status} (${report.run.mode})`);
+            console.log(`  Benchmark: ${report.benchmark.summary.scenarios} scenario(s)`);
+            console.log(`  Doctor: ${report.doctor.status}`);
+            console.log(`  Report: ${report.artifacts.adoptionReport}`);
+            for (const phase of report.phases)
+                console.log(`  [${phase.status}] ${phase.id}: ${phase.summary}`);
+            for (const action of report.nextActions)
+                console.log(`  next: ${action}`);
+            for (const warning of report.warnings)
+                console.log(`  warning: ${warning}`);
+        }
+        if (report.status === 'blocked')
+            process.exitCode = 1;
+    },
+});
+const aiOsStatusCommand = defineCommand({
+    meta: { name: 'status', description: 'Show AI OS closed-loop readiness across runtime, run, verification, dashboard, benchmark, and adoption evidence' },
+    args: {
+        dir: { type: 'string', default: PROJECT_DIR, description: 'Project directory' },
+        lang: { type: 'string', default: 'en', description: 'Output language zh/en' },
+        'benchmark-max-age-hours': { type: 'string', description: 'Maximum accepted benchmark report age in hours' },
+        json: { type: 'boolean', default: false },
+    },
+    run({ args }) {
+        const projectDir = resolve(String(args.dir ?? PROJECT_DIR));
+        const scaleDir = resolveScaleDirForProject(projectDir);
+        const lang = normalizeLangArg(args.lang);
+        const report = createAiOsStatus({
+            projectDir,
+            scaleDir,
+            benchmarkMaxAgeHours: parsePositiveIntArg(args['benchmark-max-age-hours'], '--benchmark-max-age-hours'),
+            lang,
+        });
+        if (args.json) {
+            console.log(JSON.stringify(report, null, 2));
+            if (report.status === 'blocked')
+                process.exitCode = 1;
+            return;
+        }
+        if (lang === 'zh') {
+            console.log('SCALE AI OS 状态');
+            console.log(`  状态: ${report.status}`);
+            console.log(`  检查: ${report.summary.ready} ready, ${report.summary.warning} warning, ${report.summary.blocked} blocked`);
+            console.log(`  Dashboard: ${report.dashboard.health.status} (${report.dashboard.health.score})`);
+            console.log(`  Doctor: ${report.doctor.status}`);
+            for (const check of report.checks)
+                console.log(`  [${check.status}] ${check.id}: ${check.summary}`);
+            if (report.verificationRecommendations.length > 0) {
+                console.log('  验证建议:');
+                for (const recommendation of report.verificationRecommendations) {
+                    console.log(`    - ${recommendation.command} (${recommendation.source})`);
+                }
+            }
+            for (const action of report.nextActions)
+                console.log(`  下一步: ${action}`);
+            for (const warning of report.warnings)
+                console.log(`  警告: ${warning}`);
+        }
+        else {
+            console.log('SCALE AI OS Status');
+            console.log(`  Status: ${report.status}`);
+            console.log(`  Checks: ${report.summary.ready} ready, ${report.summary.warning} warning, ${report.summary.blocked} blocked`);
+            console.log(`  Dashboard: ${report.dashboard.health.status} (${report.dashboard.health.score})`);
+            console.log(`  Doctor: ${report.doctor.status}`);
+            for (const check of report.checks)
+                console.log(`  [${check.status}] ${check.id}: ${check.summary}`);
+            if (report.verificationRecommendations.length > 0) {
+                console.log('  Verification recommendations:');
+                for (const recommendation of report.verificationRecommendations) {
+                    console.log(`    - ${recommendation.command} (${recommendation.source})`);
+                }
+            }
+            for (const action of report.nextActions)
+                console.log(`  next: ${action}`);
+            for (const warning of report.warnings)
+                console.log(`  warning: ${warning}`);
+        }
+        if (report.status === 'blocked')
+            process.exitCode = 1;
+    },
+});
 const aiOs = defineCommand({
     meta: { name: 'ai-os', description: 'AI Engineering OS runtime planning and governance orchestration' },
-    subCommands: { plan: aiOsPlanCommand },
+    subCommands: {
+        adopt: aiOsAdoptCommand,
+        status: aiOsStatusCommand,
+        plan: aiOsPlanCommand,
+        run: aiOsRunCommand,
+        dashboard: aiOsDashboardCommand,
+        benchmark: aiOsBenchmarkCommand,
+        migrate: aiOsMigrateCommand,
+        doctor: aiOsDoctorCommand,
+    },
 });
 // ============================================================================
 // upgrade command - Safe workflow/template/capability update planning
@@ -2967,8 +3300,10 @@ const upgradeCheck = defineCommand({
     },
     run({ args }) {
         const lang = normalizeLangArg(args.lang);
+        const projectDir = resolve(String(args.dir ?? PROJECT_DIR));
         const report = createUpgradeCheckReport({
-            projectDir: args.dir,
+            projectDir,
+            scaleDir: resolveScaleDirForProject(projectDir),
             targetScaleVersion: args['target-version'] ? String(args['target-version']) : undefined,
         });
         if (args.json) {
@@ -2983,6 +3318,7 @@ const upgradeCheck = defineCommand({
             console.log(`  治理包: ${report.governancePack.id ?? '无'} v${report.governancePack.currentVersion ?? '无'} -> v${report.governancePack.latestVersion ?? '无'}`);
             console.log(`  受管生成文件: ${report.generatedFiles.clean} 个干净, ${report.generatedFiles.changed} 个本地改动, ${report.generatedFiles.missing} 个缺失`);
             console.log(`  第三方能力策略: ${report.thirdParty.policy}; 需要人工审查: ${report.thirdParty.reviewRequired}`);
+            console.log(`  AI OS Runtime: ${report.aiOsRuntime.status}`);
             console.log('  下一步:');
         }
         else {
@@ -2993,10 +3329,11 @@ const upgradeCheck = defineCommand({
             console.log(`  Governance pack: ${report.governancePack.id ?? 'none'} v${report.governancePack.currentVersion ?? 'none'} -> v${report.governancePack.latestVersion ?? 'none'}`);
             console.log(`  Generated files: ${report.generatedFiles.clean} clean, ${report.generatedFiles.changed} changed, ${report.generatedFiles.missing} missing`);
             console.log(`  Third-party policy: ${report.thirdParty.policy}; review required: ${report.thirdParty.reviewRequired}`);
+            console.log(`  AI OS Runtime: ${report.aiOsRuntime.status}`);
             console.log('  Next:');
         }
         for (const command of report.recommendedCommands)
-            console.log(`    ${command}`);
+            console.log(`    ${formatUpgradeCommand(command, lang)}`);
     },
 });
 const upgradePlan = defineCommand({
@@ -3010,8 +3347,10 @@ const upgradePlan = defineCommand({
     },
     run({ args }) {
         const lang = normalizeLangArg(args.lang);
+        const projectDir = resolve(String(args.dir ?? PROJECT_DIR));
         const report = createUpgradePlanReport({
-            projectDir: args.dir,
+            projectDir,
+            scaleDir: resolveScaleDirForProject(projectDir),
             targetScaleVersion: args['target-version'] ? String(args['target-version']) : undefined,
         });
         const htmlPath = args.html ? writeUpgradePlanHtml(report, undefined, lang) : undefined;
@@ -3039,7 +3378,7 @@ const upgradePlan = defineCommand({
         console.log(lang === 'zh' ? '  步骤:' : '  Steps:');
         for (const step of report.steps) {
             const path = step.path ? ` ${step.path}` : '';
-            const command = step.command ? ` -> ${step.command}` : '';
+            const command = step.command ? ` -> ${formatUpgradeCommand(step.command, lang)}` : '';
             console.log(`    [${step.risk}] ${step.action}${path}: ${formatUpgradeStepReason(step.action, step.reason, lang)}${command}`);
         }
         if (htmlPath)
@@ -3056,8 +3395,10 @@ const upgradeApply = defineCommand({
     },
     run({ args }) {
         const lang = normalizeLangArg(args.lang);
+        const projectDir = resolve(String(args.dir ?? PROJECT_DIR));
         const result = applyUpgradePlan({
-            projectDir: args.dir,
+            projectDir,
+            scaleDir: resolveScaleDirForProject(projectDir),
             confirm: isTruthyFlag(args.confirm),
         });
         if (args.json) {
@@ -3138,12 +3479,32 @@ function formatUpgradeStepReason(action, fallback, lang) {
             return fallback
                 .replace('updates require manual-review; SCALE never auto-installs third-party capabilities.', '更新需要人工审阅；SCALE 不会自动安装第三方能力。')
                 .replace('updates require blocked; SCALE never auto-installs third-party capabilities.', '更新默认阻断；SCALE 不会自动安装第三方能力。');
+        case 'adopt-ai-os-runtime':
+            return '运行 AI OS 一键接入路径，生成运行态目录、首份 dry-run、benchmark 和 doctor 报告。';
+        case 'migrate-ai-os-runtime':
+            return 'AI OS 运行态目录缺失；接入 beta runtime 前先创建目录结构。';
+        case 'check-ai-os-runtime':
+            return '依赖 AI OS beta 编排前，先复核运行态就绪状态。';
         case 'run-preflight':
             return '完成已接受的升级后，运行项目级预检。';
         default:
             return fallback;
     }
 }
+function formatUpgradeCommand(command, lang) {
+    if (command === 'scale ai-os adopt --dir . --task "Adopt AI OS runtime" --json') {
+        return lang === 'zh'
+            ? 'scale ai-os adopt --dir . --task "接入 AI OS runtime" --lang zh'
+            : 'scale ai-os adopt --dir . --task "Adopt AI OS runtime" --lang en';
+    }
+    if (command === 'scale ai-os doctor --dir . --json') {
+        return lang === 'zh' ? 'scale ai-os doctor --dir . --lang zh' : 'scale ai-os doctor --dir . --lang en';
+    }
+    if (command === 'scale ai-os migrate --dir . --json') {
+        return 'scale ai-os migrate --dir .';
+    }
+    return command;
+}
 function formatUpgradeApplyReason(reason, lang) {
     if (lang !== 'zh')
         return reason;
@@ -5048,6 +5409,14 @@ function parseToolIds(value) {
 function parseCommaList(value) {
     return parseToolIds(value) ?? [];
 }
+function normalizeAiOsRunMode(value, forceDryRun = false) {
+    if (forceDryRun)
+        return 'dry-run';
+    const normalized = String(value ?? 'dry-run').trim().toLowerCase();
+    if (normalized === 'dry-run' || normalized === 'guarded')
+        return normalized;
+    throw new Error(`Invalid AI OS run mode "${String(value)}"; expected dry-run or guarded.`);
+}
 function createToolExecutionPlanFromArgs(args) {
     const projectDir = resolve(String(args.dir ?? PROJECT_DIR));
     const level = normalizeTaskArtifactLevel(args.level ?? 'M');