@task-shepherd/agent 1.0.8 → 1.0.11

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

@@ -1,477 +0,0 @@
-/**
- * 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

@@ -1,9 +0,0 @@
-/**
- * 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

@@ -1,79 +0,0 @@
-/**
- * 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>;