@llm-dev-ops/agentics-cli 2.7.42 → 2.8.0

package/dist/pipeline/fleet-dispatch-bounds.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Fleet dispatch bounds — shared timeout / circuit-breaker primitives.
+ *
+ * ADR-PIPELINE-108: the Phase 1 full-fleet dispatch (109 agents) and the
+ * Phase 2–6 phase fanouts must share ONE bounding discipline:
+ *   - a per-agent timeout so no single agent can stall the batch, and
+ *   - a per-fanout cloud circuit breaker so a dead backend short-circuits
+ *     the remaining cloud calls instead of each eating its full timeout.
+ *
+ * These primitives previously lived inside `swarm-orchestrator.ts`, but
+ * `swarm-orchestrator.ts` imports `executeAgentsInvokeCommand` from
+ * `commands/agents.ts`. Having `agents.ts` import the breaker back from the
+ * orchestrator would create an import cycle, so the shared pieces live here
+ * in a leaf module that neither imports from. `swarm-orchestrator.ts`
+ * re-exports `CloudCircuitBreaker` / `CloudBreakerState` for back-compat
+ * (existing tests import them from there).
+ */
+/** Default consecutive cloud-failure threshold before the breaker trips. */
+export declare const DEFAULT_CLOUD_BREAKER_THRESHOLD = 3;
+/** State exposed by `CloudCircuitBreaker.state()`. */
+export interface CloudBreakerState {
+    readonly tripped: boolean;
+    readonly after_n_timeouts: number;
+    readonly agents: ReadonlyArray<string>;
+}
+/**
+ * Per-fanout circuit breaker that trips after N consecutive cloud-tier
+ * failures and short-circuits remaining cloud invocations. Local-tier
+ * successes do not reset the streak; they bypass the breaker.
+ *
+ * Cloud-tier successes DO reset the streak — if even one cloud call works,
+ * we trust the cloud is alive again. This matches the originating-run
+ * failure mode where an entire backend fleet was down at once.
+ *
+ * Resets per fanout. Exported for unit tests.
+ */
+export declare class CloudCircuitBreaker {
+    private consecutiveCloudFailures;
+    private trippedFlag;
+    private trippedAfterN;
+    private readonly trippedAgents;
+    private readonly threshold;
+    constructor(threshold?: number);
+    /**
+     * Record an invocation outcome. `tier` is the tier the call was dispatched
+     * on. `failed=true` AND `tier='cloud'` increments the consecutive-failure
+     * counter; a cloud success resets it.
+     */
+    record(failed: boolean, tier: 'cloud' | 'local' | 'unknown', agentLabel: string): void;
+    /** Returns true once the breaker has tripped. */
+    shouldSkip(): boolean;
+    /** Snapshot of the breaker state for status.json / gate-decision-log. */
+    state(): CloudBreakerState;
+}
+/**
+ * Resolve the cloud-breaker threshold from env (`AGENTICS_CLOUD_BREAKER_THRESHOLD`).
+ * Falls back to the default constant.
+ */
+export declare function resolveCloudBreakerThreshold(): number;
+/** Default per-agent invocation timeout for the Phase 1 fleet (matches the
+ *  Phase 2–6 path's 30s). Env override: `AGENTICS_FLEET_AGENT_TIMEOUT_MS`. */
+export declare const DEFAULT_FLEET_AGENT_TIMEOUT_MS = 30000;
+/** Default fleet-wide deadline. Larger than a phase fanout (the fleet is
+ *  ~109 agents). Env override: `AGENTICS_FLEET_TIMEOUT_MS`. */
+export declare const DEFAULT_FLEET_TIMEOUT_MS = 60000;
+/** Per-agent timeout for the fleet (D1). */
+export declare function resolveFleetAgentTimeoutMs(): number;
+/** Fleet-wide deadline (D2). */
+export declare function resolveFleetTimeoutMs(): number;
+/** The effective bounds, for recording into manifest.json (D5). */
+export interface FleetDispatchConfig {
+    readonly agent_timeout_ms: number;
+    readonly fleet_timeout_ms: number;
+    readonly cloud_breaker_threshold: number;
+}
+export declare function resolveFleetDispatchConfig(): FleetDispatchConfig;
+export type AgentTier = 'repo' | 'cloud';
+/**
+ * Pure tier-selection logic (kept in this leaf module so it is unit-testable
+ * without importing the repo-agent-runner, which uses import.meta and breaks
+ * jest). `forced` is the raw `AGENTICS_AGENT_TIER` value.
+ *
+ * - `forced==='cloud'` → cloud
+ * - `forced==='repo'`  → repo if a repo mapping exists, else cloud
+ * - default (`auto`)   → repo only when repo mode is on AND a repo mapping
+ *   exists AND source is actually cached (the D2 gate); else cloud.
+ */
+export declare function decideAgentTier(opts: {
+    forced?: string | undefined;
+    hasRepo: boolean;
+    repoMode: boolean;
+    sourceCached: boolean;
+}): AgentTier;
+/** Sentinel returned by {@link withAgentTimeout} when the deadline wins. */
+export declare const AGENT_TIMED_OUT: unique symbol;
+/**
+ * Race a promise against a timeout. Resolves to {@link AGENT_TIMED_OUT} when
+ * the deadline fires first. The underlying promise is NOT cancelled (Node has
+ * no cancellation), but the caller stops waiting on it — the key property the
+ * Phase 1 fleet needs so one slow agent cannot stall the batch.
+ *
+ * The timer is cleared on settle so it never keeps the event loop alive.
+ */
+export declare function withAgentTimeout<T>(promise: Promise<T>, ms: number): Promise<T | typeof AGENT_TIMED_OUT>;
+/** Sentinel returned by {@link raceFleetDeadline} when the fleet deadline wins. */
+export declare const FLEET_TIMED_OUT: "TIMEOUT";
+/**
+ * ADR-PIPELINE-108 D2: race the whole agent batch against a wall-clock fleet
+ * deadline. Returns the settled batch if it finishes first, else
+ * {@link FLEET_TIMED_OUT}. The deadline timer is cleared on settle so a normal
+ * (non-timeout) completion never leaves a dangling timer holding the event loop
+ * open — important for long-lived (daemon/server) callers.
+ */
+export declare function raceFleetDeadline<T>(batch: Promise<T>, ms: number): Promise<T | typeof FLEET_TIMED_OUT>;
+//# sourceMappingURL=fleet-dispatch-bounds.d.ts.map

