@hongmaple0820/scale-engine 0.33.0 → 0.38.0

package/dist/workflow/GovernanceRoi.js

@@ -0,0 +1,204 @@
+// SCALE Engine — Governance ROI Report (v0.35.0)
+// End-to-end governance ROI metrics: token cost vs quality vs gate friction
+import { existsSync, readFileSync } from 'node:fs';
+import { isAbsolute, join, resolve } from 'node:path';
+import { TaskMetricsStore } from './TaskMetricsStore.js';
+import { ModelUsageLedger } from '../runtime/ModelUsageLedger.js';
+import { EvidenceStore } from './EvidenceStore.js';
+export function collectGovernanceRoi(input = {}) {
+    const projectDir = resolve(input.projectDir ?? process.cwd());
+    const scaleRoot = isAbsolute(input.scaleDir ?? '')
+        ? input.scaleDir
+        : join(projectDir, input.scaleDir ?? '.scale');
+    const taskMetrics = collectTaskMetrics(scaleRoot);
+    const costMetrics = collectCostMetrics(scaleRoot);
+    const frictionMetrics = collectFrictionMetrics(scaleRoot, taskMetrics.records);
+    const quality = {
+        firstPassRate: taskMetrics.summary.total > 0 ? taskMetrics.summary.firstPassRate : 0,
+        averageFixIterations: taskMetrics.summary.averageFixIterations,
+        gatePassRate: frictionMetrics.totalGateChecks > 0
+            ? (frictionMetrics.totalGateChecks - frictionMetrics.gateBlocks) / frictionMetrics.totalGateChecks
+            : 0,
+        evidenceCompletenessRate: taskMetrics.summary.artifactCompletenessRate,
+        securityFindingsCount: 0,
+        resolvedSecurityFindings: 0,
+    };
+    // Check security audit results
+    const securityPath = join(scaleRoot, 'security-audit.json');
+    if (existsSync(securityPath)) {
+        try {
+            const audit = JSON.parse(readFileSync(securityPath, 'utf-8'));
+            quality.securityFindingsCount = audit.findings?.length ?? 0;
+            quality.resolvedSecurityFindings = audit.findings?.filter((f) => f.resolved).length ?? 0;
+        }
+        catch { /* ignore */ }
+    }
+    const tokenEfficiency = costMetrics.totalTokensUsed > 0
+        ? quality.firstPassRate / (costMetrics.totalTokensUsed / 10000)
+        : 0;
+    const gateEfficiency = frictionMetrics.gateBlocks > 0
+        ? quality.gatePassRate / (frictionMetrics.gateBlocks / Math.max(1, frictionMetrics.totalGateChecks))
+        : quality.gatePassRate;
+    const overallScore = round(Math.min(100, quality.firstPassRate * 30 +
+        quality.gatePassRate * 20 +
+        quality.evidenceCompletenessRate * 20 +
+        (1 - Math.min(1, frictionMetrics.gateBlocks / Math.max(1, frictionMetrics.totalGateChecks))) * 15 +
+        (costMetrics.contextCompilerSavings > 0 ? 10 : 0) +
+        (quality.averageFixIterations < 2 ? 5 : 0)));
+    const recommendations = buildRecommendations(quality, frictionMetrics, costMetrics);
+    return {
+        cost: costMetrics,
+        quality,
+        friction: frictionMetrics,
+        roi: {
+            tokenEfficiency: round(tokenEfficiency),
+            gateEfficiency: round(gateEfficiency),
+            overallScore,
+        },
+        recommendations,
+    };
+}
+export function summarizeGovernanceRoi(summary) {
+    const lines = [
+        '## Governance ROI Report',
+        '',
+        `**Overall Score:** ${summary.roi.overallScore}/100`,
+        '',
+        '### Cost',
+        `- Total Tokens: ${summary.cost.totalTokensUsed.toLocaleString()}`,
+        `- Context Compiler Savings: ${summary.cost.contextCompilerSavings.toLocaleString()}`,
+        `- Cache Hit Savings: ${summary.cost.cacheHitSavings.toLocaleString()}`,
+    ];
+    if (summary.cost.estimatedCostUsd !== undefined) {
+        lines.push(`- Estimated Cost: $${summary.cost.estimatedCostUsd.toFixed(4)}`);
+    }
+    lines.push('', '### Quality', `- First Pass Rate: ${(summary.quality.firstPassRate * 100).toFixed(0)}%`, `- Average Fix Iterations: ${summary.quality.averageFixIterations.toFixed(1)}`, `- Gate Pass Rate: ${(summary.quality.gatePassRate * 100).toFixed(0)}%`, `- Evidence Completeness: ${(summary.quality.evidenceCompletenessRate * 100).toFixed(0)}%`, `- Security Findings: ${summary.quality.securityFindingsCount} (${summary.quality.resolvedSecurityFindings} resolved)`, '', '### Friction', `- Gate Checks: ${summary.friction.totalGateChecks}`, `- Gate Blocks: ${summary.friction.gateBlocks}`, `- Skipped Phases: ${summary.friction.skippedPhases}`, `- Manual Overrides: ${summary.friction.manualOverrides}`, '', '### ROI', `- Token Efficiency: ${summary.roi.tokenEfficiency}`, `- Gate Efficiency: ${summary.roi.gateEfficiency}`);
+    if (summary.recommendations.length > 0) {
+        lines.push('', '### Recommendations');
+        for (const r of summary.recommendations)
+            lines.push(`- ${r}`);
+    }
+    return lines.join('\n');
+}
+export function compareRoiReports(baseline, current) {
+    const costDelta = {
+        totalTokensUsed: current.cost.totalTokensUsed - baseline.cost.totalTokensUsed,
+        contextCompilerSavings: current.cost.contextCompilerSavings - baseline.cost.contextCompilerSavings,
+        cacheHitSavings: current.cost.cacheHitSavings - baseline.cost.cacheHitSavings,
+    };
+    const qualityDelta = {
+        firstPassRate: round(current.quality.firstPassRate - baseline.quality.firstPassRate),
+        averageFixIterations: round(current.quality.averageFixIterations - baseline.quality.averageFixIterations),
+        gatePassRate: round(current.quality.gatePassRate - baseline.quality.gatePassRate),
+    };
+    const frictionDelta = {
+        totalGateChecks: current.friction.totalGateChecks - baseline.friction.totalGateChecks,
+        gateBlocks: current.friction.gateBlocks - baseline.friction.gateBlocks,
+        skippedPhases: current.friction.skippedPhases - baseline.friction.skippedPhases,
+    };
+    const roiDelta = {
+        tokenEfficiencyChange: round(current.roi.tokenEfficiency - baseline.roi.tokenEfficiency),
+        gateEfficiencyChange: round(current.roi.gateEfficiency - baseline.roi.gateEfficiency),
+        overallScoreChange: current.roi.overallScore - baseline.roi.overallScore,
+    };
+    const improving = roiDelta.overallScoreChange > 0;
+    const summary = improving
+        ? `Governance ROI improved by ${roiDelta.overallScoreChange} points.`
+        : roiDelta.overallScoreChange < 0
+            ? `Governance ROI decreased by ${Math.abs(roiDelta.overallScoreChange)} points.`
+            : 'Governance ROI unchanged.';
+    return { costDelta, qualityDelta, frictionDelta, roiDelta, summary };
+}
+function collectTaskMetrics(scaleDir) {
+    try {
+        const store = new TaskMetricsStore(scaleDir);
+        const records = store.list();
+        return { records, summary: store.summarize() };
+    }
+    catch {
+        return {
+            records: [],
+            summary: {
+                total: 0,
+                firstPassRate: 0,
+                averageFixIterations: 0,
+                artifactCompletenessRate: 0,
+                residualRiskClarityRate: 0,
+            },
+        };
+    }
+}
+function collectCostMetrics(scaleDir) {
+    try {
+        const ledger = new ModelUsageLedger(scaleDir);
+        const summary = ledger.summarize();
+        return {
+            totalTokensUsed: summary.totalTokens,
+            tokensByPhase: {},
+            estimatedCostUsd: summary.estimatedCostUsd,
+            contextCompilerSavings: 0,
+            cacheHitSavings: summary.cacheSavingsTokens,
+        };
+    }
+    catch {
+        return {
+            totalTokensUsed: 0,
+            tokensByPhase: {},
+            contextCompilerSavings: 0,
+            cacheHitSavings: 0,
+        };
+    }
+}
+function collectFrictionMetrics(scaleDir, _records) {
+    try {
+        const evidenceStore = new EvidenceStore(scaleDir);
+        const gates = evidenceStore.listGateResults(1000);
+        const totalGateChecks = gates.length;
+        const gateBlocks = gates.filter(g => g.status === 'FAILED').length;
+        return {
+            totalGateChecks,
+            gateBlocks,
+            averageGateLatencyMs: 0,
+            skippedPhases: 0,
+            manualOverrides: 0,
+        };
+    }
+    catch {
+        return {
+            totalGateChecks: 0,
+            gateBlocks: 0,
+            averageGateLatencyMs: 0,
+            skippedPhases: 0,
+            manualOverrides: 0,
+        };
+    }
+}
+function buildRecommendations(quality, friction, cost) {
+    const recs = [];
+    if (quality.firstPassRate < 0.6) {
+        recs.push('First pass rate is below 60%. Improve test coverage and pre-verification checks.');
+    }
+    if (quality.averageFixIterations > 3) {
+        recs.push('Average fix iterations is high. Consider adding more specific error guidance.');
+    }
+    if (quality.gatePassRate < 0.8 && friction.totalGateChecks > 0) {
+        recs.push('Gate pass rate is below 80%. Review gate configurations for false positives.');
+    }
+    if (friction.gateBlocks > friction.totalGateChecks * 0.3 && friction.totalGateChecks > 0) {
+        recs.push('High gate block rate. Consider adjusting thresholds or adding advisory gates.');
+    }
+    if (cost.totalTokensUsed > 0 && cost.contextCompilerSavings === 0) {
+        recs.push('No context compiler savings recorded. Enable context budgeting to reduce token usage.');
+    }
+    if (quality.securityFindingsCount > quality.resolvedSecurityFindings) {
+        recs.push(`${quality.securityFindingsCount - quality.resolvedSecurityFindings} unresolved security finding(s).`);
+    }
+    if (recs.length === 0) {
+        recs.push('Governance metrics look healthy. Continue monitoring.');
+    }
+    return recs;
+}
+function round(n) {
+    return Math.round(n * 100) / 100;
+}
+//# sourceMappingURL=GovernanceRoi.js.map

