@task-shepherd/agent 1.0.6 → 1.0.7

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

@@ -0,0 +1,477 @@
+/**
+ * Core Workspace Configuration Types
+ *
+ * Defines TypeScript interfaces for workspace configuration that support:
+ * - Monorepo patterns (single repo, multiple services)
+ * - Multi-repo patterns (multiple repos, distributed services)
+ * - Hybrid patterns (combination of both)
+ */
+/**
+ * Workspace pattern type - determines how services are organized
+ */
+export type WorkspacePattern = 'monorepo' | 'multi-repo' | 'hybrid';
+/**
+ * Service technology stack classification
+ */
+export type ServiceTechnology = 'nodejs' | 'python' | 'go' | 'rust' | 'java' | 'dotnet' | 'php' | 'ruby' | 'react' | 'vue' | 'angular' | 'static' | 'database' | 'cache' | 'queue' | 'other';
+/**
+ * Service dependency type
+ */
+export interface ServiceDependency {
+    /** Name of the dependency service */
+    service: string;
+    /** Type of dependency */
+    type: 'required' | 'optional' | 'development';
+    /** Minimum version required (if applicable) */
+    version?: string;
+    /** Description of the dependency relationship */
+    description?: string;
+}
+/**
+ * Service endpoint configuration
+ */
+export interface ServiceEndpoint {
+    /** Service unique identifier */
+    id: string;
+    /** Human-readable service name */
+    name: string;
+    /** Service description */
+    description?: string;
+    /** Service base URL */
+    url: string;
+    /** Service port */
+    port: number;
+    /** Service protocol */
+    protocol: 'http' | 'https' | 'ws' | 'wss' | 'tcp' | 'udp' | 'grpc' | 'postgresql' | 'redis' | 'mongodb';
+    /** Service technology stack */
+    technology: ServiceTechnology;
+    /** Service environment */
+    environment: 'development' | 'staging' | 'production' | 'test';
+    /** Service health check endpoint */
+    healthCheck?: string;
+    /** Service version */
+    version?: string;
+    /** Service dependencies */
+    dependencies: ServiceDependency[];
+    /** Service authentication configuration */
+    auth?: ServiceAuthentication;
+    /** Service-specific metadata */
+    metadata?: Record<string, any>;
+}
+/**
+ * Service authentication configuration
+ */
+export interface ServiceAuthentication {
+    /** Authentication type */
+    type: 'none' | 'basic' | 'bearer' | 'apikey' | 'oauth2' | 'custom';
+    /** Authentication credentials */
+    credentials?: Record<string, string>;
+    /** Authentication headers */
+    headers?: Record<string, string>;
+}
+/**
+ * Repository configuration for multi-repo patterns
+ */
+export interface RepositoryConfig {
+    /** Repository unique identifier */
+    id: string;
+    /** Repository name */
+    name: string;
+    /** Repository URL */
+    url: string;
+    /** Local path (relative to workspace root) */
+    path: string;
+    /** Default branch */
+    branch: string;
+    /** Repository type */
+    type: 'primary' | 'service' | 'library' | 'config';
+    /** Services contained in this repository */
+    services: string[];
+    /** Repository-specific configuration */
+    config?: {
+        /** Package manager */
+        packageManager?: 'npm' | 'yarn' | 'pnpm' | 'pip' | 'go mod' | 'cargo' | 'maven' | 'gradle';
+        /** Build commands */
+        buildCommands?: string[];
+        /** Test commands */
+        testCommands?: string[];
+        /** Lint commands */
+        lintCommands?: string[];
+    };
+}
+/**
+ * AI model configuration
+ */
+export interface AIModelConfig {
+    /** AI provider */
+    provider: 'claude' | 'openai' | 'gemini' | 'azure' | 'custom';
+    /** Model name */
+    model: string;
+    /** API key or path to key file */
+    apiKey: string;
+    /** Model-specific configuration */
+    config?: Record<string, any>;
+    /** Rate limiting configuration */
+    rateLimit?: {
+        requestsPerMinute?: number;
+        tokensPerMinute?: number;
+        requestsPerDay?: number;
+    };
+}
+/**
+ * AI capabilities and constraints
+ */
+export interface AICapabilities {
+    /** Maximum concurrent operations */
+    maxConcurrentOperations: number;
+    /** Supported analysis types */
+    supportedAnalysisTypes: string[];
+    /** Workspace isolation level */
+    isolationLevel: 'strict' | 'moderate' | 'relaxed';
+    /** Service-specific capabilities */
+    serviceCapabilities?: Record<string, string[]>;
+    /** Custom capability extensions */
+    customCapabilities?: Record<string, any>;
+}
+/**
+ * File system paths configuration
+ */
+export interface WorkspacePaths {
+    /** Root directory of the workspace */
+    root: string;
+    /** Source code directories */
+    src: string[];
+    /** Test directories */
+    tests: string[];
+    /** Documentation directories */
+    docs: string[];
+    /** Configuration directories */
+    config: string[];
+    /** Build output directories */
+    build: string[];
+    /** Temporary directories */
+    temp: string[];
+    /** Log directories */
+    logs: string[];
+    /** Cache directories */
+    cache: string[];
+    /** Asset directories */
+    assets: string[];
+    /** Excluded directories (not analyzed) */
+    excluded: string[];
+    /** Service-specific paths */
+    servicePaths?: Record<string, string[]>;
+}
+/**
+ * Security and access control configuration
+ */
+export interface SecurityConfig {
+    /** File access permissions */
+    filePermissions: {
+        /** Allow file reading */
+        read: boolean;
+        /** Allow file writing */
+        write: boolean;
+        /** Allow file execution */
+        execute: boolean;
+        /** Restricted file patterns */
+        restricted: string[];
+        /** Read-only paths */
+        readOnly: string[];
+    };
+    /** Network access permissions */
+    networkPermissions: {
+        /** Allow outbound HTTP requests */
+        http: boolean;
+        /** Allow outbound HTTPS requests */
+        https: boolean;
+        /** Allowed domains */
+        allowedDomains: string[];
+        /** Blocked domains */
+        blockedDomains: string[];
+        /** Allowed ports */
+        allowedPorts?: number[];
+    };
+    /** API access control */
+    apiAccess?: {
+        /** Allowed API endpoints */
+        allowedEndpoints: string[];
+        /** API rate limits */
+        rateLimits?: Record<string, number>;
+    };
+}
+/**
+ * Development environment configuration
+ */
+export interface DevelopmentConfig {
+    /** Primary package manager */
+    packageManager: 'npm' | 'yarn' | 'pnpm' | 'pip' | 'go mod' | 'cargo' | 'maven' | 'gradle';
+    /** Runtime version requirements */
+    runtimeVersions?: {
+        node?: string;
+        python?: string;
+        go?: string;
+        rust?: string;
+        java?: string;
+        dotnet?: string;
+    };
+    /** Environment variables */
+    env?: Record<string, string>;
+    /** Development scripts */
+    scripts?: {
+        /** Start development server */
+        start?: string;
+        /** Build project */
+        build?: string;
+        /** Run all tests */
+        test?: string;
+        /** Run linting */
+        lint?: string;
+        /** Type checking */
+        typeCheck?: string;
+        /** Database setup */
+        dbSetup?: string;
+        /** Clean build artifacts */
+        clean?: string;
+    };
+    /** Development tools configuration */
+    tools?: {
+        /** Code formatter */
+        formatter?: 'prettier' | 'black' | 'gofmt' | 'rustfmt' | 'custom';
+        /** Linter configuration */
+        linter?: 'eslint' | 'pylint' | 'golangci-lint' | 'clippy' | 'custom';
+        /** Testing framework */
+        testFramework?: 'jest' | 'vitest' | 'pytest' | 'go test' | 'cargo test' | 'custom';
+    };
+}
+/**
+ * External integrations configuration
+ */
+export interface IntegrationsConfig {
+    /** TasqHub backend integration */
+    tasqhub?: {
+        /** TasqHub API URL */
+        apiUrl: string;
+        /** TasqHub API key */
+        apiKey: string;
+        /** Project ID */
+        projectId?: string;
+        /** Workspace ID in TasqHub */
+        workspaceId?: string;
+    };
+    /** Git configuration */
+    git?: {
+        /** Remote repositories */
+        remotes: Record<string, string>;
+        /** Default branch */
+        defaultBranch: string;
+        /** Git hooks configuration */
+        hooks?: {
+            preCommit?: string[];
+            postCommit?: string[];
+            prePush?: string[];
+            postMerge?: string[];
+        };
+    };
+    /** CI/CD integrations */
+    cicd?: {
+        /** CI/CD provider */
+        provider: 'github-actions' | 'gitlab-ci' | 'jenkins' | 'azure-devops' | 'custom';
+        /** Configuration file path */
+        configPath?: string;
+        /** Pipeline configuration */
+        pipelines?: Record<string, any>;
+    };
+    /** Container orchestration */
+    containers?: {
+        /** Container runtime */
+        runtime: 'docker' | 'podman' | 'containerd';
+        /** Registry configuration */
+        registry?: {
+            url: string;
+            credentials?: Record<string, string>;
+        };
+        /** Compose file paths */
+        composeFiles?: string[];
+    };
+    /** Cloud providers */
+    cloud?: {
+        /** Cloud provider */
+        provider: 'aws' | 'gcp' | 'azure' | 'custom';
+        /** Provider-specific configuration */
+        config?: Record<string, any>;
+    };
+}
+/**
+ * Workspace metadata
+ */
+export interface WorkspaceMetadata {
+    /** Workspace unique identifier */
+    id: string;
+    /** Human-readable workspace name */
+    name: string;
+    /** Workspace description */
+    description?: string;
+    /** Workspace pattern type */
+    pattern: WorkspacePattern;
+    /** Configuration schema version */
+    version: string;
+    /** Workspace creation timestamp */
+    createdAt: string;
+    /** Last update timestamp */
+    updatedAt: string;
+    /** Workspace tags */
+    tags?: string[];
+    /** Owner information */
+    owner?: {
+        name: string;
+        email: string;
+    };
+    /** Team members */
+    team?: Array<{
+        name: string;
+        email: string;
+        role: string;
+    }>;
+}
+/**
+ * Complete workspace configuration
+ */
+export interface WorkspaceConfig {
+    /** Workspace metadata */
+    workspace: WorkspaceMetadata;
+    /** Service definitions and endpoints */
+    services: Record<string, ServiceEndpoint>;
+    /** Repository configurations (for multi-repo patterns) */
+    repositories?: Record<string, RepositoryConfig>;
+    /** AI model settings and configuration */
+    ai: {
+        /** Available AI models */
+        models: Record<string, AIModelConfig>;
+        /** Default model to use */
+        defaultModel: string;
+        /** AI capabilities and constraints */
+        capabilities: AICapabilities;
+    };
+    /** File system paths and structure */
+    paths: WorkspacePaths;
+    /** Development environment configuration */
+    development: DevelopmentConfig;
+    /** Security and access control */
+    security: SecurityConfig;
+    /** External integrations */
+    integrations?: IntegrationsConfig;
+    /** Custom workspace extensions */
+    extensions?: Record<string, any>;
+}
+/**
+ * Service discovery configuration
+ */
+export interface ServiceDiscoveryConfig {
+    /** Auto-discovery enabled */
+    enabled: boolean;
+    /** Discovery methods */
+    methods: Array<'filesystem' | 'docker-compose' | 'kubernetes' | 'consul' | 'custom'>;
+    /** Discovery patterns */
+    patterns: {
+        /** File patterns to search for services */
+        files: string[];
+        /** Directory patterns to identify services */
+        directories: string[];
+        /** Port scan ranges for running services */
+        portRanges?: Array<{
+            start: number;
+            end: number;
+        }>;
+    };
+    /** Manual service overrides */
+    overrides?: Record<string, ServiceEndpoint>;
+}
+/**
+ * Workspace validation configuration
+ */
+export interface WorkspaceValidationConfig {
+    /** Validation rules */
+    rules: {
+        /** Require specific services */
+        requiredServices?: string[];
+        /** Service dependency validation */
+        validateDependencies: boolean;
+        /** Path validation */
+        validatePaths: boolean;
+        /** Port conflict detection */
+        detectPortConflicts: boolean;
+        /** Custom validation rules */
+        customRules?: Array<{
+            name: string;
+            description: string;
+            validator: string;
+        }>;
+    };
+    /** Validation severity levels */
+    severity: {
+        /** Missing required services */
+        missingServices: 'error' | 'warning' | 'info';
+        /** Circular dependencies */
+        circularDependencies: 'error' | 'warning' | 'info';
+        /** Port conflicts */
+        portConflicts: 'error' | 'warning' | 'info';
+        /** Invalid paths */
+        invalidPaths: 'error' | 'warning' | 'info';
+    };
+}
+/**
+ * Workspace initialization options
+ */
+export interface WorkspaceInitOptions {
+    /** Target directory */
+    directory?: string;
+    /** Workspace name */
+    name?: string;
+    /** Workspace description */
+    description?: string;
+    /** Workspace pattern */
+    pattern?: WorkspacePattern;
+    /** Template to use */
+    template?: string;
+    /** Interactive mode */
+    interactive?: boolean;
+    /** Force overwrite existing configuration */
+    force?: boolean;
+    /** Services to include */
+    services?: string[];
+    /** AI provider preference */
+    aiProvider?: string;
+    /** Repository URLs (for multi-repo) */
+    repositories?: string[];
+    /** Auto-discovery settings */
+    discovery?: Partial<ServiceDiscoveryConfig>;
+}
+/**
+ * Workspace template definition
+ */
+export interface WorkspaceTemplate {
+    /** Template identifier */
+    id: string;
+    /** Template name */
+    name: string;
+    /** Template description */
+    description: string;
+    /** Supported workspace patterns */
+    patterns: WorkspacePattern[];
+    /** Template configuration */
+    config: Partial<WorkspaceConfig>;
+    /** Required services */
+    requiredServices: string[];
+    /** Optional services */
+    optionalServices: string[];
+    /** Template-specific setup steps */
+    setupSteps?: string[];
+    /** Custom template variables */
+    variables?: Record<string, {
+        description: string;
+        type: 'string' | 'number' | 'boolean' | 'array';
+        default?: any;
+        required?: boolean;
+    }>;
+}

