@hongmaple0820/scale-engine 0.12.3 → 0.14.0

package/dist/workflow/SessionStateTracker.js

@@ -0,0 +1,270 @@
+// SCALE Engine — Session State Tracker
+// 轻量级状态文件追踪，用于认知工作流进度标记
+// 设计参考：工作流配置优化方案 §3.1
+import { existsSync, mkdirSync, readFileSync, writeFileSync, unlinkSync } from 'node:fs';
+import { join } from 'node:path';
+import { logger } from '../core/logger.js';
+// ============================================================================
+// Session State Tracker
+// ============================================================================
+export class SessionStateTracker {
+    constructor(sessionId, scaleDir = '.scale') {
+        this.sessionId = sessionId;
+        this.sessionDir = join(scaleDir, 'session');
+        this.ensureDir();
+    }
+    ensureDir() {
+        if (!existsSync(this.sessionDir)) {
+            mkdirSync(this.sessionDir, { recursive: true });
+        }
+    }
+    // ─────────────────────────────────────────────────────────────
+    // Flow State Management
+    // ─────────────────────────────────────────────────────────────
+    /** Get current flow state */
+    getFlowState() {
+        const stateFile = join(this.sessionDir, '.flow-state');
+        if (!existsSync(stateFile)) {
+            return this.createDefaultFlowState();
+        }
+        const content = readFileSync(stateFile, 'utf-8');
+        const state = {
+            SKILL_SCAN: '',
+            EXPLORE: '',
+            PLAN: '',
+            EXECUTE: '',
+            VERIFY: '',
+            SETTLE: '',
+            POLLUTION: '',
+            LAZY: '',
+        };
+        // Parse state file
+        for (const line of content.split('\n')) {
+            const match = line.match(/^(\w+)=(✓|⏳|pending)?$/);
+            if (match) {
+                const [, phase, status] = match;
+                if (phase in state) {
+                    state[phase] = status || '';
+                }
+            }
+        }
+        return state;
+    }
+    /** Update phase status */
+    updatePhase(phase, status) {
+        const state = this.getFlowState();
+        state[phase] = status;
+        this.writeFlowState(state);
+        logger.info({ phase, status, sessionId: this.sessionId }, 'Flow state updated');
+    }
+    /** Mark phase as complete */
+    markPhaseComplete(phase) {
+        this.updatePhase(phase, '✓');
+    }
+    /** Mark phase as in progress */
+    markPhaseInProgress(phase) {
+        this.updatePhase(phase, '⏳');
+    }
+    /** Check if all phases complete */
+    isAllComplete() {
+        const state = this.getFlowState();
+        const required = ['SKILL_SCAN', 'EXPLORE', 'PLAN', 'EXECUTE', 'VERIFY', 'SETTLE'];
+        return required.every(p => state[p] === '✓');
+    }
+    /** Get missing phases */
+    getMissingPhases() {
+        const state = this.getFlowState();
+        const required = ['SKILL_SCAN', 'EXPLORE', 'PLAN', 'EXECUTE', 'VERIFY', 'SETTLE'];
+        return required.filter(p => state[p] !== '✓');
+    }
+    createDefaultFlowState() {
+        return {
+            SKILL_SCAN: '',
+            EXPLORE: '',
+            PLAN: '',
+            EXECUTE: '',
+            VERIFY: '',
+            SETTLE: '',
+            POLLUTION: '',
+            LAZY: '',
+        };
+    }
+    writeFlowState(state) {
+        const stateFile = join(this.sessionDir, '.flow-state');
+        const content = Object.entries(state)
+            .map(([phase, status]) => `${phase}=${status}`)
+            .join('\n');
+        writeFileSync(stateFile, content, 'utf-8');
+    }
+    // ─────────────────────────────────────────────────────────────
+    // Markers Management
+    // ─────────────────────────────────────────────────────────────
+    /** Mark skill scan complete */
+    markSkillScanned(skills) {
+        const markerFile = join(this.sessionDir, '.skill-scanned');
+        writeFileSync(markerFile, skills.join('|'), 'utf-8');
+        this.updatePhase('SKILL_SCAN', '✓');
+        logger.info({ skills, sessionId: this.sessionId }, 'Skill scan marked');
+    }
+    /** Check if skill scanned */
+    isSkillScanned() {
+        const markerFile = join(this.sessionDir, '.skill-scanned');
+        return existsSync(markerFile);
+    }
+    /** Get scanned skills */
+    getScannedSkills() {
+        const markerFile = join(this.sessionDir, '.skill-scanned');
+        if (!existsSync(markerFile))
+            return [];
+        return readFileSync(markerFile, 'utf-8').split('|');
+    }
+    /** Mark verification complete */
+    markVerified() {
+        const markerFile = join(this.sessionDir, '.verified');
+        writeFileSync(markerFile, '✓', 'utf-8');
+        this.updatePhase('VERIFY', '✓');
+        logger.info({ sessionId: this.sessionId }, 'Verification marked');
+    }
+    /** Check if verified */
+    isVerified() {
+        const markerFile = join(this.sessionDir, '.verified');
+        return existsSync(markerFile);
+    }
+    /** Mark pollution detected */
+    markPollutionDetected() {
+        const markerFile = join(this.sessionDir, '.pollution-detected');
+        writeFileSync(markerFile, 'POLLUTION=1', 'utf-8');
+        this.updatePhase('POLLUTION', 'pending');
+        logger.warn({ sessionId: this.sessionId }, 'Pollution detected');
+    }
+    /** Clear pollution */
+    clearPollution() {
+        const markerFile = join(this.sessionDir, '.pollution-detected');
+        if (existsSync(markerFile)) {
+            unlinkSync(markerFile);
+        }
+        this.updatePhase('POLLUTION', '✓');
+        logger.info({ sessionId: this.sessionId }, 'Pollution cleared');
+    }
+    /** Check if pollution detected */
+    isPollutionDetected() {
+        const markerFile = join(this.sessionDir, '.pollution-detected');
+        return existsSync(markerFile);
+    }
+    /** Mark lazy detected */
+    markLazyDetected(type) {
+        const markerFile = join(this.sessionDir, '.lazy-detected');
+        const existing = existsSync(markerFile) ? readFileSync(markerFile, 'utf-8') : '';
+        const updated = existing ? `${existing}\n${type}=1` : `${type}=1`;
+        writeFileSync(markerFile, updated, 'utf-8');
+        this.updatePhase('LAZY', 'pending');
+        logger.warn({ type, sessionId: this.sessionId }, 'Lazy detected');
+    }
+    /** Clear lazy marker */
+    clearLazyMarker(type) {
+        const markerFile = join(this.sessionDir, '.lazy-detected');
+        if (!existsSync(markerFile))
+            return;
+        const content = readFileSync(markerFile, 'utf-8');
+        const lines = content.split('\n').filter(l => !l.startsWith(`${type}=`));
+        if (lines.length === 0) {
+            unlinkSync(markerFile);
+            this.updatePhase('LAZY', '');
+        }
+        else {
+            writeFileSync(markerFile, lines.join('\n'), 'utf-8');
+        }
+    }
+    /** Check if lazy detected */
+    isLazyDetected() {
+        const markerFile = join(this.sessionDir, '.lazy-detected');
+        return existsSync(markerFile);
+    }
+    /** Get lazy types */
+    getLazyTypes() {
+        const markerFile = join(this.sessionDir, '.lazy-detected');
+        if (!existsSync(markerFile))
+            return [];
+        return readFileSync(markerFile, 'utf-8')
+            .split('\n')
+            .filter(l => l.includes('=1'))
+            .map(l => l.split('=')[0]);
+    }
+    // ─────────────────────────────────────────────────────────────
+    // Fail Count Management
+    // ─────────────────────────────────────────────────────────────
+    /** Increment fail count */
+    incrementFailCount() {
+        const countFile = join(this.sessionDir, '.fail-count');
+        const current = existsSync(countFile) ? parseInt(readFileSync(countFile, 'utf-8'), 10) : 0;
+        const newCount = current + 1;
+        writeFileSync(countFile, String(newCount), 'utf-8');
+        // 检测污染（>= 2次失败）
+        if (newCount >= 2) {
+            this.markPollutionDetected();
+        }
+        return newCount;
+    }
+    /** Get fail count */
+    getFailCount() {
+        const countFile = join(this.sessionDir, '.fail-count');
+        if (!existsSync(countFile))
+            return 0;
+        return parseInt(readFileSync(countFile, 'utf-8'), 10);
+    }
+    /** Reset fail count */
+    resetFailCount() {
+        const countFile = join(this.sessionDir, '.fail-count');
+        if (existsSync(countFile)) {
+            unlinkSync(countFile);
+        }
+    }
+    // ─────────────────────────────────────────────────────────────
+    // Cleanup
+    // ─────────────────────────────────────────────────────────────
+    /** Clear all session markers */
+    clearAll() {
+        const files = [
+            '.flow-state',
+            '.skill-scanned',
+            '.verified',
+            '.pollution-detected',
+            '.lazy-detected',
+            '.fail-count',
+            '.tool-history',
+        ];
+        for (const file of files) {
+            const filePath = join(this.sessionDir, file);
+            if (existsSync(filePath)) {
+                unlinkSync(filePath);
+            }
+        }
+        logger.info({ sessionId: this.sessionId }, 'Session markers cleared');
+    }
+    /** Generate summary report */
+    generateSummary() {
+        const state = this.getFlowState();
+        const skills = this.getScannedSkills();
+        const lazyTypes = this.getLazyTypes();
+        const failCount = this.getFailCount();
+        let report = '# Session State Summary\n\n';
+        report += `Session ID: ${this.sessionId}\n\n`;
+        report += '## Flow State\n';
+        for (const [phase, status] of Object.entries(state)) {
+            report += `- ${phase}: ${status || 'pending'}\n`;
+        }
+        if (skills.length > 0) {
+            report += '\n## Scanned Skills\n';
+            report += skills.map(s => `- ${s}`).join('\n');
+        }
+        if (lazyTypes.length > 0) {
+            report += '\n## Lazy Detection\n';
+            report += lazyTypes.map(t => `- ${t}`).join('\n');
+        }
+        if (failCount > 0) {
+            report += `\n## Fail Count: ${failCount}\n`;
+        }
+        return report;
+    }
+}
+//# sourceMappingURL=SessionStateTracker.js.map

