monty-autonomous-fullstack-dev-multillm 1.0.0

package/dist/utils/git-utils.js

@@ -0,0 +1,110 @@
+/**
+ * Enhanced Git Utilities
+ * Provides git operations, conflict detection, branch management, and change tracking.
+ */
+import { existsSync } from "fs";
+import { resolve } from "path";
+import { agentConfig } from "../config/agent-config.js";
+/**
+ * Check if git is initialized
+ */
+export function isGitInitialized() {
+    const root = agentConfig.paths.projectRoot;
+    return existsSync(resolve(root, ".git"));
+}
+/**
+ * Get git status summary
+ * Note: This provides hints - actual status requires running git commands
+ */
+export function getGitStatus() {
+    const root = agentConfig.paths.projectRoot;
+    const gitDir = resolve(root, ".git");
+    if (!existsSync(gitDir)) {
+        return {
+            hasChanges: false,
+            hasUncommittedChanges: false,
+            hasUntrackedFiles: false,
+            hasConflicts: false,
+            currentBranch: null,
+            aheadOfRemote: 0,
+            behindRemote: 0,
+            lastCommit: null,
+            lastCommitMessage: null,
+        };
+    }
+    // We can't actually run git commands here, so we provide a structure
+    // The agent should run: git status, git branch, git log, etc.
+    return {
+        hasChanges: true, // Unknown - agent should check
+        hasUncommittedChanges: true, // Unknown - agent should check
+        hasUntrackedFiles: true, // Unknown - agent should check
+        hasConflicts: false, // Check for .git/MERGE_HEAD, .git/CHERRY_PICK_HEAD, etc.
+        currentBranch: null, // Agent should run: git branch --show-current
+        aheadOfRemote: 0, // Agent should run: git rev-list --count @{u}..HEAD
+        behindRemote: 0, // Agent should run: git rev-list --count HEAD..@{u}
+        lastCommit: null, // Agent should run: git log -1 --format=%H
+        lastCommitMessage: null, // Agent should run: git log -1 --format=%s
+    };
+}
+/**
+ * Check for merge conflicts
+ */
+export function hasMergeConflicts() {
+    const root = agentConfig.paths.projectRoot;
+    const gitDir = resolve(root, ".git");
+    if (!existsSync(gitDir)) {
+        return false;
+    }
+    // Check for conflict markers
+    const conflictMarkers = [
+        resolve(gitDir, "MERGE_HEAD"),
+        resolve(gitDir, "CHERRY_PICK_HEAD"),
+        resolve(gitDir, "REBASE_HEAD"),
+    ];
+    return conflictMarkers.some(marker => existsSync(marker));
+}
+/**
+ * Generate git status summary for agent prompts
+ */
+export function generateGitSummary() {
+    const initialized = isGitInitialized();
+    const conflicts = hasMergeConflicts();
+    let summary = "\n## GIT STATUS\n\n";
+    if (!initialized) {
+        summary += "❌ Git not initialized\n";
+        summary += "   Recommendation: Run 'git init' to initialize repository\n";
+        return summary;
+    }
+    summary += "✅ Git repository initialized\n";
+    if (conflicts) {
+        summary += "🚨 Merge conflicts detected!\n";
+        summary += "   Check for conflict markers (<<<<<<, =======, >>>>>>)\n";
+        summary += "   Resolve conflicts before continuing\n";
+    }
+    summary += "\n💡 Git Commands to Run:\n";
+    summary += "   - git status (check for uncommitted changes)\n";
+    summary += "   - git branch --show-current (current branch)\n";
+    summary += "   - git log --oneline -10 (recent commits)\n";
+    summary += "   - git diff (see uncommitted changes)\n";
+    return summary;
+}
+/**
+ * Get recommended git workflow
+ */
+export function getGitWorkflow() {
+    return [
+        "Before starting work: git status",
+        "After completing a feature: git add -A && git commit -m '[agent] <description>'",
+        "Before ending session: Ensure all changes are committed",
+        "If conflicts occur: Resolve manually, then commit",
+        "Never force push to main/master branch",
+    ];
+}
+export default {
+    isGitInitialized,
+    getGitStatus,
+    hasMergeConflicts,
+    generateGitSummary,
+    getGitWorkflow,
+};
+//# sourceMappingURL=git-utils.js.map

