@tangle-network/traces 0.8.23 → 0.8.25

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-SV7GW5LB.js}

@@ -2417,6 +2417,56 @@ function stampRepoAttrs(spans, attrs) {
   }
   return spans;
 }
+function replaceRepoAttrs(spans, attrs) {
+  for (const s of spans) {
+    for (const [key, value] of Object.entries(attrs)) s.attributes[key] = value;
+  }
+}
+async function resolutionForWorkdirEvidence(evidence3, cache) {
+  const cached = cache.get(evidence3.path);
+  if (cached !== void 0) return cached;
+  const cwd = await repoCandidateForPath(evidence3.path);
+  if (!cwd) {
+    cache.set(evidence3.path, null);
+    return null;
+  }
+  const attrs = await resolveRepoAttrs(cwd);
+  const resolved = attrs[ATTR.SUBJECT_KEY] ? {
+    attrs: { ...attrs, [ATTR.REPO_RESOLUTION_SOURCE]: evidence3.source },
+    cwd: attrs[ATTR.CWD] ?? cwd,
+    source: evidence3.source
+  } : null;
+  cache.set(evidence3.path, resolved);
+  return resolved;
+}
+async function resolveSpanWorkdirRepoAttrs(span2, cache) {
+  const candidates = /* @__PURE__ */ new Map();
+  const add = (value, weight) => {
+    if (!value?.cwd) return;
+    const existing = candidates.get(value.cwd);
+    if (existing) {
+      existing.score += weight;
+      return;
+    }
+    candidates.set(value.cwd, { repo: value, score: weight, order: candidates.size });
+  };
+  for (const evidence3 of extractAbsolutePaths([span2])) {
+    if (evidence3.source !== "span-workdir") continue;
+    add(await resolutionForWorkdirEvidence(evidence3, cache), evidence3.weight);
+  }
+  const byScore = (a, b) => b.score - a.score || a.order - b.order;
+  const resolved = [...candidates.values()];
+  const selected = resolved.filter((candidate) => candidate.repo.attrs[ATTR.GIT_REPOSITORY]).sort(byScore)[0] ?? resolved.filter((candidate) => candidate.repo.attrs[ATTR.SUBJECT_KEY]).sort(byScore)[0];
+  if (!selected) return null;
+  return selected.repo;
+}
+async function stampSpanWorkdirRepoAttrs(spans) {
+  const cache = /* @__PURE__ */ new Map();
+  for (const span2 of spans) {
+    const repo = await resolveSpanWorkdirRepoAttrs(span2, cache);
+    if (repo?.attrs && Object.keys(repo.attrs).length > 0) replaceRepoAttrs([span2], repo.attrs);
+  }
+}
 
 // src/session-source.ts
 async function parseSession(adapter, ref) {
@@ -2424,6 +2474,7 @@ async function parseSession(adapter, ref) {
   const repo = await resolveSessionRepoAttrs(ref.cwd, spans);
   if (repo.cwd) ref.cwd = repo.cwd;
   stampRepoAttrs(spans, repo.attrs);
+  await stampSpanWorkdirRepoAttrs(spans);
   return spans;
 }
 function refKey(ref) {
@@ -4091,6 +4142,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 +4330,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 +4339,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 +4349,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,
@@ -5212,6 +5287,7 @@ export {
   resolveRepoAttrs,
   resolveSessionRepoAttrs,
   stampRepoAttrs,
+  stampSpanWorkdirRepoAttrs,
   parseSession,
   locateSessions,
   scanSessions,

package/dist/cli.js

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

package/dist/index.d.ts

@@ -281,6 +281,7 @@ declare function resolveSessionRepoAttrs(cwd: string | null | undefined, spans:
  * same array for ergonomic chaining. A no-op when `attrs` is empty.
  */
 declare function stampRepoAttrs(spans: readonly OtlpSpan[], attrs: RepoAttrs): readonly OtlpSpan[];
+declare function stampSpanWorkdirRepoAttrs(spans: readonly OtlpSpan[]): Promise<void>;
 
 /**
  * Claude Code adapter — `~/.claude/projects/<encoded-cwd>/<session>.jsonl`.
@@ -1381,6 +1382,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 +1450,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>;
 
@@ -1649,4 +1651,4 @@ interface ExecuteOptions {
 /** Send the NEW items (or, on dryRun, write the redacted OTLP that would send). */
 declare function executeUpload(plan: UploadPlan, opts?: ExecuteOptions): Promise<UploadResult>;
 
-export { ACTOR_ATTR, ATTR, type Actor, type AdoptionOptions, type AdoptionReport, AmpAdapter, type AnalyzeOptions, type AnalyzeResult, type BuildPolicyEvidenceOptions, type BuildSessionIndexOptions, type BuildTraceFindingPacketOptions, CODING_REDACTION_RULES, CONTENT_CAP, CORRECTIVE_REACTIONS, ClaudeAdapter, CodexAdapter, type CollectOptions, type CollectPolicyEvidenceOptions, type CollectSessionIndexOptions, CopilotAdapter, DEFAULT_HARNESS, type ExecuteOptions, type ExternalAnalysisResult, type ExternalAnalyzer, FactoryAdapter, type FindingStore, ForgeAdapter, GeminiAdapter, type HarnessTraceAdapter, INGEST_SOURCE_CLI, type ImprovementAdapter, type ImprovementAdapterInput, type ImprovementProposal, type InspectSessionIndexOptions, type LiveBatchOptions, type LocateOptions, type ObservedLoop, type ObserverOptions, OpencodeAdapter, type OtlpSpan, type OtlpSpanKind, type OtlpStatusCode, PiAdapter, type PipelineOptions, type PipelineReport, type PlanOptions, type PolicyEvidenceLoopSummary, type PolicyEvidenceRecord, type PolicyEvidenceToolSummary, QwenAdapter, REACTIONS, type Reaction, type ReactionReport, type ReactionSessionReport, type RecommendationWriter, type Redactor, type RepoAttrs, type RepoResolution, type RepoResolutionSource, type RunResult, type RuntimeTrace, type ScanOptions, type ScannedSession, type SessionBatch, type SessionRef, type SpanInput, type SpanRedaction, TRACES_REDACTION_RULES, type TraceClaim, type TraceContextIndex, type TraceContextRoot, type TraceEvidenceExportOptions, type TraceEvidenceExportResult, type TraceEvidenceFormatOption, type TraceEvidenceInputFormat, type TraceEvidenceRow, type TraceFindingPacket, type TraceImprovementArtifacts, type TraceImprovementOptions, type TraceImprovementResult, type TraceIndexedFile, type TraceInspectionArea, type TraceInspectionFinding, type TraceInspectionReport, type TraceInspectionSeverity, type TraceInvestigationOptions, type TraceInvestigationResult, type TraceLiveAction, type TraceLiveActionKind, type TraceLiveAnalysisContext, type TraceLiveAnalyst, type TraceLiveBatch, type TraceLiveEvidence, type TraceLiveFinding, type TraceLiveLoop, type TraceLiveSeverity, type TraceRecommendation, type TraceReplayProof, type TraceSessionIndex, type TraceSessionIndexRow, type TraceStoreInvestigationOptions, type TraceStoreInvestigationResult, type TraceStreamEvent, type TraceStreamOptions, type TraceStreamReplayOptions, type TraceStreamSession, type TracesConfig, type TriggerPair, type UploadBackend, type UploadItem, type UploadPlan, type UploadRecord, type UploadResult, type UploadState, type UserPromptInput, alreadyUploaded, analyzeAdoption, analyzeLiveBatch, analyzeReactions, analyzeSpans, applyRedactor, buildPolicyEvidenceRecord, buildSessionIndex, buildSessionIndexFromRows, buildTraceFindingPacket, capText, classifyLiveActions, classifyReaction, claudeActor, codexActor, collectPolicyEvidence, collectSessionIndex, collectSessions, commandAnalyzer, commandRedactor, countSkillRunsJsonl, cwdMatchesSelection, defaultTraceLiveAnalysts, equivalentGitCwds, executeUpload, exportTraceEvidenceFile, exportTraceEvidenceRows, exportTraceEvidenceText, haloAnalyzer, inspectSessionIndex, knownHarnesses, listAdapters, loadState, loadTracesConfig, locateSessions, looksLikeAgentPrompt, mergeTracesConfig, normalizeRemote, parseIsoToEpochMs, parseSession, parseSince, planUpload, readSessionIndexFile, redactSpans, renderInspectionReport, resolveAdapter, resolveRepoAttrs, resolveSessionRepoAttrs, runCommand, runExternalAnalyzers, runPipelines, runTraceImprovementLoop, runTraceInvestigation, runTraceStoreInvestigation, saveReport, saveState, scanSessions, selectAdapters, serializeInspectionReport, serializePolicyEvidence, serializeSessionIndex, serializeSpans, serializeTraceStreamEvent, sessionHash, span, stampRepoAttrs, streamSessions, textIsSynthetic, toOpenInferenceSpan, toRuntimeStore, toTraceSpanEvents, traceStreamEventsFromSpans, uploadKey, userPromptSpan, watchSessions, writeInspectionReportFile, writeOtlpFile, writePolicyEvidenceFile, writeSessionIndexFile, writeTraceEvidenceExportFile, writeTraceImprovementArtifacts };
+export { ACTOR_ATTR, ATTR, type Actor, type AdoptionOptions, type AdoptionReport, AmpAdapter, type AnalyzeOptions, type AnalyzeResult, type BuildPolicyEvidenceOptions, type BuildSessionIndexOptions, type BuildTraceFindingPacketOptions, CODING_REDACTION_RULES, CONTENT_CAP, CORRECTIVE_REACTIONS, ClaudeAdapter, CodexAdapter, type CollectOptions, type CollectPolicyEvidenceOptions, type CollectSessionIndexOptions, CopilotAdapter, DEFAULT_HARNESS, type ExecuteOptions, type ExternalAnalysisResult, type ExternalAnalyzer, FactoryAdapter, type FindingStore, ForgeAdapter, GeminiAdapter, type HarnessTraceAdapter, INGEST_SOURCE_CLI, type ImprovementAdapter, type ImprovementAdapterInput, type ImprovementProposal, type InspectSessionIndexOptions, type LiveBatchOptions, type LocateOptions, type ObservedLoop, type ObserverOptions, OpencodeAdapter, type OtlpSpan, type OtlpSpanKind, type OtlpStatusCode, PiAdapter, type PipelineOptions, type PipelineReport, type PlanOptions, type PolicyEvidenceLoopSummary, type PolicyEvidenceRecord, type PolicyEvidenceToolSummary, QwenAdapter, REACTIONS, type Reaction, type ReactionReport, type ReactionSessionReport, type RecommendationWriter, type Redactor, type RepoAttrs, type RepoResolution, type RepoResolutionSource, type RunResult, type RuntimeTrace, type ScanOptions, type ScannedSession, type SessionBatch, type SessionRef, type SpanInput, type SpanRedaction, TRACES_REDACTION_RULES, type TraceClaim, type TraceContextIndex, type TraceContextRoot, type TraceEvidenceExportOptions, type TraceEvidenceExportResult, type TraceEvidenceFormatOption, type TraceEvidenceInputFormat, type TraceEvidenceRow, type TraceFindingPacket, type TraceImprovementArtifacts, type TraceImprovementOptions, type TraceImprovementResult, type TraceIndexedFile, type TraceInspectionArea, type TraceInspectionFinding, type TraceInspectionReport, type TraceInspectionSeverity, type TraceInvestigationOptions, type TraceInvestigationResult, type TraceLiveAction, type TraceLiveActionKind, type TraceLiveAnalysisContext, type TraceLiveAnalyst, type TraceLiveBatch, type TraceLiveEvidence, type TraceLiveFinding, type TraceLiveLoop, type TraceLiveSeverity, type TraceRecommendation, type TraceReplayProof, type TraceSessionIndex, type TraceSessionIndexRow, type TraceStoreInvestigationOptions, type TraceStoreInvestigationResult, type TraceStreamEvent, type TraceStreamOptions, type TraceStreamReplayOptions, type TraceStreamSession, type TracesConfig, type TriggerPair, type UploadBackend, type UploadItem, type UploadPlan, type UploadRecord, type UploadResult, type UploadState, type UserPromptInput, alreadyUploaded, analyzeAdoption, analyzeLiveBatch, analyzeReactions, analyzeSpans, applyRedactor, buildPolicyEvidenceRecord, buildSessionIndex, buildSessionIndexFromRows, buildTraceFindingPacket, capText, classifyLiveActions, classifyReaction, claudeActor, codexActor, collectPolicyEvidence, collectSessionIndex, collectSessions, commandAnalyzer, commandRedactor, countSkillRunsJsonl, cwdMatchesSelection, defaultTraceLiveAnalysts, equivalentGitCwds, executeUpload, exportTraceEvidenceFile, exportTraceEvidenceRows, exportTraceEvidenceText, haloAnalyzer, inspectSessionIndex, knownHarnesses, listAdapters, loadState, loadTracesConfig, locateSessions, looksLikeAgentPrompt, mergeTracesConfig, normalizeRemote, parseIsoToEpochMs, parseSession, parseSince, planUpload, readSessionIndexFile, redactSpans, renderInspectionReport, resolveAdapter, resolveRepoAttrs, resolveSessionRepoAttrs, runCommand, runExternalAnalyzers, runPipelines, runTraceImprovementLoop, runTraceInvestigation, runTraceStoreInvestigation, saveReport, saveState, scanSessions, selectAdapters, serializeInspectionReport, serializePolicyEvidence, serializeSessionIndex, serializeSpans, serializeTraceStreamEvent, sessionHash, span, stampRepoAttrs, stampSpanWorkdirRepoAttrs, streamSessions, textIsSynthetic, toOpenInferenceSpan, toRuntimeStore, toTraceSpanEvents, traceStreamEventsFromSpans, uploadKey, userPromptSpan, watchSessions, writeInspectionReportFile, writeOtlpFile, writePolicyEvidenceFile, writeSessionIndexFile, writeTraceEvidenceExportFile, writeTraceImprovementArtifacts };

package/dist/index.js

@@ -83,6 +83,7 @@ import {
   sessionHash,
   span,
   stampRepoAttrs,
+  stampSpanWorkdirRepoAttrs,
   streamSessions,
   textIsSynthetic,
   toOpenInferenceSpan,
@@ -98,7 +99,7 @@ import {
   writeSessionIndexFile,
   writeTraceEvidenceExportFile,
   writeTraceImprovementArtifacts
-} from "./chunk-YS5KIWLY.js";
+} from "./chunk-SV7GW5LB.js";
 
 // src/collect.ts
 async function collectSessions(opts = {}) {
@@ -216,6 +217,7 @@ export {
   sessionHash,
   span,
   stampRepoAttrs,
+  stampSpanWorkdirRepoAttrs,
   streamSessions,
   textIsSynthetic,
   toOpenInferenceSpan,

package/package.json

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