@hongmaple0820/med-scale-research-os 0.43.0

package/dist/context/ProjectAnatomy.js

@@ -0,0 +1,287 @@
+// SCALE Engine 鈥?Project Anatomy
+// Scans project directory and generates a file map with descriptions and token estimates.
+// Inspired by OpenWolf's anatomy system.
+import { readFileSync, readdirSync, statSync } from 'node:fs';
+import { join, relative, extname, basename, dirname } from 'node:path';
+import { estimateTokens } from './ContextBudget.js';
+const BINARY_EXTENSIONS = new Set([
+    '.png', '.jpg', '.jpeg', '.gif', '.bmp', '.ico', '.svg',
+    '.woff', '.woff2', '.ttf', '.eot', '.otf',
+    '.zip', '.tar', '.gz', '.bz2', '.7z', '.rar',
+    '.exe', '.dll', '.so', '.dylib', '.bin',
+    '.pdf', '.doc', '.docx', '.xls', '.xlsx', '.ppt', '.pptx',
+    '.mp3', '.mp4', '.avi', '.mov', '.webm', '.ogg',
+    '.sqlite', '.db', '.wasm', '.lock',
+]);
+const DEFAULT_EXCLUDE = ['node_modules', '.git', 'dist', 'build', '.scale', '.wolf', 'coverage', '.next', '__pycache__'];
+const ALWAYS_EXCLUDE_FILES = new Set(['.env', '.env.local', '.env.production', '.env.staging', '.env.development']);
+export class ProjectAnatomy {
+    scan(projectDir, opts) {
+        const maxFiles = opts?.maxFiles ?? 500;
+        const excludePatterns = opts?.excludePatterns ?? DEFAULT_EXCLUDE;
+        const entries = new Map();
+        this.walkDir(projectDir, projectDir, excludePatterns, maxFiles, entries);
+        return entries;
+    }
+    serialize(sections) {
+        const lines = [
+            '# anatomy.md',
+            '',
+            `> Auto-maintained by SCALE Engine. Last scanned: ${new Date().toISOString()}`,
+            '',
+        ];
+        let fileCount = 0;
+        let totalTokens = 0;
+        for (const [, list] of sections) {
+            fileCount += list.length;
+            totalTokens += list.reduce((s, e) => s + e.tokens, 0);
+        }
+        lines.push(`> Files: ${fileCount} | Total: ~${totalTokens} tokens`);
+        lines.push('');
+        const sortedKeys = [...sections.keys()].sort();
+        for (const key of sortedKeys) {
+            lines.push(`## ${key}`);
+            lines.push('');
+            const entries = sections.get(key);
+            entries.sort((a, b) => a.file.localeCompare(b.file));
+            for (const entry of entries) {
+                const desc = entry.description ? ` - ${entry.description}` : '';
+                lines.push(`- \`${entry.file}\`${desc} (~${entry.tokens} tok)`);
+            }
+            lines.push('');
+        }
+        return lines.join('\n');
+    }
+    parse(content) {
+        const sections = new Map();
+        let currentSection = '';
+        for (const line of content.split('\n')) {
+            const sectionMatch = line.match(/^## (.+)/);
+            if (sectionMatch) {
+                currentSection = sectionMatch[1].trim();
+                if (!sections.has(currentSection))
+                    sections.set(currentSection, []);
+                continue;
+            }
+            if (!currentSection)
+                continue;
+            const entryMatch = line.match(/^- `([^`]+)`(?:\s+-\s+(.+?))?\s*\(~(\d+)\s+tok\)$/);
+            if (entryMatch) {
+                sections.get(currentSection).push({
+                    file: entryMatch[1],
+                    description: entryMatch[2] || '',
+                    tokens: parseInt(entryMatch[3], 10),
+                });
+            }
+        }
+        return sections;
+    }
+    updateEntry(sections, relPath, fileContent, action) {
+        const dir = dirname(relPath);
+        const fileName = basename(relPath);
+        const sectionKey = dir === '.' ? './' : dir + '/';
+        if (action === 'delete') {
+            const entries = sections.get(sectionKey);
+            if (entries) {
+                const idx = entries.findIndex(e => e.file === fileName);
+                if (idx !== -1)
+                    entries.splice(idx, 1);
+                if (entries.length === 0)
+                    sections.delete(sectionKey);
+            }
+            return;
+        }
+        const ext = extname(relPath).toLowerCase();
+        const desc = this.extractDescriptionFromContent(fileContent, relPath);
+        const tokens = estimateTokens(fileContent);
+        if (!sections.has(sectionKey))
+            sections.set(sectionKey, []);
+        const entries = sections.get(sectionKey);
+        const idx = entries.findIndex(e => e.file === fileName);
+        const entry = { file: fileName, description: desc, tokens };
+        if (idx !== -1) {
+            entries[idx] = entry;
+        }
+        else {
+            entries.push(entry);
+        }
+    }
+    extractDescription(filePath) {
+        let content;
+        try {
+            const fd = filePath;
+            content = readFileSync(fd, 'utf-8');
+        }
+        catch {
+            return '';
+        }
+        return this.extractDescriptionFromContent(content, filePath);
+    }
+    extractDescriptionFromContent(content, filePath) {
+        const MAX_DESC = 120;
+        const name = basename(filePath);
+        const ext = extname(name).toLowerCase();
+        if (!content.trim())
+            return '';
+        const cap = (s) => s.length <= MAX_DESC ? s : s.slice(0, MAX_DESC - 3) + '...';
+        // Known config files
+        const known = {
+            'package.json': 'Node.js package manifest',
+            'tsconfig.json': 'TypeScript configuration',
+            '.gitignore': 'Git ignore rules',
+            'README.md': 'Project documentation',
+            'Dockerfile': 'Docker container definition',
+            'docker-compose.yml': 'Docker Compose services',
+            'Cargo.toml': 'Rust package manifest',
+            'go.mod': 'Go module definition',
+        };
+        if (known[name])
+            return known[name];
+        // Markdown heading
+        if (ext === '.md' || ext === '.mdx') {
+            const m = content.match(/^#{1,2}\s+(.+)$/m);
+            if (m)
+                return cap(m[1].trim());
+        }
+        // JSDoc / PHPDoc / Javadoc
+        const jm = content.match(/\/\*\*\s*\n?\s*\*?\s*(.+)/);
+        if (jm) {
+            const l = jm[1].replace(/\*\/$/, '').trim();
+            if (l && !l.startsWith('@') && l.length > 5)
+                return cap(l);
+        }
+        // Python docstring
+        if (ext === '.py') {
+            const dm = content.match(/^(?:#[^\n]*\n)*\s*(?:"""(.+?)"""|'''(.+?)''')/s);
+            if (dm) {
+                const first = (dm[1] || dm[2]).split('\n')[0].trim();
+                if (first && first.length > 3)
+                    return cap(first);
+            }
+        }
+        // Rust doc comments
+        if (ext === '.rs') {
+            const lines = content.split('\n');
+            for (const line of lines.slice(0, 20)) {
+                const m = line.match(/^\s*(?:\/\/\/|\/\/!)\s*(.+)/);
+                if (m && m[1].length > 5)
+                    return cap(m[1].trim());
+            }
+        }
+        // Go package comment
+        if (ext === '.go') {
+            const m = content.match(/\/\/\s*Package\s+\w+\s+(.*)/);
+            if (m)
+                return cap(m[1].trim());
+        }
+        // TS/JS 鈥?exports summary
+        if (['.ts', '.tsx', '.js', '.jsx', '.mjs'].includes(ext)) {
+            const exports = (content.match(/export\s+(?:async\s+)?(?:function|class|const|interface|type|enum)\s+(\w+)/g) || [])
+                .map(e => e.match(/(\w+)$/)?.[1]).filter(Boolean);
+            if (exports.length > 0 && exports.length <= 4)
+                return cap(`Exports ${exports.join(', ')}`);
+            if (exports.length > 4)
+                return cap(`Exports ${exports.slice(0, 3).join(', ')} + ${exports.length - 3} more`);
+        }
+        // Python 鈥?class + functions
+        if (ext === '.py') {
+            const cls = content.match(/class\s+(\w+)/);
+            const funcs = (content.match(/def\s+(\w+)/g) || []).map(f => f.match(/def\s+(\w+)/)?.[1]).filter(n => n && !n.startsWith('_'));
+            if (cls && funcs.length > 0)
+                return cap(`${cls[1]}: ${funcs.slice(0, 4).join(', ')}`);
+            if (funcs.length > 0)
+                return cap(funcs.slice(0, 4).join(', '));
+        }
+        // Header comment fallback
+        const hdrLines = content.split('\n');
+        for (const line of hdrLines.slice(0, 10)) {
+            const t = line.trim();
+            if (!t || t.startsWith('#!') || t.startsWith('namespace') || t.startsWith('use ') || t.startsWith('import ') || t.startsWith('from ') || t.startsWith('require') || t.startsWith('module '))
+                continue;
+            const cm = t.match(/^(?:\/\/|#|--)\s*(.+)/);
+            if (cm) {
+                const text = cm[1].trim();
+                const lower = text.toLowerCase();
+                if (text.length > 5 && !lower.startsWith('copyright') && !lower.startsWith('license') && !lower.startsWith('@')) {
+                    return cap(text);
+                }
+            }
+            if (!t.startsWith('//') && !t.startsWith('#') && !t.startsWith('/*') && !t.startsWith('*') && !t.startsWith('--'))
+                break;
+        }
+        // Last resort 鈥?first declaration
+        const declM = content.match(/(?:function|class|const|interface|type|enum)\s+(\w+)/);
+        if (declM)
+            return `Declares ${declM[1]}`;
+        return '';
+    }
+    walkDir(dir, rootDir, excludePatterns, maxFiles, entries) {
+        let totalFiles = 0;
+        for (const [, list] of entries)
+            totalFiles += list.length;
+        if (totalFiles >= maxFiles)
+            return;
+        let items;
+        try {
+            items = readdirSync(dir);
+        }
+        catch {
+            return;
+        }
+        items.sort();
+        for (const item of items) {
+            const fullPath = join(dir, item);
+            const relPath = relative(rootDir, fullPath).replace(/\\/g, '/');
+            if (this.shouldExclude(relPath, item, excludePatterns))
+                continue;
+            let stat;
+            try {
+                stat = statSync(fullPath);
+            }
+            catch {
+                continue;
+            }
+            if (stat.isDirectory()) {
+                this.walkDir(fullPath, rootDir, excludePatterns, maxFiles, entries);
+            }
+            else if (stat.isFile()) {
+                const ext = extname(item).toLowerCase();
+                if (BINARY_EXTENSIONS.has(ext))
+                    continue;
+                if (stat.size > 1024 * 1024)
+                    continue; // skip > 1MB
+                let content;
+                try {
+                    content = readFileSync(fullPath, 'utf-8');
+                }
+                catch {
+                    continue;
+                }
+                const desc = this.extractDescriptionFromContent(content, fullPath);
+                const tokens = estimateTokens(content);
+                const section = relative(rootDir, dir).replace(/\\/g, '/') || '.';
+                const sectionKey = section === '.' ? './' : section + '/';
+                if (!entries.has(sectionKey))
+                    entries.set(sectionKey, []);
+                entries.get(sectionKey).push({ file: item, description: desc, tokens });
+                totalFiles++;
+                if (totalFiles >= maxFiles)
+                    return;
+            }
+        }
+    }
+    shouldExclude(relPath, name, excludePatterns) {
+        // Always exclude sensitive files
+        if (ALWAYS_EXCLUDE_FILES.has(name))
+            return true;
+        if (name.startsWith('.env.'))
+            return true;
+        const parts = relPath.split('/');
+        for (const pattern of excludePatterns) {
+            if (parts.includes(pattern))
+                return true;
+        }
+        return false;
+    }
+}
+//# sourceMappingURL=ProjectAnatomy.js.map

package/dist/context/ProjectAnatomy.js.map

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

package/dist/context/SessionStartSequence.d.ts

@@ -0,0 +1,54 @@
+import type { IEventBus } from '../core/eventBus.js';
+import type { IArtifactStore } from '../artifact/store.js';
+export interface SessionStartContext {
+    workingDir: string;
+    gitStatus: GitStatusInfo;
+    recentCommits: CommitInfo[];
+    progressFile?: ProgressFileInfo;
+    unfinishedTasks: UnfinishedTask[];
+    harnessRecommendations: string[];
+    generatedAt: number;
+}
+export interface GitStatusInfo {
+    branch: string;
+    aheadOfMain: number;
+    uncommittedChanges: boolean;
+    untrackedFiles: string[];
+}
+export interface CommitInfo {
+    sha: string;
+    message: string;
+    timestamp: number;
+    author: string;
+}
+export interface ProgressFileInfo {
+    path: string;
+    content: string;
+    lastTask?: string;
+    currentPhase?: string;
+    blockers?: string[];
+}
+export interface UnfinishedTask {
+    taskId: string;
+    priority: number;
+    status: string;
+    description: string;
+    blockingReason?: string;
+}
+export declare class SessionStartSequence {
+    private store;
+    private eventBus;
+    private projectDir;
+    constructor(store: IArtifactStore, eventBus: IEventBus, projectDir?: string);
+    execute(sessionId: string): Promise<SessionStartContext>;
+    private getGitStatus;
+    private getRecentCommits;
+    private readProgressFile;
+    private extractLastTask;
+    private extractCurrentPhase;
+    private extractBlockers;
+    private findUnfinishedTasks;
+    private getBlockingReason;
+    private generateHarnessRecommendations;
+    formatContextBlock(ctx: SessionStartContext): string;
+}

package/dist/context/SessionStartSequence.js

@@ -0,0 +1,162 @@
+// SCALE Engine - Harness Engineering: 标准化启动序列
+// 文章启发：检查 Git Log -> 读取进度文件 -> 定位未完成任务 -> 开始工作
+import { execSync } from 'node:child_process';
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+const SILENT_GIT_STDIO = ['ignore', 'pipe', 'ignore'];
+export class SessionStartSequence {
+    constructor(store, eventBus, projectDir = '.') {
+        this.store = store;
+        this.eventBus = eventBus;
+        this.projectDir = projectDir;
+    }
+    async execute(sessionId) {
+        const workingDir = this.projectDir;
+        const gitStatus = this.getGitStatus();
+        const recentCommits = this.getRecentCommits(5);
+        const progressFile = this.readProgressFile(sessionId);
+        const unfinishedTasks = await this.findUnfinishedTasks();
+        const harnessRecommendations = this.generateHarnessRecommendations(gitStatus, progressFile, unfinishedTasks);
+        const context = { workingDir, gitStatus, recentCommits, progressFile, unfinishedTasks, harnessRecommendations, generatedAt: Date.now() };
+        this.eventBus.emit('session.started', { sessionId, context });
+        return context;
+    }
+    getGitStatus() {
+        try {
+            const branch = execSync('git rev-parse --abbrev-ref HEAD', {
+                cwd: this.projectDir, encoding: 'utf-8', stdio: SILENT_GIT_STDIO,
+            }).trim();
+            const ahead = parseInt(execSync('git rev-list --count HEAD..origin/main 2>/dev/null || echo 0', {
+                cwd: this.projectDir, encoding: 'utf-8', stdio: SILENT_GIT_STDIO,
+            }).trim(), 10);
+            const status = execSync('git status --porcelain', {
+                cwd: this.projectDir, encoding: 'utf-8', stdio: SILENT_GIT_STDIO,
+            }).trim();
+            const untracked = status.split('\n').filter(l => l.startsWith('??')).map(l => l.slice(3));
+            return { branch, aheadOfMain: ahead, uncommittedChanges: status.length > 0, untrackedFiles: untracked };
+        }
+        catch {
+            return { branch: 'unknown', aheadOfMain: 0, uncommittedChanges: false, untrackedFiles: [] };
+        }
+    }
+    getRecentCommits(limit) {
+        try {
+            const log = execSync(`git log --oneline -${limit} --format="%H|%s|%at|%an"`, {
+                cwd: this.projectDir, encoding: 'utf-8', stdio: SILENT_GIT_STDIO,
+            }).trim();
+            return log.split('\n').map(line => {
+                const [sha, message, timestamp, author] = line.split('|');
+                return { sha, message, timestamp: parseInt(timestamp, 10) * 1000, author };
+            });
+        }
+        catch {
+            return [];
+        }
+    }
+    readProgressFile(sessionId) {
+        const paths = [
+            join(this.projectDir, '.omc', 'state', 'sessions', sessionId, 'progress.md'),
+            join(this.projectDir, '.omc', 'notepad.md'),
+            join(homedir(), '.claude', 'sessions', sessionId, 'progress.md'),
+        ];
+        for (const path of paths) {
+            if (existsSync(path)) {
+                try {
+                    const content = readFileSync(path, 'utf-8');
+                    return {
+                        path,
+                        content,
+                        lastTask: this.extractLastTask(content),
+                        currentPhase: this.extractCurrentPhase(content),
+                        blockers: this.extractBlockers(content)
+                    };
+                }
+                catch {
+                    continue;
+                }
+            }
+        }
+        return undefined;
+    }
+    extractLastTask(content) {
+        const match = content.match(/Last\s*Task:\s*(TASK-[^\n]+)/i);
+        return match?.[1];
+    }
+    extractCurrentPhase(content) {
+        const match = content.match(/Phase:\s*(explore|plan|execute|verify|deliver)/i);
+        return match?.[1]?.toLowerCase();
+    }
+    extractBlockers(content) {
+        const match = content.match(/Blockers:\s*([^\n]+)/i);
+        return match ? match[1].split(',').map(b => b.trim()).filter(Boolean) : [];
+    }
+    async findUnfinishedTasks() {
+        try {
+            const allTasks = await this.store.query({ type: 'Task' });
+            const unfinished = allTasks.filter((a) => a.status !== 'DONE' && a.status !== 'CANCELLED');
+            return unfinished
+                .map((t) => ({
+                taskId: t.id,
+                priority: t.payload.priority ?? 50,
+                status: t.status,
+                description: t.payload.description ?? '',
+                blockingReason: this.getBlockingReason(t)
+            }))
+                .sort((a, b) => b.priority - a.priority);
+        }
+        catch {
+            return [];
+        }
+    }
+    getBlockingReason(artifact) {
+        if (!artifact.payload.buildStatus || artifact.payload.buildStatus === 'pending')
+            return 'Build not run';
+        if (artifact.payload.buildStatus === 'failed')
+            return 'Build failed';
+        if (!artifact.payload.testPassed)
+            return 'Tests not passed';
+        if (!artifact.payload.reviewPassed)
+            return 'Review not passed (Harness requirement)';
+        return undefined;
+    }
+    generateHarnessRecommendations(git, progress, tasks) {
+        const recs = [];
+        if (git.uncommittedChanges)
+            recs.push('WARNING: uncommitted changes');
+        if (git.untrackedFiles.length > 0)
+            recs.push(`WARNING: ${git.untrackedFiles.length} untracked files`);
+        if (git.aheadOfMain > 5)
+            recs.push(`WARNING: branch ahead of main by ${git.aheadOfMain} commits`);
+        if (progress?.blockers?.length)
+            recs.push(`WARNING: blockers: ${progress.blockers.join(', ')}`);
+        if (tasks.length > 0) {
+            const top = tasks[0];
+            recs.push(`PRIORITY: ${top.taskId} (${top.status}) - ${top.description}`);
+        }
+        recs.push('Harness Engineering: Understand -> Plan -> Execute -> Verify -> Deliver');
+        recs.push('Quality Gates: Build Pass + Test Pass + Coverage>=80% + Review Pass');
+        return recs;
+    }
+    formatContextBlock(ctx) {
+        const lines = [
+            '## Session Start Context (Harness Engineering)',
+            '',
+            '### Git Status',
+            `- Branch: ${ctx.gitStatus.branch}`,
+            `- Ahead of main: ${ctx.gitStatus.aheadOfMain}`,
+            `- Uncommitted: ${ctx.gitStatus.uncommittedChanges ? 'WARNING YES' : 'OK No'}`,
+            '',
+            '### Recent Commits',
+            ...ctx.recentCommits.map(c => `- ${c.sha.slice(0, 7)}: ${c.message}`),
+            '',
+            '### Unfinished Tasks',
+            ...ctx.unfinishedTasks.slice(0, 5).map(t => `- ${t.taskId}: ${t.status} - ${t.description}`),
+            '',
+            '### Harness Recommendations',
+            ...ctx.harnessRecommendations
+        ];
+        return lines.join('\n');
+    }
+}
+//# sourceMappingURL=SessionStartSequence.js.map

package/dist/context/SessionStartSequence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionStartSequence.js","sourceRoot":"","sources":["../../src/context/SessionStartSequence.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,+CAA+C;AAE/C,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA;AAC7C,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAClD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AAMjC,MAAM,gBAAgB,GAAiC,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAA;AA0CnF,MAAM,OAAO,oBAAoB;IAC/B,YAAoB,KAAqB,EAAU,QAAmB,EAAU,aAAqB,GAAG;QAApF,UAAK,GAAL,KAAK,CAAgB;QAAU,aAAQ,GAAR,QAAQ,CAAW;QAAU,eAAU,GAAV,UAAU,CAAc;IAAG,CAAC;IAE5G,KAAK,CAAC,OAAO,CAAC,SAAiB;QAC7B,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAAA;QAClC,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,EAAE,CAAA;QACrC,MAAM,aAAa,GAAG,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAA;QAC9C,MAAM,YAAY,GAAG,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAA;QACrD,MAAM,eAAe,GAAG,MAAM,IAAI,CAAC,mBAAmB,EAAE,CAAA;QACxD,MAAM,sBAAsB,GAAG,IAAI,CAAC,8BAA8B,CAAC,SAAS,EAAE,YAAY,EAAE,eAAe,CAAC,CAAA;QAE5G,MAAM,OAAO,GAAG,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,YAAY,EAAE,eAAe,EAAE,sBAAsB,EAAE,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAA;QACxI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC,CAAA;QAC7D,OAAO,OAAO,CAAA;IAChB,CAAC;IAEO,YAAY;QAClB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,QAAQ,CAAC,iCAAiC,EAAE;gBACzD,GAAG,EAAE,IAAI,CAAC,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,gBAAgB;aACjE,CAAC,CAAC,IAAI,EAAE,CAAA;YACT,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,CAAC,8DAA8D,EAAE;gBAC9F,GAAG,EAAE,IAAI,CAAC,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,gBAAgB;aACjE,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAA;YACd,MAAM,MAAM,GAAG,QAAQ,CAAC,wBAAwB,EAAE;gBAChD,GAAG,EAAE,IAAI,CAAC,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,gBAAgB;aACjE,CAAC,CAAC,IAAI,EAAE,CAAA;YACT,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;YACzF,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,kBAAkB,EAAE,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,cAAc,EAAE,SAAS,EAAE,CAAA;QACzG,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC,EAAE,kBAAkB,EAAE,KAAK,EAAE,cAAc,EAAE,EAAE,EAAE,CAAA;QAC7F,CAAC;IACH,CAAC;IAEO,gBAAgB,CAAC,KAAa;QACpC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,QAAQ,CAAC,sBAAsB,KAAK,2BAA2B,EAAE;gBAC3E,GAAG,EAAE,IAAI,CAAC,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,gBAAgB;aACjE,CAAC,CAAC,IAAI,EAAE,CAAA;YACT,OAAO,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE;gBAChC,MAAM,CAAC,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;gBACzD,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,CAAC,SAAS,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,CAAA;YAC5E,CAAC,CAAC,CAAA;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAA;QACX,CAAC;IACH,CAAC;IAEO,gBAAgB,CAAC,SAAiB;QACxC,MAAM,KAAK,GAAG;YACZ,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,CAAC;YAC5E,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,CAAC;YAC3C,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,CAAC;SACjE,CAAA;QACD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;gBACrB,IAAI,CAAC;oBACH,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;oBAC3C,OAAO;wBACL,IAAI;wBACJ,OAAO;wBACP,QAAQ,EAAE,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC;wBACvC,YAAY,EAAE,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC;wBAC/C,QAAQ,EAAE,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC;qBACxC,CAAA;gBACH,CAAC;gBAAC,MAAM,CAAC;oBACP,SAAQ;gBACV,CAAC;YACH,CAAC;QACH,CAAC;QACD,OAAO,SAAS,CAAA;IAClB,CAAC;IAEO,eAAe,CAAC,OAAe;QACrC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAA;QAC5D,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,CAAA;IACnB,CAAC;IAEO,mBAAmB,CAAC,OAAe;QACzC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,iDAAiD,CAAC,CAAA;QAC9E,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAA;IAClC,CAAC;IAEO,eAAe,CAAC,OAAe;QACrC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAA;QACpD,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IAC5E,CAAC;IAEO,KAAK,CAAC,mBAAmB;QAC/B,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAA;YACzD,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAW,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,IAAI,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC,CAAA;YACpG,OAAO,UAAU;iBACd,GAAG,CAAC,CAAC,CAAW,EAAE,EAAE,CAAC,CAAC;gBACrB,MAAM,EAAE,CAAC,CAAC,EAAE;gBACZ,QAAQ,EAAG,CAAC,CAAC,OAAe,CAAC,QAAQ,IAAI,EAAE;gBAC3C,MAAM,EAAE,CAAC,CAAC,MAAM;gBAChB,WAAW,EAAG,CAAC,CAAC,OAAe,CAAC,WAAW,IAAI,EAAE;gBACjD,cAAc,EAAE,IAAI,CAAC,iBAAiB,CAAC,CAAC,CAAC;aAC1C,CAAC,CAAC;iBACF,IAAI,CAAC,CAAC,CAAiB,EAAE,CAAiB,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAA;QAC5E,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAA;QACX,CAAC;IACH,CAAC;IAEO,iBAAiB,CAAC,QAAa;QACrC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,WAAW,IAAI,QAAQ,CAAC,OAAO,CAAC,WAAW,KAAK,SAAS;YAAE,OAAO,eAAe,CAAA;QACvG,IAAI,QAAQ,CAAC,OAAO,CAAC,WAAW,KAAK,QAAQ;YAAE,OAAO,cAAc,CAAA;QACpE,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,UAAU;YAAE,OAAO,kBAAkB,CAAA;QAC3D,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,YAAY;YAAE,OAAO,yCAAyC,CAAA;QACpF,OAAO,SAAS,CAAA;IAClB,CAAC;IAEO,8BAA8B,CACpC,GAAkB,EAClB,QAAsC,EACtC,KAAuB;QAEvB,MAAM,IAAI,GAAa,EAAE,CAAA;QACzB,IAAI,GAAG,CAAC,kBAAkB;YAAE,IAAI,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAA;QACrE,IAAI,GAAG,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC;YAAE,IAAI,CAAC,IAAI,CAAC,YAAY,GAAG,CAAC,cAAc,CAAC,MAAM,kBAAkB,CAAC,CAAA;QACrG,IAAI,GAAG,CAAC,WAAW,GAAG,CAAC;YAAE,IAAI,CAAC,IAAI,CAAC,oCAAoC,GAAG,CAAC,WAAW,UAAU,CAAC,CAAA;QACjG,IAAI,QAAQ,EAAE,QAAQ,EAAE,MAAM;YAAE,IAAI,CAAC,IAAI,CAAC,sBAAsB,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;QAC/F,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrB,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,CAAA;YACpB,IAAI,CAAC,IAAI,CAAC,aAAa,GAAG,CAAC,MAAM,KAAK,GAAG,CAAC,MAAM,OAAO,GAAG,CAAC,WAAW,EAAE,CAAC,CAAA;QAC3E,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,yEAAyE,CAAC,CAAA;QACpF,IAAI,CAAC,IAAI,CAAC,qEAAqE,CAAC,CAAA;QAChF,OAAO,IAAI,CAAA;IACb,CAAC;IAED,kBAAkB,CAAC,GAAwB;QACzC,MAAM,KAAK,GAAG;YACZ,gDAAgD;YAChD,EAAE;YACF,gBAAgB;YAChB,aAAa,GAAG,CAAC,SAAS,CAAC,MAAM,EAAE;YACnC,oBAAoB,GAAG,CAAC,SAAS,CAAC,WAAW,EAAE;YAC/C,kBAAkB,GAAG,CAAC,SAAS,CAAC,kBAAkB,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,OAAO,EAAE;YAC9E,EAAE;YACF,oBAAoB;YACpB,GAAG,GAAG,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;YACrE,EAAE;YACF,sBAAsB;YACtB,GAAG,GAAG,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;YAC5F,EAAE;YACF,6BAA6B;YAC7B,GAAG,GAAG,CAAC,sBAAsB;SAC9B,CAAA;QACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACzB,CAAC;CACF"}

package/dist/core/ExternalCommand.d.ts

@@ -0,0 +1,9 @@
+import * as childProcess from 'node:child_process';
+type CommandRuntime = {
+    execFileSync: typeof childProcess.execFileSync;
+    spawnSync: typeof childProcess.spawnSync;
+};
+export declare function resolveExternalCommandPath(command: string, runtime?: CommandRuntime): string | null;
+export declare function externalCommandExists(command: string, runtime?: CommandRuntime): boolean;
+export declare function runExternalCommandSync(command: string, args: string[], options?: childProcess.ExecFileSyncOptions, runtime?: CommandRuntime): string | Buffer;
+export {};

package/dist/core/ExternalCommand.js

@@ -0,0 +1,70 @@
+import * as childProcess from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { extname } from 'node:path';
+const DEFAULT_RUNTIME = {
+    execFileSync: childProcess.execFileSync,
+    spawnSync: childProcess.spawnSync,
+};
+export function resolveExternalCommandPath(command, runtime = DEFAULT_RUNTIME) {
+    try {
+        const lookup = process.platform === 'win32' ? 'where.exe' : 'which';
+        const output = runtime.execFileSync(lookup, [command], {
+            encoding: 'utf8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+        });
+        const match = String(output)
+            .split(/\r?\n/)
+            .map(line => line.trim())
+            .find(Boolean);
+        return match ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+export function externalCommandExists(command, runtime = DEFAULT_RUNTIME) {
+    return Boolean(resolveExternalCommandPath(command, runtime));
+}
+export function runExternalCommandSync(command, args, options = {}, runtime = DEFAULT_RUNTIME) {
+    const resolved = resolveWindowsCommandShim(resolveExternalCommandPath(command, runtime) ?? command);
+    if (process.platform === 'win32' && /\.(cmd|bat)$/i.test(resolved)) {
+        const result = runtime.spawnSync(process.env.ComSpec ?? 'cmd.exe', ['/d', '/c', 'call', resolved, ...args], {
+            cwd: options.cwd,
+            env: options.env,
+            encoding: options.encoding,
+            input: options.input,
+            maxBuffer: options.maxBuffer,
+            shell: false,
+            stdio: options.stdio,
+            timeout: options.timeout,
+            windowsHide: options.windowsHide,
+        });
+        if (result.error)
+            throw result.error;
+        if (typeof result.status === 'number' && result.status !== 0) {
+            const message = typeof result.stderr === 'string'
+                ? result.stderr.trim()
+                : result.stderr?.toString('utf8').trim();
+            const error = new Error(message || `Command failed: ${resolved} ${args.join(' ')}`);
+            error.status = result.status;
+            error.stdout = result.stdout;
+            error.stderr = result.stderr;
+            throw error;
+        }
+        return result.stdout ?? '';
+    }
+    return runtime.execFileSync(resolved, args, options);
+}
+function resolveWindowsCommandShim(executable) {
+    if (process.platform !== 'win32')
+        return executable;
+    if (!/[\\/]/.test(executable) || extname(executable))
+        return executable;
+    for (const extension of ['.cmd', '.exe', '.bat', '.com']) {
+        const candidate = `${executable}${extension}`;
+        if (existsSync(candidate))
+            return candidate;
+    }
+    return executable;
+}
+//# sourceMappingURL=ExternalCommand.js.map

package/dist/core/ExternalCommand.js.map

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

package/dist/core/GbrainRuntime.d.ts

@@ -0,0 +1,25 @@
+import { spawnSync, type SpawnSyncOptions } from 'node:child_process';
+export interface GbrainCommandOptions {
+    cwd?: string;
+    env?: NodeJS.ProcessEnv;
+    timeout?: number;
+    maxBuffer?: number;
+    input?: string | Buffer;
+    stdio?: SpawnSyncOptions['stdio'];
+}
+export interface GbrainCommandResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+    timedOut: boolean;
+    usedMirroredRuntime: boolean;
+    recoveredTimeout: boolean;
+}
+export interface GbrainRuntimeDeps {
+    platform?: NodeJS.Platform;
+    env?: NodeJS.ProcessEnv;
+    tmpDir?: string;
+    resolveCommandPath?: (command: string) => string | null;
+    spawn?: typeof spawnSync;
+}
+export declare function runGbrainCommandSync(args: string[], options?: GbrainCommandOptions, deps?: GbrainRuntimeDeps): GbrainCommandResult;