package/dist/utils/git-utils.js.map

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

package/dist/utils/health-check.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Health Check Utilities
+ * Monitors system health, build status, and application state.
+ */
+/**
+ * Health check result
+ */
+export interface HealthCheckResult {
+    healthy: boolean;
+    checks: {
+        projectStructure: boolean;
+        dependencies: boolean;
+        build: boolean;
+        devServer: boolean;
+    };
+    issues: string[];
+    recommendations: string[];
+}
+/**
+ * Run comprehensive health check
+ */
+export declare function runHealthCheck(): HealthCheckResult;
+/**
+ * Generate health check summary
+ */
+export declare function generateHealthSummary(): string;
+declare const _default: {
+    runHealthCheck: typeof runHealthCheck;
+    generateHealthSummary: typeof generateHealthSummary;
+};
+export default _default;
+//# sourceMappingURL=health-check.d.ts.map

package/dist/utils/health-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-check.d.ts","sourceRoot":"","sources":["../../src/utils/health-check.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE;QACN,gBAAgB,EAAE,OAAO,CAAC;QAC1B,YAAY,EAAE,OAAO,CAAC;QACtB,KAAK,EAAE,OAAO,CAAC;QACf,SAAS,EAAE,OAAO,CAAC;KACpB,CAAC;IACF,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAyFD;;GAEG;AACH,wBAAgB,cAAc,IAAI,iBAAiB,CAwClD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CA+B9C;;;;;AAED,wBAGE"}

package/dist/utils/health-check.js

