@hongmaple0820/scale-engine 0.17.0 → 0.18.0

package/dist/api/cli.js

@@ -30,7 +30,7 @@ import { EvidenceStore } from '../workflow/EvidenceStore.js';
 import { OutOfScopeStore } from '../workflow/OutOfScopeStore.js';
 import { ReviewStore } from '../workflow/ReviewStore.js';
 import { WorkflowEngine } from '../workflow/WorkflowEngine.js';
-import { resolveVerificationTargets } from '../workflow/VerificationProfile.js';
+import { resolveVerificationTargets, } from '../workflow/VerificationProfile.js';
 import { writeGovernanceTemplates } from '../workflow/GovernanceTemplates.js';
 import { computeGovernanceDrift } from '../workflow/GovernanceLock.js';
 import { baselineEngineeringStandards, doctorEngineeringStandards, scanEngineeringStandards, settleEngineeringStandards, } from '../workflow/EngineeringStandards.js';
@@ -47,11 +47,13 @@ import { evaluateToolEvidenceGate } from '../tools/ToolEvidenceGate.js';
 import { ToolEvidenceStore } from '../tools/ToolEvidenceStore.js';
 import { ToolOrchestrator } from '../tools/ToolOrchestrator.js';
 import { loadToolPolicy, toolPolicyTemplate } from '../tools/ToolPolicy.js';
+import { doctorHtmlArtifacts, renderHtmlArtifact, resolveHtmlArtifactForOpen, settleHtmlArtifacts, } from '../output/HTMLArtifactLayer.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 { execFileSync } from 'node:child_process';
+import { pathToFileURL } from 'node:url';
 import { SCALE_ENGINE_VERSION } from '../version.js';
 // ============================================================================
 // Engine bootstrap (单例 + lazy init)
@@ -96,6 +98,26 @@ function gatesForPreflightProfile(profile) {
         return ['G3', 'G0', 'G4', 'G5'];
     return ['G3', 'G0', 'G4', 'G5', 'G6', 'G7'];
 }
