@tangle-network/traces 0.9.3 → 0.9.4

package/dist/cli.js

@@ -46,6 +46,14 @@ import {
 import { readFileSync } from "fs";
 import { readFile, stat } from "fs/promises";
 import { basename, resolve } from "path";
+import {
+  analyzeSupervisorRun,
+  findSupervisorRunDirs,
+  isUnavailable,
+  renderSupervisorRollupMarkdown,
+  renderSupervisorRunMarkdown,
+  rollupSupervisorRuns
+} from "@tangle-network/agent-eval/supervisor-run";
 function packageVersion() {
   const pkg = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8"));
   if (typeof pkg.version !== "string" || !pkg.version) throw new Error("package.json is missing version");
@@ -92,6 +100,9 @@ function parseArgs(argv) {
       case "--cwd":
         a.cwd = next();
         break;
+      case "--supervisor-run-dir":
+        a.supervisorRunDir = next();
+        break;
       case "--since":
         a.since = next();
         break;
@@ -453,6 +464,7 @@ async function loadExportAttributes(args) {
   return attributes;
 }
 async function cmdAnalyze(args) {
+  if (args.supervisorRunDir) return cmdAnalyzeSupervisorRun(args.supervisorRunDir, args);
   const result = await investigate(args, { loadDefaultConfig: false });
   if (args.out) {
     await saveReport(args.out, result.report);
@@ -463,6 +475,32 @@ async function cmdAnalyze(args) {
     console.log(result.report);
   }
 }
+async function cmdAnalyzeSupervisorRun(runDir, args) {
+  const nested = await findSupervisorRunDirs(runDir);
+  let markdown;
+  if (nested.length > 0) {
+    markdown = renderSupervisorRollupMarkdown(
+      rollupSupervisorRuns(await Promise.all(nested.map((dir) => analyzeSupervisorRun(dir)))),
+      `Supervisor rollup \u2014 ${runDir}`
+    );
+  } else {
+    const report = await analyzeSupervisorRun(runDir);
+    if (isUnavailable(report.orchestration.workersSpawned)) {
+      throw new Error(
+        `no supervisor run found at ${runDir} \u2014 expected <runDir>/ws/.loops/supervisor/<id>, or a parent directory containing such runs`
+      );
+    }
+    markdown = renderSupervisorRunMarkdown(report);
+  }
+  if (args.out) {
+    await saveReport(args.out, markdown);
+    console.log(
+      `supervisor report \u2192 ${args.out}  (${nested.length > 0 ? `${nested.length} runs` : "1 run"})`
+    );
+  } else {
+    console.log(markdown);
+  }
+}
 async function collectImportedSpans(args) {
   if (!args.input) throw new Error("input file missing");
   const attributes = await loadExportAttributes(args);
@@ -787,6 +825,7 @@ function usage() {
 Commands:
   list      List discovered sessions
   analyze   Run analyst suite + loop/waste pipelines over sessions or an input file
+            (--supervisor-run-dir <dir> reports a supervision tree instead)
   investigate Run typed investigation flow, including BYO config + evidence-backed actions
   improve   Write findings, evidence, report, and canonical trace artifacts
   convert   Emit OTLP-JSONL only (HALO: use analyze --analyzer halo)
@@ -804,6 +843,10 @@ Options:
   --last <n>       Most-recent N sessions
   --session <id|path> Analyze one listed session ID or one explicit harness session file
   --cwd <dir>      Filter sessions by working directory
+  --supervisor-run-dir <dir>
+                   analyze: report a SUPERVISION TREE instead of harness sessions \u2014
+                   steers, spawn waves, concurrency, idle wall, cost by role,
+                   accepted vs rejected. Rolls up when the dir holds many runs.
   --since <t>      upload: window, 30m / 2h / 7d or an ISO date (default 24h); analyze: ISO cutoff
   --out <path>     Write report to a file
   --dir <path>     improve: write artifacts to this directory

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tangle-network/traces",
-  "version": "0.9.3",
+  "version": "0.9.4",
   "description": "Point it at your coding-agent session traces (Claude Code, Codex, OpenCode, Gemini, Pi, …) and get failure-mode + efficiency findings. CLI + SDK over the @tangle-network/agent-eval analyst suite — observe live sessions, run your own analysts, redact, and upload to the Tangle Intelligence Platform.",
   "type": "module",
   "license": "MIT",
@@ -45,7 +45,7 @@
   },
   "dependencies": {
     "@ax-llm/ax": "^23.0.1",
-    "@tangle-network/agent-eval": "^0.122.8"
+    "@tangle-network/agent-eval": "^0.124.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",