@@ -0,0 +1,152 @@
+/**
+ * Health Check Utilities
+ * Monitors system health, build status, and application state.
+ */
+import { existsSync } from "fs";
+import { resolve } from "path";
+import { agentConfig } from "../config/agent-config.js";
+/**
+ * Check project structure health
+ */
+function checkProjectStructure() {
+    const root = agentConfig.paths.projectRoot;
+    const issues = [];
+    // Check for essential directories
+    const essentialDirs = ["src", "public", "node_modules"];
+    const optionalDirs = ["components", "utils", "hooks", "pages", "app"];
+    for (const dir of essentialDirs) {
+        if (!existsSync(resolve(root, dir))) {
+            if (dir !== "node_modules") {
+                issues.push(`Missing directory: ${dir}`);
+            }
+        }
+    }
+    // Check for package.json
+    if (!existsSync(resolve(root, "package.json"))) {
+        issues.push("Missing package.json");
+    }
+    return {
+        healthy: issues.length === 0,
+        issues,
+    };
+}
+/**
+ * Check if dependencies are installed
+ */
+function checkDependencies() {
+    const root = agentConfig.paths.projectRoot;
+    const issues = [];
+    if (!existsSync(resolve(root, "node_modules"))) {
+        issues.push("node_modules not found - run 'npm install'");
+    }
+    if (!existsSync(resolve(root, "package-lock.json")) &&
+        !existsSync(resolve(root, "yarn.lock")) &&
+        !existsSync(resolve(root, "pnpm-lock.yaml"))) {
+        issues.push("No lock file found - dependencies may not be installed");
+    }
+    return {
+        healthy: issues.length === 0,
+        issues,
+    };
+}
+/**
+ * Check build status (heuristic)
+ */
+function checkBuild() {
+    const root = agentConfig.paths.projectRoot;
+    const issues = [];
+    // Check for build output directories
+    const buildDirs = ["dist", "build", ".next", "out"];
+    const hasBuildDir = buildDirs.some(dir => existsSync(resolve(root, dir)));
+    // This is just a heuristic - actual build status requires running build
+    if (!hasBuildDir) {
+        issues.push("No build output directory found - may need to run build");
+    }
+    return {
+        healthy: issues.length === 0,
+        issues,
+    };
+}
+/**
+ * Check dev server status (heuristic)
+ */
+function checkDevServer() {
+    // We can't actually check if dev server is running without making HTTP requests
+    // This is a placeholder - the agent should check by navigating to localhost
+    return {
+        healthy: true, // Unknown - agent should verify
+        issues: [],
+    };
+}
+/**
+ * Run comprehensive health check
+ */
+export function runHealthCheck() {
+    const structure = checkProjectStructure();
+    const dependencies = checkDependencies();
+    const build = checkBuild();
+    const devServer = checkDevServer();
+    const allIssues = [
+        ...structure.issues,
+        ...dependencies.issues,
+        ...build.issues,
+        ...devServer.issues,
+    ];
+    const recommendations = [];
+    if (dependencies.issues.length > 0) {
+        recommendations.push("Run 'npm install' to install dependencies");
+    }
+    if (build.issues.length > 0) {
+        recommendations.push("Run 'npm run build' to create build output");
+    }
+    if (structure.issues.length > 0) {
+        recommendations.push("Check project structure - some directories may be missing");
+    }
+    const healthy = allIssues.length === 0;
+    return {
+        healthy,
+        checks: {
+            projectStructure: structure.healthy,
+            dependencies: dependencies.healthy,
+            build: build.healthy,
+            devServer: devServer.healthy,
+        },
+        issues: allIssues,
+        recommendations,
+    };
+}
+/**
+ * Generate health check summary
+ */
+export function generateHealthSummary() {
+    const health = runHealthCheck();
+    let summary = "\n## SYSTEM HEALTH CHECK\n\n";
+    if (health.healthy) {
+        summary += "✅ System is healthy\n";
+    }
+    else {
+        summary += "⚠️ System health issues detected\n";
+    }
+    summary += `Project Structure: ${health.checks.projectStructure ? "✅" : "❌"}\n`;
+    summary += `Dependencies: ${health.checks.dependencies ? "✅" : "❌"}\n`;
+    summary += `Build: ${health.checks.build ? "✅" : "⚠️"}\n`;
+    summary += `Dev Server: ${health.checks.devServer ? "✅" : "⚠️"}\n`;
+    if (health.issues.length > 0) {
+        summary += "\n🚨 Issues:\n";
+        health.issues.forEach(issue => {
+            summary += `   - ${issue}\n`;
+        });
+    }
+    if (health.recommendations.length > 0) {
+        summary += "\n💡 Recommendations:\n";
+        health.recommendations.forEach(rec => {
+            summary += `   - ${rec}\n`;
+        });
+    }
+    return summary;
+}
+export default {
+    runHealthCheck,
+    generateHealthSummary,
+};
+//# sourceMappingURL=health-check.js.map

package/dist/utils/health-check.js.map

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

package/dist/utils/hooks-manager.d.ts

