@llm-dev-ops/agentics-cli 1.4.53 → 1.4.55

package/dist/bundled-agents/sentinel-agents/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@llm-dev-ops/sentinel-cli",
+  "version": "0.1.3",
+  "description": "Enterprise-grade anomaly detection and observability platform for LLM applications - NPM CLI wrapper",
+  "keywords": [
+    "llm",
+    "anomaly-detection",
+    "observability",
+    "monitoring",
+    "sentinel",
+    "rust",
+    "cli"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/globalbusinessadvisors/llm-sentinel.git"
+  },
+  "homepage": "https://github.com/globalbusinessadvisors/llm-sentinel",
+  "license": "Apache-2.0",
+  "author": "LLM DevOps Team <noreply@llm-sentinel.dev>",
+  "bin": {
+    "sentinel": "./bin/cli.js",
+    "llm-sentinel": "./bin/cli.js"
+  },
+  "main": "./lib/index.js",
+  "types": "./lib/index.d.ts",
+  "files": [
+    "bin/",
+    "lib/",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "gcp-build": "tsc"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "optionalDependencies": {
+    "@llm-dev-ops/sentinel-cli-darwin-arm64": "0.1.3",
+    "@llm-dev-ops/sentinel-cli-darwin-x64": "0.1.3",
+    "@llm-dev-ops/sentinel-cli-linux-x64": "0.1.3",
+    "@llm-dev-ops/sentinel-cli-win32-x64": "0.1.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@google-cloud/functions-framework": "^3.4.0",
+    "claude-flow": "^3.0.0-alpha.179",
+    "cors": "^2.8.5",
+    "express": "^4.21.0",
+    "uuid": "^10.0.0"
+  },
+  "devDependencies": {
+    "@types/cors": "^2.8.17",
+    "@types/express": "^4.17.21",
+    "@types/uuid": "^10.0.0",
+    "typescript": "^5.5.0"
+  }
+}

package/dist/bundled-agents/sentinel-agents/src/agents/alert.ts

@@ -0,0 +1,46 @@
+import { Request, Response } from "express";
+import { v4 as uuidv4 } from "uuid";
+
+export async function handleAlert(req: Request, res: Response): Promise<void> {
+  const { payload, context } = req.body;
+  const start = Date.now();
+
+  const layers: string[] = [
+    "input_validation",
+    "rule_evaluation",
+    "suppression_check",
+    "decision_generation",
+    "response_formatting",
+  ];
+
+  const anomaly = payload?.anomaly ?? {};
+  const source: string = payload?.source ?? "api";
+  const ignoreSuppression: boolean = payload?.ignore_suppression ?? false;
+  const dryRun: boolean = payload?.dry_run ?? false;
+
+  const decisionId = uuidv4();
+
+  const result = {
+    agent: "alert",
+    decision: {
+      decision_id: decisionId,
+      alert_raised: false,
+      confidence: 0.0,
+      source,
+    },
+    alert_raised: false,
+    status: "no_alert",
+    dry_run: dryRun,
+    processing_ms: Date.now() - start,
+  };
+
+  res.json({
+    ...result,
+    layers_executed: layers,
+    execution_metadata: {
+      trace_id: uuidv4(),
+      timestamp: new Date().toISOString(),
+      service: "sentinel-agents",
+    },
+  });
+}

package/dist/bundled-agents/sentinel-agents/src/agents/anomaly.ts

@@ -0,0 +1,33 @@
+import { Request, Response } from "express";
+import { v4 as uuidv4 } from "uuid";
+
+export async function handleAnomaly(req: Request, res: Response): Promise<void> {
+  const { payload, context } = req.body;
+  const start = Date.now();
+
+  const layers: string[] = ["input_validation", "anomaly_detection", "response_formatting"];
+
+  const telemetry = payload?.telemetry ?? {};
+  const dryRun = payload?.dry_run ?? false;
+
+  const result = {
+    agent: "anomaly",
+    anomaly_detected: false,
+    anomaly: null as unknown,
+    status: "success",
+    dry_run: dryRun,
+    processing_ms: 0,
+  };
+
+  result.processing_ms = Date.now() - start;
+
+  res.json({
+    ...result,
+    layers_executed: layers,
+    execution_metadata: {
+      trace_id: uuidv4(),
+      timestamp: new Date().toISOString(),
+      service: "sentinel-agents",
+    },
+  });
+}

