@ai-sdlc/orchestrator 0.1.0

package/dist/defaults.js

@@ -0,0 +1,218 @@
+/**
+ * Centralized default values for the AI-SDLC orchestrator.
+ *
+ * All magic numbers, fallback strings, and environment-driven defaults live
+ * here so they can be tuned from a single location.  Every value can be
+ * overridden by an environment variable, a Pipeline/AgentRole YAML field,
+ * or an explicit function parameter — these are only the last-resort
+ * fallbacks.
+ */
+import { parseDuration } from '@ai-sdlc/reference';
+// ── LLM Model ────────────────────────────────────────────────────────
+/**
+ * Default model name (literal fallback).
+ * Consumers should read `AI_SDLC_MODEL` env var at call time and fall back
+ * to this constant, so tests that set env vars at runtime see the override.
+ */
+export const DEFAULT_MODEL = 'claude-sonnet-4-5-20250929';
+// ── GitHub ───────────────────────────────────────────────────────────
+/**
+ * Fallback values for GitHub org/repo — empty strings require explicit config.
+ * Consumers should read `GITHUB_REPOSITORY_OWNER` / `GITHUB_REPOSITORY`
+ * at call time and fall back to these constants.
+ */
+export const DEFAULT_GITHUB_ORG = '';
+export const DEFAULT_GITHUB_REPO = '';
+export const DEFAULT_GITHUB_REPOSITORY = '';
+// ── Config directory ─────────────────────────────────────────────────
+export const DEFAULT_CONFIG_DIR_NAME = process.env.AI_SDLC_CONFIG_DIR ?? '.ai-sdlc';
+// ── Sandbox constraints ──────────────────────────────────────────────
+export const DEFAULT_SANDBOX_MEMORY_MB = 512;
+export const DEFAULT_SANDBOX_CPU_PERCENT = 80;
+export const DEFAULT_SANDBOX_NETWORK_POLICY = 'egress-only';
+export const DEFAULT_SANDBOX_TIMEOUT_MS = process.env.AI_SDLC_SANDBOX_TIMEOUT
+    ? parseDuration(process.env.AI_SDLC_SANDBOX_TIMEOUT) || 1_800_000
+    : 1_800_000; // 30 minutes
+/** Build a SandboxConstraints object from defaults, optionally overriding timeout and workDir. */
+export function defaultSandboxConstraints(workDir, timeoutMs) {
+    return {
+        maxMemoryMb: DEFAULT_SANDBOX_MEMORY_MB,
+        maxCpuPercent: DEFAULT_SANDBOX_CPU_PERCENT,
+        networkPolicy: DEFAULT_SANDBOX_NETWORK_POLICY,
+        timeoutMs: timeoutMs ?? DEFAULT_SANDBOX_TIMEOUT_MS,
+        allowedPaths: [workDir],
+    };
+}
+// ── Runner ───────────────────────────────────────────────────────────
+export const DEFAULT_RUNNER_TIMEOUT_MS = process.env.AI_SDLC_RUNNER_TIMEOUT
+    ? parseDuration(process.env.AI_SDLC_RUNNER_TIMEOUT) || 900_000
+    : 900_000; // 15 minutes
+export const DEFAULT_ALLOWED_TOOLS = 'Edit,Write,Read,Glob,Grep,Bash';
+// ── Agent constraints ────────────────────────────────────────────────
+export const DEFAULT_MAX_FILES_PER_CHANGE = 15;
+export const DEFAULT_REQUIRE_TESTS = true;
+export const DEFAULT_BLOCKED_PATHS = ['.github/workflows/**', `${DEFAULT_CONFIG_DIR_NAME}/**`];
+// ── Agent prompt commands ────────────────────────────────────────────
+/**
+ * Lint command injected into agent prompts.
+ * Undefined by default — users opt in via AI_SDLC_LINT_COMMAND env var
+ * or by passing `lintCommand` in AgentContext.
+ */
+export const DEFAULT_LINT_COMMAND = process.env.AI_SDLC_LINT_COMMAND ?? undefined;
+/**
+ * Format command injected into agent prompts.
+ * Undefined by default — users opt in via AI_SDLC_FORMAT_COMMAND env var
+ * or by passing `formatCommand` in AgentContext.
+ */
+export const DEFAULT_FORMAT_COMMAND = process.env.AI_SDLC_FORMAT_COMMAND ?? undefined;
+// ── Commit message ──────────────────────────────────────────────────
+export const DEFAULT_COMMIT_MESSAGE_TEMPLATE = process.env.AI_SDLC_COMMIT_MESSAGE_TEMPLATE ??
+    'fix: resolve issue #{issueNumber}\n\n{issueTitle}';
+export const DEFAULT_COMMIT_CO_AUTHOR = process.env.AI_SDLC_COMMIT_CO_AUTHOR ?? 'Claude <noreply@anthropic.com>';
+// ── Runner registry API defaults ────────────────────────────────────
+export const DEFAULT_OPENAI_API_URL = 'https://api.openai.com/v1/chat/completions';
+export const DEFAULT_OPENAI_MODEL = 'gpt-4';
+export const DEFAULT_ANTHROPIC_API_URL = 'https://api.anthropic.com/v1/messages';
+export const DEFAULT_ANTHROPIC_MODEL = 'claude-sonnet-4-5-20250929';
+export const DEFAULT_GENERIC_LLM_MODEL = 'default';
+// ── CLI runner model overrides ────────────────────────────────────────
+export const DEFAULT_COPILOT_MODEL = process.env.AI_SDLC_COPILOT_MODEL;
+export const DEFAULT_CURSOR_MODEL = process.env.AI_SDLC_CURSOR_MODEL;
+export const DEFAULT_CODEX_MODEL = process.env.AI_SDLC_CODEX_MODEL;
+// ── Generic LLM defaults ───────────────────────────────────────────
+export const DEFAULT_LLM_TIMEOUT_MS = 120_000;
+export const DEFAULT_LLM_MAX_TOKENS = 4096;
+export const DEFAULT_LLM_SYSTEM_PROMPT = 'You are a software engineering agent. Implement code changes as instructed.';
+// ── Docker / CI adapter defaults ────────────────────────────────────
+export const DEFAULT_DOCKER_IMAGE = 'node:20-slim';
+export const DEFAULT_WORKFLOW_FILE = 'ci.yml';
+// ── Discovery ───────────────────────────────────────────────────────
+export const DEFAULT_LABEL_TO_SKILL_MAP = {
+    bug: 'debugging',
+    feature: 'implementation',
+    docs: 'documentation',
+    test: 'testing',
+    refactor: 'refactoring',
+    security: 'security-analysis',
+    performance: 'optimization',
+};
+// ── Analysis cache ──────────────────────────────────────────────────
+export const DEFAULT_ANALYSIS_CACHE_TTL_MS = process.env.AI_SDLC_ANALYSIS_CACHE_TTL
+    ? Number(process.env.AI_SDLC_ANALYSIS_CACHE_TTL)
+    : 86_400_000; // 24 hours
+// ── Fix-CI ───────────────────────────────────────────────────────────
+export const DEFAULT_MAX_FIX_ATTEMPTS = 2;
+export const DEFAULT_MAX_LOG_LINES = 150;
+export const DEFAULT_GH_CLI_TIMEOUT_MS = process.env.AI_SDLC_GH_CLI_TIMEOUT
+    ? parseDuration(process.env.AI_SDLC_GH_CLI_TIMEOUT) || 30_000
+    : 30_000;
+// ── JIT credentials ──────────────────────────────────────────────────
+export const DEFAULT_JIT_TTL_MS = process.env.AI_SDLC_JIT_TTL
+    ? parseDuration(process.env.AI_SDLC_JIT_TTL) || 600_000
+    : 600_000; // 10 minutes
+export const DEFAULT_JIT_SCOPE = ['repo:read', 'repo:write'];
+// ── Branch naming ────────────────────────────────────────────────────
+export const DEFAULT_BRANCH_TEMPLATE = 'ai-sdlc/issue-{issueNumber}';
+export const DEFAULT_BRANCH_PATTERN = /^ai-sdlc\/issue-(\d+)$/;
+// ── PR templates ─────────────────────────────────────────────────────
+export const DEFAULT_PR_TITLE_TEMPLATE = 'fix: {issueTitle} (#{issueNumber})';
+// ── PR footer ────────────────────────────────────────────────────────
+export const DEFAULT_PR_FOOTER = '*This PR was generated by [AI-SDLC](https://github.com/ai-sdlc-framework/ai-sdlc).*';
+// ── Complexity routing ───────────────────────────────────────────────
+export const DEFAULT_COMPLEXITY_THRESHOLDS = {
+    'fully-autonomous': { min: 1, max: 3, strategy: 'fully-autonomous' },
+    'ai-with-review': { min: 4, max: 5, strategy: 'ai-with-review' },
+    'ai-assisted': { min: 6, max: 8, strategy: 'ai-assisted' },
+    'human-led': { min: 9, max: 10, strategy: 'human-led' },
+};
+// ── Autonomy guardrails ──────────────────────────────────────────────
+export const DEFAULT_MAX_LINES_PER_PR = {
+    level0: 100,
+    level1: 300,
+    level2: 500,
+};
+// ── Notification titles ──────────────────────────────────────────────
+// ── Codebase analysis ───────────────────────────────────────────
+export const DEFAULT_ANALYSIS_INCLUDE = ['**/*.ts', '**/*.tsx', '**/*.js', '**/*.jsx'];
+export const DEFAULT_ANALYSIS_EXCLUDE = [
+    'node_modules/**',
+    '.git/**',
+    'dist/**',
+    'build/**',
+    'coverage/**',
+    '**/*.d.ts',
+    '**/*.min.js',
+    '**/*.map',
+];
+export const DEFAULT_GIT_HISTORY_DAYS = 90;
+export const DEFAULT_HOTSPOT_THRESHOLD = 0.3;
+// ── Notification titles ──────────────────────────────────────────
+// ── Model cost mapping ──────────────────────────────────────────
+/** Cost per million tokens for known models (input/output/cache-read). */
+export const DEFAULT_MODEL_COSTS = {
+    'claude-opus-4-6': { inputPer1M: 15.0, outputPer1M: 75.0, cacheReadPer1M: 1.5 },
+    'claude-sonnet-4-5-20250929': { inputPer1M: 3.0, outputPer1M: 15.0, cacheReadPer1M: 0.3 },
+    'claude-haiku-4-5-20251001': { inputPer1M: 0.8, outputPer1M: 4.0, cacheReadPer1M: 0.08 },
+    'claude-sonnet-4-20250514': { inputPer1M: 3.0, outputPer1M: 15.0, cacheReadPer1M: 0.3 },
+    'claude-3-5-haiku-20241022': { inputPer1M: 1.0, outputPer1M: 5.0, cacheReadPer1M: 0.1 },
+};
+/** Default monthly cost budget in USD. */
+export const DEFAULT_COST_BUDGET_USD = 500;
+/** Dashboard refresh interval in milliseconds. */
+export const DEFAULT_DASHBOARD_REFRESH_MS = 2_000;
+/** Static gate profiles per complexity band (RFC 217-228). */
+export const PROGRESSIVE_GATE_PROFILES = [
+    {
+        band: 'trivial',
+        minScore: 1,
+        maxScore: 3,
+        defaultEnforcement: 'advisory',
+        testCoverageThreshold: 60,
+        reviewRequired: false,
+        securityScanRequired: false,
+        documentationRequired: false,
+    },
+    {
+        band: 'standard',
+        minScore: 4,
+        maxScore: 6,
+        defaultEnforcement: 'soft-mandatory',
+        testCoverageThreshold: 75,
+        reviewRequired: true,
+        securityScanRequired: false,
+        documentationRequired: false,
+    },
+    {
+        band: 'complex',
+        minScore: 7,
+        maxScore: 8,
+        defaultEnforcement: 'hard-mandatory',
+        testCoverageThreshold: 85,
+        reviewRequired: true,
+        securityScanRequired: true,
+        documentationRequired: true,
+    },
+    {
+        band: 'critical',
+        minScore: 9,
+        maxScore: 10,
+        defaultEnforcement: 'hard-mandatory',
+        testCoverageThreshold: 90,
+        reviewRequired: true,
+        securityScanRequired: true,
+        documentationRequired: true,
+    },
+];
+// ── Notification titles ──────────────────────────────────────────
+export const NOTIFICATION_TITLES = {
+    issueValidationFailed: 'AI-SDLC: Issue Validation Failed',
+    complexityTooHigh: 'AI-SDLC: Complexity Too High',
+    agentFailed: 'AI-SDLC: Agent Failed',
+    guardrailViolations: 'AI-SDLC: Guardrail Violations',
+    prCreated: 'AI-SDLC: PR Created',
+    fixCIRetryLimit: 'AI-SDLC: Fix-CI Retry Limit Reached',
+    fixCIAgentFailed: 'AI-SDLC: Fix-CI Agent Failed',
+    fixCIGuardrailViolations: 'AI-SDLC: Fix-CI Guardrail Violations',
+    fixCIApplied: 'AI-SDLC: Fix-CI Applied',
+};
+//# sourceMappingURL=defaults.js.map

