@tangle-network/agent-runtime 0.8.0 → 0.11.0

package/dist/agent.js

@@ -0,0 +1,475 @@
+import {
+  __require
+} from "./chunk-DGUM43GV.js";
+
+// src/agent/surfaces.ts
+import { existsSync } from "fs";
+import { isAbsolute, join } from "path";
+function resolveSubjectPath(subject, surfaces, repoRoot) {
+  const rel = relativePathForSubject(subject, surfaces);
+  if (rel === null) return null;
+  const abs = isAbsolute(rel) ? rel : join(repoRoot, rel);
+  const exists = existsSync(abs);
+  return {
+    absolutePath: abs,
+    repoRelativePath: rel,
+    exists,
+    intent: exists ? "edit-existing" : "create-new"
+  };
+}
+function relativePathForSubject(subject, surfaces) {
+  switch (subject.kind) {
+    case "knowledge.wiki":
+    case "knowledge.stale":
+      return join(surfaces.knowledge, `${subject.slug}.md`);
+    case "knowledge.claim":
+      return join(surfaces.knowledge, "claims", `${slugify(subject.topic)}.md`);
+    case "knowledge.raw":
+      return join(surfaces.knowledge, "raw", `${subject.sourceId}.md`);
+    case "system-prompt":
+      return join(surfaces.systemPrompt, `${slugify(subject.section)}.md`);
+    case "tool-doc":
+      return subject.aspect ? join(surfaces.tools, subject.tool, `${slugify(subject.aspect)}.md`) : join(surfaces.tools, subject.tool, "README.md");
+    case "new-tool":
+      return join(surfaces.tools, subject.name, "README.md");
+    case "rag":
+      if (!surfaces.rag) return null;
+      return join(surfaces.rag, subject.corpus, `${subject.docId}.md`);
+    case "memory":
+      if (!surfaces.memory) return null;
+      return join(surfaces.memory, `${slugify(subject.key)}.json`);
+    case "scaffolding":
+      if (!surfaces.scaffolding) return null;
+      return join(surfaces.scaffolding, `${slugify(subject.concern)}.md`);
+    case "output-schema":
+      if (!surfaces.outputSchema) return null;
+      return surfaces.outputSchema;
+    case "websearch.outdated":
+    case "prior-run-summary":
+      return null;
+    case "cluster":
+      return null;
+  }
+}
+function slugify(s) {
+  return s.toLowerCase().replace(/[^a-z0-9-]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 200) || "untitled";
+}
+function validateSurfaces(surfaces, repoRoot) {
+  const issues = [];
+  const dirSurfaces = [
+    "systemPrompt",
+    "tools",
+    "personas",
+    "knowledge"
+  ];
+  const fileSurfaces = ["rubric"];
+  const optionalDirSurfaces = [
+    "scaffolding",
+    "memory",
+    "rag"
+  ];
+  const optionalFileSurfaces = ["outputSchema"];
+  for (const key of dirSurfaces) {
+    const p = surfaces[key];
+    if (!p) {
+      issues.push({ surface: key, path: "", reason: "missing" });
+      continue;
+    }
+    const abs = isAbsolute(p) ? p : join(repoRoot, p);
+    if (!existsSync(abs)) {
+      issues.push({ surface: key, path: p, reason: "missing" });
+    }
+  }
+  for (const key of fileSurfaces) {
+    const p = surfaces[key];
+    if (!p) {
+      issues.push({ surface: key, path: "", reason: "missing" });
+      continue;
+    }
+    const abs = isAbsolute(p) ? p : join(repoRoot, p);
+    if (!existsSync(abs)) {
+      issues.push({ surface: key, path: p, reason: "missing" });
+    }
+  }
+  for (const key of [...optionalDirSurfaces, ...optionalFileSurfaces]) {
+    const p = surfaces[key];
+    if (p === void 0) continue;
+    const abs = isAbsolute(p) ? p : join(repoRoot, p);
+    if (!existsSync(abs)) {
+      issues.push({ surface: key, path: p, reason: "missing" });
+    }
+  }
+  return issues;
+}
+function renderSurfaceIssues(issues, repoRoot) {
+  if (issues.length === 0) return "";
+  const lines = issues.map(
+    (i) => `  - ${i.surface}: ${i.path ? `"${i.path}"` : "<not set>"} (${i.reason})`
+  );
+  return [
+    `Agent surface validation failed against repoRoot=${repoRoot}:`,
+    ...lines,
+    "",
+    "Fix the manifest: every required surface must point at an existing",
+    "directory (systemPrompt / tools / personas / knowledge) or file",
+    "(rubric). Optional surfaces (scaffolding / memory / rag / outputSchema)",
+    "may be omitted; the loop will reject findings targeting omitted",
+    "surfaces rather than fabricating a path."
+  ].join("\n");
+}
+
+// src/agent/define-agent.ts
+var AgentManifestError = class extends Error {
+  constructor(message, agentId, issues = []) {
+    super(message);
+    this.agentId = agentId;
+    this.issues = issues;
+    this.name = "AgentManifestError";
+  }
+  agentId;
+  issues;
+};
+function defineAgent(manifest) {
+  if (!manifest.id || manifest.id.trim().length === 0) {
+    throw new AgentManifestError("defineAgent: `id` is required", manifest.id ?? "");
+  }
+  if (!manifest.repoRoot || manifest.repoRoot.trim().length === 0) {
+    throw new AgentManifestError("defineAgent: `repoRoot` is required", manifest.id);
+  }
+  const issues = validateSurfaces(manifest.surfaces, manifest.repoRoot);
+  if (issues.length > 0) {
+    throw new AgentManifestError(
+      renderSurfaceIssues(issues, manifest.repoRoot),
+      manifest.id,
+      issues
+    );
+  }
+  const total = manifest.rubric.dimensions.reduce((acc, d) => acc + d.weight, 0);
+  if (manifest.rubric.dimensions.length > 0 && (total < 0.5 || total > 1.5)) {
+    throw new AgentManifestError(
+      `defineAgent(${manifest.id}): rubric dimension weights sum to ${total.toFixed(3)} \u2014 should be ~1.0`,
+      manifest.id
+    );
+  }
+  return manifest;
+}
+
+// src/agent/improvement-adapter.ts
+import { readFileSync } from "fs";
+import { spawnSync } from "child_process";
+import {
+  parseFindingSubject
+} from "@tangle-network/agent-eval";
+var DEFAULT_CREATE_KINDS = [
+  "knowledge.wiki",
+  "knowledge.claim",
+  "knowledge.raw",
+  "new-tool"
+];
+function createSurfaceImprovementAdapter(opts) {
+  const mode = opts.mode ?? "none";
+  const allowCreate = opts.allowCreateForKinds ?? DEFAULT_CREATE_KINDS;
+  return {
+    async proposeFromFindings(findings) {
+      const edits = [];
+      const errors = [];
+      let skipped = 0;
+      for (const f of findings) {
+        const subject = parseFindingSubject(f.subject);
+        if (subject === null) {
+          if (f.subject !== void 0) {
+            errors.push({
+              findingId: f.finding_id,
+              subject: f.subject,
+              message: "subject does not parse against the finding-subject grammar"
+            });
+          } else {
+            skipped += 1;
+          }
+          continue;
+        }
+        if (subject.kind === "cluster") {
+          skipped += 1;
+          continue;
+        }
+        if (subject.kind.startsWith("knowledge.")) {
+          skipped += 1;
+          continue;
+        }
+        const target = resolveSubjectPath(subject, opts.surfaces, opts.repoRoot);
+        if (target === null) {
+          errors.push({
+            findingId: f.finding_id,
+            subject: f.subject ?? "",
+            message: `subject kind "${subject.kind}" targets an undeclared surface; declare it in AgentSurfaces or stop emitting this subject`
+          });
+          continue;
+        }
+        if (target.intent === "create-new" && !allowCreate.includes(subject.kind)) {
+          errors.push({
+            findingId: f.finding_id,
+            subject: f.subject ?? "",
+            message: `target ${target.repoRelativePath} does not exist; the kind "${subject.kind}" requires an existing target (analyst named a section that isn't in the codebase)`
+          });
+          continue;
+        }
+        const currentContent = target.exists ? readFileSync(target.absolutePath, "utf-8") : "";
+        let draft;
+        try {
+          draft = await opts.draftPatch({ finding: f, subject, target, currentContent });
+        } catch (err) {
+          errors.push({
+            findingId: f.finding_id,
+            subject: f.subject ?? "",
+            message: `draftPatch threw: ${err instanceof Error ? err.message : String(err)}`
+          });
+          continue;
+        }
+        if (draft.patch.trim().length === 0) {
+          skipped += 1;
+          continue;
+        }
+        edits.push({
+          id: `imp-${f.finding_id}`,
+          sourceFindingId: f.finding_id,
+          subject,
+          target,
+          baseSha256: sha256(currentContent),
+          patch: draft.patch,
+          summary: draft.summary,
+          rationale: draft.rationale,
+          confidence: f.confidence,
+          severity: f.severity
+        });
+      }
+      return { edits, skipped, errors };
+    },
+    async apply(edits) {
+      const applied = [];
+      const warnings = [];
+      if (mode === "none") {
+        warnings.push(
+          "createSurfaceImprovementAdapter: mode=none; no edits applied \u2014 adjust manifest.autoApply.improvement.mode"
+        );
+        return { applied, warnings };
+      }
+      if (mode === "open-pr" && !opts.ghRepo) {
+        warnings.push("createSurfaceImprovementAdapter: mode=open-pr requires `ghRepo`; falling back to no-op");
+        return { applied, warnings };
+      }
+      for (const edit of edits) {
+        const current = edit.target.exists ? readFileSync(edit.target.absolutePath, "utf-8") : "";
+        if (sha256(current) !== edit.baseSha256) {
+          warnings.push(
+            `${edit.target.repoRelativePath}: base SHA mismatch; file changed after draft. Skipping.`
+          );
+          continue;
+        }
+        const ok = applyPatchInPlace(edit, opts.repoRoot);
+        if (!ok) {
+          warnings.push(`${edit.target.repoRelativePath}: git apply failed`);
+          continue;
+        }
+        applied.push(edit.target.repoRelativePath);
+      }
+      if (mode === "open-pr" && applied.length > 0 && opts.ghRepo) {
+        const prUrl = openPullRequest(
+          applied,
+          edits.filter((e) => applied.includes(e.target.repoRelativePath)),
+          opts.repoRoot,
+          opts.ghRepo,
+          opts.baseBranch ?? "main"
+        );
+        if (prUrl) warnings.push(`opened PR: ${prUrl}`);
+        else warnings.push("PR creation failed; edits are committed to a local branch only");
+      }
+      return { applied, warnings };
+    }
+  };
+}
+function applyPatchInPlace(edit, repoRoot) {
+  const result = spawnSync("git", ["apply", "--whitespace=fix", "-p0", "-"], {
+    cwd: repoRoot,
+    input: edit.patch,
+    encoding: "utf-8"
+  });
+  return result.status === 0;
+}
+function openPullRequest(paths, edits, repoRoot, ghRepo, baseBranch) {
+  const branch = `analyst-loop/${Date.now()}-${edits[0]?.sourceFindingId.slice(0, 12) ?? "edits"}`;
+  const checkout = spawnSync("git", ["checkout", "-b", branch], { cwd: repoRoot });
+  if (checkout.status !== 0) return null;
+  const add = spawnSync("git", ["add", ...paths], { cwd: repoRoot });
+  if (add.status !== 0) return null;
+  const title = `analyst-loop: ${edits[0]?.summary ?? `${edits.length} improvement edits`}`;
+  const body = [
+    `Automated analyst-loop edits \u2014 review carefully before merge.`,
+    "",
+    `Source findings:`,
+    ...edits.map((e) => `  - ${e.sourceFindingId} (confidence ${e.confidence.toFixed(2)}, severity ${e.severity})`),
+    "",
+    "Rationales:",
+    ...edits.map((e) => `
+## ${e.target.repoRelativePath}
+
+${e.rationale}`)
+  ].join("\n");
+  const commit = spawnSync("git", ["commit", "-m", title, "-m", body], { cwd: repoRoot });
+  if (commit.status !== 0) return null;
+  const push = spawnSync("git", ["push", "-u", "origin", branch], { cwd: repoRoot });
+  if (push.status !== 0) return null;
+  const pr = spawnSync(
+    "gh",
+    [
+      "pr",
+      "create",
+      "--repo",
+      ghRepo,
+      "--title",
+      title,
+      "--body",
+      body,
+      "--base",
+      baseBranch,
+      "--head",
+      branch
+    ],
+    { cwd: repoRoot, encoding: "utf-8" }
+  );
+  if (pr.status !== 0) return null;
+  return pr.stdout.trim();
+}
+function sha256(s) {
+  const crypto = __require("crypto");
+  return crypto.createHash("sha256").update(s, "utf-8").digest("hex");
+}
+
+// src/agent/knowledge-adapter.ts
+function createSurfaceKnowledgeAdapter(opts, deps) {
+  return {
+    proposeFromFindings(findings) {
+      const batch = deps.proposeFromFindings(findings);
+      return {
+        proposals: batch.proposals,
+        skipped: batch.skipped,
+        errors: batch.errors
+      };
+    },
+    async apply(proposals) {
+      const written = [];
+      const warnings = [];
+      for (const p of proposals) {
+        const proposalText = renderProposalAsWriteBlock(p);
+        if (proposalText === null) {
+          warnings.push(
+            `proposal has no writeBlocks/content; skipping (sourceFindingId=${getSourceFindingId(p)})`
+          );
+          continue;
+        }
+        try {
+          const r = await deps.applyKnowledgeWriteBlocks(opts.knowledgeRoot, proposalText);
+          written.push(...r.written);
+          warnings.push(...r.warnings);
+        } catch (err) {
+          warnings.push(
+            `applyKnowledgeWriteBlocks failed: ${err instanceof Error ? err.message : String(err)}`
+          );
+        }
+      }
+      if (deps.lintAfterApply && written.length > 0) {
+        try {
+          const lintIssues = await deps.lintAfterApply(opts.knowledgeRoot);
+          for (const issue of lintIssues) warnings.push(`lint: ${issue}`);
+        } catch (err) {
+          warnings.push(
+            `lintAfterApply failed: ${err instanceof Error ? err.message : String(err)}`
+          );
+        }
+      }
+      return { written, warnings };
+    }
+  };
+}
+function renderProposalAsWriteBlock(p) {
+  if (!p || typeof p !== "object") return null;
+  const obj = p;
+  if (Array.isArray(obj.writeBlocks)) {
+    const blocks = obj.writeBlocks;
+    if (blocks.length === 0) return null;
+    return blocks.map((b) => typeof b.content === "string" ? b.content : "").filter((s) => s.length > 0).join("\n\n");
+  }
+  if (typeof obj.proposalText === "string") return obj.proposalText;
+  if (typeof obj.content === "string") return obj.content;
+  return null;
+}
+function getSourceFindingId(p) {
+  if (!p || typeof p !== "object") return "<unknown>";
+  const obj = p;
+  if (typeof obj.sourceFindingId === "string") return obj.sourceFindingId;
+  if (typeof obj.id === "string") return obj.id;
+  return "<unknown>";
+}
+
+// src/agent/outcome.ts
+async function measureOutcome(result, opts) {
+  const applied = result.knowledge?.applied ?? [];
+  const improvementsApplied = result.improvement?.applied ?? [];
+  const allApplied = [...applied, ...improvementsApplied];
+  if (allApplied.length === 0) {
+    return {
+      ...result,
+      outcome: {
+        baselineComposite: meanComposite(opts.baseline),
+        afterComposite: meanComposite(opts.baseline),
+        delta: 0,
+        perPersona: opts.baseline.map((b) => ({
+          personaId: b.personaId,
+          before: b.composite,
+          after: b.composite,
+          delta: 0
+        })),
+        rolledBackPaths: []
+      }
+    };
+  }
+  const personaIds = opts.baseline.map((b) => b.personaId);
+  const after = await opts.reRunCohort(personaIds);
+  const afterByPersona = new Map(after.map((r) => [r.personaId, r.composite]));
+  const perPersona = opts.baseline.map((b) => {
+    const a = afterByPersona.get(b.personaId) ?? b.composite;
+    return { personaId: b.personaId, before: b.composite, after: a, delta: a - b.composite };
+  });
+  const baselineComposite = meanComposite(opts.baseline);
+  const afterComposite = meanComposite(after);
+  const delta = afterComposite - baselineComposite;
+  let rolledBackPaths = [];
+  if (delta < 0 && opts.rollbackOnRegression && opts.revert) {
+    await opts.revert(allApplied);
+    rolledBackPaths = [...allApplied];
+  }
+  return {
+    ...result,
+    outcome: {
+      baselineComposite,
+      afterComposite,
+      delta,
+      perPersona,
+      rolledBackPaths
+    }
+  };
+}
+function meanComposite(rows) {
+  if (rows.length === 0) return 0;
+  return rows.reduce((acc, r) => acc + r.composite, 0) / rows.length;
+}
+export {
+  AgentManifestError,
+  createSurfaceImprovementAdapter,
+  createSurfaceKnowledgeAdapter,
+  defineAgent,
+  measureOutcome,
+  renderSurfaceIssues,
+  resolveSubjectPath,
+  validateSurfaces
+};
+//# sourceMappingURL=agent.js.map

