@hongmaple0820/med-scale-research-os 0.43.0

package/dist/workflow/PhaseMarkerTracker.js

@@ -0,0 +1,291 @@
+// SCALE Engine — Phase Marker Tracker
+// 解析 Output Markers 并追踪 Phase 完成状态
+// 用于 Stop Hook 检查所有 Phase 是否完成
+import { existsSync, mkdirSync, readFileSync, writeFileSync, unlinkSync } from 'node:fs';
+import { join } from 'node:path';
+import { logger } from '../core/logger.js';
+// ============================================================================
+// Output Marker Patterns
+// ============================================================================
+// [DEFINE] ✓ ambiguity <score>% ✓ | spec <id> ✓
+const DEFINE_PATTERN = /\[DEFINE\]\s*✓\s*ambiguity\s+([\d.]+)%\s*✓\s*\|\s*spec\s+(\S+)\s*✓/;
+// [PLAN] ✓ impact ✓ | contract ✓ | rollback ✓ | plan <id> ✓
+const PLAN_PATTERN = /\[PLAN\]\s*✓\s*impact\s+✓\s*\|\s*contract\s+✓\s*\|\s*rollback\s+✓\s*\|\s*plan\s+(\S+)\s*✓/;
+// [EXECUTE] ✓ TDD RED ✓ | GREEN ✓ | REFACTOR ✓ | task <id> ✓
+const EXECUTE_PATTERN = /\[EXECUTE\]\s*✓\s*TDD\s+RED\s+✓\s*\|\s*GREEN\s+✓\s*\|\s*REFACTOR\s+✓\s*\|\s*task\s+(\S+)\s*✓/;
+// [VERIFY] ✓ <gate1> ✓ | <gate2> ✓ | ... (flexible)
+const VERIFY_PATTERN = /\[VERIFY\]\s*(.*?)(?:\s*$)/;
+// [REVIEW] ✓ files <count> ✓ | findings <total> ✓ | CRITICAL <n> ✓ | HIGH <n> ✓ | principles <n>/8 ✓
+const REVIEW_PATTERN = /\[REVIEW\]\s*✓\s*files\s+(\d+)\s*✓\s*\|\s*findings\s+(\d+)\s*✓\s*\|\s*CRITICAL\s+(\d+)\s*✓\s*\|\s*HIGH\s+(\d+)\s*✓\s*\|\s*principles\s+(\d+)\/8\s*✓/;
+// [SHIP] ✓ evidence ✓ | staged <count> ✓ | commit <hash> ✓ | push ✓ | report ✓
+const SHIP_PATTERN = /\[SHIP\]\s*✓\s*evidence\s+✓\s*\|\s*staged\s+(\d+)\s*✓\s*\|\s*commit\s+(\S+)\s*✓\s*\|\s*(push|skip)\s+✓\s*\|\s*report\s+✓/;
+// ============================================================================
+// Phase Marker Tracker
+// ============================================================================
+export class PhaseMarkerTracker {
+    constructor(scaleDir = '.scale') {
+        this.stateDir = join(scaleDir, 'phases');
+        this.stateFile = join(this.stateDir, '.phase-state');
+        this.ensureDir();
+    }
+    ensureDir() {
+        if (!existsSync(this.stateDir)) {
+            mkdirSync(this.stateDir, { recursive: true });
+        }
+    }
+    // ─────────────────────────────────────────────────────────────
+    // Marker Parsing
+    // ─────────────────────────────────────────────────────────────
+    /**
+     * 解析文本中的所有 Output Markers 并更新状态
+     * @param text 包含 markers 的文本（对话输出）
+     * @returns 本次解析出的 markers 数量
+     */
+    parseAndUpdate(text) {
+        const markers = this.parseMarkers(text);
+        const keys = Object.keys(markers);
+        if (keys.length === 0)
+            return 0;
+        const state = this.getState();
+        for (const [phase, status] of Object.entries(markers)) {
+            if (status.completed) {
+                state[phase] = status;
+            }
+        }
+        this.writeState(state);
+        logger.info({ phases: keys, count: keys.length }, 'Phase markers parsed and updated');
+        return keys.length;
+    }
+    /**
+     * 解析文本中的所有 Output Markers
+     * @returns 解析结果 Map<Phase, PhaseStatus>
+     */
+    parseMarkers(text) {
+        const results = {};
+        // DEFINE
+        const defineMatch = text.match(DEFINE_PATTERN);
+        if (defineMatch) {
+            results.DEFINE = {
+                completed: true,
+                marker: defineMatch[0],
+                details: {
+                    ambiguity: defineMatch[1],
+                    specId: defineMatch[2],
+                },
+                timestamp: Date.now(),
+            };
+        }
+        // PLAN
+        const planMatch = text.match(PLAN_PATTERN);
+        if (planMatch) {
+            results.PLAN = {
+                completed: true,
+                marker: planMatch[0],
+                details: {
+                    planId: planMatch[1],
+                },
+                timestamp: Date.now(),
+            };
+        }
+        // EXECUTE
+        const executeMatch = text.match(EXECUTE_PATTERN);
+        if (executeMatch) {
+            results.EXECUTE = {
+                completed: true,
+                marker: executeMatch[0],
+                details: {
+                    taskId: executeMatch[1],
+                },
+                timestamp: Date.now(),
+            };
+        }
+        // VERIFY
+        const verifyMatch = text.match(VERIFY_PATTERN);
+        if (verifyMatch) {
+            results.VERIFY = {
+                completed: true,
+                marker: verifyMatch[0],
+                details: {
+                    gates: verifyMatch[1].trim(),
+                },
+                timestamp: Date.now(),
+            };
+        }
+        // REVIEW
+        const reviewMatch = text.match(REVIEW_PATTERN);
+        if (reviewMatch) {
+            results.REVIEW = {
+                completed: true,
+                marker: reviewMatch[0],
+                details: {
+                    files: reviewMatch[1],
+                    findings: reviewMatch[2],
+                    critical: reviewMatch[3],
+                    high: reviewMatch[4],
+                    principles: reviewMatch[5],
+                },
+                timestamp: Date.now(),
+            };
+        }
+        // SHIP
+        const shipMatch = text.match(SHIP_PATTERN);
+        if (shipMatch) {
+            results.SHIP = {
+                completed: true,
+                marker: shipMatch[0],
+                details: {
+                    staged: shipMatch[1],
+                    commit: shipMatch[2],
+                    push: shipMatch[3],
+                },
+                timestamp: Date.now(),
+            };
+        }
+        return results;
+    }
+    // ─────────────────────────────────────────────────────────────
+    // State Management
+    // ─────────────────────────────────────────────────────────────
+    /** 获取当前 Phase 状态 */
+    getState() {
+        if (!existsSync(this.stateFile)) {
+            return this.createDefaultState();
+        }
+        try {
+            const content = readFileSync(this.stateFile, 'utf-8');
+            return JSON.parse(content);
+        }
+        catch {
+            return this.createDefaultState();
+        }
+    }
+    /** 手动标记 Phase 完成 */
+    markComplete(phase, details) {
+        const state = this.getState();
+        state[phase] = {
+            completed: true,
+            details,
+            timestamp: Date.now(),
+        };
+        this.writeState(state);
+        logger.info({ phase, details }, 'Phase marked complete');
+    }
+    /** 重置 Phase 状态 */
+    resetPhase(phase) {
+        const state = this.getState();
+        state[phase] = { completed: false };
+        this.writeState(state);
+        logger.info({ phase }, 'Phase state reset');
+    }
+    /** 重置所有状态 */
+    resetAll() {
+        if (existsSync(this.stateFile)) {
+            unlinkSync(this.stateFile);
+        }
+        logger.info('All phase states reset');
+    }
+    /** 检查单个 Phase 是否完成 */
+    isPhaseComplete(phase) {
+        return this.getState()[phase]?.completed === true;
+    }
+    /** 检查所有必需 Phase 是否完成 */
+    isAllComplete() {
+        const state = this.getState();
+        const required = ['DEFINE', 'PLAN', 'EXECUTE', 'VERIFY', 'REVIEW', 'SHIP'];
+        return required.every(p => state[p]?.completed === true);
+    }
+    /** 获取缺失的 Phase 列表 */
+    getMissingPhases() {
+        const state = this.getState();
+        const required = ['DEFINE', 'PLAN', 'EXECUTE', 'VERIFY', 'REVIEW', 'SHIP'];
+        return required.filter(p => state[p]?.completed !== true);
+    }
+    /** 获取已完成的 Phase 列表 */
+    getCompletedPhases() {
+        const state = this.getState();
+        const all = ['DEFINE', 'PLAN', 'EXECUTE', 'VERIFY', 'REVIEW', 'SHIP'];
+        return all.filter(p => state[p]?.completed === true);
+    }
+    // ─────────────────────────────────────────────────────────────
+    // Report Generation
+    // ─────────────────────────────────────────────────────────────
+    /** 生成状态报告 */
+    generateReport() {
+        const state = this.getState();
+        const phaseOrder = ['DEFINE', 'PLAN', 'EXECUTE', 'VERIFY', 'REVIEW', 'SHIP'];
+        const lines = [
+            '# SCALE Engine Phase Status',
+            '',
+        ];
+        for (const phase of phaseOrder) {
+            const status = state[phase];
+            if (status?.completed) {
+                lines.push(`✅ ${phase}: completed`);
+                if (status.details) {
+                    for (const [key, value] of Object.entries(status.details)) {
+                        lines.push(`   - ${key}: ${value}`);
+                    }
+                }
+            }
+            else {
+                lines.push(`⬜ ${phase}: pending`);
+            }
+        }
+        const completed = phaseOrder.filter(p => state[p]?.completed).length;
+        lines.push('');
+        lines.push(`Progress: ${completed}/${phaseOrder.length} phases`);
+        if (this.isAllComplete()) {
+            lines.push('');
+            lines.push('🎉 All phases complete — ready to ship!');
+        }
+        return lines.join('\n');
+    }
+    /** 生成 Stop Hook 检查结果 */
+    generateStopHookResult() {
+        const missing = this.getMissingPhases();
+        const pass = missing.length === 0;
+        if (pass) {
+            return {
+                pass: true,
+                message: 'All SCALE Engine phases complete',
+                missing: [],
+            };
+        }
+        return {
+            pass: false,
+            message: `Incomplete phases: ${missing.join(', ')}`,
+            missing,
+        };
+    }
+    // ─────────────────────────────────────────────────────────────
+    // Private Helpers
+    // ─────────────────────────────────────────────────────────────
+    createDefaultState() {
+        return {
+            DEFINE: { completed: false },
+            PLAN: { completed: false },
+            EXECUTE: { completed: false },
+            VERIFY: { completed: false },
+            REVIEW: { completed: false },
+            SHIP: { completed: false },
+        };
+    }
+    writeState(state) {
+        this.ensureDir();
+        writeFileSync(this.stateFile, JSON.stringify(state, null, 2), 'utf-8');
+    }
+}
+// ============================================================================
+// Standalone CLI Helper
+// ============================================================================
+/** 快速解析单个 marker 行（供 CLI 和 Hook 使用） */
+export function parsePhaseMarker(line) {
+    const tracker = new PhaseMarkerTracker();
+    const results = tracker.parseMarkers(line);
+    const entries = Object.entries(results);
+    if (entries.length === 0)
+        return null;
+    const [phase, status] = entries[0];
+    return { phase: phase, details: status.details ?? {} };
+}
+//# sourceMappingURL=PhaseMarkerTracker.js.map