package/dist/workflow/SessionStateTracker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionStateTracker.js","sourceRoot":"","sources":["../../src/workflow/SessionStateTracker.ts"],"names":[],"mappings":"AAAA,uCAAuC;AACvC,wBAAwB;AACxB,sBAAsB;AAEtB,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AACxF,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AA6B1C,+EAA+E;AAC/E,wBAAwB;AACxB,+EAA+E;AAE/E,MAAM,OAAO,mBAAmB;IAI9B,YAAY,SAAiB,EAAE,WAAmB,QAAQ;QACxD,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;QAC1B,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAA;QAC3C,IAAI,CAAC,SAAS,EAAE,CAAA;IAClB,CAAC;IAEO,SAAS;QACf,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;YACjC,SAAS,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;QACjD,CAAC;IACH,CAAC;IAED,gEAAgE;IAChE,wBAAwB;IACxB,gEAAgE;IAEhE,6BAA6B;IAC7B,YAAY;QACV,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,CAAA;QACtD,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC3B,OAAO,IAAI,CAAC,sBAAsB,EAAE,CAAA;QACtC,CAAC;QAED,MAAM,OAAO,GAAG,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;QAChD,MAAM,KAAK,GAAc;YACvB,UAAU,EAAE,EAAE;YACd,OAAO,EAAE,EAAE;YACX,IAAI,EAAE,EAAE;YACR,OAAO,EAAE,EAAE;YACX,MAAM,EAAE,EAAE;YACV,MAAM,EAAE,EAAE;YACV,SAAS,EAAE,EAAE;YACb,IAAI,EAAE,EAAE;SACT,CAAA;QAED,mBAAmB;QACnB,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACvC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAA;YAClD,IAAI,KAAK,EAAE,CAAC;gBACV,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,KAAK,CAAA;gBAC/B,IAAI,KAAK,IAAI,KAAK,EAAE,CAAC;oBACnB,KAAK,CAAC,KAAwB,CAAC,GAAI,MAAsB,IAAI,EAAE,CAAA;gBACjE,CAAC;YACH,CAAC;QACH,CAAC;QAED,OAAO,KAAK,CAAA;IACd,CAAC;IAED,0BAA0B;IAC1B,WAAW,CAAC,KAAsB,EAAE,MAAmB;QACrD,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,EAAE,CAAA;QACjC,KAAK,CAAC,KAAK,CAAC,GAAG,MAAM,CAAA;QACrB,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAA;QAC1B,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,EAAE,oBAAoB,CAAC,CAAA;IACjF,CAAC;IAED,6BAA6B;IAC7B,iBAAiB,CAAC,KAAsB;QACtC,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;IAC9B,CAAC;IAED,gCAAgC;IAChC,mBAAmB,CAAC,KAAsB;QACxC,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;IAC9B,CAAC;IAED,mCAAmC;IACnC,aAAa;QACX,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,EAAE,CAAA;QACjC,MAAM,QAAQ,GAAwB,CAAC,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAA;QACtG,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAA;IAC9C,CAAC;IAED,yBAAyB;IACzB,gBAAgB;QACd,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,EAAE,CAAA;QACjC,MAAM,QAAQ,GAAwB,CAAC,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAA;QACtG,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAA;IAC/C,CAAC;IAEO,sBAAsB;QAC5B,OAAO;YACL,UAAU,EAAE,EAAE;YACd,OAAO,EAAE,EAAE;YACX,IAAI,EAAE,EAAE;YACR,OAAO,EAAE,EAAE;YACX,MAAM,EAAE,EAAE;YACV,MAAM,EAAE,EAAE;YACV,SAAS,EAAE,EAAE;YACb,IAAI,EAAE,EAAE;SACT,CAAA;IACH,CAAC;IAEO,cAAc,CAAC,KAAgB;QACrC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,CAAA;QACtD,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;aAClC,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK,IAAI,MAAM,EAAE,CAAC;aAC9C,IAAI,CAAC,IAAI,CAAC,CAAA;QACb,aAAa,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;IAC5C,CAAC;IAED,gEAAgE;IAChE,qBAAqB;IACrB,gEAAgE;IAEhE,+BAA+B;IAC/B,gBAAgB,CAAC,MAAgB;QAC/B,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAA;QAC1D,aAAa,CAAC,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,CAAA;QACpD,IAAI,CAAC,WAAW,CAAC,YAAY,EAAE,GAAG,CAAC,CAAA;QACnC,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,EAAE,mBAAmB,CAAC,CAAA;IACzE,CAAC;IAED,6BAA6B;IAC7B,cAAc;QACZ,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAA;QAC1D,OAAO,UAAU,CAAC,UAAU,CAAC,CAAA;IAC/B,CAAC;IAED,yBAAyB;IACzB,gBAAgB;QACd,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAA;QAC1D,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;YAAE,OAAO,EAAE,CAAA;QACtC,OAAO,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IACrD,CAAC;IAED,iCAAiC;IACjC,YAAY;QACV,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,CAAA;QACrD,aAAa,CAAC,UAAU,EAAE,GAAG,EAAE,OAAO,CAAC,CAAA;QACvC,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAA;QAC/B,MAAM,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,EAAE,qBAAqB,CAAC,CAAA;IACnE,CAAC;IAED,wBAAwB;IACxB,UAAU;QACR,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,CAAA;QACrD,OAAO,UAAU,CAAC,UAAU,CAAC,CAAA;IAC/B,CAAC;IAED,8BAA8B;IAC9B,qBAAqB;QACnB,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,qBAAqB,CAAC,CAAA;QAC/D,aAAa,CAAC,UAAU,EAAE,aAAa,EAAE,OAAO,CAAC,CAAA;QACjD,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE,SAAS,CAAC,CAAA;QACxC,MAAM,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,EAAE,oBAAoB,CAAC,CAAA;IAClE,CAAC;IAED,sBAAsB;IACtB,cAAc;QACZ,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,qBAAqB,CAAC,CAAA;QAC/D,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC3B,UAAU,CAAC,UAAU,CAAC,CAAA;QACxB,CAAC;QACD,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE,GAAG,CAAC,CAAA;QAClC,MAAM,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,EAAE,mBAAmB,CAAC,CAAA;IACjE,CAAC;IAED,kCAAkC;IAClC,mBAAmB;QACjB,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,qBAAqB,CAAC,CAAA;QAC/D,OAAO,UAAU,CAAC,UAAU,CAAC,CAAA;IAC/B,CAAC;IAED,yBAAyB;IACzB,gBAAgB,CAAC,IAAY;QAC3B,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAA;QAC1D,MAAM,QAAQ,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;QAChF,MAAM,OAAO,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,QAAQ,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,CAAA;QACjE,aAAa,CAAC,UAAU,EAAE,OAAO,EAAE,OAAO,CAAC,CAAA;QAC3C,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;QACnC,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,EAAE,eAAe,CAAC,CAAA;IACnE,CAAC;IAED,wBAAwB;IACxB,eAAe,CAAC,IAAY;QAC1B,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAA;QAC1D,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;YAAE,OAAM;QAEnC,MAAM,OAAO,GAAG,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAA;QACjD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,CAAA;QAExE,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,UAAU,CAAC,UAAU,CAAC,CAAA;YACtB,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA;QAC9B,CAAC;aAAM,CAAC;YACN,aAAa,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAA;QACtD,CAAC;IACH,CAAC;IAED,6BAA6B;IAC7B,cAAc;QACZ,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAA;QAC1D,OAAO,UAAU,CAAC,UAAU,CAAC,CAAA;IAC/B,CAAC;IAED,qBAAqB;IACrB,YAAY;QACV,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAA;QAC1D,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;YAAE,OAAO,EAAE,CAAA;QACtC,OAAO,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC;aACrC,KAAK,CAAC,IAAI,CAAC;aACX,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;aAC7B,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IAC9B,CAAC;IAED,gEAAgE;IAChE,wBAAwB;IACxB,gEAAgE;IAEhE,2BAA2B;IAC3B,kBAAkB;QAChB,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,CAAA;QACtD,MAAM,OAAO,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;QAC1F,MAAM,QAAQ,GAAG,OAAO,GAAG,CAAC,CAAA;QAC5B,aAAa,CAAC,SAAS,EAAE,MAAM,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAA;QAEnD,gBAAgB;QAChB,IAAI,QAAQ,IAAI,CAAC,EAAE,CAAC;YAClB,IAAI,CAAC,qBAAqB,EAAE,CAAA;QAC9B,CAAC;QAED,OAAO,QAAQ,CAAA;IACjB,CAAC;IAED,qBAAqB;IACrB,YAAY;QACV,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,CAAA;QACtD,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;YAAE,OAAO,CAAC,CAAA;QACpC,OAAO,QAAQ,CAAC,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,CAAA;IACvD,CAAC;IAED,uBAAuB;IACvB,cAAc;QACZ,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,CAAA;QACtD,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC1B,UAAU,CAAC,SAAS,CAAC,CAAA;QACvB,CAAC;IACH,CAAC;IAED,gEAAgE;IAChE,UAAU;IACV,gEAAgE;IAEhE,gCAAgC;IAChC,QAAQ;QACN,MAAM,KAAK,GAAG;YACZ,aAAa;YACb,gBAAgB;YAChB,WAAW;YACX,qBAAqB;YACrB,gBAAgB;YAChB,aAAa;YACb,eAAe;SAChB,CAAA;QAED,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,CAAA;YAC5C,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;gBACzB,UAAU,CAAC,QAAQ,CAAC,CAAA;YACtB,CAAC;QACH,CAAC;QAED,MAAM,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,EAAE,yBAAyB,CAAC,CAAA;IACvE,CAAC;IAED,8BAA8B;IAC9B,eAAe;QACb,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,EAAE,CAAA;QACjC,MAAM,MAAM,GAAG,IAAI,CAAC,gBAAgB,EAAE,CAAA;QACtC,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,EAAE,CAAA;QACrC,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,EAAE,CAAA;QAErC,IAAI,MAAM,GAAG,6BAA6B,CAAA;QAC1C,MAAM,IAAI,eAAe,IAAI,CAAC,SAAS,MAAM,CAAA;QAE7C,MAAM,IAAI,iBAAiB,CAAA;QAC3B,KAAK,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YACpD,MAAM,IAAI,KAAK,KAAK,KAAK,MAAM,IAAI,SAAS,IAAI,CAAA;QAClD,CAAC;QAED,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,uBAAuB,CAAA;YACjC,MAAM,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAChD,CAAC;QAED,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,uBAAuB,CAAA;YACjC,MAAM,IAAI,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACnD,CAAC;QAED,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;YAClB,MAAM,IAAI,oBAAoB,SAAS,IAAI,CAAA;QAC7C,CAAC;QAED,OAAO,MAAM,CAAA;IACf,CAAC;CACF"}