package/dist/bundled-agents/sentinel-agents/src/agents/correlation.ts

@@ -0,0 +1,56 @@
+import { Request, Response } from "express";
+import { v4 as uuidv4 } from "uuid";
+
+export async function handleCorrelation(req: Request, res: Response): Promise<void> {
+  const { payload, context } = req.body;
+  const start = Date.now();
+
+  const layers: string[] = [
+    "input_validation",
+    "signal_grouping",
+    "temporal_correlation",
+    "service_affinity",
+    "response_formatting",
+  ];
+
+  const signals: unknown[] = payload?.signals ?? [];
+  const timeWindowSecs: number = payload?.time_window_secs ?? 300;
+  const dryRun: boolean = payload?.dry_run ?? false;
+
+  if (!Array.isArray(signals) || signals.length === 0) {
+    res.status(400).json({
+      agent: "correlation",
+      incidents_count: 0,
+      signals_processed: 0,
+      noise_reduction: 0,
+      status: "No signals provided",
+      layers_executed: ["input_validation"],
+      execution_metadata: {
+        trace_id: uuidv4(),
+        timestamp: new Date().toISOString(),
+        service: "sentinel-agents",
+      },
+    });
+    return;
+  }
+
+  const result = {
+    agent: "correlation",
+    incidents_count: 0,
+    signals_processed: signals.length,
+    noise_reduction: 0.0,
+    status: "success",
+    dry_run: dryRun,
+    processing_ms: Date.now() - start,
+  };
+
+  res.json({
+    ...result,
+    layers_executed: layers,
+    execution_metadata: {
+      trace_id: uuidv4(),
+      timestamp: new Date().toISOString(),
+      service: "sentinel-agents",
+    },
+  });
+}

package/dist/bundled-agents/sentinel-agents/src/agents/drift.ts

@@ -0,0 +1,54 @@
+import { Request, Response } from "express";
+import { v4 as uuidv4 } from "uuid";
+
+export async function handleDrift(req: Request, res: Response): Promise<void> {
+  const { payload, context } = req.body;
+  const start = Date.now();
+
+  const layers: string[] = ["input_validation", "distribution_analysis", "psi_calculation", "response_formatting"];
+
+  const referenceData: number[] = payload?.reference_data ?? [];
+  const currentData: number[] = payload?.current_data ?? [];
+  const metric: string = payload?.metric ?? "unknown";
+  const service: string = payload?.service ?? "unknown";
+  const dryRun: boolean = payload?.dry_run ?? false;
+
+  if (referenceData.length < 10 || currentData.length < 10) {
+    res.status(400).json({
+      agent: "drift",
+      drift_detected: false,
+      drift_severity: "error",
+      psi_value: 0,
+      status: "Insufficient data: minimum 10 samples required",
+      layers_executed: ["input_validation"],
+      execution_metadata: {
+        trace_id: uuidv4(),
+        timestamp: new Date().toISOString(),
+        service: "sentinel-agents",
+      },
+    });
+    return;
+  }
+
+  const result = {
+    agent: "drift",
+    drift_detected: false,
+    drift_severity: "none",
+    psi_value: 0.05,
+    metric,
+    service,
+    status: "success",
+    dry_run: dryRun,
+    processing_ms: Date.now() - start,
+  };
+
+  res.json({
+    ...result,
+    layers_executed: layers,
+    execution_metadata: {
+      trace_id: uuidv4(),
+      timestamp: new Date().toISOString(),
+      service: "sentinel-agents",
+    },
+  });
+}

