@fractary/faber 2.4.41 → 2.4.43

package/dist/cloud/resource-manager.d.ts

@@ -0,0 +1,81 @@
+/**
+ * @fractary/faber - Resource Manager
+ *
+ * Tracks and manages deployed cloud resources across environments.
+ * Uses Terraform state as primary source of truth.
+ */
+import { ResourceManagerConfig, CloudResource, ResourceFilterOptions, ResourceSummary } from './types';
+/**
+ * ResourceManager - Manages cloud resource tracking
+ *
+ * Provides an abstraction over Terraform state for listing
+ * and monitoring deployed resources.
+ */
+export declare class ResourceManager {
+    private readonly environment;
+    private readonly terraformDir;
+    private readonly awsProfile;
+    private terraformManager;
+    constructor(config: ResourceManagerConfig);
+    /**
+     * Get or create terraform manager for the environment
+     */
+    private getTerraformManager;
+    /**
+     * List resources from Terraform state
+     */
+    list(filters?: ResourceFilterOptions): Promise<CloudResource[]>;
+    /**
+     * Map Terraform resource to CloudResource
+     */
+    private mapTerraformResource;
+    /**
+     * Map resource attributes to status
+     */
+    private mapResourceStatus;
+    /**
+     * Apply filters to resources
+     */
+    private applyFilters;
+    /**
+     * Get resource status summary
+     */
+    status(): Promise<ResourceSummary>;
+    /**
+     * Get a specific resource by ID
+     */
+    get(resourceId: string): Promise<CloudResource | null>;
+    /**
+     * Get resources by type
+     */
+    getByType(type: string): Promise<CloudResource[]>;
+    /**
+     * Get resources by tag
+     */
+    getByTag(key: string, value: string): Promise<CloudResource[]>;
+    /**
+     * Check if any resources exist
+     */
+    hasResources(): Promise<boolean>;
+    /**
+     * Get resource count
+     */
+    count(filters?: ResourceFilterOptions): Promise<number>;
+    /**
+     * Get environment name
+     */
+    getEnvironment(): string;
+    /**
+     * Get terraform outputs for the environment
+     */
+    getOutputs(): Promise<Record<string, unknown>>;
+    /**
+     * Check health of resources (basic connectivity check)
+     */
+    healthCheck(): Promise<{
+        healthy: boolean;
+        issues: string[];
+        checked: number;
+    }>;
+}
+//# sourceMappingURL=resource-manager.d.ts.map

package/dist/cloud/resource-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-manager.d.ts","sourceRoot":"","sources":["../../src/cloud/resource-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EACL,qBAAqB,EACrB,aAAa,EACb,qBAAqB,EACrB,eAAe,EAEhB,MAAM,SAAS,CAAC;AAGjB;;;;;GAKG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqB;IAClD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqB;IAChD,OAAO,CAAC,gBAAgB,CAAiC;gBAE7C,MAAM,EAAE,qBAAqB;IAMzC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAmB3B;;OAEG;IACG,IAAI,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IA2BrE;;OAEG;IACH,OAAO,CAAC,oBAAoB;IA6C5B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA0CzB;;OAEG;IACH,OAAO,CAAC,YAAY;IA6BpB;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,eAAe,CAAC;IAgCxC;;OAEG;IACG,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAK5D;;OAEG;IACG,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAIvD;;OAEG;IACG,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAIpE;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,OAAO,CAAC;IAKtC;;OAEG;IACG,KAAK,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,MAAM,CAAC;IAK7D;;OAEG;IACH,cAAc,IAAI,MAAM;IAIxB;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAoBpD;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC;QAC3B,OAAO,EAAE,OAAO,CAAC;QACjB,MAAM,EAAE,MAAM,EAAE,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CA4BH"}

package/dist/cloud/resource-manager.js

