@tangle-network/traces 0.9.1 → 0.9.2

package/README.md

@@ -96,6 +96,7 @@ Every adapter captures the full conversation: the **user's prompt** and the **as
 
 ```bash
 traces list     --harness claude-code --last 20    # discover sessions
+traces analyze  --harness codex --session <id>     # pin one ID printed by `list`
 traces analyze  --harness codex --last 1           # $0 findings with actions + checks
 traces investigate --all --last 10 --out report.md  # explicit investigation alias
 traces improve --all --last 10 --dir .traces/improvement
@@ -246,6 +247,9 @@ It is intentionally read-only: it points to repeated-call loops, high tool-error
 traces evidence --all --since 24h --out policy-evidence.jsonl --otlp spans.otlp.jsonl
 ```
 
+`--last` follows recent file activity and is useful for live inspection.
+For a reproducible report, run `traces list` first and pass its session ID with `--session`.
+
 Each JSONL row is one session:
 
 - session provenance: harness, session id, cwd, path, mtime

package/dist/cli.js

@@ -208,6 +208,50 @@ async function discover(args) {
   }
   return out;
 }
+function missingPath(error) {
+  return typeof error === "object" && error !== null && error.code === "ENOENT";
+}
+async function resolveSelectedSession(args) {
+  if (!args.session) throw new Error("resolveSelectedSession requires --session");
+  const adapter = resolveAdapter(args.harness);
+  if (!adapter && !args.all) throw new Error(`unknown harness "${args.harness}"`);
+  try {
+    const st = await stat(args.session);
+    if (!adapter) {
+      throw new Error("--session <path> requires --harness when --all is set");
+    }
+    return {
+      adapter,
+      ref: {
+        harness: adapter.harness,
+        sessionId: args.session,
+        path: args.session,
+        // --session is an explicit file; honor --cwd so adoption can find the
+        // project's .evolve/skill-runs.jsonl (locate() infers cwd in the scan path).
+        cwd: args.cwd ?? null,
+        mtimeMs: st.mtimeMs
+      }
+    };
+  } catch (error) {
+    if (!missingPath(error)) throw error;
+  }
+  const matches = [];
+  for (const candidate of args.all ? adaptersFor(args) : [adapter]) {
+    const refs = await locateSessions(candidate, { cwd: args.cwd });
+    for (const ref of refs) {
+      if (ref.sessionId === args.session) matches.push({ adapter: candidate, ref });
+    }
+  }
+  if (matches.length === 1) return matches[0];
+  if (matches.length === 0) {
+    throw new Error(
+      `no ${args.all ? "selected" : adapter.harness} session with ID "${args.session}"; run \`traces list\` to select an ID, or pass an explicit session path`
+    );
+  }
+  throw new Error(
+    `session ID "${args.session}" is ambiguous across ${matches.length} files; select one harness or pass its explicit session path`
+  );
+}
 async function buildAxService() {
   const apiKey = process.env.OPENAI_API_KEY;
   if (!apiKey) {
@@ -265,18 +309,7 @@ function selectedSessionSource(ref, spans, sessionIdOverride) {
 async function collectSpans(args) {
   if (args.input) return collectImportedSpans(args);
   if (args.session) {
-    const adapter = resolveAdapter(args.harness);
-    if (!adapter) throw new Error(`unknown harness "${args.harness}"`);
-    const st = await stat(args.session);
-    const ref = {
-      harness: adapter.harness,
-      sessionId: args.session,
-      path: args.session,
-      // --session is an explicit file; honor --cwd so adoption can find the
-      // project's .evolve/skill-runs.jsonl (locate() infers cwd in the scan path).
-      cwd: args.cwd ?? null,
-      mtimeMs: st.mtimeMs
-    };
+    const { adapter, ref } = await resolveSelectedSession(args);
     const spans2 = await parseSession(adapter, ref);
     return {
       spans: spans2,
@@ -309,16 +342,7 @@ async function cmdConvert(args) {
 }
 async function collectSessionRows(args) {
   if (args.session) {
-    const adapter = resolveAdapter(args.harness);
-    if (!adapter) throw new Error(`unknown harness "${args.harness}"`);
-    const st = await stat(args.session);
-    const ref = {
-      harness: adapter.harness,
-      sessionId: args.session,
-      path: args.session,
-      cwd: args.cwd ?? null,
-      mtimeMs: st.mtimeMs
-    };
+    const { adapter, ref } = await resolveSelectedSession(args);
     return [{ ref, spans: await parseSession(adapter, ref) }];
   }
   const groups = await discover({ ...args, last: args.last || 20 });
@@ -778,7 +802,7 @@ Options:
   --harness <id>   Harness or alias (default: claude-code). Known: ${knownHarnesses().join(", ")}
   --all            Sweep every known harness
   --last <n>       Most-recent N sessions
-  --session <path> Analyze/stream one explicit harness session file
+  --session <id|path> Analyze one listed session ID or one explicit harness session file
   --cwd <dir>      Filter sessions by working directory
   --since <t>      upload: window, 30m / 2h / 7d or an ISO date (default 24h); analyze: ISO cutoff
   --out <path>     Write report to a file

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tangle-network/traces",
-  "version": "0.9.1",
+  "version": "0.9.2",
   "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",