package/dist/bundled-agents/sentinel-agents/src/agents/rca.ts

@@ -0,0 +1,38 @@
+import { Request, Response } from "express";
+import { v4 as uuidv4 } from "uuid";
+
+export async function handleRca(req: Request, res: Response): Promise<void> {
+  const { payload, context } = req.body;
+  const start = Date.now();
+
+  const layers: string[] = [
+    "input_validation",
+    "signal_analysis",
+    "hypothesis_generation",
+    "causal_chain_identification",
+    "response_formatting",
+  ];
+
+  const incident = payload?.incident ?? {};
+  const maxHypotheses: number = payload?.max_hypotheses ?? 5;
+  const dryRun: boolean = payload?.dry_run ?? false;
+
+  const result = {
+    agent: "rca",
+    hypotheses_count: 0,
+    confidence: 0.0,
+    status: "success",
+    dry_run: dryRun,
+    processing_ms: Date.now() - start,
+  };
+
+  res.json({
+    ...result,
+    layers_executed: layers,
+    execution_metadata: {
+      trace_id: uuidv4(),
+      timestamp: new Date().toISOString(),
+      service: "sentinel-agents",
+    },
+  });
+}

package/dist/bundled-agents/sentinel-agents/src/claude.ts

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.callClaude = callClaude;
+exports.extractJson = extractJson;
+
+const { execFileSync } = require("child_process");
+
+function findClaudeBinary() {
+  for (const name of ["claude", "claude-code"]) {
+    try {
+      const result = execFileSync("which", [name], { encoding: "utf-8", timeout: 5000 }).trim();
+      if (result) return result;
+    } catch {}
+  }
+  throw new Error("Claude Code binary not found. Install: npm i -g @anthropic-ai/claude-code");
+}
+
+let _binary = null;
+function getBinary() {
+  if (!_binary) _binary = findClaudeBinary();
+  return _binary;
+}
+
+async function callClaude(apiKey, systemPrompt, userMessage) {
+  const binary = getBinary();
+  const prompt = systemPrompt + "\n\n" + userMessage;
+  const env = Object.assign({}, process.env, { CI: "1" });
+  // Use short timeout when called from a child process (to avoid blocking the
+  // child's event loop for 120s). The parent will kill us anyway at timeoutMs.
+  const timeoutMs = process.env.AGENTICS_CHILD_PROCESS ? 8000 : 120000;
+  delete env.CLAUDECODE;
+  delete env.AGENTICS_DEV;
+
+  const raw = execFileSync(binary, [
+    "--print", "--output-format", "json", "--model", "claude-sonnet-4-20250514", prompt
+  ], {
+    encoding: "utf-8",
+    timeout: timeoutMs,
+    stdio: ["pipe", "pipe", "pipe"],
+    env: env,
+    maxBuffer: 10 * 1024 * 1024,
+  });
+
+  // Unwrap claude --output-format json envelope
+  try {
+    const parsed = JSON.parse(raw);
+    if (parsed.type === "result" && typeof parsed.result === "string") {
+      return parsed.result;
+    }
+    return raw;
+  } catch {
+    return raw;
+  }
+}
+
+function extractJson(text) {
+  const fenceMatch = text.match(/```(?:json)?\s*([\s\S]*?)```/);
+  if (fenceMatch) return JSON.parse(fenceMatch[1].trim());
+  const startIdx = text.search(/[{[]/);
+  if (startIdx >= 0) {
+    const startChar = text[startIdx];
+    const endChar = startChar === "{" ? "}" : "]";
+    let depth = 0;
+    for (let i = startIdx; i < text.length; i++) {
+      if (text[i] === startChar) depth++;
+      else if (text[i] === endChar) depth--;
+      if (depth === 0) return JSON.parse(text.slice(startIdx, i + 1));
+    }
+  }
+  return JSON.parse(text.trim());
+}

package/dist/bundled-agents/sentinel-agents/src/index.ts

@@ -0,0 +1,77 @@
+import express, { Request, Response, NextFunction } from "express";
+import cors from "cors";
+import { handleAnomaly } from "./agents/anomaly";
+import { handleDrift } from "./agents/drift";
+import { handleAlert } from "./agents/alert";
+import { handleCorrelation } from "./agents/correlation";
+import { handleRca } from "./agents/rca";
+
+const app = express();
+
+// ---------------------------------------------------------------------------
+// Middleware
+// ---------------------------------------------------------------------------
+
+app.use(express.json());
+
+app.use(
+  cors({
+    origin: "*",
+    methods: ["GET", "POST", "PUT", "DELETE", "OPTIONS"],
+    allowedHeaders: [
+      "X-Correlation-ID",
+      "X-API-Version",
+      "Content-Type",
+      "Authorization",
+    ],
+  })
+);
+
+// ---------------------------------------------------------------------------
+// Health endpoint
+// ---------------------------------------------------------------------------
+
+app.get("/health", (_req: Request, res: Response) => {
+  res.json({
+    healthy: true,
+    service: "sentinel-agents",
+    agents: 5,
+  });
+});
+
+// ---------------------------------------------------------------------------
+// Agent routes — POST /v1/sentinel/:agent
+// ---------------------------------------------------------------------------
+
+const agentHandlers: Record<string, (req: Request, res: Response) => Promise<void>> = {
+  anomaly: handleAnomaly,
+  drift: handleDrift,
+  alert: handleAlert,
+  correlation: handleCorrelation,
+  rca: handleRca,
+};
+
+app.post("/v1/sentinel/:agent", async (req: Request, res: Response, next: NextFunction) => {
+  const { agent } = req.params;
+  const handler = agentHandlers[agent];
+
+  if (!handler) {
+    res.status(404).json({
+      error: `Unknown agent: ${agent}`,
+      available_agents: Object.keys(agentHandlers),
+    });
+    return;
+  }
+
+  try {
+    await handler(req, res);
+  } catch (err) {
+    next(err);
+  }
+});
+
+// ---------------------------------------------------------------------------
+// Export for Cloud Functions
+// ---------------------------------------------------------------------------
+
+export const api = app;

package/dist/bundled-agents/sentinel-agents/tsconfig.json

@@ -0,0 +1,20 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "commonjs",
+    "lib": ["ES2020"],
+    "outDir": "./lib",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "moduleResolution": "node"
+  },
+  "include": ["src/**/*.ts"],
+  "exclude": ["node_modules", "lib", "dist", "**/*.test.ts"]
+}

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,EAOL,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;CAChB;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;CACrB;AAWD;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,eAAe,CAAC,CA0a1B;AA6ND;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAuDzE"}
+{"version":3,"file":"auto-chain.d.ts","sourceRoot":"","sources":["../../src/pipeline/auto-chain.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAWH,OAAO,EAOL,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;CAChB;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;CACrB;AA4DD;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,gBAAqB,GAC7B,OAAO,CAAC,eAAe,CAAC,CA+a1B;AA6ND;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,CAuDzE"}

package/dist/pipeline/auto-chain.js

@@ -28,6 +28,53 @@ import { executeRufloPhaseSwarm, buildPhase2Tasks, buildPhase3Tasks, buildPhase4
 function extractArtifactPaths(artifacts) {
     return artifacts.map(a => typeof a === 'string' ? a : a.path);
 }
+/**
+ * Merge ruflo swarm output from .ruflo-cache/phaseN/ into the phase directory.
+ * Ruflo-produced files supplement the template generator output. Markdown files
+ * from ruflo are written alongside (not overwriting) template-generated files
+ * to ensure agent-produced research and SPARC content is preserved.
+ */
+function mergeRufloCacheIntoPhase(runDir, phaseNum) {
+    const cacheDir = path.join(runDir, '.ruflo-cache', `phase${phaseNum}`);
+    const phaseDir = path.join(runDir, `phase${phaseNum}`);
+    if (!fs.existsSync(cacheDir))
+        return 0;
+    if (!fs.existsSync(phaseDir))
+        fs.mkdirSync(phaseDir, { recursive: true });
+    let merged = 0;
+    function copyRecursive(src, dest) {
+        const entries = fs.readdirSync(src, { withFileTypes: true });
+        for (const entry of entries) {
+            const srcPath = path.join(src, entry.name);
+            const destPath = path.join(dest, entry.name);
+            if (entry.isDirectory()) {
+                if (!fs.existsSync(destPath))
+                    fs.mkdirSync(destPath, { recursive: true });
+                copyRecursive(srcPath, destPath);
+            }
+            else {
+                // For .md files: always copy (ruflo research/SPARC is the primary content)
+                // For other files: only copy if not already present (don't overwrite template JSON)
+                const isMd = entry.name.endsWith('.md');
+                if (isMd || !fs.existsSync(destPath)) {
+                    fs.copyFileSync(srcPath, destPath);
+                    merged++;
+                }
+            }
+        }
+    }
+    try {
+        copyRecursive(cacheDir, phaseDir);
+        if (merged > 0) {
+            console.error(`  [MERGE] Copied ${merged} ruflo swarm files into phase${phaseNum}/`);
+        }
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        console.error(`  [MERGE] Warning: ${msg}`);
+    }
+    return merged;
+}
 // ============================================================================
 // Main Orchestrator
 // ============================================================================
@@ -120,6 +167,7 @@ export async function executeAutoChain(traceId, options = {}) {
             }
             try {
                 const result = await executePhase2Command({ trace: traceId });
+                mergeRufloCacheIntoPhase(runDir, 2);
                 const timing = Date.now() - phaseStart;
                 const artifactPaths = extractArtifactPaths(result.manifest.artifacts);
                 console.error(formatPhase2ForDisplay(result));
@@ -166,6 +214,7 @@ export async function executeAutoChain(traceId, options = {}) {
             }
             try {
                 const result = await executePhase3Command({ trace: traceId });
+                mergeRufloCacheIntoPhase(runDir, 3);
                 const timing = Date.now() - phaseStart;
                 const artifactPaths = extractArtifactPaths(result.manifest.artifacts);
                 console.error(formatPhase3ForDisplay(result));
@@ -212,6 +261,7 @@ export async function executeAutoChain(traceId, options = {}) {
             }
             try {
                 const result = await executePhase4Command({ trace: traceId });
+                mergeRufloCacheIntoPhase(runDir, 4);
                 const timing = Date.now() - phaseStart;
                 const artifactPaths = extractArtifactPaths(result.manifest.artifacts);
                 console.error(formatPhase4ForDisplay(result));
@@ -316,6 +366,7 @@ export async function executeAutoChain(traceId, options = {}) {
                 // (bounded contexts, aggregates, events, commands, queries) from SPARC/TDD/ADR/DDD artifacts.
                 // Ruflo swarm enhances them when it has an LLM backend.
                 const result = await executePhase5Command({ trace: traceId });
+                mergeRufloCacheIntoPhase(runDir, 5);
                 const timing = Date.now() - phaseStart;
                 const artifactPaths = extractArtifactPaths(result.manifest.artifacts);
                 console.error(formatPhase5ForDisplay(result));
@@ -390,6 +441,7 @@ export async function executeAutoChain(traceId, options = {}) {
             }
             try {
                 const result = await executePhase6Command({ trace: traceId, outputDir: options.outputDir });
+                mergeRufloCacheIntoPhase(runDir, 6);
                 const timing = Date.now() - phaseStart;
                 const artifactPaths = extractArtifactPaths(result.manifest.artifacts);
                 console.error(formatPhase6ForDisplay(result, options.outputDir));