package/dist/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/agent/surfaces.ts","../src/agent/define-agent.ts","../src/agent/improvement-adapter.ts","../src/agent/knowledge-adapter.ts","../src/agent/outcome.ts"],"sourcesContent":["/**\n * `AgentSurfaces` — declarative map of the mutable file/directory paths\n * the self-improvement loop can edit on behalf of an agent.\n *\n * The substrate uses this map to resolve every parsed `FindingSubject`\n * (from agent-eval) to a real on-disk path. No per-vertical glue;\n * no fabricated paths; no silent `existsSync(...)` skips that hide\n * misconfiguration from the operator.\n *\n * Surfaces are validated at `defineAgent` time — missing paths fail\n * loud with a list of every offender. A surface that's not needed\n * (e.g. an agent with no RAG corpora) is simply omitted; the loop\n * refuses to route those subjects rather than fabricating a target.\n */\n\nimport { existsSync } from 'node:fs'\nimport { isAbsolute, join } from 'node:path'\nimport type { FindingSubject } from '@tangle-network/agent-eval'\n\n/**\n * Surface declarations. Every path is repo-relative (or absolute) at\n * `defineAgent` time. At resolution time, paths are joined against the\n * agent's `repoRoot`.\n *\n * `systemPrompt`, `tools`, `personas` are DIRECTORIES; the loop appends\n * `<section>.md`, `<tool>/README.md`, `<persona-id>.yaml` etc.\n * `rubric`, `outputSchema` are SINGLE FILES; the loop edits them in\n * place.\n *\n * `knowledge` is the agent-knowledge root (typically `.agent-knowledge`);\n * `applyKnowledgeWriteBlocks` writes pages relative to it.\n *\n * Optional surfaces (`scaffolding`, `memory`, `rag`, `outputSchema`)\n * can be omitted — the loop will reject findings targeting them with a\n * clear log message instead of fabricating a path.\n */\nexport interface AgentSurfaces {\n  /** Directory containing one markdown file per system-prompt section. */\n  systemPrompt: string\n  /** Directory containing one subdir per tool (`<tool>/README.md`). */\n  tools: string\n  /** Single file (TypeScript module) defining the rubric weights + dimensions. */\n  rubric: string\n  /** Knowledge-base root; typically `.agent-knowledge`. */\n  knowledge: string\n  /** Directory containing one YAML/JSON file per persona. */\n  personas: string\n  /** Optional: directory containing scaffolding rules (precondition checks, retry policies). */\n  scaffolding?: string\n  /** Optional: memory store path (JSONL / SQLite / DB). */\n  memory?: string\n  /** Optional: directory containing RAG corpora (`<corpus>/<doc-id>.md`). */\n  rag?: string\n  /** Optional: single file defining the output schema (Zod / JSON Schema). */\n  outputSchema?: string\n}\n\nexport interface ResolvedSurface {\n  /** Absolute filesystem path the operator can `cat` / `vim`. */\n  absolutePath: string\n  /** Repo-relative path for PR descriptions, diffs, audit logs. */\n  repoRelativePath: string\n  /** Whether the path currently exists on disk. */\n  exists: boolean\n  /** The substrate's intent: edit an existing file or create a new one. */\n  intent: 'edit-existing' | 'create-new'\n}\n\n/**\n * Resolve a parsed `FindingSubject` to the file path the substrate\n * should edit (or create) on disk.\n *\n * Returns `null` when:\n *   - the subject targets a surface the agent didn't declare\n *     (e.g. `rag:*` when `surfaces.rag` is undefined), OR\n *   - the subject is a `cluster` (failure-mode emits these as evidence,\n *     not actionable mutations — they don't route to a file).\n *\n * Returns a `ResolvedSurface` with `intent: 'create-new'` when the\n * subject names a path that doesn't yet exist (e.g. a new wiki page).\n * The caller chooses whether to honour the create — for tightly-managed\n * surfaces like `systemPrompt` it's usually a contract violation\n * (the analyst named a section that doesn't exist); for `knowledge`\n * it's the whole point.\n */\nexport function resolveSubjectPath(\n  subject: FindingSubject,\n  surfaces: AgentSurfaces,\n  repoRoot: string,\n): ResolvedSurface | null {\n  const rel = relativePathForSubject(subject, surfaces)\n  if (rel === null) return null\n  const abs = isAbsolute(rel) ? rel : join(repoRoot, rel)\n  const exists = existsSync(abs)\n  return {\n    absolutePath: abs,\n    repoRelativePath: rel,\n    exists,\n    intent: exists ? 'edit-existing' : 'create-new',\n  }\n}\n\nfunction relativePathForSubject(\n  subject: FindingSubject,\n  surfaces: AgentSurfaces,\n): string | null {\n  switch (subject.kind) {\n    case 'knowledge.wiki':\n    case 'knowledge.stale':\n      return join(surfaces.knowledge, `${subject.slug}.md`)\n    case 'knowledge.claim':\n      // Claims land in a per-topic claims directory under the knowledge root.\n      return join(surfaces.knowledge, 'claims', `${slugify(subject.topic)}.md`)\n    case 'knowledge.raw':\n      return join(surfaces.knowledge, 'raw', `${subject.sourceId}.md`)\n    case 'system-prompt':\n      return join(surfaces.systemPrompt, `${slugify(subject.section)}.md`)\n    case 'tool-doc':\n      return subject.aspect\n        ? join(surfaces.tools, subject.tool, `${slugify(subject.aspect)}.md`)\n        : join(surfaces.tools, subject.tool, 'README.md')\n    case 'new-tool':\n      return join(surfaces.tools, subject.name, 'README.md')\n    case 'rag':\n      if (!surfaces.rag) return null\n      return join(surfaces.rag, subject.corpus, `${subject.docId}.md`)\n    case 'memory':\n      if (!surfaces.memory) return null\n      return join(surfaces.memory, `${slugify(subject.key)}.json`)\n    case 'scaffolding':\n      if (!surfaces.scaffolding) return null\n      return join(surfaces.scaffolding, `${slugify(subject.concern)}.md`)\n    case 'output-schema':\n      if (!surfaces.outputSchema) return null\n      // outputSchema is a single file — the field name is metadata for\n      // the LLM-drafted patch, not a separate path.\n      return surfaces.outputSchema\n    case 'websearch.outdated':\n    case 'prior-run-summary':\n      // Stale signals don't map to a single file — they're handled by\n      // the knowledge adapter as `agent-knowledge:stale:*` after the\n      // operator decides which wiki page to retract. The substrate\n      // doesn't auto-route them.\n      return null\n    case 'cluster':\n      // failure-mode cluster labels are evidence, not mutations.\n      return null\n  }\n}\n\nfunction slugify(s: string): string {\n  return (\n    s\n      .toLowerCase()\n      .replace(/[^a-z0-9-]+/g, '-')\n      .replace(/^-+|-+$/g, '')\n      .slice(0, 200) || 'untitled'\n  )\n}\n\n/**\n * Validate that every declared surface exists on disk under `repoRoot`.\n *\n * Returns an array of `SurfaceValidationIssue` — empty when all required\n * surfaces resolve. `defineAgent` throws with the issues rendered, so\n * a misconfigured manifest fails at startup (not at the first finding\n * the loop produces 20 minutes later).\n */\nexport interface SurfaceValidationIssue {\n  surface: keyof AgentSurfaces\n  path: string\n  reason: 'missing' | 'not-directory' | 'not-file'\n}\n\nexport function validateSurfaces(\n  surfaces: AgentSurfaces,\n  repoRoot: string,\n): ReadonlyArray<SurfaceValidationIssue> {\n  const issues: SurfaceValidationIssue[] = []\n  const dirSurfaces: ReadonlyArray<keyof AgentSurfaces> = [\n    'systemPrompt',\n    'tools',\n    'personas',\n    'knowledge',\n  ]\n  const fileSurfaces: ReadonlyArray<keyof AgentSurfaces> = ['rubric']\n  const optionalDirSurfaces: ReadonlyArray<keyof AgentSurfaces> = [\n    'scaffolding',\n    'memory',\n    'rag',\n  ]\n  const optionalFileSurfaces: ReadonlyArray<keyof AgentSurfaces> = ['outputSchema']\n\n  for (const key of dirSurfaces) {\n    const p = surfaces[key] as string | undefined\n    if (!p) {\n      issues.push({ surface: key, path: '', reason: 'missing' })\n      continue\n    }\n    const abs = isAbsolute(p) ? p : join(repoRoot, p)\n    if (!existsSync(abs)) {\n      issues.push({ surface: key, path: p, reason: 'missing' })\n    }\n  }\n  for (const key of fileSurfaces) {\n    const p = surfaces[key] as string | undefined\n    if (!p) {\n      issues.push({ surface: key, path: '', reason: 'missing' })\n      continue\n    }\n    const abs = isAbsolute(p) ? p : join(repoRoot, p)\n    if (!existsSync(abs)) {\n      issues.push({ surface: key, path: p, reason: 'missing' })\n    }\n  }\n  for (const key of [...optionalDirSurfaces, ...optionalFileSurfaces]) {\n    const p = surfaces[key] as string | undefined\n    if (p === undefined) continue\n    const abs = isAbsolute(p) ? p : join(repoRoot, p)\n    if (!existsSync(abs)) {\n      issues.push({ surface: key, path: p, reason: 'missing' })\n    }\n  }\n  return issues\n}\n\nexport function renderSurfaceIssues(\n  issues: ReadonlyArray<SurfaceValidationIssue>,\n  repoRoot: string,\n): string {\n  if (issues.length === 0) return ''\n  const lines = issues.map(\n    (i) => `  - ${i.surface}: ${i.path ? `\"${i.path}\"` : '<not set>'} (${i.reason})`,\n  )\n  return [\n    `Agent surface validation failed against repoRoot=${repoRoot}:`,\n    ...lines,\n    '',\n    'Fix the manifest: every required surface must point at an existing',\n    'directory (systemPrompt / tools / personas / knowledge) or file',\n    '(rubric). Optional surfaces (scaffolding / memory / rag / outputSchema)',\n    'may be omitted; the loop will reject findings targeting omitted',\n    'surfaces rather than fabricating a path.',\n  ].join('\\n')\n}\n","/**\n * `defineAgent` — typed, validated manifest API for declarative agent\n * configuration. The substrate consumes this manifest to wire the\n * canonical eval pattern + analyst self-improvement loop without any\n * per-vertical glue.\n *\n * Design goal: scale to 1000s of vertical agents. Every agent declares\n * its surfaces, rubric, runtime, and analyst configuration in ~50 lines.\n * No per-vertical `ImprovementAdapter`. No per-vertical CLI. No\n * fabricated paths.\n *\n * Validation: `defineAgent` runs `validateSurfaces` synchronously and\n * throws a structured error if any required surface is missing on\n * disk. The cost is one filesystem stat per surface (cheap); the\n * benefit is a manifest that can't ship broken.\n */\n\nimport type { TraceAnalystKindSpec } from '@tangle-network/agent-eval'\nimport {\n  type AgentSurfaces,\n  renderSurfaceIssues,\n  validateSurfaces,\n} from './surfaces'\n\n// ── manifest ─────────────────────────────────────────────────────────\n\n/**\n * The full agent manifest. Each agent ships ONE of these.\n *\n * Generics:\n *   `TPersona` — the agent's persona shape (loaded from\n *     `surfaces.personas`). Defaults to `unknown` so the substrate's\n *     persona discovery (`loadPersonas`) can accept anything; per-agent\n *     code re-narrows when it matters.\n *   `TRunOutput` — the shape `runtime.act` returns. Used by the rubric\n *     scorers and emitted into the trace.\n */\nexport interface AgentManifest<TPersona = unknown, TRunOutput = unknown> {\n  /**\n   * Stable identifier — used as `projectId` in traces, as the analyst\n   * loop's `runId` prefix, and as the namespace under which findings\n   * are persisted. MUST match the agent's repo name to keep\n   * cross-repo telemetry joinable.\n   */\n  id: string\n\n  /**\n   * Filesystem root the substrate resolves surface paths against.\n   * Typically `process.cwd()` or a fixed absolute path. Use an\n   * absolute path when the agent's tests may run from subdirectories\n   * (vitest sometimes shifts cwd).\n   */\n  repoRoot: string\n\n  /**\n   * Map of mutable surfaces the self-improvement loop can edit. See\n   * `AgentSurfaces` — required: `systemPrompt`, `tools`, `rubric`,\n   * `knowledge`, `personas`. Optional: `scaffolding`, `memory`, `rag`,\n   * `outputSchema`.\n   *\n   * Every required path is validated at `defineAgent` time. Missing\n   * paths throw with the full list of offenders.\n   */\n  surfaces: AgentSurfaces\n\n  /**\n   * Rubric the substrate uses to score each run. Dimensions × weights\n   * × judges. The substrate computes the weighted composite and\n   * stamps it into the RunRecord.\n   */\n  rubric: AgentRubric<TRunOutput>\n\n  /**\n   * Runtime adapter — how the substrate INVOKES the agent against a\n   * persona. The `act` function takes a persona + a context (with the\n   * tracer the substrate threads through for span emission) and\n   * returns the run output the rubric will score.\n   *\n   * The agent's existing production runtime goes in here; the\n   * substrate is intentionally thin around it.\n   */\n  runtime: AgentRuntime<TPersona, TRunOutput>\n\n  /**\n   * Persona discovery — the substrate loads personas via this function\n   * at eval start. Can read from `surfaces.personas`, an API, or be\n   * hardcoded. The substrate calls it once per `runAgentEval` call;\n   * persona ordering is preserved.\n   */\n  personas: () => Promise<ReadonlyArray<TPersona>>\n\n  /**\n   * Analyst kinds the substrate runs against each persona's trace.\n   * Defaults to `DEFAULT_TRACE_ANALYST_KINDS` from agent-eval. Per-agent\n   * authors can prune (e.g. skip `knowledge-poisoning` when there's no\n   * knowledge base) or extend (custom domain kinds).\n   *\n   * Empty array disables the loop — useful for `pnpm eval --no-analyst`.\n   */\n  analystKinds: ReadonlyArray<TraceAnalystKindSpec>\n\n  /**\n   * Analyst LLM configuration. The substrate uses these for all four\n   * kinds (override per-kind via `analystKinds` if needed).\n   */\n  analyst: AnalystConfig\n\n  /**\n   * Auto-apply policy. Knowledge / improvement edits land only when\n   * `enabled === true` AND the source finding's confidence meets the\n   * threshold. `mode` controls how applies happen: `'write'` mutates\n   * files in-place; `'open-pr'` writes to a branch and opens a PR.\n   *\n   * Default: knowledge auto-applies at confidence ≥0.85 in `'write'`\n   * mode (wiki edits are git-reversible); improvement stays at\n   * `enabled: false` until the agent author has measured precision.\n   */\n  autoApply?: AutoApplyPolicy\n}\n\nexport interface AgentRubric<TRunOutput> {\n  /** Dimensions composing the weighted score. Weights sum to 1.0 by convention. */\n  dimensions: ReadonlyArray<RubricDimension<TRunOutput>>\n  /**\n   * Optional judges layered on top of deterministic dimensions. Each\n   * judge returns a score per dimension; the substrate averages judges\n   * (mean by default) for the LLM contribution.\n   */\n  judges?: ReadonlyArray<JudgeConfig<TRunOutput>>\n}\n\nexport interface RubricDimension<TRunOutput> {\n  /** Unique identifier — appears in finding subjects (`rubric:<id>`). */\n  id: string\n  /** 0..1 — weight in the composite. */\n  weight: number\n  /**\n   * Deterministic scorer: given the persona + run output, returns a\n   * 0..1 score. The substrate sums weight × score across dimensions\n   * for the deterministic composite; judges supplement subjective dims.\n   */\n  score: (input: { persona: unknown; output: TRunOutput }) => number\n  /** Optional human-readable label for reports. */\n  label?: string\n}\n\nexport interface JudgeConfig<TRunOutput> {\n  /** Judge identifier — appears in trace spans + manifest. */\n  id: string\n  /** Model snapshot to invoke. Pin the snapshot (`claude-sonnet-4-6@2025-04-15`); the validator rejects bare aliases. */\n  model: string\n  /** Dimensions this judge scores. */\n  dimensions: ReadonlyArray<string>\n  /**\n   * Optional rubric anchors — text examples the judge sees as a\n   * few-shot prompt to calibrate. STRONGLY recommended for subjective\n   * dimensions; required by the calibration gate (Pearson ≥0.7).\n   */\n  anchors?: ReadonlyArray<{ input: string; output: TRunOutput; expected: Record<string, number> }>\n}\n\nexport interface AgentRuntime<TPersona, TRunOutput> {\n  /**\n   * Invoke the agent against one persona. Returns the structured run\n   * output the rubric will score.\n   *\n   * `ctx.emitter` is the substrate-threaded `TraceEmitter` — agents\n   * SHOULD record their LLM calls / tool calls through it for capture\n   * integrity. `ctx.deadlineMs` is wall-clock; the runtime SHOULD\n   * honour it for graceful cancel.\n   */\n  act: (persona: TPersona, ctx: AgentRunContext) => Promise<TRunOutput>\n}\n\nexport interface AgentRunContext {\n  /** Substrate-managed trace emitter. */\n  emitter: import('@tangle-network/agent-eval').TraceEmitter\n  /** Stable run id for this persona × variant cell. */\n  runId: string\n  /** Variant the runtime is exercising (e.g. `'baseline'`, `'source-grounded'`). */\n  variantId?: string\n  /** Wall-clock deadline (epoch ms). The runtime SHOULD honour for graceful cancel. */\n  deadlineMs?: number\n  /** Optional abort signal. */\n  signal?: AbortSignal\n}\n\nexport interface AnalystConfig {\n  /** Model the analyst kinds use. Override per-kind via `analystKinds[i].cost.models`. */\n  model: string\n  /** Optional total budget across all kinds for one run. Substrate enforces via `BudgetGuard`. */\n  budgetUsd?: number\n  /** Backend hint for the AxAIService factory — same shape every kind uses. */\n  backend?: {\n    name?: 'openai' | 'router'\n    apiKey?: string\n    baseUrl?: string\n  }\n}\n\nexport interface AutoApplyPolicy {\n  knowledge?: {\n    enabled: boolean\n    confidenceThreshold?: number\n    mode?: 'write' | 'open-pr'\n  }\n  improvement?: {\n    enabled: boolean\n    confidenceThreshold?: number\n    mode?: 'write' | 'open-pr'\n  }\n}\n\n// ── factory + validation ─────────────────────────────────────────────\n\nexport class AgentManifestError extends Error {\n  constructor(\n    message: string,\n    public readonly agentId: string,\n    public readonly issues: ReadonlyArray<unknown> = [],\n  ) {\n    super(message)\n    this.name = 'AgentManifestError'\n  }\n}\n\n/**\n * Construct a validated agent manifest. Throws `AgentManifestError`\n * if any required surface is missing on disk.\n *\n * Generics: pass your persona / output types if you want narrowed\n * `runtime.act` signatures:\n *   `defineAgent<TaxPersona, TaxRunOutput>({ ... })`\n *\n * Most callers don't need the generics — the substrate operates on\n * `unknown` payloads internally and the manifest's `score` /\n * `runtime.act` see the typed shapes via TypeScript inference at\n * the call site.\n */\nexport function defineAgent<TPersona = unknown, TRunOutput = unknown>(\n  manifest: AgentManifest<TPersona, TRunOutput>,\n): AgentManifest<TPersona, TRunOutput> {\n  if (!manifest.id || manifest.id.trim().length === 0) {\n    throw new AgentManifestError('defineAgent: `id` is required', manifest.id ?? '')\n  }\n  if (!manifest.repoRoot || manifest.repoRoot.trim().length === 0) {\n    throw new AgentManifestError('defineAgent: `repoRoot` is required', manifest.id)\n  }\n  const issues = validateSurfaces(manifest.surfaces, manifest.repoRoot)\n  if (issues.length > 0) {\n    throw new AgentManifestError(\n      renderSurfaceIssues(issues, manifest.repoRoot),\n      manifest.id,\n      issues,\n    )\n  }\n  // Lightweight rubric sanity: weights sum to ~1.0 (no hard requirement —\n  // the substrate normalizes — but flag wildly miscalibrated weights).\n  const total = manifest.rubric.dimensions.reduce((acc, d) => acc + d.weight, 0)\n  if (manifest.rubric.dimensions.length > 0 && (total < 0.5 || total > 1.5)) {\n    throw new AgentManifestError(\n      `defineAgent(${manifest.id}): rubric dimension weights sum to ${total.toFixed(3)} — should be ~1.0`,\n      manifest.id,\n    )\n  }\n  return manifest\n}\n","/**\n * Substrate-default `ImprovementAdapter` — surfaces-driven, LLM-drafted\n * patches, optional auto-apply or PR-open.\n *\n * This is the one ImprovementAdapter every vertical agent uses. The\n * substrate parses each finding's `subject` via\n * `parseFindingSubject` (agent-eval), resolves it to a real file path\n * via the agent's `AgentSurfaces`, reads the current content, and asks\n * an LLM to draft a unified-diff patch given the finding + current\n * content + per-kind editing-discipline rules.\n *\n * Auto-apply gates on the source-finding's confidence and the\n * autoApply.improvement policy. Two modes:\n *   `write` — apply the patch in-place via `git apply -p0`. Operator\n *     reviews via `git diff`.\n *   `open-pr` — write to a branch, commit, push, open a PR via `gh`.\n *     Operator reviews via the PR UI.\n *\n * Fail-loud rules:\n *   - Findings whose subject doesn't parse → counted in `errors`.\n *   - Findings whose subject targets an undeclared surface → counted in\n *     `errors` with the offending kind in the message.\n *   - Findings whose target path doesn't exist AND the kind isn't a\n *     create-new variant (`new-tool`, `knowledge.wiki`) → counted in\n *     `errors` with the resolved path in the message.\n *   - LLM drafts that fail JSON-schema validation → counted in\n *     `errors` with the schema issue.\n *\n * No silent skips. Every dropped finding has a recorded reason the\n * loop's report surfaces.\n */\n\nimport { readFileSync } from 'node:fs'\nimport { spawnSync } from 'node:child_process'\nimport {\n  type AnalystFinding,\n  type FindingSubject,\n  parseFindingSubject,\n} from '@tangle-network/agent-eval'\nimport type { ImprovementAdapter } from '../analyst-loop/types'\nimport type { AgentSurfaces, ResolvedSurface } from './surfaces'\nimport { resolveSubjectPath } from './surfaces'\n\n// ── proposal shape ───────────────────────────────────────────────────\n\nexport interface SurfaceImprovementEdit {\n  /** Stable id derived from the source finding so re-proposals are idempotent. */\n  id: string\n  /** The finding that produced this edit — for revert + audit trail. */\n  sourceFindingId: string\n  /** Parsed subject; included so the apply step doesn't re-parse. */\n  subject: FindingSubject\n  /** Resolved on-disk target. */\n  target: ResolvedSurface\n  /** SHA-256 of the current file content the patch was drafted against. */\n  baseSha256: string\n  /** Unified-diff patch the LLM drafted (relative to `target.absolutePath`). */\n  patch: string\n  /** One-line summary the operator sees in the report / PR title. */\n  summary: string\n  /** Multi-line rationale for the PR body — finding context + LLM reasoning. */\n  rationale: string\n  /** Carry-forward from the finding so the apply gate can check the threshold. */\n  confidence: number\n  /** Carry-forward severity for prioritization. */\n  severity: AnalystFinding['severity']\n}\n\nexport interface CreateSurfaceImprovementAdapterOpts {\n  surfaces: AgentSurfaces\n  repoRoot: string\n  /**\n   * LLM-draft callback. Given a finding + current file content + the\n   * resolved target, returns a unified-diff patch + summary + rationale.\n   *\n   * Required — the substrate doesn't ship a hardcoded prompt; the agent\n   * author picks the model (Haiku for cheap routine drafts, Sonnet for\n   * substantive prompt rewrites, etc.) via this callback.\n   */\n  draftPatch: (input: DraftPatchInput) => Promise<DraftPatchOutput>\n  /**\n   * Apply mode:\n   *   `write` — `git apply` in-place; operator reviews via `git diff`\n   *   `open-pr` — branch + commit + push + `gh pr create`\n   *   `none` — never apply; collect proposals for the report only\n   *\n   * The `apply` method honours this even when the loop calls it; the\n   * effective behaviour is also gated on the per-finding confidence\n   * threshold via `runAnalystLoop`'s `autoApply` policy.\n   */\n  mode?: 'write' | 'open-pr' | 'none'\n  /** When `mode === 'open-pr'`, the base branch new PRs target. Default: `main`. */\n  baseBranch?: string\n  /** Required for `mode === 'open-pr'` — the GH owner/repo (`tangle-network/tax-agent`). */\n  ghRepo?: string\n  /**\n   * When the resolved target doesn't exist, allow the substrate to\n   * CREATE the file (for `knowledge.wiki`, `new-tool` subjects). Default\n   * true for those kinds, false for `system-prompt` / `rubric` / etc.\n   * (named sections that don't exist are a contract violation, not a\n   * scaffolding opportunity).\n   */\n  allowCreateForKinds?: ReadonlyArray<FindingSubject['kind']>\n}\n\nexport interface DraftPatchInput {\n  finding: AnalystFinding\n  subject: FindingSubject\n  target: ResolvedSurface\n  /** Current file content (empty string when `intent === 'create-new'`). */\n  currentContent: string\n}\n\nexport interface DraftPatchOutput {\n  /** Unified diff against the current file content. Empty string skips this finding. */\n  patch: string\n  /** One-line summary for the operator. */\n  summary: string\n  /** Multi-line rationale for the PR body. */\n  rationale: string\n}\n\n// ── factory ──────────────────────────────────────────────────────────\n\nconst DEFAULT_CREATE_KINDS: ReadonlyArray<FindingSubject['kind']> = [\n  'knowledge.wiki',\n  'knowledge.claim',\n  'knowledge.raw',\n  'new-tool',\n]\n\nexport function createSurfaceImprovementAdapter(\n  opts: CreateSurfaceImprovementAdapterOpts,\n): ImprovementAdapter<SurfaceImprovementEdit> {\n  const mode = opts.mode ?? 'none'\n  const allowCreate = opts.allowCreateForKinds ?? DEFAULT_CREATE_KINDS\n\n  return {\n    async proposeFromFindings(findings) {\n      const edits: SurfaceImprovementEdit[] = []\n      const errors: Array<{ findingId: string; subject: string; message: string }> = []\n      let skipped = 0\n\n      for (const f of findings) {\n        const subject = parseFindingSubject(f.subject)\n        if (subject === null) {\n          if (f.subject !== undefined) {\n            errors.push({\n              findingId: f.finding_id,\n              subject: f.subject,\n              message: 'subject does not parse against the finding-subject grammar',\n            })\n          } else {\n            // Subject-less findings are descriptive, not actionable —\n            // legitimate; count in `skipped` not `errors`.\n            skipped += 1\n          }\n          continue\n        }\n\n        // `cluster` findings (failure-mode) are evidence, not mutations.\n        if (subject.kind === 'cluster') {\n          skipped += 1\n          continue\n        }\n\n        // `agent-knowledge:*` findings flow to the KnowledgeAdapter;\n        // the ImprovementAdapter skips them so subjects don't double-route.\n        if (subject.kind.startsWith('knowledge.')) {\n          skipped += 1\n          continue\n        }\n\n        const target = resolveSubjectPath(subject, opts.surfaces, opts.repoRoot)\n        if (target === null) {\n          errors.push({\n            findingId: f.finding_id,\n            subject: f.subject ?? '',\n            message: `subject kind \"${subject.kind}\" targets an undeclared surface; declare it in AgentSurfaces or stop emitting this subject`,\n          })\n          continue\n        }\n\n        if (target.intent === 'create-new' && !allowCreate.includes(subject.kind)) {\n          errors.push({\n            findingId: f.finding_id,\n            subject: f.subject ?? '',\n            message: `target ${target.repoRelativePath} does not exist; the kind \"${subject.kind}\" requires an existing target (analyst named a section that isn't in the codebase)`,\n          })\n          continue\n        }\n\n        const currentContent = target.exists ? readFileSync(target.absolutePath, 'utf-8') : ''\n\n        let draft: DraftPatchOutput\n        try {\n          draft = await opts.draftPatch({ finding: f, subject, target, currentContent })\n        } catch (err) {\n          errors.push({\n            findingId: f.finding_id,\n            subject: f.subject ?? '',\n            message: `draftPatch threw: ${err instanceof Error ? err.message : String(err)}`,\n          })\n          continue\n        }\n\n        if (draft.patch.trim().length === 0) {\n          skipped += 1\n          continue\n        }\n\n        edits.push({\n          id: `imp-${f.finding_id}`,\n          sourceFindingId: f.finding_id,\n          subject,\n          target,\n          baseSha256: sha256(currentContent),\n          patch: draft.patch,\n          summary: draft.summary,\n          rationale: draft.rationale,\n          confidence: f.confidence,\n          severity: f.severity,\n        })\n      }\n\n      return { edits, skipped, errors }\n    },\n\n    async apply(edits) {\n      const applied: string[] = []\n      const warnings: string[] = []\n\n      if (mode === 'none') {\n        warnings.push(\n          'createSurfaceImprovementAdapter: mode=none; no edits applied — adjust manifest.autoApply.improvement.mode',\n        )\n        return { applied, warnings }\n      }\n\n      if (mode === 'open-pr' && !opts.ghRepo) {\n        warnings.push('createSurfaceImprovementAdapter: mode=open-pr requires `ghRepo`; falling back to no-op')\n        return { applied, warnings }\n      }\n\n      for (const edit of edits) {\n        // Race-detection: confirm the file content hasn't moved since the\n        // patch was drafted. A diff applied against drifted content is a\n        // recipe for silent corruption.\n        const current = edit.target.exists\n          ? readFileSync(edit.target.absolutePath, 'utf-8')\n          : ''\n        if (sha256(current) !== edit.baseSha256) {\n          warnings.push(\n            `${edit.target.repoRelativePath}: base SHA mismatch; file changed after draft. Skipping.`,\n          )\n          continue\n        }\n\n        const ok = applyPatchInPlace(edit, opts.repoRoot)\n        if (!ok) {\n          warnings.push(`${edit.target.repoRelativePath}: git apply failed`)\n          continue\n        }\n        applied.push(edit.target.repoRelativePath)\n      }\n\n      if (mode === 'open-pr' && applied.length > 0 && opts.ghRepo) {\n        const prUrl = openPullRequest(\n          applied,\n          edits.filter((e) => applied.includes(e.target.repoRelativePath)),\n          opts.repoRoot,\n          opts.ghRepo,\n          opts.baseBranch ?? 'main',\n        )\n        if (prUrl) warnings.push(`opened PR: ${prUrl}`)\n        else warnings.push('PR creation failed; edits are committed to a local branch only')\n      }\n\n      return { applied, warnings }\n    },\n  }\n}\n\n// ── apply helpers ────────────────────────────────────────────────────\n\nfunction applyPatchInPlace(edit: SurfaceImprovementEdit, repoRoot: string): boolean {\n  const result = spawnSync('git', ['apply', '--whitespace=fix', '-p0', '-'], {\n    cwd: repoRoot,\n    input: edit.patch,\n    encoding: 'utf-8',\n  })\n  return result.status === 0\n}\n\nfunction openPullRequest(\n  paths: ReadonlyArray<string>,\n  edits: ReadonlyArray<SurfaceImprovementEdit>,\n  repoRoot: string,\n  ghRepo: string,\n  baseBranch: string,\n): string | null {\n  const branch = `analyst-loop/${Date.now()}-${edits[0]?.sourceFindingId.slice(0, 12) ?? 'edits'}`\n  // Create branch, stage, commit\n  const checkout = spawnSync('git', ['checkout', '-b', branch], { cwd: repoRoot })\n  if (checkout.status !== 0) return null\n  const add = spawnSync('git', ['add', ...paths], { cwd: repoRoot })\n  if (add.status !== 0) return null\n  const title = `analyst-loop: ${edits[0]?.summary ?? `${edits.length} improvement edits`}`\n  const body = [\n    `Automated analyst-loop edits — review carefully before merge.`,\n    '',\n    `Source findings:`,\n    ...edits.map((e) => `  - ${e.sourceFindingId} (confidence ${e.confidence.toFixed(2)}, severity ${e.severity})`),\n    '',\n    'Rationales:',\n    ...edits.map((e) => `\\n## ${e.target.repoRelativePath}\\n\\n${e.rationale}`),\n  ].join('\\n')\n  const commit = spawnSync('git', ['commit', '-m', title, '-m', body], { cwd: repoRoot })\n  if (commit.status !== 0) return null\n  const push = spawnSync('git', ['push', '-u', 'origin', branch], { cwd: repoRoot })\n  if (push.status !== 0) return null\n  const pr = spawnSync(\n    'gh',\n    [\n      'pr',\n      'create',\n      '--repo',\n      ghRepo,\n      '--title',\n      title,\n      '--body',\n      body,\n      '--base',\n      baseBranch,\n      '--head',\n      branch,\n    ],\n    { cwd: repoRoot, encoding: 'utf-8' },\n  )\n  if (pr.status !== 0) return null\n  return pr.stdout.trim()\n}\n\nfunction sha256(s: string): string {\n  // node:crypto is dynamic-imported lazily so the adapter can be tested in\n  // environments without crypto (browser tests, mocked envs).\n  const crypto = require('node:crypto') as typeof import('node:crypto')\n  return crypto.createHash('sha256').update(s, 'utf-8').digest('hex')\n}\n","/**\n * Substrate-default `KnowledgeAdapter` — wraps agent-knowledge's\n * `proposeFromFindings` + `applyKnowledgeWriteBlocks` with substrate\n * defaults (auto-lint after apply, source linkage via finding id).\n *\n * Every agent that ships a `.agent-knowledge/` tree uses this adapter\n * unmodified. Per-agent customization happens at the manifest level\n * (`autoApply.knowledge.confidenceThreshold`, etc.), not by writing a\n * new adapter.\n *\n * Lint discipline: after each apply we run agent-knowledge's\n * `lintKnowledgeIndex` to catch broken links / circular claims /\n * duplicate pages introduced by the new writes. Findings that fail the\n * post-apply lint are recorded in `warnings`; the apply itself is not\n * rolled back (lint failures are soft — humans review the wiki state).\n */\n\nimport type { AnalystFinding } from '@tangle-network/agent-eval'\nimport type { KnowledgeAdapter } from '../analyst-loop/types'\n\nexport interface CreateSurfaceKnowledgeAdapterOpts {\n  /** `.agent-knowledge/` root (absolute path the substrate writes blocks against). */\n  knowledgeRoot: string\n}\n\n/**\n * Build the adapter. We accept the agent-knowledge functions as DI so\n * the substrate stays decoupled from a specific agent-knowledge\n * version — the agent author imports them in their manifest module\n * and hands them to the factory.\n *\n * `proposeFromFindings(findings)` returns\n *   `{ proposals: KnowledgeProposal[]; skipped: number; errors: ... }`.\n *\n * `applyKnowledgeWriteBlocks(root, content)` returns\n *   `{ written: string[]; warnings: string[] }`.\n *\n * `lintKnowledgeIndex(index)` (optional) returns `KnowledgeLintFinding[]`.\n */\nexport interface KnowledgeAdapterDeps<TProposal> {\n  proposeFromFindings: (findings: ReadonlyArray<AnalystFinding>) => {\n    proposals: TProposal[]\n    skipped: number\n    errors: Array<{ findingId: string; subject: string; message: string }>\n  }\n  applyKnowledgeWriteBlocks: (\n    root: string,\n    proposalText: string,\n  ) => Promise<{ written: string[]; warnings: string[] }>\n  /**\n   * Optional post-apply lint hook. The substrate runs it after each\n   * batch of writes; failures land in `warnings` (the apply is not\n   * rolled back — lint signals drift to review, not block).\n   */\n  lintAfterApply?: (root: string) => Promise<ReadonlyArray<string>>\n}\n\nexport function createSurfaceKnowledgeAdapter<TProposal>(\n  opts: CreateSurfaceKnowledgeAdapterOpts,\n  deps: KnowledgeAdapterDeps<TProposal>,\n): KnowledgeAdapter<TProposal> {\n  return {\n    proposeFromFindings(findings) {\n      const batch = deps.proposeFromFindings(findings)\n      return {\n        proposals: batch.proposals,\n        skipped: batch.skipped,\n        errors: batch.errors,\n      }\n    },\n    async apply(proposals) {\n      const written: string[] = []\n      const warnings: string[] = []\n      for (const p of proposals) {\n        const proposalText = renderProposalAsWriteBlock(p)\n        if (proposalText === null) {\n          warnings.push(\n            `proposal has no writeBlocks/content; skipping (sourceFindingId=${getSourceFindingId(p)})`,\n          )\n          continue\n        }\n        try {\n          const r = await deps.applyKnowledgeWriteBlocks(opts.knowledgeRoot, proposalText)\n          written.push(...r.written)\n          warnings.push(...r.warnings)\n        } catch (err) {\n          warnings.push(\n            `applyKnowledgeWriteBlocks failed: ${err instanceof Error ? err.message : String(err)}`,\n          )\n        }\n      }\n      if (deps.lintAfterApply && written.length > 0) {\n        try {\n          const lintIssues = await deps.lintAfterApply(opts.knowledgeRoot)\n          for (const issue of lintIssues) warnings.push(`lint: ${issue}`)\n        } catch (err) {\n          warnings.push(\n            `lintAfterApply failed: ${err instanceof Error ? err.message : String(err)}`,\n          )\n        }\n      }\n      return { written, warnings }\n    },\n  }\n}\n\n/**\n * Pluck the canonical write-block text from a proposal regardless of\n * which exact agent-knowledge version produced it. We accept either:\n *   - `{ writeBlocks: Array<{ path, content }> }` — the typed shape\n *     1.3.0+ emits\n *   - `{ proposalText: string }` — legacy single-block shape\n *   - `{ content: string }` — minimal raw form\n *\n * Returns `null` when nothing parseable is present (warned upstream).\n */\nfunction renderProposalAsWriteBlock(p: unknown): string | null {\n  if (!p || typeof p !== 'object') return null\n  const obj = p as Record<string, unknown>\n  if (Array.isArray(obj.writeBlocks)) {\n    const blocks = obj.writeBlocks as Array<{ path?: string; content?: string }>\n    if (blocks.length === 0) return null\n    return blocks\n      .map((b) => (typeof b.content === 'string' ? b.content : ''))\n      .filter((s) => s.length > 0)\n      .join('\\n\\n')\n  }\n  if (typeof obj.proposalText === 'string') return obj.proposalText\n  if (typeof obj.content === 'string') return obj.content\n  return null\n}\n\nfunction getSourceFindingId(p: unknown): string {\n  if (!p || typeof p !== 'object') return '<unknown>'\n  const obj = p as Record<string, unknown>\n  if (typeof obj.sourceFindingId === 'string') return obj.sourceFindingId\n  if (typeof obj.id === 'string') return obj.id\n  return '<unknown>'\n}\n","/**\n * `OutcomeMeasurement` — the missing metric that turns the analyst\n * loop from \"observability\" into \"self-improvement\".\n *\n * Without this hook, the loop reports process counts (`findings: 42`,\n * `applied: 7`) and never proves the applied edits actually improved\n * anything. With this hook, the substrate re-runs the cohort against\n * the same personas after each apply pass and reports a composite\n * score delta. A negative delta is the substrate's strongest signal\n * to either roll back or surface for review.\n *\n * Wiring is intentionally simple: pass the manifest + the `runAgentEval`\n * function and a list of `personaIds` to re-run. The wrapper:\n *   1. Captures the baseline composite from the just-finished run.\n *   2. After `runAnalystLoop` returns, re-invokes `runAgentEval` against\n *      the same persona slice.\n *   3. Computes the delta and appends to `loop-report.json`.\n *   4. If `rollbackOnRegression` and delta < 0, reverts applied edits.\n */\n\nimport type { RunAnalystLoopResult } from '../analyst-loop/types'\n\nexport interface OutcomeMeasurement {\n  /** Baseline composite before applies — captured from the most-recent eval run. */\n  baselineComposite: number\n  /** Composite after re-running the cohort with applied edits. */\n  afterComposite: number\n  /** `afterComposite - baselineComposite`. Positive = the loop improved the agent. */\n  delta: number\n  /** Per-persona deltas for finer-grained review. */\n  perPersona: ReadonlyArray<{ personaId: string; before: number; after: number; delta: number }>\n  /** When the substrate rolled back applies due to regression, the paths reverted. */\n  rolledBackPaths: ReadonlyArray<string>\n}\n\nexport interface OutcomeMeasurementOpts {\n  /** Composite scores from the run that produced the findings. */\n  baseline: ReadonlyArray<{ personaId: string; composite: number }>\n  /**\n   * Re-run callback — the substrate invokes this after applies. The\n   * agent author provides their `runAgentEval`-equivalent so the\n   * substrate can ask \"score this persona slice now.\"\n   *\n   * The callback SHOULD reuse the same cohort + judges + variant as\n   * the baseline run; only the agent's mutable surfaces have changed.\n   */\n  reRunCohort: (personaIds: ReadonlyArray<string>) => Promise<\n    ReadonlyArray<{ personaId: string; composite: number }>\n  >\n  /** When `true`, applied edits are reverted on negative delta. Default `false`. */\n  rollbackOnRegression?: boolean\n  /** Callback to revert a list of paths (typically `git checkout HEAD --`). */\n  revert?: (paths: ReadonlyArray<string>) => Promise<void>\n}\n\n/**\n * Run `runAnalystLoop` and stamp an `OutcomeMeasurement` onto the\n * result. The substrate calls this after each canonical eval; the\n * delta lands in `loop-report.json` for cross-run trend analysis.\n *\n * The function returns the original `RunAnalystLoopResult` enriched\n * with `outcome` so callers stay backwards-compatible (the field is\n * optional on the type; missing means no measurement was wired).\n */\nexport async function measureOutcome<TProposal, TEdit>(\n  result: RunAnalystLoopResult<TProposal, TEdit>,\n  opts: OutcomeMeasurementOpts,\n): Promise<RunAnalystLoopResult<TProposal, TEdit> & { outcome: OutcomeMeasurement }> {\n  const applied = result.knowledge?.applied ?? []\n  const improvementsApplied = result.improvement?.applied ?? []\n  const allApplied = [...applied, ...improvementsApplied]\n\n  // No applies → no outcome to measure. Return a zero-delta to keep the\n  // shape stable for consumers; baseline / after equal.\n  if (allApplied.length === 0) {\n    return {\n      ...result,\n      outcome: {\n        baselineComposite: meanComposite(opts.baseline),\n        afterComposite: meanComposite(opts.baseline),\n        delta: 0,\n        perPersona: opts.baseline.map((b) => ({\n          personaId: b.personaId,\n          before: b.composite,\n          after: b.composite,\n          delta: 0,\n        })),\n        rolledBackPaths: [],\n      },\n    }\n  }\n\n  const personaIds = opts.baseline.map((b) => b.personaId)\n  const after = await opts.reRunCohort(personaIds)\n  const afterByPersona = new Map(after.map((r) => [r.personaId, r.composite]))\n\n  const perPersona = opts.baseline.map((b) => {\n    const a = afterByPersona.get(b.personaId) ?? b.composite\n    return { personaId: b.personaId, before: b.composite, after: a, delta: a - b.composite }\n  })\n  const baselineComposite = meanComposite(opts.baseline)\n  const afterComposite = meanComposite(after)\n  const delta = afterComposite - baselineComposite\n\n  let rolledBackPaths: string[] = []\n  if (delta < 0 && opts.rollbackOnRegression && opts.revert) {\n    await opts.revert(allApplied)\n    rolledBackPaths = [...allApplied]\n  }\n\n  return {\n    ...result,\n    outcome: {\n      baselineComposite,\n      afterComposite,\n      delta,\n      perPersona,\n      rolledBackPaths,\n    },\n  }\n}\n\nfunction meanComposite(rows: ReadonlyArray<{ composite: number }>): number {\n  if (rows.length === 0) return 0\n  return rows.reduce((acc, r) => acc + r.composite, 0) / rows.length\n}\n"],"mappings":"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","names":[]}

package/dist/analyst-loop.d.ts

@@ -0,0 +1,26 @@
+import { R as RunAnalystLoopOpts, a as RunAnalystLoopResult } from './types-D_MXrmJP.js';
+export { A as AnalystLoopEvent, b as AnalystRegistryLike, c as AnalystRegistryStreamingLike, d as AutoApplyPolicy, F as FindingsStoreLike, I as ImprovementAdapter, e as ImprovementEditBatch, f as ImprovementReport, K as KnowledgeAdapter, g as KnowledgeProposalBatch, h as KnowledgeReport } from './types-D_MXrmJP.js';
+import '@tangle-network/agent-eval';
+
+/**
+ * `runAnalystLoop` — the one call agent apps reach for to close the
+ * recursive-self-improvement loop.
+ *
+ *   1. Load baseline findings (last run, or the slice the caller specifies)
+ *   2. Run the analyst registry with priorFindings injected
+ *   3. Persist the new run's findings to the ledger
+ *   4. Diff the new run against the baseline
+ *   5. Hand the findings to the knowledge adapter → proposals (and
+ *      optionally apply them) → wiki edits
+ *   6. Hand the findings to the improvement adapter → prompt / tool /
+ *      scaffolding edits (review-only by default)
+ *   7. Return a single report the consumer renders / persists / acts on.
+ *
+ * Adapters are optional: the loop works as a "run + diff + report"
+ * primitive when no adapters are wired; it closes end-to-end when
+ * both adapters are wired.
+ */
+
+declare function runAnalystLoop<TProposal = unknown, TEdit = unknown>(opts: RunAnalystLoopOpts): Promise<RunAnalystLoopResult<TProposal, TEdit>>;
+
+export { RunAnalystLoopOpts, RunAnalystLoopResult, runAnalystLoop };