@@ -0,0 +1,288 @@
+/**
+ * @fractary/faber - Resource Manager
+ *
+ * Tracks and manages deployed cloud resources across environments.
+ * Uses Terraform state as primary source of truth.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { TerraformManager } from './terraform-manager';
+/**
+ * ResourceManager - Manages cloud resource tracking
+ *
+ * Provides an abstraction over Terraform state for listing
+ * and monitoring deployed resources.
+ */
+export class ResourceManager {
+    environment;
+    terraformDir;
+    awsProfile;
+    terraformManager = null;
+    constructor(config) {
+        this.environment = config.environment;
+        this.terraformDir = config.terraformDir;
+        this.awsProfile = config.awsProfile;
+    }
+    /**
+     * Get or create terraform manager for the environment
+     */
+    getTerraformManager() {
+        if (!this.terraformDir) {
+            return null;
+        }
+        if (!this.terraformManager) {
+            const workingDir = path.resolve(this.terraformDir);
+            if (fs.existsSync(workingDir)) {
+                this.terraformManager = new TerraformManager({
+                    workingDir,
+                    environment: this.environment,
+                    awsProfile: this.awsProfile,
+                });
+            }
+        }
+        return this.terraformManager;
+    }
+    /**
+     * List resources from Terraform state
+     */
+    async list(filters) {
+        const resources = [];
+        // Try to get resources from Terraform state
+        const tf = this.getTerraformManager();
+        if (tf && await tf.isInitialized()) {
+            try {
+                const state = await tf.show();
+                for (const resource of state.resources) {
+                    // Only include managed resources
+                    if (resource.mode !== 'managed')
+                        continue;
+                    for (const instance of resource.instances) {
+                        const cloudResource = this.mapTerraformResource(resource, instance);
+                        resources.push(cloudResource);
+                    }
+                }
+            }
+            catch (error) {
+                console.error('Failed to read Terraform state:', error);
+            }
+        }
+        // Apply filters
+        return this.applyFilters(resources, filters);
+    }
+    /**
+     * Map Terraform resource to CloudResource
+     */
+    mapTerraformResource(resource, instance) {
+        const attrs = instance.attributes;
+        // Determine provider from terraform provider name
+        let provider = 'other';
+        if (resource.provider.includes('aws'))
+            provider = 'aws';
+        else if (resource.provider.includes('google'))
+            provider = 'gcp';
+        else if (resource.provider.includes('azurerm'))
+            provider = 'azure';
+        // Extract common attributes
+        const id = (attrs.id ?? attrs.arn ?? `${resource.type}.${resource.name}`);
+        const tagsObj = attrs.tags;
+        const name = (attrs.name ?? (tagsObj && tagsObj.Name) ?? resource.name);
+        const availabilityZone = attrs.availability_zone;
+        const region = (attrs.region ?? (availabilityZone ? availabilityZone.slice(0, -1) : undefined));
+        const tags = tagsObj;
+        // Map status (varies by resource type)
+        const status = this.mapResourceStatus(resource.type, attrs);
+        return {
+            id,
+            type: resource.type,
+            name,
+            provider,
+            region,
+            status,
+            tags,
+            metadata: {
+                terraform_address: `${resource.type}.${resource.name}`,
+                ...attrs,
+            },
+        };
+    }
+    /**
+     * Map resource attributes to status
+     */
+    mapResourceStatus(resourceType, attrs) {
+        // EC2 instances
+        if (resourceType === 'aws_instance') {
+            const state = attrs.instance_state;
+            if (state === 'running')
+                return 'running';
+            if (state === 'stopped')
+                return 'stopped';
+            if (state === 'pending')
+                return 'pending';
+            if (state === 'terminated')
+                return 'terminated';
+        }
+        // RDS instances
+        if (resourceType === 'aws_db_instance') {
+            const status = attrs.status;
+            if (status === 'available')
+                return 'running';
+            if (status === 'stopped')
+                return 'stopped';
+            if (status === 'starting' || status === 'creating')
+                return 'pending';
+        }
+        // Lambda functions (always "running" if they exist)
+        if (resourceType === 'aws_lambda_function') {
+            return 'running';
+        }
+        // S3 buckets (always "running" if they exist)
+        if (resourceType === 'aws_s3_bucket') {
+            return 'running';
+        }
+        // ECS services
+        if (resourceType === 'aws_ecs_service') {
+            const desiredCount = attrs.desired_count;
+            if (desiredCount > 0)
+                return 'running';
+            return 'stopped';
+        }
+        // Default to running if resource exists in state
+        return 'running';
+    }
+    /**
+     * Apply filters to resources
+     */
+    applyFilters(resources, filters) {
+        if (!filters)
+            return resources;
+        let result = resources;
+        if (filters.type) {
+            result = result.filter(r => r.type === filters.type);
+        }
+        if (filters.status) {
+            result = result.filter(r => r.status === filters.status);
+        }
+        if (filters.region) {
+            result = result.filter(r => r.region === filters.region);
+        }
+        if (filters.tag) {
+            result = result.filter(r => r.tags && r.tags[filters.tag.key] === filters.tag.value);
+        }
+        return result;
+    }
+    /**
+     * Get resource status summary
+     */
+    async status() {
+        const resources = await this.list();
+        const summary = {
+            total: resources.length,
+            by_type: {},
+            by_status: {
+                running: 0,
+                stopped: 0,
+                pending: 0,
+                terminated: 0,
+                unknown: 0,
+            },
+            by_region: {},
+        };
+        for (const resource of resources) {
+            // Count by type
+            summary.by_type[resource.type] = (summary.by_type[resource.type] ?? 0) + 1;
+            // Count by status
+            summary.by_status[resource.status]++;
+            // Count by region
+            if (resource.region) {
+                summary.by_region[resource.region] = (summary.by_region[resource.region] ?? 0) + 1;
+            }
+        }
+        return summary;
+    }
+    /**
+     * Get a specific resource by ID
+     */
+    async get(resourceId) {
+        const resources = await this.list();
+        return resources.find(r => r.id === resourceId) ?? null;
+    }
+    /**
+     * Get resources by type
+     */
+    async getByType(type) {
+        return this.list({ type });
+    }
+    /**
+     * Get resources by tag
+     */
+    async getByTag(key, value) {
+        return this.list({ tag: { key, value } });
+    }
+    /**
+     * Check if any resources exist
+     */
+    async hasResources() {
+        const resources = await this.list();
+        return resources.length > 0;
+    }
+    /**
+     * Get resource count
+     */
+    async count(filters) {
+        const resources = await this.list(filters);
+        return resources.length;
+    }
+    /**
+     * Get environment name
+     */
+    getEnvironment() {
+        return this.environment;
+    }
+    /**
+     * Get terraform outputs for the environment
+     */
+    async getOutputs() {
+        const tf = this.getTerraformManager();
+        if (!tf || !await tf.isInitialized()) {
+            return {};
+        }
+        try {
+            const outputs = await tf.output();
+            const result = {};
+            for (const [key, value] of Object.entries(outputs)) {
+                result[key] = value.value;
+            }
+            return result;
+        }
+        catch {
+            return {};
+        }
+    }
+    /**
+     * Check health of resources (basic connectivity check)
+     */
+    async healthCheck() {
+        const resources = await this.list();
+        const issues = [];
+        // Check for resources in bad states
+        for (const resource of resources) {
+            if (resource.status === 'terminated') {
+                issues.push(`Resource ${resource.id} is terminated`);
+            }
+            if (resource.status === 'unknown') {
+                issues.push(`Resource ${resource.id} has unknown status`);
+            }
+        }
+        // Check for stopped resources that should be running
+        const stoppedInstances = resources.filter(r => r.type === 'aws_instance' && r.status === 'stopped');
+        if (stoppedInstances.length > 0) {
+            issues.push(`${stoppedInstances.length} EC2 instance(s) are stopped`);
+        }
+        return {
+            healthy: issues.length === 0,
+            issues,
+            checked: resources.length,
+        };
+    }
+}
+//# sourceMappingURL=resource-manager.js.map