package/dist/deploy/flyio-target.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Fly.io deployment target — deploys via Machines API or flyctl CLI.
+ */
+import type { DeploymentTarget, FetchFn, ExecFn } from './types.js';
+export interface FlyioConfig {
+    /** Fly.io API token. */
+    token: string;
+    /** Fly.io application name. */
+    appName: string;
+    /** Use flyctl CLI mode instead of API. */
+    useCliMode?: boolean;
+    /** Fly.io API base URL (defaults to https://api.machines.dev). */
+    apiBase?: string;
+}
+export declare function createFlyioTarget(config: FlyioConfig, opts?: {
+    fetch?: FetchFn;
+    exec?: ExecFn;
+}): DeploymentTarget;
+//# sourceMappingURL=flyio-target.d.ts.map

package/dist/deploy/flyio-target.js

@@ -0,0 +1,114 @@
+/**
+ * Fly.io deployment target — deploys via Machines API or flyctl CLI.
+ */
+export function createFlyioTarget(config, opts) {
+    const httpFetch = opts?.fetch ?? globalThis.fetch;
+    const exec = opts?.exec;
+    const apiBase = config.apiBase ?? 'https://api.machines.dev';
+    const deployments = new Map();
+    function headers() {
+        return {
+            'Content-Type': 'application/json',
+            Authorization: `Bearer ${config.token}`,
+        };
+    }
+    return {
+        async deploy(version, environment) {
+            const id = `fly-${Date.now()}-${environment}`;
+            const result = {
+                id,
+                state: 'deploying',
+                version,
+                startedAt: new Date().toISOString(),
+            };
+            try {
+                if (config.useCliMode && exec) {
+                    const { stdout } = await exec('flyctl', [
+                        'deploy',
+                        '--app',
+                        config.appName,
+                        '--image',
+                        version,
+                        '--now',
+                    ]);
+                    result.url = extractFlyUrl(stdout, config.appName);
+                }
+                else {
+                    // Machines API: list machines, then update each
+                    const listRes = await httpFetch(`${apiBase}/v1/apps/${config.appName}/machines`, {
+                        headers: headers(),
+                    });
+                    if (!listRes.ok)
+                        throw new Error(`Fly.io list machines failed: ${listRes.status}`);
+                    const machines = (await listRes.json());
+                    for (const machine of machines) {
+                        const updateRes = await httpFetch(`${apiBase}/v1/apps/${config.appName}/machines/${machine.id}`, {
+                            method: 'POST',
+                            headers: headers(),
+                            body: JSON.stringify({
+                                config: { ...machine.config, image: version },
+                            }),
+                        });
+                        if (!updateRes.ok)
+                            throw new Error(`Fly.io update machine ${machine.id} failed: ${updateRes.status}`);
+                    }
+                    result.url = `https://${config.appName}.fly.dev`;
+                }
+                result.state = 'healthy';
+                result.completedAt = new Date().toISOString();
+            }
+            catch (err) {
+                result.state = 'failed';
+                result.error = err instanceof Error ? err.message : String(err);
+                result.completedAt = new Date().toISOString();
+            }
+            deployments.set(id, result);
+            return result;
+        },
+        async getStatus(id) {
+            const cached = deployments.get(id);
+            if (cached)
+                return cached;
+            return { id, state: 'pending', version: 'unknown', startedAt: '' };
+        },
+        async rollback(id) {
+            const rollbackId = `${id}-rollback`;
+            const original = deployments.get(id);
+            const result = {
+                id: rollbackId,
+                state: 'deploying',
+                version: original?.version ?? 'unknown',
+                startedAt: new Date().toISOString(),
+            };
+            try {
+                if (config.useCliMode && exec) {
+                    await exec('flyctl', ['releases', '--app', config.appName, '--json']);
+                    // In CLI mode, trigger a rollback by deploying the previous image
+                    await exec('flyctl', ['deploy', '--app', config.appName, '--strategy', 'rolling']);
+                }
+                else {
+                    // API mode: re-deploy with the original version metadata
+                    const listRes = await httpFetch(`${apiBase}/v1/apps/${config.appName}/machines`, {
+                        headers: headers(),
+                    });
+                    if (!listRes.ok)
+                        throw new Error(`Fly.io list machines failed: ${listRes.status}`);
+                }
+                result.state = 'rolled-back';
+                result.completedAt = new Date().toISOString();
+            }
+            catch (err) {
+                result.state = 'failed';
+                result.error = err instanceof Error ? err.message : String(err);
+                result.completedAt = new Date().toISOString();
+            }
+            deployments.set(rollbackId, result);
+            return result;
+        },
+    };
+}
+function extractFlyUrl(stdout, appName) {
+    const urlMatch = stdout.match(/https?:\/\/[^\s]+/);
+    return urlMatch ? urlMatch[0] : `https://${appName}.fly.dev`;
+}
+//# sourceMappingURL=flyio-target.js.map

