@hongmaple0820/scale-engine 0.21.1 → 0.23.0

package/dist/api/cli.js

@@ -11,7 +11,9 @@ import { BruteRetryDetector, PrematureDoneDetector, BlameShiftDetector } from '.
 import { DangerousCommandDetector, SecretLeakDetector, RoleGateDetector, ScopeCreepDetector, BUILT_IN_ROLES } from '../guardrails/advancedDetectors.js';
 import { SQLiteKnowledgeBase } from '../knowledge/SQLiteKnowledgeBase.js';
 import { ContextBuilder } from '../context/ContextBuilder.js';
+import { ProjectAnatomy } from '../context/ProjectAnatomy.js';
 import { buildContextPack, doctorContextBudget, scanContextBudget, writeContextBudgetReport, } from '../context/ContextBudget.js';
+import { CerebrumManager } from '../knowledge/CerebrumManager.js';
 import { buildCodeGraphContext, createCodeGraphRoiReport, impactCodeGraph, inspectCodeIntelligence, queryCodeGraph, writeCodeIntelligenceConfig, } from '../codegraph/CodeIntelligence.js';
 import { WorkflowEvalStore, compareWorkflowEvalRuns, renderWorkflowEvalReport, runWorkflowEvalSuite, } from '../eval/WorkflowEval.js';
 import { FSMAgentBridge } from '../fsm/FSMAgentBridge.js';
@@ -36,6 +38,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 { computeGovernanceDrift } from '../workflow/GovernanceLock.js';
 import { applyUpgradePlan, createThirdPartyUpdateReport, createUpgradeCheckReport, createUpgradePlanReport, rollbackLatestUpgrade, writeUpgradePlanHtml, } from '../workflow/UpgradeManager.js';
 import { createGovernanceRoiReport } from '../governance/GovernanceRoi.js';
@@ -79,6 +82,19 @@ function governanceModeFromScenario(scenario) {
         return 'minimal';
     return 'standard';
 }
