@hongmaple0820/med-scale-research-os 0.43.0

package/dist/workflow/SessionCoordinator.js

@@ -0,0 +1,401 @@
+// SCALE Engine — Session Coordinator
+// Multi-session parallel task coordination: file overlap detection, task dependency graph, conflict resolution
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { isAbsolute, join, resolve } from 'node:path';
+// ============================================================================
+// Defaults
+// ============================================================================
+const DEFAULT_CONFIG = {
+    enforcement: 'warn',
+    maxConcurrentSessions: 10,
+    trackFileOverlaps: true,
+    autoBlockOnHighRisk: false,
+};
+// ============================================================================
+// SessionCoordinator
+// ============================================================================
+export class SessionCoordinator {
+    constructor(input = {}) {
+        const projectDir = resolve(input.projectDir ?? process.cwd());
+        const scaleRoot = isAbsolute(input.scaleDir ?? '')
+            ? input.scaleDir
+            : join(projectDir, input.scaleDir ?? '.scale');
+        this.stateDir = join(scaleRoot, 'coordinator');
+        this.statePath = join(this.stateDir, 'state.json');
+        this.config = { ...DEFAULT_CONFIG, ...input.config };
+        this.tasks = new Map();
+        this.dependencies = [];
+        this.conflicts = [];
+        this.loadState();
+    }
+    // --------------------------------------------------------------------------
+    // Session Registration
+    // --------------------------------------------------------------------------
+    registerSession(task) {
+        const existing = this.tasks.get(task.taskId);
+        if (existing && existing.status !== 'cancelled' && existing.status !== 'done') {
+            return existing;
+        }
+        const fullTask = {
+            ...task,
+            status: 'planned',
+            startedAt: new Date().toISOString(),
+            files: task.files.map(normalizePath),
+        };
+        this.tasks.set(fullTask.taskId, fullTask);
+        // Register dependencies as edges
+        for (const depId of fullTask.dependencies) {
+            this.dependencies.push({
+                from: depId,
+                to: fullTask.taskId,
+                type: 'blocks',
+                reason: `${fullTask.taskId} declares dependency on ${depId}`,
+            });
+        }
+        this.saveState();
+        return fullTask;
+    }
+    activateTask(taskId) {
+        const task = this.tasks.get(taskId);
+        if (!task)
+            return { allowed: false, blockers: [`Task ${taskId} not found.`] };
+        const blockers = this.getTaskBlockers(taskId);
+        if (blockers.length > 0 && this.config.enforcement === 'block') {
+            return { allowed: false, blockers };
+        }
+        task.status = 'active';
+        this.saveState();
+        return { allowed: true, blockers };
+    }
+    completeTask(taskId) {
+        const task = this.tasks.get(taskId);
+        if (!task)
+            return;
+        task.status = 'done';
+        task.completedAt = new Date().toISOString();
+        this.saveState();
+    }
+    cancelTask(taskId) {
+        const task = this.tasks.get(taskId);
+        if (!task)
+            return;
+        task.status = 'cancelled';
+        task.completedAt = new Date().toISOString();
+        this.saveState();
+    }
+    blockTask(taskId) {
+        const task = this.tasks.get(taskId);
+        if (!task)
+            return;
+        task.status = 'blocked';
+        this.saveState();
+    }
+    // --------------------------------------------------------------------------
+    // File Overlap Detection
+    // --------------------------------------------------------------------------
+    detectOverlaps() {
+        const activeTasks = this.getActiveTasks();
+        const fileMap = new Map();
+        for (const task of activeTasks) {
+            for (const file of task.files) {
+                const normalized = normalizePath(file);
+                const group = fileMap.get(normalized) ?? [];
+                group.push({ sessionId: task.sessionId, taskId: task.taskId });
+                fileMap.set(normalized, group);
+            }
+        }
+        const overlaps = [];
+        for (const [file, sessions] of fileMap) {
+            if (sessions.length < 2)
+                continue;
+            const risk = this.assessOverlapRisk(file, sessions.map(s => s.taskId));
+            overlaps.push({
+                file,
+                sessions,
+                risk,
+                suggestion: this.suggestOverlapResolution(file, risk, sessions.length),
+            });
+        }
+        return overlaps;
+    }
+    // --------------------------------------------------------------------------
+    // Task Dependency Graph
+    // --------------------------------------------------------------------------
+    addDependency(edge) {
+        this.dependencies.push(edge);
+        this.saveState();
+    }
+    getTopologicalOrder() {
+        const taskIds = new Set();
+        for (const task of this.tasks.values()) {
+            if (task.status !== 'cancelled' && task.status !== 'done') {
+                taskIds.add(task.taskId);
+            }
+        }
+        const adjacency = new Map();
+        const inDegree = new Map();
+        for (const id of taskIds) {
+            adjacency.set(id, []);
+            inDegree.set(id, 0);
+        }
+        for (const edge of this.dependencies) {
+            if (taskIds.has(edge.from) && taskIds.has(edge.to)) {
+                adjacency.get(edge.from).push(edge.to);
+                inDegree.set(edge.to, (inDegree.get(edge.to) ?? 0) + 1);
+            }
+        }
+        // Kahn's algorithm with cycle detection
+        const queue = [];
+        for (const [id, deg] of inDegree) {
+            if (deg === 0)
+                queue.push(id);
+        }
+        const order = [];
+        while (queue.length > 0) {
+            const current = queue.shift();
+            order.push(current);
+            for (const neighbor of adjacency.get(current) ?? []) {
+                const newDeg = (inDegree.get(neighbor) ?? 1) - 1;
+                inDegree.set(neighbor, newDeg);
+                if (newDeg === 0)
+                    queue.push(neighbor);
+            }
+        }
+        // Nodes not in order are in cycles
+        const inOrder = new Set(order);
+        const blocked = [...taskIds].filter(id => !inOrder.has(id));
+        // Find actual cycles
+        const cycles = this.findCycles(blocked, adjacency);
+        return { order, cycles, blocked };
+    }
+    getDependencies(taskId) {
+        const upstream = [];
+        const downstream = [];
+        for (const edge of this.dependencies) {
+            if (edge.to === taskId && !upstream.includes(edge.from))
+                upstream.push(edge.from);
+            if (edge.from === taskId && !downstream.includes(edge.to))
+                downstream.push(edge.to);
+        }
+        return { upstream, downstream };
+    }
+    // --------------------------------------------------------------------------
+    // Conflict Resolution
+    // --------------------------------------------------------------------------
+    recordConflict(conflict) {
+        const record = {
+            ...conflict,
+            id: `CONFLICT-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`,
+            resolvedAt: new Date().toISOString(),
+        };
+        this.conflicts.push(record);
+        this.saveState();
+        return record;
+    }
+    // --------------------------------------------------------------------------
+    // Status & Recommendations
+    // --------------------------------------------------------------------------
+    getCoordinationStatus() {
+        const activeTasks = this.getActiveTasks();
+        const overlaps = this.config.trackFileOverlaps ? this.detectOverlaps() : [];
+        const topo = this.getTopologicalOrder();
+        const blockedTasks = topo.blocked.map(taskId => ({
+            taskId,
+            blockedBy: this.getDependencies(taskId).upstream.filter(depId => this.tasks.get(depId)?.status !== 'done'),
+        }));
+        const recommendations = this.buildRecommendations(activeTasks, overlaps, blockedTasks);
+        return {
+            activeSessions: new Set(activeTasks.map(t => t.sessionId)).size,
+            activeTasks,
+            fileOverlaps: overlaps,
+            blockedTasks,
+            conflicts: this.conflicts,
+            recommendations,
+        };
+    }
+    // --------------------------------------------------------------------------
+    // State Persistence
+    // --------------------------------------------------------------------------
+    loadState() {
+        if (!existsSync(this.statePath))
+            return;
+        try {
+            const raw = JSON.parse(readFileSync(this.statePath, 'utf-8'));
+            if (raw.tasks) {
+                for (const [id, task] of Object.entries(raw.tasks)) {
+                    this.tasks.set(id, task);
+                }
+            }
+            if (raw.dependencies)
+                this.dependencies = raw.dependencies;
+            if (raw.conflicts)
+                this.conflicts = raw.conflicts;
+        }
+        catch { /* ignore corrupt state */ }
+    }
+    saveState() {
+        if (!existsSync(this.stateDir))
+            mkdirSync(this.stateDir, { recursive: true });
+        const tasks = {};
+        for (const [id, task] of this.tasks)
+            tasks[id] = task;
+        writeFileSync(this.statePath, JSON.stringify({
+            tasks,
+            dependencies: this.dependencies,
+            conflicts: this.conflicts,
+        }, null, 2), 'utf-8');
+    }
+    // --------------------------------------------------------------------------
+    // Internal
+    // --------------------------------------------------------------------------
+    getActiveTasks() {
+        return [...this.tasks.values()].filter(t => t.status === 'active' || t.status === 'planned');
+    }
+    getTask(taskId) {
+        return this.tasks.get(taskId);
+    }
+    listTasks() {
+        return [...this.tasks.values()];
+    }
+    getTaskBlockers(taskId) {
+        const blockers = [];
+        const { upstream } = this.getDependencies(taskId);
+        for (const depId of upstream) {
+            const dep = this.tasks.get(depId);
+            if (dep && dep.status !== 'done') {
+                blockers.push(`Task ${taskId} blocked by ${depId} (status: ${dep.status})`);
+            }
+        }
+        // Check file overlaps with high risk
+        if (this.config.autoBlockOnHighRisk) {
+            const task = this.tasks.get(taskId);
+            if (task) {
+                const overlaps = this.detectOverlaps();
+                for (const overlap of overlaps) {
+                    if (overlap.risk === 'high' && overlap.sessions.some(s => s.taskId === taskId)) {
+                        blockers.push(`High-risk file overlap on ${overlap.file}`);
+                    }
+                }
+            }
+        }
+        return blockers;
+    }
+    assessOverlapRisk(file, taskIds) {
+        // Shared config/infra files are high risk
+        if (file.includes('package.json') || file.includes('tsconfig') || file.includes('.env') || file.includes('Makefile')) {
+            return 'high';
+        }
+        // 3+ sessions on same file is high risk
+        if (taskIds.length >= 3)
+            return 'high';
+        // 2 sessions on same file is medium risk
+        return 'medium';
+    }
+    suggestOverlapResolution(file, risk, sessionCount) {
+        if (risk === 'high') {
+            return `High-risk overlap on "${file}" (${sessionCount} sessions). Consider sequential access or splitting the file.`;
+        }
+        return `Medium-risk overlap on "${file}" (${sessionCount} sessions). Coordinate merge order to avoid conflicts.`;
+    }
+    findCycles(nodes, adjacency) {
+        const cycles = [];
+        const visited = new Set();
+        const inStack = new Set();
+        const dfs = (node, path) => {
+            if (inStack.has(node)) {
+                const cycleStart = path.indexOf(node);
+                if (cycleStart >= 0) {
+                    cycles.push(path.slice(cycleStart));
+                }
+                return true;
+            }
+            if (visited.has(node))
+                return false;
+            visited.add(node);
+            inStack.add(node);
+            path.push(node);
+            for (const neighbor of adjacency.get(node) ?? []) {
+                if (nodes.includes(neighbor)) {
+                    dfs(neighbor, path);
+                }
+            }
+            path.pop();
+            inStack.delete(node);
+            return false;
+        };
+        for (const node of nodes) {
+            if (!visited.has(node))
+                dfs(node, []);
+        }
+        return cycles;
+    }
+    buildRecommendations(activeTasks, overlaps, blockedTasks) {
+        const recs = [];
+        if (activeTasks.length > this.config.maxConcurrentSessions) {
+            recs.push(`${activeTasks.length} active tasks exceed max concurrent limit (${this.config.maxConcurrentSessions}). Consider finishing some before starting new ones.`);
+        }
+        const highRiskOverlaps = overlaps.filter(o => o.risk === 'high');
+        if (highRiskOverlaps.length > 0) {
+            recs.push(`${highRiskOverlaps.length} high-risk file overlap(s) detected. Review and coordinate before merging.`);
+        }
+        if (blockedTasks.length > 0) {
+            recs.push(`${blockedTasks.length} task(s) are blocked by unfinished dependencies.`);
+        }
+        const cycles = this.getTopologicalOrder().cycles;
+        if (cycles.length > 0) {
+            recs.push(`${cycles.length} circular dependency cycle(s) detected. Break cycles to unblock execution.`);
+        }
+        if (recs.length === 0) {
+            recs.push('No coordination issues detected. All sessions are clear to proceed.');
+        }
+        return recs;
+    }
+}
+// ============================================================================
+// Summary Formatter
+// ============================================================================
+export function summarizeCoordinationStatus(status) {
+    const lines = [
+        '## Session Coordination Status',
+        '',
+        `**Active Sessions:** ${status.activeSessions}`,
+        `**Active Tasks:** ${status.activeTasks.length}`,
+        '',
+    ];
+    if (status.fileOverlaps.length > 0) {
+        lines.push('### File Overlaps');
+        for (const overlap of status.fileOverlaps) {
+            const sessionIds = overlap.sessions.map(s => s.sessionId).join(', ');
+            lines.push(`- \`${overlap.file}\` [${overlap.risk}] — ${sessionIds}`);
+            lines.push(`  ${overlap.suggestion}`);
+        }
+        lines.push('');
+    }
+    if (status.blockedTasks.length > 0) {
+        lines.push('### Blocked Tasks');
+        for (const blocked of status.blockedTasks) {
+            lines.push(`- ${blocked.taskId} blocked by: ${blocked.blockedBy.join(', ')}`);
+        }
+        lines.push('');
+    }
+    if (status.conflicts.length > 0) {
+        lines.push(`### Conflicts (${status.conflicts.length})`);
+        for (const conflict of status.conflicts) {
+            lines.push(`- \`${conflict.file}\` — ${conflict.resolution} (${conflict.sessions.join(', ')})`);
+        }
+        lines.push('');
+    }
+    if (status.recommendations.length > 0) {
+        lines.push('### Recommendations');
+        for (const rec of status.recommendations)
+            lines.push(`- ${rec}`);
+    }
+    return lines.join('\n');
+}
+// ============================================================================
+// Helpers
+// ============================================================================
+function normalizePath(p) {
+    return p.replace(/\\/g, '/').replace(/^\.\//, '');
+}
+//# sourceMappingURL=SessionCoordinator.js.map

package/dist/workflow/SessionCoordinator.js.map

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

package/dist/workflow/SessionPreamble.d.ts

@@ -0,0 +1,19 @@
+export interface SessionPreamble {
+    sessionId: string;
+    timestamp: string;
+    gitBranch: string;
+    gitRoot: string;
+    projectSlug: string;
+    scaleVersion: string;
+    activeRunCount: number;
+    learningCount: number;
+    verificationProfile: string;
+    governanceMode: string;
+    warnings: string[];
+}
+export interface PreambleOptions {
+    projectDir?: string;
+    scaleDir?: string;
+}
+export declare function collectSessionPreamble(opts?: PreambleOptions): SessionPreamble;
+export declare function formatPreambleForAgent(preamble: SessionPreamble): string;

package/dist/workflow/SessionPreamble.js

@@ -0,0 +1,130 @@
+// SCALE Engine — Session Preamble (v0.31.0)
+// Automatic environment context collection before workflow execution.
+// Inspired by gstack's preamble pattern: collect branch, sessions, learnings, etc.
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
+import { join, basename } from 'node:path';
+import { randomUUID } from 'node:crypto';
+import { execSync } from 'node:child_process';
+import { SCALE_ENGINE_VERSION } from '../version.js';
+const SILENT_GIT_STDIO = ['ignore', 'pipe', 'ignore'];
+// ============================================================================
+// Collector
+// ============================================================================
+export function collectSessionPreamble(opts) {
+    const projectDir = opts?.projectDir ?? process.cwd();
+    const scaleDir = opts?.scaleDir ?? '.scale';
+    const warnings = [];
+    // Git branch
+    let gitBranch = 'unknown';
+    try {
+        gitBranch = execSync('git branch --show-current', {
+            cwd: projectDir, encoding: 'utf-8', timeout: 5000, stdio: SILENT_GIT_STDIO,
+        }).trim();
+    }
+    catch {
+        warnings.push('Not in a git repository or git not available');
+    }
+    // Git root
+    let gitRoot = projectDir;
+    try {
+        gitRoot = execSync('git rev-parse --show-toplevel', {
+            cwd: projectDir, encoding: 'utf-8', timeout: 5000, stdio: SILENT_GIT_STDIO,
+        }).trim();
+    }
+    catch {
+        // Use projectDir as fallback
+    }
+    // Project slug
+    const projectSlug = deriveProjectSlug(projectDir);
+    // Active run count
+    const activeRunCount = countActiveRuns(scaleDir);
+    // Learning count
+    const learningCount = countLearnings(scaleDir, projectSlug);
+    // Verification profile
+    const verificationProfile = resolveCurrentProfile(scaleDir, projectDir);
+    // Governance mode (default)
+    const governanceMode = 'standard';
+    return {
+        sessionId: randomUUID().slice(0, 8),
+        timestamp: new Date().toISOString(),
+        gitBranch,
+        gitRoot,
+        projectSlug,
+        scaleVersion: SCALE_ENGINE_VERSION,
+        activeRunCount,
+        learningCount,
+        verificationProfile,
+        governanceMode,
+        warnings,
+    };
+}
+// ============================================================================
+// Formatter
+// ============================================================================
+export function formatPreambleForAgent(preamble) {
+    const lines = [
+        `SESSION: ${preamble.sessionId}`,
+        `BRANCH: ${preamble.gitBranch}`,
+        `PROJECT: ${preamble.projectSlug}`,
+        `SCALE_VERSION: ${preamble.scaleVersion}`,
+        `ACTIVE_RUNS: ${preamble.activeRunCount}`,
+        `LEARNINGS: ${preamble.learningCount}`,
+        `VERIFICATION_PROFILE: ${preamble.verificationProfile}`,
+        `GOVERNANCE_MODE: ${preamble.governanceMode}`,
+    ];
+    if (preamble.warnings.length > 0) {
+        lines.push(`WARNINGS: ${preamble.warnings.join('; ')}`);
+    }
+    return lines.join('\n');
+}
+// ============================================================================
+// Helpers
+// ============================================================================
+function deriveProjectSlug(projectDir) {
+    try {
+        return basename(projectDir).replace(/[^a-zA-Z0-9-]/g, '-').toLowerCase();
+    }
+    catch {
+        return 'unknown';
+    }
+}
+function countActiveRuns(scaleDir) {
+    const runsDir = join(scaleDir, 'ai-os', 'runs');
+    if (!existsSync(runsDir))
+        return 0;
+    try {
+        return readdirSync(runsDir).filter(f => f.endsWith('.json')).length;
+    }
+    catch {
+        return 0;
+    }
+}
+function countLearnings(scaleDir, projectSlug) {
+    const learningsDir = join(scaleDir, 'learnings');
+    if (!existsSync(learningsDir))
+        return 0;
+    try {
+        const jsonlPath = join(learningsDir, `${projectSlug}.jsonl`);
+        if (!existsSync(jsonlPath))
+            return 0;
+        const content = readFileSync(jsonlPath, 'utf-8');
+        return content.split('\n').filter(line => line.trim()).length;
+    }
+    catch {
+        return 0;
+    }
+}
+function resolveCurrentProfile(scaleDir, projectDir) {
+    try {
+        const matrixPath = join(projectDir, scaleDir, 'verification-matrix.json');
+        if (existsSync(matrixPath)) {
+            const matrix = JSON.parse(readFileSync(matrixPath, 'utf-8'));
+            return matrix.defaultProfile ?? 'default';
+        }
+    }
+    catch {
+        // Ignore
+    }
+    return 'default';
+}
+//# sourceMappingURL=SessionPreamble.js.map

package/dist/workflow/SessionPreamble.js.map

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

package/dist/workflow/SessionStateTracker.d.ts

@@ -0,0 +1,74 @@
+export type PhaseStatus = '✓' | '⏳' | '' | 'pending';
+export interface FlowState {
+    SKILL_SCAN: PhaseStatus;
+    EXPLORE: PhaseStatus;
+    PLAN: PhaseStatus;
+    EXECUTE: PhaseStatus;
+    VERIFY: PhaseStatus;
+    SETTLE: PhaseStatus;
+    POLLUTION: PhaseStatus;
+    LAZY: PhaseStatus;
+}
+export interface SessionMarkers {
+    skillScanned: boolean;
+    skillList: string[];
+    verified: boolean;
+    pollutionDetected: boolean;
+    pollutionCleared: boolean;
+    lazyDetected: string[];
+    failCount: number;
+}
+export declare class SessionStateTracker {
+    private sessionDir;
+    private sessionId;
+    constructor(sessionId: string, scaleDir?: string);
+    private ensureDir;
+    /** Get current flow state */
+    getFlowState(): FlowState;
+    /** Update phase status */
+    updatePhase(phase: keyof FlowState, status: PhaseStatus): void;
+    /** Mark phase as complete */
+    markPhaseComplete(phase: keyof FlowState): void;
+    /** Mark phase as in progress */
+    markPhaseInProgress(phase: keyof FlowState): void;
+    /** Check if all phases complete */
+    isAllComplete(): boolean;
+    /** Get missing phases */
+    getMissingPhases(): string[];
+    private createDefaultFlowState;
+    private writeFlowState;
+    /** Mark skill scan complete */
+    markSkillScanned(skills: string[]): void;
+    /** Check if skill scanned */
+    isSkillScanned(): boolean;
+    /** Get scanned skills */
+    getScannedSkills(): string[];
+    /** Mark verification complete */
+    markVerified(): void;
+    /** Check if verified */
+    isVerified(): boolean;
+    /** Mark pollution detected */
+    markPollutionDetected(): void;
+    /** Clear pollution */
+    clearPollution(): void;
+    /** Check if pollution detected */
+    isPollutionDetected(): boolean;
+    /** Mark lazy detected */
+    markLazyDetected(type: string): void;
+    /** Clear lazy marker */
+    clearLazyMarker(type: string): void;
+    /** Check if lazy detected */
+    isLazyDetected(): boolean;
+    /** Get lazy types */
+    getLazyTypes(): string[];
+    /** Increment fail count */
+    incrementFailCount(): number;
+    /** Get fail count */
+    getFailCount(): number;
+    /** Reset fail count */
+    resetFailCount(): void;
+    /** Clear all session markers */
+    clearAll(): void;
+    /** Generate summary report */
+    generateSummary(): string;
+}