@hongmaple0820/scale-engine 0.18.0 → 0.20.0

package/dist/api/cli.js

@@ -11,6 +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 { buildContextPack, doctorContextBudget, scanContextBudget, writeContextBudgetReport, } from '../context/ContextBudget.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';
 import { CapabilityRegistry } from '../capabilities/CapabilityRegistry.js';
 import { SkillRegistry } from '../skills/SkillRegistry.js';
@@ -20,10 +23,11 @@ import { createSkillPlan, evaluateSkillGate, loadSkillRoutingPolicy, skillPlanMa
 import { createAdapter, SUPPORTED_AGENTS } from '../adapters/index.js';
 import { LessonExtractor, RuleProposer, HookGenerator, EvolutionEngine } from '../evolution/EvolutionEngine.js';
 import { Doctor } from './doctor.js';
-import { quickStart, detectPlatform } from './quickstart.js';
+import { quickStart, detectPlatform, governanceNextSteps } from './quickstart.js';
 import { SkillDiscovery } from '../skills/SkillDiscovery.js';
 import { inspectRequiredWorkflowSkills, inspectWorkflowSkills } from '../skills/SkillDoctor.js';
 import { evaluateSkillInstallSafety, listSkillRepositoryEntries, recommendSkillWorkflow, renderSkillRepositoryMarkdown, } from '../skills/SkillRepository.js';
+import { evaluateSkillRadar, inspectSkillSupplyChain, renderSkillRadarMarkdown, } from '../skills/SkillRadar.js';
 import { listLeadershipPresets, renderLeadershipPresetsMarkdown } from '../agents/LeadershipPresets.js';
 import { listWorkflowPresets, getPresetsByScenario } from '../workflows/presets.js';
 import { EvidenceStore } from '../workflow/EvidenceStore.js';
@@ -33,6 +37,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 { createGovernanceRoiReport } from '../governance/GovernanceRoi.js';
+import { evaluateProgressiveGovernance, normalizeGovernanceMode } from '../governance/ProgressiveGovernance.js';
 import { baselineEngineeringStandards, doctorEngineeringStandards, scanEngineeringStandards, settleEngineeringStandards, } from '../workflow/EngineeringStandards.js';
 import { doctorResourceAssets, scanResourceAssets, settleResourceAssets } from '../workflow/ResourceGovernance.js';
 import { analyzeContextGovernance, renderContextGrillPrompt, writeContextGovernanceTemplates, } from '../workflow/ContextGovernance.js';
@@ -48,10 +54,14 @@ 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 { renderGovernanceDashboard } from '../output/GovernanceDashboard.js';
 import { cleanupWorkspaceLifecycle, inspectWorkspaceLifecycle, } from '../workflow/WorkspaceLifecycle.js';
+import { inspectWorkspaceSafety } from '../workflow/WorkspaceSafety.js';
+import { RuntimeEvidenceLedger, SessionLedger, doctorRuntimeEvidence, evaluateFinalReportReadiness, } from '../runtime/index.js';
+import { MemoryFabric, MemoryBrain, doctorMemoryFabric, renderContextPackMarkdown, renderMemoryLearningCandidateMarkdown, settleMemoryLearning, } from '../memory/index.js';
 import { resolveWorkspaceTopology, workspaceTopologyPath, workspaceTopologyTemplate, } from '../workflow/WorkspaceTopology.js';
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
-import { join, resolve } from 'node:path';
+import { dirname, isAbsolute, join, resolve } from 'node:path';
 import { execFileSync } from 'node:child_process';
 import { pathToFileURL } from 'node:url';
 import { SCALE_ENGINE_VERSION } from '../version.js';
@@ -131,15 +141,15 @@ function evaluateEngineeringStandardsGate(options) {
     }
     const settlement = options.settle && options.artifactsDir
         ? settleEngineeringStandards({
-            projectDir: PROJECT_DIR,
-            scaleDir: SCALE_DIR,
+            projectDir: options.projectDir ?? PROJECT_DIR,
+            scaleDir: options.scaleDir ?? SCALE_DIR,
             taskId: options.taskId,
             artifactsDir: options.artifactsDir,
         })
         : undefined;
     const doctor = settlement?.doctor ?? doctorEngineeringStandards({
-        projectDir: PROJECT_DIR,
-        scaleDir: SCALE_DIR,
+        projectDir: options.projectDir ?? PROJECT_DIR,
+        scaleDir: options.scaleDir ?? SCALE_DIR,
     });
     return {
         mode,
@@ -151,6 +161,16 @@ function evaluateEngineeringStandardsGate(options) {
         standardsImpactPath: settlement?.standardsImpactPath,
     };
 }
+function skippedEngineeringStandardsGate(reason, policy) {
+    void reason;
+    return {
+        mode: normalizeEngineeringStandardsGateMode(policy.engineeringStandardsGate),
+        checked: false,
+        blocked: false,
+        ok: true,
+        findings: [],
+    };
+}
 function normalizeEngineeringStandardsGateMode(value) {
     return value === 'off' || value === 'block' ? value : 'warn';
 }
@@ -194,6 +214,23 @@ function createEngine() {
     });
     return { eventBus, store, fsm, gateway, roleGate, kb, ctx, fsmAgentBridge, workflowEngine };
 }
+function resolveScaleDirForProject(projectDir) {
+    return isAbsolute(SCALE_DIR) ? SCALE_DIR : join(projectDir, SCALE_DIR);
+}
+function createVerificationWorkflowEngine(scaleDir) {
+    ensureDir(scaleDir);
+    const eventBus = new EventBus({ eventsDir: join(scaleDir, 'events') });
+    const capabilityRegistry = new CapabilityRegistry(eventBus);
+    const skillRegistry = new SkillRegistry(eventBus);
+    registerCoreSkills(skillRegistry);
+    registerExternalSkills(skillRegistry, eventBus);
+    return new WorkflowEngine({
+        eventBus,
+        capabilityRegistry,
+        skillRegistry,
+        scaleDir,
+    });
+}
 // ============================================================================
 // session commands
 // ============================================================================
@@ -889,1257 +926,2541 @@ const contextGrill = defineCommand({
             console.log(`\nArtifact: ${artifactPath}`);
     },
 });
