@task-shepherd/agent 1.0.5 → 1.0.7

package/shared/dist/workspace/constants.d.ts

@@ -0,0 +1,148 @@
+/**
+ * Workspace Configuration Constants
+ *
+ * Defines constants and default values for workspace configuration.
+ */
+import type { WorkspaceTemplate, AICapabilities, WorkspacePaths, SecurityConfig, DevelopmentConfig } from './types.js';
+/**
+ * Configuration file constants
+ */
+export declare const WORKSPACE_CONFIG_VERSION = "1.0.0";
+export declare const WORKSPACE_CONFIG_FILE = ".tasqhub-workspace.json";
+export declare const WORKSPACE_LOCK_FILE = ".tasqhub-workspace.lock";
+export declare const WORKSPACE_CACHE_DIR = ".tasqhub-cache";
+/**
+ * Default AI capabilities
+ */
+export declare const DEFAULT_AI_CAPABILITIES: AICapabilities;
+/**
+ * Default workspace paths
+ */
+export declare const DEFAULT_WORKSPACE_PATHS: WorkspacePaths;
+/**
+ * Default security configuration
+ */
+export declare const DEFAULT_SECURITY_CONFIG: SecurityConfig;
+/**
+ * Default development configuration
+ */
+export declare const DEFAULT_DEVELOPMENT_CONFIG: DevelopmentConfig;
+/**
+ * Common service port ranges
+ */
+export declare const COMMON_SERVICE_PORTS: {
+    development: {
+        frontend: number[];
+        backend: number[];
+        database: number[];
+        cache: number[];
+        queue: number[];
+        monitoring: number[];
+    };
+    production: {
+        http: number[];
+        https: number[];
+        database: number[];
+        cache: number[];
+        queue: number[];
+    };
+};
+/**
+ * Workspace templates
+ */
+export declare const WORKSPACE_TEMPLATES: Record<string, WorkspaceTemplate>;
+/**
+ * Service discovery patterns
+ */
+export declare const SERVICE_DISCOVERY_PATTERNS: {
+    files: string[];
+    directories: string[];
+    portRanges: {
+        start: number;
+        end: number;
+    }[];
+};
+/**
+ * Common workspace validation rules
+ */
+export declare const COMMON_VALIDATION_RULES: {
+    requiredServices: {
+        'full-stack': string[];
+        'api-only': string[];
+        'frontend-only': string[];
+        'ai-enhanced': string[];
+    };
+    portConflicts: {
+        severity: "warning";
+        exclusions: string[];
+    };
+    circularDependencies: {
+        severity: "error";
+        allowedPatterns: never[];
+    };
+};
+/**
+ * Environment-specific defaults
+ */
+export declare const ENVIRONMENT_DEFAULTS: {
+    development: {
+        security: {
+            filePermissions: {
+                execute: boolean;
+                read: boolean;
+                write: boolean;
+                restricted: string[];
+                readOnly: string[];
+            };
+            networkPermissions: {
+                http: boolean;
+                https: boolean;
+                allowedDomains: string[];
+                blockedDomains: string[];
+                allowedPorts?: number[];
+            };
+            apiAccess?: {
+                allowedEndpoints: string[];
+                rateLimits?: Record<string, number>;
+            };
+        };
+    };
+    production: {
+        security: {
+            filePermissions: {
+                write: boolean;
+                execute: boolean;
+                read: boolean;
+                restricted: string[];
+                readOnly: string[];
+            };
+            networkPermissions: {
+                allowedDomains: never[];
+                http: boolean;
+                https: boolean;
+                blockedDomains: string[];
+                allowedPorts?: number[];
+            };
+            apiAccess?: {
+                allowedEndpoints: string[];
+                rateLimits?: Record<string, number>;
+            };
+        };
+    };
+    test: {
+        paths: {
+            excluded: string[];
+            root: string;
+            src: string[];
+            tests: string[];
+            docs: string[];
+            config: string[];
+            build: string[];
+            temp: string[];
+            logs: string[];
+            cache: string[];
+            assets: string[];
+            servicePaths?: Record<string, string[]>;
+        };
+    };
+};

package/shared/dist/workspace/constants.js

