@esotech/contextuate 2.0.0 → 2.1.0

package/dist/commands/remove.d.ts

@@ -0,0 +1,3 @@
+export declare function removeCommand(options: {
+    force?: boolean;
+}): Promise<void>;

package/dist/commands/run.d.ts

@@ -0,0 +1,6 @@
+export declare function runCommand(agentName: string, options: {
+    dryRun?: boolean;
+    isolation?: string;
+    goal?: string;
+    task?: string;
+}): Promise<void>;

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -9,6 +9,8 @@ const create_1 = require("./commands/create");
 const index_1 = require("./commands/index");
 const context_1 = require("./commands/context");
 const install_1 = require("./commands/install");
+const monitor_1 = require("./commands/monitor");
+const claude_1 = require("./commands/claude");
 const fs_1 = require("fs");
 const path_1 = require("path");
 const program = new commander_1.Command();
@@ -23,7 +25,7 @@ catch (error) {
 }
 program
     .name('contextuate')
-    .description('Standardized AI context framework for any project. Powered by Esotech.')
+    .description('Standardized AI context framework for any project.')
     .version(version);
 program
     .command('init [platforms...]')
@@ -68,6 +70,7 @@ const install = program
     .option('-a, --agents <names...>', 'Install specific agents (use "all" for all)')
     .option('-s, --standards <names...>', 'Install language standards (use "all" for all)')
     .option('-t, --tools <names...>', 'Install tools (use "all" for all)')
+    .option('-k, --skills <names...>', 'Install skills/slash commands (use "all" for all)')
     .option('--all', 'Install all available templates')
     .option('-l, --list', 'List available templates')
     .option('-f, --force', 'Overwrite existing files')
@@ -93,4 +96,113 @@ install
     .option('--all', 'Install all tools')
     .option('-f, --force', 'Overwrite existing files')
     .action(install_1.installToolsCommand);
+// Subcommand: install skills
+install
+    .command('skills [names...]')
+    .description('Install skill templates (slash commands like /orchestrate)')
+    .option('--all', 'Install all skills')
+    .option('-f, --force', 'Overwrite existing files')
+    .action(install_1.installSkillsCommand);
+// Monitor command with subcommands
+const monitor = program
+    .command('monitor')
+    .description('Real-time monitoring dashboard for Claude Code sessions')
+    .option('-p, --port <number>', 'HTTP server port')
+    .option('-w, --ws-port <number>', 'WebSocket server port')
+    .option('--no-open', 'Do not open browser automatically')
+    .option('-f, --foreground', 'Run server in foreground (blocking)')
+    .action((options) => (0, monitor_1.monitorStartCommand)({
+    port: options.port ? parseInt(options.port) : undefined,
+    wsPort: options.wsPort ? parseInt(options.wsPort) : undefined,
+    noOpen: options.open === false,
+    foreground: options.foreground,
+}));
+// Subcommand: monitor init
+monitor
+    .command('init')
+    .description('Initialize monitor configuration and install hooks')
+    .option('--global', 'Install hooks at user level (~/.claude/settings.json) - DEFAULT')
+    .option('--project', 'Install hooks at project level (.claude/settings.json)')
+    .action(monitor_1.monitorInitCommand);
+// Subcommand: monitor start (explicit)
+monitor
+    .command('start')
+    .description('Start the monitor server')
+    .option('-p, --port <number>', 'HTTP server port')
+    .option('-w, --ws-port <number>', 'WebSocket server port')
+    .option('--no-open', 'Do not open browser automatically')
+    .option('-f, --foreground', 'Run server in foreground (blocking)')
+    .action((options) => (0, monitor_1.monitorStartCommand)({
+    port: options.port ? parseInt(options.port) : undefined,
+    wsPort: options.wsPort ? parseInt(options.wsPort) : undefined,
+    noOpen: options.open === false,
+    foreground: options.foreground,
+}));
+// Subcommand: monitor stop
+monitor
+    .command('stop')
+    .description('Stop the monitor daemon')
+    .option('--all', 'Also stop any background processes')
+    .action((options) => (0, monitor_1.monitorStopCommand)({ all: options.all }));
+// Subcommand: monitor status
+monitor
+    .command('status')
+    .description('Show monitor server status')
+    .action(monitor_1.monitorStatusCommand);
+// Daemon command group (top-level)
+const daemon = program
+    .command('daemon')
+    .description('Manage the monitor daemon');
+daemon
+    .command('start')
+    .description('Start the event processing daemon')
+    .option('-d, --detach', 'Run in background (detached mode)')
+    .action(async (options) => {
+    await (0, monitor_1.monitorDaemonStartCommand)(options);
+});
+daemon
+    .command('stop')
+    .description('Stop the daemon')
+    .action(async () => {
+    await (0, monitor_1.monitorDaemonStopCommand)();
+});
+daemon
+    .command('status')
+    .description('Check daemon status')
+    .action(async () => {
+    await (0, monitor_1.monitorDaemonStatusCommand)();
+});
+daemon
+    .command('logs')
+    .description('View daemon logs')
+    .option('-f, --follow', 'Follow log output (like tail -f)')
+    .option('-n, --lines <n>', 'Number of lines to show', '50')
+    .action(async (options) => {
+    await (0, monitor_1.monitorDaemonLogsCommand)({
+        follow: options.follow,
+        lines: parseInt(options.lines)
+    });
+});
+// Claude wrapper command - wraps Claude CLI with PTY for monitor integration
+program
+    .command('claude')
+    .description('Run Claude Code with monitor integration (PTY wrapper)')
+    .argument('[args...]', 'Arguments to pass to Claude CLI')
+    .allowUnknownOption(true)
+    .action((args) => {
+    (0, claude_1.claudeCommand)(args);
+});
+// Wrapper command group - manage Claude wrapper sessions
+const wrapper = program
+    .command('wrapper')
+    .description('Manage Claude wrapper sessions');
+wrapper
+    .command('list')
+    .description('List active wrapper sessions')
+    .action(claude_1.listWrappersCommand);
+wrapper
+    .command('kill')
+    .argument('<wrapperId>', 'Wrapper ID to kill')
+    .description('Kill a wrapper session')
+    .action(claude_1.killWrapperCommand);
 program.parse();