package/dist/cloud/resource-manager.js.map

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

package/dist/cloud/terraform-manager.d.ts

@@ -0,0 +1,108 @@
+/**
+ * @fractary/faber - Terraform Manager
+ *
+ * Wraps Terraform CLI operations with structured responses.
+ */
+import { TerraformManagerConfig, TerraformPlan, TerraformInitResult, TerraformValidateResult, TerraformApplyResult, TerraformDestroyResult, TerraformState, TerraformOutput, TerraformInitOptions, TerraformPlanOptions, TerraformApplyOptions, TerraformDestroyOptions } from './types';
+/**
+ * TerraformManager - Manages Terraform CLI operations
+ *
+ * Provides structured wrappers around terraform commands with
+ * JSON output parsing and error handling.
+ */
+export declare class TerraformManager {
+    private readonly workingDir;
+    private readonly environment;
+    private readonly terraformBinary;
+    private readonly awsProfile;
+    private readonly envVars;
+    constructor(config: TerraformManagerConfig);
+    /**
+     * Get environment variables for terraform execution
+     */
+    private getEnv;
+    /**
+     * Execute terraform command synchronously
+     */
+    private exec;
+    /**
+     * Execute terraform command with JSON output
+     */
+    private execJson;
+    /**
+     * Build variable arguments
+     */
+    private buildVarArgs;
+    /**
+     * Build target arguments
+     */
+    private buildTargetArgs;
+    /**
+     * Initialize Terraform working directory
+     */
+    init(options?: TerraformInitOptions): Promise<TerraformInitResult>;
+    /**
+     * Validate Terraform configuration
+     */
+    validate(): Promise<TerraformValidateResult>;
+    /**
+     * Generate execution plan
+     */
+    plan(options?: TerraformPlanOptions): Promise<TerraformPlan>;
+    /**
+     * Map terraform actions to single action type
+     */
+    private mapAction;
+    /**
+     * Apply changes
+     */
+    apply(options?: TerraformApplyOptions): Promise<TerraformApplyResult>;
+    /**
+     * Destroy infrastructure
+     */
+    destroy(options?: TerraformDestroyOptions): Promise<TerraformDestroyResult>;
+    /**
+     * Show current state
+     */
+    show(): Promise<TerraformState>;
+    /**
+     * Get outputs
+     */
+    output(name?: string): Promise<Record<string, TerraformOutput>>;
+    /**
+     * Select workspace
+     */
+    selectWorkspace(name: string): Promise<void>;
+    /**
+     * List workspaces
+     */
+    listWorkspaces(): Promise<string[]>;
+    /**
+     * Get current workspace
+     */
+    currentWorkspace(): Promise<string>;
+    /**
+     * Get terraform version
+     */
+    getVersion(): Promise<string>;
+    /**
+     * Check if terraform is initialized
+     */
+    isInitialized(): Promise<boolean>;
+    /**
+     * Format terraform files
+     */
+    fmt(check?: boolean): Promise<{
+        formatted: boolean;
+        files: string[];
+    }>;
+    /**
+     * Get working directory
+     */
+    getWorkingDir(): string;
+    /**
+     * Get environment
+     */
+    getEnvironment(): string | undefined;
+}
+//# sourceMappingURL=terraform-manager.d.ts.map