package/shared/dist/workspace/types.js

@@ -0,0 +1,9 @@
+/**
+ * Core Workspace Configuration Types
+ *
+ * Defines TypeScript interfaces for workspace configuration that support:
+ * - Monorepo patterns (single repo, multiple services)
+ * - Multi-repo patterns (multiple repos, distributed services)
+ * - Hybrid patterns (combination of both)
+ */
+export {};

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

@@ -0,0 +1,79 @@
+/**
+ * Workspace Configuration Utilities
+ *
+ * Helper functions for working with workspace configurations.
+ */
+import type { WorkspaceConfig, ServiceEndpoint, WorkspacePattern } from './types.js';
+import { COMMON_SERVICE_PORTS } from './constants.js';
+/**
+ * Create a workspace configuration from a template
+ */
+export declare function createWorkspaceFromTemplate(templateId: string, options: {
+    name: string;
+    description?: string;
+    pattern?: WorkspacePattern;
+    services?: string[];
+    customConfig?: Partial<WorkspaceConfig>;
+}): Partial<WorkspaceConfig>;
+/**
+ * Merge workspace configurations
+ */
+export declare function mergeWorkspaceConfigs(base: Partial<WorkspaceConfig>, override: Partial<WorkspaceConfig>): Partial<WorkspaceConfig>;
+/**
+ * Generate a unique workspace ID
+ */
+export declare function generateWorkspaceId(): string;
+/**
+ * Find available port for a service
+ */
+export declare function findAvailablePort(services: Record<string, ServiceEndpoint>, preferredPort?: number, serviceType?: keyof typeof COMMON_SERVICE_PORTS.development): number;
+/**
+ * Resolve service dependencies in topological order
+ */
+export declare function resolveServiceDependencies(services: Record<string, ServiceEndpoint>): string[];
+/**
+ * Get service startup order based on dependencies
+ */
+export declare function getServiceStartupOrder(services: Record<string, ServiceEndpoint>): Array<{
+    service: string;
+    level: number;
+}>;
+/**
+ * Validate service dependencies
+ */
+export declare function validateServiceDependencies(services: Record<string, ServiceEndpoint>): Array<{
+    service: string;
+    dependency: string;
+    issue: string;
+}>;
+/**
+ * Check if two versions are compatible (simplified semver check)
+ */
+export declare function isVersionCompatible(available: string, required: string): boolean;
+/**
+ * Generate service health check URLs
+ */
+export declare function generateHealthCheckUrls(services: Record<string, ServiceEndpoint>): Record<string, string>;
+/**
+ * Filter services by technology
+ */
+export declare function filterServicesByTechnology(services: Record<string, ServiceEndpoint>, technology: string): Record<string, ServiceEndpoint>;
+/**
+ * Filter services by environment
+ */
+export declare function filterServicesByEnvironment(services: Record<string, ServiceEndpoint>, environment: string): Record<string, ServiceEndpoint>;
+/**
+ * Get workspace summary
+ */
+export declare function getWorkspaceSummary(config: WorkspaceConfig): {
+    totalServices: number;
+    servicesByTechnology: Record<string, number>;
+    servicesByEnvironment: Record<string, number>;
+    dependencies: number;
+    aiModels: number;
+    pattern: WorkspacePattern;
+};
+/**
+ * Convert workspace config to environment variables
+ */
+export declare function workspaceConfigToEnvVars(config: WorkspaceConfig, prefix?: string): Record<string, string>;