monomind 1.10.0 → 1.10.2

package/packages/@monomind/cli/dist/src/init/types.d.ts

@@ -0,0 +1,315 @@
+/**
+ * V1 Init System Types
+ * Configuration options for initializing Claude Code integration
+ */
+/**
+ * Components that can be initialized
+ */
+export interface InitComponents {
+    /** Create .claude/settings.json with hooks */
+    settings: boolean;
+    /** Copy skills to .claude/skills/ */
+    skills: boolean;
+    /** Copy commands to .claude/commands/ */
+    commands: boolean;
+    /** Copy agents to .claude/agents/ */
+    agents: boolean;
+    /** Create helper scripts in .claude/helpers/ */
+    helpers: boolean;
+    /** Configure statusline */
+    statusline: boolean;
+    /** Create MCP configuration */
+    mcp: boolean;
+    /** Create .monomind/ directory (V1 runtime) */
+    runtime: boolean;
+    /** Create CLAUDE.md with swarm guidance */
+    claudeMd: boolean;
+    /** Build knowledge graph on init using monograph (TypeScript) */
+    graphify: boolean;
+}
+/**
+ * Hook configuration options
+ * Valid Claude Code hook events (23 total):
+ *   PreToolUse, PostToolUse, PostToolUseFailure, UserPromptSubmit,
+ *   SessionStart, SessionEnd, Stop, SubagentStart, SubagentStop,
+ *   PreCompact, PostCompact, Notification, ConfigChange,
+ *   InstructionsLoaded, PermissionRequest, WorktreeCreate, WorktreeRemove,
+ *   TeammateIdle, TaskCompleted, Elicitation, ElicitationResult
+ */
+export interface HooksConfig {
+    /** Enable PreToolUse hooks */
+    preToolUse: boolean;
+    /** Enable PostToolUse hooks */
+    postToolUse: boolean;
+    /** Enable UserPromptSubmit for routing */
+    userPromptSubmit: boolean;
+    /** Enable SessionStart hooks */
+    sessionStart: boolean;
+    /** Enable Stop hooks */
+    stop: boolean;
+    /** Enable PreCompact hooks (context preservation before compaction) */
+    preCompact: boolean;
+    /** Enable Notification hooks */
+    notification: boolean;
+    /** Enable TeammateIdle hooks (agent teams auto-assign) */
+    teammateIdle: boolean;
+    /** Enable TaskCompleted hooks (agent teams pattern learning) */
+    taskCompleted: boolean;
+    /** Hook timeout in milliseconds */
+    timeout: number;
+    /** Continue on hook error */
+    continueOnError: boolean;
+}
+/**
+ * Skills configuration
+ */
+export interface SkillsConfig {
+    /** Include core skills (swarm, sparc, mastermind, monodesign, monomotion) */
+    core: boolean;
+    /** Include AgentDB skills */
+    agentdb: boolean;
+    /** Include GitHub integration skills */
+    github: boolean;
+    /** Include browser automation skills */
+    browser: boolean;
+    /** Include advanced skills (agentic-jujutsu, security, performance, etc.) */
+    advanced: boolean;
+    /** Include all available skills */
+    all: boolean;
+}
+/**
+ * Commands configuration
+ */
+export interface CommandsConfig {
+    /** Include core commands (mastermind.md, tokens.md, browse.md, sparc.md, ts.md) */
+    core: boolean;
+    /** Include agents commands */
+    agents?: boolean;
+    /** Include analysis commands */
+    analysis: boolean;
+    /** Include automation commands */
+    automation: boolean;
+    /** Include coordination commands */
+    coordination?: boolean;
+    /** Include github commands */
+    github: boolean;
+    /** Include hive-mind commands */
+    hiveMind?: boolean;
+    /** Include hooks commands */
+    hooks: boolean;
+    /** Include mastermind commands */
+    mastermind?: boolean;
+    /** Include memory commands */
+    memory?: boolean;
+    /** Include monitoring commands */
+    monitoring: boolean;
+    /** Include monograph commands */
+    monograph?: boolean;
+    /** Include monomind commands */
+    monomind?: boolean;
+    /** Include optimization commands */
+    optimization: boolean;
+    /** Include pair commands */
+    pair?: boolean;
+    /** Include SPARC commands */
+    sparc: boolean;
+    /** Include stream-chain commands */
+    streamChain?: boolean;
+    /** Include swarm commands */
+    swarm?: boolean;
+    /** Include training commands */
+    training?: boolean;
+    /** Include truth commands */
+    truth?: boolean;
+    /** Include verify commands */
+    verify?: boolean;
+    /** Include workflows commands */
+    workflows?: boolean;
+    /** Include all commands */
+    all: boolean;
+}
+/**
+ * Agents configuration
+ */
+export interface AgentsConfig {
+    /** Include core agents (coder, tester, reviewer) */
+    core: boolean;
+    /** Include consensus agents */
+    consensus: boolean;
+    /** Include GitHub agents */
+    github: boolean;
+    /** Include hive-mind agents */
+    hiveMind: boolean;
+    /** Include SPARC agents */
+    sparc: boolean;
+    /** Include swarm coordinators */
+    swarm: boolean;
+    /** Include optimization agents */
+    optimization: boolean;
+    /** Include testing agents */
+    testing: boolean;
+    /** Include all agents */
+    all: boolean;
+}
+/**
+ * Statusline configuration
+ */
+export interface StatuslineConfig {
+    /** Enable statusline */
+    enabled: boolean;
+    /** Show V1 progress */
+    showProgress: boolean;
+    /** Show security status */
+    showSecurity: boolean;
+    /** Show swarm activity */
+    showSwarm: boolean;
+    /** Show hooks metrics */
+    showHooks: boolean;
+    /** Show performance targets */
+    showPerformance: boolean;
+    /** Refresh interval in milliseconds */
+    refreshInterval: number;
+}
+/**
+ * MCP configuration
+ */
+export interface MCPConfig {
+    /** Include monomind MCP server */
+    monomind: boolean;
+    /** Include ruv-swarm MCP server */
+    ruvSwarm: boolean;
+    /** Include monograph knowledge graph MCP server */
+    graphify: boolean;
+    /** Auto-start MCP server */
+    autoStart: boolean;
+    /** Server port */
+    port: number;
+}
+/**
+ * Runtime configuration (.monomind/)
+ */
+export interface RuntimeConfig {
+    /** Swarm topology */
+    topology: 'mesh' | 'hierarchical' | 'hierarchical-mesh' | 'adaptive';
+    /** Maximum agents */
+    maxAgents: number;
+    /** Memory backend */
+    memoryBackend: 'memory' | 'sqlite' | 'agentdb' | 'hybrid';
+    /** Enable HNSW indexing */
+    enableHNSW: boolean;
+    /** Enable neural learning */
+    enableNeural: boolean;
+    /** Enable LearningBridge (ADR-049) - connects insights to SONA/ReasoningBank */
+    enableLearningBridge?: boolean;
+    /** Enable MemoryGraph (ADR-049) - PageRank knowledge graph */
+    enableMemoryGraph?: boolean;
+    /** Enable AgentMemoryScope (ADR-049) - 3-scope agent memory */
+    enableAgentScopes?: boolean;
+    /** CLAUDE.md template variant */
+    claudeMdTemplate?: ClaudeMdTemplate;
+}
+/** Template variants for generated CLAUDE.md files */
+export type ClaudeMdTemplate = 'minimal' | 'standard' | 'full' | 'security' | 'performance' | 'solo';
+/**
+ * Embeddings configuration
+ */
+export interface EmbeddingsConfig {
+    /** Enable embedding subsystem */
+    enabled: boolean;
+    /** ONNX model ID */
+    model: 'Xenova/all-MiniLM-L6-v2' | 'Xenova/all-mpnet-base-v2' | 'Xenova/bge-small-en-v1.5' | string;
+    /** Enable hyperbolic (Poincaré ball) embeddings */
+    hyperbolic: boolean;
+    /** Poincaré ball curvature (negative value, typically -1) */
+    curvature: number;
+    /** Pre-download model during init */
+    predownload: boolean;
+    /** LRU cache size (number of embeddings) */
+    cacheSize: number;
+    /** Enable neural substrate integration */
+    neuralSubstrate: boolean;
+}
+/**
+ * Detected platform information
+ */
+export interface PlatformInfo {
+    /** Operating system */
+    os: 'windows' | 'darwin' | 'linux';
+    /** Architecture */
+    arch: 'x64' | 'arm64' | 'arm' | 'ia32';
+    /** Node.js version */
+    nodeVersion: string;
+    /** Shell type */
+    shell: 'powershell' | 'cmd' | 'bash' | 'zsh' | 'sh';
+    /** Home directory */
+    homeDir: string;
+    /** Config directory (platform-specific) */
+    configDir: string;
+}
+/**
+ * Detect current platform
+ */
+export declare function detectPlatform(): PlatformInfo;
+/**
+ * Complete init options
+ */
+export interface InitOptions {
+    /** Target directory */
+    targetDir: string;
+    /** Source base directory for skills/commands/agents (optional) */
+    sourceBaseDir?: string;
+    /** Force overwrite existing files */
+    force: boolean;
+    /** Run in interactive mode */
+    interactive: boolean;
+    /** Components to initialize */
+    components: InitComponents;
+    /** Hooks configuration */
+    hooks: HooksConfig;
+    /** Skills configuration */
+    skills: SkillsConfig;
+    /** Commands configuration */
+    commands: CommandsConfig;
+    /** Agents configuration */
+    agents: AgentsConfig;
+    /** Statusline configuration */
+    statusline: StatuslineConfig;
+    /** MCP configuration */
+    mcp: MCPConfig;
+    /** Runtime configuration */
+    runtime: RuntimeConfig;
+    /** Embeddings configuration */
+    embeddings: EmbeddingsConfig;
+}
+/**
+ * Default init options - full V1 setup
+ */
+export declare const DEFAULT_INIT_OPTIONS: InitOptions;
+/**
+ * Minimal init options
+ */
+export declare const MINIMAL_INIT_OPTIONS: InitOptions;
+/**
+ * Full init options (everything enabled)
+ */
+export declare const FULL_INIT_OPTIONS: InitOptions;
+/**
+ * Init result
+ */
+export interface InitResult {
+    success: boolean;
+    platform: PlatformInfo;
+    created: {
+        directories: string[];
+        files: string[];
+    };
+    skipped: string[];
+    errors: string[];
+    summary: {
+        skillsCount: number;
+        commandsCount: number;
+        agentsCount: number;
+        hooksEnabled: number;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/packages/@monomind/cli/dist/src/init/types.js

@@ -0,0 +1,254 @@
+/**
+ * V1 Init System Types
+ * Configuration options for initializing Claude Code integration
+ */
+import os from 'os';
+import path from 'path';
+/**
+ * Detect current platform
+ */
+export function detectPlatform() {
+    const platform = os.platform();
+    const arch = os.arch();
+    const homeDir = os.homedir();
+    let osType;
+    let shell;
+    let configDir;
+    switch (platform) {
+        case 'win32':
+            osType = 'windows';
+            shell = process.env.PSModulePath ? 'powershell' : 'cmd';
+            configDir = process.env.APPDATA || path.join(homeDir, 'AppData', 'Roaming');
+            break;
+        case 'darwin':
+            osType = 'darwin';
+            shell = process.env.SHELL?.includes('zsh') ? 'zsh' : 'bash';
+            configDir = path.join(homeDir, 'Library', 'Application Support');
+            break;
+        default:
+            osType = 'linux';
+            shell = process.env.SHELL?.includes('zsh') ? 'zsh' : (process.env.SHELL?.includes('bash') ? 'bash' : 'sh');
+            configDir = process.env.XDG_CONFIG_HOME || path.join(homeDir, '.config');
+    }
+    return {
+        os: osType,
+        arch: arch,
+        nodeVersion: process.version,
+        shell,
+        homeDir,
+        configDir,
+    };
+}
+/**
+ * Default init options - full V1 setup
+ */
+export const DEFAULT_INIT_OPTIONS = {
+    targetDir: process.cwd(),
+    force: false,
+    interactive: true,
+    components: {
+        settings: true,
+        skills: true,
+        commands: true,
+        agents: true,
+        helpers: true,
+        statusline: true,
+        mcp: true,
+        runtime: true,
+        claudeMd: true,
+        graphify: true,
+    },
+    hooks: {
+        preToolUse: true,
+        postToolUse: true,
+        userPromptSubmit: true,
+        sessionStart: true,
+        stop: true,
+        preCompact: true,
+        notification: true,
+        teammateIdle: true,
+        taskCompleted: true,
+        timeout: 5000,
+        continueOnError: true,
+    },
+    skills: {
+        core: true,
+        agentdb: true,
+        github: true,
+        browser: true,
+        advanced: true,
+        all: true,
+    },
+    commands: {
+        core: true,
+        analysis: true,
+        automation: true,
+        github: true,
+        hooks: true,
+        monitoring: true,
+        optimization: true,
+        sparc: true,
+        all: true,
+    },
+    agents: {
+        core: true,
+        consensus: true,
+        github: true,
+        hiveMind: true,
+        sparc: true,
+        swarm: true,
+        optimization: true,
+        testing: true,
+        all: true,
+    },
+    statusline: {
+        enabled: true,
+        showProgress: true,
+        showSecurity: true,
+        showSwarm: true,
+        showHooks: true,
+        showPerformance: true,
+        refreshInterval: 5000,
+    },
+    mcp: {
+        monomind: true,
+        ruvSwarm: false,
+        graphify: false,
+        autoStart: false,
+        port: 3000,
+    },
+    runtime: {
+        topology: 'hierarchical-mesh',
+        maxAgents: 15,
+        memoryBackend: 'hybrid',
+        enableHNSW: true,
+        enableNeural: true,
+        enableLearningBridge: true,
+        enableMemoryGraph: true,
+        enableAgentScopes: true,
+    },
+    embeddings: {
+        enabled: true,
+        model: 'Xenova/all-MiniLM-L6-v2',
+        hyperbolic: true,
+        curvature: -1.0,
+        predownload: false, // Don't auto-download to speed up init
+        cacheSize: 256,
+        neuralSubstrate: true,
+    },
+};
+/**
+ * Minimal init options
+ */
+export const MINIMAL_INIT_OPTIONS = {
+    ...DEFAULT_INIT_OPTIONS,
+    components: {
+        settings: true,
+        skills: true,
+        commands: false,
+        agents: false,
+        helpers: false,
+        statusline: false,
+        mcp: true,
+        runtime: true,
+        claudeMd: true,
+        graphify: false,
+    },
+    hooks: {
+        ...DEFAULT_INIT_OPTIONS.hooks,
+        userPromptSubmit: false,
+        stop: false,
+        notification: false,
+        teammateIdle: false,
+        taskCompleted: false,
+    },
+    skills: {
+        core: true,
+        agentdb: false,
+        github: false,
+        browser: false,
+        advanced: false,
+        all: false,
+    },
+    agents: {
+        core: true,
+        consensus: false,
+        github: false,
+        hiveMind: false,
+        sparc: false,
+        swarm: false,
+        optimization: false,
+        testing: false,
+        all: false,
+    },
+    runtime: {
+        topology: 'mesh',
+        maxAgents: 5,
+        memoryBackend: 'memory',
+        enableHNSW: false,
+        enableNeural: false,
+        enableLearningBridge: false,
+        enableMemoryGraph: false,
+        enableAgentScopes: false,
+    },
+    embeddings: {
+        enabled: false,
+        model: 'Xenova/all-MiniLM-L6-v2',
+        hyperbolic: false,
+        curvature: -1.0,
+        predownload: false,
+        cacheSize: 128,
+        neuralSubstrate: false,
+    },
+};
+/**
+ * Full init options (everything enabled)
+ */
+export const FULL_INIT_OPTIONS = {
+    ...DEFAULT_INIT_OPTIONS,
+    components: {
+        settings: true,
+        skills: true,
+        commands: true,
+        agents: true,
+        helpers: true,
+        statusline: true,
+        mcp: true,
+        runtime: true,
+        claudeMd: true,
+        graphify: true,
+    },
+    skills: {
+        core: true,
+        agentdb: true,
+        github: true,
+        browser: true,
+        advanced: true,
+        all: true,
+    },
+    commands: {
+        ...DEFAULT_INIT_OPTIONS.commands,
+        all: true,
+    },
+    agents: {
+        ...DEFAULT_INIT_OPTIONS.agents,
+        all: true,
+    },
+    mcp: {
+        monomind: true,
+        ruvSwarm: true,
+        graphify: false,
+        autoStart: false,
+        port: 3000,
+    },
+    embeddings: {
+        enabled: true,
+        model: 'Xenova/all-MiniLM-L6-v2',
+        hyperbolic: true,
+        curvature: -1.0,
+        predownload: true, // Pre-download for full init
+        cacheSize: 256,
+        neuralSubstrate: true,
+    },
+};
+//# sourceMappingURL=types.js.map

package/packages/@monomind/cli/dist/src/interactive/interrupt.d.ts

@@ -0,0 +1,22 @@
+export type InterruptDecision = 'approved' | 'rejected' | 'edited';
+export interface InterruptPromptResult {
+    decision: InterruptDecision;
+    editedTask?: string;
+}
+export interface InterruptConfig {
+    interruptBefore: string[];
+    confidenceThreshold?: number;
+    autoApprove?: boolean;
+}
+export declare class InterruptRegistry {
+    private config;
+    load(config: InterruptConfig): void;
+    shouldInterrupt(agentSlug: string, confidence?: number): boolean;
+    getConfig(): InterruptConfig;
+}
+export declare const interruptRegistry: InterruptRegistry;
+export declare class InterruptController {
+    prompt(agentSlug: string, taskDescription: string, checkpointId: string): Promise<InterruptPromptResult>;
+}
+export declare const interruptController: InterruptController;
+//# sourceMappingURL=interrupt.d.ts.map

package/packages/@monomind/cli/dist/src/interactive/interrupt.js

@@ -0,0 +1,71 @@
+import * as readline from 'node:readline';
+export class InterruptRegistry {
+    config = { interruptBefore: [] };
+    load(config) {
+        this.config = config;
+    }
+    shouldInterrupt(agentSlug, confidence) {
+        if (this.config.autoApprove)
+            return false;
+        if (this.config.interruptBefore.includes(agentSlug))
+            return true;
+        if (confidence !== undefined &&
+            this.config.confidenceThreshold !== undefined &&
+            confidence < this.config.confidenceThreshold) {
+            return true;
+        }
+        return false;
+    }
+    getConfig() {
+        return { ...this.config };
+    }
+}
+export const interruptRegistry = new InterruptRegistry();
+export class InterruptController {
+    async prompt(agentSlug, taskDescription, checkpointId) {
+        // Non-TTY / CI mode
+        if (!process.stdin.isTTY || process.env.CI_AUTO_APPROVE === '1') {
+            return { decision: 'approved' };
+        }
+        const rl = readline.createInterface({
+            input: process.stdin,
+            output: process.stdout,
+        });
+        // Strip control characters from interpolated fields. ANSI escape sequences
+        // in any of these fields would let a malicious agent or LLM-generated task
+        // description redraw the screen and trick the user into approving an
+        // entirely different action than the one shown — defeating this very gate.
+        const safe = (s) => String(s ?? '').replace(/[\x00-\x1f\x7f-\x9f]/g, '?').slice(0, 500);
+        console.log('\n' + '='.repeat(60));
+        console.log('[MONOMIND] Interrupt — Human approval required');
+        console.log(`  Agent:      ${safe(agentSlug)}`);
+        console.log(`  Task:       ${safe(taskDescription)}`);
+        console.log(`  Checkpoint: ${safe(checkpointId)}`);
+        console.log('='.repeat(60));
+        console.log('  Options: [y] approve  [n] reject  [e] edit task');
+        return new Promise((resolve) => {
+            rl.question('  Choice (y/n/e): ', (answer) => {
+                rl.close();
+                const trimmed = answer.trim().toLowerCase();
+                if (trimmed === 'y' || trimmed === 'yes') {
+                    resolve({ decision: 'approved' });
+                }
+                else if (trimmed === 'e' || trimmed === 'edit') {
+                    const rl2 = readline.createInterface({
+                        input: process.stdin,
+                        output: process.stdout,
+                    });
+                    rl2.question('  New task description: ', (newTask) => {
+                        rl2.close();
+                        resolve({ decision: 'edited', editedTask: newTask });
+                    });
+                }
+                else {
+                    resolve({ decision: 'rejected' });
+                }
+            });
+        });
+    }
+}
+export const interruptController = new InterruptController();
+//# sourceMappingURL=interrupt.js.map

package/packages/@monomind/cli/dist/src/mcp/deprecation-injector.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Deprecation Injector (Task 31)
+ *
+ * Injects deprecation warnings into MCP tool responses when the
+ * invoked tool has been marked as deprecated in the ToolRegistry.
+ */
+import type { ToolRegistry } from './tool-registry.js';
+/**
+ * Injects deprecation metadata into MCP responses.
+ */
+export declare class DeprecationInjector {
+    private readonly registry;
+    constructor(registry: ToolRegistry);
+    /**
+     * If `toolName` is deprecated, augment the response with a warning.
+     *
+     * Returns the original response unmodified when the tool is not
+     * deprecated. When deprecated, adds `_deprecation` metadata.
+     *
+     * Warning format:
+     *   [DEPRECATED] Tool "<name>" is deprecated. <message>. Use "<successor>" instead.
+     */
+    inject(response: Record<string, unknown>, toolName: string): Record<string, unknown>;
+}
+//# sourceMappingURL=deprecation-injector.d.ts.map