monomind 1.6.0 → 1.6.1

package/packages/@monomind/cli/dist/src/agents/prompt-version-manager.js

@@ -1,58 +0,0 @@
-/**
- * PromptVersionManager - High-level prompt version lifecycle operations
- *
- * Provides publish-from-file, promote, rollback, and experiment
- * start/stop workflows on top of PromptVersionStore.
- *
- * @module @monoes/cli/agents/prompt-version-manager
- */
-import * as fs from 'node:fs';
-export class PromptVersionManager {
-    store;
-    constructor(store) {
-        this.store = store;
-    }
-    publishFromFile(agentSlug, filePath, newVersion, changelog) {
-        const prompt = fs.readFileSync(filePath, 'utf-8');
-        const version = {
-            agentSlug,
-            version: newVersion,
-            prompt,
-            changelog,
-            activeFrom: new Date(),
-            traceCount: 0,
-            publishedBy: 'prompt-version-manager',
-            createdAt: new Date(),
-        };
-        this.store.save(version);
-        return version;
-    }
-    promote(agentSlug, version) {
-        this.store.setActive(agentSlug, version);
-    }
-    rollback(agentSlug, stepsBack = 1) {
-        const versions = this.store.listVersions(agentSlug);
-        if (versions.length < stepsBack + 1) {
-            throw new Error(`Cannot rollback ${stepsBack} step(s): only ${versions.length} version(s) exist for "${agentSlug}"`);
-        }
-        // versions are sorted DESC by createdAt, so index 0 = newest
-        const target = versions[stepsBack];
-        this.store.setActive(agentSlug, target.version);
-    }
-    startExperiment(experiment) {
-        this.store.saveExperiment(experiment);
-    }
-    stopExperiment(agentSlug, promoteWinner) {
-        const experiment = this.store.getExperiment(agentSlug);
-        if (!experiment) {
-            throw new Error(`No active experiment for "${agentSlug}"`);
-        }
-        // Default winner is control
-        const winnerId = experiment.control;
-        this.store.concludeExperiment(agentSlug, winnerId);
-        if (promoteWinner) {
-            this.store.setActive(agentSlug, winnerId);
-        }
-    }
-}
-//# sourceMappingURL=prompt-version-manager.js.map

package/packages/@monomind/cli/dist/src/agents/registry-builder.d.ts

@@ -1,36 +0,0 @@
-/**
- * Registry Builder (Task 30)
- *
- * Scans agent definition .md files, parses YAML frontmatter,
- * and produces a unified AgentRegistry JSON.
- */
-import type { AgentRegistry } from '../../../shared/src/types/agent-registry.js';
-/**
- * Build the agent registry by scanning `.md` files under `agentsRoot`.
- *
- * @param agentsRoot - Root directory (or array of directories) to scan.
- * @param outputPath - Optional path to write the registry JSON file.
- * @returns The built AgentRegistry object.
- */
-export declare function buildRegistry(agentsRoot: string, outputPath?: string): AgentRegistry;
-/**
- * Build a unified agent registry from multiple root directories, deduplicating
- * by slug. When the same slug appears in more than one root, the entry from the
- * **first** root in the array wins (earlier roots are considered canonical).
- *
- * Typical usage — extras (agency-agents) listed first so they take precedence
- * over any locally duplicated copies in `.claude/agents/`:
- *
- * ```ts
- * buildUnifiedRegistry([
- *   '/path/to/agency-agents',   // canonical source — wins on conflict
- *   '.claude/agents',           // dev copies — used only for unique slugs
- * ], '.monomind/registry.json');
- * ```
- *
- * @param roots      - Ordered list of directories to scan (first-wins on slug conflict).
- * @param outputPath - Optional path to write the merged registry JSON file.
- * @returns The deduplicated AgentRegistry.
- */
-export declare function buildUnifiedRegistry(roots: string[], outputPath?: string): AgentRegistry;
-//# sourceMappingURL=registry-builder.d.ts.map

