@llm-dev-ops/agentics-cli 1.0.0

package/README.md

@@ -0,0 +1 @@
+# agentics-cli

package/dist/adapters/base-adapter.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Downstream Adapter Module (Module C)
+ *
+ * SPARC Architecture Reference: §2.4
+ *
+ * PURPOSE: Invoke external repository APIs with minimal coupling
+ *
+ * DEPENDENCIES: HTTP Client only
+ *
+ * FORBIDDEN:
+ * - Response Parsing (NO JSON schema validation)
+ * - Response Transform (NO field mapping or conversion)
+ * - Business Logic (NO conditional handling based on data)
+ * - Caching (NO response storage)
+ * - Error Recovery (Errors bubble up unchanged)
+ */
+import type { AdapterRequest, AdapterResponse, HealthStatus, EndpointConfig } from '../types/index.js';
+export type { AdapterResponse, EndpointConfig } from '../types/index.js';
+export interface IDownstreamAdapter {
+    invoke(request: AdapterRequest): Promise<AdapterResponse>;
+    health(): Promise<HealthStatus>;
+    getEndpointConfig(): EndpointConfig;
+}
+export declare class BaseAdapter implements IDownstreamAdapter {
+    protected readonly config: EndpointConfig;
+    protected readonly serviceName: string;
+    protected readonly correlationId?: string;
+    constructor(options: {
+        serviceName: string;
+        config: EndpointConfig;
+        correlationId?: string;
+    });
+    invoke(request: AdapterRequest): Promise<AdapterResponse>;
+    health(): Promise<HealthStatus>;
+    getEndpointConfig(): EndpointConfig;
+}
+export declare class ManifestsAdapter extends BaseAdapter {
+    constructor(config: EndpointConfig, correlationId?: string);
+    select(criteria: unknown): Promise<AdapterResponse>;
+}
+export declare class PlannerAdapter extends BaseAdapter {
+    constructor(config: EndpointConfig, correlationId?: string);
+    createPlan(manifestRef: unknown, params: unknown): Promise<AdapterResponse>;
+}
+export declare class RunnerAdapter extends BaseAdapter {
+    constructor(config: EndpointConfig, correlationId?: string);
+    execute(planRef: unknown, config: unknown): Promise<AdapterResponse>;
+}
+export declare class IntentAdapter extends BaseAdapter {
+    constructor(config: EndpointConfig, correlationId?: string);
+    resolve(simRef: unknown, spec: unknown): Promise<AdapterResponse>;
+}
+export declare class ExportersAdapter extends BaseAdapter {
+    constructor(config: EndpointConfig, correlationId?: string);
+    generate(intentRef: unknown, formatSpec: unknown): Promise<AdapterResponse>;
+}
+export declare class DiligenceAdapter extends BaseAdapter {
+    constructor(config: EndpointConfig, correlationId?: string);
+    package(refs: unknown[], requirements: unknown): Promise<AdapterResponse>;
+}
+export declare class SimulationEngineAdapter extends BaseAdapter {
+    constructor(config: EndpointConfig, correlationId?: string);
+    inspect(simRef: unknown, outputType: string): Promise<AdapterResponse>;
+    getOutputs(simRef: unknown): Promise<AdapterResponse>;
+}
+export declare class RoiEngineAdapter extends BaseAdapter {
+    constructor(config: EndpointConfig, correlationId?: string);
+    quantify(simRef: unknown, reportType: string, params?: unknown): Promise<AdapterResponse>;
+    getSummary(simRef: unknown): Promise<AdapterResponse>;
+}
+export type ServiceName = 'agentics-org-manifests' | 'agentics-simulation-planner' | 'agentics-simulation-runner' | 'agentics-simulation-engine' | 'enterprise-roi-engine' | 'agentics-deployment-intent' | 'agentics-deployment-exporters' | 'diligence-artifacts';
+export declare function createAdapter(serviceName: ServiceName, config: EndpointConfig, correlationId?: string): IDownstreamAdapter;
+//# sourceMappingURL=base-adapter.d.ts.map

