@hongmaple0820/scale-engine 0.21.2 → 0.23.0

package/README.en.md

@@ -1,23 +1,47 @@
 <p align="center">
-  <img src="https://img.shields.io/badge/version-0.21.2-orange?style=flat-square" alt="version" />
+  <img src="https://img.shields.io/badge/version-0.23.0-orange?style=flat-square" alt="version" />
   <img src="https://img.shields.io/badge/platforms-16-blue?style=flat-square" alt="platforms" />
   <img src="https://img.shields.io/badge/agents-12-blue?style=flat-square" alt="agents" />
   <img src="https://img.shields.io/badge/workflows-10-green?style=flat-square" alt="workflows" />
   <img src="https://img.shields.io/badge/detectors-19-red?style=flat-square" alt="detectors" />
   <img src="https://img.shields.io/badge/tests-verified-brightgreen?style=flat-square" alt="tests" />
-  <img src="https://img.shields.io/badge/npm-0.21.2-cb3837?style=flat-square&logo=npm" alt="npm" />
-</p>
-
-# SCALE Engine v0.21.2
+  <img src="https://img.shields.io/badge/npm-0.23.0-cb3837?style=flat-square&logo=npm" alt="npm" />
+</p>
+
+# SCALE Engine v0.23.0
 
 SCALE Engine makes AI coding agents follow engineering rules through executable workflow gates, evidence files, and review constraints instead of relying on prompt discipline alone. It helps humans see what the agent explored, planned, verified, skipped, and why a task is or is not ready to ship.
 
