@hongmaple0820/scale-engine 0.14.0 → 0.15.1

package/dist/api/cli.js

@@ -31,12 +31,16 @@ 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';
 import { cleanupWorkspaceLifecycle, inspectWorkspaceLifecycle, } from '../workflow/WorkspaceLifecycle.js';
+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)
 // ============================================================================
@@ -68,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)
@@ -826,6 +866,7 @@ const taskArtifacts = defineCommand({
 });
 function printWorkspaceLifecycle(report) {
     console.log('\nSCALE Workspace Lifecycle');
+    console.log(`  Topology: ${report.topology.topology}${report.topology.configured ? '' : ' (default)'}`);
     console.log(`  Root: ${report.root.path}`);
     console.log(`  Branch: ${report.root.branch ?? '(detached)'}`);
     console.log(`  Linked worktree: ${report.root.isLinkedWorktree ? 'yes' : 'no'}`);
@@ -852,6 +893,19 @@ function printWorkspaceLifecycle(report) {
     for (const action of report.finish.nextActions)
         console.log(`  [NEXT] ${action}`);
 }
+function printWorkspaceTopology(topology, written) {
+    console.log('\nSCALE Workspace Topology');
+    console.log(`  Topology: ${topology.topology}${topology.configured ? '' : ' (default)'}`);
+    console.log(`  Config: ${topology.configPath}`);
+    if (written)
+        console.log(`  Written: ${written}`);
+    console.log('\n  Repositories:');
+    for (const repo of topology.repositories) {
+        console.log(`    - ${repo.name}: ${repo.path} (${repo.role}) required=${repo.required !== false ? 'yes' : 'no'}`);
+    }
+    for (const warning of topology.warnings)
+        console.log(`  [WARN] ${warning}`);
+}
 function printWorkspaceCleanup(result) {
     printWorkspaceLifecycle(result.report);
     console.log('\n  Cleanup plan:');
@@ -885,6 +939,35 @@ const workspaceStatus = defineCommand({
             process.exitCode = 1;
     },
 });
+const workspaceMap = defineCommand({
+    meta: { name: 'map', description: 'Resolve or write explicit workspace topology for single, monorepo, polyrepo, submodule, or MOE projects' },
+    args: {
+        dir: { type: 'string', description: 'Project directory; defaults to current project directory' },
+        topology: { type: 'string', default: 'moe', description: 'Starter topology for --write (single/monorepo/polyrepo/submodule-workspace/moe)' },
+        write: { type: 'boolean', default: false, description: 'Create .scale/workspace.json when it does not exist' },
+        json: { type: 'boolean', default: false },
+    },
+    run({ args }) {
+        const projectDir = resolve(args.dir ?? PROJECT_DIR);
+        const target = workspaceTopologyPath(projectDir);
+        let written = null;
+        if (isTruthyFlag(args.write) && !existsSync(target)) {
+            ensureDir(join(projectDir, '.scale'));
+            writeFileSync(target, workspaceTopologyTemplate({
+                topology: normalizeWorkspaceTopologyKind(args.topology),
+            }), 'utf-8');
+            written = target;
+        }
+        const topology = resolveWorkspaceTopology({ projectDir });
+        const result = { ...topology, written };
+        if (args.json) {
+            console.log(JSON.stringify(result, null, 2));
+        }
+        else {
+            printWorkspaceTopology(topology, written);
+        }
+    },
+});
 const workspaceFinish = defineCommand({
     meta: { name: 'finish', description: 'Check whether a temporary worktree can be safely finished or cleaned up' },
     args: {
@@ -896,6 +979,7 @@ const workspaceFinish = defineCommand({
         const result = {
             root: report.root,
             childRepositories: report.childRepositories,
+            topology: report.topology,
             finish: report.finish,
         };
         if (args.json) {
@@ -936,11 +1020,23 @@ const workspaceCleanup = defineCommand({
 const workspace = defineCommand({
     meta: { name: 'workspace', description: 'Inspect worktree, branch, and child repository lifecycle safety' },
     subCommands: {
+        map: workspaceMap,
         status: workspaceStatus,
         finish: workspaceFinish,
         cleanup: workspaceCleanup,
     },
 });
+function normalizeWorkspaceTopologyKind(value) {
+    const normalized = String(value ?? 'moe').trim();
+    if (normalized === 'single'
+        || normalized === 'monorepo'
+        || normalized === 'polyrepo'
+        || normalized === 'submodule-workspace'
+        || normalized === 'moe') {
+        return normalized;
+    }
+    return 'moe';
+}
 const preflight = defineCommand({
     meta: { name: 'preflight', description: 'Run service-aware verification without a task artifact' },
     args: {
@@ -965,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');
@@ -973,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) {
@@ -1004,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,
@@ -1012,6 +1120,7 @@ const preflight = defineCommand({
             gates: gateStages,
             services: targetResults.map(target => target.service).filter(Boolean),
             policy: resolved.policy,
+            engineeringStandards,
             targets: targetResults,
             passed,
         };
@@ -1150,7 +1259,7 @@ const init = defineCommand({
         'governance-pack': {
             type: 'string',
             default: 'standard',
-            description: 'Governance template pack (standard/project-scaffold/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' },
@@ -1357,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({
@@ -1919,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,
@@ -1951,6 +2242,8 @@ const main = defineCommand({
         stats,
         preflight,
         governance,
+        assets,
+        standards,
         metrics,
         'task-artifacts': taskArtifacts,
         workspace,