package/dist/adapters/base-adapter.d.ts.map

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

package/dist/adapters/base-adapter.js

@@ -0,0 +1,311 @@
+/**
+ * Downstream Adapter Module (Module C)
+ *
+ * SPARC Architecture Reference: §2.4
+ *
+ * PURPOSE: Invoke external repository APIs with minimal coupling
+ *
+ * DEPENDENCIES: HTTP Client only
+ *
+ * FORBIDDEN:
+ * - Response Parsing (NO JSON schema validation)
+ * - Response Transform (NO field mapping or conversion)
+ * - Business Logic (NO conditional handling based on data)
+ * - Caching (NO response storage)
+ * - Error Recovery (Errors bubble up unchanged)
+ */
+import { ServiceError } from '../errors/index.js';
+// ============================================================================
+// Base Adapter Implementation
+// ============================================================================
+export class BaseAdapter {
+    config;
+    serviceName;
+    correlationId;
+    constructor(options) {
+        this.serviceName = options.serviceName;
+        this.config = options.config;
+        this.correlationId = options.correlationId;
+    }
+    async invoke(request) {
+        const startTime = Date.now();
+        const url = `${this.config.baseUrl}${request.endpoint}`;
+        const timeout = request.timeout ?? this.config.timeout;
+        // Create abort controller for timeout
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), timeout);
+        try {
+            const response = await fetch(url, {
+                method: request.method,
+                headers: {
+                    'Content-Type': 'application/json',
+                    'X-Correlation-ID': this.correlationId ?? crypto.randomUUID(),
+                    'X-API-Version': this.config.version,
+                    ...request.headers,
+                },
+                body: request.body ? JSON.stringify(request.body) : undefined,
+                signal: controller.signal,
+            });
+            clearTimeout(timeoutId);
+            const timing = Date.now() - startTime;
+            // Get response body - PASSTHROUGH, no interpretation
+            let body;
+            const contentType = response.headers.get('content-type') ?? '';
+            if (contentType.includes('application/json')) {
+                body = await response.json();
+            }
+            else {
+                body = await response.text();
+            }
+            // Check for error status codes - surface error, no retry
+            if (!response.ok) {
+                throw new ServiceError({
+                    service: this.serviceName,
+                    operation: request.endpoint,
+                    type: response.status >= 500 ? 'internal_error' : 'unavailable',
+                    statusCode: response.status,
+                    upstreamMessage: typeof body === 'object' && body !== null && 'message' in body
+                        ? String(body.message)
+                        : String(body),
+                    correlationId: this.correlationId,
+                });
+            }
+            // Return raw response - NO transformation
+            return {
+                status: response.status,
+                headers: Object.fromEntries(response.headers.entries()),
+                body, // Raw passthrough - never parsed by CLI
+                timing,
+            };
+        }
+        catch (error) {
+            clearTimeout(timeoutId);
+            // Handle abort (timeout)
+            if (error instanceof Error && error.name === 'AbortError') {
+                throw new ServiceError({
+                    service: this.serviceName,
+                    operation: request.endpoint,
+                    type: 'timeout',
+                    upstreamMessage: `Request timed out after ${timeout}ms`,
+                    correlationId: this.correlationId,
+                });
+            }
+            // Handle network errors
+            if (error instanceof TypeError) {
+                throw new ServiceError({
+                    service: this.serviceName,
+                    operation: request.endpoint,
+                    type: 'unavailable',
+                    upstreamMessage: `Network error: ${error.message}`,
+                    correlationId: this.correlationId,
+                });
+            }
+            // Re-throw CLIErrors as-is
+            throw error;
+        }
+    }
+    async health() {
+        const startTime = Date.now();
+        try {
+            const response = await this.invoke({
+                endpoint: '/health',
+                method: 'GET',
+                headers: {},
+                timeout: 5000, // Health check has short timeout
+            });
+            return {
+                healthy: response.status === 200,
+                latency: Date.now() - startTime,
+                version: this.config.version,
+            };
+        }
+        catch {
+            return {
+                healthy: false,
+                latency: Date.now() - startTime,
+                version: this.config.version,
+            };
+        }
+    }
+    getEndpointConfig() {
+        return { ...this.config };
+    }
+}
+// ============================================================================
+// Service-Specific Adapters
+// ============================================================================
+export class ManifestsAdapter extends BaseAdapter {
+    constructor(config, correlationId) {
+        super({
+            serviceName: 'agentics-org-manifests',
+            config,
+            correlationId,
+        });
+    }
+    async select(criteria) {
+        return this.invoke({
+            endpoint: '/api/v1/manifests/select',
+            method: 'POST',
+            headers: {},
+            body: criteria,
+        });
+    }
+}
+export class PlannerAdapter extends BaseAdapter {
+    constructor(config, correlationId) {
+        super({
+            serviceName: 'agentics-simulation-planner',
+            config,
+            correlationId,
+        });
+    }
+    async createPlan(manifestRef, params) {
+        return this.invoke({
+            endpoint: '/api/v1/plans/create',
+            method: 'POST',
+            headers: {},
+            body: { manifest_ref: manifestRef, params },
+        });
+    }
+}
+export class RunnerAdapter extends BaseAdapter {
+    constructor(config, correlationId) {
+        super({
+            serviceName: 'agentics-simulation-runner',
+            config,
+            correlationId,
+        });
+    }
+    async execute(planRef, config) {
+        return this.invoke({
+            endpoint: '/api/v1/simulations/execute',
+            method: 'POST',
+            headers: {},
+            body: { plan_ref: planRef, config },
+        });
+    }
+}
+export class IntentAdapter extends BaseAdapter {
+    constructor(config, correlationId) {
+        super({
+            serviceName: 'agentics-deployment-intent',
+            config,
+            correlationId,
+        });
+    }
+    async resolve(simRef, spec) {
+        return this.invoke({
+            endpoint: '/api/v1/intents/resolve',
+            method: 'POST',
+            headers: {},
+            body: { sim_ref: simRef, spec },
+        });
+    }
+}
+export class ExportersAdapter extends BaseAdapter {
+    constructor(config, correlationId) {
+        super({
+            serviceName: 'agentics-deployment-exporters',
+            config,
+            correlationId,
+        });
+    }
+    async generate(intentRef, formatSpec) {
+        return this.invoke({
+            endpoint: '/api/v1/exports/generate',
+            method: 'POST',
+            headers: {},
+            body: { intent_ref: intentRef, format_spec: formatSpec },
+        });
+    }
+}
+export class DiligenceAdapter extends BaseAdapter {
+    constructor(config, correlationId) {
+        super({
+            serviceName: 'diligence-artifacts',
+            config,
+            correlationId,
+        });
+    }
+    async package(refs, requirements) {
+        return this.invoke({
+            endpoint: '/api/v1/diligence/package',
+            method: 'POST',
+            headers: {},
+            body: { refs, requirements },
+        });
+    }
+}
+export class SimulationEngineAdapter extends BaseAdapter {
+    constructor(config, correlationId) {
+        super({
+            serviceName: 'agentics-simulation-engine',
+            config,
+            correlationId,
+        });
+    }
+    async inspect(simRef, outputType) {
+        return this.invoke({
+            endpoint: '/api/v1/outputs/retrieve',
+            method: 'POST',
+            headers: {},
+            body: { sim_ref: simRef, output_type: outputType },
+        });
+    }
+    async getOutputs(simRef) {
+        return this.invoke({
+            endpoint: '/api/v1/outputs/list',
+            method: 'POST',
+            headers: {},
+            body: { sim_ref: simRef },
+        });
+    }
+}
+export class RoiEngineAdapter extends BaseAdapter {
+    constructor(config, correlationId) {
+        super({
+            serviceName: 'enterprise-roi-engine',
+            config,
+            correlationId,
+        });
+    }
+    async quantify(simRef, reportType, params) {
+        return this.invoke({
+            endpoint: '/api/v1/reports/generate',
+            method: 'POST',
+            headers: {},
+            body: { sim_ref: simRef, report_type: reportType, params: params ?? {} },
+        });
+    }
+    async getSummary(simRef) {
+        return this.invoke({
+            endpoint: '/api/v1/reports/executive-summary',
+            method: 'POST',
+            headers: {},
+            body: { sim_ref: simRef },
+        });
+    }
+}
+export function createAdapter(serviceName, config, correlationId) {
+    switch (serviceName) {
+        case 'agentics-org-manifests':
+            return new ManifestsAdapter(config, correlationId);
+        case 'agentics-simulation-planner':
+            return new PlannerAdapter(config, correlationId);
+        case 'agentics-simulation-runner':
+            return new RunnerAdapter(config, correlationId);
+        case 'agentics-simulation-engine':
+            return new SimulationEngineAdapter(config, correlationId);
+        case 'enterprise-roi-engine':
+            return new RoiEngineAdapter(config, correlationId);
+        case 'agentics-deployment-intent':
+            return new IntentAdapter(config, correlationId);
+        case 'agentics-deployment-exporters':
+            return new ExportersAdapter(config, correlationId);
+        case 'diligence-artifacts':
+            return new DiligenceAdapter(config, correlationId);
+        default:
+            throw new Error(`Unknown service: ${serviceName}`);
+    }
+}
+//# sourceMappingURL=base-adapter.js.map