-Repository: https://github.com/hongmaple0820/scale-engine
-Mirror: https://gitee.com/hongmaple/scale-engine
-npm: https://www.npmjs.com/package/@hongmaple0820/scale-engine
-Language: [English](README.en.md) | [Chinese](README.md)
-
-## What It Solves
+Repository: https://github.com/hongmaple0820/scale-engine
+Mirror: https://gitee.com/hongmaple/scale-engine
+npm: https://www.npmjs.com/package/@hongmaple0820/scale-engine
+Language: [English](README.en.md) | [Chinese](README.md)
+
+## Community
+
+SCALE Engine is an engineering workflow governance project for real AI-agent delivery. Contributions, issues, PRs, governance-pack ideas, and field reports are welcome through the source repositories. Chinese users can also follow the WeChat public account for updates, examples, and community entry points.
+
+| Platform | Link | Purpose |
+| --- | --- | --- |
+| GitHub | [https://github.com/hongmaple0820/scale-engine](https://github.com/hongmaple0820/scale-engine) | Source, issues, and PRs |
+| Gitee | [https://gitee.com/hongmaple/scale-engine](https://gitee.com/hongmaple/scale-engine) | China mirror and feedback |
+| npm | [https://www.npmjs.com/package/@hongmaple0820/scale-engine](https://www.npmjs.com/package/@hongmaple0820/scale-engine) | CLI package |
+
+<p align="center">
+  <img src="image/wechat-public.jpg" alt="SCALE Engine WeChat public account" width="220" />
+</p>
+
+## Sponsorship
+
+If SCALE Engine saves engineering governance time for your team, or helps move AI-agent work into a verifiable, reviewable, and releasable loop, voluntary sponsorship is welcome. Sponsorship supports maintenance, examples, documentation, test coverage, and community support. It is not a commercial support contract and does not change issue or PR priority.
+
+<p align="center">
+  <img src="image/wxPay.jpg" alt="Sponsor with WeChat Pay" width="220" />
+  &nbsp;&nbsp;
+  <img src="image/zfb.jpg" alt="Sponsor with Alipay" width="220" />
+</p>
+
+## What It Solves
 
 AI coding becomes hard when agents must behave consistently across real teams and real repositories:
 

package/README.md

@@ -1,32 +1,61 @@
 <p align="center">
-  <img src="https://img.shields.io/badge/version-0.21.2-orange?style=flat-square" alt="version" />
+  <img src="https://img.shields.io/badge/version-0.23.0-orange?style=flat-square" alt="version" />
   <img src="https://img.shields.io/badge/platforms-16-blue?style=flat-square" alt="platforms" />
   <img src="https://img.shields.io/badge/agents-12-blue?style=flat-square" alt="agents" />
   <img src="https://img.shields.io/badge/workflows-10-green?style=flat-square" alt="workflows" />
   <img src="https://img.shields.io/badge/detectors-19-red?style=flat-square" alt="detectors" />
   <img src="https://img.shields.io/badge/tests-verified-brightgreen?style=flat-square" alt="tests" />
-  <img src="https://img.shields.io/badge/npm-0.21.2-cb3837?style=flat-square&logo=npm" alt="npm" />
-</p>
-
-# SCALE Engine v0.21.2
+  <img src="https://img.shields.io/badge/npm-0.23.0-cb3837?style=flat-square&logo=npm" alt="npm" />
+</p>
+
+# SCALE Engine v0.23.0
 
 SCALE Engine 让 AI Agent 不再只靠“自觉”遵守工程规范。它把探索、规划、实现、验证、评审、发版这些要求变成可执行的命令、门禁和证据文件，让人类可以看见 Agent 做了什么、跳过了什么、为什么能交付或不能交付。
 
-源码仓库：https://github.com/hongmaple0820/scale-engine
-国内镜像：https://gitee.com/hongmaple/scale-engine
-npm：https://www.npmjs.com/package/@hongmaple0820/scale-engine
-语言：[中文](README.md) | [English](README.en.md)
-
-## 社区与推广
-
-### 链接
-
-| 平台 | 链接 | 说明 |
-|------|------|------|
-| 📦 **GitHub** | [https://github.com/hongmaple0820/scale-engine](https://github.com/hongmaple0820/scale-engine) | 源码 + Issues + PR |
-| 🔧 **Gitee** | [https://gitee.com/hongmaple/scale-engine](https://gitee.com/hongmaple/scale-engine) | 国内镜像 |
-| 📦 **npm** | [https://www.npmjs.com/package/@hongmaple0820/scale-engine](https://www.npmjs.com/package/@hongmaple0820/scale-engine) | 包下载 |
-## 它解决什么问题
+源码仓库：https://github.com/hongmaple0820/scale-engine
+国内镜像：https://gitee.com/hongmaple/scale-engine
+npm：https://www.npmjs.com/package/@hongmaple0820/scale-engine
+语言：[中文](README.md) | [English](README.en.md)
+
+## 先怎么学
+
+如果你第一次接触 SCALE，不要从完整命令列表开始读。按这个顺序更容易掌握：
+
+| 目标 | 入口 | 你应该学会什么 |
+| --- | --- | --- |
+| 先跑起来 | [3 分钟快速开始](docs/start/quickstart.md) | 安装 CLI、初始化治理文件、运行 preflight |
+| 看完整闭环 | [官方 Demo Walkthrough](docs/start/agent-governance-demo.md) | 任务上下文、诊断、TDD、artifact 和验证证据如何串起来 |
+| 接入已有项目 | [SCALE 工作流升级指南](docs/start/workflow-upgrade.md) | `init`、`upgrade check/plan/apply`、本地 `make` 包装入口怎么用 |
+| 选择治理包 | 本文的 Governance Pack 章节 | 不同项目形态应该选哪个 pack |
+| 维护或扩展 SCALE | [docs/README.md](docs/README.md) | 文档地图、内部模块和长期维护资料 |
+
+一句话理解：SCALE 不是让 Agent 多写文档，而是让“做了什么、验证了什么、没验证什么”可追踪。
+
+## 社区与推广
+
+SCALE Engine 是一个面向真实工程交付的 Agent 工作流治理项目。欢迎通过源码仓库提交 Issue、PR、场景反馈和治理包改进建议；中文用户也可以关注公众号获取更新、示例和社区入口。
+
+| 平台 | 链接 | 说明 |
+|------|------|------|
+| GitHub | [https://github.com/hongmaple0820/scale-engine](https://github.com/hongmaple0820/scale-engine) | 源码、Issues、PR |
+| Gitee | [https://gitee.com/hongmaple/scale-engine](https://gitee.com/hongmaple/scale-engine) | 国内镜像与反馈 |
+| npm | [https://www.npmjs.com/package/@hongmaple0820/scale-engine](https://www.npmjs.com/package/@hongmaple0820/scale-engine) | CLI 包下载 |
+
+<p align="center">
+  <img src="image/wechat-public.jpg" alt="SCALE Engine 微信公众号" width="220" />
+</p>
+
+## 赞助与支持
+
+如果 SCALE Engine 节省了你的工程治理时间，或帮助你的团队把 AI Agent 工作流落到可验证、可复盘、可发版的闭环里，欢迎自愿赞助。赞助用于持续维护、示例项目、文档、测试矩阵和社区支持，不构成商业支持承诺，也不会改变 Issue 或 PR 的处理优先级。
+
+<p align="center">
+  <img src="image/wxPay.jpg" alt="微信赞助" width="220" />
+  &nbsp;&nbsp;
+  <img src="image/zfb.jpg" alt="支付宝赞助" width="220" />
+</p>
+
+## 它解决什么问题
 
 AI 编码真正难的不是“写代码”，而是持续稳定地遵守工程纪律：
 
@@ -121,9 +150,11 @@ scale skill outdated --dir .
 - `scale tools outdated` 和 `scale skill outdated` 只列出更新面、来源、信任等级和安全策略，不做自动安装。
 - 第三方社区来源默认人工评审，高权限桌面自动化默认阻断自动升级。
 
-详细说明见 [升级管理](docs/UPGRADE_MANAGEMENT.md)。
-
-## Governance Pack
+详细说明见 [升级管理](docs/UPGRADE_MANAGEMENT.md)。
+
+新用户和项目维护者可先看 [SCALE workflow upgrade guide](docs/start/workflow-upgrade.md)，它把 `scale init --interactive`、`scale upgrade check/plan/apply/rollback` 和仓库本地 `make workflow-upgrade-*` 入口放在一条可执行路径里。
+
+## Governance Pack
 
 在已有项目中安装治理工作流：
 

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
@@ -2230,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)' },
@@ -2292,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}`);
@@ -2305,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}`);
@@ -2315,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({
@@ -2369,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,
@@ -2385,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}`);
@@ -2396,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())
@@ -2403,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: {
@@ -3612,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: {
@@ -3876,6 +4151,7 @@ const memory = defineCommand({
     subCommands: {
         pack: memoryPack,
         doctor: memoryDoctor,
+        cerebrum: memoryCerebrum,
         settle: memorySettle,
         ingest: memoryIngest,
         query: memoryQuery,
@@ -4755,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({
@@ -4773,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,
@@ -4814,6 +5093,7 @@ const main = defineCommand({
         team,
         'create-prd': createPRD,
         'out-of-scope': outOfScope,
+        config,
     },
 });
 runMain(main);