package/dist/cloud/terraform-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terraform-manager.d.ts","sourceRoot":"","sources":["../../src/cloud/terraform-manager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,EACL,sBAAsB,EACtB,aAAa,EACb,mBAAmB,EACnB,uBAAuB,EACvB,oBAAoB,EACpB,sBAAsB,EACtB,cAAc,EACd,eAAe,EACf,oBAAoB,EACpB,oBAAoB,EACpB,qBAAqB,EACrB,uBAAuB,EAExB,MAAM,SAAS,CAAC;AAOjB;;;;;GAKG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqB;IACjD,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAqB;IAChD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;gBAErC,MAAM,EAAE,sBAAsB;IAiB1C;;OAEG;IACH,OAAO,CAAC,MAAM;IAUd;;OAEG;IACH,OAAO,CAAC,IAAI;IAqBZ;;OAEG;IACH,OAAO,CAAC,QAAQ;IAShB;;OAEG;IACH,OAAO,CAAC,YAAY;IAmBpB;;OAEG;IACH,OAAO,CAAC,eAAe;IAcvB;;OAEG;IACG,IAAI,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAkDxE;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,uBAAuB,CAAC;IAsClD;;OAEG;IACG,IAAI,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,aAAa,CAAC;IAmGlE;;OAEG;IACH,OAAO,CAAC,SAAS;IASjB;;OAEG;IACG,KAAK,CAAC,OAAO,CAAC,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAyD3E;;OAEG;IACG,OAAO,CAAC,OAAO,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IA6CjF;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,cAAc,CAAC;IAuDrC;;OAEG;IACG,MAAM,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;IAkCrE;;OAEG;IACG,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUlD;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAUzC;;OAEG;IACG,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC;IASzC;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC;IAanC;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC;IAKvC;;OAEG;IACG,GAAG,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IA4B5E;;OAEG;IACH,aAAa,IAAI,MAAM;IAIvB;;OAEG;IACH,cAAc,IAAI,MAAM,GAAG,SAAS;CAGrC"}