package/dist/adapters/base-adapter.js.map

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

package/dist/adapters/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Adapter Exports
+ *
+ * Re-exports all adapter implementations
+ */
+export { BaseAdapter, ManifestsAdapter, PlannerAdapter, RunnerAdapter, SimulationEngineAdapter, RoiEngineAdapter, IntentAdapter, ExportersAdapter, DiligenceAdapter, createAdapter, } from './base-adapter.js';
+export type { IDownstreamAdapter, ServiceName, } from './base-adapter.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,uBAAuB,EACvB,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,GACd,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EACV,kBAAkB,EAClB,WAAW,GACZ,MAAM,mBAAmB,CAAC"}

package/dist/adapters/index.js

@@ -0,0 +1,7 @@
+/**
+ * Adapter Exports
+ *
+ * Re-exports all adapter implementations
+ */
+export { BaseAdapter, ManifestsAdapter, PlannerAdapter, RunnerAdapter, SimulationEngineAdapter, RoiEngineAdapter, IntentAdapter, ExportersAdapter, DiligenceAdapter, createAdapter, } from './base-adapter.js';
+//# sourceMappingURL=index.js.map

package/dist/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,uBAAuB,EACvB,gBAAgB,EAChB,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,GACd,MAAM,mBAAmB,CAAC"}