@@ -0,0 +1,154 @@
+/**
+ * Hooks Manager
+ * Implements lifecycle hooks for the Claude Agent SDK.
+ * Hooks allow customization of agent behavior at key points.
+ *
+ * Copyright (c) 2025 Dobeu Tech Solutions LLC
+ * Licensed under CC BY-NC 4.0
+ */
+/**
+ * Hook event types
+ */
+export type HookEvent = 'session.start' | 'session.end' | 'query.before' | 'query.after' | 'tool.before' | 'tool.after' | 'file.read' | 'file.write' | 'file.edit' | 'error.caught' | 'feature.start' | 'feature.complete' | 'feature.fail' | 'checkpoint.create' | 'checkpoint.restore' | 'git.commit' | 'browser.navigate' | 'browser.action';
+/**
+ * Hook context passed to hook handlers
+ */
+export interface HookContext {
+    event: HookEvent;
+    timestamp: number;
+    sessionId?: string;
+    featureId?: string;
+    data?: Record<string, unknown>;
+}
+/**
+ * Hook handler function type
+ */
+export type HookHandler = (context: HookContext) => Promise<HookResult> | HookResult;
+/**
+ * Hook result that can modify agent behavior
+ */
+export interface HookResult {
+    continue: boolean;
+    modified?: Record<string, unknown>;
+    message?: string;
+    warnings?: string[];
+    block?: {
+        reason: string;
+        suggestion?: string;
+    };
+}
+/**
+ * Security hook configuration
+ */
+export interface SecurityHookConfig {
+    blockSensitiveFiles: boolean;
+    sensitivePatterns: RegExp[];
+    blockDangerousCommands: boolean;
+    dangerousCommandPatterns: RegExp[];
+    requireConfirmation: boolean;
+    confirmationPatterns: RegExp[];
+    auditAllActions: boolean;
+}
+/**
+ * Default security hook configuration
+ */
+export declare const DEFAULT_SECURITY_CONFIG: SecurityHookConfig;
+/**
+ * Hooks Manager class
+ */
+export declare class HooksManager {
+    private hooks;
+    private securityConfig;
+    private hookIdCounter;
+    private auditLog;
+    private enabled;
+    constructor(securityConfig?: Partial<SecurityHookConfig>);
+    /**
+     * Check if hooks are enabled
+     */
+    isEnabled(): boolean;
+    /**
+     * Enable or disable hooks
+     */
+    setEnabled(enabled: boolean): void;
+    /**
+     * Generate unique hook ID
+     */
+    private generateId;
+    /**
+     * Register a hook
+     */
+    register(event: HookEvent, handler: HookHandler, options?: {
+        name?: string;
+        description?: string;
+        priority?: number;
+        enabled?: boolean;
+    }): string;
+    /**
+     * Unregister a hook
+     */
+    unregister(hookId: string): boolean;
+    /**
+     * Enable a hook
+     */
+    enable(hookId: string): boolean;
+    /**
+     * Disable a hook
+     */
+    disable(hookId: string): boolean;
+    /**
+     * Trigger hooks for an event
+     */
+    trigger(event: HookEvent, data?: Record<string, unknown>): Promise<HookResult>;
+    /**
+     * Register default security hooks
+     */
+    private registerSecurityHooks;
+    /**
+     * Get audit log
+     */
+    getAuditLog(): HookContext[];
+    /**
+     * Clear audit log
+     */
+    clearAuditLog(): void;
+    /**
+     * Get all registered hooks
+     */
+    listHooks(): Array<{
+        event: HookEvent;
+        name: string;
+        enabled: boolean;
+        priority: number;
+    }>;
+    /**
+     * Get hooks summary
+     */
+    getSummary(): string;
+    /**
+     * Update security configuration
+     */
+    updateSecurityConfig(config: Partial<SecurityHookConfig>): void;
+    /**
+     * Get current security configuration
+     */
+    getSecurityConfig(): SecurityHookConfig;
+}
+/**
+ * Create a logging hook
+ */
+export declare function createLoggingHook(logFn: (context: HookContext) => void): HookHandler;
+/**
+ * Create a validation hook
+ */
+export declare function createValidationHook(validate: (context: HookContext) => boolean | string): HookHandler;
+/**
+ * Create a transformation hook
+ */
+export declare function createTransformationHook(transform: (context: HookContext) => Record<string, unknown>): HookHandler;
+/**
+ * Create a hooks manager instance
+ */
+export declare function createHooksManager(securityConfig?: Partial<SecurityHookConfig>): HooksManager;
+export default HooksManager;
+//# sourceMappingURL=hooks-manager.d.ts.map

package/dist/utils/hooks-manager.d.ts.map

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