package/dist/pipeline/fleet-dispatch-bounds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fleet-dispatch-bounds.d.ts","sourceRoot":"","sources":["../../src/pipeline/fleet-dispatch-bounds.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAMH,4EAA4E;AAC5E,eAAO,MAAM,+BAA+B,IAAI,CAAC;AAEjD,sDAAsD;AACtD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;CACxC;AAED;;;;;;;;;;GAUG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,wBAAwB,CAAK;IACrC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAgB;IAC9C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,SAAS,SAAkC;IAIvD;;;;OAIG;IACH,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAqBtF,iDAAiD;IACjD,UAAU,IAAI,OAAO;IAErB,yEAAyE;IACzE,KAAK,IAAI,iBAAiB;CAO3B;AAED;;;GAGG;AACH,wBAAgB,4BAA4B,IAAI,MAAM,CAOrD;AAMD;8EAC8E;AAC9E,eAAO,MAAM,8BAA8B,QAAS,CAAC;AAErD;+DAC+D;AAC/D,eAAO,MAAM,wBAAwB,QAAS,CAAC;AAW/C,4CAA4C;AAC5C,wBAAgB,0BAA0B,IAAI,MAAM,CAEnD;AAED,gCAAgC;AAChC,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAED,mEAAmE;AACnE,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,uBAAuB,EAAE,MAAM,CAAC;CAC1C;AAED,wBAAgB,0BAA0B,IAAI,mBAAmB,CAMhE;AAMD,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;AAEzC;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE;IACpC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,YAAY,EAAE,OAAO,CAAC;CACvB,GAAG,SAAS,CAMZ;AAED,4EAA4E;AAC5E,eAAO,MAAM,eAAe,eAA4B,CAAC;AAEzD;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,EACtC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EACnB,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,CAAC,GAAG,OAAO,eAAe,CAAC,CAUrC;AAED,mFAAmF;AACnF,eAAO,MAAM,eAAe,EAAG,SAAkB,CAAC;AAElD;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CAAC,CAAC,EACvC,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,EACjB,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,CAAC,GAAG,OAAO,eAAe,CAAC,CAUrC"}