package/dist/audit/audit-trail.d.ts

@@ -0,0 +1,68 @@
+/**
+ * Audit Trail Module
+ *
+ * SPARC Architecture Reference: §6.1 (SPARC_PSEUDOCODE)
+ *
+ * PURPOSE: Record CLI operations for compliance and debugging
+ *
+ * FORBIDDEN:
+ * - State Modification (audit is append-only)
+ * - Error Recovery (errors recorded but not handled)
+ * - Data Transformation (raw data recorded)
+ */
+import type { AuditEntry, BaseReference, DownstreamCall } from '../types/index.js';
+export interface IAuditTrail {
+    /**
+     * Record a command execution
+     */
+    record(entry: AuditEntryInput): AuditEntry;
+    /**
+     * Get audit entries for a trace
+     */
+    getByTraceId(traceId: string): AuditEntry[];
+    /**
+     * Format audit entry for output
+     */
+    format(entry: AuditEntry): string;
+}
+export interface AuditEntryInput {
+    command: string;
+    inputs: unknown;
+    outputs: BaseReference | null;
+    dependencies: DownstreamCall[];
+    duration_ms: number;
+    status: 'SUCCESS' | 'FAILED';
+    error_code?: string;
+    error_message?: string;
+    trace_id: string;
+    parent_id?: string;
+}
+export declare class AuditTrail implements IAuditTrail {
+    private readonly version;
+    private readonly entries;
+    /**
+     * Record a command execution
+     * SPARC: Append-only, no modification of existing entries
+     */
+    record(input: AuditEntryInput): AuditEntry;
+    /**
+     * Get audit entries for a trace
+     */
+    getByTraceId(traceId: string): AuditEntry[];
+    /**
+     * Format audit entry for output (JSON format)
+     */
+    format(entry: AuditEntry): string;
+    private hashInputs;
+    private sortKeys;
+    private redactSensitive;
+    private computeChecksum;
+}
+export declare class AuditLogger {
+    private readonly destination;
+    constructor(destination?: 'stdout' | 'stderr');
+    log(entry: AuditEntry): void;
+}
+export declare function createAuditTrail(): IAuditTrail;
+export declare function createAuditLogger(destination?: 'stdout' | 'stderr'): AuditLogger;
+//# sourceMappingURL=audit-trail.d.ts.map