package/dist/monitor/daemon/circuit-breaker.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Circuit Breaker
+ *
+ * Monitors Claude Code sessions for stagnation and takes corrective action.
+ * Inspired by Michael Nygard's "Release It!" circuit breaker pattern.
+ *
+ * States:
+ * - CLOSED: Normal operation, progress being made
+ * - HALF_OPEN: Warning state, monitoring for recovery
+ * - OPEN: Stagnation detected, intervention required
+ *
+ * Detection methods:
+ * - Time-based: No events for X seconds, no progress for Y seconds
+ * - Loop-based: N loops without file changes, M consecutive errors
+ *
+ * Actions:
+ * - Alert: Notify UI of state change
+ * - Inject prompt: Send "you're stuck" message to Claude
+ * - Kill: Terminate the session
+ * - Restart: Kill and spawn new session
+ */
+import type { WrapperManager } from './wrapper-manager.js';
+import type { MonitorEvent, CircuitBreakerConfig, SessionHealth, CircuitAlert } from '../../types/monitor.js';
+/**
+ * Callback for circuit alerts
+ */
+export type CircuitAlertCallback = (alert: CircuitAlert) => void;
+/**
+ * Circuit Breaker class
+ *
+ * Monitors session health and takes action when stagnation is detected.
+ */
+export declare class CircuitBreaker {
+    private config;
+    private wrapperManager;
+    private sessionHealth;
+    private cronJob;
+    private onAlert;
+    private pendingKills;
+    constructor(config: Partial<CircuitBreakerConfig>, wrapperManager: WrapperManager, onAlert: CircuitAlertCallback);
+    /**
+     * Start the cron-based health monitoring
+     */
+    start(): void;
+    /**
+     * Stop health monitoring
+     */
+    stop(): void;
+    /**
+     * Update configuration at runtime
+     */
+    updateConfig(config: Partial<CircuitBreakerConfig>): void;
+    /**
+     * Get current configuration
+     */
+    getConfig(): CircuitBreakerConfig;
+    /**
+     * Scheduled health check - runs on cron interval
+     */
+    private runHealthChecks;
+    /**
+     * Process an incoming event (called by EventProcessor)
+     */
+    processEvent(event: MonitorEvent, wrapperId: string | null): void;
+    /**
+     * Handle state transitions and take action
+     */
+    private transitionState;
+    /**
+     * Take intervention action
+     */
+    private takeAction;
+    /**
+     * Schedule a kill after the grace period
+     */
+    private scheduleKill;
+    /**
+     * Build a context-aware intervention prompt
+     */
+    private buildInterventionPrompt;
+    /**
+     * Kill wrapper and optionally restart
+     */
+    private killAndMaybeRestart;
+    /**
+     * Check if event indicates file modification progress
+     */
+    private isProgressEvent;
+    /**
+     * Get recommendation based on current health state
+     */
+    private getRecommendation;
+    /**
+     * Get or create health tracking for a session
+     */
+    private getOrCreateHealth;
+    /**
+     * Get health status for all sessions (for UI)
+     */
+    getAllHealth(): SessionHealth[];
+    /**
+     * Get health for a specific session
+     */
+    getSessionHealth(sessionId: string): SessionHealth | undefined;
+    /**
+     * Reset circuit for a session (manual intervention)
+     */
+    resetCircuit(sessionId: string): void;
+    /**
+     * Associate a wrapper with a session (called when correlation is detected)
+     */
+    associateWrapper(sessionId: string, wrapperId: string): void;
+    /**
+     * Remove health tracking for a session (on session end)
+     */
+    removeSession(sessionId: string): void;
+    /**
+     * Check if circuit breaker is enabled
+     */
+    isEnabled(): boolean;
+}