@hongmaple0820/med-scale-research-os 0.43.0

package/dist/orchestrator/OrchestratorDaemon.js

@@ -0,0 +1,150 @@
+// SCALE Orchestrator — Daemon
+// 对齐 Symphony: long-running daemon with poll loop + workspace lifecycle
+// Manages: start, stop, status, signal handling, graceful shutdown
+import { existsSync, mkdirSync, writeFileSync, readFileSync, unlinkSync } from 'node:fs';
+import { join } from 'node:path';
+import { logger } from '../core/logger.js';
+import { PolicyLoader } from './PolicyLoader.js';
+import { WorkspaceManager } from './WorkspaceManager.js';
+import { ReconciliationLoop } from './ReconciliationLoop.js';
+import { GitHubTrackerAdapter, MockTrackerAdapter } from './TrackerAdapter.js';
+// ---------------------------------------------------------------------------
+// PID file management (for daemon lifecycle)
+// ---------------------------------------------------------------------------
+const DAEMON_DIR = '.scale/orchestrator';
+const PID_FILE = join(DAEMON_DIR, 'daemon.pid');
+const LOG_FILE = join(DAEMON_DIR, 'daemon.log');
+export class OrchestratorDaemon {
+    constructor(projectDir = process.cwd()) {
+        this.policyLoader = new PolicyLoader();
+        this.workspaceManager = null;
+        this.reconciliationLoop = null;
+        this.tracker = null;
+        this.startedAt = null;
+        this.projectDir = projectDir;
+    }
+    /**
+     * Start the daemon.
+     */
+    async start() {
+        // Ensure daemon directory
+        if (!existsSync(DAEMON_DIR))
+            mkdirSync(DAEMON_DIR, { recursive: true });
+        // Check if already running
+        if (existsSync(PID_FILE)) {
+            const existingPid = parseInt(readFileSync(PID_FILE, 'utf-8'), 10);
+            try {
+                process.kill(existingPid, 0);
+                return { success: false, pid: existingPid, reason: 'Daemon already running' };
+            }
+            catch { /* stale PID */ }
+        }
+        // Load policy
+        const policy = this.policyLoader.load(this.projectDir);
+        this.policyLoader.watch(this.projectDir);
+        // Create tracker adapter
+        this.tracker = this.createTracker(policy);
+        // Create workspace manager
+        this.workspaceManager = new WorkspaceManager(policy);
+        // Create reconciliation loop
+        this.reconciliationLoop = new ReconciliationLoop(this.tracker, this.workspaceManager, policy);
+        // Wire up events
+        this.reconciliationLoop.on('dispatched', (record) => {
+            logger.info({ issueId: record.issueId, workspace: record.workspaceId, attempt: record.attempts }, 'Task dispatched');
+        });
+        this.reconciliationLoop.on('completed', (issueId, success) => {
+            logger.info({ issueId, success }, 'Task completed');
+        });
+        this.reconciliationLoop.on('released', (issueId) => {
+            this.workspaceManager?.updateStatus(issueId, 'terminal');
+        });
+        this.reconciliationLoop.on('error', (issueId, error) => {
+            logger.error({ issueId, err: error }, 'Task error');
+        });
+        // Start the loop
+        this.reconciliationLoop.start();
+        this.startedAt = new Date().toISOString();
+        // Write PID
+        writeFileSync(PID_FILE, String(process.pid));
+        // Signal handling for graceful shutdown
+        const shutdown = () => { void this.stop(); process.exit(0); };
+        process.on('SIGINT', shutdown);
+        process.on('SIGTERM', shutdown);
+        // Append to log
+        writeFileSync(LOG_FILE, `${this.startedAt} — Daemon started (PID ${process.pid})\n`, { flag: 'a' });
+        logger.info({ pid: process.pid, policy: policy.hash }, 'Orchestrator daemon started');
+        return { success: true, pid: process.pid };
+    }
+    /**
+     * Stop the daemon gracefully.
+     */
+    async stop() {
+        if (this.reconciliationLoop)
+            this.reconciliationLoop.stop();
+        if (this.workspaceManager) {
+            this.workspaceManager.cleanupTerminal();
+        }
+        if (existsSync(PID_FILE))
+            unlinkSync(PID_FILE);
+        this.startedAt = null;
+        const timestamp = new Date().toISOString();
+        writeFileSync(LOG_FILE, `${timestamp} — Daemon stopped\n`, { flag: 'a' });
+        logger.info('Orchestrator daemon stopped');
+        return { success: true };
+    }
+    /**
+     * Get current daemon status.
+     */
+    status() {
+        const records = this.reconciliationLoop?.getDispatchRecords() ?? [];
+        const activeRecords = records.filter(r => r.state === 'Running');
+        const activeWorkspaces = this.workspaceManager?.listActive() ?? [];
+        const uptime = this.startedAt
+            ? Date.now() - new Date(this.startedAt).getTime()
+            : undefined;
+        return {
+            running: existsSync(PID_FILE),
+            pid: existsSync(PID_FILE) ? parseInt(readFileSync(PID_FILE, 'utf-8'), 10) : undefined,
+            startedAt: this.startedAt ?? undefined,
+            policyPath: join(this.projectDir, 'SCALE_POLICY.md'),
+            policyHash: this.policyLoader.get().hash,
+            activeWorkspaces: activeWorkspaces.length,
+            totalDispatched: records.length,
+            activeIssues: activeRecords.map(r => r.issueId),
+            lastTickAt: records[0]?.lastActivityAt,
+            uptime,
+        };
+    }
+    /**
+     * Read daemon log.
+     */
+    readLog(lines = 50) {
+        if (!existsSync(LOG_FILE))
+            return '(no log)';
+        const entries = readFileSync(LOG_FILE, 'utf-8').trim().split('\n');
+        return entries.slice(-lines).join('\n');
+    }
+    // -----------------------------------------------------------------------
+    // Internal
+    // -----------------------------------------------------------------------
+    createTracker(policy) {
+        switch (policy.tracker.type) {
+            case 'github':
+                return new GitHubTrackerAdapter({
+                    type: 'github',
+                    owner: policy.tracker.owner,
+                    repo: policy.tracker.repo,
+                    activeStates: policy.tracker.activeStates,
+                    terminalStates: policy.tracker.terminalStates,
+                    priorityLabels: policy.polling.priorityLabels,
+                });
+            case 'linear':
+            case 'jira':
+                logger.warn(`${policy.tracker.type} tracker not yet implemented — using mock`);
+                return new MockTrackerAdapter();
+            default:
+                return new MockTrackerAdapter();
+        }
+    }
+}
+//# sourceMappingURL=OrchestratorDaemon.js.map

