@llm-dev-ops/agentics-cli 2.7.41 → 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/output-validator.d.ts

@@ -26,8 +26,13 @@ export declare function validateSparc(filePath: string): StructuralCheckResult;
  */
 export declare function validateAdrDir(adrDir: string): StructuralCheckResult[];
 /**
- * Verify the implementation-prompts directory has numbered prompts in the
- * impl-NNN-*.md form. Counts the prompts and reports zero or too-few cases.
+ * Verify the implementation-prompts directory. Accepts EITHER:
+ *   - the consolidated single-file format (ADR-PIPELINE-104): one
+ *     `implementation-prompts.md` with ≥ minPrompts `## Implement ADR-`
+ *     sections; OR
+ *   - the legacy multi-file format (ADR-PIPELINE-101): ≥ minPrompts files
+ *     matching `impl-NNN-*.md` (for any local fallback paths that still
+ *     emit this shape).
  */
 export declare function validateImplementationPrompts(promptsDir: string, minPrompts?: number): StructuralCheckResult;
 /**

package/dist/pipeline/output-validator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"output-validator.d.ts","sourceRoot":"","sources":["../../src/pipeline/output-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,OAAO,GAAG,KAAK,GAAG,wBAAwB,CAAC;CACnE;AAcD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,qBAAqB,CAoBrE;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,qBAAqB,EAAE,CAuCtE;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAC3C,UAAU,EAAE,MAAM,EAClB,UAAU,SAAI,GACb,qBAAqB,CAkCvB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,SAAS,qBAAqB,EAAE,EACzC,UAAU,EAAE,MAAM,GACjB,MAAM,CAUR"}
+{"version":3,"file":"output-validator.d.ts","sourceRoot":"","sources":["../../src/pipeline/output-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,OAAO,GAAG,KAAK,GAAG,wBAAwB,CAAC;CACnE;AAcD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,qBAAqB,CAoBrE;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,qBAAqB,EAAE,CAuCtE;AAED;;;;;;;;GAQG;AACH,wBAAgB,6BAA6B,CAC3C,UAAU,EAAE,MAAM,EAClB,UAAU,SAAK,GACd,qBAAqB,CAuFvB;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,SAAS,qBAAqB,EAAE,EACzC,UAAU,EAAE,MAAM,GACjB,MAAM,CAUR"}

package/dist/pipeline/output-validator.js

@@ -94,10 +94,15 @@ export function validateAdrDir(adrDir) {
     });
 }
 /**
- * Verify the implementation-prompts directory has numbered prompts in the
- * impl-NNN-*.md form. Counts the prompts and reports zero or too-few cases.
+ * Verify the implementation-prompts directory. Accepts EITHER:
+ *   - the consolidated single-file format (ADR-PIPELINE-104): one
+ *     `implementation-prompts.md` with ≥ minPrompts `## Implement ADR-`
+ *     sections; OR
+ *   - the legacy multi-file format (ADR-PIPELINE-101): ≥ minPrompts files
+ *     matching `impl-NNN-*.md` (for any local fallback paths that still
+ *     emit this shape).
  */
