@hongmaple0820/scale-engine 0.15.0 → 0.15.1

package/README.en.md

@@ -1,14 +1,14 @@
 <p align="center">
-  <img src="https://img.shields.io/badge/version-0.12.2-orange?style=flat-square" alt="version" />
+  <img src="https://img.shields.io/badge/version-0.15.1-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-560-passing-brightgreen?style=flat-square" alt="tests" />
-  <img src="https://img.shields.io/badge/npm-0.12.2-cb3837?style=flat-square&logo=npm" alt="npm" />
+  <img src="https://img.shields.io/badge/tests-822-passing-brightgreen?style=flat-square" alt="tests" />
+  <img src="https://img.shields.io/badge/npm-0.15.1-cb3837?style=flat-square&logo=npm" alt="npm" />
 </p>
 
-# SCALE Engine v0.11.2
+# SCALE Engine v0.15.1
 
 SCALE Engine is an AI engineering workflow runtime for agentic coding tools. It turns prompt-level engineering rules into stateful workflow gates, persisted evidence, review records, and release checks.
 
@@ -28,7 +28,15 @@ Prompt instructions are advisory. Production engineering needs mechanisms:
 
 ## Current Release
 
-v0.11.1 introduces four priority improvements:
+v0.15.1 focuses on production-grade engineering governance templates:
+
+- Supports MOE and non-MOE workspace topology, child repository blockers, and temporary worktree cleanup candidates.
+- Adds resource asset governance for maintained docs, versioned outputs, task evidence, temporary files, and forbidden commit assets.
+- Adds engineering standards scans for noisy logs, sensitive data redaction, secure input handling, ORM/database usage, framework conventions, and test rigor.
+- Strengthens skill and tool orchestration with routing and evidence contracts for UI/UX, web research, browser E2E, desktop automation, and external Agent CLIs.
+- `scale init` / governance packs now generate service matrix, verification profile, artifact templates, metrics, resource policy, engineering standards, and tool orchestration rules.
+
+Historical v0.11.1 introduced four priority improvements:
 
 ### Phase Commands FSM Blocking
 - `canTransition` + `process.exit(1)` ensures FSM guard failures block execution, not continue

package/README.md

@@ -1,14 +1,14 @@
 <p align="center">
-  <img src="https://img.shields.io/badge/version-0.12.3-orange?style=flat-square" alt="version" />
+  <img src="https://img.shields.io/badge/version-0.15.1-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-562-passing-brightgreen?style=flat-square" alt="tests" />
-  <img src="https://img.shields.io/badge/npm-0.12.2-cb3837?style=flat-square&logo=npm" alt="npm" />
+  <img src="https://img.shields.io/badge/tests-822-passing-brightgreen?style=flat-square" alt="tests" />
+  <img src="https://img.shields.io/badge/npm-0.15.1-cb3837?style=flat-square&logo=npm" alt="npm" />
 </p>
 
-# SCALE Engine v0.12.3
+# SCALE Engine v0.15.1
 
 SCALE Engine 是一个面向 AI 编码 Agent 的工程化工作流运行时。它把提示词里的工程纪律，下沉为状态机、质量门禁、持久化证据、确定性 review 记录和发布检查。
 
@@ -28,7 +28,15 @@ npm：https://www.npmjs.com/package/@hongmaple0820/scale-engine
 
 ## 当前版本
 
-v0.11.1 新增四大优先级改进：
+v0.15.1 聚焦生产级工程治理模板：
+
+- 支持 MOE / 非 MOE 工作区拓扑、子仓库变更阻断、临时 worktree 清理候选识别。
+- 增加资源资产治理，区分长期维护文档、版本化产物、任务证据、临时文件和禁止提交资产。
+- 增加工程规范扫描，覆盖日志噪音、敏感信息脱敏、安全输入、ORM/数据库、框架组件和测试验证。
+- 增强技能与工具编排，UI/UX、联网研究、浏览器 E2E、桌面自动化、外部 Agent CLI 都有路由和证据契约。
+- `scale init` / governance pack 会生成 service matrix、verification profile、artifact 模板、metrics、resource policy、engineering standards 和 tool orchestration 规则。
+
+历史 v0.11.1 新增四大优先级改进：
 
 ### Phase Commands FSM 阻断
 - `canTransition` + `process.exit(1)` 确保 FSM guard 失败时阻塞流程，而非继续执行

package/dist/api/cli.js

@@ -31,6 +31,8 @@ import { WorkflowEngine } from '../workflow/WorkflowEngine.js';
 import { resolveVerificationTargets } from '../workflow/VerificationProfile.js';
 import { writeGovernanceTemplates } from '../workflow/GovernanceTemplates.js';
 import { computeGovernanceDrift } from '../workflow/GovernanceLock.js';
