@agentproto/corpus 0.1.0-alpha.4 → 0.1.0

package/dist/{chunk-UPX26MYH.mjs → chunk-WF5KGEL6.mjs}

@@ -9,6 +9,7 @@ var CandidatesSidecar = class {
   constructor(opts) {
     this.opts = opts;
   }
+  opts;
   /**
    * Load every row from disk. Returns an empty list if the file
    * doesn't exist (a fresh corpus has no candidates yet).
@@ -89,6 +90,8 @@ var SidecarDuplicateError = class extends Error {
     this.id = id;
     this.name = "SidecarDuplicateError";
   }
+  path;
+  id;
 };
 var SidecarNotFoundError = class extends Error {
   constructor(path, id) {
@@ -97,8 +100,10 @@ var SidecarNotFoundError = class extends Error {
     this.id = id;
     this.name = "SidecarNotFoundError";
   }
+  path;
+  id;
 };
 
 export { CandidatesSidecar, SidecarDuplicateError, SidecarNotFoundError };
-//# sourceMappingURL=chunk-UPX26MYH.mjs.map
-//# sourceMappingURL=chunk-UPX26MYH.mjs.map
+//# sourceMappingURL=chunk-WF5KGEL6.mjs.map
+//# sourceMappingURL=chunk-WF5KGEL6.mjs.map

package/dist/chunk-WF5KGEL6.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/workspace/sidecar.ts"],"names":["yamlParse","yamlStringify"],"mappings":";;;;;;;AA6CO,IAAM,oBAAN,MAAwB;AAAA,EAC7B,YAA6B,IAAA,EAAgC;AAAhC,IAAA,IAAA,CAAA,IAAA,GAAA,IAAA;AAAA,EAAiC;AAAA,EAAjC,IAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAM7B,MAAM,IAAA,GAAyC;AAC7C,IAAA,IAAI,CAAE,MAAM,IAAA,CAAK,IAAA,CAAK,EAAA,CAAG,MAAA,CAAO,IAAA,CAAK,IAAA,CAAK,IAAI,CAAA,EAAI,OAAO,EAAC;AAC1D,IAAA,MAAM,OAAA,GAAU,MAAM,IAAA,CAAK,IAAA,CAAK,GAAG,QAAA,CAAS,IAAA,CAAK,KAAK,IAAI,CAAA;AAC1D,IAAA,IAAI,CAAC,OAAA,CAAQ,IAAA,EAAK,SAAU,EAAC;AAC7B,IAAA,MAAM,MAAA,GAASA,MAAU,OAAO,CAAA;AAChC,IAAA,IAAI,CAAC,UAAU,CAAC,KAAA,CAAM,QAAQ,MAAA,CAAO,UAAU,CAAA,EAAG,OAAO,EAAC;AAC1D,IAAA,OAAO,MAAA,CAAO,UAAA;AAAA,EAChB;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,OAAO,GAAA,EAAqD;AAChE,IAAA,MAAM,QAAA,GAAW,MAAM,IAAA,CAAK,IAAA,EAAK;AACjC,IAAA,IAAI,QAAA,CAAS,KAAK,CAAC,CAAA,KAAM,EAAE,EAAA,KAAO,GAAA,CAAI,EAAE,CAAA,EAAG;AACzC,MAAA,MAAM,IAAI,qBAAA,CAAsB,IAAA,CAAK,IAAA,CAAK,IAAA,EAAM,IAAI,EAAE,CAAA;AAAA,IACxD;AACA,IAAA,MAAM,IAAA,GAAO,CAAC,GAAG,QAAA,EAAU,GAAG,CAAA;AAC9B,IAAA,MAAM,IAAA,CAAK,MAAM,IAAI,CAAA;AACrB,IAAA,OAAO,IAAA;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,MAAA,CACJ,EAAA,EACA,KAAA,EACuB;AACvB,IAAA,MAAM,QAAA,GAAW,MAAM,IAAA,CAAK,IAAA,EAAK;AACjC,IAAA,IAAI,OAAA,GAA+B,IAAA;AACnC,IAAA,MAAM,IAAA,GAAO,QAAA,CAAS,GAAA,CAAI,CAAC,CAAA,KAAM;AAC/B,MAAA,IAAI,CAAA,CAAE,EAAA,KAAO,EAAA,EAAI,OAAO,CAAA;AACxB,MAAA,OAAA,GAAU,EAAE,GAAG,CAAA,EAAG,GAAG,KAAA,EAAO,EAAA,EAAI,EAAE,EAAA,EAAG;AACrC,MAAA,OAAO,OAAA;AAAA,IACT,CAAC,CAAA;AACD,IAAA,IAAI,CAAC,SAAS,MAAM,IAAI,qBAAqB,IAAA,CAAK,IAAA,CAAK,MAAM,EAAE,CAAA;AAC/D,IAAA,MAAM,IAAA,CAAK,MAAM,IAAI,CAAA;AACrB,IAAA,OAAO,OAAA;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAM,KAAK,EAAA,EAAmC;AAC5C,IAAA,MAAM,QAAA,GAAW,MAAM,IAAA,CAAK,IAAA,EAAK;AACjC,IAAA,MAAM,MAAM,QAAA,CAAS,SAAA,CAAU,CAAC,CAAA,KAAM,CAAA,CAAE,OAAO,EAAE,CAAA;AACjD,IAAA,IAAI,GAAA,KAAQ,IAAI,MAAM,IAAI,qBAAqB,IAAA,CAAK,IAAA,CAAK,MAAM,EAAE,CAAA;AACjE,IAAA,MAAM,OAAA,GAAU,SAAS,GAAG,CAAA;AAC5B,IAAA,MAAM,IAAA,GAAO,CAAC,GAAG,QAAA,CAAS,KAAA,CAAM,CAAA,EAAG,GAAG,CAAA,EAAG,GAAG,QAAA,CAAS,KAAA,CAAM,GAAA,GAAM,CAAC,CAAC,CAAA;AACnE,IAAA,MAAM,IAAA,CAAK,MAAM,IAAI,CAAA;AACrB,IAAA,OAAO,OAAA;AAAA,EACT;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,MAAM,UAAA,EAAoD;AAC9D,IAAA,MAAM,KAAA,GAAsB,EAAE,UAAA,EAAW;AACzC,IAAA,MAAM,OAAA,GAAUC,UAAc,KAAA,EAAO;AAAA;AAAA;AAAA;AAAA,MAInC,cAAA,EAAgB;AAAA,KACjB,CAAA;AACD,IAAA,MAAM,KAAK,IAAA,CAAK,EAAA,CAAG,UAAU,IAAA,CAAK,IAAA,CAAK,MAAM,OAAO,CAAA;AAAA,EACtD;AACF;AAEO,IAAM,qBAAA,GAAN,cAAoC,KAAA,CAAM;AAAA,EAC/C,WAAA,CACW,MACA,EAAA,EACT;AACA,IAAA,KAAA;AAAA,MACE,CAAA,qCAAA,EAAwC,EAAE,CAAA,oBAAA,EAAuB,IAAI,CAAA;AAAA,KACvE;AALS,IAAA,IAAA,CAAA,IAAA,GAAA,IAAA;AACA,IAAA,IAAA,CAAA,EAAA,GAAA,EAAA;AAKT,IAAA,IAAA,CAAK,IAAA,GAAO,uBAAA;AAAA,EACd;AAAA,EAPW,IAAA;AAAA,EACA,EAAA;AAOb;AAEO,IAAM,oBAAA,GAAN,cAAmC,KAAA,CAAM;AAAA,EAC9C,WAAA,CACW,MACA,EAAA,EACT;AACA,IAAA,KAAA,CAAM,CAAA,oCAAA,EAAuC,EAAE,CAAA,SAAA,EAAY,IAAI,CAAA,CAAE,CAAA;AAHxD,IAAA,IAAA,CAAA,IAAA,GAAA,IAAA;AACA,IAAA,IAAA,CAAA,EAAA,GAAA,EAAA;AAGT,IAAA,IAAA,CAAK,IAAA,GAAO,sBAAA;AAAA,EACd;AAAA,EALW,IAAA;AAAA,EACA,EAAA;AAKb","file":"chunk-WF5KGEL6.mjs","sourcesContent":["/**\n * CandidatesSidecar — accessor for `collections/<name>/_candidates.yaml`.\n *\n * The plan calls out lazy materialization (so-so #6): the\n * \"discovered\" state has high volume and short lifespan; AIP-18 ITEM\n * files only materialize when a candidate transitions to `analyzed`.\n * Until then, candidates live in a YAML sidecar keyed by id.\n *\n * Sidecar shape:\n *   candidates:\n *     - id: <slug>\n *       status: discovered   # may also be transitioning (rare)\n *       sourceUrl: ...       # collection-specific fields are free-form\n *       contentHash: ...\n *       discoveredAt: ISO\n *       discoveredBy: ws://operators/<slug>\n *\n * The accessor enforces:\n *   - id uniqueness within the file\n *   - atomic full-file writes (no partial sidecar)\n *   - status transition discipline (a row stays here only while\n *     `status === \"discovered\"`; transitions out remove the row and\n *     return the data so the caller can materialize ITEM.md)\n */\n\nimport { parse as yamlParse, stringify as yamlStringify } from \"yaml\"\nimport type { FsPort } from \"../ports/fs.port.js\"\n\nexport interface CandidateRow {\n  readonly id: string\n  readonly status: \"discovered\" | string\n  /** Open-ended — collection schema's `fields` defines what's allowed. */\n  readonly [key: string]: unknown\n}\n\ninterface SidecarShape {\n  readonly candidates: readonly CandidateRow[]\n}\n\nexport interface CandidatesSidecarOptions {\n  readonly fs: FsPort\n  /** Workspace-relative path of the sidecar file. */\n  readonly path: string\n}\n\nexport class CandidatesSidecar {\n  constructor(private readonly opts: CandidatesSidecarOptions) {}\n\n  /**\n   * Load every row from disk. Returns an empty list if the file\n   * doesn't exist (a fresh corpus has no candidates yet).\n   */\n  async load(): Promise<readonly CandidateRow[]> {\n    if (!(await this.opts.fs.exists(this.opts.path))) return []\n    const content = await this.opts.fs.readFile(this.opts.path)\n    if (!content.trim()) return []\n    const parsed = yamlParse(content) as Partial<SidecarShape> | null\n    if (!parsed || !Array.isArray(parsed.candidates)) return []\n    return parsed.candidates as readonly CandidateRow[]\n  }\n\n  /**\n   * Append a new candidate. Refuses if `id` already exists — sidecar\n   * keys are unique. Returns the full updated list.\n   */\n  async append(row: CandidateRow): Promise<readonly CandidateRow[]> {\n    const existing = await this.load()\n    if (existing.some((r) => r.id === row.id)) {\n      throw new SidecarDuplicateError(this.opts.path, row.id)\n    }\n    const next = [...existing, row]\n    await this.write(next)\n    return next\n  }\n\n  /**\n   * Mutate one row in-place. Throws if not found.\n   */\n  async update(\n    id: string,\n    patch: Readonly<Record<string, unknown>>\n  ): Promise<CandidateRow> {\n    const existing = await this.load()\n    let updated: CandidateRow | null = null\n    const next = existing.map((r) => {\n      if (r.id !== id) return r\n      updated = { ...r, ...patch, id: r.id } as CandidateRow\n      return updated\n    })\n    if (!updated) throw new SidecarNotFoundError(this.opts.path, id)\n    await this.write(next)\n    return updated\n  }\n\n  /**\n   * Remove a row by id. Returns the removed row so the caller can\n   * materialize an ITEM.md from its fields. Throws if not found.\n   *\n   * Use this when a candidate transitions out of `discovered`: pull\n   * it from the sidecar, write the ITEM.md, append an event.\n   */\n  async take(id: string): Promise<CandidateRow> {\n    const existing = await this.load()\n    const idx = existing.findIndex((r) => r.id === id)\n    if (idx === -1) throw new SidecarNotFoundError(this.opts.path, id)\n    const removed = existing[idx]!\n    const next = [...existing.slice(0, idx), ...existing.slice(idx + 1)]\n    await this.write(next)\n    return removed\n  }\n\n  /**\n   * Whole-file replace. Used in tests and by the indexer for\n   * bulk migrations. Prefer append/update/take for normal flow.\n   */\n  async write(candidates: readonly CandidateRow[]): Promise<void> {\n    const shape: SidecarShape = { candidates }\n    const content = yamlStringify(shape, {\n      // Stable output: sort keys alphabetically across rows for\n      // greppable diffs. Each row's id key is preserved by the\n      // stringifier; the rest is dictionary order.\n      sortMapEntries: false,\n    })\n    await this.opts.fs.writeFile(this.opts.path, content)\n  }\n}\n\nexport class SidecarDuplicateError extends Error {\n  constructor(\n    readonly path: string,\n    readonly id: string\n  ) {\n    super(\n      `SidecarDuplicateError: candidate id \"${id}\" already exists in ${path}`\n    )\n    this.name = \"SidecarDuplicateError\"\n  }\n}\n\nexport class SidecarNotFoundError extends Error {\n  constructor(\n    readonly path: string,\n    readonly id: string\n  ) {\n    super(`SidecarNotFoundError: candidate id \"${id}\" not in ${path}`)\n    this.name = \"SidecarNotFoundError\"\n  }\n}\n"]}

