@hongmaple0820/scale-engine 0.33.0 → 0.39.0

package/dist/api/cli.js

@@ -10,7 +10,7 @@ import { Gateway } from '../guardrails/Gateway.js';
 import { BruteRetryDetector, PrematureDoneDetector, BlameShiftDetector } from '../guardrails/detectors.js';
 import { DangerousCommandDetector, SecretLeakDetector, RoleGateDetector, ScopeCreepDetector, BUILT_IN_ROLES } from '../guardrails/advancedDetectors.js';
 import { auditDependencies } from '../guardrails/DependencyAuditor.js';
-import { SQLiteKnowledgeBase } from '../knowledge/SQLiteKnowledgeBase.js';
+import { GraphifyKnowledgeBase } from '../knowledge/GraphifyKnowledgeBase.js';
 import { ContextBuilder } from '../context/ContextBuilder.js';
 import { ProjectAnatomy } from '../context/ProjectAnatomy.js';
 import { buildContextPack, doctorContextBudget, scanContextBudget, writeContextBudgetReport, } from '../context/ContextBudget.js';
@@ -27,7 +27,12 @@ import { createSkillPlan, evaluateSkillGate, loadSkillRoutingPolicy, skillPlanMa
 import { createAdapter, SUPPORTED_AGENTS } from '../adapters/index.js';
 import { LessonExtractor, RuleProposer, HookGenerator, EvolutionEngine } from '../evolution/EvolutionEngine.js';
 import { Doctor } from './doctor.js';
+import { inspectEnvironment, renderEnvironmentDoctor } from '../env/EnvironmentDoctor.js';
 import { quickStart, detectPlatform, governanceNextSteps } from './quickstart.js';
+import { bootstrapDependencies } from '../bootstrap/DependencyBootstrap.js';
+import { renderDependencyBootstrapReport } from '../bootstrap/DependencyBootstrapRenderer.js';
+import { runSetupWizard } from '../setup/SetupWizard.js';
+import { normalizeLanguage, resolveCliLanguage } from '../i18n/Language.js';
 import { SkillDiscovery } from '../skills/SkillDiscovery.js';
 import { inspectRequiredWorkflowSkills, inspectWorkflowSkills } from '../skills/SkillDoctor.js';
 import { evaluateSkillInstallSafety, listSkillRepositoryEntries, recommendSkillWorkflow, renderSkillRepositoryMarkdown, } from '../skills/SkillRepository.js';
@@ -39,8 +44,12 @@ import { OutOfScopeStore } from '../workflow/OutOfScopeStore.js';
 import { ReviewStore } from '../workflow/ReviewStore.js';
 import { WorkflowEngine } from '../workflow/WorkflowEngine.js';
 import { resolveVerificationTargets, } from '../workflow/VerificationProfile.js';
+import { preflightGateStages } from '../workflow/GateCatalog.js';
+import { gatesCommand } from '../cli/gateStatusCommands.js';
+import { scoreCommand } from '../cli/scoreCommands.js';
+import { promptCommand } from '../cli/promptCommands.js';
 import { writeGovernanceTemplates } from '../workflow/GovernanceTemplates.js';
-import { getProfile as getConfigProfile, generateConfigForProfile, listProfiles as listConfigProfiles } from '../config/profiles.js';
+import { getBootstrapPlanForProfile, getProfile as getConfigProfile, generateConfigForProfile, listProfiles as listConfigProfiles, } from '../config/profiles.js';
 import { computeGovernanceDrift } from '../workflow/GovernanceLock.js';
 import { applyUpgradePlan, createThirdPartyUpdateReport, createUpgradeCheckReport, createUpgradePlanReport, rollbackLatestUpgrade, writeUpgradePlanHtml, } from '../workflow/UpgradeManager.js';
 import { createGovernanceRoiReport } from '../governance/GovernanceRoi.js';
@@ -66,7 +75,7 @@ import { renderGovernanceDashboard } from '../output/GovernanceDashboard.js';
 import { cleanupWorkspaceLifecycle, inspectWorkspaceLifecycle, } from '../workflow/WorkspaceLifecycle.js';
 import { inspectWorkspaceSafety } from '../workflow/WorkspaceSafety.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 { MemoryFabric, MemoryBrain, doctorMemoryFabric, renderContextPackMarkdown, renderMemoryLearningCandidateMarkdown, inspectMemoryProviders, recallMemoryProviders, settleMemoryLearning, useMemoryProvider, writeMemoryProvidersConfig, } from '../memory/index.js';
 import { resolveWorkspaceTopology, workspaceTopologyPath, workspaceTopologyTemplate, } from '../workflow/WorkspaceTopology.js';
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
 import { dirname, isAbsolute, join, resolve } from 'node:path';
@@ -125,9 +134,7 @@ function normalizePreflightProfile(value) {
     return 'quick';
 }
 function gatesForPreflightProfile(profile) {
-    if (profile === 'quick')
-        return ['G3', 'G0', 'G4', 'G5'];
-    return ['G3', 'G0', 'G4', 'G5', 'G6', 'G7'];
+    return preflightGateStages(profile);
 }
 function shouldSkipPreflightCommandTargets(resolved, args) {
     if (!resolved.matrix)
@@ -166,11 +173,13 @@ function evaluateEngineeringStandardsGate(options) {
             scaleDir: options.scaleDir ?? SCALE_DIR,
             taskId: options.taskId,
             artifactsDir: options.artifactsDir,
+            changedFiles: options.changedFiles,
         })
         : undefined;
     const doctor = settlement?.doctor ?? doctorEngineeringStandards({
         projectDir: options.projectDir ?? PROJECT_DIR,
         scaleDir: options.scaleDir ?? SCALE_DIR,
+        changedFiles: options.changedFiles,
     });
     return {
         mode,
@@ -180,6 +189,7 @@ function evaluateEngineeringStandardsGate(options) {
         findings: doctor.findings,
         summary: doctor.scan.summary,
         standardsImpactPath: settlement?.standardsImpactPath,
+        changedFiles: options.changedFiles,
     };
 }
 function skippedEngineeringStandardsGate(reason, policy) {
@@ -220,7 +230,7 @@ function createEngine() {
     gateway.registerDetector(new ScopeCreepDetector(), 'preTool');
     gateway.registerDetector(new PrematureDoneDetector(), 'beforeStop');
     gateway.registerDetector(new BlameShiftDetector(), 'postTool');
-    const kb = new SQLiteKnowledgeBase(eventBus, { dbPath: join(SCALE_DIR, 'knowledge.db') });
+    const kb = new GraphifyKnowledgeBase(eventBus, { projectDir: PROJECT_DIR, scaleDir: SCALE_DIR });
     const ctx = new ContextBuilder(store, kb, eventBus);
     const fsmAgentBridge = new FSMAgentBridge(fsm, store);
     const capabilityRegistry = new CapabilityRegistry(eventBus);
@@ -1197,8 +1207,18 @@ const codegraphStatus = defineCommand({
         }
         console.log('SCALE Code Intelligence Status');
         console.log(`  Config: ${report.configPath} (${report.configExists ? 'found' : 'default'})`);
+        console.log(`  Project index: ${report.projectIndexExists ? report.projectIndexPath : `${report.projectIndexPath} (not initialized)`}`);
         for (const provider of report.providers) {
             console.log(`  [${provider.available ? 'AVAILABLE' : 'UNAVAILABLE'}] ${provider.id} (${provider.type}): ${provider.reason}`);
+            if (provider.source)
+                console.log(`    source: ${provider.source}`);
+            if (!provider.available && provider.installHint)
+                console.log(`    install: ${provider.installHint}`);
+            if (provider.available && provider.projectInitHint && provider.id === 'codegraph' && !report.projectIndexExists) {
+                console.log(`    init: ${provider.projectInitHint}`);
+            }
+            if (provider.serveCommand)
+                console.log(`    mcp: ${provider.serveCommand}`);
         }
         console.log(`  Fallback: ${report.fallback.available ? 'available' : 'disabled'} (${report.fallback.tools.join(', ')})`);
         for (const recommendation of report.recommendations)
@@ -2304,12 +2324,14 @@ const preflight = defineCommand({
             resolved.warnings.push('No verification services or profile commands configured; command gates skipped for this governance-only project.');
         }
         const workspaceSafety = inspectWorkspaceSafety(projectDir);
+        const engineeringStandardsChangedFiles = readGitChangedFilesForStandards(projectDir);
         const engineeringStandards = workspaceSafety.blocked
             ? skippedEngineeringStandardsGate('Workspace has unresolved git conflicts; resolve them before standards scanning.', resolved.policy)
             : evaluateEngineeringStandardsGate({
                 policy: resolved.policy,
                 projectDir,
                 scaleDir,
+                changedFiles: engineeringStandardsChangedFiles,
             });
         const targetResults = [];
         if (!args.json) {
@@ -2325,6 +2347,9 @@ const preflight = defineCommand({
             if (engineeringStandards.checked) {
                 const status = engineeringStandards.blocked ? 'BLOCKED' : engineeringStandards.ok ? 'OK' : 'WARN';
                 console.log(`  Engineering standards: ${status} (${engineeringStandards.mode})`);
+                if (engineeringStandards.changedFiles) {
+                    console.log(`  Engineering standards scope: changed files (${engineeringStandards.changedFiles.length})`);
+                }
             }
             else {
                 console.log('  Engineering standards: skipped');
@@ -2528,7 +2553,7 @@ const status = defineCommand({
 // init command
 // ============================================================================
 const init = defineCommand({
-    meta: { name: 'init', description: 'Initialize SCALE Engine in current project (one-click install)' },
+    meta: { name: 'init', description: 'Initialize SCALE Engine governance in current project (one-click bootstrap, not third-party auto-install)' },
     args: {
         agent: { type: 'string', default: '', description: `Agent type (${SUPPORTED_AGENTS.join('/')}) - auto-detected if not specified` },
         dir: { type: 'string', default: '.', description: 'Project directory' },
@@ -2626,16 +2651,22 @@ const init = defineCommand({
             console.log(`   Scenario:      ${scenarioMode}`);
             console.log(`   Profile:       ${profileId}`);
             console.log(`\n📋 Next steps:`);
-            for (const step of governanceNextSteps())
+            for (const step of governanceNextSteps({
+                profileId,
+                governancePack: String(args['governance-pack']),
+            }))
                 console.log(`   → ${step}`);
             return;
         }
         // One-click quick start mode
         if (!args.agent) {
-            const qsResult = await quickStart(args.dir, { governancePack: args['governance-pack'] });
+            const profileId = args.profile || profileFromScenario(args.scenario);
+            const qsResult = await quickStart(args.dir, {
+                governancePack: args['governance-pack'],
+                profileId,
+            });
             // Generate config.yaml from profile
             if (qsResult.success) {
-                const profileId = args.profile || profileFromScenario(args.scenario);
                 const projectName = args.dir.split(/[/\\]/).pop() || 'Project';
                 const detectedAgent = qsResult.platform ? [qsResult.platform] : [];
                 const configPath = writeConfigYaml(args.dir, profileId, projectName, detectedAgent);
@@ -2650,8 +2681,10 @@ const init = defineCommand({
                     created: qsResult.created,
                     skipped: qsResult.skipped,
                     constraintsApplied: qsResult.constraintsApplied,
+                    workflowCapabilities: qsResult.workflowCapabilities,
                     capabilitiesEnabled: qsResult.capabilitiesEnabled,
                     knowledgeGraph: qsResult.knowledgeGraph,
+                    dependencyBootstrapCommand: qsResult.dependencyBootstrapCommand,
                     nextSteps: qsResult.nextSteps,
                     suggestions: detection?.suggestions ?? [],
                 }, null, 2));
@@ -2671,7 +2704,8 @@ const init = defineCommand({
                         console.log(`   - ${f}`);
                 }
                 console.log(`\n🔒 Physical constraints applied: ${qsResult.constraintsApplied}`);
-                console.log(`\n🚀 Capabilities enabled: ${qsResult.capabilitiesEnabled.join(', ')}`);
+                console.log(`\n🧭 Workflow capability plan: ${qsResult.workflowCapabilities.join(', ')}`);
+                console.log(`\n🧰 Dependency bootstrap: ${qsResult.dependencyBootstrapCommand}`);
                 console.log(`\n📋 Next steps:`);
                 for (const step of qsResult.nextSteps)
                     console.log(`   → ${step}`);
@@ -2713,7 +2747,10 @@ const init = defineCommand({
                 scaleDir: result.scaleDir,
                 created: result.created,
                 skipped: result.skipped,
-                nextSteps: governanceNextSteps(),
+                nextSteps: governanceNextSteps({
+                    profileId,
+                    governancePack: String(args['governance-pack']),
+                }),
             }, null, 2));
             return;
         }
@@ -2731,17 +2768,130 @@ const init = defineCommand({
         console.log(`\n📄 Config:    ${configPath}`);
         console.log(`\n📂 Data dir:  ${result.scaleDir}`);
         console.log(`\n📋 Next steps:`);
-        for (const step of governanceNextSteps())
+        for (const step of governanceNextSteps({
+            profileId,
+            governancePack: String(args['governance-pack']),
+        }))
             console.log(`   → ${step}`);
     },
 });
+const bootstrapDepsCommand = defineCommand({
+    meta: { name: 'deps', description: 'Plan or install third-party skills, CLI dependencies, and project post-configuration' },
+    args: {
+        dir: { type: 'string', default: PROJECT_DIR, description: 'Project directory' },
+        pack: { type: 'string', default: '', description: 'Comma-separated packs: ui,memory,knowledge,external-cli,full. Defaults to full unless --profile is supplied.' },
+        profile: { type: 'string', description: 'Resolve recommended packs from profile: minimal, standard, advanced' },
+        'governance-pack': { type: 'string', description: 'Optional governance pack hint, for example frontend-app -> ui' },
+        include: { type: 'string', description: 'Additional dependency ids to include explicitly' },
+        apply: { type: 'boolean', default: false, description: 'Run install commands for ready dependencies' },
+        lang: { type: 'string', description: 'Output language zh/en. Defaults to zh, then SCALE_LANG, then .scale/config.yaml locale.' },
+        json: { type: 'boolean', default: false, description: 'Output bootstrap plan as JSON' },
+    },
+    async run({ args }) {
+        const projectDir = resolve(String(args.dir ?? PROJECT_DIR));
+        const lang = resolveCliLanguage({ lang: args.lang, projectDir, scaleDir: SCALE_DIR });
+        const explicitPacks = parseCommaList(args.pack);
+        const recommendedPacks = args.profile
+            ? getBootstrapPlanForProfile(String(args.profile), args['governance-pack'] ? String(args['governance-pack']) : undefined).packs
+            : [];
+        const report = await bootstrapDependencies({
+            projectDir,
+            scaleDir: SCALE_DIR,
+            packIds: explicitPacks.length > 0 ? uniqueStrings([...recommendedPacks, ...explicitPacks]) : recommendedPacks,
+            includeIds: parseCommaList(args.include),
+            apply: isTruthyFlag(args.apply),
+        });
+        if (args.json) {
+            console.log(JSON.stringify(report, null, 2));
+            if (isTruthyFlag(args.apply) && !report.ok)
+                process.exitCode = 1;
+            return;
+        }
+        console.log(renderDependencyBootstrapReport(report, lang));
+        if (report.apply && !report.ok)
+            process.exitCode = 1;
+    },
+});
+const bootstrap = defineCommand({
+    meta: { name: 'bootstrap', description: 'Bootstrap third-party workflow dependencies with explicit install intent' },
+    subCommands: { deps: bootstrapDepsCommand },
+});
 // ============================================================================
+const setup = defineCommand({
+    meta: { name: 'setup', description: 'Interactive SCALE setup for third-party skills, CLIs, memory, and knowledge providers' },
+    args: {
+        dir: { type: 'string', default: PROJECT_DIR, description: 'Project directory' },
+        pack: { type: 'string', default: '', description: 'Comma-separated packs: ui,memory,knowledge,external-cli,full. Defaults to full unless --profile is supplied.' },
+        profile: { type: 'string', description: 'Resolve recommended packs from profile: minimal, standard, advanced' },
+        'governance-pack': { type: 'string', description: 'Optional governance pack hint, for example frontend-app -> ui' },
+        include: { type: 'string', description: 'Additional dependency ids to include explicitly' },
+        apply: { type: 'boolean', default: false, description: 'Run install commands for ready dependencies' },
+        yes: { type: 'boolean', default: false, description: 'Confirm installation without prompting' },
+        interactive: { type: 'boolean', default: true, description: 'Prompt before installation when dependencies are ready' },
+        lang: { type: 'string', description: 'Output language zh/en. Defaults to zh, then SCALE_LANG, then .scale/config.yaml locale.' },
+        'memory-provider': { type: 'string', description: 'Switch memory provider during setup: gbrain, agentmemory, or scale-local' },
+        'memory-mode': { type: 'string', description: 'Memory routing mode: auto, local-only, external-first' },
+        'memory-endpoint': { type: 'string', description: 'Optional endpoint to persist for the selected memory provider' },
+        'memory-write-mode': { type: 'string', description: 'Memory write mode: disabled, candidate-only, enabled' },
+        'allow-external-write': { type: 'boolean', default: false, description: 'Explicitly allow external memory writes in provider routing' },
+        json: { type: 'boolean', default: false, description: 'Output setup report as JSON' },
+    },
+    async run({ args }) {
+        const projectDir = resolve(String(args.dir ?? PROJECT_DIR));
+        const lang = resolveCliLanguage({ lang: args.lang, projectDir, scaleDir: SCALE_DIR });
+        const explicitPacks = parseCommaList(args.pack);
+        const recommendedPacks = args.profile
+            ? getBootstrapPlanForProfile(String(args.profile), args['governance-pack'] ? String(args['governance-pack']) : undefined).packs
+            : [];
+        const report = await runSetupWizard({
+            projectDir,
+            scaleDir: SCALE_DIR,
+            packIds: explicitPacks.length > 0 ? uniqueStrings([...recommendedPacks, ...explicitPacks]) : recommendedPacks,
+            includeIds: parseCommaList(args.include),
+            apply: isTruthyFlag(args.apply),
+            yes: isTruthyFlag(args.yes),
+            interactive: isTruthyFlag(args.interactive) && !isTruthyFlag(args.json),
+            lang,
+            memoryProvider: args['memory-provider'] ? String(args['memory-provider']) : undefined,
+            memoryMode: normalizeMemoryModeArg(args['memory-mode']),
+            memoryEndpoint: args['memory-endpoint'] ? String(args['memory-endpoint']) : undefined,
+            memoryWriteMode: normalizeMemoryWriteModeArg(args['memory-write-mode']),
+            allowExternalWrite: isTruthyFlag(args['allow-external-write']) ? true : undefined,
+            promptLanguage: isTruthyFlag(args.interactive) && !args.lang,
+        });
+        if (args.json) {
+            console.log(JSON.stringify(report, null, 2));
+            if (!report.ok)
+                process.exitCode = 1;
+            return;
+        }
+        console.log(lang === 'zh' ? '\nSCALE 交互式安装' : '\nSCALE Interactive Setup');
+        console.log(lang === 'zh'
+            ? `  已执行安装: ${report.applied ? '是' : '否'}`
+            : `  Applied: ${report.applied}`);
+        if (report.memoryProviderSwitch) {
+            const switched = report.memoryProviderSwitch;
+            console.log(lang === 'zh' ? '  记忆供应商:' : '  Memory provider:');
+            console.log(`    provider=${switched.provider}; mode=${switched.mode}; config=${switched.path}`);
+            console.log(`    order=${switched.previousOrder.join(' -> ')} => ${switched.nextOrder.join(' -> ')}`);
+            if (switched.providerStatus) {
+                console.log(`    status=${switched.providerStatus.available ? 'available' : 'not-ready'}; reason=${switched.providerStatus.reason}`);
+            }
+            for (const warning of switched.warnings)
+                console.log(lang === 'zh' ? `    [警告] ${warning}` : `    [WARN] ${warning}`);
+        }
+        console.log(renderDependencyBootstrapReport(report.final, lang));
+        if (!report.ok)
+            process.exitCode = 1;
+    },
+});
 // config command — Configuration profile management
 // ============================================================================
 const configProfile = defineCommand({
     meta: { name: 'profile', description: 'View or switch configuration profile' },
     args: {
         set: { type: 'string', default: '', description: 'Switch to profile (minimal/standard/advanced)' },
+        'governance-pack': { type: 'string', description: 'Optional governance pack hint for bootstrap suggestions, for example frontend-app' },
         list: { type: 'boolean', default: false, description: 'List all available profiles' },
         json: { type: 'boolean', default: false, description: 'Output as JSON' },
     },
@@ -2765,12 +2915,27 @@ const configProfile = defineCommand({
                 console.log(`\n⚠️  Profile "${args.set}" not found. Available: minimal, standard, advanced`);
                 return;
             }
+            const bootstrapPlan = getBootstrapPlanForProfile(profile.id, args['governance-pack'] ? String(args['governance-pack']) : undefined);
             // Update config.yaml
             const configPath = join('.scale', 'config.yaml');
             const projectName = process.cwd().split(/[/\\]/).pop() || 'Project';
             const content = generateConfigForProfile(args.set, { name: projectName });
             ensureDir('.scale');
             writeFileSync(configPath, content, 'utf-8');
+            if (args.json) {
+                console.log(JSON.stringify({
+                    ok: true,
+                    profile: profile.id,
+                    name: profile.name,
+                    description: profile.description,
+                    sections: profile.sections,
+                    bootstrapPacks: bootstrapPlan.packs,
+                    dependencyBootstrapCommand: bootstrapPlan.inspectCommand,
+                    dependencyBootstrapApplyCommand: bootstrapPlan.applyCommand,
+                    configPath,
+                }, null, 2));
+                return;
+            }
             console.log(`\n✅ Profile switched to: ${profile.name}`);
             console.log(`   ${profile.description}`);
             console.log(`\n📄 Config updated: ${configPath}`);
@@ -2786,13 +2951,24 @@ const configProfile = defineCommand({
         const match = content.match(/^profile:\s*(.+)$/m);
         const currentProfile = match?.[1]?.trim() || 'standard';
         const profile = getConfigProfile(currentProfile);
+        const bootstrapPlan = getBootstrapPlanForProfile(profile.id, args['governance-pack'] ? String(args['governance-pack']) : undefined);
         if (args.json) {
-            console.log(JSON.stringify({ profile: profile.id, name: profile.name, description: profile.description, sections: profile.sections }, null, 2));
+            console.log(JSON.stringify({
+                profile: profile.id,
+                name: profile.name,
+                description: profile.description,
+                sections: profile.sections,
+                bootstrapPacks: bootstrapPlan.packs,
+                dependencyBootstrapCommand: bootstrapPlan.inspectCommand,
+                dependencyBootstrapApplyCommand: bootstrapPlan.applyCommand,
+            }, null, 2));
             return;
         }
         console.log(`\nCurrent profile: ${profile.name} (${profile.id})`);
         console.log(`  ${profile.description}`);
         console.log(`\nSections: ${profile.sections.join(', ')}`);
+        console.log(`Bootstrap packs: ${bootstrapPlan.packs.join(', ')}`);
+        console.log(`Dependency bootstrap: ${bootstrapPlan.inspectCommand}`);
         console.log(`\nUse: scale config profile --set <id> to switch`);
     },
 });
@@ -3654,9 +3830,24 @@ function readGitChangedFiles(projectDir) {
     const untracked = readGitPathList(projectDir, ['ls-files', '--others', '--exclude-standard']);
     return Array.from(new Set([...tracked, ...untracked]));
 }
+function readGitChangedFilesForStandards(projectDir) {
+    try {
+        execFileSync('git', ['-C', projectDir, 'rev-parse', '--is-inside-work-tree'], {
+            encoding: 'utf-8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+        });
+    }
+    catch {
+        return undefined;
+    }
+    return readGitChangedFiles(projectDir);
+}
 function readGitPathList(projectDir, args) {
     try {
-        return execFileSync('git', ['-C', projectDir, ...args], { encoding: 'utf-8' })
+        return execFileSync('git', ['-C', projectDir, ...args], {
+            encoding: 'utf-8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+        })
             .split(/\r?\n/)
             .map(item => item.trim())
             .filter(Boolean);
@@ -3987,8 +4178,19 @@ function normalizeThemeArg(value) {
     return 'auto';
 }
 function normalizeLangArg(value) {
-    const raw = String(value ?? process.env.SCALE_LANG ?? 'zh').trim().toLowerCase();
-    return raw === 'en' || raw.startsWith('en-') || raw === 'english' ? 'en' : 'zh';
+    return normalizeLanguage(value ?? process.env.SCALE_LANG);
+}
+function normalizeMemoryModeArg(value) {
+    const normalized = String(value ?? '').trim().toLowerCase();
+    if (normalized === 'auto' || normalized === 'local-only' || normalized === 'external-first')
+        return normalized;
+    return undefined;
+}
+function normalizeMemoryWriteModeArg(value) {
+    const normalized = String(value ?? '').trim().toLowerCase();
+    if (normalized === 'disabled' || normalized === 'candidate-only' || normalized === 'enabled')
+        return normalized;
+    return undefined;
 }
 function launchLocalFile(path) {
     try {
@@ -4025,13 +4227,34 @@ const evolve = defineCommand({
 // ============================================================================
 // doctor command
 // ============================================================================
+function runEnvironmentDoctor(json) {
+    const report = inspectEnvironment();
+    if (json) {
+        console.log(JSON.stringify(report, null, 2));
+    }
+    else {
+        console.log(renderEnvironmentDoctor(report));
+    }
+    process.exitCode = report.ok ? 0 : 1;
+}
 const doctor = defineCommand({
     meta: { name: 'doctor', description: 'Diagnose SCALE Engine health' },
     args: {
+        scope: { type: 'positional', required: false, description: 'Optional diagnostic scope: env' },
         dir: { type: 'string', default: '.', description: 'Project directory' },
         json: { type: 'boolean', default: false, description: 'Output as JSON' },
     },
     async run({ args }) {
+        const scope = String(args.scope ?? '').trim().toLowerCase();
+        if (scope === 'env' || scope === 'environment') {
+            runEnvironmentDoctor(args.json);
+            return;
+        }
+        if (scope) {
+            console.error(`Unknown doctor scope: ${scope}. Supported scope: env.`);
+            process.exitCode = 1;
+            return;
+        }
         const doc = new Doctor(args.dir);
         const report = await doc.diagnose();
         if (args.json) {
@@ -4924,12 +5147,57 @@ const memoryProviderRecall = defineCommand({
             console.log(`  [WARN] ${warning}`);
     },
 });
+const memoryProviderUse = defineCommand({
+    meta: { name: 'use', description: 'Promote one memory provider to the front of routing and persist the selection' },
+    args: {
+        provider: { type: 'positional', required: true, description: 'Provider id: gbrain, agentmemory, or scale-local' },
+        mode: { type: 'string', description: 'Optional routing mode override: auto, local-only, external-first' },
+        endpoint: { type: 'string', description: 'Optional provider endpoint to persist while switching' },
+        'write-mode': { type: 'string', description: 'Optional provider write mode: disabled, candidate-only, enabled' },
+        'allow-external-write': { type: 'boolean', default: false, description: 'Persist external write allowance when explicitly switching' },
+        json: { type: 'boolean', default: false },
+    },
+    run({ args }) {
+        const mode = args.mode ? String(args.mode) : undefined;
+        const writeMode = args['write-mode']
+            ? String(args['write-mode'])
+            : undefined;
+        const report = useMemoryProvider({
+            projectDir: PROJECT_DIR,
+            scaleDir: SCALE_DIR,
+            provider: String(args.provider),
+            mode: mode,
+            endpoint: args.endpoint ? String(args.endpoint) : undefined,
+            writeMode,
+            allowExternalWrite: isTruthyFlag(args['allow-external-write']) ? true : undefined,
+        });
+        if (args.json) {
+            console.log(JSON.stringify(report, null, 2));
+            if (!report.ok)
+                process.exitCode = 1;
+            return;
+        }
+        console.log('\nSCALE Memory Provider Switch');
+        console.log(`  Provider: ${report.provider}`);
+        console.log(`  Mode: ${report.mode}`);
+        console.log(`  Config: ${report.path}`);
+        console.log(`  Order: ${report.previousOrder.join(' -> ')} -> ${report.nextOrder.join(' -> ')}`);
+        if (report.providerStatus) {
+            console.log(`  Status: ${report.providerStatus.available ? 'available' : 'not-ready'} (${report.providerStatus.reason})`);
+        }
+        for (const warning of report.warnings)
+            console.log(`  [WARN] ${warning}`);
+        if (!report.ok)
+            process.exitCode = 1;
+    },
+});
 const memoryProvider = defineCommand({
     meta: { name: 'provider', description: 'Manage autonomous memory provider routing for agentmemory, gbrain, and scale-local' },
     subCommands: {
         init: memoryProviderInit,
         status: memoryProviderStatus,
         recall: memoryProviderRecall,
+        use: memoryProviderUse,
     },
 });
 const memory = defineCommand({
@@ -5524,6 +5792,8 @@ const toolDoctorCommand = defineCommand({
                     console.log(`    version: ${entry.version}`);
                 if (entry.missingReason)
                     console.log(`    reason: ${entry.missingReason}`);
+                if (!entry.installed && entry.installHint)
+                    console.log(`    install: ${entry.installHint}`);
             }
         }
         if (!report.ok)
@@ -5848,9 +6118,12 @@ const main = defineCommand({
         run: runCommand,
         // Original commands (preserved)
         init,
+        setup,
+        bootstrap,
         doctor,
         session,
         gate,
+        gates: gatesCommand,
         'meta-governance': metaGovernance,
         create,
         list,
@@ -5865,6 +6138,8 @@ const main = defineCommand({
         preflight,
         upgrade,
         governance,
+        prompt: promptCommand,
+        score: scoreCommand,
         'ai-os': aiOs,
         codegraph,
         eval: evalCommand,