package/dist/audit/audit-trail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-trail.d.ts","sourceRoot":"","sources":["../../src/audit/audit-trail.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EACV,UAAU,EACV,aAAa,EACb,cAAc,EACf,MAAM,mBAAmB,CAAC;AAO3B,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,eAAe,GAAG,UAAU,CAAC;IAE3C;;OAEG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,EAAE,CAAC;IAE5C;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAAC;CACnC;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,aAAa,GAAG,IAAI,CAAC;IAC9B,YAAY,EAAE,cAAc,EAAE,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,SAAS,GAAG,QAAQ,CAAC;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAMD,qBAAa,UAAW,YAAW,WAAW;IAC5C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAmB;IAC3C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwC;IAEhE;;;OAGG;IACH,MAAM,CAAC,KAAK,EAAE,eAAe,GAAG,UAAU;IAuD1C;;OAEG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,EAAE;IAI3C;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM;IAQjC,OAAO,CAAC,UAAU;IAKlB,OAAO,CAAC,QAAQ;IAYhB,OAAO,CAAC,eAAe;IAwCvB,OAAO,CAAC,eAAe;CAIxB;AAMD,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAsB;gBAEtC,WAAW,GAAE,QAAQ,GAAG,QAAmB;IAIvD,GAAG,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;CAY7B;AAMD,wBAAgB,gBAAgB,IAAI,WAAW,CAE9C;AAED,wBAAgB,iBAAiB,CAAC,WAAW,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,WAAW,CAEhF"}

package/dist/audit/audit-trail.js