-export function validateImplementationPrompts(promptsDir, minPrompts = 5) {
+export function validateImplementationPrompts(promptsDir, minPrompts = 10) {
     if (!fs.existsSync(promptsDir)) {
         return {
             ok: false,
@@ -106,6 +111,48 @@ export function validateImplementationPrompts(promptsDir, minPrompts = 5) {
             artifactKind: 'implementation-prompts',
         };
     }
+    // ── consolidated single-file path ─────────────────────────────────────
+    const consolidatedPath = path.join(promptsDir, 'implementation-prompts.md');
+    if (fs.existsSync(consolidatedPath)) {
+        let content;
+        try {
+            content = fs.readFileSync(consolidatedPath, 'utf-8');
+        }
+        catch (err) {
+            return {
+                ok: false,
+                missing: [`unreadable: ${err instanceof Error ? err.message : String(err)}`],
+                filePath: consolidatedPath,
+                artifactKind: 'implementation-prompts',
+            };
+        }
+        const sectionRe = /^##\s+Implement\s+ADR-/gim;
+        const matches = content.match(sectionRe) ?? [];
+        const failureSectionRe = /^##\s+Implement\s+ADR-FAIL-/im;
+        if (failureSectionRe.test(content)) {
+            return {
+                ok: false,
+                missing: ['implementation-prompts.md contains an "Implement ADR-FAIL-…" section — ADR-FAIL stubs must be filtered out'],
+                filePath: consolidatedPath,
+                artifactKind: 'implementation-prompts',
+            };
+        }
+        if (matches.length < minPrompts) {
+            return {
+                ok: false,
+                missing: [`consolidated implementation-prompts.md has ${matches.length} sections (expected at least ${minPrompts})`],
+                filePath: consolidatedPath,
+                artifactKind: 'implementation-prompts',
+            };
+        }
+        return {
+            ok: true,
+            missing: [],
+            filePath: consolidatedPath,
+            artifactKind: 'implementation-prompts',
+        };
+    }
+    // ── legacy multi-file path ────────────────────────────────────────────
     let files;
     try {
         files = fs.readdirSync(promptsDir).filter((f) => /^impl-\d+-.+\.md$/.test(f));
@@ -121,11 +168,21 @@ export function validateImplementationPrompts(promptsDir, minPrompts = 5) {
     if (files.length < minPrompts) {
         return {
             ok: false,
-            missing: [`expected at least ${minPrompts} prompts, found ${files.length}`],
+            missing: [`expected at least ${minPrompts} prompts (consolidated implementation-prompts.md OR impl-NNN-*.md files), found ${files.length}`],
             filePath: promptsDir,
             artifactKind: 'implementation-prompts',
         };
     }
+    // Reject any legacy impl-NNN file whose title contains "adr-failed".
+    const failureFile = files.find((f) => /adr-failed|adr-fail/i.test(f));
+    if (failureFile) {
+        return {
+            ok: false,
+            missing: [`legacy impl prompts include a failure-stub file: ${failureFile} — ADR-FAIL stubs must be filtered upstream`],
+            filePath: path.join(promptsDir, failureFile),
+            artifactKind: 'implementation-prompts',
+        };
+    }
     return {
         ok: true,
         missing: [],

package/dist/pipeline/output-validator.js.map

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

package/dist/pipeline/phase2/phases/adr-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adr-generator.d.ts","sourceRoot":"","sources":["../../../../src/pipeline/phase2/phases/adr-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAQH,OAAO,KAAK,EACV,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EAGf,eAAe,EAChB,MAAM,aAAa,CAAC;AAmIrB;;;;;;;;;;GAUG;AACH,wBAAsB,eAAe,CAAC,KAAK,EAAE,iBAAiB,EAAE,OAAO,EAAE,eAAe,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CA4BpI;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,eAAe,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAkBnF;AAipBD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,eAAe,CAwFlB;AAiGD,wBAAsB,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA8IrF"}
+{"version":3,"file":"adr-generator.d.ts","sourceRoot":"","sources":["../../../../src/pipeline/phase2/phases/adr-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAQH,OAAO,KAAK,EACV,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EAGf,eAAe,EAChB,MAAM,aAAa,CAAC;AAmIrB;;;;;;;;;;GAUG;AACH,wBAAsB,eAAe,CAAC,KAAK,EAAE,iBAAiB,EAAE,OAAO,EAAE,eAAe,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CA4BpI;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,eAAe,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAkBnF;AAmpBD;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,eAAe,CAwFlB;AAiGD,wBAAsB,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA8IrF"}

package/dist/pipeline/phase2/phases/adr-generator.js

@@ -201,7 +201,7 @@ async function tryGenerateLLMADRs(sparc, dossier, query, phase2Dir = '') {
     try {
         const claudeBin = resolveClaudeBin();
         if (!claudeBin) {
-            process.stderr.write('[adr-generator] claude binary not found — cannot generate LLM ADRs\n');
+            process.stderr.write('[CANNED FALLBACK] [adr-generator] claude binary not found on PATH — falling back to ADR-FAIL-001 stub. Set AGENTICS_CLAUDE_BIN or install Claude Code.\n');
             return null;
         }
         const delimiter = newDocBreakDelimiter();
@@ -209,10 +209,11 @@ async function tryGenerateLLMADRs(sparc, dossier, query, phase2Dir = '') {
         const model = process.env['AGENTICS_CLAUDE_MODEL'] || 'claude-sonnet-4-20250514';
         const timeoutMs = parseAdrTimeoutMs();
         const startMs = Date.now();
+        process.stderr.write(`[adr-generator] starting claude --print: model=${model}, timeout=${Math.round(timeoutMs / 1000)}s, prompt=${prompt.length} chars\n`);
         const result = await runStreamedClaudePrint(claudeBin, prompt, model, timeoutMs, phase2Dir);
         if (!result.ok) {
-            process.stderr.write(`[adr-generator] Claude --print stream failed: ${result.reason} ` +
-                `(received ${result.stdoutBytes} bytes over ${result.elapsedMs}ms)\n`);
+            process.stderr.write(`[CANNED FALLBACK] [adr-generator] Claude --print stream failed: ${result.reason} ` +
+                `(received ${result.stdoutBytes} bytes over ${result.elapsedMs}ms) — will salvage partial output if ≥1KB, otherwise emit ADR-FAIL-001 stub\n`);
             // ADR-PIPELINE-100 §D3: streamed output is preserved on timeout/kill, so
             // we still try to parse what came back — if the LLM finished the first
             // few ADRs before the cap, those are usable.
@@ -227,7 +228,7 @@ async function tryGenerateLLMADRs(sparc, dossier, query, phase2Dir = '') {
         }
         const adrs = parseMarkdownADRs(result.stdout, delimiter, dossier);
         if (!adrs || adrs.length === 0) {
-            process.stderr.write('[adr-generator] Claude --print returned no parseable markdown ADRs\n');
+            process.stderr.write(`[CANNED FALLBACK] [adr-generator] Claude --print returned ${result.stdoutBytes} bytes but parseMarkdownADRs extracted 0 ADRs — delimiter "${delimiter.slice(0, 40)}…" not found or markdown malformed. Falling back to ADR-FAIL-001 stub.\n`);
             return null;
         }
         const durationMs = Date.now() - startMs;
@@ -236,7 +237,7 @@ async function tryGenerateLLMADRs(sparc, dossier, query, phase2Dir = '') {
         return adrs;
     }
     catch (err) {
-        process.stderr.write(`[adr-generator] LLM ADR generation failed: ${err instanceof Error ? err.message : String(err)}\n`);
+        process.stderr.write(`[CANNED FALLBACK] [adr-generator] LLM ADR generation threw: ${err instanceof Error ? err.message : String(err)} — emitting ADR-FAIL-001 stub. Stack: ${err instanceof Error && err.stack ? err.stack.split('\n').slice(0, 3).join(' | ') : 'n/a'}\n`);
         return null;
     }
 }