package/dist/orchestrator/OrchestratorDaemon.js.map

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

package/dist/orchestrator/PolicyLoader.d.ts

@@ -0,0 +1,80 @@
+export interface OrchestratorPolicy {
+    tracker: TrackerSection;
+    polling: PollingSection;
+    workspace: WorkspaceSection;
+    hooks: HooksSection;
+    agent: AgentSection;
+    codex: CodexSection;
+    version: number;
+    rawBody: string;
+    filePath: string;
+    lastModified: number;
+    hash: string;
+}
+export interface TrackerSection {
+    type: 'github' | 'linear' | 'jira';
+    owner?: string;
+    repo?: string;
+    projectKey?: string;
+    baseUrl?: string;
+    activeStates: string[];
+    terminalStates: string[];
+}
+export interface PollingSection {
+    intervalMs: number;
+    maxParallelWorkspaces: number;
+    maxRetryBackoffMs: number;
+    maxAttempts: number;
+    priorityLabels: Record<string, number>;
+}
+export interface WorkspaceSection {
+    root: string;
+    allowedChars: string;
+    maxWorkspaceAgeHours: number;
+}
+export interface HooksSection {
+    afterCreate?: string;
+    beforeRun?: string;
+    afterRun?: string;
+    beforeRemove?: string;
+}
+export interface AgentSection {
+    model: string;
+    maxTurns: number;
+    timeoutMinutes: number;
+    instructions?: string;
+}
+export interface CodexSection {
+    enabled: boolean;
+    promptTemplate?: string;
+}
+export declare const DEFAULT_POLICY: OrchestratorPolicy;
+export declare class PolicyLoader {
+    private currentPolicy;
+    private lastGoodPolicy;
+    private watcherActive;
+    /**
+     * Load SCALE_POLICY.md from project root.
+     * Falls back to good policy if the loaded one is invalid.
+     */
+    load(projectDir: string): OrchestratorPolicy;
+    /**
+     * Enable dynamic reload via file watcher.
+     * On file change: reload, retain last-good on parse failure.
+     */
+    watch(projectDir: string): void;
+    /**
+     * Get the current loaded policy (already validated/reloaded).
+     */
+    get(): OrchestratorPolicy;
+    /**
+     * Parse YAML frontmatter from Markdown.
+     * Format: ---\n<YAML>\n---\n<MARKDOWN BODY>
+     */
+    parsePolicyMarkdown(raw: string, filePath: string, lastModified: number): OrchestratorPolicy;
+    /**
+     * Minimal YAML parser for the SCALE_POLICY.md frontmatter subset.
+     * Handles nested objects and arrays needed by the 6-key schema.
+     */
+    private minimalYamlParse;
+}

