@tangle-network/traces 0.8.23 → 0.8.24

package/README.md

@@ -55,7 +55,7 @@ Add `--llm` for the **agentic analysts** (failure-mode / knowledge-gap / knowled
 
 Every run also writes a **canonical OpenInference JSONL artifact**, so you can run external engines like [HALO](https://github.com/context-labs/halo) over it directly with `--analyzer halo`. See [External engines](#external-engines-bring-your-own). Analysis is never locked to one engine.
 
-`traces improve` is the reviewable action path. It writes typed artifacts: findings, recommendations, evidence rows, claims, report, and before/after replay metadata. Another agent, CI job, or hosted product can consume the result without scraping prose.
+`traces improve` is the reviewable action path. It writes typed artifacts: findings, recommendations, proposal-only artifacts, evidence rows, claims, report, and before/after replay metadata. Another agent, CI job, or hosted product can consume the result without scraping prose.
 
 ## What it finds
 
@@ -197,6 +197,7 @@ The directory contains:
 |---|---|
 | `findings.json` | typed `AnalystFinding[]`; finding ids, severity, evidence refs, recommended action, validation plan |
 | `recommendations.json` | ranked actions derived from analyst, deterministic, and external findings |
+| `proposals.json` | reviewable proposal-only artifacts linked to recommendation ids and evidence refs |
 | `evidence.jsonl` | one row per evidence ref, suitable for downstream mining |
 | `claims.json` | compact claim list for review agents and dashboards |
 | `report.md` | human-readable report rendered from the typed data |
@@ -214,7 +215,7 @@ The config can export:
 - `liveAnalysts`: deterministic online analysts that implement the `TraceLiveAnalyst` contract for `traces stream`
 - `registry`: a prebuilt `AnalystRegistry`
 - `externalAnalyzers`: HALO or any command/model adapter that reads the OTLP artifact
-- `improvementAdapter`: a proposal writer that maps recommendations to patches, profile edits, prompts, or validation commands
+- `improvementAdapter`: a proposal writer that replaces the default proposal set with product-specific patches, profile edits, prompts, or validation commands
 
 `traces` does not apply patches or open PRs by default. The public engine produces reviewable artifacts; hosted products can decide how to deliver, approve, or apply them.
 
@@ -344,7 +345,7 @@ The CLI is a thin consumer of these exports.
 |---|---|---|
 | `analyzeSpans` | `(spans, { registry?, ai?, budgetUsd? }) → AnalyzeResult` | run built-in analysts, or **your own** via `registry` |
 | `runTraceInvestigation` | `(TraceInvestigationOptions) → TraceInvestigationResult` | typed findings, recommendations, claims, external analyzer output, and report |
-| `runTraceImprovementLoop` | `(TraceImprovementOptions) → TraceImprovementResult` | writes the full improvement artifact pack and optional proposal output |
+| `runTraceImprovementLoop` | `(TraceImprovementOptions) → TraceImprovementResult` | writes the full improvement artifact pack and proposal-only output |
 | `buildTraceFindingPacket` | `({ findings }) → TraceFindingPacket` | turn any `AnalystFinding[]` into recommendations, claims, and a report |
 | `runTraceStoreInvestigation` | `({ traceStore }) → TraceStoreInvestigationResult` | run the same packet layer over a hosted/custom `TraceAnalysisStore` |
 | `loadTracesConfig` | `(path?) → TracesConfig \| undefined` | load BYO analysts, external analyzers, and proposal adapters |

package/dist/{chunk-YS5KIWLY.js → chunk-4LLOYL36.js}

@@ -4091,6 +4091,27 @@ function buildTraceFindingPacket(opts) {
   };
   return { ...packet, report: renderFindingPacket(packet, opts.title) };
 }
+function buildDefaultImprovementProposals(input) {
+  return input.recommendations.slice(0, 5).map((recommendation, index) => {
+    const matchingFindings = input.findings.filter((finding2) => recommendation.findingIds.includes(finding2.finding_id));
+    const evidenceRefs = recommendation.evidenceRefs.length > 0 ? recommendation.evidenceRefs : matchingFindings.flatMap((finding2) => finding2.evidence_refs);
+    return {
+      id: `proposal-${index + 1}-${slug(recommendation.title)}`,
+      title: recommendation.title,
+      description: [
+        recommendation.action,
+        "",
+        `Why: ${recommendation.rationale}`,
+        `Validation: ${recommendation.validationPlan}`,
+        "",
+        "This is a proposal-only artifact. It does not mutate code, prompts, skills, tools, MCP config, hooks, subagents, or external systems until a human applies it and reruns validation."
+      ].join("\n"),
+      recommendationIds: [recommendation.id],
+      validationCommand: "traces improve --last 1 --dir .traces/improvement",
+      evidenceRefs
+    };
+  });
+}
 function renderExternal(results) {
   if (results.length === 0) return "";
   const lines = ["## external analyzers", ""];
@@ -4258,6 +4279,7 @@ async function writeTraceImprovementArtifacts(result, outDir) {
     directory,
     findings: join16(directory, "findings.json"),
     recommendations: join16(directory, "recommendations.json"),
+    proposals: join16(directory, "proposals.json"),
     evidence: join16(directory, "evidence.jsonl"),
     claims: join16(directory, "claims.json"),
     report: join16(directory, "report.md"),
@@ -4266,6 +4288,7 @@ async function writeTraceImprovementArtifacts(result, outDir) {
   await Promise.all([
     writeFile4(paths.findings, json(result.findings), "utf8"),
     writeFile4(paths.recommendations, json(result.recommendations), "utf8"),
+    writeFile4(paths.proposals, json(result.proposals), "utf8"),
     writeFile4(paths.evidence, jsonl(buildEvidenceRows(result.findings)), "utf8"),
     writeFile4(paths.claims, json(result.claims), "utf8"),
     writeFile4(paths.report, result.report, "utf8"),
@@ -4275,13 +4298,14 @@ async function writeTraceImprovementArtifacts(result, outDir) {
 }
 async function runTraceImprovementLoop(opts) {
   const investigation = await runTraceInvestigation(opts);
-  const proposals = opts.adapter ? await opts.adapter.propose({
+  const adapterInput = {
     findings: investigation.findings,
     recommendations: investigation.recommendations,
     claims: investigation.claims,
     spans: opts.spans,
     otlpPath: investigation.otlpPath
-  }) : [];
+  };
+  const proposals = opts.adapter ? await opts.adapter.propose(adapterInput) : buildDefaultImprovementProposals(adapterInput);
   const replay = replayProof(investigation, proposals);
   const result = {
     ...investigation,

package/dist/cli.js

@@ -44,7 +44,7 @@ import {
   writePolicyEvidenceFile,
   writeSessionIndexFile,
   writeTraceEvidenceExportFile
-} from "./chunk-YS5KIWLY.js";
+} from "./chunk-4LLOYL36.js";
 
 // src/cli.ts
 import { readFileSync } from "fs";

package/dist/index.d.ts

@@ -1381,6 +1381,7 @@ interface TraceImprovementArtifacts {
     readonly directory: string;
     readonly findings: string;
     readonly recommendations: string;
+    readonly proposals: string;
     readonly evidence: string;
     readonly claims: string;
     readonly report: string;
@@ -1448,7 +1449,7 @@ declare function loadTracesConfig(path?: string): Promise<TracesConfig | undefin
 declare function mergeTracesConfig(opts: TraceInvestigationOptions, config?: TracesConfig): TraceInvestigationOptions;
 declare function runTraceInvestigation(opts: TraceInvestigationOptions): Promise<TraceInvestigationResult>;
 declare function runTraceStoreInvestigation(opts: TraceStoreInvestigationOptions): Promise<TraceStoreInvestigationResult>;
-declare function writeTraceImprovementArtifacts(result: Pick<TraceImprovementResult, 'findings' | 'recommendations' | 'claims' | 'report' | 'replay'>, outDir?: string): Promise<TraceImprovementArtifacts>;
+declare function writeTraceImprovementArtifacts(result: Pick<TraceImprovementResult, 'findings' | 'recommendations' | 'proposals' | 'claims' | 'report' | 'replay'>, outDir?: string): Promise<TraceImprovementArtifacts>;
 declare function runTraceImprovementLoop(opts: TraceImprovementOptions): Promise<TraceImprovementResult>;
 declare function saveReport(path: string, report: string): Promise<void>;
 

package/dist/index.js

@@ -98,7 +98,7 @@ import {
   writeSessionIndexFile,
   writeTraceEvidenceExportFile,
   writeTraceImprovementArtifacts
-} from "./chunk-YS5KIWLY.js";
+} from "./chunk-4LLOYL36.js";
 
 // src/collect.ts
 async function collectSessions(opts = {}) {

package/package.json

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