package/dist/pipeline/fleet-dispatch-bounds.js

@@ -0,0 +1,190 @@
+/**
+ * Fleet dispatch bounds — shared timeout / circuit-breaker primitives.
+ *
+ * ADR-PIPELINE-108: the Phase 1 full-fleet dispatch (109 agents) and the
+ * Phase 2–6 phase fanouts must share ONE bounding discipline:
+ *   - a per-agent timeout so no single agent can stall the batch, and
+ *   - a per-fanout cloud circuit breaker so a dead backend short-circuits
+ *     the remaining cloud calls instead of each eating its full timeout.
+ *
+ * These primitives previously lived inside `swarm-orchestrator.ts`, but
+ * `swarm-orchestrator.ts` imports `executeAgentsInvokeCommand` from
+ * `commands/agents.ts`. Having `agents.ts` import the breaker back from the
+ * orchestrator would create an import cycle, so the shared pieces live here
+ * in a leaf module that neither imports from. `swarm-orchestrator.ts`
+ * re-exports `CloudCircuitBreaker` / `CloudBreakerState` for back-compat
+ * (existing tests import them from there).
+ */
+// ============================================================================
+// Cloud circuit breaker (ADR-094 D7, generalised by ADR-108)
+// ============================================================================
+/** Default consecutive cloud-failure threshold before the breaker trips. */
+export const DEFAULT_CLOUD_BREAKER_THRESHOLD = 3;
+/**
+ * Per-fanout circuit breaker that trips after N consecutive cloud-tier
+ * failures and short-circuits remaining cloud invocations. Local-tier
+ * successes do not reset the streak; they bypass the breaker.
+ *
+ * Cloud-tier successes DO reset the streak — if even one cloud call works,
+ * we trust the cloud is alive again. This matches the originating-run
+ * failure mode where an entire backend fleet was down at once.
+ *
+ * Resets per fanout. Exported for unit tests.
+ */
+export class CloudCircuitBreaker {
+    consecutiveCloudFailures = 0;
+    trippedFlag = false;
+    trippedAfterN = 0;
+    trippedAgents = [];
+    threshold;
+    constructor(threshold = DEFAULT_CLOUD_BREAKER_THRESHOLD) {
+        this.threshold = Math.max(1, threshold);
+    }
+    /**
+     * Record an invocation outcome. `tier` is the tier the call was dispatched
+     * on. `failed=true` AND `tier='cloud'` increments the consecutive-failure
+     * counter; a cloud success resets it.
+     */
+    record(failed, tier, agentLabel) {
+        if (this.trippedFlag)
+            return; // already tripped — record-only mode
+        if (tier === 'cloud') {
+            if (failed) {
+                this.consecutiveCloudFailures++;
+                this.trippedAgents.push(agentLabel);
+                if (this.consecutiveCloudFailures >= this.threshold) {
+                    this.trippedFlag = true;
+                    this.trippedAfterN = this.consecutiveCloudFailures;
+                    process.stderr.write(`[BREAKER] cloud breaker tripped after ${this.trippedAfterN} timeouts (${this.trippedAgents.slice(0, 5).join(', ')}${this.trippedAgents.length > 5 ? ', …' : ''})\n`);
+                }
+            }
+            else {
+                // Cloud success — clear the streak. Cloud is alive.
+                this.consecutiveCloudFailures = 0;
+            }
+        }
+        // local-tier outcomes don't move the breaker state.
+    }
+    /** Returns true once the breaker has tripped. */
+    shouldSkip() { return this.trippedFlag; }
+    /** Snapshot of the breaker state for status.json / gate-decision-log. */
+    state() {
+        return {
+            tripped: this.trippedFlag,
+            after_n_timeouts: this.trippedAfterN,
+            agents: [...this.trippedAgents],
+        };
+    }
+}
+/**
+ * Resolve the cloud-breaker threshold from env (`AGENTICS_CLOUD_BREAKER_THRESHOLD`).
+ * Falls back to the default constant.
+ */
+export function resolveCloudBreakerThreshold() {
+    const env = process.env['AGENTICS_CLOUD_BREAKER_THRESHOLD'];
+    if (env) {
+        const parsed = parseInt(env, 10);
+        if (!Number.isNaN(parsed) && parsed >= 1)
+            return parsed;
+    }
+    return DEFAULT_CLOUD_BREAKER_THRESHOLD;
+}
+// ============================================================================
+// Per-agent + fleet timeouts (ADR-108 D1, D2, D5)
+// ============================================================================
+/** Default per-agent invocation timeout for the Phase 1 fleet (matches the
+ *  Phase 2–6 path's 30s). Env override: `AGENTICS_FLEET_AGENT_TIMEOUT_MS`. */
+export const DEFAULT_FLEET_AGENT_TIMEOUT_MS = 30_000;
+/** Default fleet-wide deadline. Larger than a phase fanout (the fleet is
+ *  ~109 agents). Env override: `AGENTICS_FLEET_TIMEOUT_MS`. */
+export const DEFAULT_FLEET_TIMEOUT_MS = 60_000;
+function resolvePositiveIntEnv(name, fallback) {
+    const env = process.env[name];
+    if (env) {
+        const parsed = parseInt(env, 10);
+        if (!Number.isNaN(parsed) && parsed >= 1)
+            return parsed;
+    }
+    return fallback;
+}
+/** Per-agent timeout for the fleet (D1). */
+export function resolveFleetAgentTimeoutMs() {
+    return resolvePositiveIntEnv('AGENTICS_FLEET_AGENT_TIMEOUT_MS', DEFAULT_FLEET_AGENT_TIMEOUT_MS);
+}
+/** Fleet-wide deadline (D2). */
+export function resolveFleetTimeoutMs() {
+    return resolvePositiveIntEnv('AGENTICS_FLEET_TIMEOUT_MS', DEFAULT_FLEET_TIMEOUT_MS);
+}
+export function resolveFleetDispatchConfig() {
+    return {
+        agent_timeout_ms: resolveFleetAgentTimeoutMs(),
+        fleet_timeout_ms: resolveFleetTimeoutMs(),
+        cloud_breaker_threshold: resolveCloudBreakerThreshold(),
+    };
+}
+/**
+ * Pure tier-selection logic (kept in this leaf module so it is unit-testable
+ * without importing the repo-agent-runner, which uses import.meta and breaks
+ * jest). `forced` is the raw `AGENTICS_AGENT_TIER` value.
+ *
+ * - `forced==='cloud'` → cloud
+ * - `forced==='repo'`  → repo if a repo mapping exists, else cloud
+ * - default (`auto`)   → repo only when repo mode is on AND a repo mapping
+ *   exists AND source is actually cached (the D2 gate); else cloud.
+ */
+export function decideAgentTier(opts) {
+    const forced = (opts.forced ?? '').toLowerCase();
+    if (forced === 'cloud')
+        return 'cloud';
+    if (forced === 'repo')
+        return opts.hasRepo ? 'repo' : 'cloud';
+    if (opts.repoMode && opts.hasRepo && opts.sourceCached)
+        return 'repo';
+    return 'cloud';
+}
+/** Sentinel returned by {@link withAgentTimeout} when the deadline wins. */
+export const AGENT_TIMED_OUT = Symbol('agent-timed-out');
+/**
+ * Race a promise against a timeout. Resolves to {@link AGENT_TIMED_OUT} when
+ * the deadline fires first. The underlying promise is NOT cancelled (Node has
+ * no cancellation), but the caller stops waiting on it — the key property the
+ * Phase 1 fleet needs so one slow agent cannot stall the batch.
+ *
+ * The timer is cleared on settle so it never keeps the event loop alive.
+ */
+export async function withAgentTimeout(promise, ms) {
+    let timer;
+    const timeout = new Promise((resolve) => {
+        timer = setTimeout(() => resolve(AGENT_TIMED_OUT), ms);
+    });
+    try {
+        return await Promise.race([promise, timeout]);
+    }
+    finally {
+        if (timer)
+            clearTimeout(timer);
+    }
+}
+/** Sentinel returned by {@link raceFleetDeadline} when the fleet deadline wins. */
+export const FLEET_TIMED_OUT = 'TIMEOUT';
+/**
+ * ADR-PIPELINE-108 D2: race the whole agent batch against a wall-clock fleet
+ * deadline. Returns the settled batch if it finishes first, else
+ * {@link FLEET_TIMED_OUT}. The deadline timer is cleared on settle so a normal
+ * (non-timeout) completion never leaves a dangling timer holding the event loop
+ * open — important for long-lived (daemon/server) callers.
+ */
+export async function raceFleetDeadline(batch, ms) {
+    let timer;
+    const deadline = new Promise((resolve) => {
+        timer = setTimeout(() => resolve(FLEET_TIMED_OUT), ms);
+    });
+    try {
+        return await Promise.race([batch, deadline]);
+    }
+    finally {
+        if (timer)
+            clearTimeout(timer);
+    }
+}
+//# sourceMappingURL=fleet-dispatch-bounds.js.map