+import { doctorEngineeringStandards, scanEngineeringStandards, settleEngineeringStandards, } from '../workflow/EngineeringStandards.js';
+import { doctorResourceAssets, scanResourceAssets, settleResourceAssets } from '../workflow/ResourceGovernance.js';
 import { TaskMetricsStore } from '../workflow/TaskMetricsStore.js';
 import { checkTaskArtifactCompleteness } from '../workflow/TaskArtifactScaffolder.js';
 import { WorkflowArtifactWriter } from '../workflow/WorkflowArtifactWriter.js';
@@ -38,6 +40,7 @@ import { cleanupWorkspaceLifecycle, inspectWorkspaceLifecycle, } from '../workfl
 import { resolveWorkspaceTopology, workspaceTopologyPath, workspaceTopologyTemplate, } from '../workflow/WorkspaceTopology.js';
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
 import { join, resolve } from 'node:path';
+import { SCALE_ENGINE_VERSION } from '../version.js';
 // ============================================================================
 // Engine bootstrap (单例 + lazy init)
 // ============================================================================
@@ -69,6 +72,42 @@ function gatesForPreflightProfile(profile) {
         return ['G3', 'G0', 'G4', 'G5'];
     return ['G3', 'G0', 'G4', 'G5', 'G6', 'G7'];
 }