package/dist/workflow/TaskArtifactScaffolder.d.ts

@@ -0,0 +1,47 @@
+import type { GateResult } from './types.js';
+import { type SkillPlan } from '../skills/routing/index.js';
+export type TaskArtifactLevel = 'S' | 'M' | 'L' | 'CRITICAL';
+export interface TaskArtifactScaffoldOptions {
+    projectDir?: string;
+    taskId: string;
+    taskName: string;
+    description: string;
+    level: TaskArtifactLevel;
+    services?: string[];
+    skillPlan?: SkillPlan;
+}
+export interface TaskArtifactScaffoldResult {
+    relativeDir?: string;
+    dir?: string;
+    created: string[];
+    skipped: string[];
+}
+export interface VerificationArtifactAppendOptions {
+    projectDir?: string;
+    artifactsDir?: string;
+    taskId: string;
+    profile: string;
+    services: string[];
+    gateResults: GateResult[];
+    passed: boolean;
+}
+export interface TaskArtifactCheckOptions {
+    projectDir?: string;
+    artifactsDir?: string;
+    level: TaskArtifactLevel;
+    skillRequiredArtifacts?: string[];
+}
+export interface TaskArtifactIncompleteItem {
+    file: string;
+    reason: string;
+}
+export interface TaskArtifactCheckResult {
+    complete: boolean;
+    artifactsDir?: string;
+    required: string[];
+    missing: string[];
+    incomplete: TaskArtifactIncompleteItem[];
+}
+export declare function scaffoldTaskArtifacts(options: TaskArtifactScaffoldOptions): TaskArtifactScaffoldResult;
+export declare function appendVerificationArtifact(options: VerificationArtifactAppendOptions): string | null;
+export declare function checkTaskArtifactCompleteness(options: TaskArtifactCheckOptions): TaskArtifactCheckResult;