package/dist/workflow/PhaseMarkerTracker.js.map

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

package/dist/workflow/ResourceGovernance.d.ts

@@ -0,0 +1,120 @@
+export type ResourceAssetType = 'canonical-doc' | 'task-artifact' | 'evidence-report' | 'temporary' | 'reusable-script' | 'generated-media' | 'contract' | 'decision-record' | 'unknown';
+export type ResourceLifecycle = 'maintained' | 'immutable' | 'task-scoped' | 'temporary' | 'generated' | 'review-required';
+export type ResourceGitPolicy = 'commit' | 'ignore' | 'lfs' | 'external' | 'review';
+export type ResourceFindingSeverity = 'info' | 'warn' | 'fail';
+export interface ResourceAsset {
+    path: string;
+    type: ResourceAssetType;
+    lifecycle: ResourceLifecycle;
+    gitPolicy: ResourceGitPolicy;
+    reason: string;
+    sizeBytes: number;
+    modifiedAt: string;
+    tracked: boolean;
+    retentionDays?: number;
+    expiresAt?: string;
+    owner?: string;
+    module?: string;
+    sourceOfTruth?: boolean;
+}
+export interface ResourceManifestAsset {
+    path: string;
+    type?: ResourceAssetType;
+    lifecycle?: ResourceLifecycle;
+    gitPolicy?: ResourceGitPolicy;
+    owner?: string;
+    module?: string;
+    sourceOfTruth?: boolean;
+    retentionDays?: number;
+    lastReviewedAt?: string;
+    reviewIntervalDays?: number;
+}
+export interface ResourceManifestFile {
+    version?: number;
+    assets?: ResourceManifestAsset[];
+}
+export interface ResourcePolicyFile {
+    version?: number;
+    maxGitFileSizeBytes?: number;
+    ignoredDirectories?: string[];
+    retainedRuntimeDirectories?: string[];
+    owners?: Record<string, string>;
+    modules?: Record<string, {
+        path: string;
+        owner?: string;
+    }>;
+}
+export interface ResolvedResourcePolicy {
+    version: number;
+    maxGitFileSizeBytes: number;
+    ignoredDirectories: string[];
+    retainedRuntimeDirectories: string[];
+    owners: Record<string, string>;
+    modules: Record<string, {
+        path: string;
+        owner?: string;
+    }>;
+    warnings: string[];
+}
+export interface ResolvedResourceManifest {
+    version: number;
+    assets: ResourceManifestAsset[];
+    warnings: string[];
+}
+export interface ResourceScanOptions {
+    projectDir?: string;
+    scaleDir?: string;
+    includeIgnored?: boolean;
+    trackedPaths?: string[];
+    now?: Date;
+}
+export interface ResourceScanSummary {
+    total: number;
+    byType: Record<ResourceAssetType, number>;
+    byGitPolicy: Record<ResourceGitPolicy, number>;
+    trackedForbidden: number;
+    expired: number;
+    largeTracked: number;
+}
+export interface ResourceScanReport {
+    projectDir: string;
+    policyPath: string;
+    manifestPath: string;
+    policy: ResolvedResourcePolicy;
+    manifest: ResolvedResourceManifest;
+    assets: ResourceAsset[];
+    summary: ResourceScanSummary;
+    warnings: string[];
+}
+export interface ResourceFinding {
+    severity: ResourceFindingSeverity;
+    code: string;
+    path?: string;
+    message: string;
+    fix?: string;
+}
+export interface ResourceDoctorReport {
+    ok: boolean;
+    projectDir: string;
+    findings: ResourceFinding[];
+    scan: ResourceScanReport;
+}
+export interface ResourceSettleOptions extends ResourceScanOptions {
+    taskId?: string;
+    artifactsDir?: string;
+}
+export interface ResourceSettleReport {
+    ok: boolean;
+    taskId?: string;
+    resourceImpactPath?: string;
+    doctor: ResourceDoctorReport;
+}
+export declare function resourcePolicyPath(projectDir?: string, scaleDir?: string): string;
+export declare function resourceManifestPath(projectDir?: string, scaleDir?: string): string;
+export declare function resourcePolicyTemplate(): string;
+export declare function resourceManifestTemplate(): string;
+export declare function loadResourcePolicy(projectDir?: string, scaleDir?: string): ResolvedResourcePolicy;
+export declare function loadResourceManifest(projectDir?: string, scaleDir?: string): ResolvedResourceManifest;
+export declare function scanResourceAssets(options?: ResourceScanOptions): ResourceScanReport;
+export declare function doctorResourceAssets(options?: ResourceScanOptions): ResourceDoctorReport;
+export declare function settleResourceAssets(options?: ResourceSettleOptions): ResourceSettleReport;