@esotech/contextuate 2.0.0 → 2.1.1

package/dist/types/monitor.js

@@ -0,0 +1,75 @@
+"use strict";
+/**
+ * Contextuate Monitor - Type Definitions
+ *
+ * Shared TypeScript types for the monitor feature.
+ * Used by both server and client components.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_CIRCUIT_BREAKER_CONFIG = exports.DEFAULT_CONFIG = void 0;
+exports.getDefaultMonitorPaths = getDefaultMonitorPaths;
+/**
+ * Default configuration values
+ */
+exports.DEFAULT_CONFIG = {
+    mode: 'local',
+    server: {
+        host: '0.0.0.0',
+        port: 3847,
+        wsPort: 3848,
+    },
+    redis: {
+        host: 'localhost',
+        port: 6379,
+        password: null,
+        channel: 'contextuate:events',
+    },
+    persistence: {
+        enabled: true,
+        type: 'file',
+    },
+    socketPath: '/tmp/contextuate-monitor.sock',
+};
+/**
+ * Get default monitor paths
+ *
+ * @returns MonitorPaths with all default directory and file paths
+ */
+function getDefaultMonitorPaths() {
+    // Note: We use lazy imports to avoid circular dependencies
+    // eslint-disable-next-line @typescript-eslint/no-var-requires
+    const path = require('path');
+    // eslint-disable-next-line @typescript-eslint/no-var-requires
+    const os = require('os');
+    const baseDir = path.join(os.homedir(), '.contextuate', 'monitor');
+    return {
+        baseDir,
+        configFile: path.join(baseDir, 'config.json'),
+        rawDir: path.join(baseDir, 'raw'),
+        processedDir: path.join(baseDir, 'processed'),
+        sessionsDir: path.join(baseDir, 'sessions'),
+        hooksDir: path.join(baseDir, 'hooks'),
+        daemonPidFile: path.join(baseDir, 'daemon.pid'),
+        daemonLogFile: path.join(baseDir, 'daemon.log'),
+        daemonStateFile: path.join(baseDir, 'daemon.state.json'),
+        serverPidFile: path.join(baseDir, 'server.pid'),
+        serverLogFile: path.join(baseDir, 'server.log'),
+    };
+}
+/**
+ * Default circuit breaker configuration
+ */
+exports.DEFAULT_CIRCUIT_BREAKER_CONFIG = {
+    enabled: true,
+    noEventTimeout: 300,
+    noProgressTimeout: 600,
+    maxSessionDuration: 7200,
+    noProgressLoops: 3,
+    sameErrorThreshold: 5,
+    healthCheckInterval: '*/30 * * * * *',
+    autoInjectPrompt: true,
+    autoKill: false,
+    autoRestart: false,
+    gracePeriodMs: 60000,
+    stuckPrompt: 'You appear to be stuck. Please try a different approach or describe what is blocking you.',
+};

package/dist/utils/git.d.ts

@@ -0,0 +1,9 @@
+export declare class GitManager {
+    private cwd;
+    constructor(cwd: string);
+    isGitRepo(): Promise<boolean>;
+    getCurrentBranch(): Promise<string>;
+    createWorktree(agentName: string, sessionId: string): Promise<string>;
+    removeWorktree(worktreePath: string, deleteBranch?: boolean): Promise<void>;
+    commitChanges(worktreePath: string, message: string): Promise<void>;
+}

package/dist/utils/tokens.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Estimates the number of tokens in a string.
+ * Uses a simple heuristic: ~4 characters per token for English text/code.
+ */
+export declare function estimateTokens(text: string): number;
+/**
+ * Generates a compact file tree representation of a directory.
+ * Respects .gitignore via a simple filter (can be enhanced).
+ */
+export declare function generateFileTree(dir: string, maxDepth?: number): Promise<string>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@esotech/contextuate",
-  "version": "2.0.0",
+  "version": "2.1.1",
   "description": "**Standardized AI Context for Software Projects**",
   "main": "dist/index.js",
   "bin": {
@@ -11,8 +11,10 @@
   },
   "scripts": {
     "test": "echo \"Error: no test specified\" && exit 1",
-    "build": "tsc && mkdir -p dist/templates && cp -r src/templates/* dist/templates/",
-    "prepublishOnly": "npm run build"
+    "build": "tsc && rm -rf dist/templates && mkdir -p dist/templates && cp -r src/templates/* dist/templates/ && mkdir -p dist/monitor/hooks && cp src/monitor/hooks/emit-event.js dist/monitor/hooks/ && chmod +x dist/index.js dist/monitor/hooks/emit-event.js dist/monitor/daemon/cli.js dist/monitor/server/cli.js",
+    "build:monitor-ui": "cd src/monitor/ui && npm install && npm run build",
+    "build:all": "npm run build && npm run build:monitor-ui",
+    "prepublishOnly": "npm run build:all"
   },
   "repository": {
     "type": "git",
@@ -31,7 +33,8 @@
     "copilot",
     "cursor",
     "anthropic",
-    "claude"
+    "claude",
+    "monitor"
   ],
   "author": "Alexander David Conroy <alex@esotech.com> (https://github.com/geilt)",
   "license": "MIT",
@@ -47,13 +50,23 @@
     "@types/fs-extra": "^11.0.4",
     "@types/inquirer": "^9.0.9",
     "@types/node": "^24.10.1",
+    "@types/node-cron": "^3.0.11",
+    "@types/ws": "^8.5.13",
     "typescript": "^5.9.3"
   },
   "dependencies": {
+    "@fastify/cors": "^10.0.1",
+    "@fastify/static": "^8.0.3",
     "chalk": "^5.6.2",
     "commander": "^14.0.2",
+    "fastify": "^5.2.0",
     "fs-extra": "^11.3.2",
     "gray-matter": "^4.0.3",
-    "inquirer": "^13.0.1"
+    "inquirer": "^13.0.1",
+    "ioredis": "^5.4.2",
+    "node-cron": "^4.2.1",
+    "node-pty": "^1.2.0-beta.2",
+    "uuid": "^11.0.3",
+    "ws": "^8.18.0"
   }
 }

package/dist/templates/version.json

@@ -1,8 +0,0 @@
-{
-	"name": "contextuate",
-	"version": "1.0.0",
-	"description": "AI Context Framework - Standardized documentation for AI coding assistants",
-	"repository": "https://github.com/esotech/contextuate",
-	"installed": null,
-	"updated": null
-}