@hongmaple0820/med-scale-research-os 0.43.0

package/dist/evolution/SessionLearnings.js

@@ -0,0 +1,217 @@
+// SCALE Engine — Session Learnings (v0.31.0)
+// Cross-session knowledge persistence inspired by gstack's learnings.jsonl.
+// Learnings survive across sessions and are loaded into future plans.
+import { existsSync, mkdirSync, readFileSync, writeFileSync, appendFileSync, readdirSync } from 'node:fs';
+import { join, basename } from 'node:path';
+import { randomUUID } from 'node:crypto';
+// ============================================================================
+// Store Implementation
+// ============================================================================
+export function createLearningStore(opts) {
+    const storePath = opts.storePath ?? '.scale/learnings';
+    const dir = storePath;
+    function ensureDir() {
+        if (!existsSync(dir))
+            mkdirSync(dir, { recursive: true });
+    }
+    function getJsonlPath(projectSlug) {
+        return join(dir, `${projectSlug}.jsonl`);
+    }
+    function readEntries(projectSlug) {
+        const path = getJsonlPath(projectSlug);
+        if (!existsSync(path))
+            return [];
+        try {
+            const content = readFileSync(path, 'utf-8');
+            return content.split('\n').filter(line => line.trim()).map(line => JSON.parse(line));
+        }
+        catch {
+            return [];
+        }
+    }
+    function writeEntries(projectSlug, entries) {
+        ensureDir();
+        const path = getJsonlPath(projectSlug);
+        const content = entries.map(e => JSON.stringify(e)).join('\n') + '\n';
+        writeFileSync(path, content, 'utf-8');
+    }
+    return {
+        append(entry) {
+            ensureDir();
+            const path = getJsonlPath(entry.projectSlug);
+            appendFileSync(path, JSON.stringify(entry) + '\n', 'utf-8');
+        },
+        search(query) {
+            const slug = query.projectSlug;
+            const slugs = slug ? [slug] : listProjectSlugs(dir);
+            const allEntries = [];
+            for (const s of slugs) {
+                const entries = readEntries(s);
+                allEntries.push(...entries);
+            }
+            let filtered = allEntries;
+            if (query.category) {
+                filtered = filtered.filter(e => e.category === query.category);
+            }
+            if (query.tags && query.tags.length > 0) {
+                filtered = filtered.filter(e => query.tags.some(t => e.tags.includes(t)));
+            }
+            // Sort by timestamp descending (newest first)
+            filtered.sort((a, b) => new Date(b.ts).getTime() - new Date(a.ts).getTime());
+            if (query.limit) {
+                filtered = filtered.slice(0, query.limit);
+            }
+            return filtered;
+        },
+        prune(opts) {
+            const slugs = listProjectSlugs(dir);
+            let prunedCount = 0;
+            for (const slug of slugs) {
+                const entries = readEntries(slug);
+                const now = Date.now();
+                const kept = entries.filter(e => {
+                    if (opts.olderThanDays) {
+                        const ageMs = now - new Date(e.ts).getTime();
+                        const ageDays = ageMs / (1000 * 60 * 60 * 24);
+                        if (ageDays > opts.olderThanDays) {
+                            prunedCount++;
+                            return false;
+                        }
+                    }
+                    if (opts.minRelevance && e.relevanceDecay) {
+                        const ageMs = now - new Date(e.ts).getTime();
+                        const ageDays = ageMs / (1000 * 60 * 60 * 24);
+                        const relevance = Math.max(0, 1 - (e.relevanceDecay * ageDays / 30));
+                        if (relevance < opts.minRelevance) {
+                            prunedCount++;
+                            return false;
+                        }
+                    }
+                    return true;
+                });
+                if (kept.length !== entries.length) {
+                    writeEntries(slug, kept);
+                }
+            }
+            return prunedCount;
+        },
+        count() {
+            const slugs = listProjectSlugs(dir);
+            let total = 0;
+            for (const slug of slugs) {
+                total += readEntries(slug).length;
+            }
+            return total;
+        },
+        exportJsonl() {
+            const slugs = listProjectSlugs(dir);
+            const lines = [];
+            for (const slug of slugs) {
+                const entries = readEntries(slug);
+                for (const entry of entries) {
+                    lines.push(JSON.stringify(entry));
+                }
+            }
+            return lines.join('\n') + '\n';
+        },
+    };
+}
+export function autoLearnFromRunReport(report) {
+    const entries = [];
+    const projectSlug = deriveProjectSlug();
+    const ts = new Date().toISOString();
+    // Learn from blocked runs
+    if (report.status === 'blocked') {
+        entries.push({
+            id: randomUUID(),
+            ts,
+            projectSlug,
+            category: 'failure',
+            title: `Run blocked: ${report.plan.task.slice(0, 80)}`,
+            detail: `Task "${report.plan.task}" was blocked. Governance mode: ${report.plan.governance?.mode ?? 'unknown'}.`,
+            evidenceIds: [],
+            tags: ['blocked', report.mode],
+            relevanceDecay: 0.3,
+        });
+    }
+    // Learn from failure learning candidates
+    for (const candidate of report.failureLearning.candidates) {
+        entries.push({
+            id: randomUUID(),
+            ts,
+            projectSlug,
+            category: 'failure',
+            title: candidate.title,
+            detail: candidate.summary,
+            evidenceIds: candidate.evidenceRefs,
+            tags: ['failure-learning', candidate.source, candidate.promotable ? 'promotable' : 'non-promotable'],
+            relevanceDecay: 0.2,
+        });
+    }
+    // Learn from verification failures
+    for (const cmd of report.verification.commands) {
+        if (cmd.status === 'failed') {
+            entries.push({
+                id: randomUUID(),
+                ts,
+                projectSlug,
+                category: 'failure',
+                title: `Verification failed: ${cmd.command}`,
+                detail: `Command "${cmd.command}" exited with code ${cmd.exitCode}.`,
+                evidenceIds: [],
+                tags: ['verification-failure', 'exit-code-' + cmd.exitCode],
+                relevanceDecay: 0.4,
+            });
+        }
+    }
+    return entries;
+}
+// ============================================================================
+// Load Relevant Learnings
+// ============================================================================
+export function loadRelevantLearnings(opts) {
+    const scaleDir = opts.scaleDir ?? '.scale';
+    const storePath = join(scaleDir, 'learnings');
+    const store = createLearningStore({ storePath });
+    const projectSlug = deriveProjectSlug(opts.projectDir);
+    const query = {
+        projectSlug,
+        tags: opts.tags,
+        limit: opts.limit ?? 10,
+    };
+    let results = store.search(query);
+    // If task is provided, filter by relevance to task keywords
+    if (opts.task) {
+        const taskWords = opts.task.toLowerCase().split(/\s+/).filter(w => w.length > 3);
+        results = results.filter(e => {
+            const entryText = `${e.title} ${e.detail}`.toLowerCase();
+            return taskWords.some(w => entryText.includes(w));
+        });
+    }
+    return results.slice(0, opts.limit ?? 10);
+}
+// ============================================================================
+// Helpers
+// ============================================================================
+function deriveProjectSlug(projectDir) {
+    try {
+        const dir = projectDir ?? process.cwd();
+        return basename(dir).replace(/[^a-zA-Z0-9-]/g, '-').toLowerCase();
+    }
+    catch {
+        return 'unknown';
+    }
+}
+function listProjectSlugs(dir) {
+    if (!existsSync(dir))
+        return [];
+    try {
+        return readdirSync(dir)
+            .filter(f => f.endsWith('.jsonl'))
+            .map(f => f.replace('.jsonl', ''));
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=SessionLearnings.js.map

package/dist/evolution/SessionLearnings.js.map

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

package/dist/evolution/SkillCreator.d.ts

@@ -0,0 +1,75 @@
+import type { Pattern, IPatternExtractor } from './PatternExtractor.js';
+import type { IEventBus } from '../core/eventBus.js';
+export interface SkillProposal {
+    id: string;
+    name: string;
+    description: string;
+    triggers: string[];
+    triggerConditions: string[];
+    agents: string[];
+    steps: SkillStep[];
+    examples: SkillExample[];
+    antipatterns: string[];
+    sourcePattern: string;
+    sourceConversation?: string;
+    meetsCriteria?: SkillCriteria;
+    status: 'draft' | 'proposed' | 'approved' | 'published';
+    createdAt: number;
+}
+export interface SkillStep {
+    phase: string;
+    actions: string[];
+    checklist: string[];
+}
+export interface SkillExample {
+    title: string;
+    code?: string;
+    description: string;
+}
+export interface SkillCriteria {
+    notGoogleable: boolean;
+    contextSpecific: boolean;
+    executable: boolean;
+    hardWon: boolean;
+}
+export interface SkillCandidate {
+    id: string;
+    detectedPattern: string;
+    potentialTriggers: string[];
+    estimatedValue: number;
+    meetsCriteria: SkillCriteria;
+}
+export interface ISkillCreator {
+    patternToSkill(pattern: Pattern): SkillProposal;
+    detectSkillCandidate(conversationId: string): SkillCandidate | null;
+    validateTriggerConditions(proposal: SkillProposal): {
+        valid: boolean;
+        reason?: string;
+    };
+    proposeToUser(skill: SkillProposal): Promise<boolean>;
+    publish(skill: SkillProposal, skillsDir: string): string;
+    getProposals(): SkillProposal[];
+}
+export declare class SkillCreator implements ISkillCreator {
+    private extractor;
+    private eventBus;
+    private proposals;
+    private seq;
+    constructor(extractor: IPatternExtractor, eventBus: IEventBus);
+    patternToSkill(pattern: Pattern): SkillProposal;
+    proposeToUser(skill: SkillProposal): Promise<boolean>;
+    publish(skill: SkillProposal, skillsDir: string): string;
+    getProposals(): SkillProposal[];
+    detectSkillCandidate(conversationId: string): SkillCandidate | null;
+    validateTriggerConditions(proposal: SkillProposal): {
+        valid: boolean;
+        reason?: string;
+    };
+    private generateSkillMarkdownEnhanced;
+    private skillNameFromPattern;
+    private inferTriggers;
+    private inferTriggerConditions;
+    private inferAgents;
+    private convertSteps;
+    private generateSkillMarkdown;
+}

package/dist/evolution/SkillCreator.js

@@ -0,0 +1,219 @@
+// SCALE Engine — Skill Creator
+// Purpose: Convert verified patterns into reusable skills
+// Enhanced: mattpoclock/skills style write-a-skill
+import { logger } from '../core/logger.js';
+import { writeFileSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+export class SkillCreator {
+    constructor(extractor, eventBus) {
+        this.extractor = extractor;
+        this.eventBus = eventBus;
+        this.proposals = new Map();
+        this.seq = 0;
+    }
+    patternToSkill(pattern) {
+        const skill = {
+            id: 'SKILL-' + Date.now() + '-' + (++this.seq).toString().padStart(3, '0'),
+            name: this.skillNameFromPattern(pattern),
+            description: pattern.description,
+            triggers: this.inferTriggers(pattern),
+            triggerConditions: this.inferTriggerConditions(pattern),
+            agents: this.inferAgents(pattern),
+            steps: this.convertSteps(pattern.steps),
+            examples: [],
+            antipatterns: [],
+            sourcePattern: pattern.id,
+            status: 'draft',
+            createdAt: Date.now(),
+        };
+        this.proposals.set(skill.id, skill);
+        logger.info({ skillId: skill.id, patternId: pattern.id }, 'Pattern converted to skill draft');
+        return skill;
+    }
+    async proposeToUser(skill) {
+        skill.status = 'proposed';
+        this.eventBus.emit('skill.proposed', { skillId: skill.id, name: skill.name });
+        logger.info({ skillId: skill.id }, 'Skill proposed for user approval');
+        return true;
+    }
+    publish(skill, skillsDir) {
+        if (skill.status !== 'approved') {
+            logger.warn({ skillId: skill.id }, 'Skill not approved - cannot publish');
+            throw new Error('Skill must be approved before publishing');
+        }
+        mkdirSync(skillsDir, { recursive: true });
+        const skillDir = join(skillsDir, skill.name.toLowerCase().replace(/\s+/g, '-'));
+        mkdirSync(skillDir, { recursive: true });
+        const skillPath = join(skillDir, 'SKILL.md');
+        const content = this.generateSkillMarkdown(skill);
+        writeFileSync(skillPath, content, 'utf-8');
+        skill.status = 'published';
+        this.eventBus.emit('skill.published', { skillId: skill.id, path: skillPath });
+        logger.info({ skillId: skill.id, path: skillPath }, 'Skill published');
+        return skillPath;
+    }
+    getProposals() {
+        return Array.from(this.proposals.values());
+    }
+    // ========== mattpoclock/skills style: write-a-skill ==========
+    detectSkillCandidate(conversationId) {
+        // Placeholder: In real implementation, would analyze conversation history
+        // For now, return null to indicate no candidate detected
+        logger.debug({ conversationId }, 'Scanning conversation for skill candidates');
+        return null;
+    }
+    validateTriggerConditions(proposal) {
+        // mattpoclock detection: trigger conditions should describe SCENARIOS, not ACTIONS
+        const actionWords = ['implement', 'build', 'create', 'write', 'develop', 'code', 'fix', 'add'];
+        for (const trigger of proposal.triggerConditions) {
+            for (const action of actionWords) {
+                if (trigger.toLowerCase().includes(action)) {
+                    return {
+                        valid: false,
+                        reason: `Trigger "${trigger}" describes action, not scenario. Use "when X happens" instead.`,
+                    };
+                }
+            }
+        }
+        // Check that triggers use mattpoclock style: "Use when X"
+        for (const trigger of proposal.triggerConditions) {
+            if (!trigger.toLowerCase().includes('when') && !trigger.toLowerCase().includes('if')) {
+                return {
+                    valid: false,
+                    reason: `Trigger "${trigger}" should use "Use when X" format`,
+                };
+            }
+        }
+        return { valid: true };
+    }
+    generateSkillMarkdownEnhanced(skill) {
+        // mattpoclock/skills YAML frontmatter format
+        const frontmatter = {
+            name: skill.name,
+            description: `Use when ${skill.triggerConditions.join(' OR ')}`,
+            version: '1.0.0',
+            author: 'scale-engine',
+            extractedFrom: skill.sourceConversation,
+        };
+        let md = '---\n';
+        md += `name: ${frontmatter.name}\n`;
+        md += `description: ${frontmatter.description}\n`;
+        md += `version: ${frontmatter.version}\n`;
+        if (frontmatter.author)
+            md += `author: ${frontmatter.author}\n`;
+        if (frontmatter.extractedFrom)
+            md += `extractedFrom: ${frontmatter.extractedFrom}\n`;
+        md += '---\n\n';
+        md += `## When to Use\n\n`;
+        for (const t of skill.triggerConditions)
+            md += `- ${t}\n`;
+        md += '\n';
+        md += '## Steps\n\n';
+        for (const step of skill.steps) {
+            md += `${step.phase}:\n`;
+            for (const action of step.actions)
+                md += `1. ${action}\n`;
+            md += '\n';
+        }
+        if (skill.examples?.length) {
+            md += '## Examples\n\n';
+            for (const ex of skill.examples) {
+                md += `### ${ex.title}\n${ex.description}\n`;
+                if (ex.code)
+                    md += `\n\`\`\`\n${ex.code}\n\`\`\`\n`;
+                md += '\n';
+            }
+        }
+        if (skill.antipatterns?.length) {
+            md += '## Anti-patterns\n\n';
+            for (const a of skill.antipatterns)
+                md += `- ${a}\n`;
+            md += '\n';
+        }
+        return md;
+    }
+    skillNameFromPattern(pattern) {
+        return pattern.name.replace(' Pattern', '').replace(' Workflow', '');
+    }
+    inferTriggers(pattern) {
+        const triggers = [];
+        for (const step of pattern.steps) {
+            const words = step.action.toLowerCase().split(/\s+/);
+            triggers.push(...words.filter(w => w.length > 3));
+        }
+        return [...new Set(triggers)].slice(0, 5);
+    }
+    inferTriggerConditions(pattern) {
+        // mattpoclock style: "Use when X" format, not action descriptions
+        const conditions = [];
+        const name = this.skillNameFromPattern(pattern).toLowerCase();
+        // Generate scenario-based triggers
+        if (name.includes('auth'))
+            conditions.push('Use when implementing authentication features');
+        if (name.includes('api'))
+            conditions.push('Use when building API endpoints');
+        if (name.includes('test'))
+            conditions.push('Use when writing tests');
+        if (name.includes('deploy'))
+            conditions.push('Use when deploying to production');
+        if (name.includes('refactor'))
+            conditions.push('Use when restructuring existing code');
+        // Default fallback
+        if (conditions.length === 0)
+            conditions.push(`Use when working with ${name}`);
+        return conditions;
+    }
+    inferAgents(pattern) {
+        const agentMap = {
+            plan: ['planner'],
+            implement: ['implementer'],
+            test: ['tester'],
+            review: ['reviewer'],
+            debug: ['debugger'],
+            document: ['doc-writer'],
+        };
+        const agents = [];
+        for (const step of pattern.steps) {
+            for (const [keyword, agentList] of Object.entries(agentMap)) {
+                if (step.action.toLowerCase().includes(keyword)) {
+                    agents.push(...agentList);
+                }
+            }
+        }
+        return [...new Set(agents)];
+    }
+    convertSteps(patternSteps) {
+        const phases = ['Setup', 'Execute', 'Verify'];
+        return patternSteps.map((ps, i) => ({
+            phase: phases[i] ?? 'Step ' + (i + 1),
+            actions: [ps.action],
+            checklist: ['Verify ' + ps.expectedOutcome],
+        }));
+    }
+    generateSkillMarkdown(skill) {
+        let md = '---\n';
+        md += 'name: ' + skill.name + '\n';
+        md += 'version: 1.0.0\n';
+        md += 'description: ' + skill.description + '\n';
+        md += 'triggers:\n';
+        for (const t of skill.triggers)
+            md += '  - ' + t + '\n';
+        md += 'agents:\n';
+        for (const a of skill.agents)
+            md += '  - ' + a + '\n';
+        md += '---\n\n';
+        md += '# ' + skill.name + '\n\n';
+        md += 'Auto-generated from pattern: ' + skill.sourcePattern + '\n\n';
+        for (const step of skill.steps) {
+            md += '## ' + step.phase + '\n\n';
+            for (const action of step.actions)
+                md += '1. ' + action + '\n';
+            md += '\n**Checklist:**\n';
+            for (const item of step.checklist)
+                md += '- [ ] ' + item + '\n';
+            md += '\n';
+        }
+        return md;
+    }
+}
+//# sourceMappingURL=SkillCreator.js.map

package/dist/evolution/SkillCreator.js.map

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

package/dist/fsm/FSMAgentBridge.d.ts

@@ -0,0 +1,59 @@
+import type { IArtifactStore } from "../artifact/store.js";
+import type { IFSM } from "../artifact/fsm.js";
+import type { IEventBus } from "../core/eventBus.js";
+export interface FSMContextSnapshot {
+    artifactId: string;
+    artifactType: string;
+    currentStatus: string;
+    allowedTransitions: string[];
+    blockingReasons: string[];
+    downstreamImpact: string[];
+    parentStatus?: string;
+    childrenStatuses: string[];
+}
+export interface SessionFSMContext {
+    sessionId: string;
+    artifacts: FSMContextSnapshot[];
+    recalledLessons: string[];
+    recommendations: string[];
+    generatedAt: number;
+}
+export interface IFSMAgentBridge {
+    getFSMContext(artifactId: string): Promise<FSMContextSnapshot | null>;
+    getSessionContext(sessionId: string, eventBus: IEventBus): Promise<SessionFSMContext>;
+    checkOperation(artifactId: string, operation: string): Promise<{
+        allowed: boolean;
+        reasons: string[];
+    }>;
+    getCreationPrerequisites(artifactType: string): Promise<{
+        requiredParentStatus: string[];
+        message: string;
+    }>;
+    injectFSMContextToPrompt(prompt: string, artifactIds: string[]): Promise<string>;
+}
+export declare class FSMAgentBridge implements IFSMAgentBridge {
+    private fsm;
+    private store;
+    constructor(fsm: IFSM, store: IArtifactStore);
+    getFSMContext(artifactId: string): Promise<FSMContextSnapshot | null>;
+    checkOperation(artifactId: string, operation: string): Promise<{
+        allowed: boolean;
+        reasons: string[];
+    }>;
+    getCreationPrerequisites(artifactType: string): Promise<{
+        requiredParentStatus: string[];
+        message: string;
+    }>;
+    /**
+     * Get FSM context for all artifacts related to a session
+     * This is the primary method for SessionStart hook to inject context
+     */
+    getSessionContext(sessionId: string, eventBus: IEventBus): Promise<SessionFSMContext>;
+    /**
+     * Generate actionable recommendations from FSM state
+     */
+    private generateRecommendations;
+    injectFSMContextToPrompt(prompt: string, artifactIds: string[]): Promise<string>;
+    private calculateDownstreamImpact;
+    private formatFSMBlock;
+}