+function shouldSkipPreflightCommandTargets(resolved, args) {
+    if (!resolved.matrix)
+        return false;
+    const requestedService = String(args.service ?? '').trim();
+    if (requestedService && requestedService !== 'all')
+        return false;
+    const hasCommandOverrides = [
+        args['build-cmd'],
+        args['lint-cmd'],
+        args['test-cmd'],
+        args['coverage-cmd'],
+    ].some(value => typeof value === 'string' && value.trim().length > 0);
+    if (hasCommandOverrides)
+        return false;
+    const profile = resolved.matrix.profiles?.[resolved.profileName];
+    const hasProfileCommands = Object.values(profile?.commands ?? {})
+        .some(value => typeof value === 'string' && value.trim().length > 0);
+    const hasServices = (resolved.matrix.services ?? []).length > 0;
+    return !hasServices && !hasProfileCommands;
+}
 function evaluateEngineeringStandardsGate(options) {
     const mode = normalizeEngineeringStandardsGateMode(options.policy.engineeringStandardsGate);
     if (mode === 'off') {
@@ -1378,6 +1400,10 @@ const preflight = defineCommand({
             profile: args.profile,
             service: args.service,
         });
+        const commandTargetsSkipped = shouldSkipPreflightCommandTargets(resolved, args);
+        if (commandTargetsSkipped) {
+            resolved.warnings.push('No verification services or profile commands configured; command gates skipped for this governance-only project.');
+        }
         const engineeringStandards = evaluateEngineeringStandardsGate({
             policy: resolved.policy,
         });
@@ -1397,7 +1423,7 @@ const preflight = defineCommand({
                 console.log('  Engineering standards: skipped');
             }
         }
-        for (const target of resolved.targets) {
+        for (const target of commandTargetsSkipped ? [] : resolved.targets) {
             if (!args.json) {
                 const label = target.service ? `${target.service.name} (${target.service.path})` : 'root';
                 console.log(`\n  Target: ${label}`);
@@ -1427,8 +1453,7 @@ 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',
@@ -1439,6 +1464,7 @@ const preflight = defineCommand({
             policy: resolved.policy,
             engineeringStandards,
             targets: targetResults,
+            commandTargetsSkipped,
             passed,
         };
         if (args.json) {
@@ -1689,7 +1715,7 @@ const init = defineCommand({
                 const detection = qsResult.success ? undefined : detectPlatform(args.dir);
                 console.log(JSON.stringify({
                     ok: qsResult.success,
-                    mode: 'quick',
+                    mode: qsResult.success && !qsResult.platform ? 'governance-only' : 'quick',
                     platform: qsResult.platform,
                     created: qsResult.created,
                     skipped: qsResult.skipped,
@@ -1701,8 +1727,11 @@ const init = defineCommand({
                 }, null, 2));
                 return;
             }
-            if (qsResult.success && qsResult.platform) {
-                console.log(`\n✅ SCALE Engine Quick Start completed for ${qsResult.platform}`);
+            if (qsResult.success) {
+                if (!qsResult.platform)
+                    console.log(`\nSCALE governance templates initialized`);
+                else
+                    console.log(`\n✅ SCALE Engine Quick Start completed for ${qsResult.platform}`);
                 console.log(`\n📁 Created (${qsResult.created.length}):`);
                 for (const f of qsResult.created)
                     console.log(`   + ${f}`);
@@ -2056,6 +2085,182 @@ const standards = defineCommand({
     subCommands: { scan: standardsScan, doctor: standardsDoctor, settle: standardsSettle, baseline: standardsBaseline },
 });
 // ============================================================================
+// artifact command - Derived HTML artifacts for human review
+// ============================================================================
+const artifactRender = defineCommand({
+    meta: { name: 'render', description: 'Render a task Markdown source set into a governed HTML artifact' },
+    args: {
+        dir: { type: 'string', default: '.', description: 'Project directory' },
+        'task-id': { type: 'string', description: 'Task id under docs/worklog/tasks' },
+        'artifact-dir': { type: 'string', description: 'Task artifact directory override' },
+        type: { type: 'string', default: 'release-report', description: 'HTML artifact type' },
+        source: { type: 'string', description: 'Comma or newline separated source Markdown files relative to the task directory' },
+        theme: { type: 'string', default: 'auto', description: 'Theme mode: dark/light/auto' },
+        lang: { type: 'string', default: 'zh', description: 'HTML language: zh/en' },
+        title: { type: 'string', description: 'HTML document title override' },
+        json: { type: 'boolean', default: false, description: 'Print JSON output' },
+    },
+    run({ args }) {
+        const result = renderHtmlArtifact({
+            projectDir: args.dir,
+            taskId: args['task-id'],
+            artifactDir: args['artifact-dir'],
+            type: String(args.type ?? 'release-report'),
+            sourcePaths: splitChangedFiles(typeof args.source === 'string' ? args.source : undefined),
+            theme: normalizeThemeArg(args.theme),
+            lang: normalizeLangArg(args.lang),
+            title: typeof args.title === 'string' ? args.title : undefined,
+        });
+        if (args.json) {
+            console.log(JSON.stringify(result, null, 2));
+            return;
+        }
+        console.log('SCALE HTML Artifact Render');
+        console.log(`  Type: ${result.type}`);
+        console.log(`  HTML: ${result.outputPath}`);
+        console.log(`  Index: ${result.indexPath}`);
+        console.log(`  Manifest: ${result.manifestPath}`);
+        if (result.missingSources.length > 0) {
+            console.log(`  Missing sources: ${result.missingSources.join(', ')}`);
+        }
+    },
+});
+const artifactDoctor = defineCommand({
+    meta: { name: 'doctor', description: 'Check HTML artifacts for traceability, stale sources, remote assets, and secret-like content' },
+    args: {
+        dir: { type: 'string', default: '.', description: 'Project directory' },
+        'task-id': { type: 'string', description: 'Task id under docs/worklog/tasks' },
+        'artifact-dir': { type: 'string', description: 'Task artifact directory override' },
+        type: { type: 'string', description: 'Optional HTML artifact type to check' },
+        json: { type: 'boolean', default: false, description: 'Print JSON output' },
+    },
+    run({ args }) {
+        const report = doctorHtmlArtifacts({
+            projectDir: args.dir,
+            taskId: args['task-id'],
+            artifactDir: args['artifact-dir'],
+            type: typeof args.type === 'string' ? args.type : undefined,
+        });
+        if (args.json) {
+            console.log(JSON.stringify(report, null, 2));
+            if (!report.ok)
+                process.exitCode = 1;
+            return;
+        }
+        console.log(`SCALE HTML Artifact Doctor: ${report.ok ? 'OK' : 'FAILED'}`);
+        console.log(`  Manifest: ${report.manifestPath}`);
+        console.log(`  Artifacts: ${report.artifacts.length}`);
+        if (report.findings.length === 0) {
+            console.log('  No HTML artifact findings.');
+        }
+        else {
+            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 artifactSettle = defineCommand({
+    meta: { name: 'settle', description: 'Record HTML artifact settlement evidence for a task' },
+    args: {
+        dir: { type: 'string', default: '.', description: 'Project directory' },
+        'task-id': { type: 'string', description: 'Task id under docs/worklog/tasks' },
+        'artifact-dir': { type: 'string', description: 'Task artifact directory override' },
+        json: { type: 'boolean', default: false, description: 'Print JSON output' },
+    },
+    run({ args }) {
+        const report = settleHtmlArtifacts({
+            projectDir: args.dir,
+            taskId: args['task-id'],
+            artifactDir: args['artifact-dir'],
+        });
+        if (args.json) {
+            console.log(JSON.stringify(report, null, 2));
+            if (!report.ok)
+                process.exitCode = 1;
+            return;
+        }
+        console.log(`SCALE HTML Artifact Settlement: ${report.ok ? 'OK' : 'FAILED'}`);
+        console.log(`  HTML impact: ${report.htmlImpactPath}`);
+        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 artifactOpen = defineCommand({
+    meta: { name: 'open', description: 'Open or print the local file URL for a rendered HTML artifact' },
+    args: {
+        dir: { type: 'string', default: '.', description: 'Project directory' },
+        'task-id': { type: 'string', description: 'Task id under docs/worklog/tasks' },
+        'artifact-dir': { type: 'string', description: 'Task artifact directory override' },
+        type: { type: 'string', description: 'Optional HTML artifact type to open' },
+        'print-only': { type: 'boolean', default: false, description: 'Only print the file URL without launching a browser' },
+        json: { type: 'boolean', default: false, description: 'Print JSON output' },
+    },
+    run({ args }) {
+        const path = resolveHtmlArtifactForOpen({
+            projectDir: args.dir,
+            taskId: args['task-id'],
+            artifactDir: args['artifact-dir'],
+            type: typeof args.type === 'string' ? args.type : undefined,
+        });
+        const url = pathToFileURL(path).toString();
+        const exists = existsSync(path);
+        if (!args['print-only'] && exists)
+            launchLocalFile(path);
+        const output = { ok: exists, path, url, launched: Boolean(!args['print-only'] && exists) };
+        if (args.json) {
+            console.log(JSON.stringify(output, null, 2));
+            if (!exists)
+                process.exitCode = 1;
+            return;
+        }
+        if (!exists) {
+            console.log(`HTML artifact not found: ${path}`);
+            process.exitCode = 1;
+            return;
+        }
+        console.log(url);
+    },
+});
+const artifact = defineCommand({
+    meta: { name: 'artifact', description: 'Derived HTML artifact rendering and safety checks' },
+    subCommands: { render: artifactRender, doctor: artifactDoctor, settle: artifactSettle, open: artifactOpen },
+});
+function normalizeThemeArg(value) {
+    const normalized = String(value ?? 'auto').trim().toLowerCase();
+    if (normalized === 'dark' || normalized === 'light' || normalized === 'auto')
+        return normalized;
+    return 'auto';
+}
+function normalizeLangArg(value) {
+    return String(value ?? 'zh').trim().toLowerCase() === 'en' ? 'en' : 'zh';
+}
+function launchLocalFile(path) {
+    try {
+        if (process.platform === 'win32') {
+            execFileSync('cmd', ['/c', 'start', '', path], { stdio: 'ignore' });
+        }
+        else if (process.platform === 'darwin') {
+            execFileSync('open', [path], { stdio: 'ignore' });
+        }
+        else {
+            execFileSync('xdg-open', [path], { stdio: 'ignore' });
+        }
+    }
+    catch {
+        // Opening is convenience-only; artifact doctor/render remains the source of truth.
+    }
+}
+// ============================================================================
 // evolve command
 // ============================================================================
 const evolve = defineCommand({
@@ -2453,6 +2658,7 @@ const skillCheckCommand = defineCommand({
             artifactsDir: args.dir ?? state?.artifactsDir,
             level,
             requiredArtifacts: state?.requiredSkillArtifacts,
+            requiredSkills: state?.requiredSkills,
             mode: state?.skillRoutingMode ?? policy.policy.mode,
             enforceLevels: policy.policy.enforceLevels,
         });
@@ -3005,6 +3211,7 @@ const main = defineCommand({
         stats,
         preflight,
         governance,
+        artifact,
         assets,
         standards,
         metrics,