@hongmaple0820/scale-engine 0.46.0 → 0.48.0

package/dist/cli/dependencyTddCommands.js

@@ -0,0 +1,174 @@
+// SCALE Engine — Dependency, TDD, Stats, and Metrics Commands
+import { defineCommand } from 'citty';
+import { getEngine, SCALE_DIR, PROJECT_DIR, isTruthyFlag, commandEvidence } from './engineBootstrap.js';
+import { auditDependencies } from '../guardrails/DependencyAuditor.js';
+import { createTddSlice, evaluateTddSlice, renderTddSliceMarkdown, } from '../workflow/TddLoop.js';
+import { removeWorkflowOpenTask } from '../workflow/WorkflowOpenTasks.js';
+import { TaskMetricsStore } from '../workflow/TaskMetricsStore.js';
+import { WorkflowArtifactWriter } from '../workflow/WorkflowArtifactWriter.js';
+import { appendTddSliceArtifact, } from '../workflow/TaskArtifactScaffolder.js';
+import { join } from 'node:path';
+function parseCommaList(value) {
+    if (value === undefined || value === null || value === '')
+        return [];
+    return String(value).split(',').map(s => s.trim()).filter(s => s.length > 0);
+}
+export const dependencyAuditCommand = defineCommand({
+    meta: { name: 'audit', description: 'Audit lockfile-scoped dependency supply-chain risk' },
+    args: {
+        dir: { type: 'string', default: PROJECT_DIR, description: 'Project directory' },
+        mode: { type: 'string', description: 'Audit mode: compatibility, strict, or offline' },
+        'changed-packages': { type: 'string', description: 'Comma-separated package names to audit instead of direct dependencies' },
+        json: { type: 'boolean', default: false },
+    },
+    run({ args }) {
+        const mode = args.mode === 'compatibility' || args.mode === 'strict' || args.mode === 'offline'
+            ? args.mode
+            : undefined;
+        const report = auditDependencies({
+            projectDir: args.dir ? String(args.dir) : PROJECT_DIR,
+            mode,
+            changedPackages: parseCommaList(args['changed-packages']),
+        });
+        if (args.json) {
+            console.log(JSON.stringify(report, null, 2));
+        }
+        else {
+            console.log(`SCALE Dependency Audit: ${report.ok ? 'OK' : 'FAILED'}`);
+            console.log(`  Packages audited: ${report.summary.packagesAudited}`);
+            console.log(`  Findings: ${report.summary.totalFindings}`);
+            console.log(`  Mode: ${report.mode}`);
+            for (const finding of report.findings.slice(0, 20)) {
+                console.log(`  [${finding.severity}] ${finding.ruleId} ${finding.packageName}${finding.version ? `@${finding.version}` : ''}: ${finding.message}`);
+            }
+            if (report.findings.length > 20)
+                console.log(`  ... ${report.findings.length - 20} more finding(s)`);
+        }
+        if (!report.ok)
+            process.exitCode = 1;
+    },
+});
+export const dependencyCommand = defineCommand({
+    meta: { name: 'dependency', description: 'Supply-chain dependency governance' },
+    subCommands: { audit: dependencyAuditCommand },
+});
+export 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] ?? '',
+            });
+            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}`);
+    },
+});
+export const tddCommand = defineCommand({
+    meta: { name: 'tdd', description: 'TDD vertical slice workflows' },
+    subCommands: { slice: tddSliceCommand },
+});
+export const statsCommand = 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));
+    },
+});
+export const metricsListCommand = 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}`);
+        }
+    },
+});
+export const metricsCommand = defineCommand({
+    meta: { name: 'metrics', description: 'Inspect workflow task metrics' },
+    subCommands: { list: metricsListCommand },
+});
+//# sourceMappingURL=dependencyTddCommands.js.map

package/dist/cli/dependencyTddCommands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependencyTddCommands.js","sourceRoot":"","sources":["../../src/cli/dependencyTddCommands.ts"],"names":[],"mappings":"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"}

package/dist/cli/diagnoseHuntCommands.d.ts