package/dist/index.mjs

@@ -1,8 +1,8 @@
 export { systemClock } from './chunk-KYX2DTEH.mjs';
 import { REFINED_KIND_SCHEMA, resolveKnowledge } from './chunk-JV6VRZ6U.mjs';
 export { REFINED_KIND_SCHEMA, isRefinedKind, resolveKnowledge } from './chunk-JV6VRZ6U.mjs';
-import { CandidatesSidecar } from './chunk-UPX26MYH.mjs';
-export { CandidatesSidecar, SidecarDuplicateError, SidecarNotFoundError } from './chunk-UPX26MYH.mjs';
+import { CandidatesSidecar } from './chunk-WF5KGEL6.mjs';
+export { CandidatesSidecar, SidecarDuplicateError, SidecarNotFoundError } from './chunk-WF5KGEL6.mjs';
 import matter6 from 'gray-matter';
 import { createHash } from 'crypto';
 import { z } from 'zod';
@@ -320,6 +320,7 @@ var CorpusEventEmitter = class {
   constructor(opts) {
     this.opts = opts;
   }
+  opts;
   /**
    * Emit one event. Returns the event as written (including the
    * ISO timestamp and actor resolved at emit time). The .md log file
@@ -357,6 +358,7 @@ var CorpusWorkspaceReader = class {
   constructor(opts) {
     this.opts = opts;
   }
+  opts;
   /**
    * Scan the workspace rooted at `root` and return a typed snapshot.
    * `root` is workspace-relative (the host resolves to a backing
@@ -466,11 +468,15 @@ var CorpusVersionConflictError = class extends Error {
     this.actual = actual;
     this.name = "CorpusVersionConflictError";
   }
+  path;
+  expected;
+  actual;
 };
 var CorpusWorkspaceWriter = class _CorpusWorkspaceWriter {
   constructor(opts) {
     this.opts = opts;
   }
+  opts;
   /**
    * Compute the versionToken for raw file content. Exposed so the
    * caller can stage a write and pass the same hash function used
@@ -544,6 +550,7 @@ var ImporterRunner = class {
   constructor(opts) {
     this.opts = opts;
   }
+  opts;
   /**
    * Run a single importer batch end-to-end.
    *
@@ -686,6 +693,7 @@ var LocalFilesImporter = class {
   constructor(opts) {
     this.opts = opts;
   }
+  opts;
   id = "local-files";
   label = "Local Files";
   async *enumerate(target) {
@@ -820,6 +828,7 @@ var WebImporter = class {
   constructor(opts) {
     this.opts = opts;
   }
+  opts;
   id = "web";
   label = "Web (URLs)";
   async *enumerate(target) {
@@ -886,6 +895,7 @@ var ConversationImporter = class {
   constructor(opts) {
     this.opts = opts;
   }
+  opts;
   id = "conversation";
   label = "Conversation";
   async *enumerate(target) {
@@ -991,6 +1001,7 @@ var DistillRunner = class {
   constructor(opts) {
     this.opts = opts;
   }
+  opts;
   async run(source) {
     const items = await this.opts.distiller.distill({
       title: source.title,
@@ -1471,7 +1482,7 @@ function serializeSynthesis(body, lens, atoms, clock) {
     }
   };
   const trimmed = body.trim();
-  return matter6.stringify(trimmed.startsWith("\n") ? trimmed : "\n" + trimmed, fm);
+  return matter6.stringify("\n" + trimmed, fm);
 }
 function buildSynthesisPrompt(input) {
   const atomBlock = input.atoms.map((a, i) => `### Atom ${i + 1}: ${a.title}
@@ -1707,6 +1718,7 @@ var ReadOnlyFs = class {
   constructor(inner) {
     this.inner = inner;
   }
+  inner;
   exists(path) {
     return this.inner.exists(path);
   }
@@ -1791,6 +1803,7 @@ var StackResolver = class {
   constructor(registry) {
     this.registry = registry;
   }
+  registry;
   async resolve(ctx) {
     const providers = [...this.registry.list()].sort((a, b) => a.band - b.band);
     const entries = [];
@@ -1881,6 +1894,7 @@ var SyncRunner = class {
   constructor(opts) {
     this.opts = opts;
   }
+  opts;
   async run() {
     const scheme = this.opts.uriScheme ?? "corpus";
     const throttle = this.opts.throttleMs ?? 0;
@@ -1985,6 +1999,7 @@ var ReviewerTrackRecord = class {
     this.opts = opts;
     this.path = opts.path ?? DEFAULT_PATH;
   }
+  opts;
   path;
   /** Load the full record. Empty when the file doesn't exist yet. */
   async load() {
@@ -2223,6 +2238,7 @@ var CorpusLinter = class {
   constructor(opts) {
     this.opts = opts;
   }
+  opts;
   lint(snapshot) {
     const decls = extractLintDeclarations(snapshot);
     const issues = [];
@@ -2474,6 +2490,9 @@ var IllegalTransitionError = class extends Error {
     this.reason = reason;
     this.name = "IllegalTransitionError";
   }
+  from;
+  to;
+  reason;
 };
 function assertTransition(from, to, graph) {
   const check = canTransition(from, to, graph);
@@ -2601,11 +2620,14 @@ var PromoteRejectedError = class extends Error {
     this.failures = failures;
     this.name = "PromoteRejectedError";
   }
+  entrySlug;
+  failures;
 };
 var CorpusPromoter = class {
   constructor(ctx) {
     this.ctx = ctx;
   }
+  ctx;
   async promote(opts) {
     const reader = new CorpusWorkspaceReader({ fs: this.ctx.fs });
     const writer = new CorpusWorkspaceWriter({ fs: this.ctx.fs });
@@ -2674,7 +2696,7 @@ var CorpusPromoter = class {
         clock: this.ctx.clock
       });
       if (opts.candidateId && opts.candidateSidecarPath) {
-        const { CandidatesSidecar: CandidatesSidecar2 } = await import('./sidecar-TTWQD5R3.mjs');
+        const { CandidatesSidecar: CandidatesSidecar2 } = await import('./sidecar-WZTZS2I6.mjs');
         const sidecar = new CandidatesSidecar2({
           fs: this.ctx.fs,
           path: joinPath3(opts.workspacePath, opts.candidateSidecarPath)
@@ -2791,6 +2813,7 @@ var CorpusIndexer = class {
   constructor(opts) {
     this.opts = opts;
   }
+  opts;
   /**
    * Re-sync every active entry. Used at boot (cold-install) and by
    * the admin `corpus reindex` command for drift recovery.
@@ -3216,6 +3239,7 @@ var OperatorOverlayResolver = class {
   constructor(registry) {
     this.registry = registry;
   }
+  registry;
   resolve(ctx) {
     const slugs = ctx.roleSlug ? [ctx.operatorSlug, ctx.roleSlug] : [ctx.operatorSlug];
     const candidates = this.registry.listBy({
@@ -3261,6 +3285,7 @@ var PlaybookNotFoundError = class extends Error {
     this.slug = slug;
     this.name = "PlaybookNotFoundError";
   }
+  slug;
 };
 var IllegalPlaybookTransitionError = class extends Error {
   constructor(slug, from, to) {
@@ -3272,11 +3297,15 @@ var IllegalPlaybookTransitionError = class extends Error {
     this.to = to;
     this.name = "IllegalPlaybookTransitionError";
   }
+  slug;
+  from;
+  to;
 };
 var PlaybookLifecycle = class {
   constructor(opts) {
     this.opts = opts;
   }
+  opts;
   /**
    * Transition `slug` from shadow → active. Cascades through
    * `supersedes[]`: any currently-active playbook listed there is
@@ -3457,6 +3486,7 @@ var PlaybookEvaluator = class {
   constructor(opts) {
     this.opts = opts;
   }
+  opts;
   /**
    * Run an eval batch against a single playbook. For each case:
    *   1. Score shadow.response against rubric → shadowScore