package/dist/workflow/GovernanceRoi.js.map

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

package/dist/workflow/GovernanceTemplates.js

@@ -276,7 +276,7 @@ SCALE plans required skills from task description, service selection, and change
 
 Tool orchestration is part of the workflow contract:
 
-- UI/UX work requires \`frontend-design\` and \`ui-ux-pro-max\`, and should consider \`awesome-design-md\`, browser screenshots, responsive checks, and visual review evidence.
+- UI/UX work requires \`awesome-design-md\` and \`ui-ux-pro-max\`, and should use \`frontend-design\` as an implementation companion alongside browser screenshots, responsive checks, and visual review evidence.
 - Web research, logged-in pages, and dynamic browser work require \`web-access\` evidence, source citations, and browser/network/console evidence when available.
 - Browser E2E work should combine \`webapp-testing\`, Playwright, Agent Browser, web-access, or Chrome DevTools MCP according to the target and record screenshots plus console/network findings.
 - Desktop or client-side GUI automation uses CUA/computer-use only with explicit operator-safety notes, desktop screenshots, and a side-effect boundary.
@@ -465,7 +465,7 @@ function skillPlanTemplate() {
 
 | Capability | Primary Tool Or Skill | Fallback | Required Evidence |
 | --- | --- | --- | --- |
-| UI/UX design | frontend-design, ui-ux-pro-max | awesome-design-md | design-system, ui-spec.md, visual-review.md |
+| UI/UX design | awesome-design-md, ui-ux-pro-max | frontend-design | design-system, ui-spec.md, visual-review.md |
 | Web research or logged-in pages | web-access | agent-browser, Chrome DevTools MCP | source citations, browser evidence |
 | Browser E2E | webapp-testing, Playwright | agent-browser, web-access | screenshot, console, network evidence |
 | Desktop GUI automation | CUA/computer-use | manual verification | desktop screenshot, operator-safety notes |

package/dist/workflow/McpGovernance.d.ts

@@ -0,0 +1,63 @@
+export type McpServerStatus = 'unknown' | 'healthy' | 'degraded' | 'unhealthy' | 'blocked';
+export type McpSecurityLevel = 'trusted' | 'review' | 'untrusted';
+export interface McpServerRegistration {
+    id: string;
+    name: string;
+    transport: 'stdio' | 'sse' | 'streamable-http';
+    command?: string;
+    url?: string;
+    version?: string;
+    securityLevel: McpSecurityLevel;
+    capabilities: string[];
+    registeredAt: string;
+    lastHealthCheck?: string;
+    status: McpServerStatus;
+}
+export interface McpHealthCheckResult {
+    serverId: string;
+    status: McpServerStatus;
+    latency?: number;
+    toolCount?: number;
+    error?: string;
+    checkedAt: string;
+}
+export interface McpGovernanceConfig {
+    autoHealthCheck: boolean;
+    healthCheckIntervalMs: number;
+    blockUntrusted: boolean;
+    requiredCapabilities: string[];
+    maxLatencyMs: number;
+}
+export interface McpSecurityScanResult {
+    serverId: string;
+    findings: McpSecurityFinding[];
+    riskLevel: 'low' | 'medium' | 'high' | 'critical';
+    scannedAt: string;
+}
+export interface McpSecurityFinding {
+    id: string;
+    severity: 'low' | 'medium' | 'high' | 'critical';
+    title: string;
+    description: string;
+    recommendation: string;
+}
+export declare class McpGovernor {
+    private servers;
+    private config;
+    private now;
+    constructor(config?: McpGovernanceConfig, now?: () => Date);
+    register(server: Omit<McpServerRegistration, 'registeredAt' | 'status'>): McpServerRegistration;
+    unregister(id: string): void;
+    getServer(id: string): McpServerRegistration | undefined;
+    listServers(): McpServerRegistration[];
+    checkHealth(id: string): McpHealthCheckResult;
+    checkAllHealth(): McpHealthCheckResult[];
+    scanSecurity(id: string): McpSecurityScanResult;
+    isAllowed(id: string, toolName: string): {
+        allowed: boolean;
+        reason?: string;
+    };
+    getConfig(): McpGovernanceConfig;
+    updateConfig(patch: Partial<McpGovernanceConfig>): void;
+    loadFromProject(projectDir?: string): void;
+}

package/dist/workflow/McpGovernance.js

@@ -0,0 +1,198 @@
+// SCALE Engine — MCP Lifecycle Governance (v0.34.0)
+// MCP server lifecycle management with health checks, security scanning, and policy enforcement
+import { existsSync, readFileSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import yaml from 'js-yaml';
+import { randomUUID } from 'node:crypto';
+const DEFAULT_GOVERNANCE_CONFIG = {
+    autoHealthCheck: true,
+    healthCheckIntervalMs: 30000,
+    blockUntrusted: false,
+    requiredCapabilities: [],
+    maxLatencyMs: 5000,
+};
+export class McpGovernor {
+    constructor(config, now) {
+        this.servers = new Map();
+        this.config = config ?? { ...DEFAULT_GOVERNANCE_CONFIG };
+        this.now = now ?? (() => new Date());
+    }
+    register(server) {
+        const existing = this.servers.get(server.id);
+        const registration = {
+            ...server,
+            registeredAt: existing?.registeredAt ?? this.now().toISOString(),
+            status: existing?.status ?? 'unknown',
+            lastHealthCheck: existing?.lastHealthCheck,
+        };
+        this.servers.set(server.id, registration);
+        return registration;
+    }
+    unregister(id) {
+        this.servers.delete(id);
+    }
+    getServer(id) {
+        return this.servers.get(id);
+    }
+    listServers() {
+        return [...this.servers.values()];
+    }
+    checkHealth(id) {
+        const server = this.servers.get(id);
+        if (!server) {
+            return {
+                serverId: id,
+                status: 'unhealthy',
+                error: 'Server not registered',
+                checkedAt: this.now().toISOString(),
+            };
+        }
+        // Blocked servers stay blocked
+        if (server.status === 'blocked') {
+            return {
+                serverId: id,
+                status: 'blocked',
+                error: 'Server is blocked by governance policy',
+                checkedAt: this.now().toISOString(),
+            };
+        }
+        // Check security level against policy
+        if (this.config.blockUntrusted && server.securityLevel === 'untrusted') {
+            server.status = 'blocked';
+            return {
+                serverId: id,
+                status: 'blocked',
+                error: 'Untrusted server blocked by governance policy',
+                checkedAt: this.now().toISOString(),
+            };
+        }
+        // Simulate health check based on registration data
+        const latency = server.transport === 'stdio' ? 50 : 200;
+        const status = latency > this.config.maxLatencyMs ? 'degraded' : 'healthy';
+        server.status = status;
+        server.lastHealthCheck = this.now().toISOString();
+        return {
+            serverId: id,
+            status,
+            latency,
+            toolCount: server.capabilities.length,
+            checkedAt: server.lastHealthCheck,
+        };
+    }
+    checkAllHealth() {
+        return [...this.servers.keys()].map(id => this.checkHealth(id));
+    }
+    scanSecurity(id) {
+        const server = this.servers.get(id);
+        const scannedAt = this.now().toISOString();
+        if (!server) {
+            return {
+                serverId: id,
+                findings: [{
+                        id: `MCP-SEC-${randomUUID().slice(0, 8)}`,
+                        severity: 'high',
+                        title: 'Unregistered server',
+                        description: `Server "${id}" is not registered in the governance system`,
+                        recommendation: 'Register the server before use',
+                    }],
+                riskLevel: 'high',
+                scannedAt,
+            };
+        }
+        const findings = [];
+        // Check security level
+        if (server.securityLevel === 'untrusted') {
+            findings.push({
+                id: `MCP-SEC-${randomUUID().slice(0, 8)}`,
+                severity: 'high',
+                title: 'Untrusted security level',
+                description: `Server "${server.name}" has untrusted security level`,
+                recommendation: 'Review server source and upgrade to "review" or "trusted" after validation',
+            });
+        }
+        // Check required capabilities
+        for (const cap of this.config.requiredCapabilities) {
+            if (!server.capabilities.includes(cap)) {
+                findings.push({
+                    id: `MCP-SEC-${randomUUID().slice(0, 8)}`,
+                    severity: 'medium',
+                    title: 'Missing required capability',
+                    description: `Server "${server.name}" is missing required capability "${cap}"`,
+                    recommendation: `Add "${cap}" capability to the server configuration`,
+                });
+            }
+        }
+        // Check transport security
+        if (server.transport === 'sse' && !server.url?.startsWith('https://')) {
+            findings.push({
+                id: `MCP-SEC-${randomUUID().slice(0, 8)}`,
+                severity: 'medium',
+                title: 'Insecure transport',
+                description: `Server "${server.name}" uses SSE without HTTPS`,
+                recommendation: 'Use HTTPS for SSE transport to prevent MITM attacks',
+            });
+        }
+        // Check for stdio with command injection risk
+        if (server.transport === 'stdio' && server.command) {
+            if (server.command.includes('&&') || server.command.includes('|') || server.command.includes(';')) {
+                findings.push({
+                    id: `MCP-SEC-${randomUUID().slice(0, 8)}`,
+                    severity: 'critical',
+                    title: 'Potential command injection',
+                    description: `Server "${server.name}" command contains shell operators`,
+                    recommendation: 'Remove shell operators from the command; use separate arguments',
+                });
+            }
+        }
+        const riskLevel = findings.some(f => f.severity === 'critical')
+            ? 'critical'
+            : findings.some(f => f.severity === 'high')
+                ? 'high'
+                : findings.some(f => f.severity === 'medium')
+                    ? 'medium'
+                    : 'low';
+        return { serverId: id, findings, riskLevel, scannedAt };
+    }
+    isAllowed(id, toolName) {
+        const server = this.servers.get(id);
+        if (!server)
+            return { allowed: false, reason: 'Server not registered' };
+        if (server.status === 'blocked')
+            return { allowed: false, reason: 'Server is blocked' };
+        if (this.config.blockUntrusted && server.securityLevel === 'untrusted') {
+            return { allowed: false, reason: 'Untrusted server blocked by governance policy' };
+        }
+        if (!server.capabilities.includes(toolName)) {
+            return { allowed: false, reason: `Tool "${toolName}" not in server capabilities` };
+        }
+        return { allowed: true };
+    }
+    getConfig() {
+        return { ...this.config };
+    }
+    updateConfig(patch) {
+        Object.assign(this.config, patch);
+    }
+    loadFromProject(projectDir) {
+        const dir = resolve(projectDir ?? process.cwd());
+        const configPath = join(dir, '.scale', 'mcp-servers.yaml');
+        if (!existsSync(configPath))
+            return;
+        try {
+            const content = readFileSync(configPath, 'utf-8');
+            const parsed = yaml.load(content);
+            if (parsed.governance) {
+                Object.assign(this.config, parsed.governance);
+            }
+            if (Array.isArray(parsed.servers)) {
+                for (const server of parsed.servers) {
+                    this.register(server);
+                }
+            }
+        }
+        catch {
+            // ignore parse errors
+        }
+    }
+}
+//# sourceMappingURL=McpGovernance.js.map

package/dist/workflow/McpGovernance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"McpGovernance.js","sourceRoot":"","sources":["../../src/workflow/McpGovernance.ts"],"names":[],"mappings":"AAAA,oDAAoD;AACpD,gGAAgG;AAEhG,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAClD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACzC,OAAO,IAAI,MAAM,SAAS,CAAA;AAC1B,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AAmDxC,MAAM,yBAAyB,GAAwB;IACrD,eAAe,EAAE,IAAI;IACrB,qBAAqB,EAAE,KAAK;IAC5B,cAAc,EAAE,KAAK;IACrB,oBAAoB,EAAE,EAAE;IACxB,YAAY,EAAE,IAAI;CACnB,CAAA;AAED,MAAM,OAAO,WAAW;IAKtB,YAAY,MAA4B,EAAE,GAAgB;QAJlD,YAAO,GAAuC,IAAI,GAAG,EAAE,CAAA;QAK7D,IAAI,CAAC,MAAM,GAAG,MAAM,IAAI,EAAE,GAAG,yBAAyB,EAAE,CAAA;QACxD,IAAI,CAAC,GAAG,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC,CAAA;IACtC,CAAC;IAED,QAAQ,CAAC,MAA8D;QACrE,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;QAC5C,MAAM,YAAY,GAA0B;YAC1C,GAAG,MAAM;YACT,YAAY,EAAE,QAAQ,EAAE,YAAY,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;YAChE,MAAM,EAAE,QAAQ,EAAE,MAAM,IAAI,SAAS;YACrC,eAAe,EAAE,QAAQ,EAAE,eAAe;SAC3C,CAAA;QACD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,YAAY,CAAC,CAAA;QACzC,OAAO,YAAY,CAAA;IACrB,CAAC;IAED,UAAU,CAAC,EAAU;QACnB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;IACzB,CAAC;IAED,SAAS,CAAC,EAAU;QAClB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;IAC7B,CAAC;IAED,WAAW;QACT,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IACnC,CAAC;IAED,WAAW,CAAC,EAAU;QACpB,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QACnC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO;gBACL,QAAQ,EAAE,EAAE;gBACZ,MAAM,EAAE,WAAW;gBACnB,KAAK,EAAE,uBAAuB;gBAC9B,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;aACpC,CAAA;QACH,CAAC;QAED,+BAA+B;QAC/B,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAChC,OAAO;gBACL,QAAQ,EAAE,EAAE;gBACZ,MAAM,EAAE,SAAS;gBACjB,KAAK,EAAE,wCAAwC;gBAC/C,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;aACpC,CAAA;QACH,CAAC;QAED,sCAAsC;QACtC,IAAI,IAAI,CAAC,MAAM,CAAC,cAAc,IAAI,MAAM,CAAC,aAAa,KAAK,WAAW,EAAE,CAAC;YACvE,MAAM,CAAC,MAAM,GAAG,SAAS,CAAA;YACzB,OAAO;gBACL,QAAQ,EAAE,EAAE;gBACZ,MAAM,EAAE,SAAS;gBACjB,KAAK,EAAE,+CAA+C;gBACtD,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;aACpC,CAAA;QACH,CAAC;QAED,mDAAmD;QACnD,MAAM,OAAO,GAAG,MAAM,CAAC,SAAS,KAAK,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAA;QACvD,MAAM,MAAM,GAAoB,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAA;QAE3F,MAAM,CAAC,MAAM,GAAG,MAAM,CAAA;QACtB,MAAM,CAAC,eAAe,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAA;QAEjD,OAAO;YACL,QAAQ,EAAE,EAAE;YACZ,MAAM;YACN,OAAO;YACP,SAAS,EAAE,MAAM,CAAC,YAAY,CAAC,MAAM;YACrC,SAAS,EAAE,MAAM,CAAC,eAAe;SAClC,CAAA;IACH,CAAC;IAED,cAAc;QACZ,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,CAAA;IACjE,CAAC;IAED,YAAY,CAAC,EAAU;QACrB,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QACnC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAA;QAE1C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO;gBACL,QAAQ,EAAE,EAAE;gBACZ,QAAQ,EAAE,CAAC;wBACT,EAAE,EAAE,WAAW,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE;wBACzC,QAAQ,EAAE,MAAM;wBAChB,KAAK,EAAE,qBAAqB;wBAC5B,WAAW,EAAE,WAAW,EAAE,8CAA8C;wBACxE,cAAc,EAAE,gCAAgC;qBACjD,CAAC;gBACF,SAAS,EAAE,MAAM;gBACjB,SAAS;aACV,CAAA;QACH,CAAC;QAED,MAAM,QAAQ,GAAyB,EAAE,CAAA;QAEzC,uBAAuB;QACvB,IAAI,MAAM,CAAC,aAAa,KAAK,WAAW,EAAE,CAAC;YACzC,QAAQ,CAAC,IAAI,CAAC;gBACZ,EAAE,EAAE,WAAW,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE;gBACzC,QAAQ,EAAE,MAAM;gBAChB,KAAK,EAAE,0BAA0B;gBACjC,WAAW,EAAE,WAAW,MAAM,CAAC,IAAI,gCAAgC;gBACnE,cAAc,EAAE,4EAA4E;aAC7F,CAAC,CAAA;QACJ,CAAC;QAED,8BAA8B;QAC9B,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,oBAAoB,EAAE,CAAC;YACnD,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBACvC,QAAQ,CAAC,IAAI,CAAC;oBACZ,EAAE,EAAE,WAAW,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE;oBACzC,QAAQ,EAAE,QAAQ;oBAClB,KAAK,EAAE,6BAA6B;oBACpC,WAAW,EAAE,WAAW,MAAM,CAAC,IAAI,qCAAqC,GAAG,GAAG;oBAC9E,cAAc,EAAE,QAAQ,GAAG,0CAA0C;iBACtE,CAAC,CAAA;YACJ,CAAC;QACH,CAAC;QAED,2BAA2B;QAC3B,IAAI,MAAM,CAAC,SAAS,KAAK,KAAK,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YACtE,QAAQ,CAAC,IAAI,CAAC;gBACZ,EAAE,EAAE,WAAW,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE;gBACzC,QAAQ,EAAE,QAAQ;gBAClB,KAAK,EAAE,oBAAoB;gBAC3B,WAAW,EAAE,WAAW,MAAM,CAAC,IAAI,0BAA0B;gBAC7D,cAAc,EAAE,qDAAqD;aACtE,CAAC,CAAA;QACJ,CAAC;QAED,8CAA8C;QAC9C,IAAI,MAAM,CAAC,SAAS,KAAK,OAAO,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACnD,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBAClG,QAAQ,CAAC,IAAI,CAAC;oBACZ,EAAE,EAAE,WAAW,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE;oBACzC,QAAQ,EAAE,UAAU;oBACpB,KAAK,EAAE,6BAA6B;oBACpC,WAAW,EAAE,WAAW,MAAM,CAAC,IAAI,oCAAoC;oBACvE,cAAc,EAAE,iEAAiE;iBAClF,CAAC,CAAA;YACJ,CAAC;QACH,CAAC;QAED,MAAM,SAAS,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,UAAU,CAAC;YAC7D,CAAC,CAAC,UAAU;YACZ,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,MAAM,CAAC;gBACzC,CAAC,CAAC,MAAM;gBACR,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC;oBAC3C,CAAC,CAAC,QAAQ;oBACV,CAAC,CAAC,KAAK,CAAA;QAEb,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,CAAA;IACzD,CAAC;IAED,SAAS,CAAC,EAAU,EAAE,QAAgB;QACpC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QACnC,IAAI,CAAC,MAAM;YAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,uBAAuB,EAAE,CAAA;QACvE,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS;YAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,mBAAmB,EAAE,CAAA;QACvF,IAAI,IAAI,CAAC,MAAM,CAAC,cAAc,IAAI,MAAM,CAAC,aAAa,KAAK,WAAW,EAAE,CAAC;YACvE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,+CAA+C,EAAE,CAAA;QACpF,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5C,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,QAAQ,8BAA8B,EAAE,CAAA;QACpF,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;IAC1B,CAAC;IAED,SAAS;QACP,OAAO,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAA;IAC3B,CAAC;IAED,YAAY,CAAC,KAAmC;QAC9C,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;IACnC,CAAC;IAED,eAAe,CAAC,UAAmB;QACjC,MAAM,GAAG,GAAG,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAA;QAChD,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,QAAQ,EAAE,kBAAkB,CAAC,CAAA;QAC1D,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;YAAE,OAAM;QAEnC,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAA;YACjD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAA2H,CAAA;YAE3J,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;gBACtB,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,UAAU,CAAC,CAAA;YAC/C,CAAC;YAED,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;gBAClC,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;oBACpC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;gBACvB,CAAC;YACH,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,sBAAsB;QACxB,CAAC;IACH,CAAC;CACF"}

package/dist/workflow/SessionCoordinator.d.ts

@@ -0,0 +1,103 @@
+export type SessionTaskStatus = 'planned' | 'active' | 'blocked' | 'done' | 'cancelled';
+export type DependencyType = 'blocks' | 'soft-dep' | 'data-flow';
+export type OverlapRisk = 'low' | 'medium' | 'high';
+export type EnforcementLevel = 'advisory' | 'warn' | 'block';
+export type ConflictResolution = 'accept' | 'defer' | 'split-files' | 'manual';
+export interface SessionTask {
+    sessionId: string;
+    taskId: string;
+    files: string[];
+    dependencies: string[];
+    status: SessionTaskStatus;
+    startedAt: string;
+    completedAt?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface FileOverlap {
+    file: string;
+    sessions: Array<{
+        sessionId: string;
+        taskId: string;
+    }>;
+    risk: OverlapRisk;
+    suggestion: string;
+}
+export interface TaskDependencyEdge {
+    from: string;
+    to: string;
+    type: DependencyType;
+    reason: string;
+}
+export interface ConflictRecord {
+    id: string;
+    file: string;
+    sessions: string[];
+    resolution: ConflictResolution;
+    resolvedBy?: string;
+    resolvedAt: string;
+    notes?: string;
+}
+export interface SessionCoordinatorConfig {
+    enforcement: EnforcementLevel;
+    maxConcurrentSessions: number;
+    trackFileOverlaps: boolean;
+    autoBlockOnHighRisk: boolean;
+}
+export interface SessionCoordinatorInput {
+    projectDir?: string;
+    scaleDir?: string;
+    config?: Partial<SessionCoordinatorConfig>;
+}
+export interface CoordinationStatus {
+    activeSessions: number;
+    activeTasks: SessionTask[];
+    fileOverlaps: FileOverlap[];
+    blockedTasks: Array<{
+        taskId: string;
+        blockedBy: string[];
+    }>;
+    conflicts: ConflictRecord[];
+    recommendations: string[];
+}
+export interface TopologicalOrder {
+    order: string[];
+    cycles: string[][];
+    blocked: string[];
+}
+export declare class SessionCoordinator {
+    private tasks;
+    private dependencies;
+    private conflicts;
+    private config;
+    private statePath;
+    private stateDir;
+    constructor(input?: SessionCoordinatorInput);
+    registerSession(task: Omit<SessionTask, 'status' | 'startedAt'>): SessionTask;
+    activateTask(taskId: string): {
+        allowed: boolean;
+        blockers: string[];
+    };
+    completeTask(taskId: string): void;
+    cancelTask(taskId: string): void;
+    blockTask(taskId: string): void;
+    detectOverlaps(): FileOverlap[];
+    addDependency(edge: TaskDependencyEdge): void;
+    getTopologicalOrder(): TopologicalOrder;
+    getDependencies(taskId: string): {
+        upstream: string[];
+        downstream: string[];
+    };
+    recordConflict(conflict: Omit<ConflictRecord, 'id' | 'resolvedAt'>): ConflictRecord;
+    getCoordinationStatus(): CoordinationStatus;
+    private loadState;
+    private saveState;
+    private getActiveTasks;
+    getTask(taskId: string): SessionTask | undefined;
+    listTasks(): SessionTask[];
+    private getTaskBlockers;
+    private assessOverlapRisk;
+    private suggestOverlapResolution;
+    private findCycles;
+    private buildRecommendations;
+}
+export declare function summarizeCoordinationStatus(status: CoordinationStatus): string;