package/dist/deploy/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Deployment targets barrel export.
+ */
+export type { DeploymentTargetConfig, HealthCheckConfig, DeploymentState, DeploymentResult, DeploymentTarget, ExecFn, FetchFn, } from './types.js';
+export { createKubernetesTarget } from './kubernetes-target.js';
+export type { KubernetesConfig } from './kubernetes-target.js';
+export { createVercelTarget } from './vercel-target.js';
+export type { VercelConfig } from './vercel-target.js';
+export { createFlyioTarget } from './flyio-target.js';
+export type { FlyioConfig } from './flyio-target.js';
+export type { CanaryStep, CanaryConfig, BlueGreenConfig, RollingConfig, RolloutStrategy, RolloutPhase, RolloutStatus, RolloutMetrics, MetricsSource, RolloutControllerConfig, } from './rollout-types.js';
+export { createHttpMetricsCollector, createStubMetricsCollector } from './metrics-collector.js';
+export type { HttpMetricsConfig } from './metrics-collector.js';
+export { RolloutController } from './rollout-controller.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/deploy/index.js

@@ -0,0 +1,11 @@
+/**
+ * Deployment targets barrel export.
+ */
+export { createKubernetesTarget } from './kubernetes-target.js';
+export { createVercelTarget } from './vercel-target.js';
+export { createFlyioTarget } from './flyio-target.js';
+// Metrics collection
+export { createHttpMetricsCollector, createStubMetricsCollector } from './metrics-collector.js';
+// Rollout controller
+export { RolloutController } from './rollout-controller.js';
+//# sourceMappingURL=index.js.map

