@llm-dev-ops/agentics-cli 2.1.4 → 2.3.0

package/dist/pipeline/auto-chain.d.ts

@@ -44,6 +44,79 @@ export interface AutoChainResult {
     commitHash?: string;
     githubUrl?: string;
 }
+/**
+ * Copy whatever planning artifacts exist from ~/.agentics/runs/<traceId>/
+ * to .agentics/plans/ in the current working directory. Uses .agentics/plans/
+ * instead of plans/ to avoid colliding with any existing plans/ folder in the
+ * project (e.g., SPARC artifacts checked into the repo). Skips files that
+ * already exist with identical content to avoid unnecessary duplication.
+ *
+ * Called after every phase so even if later phases fail, earlier artifacts
+ * are still available.
+ */
+/**
+ * ADR-PIPELINE-068: scaffold body for `src/simulation-lineage.ts`.
+ *
+ * Exported so unit tests can write the file to a temp directory and
+ * exercise the runtime behavior (env override, manifest walk, fallback)
+ * without having to spin up the full pipeline.
+ *
+ * Invariants enforced by tests:
+ * - Uses `readFileSync` + `fileURLToPath` (NEVER `require(`)
+ * - Exports `loadSimulationLineage`, `requireSimulationLineage`,
+ *   `formatLineageBanner`, and the legacy `loadSimulationId` alias
+ * - Walks up at most 6 directories from the module location and from cwd
+ */
+export declare const SIMULATION_LINEAGE_SCAFFOLD = "// Auto-generated by Agentics pipeline (ADR-PIPELINE-068)\n// ESM-safe simulation lineage loader. Reads .agentics/plans/manifest.json\n// (or .agentics/runs/latest/manifest.json) using readFileSync \u2014 never\n// CommonJS require(). Do NOT reimplement this helper; import from it.\nimport { readFileSync, existsSync } from 'node:fs';\nimport { resolve, dirname, join } from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\nexport type SimulationLineageSource = 'env' | 'manifest' | 'fallback';\n\nexport interface SimulationLineage {\n  readonly simulationId: string;\n  readonly traceId: string;\n  readonly runId: string;\n  readonly source: SimulationLineageSource;\n  readonly manifestPath?: string;\n}\n\nconst MANIFEST_CANDIDATES: readonly string[] = [\n  '.agentics/plans/manifest.json',\n  '.agentics/runs/latest/manifest.json',\n];\n\nconst WALK_DEPTH = 6;\n\n/** Walk up from startDir looking for any manifest candidate path. */\nfunction findManifest(startDir: string): string | null {\n  let dir = startDir;\n  for (let i = 0; i < WALK_DEPTH; i++) {\n    for (const rel of MANIFEST_CANDIDATES) {\n      const candidate = resolve(dir, rel);\n      if (existsSync(candidate)) return candidate;\n    }\n    const parent = dirname(dir);\n    if (parent === dir) break;\n    dir = parent;\n  }\n  return null;\n}\n\nfunction moduleDir(): string {\n  try {\n    return dirname(fileURLToPath(import.meta.url));\n  } catch {\n    return process.cwd();\n  }\n}\n\n/**\n * Load the simulation lineage. Permissive \u2014 returns a fallback record when\n * nothing is available. Callers who need strict behavior should use\n * requireSimulationLineage() instead.\n *\n * Resolution order:\n *   1. AGENTICS_SIMULATION_ID / AGENTICS_TRACE_ID environment variables\n *   2. First manifest.json found walking up from this module (then cwd)\n *   3. Fallback record with source='fallback'\n */\nexport function loadSimulationLineage(): SimulationLineage {\n  const envSim = process.env['AGENTICS_SIMULATION_ID'];\n  const envTrace = process.env['AGENTICS_TRACE_ID'];\n  if (envSim) {\n    return {\n      simulationId: envSim,\n      traceId: envTrace ?? envSim,\n      runId: envSim,\n      source: 'env',\n    };\n  }\n\n  const startDirs = [moduleDir(), process.cwd()];\n  for (const start of startDirs) {\n    try {\n      const manifestPath = findManifest(start);\n      if (!manifestPath) continue;\n      const raw = JSON.parse(readFileSync(manifestPath, 'utf-8')) as Record<string, unknown>;\n      const runId = String(raw['run_id'] ?? raw['runId'] ?? '');\n      const simulationId = String(\n        raw['simulation_id'] ?? raw['simulationId'] ?? raw['execution_id'] ?? runId,\n      );\n      const traceId = String(raw['trace_id'] ?? raw['traceId'] ?? simulationId);\n      if (simulationId) {\n        return { simulationId, traceId, runId: runId || simulationId, source: 'manifest', manifestPath };\n      }\n    } catch {\n      // Try the next start dir. Never throw from the permissive loader.\n    }\n  }\n\n  return {\n    simulationId: 'sim-unknown',\n    traceId: 'trace-unknown',\n    runId: 'run-unknown',\n    source: 'fallback',\n  };\n}\n\n/**\n * Strict variant \u2014 throws ECLI-LIN-068 when no simulation lineage is\n * available. Use this at startup when the service MUST carry a real\n * simulation id (audit logs, ERP posts, etc.).\n */\nexport function requireSimulationLineage(): SimulationLineage {\n  const lineage = loadSimulationLineage();\n  if (lineage.source === 'fallback') {\n    throw new Error(\n      'ECLI-LIN-068: simulation lineage unavailable \u2014 set AGENTICS_SIMULATION_ID or place .agentics/plans/manifest.json in the project tree',\n    );\n  }\n  return lineage;\n}\n\n/**\n * Human-readable banner printed by the demo script when the loader falls\n * back. Makes the break visible instead of letting sim-unknown leak into\n * downstream audit logs and ERP posts.\n */\nexport function formatLineageBanner(lineage: SimulationLineage): string {\n  if (lineage.source !== 'fallback') {\n    return `simulation lineage: ${lineage.simulationId} (source: ${lineage.source})`;\n  }\n  return [\n    '',\n    '\u26A0\uFE0F  Simulation lineage unavailable (source: fallback)',\n    '    All audit entries and ERP posts will carry sim-unknown.',\n    '    Fix: place .agentics/plans/manifest.json in the project tree,',\n    '    or set AGENTICS_SIMULATION_ID=<run-id> before running the demo.',\n    '',\n  ].join('\\n');\n}\n\n/** Also exported under the legacy alias some older prompts referenced. */\nexport const loadSimulationId = (): string => loadSimulationLineage().simulationId;\n";
+/**
+ * ADR-PIPELINE-069: scaffold body for `src/circuit-breaker.ts`.
+ *
+ * Extracted from the legacy middleware.ts scaffold so generators can
+ * `import { CircuitBreaker } from './circuit-breaker.js'` without pulling
+ * the entire middleware module. middleware.ts now re-exports this symbol
+ * so existing imports keep working.
+ */
+export declare const CIRCUIT_BREAKER_SCAFFOLD = "// Auto-generated by Agentics pipeline (ADR-PIPELINE-069)\n// Owned by the scaffold \u2014 do NOT redeclare CircuitBreaker in generated code.\nimport { createLogger } from './logger.js';\n\n/** Simple circuit breaker for external service calls. */\nexport class CircuitBreaker {\n  private failures = 0;\n  private state: 'closed' | 'open' | 'half-open' = 'closed';\n  private nextAttempt = 0;\n\n  constructor(\n    private readonly name: string,\n    private readonly threshold = 5,\n    private readonly cooldownMs = 30000,\n    private readonly logger = createLogger('circuit-breaker'),\n  ) {}\n\n  async call<T>(fn: () => Promise<T>): Promise<T> {\n    if (this.state === 'open') {\n      if (Date.now() < this.nextAttempt) {\n        throw new Error(`Circuit breaker '${this.name}' is OPEN \u2014 retry after ${new Date(this.nextAttempt).toISOString()}`);\n      }\n      this.state = 'half-open';\n      this.logger.info('circuit.half-open', { name: this.name });\n    }\n    try {\n      const result = await fn();\n      if (this.state === 'half-open') {\n        this.state = 'closed';\n        this.failures = 0;\n        this.logger.info('circuit.closed', { name: this.name });\n      }\n      return result;\n    } catch (err) {\n      this.failures++;\n      if (this.failures >= this.threshold) {\n        this.state = 'open';\n        this.nextAttempt = Date.now() + this.cooldownMs;\n        this.logger.warn('circuit.open', { name: this.name, failures: this.failures, retryAt: new Date(this.nextAttempt).toISOString() });\n      }\n      throw err;\n    }\n  }\n\n  getState(): string { return this.state; }\n}\n";
+/**
+ * ADR-PIPELINE-069: Single source of truth for scaffold-owned modules.
+ *
+ * Every module the pipeline emits into `.agentics/plans/scaffold/src/` is
+ * listed here with its public exports. The list is consumed by:
+ *   - `copyPlanningArtifacts()`     — writes OWNED_MODULES.json sidecar
+ *   - `prompt-generator.ts`         — injects "do not reimplement" block
+ *   - `post-generation-validator.ts` PGV-012 — bans duplicate declarations
+ *
+ * When you add a new scaffold file, add it here in the same change.
+ */
+export interface OwnedScaffoldModule {
+    readonly path: string;
+    readonly exports: readonly string[];
+}
+export declare const OWNED_SCAFFOLD_MODULES: readonly OwnedScaffoldModule[];
+export interface OwnedModulesManifest {
+    readonly version: '1.0';
+    readonly generated_at: string;
+    readonly owned: readonly OwnedScaffoldModule[];
+}
+export declare function buildOwnedModulesManifest(now?: Date): OwnedModulesManifest;
+export interface ScaffoldDuplicateFinding {
+    /** Absolute path of the file that redeclares an owned export. */
+    readonly path: string;
+    /** The export name that collides. */
+    readonly exportName: string;
+    /** Scaffold path that owns the export. */
+    readonly ownedPath: string;
+}
+/**
+ * ADR-PIPELINE-069: Walk a project tree looking for generator-emitted files
+ * that redeclare an export listed in OWNED_SCAFFOLD_MODULES. Skips:
+ *   - the scaffold-owned files themselves (matched by basename)
+ *   - test files
+ *   - node_modules / dist / .agentics
+ *
+ * Returns one finding per (file, export) pair.
+ */
+export declare function detectScaffoldDuplicates(projectRoot: string, owned?: readonly OwnedScaffoldModule[]): ScaffoldDuplicateFinding[];
 export declare function executeAutoChain(traceId: string, options?: AutoChainOptions): Promise<AutoChainResult>;
 /**
  * Format the auto-chain result for stdout display.

package/dist/pipeline/auto-chain.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auto-chain.d.ts","sourceRoot":"","sources":["../../src/pipeline/auto-chain.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAWH,OAAO,EAGL,KAAK,aAAa,EAEnB,MAAM,wBAAwB,CAAC;AA+BhC,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,CAAC,EAAE,aAAa,CAAC;CACxC;AAED,UAAU,WAAW;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CAC1E;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,aAAa,CAAC;IAC7B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAglBD,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,eAAe,CAAC,CAmjD1B;AA0QD;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAoFzE"}
+{"version":3,"file":"auto-chain.d.ts","sourceRoot":"","sources":["../../src/pipeline/auto-chain.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAWH,OAAO,EAGL,KAAK,aAAa,EAEnB,MAAM,wBAAwB,CAAC;AA+BhC,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,CAAC,EAAE,aAAa,CAAC;CACxC;AAED,UAAU,WAAW;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CAC1E;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,aAAa,CAAC;IAC7B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAqDD;;;;;;;;;GASG;AACH;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,2BAA2B,6iJAqIvC,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,wBAAwB,omDA8CpC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAED,eAAO,MAAM,sBAAsB,EAAE,SAAS,mBAAmB,EAgDhE,CAAC;AAEF,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC;IACxB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,SAAS,mBAAmB,EAAE,CAAC;CAChD;AAED,wBAAgB,yBAAyB,CAAC,GAAG,GAAE,IAAiB,GAAG,oBAAoB,CAMtF;AAED,MAAM,WAAW,wBAAwB;IACvC,iEAAiE;IACjE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,qCAAqC;IACrC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,0CAA0C;IAC1C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAMD;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CACtC,WAAW,EAAE,MAAM,EACnB,KAAK,GAAE,SAAS,mBAAmB,EAA2B,GAC7D,wBAAwB,EAAE,CA+D5B;AAuoBD,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,eAAe,CAAC,CA2lD1B;AA0QD;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAoFzE"}