@hongmaple0820/scale-engine 0.12.3 → 0.14.0

package/dist/workflow/TaskMetricsStore.js

@@ -0,0 +1,149 @@
+import { appendFileSync, existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+export class TaskMetricsStore {
+    constructor(scaleDir = process.env.SCALE_DIR ?? '.scale') {
+        this.metricsDir = join(scaleDir, 'metrics');
+        this.recordsPath = join(this.metricsDir, 'tasks.jsonl');
+    }
+    append(record) {
+        if (!existsSync(this.metricsDir))
+            mkdirSync(this.metricsDir, { recursive: true });
+        appendFileSync(this.recordsPath, JSON.stringify(record) + '\n', 'utf-8');
+    }
+    upsert(record) {
+        const records = this.list();
+        const index = records.findIndex(candidate => candidate.taskId === record.taskId);
+        if (index >= 0)
+            records[index] = record;
+        else
+            records.push(record);
+        this.writeAll(records);
+    }
+    recordVerification(input) {
+        const previous = this.findByTaskId(input.taskId);
+        const finalGateStatus = input.finalGateStatus ?? (input.passed ? 'passed' : 'failed');
+        const additionalIteration = previous && !(previous.finalGateStatus === 'passed' && finalGateStatus === 'passed') ? 1 : 0;
+        const firstVerificationPass = previous?.firstVerificationPass ?? input.passed;
+        const fixIterations = (previous?.fixIterations ?? 0) + additionalIteration;
+        const record = {
+            date: input.date ?? currentDate(),
+            taskId: input.taskId,
+            taskName: input.taskName,
+            level: input.level,
+            services: input.services ?? [],
+            filesChanged: input.filesChanged ?? 0,
+            firstVerificationPass,
+            fixIterations,
+            reworkNeeded: !firstVerificationPass || fixIterations > 0,
+            artifactComplete: input.artifactComplete ?? false,
+            residualRisk: input.residualRisk ?? '',
+            finalGateStatus,
+        };
+        this.upsert(record);
+        return record;
+    }
+    list() {
+        if (!existsSync(this.recordsPath))
+            return [];
+        return readFileSync(this.recordsPath, 'utf-8')
+            .split('\n')
+            .map(line => line.trim())
+            .filter(Boolean)
+            .map(line => JSON.parse(line));
+    }
+    findByTaskId(taskId) {
+        const records = this.list();
+        for (let i = records.length - 1; i >= 0; i -= 1) {
+            if (records[i].taskId === taskId)
+                return records[i];
+        }
+        return undefined;
+    }
+    summarize() {
+        const records = this.list();
+        if (records.length === 0) {
+            return {
+                total: 0,
+                firstPassRate: 0,
+                averageFixIterations: 0,
+                artifactCompletenessRate: 0,
+                residualRiskClarityRate: 0,
+            };
+        }
+        return {
+            total: records.length,
+            firstPassRate: ratio(records.filter(record => record.firstVerificationPass).length, records.length),
+            averageFixIterations: records.reduce((sum, record) => sum + record.fixIterations, 0) / records.length,
+            artifactCompletenessRate: ratio(records.filter(record => record.artifactComplete).length, records.length),
+            residualRiskClarityRate: ratio(records.filter(record => record.residualRisk.trim().length > 0).length, records.length),
+        };
+    }
+    toMarkdownRow(record) {
+        return [
+            record.date,
+            record.taskName,
+            record.level,
+            record.services.join(', '),
+            String(record.filesChanged),
+            record.firstVerificationPass ? 'yes' : 'no',
+            String(record.fixIterations),
+            record.reworkNeeded ? 'yes' : 'no',
+            record.artifactComplete ? 'yes' : 'no',
+            record.residualRisk || 'none stated',
+            record.finalGateStatus,
+        ].map(escapeCell).join(' | ');
+    }
+    writeMarkdownReport(projectDir = process.cwd()) {
+        const target = join(projectDir, 'docs', 'worklog', 'metrics.md');
+        const dir = join(projectDir, 'docs', 'worklog');
+        if (!existsSync(dir))
+            mkdirSync(dir, { recursive: true });
+        const section = this.renderGeneratedMarkdownSection();
+        const existing = existsSync(target) ? readFileSync(target, 'utf-8') : '# Workflow Metrics\n\n';
+        const next = replaceGeneratedSection(existing, section);
+        writeFileSync(target, next, 'utf-8');
+        return target;
+    }
+    renderGeneratedMarkdownSection() {
+        const summary = this.summarize();
+        const rows = this.list().map(record => `| ${this.toMarkdownRow(record)} |`);
+        return [
+            '<!-- SCALE_METRICS:START -->',
+            `Total tasks: ${summary.total}`,
+            `First-pass verification rate: ${(summary.firstPassRate * 100).toFixed(1)}%`,
+            `Average fix iterations: ${summary.averageFixIterations.toFixed(2)}`,
+            `Artifact completeness: ${(summary.artifactCompletenessRate * 100).toFixed(1)}%`,
+            '',
+            '| Date | Task | Level | Services | Files Changed | First Verification Pass | Fix Iterations | Rework Needed | Artifact Complete | Residual Risk | Final Gate |',
+            '| --- | --- | --- | --- | ---: | --- | ---: | --- | --- | --- | --- |',
+            ...(rows.length ? rows : ['|  |  |  |  |  |  |  |  |  |  |  |']),
+            '<!-- SCALE_METRICS:END -->',
+        ].join('\n');
+    }
+    writeAll(records) {
+        if (!existsSync(this.metricsDir))
+            mkdirSync(this.metricsDir, { recursive: true });
+        const body = records.map(record => JSON.stringify(record)).join('\n');
+        writeFileSync(this.recordsPath, body ? `${body}\n` : '', 'utf-8');
+    }
+}
+function replaceGeneratedSection(existing, generatedSection) {
+    const marker = /<!-- SCALE_METRICS:START -->[\s\S]*?<!-- SCALE_METRICS:END -->/;
+    if (marker.test(existing))
+        return existing.replace(marker, generatedSection);
+    const titleMatch = existing.match(/^# .+\n/);
+    if (titleMatch) {
+        return existing.replace(titleMatch[0], `${titleMatch[0]}\n${generatedSection}\n`);
+    }
+    return `# Workflow Metrics\n\n${generatedSection}\n\n${existing}`;
+}
+function currentDate() {
+    return new Date().toISOString().slice(0, 10);
+}
+function ratio(part, total) {
+    return total === 0 ? 0 : Math.round((part / total) * 1000) / 1000;
+}
+function escapeCell(value) {
+    return value.replace(/\|/g, '\\|');
+}
+//# sourceMappingURL=TaskMetricsStore.js.map

package/dist/workflow/TaskMetricsStore.js.map

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

package/dist/workflow/VerificationCommands.d.ts

@@ -5,11 +5,13 @@ export interface VerificationCommandConfig {
     coverage?: string;
     tddEvidence?: string;
     tddStrict?: boolean;
+    cwd?: string;
 }
 export interface ResolvedVerificationCommand {
     command?: string;
     source: 'override' | 'package-script' | 'fallback' | 'missing';
     reason: string;
+    cwd?: string;
 }
 export interface ResolvedVerificationCommands {
     packageManager: string;

package/dist/workflow/VerificationCommands.js

@@ -6,14 +6,17 @@ export function detectVerificationCommands(cwd = process.cwd(), overrides = {})
     const packageManager = detectPackageManager(cwd, pkg);
     return {
         packageManager,
-        build: resolveBuildCommand(packageManager, scripts, overrides.build),
-        lint: resolveScriptCommand(packageManager, scripts, 'lint', overrides.lint),
-        test: resolveScriptCommand(packageManager, scripts, 'test', overrides.test),
-        coverage: resolveCoverageCommand(packageManager, scripts, overrides.coverage),
+        build: withCwd(resolveBuildCommand(packageManager, scripts, overrides.build), cwd),
+        lint: withCwd(resolveScriptCommand(packageManager, scripts, 'lint', overrides.lint), cwd),
+        test: withCwd(resolveScriptCommand(packageManager, scripts, 'test', overrides.test), cwd),
+        coverage: withCwd(resolveCoverageCommand(packageManager, scripts, overrides.coverage), cwd),
         tddEvidence: overrides.tddEvidence,
         tddStrict: overrides.tddStrict,
     };
 }
+function withCwd(command, cwd) {
+    return { ...command, cwd };
+}
 function readPackageJson(cwd) {
     try {
         return JSON.parse(readFileSync(join(cwd, 'package.json'), 'utf8'));
@@ -71,16 +74,9 @@ function resolveCoverageCommand(packageManager, scripts, override) {
             reason: 'detected package.json "coverage" script',
         };
     }
-    if (scripts.test) {
-        return {
-            command: `${runScriptCommand(packageManager, 'test')} -- --coverage`,
-            source: 'fallback',
-            reason: 'no "coverage" script; using test script with coverage flag',
-        };
-    }
     return {
         source: 'missing',
-        reason: 'package.json has neither "coverage" nor "test" script',
+        reason: 'package.json has no "coverage" script; add one or pass --coverage-cmd for full coverage gates',
     };
 }
 function resolveBuildCommand(packageManager, scripts, override) {

package/dist/workflow/VerificationCommands.js.map

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

package/dist/workflow/VerificationProfile.d.ts

@@ -0,0 +1,56 @@
+import type { VerificationCommandConfig } from './VerificationCommands.js';
+export type VerificationCommandName = 'build' | 'lint' | 'test' | 'coverage';
+export type VerificationArtifactGateMode = 'off' | 'warn' | 'block';
+export type VerificationArtifactGateLevel = 'M' | 'L' | 'CRITICAL';
+export interface VerificationService {
+    name: string;
+    path: string;
+    type?: 'node' | 'go' | 'python' | 'custom';
+    required?: boolean;
+    commands?: Partial<Record<VerificationCommandName, string>>;
+}
+export interface VerificationProfileEntry {
+    commands?: Partial<Record<VerificationCommandName, string>>;
+    services?: string[];
+}
+export interface VerificationPolicy {
+    mode?: string;
+    optionalToolsWarnOnly?: boolean;
+    artifactGate?: VerificationArtifactGateMode;
+    artifactGateLevels?: VerificationArtifactGateLevel[];
+}
+export interface VerificationMatrix {
+    version?: number;
+    defaultProfile?: string;
+    profiles?: Record<string, VerificationProfileEntry>;
+    services?: VerificationService[];
+    exclude?: string[];
+    policy?: VerificationPolicy;
+}
+export interface ResolveVerificationProfileOptions {
+    projectDir?: string;
+    scaleDir?: string;
+    profile?: string;
+    service?: string;
+    services?: string[];
+}
+export interface ResolvedVerificationProfile {
+    config: VerificationCommandConfig;
+    profileName: string;
+    service?: VerificationService;
+    matrix?: VerificationMatrix;
+    policy: VerificationPolicy;
+    warnings: string[];
+}
+export interface ResolvedVerificationTargets {
+    targets: ResolvedVerificationProfile[];
+    profileName: string;
+    matrix?: VerificationMatrix;
+    policy: VerificationPolicy;
+    warnings: string[];
+}
+export declare const DEFAULT_VERIFICATION_POLICY: VerificationPolicy;
+export declare function loadVerificationMatrix(projectDir?: string, scaleDir?: string): VerificationMatrix | null;
+export declare function resolveVerificationProfile(options?: ResolveVerificationProfileOptions): ResolvedVerificationProfile;
+export declare function resolveVerificationTargets(options?: ResolveVerificationProfileOptions): ResolvedVerificationTargets;
+export declare function resolveVerificationPolicy(matrix: VerificationMatrix | null | undefined): VerificationPolicy;

package/dist/workflow/VerificationProfile.js

@@ -0,0 +1,170 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { isAbsolute, join, resolve } from 'node:path';
+export const DEFAULT_VERIFICATION_POLICY = {
+    optionalToolsWarnOnly: true,
+    artifactGate: 'warn',
+    artifactGateLevels: ['M', 'L', 'CRITICAL'],
+};
+export function loadVerificationMatrix(projectDir = process.cwd(), scaleDir = '.scale') {
+    const path = verificationMatrixPath(projectDir, scaleDir);
+    if (!existsSync(path))
+        return null;
+    return JSON.parse(readFileSync(path, 'utf-8'));
+}
+export function resolveVerificationProfile(options = {}) {
+    const projectDir = resolve(options.projectDir ?? process.cwd());
+    const scaleDir = options.scaleDir ?? '.scale';
+    const matrix = loadVerificationMatrix(projectDir, scaleDir);
+    const warnings = [];
+    if (!matrix) {
+        return {
+            config: { cwd: projectDir },
+            profileName: options.profile ?? 'auto',
+            policy: resolveVerificationPolicy(null),
+            warnings: [`No verification matrix found at ${verificationMatrixPath(projectDir, scaleDir)}; using package script auto-detection.`],
+        };
+    }
+    const profileName = options.profile ?? matrix.defaultProfile ?? 'default';
+    const profile = matrix.profiles?.[profileName];
+    if (options.profile && !profile) {
+        warnings.push(`Verification profile "${options.profile}" was not found; using service or auto-detected commands.`);
+    }
+    const service = options.service
+        ? matrix.services?.find(candidate => candidate.name === options.service)
+        : undefined;
+    if (options.service && !service) {
+        warnings.push(`Verification service "${options.service}" was not found; using project root.`);
+    }
+    const cwd = service ? resolve(projectDir, service.path) : projectDir;
+    const commands = {
+        ...defaultCommandsForService(service),
+        ...(profile?.commands ?? {}),
+        ...(service?.commands ?? {}),
+    };
+    return {
+        config: {
+            cwd,
+            build: commands.build,
+            lint: commands.lint,
+            test: commands.test,
+            coverage: commands.coverage,
+        },
+        profileName,
+        service,
+        matrix,
+        policy: resolveVerificationPolicy(matrix),
+        warnings,
+    };
+}
+export function resolveVerificationTargets(options = {}) {
+    const projectDir = resolve(options.projectDir ?? process.cwd());
+    const scaleDir = options.scaleDir ?? '.scale';
+    const matrix = loadVerificationMatrix(projectDir, scaleDir);
+    if (!matrix) {
+        const target = resolveVerificationProfile(options);
+        return {
+            targets: [target],
+            profileName: target.profileName,
+            policy: target.policy,
+            warnings: target.warnings,
+        };
+    }
+    const profileName = options.profile ?? matrix.defaultProfile ?? 'default';
+    const profile = matrix.profiles?.[profileName];
+    const serviceNames = selectServiceNames(matrix, profile, options.service, options.services);
+    if (serviceNames.length === 0) {
+        const target = resolveVerificationProfile({ ...options, profile: profileName, service: undefined });
+        return {
+            targets: [target],
+            profileName,
+            matrix,
+            policy: resolveVerificationPolicy(matrix),
+            warnings: target.warnings,
+        };
+    }
+    const targets = serviceNames.map(service => resolveVerificationProfile({
+        ...options,
+        profile: profileName,
+        service,
+    }));
+    return {
+        targets,
+        profileName,
+        matrix,
+        policy: resolveVerificationPolicy(matrix),
+        warnings: targets.flatMap(target => target.warnings),
+    };
+}
+export function resolveVerificationPolicy(matrix) {
+    const policy = matrix?.policy ?? {};
+    return {
+        ...DEFAULT_VERIFICATION_POLICY,
+        ...policy,
+        artifactGate: normalizeArtifactGate(policy.artifactGate) ?? DEFAULT_VERIFICATION_POLICY.artifactGate,
+        artifactGateLevels: normalizeArtifactGateLevels(policy.artifactGateLevels),
+    };
+}
+function selectServiceNames(matrix, profile, requestedService, requestedServices = []) {
+    const requested = unique([
+        ...requestedServices,
+        ...splitServiceNames(requestedService),
+    ]);
+    if (requested.includes('all')) {
+        if (profile?.services?.length)
+            return profile.services;
+        return (matrix.services ?? [])
+            .filter(service => service.required !== false)
+            .map(service => service.name);
+    }
+    if (requested.length > 0)
+        return requested;
+    return profile?.services ?? [];
+}
+function splitServiceNames(value) {
+    if (!value)
+        return [];
+    return value
+        .split(',')
+        .map(service => service.trim())
+        .filter(Boolean);
+}
+function defaultCommandsForService(service) {
+    if (!service?.type || service.type === 'node' || service.type === 'custom')
+        return {};
+    if (service.type === 'go') {
+        return {
+            build: 'go build ./...',
+            lint: 'go vet ./...',
+            test: 'go test ./...',
+            coverage: 'go test ./... -cover',
+        };
+    }
+    if (service.type === 'python') {
+        return {
+            build: 'python -m compileall .',
+            lint: 'python -m ruff check .',
+            test: 'python -m pytest',
+            coverage: 'python -m pytest --cov=.',
+        };
+    }
+    return {};
+}
+function unique(items) {
+    return [...new Set(items)];
+}
+function verificationMatrixPath(projectDir, scaleDir) {
+    const root = isAbsolute(scaleDir) ? scaleDir : join(projectDir, scaleDir);
+    return join(root, 'verification.json');
+}
+function normalizeArtifactGate(value) {
+    if (value === 'off' || value === 'warn' || value === 'block')
+        return value;
+    return undefined;
+}
+function normalizeArtifactGateLevels(value) {
+    if (!Array.isArray(value))
+        return DEFAULT_VERIFICATION_POLICY.artifactGateLevels ?? ['M', 'L', 'CRITICAL'];
+    const levels = value.filter((level) => level === 'M' || level === 'L' || level === 'CRITICAL');
+    return levels.length > 0 ? levels : DEFAULT_VERIFICATION_POLICY.artifactGateLevels ?? ['M', 'L', 'CRITICAL'];
+}
+//# sourceMappingURL=VerificationProfile.js.map

package/dist/workflow/VerificationProfile.js.map

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

package/dist/workflow/WorkflowArtifactWriter.d.ts

@@ -0,0 +1,113 @@
+export interface ExploreArtifact {
+    timestamp: string;
+    files: string[];
+    fileCount: number;
+    mainContradiction: string;
+    ambiguityScore: number;
+    socraticCompleted: boolean;
+    graphNodes?: number;
+}
+export interface PlanArtifact {
+    timestamp: string;
+    planId: string;
+    specId: string;
+    hasBoundaryAnalysis: boolean;
+    hasExceptionHandling: boolean;
+    hasRollbackStrategy: boolean;
+    modules: string[];
+    consensusRounds: number;
+    verdict: string;
+}
+export interface TDDEvidence {
+    timestamp: string;
+    taskId: string;
+    red: boolean;
+    green: boolean;
+    refactor: boolean;
+    testFirst: boolean;
+    testFile: string;
+    implFile: string;
+    coverage?: number;
+}
+export interface CheckpointData {
+    timestamp: string;
+    phase: string;
+    sessionId?: string;
+    data: Record<string, unknown>;
+}
+export type WorkflowTaskLevel = 'S' | 'M' | 'L' | 'CRITICAL';
+export type WorkflowPhase = 'define' | 'explore' | 'plan' | 'build' | 'verify' | 'review' | 'ship' | 'done';
+export interface WorkflowState {
+    schemaVersion: 1;
+    taskId: string;
+    level: WorkflowTaskLevel;
+    phase: WorkflowPhase;
+    artifactsDir?: string;
+    exploredFiles: string[];
+    fileCount: number;
+    mainContradiction: string;
+    completedGates: string[];
+    openTasks: string[];
+    filesModified: string[];
+    skillIntents?: string[];
+    skillRoutingMode?: 'off' | 'warn' | 'block';
+    skillPlanRequired?: boolean;
+    skillPlanPath?: string;
+    requiredSkills?: string[];
+    recommendedSkills?: string[];
+    requiredSkillArtifacts?: string[];
+    requiredSkillVerification?: string[];
+    lastSpecId?: string;
+    lastPlanId?: string;
+    lastTaskId?: string;
+    updatedAt: string;
+}
+export type WorkflowStatePatch = Partial<Omit<WorkflowState, 'schemaVersion' | 'updatedAt'>> & {
+    updatedAt?: string;
+};
+export declare class WorkflowArtifactWriter {
+    private stateDir;
+    constructor(scaleDir?: string);
+    private ensureDir;
+    /** Write explore result to .scale/state/explore.json */
+    writeExploreResult(result: ExploreArtifact): void;
+    /** Read explore artifact from .scale/state/explore.json */
+    readExploreResult(): ExploreArtifact | null;
+    /** Check if explore artifact exists and is valid */
+    hasValidExploreResult(minFiles?: number): boolean;
+    /** Write plan result to .scale/state/plan-{planId}.json */
+    writePlanResult(result: PlanArtifact): void;
+    /** Read plan artifact by ID */
+    readPlanResult(planId: string): PlanArtifact | null;
+    /** Read the most recent plan artifact */
+    readLatestPlanResult(): PlanArtifact | null;
+    /** Check if a valid plan artifact exists */
+    hasValidPlanResult(): boolean;
+    /** Write TDD evidence to .scale/state/tdd-{taskId}.json */
+    writeTDDEvidence(evidence: TDDEvidence): void;
+    /** Read TDD evidence by task ID */
+    readTDDEvidence(taskId: string): TDDEvidence | null;
+    /** Read the most recent TDD evidence */
+    readLatestTDDEvidence(): TDDEvidence | null;
+    /** Check if valid TDD evidence exists for a task */
+    hasValidTDDEvidence(taskId?: string): boolean;
+    /** Write checkpoint to .scale/state/checkpoint.json */
+    writeCheckpoint(data: CheckpointData): void;
+    /** Read checkpoint */
+    readCheckpoint(): CheckpointData | null;
+    /** Clear all artifacts (for testing or reset) */
+    clearAll(): void;
+    /** Get state directory path */
+    getStateDir(): string;
+    /** Write authoritative workflow state to .scale/state/current.json */
+    writeCurrentState(state: WorkflowState): void;
+    /** Read authoritative workflow state from .scale/state/current.json */
+    readCurrentState(): WorkflowState | null;
+    /** Merge a patch into .scale/state/current.json. */
+    updateCurrentState(patch: WorkflowStatePatch): WorkflowState;
+    private readJson;
+    private listFiles;
+    private createDefaultState;
+    private normalizeState;
+    private isWorkflowPhase;
+}