package/dist/deploy/kubernetes-target.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Kubernetes deployment target — deploys via K8s API or kubectl CLI.
+ */
+import type { DeploymentTarget, FetchFn, ExecFn } from './types.js';
+export interface KubernetesConfig {
+    /** K8s API server URL (for API mode). */
+    apiServer?: string;
+    /** Bearer token for K8s API auth. */
+    token?: string;
+    /** Namespace to deploy into. */
+    namespace: string;
+    /** Deployment name. */
+    deploymentName: string;
+    /** Container name within the deployment. */
+    containerName: string;
+    /** Image repository (e.g. 'registry.io/app'). */
+    imageRepo: string;
+    /** Use kubectl CLI mode instead of API. */
+    useCliMode?: boolean;
+}
+export declare function createKubernetesTarget(config: KubernetesConfig, opts?: {
+    fetch?: FetchFn;
+    exec?: ExecFn;
+}): DeploymentTarget;
+//# sourceMappingURL=kubernetes-target.d.ts.map

package/dist/deploy/kubernetes-target.js

@@ -0,0 +1,124 @@
+/**
+ * Kubernetes deployment target — deploys via K8s API or kubectl CLI.
+ */
+export function createKubernetesTarget(config, opts) {
+    const httpFetch = opts?.fetch ?? globalThis.fetch;
+    const exec = opts?.exec;
+    const deployments = new Map();
+    function apiUrl(path) {
+        return `${config.apiServer}/apis/apps/v1/namespaces/${config.namespace}${path}`;
+    }
+    function headers() {
+        return {
+            'Content-Type': 'application/strategic-merge-patch+json',
+            ...(config.token ? { Authorization: `Bearer ${config.token}` } : {}),
+        };
+    }
+    return {
+        async deploy(version, environment) {
+            const id = `k8s-${Date.now()}-${environment}`;
+            const image = `${config.imageRepo}:${version}`;
+            const result = {
+                id,
+                state: 'deploying',
+                version,
+                startedAt: new Date().toISOString(),
+            };
+            try {
+                if (config.useCliMode && exec) {
+                    await exec('kubectl', [
+                        'set',
+                        'image',
+                        `deployment/${config.deploymentName}`,
+                        `${config.containerName}=${image}`,
+                        '-n',
+                        config.namespace,
+                    ]);
+                    await exec('kubectl', [
+                        'rollout',
+                        'status',
+                        `deployment/${config.deploymentName}`,
+                        '-n',
+                        config.namespace,
+                        '--timeout=120s',
+                    ]);
+                }
+                else {
+                    const patch = {
+                        spec: {
+                            template: {
+                                spec: {
+                                    containers: [{ name: config.containerName, image }],
+                                },
+                            },
+                        },
+                    };
+                    const res = await httpFetch(apiUrl(`/deployments/${config.deploymentName}`), {
+                        method: 'PATCH',
+                        headers: headers(),
+                        body: JSON.stringify(patch),
+                    });
+                    if (!res.ok)
+                        throw new Error(`K8s API error: ${res.status}`);
+                }
+                result.state = 'healthy';
+                result.completedAt = new Date().toISOString();
+            }
+            catch (err) {
+                result.state = 'failed';
+                result.error = err instanceof Error ? err.message : String(err);
+                result.completedAt = new Date().toISOString();
+            }
+            deployments.set(id, result);
+            return result;
+        },
+        async getStatus(id) {
+            const cached = deployments.get(id);
+            if (cached)
+                return cached;
+            return { id, state: 'pending', version: 'unknown', startedAt: '' };
+        },
+        async rollback(id) {
+            const original = deployments.get(id);
+            const rollbackId = `${id}-rollback`;
+            const result = {
+                id: rollbackId,
+                state: 'deploying',
+                version: original?.version ?? 'unknown',
+                startedAt: new Date().toISOString(),
+            };
+            try {
+                if (config.useCliMode && exec) {
+                    await exec('kubectl', [
+                        'rollout',
+                        'undo',
+                        `deployment/${config.deploymentName}`,
+                        '-n',
+                        config.namespace,
+                    ]);
+                }
+                else {
+                    const res = await httpFetch(apiUrl(`/deployments/${config.deploymentName}`) + '?dryRun=false', {
+                        method: 'PATCH',
+                        headers: headers(),
+                        body: JSON.stringify({
+                            spec: { template: { metadata: { annotations: { 'ai-sdlc/rollback': 'true' } } } },
+                        }),
+                    });
+                    if (!res.ok)
+                        throw new Error(`K8s rollback API error: ${res.status}`);
+                }
+                result.state = 'rolled-back';
+                result.completedAt = new Date().toISOString();
+            }
+            catch (err) {
+                result.state = 'failed';
+                result.error = err instanceof Error ? err.message : String(err);
+                result.completedAt = new Date().toISOString();
+            }
+            deployments.set(rollbackId, result);
+            return result;
+        },
+    };
+}
+//# sourceMappingURL=kubernetes-target.js.map