@@ -0,0 +1,135 @@
+export declare const diagnosePlanCommand: import("citty").CommandDef<{
+    'task-id': {
+        type: "string";
+        required: true;
+    };
+    symptom: {
+        type: "string";
+        required: true;
+    };
+    repro: {
+        type: "string";
+        description: string;
+    };
+    'expected-failure': {
+        type: "string";
+        description: string;
+    };
+    files: {
+        type: "string";
+        description: string;
+    };
+    verify: {
+        type: "string";
+        description: string;
+    };
+    'artifact-dir': {
+        type: "string";
+        description: string;
+    };
+    write: {
+        type: "boolean";
+        default: false;
+        description: string;
+    };
+    json: {
+        type: "boolean";
+        default: false;
+    };
+}>;
+export declare const diagnoseCommand: import("citty").CommandDef<import("citty").ArgsDef>;
+export declare const huntScanCommand: import("citty").CommandDef<{
+    dir: {
+        type: "string";
+        default: string;
+        description: string;
+    };
+    changed: {
+        type: "boolean";
+        default: false;
+        description: string;
+    };
+    'changed-files': {
+        type: "string";
+        description: string;
+    };
+    json: {
+        type: "boolean";
+        default: false;
+    };
+}>;
+export declare const huntReportCommand: import("citty").CommandDef<{
+    dir: {
+        type: "string";
+        default: string;
+        description: string;
+    };
+    changed: {
+        type: "boolean";
+        default: false;
+        description: string;
+    };
+    'changed-files': {
+        type: "string";
+        description: string;
+    };
+    json: {
+        type: "boolean";
+        default: false;
+    };
+}>;
+export declare const huntDiagnoseCommand: import("citty").CommandDef<{
+    id: {
+        type: "positional";
+        required: true;
+        description: string;
+    };
+    dir: {
+        type: "string";
+        default: string;
+        description: string;
+    };
+    changed: {
+        type: "boolean";
+        default: false;
+        description: string;
+    };
+    'changed-files': {
+        type: "string";
+        description: string;
+    };
+    json: {
+        type: "boolean";
+        default: false;
+    };
+}>;
+export declare const huntIgnoreCommand: import("citty").CommandDef<{
+    id: {
+        type: "positional";
+        required: true;
+        description: string;
+    };
+    reason: {
+        type: "string";
+        description: string;
+    };
+    dir: {
+        type: "string";
+        default: string;
+        description: string;
+    };
+    changed: {
+        type: "boolean";
+        default: false;
+        description: string;
+    };
+    'changed-files': {
+        type: "string";
+        description: string;
+    };
+    json: {
+        type: "boolean";
+        default: false;
+    };
+}>;
+export declare const huntCommand: import("citty").CommandDef<import("citty").ArgsDef>;

package/dist/cli/diagnoseHuntCommands.js