package/dist/workflow/TaskArtifactScaffolder.js

@@ -0,0 +1,237 @@
+import { appendFileSync, existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { isAbsolute, join, resolve } from 'node:path';
+import { governanceTemplateContent } from './GovernanceTemplates.js';
+import { skillPlanMarkdown } from '../skills/routing/index.js';
+const TASK_ARTIFACTS = [
+    'explore.md',
+    'mini-prd.md',
+    'skill-plan.md',
+    'plan.md',
+    'verification.md',
+    'review.md',
+    'summary.md',
+];
+export function scaffoldTaskArtifacts(options) {
+    if (options.level === 'S')
+        return { created: [], skipped: [] };
+    const projectDir = resolve(options.projectDir ?? process.cwd());
+    const relativeDir = join('docs', 'worklog', 'tasks', `${currentDate()}-${slugify(options.taskName || options.description || options.taskId)}`);
+    const dir = uniqueDirectory(projectDir, relativeDir, options.taskId);
+    const result = {
+        relativeDir: relativePath(projectDir, dir),
+        dir,
+        created: [],
+        skipped: [],
+    };
+    if (!existsSync(dir))
+        mkdirSync(dir, { recursive: true });
+    const artifacts = unique([
+        ...TASK_ARTIFACTS,
+        ...(options.skillPlan?.requiredArtifacts ?? []),
+    ]);
+    for (const name of artifacts) {
+        const target = join(dir, name);
+        if (existsSync(target)) {
+            result.skipped.push(target);
+            continue;
+        }
+        const template = name === 'skill-plan.md' && options.skillPlan
+            ? skillPlanMarkdown(options.skillPlan)
+            : readTemplate(projectDir, name);
+        const content = name === 'skill-plan.md' && options.skillPlan
+            ? template
+            : injectTaskMetadata(template, options);
+        writeFileSync(target, content, 'utf-8');
+        result.created.push(target);
+    }
+    return result;
+}
+export function appendVerificationArtifact(options) {
+    if (!options.artifactsDir)
+        return null;
+    const projectDir = resolve(options.projectDir ?? process.cwd());
+    const dir = isAbsolute(options.artifactsDir) ? options.artifactsDir : resolve(projectDir, options.artifactsDir);
+    if (!existsSync(dir))
+        return null;
+    const target = join(dir, 'verification.md');
+    if (!existsSync(target)) {
+        writeFileSync(target, injectTaskMetadata(readTemplate(projectDir, 'verification.md'), {
+            projectDir,
+            taskId: options.taskId,
+            taskName: options.taskId,
+            description: '',
+            level: 'M',
+            services: options.services,
+        }), 'utf-8');
+    }
+    appendFileSync(target, verificationRunMarkdown(options), 'utf-8');
+    return target;
+}
+export function checkTaskArtifactCompleteness(options) {
+    if (options.level === 'S') {
+        return { complete: true, artifactsDir: options.artifactsDir, required: [], missing: [], incomplete: [] };
+    }
+    if (!options.artifactsDir) {
+        const required = requiredArtifactsForLevel(options.level, options.skillRequiredArtifacts);
+        return {
+            complete: false,
+            required,
+            missing: required,
+            incomplete: [],
+        };
+    }
+    const projectDir = resolve(options.projectDir ?? process.cwd());
+    const dir = isAbsolute(options.artifactsDir) ? options.artifactsDir : resolve(projectDir, options.artifactsDir);
+    const required = requiredArtifactsForLevel(options.level, options.skillRequiredArtifacts);
+    const missing = [];
+    const incomplete = [];
+    for (const file of required) {
+        const path = join(dir, file);
+        if (!existsSync(path)) {
+            missing.push(file);
+            continue;
+        }
+        const reason = incompleteReason(file, readFileSync(path, 'utf-8'));
+        if (reason)
+            incomplete.push({ file, reason });
+    }
+    return {
+        complete: missing.length === 0 && incomplete.length === 0,
+        artifactsDir: dir,
+        required,
+        missing,
+        incomplete,
+    };
+}
+function verificationRunMarkdown(options) {
+    const rows = options.gateResults.flatMap(result => (result.evidenceItems ?? []).map(item => {
+        const command = item.command ?? item.label;
+        const resultText = item.passed ? 'PASS' : 'FAIL';
+        const notes = [
+            `gate=${result.gate}`,
+            item.cwd ? `cwd=${item.cwd}` : '',
+            typeof item.exitCode === 'number' ? `exit=${item.exitCode}` : '',
+            item.outputHash ? `hash=${item.outputHash}` : '',
+        ].filter(Boolean).join('; ');
+        return `| ${escapeCell(command)} | ${resultText} | ${escapeCell(notes || item.detail)} |`;
+    }));
+    return `
+## SCALE Verification Run - ${new Date().toISOString()}
+
+Profile: ${options.profile}
+Services: ${options.services.length ? options.services.join(', ') : 'root'}
+Final Status: ${options.passed ? 'passed' : 'failed'}
+
+| Command | Result | Notes |
+| --- | --- | --- |
+${rows.length ? rows.join('\n') : '| no command evidence | FAIL | no evidence items recorded |'}
+`;
+}
+function readTemplate(projectDir, name) {
+    const templatePath = join(projectDir, 'docs', 'workflow', 'templates', name);
+    if (existsSync(templatePath))
+        return readFileSync(templatePath, 'utf-8');
+    return isGovernanceTemplateName(name)
+        ? governanceTemplateContent(name)
+        : `# ${name}\n\n## Evidence\n\n\n`;
+}
+function requiredArtifactsForLevel(level, skillRequiredArtifacts = []) {
+    if (level === 'S')
+        return [];
+    const required = ['explore.md', 'skill-plan.md', 'plan.md', 'verification.md', 'review.md', 'summary.md'];
+    if (level === 'L' || level === 'CRITICAL')
+        required.splice(1, 0, 'mini-prd.md');
+    return unique([...required, ...skillRequiredArtifacts]);
+}
+function incompleteReason(file, content) {
+    if (file === 'verification.md' && /SCALE Verification Run|Final Status:\s*(passed|failed)|\|\s*[^|\s][^|]*\|\s*(PASS|FAIL)/i.test(content)) {
+        return null;
+    }
+    const substantive = substantiveLines(content);
+    const minimumLines = file === 'mini-prd.md' ? 3 : file === 'skill-plan.md' ? 1 : 2;
+    if (substantive.length < minimumLines) {
+        return `contains only template placeholders (${substantive.length}/${minimumLines} substantive lines)`;
+    }
+    return null;
+}
+function substantiveLines(content) {
+    return content
+        .split(/\r?\n/)
+        .map(line => line.trim())
+        .filter(line => line.length > 0)
+        .filter(line => !line.startsWith('#'))
+        .filter(line => !line.startsWith('**Task ID**:'))
+        .filter(line => !line.startsWith('**Task**:'))
+        .filter(line => !line.startsWith('**Level**:'))
+        .filter(line => !line.startsWith('**Services**:'))
+        .filter(line => !line.startsWith('**Created**:'))
+        .filter(line => !/^tbd$/i.test(line))
+        .filter(line => !/^\|/.test(line))
+        .filter(line => !/^\|?[\s:-]+\|[\s|:-]*$/.test(line))
+        .filter(line => !/^[-*]\s*(\[ \])?\s*(tbd)?$/i.test(line))
+        .filter(line => !/^\d+\.\s*(tbd)?$/i.test(line))
+        .filter(line => !/^\*Generated by SCALE Engine/i.test(line));
+}
+function injectTaskMetadata(template, options) {
+    const metadata = [
+        `**Task ID**: ${options.taskId}`,
+        `**Task**: ${options.taskName}`,
+        `**Level**: ${options.level}`,
+        `**Services**: ${options.services?.length ? options.services.join(', ') : 'unspecified'}`,
+        `**Created**: ${new Date().toISOString()}`,
+        '',
+    ].join('\n');
+    return template.replace(/^(# .+\n)/, `$1\n${metadata}`);
+}
+function uniqueDirectory(projectDir, relativeDir, taskId) {
+    const preferred = resolve(projectDir, relativeDir);
+    if (!existsSync(preferred))
+        return preferred;
+    const summary = join(preferred, 'summary.md');
+    if (existsSync(summary) && readFileSync(summary, 'utf-8').includes(`**Task ID**: ${taskId}`)) {
+        return preferred;
+    }
+    return resolve(projectDir, `${relativeDir}-${slugify(taskId).slice(0, 16)}`);
+}
+function relativePath(projectDir, path) {
+    return path.startsWith(projectDir)
+        ? path.slice(projectDir.length + 1).replace(/\\/g, '/')
+        : path.replace(/\\/g, '/');
+}
+function currentDate() {
+    return new Date().toISOString().slice(0, 10);
+}
+function slugify(value) {
+    const slug = value
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .slice(0, 48);
+    return slug || 'task';
+}
+function escapeCell(value) {
+    return value.replace(/\|/g, '\\|').replace(/\r?\n/g, ' ');
+}
+function isGovernanceTemplateName(name) {
+    return [
+        'explore.md',
+        'mini-prd.md',
+        'skill-plan.md',
+        'skill-evidence.md',
+        'ui-spec.md',
+        'visual-review.md',
+        'api-contract.md',
+        'docs-impact.md',
+        'security-review.md',
+        'db-change-plan.md',
+        'e2e-plan.md',
+        'plan.md',
+        'verification.md',
+        'review.md',
+        'summary.md',
+    ].includes(name);
+}
+function unique(items) {
+    return [...new Set(items)];
+}
+//# sourceMappingURL=TaskArtifactScaffolder.js.map

package/dist/workflow/TaskArtifactScaffolder.js.map

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

package/dist/workflow/TaskMetricsStore.d.ts

@@ -0,0 +1,49 @@
+export type MetricTaskLevel = 'M' | 'L' | 'CRITICAL';
+export interface TaskMetricRecord {
+    date: string;
+    taskId: string;
+    taskName: string;
+    level: MetricTaskLevel;
+    services: string[];
+    filesChanged: number;
+    firstVerificationPass: boolean;
+    fixIterations: number;
+    reworkNeeded: boolean;
+    artifactComplete: boolean;
+    residualRisk: string;
+    finalGateStatus: 'passed' | 'failed' | 'blocked';
+}
+export interface TaskMetricSummary {
+    total: number;
+    firstPassRate: number;
+    averageFixIterations: number;
+    artifactCompletenessRate: number;
+    residualRiskClarityRate: number;
+}
+export interface VerificationMetricInput {
+    taskId: string;
+    taskName: string;
+    level: MetricTaskLevel;
+    services?: string[];
+    filesChanged?: number;
+    passed: boolean;
+    artifactComplete?: boolean;
+    residualRisk?: string;
+    finalGateStatus?: TaskMetricRecord['finalGateStatus'];
+    date?: string;
+}
+export declare class TaskMetricsStore {
+    private metricsDir;
+    private recordsPath;
+    constructor(scaleDir?: string);
+    append(record: TaskMetricRecord): void;
+    upsert(record: TaskMetricRecord): void;
+    recordVerification(input: VerificationMetricInput): TaskMetricRecord;
+    list(): TaskMetricRecord[];
+    findByTaskId(taskId: string): TaskMetricRecord | undefined;
+    summarize(): TaskMetricSummary;
+    toMarkdownRow(record: TaskMetricRecord): string;
+    writeMarkdownReport(projectDir?: string): string;
+    private renderGeneratedMarkdownSection;
+    private writeAll;
+}