package/dist/deploy/metrics-collector.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Metrics collection implementations for rollout monitoring.
+ */
+import type { RolloutMetrics, MetricsSource } from './rollout-types.js';
+import type { FetchFn } from './types.js';
+export interface HttpMetricsConfig {
+    /** URL to check for health/metrics. */
+    healthUrl: string;
+    /** Expected HTTP status code (defaults to 200). */
+    expectedStatus?: number;
+    /** Request timeout in ms (defaults to 5000). */
+    timeoutMs?: number;
+    /** Number of sample requests for latency calculation. */
+    sampleCount?: number;
+}
+/**
+ * Collects metrics by probing an HTTP health endpoint.
+ * Measures latency, error rate based on HTTP status, and reports
+ * basic availability metrics.
+ */
+export declare function createHttpMetricsCollector(config: HttpMetricsConfig, opts?: {
+    fetch?: FetchFn;
+}): MetricsSource;
+/**
+ * Creates a metrics source that returns configurable static metrics.
+ * Useful for testing rollout controllers without real infrastructure.
+ */
+export declare function createStubMetricsCollector(defaults?: Partial<RolloutMetrics>): MetricsSource & {
+    setMetrics(m: Partial<RolloutMetrics>): void;
+};
+//# sourceMappingURL=metrics-collector.d.ts.map