-const context = defineCommand({
-    meta: { name: 'context', description: 'Context assembly' },
-    subCommands: { build: contextBuild, status: contextStatus, inject: contextInject, glossary: contextGlossary, init: contextInit, grill: contextGrill },
-});
-// ============================================================================
-// diagnose command - evidence-first debugging loop
-// ============================================================================
-const diagnosePlanCommand = defineCommand({
-    meta: { name: 'plan', description: 'Create a reproducible diagnostic loop before fixing a bug' },
+function parsePositiveIntArg(value, name) {
+    if (value === undefined || value === null || value === '')
+        return undefined;
+    const parsed = Number.parseInt(String(value), 10);
+    if (Number.isNaN(parsed) || parsed <= 0) {
+        throw new Error(`${name} must be a positive integer.`);
+    }
+    return parsed;
+}
+const contextBudget = defineCommand({
+    meta: { name: 'budget', description: 'Report Always/on-demand/evidence/archive/generated context token cost' },
     args: {
-        'task-id': { type: 'string', required: true },
-        symptom: { type: 'string', required: true },
-        repro: { type: 'string', description: 'Command that reproduces the current failure' },
-        'expected-failure': { type: 'string', description: 'Expected failing behavior or assertion' },
-        files: { type: 'string', description: 'Comma-separated changed or suspicious files' },
-        verify: { type: 'string', description: 'Comma-separated verification commands after the fix' },
-        'artifact-dir': { type: 'string', description: 'Task artifact directory where plan.md should be updated' },
-        write: { type: 'boolean', default: false, description: 'Append diagnostic loop output to the task plan artifact' },
+        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' },
+        write: { type: 'boolean', default: false, description: 'Write .scale/context-budget.json' },
         json: { type: 'boolean', default: false },
     },
     run({ args }) {
-        const changedFiles = parseCommaList(args.files);
-        const loop = createDiagnosticLoop({
-            taskId: String(args['task-id']),
-            symptom: String(args.symptom),
-            reproductionCommand: args.repro ? String(args.repro) : undefined,
-            expectedFailure: args['expected-failure'] ? String(args['expected-failure']) : undefined,
-            changedFiles,
-            verificationCommands: parseCommaList(args.verify),
+        const projectDir = resolve(String(args.dir ?? PROJECT_DIR));
+        const scaleDir = resolveScaleDirForProject(projectDir);
+        const report = scanContextBudget({
+            projectDir,
+            scaleDir,
+            maxAlwaysTokens: parsePositiveIntArg(args['max-always'], '--max-always'),
+            maxTaskTokens: parsePositiveIntArg(args['max-task'], '--max-task'),
         });
-        const validation = validateDiagnosticLoop(loop);
-        const artifactPath = isTruthyFlag(args.write)
-            ? appendDiagnosticLoopArtifact({
-                projectDir: PROJECT_DIR,
-                artifactsDir: args['artifact-dir'] ? String(args['artifact-dir']) : undefined,
-                loop,
-                validation,
-            }) ?? undefined
-            : undefined;
-        if (artifactPath || args['artifact-dir']) {
-            const writer = new WorkflowArtifactWriter(SCALE_DIR);
-            const current = writer.readCurrentState();
-            const currentOpenTasks = current?.taskId === loop.taskId ? current.openTasks : [];
-            writer.updateCurrentState({
-                taskId: loop.taskId,
-                phase: 'plan',
-                artifactsDir: args['artifact-dir'] ? String(args['artifact-dir']).replace(/\\/g, '/') : undefined,
-                filesModified: changedFiles,
-                openTasks: validation.ready
-                    ? removeWorkflowOpenTask(currentOpenTasks.filter(task => task.trim().startsWith('scale ')), 'diagnostic-loop')
-                    : uniqueStrings([
-                        ...currentOpenTasks,
-                        ...validation.blockers,
-                    ]),
-            });
-        }
+        const path = isTruthyFlag(args.write) ? writeContextBudgetReport(report) : undefined;
         if (args.json) {
-            console.log(JSON.stringify({ loop, validation, artifactPath }, null, 2));
+            console.log(JSON.stringify({ ...report, path }, null, 2));
             return;
         }
-        console.log(renderDiagnosticLoopMarkdown(loop));
-        if (!validation.ready) {
-            console.log('\nBlockers:');
-            for (const blocker of validation.blockers)
-                console.log(`  - ${blocker}`);
+        console.log('SCALE Context Budget');
+        console.log(`  Project: ${report.projectDir}`);
+        console.log(`  Total: ${report.summary.totalTokens} estimated tokens across ${report.summary.totalFiles} files`);
+        console.log(`  Always: ${report.summary.alwaysTokens}/${report.thresholds.maxAlwaysTokens}`);
+        for (const [category, summary] of Object.entries(report.summary.byCategory)) {
+            console.log(`  ${category}: ${summary.tokens} tokens in ${summary.files} files`);
         }
-        if (artifactPath)
-            console.log(`\nArtifact: ${artifactPath}`);
+        for (const recommendation of report.recommendations)
+            console.log(`  recommendation: ${recommendation}`);
+        if (path)
+            console.log(`  wrote: ${path}`);
     },
 });
-const diagnose = defineCommand({
-    meta: { name: 'diagnose', description: 'Evidence-first debugging workflows' },
-    subCommands: { plan: diagnosePlanCommand },
-});
-// ============================================================================
-// tdd command - vertical slice RED/GREEN/REFACTOR loop
-// ============================================================================
-const tddSliceCommand = defineCommand({
-    meta: { name: 'slice', description: 'Create and evaluate a TDD vertical slice' },
+const contextPack = defineCommand({
+    meta: { name: 'pack', description: 'Build a lazy-loaded context pack for a task' },
     args: {
-        'task-id': { type: 'string', required: true },
-        behavior: { type: 'string', required: true },
-        'public-interface': { type: 'string', required: true },
-        'failing-test': { type: 'string', required: true },
-        'test-file': { type: 'string', required: true },
-        'impl-files': { type: 'string', required: true },
-        'red-exit-code': { type: 'string', description: 'Exit code from the RED command' },
-        'red-summary': { type: 'string', description: 'Short RED output summary' },
-        'green-exit-code': { type: 'string', description: 'Exit code from the GREEN command' },
-        'green-summary': { type: 'string', description: 'Short GREEN output summary' },
-        'refactor-exit-code': { type: 'string', description: 'Exit code from the REFACTOR command' },
-        'refactor-summary': { type: 'string', description: 'Short REFACTOR output summary' },
-        'artifact-dir': { type: 'string', description: 'Task artifact directory where verification.md should be updated' },
-        write: { type: 'boolean', default: false, description: 'Append TDD slice output to the task verification artifact' },
+        dir: { type: 'string', default: PROJECT_DIR, description: 'Project directory' },
+        task: { type: 'string', required: true, description: 'Current task or question' },
+        'task-id': { type: 'string', description: 'Task id' },
+        level: { type: 'string', default: 'M', description: 'Task level: S, M, L, or CRITICAL' },
+        files: { type: 'string', description: 'Comma-separated files or modules in scope' },
+        budget: { type: 'string', description: 'Maximum estimated tokens for the context pack' },
         json: { type: 'boolean', default: false },
     },
     run({ args }) {
-        const failingTest = String(args['failing-test']);
-        const slice = createTddSlice({
-            taskId: String(args['task-id']),
-            behavior: String(args.behavior),
-            publicInterface: String(args['public-interface']),
-            failingTestCommand: failingTest,
-            testFile: String(args['test-file']),
-            implementationFiles: parseCommaList(args['impl-files']),
-            redEvidence: commandEvidence(failingTest, args['red-exit-code'], args['red-summary']),
-            greenEvidence: commandEvidence(failingTest, args['green-exit-code'], args['green-summary']),
-            refactorEvidence: commandEvidence(failingTest, args['refactor-exit-code'], args['refactor-summary']),
+        const projectDir = resolve(String(args.dir ?? PROJECT_DIR));
+        const scaleDir = resolveScaleDirForProject(projectDir);
+        const pack = buildContextPack({
+            projectDir,
+            scaleDir,
+            task: String(args.task),
+            taskId: args['task-id'] ? String(args['task-id']) : undefined,
+            level: String(args.level ?? 'M'),
+            files: parseCommaList(args.files),
+            budget: parsePositiveIntArg(args.budget, '--budget'),
         });
-        const evaluation = evaluateTddSlice(slice);
-        const artifactPath = isTruthyFlag(args.write)
-            ? appendTddSliceArtifact({
-                projectDir: PROJECT_DIR,
-                artifactsDir: args['artifact-dir'] ? String(args['artifact-dir']) : undefined,
-                slice,
-            }) ?? undefined
-            : undefined;
-        let tddStatePath;
-        if (slice.redEvidence && slice.greenEvidence && slice.refactorEvidence) {
-            const writer = new WorkflowArtifactWriter(SCALE_DIR);
-            writer.writeTDDEvidence({
-                timestamp: new Date().toISOString(),
-                taskId: slice.taskId,
-                red: slice.redEvidence.exitCode !== 0,
-                green: slice.greenEvidence.exitCode === 0,
-                refactor: slice.refactorEvidence.exitCode === 0,
-                testFirst: slice.redEvidence.exitCode !== 0,
-                testFile: slice.testFile,
-                implFile: slice.implementationFiles[0] ?? '',
-            });
-            writer.updateCurrentState({
-                taskId: slice.taskId,
-                phase: 'verify',
-                artifactsDir: args['artifact-dir'] ? String(args['artifact-dir']).replace(/\\/g, '/') : undefined,
-                filesModified: slice.implementationFiles,
-                openTasks: removeWorkflowOpenTask(writer.readCurrentState()?.openTasks, 'tdd-slice'),
-            });
-            tddStatePath = join(writer.getStateDir(), `tdd-${slice.taskId}.json`);
+        if (args.json) {
+            console.log(JSON.stringify(pack, null, 2));
+            return;
         }
+        console.log('SCALE Context Pack');
+        console.log(`  Task: ${pack.task.task}`);
+        console.log(`  Budget: ${pack.totalEstimatedTokens}/${pack.task.budget}`);
+        for (const section of pack.sections) {
+            console.log(`  [${section.included ? 'IN' : 'OUT'}] ${section.id}: ${section.estimatedTokens} tokens`);
+        }
+    },
+});
+const contextDoctor = defineCommand({
+    meta: { name: 'doctor', description: 'Check context budget thresholds and generated-artifact loading risk' },
+    args: {
+        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' },
+        json: { type: 'boolean', default: false },
+    },
+    run({ args }) {
+        const projectDir = resolve(String(args.dir ?? PROJECT_DIR));
+        const scaleDir = resolveScaleDirForProject(projectDir);
+        const report = doctorContextBudget({
+            projectDir,
+            scaleDir,
+            maxAlwaysTokens: parsePositiveIntArg(args['max-always'], '--max-always'),
+            maxTaskTokens: parsePositiveIntArg(args['max-task'], '--max-task'),
+        });
         if (args.json) {
-            console.log(JSON.stringify({ slice, evaluation, artifactPath, tddStatePath }, null, 2));
+            console.log(JSON.stringify(report, null, 2));
+            if (!report.ok)
+                process.exitCode = 1;
             return;
         }
-        console.log(renderTddSliceMarkdown(slice));
-        if (evaluation.blockers.length > 0) {
-            console.log('\nBlockers:');
-            for (const blocker of evaluation.blockers)
-                console.log(`  - ${blocker}`);
+        console.log(`SCALE Context Doctor: ${report.ok ? 'OK' : 'FAILED'}`);
+        for (const check of report.checks) {
+            console.log(`  [${check.status.toUpperCase()}] ${check.name}: ${check.message}`);
         }
-        if (artifactPath)
-            console.log(`\nArtifact: ${artifactPath}`);
-        if (tddStatePath)
-            console.log(`TDD state: ${tddStatePath}`);
+        if (!report.ok)
+            process.exitCode = 1;
     },
 });
-const tdd = defineCommand({
-    meta: { name: 'tdd', description: 'TDD vertical slice workflows' },
-    subCommands: { slice: tddSliceCommand },
+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 },
 });
 // ============================================================================
-// stats
+// codegraph command - Adapter-first code intelligence
 // ============================================================================
-const stats = defineCommand({
-    meta: { name: 'stats', description: 'Show engine stats' },
-    args: {},
-    async run() {
-        const { store, eventBus } = getEngine();
-        const s = store.stats();
-        const events = await eventBus.query({ limit: 1000 });
-        console.log(JSON.stringify({ ...s, eventCount: events.length }, null, 2));
-    },
-});
-const metricsList = defineCommand({
-    meta: { name: 'list', description: 'List M/L task workflow metrics' },
+const codegraphStatus = defineCommand({
+    meta: { name: 'status', description: 'Inspect CodeGraph, Graphify, and fallback code intelligence providers' },
     args: {
+        dir: { type: 'string', default: PROJECT_DIR, description: 'Project directory' },
         json: { type: 'boolean', default: false },
     },
-    async run({ args }) {
-        const store = new TaskMetricsStore(SCALE_DIR);
-        const records = store.list();
-        const summary = store.summarize();
+    run({ args }) {
+        const projectDir = resolve(String(args.dir ?? PROJECT_DIR));
+        const scaleDir = resolveScaleDirForProject(projectDir);
+        const report = inspectCodeIntelligence({
+            projectDir,
+            scaleDir,
+        });
         if (args.json) {
-            console.log(JSON.stringify({ summary, records }, null, 2));
+            console.log(JSON.stringify(report, null, 2));
             return;
         }
-        console.log('\nWorkflow Metrics');
-        console.log(`  Total tasks: ${summary.total}`);
-        console.log(`  First-pass verification rate: ${(summary.firstPassRate * 100).toFixed(1)}%`);
-        console.log(`  Average fix iterations: ${summary.averageFixIterations.toFixed(2)}`);
-        console.log(`  Artifact completeness: ${(summary.artifactCompletenessRate * 100).toFixed(1)}%`);
-        for (const record of records.slice(-10)) {
-            console.log(`  - ${record.date} ${record.level} ${record.taskName}: ${record.finalGateStatus}`);
+        console.log('SCALE Code Intelligence Status');
+        console.log(`  Config: ${report.configPath} (${report.configExists ? 'found' : 'default'})`);
+        for (const provider of report.providers) {
+            console.log(`  [${provider.available ? 'AVAILABLE' : 'UNAVAILABLE'}] ${provider.id} (${provider.type}): ${provider.reason}`);
         }
+        console.log(`  Fallback: ${report.fallback.available ? 'available' : 'disabled'} (${report.fallback.tools.join(', ')})`);
+        for (const recommendation of report.recommendations)
+            console.log(`  recommendation: ${recommendation}`);
     },
 });
-const metrics = defineCommand({
-    meta: { name: 'metrics', description: 'Inspect workflow task metrics' },
-    subCommands: { list: metricsList },
-});
-function normalizeTaskArtifactLevel(value) {
-    const normalized = String(value ?? 'M').trim().toUpperCase();
-    if (normalized === 'S' || normalized === 'M' || normalized === 'L' || normalized === 'CRITICAL') {
-        return normalized;
-    }
-    throw new Error(`Invalid task level "${String(value)}"; expected S, M, L, or CRITICAL.`);
-}
-const taskArtifactsCheck = defineCommand({
-    meta: { name: 'check', description: 'Check task artifact completeness' },
+const codegraphInit = defineCommand({
+    meta: { name: 'init', description: 'Create .scale/code-intelligence.json provider configuration' },
     args: {
-        dir: { type: 'string', description: 'Task artifact directory; defaults to .scale/state/current.json artifactsDir' },
-        level: { type: 'string', description: 'Task level: S, M, L, or CRITICAL; defaults to current state level or M' },
-        'warn-only': { type: 'boolean', default: false, description: 'Return zero even when artifacts are incomplete' },
+        dir: { type: 'string', default: PROJECT_DIR, description: 'Project directory' },
+        force: { type: 'boolean', default: false, description: 'Overwrite existing configuration' },
         json: { type: 'boolean', default: false },
     },
     run({ args }) {
-        const state = new WorkflowArtifactWriter(SCALE_DIR).readCurrentState();
-        let level;
-        try {
-            level = normalizeTaskArtifactLevel(args.level ?? state?.level ?? 'M');
-        }
-        catch (e) {
-            console.error(e.message);
-            process.exit(1);
-        }
-        const result = checkTaskArtifactCompleteness({
-            projectDir: PROJECT_DIR,
-            artifactsDir: args.dir ?? state?.artifactsDir,
-            level,
-            skillRequiredArtifacts: state?.requiredSkillArtifacts,
+        const projectDir = resolve(String(args.dir ?? PROJECT_DIR));
+        const scaleDir = resolveScaleDirForProject(projectDir);
+        const result = writeCodeIntelligenceConfig({
+            projectDir,
+            scaleDir,
+            force: isTruthyFlag(args.force),
         });
         if (args.json) {
             console.log(JSON.stringify(result, null, 2));
+            return;
         }
-        else {
-            console.log(`\nTask Artifacts: ${result.complete ? 'COMPLETE' : 'INCOMPLETE'}`);
-            if (result.artifactsDir)
-                console.log(`  Directory: ${result.artifactsDir}`);
-            console.log(`  Required: ${result.required.join(', ') || 'none'}`);
-            for (const file of result.missing)
-                console.log(`  [MISSING] ${file}`);
-            for (const item of result.incomplete)
-                console.log(`  [INCOMPLETE] ${item.file}: ${item.reason}`);
-        }
-        if (!result.complete && !args['warn-only'])
-            process.exitCode = 1;
+        console.log(`SCALE Code Intelligence Config: ${result.written ? 'written' : 'exists'}`);
+        console.log(`  ${result.path}`);
     },
 });
-const taskArtifacts = defineCommand({
-    meta: { name: 'task-artifacts', description: 'Inspect task artifact completeness' },
-    subCommands: { check: taskArtifactsCheck },
-});
-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'}`);
-    console.log(`  Root status: ${report.root.clean ? 'clean' : 'dirty'}`);
-    if (!report.root.clean) {
-        console.log(`    staged=${report.root.staged} unstaged=${report.root.unstaged} untracked=${report.root.untracked}`);
-    }
-    if (report.childRepositories.length) {
-        console.log('\n  Child repositories:');
-        for (const child of report.childRepositories) {
-            console.log(`    ${child.clean ? '[CLEAN]' : '[DIRTY]'} ${child.relativePath} (${child.kind}) branch=${child.branch ?? '(detached)'}`);
-            if (!child.clean)
-                console.log(`      staged=${child.staged} unstaged=${child.unstaged} untracked=${child.untracked}`);
+const codegraphQuery = defineCommand({
+    meta: { name: 'query', description: 'Query code intelligence providers, with explicit fallback when graph data is unavailable' },
+    args: {
+        query: { type: 'positional', required: true, description: 'Symbol, function, class, route, or text query' },
+        dir: { type: 'string', default: PROJECT_DIR, description: 'Project directory' },
+        json: { type: 'boolean', default: false },
+    },
+    run({ args }) {
+        const projectDir = resolve(String(args.dir ?? PROJECT_DIR));
+        const scaleDir = resolveScaleDirForProject(projectDir);
+        const report = queryCodeGraph({
+            projectDir,
+            scaleDir,
+            query: String(args.query),
+        });
+        if (args.json) {
+            console.log(JSON.stringify(report, null, 2));
+            return;
         }
-    }
-    else {
-        console.log('\n  Child repositories: none');
-    }
-    console.log(`\n  Cleanup candidate: ${report.finish.canCleanup ? 'yes' : 'no'}`);
-    for (const blocker of report.finish.blockers)
-        console.log(`  [BLOCKER] ${blocker}`);
-    for (const warning of report.finish.warnings)
-        console.log(`  [WARN] ${warning}`);
-    for (const action of report.finish.nextActions)
-        console.log(`  [NEXT] ${action}`);
-}
-function compactList(values, limit = 5) {
-    if (values.length <= limit)
-        return values.join(', ');
-    return `${values.slice(0, limit).join(', ')} (+${values.length - limit} more)`;
-}
-function printWorkspaceSummary(report) {
-    const dirtyChildren = report.childRepositories
-        .filter(child => !child.clean)
-        .map(child => child.relativePath);
-    const unpushedChildren = report.childRepositories
-        .filter(child => child.ahead > 0 || (report.topology.finishPolicy.requirePushedBranches && report.topology.topology === 'moe' && !child.upstream && Boolean(child.branch)))
-        .map(child => child.relativePath);
-    const noUpstreamChildren = report.childRepositories
-        .filter(child => !child.upstream && Boolean(child.branch))
-        .map(child => child.relativePath);
-    const rootStatus = report.root.clean
-        ? 'clean'
-        : `dirty (staged=${report.root.staged}, unstaged=${report.root.unstaged}, untracked=${report.root.untracked})`;
-    const status = report.finish.blockers.length > 0 ? 'BLOCKED' : 'READY';
-    console.log('\nSCALE Workspace Summary');
-    console.log(`  Status: ${status}`);
-    console.log(`  Topology: ${report.topology.topology}${report.topology.configured ? '' : ' (default)'}`);
-    console.log(`  Root: ${rootStatus}`);
-    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)}`);
-    if (unpushedChildren.length > 0)
-        console.log(`  Unpushed child repositories: ${compactList(unpushedChildren)}`);
-    if (report.finish.blockers.length > 0) {
-        console.log('\n  Blockers:');
-        for (const blocker of report.finish.blockers.slice(0, 8))
-            console.log(`    - ${blocker}`);
-        if (report.finish.blockers.length > 8)
-            console.log(`    - ... ${report.finish.blockers.length - 8} more blocker(s)`);
-    }
-    if (report.finish.warnings.length > 0) {
-        console.log(`\n  Warnings: ${report.finish.warnings.length} warning(s); run scale workspace finish --json for details`);
-    }
-    console.log('\n  Next:');
-    const nextActions = report.finish.blockers.length > 0
-        ? report.finish.nextActions
-        : ['Proceed with scale ship <task-id> or cleanup when the branch policy is satisfied'];
-    for (const action of nextActions.slice(0, 3))
-        console.log(`    - ${action}`);
-    console.log('    - Run scale workspace finish --json for full details');
-}
-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:');
-    console.log(`    Mode: ${result.mode}`);
-    console.log(`    Target: ${result.targetPath}`);
-    console.log(`    Can apply: ${result.canApply ? 'yes' : 'no'}`);
-    console.log(`    Applied: ${result.applied ? 'yes' : 'no'}`);
-    console.log(`    Confirmation token: ${result.confirmationToken ?? '(unavailable)'}`);
-    for (const command of result.commands)
-        console.log(`    Command: ${command}`);
-    for (const blocker of result.blockers)
-        console.log(`  [BLOCKER] ${blocker}`);
-    for (const warning of result.warnings)
-        console.log(`  [WARN] ${warning}`);
-}
-const workspaceStatus = defineCommand({
-    meta: { name: 'status', description: 'Inspect root worktree and child repository lifecycle state' },
+        printCodeGraphReport(report);
+    },
+});
+const codegraphImpact = defineCommand({
+    meta: { name: 'impact', description: 'Find likely impacted files for a symbol' },
     args: {
-        dir: { type: 'string', description: 'Repository or worktree directory; defaults to current project directory' },
-        summary: { type: 'boolean', default: false, description: 'Print concise human summary instead of the full repository listing' },
+        symbol: { type: 'string', required: true, description: 'Symbol to analyze' },
+        dir: { type: 'string', default: PROJECT_DIR, description: 'Project directory' },
         json: { type: 'boolean', default: false },
     },
-    async run({ args }) {
-        const report = await inspectWorkspaceLifecycle({ projectDir: args.dir ?? PROJECT_DIR });
+    run({ args }) {
+        const projectDir = resolve(String(args.dir ?? PROJECT_DIR));
+        const scaleDir = resolveScaleDirForProject(projectDir);
+        const report = impactCodeGraph({
+            projectDir,
+            scaleDir,
+            symbol: String(args.symbol),
+        });
         if (args.json) {
             console.log(JSON.stringify(report, null, 2));
+            return;
         }
-        else if (isTruthyFlag(args.summary)) {
-            printWorkspaceSummary(report);
+        printCodeGraphReport(report);
+    },
+});
+const codegraphContext = defineCommand({
+    meta: { name: 'context', description: 'Build a budgeted file context recommendation from code intelligence' },
+    args: {
+        symbol: { type: 'string', required: true, description: 'Symbol to analyze' },
+        budget: { type: 'string', description: 'Maximum estimated tokens for recommended files' },
+        dir: { type: 'string', default: PROJECT_DIR, description: 'Project directory' },
+        json: { type: 'boolean', default: false },
+    },
+    run({ args }) {
+        const projectDir = resolve(String(args.dir ?? PROJECT_DIR));
+        const scaleDir = resolveScaleDirForProject(projectDir);
+        const report = buildCodeGraphContext({
+            projectDir,
+            scaleDir,
+            symbol: String(args.symbol),
+            budget: parsePositiveIntArg(args.budget, '--budget'),
+        });
+        if (args.json) {
+            console.log(JSON.stringify(report, null, 2));
+            return;
         }
-        else {
-            printWorkspaceLifecycle(report);
+        printCodeGraphReport(report);
+        console.log(`  Context budget: ${report.totalEstimatedTokens}/${report.budget}`);
+        for (const file of report.contextFiles) {
+            console.log(`  [${file.included ? 'IN' : 'OUT'}] ${file.path}: ${file.estimatedTokens} tokens`);
         }
-        if (report.finish.blockers.length > 0)
-            process.exitCode = 1;
     },
 });
-const workspaceMap = defineCommand({
-    meta: { name: 'map', description: 'Resolve or write explicit workspace topology for single, monorepo, polyrepo, submodule, or MOE projects' },
+const codegraphRoi = defineCommand({
+    meta: { name: 'roi', description: 'Estimate exploration ROI from code intelligence or fallback query results' },
     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' },
+        query: { type: 'string', description: 'Text query' },
+        symbol: { type: 'string', description: 'Symbol to analyze' },
+        dir: { type: 'string', default: PROJECT_DIR, description: 'Project directory' },
         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.query && !args.symbol)
+            throw new Error('Provide --query or --symbol.');
+        const projectDir = resolve(String(args.dir ?? PROJECT_DIR));
+        const scaleDir = resolveScaleDirForProject(projectDir);
+        const report = createCodeGraphRoiReport({
+            projectDir,
+            scaleDir,
+            query: args.query ? String(args.query) : undefined,
+            symbol: args.symbol ? String(args.symbol) : undefined,
+        });
         if (args.json) {
-            console.log(JSON.stringify(result, null, 2));
-        }
-        else {
-            printWorkspaceTopology(topology, written);
+            console.log(JSON.stringify(report, null, 2));
+            return;
         }
+        console.log('SCALE Code Intelligence ROI');
+        console.log(`  Query: ${report.query}`);
+        console.log(`  Provider: ${report.provider ?? 'fallback'}`);
+        console.log(`  Fallback: ${report.fallbackUsed}`);
+        console.log(`  Graph hits: ${report.metrics.graphHits}`);
+        console.log(`  Reads saved: ${report.metrics.fileReadsSaved}`);
+        console.log(`  Recommendation: ${report.recommendation}`);
     },
 });
-const workspaceFinish = defineCommand({
-    meta: { name: 'finish', description: 'Check whether a temporary worktree can be safely finished or cleaned up' },
+function printCodeGraphReport(report) {
+    console.log('SCALE Code Intelligence');
+    console.log(`  Mode: ${report.mode}`);
+    console.log(`  Query: ${report.query}`);
+    console.log(`  Provider: ${report.provider ?? 'fallback'}`);
+    console.log(`  Fallback used: ${report.fallbackUsed}`);
+    console.log(`  Confidence: ${report.confidence}`);
+    console.log(`  Files: ${report.files.length}`);
+    console.log(`  Estimated reads saved: ${report.roi.fileReadsSaved}`);
+    for (const hit of report.hits.slice(0, 12)) {
+        const line = hit.line ? `:${hit.line}` : '';
+        const symbol = hit.symbol ? ` ${hit.symbol}` : '';
+        console.log(`  - ${hit.file}${line}${symbol} (${hit.reason})`);
+    }
+    for (const warning of report.warnings)
+        console.log(`  warning: ${warning}`);
+}
+const codegraph = defineCommand({
+    meta: { name: 'codegraph', description: 'Adapter-first code intelligence and exploration ROI' },
+    subCommands: { status: codegraphStatus, init: codegraphInit, query: codegraphQuery, impact: codegraphImpact, context: codegraphContext, roi: codegraphRoi },
+});
+// ============================================================================
+// eval command - Workflow eval baseline and failure replay
+// ============================================================================
+const evalInit = defineCommand({
+    meta: { name: 'init', description: 'Create a lightweight workflow eval suite under .scale/evals' },
     args: {
-        dir: { type: 'string', description: 'Repository or worktree directory; defaults to current project directory' },
-        summary: { type: 'boolean', default: false, description: 'Print concise human summary instead of the full repository listing' },
+        dir: { type: 'string', default: PROJECT_DIR, description: 'Project directory' },
+        suite: { type: 'string', default: 'workflow-baseline', description: 'Suite id' },
+        force: { type: 'boolean', default: false, description: 'Overwrite the existing suite file' },
         json: { type: 'boolean', default: false },
     },
-    async run({ args }) {
-        const report = await inspectWorkspaceLifecycle({ projectDir: args.dir ?? PROJECT_DIR });
-        const result = {
-            root: report.root,
-            childRepositories: report.childRepositories,
-            topology: report.topology,
-            finish: report.finish,
-        };
+    run({ args }) {
+        const projectDir = resolve(String(args.dir ?? PROJECT_DIR));
+        const scaleDir = resolveScaleDirForProject(projectDir);
+        const store = new WorkflowEvalStore({
+            projectDir,
+            scaleDir,
+        });
+        const result = store.initSuite(String(args.suite ?? 'workflow-baseline'), isTruthyFlag(args.force));
         if (args.json) {
             console.log(JSON.stringify(result, null, 2));
+            return;
         }
-        else if (isTruthyFlag(args.summary)) {
-            printWorkspaceSummary(report);
-        }
-        else {
-            printWorkspaceLifecycle(report);
-        }
-        if (report.finish.blockers.length > 0)
-            process.exitCode = 1;
+        console.log(`SCALE Workflow Eval Suite: ${result.written ? 'written' : 'exists'}`);
+        console.log(`  Suite: ${result.suite.id}`);
+        console.log(`  Path: ${result.path}`);
+        console.log(`  Cases: ${result.suite.cases.length}`);
     },
 });
-const workspaceCleanup = defineCommand({
-    meta: { name: 'cleanup', description: 'Dry-run or apply safe removal of a linked temporary worktree' },
+const evalRun = defineCommand({
+    meta: { name: 'run', description: 'Run a workflow eval suite and preserve failure replay artifacts' },
     args: {
-        dir: { type: 'string', description: 'Linked worktree directory; defaults to current project directory' },
-        'dry-run': { type: 'boolean', default: false, description: 'Preview cleanup; this is the default unless --apply is set' },
-        apply: { type: 'boolean', default: false, description: 'Actually run git worktree remove after safety checks' },
-        confirm: { type: 'string', description: 'Required confirmation token for --apply, usually the worktree branch name' },
-        summary: { type: 'boolean', default: false, description: 'Print concise human summary before the cleanup plan' },
+        dir: { type: 'string', default: PROJECT_DIR, description: 'Project directory' },
+        suite: { type: 'string', default: 'workflow-baseline', description: 'Suite id or JSON path' },
         json: { type: 'boolean', default: false },
     },
     async run({ args }) {
-        const result = await cleanupWorkspaceLifecycle({
-            projectDir: args.dir ?? PROJECT_DIR,
-            apply: isTruthyFlag(args.apply),
-            confirm: args.confirm,
+        const projectDir = resolve(String(args.dir ?? PROJECT_DIR));
+        const scaleDir = resolveScaleDirForProject(projectDir);
+        const result = await runWorkflowEvalSuite({
+            projectDir,
+            scaleDir,
+            suite: String(args.suite ?? 'workflow-baseline'),
         });
         if (args.json) {
             console.log(JSON.stringify(result, null, 2));
+            if (!result.run.ok)
+                process.exitCode = 1;
+            return;
         }
-        else if (isTruthyFlag(args.summary)) {
-            printWorkspaceSummary(result.report);
-            console.log('\n  Cleanup:');
-            console.log(`    Mode: ${result.mode}`);
-            console.log(`    Can apply: ${result.canApply ? 'yes' : 'no'}`);
-            console.log(`    Applied: ${result.applied ? 'yes' : 'no'}`);
-            console.log(`    Confirmation token: ${result.confirmationToken ?? '(unavailable)'}`);
-        }
-        else {
-            printWorkspaceCleanup(result);
-        }
-        if (!result.canApply || (isTruthyFlag(args.apply) && !result.applied))
+        console.log(`SCALE Workflow Eval: ${result.run.ok ? 'PASS' : 'FAIL'}`);
+        console.log(`  Run: ${result.run.id}`);
+        console.log(`  Suite: ${result.run.suiteId}`);
+        console.log(`  Pass@1: ${(result.run.metrics.passAt1Rate * 100).toFixed(1)}%`);
+        console.log(`  Pass@3: ${(result.run.metrics.passAt3Rate * 100).toFixed(1)}%`);
+        console.log(`  Tool calls: ${result.run.metrics.totalToolCalls}`);
+        console.log(`  Estimated tokens: ${result.run.metrics.estimatedTokens}`);
+        console.log(`  Failures: ${result.run.metrics.failureReplayCount}`);
+        console.log(`  Run path: ${result.runPath}`);
+        for (const failurePath of result.failurePaths)
+            console.log(`  Failure replay: ${failurePath}`);
+        if (!result.run.ok)
             process.exitCode = 1;
     },
 });
-const workspace = defineCommand({
-    meta: { name: 'workspace', description: 'Inspect worktree, branch, and child repository lifecycle safety' },
-    subCommands: {
-        map: workspaceMap,
-        status: workspaceStatus,
-        finish: workspaceFinish,
-        cleanup: workspaceCleanup,
+const evalCompare = defineCommand({
+    meta: { name: 'compare', description: 'Compare two workflow eval runs by pass rate, iterations, tool calls, and token estimate' },
+    args: {
+        dir: { type: 'string', default: PROJECT_DIR, description: 'Project directory' },
+        baseline: { type: 'string', required: true, description: 'Baseline run id or JSON path' },
+        candidate: { type: 'string', required: true, description: 'Candidate run id or JSON path' },
+        json: { type: 'boolean', default: false },
     },
-});
-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' },
+    run({ args }) {
+        const projectDir = resolve(String(args.dir ?? PROJECT_DIR));
+        const scaleDir = resolveScaleDirForProject(projectDir);
+        const comparison = compareWorkflowEvalRuns({
+            projectDir,
+            scaleDir,
+            baseline: String(args.baseline),
+            candidate: String(args.candidate),
+        });
+        if (args.json) {
+            console.log(JSON.stringify(comparison, null, 2));
+            return;
+        }
+        console.log(`SCALE Workflow Eval Compare: ${comparison.recommendation}`);
+        console.log(`  Baseline: ${comparison.baseline.id}`);
+        console.log(`  Candidate: ${comparison.candidate.id}`);
+        console.log(`  Delta Pass@1: ${(comparison.delta.passAt1Rate * 100).toFixed(1)}%`);
+        console.log(`  Delta Pass@3: ${(comparison.delta.passAt3Rate * 100).toFixed(1)}%`);
+        console.log(`  Delta fix iterations: ${comparison.delta.averageFixIterations.toFixed(2)}`);
+        console.log(`  Delta tool calls: ${comparison.delta.totalToolCalls}`);
+        console.log(`  Delta estimated tokens: ${comparison.delta.estimatedTokens}`);
+        console.log(`  Delta human corrections: ${comparison.delta.humanCorrections}`);
+    },
+});
+const evalReport = defineCommand({
+    meta: { name: 'report', description: 'Render a Markdown workflow eval report from a saved run' },
     args: {
-        'build-cmd': { type: 'string', description: 'Override build command' },
-        'lint-cmd': { type: 'string', description: 'Override lint command' },
-        'test-cmd': { type: 'string', description: 'Override test command' },
-        'coverage-cmd': { type: 'string', description: 'Override coverage command' },
-        profile: { type: 'string', description: 'Verification profile from .scale/verification.json' },
-        'preflight-profile': { type: 'string', default: 'quick', description: 'Gate intensity profile (quick/full/ci); quick skips coverage and security' },
-        service: { type: 'string', description: 'Service name from .scale/verification.json; use all for required services' },
-        'tdd-evidence': { type: 'string', description: 'Path to JSON TDD evidence with red/green/refactor/testFirst=true' },
-        'tdd-strict': { type: 'boolean', default: false, description: 'Require TDD evidence before other gates' },
+        dir: { type: 'string', default: PROJECT_DIR, description: 'Project directory' },
+        run: { type: 'string', required: true, description: 'Run id or JSON path' },
+        output: { type: 'string', alias: 'o', description: 'Write report to a Markdown file' },
         json: { type: 'boolean', default: false },
     },
-    async run({ args }) {
-        const { workflowEngine } = getEngine();
-        const preflightProfile = normalizePreflightProfile(args['preflight-profile']);
-        const gateStages = gatesForPreflightProfile(preflightProfile);
-        const resolved = resolveVerificationTargets({
-            projectDir: PROJECT_DIR,
-            scaleDir: SCALE_DIR,
-            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,
-        });
-        const targetResults = [];
-        if (!args.json) {
-            console.log('\nSCALE Preflight');
-            for (const warning of resolved.warnings)
-                console.log(`  [WARN] ${warning}`);
-            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 commandTargetsSkipped ? [] : resolved.targets) {
-            if (!args.json) {
-                const label = target.service ? `${target.service.name} (${target.service.path})` : 'root';
-                console.log(`\n  Target: ${label}`);
-            }
-            const gates = await workflowEngine.verify({
-                cwd: target.config.cwd,
-                build: args['build-cmd'] ?? target.config.build,
-                lint: args['lint-cmd'] ?? target.config.lint,
-                test: args['test-cmd'] ?? target.config.test,
-                coverage: args['coverage-cmd'] ?? target.config.coverage,
-                tddEvidence: args['tdd-evidence'],
-                tddStrict: isTruthyFlag(args['tdd-strict']),
-                gates: gateStages,
-            });
-            const passed = gates.every(gate => gate.passed);
-            targetResults.push({
-                service: target.service?.name,
-                cwd: target.config.cwd ?? PROJECT_DIR,
-                gates,
-                passed,
-            });
-            if (!args.json) {
-                for (const gate of gates) {
-                    console.log(`    ${gate.passed ? '[PASS]' : '[FAIL]'} ${gate.gate}: ${gate.evidence.slice(0, 80)}`);
-                    for (const blocker of gate.blockers)
-                        console.log(`      [BLOCKER] ${blocker.slice(0, 120)}`);
-                }
-            }
+    run({ args }) {
+        const projectDir = resolve(String(args.dir ?? PROJECT_DIR));
+        const scaleDir = resolveScaleDirForProject(projectDir);
+        const store = new WorkflowEvalStore({ projectDir, scaleDir });
+        const run = store.loadRun(String(args.run));
+        const markdown = renderWorkflowEvalReport(run);
+        const outputPath = args.output ? resolve(projectDir, String(args.output)) : undefined;
+        if (outputPath) {
+            mkdirSync(dirname(outputPath), { recursive: true });
+            writeFileSync(outputPath, markdown, 'utf-8');
         }
-        const passed = (targetResults.length === 0 || targetResults.every(target => target.passed)) &&
-            !engineeringStandards.blocked;
-        const result = {
-            phase: 'PREFLIGHT',
-            profile: resolved.profileName,
-            preflightProfile,
-            gates: gateStages,
-            services: targetResults.map(target => target.service).filter(Boolean),
-            policy: resolved.policy,
-            engineeringStandards,
-            targets: targetResults,
-            commandTargetsSkipped,
-            passed,
-        };
         if (args.json) {
-            console.log(JSON.stringify(result, null, 2));
-        }
-        else {
-            console.log(`\nPREFLIGHT: ${passed ? 'PASSED' : 'FAILED'}\n`);
+            console.log(JSON.stringify({ runId: run.id, outputPath, markdown }, null, 2));
+            return;
         }
-        if (!passed)
-            process.exitCode = 1;
+        if (outputPath)
+            console.log(`Workflow eval report written: ${outputPath}`);
+        else
+            console.log(markdown);
     },
 });
-const status = defineCommand({
-    meta: { name: 'status', description: 'Show current SCALE workflow status' },
+const evalFailures = defineCommand({
+    meta: { name: 'failures', description: 'List failure replay records for workflow improvement' },
     args: {
+        dir: { type: 'string', default: PROJECT_DIR, description: 'Project directory' },
+        'task-id': { type: 'string', description: 'Filter by task/case id' },
+        since: { type: 'string', default: '30d', description: 'Window such as 30d; use all for no date filter' },
         json: { type: 'boolean', default: false },
     },
-    async run({ args }) {
-        const { store } = getEngine();
-        const evidenceStore = new EvidenceStore(SCALE_DIR);
-        const reviewStore = new ReviewStore(SCALE_DIR);
-        const [specs, plans, tasks, releases] = await Promise.all([
-            store.query({ type: 'Spec', limit: 1 }),
-            store.query({ type: 'Plan', limit: 1 }),
-            store.query({ type: 'Task', limit: 1 }),
-            store.query({ type: 'Release', limit: 1 }),
-        ]);
-        const latestEvidence = evidenceStore.listGateResults(5);
-        const latestReviews = reviewStore.listReviews(5);
-        const latestTask = tasks[0];
-        const taskPayload = latestTask?.payload;
-        const workflowState = new WorkflowArtifactWriter(SCALE_DIR).readCurrentState();
-        const currentOpenTasks = workflowState?.taskId === latestTask?.id ? workflowState.openTasks ?? [] : [];
-        const nextOpenTask = nextWorkflowOpenTask(currentOpenTasks);
-        const blockers = [];
-        const latestBlockingEvidence = latestEvidence.find(record => !record.passed);
-        const latestBlockingReview = latestReviews.find(record => !record.passed);
-        if (latestBlockingEvidence)
-            blockers.push(`${latestBlockingEvidence.gate}: ${latestBlockingEvidence.blockers.join('; ') || latestBlockingEvidence.status}`);
-        if (latestBlockingReview)
-            blockers.push(`Review ${latestBlockingReview.id}: ${latestBlockingReview.summary.critical} critical, ${latestBlockingReview.summary.high} high`);
-        if (latestTask && (!taskPayload?.verificationEvidenceIds || taskPayload.verificationEvidenceIds.length === 0)) {
-            blockers.push(`Task ${latestTask.id} has no persisted verification evidence`);
-        }
-        if (latestTask?.status === 'COMPLETED' && (!taskPayload?.reviewEvidenceIds || taskPayload.reviewEvidenceIds.length === 0)) {
-            blockers.push(`Task ${latestTask.id} has no persisted review evidence`);
-        }
-        const nextCommand = (() => {
-            if (!specs[0])
-                return 'scale define "<feature>" --description "<what to build>"';
-            if (!plans[0])
-                return `scale plan ${specs[0].id}`;
-            if (!latestTask)
-                return `scale build ${plans[0].id}`;
-            if (nextOpenTask?.kind === 'command')
-                return nextOpenTask.value;
-            if (nextOpenTask?.kind === 'blocker')
-                return `Resolve workflow blocker: ${nextOpenTask.value}`;
-            if (!taskPayload?.verificationEvidenceIds?.length)
-                return `scale verify ${latestTask.id}`;
-            if (latestTask.status !== 'COMPLETED')
-                return `scale verify ${latestTask.id}`;
-            if (!taskPayload.reviewEvidenceIds?.length || taskPayload.reviewPassed !== true)
-                return `scale review ${latestTask.id}`;
-            if (!releases[0])
-                return `scale ship ${latestTask.id}`;
-            return 'scale evidence list';
-        })();
-        const result = {
-            artifacts: {
-                latestSpec: specs[0] ? { id: specs[0].id, status: specs[0].status, title: specs[0].title } : null,
-                latestPlan: plans[0] ? { id: plans[0].id, status: plans[0].status, title: plans[0].title } : null,
-                latestTask: latestTask ? {
-                    id: latestTask.id,
-                    status: latestTask.status,
-                    title: latestTask.title,
-                    lintStatus: taskPayload?.lintStatus,
-                    testPassed: taskPayload?.testPassed,
-                    testCoverage: taskPayload?.testCoverage,
-                    evidenceIds: taskPayload?.verificationEvidenceIds ?? [],
-                    reviewPassed: taskPayload?.reviewPassed,
-                    reviewEvidenceIds: taskPayload?.reviewEvidenceIds ?? [],
-                } : null,
-            },
-            recentEvidence: latestEvidence.map(record => ({
-                id: record.id,
-                gate: record.gate,
-                status: record.status,
-                passed: record.passed,
-                blockers: record.blockers,
-                createdAt: record.createdAt,
-            })),
-            recentReviews: latestReviews.map(record => ({
-                id: record.id,
-                taskId: record.taskId,
-                passed: record.passed,
-                summary: record.summary,
-                createdAt: record.createdAt,
-            })),
-            workflowState: workflowState ? {
-                taskId: workflowState.taskId,
-                level: workflowState.level,
-                phase: workflowState.phase,
-                artifactsDir: workflowState.artifactsDir,
-                openTasks: workflowState.openTasks,
-                skillIntents: workflowState.skillIntents,
-            } : null,
-            blockers,
-            nextCommand,
-        };
+    run({ args }) {
+        const projectDir = resolve(String(args.dir ?? PROJECT_DIR));
+        const scaleDir = resolveScaleDirForProject(projectDir);
+        const store = new WorkflowEvalStore({
+            projectDir,
+            scaleDir,
+        });
+        const failures = store.listFailures({
+            taskId: args['task-id'] ? String(args['task-id']) : undefined,
+            sinceDays: parseSinceDays(args.since),
+        });
         if (args.json) {
-            console.log(JSON.stringify(result, null, 2));
+            console.log(JSON.stringify({ count: failures.length, failures }, null, 2));
             return;
         }
-        console.log('\nSCALE Status');
-        console.log('Artifacts:');
-        console.log(`  Spec: ${result.artifacts.latestSpec ? `${result.artifacts.latestSpec.id} (${result.artifacts.latestSpec.status})` : 'none'}`);
-        console.log(`  Plan: ${result.artifacts.latestPlan ? `${result.artifacts.latestPlan.id} (${result.artifacts.latestPlan.status})` : 'none'}`);
-        console.log(`  Task: ${result.artifacts.latestTask ? `${result.artifacts.latestTask.id} (${result.artifacts.latestTask.status})` : 'none'}`);
-        if (result.artifacts.latestTask?.evidenceIds.length) {
-            console.log(`  Task evidence: ${result.artifacts.latestTask.evidenceIds.join(', ')}`);
-        }
-        console.log('\nRecent Evidence:');
-        if (result.recentEvidence.length === 0) {
-            console.log('  none');
+        console.log(`SCALE Failure Replays: ${failures.length}`);
+        for (const failure of failures) {
+            console.log(`  [${failure.status}] ${failure.id} ${failure.category} task=${failure.taskId}`);
+            console.log(`    prevention: ${failure.prevention}`);
         }
-        else {
-            for (const record of result.recentEvidence) {
-                console.log(`  ${record.id} ${record.gate} ${record.passed ? 'PASS' : record.status}`);
-            }
+    },
+});
+const evalReplay = defineCommand({
+    meta: { name: 'replay', description: 'Show failure replay records by failure id or task id' },
+    args: {
+        id: { type: 'positional', description: 'Failure replay id' },
+        dir: { type: 'string', default: PROJECT_DIR, description: 'Project directory' },
+        'task-id': { type: 'string', description: 'Task/case id to replay' },
+        json: { type: 'boolean', default: false },
+    },
+    run({ args }) {
+        const projectDir = resolve(String(args.dir ?? PROJECT_DIR));
+        const scaleDir = resolveScaleDirForProject(projectDir);
+        const store = new WorkflowEvalStore({
+            projectDir,
+            scaleDir,
+        });
+        const failures = args.id
+            ? [store.getFailure(String(args.id))].filter(Boolean)
+            : store.listFailures({ taskId: args['task-id'] ? String(args['task-id']) : undefined });
+        if (args.json) {
+            console.log(JSON.stringify({ count: failures.length, failures }, null, 2));
+            if (failures.length === 0)
+                process.exitCode = 1;
+            return;
         }
-        if (blockers.length > 0) {
-            console.log('\nBlockers:');
-            for (const blocker of blockers)
-                console.log(`  - ${blocker}`);
+        if (failures.length === 0) {
+            console.log('No failure replay records found.');
+            process.exitCode = 1;
+            return;
         }
-        if (result.workflowState?.openTasks.length) {
-            console.log('\nOpen Tasks:');
-            for (const task of result.workflowState.openTasks)
-                console.log(`  - ${task}`);
+        for (const failure of failures) {
+            if (!failure)
+                continue;
+            console.log(`Failure Replay: ${failure.id}`);
+            console.log(`  Task: ${failure.task}`);
+            console.log(`  Category: ${failure.category}`);
+            console.log(`  Phase: ${failure.phase}`);
+            console.log(`  Wrong turn: ${failure.wrongTurn}`);
+            console.log(`  Evidence: ${failure.evidence}`);
+            console.log(`  Correction: ${failure.correction}`);
+            console.log(`  Prevention: ${failure.prevention}`);
+            if (failure.replayCommand)
+                console.log(`  Replay command: ${failure.replayCommand}`);
         }
-        console.log(`\nNext: ${nextCommand}`);
     },
 });
-// ============================================================================
-// init command
-// ============================================================================
-const init = defineCommand({
-    meta: { name: 'init', description: 'Initialize SCALE Engine in current project (one-click install)' },
+const evalPromoteFailure = defineCommand({
+    meta: { name: 'promote-failure', description: 'Promote a failure replay into a workflow improvement candidate' },
     args: {
-        agent: { type: 'string', default: '', description: `Agent type (${SUPPORTED_AGENTS.join('/')}) - auto-detected if not specified` },
-        dir: { type: 'string', default: '.', description: 'Project directory' },
-        json: { type: 'boolean', default: false, description: 'Output initialization result as JSON' },
-        scenario: { type: 'string', default: 'standard', description: 'Scenario mode (sandbox/standard/critical)' },
-        'governance-pack': {
-            type: 'string',
-            default: 'standard',
-            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' },
-        '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)' },
+        id: { type: 'positional', required: true, description: 'Failure replay id' },
+        dir: { type: 'string', default: PROJECT_DIR, description: 'Project directory' },
+        json: { type: 'boolean', default: false },
     },
-    async run({ args }) {
-        // Interactive configuration mode
-        if (args.interactive) {
-            console.log('\n🔧 SCALE Engine Interactive Configuration\n');
-            console.log('='.repeat(50));
-            // Step 1: Detect and suggest agent platform
-            const detection = detectPlatform(args.dir);
-            console.log('\n📋 Step 1: Agent Platform Selection');
-            console.log(`   Detected suggestions: ${detection.suggestions.join(', ') || 'none'}`);
-            const agentType = args.agent || detection.suggestions[0] || 'claude-code';
-            console.log(`   Using: ${agentType}`);
-            // Step 2: Scenario mode
-            console.log('\n📋 Step 2: Scenario Mode');
-            console.log('   sandbox    - No quality gates (POC/prototype)');
-            console.log('   standard   - Default quality gates');
-            console.log('   critical   - Hardened gates + manual approval');
-            const scenarioMode = args.scenario;
-            console.log(`   Using: ${scenarioMode}`);
-            // Step 3: Quality Gate Thresholds (quantified)
-            console.log('\n📋 Step 3: Quality Gate Thresholds');
-            const coverageThreshold = parseInt(args['coverage-threshold'], 10) || 80;
-            const retryThreshold = parseInt(args['retry-threshold'], 10) || 3;
-            const blockSeverity = args['block-severity'] || 'CRITICAL';
-            console.log(`   Coverage threshold:   ${coverageThreshold}%`);
-            console.log(`   Retry threshold:      ${retryThreshold} (brute retry block)`);
-            console.log(`   Block severity:       ${blockSeverity}`);
-            // Step 4: Write thresholds to .scale/thresholds.json
-            const thresholdsPath = join(args.dir, '.scale', 'thresholds.json');
-            ensureDir(join(args.dir, '.scale'));
-            writeFileSync(thresholdsPath, JSON.stringify({
-                coverage: { minimum: coverageThreshold, unit: 'percent' },
-                retry: { bruteMaximum: retryThreshold, unit: 'count' },
-                severity: { blockLevel: blockSeverity },
-                gates: {
-                    G3_build: { required: scenarioMode !== 'sandbox', exitCode: 0 },
-                    G4_lint: { required: scenarioMode !== 'sandbox', exitCode: 0 },
-                    G5_tests: { required: scenarioMode !== 'sandbox', allPass: true },
-                    G6_coverage: { required: scenarioMode !== 'sandbox', minimum: coverageThreshold },
-                    G7_security: { required: scenarioMode === 'critical', noCritical: true },
-                },
-            }, null, 2));
-            console.log(`\n   ✓ Thresholds written to: ${thresholdsPath}`);
-            // Initialize with adapter
-            const adapter = createAdapter(agentType);
-            const result = await adapter.init({
-                projectDir: args.dir,
-                agentType: agentType,
-                scenarioMode,
-                thresholdsPath,
+    run({ args }) {
+        const projectDir = resolve(String(args.dir ?? PROJECT_DIR));
+        const scaleDir = resolveScaleDirForProject(projectDir);
+        const store = new WorkflowEvalStore({
+            projectDir,
+            scaleDir,
+        });
+        const candidate = store.promoteFailure(String(args.id));
+        if (args.json) {
+            console.log(JSON.stringify(candidate, null, 2));
+            return;
+        }
+        console.log(`Workflow improvement candidate: ${candidate.id}`);
+        console.log(`  Failure: ${candidate.failureId}`);
+        console.log(`  Category: ${candidate.category}`);
+        console.log(`  Recommendation: ${candidate.recommendation}`);
+    },
+});
+function parseSinceDays(value) {
+    const text = String(value ?? '').trim().toLowerCase();
+    if (!text || text === 'all')
+        return undefined;
+    const match = text.match(/^(\d+)(d|day|days)?$/);
+    if (!match)
+        return undefined;
+    const days = Number.parseInt(match[1], 10);
+    return Number.isFinite(days) && days > 0 ? days : undefined;
+}
+const evalCommand = defineCommand({
+    meta: { name: 'eval', description: 'Workflow eval harness, pass@k metrics, and failure replay' },
+    subCommands: {
+        init: evalInit,
+        run: evalRun,
+        compare: evalCompare,
+        report: evalReport,
+        failures: evalFailures,
+        replay: evalReplay,
+        'promote-failure': evalPromoteFailure,
+    },
+});
+// ============================================================================
+// diagnose command - evidence-first debugging loop
+// ============================================================================
+const diagnosePlanCommand = defineCommand({
+    meta: { name: 'plan', description: 'Create a reproducible diagnostic loop before fixing a bug' },
+    args: {
+        'task-id': { type: 'string', required: true },
+        symptom: { type: 'string', required: true },
+        repro: { type: 'string', description: 'Command that reproduces the current failure' },
+        'expected-failure': { type: 'string', description: 'Expected failing behavior or assertion' },
+        files: { type: 'string', description: 'Comma-separated changed or suspicious files' },
+        verify: { type: 'string', description: 'Comma-separated verification commands after the fix' },
+        'artifact-dir': { type: 'string', description: 'Task artifact directory where plan.md should be updated' },
+        write: { type: 'boolean', default: false, description: 'Append diagnostic loop output to the task plan artifact' },
+        json: { type: 'boolean', default: false },
+    },
+    run({ args }) {
+        const changedFiles = parseCommaList(args.files);
+        const loop = createDiagnosticLoop({
+            taskId: String(args['task-id']),
+            symptom: String(args.symptom),
+            reproductionCommand: args.repro ? String(args.repro) : undefined,
+            expectedFailure: args['expected-failure'] ? String(args['expected-failure']) : undefined,
+            changedFiles,
+            verificationCommands: parseCommaList(args.verify),
+        });
+        const validation = validateDiagnosticLoop(loop);
+        const artifactPath = isTruthyFlag(args.write)
+            ? appendDiagnosticLoopArtifact({
+                projectDir: PROJECT_DIR,
+                artifactsDir: args['artifact-dir'] ? String(args['artifact-dir']) : undefined,
+                loop,
+                validation,
+            }) ?? undefined
+            : undefined;
+        if (artifactPath || args['artifact-dir']) {
+            const writer = new WorkflowArtifactWriter(SCALE_DIR);
+            const current = writer.readCurrentState();
+            const currentOpenTasks = current?.taskId === loop.taskId ? current.openTasks : [];
+            writer.updateCurrentState({
+                taskId: loop.taskId,
+                phase: 'plan',
+                artifactsDir: args['artifact-dir'] ? String(args['artifact-dir']).replace(/\\/g, '/') : undefined,
+                filesModified: changedFiles,
+                openTasks: validation.ready
+                    ? removeWorkflowOpenTask(currentOpenTasks.filter(task => task.trim().startsWith('scale ')), 'diagnostic-loop')
+                    : uniqueStrings([
+                        ...currentOpenTasks,
+                        ...validation.blockers,
+                    ]),
             });
-            const projectName = args.dir.split(/[/\\]/).pop() || 'Project';
-            const governance = writeGovernanceTemplates(args.dir, {
-                mode: governanceModeFromScenario(scenarioMode),
-                projectName,
-                pack: args['governance-pack'],
+        }
+        if (args.json) {
+            console.log(JSON.stringify({ loop, validation, artifactPath }, null, 2));
+            return;
+        }
+        console.log(renderDiagnosticLoopMarkdown(loop));
+        if (!validation.ready) {
+            console.log('\nBlockers:');
+            for (const blocker of validation.blockers)
+                console.log(`  - ${blocker}`);
+        }
+        if (artifactPath)
+            console.log(`\nArtifact: ${artifactPath}`);
+    },
+});
+const diagnose = defineCommand({
+    meta: { name: 'diagnose', description: 'Evidence-first debugging workflows' },
+    subCommands: { plan: diagnosePlanCommand },
+});
+// ============================================================================
+// tdd command - vertical slice RED/GREEN/REFACTOR loop
+// ============================================================================
+const tddSliceCommand = defineCommand({
+    meta: { name: 'slice', description: 'Create and evaluate a TDD vertical slice' },
+    args: {
+        'task-id': { type: 'string', required: true },
+        behavior: { type: 'string', required: true },
+        'public-interface': { type: 'string', required: true },
+        'failing-test': { type: 'string', required: true },
+        'test-file': { type: 'string', required: true },
+        'impl-files': { type: 'string', required: true },
+        'red-exit-code': { type: 'string', description: 'Exit code from the RED command' },
+        'red-summary': { type: 'string', description: 'Short RED output summary' },
+        'green-exit-code': { type: 'string', description: 'Exit code from the GREEN command' },
+        'green-summary': { type: 'string', description: 'Short GREEN output summary' },
+        'refactor-exit-code': { type: 'string', description: 'Exit code from the REFACTOR command' },
+        'refactor-summary': { type: 'string', description: 'Short REFACTOR output summary' },
+        'artifact-dir': { type: 'string', description: 'Task artifact directory where verification.md should be updated' },
+        write: { type: 'boolean', default: false, description: 'Append TDD slice output to the task verification artifact' },
+        json: { type: 'boolean', default: false },
+    },
+    run({ args }) {
+        const failingTest = String(args['failing-test']);
+        const slice = createTddSlice({
+            taskId: String(args['task-id']),
+            behavior: String(args.behavior),
+            publicInterface: String(args['public-interface']),
+            failingTestCommand: failingTest,
+            testFile: String(args['test-file']),
+            implementationFiles: parseCommaList(args['impl-files']),
+            redEvidence: commandEvidence(failingTest, args['red-exit-code'], args['red-summary']),
+            greenEvidence: commandEvidence(failingTest, args['green-exit-code'], args['green-summary']),
+            refactorEvidence: commandEvidence(failingTest, args['refactor-exit-code'], args['refactor-summary']),
+        });
+        const evaluation = evaluateTddSlice(slice);
+        const artifactPath = isTruthyFlag(args.write)
+            ? appendTddSliceArtifact({
+                projectDir: PROJECT_DIR,
+                artifactsDir: args['artifact-dir'] ? String(args['artifact-dir']) : undefined,
+                slice,
+            }) ?? undefined
+            : undefined;
+        let tddStatePath;
+        if (slice.redEvidence && slice.greenEvidence && slice.refactorEvidence) {
+            const writer = new WorkflowArtifactWriter(SCALE_DIR);
+            writer.writeTDDEvidence({
+                timestamp: new Date().toISOString(),
+                taskId: slice.taskId,
+                red: slice.redEvidence.exitCode !== 0,
+                green: slice.greenEvidence.exitCode === 0,
+                refactor: slice.refactorEvidence.exitCode === 0,
+                testFirst: slice.redEvidence.exitCode !== 0,
+                testFile: slice.testFile,
+                implFile: slice.implementationFiles[0] ?? '',
             });
-            result.created.push(...governance.created);
-            result.skipped.push(...governance.skipped);
-            console.log(`\n✅ SCALE Engine initialized for ${agentType} (interactive mode)`);
-            console.log(`\n📁 Created:`);
-            for (const f of result.created)
-                console.log(`   + ${f}`);
-            if (result.skipped.length > 0) {
-                console.log(`\n⏭️  Skipped (already exist):`);
-                for (const f of result.skipped)
-                    console.log(`   - ${f}`);
-            }
-            console.log(`\n🔧 Configuration Summary:`);
-            console.log(`   Settings:      ${result.settingsPath}`);
-            console.log(`   Knowledge:     ${result.knowledgeDocPath}`);
-            console.log(`   Thresholds:    ${thresholdsPath}`);
-            console.log(`   Data dir:      ${result.scaleDir}`);
-            console.log(`   Scenario:      ${scenarioMode}`);
-            console.log(`\n📋 Next steps:`);
-            console.log(`   → scale doctor`);
-            console.log(`   → scale create Spec "<feature name>"`);
+            writer.updateCurrentState({
+                taskId: slice.taskId,
+                phase: 'verify',
+                artifactsDir: args['artifact-dir'] ? String(args['artifact-dir']).replace(/\\/g, '/') : undefined,
+                filesModified: slice.implementationFiles,
+                openTasks: removeWorkflowOpenTask(writer.readCurrentState()?.openTasks, 'tdd-slice'),
+            });
+            tddStatePath = join(writer.getStateDir(), `tdd-${slice.taskId}.json`);
+        }
+        if (args.json) {
+            console.log(JSON.stringify({ slice, evaluation, artifactPath, tddStatePath }, null, 2));
+            return;
+        }
+        console.log(renderTddSliceMarkdown(slice));
+        if (evaluation.blockers.length > 0) {
+            console.log('\nBlockers:');
+            for (const blocker of evaluation.blockers)
+                console.log(`  - ${blocker}`);
+        }
+        if (artifactPath)
+            console.log(`\nArtifact: ${artifactPath}`);
+        if (tddStatePath)
+            console.log(`TDD state: ${tddStatePath}`);
+    },
+});
+const tdd = defineCommand({
+    meta: { name: 'tdd', description: 'TDD vertical slice workflows' },
+    subCommands: { slice: tddSliceCommand },
+});
+// ============================================================================
+// stats
+// ============================================================================
+const stats = defineCommand({
+    meta: { name: 'stats', description: 'Show engine stats' },
+    args: {},
+    async run() {
+        const { store, eventBus } = getEngine();
+        const s = store.stats();
+        const events = await eventBus.query({ limit: 1000 });
+        console.log(JSON.stringify({ ...s, eventCount: events.length }, null, 2));
+    },
+});
+const metricsList = defineCommand({
+    meta: { name: 'list', description: 'List M/L task workflow metrics' },
+    args: {
+        json: { type: 'boolean', default: false },
+    },
+    async run({ args }) {
+        const store = new TaskMetricsStore(SCALE_DIR);
+        const records = store.list();
+        const summary = store.summarize();
+        if (args.json) {
+            console.log(JSON.stringify({ summary, records }, null, 2));
+            return;
+        }
+        console.log('\nWorkflow Metrics');
+        console.log(`  Total tasks: ${summary.total}`);
+        console.log(`  First-pass verification rate: ${(summary.firstPassRate * 100).toFixed(1)}%`);
+        console.log(`  Average fix iterations: ${summary.averageFixIterations.toFixed(2)}`);
+        console.log(`  Artifact completeness: ${(summary.artifactCompletenessRate * 100).toFixed(1)}%`);
+        for (const record of records.slice(-10)) {
+            console.log(`  - ${record.date} ${record.level} ${record.taskName}: ${record.finalGateStatus}`);
+        }
+    },
+});
+const metrics = defineCommand({
+    meta: { name: 'metrics', description: 'Inspect workflow task metrics' },
+    subCommands: { list: metricsList },
+});
+function normalizeTaskArtifactLevel(value) {
+    const normalized = String(value ?? 'M').trim().toUpperCase();
+    if (normalized === 'S' || normalized === 'M' || normalized === 'L' || normalized === 'CRITICAL') {
+        return normalized;
+    }
+    throw new Error(`Invalid task level "${String(value)}"; expected S, M, L, or CRITICAL.`);
+}
+const taskArtifactsCheck = defineCommand({
+    meta: { name: 'check', description: 'Check task artifact completeness' },
+    args: {
+        dir: { type: 'string', description: 'Task artifact directory; defaults to .scale/state/current.json artifactsDir' },
+        level: { type: 'string', description: 'Task level: S, M, L, or CRITICAL; defaults to current state level or M' },
+        'warn-only': { type: 'boolean', default: false, description: 'Return zero even when artifacts are incomplete' },
+        json: { type: 'boolean', default: false },
+    },
+    run({ args }) {
+        const state = new WorkflowArtifactWriter(SCALE_DIR).readCurrentState();
+        let level;
+        try {
+            level = normalizeTaskArtifactLevel(args.level ?? state?.level ?? 'M');
+        }
+        catch (e) {
+            console.error(e.message);
+            process.exit(1);
+        }
+        const result = checkTaskArtifactCompleteness({
+            projectDir: PROJECT_DIR,
+            artifactsDir: args.dir ?? state?.artifactsDir,
+            level,
+            skillRequiredArtifacts: state?.requiredSkillArtifacts,
+        });
+        if (args.json) {
+            console.log(JSON.stringify(result, null, 2));
+        }
+        else {
+            console.log(`\nTask Artifacts: ${result.complete ? 'COMPLETE' : 'INCOMPLETE'}`);
+            if (result.artifactsDir)
+                console.log(`  Directory: ${result.artifactsDir}`);
+            console.log(`  Required: ${result.required.join(', ') || 'none'}`);
+            for (const file of result.missing)
+                console.log(`  [MISSING] ${file}`);
+            for (const item of result.incomplete)
+                console.log(`  [INCOMPLETE] ${item.file}: ${item.reason}`);
+        }
+        if (!result.complete && !args['warn-only'])
+            process.exitCode = 1;
+    },
+});
+const taskArtifacts = defineCommand({
+    meta: { name: 'task-artifacts', description: 'Inspect task artifact completeness' },
+    subCommands: { check: taskArtifactsCheck },
+});
+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'}`);
+    console.log(`  Root status: ${report.root.clean ? 'clean' : 'dirty'}`);
+    if (!report.root.clean) {
+        console.log(`    staged=${report.root.staged} unstaged=${report.root.unstaged} untracked=${report.root.untracked}`);
+    }
+    if (report.childRepositories.length) {
+        console.log('\n  Child repositories:');
+        for (const child of report.childRepositories) {
+            console.log(`    ${child.clean ? '[CLEAN]' : '[DIRTY]'} ${child.relativePath} (${child.kind}) branch=${child.branch ?? '(detached)'}`);
+            if (!child.clean)
+                console.log(`      staged=${child.staged} unstaged=${child.unstaged} untracked=${child.untracked}`);
+        }
+    }
+    else {
+        console.log('\n  Child repositories: none');
+    }
+    console.log(`\n  Cleanup candidate: ${report.finish.canCleanup ? 'yes' : 'no'}`);
+    for (const blocker of report.finish.blockers)
+        console.log(`  [BLOCKER] ${blocker}`);
+    for (const warning of report.finish.warnings)
+        console.log(`  [WARN] ${warning}`);
+    for (const action of report.finish.nextActions)
+        console.log(`  [NEXT] ${action}`);
+}
+function compactList(values, limit = 5) {
+    if (values.length <= limit)
+        return values.join(', ');
+    return `${values.slice(0, limit).join(', ')} (+${values.length - limit} more)`;
+}
+function printWorkspaceSummary(report) {
+    const dirtyChildren = report.childRepositories
+        .filter(child => !child.clean)
+        .map(child => child.relativePath);
+    const unpushedChildren = report.childRepositories
+        .filter(child => child.ahead > 0 || (report.topology.finishPolicy.requirePushedBranches && report.topology.topology === 'moe' && !child.upstream && Boolean(child.branch)))
+        .map(child => child.relativePath);
+    const noUpstreamChildren = report.childRepositories
+        .filter(child => !child.upstream && Boolean(child.branch))
+        .map(child => child.relativePath);
+    const rootStatus = report.root.clean
+        ? 'clean'
+        : `dirty (staged=${report.root.staged}, unstaged=${report.root.unstaged}, untracked=${report.root.untracked})`;
+    const status = report.finish.blockers.length > 0 ? 'BLOCKED' : 'READY';
+    console.log('\nSCALE Workspace Summary');
+    console.log(`  Status: ${status}`);
+    console.log(`  Topology: ${report.topology.topology}${report.topology.configured ? '' : ' (default)'}`);
+    console.log(`  Root: ${rootStatus}`);
+    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)}`);
+    if (unpushedChildren.length > 0)
+        console.log(`  Unpushed child repositories: ${compactList(unpushedChildren)}`);
+    if (report.finish.blockers.length > 0) {
+        console.log('\n  Blockers:');
+        for (const blocker of report.finish.blockers.slice(0, 8))
+            console.log(`    - ${blocker}`);
+        if (report.finish.blockers.length > 8)
+            console.log(`    - ... ${report.finish.blockers.length - 8} more blocker(s)`);
+    }
+    if (report.finish.warnings.length > 0) {
+        console.log(`\n  Warnings: ${report.finish.warnings.length} warning(s); run scale workspace finish --json for details`);
+    }
+    console.log('\n  Next:');
+    const nextActions = report.finish.blockers.length > 0
+        ? report.finish.nextActions
+        : ['Proceed with scale ship <task-id> or cleanup when the branch policy is satisfied'];
+    for (const action of nextActions.slice(0, 3))
+        console.log(`    - ${action}`);
+    console.log('    - Run scale workspace finish --json for full details');
+}
+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:');
+    console.log(`    Mode: ${result.mode}`);
+    console.log(`    Target: ${result.targetPath}`);
+    console.log(`    Can apply: ${result.canApply ? 'yes' : 'no'}`);
+    console.log(`    Applied: ${result.applied ? 'yes' : 'no'}`);
+    console.log(`    Confirmation token: ${result.confirmationToken ?? '(unavailable)'}`);
+    for (const command of result.commands)
+        console.log(`    Command: ${command}`);
+    for (const blocker of result.blockers)
+        console.log(`  [BLOCKER] ${blocker}`);
+    for (const warning of result.warnings)
+        console.log(`  [WARN] ${warning}`);
+}
+const workspaceStatus = defineCommand({
+    meta: { name: 'status', description: 'Inspect root worktree and child repository lifecycle state' },
+    args: {
+        dir: { type: 'string', description: 'Repository or worktree directory; defaults to current project directory' },
+        summary: { type: 'boolean', default: false, description: 'Print concise human summary instead of the full repository listing' },
+        json: { type: 'boolean', default: false },
+    },
+    async run({ args }) {
+        const report = await inspectWorkspaceLifecycle({ projectDir: args.dir ?? PROJECT_DIR });
+        if (args.json) {
+            console.log(JSON.stringify(report, null, 2));
+        }
+        else if (isTruthyFlag(args.summary)) {
+            printWorkspaceSummary(report);
+        }
+        else {
+            printWorkspaceLifecycle(report);
+        }
+        if (report.finish.blockers.length > 0)
+            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: {
+        dir: { type: 'string', description: 'Repository or worktree directory; defaults to current project directory' },
+        summary: { type: 'boolean', default: false, description: 'Print concise human summary instead of the full repository listing' },
+        json: { type: 'boolean', default: false },
+    },
+    async run({ args }) {
+        const report = await inspectWorkspaceLifecycle({ projectDir: args.dir ?? PROJECT_DIR });
+        const result = {
+            root: report.root,
+            childRepositories: report.childRepositories,
+            topology: report.topology,
+            finish: report.finish,
+        };
+        if (args.json) {
+            console.log(JSON.stringify(result, null, 2));
+        }
+        else if (isTruthyFlag(args.summary)) {
+            printWorkspaceSummary(report);
+        }
+        else {
+            printWorkspaceLifecycle(report);
+        }
+        if (report.finish.blockers.length > 0)
+            process.exitCode = 1;
+    },
+});
+const workspaceCleanup = defineCommand({
+    meta: { name: 'cleanup', description: 'Dry-run or apply safe removal of a linked temporary worktree' },
+    args: {
+        dir: { type: 'string', description: 'Linked worktree directory; defaults to current project directory' },
+        'dry-run': { type: 'boolean', default: false, description: 'Preview cleanup; this is the default unless --apply is set' },
+        apply: { type: 'boolean', default: false, description: 'Actually run git worktree remove after safety checks' },
+        confirm: { type: 'string', description: 'Required confirmation token for --apply, usually the worktree branch name' },
+        summary: { type: 'boolean', default: false, description: 'Print concise human summary before the cleanup plan' },
+        json: { type: 'boolean', default: false },
+    },
+    async run({ args }) {
+        const result = await cleanupWorkspaceLifecycle({
+            projectDir: args.dir ?? PROJECT_DIR,
+            apply: isTruthyFlag(args.apply),
+            confirm: args.confirm,
+        });
+        if (args.json) {
+            console.log(JSON.stringify(result, null, 2));
+        }
+        else if (isTruthyFlag(args.summary)) {
+            printWorkspaceSummary(result.report);
+            console.log('\n  Cleanup:');
+            console.log(`    Mode: ${result.mode}`);
+            console.log(`    Can apply: ${result.canApply ? 'yes' : 'no'}`);
+            console.log(`    Applied: ${result.applied ? 'yes' : 'no'}`);
+            console.log(`    Confirmation token: ${result.confirmationToken ?? '(unavailable)'}`);
+        }
+        else {
+            printWorkspaceCleanup(result);
+        }
+        if (!result.canApply || (isTruthyFlag(args.apply) && !result.applied))
+            process.exitCode = 1;
+    },
+});
+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: {
+        dir: { type: 'string', default: PROJECT_DIR, description: 'Project directory' },
+        'build-cmd': { type: 'string', description: 'Override build command' },
+        'lint-cmd': { type: 'string', description: 'Override lint command' },
+        'test-cmd': { type: 'string', description: 'Override test command' },
+        'coverage-cmd': { type: 'string', description: 'Override coverage command' },
+        profile: { type: 'string', description: 'Verification profile from .scale/verification.json' },
+        'preflight-profile': { type: 'string', default: 'quick', description: 'Gate intensity profile (quick/full/ci); quick skips coverage and security' },
+        service: { type: 'string', description: 'Service name from .scale/verification.json; use all for required services' },
+        'tdd-evidence': { type: 'string', description: 'Path to JSON TDD evidence with red/green/refactor/testFirst=true' },
+        'tdd-strict': { type: 'boolean', default: false, description: 'Require TDD evidence before other gates' },
+        json: { type: 'boolean', default: false },
+    },
+    async run({ args }) {
+        const projectDir = resolve(String(args.dir ?? PROJECT_DIR));
+        const scaleDir = resolveScaleDirForProject(projectDir);
+        const workflowEngine = createVerificationWorkflowEngine(scaleDir);
+        const preflightProfile = normalizePreflightProfile(args['preflight-profile']);
+        const resolved = resolveVerificationTargets({
+            projectDir,
+            scaleDir,
+            profile: args.profile,
+            service: args.service,
+        });
+        let gateStages = gatesForPreflightProfile(preflightProfile);
+        if (resolved.targets.some(target => target.config.smoke)) {
+            gateStages = ['G8'];
+        }
+        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 workspaceSafety = inspectWorkspaceSafety(projectDir);
+        const engineeringStandards = workspaceSafety.blocked
+            ? skippedEngineeringStandardsGate('Workspace has unresolved git conflicts; resolve them before standards scanning.', resolved.policy)
+            : evaluateEngineeringStandardsGate({
+                policy: resolved.policy,
+                projectDir,
+                scaleDir,
+            });
+        const targetResults = [];
+        if (!args.json) {
+            console.log('\nSCALE Preflight');
+            for (const warning of resolved.warnings)
+                console.log(`  [WARN] ${warning}`);
+            console.log(`  Profile: ${resolved.profileName}`);
+            console.log(`  Preflight profile: ${preflightProfile}`);
+            console.log(`  Gates: ${gateStages.join(', ')}`);
+            if (workspaceSafety.blocked) {
+                console.log(`  Workspace safety: BLOCKED - ${workspaceSafety.message}`);
+            }
+            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 commandTargetsSkipped || workspaceSafety.blocked ? [] : resolved.targets) {
+            if (!args.json) {
+                const label = target.service ? `${target.service.name} (${target.service.path})` : 'root';
+                console.log(`\n  Target: ${label}`);
+            }
+            const gates = await workflowEngine.verify({
+                cwd: target.config.cwd,
+                build: args['build-cmd'] ?? target.config.build,
+                lint: args['lint-cmd'] ?? target.config.lint,
+                test: args['test-cmd'] ?? target.config.test,
+                coverage: args['coverage-cmd'] ?? target.config.coverage,
+                smoke: target.config.smoke,
+                runtimeEvidence: {
+                    projectDir,
+                    scaleDir,
+                    profile: resolved.profileName,
+                },
+                tddEvidence: args['tdd-evidence'],
+                tddStrict: isTruthyFlag(args['tdd-strict']),
+                gates: gateStages,
+            });
+            const passed = gates.every(gate => gate.passed);
+            targetResults.push({
+                service: target.service?.name,
+                cwd: target.config.cwd ?? projectDir,
+                gates,
+                passed,
+            });
+            if (!args.json) {
+                for (const gate of gates) {
+                    console.log(`    ${gate.passed ? '[PASS]' : '[FAIL]'} ${gate.gate}: ${gate.evidence.slice(0, 80)}`);
+                    for (const blocker of gate.blockers)
+                        console.log(`      [BLOCKER] ${blocker.slice(0, 120)}`);
+                }
+            }
+        }
+        const passed = (targetResults.length === 0 || targetResults.every(target => target.passed)) &&
+            !workspaceSafety.blocked &&
+            !engineeringStandards.blocked;
+        const result = {
+            phase: 'PREFLIGHT',
+            profile: resolved.profileName,
+            preflightProfile,
+            gates: gateStages,
+            services: targetResults.map(target => target.service).filter(Boolean),
+            policy: resolved.policy,
+            workspaceSafety,
+            engineeringStandards,
+            targets: targetResults,
+            commandTargetsSkipped,
+            passed,
+        };
+        if (args.json) {
+            console.log(JSON.stringify(result, null, 2));
+        }
+        else {
+            console.log(`\nPREFLIGHT: ${passed ? 'PASSED' : 'FAILED'}\n`);
+        }
+        if (!passed)
+            process.exitCode = 1;
+    },
+});
+const status = defineCommand({
+    meta: { name: 'status', description: 'Show current SCALE workflow status' },
+    args: {
+        json: { type: 'boolean', default: false },
+    },
+    async run({ args }) {
+        const { store } = getEngine();
+        const evidenceStore = new EvidenceStore(SCALE_DIR);
+        const reviewStore = new ReviewStore(SCALE_DIR);
+        const [specs, plans, tasks, releases] = await Promise.all([
+            store.query({ type: 'Spec', limit: 1 }),
+            store.query({ type: 'Plan', limit: 1 }),
+            store.query({ type: 'Task', limit: 1 }),
+            store.query({ type: 'Release', limit: 1 }),
+        ]);
+        const latestEvidence = evidenceStore.listGateResults(5);
+        const latestReviews = reviewStore.listReviews(5);
+        const latestTask = tasks[0];
+        const taskPayload = latestTask?.payload;
+        const workflowState = new WorkflowArtifactWriter(SCALE_DIR).readCurrentState();
+        const currentOpenTasks = workflowState?.openTasks ?? [];
+        const nextOpenTask = nextWorkflowOpenTask(currentOpenTasks);
+        const blockers = [];
+        const latestBlockingEvidence = latestEvidence.find(record => !record.passed);
+        const latestBlockingReview = latestReviews.find(record => !record.passed);
+        if (latestBlockingEvidence)
+            blockers.push(`${latestBlockingEvidence.gate}: ${latestBlockingEvidence.blockers.join('; ') || latestBlockingEvidence.status}`);
+        if (latestBlockingReview)
+            blockers.push(`Review ${latestBlockingReview.id}: ${latestBlockingReview.summary.critical} critical, ${latestBlockingReview.summary.high} high`);
+        if (latestTask && (!taskPayload?.verificationEvidenceIds || taskPayload.verificationEvidenceIds.length === 0)) {
+            blockers.push(`Task ${latestTask.id} has no persisted verification evidence`);
+        }
+        if (latestTask?.status === 'COMPLETED' && (!taskPayload?.reviewEvidenceIds || taskPayload.reviewEvidenceIds.length === 0)) {
+            blockers.push(`Task ${latestTask.id} has no persisted review evidence`);
+        }
+        const nextCommand = (() => {
+            if (nextOpenTask?.kind === 'command')
+                return nextOpenTask.value;
+            if (nextOpenTask?.kind === 'blocker')
+                return `Resolve workflow blocker: ${nextOpenTask.value}`;
+            if (!specs[0])
+                return 'scale define "<feature>" --description "<what to build>"';
+            if (!plans[0])
+                return `scale plan ${specs[0].id}`;
+            if (!latestTask)
+                return `scale build ${plans[0].id}`;
+            if (!taskPayload?.verificationEvidenceIds?.length)
+                return `scale verify ${latestTask.id}`;
+            if (latestTask.status !== 'COMPLETED')
+                return `scale verify ${latestTask.id}`;
+            if (!taskPayload.reviewEvidenceIds?.length || taskPayload.reviewPassed !== true)
+                return `scale review ${latestTask.id}`;
+            if (!releases[0])
+                return `scale ship ${latestTask.id}`;
+            return 'scale evidence list';
+        })();
+        const result = {
+            artifacts: {
+                latestSpec: specs[0] ? { id: specs[0].id, status: specs[0].status, title: specs[0].title } : null,
+                latestPlan: plans[0] ? { id: plans[0].id, status: plans[0].status, title: plans[0].title } : null,
+                latestTask: latestTask ? {
+                    id: latestTask.id,
+                    status: latestTask.status,
+                    title: latestTask.title,
+                    lintStatus: taskPayload?.lintStatus,
+                    testPassed: taskPayload?.testPassed,
+                    testCoverage: taskPayload?.testCoverage,
+                    evidenceIds: taskPayload?.verificationEvidenceIds ?? [],
+                    reviewPassed: taskPayload?.reviewPassed,
+                    reviewEvidenceIds: taskPayload?.reviewEvidenceIds ?? [],
+                } : null,
+            },
+            recentEvidence: latestEvidence.map(record => ({
+                id: record.id,
+                gate: record.gate,
+                status: record.status,
+                passed: record.passed,
+                blockers: record.blockers,
+                createdAt: record.createdAt,
+            })),
+            recentReviews: latestReviews.map(record => ({
+                id: record.id,
+                taskId: record.taskId,
+                passed: record.passed,
+                summary: record.summary,
+                createdAt: record.createdAt,
+            })),
+            workflowState: workflowState ? {
+                taskId: workflowState.taskId,
+                level: workflowState.level,
+                phase: workflowState.phase,
+                artifactsDir: workflowState.artifactsDir,
+                openTasks: workflowState.openTasks ?? [],
+                skillIntents: workflowState.skillIntents,
+            } : null,
+            blockers,
+            nextCommand,
+        };
+        if (args.json) {
+            console.log(JSON.stringify(result, null, 2));
+            return;
+        }
+        console.log('\nSCALE Status');
+        console.log('Artifacts:');
+        console.log(`  Spec: ${result.artifacts.latestSpec ? `${result.artifacts.latestSpec.id} (${result.artifacts.latestSpec.status})` : 'none'}`);
+        console.log(`  Plan: ${result.artifacts.latestPlan ? `${result.artifacts.latestPlan.id} (${result.artifacts.latestPlan.status})` : 'none'}`);
+        console.log(`  Task: ${result.artifacts.latestTask ? `${result.artifacts.latestTask.id} (${result.artifacts.latestTask.status})` : 'none'}`);
+        if (result.artifacts.latestTask?.evidenceIds.length) {
+            console.log(`  Task evidence: ${result.artifacts.latestTask.evidenceIds.join(', ')}`);
+        }
+        console.log('\nRecent Evidence:');
+        if (result.recentEvidence.length === 0) {
+            console.log('  none');
+        }
+        else {
+            for (const record of result.recentEvidence) {
+                console.log(`  ${record.id} ${record.gate} ${record.passed ? 'PASS' : record.status}`);
+            }
+        }
+        if (blockers.length > 0) {
+            console.log('\nBlockers:');
+            for (const blocker of blockers)
+                console.log(`  - ${blocker}`);
+        }
+        if ((result.workflowState?.openTasks.length ?? 0) > 0) {
+            console.log('\nOpen Tasks:');
+            for (const task of result.workflowState.openTasks)
+                console.log(`  - ${task}`);
+        }
+        console.log(`\nNext: ${nextCommand}`);
+    },
+});
+// ============================================================================
+// init command
+// ============================================================================
+const init = defineCommand({
+    meta: { name: 'init', description: 'Initialize SCALE Engine in current project (one-click install)' },
+    args: {
+        agent: { type: 'string', default: '', description: `Agent type (${SUPPORTED_AGENTS.join('/')}) - auto-detected if not specified` },
+        dir: { type: 'string', default: '.', description: 'Project directory' },
+        json: { type: 'boolean', default: false, description: 'Output initialization result as JSON' },
+        scenario: { type: 'string', default: 'standard', description: 'Scenario mode (sandbox/standard/critical)' },
+        'governance-pack': {
+            type: 'string',
+            default: 'standard',
+            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' },
+        '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)' },
+    },
+    async run({ args }) {
+        // Interactive configuration mode
+        if (args.interactive) {
+            console.log('\n🔧 SCALE Engine Interactive Configuration\n');
+            console.log('='.repeat(50));
+            // Step 1: Detect and suggest agent platform
+            const detection = detectPlatform(args.dir);
+            console.log('\n📋 Step 1: Agent Platform Selection');
+            console.log(`   Detected suggestions: ${detection.suggestions.join(', ') || 'none'}`);
+            const agentType = args.agent || detection.suggestions[0] || 'claude-code';
+            console.log(`   Using: ${agentType}`);
+            // Step 2: Scenario mode
+            console.log('\n📋 Step 2: Scenario Mode');
+            console.log('   sandbox    - No quality gates (POC/prototype)');
+            console.log('   standard   - Default quality gates');
+            console.log('   critical   - Hardened gates + manual approval');
+            const scenarioMode = args.scenario;
+            console.log(`   Using: ${scenarioMode}`);
+            // Step 3: Quality Gate Thresholds (quantified)
+            console.log('\n📋 Step 3: Quality Gate Thresholds');
+            const coverageThreshold = parseInt(args['coverage-threshold'], 10) || 80;
+            const retryThreshold = parseInt(args['retry-threshold'], 10) || 3;
+            const blockSeverity = args['block-severity'] || 'CRITICAL';
+            console.log(`   Coverage threshold:   ${coverageThreshold}%`);
+            console.log(`   Retry threshold:      ${retryThreshold} (brute retry block)`);
+            console.log(`   Block severity:       ${blockSeverity}`);
+            // Step 4: Write thresholds to .scale/thresholds.json
+            const thresholdsPath = join(args.dir, '.scale', 'thresholds.json');
+            ensureDir(join(args.dir, '.scale'));
+            writeFileSync(thresholdsPath, JSON.stringify({
+                coverage: { minimum: coverageThreshold, unit: 'percent' },
+                retry: { bruteMaximum: retryThreshold, unit: 'count' },
+                severity: { blockLevel: blockSeverity },
+                gates: {
+                    G3_build: { required: scenarioMode !== 'sandbox', exitCode: 0 },
+                    G4_lint: { required: scenarioMode !== 'sandbox', exitCode: 0 },
+                    G5_tests: { required: scenarioMode !== 'sandbox', allPass: true },
+                    G6_coverage: { required: scenarioMode !== 'sandbox', minimum: coverageThreshold },
+                    G7_security: { required: scenarioMode === 'critical', noCritical: true },
+                },
+            }, null, 2));
+            console.log(`\n   ✓ Thresholds written to: ${thresholdsPath}`);
+            // Initialize with adapter
+            const adapter = createAdapter(agentType);
+            const result = await adapter.init({
+                projectDir: args.dir,
+                agentType: agentType,
+                scenarioMode,
+                thresholdsPath,
+            });
+            const projectName = args.dir.split(/[/\\]/).pop() || 'Project';
+            const governance = writeGovernanceTemplates(args.dir, {
+                mode: governanceModeFromScenario(scenarioMode),
+                projectName,
+                pack: args['governance-pack'],
+            });
+            result.created.push(...governance.created);
+            result.skipped.push(...governance.skipped);
+            console.log(`\n✅ SCALE Engine initialized for ${agentType} (interactive mode)`);
+            console.log(`\n📁 Created:`);
+            for (const f of result.created)
+                console.log(`   + ${f}`);
+            if (result.skipped.length > 0) {
+                console.log(`\n⏭️  Skipped (already exist):`);
+                for (const f of result.skipped)
+                    console.log(`   - ${f}`);
+            }
+            console.log(`\n🔧 Configuration Summary:`);
+            console.log(`   Settings:      ${result.settingsPath}`);
+            console.log(`   Knowledge:     ${result.knowledgeDocPath}`);
+            console.log(`   Thresholds:    ${thresholdsPath}`);
+            console.log(`   Data dir:      ${result.scaleDir}`);
+            console.log(`   Scenario:      ${scenarioMode}`);
+            console.log(`\n📋 Next steps:`);
+            for (const step of governanceNextSteps())
+                console.log(`   → ${step}`);
+            return;
+        }
+        // One-click quick start mode
+        if (!args.agent) {
+            const qsResult = await quickStart(args.dir, { governancePack: args['governance-pack'] });
+            if (args.json) {
+                const detection = qsResult.success ? undefined : detectPlatform(args.dir);
+                console.log(JSON.stringify({
+                    ok: qsResult.success,
+                    mode: qsResult.success && !qsResult.platform ? 'governance-only' : 'quick',
+                    platform: qsResult.platform,
+                    created: qsResult.created,
+                    skipped: qsResult.skipped,
+                    constraintsApplied: qsResult.constraintsApplied,
+                    capabilitiesEnabled: qsResult.capabilitiesEnabled,
+                    knowledgeGraph: qsResult.knowledgeGraph,
+                    nextSteps: qsResult.nextSteps,
+                    suggestions: detection?.suggestions ?? [],
+                }, null, 2));
+                return;
+            }
+            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}`);
+                if (qsResult.skipped.length > 0) {
+                    console.log(`\n⏭️  Skipped (${qsResult.skipped.length}):`);
+                    for (const f of qsResult.skipped)
+                        console.log(`   - ${f}`);
+                }
+                console.log(`\n🔒 Physical constraints applied: ${qsResult.constraintsApplied}`);
+                console.log(`\n🚀 Capabilities enabled: ${qsResult.capabilitiesEnabled.join(', ')}`);
+                console.log(`\n📋 Next steps:`);
+                for (const step of qsResult.nextSteps)
+                    console.log(`   → ${step}`);
+            }
+            else {
+                console.log(`\n⚠️  No agent platform detected`);
+                const detection = detectPlatform(args.dir);
+                console.log(`\n📋 Suggested platforms: ${detection.suggestions.join(', ')}`);
+                console.log(`\n→ Run: scale init --agent <platform>`);
+            }
+            return;
+        }
+        // Manual agent specification mode
+        const adapter = createAdapter(args.agent);
+        const result = await adapter.init({ projectDir: args.dir, agentType: args.agent, scenarioMode: args.scenario });
+        const projectName = args.dir.split(/[/\\]/).pop() || 'Project';
+        const governance = writeGovernanceTemplates(args.dir, {
+            mode: governanceModeFromScenario(args.scenario),
+            projectName,
+            pack: args['governance-pack'],
+        });
+        result.created.push(...governance.created);
+        result.skipped.push(...governance.skipped);
+        if (args.json) {
+            console.log(JSON.stringify({
+                ok: true,
+                mode: args.quick ? 'quick-agent' : 'manual',
+                agent: args.agent,
+                scenario: args.scenario,
+                governancePack: args['governance-pack'],
+                settingsPath: result.settingsPath,
+                knowledgeDocPath: result.knowledgeDocPath,
+                scaleDir: result.scaleDir,
+                created: result.created,
+                skipped: result.skipped,
+                nextSteps: governanceNextSteps(),
+            }, null, 2));
+            return;
+        }
+        console.log(`\n✅ SCALE Engine initialized for ${args.agent} (scenario: ${args.scenario})`);
+        console.log(`\n📁 Created:`);
+        for (const f of result.created)
+            console.log(`   + ${f}`);
+        if (result.skipped.length > 0) {
+            console.log(`\n⏭️  Skipped (already exist):`);
+            for (const f of result.skipped)
+                console.log(`   - ${f}`);
+        }
+        console.log(`\n🔧 Settings: ${result.settingsPath}`);
+        console.log(`\n📖 Knowledge: ${result.knowledgeDocPath}`);
+        console.log(`\n📂 Data dir:  ${result.scaleDir}`);
+        console.log(`\n📋 Next steps:`);
+        for (const step of governanceNextSteps())
+            console.log(`   → ${step}`);
+    },
+});
+// ============================================================================
+// governance command — Generated governance asset tooling
+// ============================================================================
+const governanceDiff = defineCommand({
+    meta: { name: 'diff', description: 'Check generated governance files for drift' },
+    args: {
+        dir: { type: 'string', default: '.', description: 'Project directory' },
+        json: { type: 'boolean', default: false, description: 'Print JSON output' },
+    },
+    run({ args }) {
+        const report = computeGovernanceDrift(args.dir);
+        if (args.json) {
+            console.log(JSON.stringify(report, null, 2));
+            return;
+        }
+        if (!report.lockExists) {
+            console.log('No governance lock found. Run: scale init --governance-pack <pack>');
+            return;
+        }
+        if (report.missing.length === 0 && report.changed.length === 0) {
+            console.log('Governance generated files are clean.');
+            return;
+        }
+        for (const item of report.missing)
+            console.log(`missing: ${item.path}`);
+        for (const item of report.changed)
+            console.log(`changed: ${item.path}`);
+    },
+});
+const governanceModeCommand = defineCommand({
+    meta: { name: 'mode', description: 'Evaluate progressive governance mode from task text and changed files' },
+    args: {
+        task: { type: 'string', description: 'Task or requirement description' },
+        files: { type: 'string', description: 'Comma-separated changed or target files' },
+        'requested-mode': { type: 'string', description: 'Requested governance mode: minimal, standard, expanded, or critical' },
+        json: { type: 'boolean', default: false },
+    },
+    run({ args }) {
+        const report = evaluateProgressiveGovernance({
+            task: args.task ? String(args.task) : undefined,
+            changedFiles: parseCommaList(args.files),
+            requestedMode: normalizeGovernanceMode(args['requested-mode']),
+        });
+        if (args.json) {
+            console.log(JSON.stringify(report, null, 2));
+            return;
+        }
+        console.log('SCALE Progressive Governance');
+        console.log(`  Recommended: ${report.recommendedMode}`);
+        console.log(`  Effective: ${report.effectiveMode}`);
+        if (report.escalated)
+            console.log(`  Escalated from requested mode: ${report.requestedMode}`);
+        for (const signal of report.signals) {
+            console.log(`  [${signal.mode}] ${signal.id}: ${signal.reason}`);
+        }
+        for (const behavior of report.requiredBehaviors) {
+            console.log(`  behavior: ${behavior}`);
+        }
+    },
+});
+const governanceRoiCommand = defineCommand({
+    meta: { name: 'roi', description: 'Report benefit and overhead signals for active governance modules' },
+    args: {
+        dir: { type: 'string', default: PROJECT_DIR, description: 'Project directory' },
+        'task-id': { type: 'string', description: 'Task id' },
+        task: { type: 'string', description: 'Task or requirement description' },
+        files: { type: 'string', description: 'Comma-separated changed or target files' },
+        'requested-mode': { type: 'string', description: 'Requested governance mode' },
+        'code-query': { type: 'string', description: 'Optional code intelligence query to include in ROI' },
+        symbol: { type: 'string', description: 'Optional symbol impact query to include in ROI' },
+        json: { type: 'boolean', default: false },
+    },
+    run({ args }) {
+        const projectDir = resolve(String(args.dir ?? PROJECT_DIR));
+        const scaleDir = resolveScaleDirForProject(projectDir);
+        const governanceReport = evaluateProgressiveGovernance({
+            task: args.task ? String(args.task) : undefined,
+            changedFiles: parseCommaList(args.files),
+            requestedMode: normalizeGovernanceMode(args['requested-mode']),
+        });
+        const contextBudget = scanContextBudget({ projectDir, scaleDir });
+        const codeIntelligence = args.symbol
+            ? impactCodeGraph({ projectDir, scaleDir, symbol: String(args.symbol) })
+            : args['code-query']
+                ? queryCodeGraph({ projectDir, scaleDir, query: String(args['code-query']) })
+                : undefined;
+        const report = createGovernanceRoiReport({
+            taskId: args['task-id'] ? String(args['task-id']) : undefined,
+            contextBudget,
+            governance: governanceReport,
+            codeIntelligence,
+        });
+        if (args.json) {
+            console.log(JSON.stringify(report, null, 2));
+            return;
+        }
+        console.log('SCALE Governance ROI');
+        console.log(`  Recommendation: ${report.summary.recommendation}`);
+        for (const module of report.modules) {
+            console.log(`  [${module.evidenceLevel}] ${module.module}`);
+            console.log(`    benefit: ${module.benefit}`);
+            console.log(`    overhead: ${module.overhead}`);
+            console.log(`    recommendation: ${module.recommendation}`);
+        }
+    },
+});
+const governance = defineCommand({
+    meta: { name: 'governance', description: 'Governance template pack tools' },
+    subCommands: { diff: governanceDiff, mode: governanceModeCommand, roi: governanceRoiCommand },
+});
+// ============================================================================
+// 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
+// ============================================================================
+function resolveChangedFilesArg(args) {
+    const explicit = splitChangedFiles(args['changed-files']);
+    if (explicit.length > 0)
+        return explicit;
+    if (!args.changed)
+        return undefined;
+    return readGitChangedFiles(args.dir ?? '.');
+}
+function splitChangedFiles(value) {
+    if (!value)
+        return [];
+    return value
+        .split(/[\n,]/)
+        .map(item => item.trim())
+        .filter(Boolean);
+}
+function readGitChangedFiles(projectDir) {
+    const tracked = readGitPathList(projectDir, ['diff', '--name-only', '--diff-filter=ACMRTUXB', 'HEAD', '--']);
+    const untracked = readGitPathList(projectDir, ['ls-files', '--others', '--exclude-standard']);
+    return Array.from(new Set([...tracked, ...untracked]));
+}
+function readGitPathList(projectDir, args) {
+    try {
+        return execFileSync('git', ['-C', projectDir, ...args], { encoding: 'utf-8' })
+            .split(/\r?\n/)
+            .map(item => item.trim())
+            .filter(Boolean);
+    }
+    catch {
+        return [];
+    }
+}
+const standardsScan = defineCommand({
+    meta: { name: 'scan', description: 'Scan source files for engineering standard violations' },
+    args: {
+        dir: { type: 'string', default: '.', description: 'Project directory' },
+        changed: { type: 'boolean', default: false, description: 'Scan changed Git files only' },
+        'changed-files': { type: 'string', description: 'Comma or newline separated file list to scan' },
+        json: { type: 'boolean', default: false, description: 'Print JSON output' },
+    },
+    run({ args }) {
+        const report = scanEngineeringStandards({ projectDir: args.dir, changedFiles: resolveChangedFilesArg(args) });
+        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' },
+        changed: { type: 'boolean', default: false, description: 'Scan changed Git files only' },
+        'changed-files': { type: 'string', description: 'Comma or newline separated file list to scan' },
+        json: { type: 'boolean', default: false, description: 'Print JSON output' },
+    },
+    run({ args }) {
+        const report = doctorEngineeringStandards({ projectDir: args.dir, changedFiles: resolveChangedFilesArg(args) });
+        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' },
+        changed: { type: 'boolean', default: false, description: 'Scan changed Git files only' },
+        'changed-files': { type: 'string', description: 'Comma or newline separated file list to scan' },
+        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'],
+            changedFiles: resolveChangedFilesArg(args),
+        });
+        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 standardsBaseline = defineCommand({
+    meta: { name: 'baseline', description: 'Generate a legacy standards baseline and classification report' },
+    args: {
+        dir: { type: 'string', default: '.', description: 'Project directory' },
+        write: { type: 'boolean', default: false, description: 'Write .scale/engineering-standards-baseline.json' },
+        'task-id': { type: 'string', description: 'Task id for the legacy debt report' },
+        'artifact-dir': { type: 'string', description: 'Directory where standards-legacy-debt.md should be written' },
+        reason: { type: 'string', default: 'legacy standards debt accepted for staged remediation', description: 'Reason recorded on generated baseline entries' },
+        json: { type: 'boolean', default: false, description: 'Print JSON output' },
+    },
+    run({ args }) {
+        const report = baselineEngineeringStandards({
+            projectDir: args.dir,
+            writeBaseline: args.write,
+            taskId: args['task-id'],
+            artifactsDir: args['artifact-dir'],
+            reason: args.reason,
+        });
+        if (args.json) {
+            console.log(JSON.stringify(report, null, 2));
+            return;
+        }
+        console.log(`Standards baseline: ${report.wroteBaseline ? 'written' : 'dry-run'}`);
+        console.log(`  Baseline entries: ${report.baselineEntries.length}`);
+        console.log(`  Blocking findings: ${report.debt.blockingFindings}`);
+        console.log(`  Baseline path: ${report.baselinePath}`);
+        if (report.legacyDebtPath)
+            console.log(`  Legacy debt report: ${report.legacyDebtPath}`);
+        if (!report.wroteBaseline)
+            console.log('  Re-run with --write to update .scale/engineering-standards-baseline.json.');
+    },
+});
+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, 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;
         }
-        // One-click quick start mode
-        if (!args.agent) {
-            const qsResult = await quickStart(args.dir, { governancePack: args['governance-pack'] });
-            if (args.json) {
-                const detection = qsResult.success ? undefined : detectPlatform(args.dir);
-                console.log(JSON.stringify({
-                    ok: qsResult.success,
-                    mode: qsResult.success && !qsResult.platform ? 'governance-only' : 'quick',
-                    platform: qsResult.platform,
-                    created: qsResult.created,
-                    skipped: qsResult.skipped,
-                    constraintsApplied: qsResult.constraintsApplied,
-                    capabilitiesEnabled: qsResult.capabilitiesEnabled,
-                    knowledgeGraph: qsResult.knowledgeGraph,
-                    nextSteps: qsResult.nextSteps,
-                    suggestions: detection?.suggestions ?? [],
-                }, null, 2));
-                return;
-            }
-            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}`);
-                if (qsResult.skipped.length > 0) {
-                    console.log(`\n⏭️  Skipped (${qsResult.skipped.length}):`);
-                    for (const f of qsResult.skipped)
-                        console.log(`   - ${f}`);
-                }
-                console.log(`\n🔒 Physical constraints applied: ${qsResult.constraintsApplied}`);
-                console.log(`\n🚀 Capabilities enabled: ${qsResult.capabilitiesEnabled.join(', ')}`);
-                console.log(`\n📋 Next steps:`);
-                for (const step of qsResult.nextSteps)
-                    console.log(`   → ${step}`);
-            }
-            else {
-                console.log(`\n⚠️  No agent platform detected`);
-                const detection = detectPlatform(args.dir);
-                console.log(`\n📋 Suggested platforms: ${detection.suggestions.join(', ')}`);
-                console.log(`\n→ Run: scale init --agent <platform>`);
+        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;
         }
-        // Manual agent specification mode
-        const adapter = createAdapter(args.agent);
-        const result = await adapter.init({ projectDir: args.dir, agentType: args.agent, scenarioMode: args.scenario });
-        const projectName = args.dir.split(/[/\\]/).pop() || 'Project';
-        const governance = writeGovernanceTemplates(args.dir, {
-            mode: governanceModeFromScenario(args.scenario),
-            projectName,
-            pack: args['governance-pack'],
+        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,
         });
-        result.created.push(...governance.created);
-        result.skipped.push(...governance.skipped);
+        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({
-                ok: true,
-                mode: args.quick ? 'quick-agent' : 'manual',
-                agent: args.agent,
-                scenario: args.scenario,
-                governancePack: args['governance-pack'],
-                settingsPath: result.settingsPath,
-                knowledgeDocPath: result.knowledgeDocPath,
-                scaleDir: result.scaleDir,
-                created: result.created,
-                skipped: result.skipped,
-                nextSteps: ['scale doctor', 'scale create Spec "<feature name>"'],
-            }, null, 2));
+            console.log(JSON.stringify(output, null, 2));
+            if (!exists)
+                process.exitCode = 1;
             return;
         }
-        console.log(`\n✅ SCALE Engine initialized for ${args.agent} (scenario: ${args.scenario})`);
-        console.log(`\n📁 Created:`);
-        for (const f of result.created)
-            console.log(`   + ${f}`);
-        if (result.skipped.length > 0) {
-            console.log(`\n⏭️  Skipped (already exist):`);
-            for (const f of result.skipped)
-                console.log(`   - ${f}`);
+        if (!exists) {
+            console.log(`HTML artifact not found: ${path}`);
+            process.exitCode = 1;
+            return;
         }
-        console.log(`\n🔧 Settings: ${result.settingsPath}`);
-        console.log(`\n📖 Knowledge: ${result.knowledgeDocPath}`);
-        console.log(`\n📂 Data dir:  ${result.scaleDir}`);
-        console.log(`\n📋 Next steps:`);
-        console.log(`   → scale doctor`);
-        console.log(`   → scale create Spec "<feature name>"`);
+        console.log(url);
+    },
+});
+const artifactDashboard = defineCommand({
+    meta: { name: 'dashboard', description: 'Render a governance HTML dashboard from runtime, eval, memory, resource, and artifact evidence' },
+    args: {
+        dir: { type: 'string', default: '.', description: 'Project directory' },
+        'task-id': { type: 'string', description: 'Optional task id to scope runtime/eval evidence and task HTML artifacts' },
+        output: { type: 'string', alias: 'o', description: 'Output HTML path; defaults to .scale/reports/governance-dashboard.html' },
+        theme: { type: 'string', default: 'auto', description: 'Theme mode: dark/light/auto' },
+        lang: { type: 'string', default: 'zh', description: 'HTML language: zh/en' },
+        json: { type: 'boolean', default: false, description: 'Print JSON output' },
+    },
+    run({ args }) {
+        const projectDir = resolve(String(args.dir ?? PROJECT_DIR));
+        const scaleDir = resolveScaleDirForProject(projectDir);
+        const report = renderGovernanceDashboard({
+            projectDir,
+            scaleDir,
+            taskId: typeof args['task-id'] === 'string' ? args['task-id'] : undefined,
+            output: typeof args.output === 'string' ? args.output : undefined,
+            theme: normalizeThemeArg(args.theme),
+            lang: normalizeLangArg(args.lang),
+        });
+        if (args.json) {
+            console.log(JSON.stringify(report, null, 2));
+            if (!report.ok)
+                process.exitCode = 1;
+            return;
+        }
+        console.log(`SCALE Governance Dashboard: ${report.ok ? 'OK' : 'ATTENTION'}`);
+        console.log(`  HTML: ${report.outputPath}`);
+        console.log(`  Manifest: ${report.manifestPath}`);
+        for (const finding of report.findings) {
+            console.log(`  [${finding.severity.toUpperCase()}] ${finding.code}: ${finding.message}`);
+        }
+        if (!report.ok)
+            process.exitCode = 1;
+    },
+});
+const artifact = defineCommand({
+    meta: { name: 'artifact', description: 'Derived HTML artifact rendering and safety checks' },
+    subCommands: { render: artifactRender, doctor: artifactDoctor, settle: artifactSettle, open: artifactOpen, dashboard: artifactDashboard },
+});
+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({
+    meta: { name: 'evolve', description: 'Run evolution cycle (Defect→Lesson→Rule→Hook)' },
+    args: {},
+    async run() {
+        const { store, kb, eventBus } = getEngine();
+        const extractor = new LessonExtractor(store, kb, eventBus);
+        const proposer = new RuleProposer(kb, eventBus);
+        const generator = new HookGenerator(eventBus);
+        const engine = new EvolutionEngine(extractor, proposer, generator, eventBus, SCALE_DIR);
+        const stats = await engine.runCycle();
+        console.log(JSON.stringify(stats, null, 2));
     },
 });
 // ============================================================================
-// governance command — Generated governance asset tooling
+// doctor command
 // ============================================================================
-const governanceDiff = defineCommand({
-    meta: { name: 'diff', description: 'Check generated governance files for drift' },
+const doctor = defineCommand({
+    meta: { name: 'doctor', description: 'Diagnose SCALE Engine health' },
     args: {
         dir: { type: 'string', default: '.', description: 'Project directory' },
-        json: { type: 'boolean', default: false, description: 'Print JSON output' },
+        json: { type: 'boolean', default: false, description: 'Output as JSON' },
     },
-    run({ args }) {
-        const report = computeGovernanceDrift(args.dir);
+    async run({ args }) {
+        const doc = new Doctor(args.dir);
+        const report = await doc.diagnose();
         if (args.json) {
             console.log(JSON.stringify(report, null, 2));
-            return;
-        }
-        if (!report.lockExists) {
-            console.log('No governance lock found. Run: scale init --governance-pack <pack>');
-            return;
         }
-        if (report.missing.length === 0 && report.changed.length === 0) {
-            console.log('Governance generated files are clean.');
-            return;
+        else {
+            console.log(doc.formatReport(report));
         }
-        for (const item of report.missing)
-            console.log(`missing: ${item.path}`);
-        for (const item of report.changed)
-            console.log(`changed: ${item.path}`);
+        process.exitCode = report.overall === 'broken' ? 1 : 0;
     },
 });
-const governance = defineCommand({
-    meta: { name: 'governance', description: 'Governance template pack tools' },
-    subCommands: { diff: governanceDiff },
-});
 // ============================================================================
-// assets command - Resource lifecycle governance
+// workflow command — 列出/查看工作流预设
 // ============================================================================
-const assetsScan = defineCommand({
-    meta: { name: 'scan', description: 'Classify project docs, reports, media, scripts, and temporary outputs' },
+const workflowList = defineCommand({
+    meta: { name: 'list', description: 'List all workflow presets' },
     args: {
-        dir: { type: 'string', default: '.', description: 'Project directory' },
-        json: { type: 'boolean', default: false, description: 'Print JSON output' },
+        scenario: { type: 'string', description: 'Filter by scenario mode (sandbox/standard/critical)' },
+        json: { type: 'boolean', default: false, description: 'Output workflow presets as JSON' },
     },
-    run({ args }) {
-        const report = scanResourceAssets({ projectDir: args.dir });
+    async run({ args }) {
+        const presets = args.scenario
+            ? getPresetsByScenario(args.scenario)
+            : listWorkflowPresets();
         if (args.json) {
-            console.log(JSON.stringify(report, null, 2));
+            console.log(JSON.stringify({
+                ok: true,
+                scenario: args.scenario ?? null,
+                count: presets.length,
+                presets: presets.map(preset => ({
+                    id: preset.id,
+                    name: preset.name,
+                    nameZh: preset.nameZh,
+                    description: preset.description,
+                    scenarioMode: preset.scenarioMode,
+                    requiredArtifacts: preset.requiredArtifacts,
+                    steps: preset.steps,
+                })),
+            }, 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}`);
+        if (presets.length === 0) {
+            console.log('No workflow presets found.');
+            return;
+        }
+        console.log('\n📋 SCALE Engine Workflow Presets');
+        console.log('═══════════════════════════════════════════════════════');
+        for (const preset of presets) {
+            const modeEmoji = { sandbox: '🏖️', standard: '⚙️', critical: '🔒' }[preset.scenarioMode];
+            const mandatorySteps = preset.steps.filter((s) => s.isMandatory).length;
+            const totalSteps = preset.steps.length;
+            console.log(`\n  ${preset.nameZh} (${preset.id})`);
+            console.log(`  ${preset.description}`);
+            console.log(`  Mode: ${modeEmoji} ${preset.scenarioMode} · Steps: ${mandatorySteps}/${totalSteps} mandatory`);
+            if (preset.requiredArtifacts.length > 0) {
+                console.log(`  Requires: ${preset.requiredArtifacts.map((a) => `${a.type}${a.status ? `(${a.status})` : ''}`).join(', ')}`);
+            }
+            // Show step summary
+            for (const step of preset.steps) {
+                const marker = step.isMandatory ? '●' : '○';
+                const gate = step.verificationGate ? ` ⊓ ${step.verificationGate}` : '';
+                console.log(`    ${marker} ${step.stepId}: ${step.action}${gate}`);
+            }
         }
+        console.log('\n═══════════════════════════════════════════════════════');
+        console.log('\nUsage: scale workflow show <preset-id>');
     },
 });
-const assetsDoctor = defineCommand({
-    meta: { name: 'doctor', description: 'Find resource lifecycle and Git policy problems' },
+const workflow = defineCommand({
+    meta: { name: 'workflow', description: 'Workflow preset management' },
+    subCommands: { list: workflowList },
+});
+const evidenceList = defineCommand({
+    meta: { name: 'list', description: 'List persisted gate evidence records' },
     args: {
-        dir: { type: 'string', default: '.', description: 'Project directory' },
-        json: { type: 'boolean', default: false, description: 'Print JSON output' },
+        limit: { type: 'string', default: '20', description: 'Maximum number of records' },
+        json: { type: 'boolean', default: false },
     },
-    run({ args }) {
-        const report = doctorResourceAssets({ projectDir: args.dir });
+    async run({ args }) {
+        const store = new EvidenceStore(SCALE_DIR);
+        const records = store.listGateResults(parseInt(args.limit, 10) || 20);
         if (args.json) {
-            console.log(JSON.stringify(report, null, 2));
+            console.log(JSON.stringify(records, null, 2));
             return;
         }
-        console.log(`SCALE Asset Doctor: ${report.ok ? 'OK' : 'FAILED'}`);
-        if (report.findings.length === 0) {
-            console.log('  No resource lifecycle findings.');
+        if (records.length === 0) {
+            console.log('No evidence records found.');
             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}`);
+        console.log('\nSCALE Evidence Records');
+        for (const record of records) {
+            const status = record.passed ? 'PASS' : record.status;
+            const blockers = record.blockers.length > 0 ? ` blockers=${record.blockers.length}` : '';
+            console.log(`  ${record.id}  ${record.gate}  ${status}  ${new Date(record.createdAt).toISOString()}${blockers}`);
         }
-        if (!report.ok)
-            process.exitCode = 1;
+        console.log('\nUsage: scale evidence show <id>');
     },
 });
-const assetsSettle = defineCommand({
-    meta: { name: 'settle', description: 'Record resource lifecycle settlement evidence for a task' },
+const evidenceShow = defineCommand({
+    meta: { name: 'show', description: 'Show a persisted gate evidence record' },
     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' },
+        id: { type: 'positional', required: true },
+        json: { type: 'boolean', default: false },
     },
-    run({ args }) {
-        const report = settleResourceAssets({
-            projectDir: args.dir,
-            taskId: args['task-id'],
-            artifactsDir: args['artifact-dir'],
-        });
+    async run({ args }) {
+        const store = new EvidenceStore(SCALE_DIR);
+        const record = store.getGateResult(args.id);
+        if (!record) {
+            console.error(`Evidence record not found: ${args.id}`);
+            process.exit(1);
+        }
         if (args.json) {
-            console.log(JSON.stringify(report, null, 2));
+            console.log(JSON.stringify(record, null, 2));
+            return;
         }
-        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}`);
-                }
-            }
+        console.log(`\nEvidence: ${record.id}`);
+        console.log(`Gate: ${record.gate}`);
+        console.log(`Status: ${record.status}`);
+        console.log(`Passed: ${record.passed}`);
+        console.log(`Created: ${new Date(record.createdAt).toISOString()}`);
+        console.log(`Duration: ${record.durationMs}ms`);
+        if (record.blockers.length > 0) {
+            console.log('\nBlockers:');
+            for (const blocker of record.blockers)
+                console.log(`  - ${blocker}`);
+        }
+        console.log('\nEvidence Items:');
+        for (const item of record.evidenceItems) {
+            const status = item.passed ? 'PASS' : 'FAIL';
+            const target = item.command ?? item.path ?? '';
+            console.log(`  - [${status}] ${item.label}${target ? ` (${target})` : ''}`);
+            console.log(`    ${item.detail}`);
         }
-        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 },
+const evidence = defineCommand({
+    meta: { name: 'evidence', description: 'Persisted gate evidence inspection' },
+    subCommands: { list: evidenceList, show: evidenceShow },
 });
 // ============================================================================
-// standards command - Engineering standards governance
+// runtime command - session ledger + completion evidence
 // ============================================================================
-function resolveChangedFilesArg(args) {
-    const explicit = splitChangedFiles(args['changed-files']);
-    if (explicit.length > 0)
-        return explicit;
-    if (!args.changed)
-        return undefined;
-    return readGitChangedFiles(args.dir ?? '.');
-}
-function splitChangedFiles(value) {
-    if (!value)
-        return [];
-    return value
-        .split(/[\n,]/)
-        .map(item => item.trim())
-        .filter(Boolean);
+function normalizeRuntimeEvidenceKind(value) {
+    const normalized = String(value ?? 'command').trim();
+    const allowed = ['command', 'gate', 'tool', 'skill', 'mcp', 'browser', 'desktop', 'manual', 'final-report'];
+    if (allowed.includes(normalized))
+        return normalized;
+    throw new Error(`Invalid runtime evidence kind "${normalized}"; expected ${allowed.join(', ')}.`);
 }
-function readGitChangedFiles(projectDir) {
-    const tracked = readGitPathList(projectDir, ['diff', '--name-only', '--diff-filter=ACMRTUXB', 'HEAD', '--']);
-    const untracked = readGitPathList(projectDir, ['ls-files', '--others', '--exclude-standard']);
-    return Array.from(new Set([...tracked, ...untracked]));
+function normalizeRuntimeEvidenceStatus(value) {
+    const normalized = String(value ?? '').trim();
+    if (normalized === 'passed' || normalized === 'failed' || normalized === 'skipped')
+        return normalized;
+    throw new Error(`Invalid runtime evidence status "${normalized}"; expected passed, failed, or skipped.`);
 }
-function readGitPathList(projectDir, args) {
-    try {
-        return execFileSync('git', ['-C', projectDir, ...args], { encoding: 'utf-8' })
-            .split(/\r?\n/)
-            .map(item => item.trim())
-            .filter(Boolean);
-    }
-    catch {
-        return [];
-    }
+function normalizeRuntimeSessionStatus(value) {
+    const normalized = String(value ?? 'completed').trim();
+    if (normalized === 'active' || normalized === 'completed' || normalized === 'failed' || normalized === 'abandoned')
+        return normalized;
+    throw new Error(`Invalid runtime session status "${normalized}"; expected active, completed, failed, or abandoned.`);
 }
-const standardsScan = defineCommand({
-    meta: { name: 'scan', description: 'Scan source files for engineering standard violations' },
+const runtimeStart = defineCommand({
+    meta: { name: 'start', description: 'Start a runtime session ledger' },
     args: {
-        dir: { type: 'string', default: '.', description: 'Project directory' },
-        changed: { type: 'boolean', default: false, description: 'Scan changed Git files only' },
-        'changed-files': { type: 'string', description: 'Comma or newline separated file list to scan' },
-        json: { type: 'boolean', default: false, description: 'Print JSON output' },
+        'session-id': { type: 'string', description: 'Session id; generated when omitted' },
+        'task-id': { type: 'string', description: 'Task id linked to this session' },
+        agent: { type: 'string', description: 'Agent name' },
+        level: { type: 'string', default: 'M', description: 'Task level: S, M, L, or CRITICAL' },
+        summary: { type: 'string', description: 'Short session summary' },
+        json: { type: 'boolean', default: false },
     },
     run({ args }) {
-        const report = scanEngineeringStandards({ projectDir: args.dir, changedFiles: resolveChangedFilesArg(args) });
-        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}`);
+        const ledger = new SessionLedger({ projectDir: PROJECT_DIR, scaleDir: SCALE_DIR });
+        const session = ledger.start({
+            sessionId: args['session-id'],
+            taskId: args['task-id'],
+            agent: args.agent,
+            level: normalizeTaskArtifactLevel(args.level),
+            summary: args.summary,
+        });
+        if (args.json) {
+            console.log(JSON.stringify(session, null, 2));
+            return;
         }
-        if (report.findings.length > 20)
-            console.log(`  ... ${report.findings.length - 20} more finding(s)`);
+        console.log(`Runtime session started: ${session.sessionId}`);
+        if (session.taskId)
+            console.log(`  Task: ${session.taskId}`);
+        if (session.level)
+            console.log(`  Level: ${session.level}`);
+        console.log(`  Events: ${ledger.sessionFile(session.sessionId)}`);
     },
 });
-const standardsDoctor = defineCommand({
-    meta: { name: 'doctor', description: 'Find blocking engineering standards problems' },
+const runtimeEnd = defineCommand({
+    meta: { name: 'end', description: 'End the current or named runtime session' },
     args: {
-        dir: { type: 'string', default: '.', description: 'Project directory' },
-        changed: { type: 'boolean', default: false, description: 'Scan changed Git files only' },
-        'changed-files': { type: 'string', description: 'Comma or newline separated file list to scan' },
-        json: { type: 'boolean', default: false, description: 'Print JSON output' },
+        'session-id': { type: 'string', description: 'Session id; current session is used when omitted' },
+        status: { type: 'string', default: 'completed', description: 'completed, failed, or abandoned' },
+        summary: { type: 'string', description: 'Completion summary' },
+        json: { type: 'boolean', default: false },
     },
     run({ args }) {
-        const report = doctorEngineeringStandards({ projectDir: args.dir, changedFiles: resolveChangedFilesArg(args) });
+        const ledger = new SessionLedger({ projectDir: PROJECT_DIR, scaleDir: SCALE_DIR });
+        const sessionId = args['session-id'] ?? ledger.current()?.sessionId;
+        if (!sessionId) {
+            console.error('No runtime session id provided and no current runtime session exists.');
+            process.exit(1);
+        }
+        const session = ledger.end(sessionId, normalizeRuntimeSessionStatus(args.status), args.summary);
         if (args.json) {
-            console.log(JSON.stringify(report, null, 2));
-            if (!report.ok)
-                process.exitCode = 1;
+            console.log(JSON.stringify(session, null, 2));
             return;
         }
-        console.log(`SCALE Standards Doctor: ${report.ok ? 'OK' : 'FAILED'}`);
-        if (report.findings.length === 0) {
-            console.log('  No engineering standards findings.');
-            return;
+        console.log(`Runtime session ended: ${session.sessionId}`);
+        console.log(`  Status: ${session.status}`);
+    },
+});
+const runtimeRecord = defineCommand({
+    meta: { name: 'record', description: 'Record command, gate, tool, browser, skill, or manual runtime evidence' },
+    args: {
+        'task-id': { type: 'string', description: 'Task id linked to this evidence' },
+        'session-id': { type: 'string', description: 'Session id linked to this evidence' },
+        kind: { type: 'string', default: 'command', description: 'command, gate, tool, skill, mcp, browser, desktop, manual, final-report' },
+        title: { type: 'string', required: true, description: 'Evidence title' },
+        status: { type: 'string', required: true, description: 'passed, failed, or skipped' },
+        command: { type: 'string', description: 'Exact command or tool invocation, with secrets redacted by SCALE' },
+        'exit-code': { type: 'string', description: 'Exit code when applicable' },
+        summary: { type: 'string', required: true, description: 'Short output summary' },
+        artifacts: { type: 'string', description: 'Comma-separated artifact paths' },
+        'metadata-json': { type: 'string', default: '{}', description: 'Additional JSON metadata' },
+        json: { type: 'boolean', default: false },
+    },
+    run({ args }) {
+        const current = new SessionLedger({ projectDir: PROJECT_DIR, scaleDir: SCALE_DIR }).current();
+        let metadata = {};
+        try {
+            metadata = JSON.parse(String(args['metadata-json'] ?? '{}'));
         }
-        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}`);
+        catch {
+            console.error('--metadata-json must be valid JSON.');
+            process.exit(1);
         }
-        if (!report.ok)
-            process.exitCode = 1;
+        const exitCode = args['exit-code'] === undefined || args['exit-code'] === ''
+            ? undefined
+            : Number.parseInt(String(args['exit-code']), 10);
+        if (exitCode !== undefined && Number.isNaN(exitCode)) {
+            console.error('--exit-code must be a number.');
+            process.exit(1);
+        }
+        const ledger = new RuntimeEvidenceLedger({ projectDir: PROJECT_DIR, scaleDir: SCALE_DIR });
+        const record = ledger.record({
+            taskId: args['task-id'] ?? current?.taskId,
+            sessionId: args['session-id'] ?? current?.sessionId,
+            kind: normalizeRuntimeEvidenceKind(args.kind),
+            title: args.title,
+            status: normalizeRuntimeEvidenceStatus(args.status),
+            command: args.command,
+            exitCode,
+            summary: args.summary,
+            artifacts: parseCommaList(args.artifacts),
+            metadata,
+        });
+        if (record.sessionId) {
+            new SessionLedger({ projectDir: PROJECT_DIR, scaleDir: SCALE_DIR }).append(record.sessionId, {
+                type: 'evidence.recorded',
+                message: `${record.status}: ${record.title}`,
+                data: {
+                    evidenceId: record.id,
+                    kind: record.kind,
+                    taskId: record.taskId,
+                },
+            });
+        }
+        if (args.json) {
+            console.log(JSON.stringify(record, null, 2));
+            return;
+        }
+        console.log(`Runtime evidence recorded: ${record.id}`);
+        console.log(`  Status: ${record.status}`);
+        console.log(`  Kind: ${record.kind}`);
+        if (record.redactionApplied)
+            console.log('  Redaction: applied');
     },
 });
-const standardsSettle = defineCommand({
-    meta: { name: 'settle', description: 'Record engineering standards settlement evidence for a task' },
+const runtimeDoctor = defineCommand({
+    meta: { name: 'doctor', description: 'Check runtime session and completion evidence' },
     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' },
-        changed: { type: 'boolean', default: false, description: 'Scan changed Git files only' },
-        'changed-files': { type: 'string', description: 'Comma or newline separated file list to scan' },
-        json: { type: 'boolean', default: false, description: 'Print JSON output' },
+        'task-id': { type: 'string', description: 'Task id to inspect' },
+        'session-id': { type: 'string', description: 'Session id to inspect' },
+        level: { type: 'string', default: 'M', description: 'Task level: S, M, L, or CRITICAL' },
+        json: { type: 'boolean', default: false },
     },
     run({ args }) {
-        const report = settleEngineeringStandards({
-            projectDir: args.dir,
+        const report = doctorRuntimeEvidence({
+            projectDir: PROJECT_DIR,
+            scaleDir: SCALE_DIR,
             taskId: args['task-id'],
-            artifactsDir: args['artifact-dir'],
-            changedFiles: resolveChangedFilesArg(args),
+            sessionId: args['session-id'],
+            level: normalizeTaskArtifactLevel(args.level),
         });
         if (args.json) {
             console.log(JSON.stringify(report, null, 2));
+            if (report.blocked)
+                process.exitCode = 1;
+            return;
         }
-        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}`);
-            }
+        console.log('\nSCALE Runtime Doctor');
+        console.log(`  Evidence: ${report.evidence.total} total, ${report.evidence.passed} passed, ${report.evidence.failed} failed, ${report.evidence.skipped} skipped`);
+        for (const check of report.checks) {
+            console.log(`  [${check.status.toUpperCase()}] ${check.name}: ${check.message}`);
+            if (check.fix)
+                console.log(`    Fix: ${check.fix}`);
         }
-        if (!report.ok)
+        if (report.blocked)
             process.exitCode = 1;
     },
 });
-const standardsBaseline = defineCommand({
-    meta: { name: 'baseline', description: 'Generate a legacy standards baseline and classification report' },
+const runtimeFinalCheck = defineCommand({
+    meta: { name: 'final-check', description: 'Block final delivery claims without passed runtime evidence' },
     args: {
-        dir: { type: 'string', default: '.', description: 'Project directory' },
-        write: { type: 'boolean', default: false, description: 'Write .scale/engineering-standards-baseline.json' },
-        'task-id': { type: 'string', description: 'Task id for the legacy debt report' },
-        'artifact-dir': { type: 'string', description: 'Directory where standards-legacy-debt.md should be written' },
-        reason: { type: 'string', default: 'legacy standards debt accepted for staged remediation', description: 'Reason recorded on generated baseline entries' },
-        json: { type: 'boolean', default: false, description: 'Print JSON output' },
+        'task-id': { type: 'string', description: 'Task id to inspect' },
+        'session-id': { type: 'string', description: 'Session id to inspect' },
+        level: { type: 'string', default: 'M', description: 'Task level: S, M, L, or CRITICAL' },
+        json: { type: 'boolean', default: false },
     },
     run({ args }) {
-        const report = baselineEngineeringStandards({
-            projectDir: args.dir,
-            writeBaseline: args.write,
+        const readiness = evaluateFinalReportReadiness({
+            projectDir: PROJECT_DIR,
+            scaleDir: SCALE_DIR,
             taskId: args['task-id'],
-            artifactsDir: args['artifact-dir'],
-            reason: args.reason,
+            sessionId: args['session-id'],
+            level: normalizeTaskArtifactLevel(args.level),
         });
         if (args.json) {
-            console.log(JSON.stringify(report, null, 2));
+            console.log(JSON.stringify(readiness, null, 2));
+            if (readiness.blocked)
+                process.exitCode = 1;
             return;
         }
-        console.log(`Standards baseline: ${report.wroteBaseline ? 'written' : 'dry-run'}`);
-        console.log(`  Baseline entries: ${report.baselineEntries.length}`);
-        console.log(`  Blocking findings: ${report.debt.blockingFindings}`);
-        console.log(`  Baseline path: ${report.baselinePath}`);
-        if (report.legacyDebtPath)
-            console.log(`  Legacy debt report: ${report.legacyDebtPath}`);
-        if (!report.wroteBaseline)
-            console.log('  Re-run with --write to update .scale/engineering-standards-baseline.json.');
+        console.log('\nSCALE Runtime Final Check');
+        console.log(`  Ready: ${readiness.ready}`);
+        for (const reason of readiness.reasons)
+            console.log(`  [BLOCKER] ${reason}`);
+        if (readiness.blocked)
+            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, baseline: standardsBaseline },
+const runtime = defineCommand({
+    meta: { name: 'runtime', description: 'Runtime session ledger and completion evidence governance' },
+    subCommands: {
+        start: runtimeStart,
+        end: runtimeEnd,
+        record: runtimeRecord,
+        doctor: runtimeDoctor,
+        'final-check': runtimeFinalCheck,
+    },
 });
 // ============================================================================
-// artifact command - Derived HTML artifacts for human review
+// memory command - runtime evidence + knowledge + graph context packs
 // ============================================================================
-const artifactRender = defineCommand({
-    meta: { name: 'render', description: 'Render a task Markdown source set into a governed HTML artifact' },
+function parseMemoryBudget(value) {
+    if (value === undefined || value === null || value === '')
+        return undefined;
+    const parsed = Number.parseInt(String(value), 10);
+    if (Number.isNaN(parsed) || parsed <= 0) {
+        throw new Error('--budget must be a positive integer.');
+    }
+    return parsed;
+}
+function normalizeMemorySource(value) {
+    const normalized = String(value ?? 'evidence').trim().toLowerCase();
+    if (normalized === 'evidence' || normalized === 'candidate' || normalized === 'failure')
+        return normalized;
+    throw new Error('--from must be evidence, candidate, or failure.');
+}
+function normalizeMemoryNodeType(value) {
+    if (value === undefined || value === null || value === '')
+        return undefined;
+    const normalized = String(value).trim().toLowerCase();
+    if (normalized === 'fact' || normalized === 'decision' || normalized === 'incident' || normalized === 'relation' || normalized === 'contradiction')
+        return normalized;
+    throw new Error('--type must be fact, decision, incident, relation, or contradiction.');
+}
+function normalizeMemoryScope(value) {
+    if (value === undefined || value === null || value === '')
+        return undefined;
+    const normalized = String(value).trim().toLowerCase();
+    if (normalized === 'project' || normalized === 'workspace' || normalized === 'global-candidate')
+        return normalized;
+    throw new Error('--scope must be project, workspace, or global-candidate.');
+}
+function memoryBrain() {
+    return new MemoryBrain({ projectDir: PROJECT_DIR, scaleDir: SCALE_DIR });
+}
+const memoryPack = defineCommand({
+    meta: { name: 'pack', description: 'Build a compact context pack from runtime evidence, session events, knowledge, and graph status' },
     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' },
+        task: { type: 'string', required: true, description: 'Current task or question' },
+        'task-id': { type: 'string', description: 'Task id to scope evidence and session data' },
+        'session-id': { type: 'string', description: 'Session id to scope session events' },
+        level: { type: 'string', default: 'M', description: 'Task level: S, M, L, or CRITICAL' },
+        files: { type: 'string', description: 'Comma-separated files or modules in scope' },
+        budget: { type: 'string', description: 'Maximum estimated tokens for the context pack' },
+        json: { type: 'boolean', default: false },
     },
-    run({ args }) {
-        const result = renderHtmlArtifact({
-            projectDir: args.dir,
+    async run({ args }) {
+        let budgetTokens;
+        try {
+            budgetTokens = parseMemoryBudget(args.budget);
+        }
+        catch (e) {
+            console.error(e.message);
+            process.exit(1);
+        }
+        const { kb } = getEngine();
+        const pack = await new MemoryFabric({
+            projectDir: PROJECT_DIR,
+            scaleDir: SCALE_DIR,
+            knowledgeBase: kb,
+        }).createContextPack({
+            task: args.task,
             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,
+            sessionId: args['session-id'],
+            level: normalizeTaskArtifactLevel(args.level),
+            files: parseCommaList(args.files),
+            budgetTokens,
         });
         if (args.json) {
-            console.log(JSON.stringify(result, null, 2));
+            console.log(JSON.stringify(pack, 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(', ')}`);
-        }
+        console.log(renderContextPackMarkdown(pack));
     },
 });
-const artifactDoctor = defineCommand({
-    meta: { name: 'doctor', description: 'Check HTML artifacts for traceability, stale sources, remote assets, and secret-like content' },
+const memoryDoctor = defineCommand({
+    meta: { name: 'doctor', description: 'Check whether a task context pack is available and within token budget' },
     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' },
+        task: { type: 'string', required: true, description: 'Current task or question' },
+        'task-id': { type: 'string', description: 'Task id to scope evidence and session data' },
+        'session-id': { type: 'string', description: 'Session id to scope session events' },
+        level: { type: 'string', default: 'M', description: 'Task level: S, M, L, or CRITICAL' },
+        files: { type: 'string', description: 'Comma-separated files or modules in scope' },
+        budget: { type: 'string', description: 'Maximum estimated tokens for the context pack' },
+        json: { type: 'boolean', default: false },
     },
-    run({ args }) {
-        const report = doctorHtmlArtifacts({
-            projectDir: args.dir,
+    async run({ args }) {
+        let budgetTokens;
+        try {
+            budgetTokens = parseMemoryBudget(args.budget);
+        }
+        catch (e) {
+            console.error(e.message);
+            process.exit(1);
+        }
+        const { kb } = getEngine();
+        const report = await doctorMemoryFabric({
+            projectDir: PROJECT_DIR,
+            scaleDir: SCALE_DIR,
+            knowledgeBase: kb,
+        }, {
+            task: args.task,
             taskId: args['task-id'],
-            artifactDir: args['artifact-dir'],
-            type: typeof args.type === 'string' ? args.type : undefined,
+            sessionId: args['session-id'],
+            level: normalizeTaskArtifactLevel(args.level),
+            files: parseCommaList(args.files),
+            budgetTokens,
         });
         if (args.json) {
             console.log(JSON.stringify(report, null, 2));
@@ -2147,283 +3468,288 @@ const artifactDoctor = defineCommand({
                 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}`);
-            }
+        console.log('\nSCALE Memory Doctor');
+        console.log(`  Budget: ${report.pack.budget.used}/${report.pack.budget.limit} estimated tokens`);
+        for (const check of report.checks) {
+            console.log(`  [${check.status.toUpperCase()}] ${check.name}: ${check.message}`);
         }
         if (!report.ok)
             process.exitCode = 1;
     },
 });
-const artifactSettle = defineCommand({
-    meta: { name: 'settle', description: 'Record HTML artifact settlement evidence for a task' },
+const memorySettle = defineCommand({
+    meta: { name: 'settle', description: 'Settle runtime evidence into a reviewable memory learning candidate' },
     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' },
+        task: { type: 'string', required: true, description: 'Current task or question' },
+        'task-id': { type: 'string', description: 'Task id to scope evidence and session data' },
+        'session-id': { type: 'string', description: 'Session id to scope session events' },
+        level: { type: 'string', default: 'M', description: 'Task level: S, M, L, or CRITICAL' },
+        files: { type: 'string', description: 'Comma-separated files or modules in scope' },
+        budget: { type: 'string', description: 'Maximum estimated tokens for the context pack' },
+        json: { type: 'boolean', default: false },
     },
-    run({ args }) {
-        const report = settleHtmlArtifacts({
-            projectDir: args.dir,
+    async run({ args }) {
+        let budgetTokens;
+        try {
+            budgetTokens = parseMemoryBudget(args.budget);
+        }
+        catch (e) {
+            console.error(e.message);
+            process.exit(1);
+        }
+        const { kb } = getEngine();
+        const pack = await new MemoryFabric({
+            projectDir: PROJECT_DIR,
+            scaleDir: SCALE_DIR,
+            knowledgeBase: kb,
+        }).createContextPack({
+            task: args.task,
             taskId: args['task-id'],
-            artifactDir: args['artifact-dir'],
+            sessionId: args['session-id'],
+            level: normalizeTaskArtifactLevel(args.level),
+            files: parseCommaList(args.files),
+            budgetTokens,
+        });
+        const settlement = settleMemoryLearning({
+            projectDir: PROJECT_DIR,
+            scaleDir: SCALE_DIR,
+            pack,
         });
         if (args.json) {
-            console.log(JSON.stringify(report, null, 2));
-            if (!report.ok)
-                process.exitCode = 1;
+            console.log(JSON.stringify(settlement, null, 2));
             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;
+        console.log(renderMemoryLearningCandidateMarkdown(settlement.candidate));
+        console.log(`\nWrote: ${settlement.files.markdown}`);
     },
 });
-const artifactOpen = defineCommand({
-    meta: { name: 'open', description: 'Open or print the local file URL for a rendered HTML artifact' },
+const memoryIngest = defineCommand({
+    meta: { name: 'ingest', description: 'Ingest runtime evidence, learning candidates, or failure replays into the project memory brain' },
     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' },
+        from: { type: 'string', default: 'evidence', description: 'Source: evidence, candidate, or failure' },
+        'task-id': { type: 'string', description: 'Task id to scope runtime evidence' },
+        'session-id': { type: 'string', description: 'Session id to scope runtime evidence' },
+        'candidate-id': { type: 'string', description: 'Memory learning candidate id' },
+        'failure-id': { type: 'string', description: 'Workflow eval failure replay id' },
+        type: { type: 'string', description: 'Memory type override: fact/decision/incident/relation/contradiction' },
+        scope: { type: 'string', description: 'Memory scope: project/workspace/global-candidate' },
+        json: { type: 'boolean', default: false },
     },
     run({ args }) {
-        const path = resolveHtmlArtifactForOpen({
-            projectDir: args.dir,
+        let from;
+        let type;
+        let scope;
+        try {
+            from = normalizeMemorySource(args.from);
+            type = normalizeMemoryNodeType(args.type);
+            scope = normalizeMemoryScope(args.scope);
+        }
+        catch (error) {
+            console.error(error.message);
+            process.exit(1);
+            return;
+        }
+        const report = memoryBrain().ingest({
+            from,
             taskId: args['task-id'],
-            artifactDir: args['artifact-dir'],
-            type: typeof args.type === 'string' ? args.type : undefined,
+            sessionId: args['session-id'],
+            candidateId: args['candidate-id'],
+            failureId: args['failure-id'],
+            type,
+            scope,
         });
-        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)
+            console.log(JSON.stringify(report, null, 2));
+            if (!report.ok)
                 process.exitCode = 1;
             return;
         }
-        if (!exists) {
-            console.log(`HTML artifact not found: ${path}`);
+        console.log('\nSCALE Memory Ingest');
+        console.log(`  Source: ${report.source}`);
+        console.log(`  Created: ${report.created}`);
+        console.log(`  Skipped: ${report.skipped}`);
+        for (const node of report.nodes)
+            console.log(`  [${node.status}] ${node.id}: ${node.title}`);
+        for (const warning of report.warnings)
+            console.log(`  [WARN] ${warning}`);
+        if (!report.ok)
             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' });
+const memoryQuery = defineCommand({
+    meta: { name: 'query', description: 'Query concise project-scoped long-term memory with evidence references' },
+    args: {
+        query: { type: 'positional', required: true, description: 'Search query' },
+        limit: { type: 'string', default: '8', description: 'Maximum number of memory nodes' },
+        status: { type: 'string', description: 'Filter by status: candidate/active/stale/rejected' },
+        json: { type: 'boolean', default: false },
+    },
+    run({ args }) {
+        const limit = Number.parseInt(String(args.limit ?? '8'), 10);
+        const status = args.status ? String(args.status) : undefined;
+        const report = memoryBrain().query(String(args.query), {
+            limit: Number.isFinite(limit) && limit > 0 ? limit : 8,
+            status,
+        });
+        if (args.json) {
+            console.log(JSON.stringify(report, null, 2));
+            return;
         }
-        else {
-            execFileSync('xdg-open', [path], { stdio: 'ignore' });
+        console.log('\nSCALE Memory Query');
+        console.log(`  Query: ${report.query}`);
+        console.log(`  Results: ${report.count}`);
+        for (const node of report.nodes) {
+            console.log(`  [${node.status}/${node.type}] ${node.id}: ${node.title}`);
+            console.log(`    confidence: ${node.confidence}; evidence: ${node.evidencePaths.join(', ') || 'none'}`);
+            console.log(`    ${node.summary}`);
         }
-    }
-    catch {
-        // Opening is convenience-only; artifact doctor/render remains the source of truth.
-    }
-}
-// ============================================================================
-// evolve command
-// ============================================================================
-const evolve = defineCommand({
-    meta: { name: 'evolve', description: 'Run evolution cycle (Defect→Lesson→Rule→Hook)' },
-    args: {},
-    async run() {
-        const { store, kb, eventBus } = getEngine();
-        const extractor = new LessonExtractor(store, kb, eventBus);
-        const proposer = new RuleProposer(kb, eventBus);
-        const generator = new HookGenerator(eventBus);
-        const engine = new EvolutionEngine(extractor, proposer, generator, eventBus, SCALE_DIR);
-        const stats = await engine.runCycle();
-        console.log(JSON.stringify(stats, null, 2));
     },
 });
-// ============================================================================
-// doctor command
-// ============================================================================
-const doctor = defineCommand({
-    meta: { name: 'doctor', description: 'Diagnose SCALE Engine health' },
+const memoryContradictions = defineCommand({
+    meta: { name: 'contradictions', description: 'Report conflicting project memory instead of silently resolving it' },
     args: {
-        dir: { type: 'string', default: '.', description: 'Project directory' },
-        json: { type: 'boolean', default: false, description: 'Output as JSON' },
+        json: { type: 'boolean', default: false },
     },
-    async run({ args }) {
-        const doc = new Doctor(args.dir);
-        const report = await doc.diagnose();
+    run({ args }) {
+        const report = memoryBrain().contradictions();
         if (args.json) {
             console.log(JSON.stringify(report, null, 2));
+            if (!report.ok)
+                process.exitCode = 1;
+            return;
         }
-        else {
-            console.log(doc.formatReport(report));
+        console.log('\nSCALE Memory Contradictions');
+        console.log(`  Count: ${report.count}`);
+        for (const item of report.contradictions) {
+            console.log(`  [CONFLICT] ${item.title}`);
+            console.log(`    nodes: ${item.nodeIds.join(', ')}`);
+            console.log(`    evidence: ${item.evidencePaths.join(', ') || 'none'}`);
         }
-        process.exitCode = report.overall === 'broken' ? 1 : 0;
+        if (!report.ok)
+            process.exitCode = 1;
     },
 });
-// ============================================================================
-// workflow command — 列出/查看工作流预设
-// ============================================================================
-const workflowList = defineCommand({
-    meta: { name: 'list', description: 'List all workflow presets' },
+const memoryDream = defineCommand({
+    meta: { name: 'dream', description: 'Run memory maintenance: duplicates, stale memories, contradictions, and promotion candidates' },
     args: {
-        scenario: { type: 'string', description: 'Filter by scenario mode (sandbox/standard/critical)' },
-        json: { type: 'boolean', default: false, description: 'Output workflow presets as JSON' },
+        json: { type: 'boolean', default: false },
     },
-    async run({ args }) {
-        const presets = args.scenario
-            ? getPresetsByScenario(args.scenario)
-            : listWorkflowPresets();
+    run({ args }) {
+        const report = memoryBrain().dream();
         if (args.json) {
-            console.log(JSON.stringify({
-                ok: true,
-                scenario: args.scenario ?? null,
-                count: presets.length,
-                presets: presets.map(preset => ({
-                    id: preset.id,
-                    name: preset.name,
-                    nameZh: preset.nameZh,
-                    description: preset.description,
-                    scenarioMode: preset.scenarioMode,
-                    requiredArtifacts: preset.requiredArtifacts,
-                    steps: preset.steps,
-                })),
-            }, null, 2));
-            return;
-        }
-        if (presets.length === 0) {
-            console.log('No workflow presets found.');
+            console.log(JSON.stringify(report, null, 2));
+            if (!report.ok)
+                process.exitCode = 1;
             return;
         }
-        console.log('\n📋 SCALE Engine Workflow Presets');
-        console.log('═══════════════════════════════════════════════════════');
-        for (const preset of presets) {
-            const modeEmoji = { sandbox: '🏖️', standard: '⚙️', critical: '🔒' }[preset.scenarioMode];
-            const mandatorySteps = preset.steps.filter((s) => s.isMandatory).length;
-            const totalSteps = preset.steps.length;
-            console.log(`\n  ${preset.nameZh} (${preset.id})`);
-            console.log(`  ${preset.description}`);
-            console.log(`  Mode: ${modeEmoji} ${preset.scenarioMode} · Steps: ${mandatorySteps}/${totalSteps} mandatory`);
-            if (preset.requiredArtifacts.length > 0) {
-                console.log(`  Requires: ${preset.requiredArtifacts.map((a) => `${a.type}${a.status ? `(${a.status})` : ''}`).join(', ')}`);
-            }
-            // Show step summary
-            for (const step of preset.steps) {
-                const marker = step.isMandatory ? '●' : '○';
-                const gate = step.verificationGate ? ` ⊓ ${step.verificationGate}` : '';
-                console.log(`    ${marker} ${step.stepId}: ${step.action}${gate}`);
-            }
-        }
-        console.log('\n═══════════════════════════════════════════════════════');
-        console.log('\nUsage: scale workflow show <preset-id>');
+        console.log('\nSCALE Memory Dream');
+        console.log(`  Total: ${report.summary.total}`);
+        console.log(`  Active: ${report.summary.active}`);
+        console.log(`  Candidates: ${report.summary.candidate}`);
+        console.log(`  Contradictions: ${report.summary.contradictions}`);
+        console.log(`  Duplicate groups: ${report.summary.duplicateGroups}`);
+        for (const item of report.promotionCandidates)
+            console.log(`  [PROMOTE?] ${item.id}: ${item.title}`);
+        for (const item of report.staleCandidates)
+            console.log(`  [STALE] ${item.id}: ${item.reason}`);
+        if (!report.ok)
+            process.exitCode = 1;
     },
 });
-const workflow = defineCommand({
-    meta: { name: 'workflow', description: 'Workflow preset management' },
-    subCommands: { list: workflowList },
-});
-const evidenceList = defineCommand({
-    meta: { name: 'list', description: 'List persisted gate evidence records' },
+const memoryPromote = defineCommand({
+    meta: { name: 'promote', description: 'Promote a memory candidate to active project memory after evidence review' },
     args: {
-        limit: { type: 'string', default: '20', description: 'Maximum number of records' },
+        id: { type: 'positional', required: true, description: 'Memory node id or learning candidate id' },
+        scope: { type: 'string', description: 'Scope override: project/workspace/global-candidate' },
         json: { type: 'boolean', default: false },
     },
-    async run({ args }) {
-        const store = new EvidenceStore(SCALE_DIR);
-        const records = store.listGateResults(parseInt(args.limit, 10) || 20);
-        if (args.json) {
-            console.log(JSON.stringify(records, null, 2));
-            return;
+    run({ args }) {
+        let scope;
+        try {
+            scope = normalizeMemoryScope(args.scope);
         }
-        if (records.length === 0) {
-            console.log('No evidence records found.');
+        catch (error) {
+            console.error(error.message);
+            process.exit(1);
             return;
         }
-        console.log('\nSCALE Evidence Records');
-        for (const record of records) {
-            const status = record.passed ? 'PASS' : record.status;
-            const blockers = record.blockers.length > 0 ? ` blockers=${record.blockers.length}` : '';
-            console.log(`  ${record.id}  ${record.gate}  ${status}  ${new Date(record.createdAt).toISOString()}${blockers}`);
+        const report = memoryBrain().promote(String(args.id), { scope });
+        if (args.json) {
+            console.log(JSON.stringify(report, null, 2));
+            if (!report.ok)
+                process.exitCode = 1;
+            return;
         }
-        console.log('\nUsage: scale evidence show <id>');
+        console.log('\nSCALE Memory Promote');
+        console.log(`  Status: ${report.ok ? 'promoted' : 'blocked'}`);
+        if (report.node)
+            console.log(`  Node: ${report.node.id} (${report.node.status})`);
+        for (const warning of report.warnings)
+            console.log(`  [WARN] ${warning}`);
+        if (!report.ok)
+            process.exitCode = 1;
     },
 });
-const evidenceShow = defineCommand({
-    meta: { name: 'show', description: 'Show a persisted gate evidence record' },
+const memoryExport = defineCommand({
+    meta: { name: 'export', description: 'Export project memory as JSONL' },
     args: {
-        id: { type: 'positional', required: true },
+        output: { type: 'string', alias: 'o', description: 'Output JSONL file; stdout when omitted' },
         json: { type: 'boolean', default: false },
     },
-    async run({ args }) {
-        const store = new EvidenceStore(SCALE_DIR);
-        const record = store.getGateResult(args.id);
-        if (!record) {
-            console.error(`Evidence record not found: ${args.id}`);
-            process.exit(1);
+    run({ args }) {
+        const jsonl = memoryBrain().exportJsonl();
+        if (args.output) {
+            const outputPath = resolve(PROJECT_DIR, String(args.output));
+            ensureDir(dirname(outputPath));
+            writeFileSync(outputPath, jsonl, 'utf-8');
+            if (args.json) {
+                console.log(JSON.stringify({ ok: true, outputPath, bytes: jsonl.length }, null, 2));
+                return;
+            }
+            console.log(`[OK] Memory JSONL exported: ${outputPath}`);
+            return;
         }
+        console.log(jsonl);
+    },
+});
+const memoryImport = defineCommand({
+    meta: { name: 'import', description: 'Import project memory from JSONL' },
+    args: {
+        file: { type: 'positional', required: true, description: 'Input JSONL file' },
+        json: { type: 'boolean', default: false },
+    },
+    run({ args }) {
+        const filePath = resolve(PROJECT_DIR, String(args.file));
+        const report = memoryBrain().importJsonl(filePath);
         if (args.json) {
-            console.log(JSON.stringify(record, null, 2));
+            console.log(JSON.stringify(report, null, 2));
+            if (!report.ok)
+                process.exitCode = 1;
             return;
         }
-        console.log(`\nEvidence: ${record.id}`);
-        console.log(`Gate: ${record.gate}`);
-        console.log(`Status: ${record.status}`);
-        console.log(`Passed: ${record.passed}`);
-        console.log(`Created: ${new Date(record.createdAt).toISOString()}`);
-        console.log(`Duration: ${record.durationMs}ms`);
-        if (record.blockers.length > 0) {
-            console.log('\nBlockers:');
-            for (const blocker of record.blockers)
-                console.log(`  - ${blocker}`);
-        }
-        console.log('\nEvidence Items:');
-        for (const item of record.evidenceItems) {
-            const status = item.passed ? 'PASS' : 'FAIL';
-            const target = item.command ?? item.path ?? '';
-            console.log(`  - [${status}] ${item.label}${target ? ` (${target})` : ''}`);
-            console.log(`    ${item.detail}`);
-        }
+        console.log('\nSCALE Memory Import');
+        console.log(`  Imported: ${report.imported}`);
+        console.log(`  Skipped: ${report.skipped}`);
+        for (const warning of report.warnings)
+            console.log(`  [WARN] ${warning}`);
+        if (!report.ok)
+            process.exitCode = 1;
     },
 });
-const evidence = defineCommand({
-    meta: { name: 'evidence', description: 'Persisted gate evidence inspection' },
-    subCommands: { list: evidenceList, show: evidenceShow },
+const memory = defineCommand({
+    meta: { name: 'memory', description: 'Memory Fabric context packs and project-scoped long-term memory' },
+    subCommands: {
+        pack: memoryPack,
+        doctor: memoryDoctor,
+        settle: memorySettle,
+        ingest: memoryIngest,
+        query: memoryQuery,
+        contradictions: memoryContradictions,
+        dream: memoryDream,
+        promote: memoryPromote,
+        export: memoryExport,
+        import: memoryImport,
+    },
 });
 // ============================================================================
 // out-of-scope command — 借鉴 mattpocock/skills 的 .out-of-scope/ 设计
@@ -2619,13 +3945,16 @@ const skillPlanCommand = defineCommand({
 const skillDoctorCommand = defineCommand({
     meta: { name: 'doctor', description: 'Check workflow skill installation status' },
     args: {
-        dir: { type: 'string', default: '.', description: 'Project directory' },
+        dir: { type: 'string', default: PROJECT_DIR, description: 'Project directory' },
+        'supply-chain': { type: 'boolean', default: false, description: 'Include supply-chain safety review for known skill sources' },
         json: { type: 'boolean', default: false, description: 'Output skill doctor report as JSON' },
     },
     run({ args }) {
-        const report = inspectWorkflowSkills({ projectDir: args.dir });
+        const projectDir = resolve(String(args.dir ?? PROJECT_DIR));
+        const report = inspectWorkflowSkills({ projectDir });
+        const supplyChain = isTruthyFlag(args['supply-chain']) ? inspectSkillSupplyChain({ projectDir }) : undefined;
         if (args.json) {
-            console.log(JSON.stringify(report, null, 2));
+            console.log(JSON.stringify(supplyChain ? { installation: report, supplyChain } : report, null, 2));
             return;
         }
         console.log('\nSCALE Skill Doctor');
@@ -2637,7 +3966,18 @@ const skillDoctorCommand = defineCommand({
             if (!skill.installed)
                 console.log(`    install: ${skill.installCommand}`);
         }
-        if (!report.ok)
+        if (supplyChain) {
+            console.log('\nSkill Supply Chain');
+            console.log(`  Evaluated: ${supplyChain.evaluated}`);
+            console.log(`  Blocked: ${supplyChain.blocked}`);
+            console.log(`  Warnings: ${supplyChain.warnings}`);
+            for (const entry of supplyChain.entries.filter(entry => entry.blocked || entry.findings.length > 0)) {
+                console.log(`  [${entry.blocked ? 'BLOCKED' : 'WARN'}] ${entry.id}: ${entry.risk}`);
+                for (const finding of entry.findings)
+                    console.log(`    - ${finding.rule}: ${finding.message}`);
+            }
+        }
+        if (!report.ok || supplyChain?.ok === false)
             process.exitCode = 1;
     },
 });
@@ -2749,6 +4089,59 @@ const skillSafetyCommand = defineCommand({
             process.exitCode = 1;
     },
 });
+const skillRadarCommand = defineCommand({
+    meta: { name: 'radar', description: 'Recommend skills, MCP, and CLI capabilities with confidence, safety, and evidence requirements' },
+    args: {
+        task: { type: 'string', required: true, description: 'Task description' },
+        phase: { type: 'string', description: 'Workflow phase' },
+        level: { type: 'string', default: 'M', description: 'Task level: S, M, L, or CRITICAL' },
+        files: { type: 'string', description: 'Comma-separated changed or relevant files' },
+        services: { type: 'string', description: 'Comma-separated services or modules' },
+        dir: { type: 'string', default: PROJECT_DIR, description: 'Project directory' },
+        output: { type: 'string', alias: 'o', description: 'Write markdown report to file' },
+        json: { type: 'boolean', default: false, description: 'Output radar report as JSON' },
+    },
+    run({ args }) {
+        const projectDir = resolve(String(args.dir ?? PROJECT_DIR));
+        const scaleDir = resolveScaleDirForProject(projectDir);
+        const report = evaluateSkillRadar({
+            projectDir,
+            scaleDir,
+            task: String(args.task),
+            phase: args.phase ? String(args.phase) : undefined,
+            level: String(args.level ?? 'M'),
+            files: parseCommaList(args.files),
+            services: parseCommaList(args.services),
+        });
+        if (args.output) {
+            const outputPath = resolve(projectDir, String(args.output));
+            ensureDir(dirname(outputPath));
+            writeFileSync(outputPath, renderSkillRadarMarkdown(report), 'utf-8');
+        }
+        if (args.json) {
+            console.log(JSON.stringify(report, null, 2));
+            if (!report.ok)
+                process.exitCode = 1;
+            return;
+        }
+        console.log('\nSCALE Skill Radar');
+        console.log(`  Task: ${report.task}`);
+        console.log(`  Level: ${report.level}`);
+        console.log(`  Domains: ${report.detectedDomains.map(domain => `${domain.domain}:${domain.score}`).join(', ') || 'none'}`);
+        console.log(`  Policy: ${report.policyMode}`);
+        console.log(`  Tools: ${report.toolSummary.installed}/${report.toolSummary.total} installed`);
+        for (const item of report.recommendations.slice(0, 8)) {
+            console.log(`  [${item.action}] ${item.id} confidence=${item.confidence.toFixed(2)} safety=${item.safetyLevel}`);
+            console.log(`    evidence: ${item.requiredEvidence.join(', ') || 'none'}`);
+            if (item.safetyLevel === 'blocked' || item.action === 'suggest-fallback')
+                console.log(`    fallback: ${item.fallback}`);
+        }
+        if (args.output)
+            console.log(`  Report: ${resolve(projectDir, String(args.output))}`);
+        if (!report.ok)
+            process.exitCode = 1;
+    },
+});
 const skillRecommendCommand = defineCommand({
     meta: { name: 'recommend', description: 'Recommend a composable skill workflow for a task' },
     args: {
@@ -2783,6 +4176,7 @@ const skill = defineCommand({
         check: skillCheckCommand,
         repo: skillRepoCommand,
         safety: skillSafetyCommand,
+        radar: skillRadarCommand,
         recommend: skillRecommendCommand,
     },
 });
@@ -3211,6 +4605,8 @@ const main = defineCommand({
         stats,
         preflight,
         governance,
+        codegraph,
+        eval: evalCommand,
         artifact,
         assets,
         standards,
@@ -3220,6 +4616,8 @@ const main = defineCommand({
         status,
         workflow,
         evidence,
+        runtime,
+        memory,
         diagnose,
         tdd,
         tool,