package/dist/orchestrator/PolicyLoader.js

@@ -0,0 +1,229 @@
+// SCALE Orchestrator — Policy Loader
+// 对齐 Symphony: YAML frontmatter + Markdown body in SCALE_POLICY.md
+// 动态重载: 文件变更自动重载，无效配置保留上一次良好配置
+import { existsSync, readFileSync, statSync, watchFile } from 'node:fs';
+import { join } from 'node:path';
+import { logger } from '../core/logger.js';
+// ---------------------------------------------------------------------------
+// Default policy
+// ---------------------------------------------------------------------------
+export const DEFAULT_POLICY = {
+    tracker: {
+        type: 'github',
+        activeStates: ['open', 'in_progress'],
+        terminalStates: ['resolved', 'closed', 'cancelled'],
+    },
+    polling: {
+        intervalMs: 30000,
+        maxParallelWorkspaces: 3,
+        maxRetryBackoffMs: 300000,
+        maxAttempts: 3,
+        priorityLabels: { 'priority:critical': 0, 'priority:high': 1, 'priority:medium': 2, 'priority:low': 3 },
+    },
+    workspace: {
+        root: '.scale/worktrees',
+        allowedChars: '[A-Za-z0-9._-]',
+        maxWorkspaceAgeHours: 24,
+    },
+    hooks: {},
+    agent: {
+        model: 'claude-sonnet-4-6',
+        maxTurns: 50,
+        timeoutMinutes: 30,
+    },
+    codex: {
+        enabled: true,
+    },
+    version: 1,
+    rawBody: '',
+    filePath: '',
+    lastModified: 0,
+    hash: '',
+};
+// ---------------------------------------------------------------------------
+// PolicyLoader
+// ---------------------------------------------------------------------------
+export class PolicyLoader {
+    constructor() {
+        this.currentPolicy = { ...DEFAULT_POLICY };
+        this.lastGoodPolicy = { ...DEFAULT_POLICY };
+        this.watcherActive = false;
+    }
+    /**
+     * Load SCALE_POLICY.md from project root.
+     * Falls back to good policy if the loaded one is invalid.
+     */
+    load(projectDir) {
+        const policyPath = join(projectDir, 'SCALE_POLICY.md');
+        if (!existsSync(policyPath)) {
+            logger.warn('No SCALE_POLICY.md found, using defaults');
+            this.currentPolicy = { ...DEFAULT_POLICY, filePath: policyPath, lastModified: Date.now(), hash: 'default' };
+            return this.currentPolicy;
+        }
+        const raw = readFileSync(policyPath, 'utf-8');
+        const stat = statSync(policyPath);
+        try {
+            const parsed = this.parsePolicyMarkdown(raw, policyPath, stat.mtimeMs);
+            this.lastGoodPolicy = parsed;
+            this.currentPolicy = parsed;
+            logger.info({ path: policyPath, version: parsed.version }, 'SCALE_POLICY.md loaded');
+            return parsed;
+        }
+        catch (err) {
+            logger.error({ err, path: policyPath }, 'Failed to parse SCALE_POLICY.md — using last-good config');
+            this.currentPolicy = { ...this.lastGoodPolicy, filePath: policyPath, lastModified: stat.mtimeMs };
+            return this.currentPolicy;
+        }
+    }
+    /**
+     * Enable dynamic reload via file watcher.
+     * On file change: reload, retain last-good on parse failure.
+     */
+    watch(projectDir) {
+        if (this.watcherActive)
+            return;
+        const policyPath = join(projectDir, 'SCALE_POLICY.md');
+        watchFile(policyPath, { interval: 5000 }, () => {
+            logger.info('SCALE_POLICY.md changed — reloading');
+            this.load(projectDir);
+        });
+        this.watcherActive = true;
+    }
+    /**
+     * Get the current loaded policy (already validated/reloaded).
+     */
+    get() {
+        return this.currentPolicy;
+    }
+    /**
+     * Parse YAML frontmatter from Markdown.
+     * Format: ---\n<YAML>\n---\n<MARKDOWN BODY>
+     */
+    parsePolicyMarkdown(raw, filePath, lastModified) {
+        const frontmatterMatch = raw.match(/^---\n([\s\S]*?)\n---/);
+        if (!frontmatterMatch) {
+            throw new Error('SCALE_POLICY.md missing YAML frontmatter (---...---)');
+        }
+        const yamlStr = frontmatterMatch[1];
+        const bodyStart = (frontmatterMatch.index ?? 0) + frontmatterMatch[0].length;
+        const rawBody = raw.slice(bodyStart).trim();
+        const frontmatter = this.minimalYamlParse(yamlStr);
+        // Merge with defaults so partial configs work
+        const merged = {
+            tracker: { ...DEFAULT_POLICY.tracker, ...(frontmatter.tracker ?? {}) },
+            polling: { ...DEFAULT_POLICY.polling, ...(frontmatter.polling ?? {}) },
+            workspace: { ...DEFAULT_POLICY.workspace, ...(frontmatter.workspace ?? {}) },
+            hooks: { ...DEFAULT_POLICY.hooks, ...(frontmatter.hooks ?? {}) },
+            agent: { ...DEFAULT_POLICY.agent, ...(frontmatter.agent ?? {}) },
+            codex: { ...DEFAULT_POLICY.codex, ...(frontmatter.codex ?? {}) },
+            version: frontmatter.version ?? 1,
+            rawBody,
+            filePath,
+            lastModified,
+            hash: '',
+        };
+        const crypto = __non_webpack_require__('node:crypto') ?? require('crypto');
+        merged.hash = crypto.createHash('sha256').update(raw).digest('hex').slice(0, 12);
+        return merged;
+    }
+    /**
+     * Minimal YAML parser for the SCALE_POLICY.md frontmatter subset.
+     * Handles nested objects and arrays needed by the 6-key schema.
+     */
+    minimalYamlParse(yamlStr) {
+        const result = {};
+        // Split into lines and parse top-level key: value pairs
+        const lines = yamlStr.split('\n');
+        let currentSection = null;
+        let currentObj = {};
+        let inArray = null;
+        let arrayValues = [];
+        for (const line of lines) {
+            const trimmed = line.trim();
+            if (!trimmed || trimmed.startsWith('#'))
+                continue;
+            // Section headers
+            if (trimmed.match(/^[a-zA-Z_]+:/) && !trimmed.includes(': ') && !trimmed.endsWith(':')) {
+                // Simple key: value at top level
+                const [key, ...rest] = trimmed.split(':');
+                const val = rest.join(':').trim();
+                if (val && currentSection === null) {
+                    result[key.trim()] = isNaN(Number(val)) ? val : Number(val);
+                    continue;
+                }
+            }
+            // Start of a section object
+            if (trimmed.endsWith(':') && !trimmed.match(/^\s*-/)) {
+                const sectionName = trimmed.slice(0, -1).trim();
+                currentSection = sectionName;
+                currentObj = {};
+                result[sectionName] = currentObj;
+                inArray = null;
+                continue;
+            }
+            // Key: value within a section
+            if (currentSection && trimmed.includes(':') && !trimmed.startsWith('-')) {
+                const [key, ...rest] = trimmed.split(':');
+                const val = rest.join(':').trim();
+                if (val) {
+                    // Numeric values
+                    if (/^\d+$/.test(val))
+                        currentObj[key.trim()] = parseInt(val, 10);
+                    // Boolean values
+                    else if (val === 'true')
+                        currentObj[key.trim()] = true;
+                    else if (val === 'false')
+                        currentObj[key.trim()] = false;
+                    // Strings
+                    else
+                        currentObj[key.trim()] = val;
+                }
+                inArray = null;
+                continue;
+            }
+            // Array item — start
+            if (currentSection && trimmed === '-') {
+                inArray = null;
+                continue;
+            }
+            // Array items — list
+            if (currentSection && trimmed.startsWith('- ') && !trimmed.includes(':')) {
+                const val = trimmed.slice(2).trim();
+                if (inArray) {
+                    arrayValues.push(val);
+                }
+                else {
+                    // Check if an array key was just defined
+                    const lastKey = Object.keys(currentObj).pop();
+                    if (lastKey && Array.isArray(currentObj[lastKey])) {
+                        ;
+                        currentObj[lastKey].push(val);
+                    }
+                }
+                continue;
+            }
+            // Key: (empty) — start of an array
+            if (currentSection && trimmed.includes(':') && trimmed.slice(-1) === ':') {
+                const key = trimmed.slice(0, -1).trim();
+                const valAfterColon = trimmed.split(':').slice(1).join(':').trim();
+                if (!valAfterColon) {
+                    inArray = key;
+                    arrayValues = [];
+                    currentObj[key] = arrayValues;
+                }
+                continue;
+            }
+        }
+        return result;
+    }
+}
+// Avoid bundler issues with dynamic require
+function __non_webpack_require__(mod) {
+    try {
+        return require(mod);
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=PolicyLoader.js.map

package/dist/orchestrator/PolicyLoader.js.map

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

package/dist/orchestrator/ReconciliationLoop.d.ts

@@ -0,0 +1,71 @@
+import { EventEmitter } from 'node:events';
+import type { ITrackerAdapter } from './TrackerAdapter.js';
+import type { OrchestratorPolicy } from './PolicyLoader.js';
+import { WorkspaceManager } from './WorkspaceManager.js';
+export type OrchestrationState = 'Unclaimed' | 'Claimed' | 'Running' | 'RetryQueued' | 'Released';
+export interface DispatchRecord {
+    issueId: string;
+    state: OrchestrationState;
+    workspaceId: string;
+    branch: string;
+    claimedAt: string;
+    lastActivityAt: string;
+    attempts: number;
+    maxAttempts: number;
+    turnsCompleted: number;
+    pid?: number;
+}
+export interface ReconciliationEvents {
+    claimed: (issueId: string) => void;
+    dispatched: (record: DispatchRecord) => void;
+    completed: (issueId: string, success: boolean) => void;
+    retryQueued: (issueId: string, attempt: number) => void;
+    released: (issueId: string) => void;
+    error: (issueId: string, error: Error) => void;
+}
+export declare interface ReconciliationLoop {
+    on<E extends keyof ReconciliationEvents>(event: E, listener: ReconciliationEvents[E]): this;
+    emit<E extends keyof ReconciliationEvents>(event: E, ...args: Parameters<ReconciliationEvents[E]>): boolean;
+}
+export declare class ReconciliationLoop extends EventEmitter {
+    private dispatchRecords;
+    private workspaceManager;
+    private tracker;
+    private policy;
+    private running;
+    private timer;
+    constructor(tracker: ITrackerAdapter, workspaceManager: WorkspaceManager, policy: OrchestratorPolicy);
+    /**
+     * Main reconciliation tick.
+     * Called on each polling interval.
+     */
+    tick(): Promise<{
+        dispatched: number;
+        completed: number;
+        errors: number;
+    }>;
+    /**
+     * Start the polling loop.
+     */
+    start(): void;
+    /**
+     * Stop the polling loop.
+     */
+    stop(): void;
+    /**
+     * Get dispatch records for status display.
+     */
+    getDispatchRecords(): DispatchRecord[];
+    /**
+     * Compute retry delay using exponential backoff.
+     * delay = min(10000 * 2^(attempt-1), max_retry_backoff_ms)
+     */
+    computeRetryDelay(attempt: number): number;
+    private startupRecovery;
+    private preflightValidation;
+    private fetchCandidates;
+    private dispatch;
+    private reconcileRunning;
+    private completeIssue;
+    private emitCompletions;
+}