@@ -0,0 +1,432 @@
+/**
+ * Workspace Configuration Constants
+ *
+ * Defines constants and default values for workspace configuration.
+ */
+/**
+ * Configuration file constants
+ */
+export const WORKSPACE_CONFIG_VERSION = '1.0.0';
+export const WORKSPACE_CONFIG_FILE = '.tasqhub-workspace.json';
+export const WORKSPACE_LOCK_FILE = '.tasqhub-workspace.lock';
+export const WORKSPACE_CACHE_DIR = '.tasqhub-cache';
+/**
+ * Default AI capabilities
+ */
+export const DEFAULT_AI_CAPABILITIES = {
+    maxConcurrentOperations: 3,
+    supportedAnalysisTypes: [
+        'project_review',
+        'development_plan',
+        'code_analysis',
+        'dependency_analysis',
+        'security_scan'
+    ],
+    isolationLevel: 'moderate'
+};
+/**
+ * Default workspace paths
+ */
+export const DEFAULT_WORKSPACE_PATHS = {
+    root: '.',
+    src: ['src', 'lib'],
+    tests: ['test', 'tests', '__tests__', 'spec'],
+    docs: ['docs', 'documentation'],
+    config: ['config', 'configs', '.config'],
+    build: ['build', 'dist', 'out'],
+    temp: ['tmp', 'temp', '.tmp'],
+    logs: ['logs', '.logs'],
+    cache: ['cache', '.cache', 'node_modules/.cache'],
+    assets: ['assets', 'public', 'static'],
+    excluded: [
+        'node_modules',
+        '.git',
+        '.env',
+        '.env.local',
+        '.env.production',
+        '.DS_Store',
+        'Thumbs.db',
+        '*.log',
+        '*.pid',
+        '*.seed',
+        '*.pid.lock'
+    ]
+};
+/**
+ * Default security configuration
+ */
+export const DEFAULT_SECURITY_CONFIG = {
+    filePermissions: {
+        read: true,
+        write: true,
+        execute: false,
+        restricted: [
+            '.env',
+            '.env.local',
+            '.env.production',
+            '*.key',
+            '*.pem',
+            '*.p12',
+            '*.pfx',
+            'id_rsa',
+            'id_ed25519'
+        ],
+        readOnly: [
+            'package-lock.json',
+            'yarn.lock',
+            'pnpm-lock.yaml',
+            'Cargo.lock',
+            'go.sum'
+        ]
+    },
+    networkPermissions: {
+        http: true,
+        https: true,
+        allowedDomains: [
+            'api.anthropic.com',
+            'api.openai.com',
+            'api.github.com',
+            'registry.npmjs.org',
+            'pypi.org',
+            'crates.io',
+            'pkg.go.dev'
+        ],
+        blockedDomains: []
+    }
+};
+/**
+ * Default development configuration
+ */
+export const DEFAULT_DEVELOPMENT_CONFIG = {
+    packageManager: 'npm',
+    scripts: {
+        start: 'npm start',
+        build: 'npm run build',
+        test: 'npm test',
+        lint: 'npm run lint',
+        typeCheck: 'npm run type-check'
+    }
+};
+/**
+ * Common service port ranges
+ */
+export const COMMON_SERVICE_PORTS = {
+    development: {
+        frontend: [3000, 3001, 3002, 5173, 8080],
+        backend: [4000, 4001, 4002, 8000, 8001],
+        database: [5432, 5433, 3306, 27017],
+        cache: [6379, 6380, 11211],
+        queue: [5672, 15672, 9092],
+        monitoring: [9090, 3001, 16686]
+    },
+    production: {
+        http: [80, 8080],
+        https: [443, 8443],
+        database: [5432, 3306, 27017],
+        cache: [6379, 11211],
+        queue: [5672, 9092]
+    }
+};
+/**
+ * Workspace templates
+ */
+export const WORKSPACE_TEMPLATES = {
+    minimal: {
+        id: 'minimal',
+        name: 'Minimal Workspace',
+        description: 'Basic workspace configuration with essential settings',
+        patterns: ['monorepo', 'multi-repo'],
+        config: {
+            workspace: {
+                pattern: 'monorepo',
+                version: WORKSPACE_CONFIG_VERSION
+            },
+            services: {},
+            ai: {
+                models: {
+                    claude: {
+                        provider: 'claude',
+                        model: 'claude-3-5-sonnet-20241022',
+                        apiKey: '${CLAUDE_API_KEY}'
+                    }
+                },
+                defaultModel: 'claude',
+                capabilities: DEFAULT_AI_CAPABILITIES
+            },
+            paths: DEFAULT_WORKSPACE_PATHS,
+            development: DEFAULT_DEVELOPMENT_CONFIG,
+            security: DEFAULT_SECURITY_CONFIG
+        },
+        requiredServices: [],
+        optionalServices: ['backend', 'frontend', 'agent']
+    },
+    'full-stack': {
+        id: 'full-stack',
+        name: 'Full-Stack Application',
+        description: 'Complete full-stack workspace with frontend, backend, and database',
+        patterns: ['monorepo'],
+        config: {
+            workspace: {
+                pattern: 'monorepo',
+                version: WORKSPACE_CONFIG_VERSION
+            },
+            services: {
+                frontend: {
+                    id: 'frontend',
+                    name: 'Frontend Application',
+                    url: 'http://localhost:3000',
+                    port: 3000,
+                    protocol: 'http',
+                    technology: 'react',
+                    environment: 'development',
+                    dependencies: [
+                        { service: 'backend', type: 'required' }
+                    ]
+                },
+                backend: {
+                    id: 'backend',
+                    name: 'Backend API',
+                    url: 'http://localhost:4000',
+                    port: 4000,
+                    protocol: 'http',
+                    technology: 'nodejs',
+                    environment: 'development',
+                    dependencies: [
+                        { service: 'database', type: 'required' }
+                    ]
+                },
+                database: {
+                    id: 'database',
+                    name: 'PostgreSQL Database',
+                    url: 'postgresql://localhost:5432',
+                    port: 5432,
+                    protocol: 'postgresql',
+                    technology: 'database',
+                    environment: 'development',
+                    dependencies: []
+                }
+            },
+            ai: {
+                models: {
+                    claude: {
+                        provider: 'claude',
+                        model: 'claude-3-5-sonnet-20241022',
+                        apiKey: '${CLAUDE_API_KEY}'
+                    }
+                },
+                defaultModel: 'claude',
+                capabilities: DEFAULT_AI_CAPABILITIES
+            },
+            paths: DEFAULT_WORKSPACE_PATHS,
+            development: DEFAULT_DEVELOPMENT_CONFIG,
+            security: DEFAULT_SECURITY_CONFIG
+        },
+        requiredServices: ['frontend', 'backend', 'database'],
+        optionalServices: ['cache', 'queue', 'agent']
+    },
+    'ai-enhanced': {
+        id: 'ai-enhanced',
+        name: 'AI-Enhanced Development',
+        description: 'Workspace optimized for AI-assisted development workflows',
+        patterns: ['monorepo', 'multi-repo'],
+        config: {
+            workspace: {
+                pattern: 'monorepo',
+                version: WORKSPACE_CONFIG_VERSION
+            },
+            services: {
+                'agent': {
+                    id: 'agent',
+                    name: 'AI Agent Service',
+                    url: 'http://localhost:8547',
+                    port: 8547,
+                    protocol: 'http',
+                    technology: 'nodejs',
+                    environment: 'development',
+                    dependencies: []
+                }
+            },
+            ai: {
+                models: {
+                    claude: {
+                        provider: 'claude',
+                        model: 'claude-3-5-sonnet-20241022',
+                        apiKey: '${CLAUDE_API_KEY}'
+                    },
+                    openai: {
+                        provider: 'openai',
+                        model: 'gpt-4',
+                        apiKey: '${OPENAI_API_KEY}'
+                    }
+                },
+                defaultModel: 'claude',
+                capabilities: {
+                    ...DEFAULT_AI_CAPABILITIES,
+                    maxConcurrentOperations: 5,
+                    supportedAnalysisTypes: [
+                        ...DEFAULT_AI_CAPABILITIES.supportedAnalysisTypes,
+                        'code_generation',
+                        'test_generation',
+                        'documentation_generation',
+                        'refactoring_suggestions'
+                    ]
+                }
+            },
+            paths: DEFAULT_WORKSPACE_PATHS,
+            development: DEFAULT_DEVELOPMENT_CONFIG,
+            security: DEFAULT_SECURITY_CONFIG
+        },
+        requiredServices: ['agent'],
+        optionalServices: ['frontend', 'backend', 'database']
+    },
+    microservices: {
+        id: 'microservices',
+        name: 'Microservices Architecture',
+        description: 'Multi-repository workspace for microservices architecture',
+        patterns: ['multi-repo', 'hybrid'],
+        config: {
+            workspace: {
+                pattern: 'multi-repo',
+                version: WORKSPACE_CONFIG_VERSION
+            },
+            services: {},
+            repositories: {
+                'api-gateway': {
+                    id: 'api-gateway',
+                    name: 'API Gateway',
+                    url: 'https://github.com/org/api-gateway.git',
+                    path: './services/api-gateway',
+                    branch: 'main',
+                    type: 'service',
+                    services: ['api-gateway']
+                },
+                'user-service': {
+                    id: 'user-service',
+                    name: 'User Service',
+                    url: 'https://github.com/org/user-service.git',
+                    path: './services/user-service',
+                    branch: 'main',
+                    type: 'service',
+                    services: ['user-service']
+                },
+                'shared-lib': {
+                    id: 'shared-lib',
+                    name: 'Shared Library',
+                    url: 'https://github.com/org/shared-lib.git',
+                    path: './shared',
+                    branch: 'main',
+                    type: 'library',
+                    services: []
+                }
+            },
+            ai: {
+                models: {
+                    claude: {
+                        provider: 'claude',
+                        model: 'claude-3-5-sonnet-20241022',
+                        apiKey: '${CLAUDE_API_KEY}'
+                    }
+                },
+                defaultModel: 'claude',
+                capabilities: DEFAULT_AI_CAPABILITIES
+            },
+            paths: DEFAULT_WORKSPACE_PATHS,
+            development: DEFAULT_DEVELOPMENT_CONFIG,
+            security: DEFAULT_SECURITY_CONFIG
+        },
+        requiredServices: [],
+        optionalServices: ['api-gateway', 'user-service', 'product-service', 'order-service']
+    }
+};
+/**
+ * Service discovery patterns
+ */
+export const SERVICE_DISCOVERY_PATTERNS = {
+    files: [
+        'package.json',
+        'Dockerfile',
+        'docker-compose.yml',
+        'docker-compose.yaml',
+        'Cargo.toml',
+        'go.mod',
+        'pom.xml',
+        'build.gradle',
+        'requirements.txt',
+        'pyproject.toml'
+    ],
+    directories: [
+        'src',
+        'app',
+        'services',
+        'packages',
+        'apps',
+        'microservices',
+        'lambda',
+        'functions'
+    ],
+    portRanges: [
+        { start: 3000, end: 3010 }, // Frontend development servers
+        { start: 4000, end: 4010 }, // Backend API servers
+        { start: 5000, end: 5010 }, // Additional services
+        { start: 8000, end: 8090 } // Common web servers
+    ]
+};
+/**
+ * Common workspace validation rules
+ */
+export const COMMON_VALIDATION_RULES = {
+    requiredServices: {
+        'full-stack': ['frontend', 'backend', 'database'],
+        'api-only': ['backend', 'database'],
+        'frontend-only': ['frontend'],
+        'ai-enhanced': ['agent']
+    },
+    portConflicts: {
+        severity: 'warning',
+        exclusions: ['database', 'cache'] // These can share ports in different environments
+    },
+    circularDependencies: {
+        severity: 'error',
+        allowedPatterns: [] // No circular dependencies allowed by default
+    }
+};
+/**
+ * Environment-specific defaults
+ */
+export const ENVIRONMENT_DEFAULTS = {
+    development: {
+        security: {
+            ...DEFAULT_SECURITY_CONFIG,
+            filePermissions: {
+                ...DEFAULT_SECURITY_CONFIG.filePermissions,
+                execute: true // Allow execution in development
+            }
+        }
+    },
+    production: {
+        security: {
+            ...DEFAULT_SECURITY_CONFIG,
+            filePermissions: {
+                ...DEFAULT_SECURITY_CONFIG.filePermissions,
+                write: false, // Read-only in production
+                execute: false
+            },
+            networkPermissions: {
+                ...DEFAULT_SECURITY_CONFIG.networkPermissions,
+                allowedDomains: [] // Restrict domains in production
+            }
+        }
+    },
+    test: {
+        paths: {
+            ...DEFAULT_WORKSPACE_PATHS,
+            excluded: [
+                ...DEFAULT_WORKSPACE_PATHS.excluded,
+                'coverage',
+                'test-results',
+                '*.test.js',
+                '*.spec.js'
+            ]
+        }
+    }
+};

package/shared/dist/workspace/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Comprehensive Workspace Configuration Types and Validation
+ *
+ * This module defines the core workspace configuration types that support
+ * monorepo, multi-repo, and hybrid patterns across the TasqHub ecosystem.
+ */
+export * from './types.js';
+export * from './validation.js';
+export * from './constants.js';
+export * from './utils.js';

package/shared/dist/workspace/index.js

@@ -0,0 +1,10 @@
+/**
+ * Comprehensive Workspace Configuration Types and Validation
+ *
+ * This module defines the core workspace configuration types that support
+ * monorepo, multi-repo, and hybrid patterns across the TasqHub ecosystem.
+ */
+export * from './types.js';
+export * from './validation.js';
+export * from './constants.js';
+export * from './utils.js';