package/packages/@monomind/cli/dist/src/agents/registry-builder.js

@@ -1,200 +0,0 @@
-/**
- * Registry Builder (Task 30)
- *
- * Scans agent definition .md files, parses YAML frontmatter,
- * and produces a unified AgentRegistry JSON.
- */
-import { readFileSync, writeFileSync, readdirSync, statSync } from 'fs';
-import { join, basename, relative, extname } from 'path';
-/** Directories to skip during recursive scan. */
-const SKIP_DIRS = new Set(['schemas', 'ephemeral']);
-/**
- * Recursively collect all `.md` files under `root`, skipping SKIP_DIRS.
- */
-function collectMdFiles(root, base = root) {
-    const results = [];
-    let entries;
-    try {
-        entries = readdirSync(root);
-    }
-    catch {
-        return results;
-    }
-    for (const entry of entries) {
-        const full = join(root, entry);
-        let stat;
-        try {
-            stat = statSync(full);
-        }
-        catch {
-            continue;
-        }
-        if (stat.isDirectory()) {
-            if (SKIP_DIRS.has(entry))
-                continue;
-            results.push(...collectMdFiles(full, base));
-        }
-        else if (stat.isFile() && extname(entry) === '.md') {
-            results.push(full);
-        }
-    }
-    return results;
-}
-/**
- * Parse YAML frontmatter from markdown content using simple regex.
- * Returns key-value pairs from the `---` delimited block.
- */
-function parseFrontmatter(content) {
-    const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---/);
-    if (!match)
-        return {};
-    const block = match[1];
-    const result = {};
-    for (const line of block.split('\n')) {
-        const trimmed = line.trim();
-        if (!trimmed || trimmed.startsWith('#'))
-            continue;
-        const colonIdx = trimmed.indexOf(':');
-        if (colonIdx === -1)
-            continue;
-        const key = trimmed.slice(0, colonIdx).trim();
-        let value = trimmed.slice(colonIdx + 1).trim();
-        // Handle YAML arrays written as "[a, b, c]"
-        if (typeof value === 'string' && value.startsWith('[') && value.endsWith(']')) {
-            value = value
-                .slice(1, -1)
-                .split(',')
-                .map((s) => s.trim().replace(/^["']|["']$/g, ''))
-                .filter(Boolean);
-        }
-        // Handle booleans
-        else if (value === 'true')
-            value = true;
-        else if (value === 'false')
-            value = false;
-        // Handle quoted strings
-        else if (typeof value === 'string' &&
-            ((value.startsWith('"') && value.endsWith('"')) ||
-                (value.startsWith("'") && value.endsWith("'")))) {
-            value = value.slice(1, -1);
-        }
-        result[key] = value;
-    }
-    return result;
-}
-/** Coerce a value into a string array. */
-function toStringArray(val) {
-    if (Array.isArray(val))
-        return val.map(String);
-    if (typeof val === 'string' && val.length > 0)
-        return [val];
-    return [];
-}
-/** Parse trigger patterns from frontmatter value. */
-function parseTriggers(val) {
-    if (!val)
-        return [];
-    const arr = Array.isArray(val) ? val : [val];
-    return arr.map((t) => {
-        if (typeof t === 'object' && t !== null && 'pattern' in t) {
-            return { pattern: String(t.pattern), mode: String(t.mode ?? 'glob') };
-        }
-        return { pattern: String(t), mode: 'glob' };
-    });
-}
-/**
- * Derive a slug from a filename: remove extension, lowercase, replace spaces with hyphens.
- */
-function slugFromFilename(filename) {
-    return basename(filename, extname(filename))
-        .toLowerCase()
-        .replace(/\s+/g, '-')
-        .replace(/[^a-z0-9-]/g, '');
-}
-/**
- * Derive category from the parent directory name relative to agents root.
- */
-function categoryFromPath(filePath, agentsRoot) {
-    const rel = relative(agentsRoot, filePath);
-    const parts = rel.split('/');
-    return parts.length > 1 ? parts[0] : 'default';
-}
-/**
- * Build the agent registry by scanning `.md` files under `agentsRoot`.
- *
- * @param agentsRoot - Root directory (or array of directories) to scan.
- * @param outputPath - Optional path to write the registry JSON file.
- * @returns The built AgentRegistry object.
- */
-export function buildRegistry(agentsRoot, outputPath) {
-    return buildUnifiedRegistry([agentsRoot], outputPath);
-}
-/**
- * Build a unified agent registry from multiple root directories, deduplicating
- * by slug. When the same slug appears in more than one root, the entry from the
- * **first** root in the array wins (earlier roots are considered canonical).
- *
- * Typical usage — extras (agency-agents) listed first so they take precedence
- * over any locally duplicated copies in `.claude/agents/`:
- *
- * ```ts
- * buildUnifiedRegistry([
- *   '/path/to/agency-agents',   // canonical source — wins on conflict
- *   '.claude/agents',           // dev copies — used only for unique slugs
- * ], '.monomind/registry.json');
- * ```
- *
- * @param roots      - Ordered list of directories to scan (first-wins on slug conflict).
- * @param outputPath - Optional path to write the merged registry JSON file.
- * @returns The deduplicated AgentRegistry.
- */
-export function buildUnifiedRegistry(roots, outputPath) {
-    const now = new Date().toISOString();
-    /** Slug → first-seen entry (first root wins). */
-    const seen = new Map();
-    for (const root of roots) {
-        const files = collectMdFiles(root);
-        for (const file of files) {
-            let content;
-            try {
-                content = readFileSync(file, 'utf-8');
-            }
-            catch {
-                continue;
-            }
-            const fm = parseFrontmatter(content);
-            const slug = fm.slug || slugFromFilename(file);
-            // Skip duplicates — first root wins
-            if (seen.has(slug))
-                continue;
-            seen.set(slug, {
-                slug,
-                name: fm.name || slug,
-                version: fm.version || '0.0.0',
-                category: fm.category || categoryFromPath(file, root),
-                capabilities: toStringArray(fm.capabilities),
-                taskTypes: toStringArray(fm.taskTypes ?? fm['task-types'] ?? fm.task_types),
-                tools: toStringArray(fm.tools),
-                triggers: parseTriggers(fm.triggers),
-                deprecated: fm.deprecated === true,
-                deprecatedBy: fm.deprecatedBy,
-                dependencies: toStringArray(fm.dependencies),
-                filePath: file,
-                registeredAt: now,
-                lastUpdated: now,
-            });
-        }
-    }
-    const agents = Array.from(seen.values());
-    const registry = {
-        version: '1.0.0',
-        generatedAt: now,
-        totalAgents: agents.length,
-        agents,
-    };
-    if (outputPath) {
-        writeFileSync(outputPath, JSON.stringify(registry, null, 2), 'utf-8');
-    }
-    return registry;
-}
-//# sourceMappingURL=registry-builder.js.map

package/packages/@monomind/cli/dist/src/agents/registry-query.d.ts

@@ -1,71 +0,0 @@
-/**
- * Registry Query (Task 30)
- *
- * Provides query and validation utilities over an AgentRegistry.
- * Supports loading from an in-memory object or a JSON file on disk.
- */
-import type { AgentRegistry, AgentRegistryEntry } from '../../../shared/src/types/agent-registry.js';
-/** Validation issue found during registry validation. */
-export interface RegistryValidationResult {
-    slug: string;
-    field: string;
-    message: string;
-    severity: 'error' | 'warning';
-}
-/** Conflict entry for duplicate slug detection. */
-export interface RegistryConflict {
-    slug: string;
-    entries: AgentRegistryEntry[];
-}
-/**
- * Query engine for the Central Agent Registry.
- */
-export declare class RegistryQuery {
-    private agents;
-    private constructor();
-    /**
-     * Create a RegistryQuery from an in-memory AgentRegistry object.
-     */
-    static loadFromJSON(registry: AgentRegistry): RegistryQuery;
-    /**
-     * Create a RegistryQuery by reading a registry JSON file from disk.
-     */
-    static loadFromFile(path: string): RegistryQuery;
-    /**
-     * Find all agents that list the given capability.
-     */
-    findByCapability(capability: string): AgentRegistryEntry[];
-    /**
-     * Find all agents that handle the given task type.
-     */
-    findByTaskType(taskType: string): AgentRegistryEntry[];
-    /**
-     * Find an agent by its unique slug. Returns undefined if not found.
-     */
-    findBySlug(slug: string): AgentRegistryEntry | undefined;
-    /**
-     * Find all agents that list the given tool.
-     */
-    findByTool(tool: string): AgentRegistryEntry[];
-    /**
-     * Find micro-agents — agents that have at least one trigger pattern.
-     */
-    findMicroAgents(): AgentRegistryEntry[];
-    /**
-     * Return all agent slugs in the registry.
-     */
-    allSlugs(): string[];
-    /**
-     * Validate the registry, returning a list of validation issues.
-     * Checks:
-     * - version must be valid semver (X.Y.Z pattern)
-     * - slug must be non-empty
-     * - name must be non-empty
-     */
-    validate(): RegistryValidationResult[];
-    /**
-     * Detect duplicate slugs across registry entries.
-     */
-    conflicts(): RegistryConflict[];
-}
-//# sourceMappingURL=registry-query.d.ts.map

package/packages/@monomind/cli/dist/src/agents/registry-query.js

@@ -1,125 +0,0 @@
-/**
- * Registry Query (Task 30)
- *
- * Provides query and validation utilities over an AgentRegistry.
- * Supports loading from an in-memory object or a JSON file on disk.
- */
-import { readFileSync } from 'fs';
-/**
- * Query engine for the Central Agent Registry.
- */
-export class RegistryQuery {
-    agents;
-    constructor(agents) {
-        this.agents = agents;
-    }
-    /**
-     * Create a RegistryQuery from an in-memory AgentRegistry object.
-     */
-    static loadFromJSON(registry) {
-        return new RegistryQuery(registry.agents ?? []);
-    }
-    /**
-     * Create a RegistryQuery by reading a registry JSON file from disk.
-     */
-    static loadFromFile(path) {
-        const raw = readFileSync(path, 'utf-8');
-        const registry = JSON.parse(raw);
-        return RegistryQuery.loadFromJSON(registry);
-    }
-    /**
-     * Find all agents that list the given capability.
-     */
-    findByCapability(capability) {
-        return this.agents.filter((a) => a.capabilities.includes(capability));
-    }
-    /**
-     * Find all agents that handle the given task type.
-     */
-    findByTaskType(taskType) {
-        return this.agents.filter((a) => a.taskTypes.includes(taskType));
-    }
-    /**
-     * Find an agent by its unique slug. Returns undefined if not found.
-     */
-    findBySlug(slug) {
-        return this.agents.find((a) => a.slug === slug);
-    }
-    /**
-     * Find all agents that list the given tool.
-     */
-    findByTool(tool) {
-        return this.agents.filter((a) => a.tools.includes(tool));
-    }
-    /**
-     * Find micro-agents — agents that have at least one trigger pattern.
-     */
-    findMicroAgents() {
-        return this.agents.filter((a) => a.triggers.length > 0);
-    }
-    /**
-     * Return all agent slugs in the registry.
-     */
-    allSlugs() {
-        return this.agents.map((a) => a.slug);
-    }
-    /**
-     * Validate the registry, returning a list of validation issues.
-     * Checks:
-     * - version must be valid semver (X.Y.Z pattern)
-     * - slug must be non-empty
-     * - name must be non-empty
-     */
-    validate() {
-        const results = [];
-        const semverRe = /^\d+\.\d+\.\d+/;
-        for (const agent of this.agents) {
-            if (!agent.slug) {
-                results.push({ slug: agent.slug ?? '(empty)', field: 'slug', message: 'Slug is empty', severity: 'error' });
-            }
-            if (!agent.name) {
-                results.push({ slug: agent.slug, field: 'name', message: 'Name is empty', severity: 'error' });
-            }
-            if (!semverRe.test(agent.version)) {
-                results.push({
-                    slug: agent.slug,
-                    field: 'version',
-                    message: `Invalid semver: "${agent.version}"`,
-                    severity: 'error',
-                });
-            }
-            if (agent.deprecated && !agent.deprecatedBy) {
-                results.push({
-                    slug: agent.slug,
-                    field: 'deprecatedBy',
-                    message: 'Agent is deprecated but deprecatedBy is not set',
-                    severity: 'warning',
-                });
-            }
-        }
-        return results;
-    }
-    /**
-     * Detect duplicate slugs across registry entries.
-     */
-    conflicts() {
-        const map = new Map();
-        for (const agent of this.agents) {
-            const existing = map.get(agent.slug);
-            if (existing) {
-                existing.push(agent);
-            }
-            else {
-                map.set(agent.slug, [agent]);
-            }
-        }
-        const result = [];
-        for (const [slug, entries] of map) {
-            if (entries.length > 1) {
-                result.push({ slug, entries });
-            }
-        }
-        return result;
-    }
-}
-//# sourceMappingURL=registry-query.js.map

package/packages/@monomind/cli/dist/src/agents/score-decay.d.ts

@@ -1,19 +0,0 @@
-/**
- * Score Decay (Task 39)
- *
- * Time-based decay for agent specialization scores.
- * Scores from 90 days ago have 50% weight (half-life model).
- */
-/** Half-life in days: after this many days, score weight is halved. */
-export declare const SCORE_HALF_LIFE_DAYS = 90;
-/**
- * Calculate the decay factor for a score based on how old it is.
- *
- * decay(t) = 0.5^(days_since_update / 90)
- *
- * - Returns 1.0 for scores updated right now
- * - Returns ~0.5 for scores updated 90 days ago
- * - Returns ~0.25 for scores updated 180 days ago
- */
-export declare function calculateDecayFactor(lastUpdatedIso: string): number;
-//# sourceMappingURL=score-decay.d.ts.map

package/packages/@monomind/cli/dist/src/agents/score-decay.js

@@ -1,22 +0,0 @@
-/**
- * Score Decay (Task 39)
- *
- * Time-based decay for agent specialization scores.
- * Scores from 90 days ago have 50% weight (half-life model).
- */
-/** Half-life in days: after this many days, score weight is halved. */
-export const SCORE_HALF_LIFE_DAYS = 90;
-/**
- * Calculate the decay factor for a score based on how old it is.
- *
- * decay(t) = 0.5^(days_since_update / 90)
- *
- * - Returns 1.0 for scores updated right now
- * - Returns ~0.5 for scores updated 90 days ago
- * - Returns ~0.25 for scores updated 180 days ago
- */
-export function calculateDecayFactor(lastUpdatedIso) {
-    const daysSince = (Date.now() - new Date(lastUpdatedIso).getTime()) / 86_400_000;
-    return Math.pow(0.5, daysSince / SCORE_HALF_LIFE_DAYS);
-}
-//# sourceMappingURL=score-decay.js.map

package/packages/@monomind/cli/dist/src/agents/shared-instructions-loader.d.ts

@@ -1,13 +0,0 @@
-export declare class SharedInstructionsLoader {
-    private cache;
-    private filePath;
-    constructor(filePath?: string);
-    load(basePath?: string): string;
-    getSharedInstructions(basePath?: string): string;
-    reload(basePath?: string): string;
-    isLoaded(): boolean;
-    /** Prepend shared instructions to an agent prompt with separator */
-    prependToPrompt(agentPrompt: string, basePath?: string): string;
-}
-export declare const sharedInstructionsLoader: SharedInstructionsLoader;
-//# sourceMappingURL=shared-instructions-loader.d.ts.map

package/packages/@monomind/cli/dist/src/agents/shared-instructions-loader.js

@@ -1,40 +0,0 @@
-import { readFileSync, existsSync } from 'node:fs';
-import { resolve } from 'node:path';
-const DEFAULT_PATH = '.agents/shared_instructions.md';
-export class SharedInstructionsLoader {
-    cache = null;
-    filePath;
-    constructor(filePath) {
-        this.filePath = filePath ?? DEFAULT_PATH;
-    }
-    load(basePath) {
-        const fullPath = basePath ? resolve(basePath, this.filePath) : this.filePath;
-        if (!existsSync(fullPath)) {
-            this.cache = '';
-            return '';
-        }
-        this.cache = readFileSync(fullPath, 'utf-8');
-        return this.cache;
-    }
-    getSharedInstructions(basePath) {
-        if (this.cache !== null)
-            return this.cache;
-        return this.load(basePath);
-    }
-    reload(basePath) {
-        this.cache = null;
-        return this.load(basePath);
-    }
-    isLoaded() {
-        return this.cache !== null;
-    }
-    /** Prepend shared instructions to an agent prompt with separator */
-    prependToPrompt(agentPrompt, basePath) {
-        const shared = this.getSharedInstructions(basePath);
-        if (!shared)
-            return agentPrompt;
-        return `${shared}\n\n---\n\n${agentPrompt}`;
-    }
-}
-export const sharedInstructionsLoader = new SharedInstructionsLoader();
-//# sourceMappingURL=shared-instructions-loader.js.map

package/packages/@monomind/cli/dist/src/agents/specialization-scorer.d.ts

@@ -1,54 +0,0 @@
-/**
- * Agent Specialization Scorer (Task 39)
- *
- * JSONL-based per-agent-per-task-type scoring with time-decay.
- * Enables monomind to prefer historically successful agents for specific task types.
- */
-import type { SpecializationScore, ScoreUpdate } from '../../../shared/src/types/specialization.js';
-/**
- * JSONL-based specialization scorer.
- *
- * Stores one JSON object per line in the configured file path.
- * Each line represents a SpecializationScore for a unique agent+taskType pair.
- * On update, the entire file is rewritten to maintain a single record per pair.
- */
-export declare class SpecializationScorer {
-    private readonly filePath;
-    constructor(filePath: string);
-    private readAll;
-    private writeAll;
-    /**
-     * Record an outcome for a given agent+taskType pair.
-     *
-     * Updates running averages for latency and quality, recalculates
-     * successRate, applies time-decay, and persists the result.
-     */
-    recordOutcome(update: ScoreUpdate): SpecializationScore;
-    /**
-     * Get the score for a specific agent+taskType pair, or null if not found.
-     * Recalculates decay on read.
-     */
-    getScore(agentSlug: string, taskType: string): SpecializationScore | null;
-    /**
-     * Get top N candidates for a task type from the given list of slugs,
-     * sorted by effectiveScore descending.
-     */
-    getTopCandidates(taskType: string, slugs: string[], topN?: number): SpecializationScore[];
-    /**
-     * Return the best candidate slug for a task type.
-     * Falls back to the first candidate if no scores exist.
-     */
-    topCandidate(taskType: string, candidates: string[]): string;
-    /**
-     * Get all scores for a given agent across all task types.
-     */
-    getAllScores(agentSlug: string): SpecializationScore[];
-    /**
-     * Reset scores for an agent. If taskType is provided, only that
-     * pair is removed; otherwise all scores for the agent are removed.
-     *
-     * @returns The number of records deleted.
-     */
-    resetScores(agentSlug: string, taskType?: string): number;
-}
-//# sourceMappingURL=specialization-scorer.d.ts.map