package/dist/deploy/metrics-collector.js

@@ -0,0 +1,75 @@
+/**
+ * Metrics collection implementations for rollout monitoring.
+ */
+/**
+ * Collects metrics by probing an HTTP health endpoint.
+ * Measures latency, error rate based on HTTP status, and reports
+ * basic availability metrics.
+ */
+export function createHttpMetricsCollector(config, opts) {
+    const httpFetch = opts?.fetch ?? globalThis.fetch;
+    const expectedStatus = config.expectedStatus ?? 200;
+    const timeoutMs = config.timeoutMs ?? 5000;
+    const sampleCount = config.sampleCount ?? 5;
+    return {
+        async collect(_deploymentId) {
+            const latencies = [];
+            let errors = 0;
+            for (let i = 0; i < sampleCount; i++) {
+                const start = Date.now();
+                try {
+                    const controller = new AbortController();
+                    const timer = setTimeout(() => controller.abort(), timeoutMs);
+                    const res = await httpFetch(config.healthUrl, { signal: controller.signal });
+                    clearTimeout(timer);
+                    const elapsed = Date.now() - start;
+                    latencies.push(elapsed);
+                    if (res.status !== expectedStatus)
+                        errors++;
+                }
+                catch {
+                    errors++;
+                    latencies.push(timeoutMs);
+                }
+            }
+            // Sort latencies for P95
+            latencies.sort((a, b) => a - b);
+            const p95Index = Math.min(Math.ceil(latencies.length * 0.95) - 1, latencies.length - 1);
+            const p95 = latencies[p95Index] ?? 0;
+            const successCount = sampleCount - errors;
+            return {
+                errorRate: errors / sampleCount,
+                latencyP95Ms: p95,
+                requestsPerSecond: successCount, // approximation from sample
+                healthyInstances: successCount > 0 ? 1 : 0,
+                totalInstances: 1,
+                collectedAt: new Date().toISOString(),
+            };
+        },
+    };
+}
+// ── Stub Metrics Collector (for testing) ────────────────────────────
+/**
+ * Creates a metrics source that returns configurable static metrics.
+ * Useful for testing rollout controllers without real infrastructure.
+ */
+export function createStubMetricsCollector(defaults) {
+    let current = {
+        errorRate: 0,
+        latencyP95Ms: 50,
+        requestsPerSecond: 100,
+        healthyInstances: 3,
+        totalInstances: 3,
+        collectedAt: new Date().toISOString(),
+        ...defaults,
+    };
+    return {
+        async collect(_deploymentId) {
+            return { ...current, collectedAt: new Date().toISOString() };
+        },
+        setMetrics(m) {
+            current = { ...current, ...m };
+        },
+    };
+}
+//# sourceMappingURL=metrics-collector.js.map