@llm-dev-ops/agentics-cli 2.7.16 → 2.7.18

package/dist/pipeline/phase7/coordinator.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Phase 7 — Consulting Deliverables Coordinator (ADR-PIPELINE-098 D1, D5–D9).
+ *
+ * Walks the 85-row deliverables registry and, for each row:
+ *   1. If `mirrorsExisting` is set → symlink (POSIX) or copy (Windows /
+ *      AGENTICS_PHASE7_MIRROR=copy) the pre-existing top-level doc into the
+ *      sectioned subdir; record `status: 'emitted'`.
+ *   2. Otherwise → load `inputArtifacts` from disk into a Record<path,string>,
+ *      build a Ruflo task (templateId + inputs + consensus banner + fcv block
+ *      from `unit-economics.json`), dispatch through the existing
+ *      `executeRufloPhaseSwarm` path used by Phase 5/6, then render the
+ *      response through `template-renderer.renderTemplate` and write to
+ *      `<runDir>/deliverables/<NN-section>/<slug>.<format>`.
+ *   3. On failure → emit a skeleton file with frontmatter
+ *      `degraded_mode: generation-failed` + `failure_reason` + the available /
+ *      missing inputs + the consensus banner + the fcv block. The phase keeps
+ *      going; status drops to `partial`.
+ *
+ * After every row is processed the coordinator writes a markdown index.md and
+ * a machine-readable `phase7-manifest.json` (D9.a schema), then runs the
+ * coherence gate. Any coherence violation drops the phase status to
+ * `partial`.
+ *
+ * Phase 1 input gate (D1 / ADR-094 D4):
+ *   If `<runDir>/manifest.json` does NOT exist, the coordinator fans out
+ *   nothing and returns `status: 'skipped-due-to-upstream'` with reason
+ *   `phase1-inputs-missing`. The caller in `auto-chain.ts` still pushes a
+ *   `phases[]` entry per ADR-094 D4.
+ *
+ * Hard contracts:
+ *   - Never throws. All failures collapse into `Phase7Result.status` +
+ *     per-row entries in the manifest.
+ *   - Pure I/O at the boundary; no globals, no module-level state.
+ *   - Templates dir + registry file + coherence-gate file are owned by other
+ *     agents working in parallel; this file imports them without modifying.
+ */
+import { type CoherenceViolation } from './coherence-gate.js';
+export type DeliverableStatus = 'emitted' | 'skeleton' | 'failed';
+export type Phase7Status = 'completed' | 'partial' | 'failed' | 'skipped-due-to-upstream';
+export interface DeliverableManifestEntry {
+    readonly section: number;
+    readonly slug: string;
+    readonly status: DeliverableStatus;
+    readonly input_artifacts_used: ReadonlyArray<string>;
+    readonly input_artifacts_missing: ReadonlyArray<string>;
+    readonly source_agents_called: ReadonlyArray<string>;
+    readonly fcv_kinds_emitted: ReadonlyArray<string>;
+    readonly timing_ms: number;
+    readonly output_path: string;
+    readonly failure_reason?: string;
+}
+export interface Phase7Manifest {
+    readonly phase: 7;
+    readonly trace_id: string;
+    readonly started_at: string;
+    readonly completed_at: string;
+    readonly total_timing_ms: number;
+    readonly deliverables_total: number;
+    readonly deliverables_emitted: number;
+    readonly deliverables_skeleton: number;
+    readonly deliverables_failed: number;
+    readonly coherence_violations: ReadonlyArray<CoherenceViolation>;
+    readonly deliverables: ReadonlyArray<DeliverableManifestEntry>;
+}
+export interface Phase7Options {
+    readonly verbose?: boolean;
+    readonly outputDir?: string;
+}
+export interface Phase7Result {
+    readonly status: Phase7Status;
+    readonly deliverables_emitted: number;
+    readonly deliverables_skeleton: number;
+    readonly deliverables_failed: number;
+    readonly deliverables_total: number;
+    readonly coherence_violations: ReadonlyArray<CoherenceViolation>;
+    readonly timing_ms: number;
+    /** Absolute paths of the files written during this phase. */
+    readonly output_paths: ReadonlyArray<string>;
+    /** Reason string when `status === 'skipped-due-to-upstream'` or `'failed'`. */
+    readonly reason?: string;
+}
+export interface Phase7Args {
+    readonly runDir: string;
+    readonly traceId: string;
+    readonly scenarioQuery: string;
+    readonly options?: Phase7Options;
+}
+/**
+ * Phase 7 entry point. Returns a `Phase7Result` describing what happened.
+ * Never throws — disk-full and similar conditions are reported as
+ * `status: 'failed'` with `reason` set.
+ */
+export declare function executePhase7(args: Phase7Args): Promise<Phase7Result>;
+//# sourceMappingURL=coordinator.d.ts.map

package/dist/pipeline/phase7/coordinator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coordinator.d.ts","sourceRoot":"","sources":["../../../src/pipeline/phase7/coordinator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAkBH,OAAO,EAEL,KAAK,kBAAkB,EACxB,MAAM,qBAAqB,CAAC;AAoB7B,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,UAAU,GAAG,QAAQ,CAAC;AAElE,MAAM,MAAM,YAAY,GACpB,WAAW,GACX,SAAS,GACT,QAAQ,GACR,yBAAyB,CAAC;AAE9B,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;IACnC,QAAQ,CAAC,oBAAoB,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACrD,QAAQ,CAAC,uBAAuB,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACxD,QAAQ,CAAC,oBAAoB,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IACrD,QAAQ,CAAC,iBAAiB,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAClD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;IAClB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,oBAAoB,EAAE,aAAa,CAAC,kBAAkB,CAAC,CAAC;IACjE,QAAQ,CAAC,YAAY,EAAE,aAAa,CAAC,wBAAwB,CAAC,CAAC;CAChE;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;IACvC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,oBAAoB,EAAE,aAAa,CAAC,kBAAkB,CAAC,CAAC;IACjE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,6DAA6D;IAC7D,QAAQ,CAAC,YAAY,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC;IAC7C,+EAA+E;IAC/E,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,OAAO,CAAC,EAAE,aAAa,CAAC;CAClC;AA2BD;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC,CAgU3E"}