package/dist/pipeline/fleet-dispatch-bounds.js.map

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

package/dist/pipeline/phase3/phases/domain-codegen.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"domain-codegen.d.ts","sourceRoot":"","sources":["../../../../src/pipeline/phase3/phases/domain-codegen.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EACV,aAAa,EACb,iBAAiB,EACjB,sBAAsB,EAGtB,aAAa,EAEd,MAAM,aAAa,CAAC;AAErB,OAAO,KAAK,EACV,iBAAiB,EAQjB,OAAO,EAGP,iBAAiB,EAGlB,MAAM,uBAAuB,CAAC;AAshH/B;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAC7B,WAAW,EAAE,iBAAiB,EAC9B,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,sBAAsB,EAChC,KAAK,EAAE,iBAAiB,GACvB,aAAa,CA+Uf;AAuiBD;;;;;;;;;;GAUG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,iBAAiB,CAAC,CAwK5B"}
+{"version":3,"file":"domain-codegen.d.ts","sourceRoot":"","sources":["../../../../src/pipeline/phase3/phases/domain-codegen.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EACV,aAAa,EACb,iBAAiB,EACjB,sBAAsB,EAGtB,aAAa,EAEd,MAAM,aAAa,CAAC;AAErB,OAAO,KAAK,EACV,iBAAiB,EAQjB,OAAO,EAGP,iBAAiB,EAGlB,MAAM,uBAAuB,CAAC;AA4hH/B;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAC7B,WAAW,EAAE,iBAAiB,EAC9B,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,sBAAsB,EAChC,KAAK,EAAE,iBAAiB,GACvB,aAAa,CA+Uf;AAuiBD;;;;;;;;;;GAUG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,iBAAiB,CAAC,CAwK5B"}

package/dist/pipeline/phase3/phases/domain-codegen.js

@@ -558,8 +558,14 @@ function extractFieldsFromDescription(description, entityName) {
     // ADR-PIPELINE-021: If description patterns found nothing, try matching against
     // the entity NAME itself (e.g. "UpgradeOptions" → matches "upgrade" pattern).
     // This catches entities with generic descriptions but domain-specific names.
-    if (fields.length === 0) {
-        const nameFields = extractFieldsFromDescription(entityName.replace(/([A-Z])/g, ' $1'), entityName);
+    //
+    // Recurse AT MOST ONCE: only when the description is not already the spaced
+    // entity name. The recursive call passes the spaced name AS the description,
+    // so without this guard it would recurse on identical arguments forever
+    // (Maximum-call-stack-size-exceeded — the domain-codegen crash this fixes).
+    const spacedEntityName = entityName.replace(/([A-Z])/g, ' $1');
+    if (fields.length === 0 && description !== spacedEntityName) {
+        const nameFields = extractFieldsFromDescription(spacedEntityName, entityName);
         if (nameFields.length > 0 && !(nameFields.length === 1 && nameFields[0].type === 'Record<string, unknown>')) {
             fields.push(...nameFields);
         }