@hongmaple0820/scale-engine 0.33.0 → 0.38.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';
@@ -28,6 +28,7 @@ import { createAdapter, SUPPORTED_AGENTS } from '../adapters/index.js';
 import { LessonExtractor, RuleProposer, HookGenerator, EvolutionEngine } from '../evolution/EvolutionEngine.js';
 import { Doctor } from './doctor.js';
 import { quickStart, detectPlatform, governanceNextSteps } from './quickstart.js';
+import { bootstrapDependencies } from '../bootstrap/DependencyBootstrap.js';
 import { SkillDiscovery } from '../skills/SkillDiscovery.js';
 import { inspectRequiredWorkflowSkills, inspectWorkflowSkills } from '../skills/SkillDoctor.js';
 import { evaluateSkillInstallSafety, listSkillRepositoryEntries, recommendSkillWorkflow, renderSkillRepositoryMarkdown, } from '../skills/SkillRepository.js';
@@ -40,7 +41,7 @@ import { ReviewStore } from '../workflow/ReviewStore.js';
 import { WorkflowEngine } from '../workflow/WorkflowEngine.js';
 import { resolveVerificationTargets, } from '../workflow/VerificationProfile.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 +67,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';
@@ -220,7 +221,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 +1198,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)
@@ -2528,7 +2539,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 +2637,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 +2667,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 +2690,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 +2733,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,10 +2754,85 @@ 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' },
+        json: { type: 'boolean', default: false, description: 'Output bootstrap plan as JSON' },
+    },
+    async run({ args }) {
+        const projectDir = resolve(String(args.dir ?? PROJECT_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('\nSCALE Dependency Bootstrap');
+        console.log(`  Project: ${report.projectDir}`);
+        console.log(`  Packs: ${report.packIds.join(', ')}`);
+        console.log(`  Apply: ${report.apply}`);
+        console.log(`  Complete: ${report.complete}`);
+        for (const item of report.items) {
+            console.log(`  [${item.status.toUpperCase()}] ${item.id} (${item.kind})`);
+            console.log(`    source: ${item.source}`);
+            console.log(`    detected: ${item.detectedBy}`);
+            if (!item.installed && item.installCommand)
+                console.log(`    install: ${item.installCommand}`);
+            if (!item.installed && item.manualReason)
+                console.log(`    reason: ${item.manualReason}`);
+            if (!item.installed && item.prerequisites.length > 0) {
+                console.log(`    prereqs: ${item.prerequisites.map(req => `${req.command}=${req.present ? 'ok' : 'missing'}`).join(', ')}`);
+            }
+            if (item.error)
+                console.log(`    error: ${item.error}`);
+        }
+        for (const action of report.postActions)
+            console.log(`  [POST] ${action}`);
+        if (report.postChecks.length > 0) {
+            console.log(`  Post-checks: passed=${report.postCheckSummary.passed}, warned=${report.postCheckSummary.warned}, failed=${report.postCheckSummary.failed}`);
+            for (const check of report.postChecks) {
+                console.log(`  [POSTCHECK ${check.status.toUpperCase()}] ${check.label}: ${check.summary}`);
+                console.log(`    command: ${check.command}`);
+            }
+        }
+        for (const command of report.postCheckCommands)
+            console.log(`  [CHECK] ${command}`);
+        for (const hint of report.rollbackHints)
+            console.log(`  [ROLLBACK] ${hint}`);
+        for (const recommendation of report.recommendations)
+            console.log(`  [NEXT] ${recommendation}`);
+        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 },
+});
 // ============================================================================
 // config command — Configuration profile management
 // ============================================================================
@@ -2742,6 +2840,7 @@ 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 +2864,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 +2900,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`);
     },
 });
@@ -4924,12 +5049,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 +5694,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,6 +6020,7 @@ const main = defineCommand({
         run: runCommand,
         // Original commands (preserved)
         init,
+        bootstrap,
         doctor,
         session,
         gate,