+function profileFromScenario(scenario) {
+    if (scenario === 'sandbox')
+        return 'minimal';
+    if (scenario === 'critical')
+        return 'advanced';
+    return 'standard';
+}
+function writeConfigYaml(projectDir, profileId, projectName, agents) {
+    const configPath = join(projectDir, '.scale', 'config.yaml');
+    const content = generateConfigForProfile(profileId, { name: projectName, agents });
+    writeFileSync(configPath, content, 'utf-8');
+    return configPath;
+}
 function ensureDir(dir) {
     if (!existsSync(dir))
         mkdirSync(dir, { recursive: true });
@@ -346,6 +362,60 @@ const gate = defineCommand({
     subCommands: { 'pre-tool': gatePreTool, 'post-tool': gatePostTool, 'before-stop': gateBeforeStop },
 });
 // ============================================================================
+// meta-governance — 元治理门禁 (G9-G15)
+// ============================================================================
+const metaGovernance = defineCommand({
+    meta: { name: 'meta-governance', description: 'Run meta-governance gates (G9-G15) — check if governance capabilities are actually used' },
+    args: {
+        'scale-dir': { type: 'string', default: '.scale' },
+        json: { type: 'boolean', default: false, description: 'Output as JSON' },
+    },
+    async run({ args }) {
+        const { eventBus } = getEngine();
+        const { GateSystem } = await import('../workflow/gates/GateSystem.js');
+        const gateSystem = new GateSystem(eventBus);
+        const results = await gateSystem.executeMetaGovernance(args['scale-dir']);
+        if (args.json) {
+            console.log(JSON.stringify(results, null, 2));
+            return;
+        }
+        const stageNames = {
+            G9: 'Knowledge Utilization',
+            G10: 'Evolution Effectiveness',
+            G11: 'Guardrail Effectiveness',
+            G12: 'Workflow Thoroughness',
+            G13: 'Multi-Agent Coordination',
+            G14: 'Skill Utilization',
+            G15: 'Self-Improvement',
+        };
+        let allPassed = true;
+        for (const result of results) {
+            const icon = result.passed ? '✅' : '❌';
+            const name = stageNames[result.gate] ?? result.gate;
+            console.log(`${icon} ${result.gate} ${name}`);
+            if (result.evidence) {
+                for (const line of result.evidence.split('\n')) {
+                    console.log(`   ${line}`);
+                }
+            }
+            if (!result.passed) {
+                allPassed = false;
+                for (const blocker of result.blockers) {
+                    console.log(`   ⛔ ${blocker}`);
+                }
+            }
+            console.log();
+        }
+        if (!allPassed) {
+            console.log('❌ Meta-governance check FAILED — some capabilities are not being effectively used');
+            process.exit(1);
+        }
+        else {
+            console.log('✅ All meta-governance gates passed');
+        }
+    },
+});
+// ============================================================================
 // artifact CRUD
 // ============================================================================
 const create = defineCommand({
@@ -1013,6 +1083,9 @@ const contextDoctor = defineCommand({
         dir: { type: 'string', default: PROJECT_DIR, description: 'Project directory' },
         'max-always': { type: 'string', description: 'Maximum Always-loaded estimated tokens' },
         'max-task': { type: 'string', description: 'Maximum task context estimated tokens' },
+        task: { type: 'string', description: 'Task text for a representative lazy context pack probe' },
+        level: { type: 'string', default: 'M', description: 'Task level for the context pack probe' },
+        files: { type: 'string', description: 'Comma-separated scoped files for the context pack probe' },
         json: { type: 'boolean', default: false },
     },
     run({ args }) {
@@ -1023,6 +1096,9 @@ const contextDoctor = defineCommand({
             scaleDir,
             maxAlwaysTokens: parsePositiveIntArg(args['max-always'], '--max-always'),
             maxTaskTokens: parsePositiveIntArg(args['max-task'], '--max-task'),
+            task: args.task ? String(args.task) : undefined,
+            level: String(args.level ?? 'M'),
+            files: parseCommaList(args.files),
         });
         if (args.json) {
             console.log(JSON.stringify(report, null, 2));
@@ -1038,9 +1114,55 @@ const contextDoctor = defineCommand({
             process.exitCode = 1;
     },
 });
+const contextAnatomy = defineCommand({
+    meta: { name: 'anatomy', description: 'Scan the project and generate .scale/anatomy.md for file-map context' },
+    args: {
+        dir: { type: 'string', default: PROJECT_DIR, description: 'Project directory' },
+        'max-files': { type: 'string', description: 'Maximum files to include; defaults to 500' },
+        exclude: { type: 'string', description: 'Comma-separated directory names to exclude' },
+        write: { type: 'boolean', default: false, description: 'Write .scale/anatomy.md' },
+        json: { type: 'boolean', default: false },
+    },
+    run({ args }) {
+        const projectDir = resolve(String(args.dir ?? PROJECT_DIR));
+        const scaleDir = resolveScaleDirForProject(projectDir);
+        const maxFiles = parsePositiveIntArg(args['max-files'], '--max-files');
+        const excludePatterns = parseCommaList(args.exclude);
+        const anatomy = new ProjectAnatomy();
+        const sections = anatomy.scan(projectDir, {
+            maxFiles,
+            excludePatterns: excludePatterns.length > 0 ? excludePatterns : undefined,
+        });
+        const content = anatomy.serialize(sections);
+        const summary = [...sections.values()].reduce((acc, entries) => {
+            acc.files += entries.length;
+            acc.tokens += entries.reduce((sum, entry) => sum + entry.tokens, 0);
+            return acc;
+        }, { files: 0, tokens: 0 });
+        const outputPath = join(scaleDir, 'anatomy.md');
+        if (isTruthyFlag(args.write)) {
+            ensureDir(scaleDir);
+            writeFileSync(outputPath, content, 'utf-8');
+        }
+        if (args.json) {
+            console.log(JSON.stringify({
+                ok: true,
+                projectDir,
+                outputPath: isTruthyFlag(args.write) ? outputPath : undefined,
+                summary,
+            }, null, 2));
+            return;
+        }
+        console.log('SCALE Project Anatomy');
+        console.log(`  Files: ${summary.files}`);
+        console.log(`  Estimated tokens: ${summary.tokens}`);
+        if (isTruthyFlag(args.write))
+            console.log(`  Wrote: ${outputPath}`);
+    },
+});
 const context = defineCommand({
     meta: { name: 'context', description: 'Context assembly' },
-    subCommands: { build: contextBuild, status: contextStatus, inject: contextInject, glossary: contextGlossary, init: contextInit, grill: contextGrill, budget: contextBudget, pack: contextPack, doctor: contextDoctor },
+    subCommands: { build: contextBuild, status: contextStatus, inject: contextInject, glossary: contextGlossary, init: contextInit, grill: contextGrill, budget: contextBudget, pack: contextPack, doctor: contextDoctor, anatomy: contextAnatomy },
 });
 // ============================================================================
 // codegraph command - Adapter-first code intelligence
@@ -1722,9 +1844,14 @@ function printWorkspaceLifecycle(report) {
     console.log(`  Branch: ${report.root.branch ?? '(detached)'}`);
     console.log(`  Linked worktree: ${report.root.isLinkedWorktree ? 'yes' : 'no'}`);
     console.log(`  Root status: ${report.root.clean ? 'clean' : 'dirty'}`);
+    console.log(`  Branch policy: ${report.branchPolicy.mode} role=${report.branchPolicy.role} ship=${report.branchPolicy.shipAllowed ? 'allowed' : 'blocked'}`);
+    console.log(`    Integration: ${report.branchPolicy.integrationBranch}`);
+    console.log(`    Production: ${report.branchPolicy.productionBranch}`);
     if (!report.root.clean) {
         console.log(`    staged=${report.root.staged} unstaged=${report.root.unstaged} untracked=${report.root.untracked}`);
     }
+    for (const blocker of report.branchPolicy.shipBlockers)
+        console.log(`  [SHIP BLOCKER] ${blocker}`);
     if (report.childRepositories.length) {
         console.log('\n  Child repositories:');
         for (const child of report.childRepositories) {
@@ -1767,6 +1894,7 @@ function printWorkspaceSummary(report) {
     console.log(`  Status: ${status}`);
     console.log(`  Topology: ${report.topology.topology}${report.topology.configured ? '' : ' (default)'}`);
     console.log(`  Root: ${rootStatus}`);
+    console.log(`  Branch: ${report.root.branch ?? '(detached)'} (${report.branchPolicy.role}, ship ${report.branchPolicy.shipAllowed ? 'allowed' : 'blocked'})`);
     console.log(`  Children: ${report.childRepositories.length} total, ${dirtyChildren.length} dirty, ${unpushedChildren.length} unpushed, ${noUpstreamChildren.length} no upstream`);
     if (dirtyChildren.length > 0)
         console.log(`  Dirty child repositories: ${compactList(dirtyChildren)}`);
@@ -1882,6 +2010,7 @@ const workspaceFinish = defineCommand({
             root: report.root,
             childRepositories: report.childRepositories,
             topology: report.topology,
+            branchPolicy: report.branchPolicy,
             finish: report.finish,
         };
         if (args.json) {
@@ -2223,6 +2352,7 @@ const init = defineCommand({
         },
         quick: { type: 'boolean', default: false, description: 'Quick start with auto-detection' },
         interactive: { type: 'boolean', default: false, description: 'Interactive configuration mode with prompts' },
+        profile: { type: 'string', default: '', description: 'Configuration profile (minimal/standard/advanced). Auto-mapped from scenario if not specified' },
         'coverage-threshold': { type: 'string', default: '80', description: 'Coverage threshold (default 80%)' },
         'retry-threshold': { type: 'string', default: '3', description: 'Brute retry threshold (default 3)' },
         'block-severity': { type: 'string', default: 'CRITICAL', description: 'Block severity level (CRITICAL/HIGH/MEDIUM)' },
@@ -2285,7 +2415,11 @@ const init = defineCommand({
             });
             result.created.push(...governance.created);
             result.skipped.push(...governance.skipped);
-            console.log(`\n✅ SCALE Engine initialized for ${agentType} (interactive mode)`);
+            // Generate config.yaml from profile
+            const profileId = args.profile || profileFromScenario(scenarioMode);
+            const configPath = writeConfigYaml(args.dir, profileId, projectName, [agentType]);
+            result.created.push(configPath);
+            console.log(`\n✅ SCALE Engine initialized for ${agentType} (interactive mode, profile: ${profileId})`);
             console.log(`\n📁 Created:`);
             for (const f of result.created)
                 console.log(`   + ${f}`);
@@ -2298,8 +2432,10 @@ const init = defineCommand({
             console.log(`   Settings:      ${result.settingsPath}`);
             console.log(`   Knowledge:     ${result.knowledgeDocPath}`);
             console.log(`   Thresholds:    ${thresholdsPath}`);
+            console.log(`   Config:        ${configPath}`);
             console.log(`   Data dir:      ${result.scaleDir}`);
             console.log(`   Scenario:      ${scenarioMode}`);
+            console.log(`   Profile:       ${profileId}`);
             console.log(`\n📋 Next steps:`);
             for (const step of governanceNextSteps())
                 console.log(`   → ${step}`);
@@ -2308,6 +2444,14 @@ const init = defineCommand({
         // One-click quick start mode
         if (!args.agent) {
             const qsResult = await quickStart(args.dir, { governancePack: args['governance-pack'] });
+            // 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);
+                qsResult.created.push(configPath);
+            }
             if (args.json) {
                 const detection = qsResult.success ? undefined : detectPlatform(args.dir);
                 console.log(JSON.stringify({
@@ -2362,15 +2506,21 @@ const init = defineCommand({
         });
         result.created.push(...governance.created);
         result.skipped.push(...governance.skipped);
+        // Generate config.yaml from profile
+        const profileId = args.profile || profileFromScenario(args.scenario);
+        const configPath = writeConfigYaml(args.dir, profileId, projectName, [args.agent]);
+        result.created.push(configPath);
         if (args.json) {
             console.log(JSON.stringify({
                 ok: true,
                 mode: args.quick ? 'quick-agent' : 'manual',
                 agent: args.agent,
                 scenario: args.scenario,
+                profile: profileId,
                 governancePack: args['governance-pack'],
                 settingsPath: result.settingsPath,
                 knowledgeDocPath: result.knowledgeDocPath,
+                configPath,
                 scaleDir: result.scaleDir,
                 created: result.created,
                 skipped: result.skipped,
@@ -2378,7 +2528,7 @@ const init = defineCommand({
             }, null, 2));
             return;
         }
-        console.log(`\n✅ SCALE Engine initialized for ${args.agent} (scenario: ${args.scenario})`);
+        console.log(`\n✅ SCALE Engine initialized for ${args.agent} (scenario: ${args.scenario}, profile: ${profileId})`);
         console.log(`\n📁 Created:`);
         for (const f of result.created)
             console.log(`   + ${f}`);
@@ -2389,6 +2539,7 @@ const init = defineCommand({
         }
         console.log(`\n🔧 Settings: ${result.settingsPath}`);
         console.log(`\n📖 Knowledge: ${result.knowledgeDocPath}`);
+        console.log(`\n📄 Config:    ${configPath}`);
         console.log(`\n📂 Data dir:  ${result.scaleDir}`);
         console.log(`\n📋 Next steps:`);
         for (const step of governanceNextSteps())
@@ -2396,8 +2547,70 @@ const init = defineCommand({
     },
 });
 // ============================================================================
-// governance command — Generated governance asset tooling
+// 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)' },
+        list: { type: 'boolean', default: false, description: 'List all available profiles' },
+        json: { type: 'boolean', default: false, description: 'Output as JSON' },
+    },
+    async run({ args }) {
+        if (args.list) {
+            const profiles = listConfigProfiles();
+            if (args.json) {
+                console.log(JSON.stringify(profiles, null, 2));
+                return;
+            }
+            console.log('\nAvailable profiles:\n');
+            for (const p of profiles) {
+                console.log(`  ${p.id.padEnd(12)} ${p.name} — ${p.description}`);
+            }
+            console.log(`\nUse: scale config profile --set <id>`);
+            return;
+        }
+        if (args.set) {
+            const profile = getConfigProfile(args.set);
+            if (profile.id !== args.set) {
+                console.log(`\n⚠️  Profile "${args.set}" not found. Available: minimal, standard, advanced`);
+                return;
+            }
+            // 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');
+            console.log(`\n✅ Profile switched to: ${profile.name}`);
+            console.log(`   ${profile.description}`);
+            console.log(`\n📄 Config updated: ${configPath}`);
+            return;
+        }
+        // Show current profile
+        const configPath = join('.scale', 'config.yaml');
+        if (!existsSync(configPath)) {
+            console.log('\n⚠️  No config.yaml found. Run: scale init');
+            return;
+        }
+        const content = readFileSync(configPath, 'utf-8');
+        const match = content.match(/^profile:\s*(.+)$/m);
+        const currentProfile = match?.[1]?.trim() || 'standard';
+        const profile = getConfigProfile(currentProfile);
+        if (args.json) {
+            console.log(JSON.stringify({ profile: profile.id, name: profile.name, description: profile.description, sections: profile.sections }, null, 2));
+            return;
+        }
+        console.log(`\nCurrent profile: ${profile.name} (${profile.id})`);
+        console.log(`  ${profile.description}`);
+        console.log(`\nSections: ${profile.sections.join(', ')}`);
+        console.log(`\nUse: scale config profile --set <id> to switch`);
+    },
+});
+const config = defineCommand({
+    meta: { name: 'config', description: 'Configuration management' },
+    subCommands: { profile: configProfile },
+});
 const governanceDiff = defineCommand({
     meta: { name: 'diff', description: 'Check generated governance files for drift' },
     args: {
@@ -3605,6 +3818,75 @@ const memoryDoctor = defineCommand({
             process.exitCode = 1;
     },
 });
+const memoryCerebrum = defineCommand({
+    meta: { name: 'cerebrum', description: 'Maintain .scale/cerebrum.md do-not-repeat rules and preferences' },
+    args: {
+        type: { type: 'string', description: 'Optional entry type: preference or do-not-repeat' },
+        pattern: { type: 'string', description: 'Pattern for do-not-repeat entries' },
+        description: { type: 'string', description: 'Entry description or preference text' },
+        tags: { type: 'string', description: 'Comma-separated tags for preferences' },
+        write: { type: 'boolean', default: false, description: 'Write .scale/cerebrum.md' },
+        json: { type: 'boolean', default: false },
+    },
+    async run({ args }) {
+        const { kb } = getEngine();
+        const manager = new CerebrumManager(kb);
+        const type = args.type ? String(args.type).toLowerCase() : '';
+        let created;
+        if (type) {
+            if (type === 'do-not-repeat' || type === 'do_not_repeat' || type === 'dnr') {
+                const pattern = String(args.pattern ?? '').trim();
+                const description = String(args.description ?? '').trim();
+                if (!pattern || !description) {
+                    console.error('memory cerebrum --type do-not-repeat requires --pattern and --description.');
+                    process.exit(1);
+                    return;
+                }
+                created = await manager.addDoNotRepeat(pattern, description);
+            }
+            else if (type === 'preference' || type === 'pref') {
+                const description = String(args.description ?? args.pattern ?? '').trim();
+                if (!description) {
+                    console.error('memory cerebrum --type preference requires --description.');
+                    process.exit(1);
+                    return;
+                }
+                created = await manager.addPreference(description, parseCommaList(args.tags));
+            }
+            else {
+                console.error('memory cerebrum --type must be preference or do-not-repeat.');
+                process.exit(1);
+                return;
+            }
+        }
+        const entries = await manager.loadAll();
+        const outputPath = join(SCALE_DIR, 'cerebrum.md');
+        const shouldWrite = isTruthyFlag(args.write) || Boolean(created);
+        if (shouldWrite) {
+            ensureDir(SCALE_DIR);
+            writeFileSync(outputPath, manager.toMarkdown(), 'utf-8');
+        }
+        const summary = {
+            total: entries.length,
+            doNotRepeat: entries.filter(entry => entry.type === 'do_not_repeat').length,
+            preferences: entries.filter(entry => entry.type === 'preference').length,
+        };
+        if (args.json) {
+            console.log(JSON.stringify({
+                ok: true,
+                outputPath: shouldWrite ? outputPath : undefined,
+                created,
+                summary,
+            }, null, 2));
+            return;
+        }
+        console.log('SCALE Cerebrum');
+        console.log(`  Do-not-repeat: ${summary.doNotRepeat}`);
+        console.log(`  Preferences: ${summary.preferences}`);
+        if (shouldWrite)
+            console.log(`  Wrote: ${outputPath}`);
+    },
+});
 const memorySettle = defineCommand({
     meta: { name: 'settle', description: 'Settle runtime evidence into a reviewable memory learning candidate' },
     args: {
@@ -3869,6 +4151,7 @@ const memory = defineCommand({
     subCommands: {
         pack: memoryPack,
         doctor: memoryDoctor,
+        cerebrum: memoryCerebrum,
         settle: memorySettle,
         ingest: memoryIngest,
         query: memoryQuery,
@@ -4748,6 +5031,7 @@ const team = defineCommand({
 // Phase-Aligned Commands (v0.10.1) - agent-skills style
 // ============================================================================
 import * as phaseCommands from '../cli/phaseCommands.js';
+import { runCommand } from '../cli/runCommand.js';
 import * as liteCommands from '../cli/liteCommands.js';
 import * as vibeCommands from '../cli/vibeCommands.js';
 const main = defineCommand({
@@ -4766,11 +5050,13 @@ const main = defineCommand({
         verify: phaseCommands.phaseVerify,
         review: phaseCommands.phaseReview,
         ship: phaseCommands.phaseShip,
+        run: runCommand,
         // Original commands (preserved)
         init,
         doctor,
         session,
         gate,
+        'meta-governance': metaGovernance,
         create,
         list,
         show,
@@ -4807,6 +5093,7 @@ const main = defineCommand({
         team,
         'create-prd': createPRD,
         'out-of-scope': outOfScope,
+        config,
     },
 });
 runMain(main);