@@ -0,0 +1,224 @@
+// SCALE Engine — Diagnose and Hunt Commands
+import { defineCommand } from 'citty';
+import { SCALE_DIR, PROJECT_DIR, isTruthyFlag } from './engineBootstrap.js';
+import { WorkflowArtifactWriter } from '../workflow/WorkflowArtifactWriter.js';
+import { createDiagnosticLoop, renderDiagnosticLoopMarkdown, validateDiagnosticLoop, } from '../workflow/DiagnosticLoop.js';
+import { BackgroundHunter, HuntFindingStore } from '../workflow/autonomous/BackgroundHunter.js';
+import { removeWorkflowOpenTask } from '../workflow/WorkflowOpenTasks.js';
+import { appendDiagnosticLoopArtifact } from '../workflow/TaskArtifactScaffolder.js';
+function parseCommaList(value) {
+    if (value === undefined || value === null || value === '')
+        return [];
+    return String(value).split(',').map(s => s.trim()).filter(s => s.length > 0);
+}
+function uniqueStrings(items) {
+    return [...new Set(items)];
+}
+function resolveChangedFilesArg(args) {
+    if (args['changed-files'])
+        return parseCommaList(args['changed-files']);
+    if (!args.changed)
+        return undefined;
+    return undefined;
+}
+export 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,
+                    ]),
+            });
+        }
+        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}`);
+    },
+});
+export const diagnoseCommand = defineCommand({
+    meta: { name: 'diagnose', description: 'Evidence-first debugging workflows' },
+    subCommands: { plan: diagnosePlanCommand },
+});
+function createBackgroundHunter(args) {
+    return new BackgroundHunter({ projectDir: args.dir ? String(args.dir) : PROJECT_DIR });
+}
+export const huntScanCommand = defineCommand({
+    meta: { name: 'scan', description: 'Run a readonly proactive governance scan' },
+    args: {
+        dir: { type: 'string', default: PROJECT_DIR, 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 },
+    },
+    run({ args }) {
+        const report = createBackgroundHunter(args).scan({
+            changedFiles: resolveChangedFilesArg(args),
+        });
+        if (args.json) {
+            console.log(JSON.stringify(report, null, 2));
+            return;
+        }
+        printHuntReport(report);
+    },
+});
+export const huntReportCommand = defineCommand({
+    meta: { name: 'report', description: 'Print open and ignored hunt findings' },
+    args: {
+        dir: { type: 'string', default: PROJECT_DIR, 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 },
+    },
+    run({ args }) {
+        const report = createBackgroundHunter(args).scan({
+            changedFiles: resolveChangedFilesArg(args),
+        });
+        if (args.json) {
+            console.log(JSON.stringify(report, null, 2));
+            return;
+        }
+        printHuntReport(report);
+    },
+});
+export const huntDiagnoseCommand = defineCommand({
+    meta: { name: 'diagnose', description: 'Create a diagnostic loop from a hunt finding' },
+    args: {
+        id: { type: 'positional', required: true, description: 'Hunt finding id' },
+        dir: { type: 'string', default: PROJECT_DIR, 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 },
+    },
+    run({ args }) {
+        const report = createBackgroundHunter(args).scan({
+            changedFiles: resolveChangedFilesArg(args),
+        });
+        const finding = report.findings.find(item => item.id === String(args.id));
+        if (!finding) {
+            console.error(`Hunt finding not found: ${String(args.id)}`);
+            process.exitCode = 1;
+            return;
+        }
+        const loop = createDiagnosticLoop(finding.diagnosticInput);
+        const validation = validateDiagnosticLoop(loop);
+        if (args.json) {
+            console.log(JSON.stringify({ finding, loop, validation }, null, 2));
+            return;
+        }
+        console.log(renderDiagnosticLoopMarkdown(loop));
+        if (!validation.ready) {
+            console.log('\nBlockers:');
+            for (const blocker of validation.blockers)
+                console.log(`  - ${blocker}`);
+        }
+    },
+});
+export const huntIgnoreCommand = defineCommand({
+    meta: { name: 'ignore', description: 'Ignore a stable hunt finding fingerprint' },
+    args: {
+        id: { type: 'positional', required: true, description: 'Hunt finding id' },
+        reason: { type: 'string', description: 'Why this finding is accepted or deferred' },
+        dir: { type: 'string', default: PROJECT_DIR, 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 },
+    },
+    run({ args }) {
+        const projectDir = args.dir ? String(args.dir) : PROJECT_DIR;
+        const report = new BackgroundHunter({ projectDir }).scan({
+            changedFiles: resolveChangedFilesArg(args),
+        });
+        const finding = report.findings.find(item => item.id === String(args.id));
+        if (!finding) {
+            console.error(`Hunt finding not found: ${String(args.id)}`);
+            process.exitCode = 1;
+            return;
+        }
+        const ignored = new HuntFindingStore({ projectDir }).ignore({
+            id: finding.id,
+            fingerprint: finding.fingerprint,
+            reason: args.reason ? String(args.reason) : undefined,
+            ignoredAt: new Date().toISOString(),
+        });
+        if (args.json) {
+            console.log(JSON.stringify({ ignored }, null, 2));
+            return;
+        }
+        console.log(`Ignored hunt finding: ${ignored.id}`);
+        if (ignored.reason)
+            console.log(`  Reason: ${ignored.reason}`);
+    },
+});
+export const huntCommand = defineCommand({
+    meta: { name: 'hunt', description: 'Readonly proactive governance scans' },
+    subCommands: {
+        scan: huntScanCommand,
+        report: huntReportCommand,
+        diagnose: huntDiagnoseCommand,
+        ignore: huntIgnoreCommand,
+    },
+});
+function printHuntReport(report) {
+    console.log('SCALE Hunt Report');
+    console.log(`  Project: ${report.projectDir}`);
+    console.log(`  Open findings: ${report.summary.open}`);
+    console.log(`  Ignored findings: ${report.summary.ignored}`);
+    console.log(`  Blocking findings: ${report.summary.blocking}`);
+    for (const finding of report.findings.slice(0, 20)) {
+        const line = finding.line ? `:${finding.line}` : '';
+        const status = finding.status === 'ignored' ? 'IGNORED' : finding.severity.toUpperCase();
+        console.log(`  [${status}] ${finding.id} ${finding.ruleId} ${finding.path ?? 'project'}${line}: ${finding.message}`);
+    }
+    if (report.findings.length > 20)
+        console.log(`  ... ${report.findings.length - 20} more finding(s)`);
+}
+//# sourceMappingURL=diagnoseHuntCommands.js.map

package/dist/cli/diagnoseHuntCommands.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnoseHuntCommands.js","sourceRoot":"","sources":["../../src/cli/diagnoseHuntCommands.ts"],"names":[],"mappings":"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"}

package/dist/cli/engineBootstrap.d.ts

@@ -0,0 +1,39 @@
+import { EventBus } from '../core/eventBus.js';
+import { SQLiteArtifactStore } from '../artifact/sqliteStore.js';
+import { FSM } from '../artifact/fsm.js';
+import { Gateway } from '../guardrails/Gateway.js';
+import { RoleGateDetector } from '../guardrails/advancedDetectors.js';
+import { GraphifyKnowledgeBase } from '../knowledge/GraphifyKnowledgeBase.js';
+import { ContextBuilder } from '../context/ContextBuilder.js';
+import { FSMAgentBridge } from '../fsm/FSMAgentBridge.js';
+import { WorkflowEngine } from '../workflow/WorkflowEngine.js';
+import type { GateStage } from '../workflow/types.js';
+import type { GovernanceMode } from '../workflow/GovernanceTemplates.js';
+import type { TddCommandEvidence } from '../workflow/TddLoop.js';
+export declare const SCALE_DIR: string;
+export declare const PROJECT_DIR: string;
+export declare const DB_PATH: string;
+export declare function ensureDir(dir: string): void;
+export declare function isTruthyFlag(value: unknown): boolean;
+export declare function governanceModeFromScenario(scenario: string): GovernanceMode;
+export declare function profileFromScenario(scenario: string): string;
+export declare function writeConfigYaml(projectDir: string, profileId: string, projectName: string, agents: string[]): string;
+export declare function commandEvidence(command: string, exitCode: unknown, summary: unknown): TddCommandEvidence | undefined;
+export type PreflightProfile = 'quick' | 'full' | 'ci';
+export declare function normalizePreflightProfile(value: unknown): PreflightProfile;
+export declare function gatesForPreflightProfile(profile: PreflightProfile): GateStage[];
+export declare function resolveScaleDirForProject(projectDir: string): string;
+interface Engine {
+    eventBus: EventBus;
+    store: SQLiteArtifactStore;
+    fsm: FSM;
+    gateway: Gateway;
+    roleGate: RoleGateDetector;
+    kb: GraphifyKnowledgeBase;
+    ctx: ContextBuilder;
+    fsmAgentBridge: FSMAgentBridge;
+    workflowEngine: WorkflowEngine;
+}
+export declare function getEngine(): Engine;
+export declare function createVerificationWorkflowEngine(scaleDir: string): WorkflowEngine;
+export {};