+function evaluateEngineeringStandardsGate(options) {
+    const mode = normalizeEngineeringStandardsGateMode(options.policy.engineeringStandardsGate);
+    if (mode === 'off') {
+        return {
+            mode,
+            checked: false,
+            blocked: false,
+            ok: true,
+            findings: [],
+        };
+    }
+    const settlement = options.settle && options.artifactsDir
+        ? settleEngineeringStandards({
+            projectDir: PROJECT_DIR,
+            scaleDir: SCALE_DIR,
+            taskId: options.taskId,
+            artifactsDir: options.artifactsDir,
+        })
+        : undefined;
+    const doctor = settlement?.doctor ?? doctorEngineeringStandards({
+        projectDir: PROJECT_DIR,
+        scaleDir: SCALE_DIR,
+    });
+    return {
+        mode,
+        checked: true,
+        blocked: mode === 'block' && !doctor.ok,
+        ok: doctor.ok,
+        findings: doctor.findings,
+        summary: doctor.scan.summary,
+        standardsImpactPath: settlement?.standardsImpactPath,
+    };
+}
+function normalizeEngineeringStandardsGateMode(value) {
+    return value === 'off' || value === 'block' ? value : 'warn';
+}
 let _engine = null;
 function getEngine() {
     if (!_engine)
@@ -1022,6 +1061,9 @@ const preflight = defineCommand({
             profile: args.profile,
             service: args.service,
         });
+        const engineeringStandards = evaluateEngineeringStandardsGate({
+            policy: resolved.policy,
+        });
         const targetResults = [];
         if (!args.json) {
             console.log('\nSCALE Preflight');
@@ -1030,6 +1072,13 @@ const preflight = defineCommand({
             console.log(`  Profile: ${resolved.profileName}`);
             console.log(`  Preflight profile: ${preflightProfile}`);
             console.log(`  Gates: ${gateStages.join(', ')}`);
+            if (engineeringStandards.checked) {
+                const status = engineeringStandards.blocked ? 'BLOCKED' : engineeringStandards.ok ? 'OK' : 'WARN';
+                console.log(`  Engineering standards: ${status} (${engineeringStandards.mode})`);
+            }
+            else {
+                console.log('  Engineering standards: skipped');
+            }
         }
         for (const target of resolved.targets) {
             if (!args.json) {
@@ -1061,7 +1110,9 @@ const preflight = defineCommand({
                 }
             }
         }
-        const passed = targetResults.length > 0 && targetResults.every(target => target.passed);
+        const passed = targetResults.length > 0 &&
+            targetResults.every(target => target.passed) &&
+            !engineeringStandards.blocked;
         const result = {
             phase: 'PREFLIGHT',
             profile: resolved.profileName,
@@ -1069,6 +1120,7 @@ const preflight = defineCommand({
             gates: gateStages,
             services: targetResults.map(target => target.service).filter(Boolean),
             policy: resolved.policy,
+            engineeringStandards,
             targets: targetResults,
             passed,
         };
@@ -1207,7 +1259,7 @@ const init = defineCommand({
         'governance-pack': {
             type: 'string',
             default: 'standard',
-            description: 'Governance template pack (standard/project-scaffold/moe-workspace/go-service-matrix/node-library/frontend-app)',
+            description: 'Governance template pack (standard/project-scaffold/moe-workspace/resource-governance/go-service-matrix/node-library/frontend-app)',
         },
         quick: { type: 'boolean', default: false, description: 'Quick start with auto-detection' },
         interactive: { type: 'boolean', default: false, description: 'Interactive configuration mode with prompts' },
@@ -1414,6 +1466,188 @@ const governance = defineCommand({
     subCommands: { diff: governanceDiff },
 });
 // ============================================================================
+// assets command - Resource lifecycle governance
+// ============================================================================
+const assetsScan = defineCommand({
+    meta: { name: 'scan', description: 'Classify project docs, reports, media, scripts, and temporary outputs' },
+    args: {
+        dir: { type: 'string', default: '.', description: 'Project directory' },
+        json: { type: 'boolean', default: false, description: 'Print JSON output' },
+    },
+    run({ args }) {
+        const report = scanResourceAssets({ projectDir: args.dir });
+        if (args.json) {
+            console.log(JSON.stringify(report, null, 2));
+            return;
+        }
+        console.log('SCALE Asset Scan');
+        console.log(`  Project: ${report.projectDir}`);
+        console.log(`  Total resources: ${report.summary.total}`);
+        console.log(`  Tracked forbidden: ${report.summary.trackedForbidden}`);
+        console.log(`  Large tracked: ${report.summary.largeTracked}`);
+        console.log(`  Expired: ${report.summary.expired}`);
+        console.log('\nBy type:');
+        for (const [type, count] of Object.entries(report.summary.byType)) {
+            if (count > 0)
+                console.log(`  ${type}: ${count}`);
+        }
+    },
+});
+const assetsDoctor = defineCommand({
+    meta: { name: 'doctor', description: 'Find resource lifecycle and Git policy problems' },
+    args: {
+        dir: { type: 'string', default: '.', description: 'Project directory' },
+        json: { type: 'boolean', default: false, description: 'Print JSON output' },
+    },
+    run({ args }) {
+        const report = doctorResourceAssets({ projectDir: args.dir });
+        if (args.json) {
+            console.log(JSON.stringify(report, null, 2));
+            return;
+        }
+        console.log(`SCALE Asset Doctor: ${report.ok ? 'OK' : 'FAILED'}`);
+        if (report.findings.length === 0) {
+            console.log('  No resource lifecycle findings.');
+            return;
+        }
+        for (const finding of report.findings) {
+            const path = finding.path ? ` ${finding.path}` : '';
+            console.log(`  [${finding.severity.toUpperCase()}] ${finding.code}${path}: ${finding.message}`);
+            if (finding.fix)
+                console.log(`    fix: ${finding.fix}`);
+        }
+        if (!report.ok)
+            process.exitCode = 1;
+    },
+});
+const assetsSettle = defineCommand({
+    meta: { name: 'settle', description: 'Record resource lifecycle settlement evidence for a task' },
+    args: {
+        dir: { type: 'string', default: '.', description: 'Project directory' },
+        'task-id': { type: 'string', description: 'Task id for the settlement record' },
+        'artifact-dir': { type: 'string', description: 'Task artifact directory where resource-impact.md should be updated' },
+        json: { type: 'boolean', default: false, description: 'Print JSON output' },
+    },
+    run({ args }) {
+        const report = settleResourceAssets({
+            projectDir: args.dir,
+            taskId: args['task-id'],
+            artifactsDir: args['artifact-dir'],
+        });
+        if (args.json) {
+            console.log(JSON.stringify(report, null, 2));
+        }
+        else {
+            console.log(`SCALE Asset Settlement: ${report.ok ? 'OK' : 'FAILED'}`);
+            if (report.resourceImpactPath)
+                console.log(`  Resource impact: ${report.resourceImpactPath}`);
+            if (report.doctor.findings.length > 0) {
+                for (const finding of report.doctor.findings) {
+                    const path = finding.path ? ` ${finding.path}` : '';
+                    console.log(`  [${finding.severity.toUpperCase()}] ${finding.code}${path}: ${finding.message}`);
+                }
+            }
+        }
+        if (!report.ok)
+            process.exitCode = 1;
+    },
+});
+const assets = defineCommand({
+    meta: { name: 'assets', description: 'Resource lifecycle governance for generated and maintained project assets' },
+    subCommands: { scan: assetsScan, doctor: assetsDoctor, settle: assetsSettle },
+});
+// ============================================================================
+// standards command - Engineering standards governance
+// ============================================================================
+const standardsScan = defineCommand({
+    meta: { name: 'scan', description: 'Scan source files for engineering standard violations' },
+    args: {
+        dir: { type: 'string', default: '.', description: 'Project directory' },
+        json: { type: 'boolean', default: false, description: 'Print JSON output' },
+    },
+    run({ args }) {
+        const report = scanEngineeringStandards({ projectDir: args.dir });
+        if (args.json) {
+            console.log(JSON.stringify(report, null, 2));
+            return;
+        }
+        console.log('SCALE Standards Scan');
+        console.log(`  Project: ${report.projectDir}`);
+        console.log(`  Files scanned: ${report.summary.filesScanned}`);
+        console.log(`  Findings: ${report.summary.totalFindings}`);
+        console.log(`  Blocking findings: ${report.summary.blockingFindings}`);
+        for (const finding of report.findings.slice(0, 20)) {
+            const line = finding.line ? `:${finding.line}` : '';
+            console.log(`  [${finding.severity.toUpperCase()}] ${finding.ruleId} ${finding.path}${line}: ${finding.message}`);
+        }
+        if (report.findings.length > 20)
+            console.log(`  ... ${report.findings.length - 20} more finding(s)`);
+    },
+});
+const standardsDoctor = defineCommand({
+    meta: { name: 'doctor', description: 'Find blocking engineering standards problems' },
+    args: {
+        dir: { type: 'string', default: '.', description: 'Project directory' },
+        json: { type: 'boolean', default: false, description: 'Print JSON output' },
+    },
+    run({ args }) {
+        const report = doctorEngineeringStandards({ projectDir: args.dir });
+        if (args.json) {
+            console.log(JSON.stringify(report, null, 2));
+            if (!report.ok)
+                process.exitCode = 1;
+            return;
+        }
+        console.log(`SCALE Standards Doctor: ${report.ok ? 'OK' : 'FAILED'}`);
+        if (report.findings.length === 0) {
+            console.log('  No engineering standards findings.');
+            return;
+        }
+        for (const finding of report.findings) {
+            const line = finding.line ? `:${finding.line}` : '';
+            console.log(`  [${finding.severity.toUpperCase()}] ${finding.ruleId} ${finding.path}${line}: ${finding.message}`);
+            if (finding.fix)
+                console.log(`    fix: ${finding.fix}`);
+        }
+        if (!report.ok)
+            process.exitCode = 1;
+    },
+});
+const standardsSettle = defineCommand({
+    meta: { name: 'settle', description: 'Record engineering standards settlement evidence for a task' },
+    args: {
+        dir: { type: 'string', default: '.', description: 'Project directory' },
+        'task-id': { type: 'string', description: 'Task id for the settlement record' },
+        'artifact-dir': { type: 'string', description: 'Task artifact directory where standards-impact.md should be updated' },
+        json: { type: 'boolean', default: false, description: 'Print JSON output' },
+    },
+    run({ args }) {
+        const report = settleEngineeringStandards({
+            projectDir: args.dir,
+            taskId: args['task-id'],
+            artifactsDir: args['artifact-dir'],
+        });
+        if (args.json) {
+            console.log(JSON.stringify(report, null, 2));
+        }
+        else {
+            console.log(`SCALE Standards Settlement: ${report.ok ? 'OK' : 'FAILED'}`);
+            if (report.standardsImpactPath)
+                console.log(`  Standards impact: ${report.standardsImpactPath}`);
+            for (const finding of report.doctor.findings) {
+                const line = finding.line ? `:${finding.line}` : '';
+                console.log(`  [${finding.severity.toUpperCase()}] ${finding.ruleId} ${finding.path}${line}: ${finding.message}`);
+            }
+        }
+        if (!report.ok)
+            process.exitCode = 1;
+    },
+});
+const standards = defineCommand({
+    meta: { name: 'standards', description: 'Engineering standards governance for logs, security, architecture, database, and code quality' },
+    subCommands: { scan: standardsScan, doctor: standardsDoctor, settle: standardsSettle },
+});
+// ============================================================================
 // evolve command
 // ============================================================================
 const evolve = defineCommand({
@@ -1976,7 +2210,7 @@ import * as phaseCommands from '../cli/phaseCommands.js';
 import * as liteCommands from '../cli/liteCommands.js';
 import * as vibeCommands from '../cli/vibeCommands.js';
 const main = defineCommand({
-    meta: { name: 'scale', version: '0.13.0', description: 'SCALE Engine v0.13.0 CLI - hardened phase workflow gates, governance templates, platform adapters, skill routing, and verification automation' },
+    meta: { name: 'scale', version: SCALE_ENGINE_VERSION, description: `SCALE Engine v${SCALE_ENGINE_VERSION} CLI - hardened phase workflow gates, governance templates, platform adapters, skill routing, and verification automation` },
     subCommands: {
         // Lite Mode (agent-skills style interactive entry)
         lite: liteCommands.liteCommand,
@@ -2008,6 +2242,8 @@ const main = defineCommand({
         stats,
         preflight,
         governance,
+        assets,
+        standards,
         metrics,
         'task-artifacts': taskArtifacts,
         workspace,