@@ -0,0 +1,172 @@
+/**
+ * Audit Trail Module
+ *
+ * SPARC Architecture Reference: §6.1 (SPARC_PSEUDOCODE)
+ *
+ * PURPOSE: Record CLI operations for compliance and debugging
+ *
+ * FORBIDDEN:
+ * - State Modification (audit is append-only)
+ * - Error Recovery (errors recorded but not handled)
+ * - Data Transformation (raw data recorded)
+ */
+import * as crypto from 'node:crypto';
+// ============================================================================
+// Audit Trail Implementation
+// ============================================================================
+export class AuditTrail {
+    version = '1.0.0';
+    entries = new Map();
+    /**
+     * Record a command execution
+     * SPARC: Append-only, no modification of existing entries
+     */
+    record(input) {
+        const id = crypto.randomUUID();
+        const timestamp = new Date().toISOString();
+        // Compute inputs hash for reproducibility
+        const inputsHash = this.hashInputs(input.inputs);
+        // Redact sensitive fields from inputs
+        const inputsRedacted = this.redactSensitive(input.inputs);
+        // Compute checksum for entry integrity
+        const entryData = {
+            id,
+            version: this.version,
+            command: input.command,
+            inputs_hash: inputsHash,
+            outputs: input.outputs,
+            dependencies: input.dependencies.map(d => d.service),
+            timestamp,
+            duration_ms: input.duration_ms,
+            status: input.status,
+            error_code: input.error_code,
+            error_message: input.error_message,
+            trace_id: input.trace_id,
+            parent_id: input.parent_id,
+        };
+        const checksum = this.computeChecksum(entryData);
+        const entry = {
+            id,
+            version: this.version,
+            command: input.command,
+            inputs_hash: inputsHash,
+            inputs_redacted: inputsRedacted,
+            outputs: input.outputs,
+            dependencies: input.dependencies.map(d => d.service),
+            timestamp,
+            duration_ms: input.duration_ms,
+            status: input.status,
+            error_code: input.error_code,
+            error_message: input.error_message,
+            trace_id: input.trace_id,
+            parent_id: input.parent_id,
+            checksum,
+        };
+        // Store by trace_id for retrieval
+        const traceEntries = this.entries.get(input.trace_id) ?? [];
+        traceEntries.push(entry);
+        this.entries.set(input.trace_id, traceEntries);
+        return entry;
+    }
+    /**
+     * Get audit entries for a trace
+     */
+    getByTraceId(traceId) {
+        return this.entries.get(traceId) ?? [];
+    }
+    /**
+     * Format audit entry for output (JSON format)
+     */
+    format(entry) {
+        return JSON.stringify(entry, null, 2);
+    }
+    // ============================================================================
+    // Private Methods
+    // ============================================================================
+    hashInputs(inputs) {
+        const canonical = JSON.stringify(inputs, this.sortKeys);
+        return crypto.createHash('sha256').update(canonical).digest('hex').slice(0, 16);
+    }
+    sortKeys(_key, value) {
+        if (value && typeof value === 'object' && !Array.isArray(value)) {
+            return Object.keys(value)
+                .sort()
+                .reduce((sorted, key) => {
+                sorted[key] = value[key];
+                return sorted;
+            }, {});
+        }
+        return value;
+    }
+    redactSensitive(inputs) {
+        if (!inputs || typeof inputs !== 'object') {
+            return inputs;
+        }
+        const sensitivePatterns = [
+            /token/i,
+            /password/i,
+            /secret/i,
+            /key/i,
+            /auth/i,
+            /credential/i,
+        ];
+        const redact = (obj) => {
+            if (!obj || typeof obj !== 'object') {
+                return obj;
+            }
+            if (Array.isArray(obj)) {
+                return obj.map(redact);
+            }
+            const result = {};
+            for (const [key, value] of Object.entries(obj)) {
+                const isSensitive = sensitivePatterns.some(pattern => pattern.test(key));
+                if (isSensitive && typeof value === 'string') {
+                    result[key] = '[REDACTED]';
+                }
+                else if (typeof value === 'object') {
+                    result[key] = redact(value);
+                }
+                else {
+                    result[key] = value;
+                }
+            }
+            return result;
+        };
+        return redact(inputs);
+    }
+    computeChecksum(data) {
+        const canonical = JSON.stringify(data, this.sortKeys);
+        return crypto.createHash('sha256').update(canonical).digest('hex');
+    }
+}
+// ============================================================================
+// Audit Logger (Console output for audit trail)
+// ============================================================================
+export class AuditLogger {
+    destination;
+    constructor(destination = 'stderr') {
+        this.destination = destination;
+    }
+    log(entry) {
+        const output = JSON.stringify({
+            level: 'AUDIT',
+            ...entry,
+        });
+        if (this.destination === 'stdout') {
+            console.log(output);
+        }
+        else {
+            console.error(output);
+        }
+    }
+}
+// ============================================================================
+// Factory Functions
+// ============================================================================
+export function createAuditTrail() {
+    return new AuditTrail();
+}
+export function createAuditLogger(destination) {
+    return new AuditLogger(destination);
+}
+//# sourceMappingURL=audit-trail.js.map