@agentproto/corpus 0.1.0-alpha.2 → 0.1.0-alpha.4

package/dist/model-CtAaBJn4.d.ts

@@ -0,0 +1,24 @@
+/**
+ * ReportModelPort — the minimal model seam the report's model steps consume.
+ *
+ * Structural, not nominal: the AIP `ModelPort` (`complete({system?, prompt}) →
+ * {result}`) satisfies it as-is, so the same engine runs under any registered
+ * model. The single-pass functions here ARE the "model driver" tier; the
+ * higher-fidelity claude-code path (Phase C) reuses the same prompt-builders
+ * but swaps the executor for file-reading sub-agents.
+ */
+interface ReportModelInput {
+    readonly system?: string;
+    readonly prompt: string;
+}
+interface ReportModelOutput {
+    /** Completion payload — string for text, or a structured object. */
+    readonly result: string | unknown;
+}
+interface ReportModelPort {
+    complete(input: ReportModelInput): Promise<ReportModelOutput>;
+}
+/** Run a prompt and coerce the completion to text. */
+declare function runModel(model: ReportModelPort, input: ReportModelInput): Promise<string>;
+
+export { type ReportModelPort as R, type ReportModelInput as a, type ReportModelOutput as b, runModel as r };

package/dist/report/index.d.ts

@@ -1,5 +1,7 @@
 import { F as FsPort } from '../fs.port-BHzctsoT.js';
 import { z } from 'zod';
+import { R as ReportModelPort, a as ReportModelInput } from '../model-CtAaBJn4.js';
+export { b as ReportModelOutput, r as runModel } from '../model-CtAaBJn4.js';
 
 /**
  * ReportConfig — the single source of truth for a long-form report rendered
@@ -385,29 +387,6 @@ interface ApplyEditsOptions {
 }
 declare function applyEdits(opts: ApplyEditsOptions): Promise<ApplyEditsResult>;
 
-/**
- * ReportModelPort — the minimal model seam the report's model steps consume.
- *
- * Structural, not nominal: the AIP `ModelPort` (`complete({system?, prompt}) →
- * {result}`) satisfies it as-is, so the same engine runs under any registered
- * model. The single-pass functions here ARE the "model driver" tier; the
- * higher-fidelity claude-code path (Phase C) reuses the same prompt-builders
- * but swaps the executor for file-reading sub-agents.
- */
-interface ReportModelInput {
-    readonly system?: string;
-    readonly prompt: string;
-}
-interface ReportModelOutput {
-    /** Completion payload — string for text, or a structured object. */
-    readonly result: string | unknown;
-}
-interface ReportModelPort {
-    complete(input: ReportModelInput): Promise<ReportModelOutput>;
-}
-/** Run a prompt and coerce the completion to text. */
-declare function runModel(model: ReportModelPort, input: ReportModelInput): Promise<string>;
-
 /**
  * analyze — synthesize the distilled entries of each facet into a structured
  * markdown analysis doc (`sources.<facet>.md`), the deeper context the chapter
@@ -523,4 +502,4 @@ interface PlanOutlineResult {
 }
 declare function planOutline(opts: PlanOutlineOptions): Promise<PlanOutlineResult>;
 
-export { type AnalyzeDatasetOptions, type AnalyzeDatasetResult, type AnalyzeFacetInput, type ApplyEditsOptions, type ApplyEditsResult, type AssembleOptions, type AssembleResult, type BibEntry, type BuildPacksOptions, type BuildPacksResult, type BuildReportContentOptions, type ChapterDraft, type ChapterEdit, type ChapterEditSet, type ChapterReviewContext, type ChapterWriteContext, type CollectSectionsOptions, type PackFile, type PlanOutlineOptions, type PlanOutlineResult, type ReportChapter, type ReportConfig, type ReportContent, type ReportCover, type ReportCoverFact, type ReportCoverPage, type ReportModelInput, type ReportModelOutput, type ReportModelPort, type ReportPart, type ReportSection, type StitchOptions, type StitchResult, analyzeDataset, applyEdits, assembleChapters, bibEntrySchema, buildChapterWritePrompt, buildFacetAnalysisPrompt, buildPacks, buildReportContent, buildReviewPrompt, citesOf, cleanDraft, collectReportSections, outOfRangeCites, planOutline, reportChapterSchema, reportConfigSchema, reportContentSchema, reportContentToMarkdown, reportCoverFactSchema, reportCoverPageSchema, reportCoverSchema, reportPartSchema, reportSectionKindSchema, reportSectionSchema, reviewChapter, runModel, stitchReport, writeChapter };
+export { type AnalyzeDatasetOptions, type AnalyzeDatasetResult, type AnalyzeFacetInput, type ApplyEditsOptions, type ApplyEditsResult, type AssembleOptions, type AssembleResult, type BibEntry, type BuildPacksOptions, type BuildPacksResult, type BuildReportContentOptions, type ChapterDraft, type ChapterEdit, type ChapterEditSet, type ChapterReviewContext, type ChapterWriteContext, type CollectSectionsOptions, type PackFile, type PlanOutlineOptions, type PlanOutlineResult, type ReportChapter, type ReportConfig, type ReportContent, type ReportCover, type ReportCoverFact, type ReportCoverPage, ReportModelInput, ReportModelPort, type ReportPart, type ReportSection, type StitchOptions, type StitchResult, analyzeDataset, applyEdits, assembleChapters, bibEntrySchema, buildChapterWritePrompt, buildFacetAnalysisPrompt, buildPacks, buildReportContent, buildReviewPrompt, citesOf, cleanDraft, collectReportSections, outOfRangeCites, planOutline, reportChapterSchema, reportConfigSchema, reportContentSchema, reportContentToMarkdown, reportCoverFactSchema, reportCoverPageSchema, reportCoverSchema, reportPartSchema, reportSectionKindSchema, reportSectionSchema, reviewChapter, stitchReport, writeChapter };

package/dist/report/index.mjs

@@ -1,4 +1,4 @@
-import { resolveKnowledge } from '../chunk-3P23OX5X.mjs';
+import { resolveKnowledge } from '../chunk-JV6VRZ6U.mjs';
 import matter from 'gray-matter';
 import { z } from 'zod';
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentproto/corpus",
-  "version": "0.1.0-alpha.2",
+  "version": "0.1.0-alpha.4",
   "description": "@agentproto/corpus — canonical composition of AIP-10 KNOWLEDGE, AIP-12 PLAYBOOK, AIP-18 COLLECTION, AIP-9 OPERATOR, AIP-15 WORKFLOW, AIP-41 ROUTINE into an autonomous knowledge-improvement system. Pure: zero runtime, zero filesystem, zero HTTP — all I/O via injected ports.",
   "keywords": [
     "agentproto",
@@ -59,13 +59,13 @@
     "gray-matter": "^4.0.3",
     "yaml": "^2.7.0",
     "zod": "^4.4.3",
-    "@agentproto/knowledge": "0.1.0-alpha.1",
     "@agentproto/collection": "0.1.0-alpha.1",
     "@agentproto/registry": "0.1.0-alpha.1",
-    "@agentproto/routine": "0.1.0-alpha.1",
+    "@agentproto/knowledge": "0.1.0-alpha.1",
     "@agentproto/operator": "0.1.0-alpha.1",
     "@agentproto/playbook": "0.1.0-alpha.1",
-    "@agentproto/workflow": "0.1.0-alpha.1"
+    "@agentproto/workflow": "0.1.0-alpha.1",
+    "@agentproto/routine": "0.1.0-alpha.1"
   },
   "devDependencies": {
     "@types/node": "^25.6.2",

package/dist/chunk-3P23OX5X.mjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/distill/types.ts","../src/knowledge/resolve.ts"],"names":["z"],"mappings":";;;;;;;;AAgBO,IAAM,mBAAA,GAAsB,EAAE,IAAA,CAAK;AAAA,EACxC,WAAA;AAAA,EACA,SAAA;AAAA,EACA,UAAA;AAAA,EACA,SAAA;AAAA,EACA;AACF,CAAC;AAKM,SAAS,cAAc,KAAA,EAAsC;AAClE,EAAA,OAAO,mBAAA,CAAoB,SAAA,CAAU,KAAK,CAAA,CAAE,OAAA;AAC9C;ACNA,IAAM,iBAAA,GAAoBA,EACvB,MAAA,CAAO;AAAA,EACN,QAAQA,CAAAA,CAAE,MAAA,GAAS,QAAA,EAAS,CAAE,MAAM,MAAS,CAAA;AAAA,EAC7C,MAAMA,CAAAA,CAAE,MAAA,GAAS,QAAA,EAAS,CAAE,MAAM,MAAS,CAAA;AAAA,EAC3C,MAAMA,CAAAA,CAAE,MAAA,GAAS,QAAA,EAAS,CAAE,MAAM,MAAS,CAAA;AAAA,EAC3C,OAAOA,CAAAA,CAAE,MAAA,GAAS,QAAA,EAAS,CAAE,MAAM,MAAS,CAAA;AAAA,EAC5C,OAAA,EAASA,CAAAA,CAAE,KAAA,CAAMA,CAAAA,CAAE,MAAA,EAAQ,CAAA,CAAE,QAAA,EAAS,CAAE,KAAA,CAAM,MAAS,CAAA;AAAA,EACvD,YAAYA,CAAAA,CAAE,MAAA,GAAS,QAAA,EAAS,CAAE,MAAM,MAAS,CAAA;AAAA,EACjD,IAAA,EAAMA,CAAAA,CAAE,KAAA,CAAMA,CAAAA,CAAE,MAAA,EAAQ,CAAA,CAAE,QAAA,EAAS,CAAE,KAAA,CAAM,MAAS,CAAA;AAAA,EACpD,QAAA,EAAUA,EACP,MAAA,CAAO;AAAA,IACN,MAAA,EAAQA,EACL,MAAA,CAAO;AAAA,MACN,QAAQA,CAAAA,CAAE,MAAA,GAAS,QAAA,EAAS,CAAE,MAAM,MAAS,CAAA;AAAA,MAC7C,QAAQA,CAAAA,CAAE,MAAA,GAAS,QAAA,EAAS,CAAE,MAAM,MAAS,CAAA;AAAA;AAAA;AAAA,MAG7C,aAAaA,CAAAA,CACV,KAAA;AAAA,QACCA,EACG,MAAA,CAAO;AAAA,UACN,EAAA,EAAIA,EAAE,MAAA,EAAO;AAAA,UACb,KAAKA,CAAAA,CAAE,MAAA,GAAS,QAAA,EAAS,CAAE,MAAM,MAAS,CAAA;AAAA,UAC1C,OAAOA,CAAAA,CAAE,MAAA,GAAS,QAAA,EAAS,CAAE,MAAM,MAAS,CAAA;AAAA,UAC5C,WAAWA,CAAAA,CAAE,MAAA,GAAS,QAAA,EAAS,CAAE,MAAM,MAAS,CAAA;AAAA,UAChD,UAAUA,CAAAA,CAAE,MAAA,GAAS,QAAA,EAAS,CAAE,MAAM,MAAS;AAAA,SAChD,EACA,KAAA;AAAM,OACX,CACC,QAAA,EAAS,CACT,KAAA,CAAM,MAAS;AAAA,KACnB,CAAA,CACA,KAAA,GACA,QAAA,EAAS,CACT,MAAM,MAAS;AAAA,GACnB,CAAA,CACA,KAAA,GACA,QAAA,EAAS,CACT,MAAM,MAAS;AACpB,CAAC,EACA,KAAA,EAAM;AA6CT,eAAsB,iBACpB,IAAA,EACmC;AACnC,EAAA,MAAM,EAAE,EAAA,EAAI,KAAA,EAAO,aAAA,EAAc,GAAI,IAAA;AACrC,EAAA,MAAM,QAAA,GAAW,IAAI,GAAA,CAAA,CAAK,KAAA,CAAM,IAAA,IAAQ,EAAC,EAAG,GAAA,CAAI,CAAA,CAAA,KAAK,CAAA,CAAE,WAAA,EAAa,CAAC,CAAA;AACrE,EAAA,MAAM,YAAY,KAAA,CAAM,KAAA,GAAQ,IAAI,GAAA,CAAI,KAAA,CAAM,KAAK,CAAA,GAAI,IAAA;AAEvD,EAAA,IAAI,IAAA;AACJ,EAAA,IAAI;AACF,IAAA,IAAA,GAAO,MAAM,EAAA,CAAG,IAAA,CAAK,SAAS,CAAA;AAAA,EAChC,CAAA,CAAA,MAAQ;AACN,IAAA,OAAO,EAAC;AAAA,EACV;AAEA,EAAA,MAAM,OAAwB,EAAC;AAC/B,EAAA,KAAA,MAAW,OAAO,IAAA,EAAM;AACtB,IAAA,IAAI,CAAC,GAAA,CAAI,QAAA,CAAS,KAAK,CAAA,EAAG;AAG1B,IAAA,MAAM,IAAA,GAAO,WAAW,GAAG,CAAA,CAAA;AAC3B,IAAA,IAAI,MAAA;AACJ,IAAA,IAAI;AACF,MAAA,MAAA,GAAS,MAAA,CAAO,MAAM,EAAA,CAAG,QAAA,CAAS,IAAI,CAAC,CAAA;AAAA,IACzC,CAAA,CAAA,MAAQ;AACN,MAAA;AAAA,IACF;AACA,IAAA,MAAM,EAAA,GAAK,iBAAA,CAAkB,KAAA,CAAM,MAAA,CAAO,IAAI,CAAA;AAC9C,IAAA,IAAI,EAAA,CAAG,WAAW,oBAAA,EAAsB;AAKxC,IAAA,IAAI,EAAA,CAAG,QAAA,EAAU,MAAA,EAAQ,MAAA,KAAW,UAAA,EAAY;AAEhD,IAAA,MAAM,IAAA,GAAO,GAAG,IAAA,IAAQ,EAAA;AACxB,IAAA,IAAI,SAAA,IAAa,EAAE,aAAA,CAAc,IAAI,KAAK,SAAA,CAAU,GAAA,CAAI,IAAI,CAAA,CAAA,EAAI;AAEhE,IAAA,MAAM,IAAA,GAAO,EAAA,CAAG,IAAA,IAAQ,EAAC;AACzB,IAAA,IAAI,QAAA,CAAS,IAAA,GAAO,CAAA,IAAK,CAAC,IAAA,CAAK,IAAA,CAAK,CAAA,CAAA,KAAK,QAAA,CAAS,GAAA,CAAI,CAAA,CAAE,WAAA,EAAa,CAAC,CAAA,EAAG;AAEzE,IAAA,MAAM,MAAA,GAAS,EAAA,CAAG,QAAA,EAAU,MAAA,EAAQ,MAAA;AACpC,IAAA,IAAI,iBAAiB,MAAA,IAAU,CAAC,aAAA,CAAc,GAAA,CAAI,MAAM,CAAA,EAAG;AAE3D,IAAA,IAAA,CAAK,IAAA,CAAK;AAAA,MACR,IAAA,EAAM,GAAG,IAAA,IAAQ,IAAA;AAAA,MACjB,IAAA;AAAA,MACA,KAAA,EAAO,GAAG,KAAA,IAAS,EAAA;AAAA,MACnB,IAAA,EAAM,MAAA,CAAO,OAAA,CAAQ,IAAA,EAAK;AAAA,MAC1B,OAAA,EAAS,EAAA,CAAG,OAAA,IAAW,EAAC;AAAA,MACxB,GAAI,EAAA,CAAG,QAAA,EAAU,MAAA,EAAQ,WAAA,GACrB,EAAE,UAAA,EAAY,EAAA,CAAG,QAAA,CAAS,MAAA,CAAO,WAAA,EAAY,GAC7C,EAAC;AAAA,MACL,UAAA,EAAY,GAAG,UAAA,IAAc,CAAA;AAAA,MAC7B,IAAA;AAAA,MACA,GAAI,MAAA,GAAS,EAAE,MAAA,KAAW,EAAC;AAAA,MAC3B;AAAA,KACD,CAAA;AAAA,EACH;AAEA,EAAA,IAAA,CAAK,KAAK,CAAC,CAAA,EAAG,MAAM,CAAA,CAAE,UAAA,GAAa,EAAE,UAAU,CAAA;AAC/C,EAAA,OAAO,KAAA,CAAM,eAAe,MAAA,GAAY,IAAA,CAAK,MAAM,CAAA,EAAG,KAAA,CAAM,UAAU,CAAA,GAAI,IAAA;AAC5E","file":"chunk-3P23OX5X.mjs","sourcesContent":["/**\n * Distill — raw source → refined knowledge entries (the KNOWLEDGE layer).\n *\n * The \"simple mode\": no graph engine. A refined entry is just an AIP-10\n * `knowledge.entry/v1` markdown file whose `sources: [<id>]` frontmatter\n * IS the `derivedFrom` provenance edge. The filesystem refs ARE the graph;\n * a graph engine (mind-graph / gbrain) is an optional index added later.\n *\n * The kit owns the contract + the runner (what to write, where, with what\n * provenance). The LLM that actually extracts insights is an injected\n * `DistillPort` — host-supplied (Claude/OpenAI), so the kit stays pure.\n */\n\nimport { z } from \"zod\"\n\n/** Generic AIP-10 refined kinds — NOT domain-specific. */\nexport const REFINED_KIND_SCHEMA = z.enum([\n  \"principle\",\n  \"pattern\",\n  \"critique\",\n  \"summary\",\n  \"example\",\n])\n\nexport type RefinedKind = z.infer<typeof REFINED_KIND_SCHEMA>\n\n/** Runtime guard — narrows an untyped value to RefinedKind without a cast. */\nexport function isRefinedKind(value: unknown): value is RefinedKind {\n  return REFINED_KIND_SCHEMA.safeParse(value).success\n}\n\nexport interface DistilledItem {\n  readonly kind: RefinedKind\n  readonly title: string\n  /** The refined insight, markdown. Self-contained, not a quote dump. */\n  readonly body: string\n  /** 0–1 model confidence. */\n  readonly confidence?: number\n  readonly tags?: readonly string[]\n}\n\nexport interface DistillInput {\n  readonly title: string\n  readonly body: string\n  readonly tags?: readonly string[]\n  /** Hint for the kinds worth extracting (e.g. only principles). */\n  readonly kinds?: readonly RefinedKind[]\n}\n\n/**\n * The LLM boundary. Given a raw source, return refined items. Injected by\n * the host (corpus-cli `AnthropicDistiller`, a Guilde operator, …) so the\n * kit takes no model dependency.\n */\nexport interface DistillPort {\n  distill(input: DistillInput): Promise<readonly DistilledItem[]>\n}\n","/**\n * resolveKnowledge — the `knowledge:` binding resolver (KNOWLEDGE→SKILL link).\n *\n * Filesystem-first: a skill's binding (`{ tags, kinds }`) is resolved against\n * the refined `entries/**​/*.md` on disk — no graph engine. Returns the\n * matching refined entries (with their `sources:` provenance), filtered by the\n * caller's access scope so an operator never sees knowledge above its clearance.\n *\n * A graph engine (mind-graph / gbrain) can later replace this scan with\n * traversal/activation behind the SAME signature — the binding contract is stable.\n */\n\nimport matter from \"gray-matter\"\nimport { z } from \"zod\"\nimport type { FsPort } from \"../ports/fs.port.js\"\nimport { isRefinedKind, type RefinedKind } from \"../distill/types.js\"\n\n/**\n * Lenient zod view of an AIP-10 entry's frontmatter. Every field `.catch`es to\n * undefined so a malformed value degrades gracefully (the entry is still\n * parsed, the bad field is simply absent) — matching the previous defensive\n * hand-narrowing, but typed and cast-free.\n */\nconst ENTRY_FRONTMATTER = z\n  .object({\n    schema: z.string().optional().catch(undefined),\n    slug: z.string().optional().catch(undefined),\n    kind: z.string().optional().catch(undefined),\n    title: z.string().optional().catch(undefined),\n    sources: z.array(z.string()).optional().catch(undefined),\n    confidence: z.number().optional().catch(undefined),\n    tags: z.array(z.string()).optional().catch(undefined),\n    metadata: z\n      .object({\n        corpus: z\n          .object({\n            access: z.string().optional().catch(undefined),\n            status: z.string().optional().catch(undefined),\n            // Resolved provenance written at promote time — the origins this\n            // entry was distilled from, so a recall can cite the real source.\n            source_refs: z\n              .array(\n                z\n                  .object({\n                    id: z.string(),\n                    url: z.string().optional().catch(undefined),\n                    title: z.string().optional().catch(undefined),\n                    authority: z.string().optional().catch(undefined),\n                    language: z.string().optional().catch(undefined),\n                  })\n                  .loose()\n              )\n              .optional()\n              .catch(undefined),\n          })\n          .loose()\n          .optional()\n          .catch(undefined),\n      })\n      .loose()\n      .optional()\n      .catch(undefined),\n  })\n  .loose()\n\nexport interface CorpusEntryQuery {\n  /** Match entries sharing ANY of these tags. Empty/absent = no tag filter. */\n  readonly tags?: readonly string[]\n  /** Restrict to these refined kinds. Empty/absent = all kinds. */\n  readonly kinds?: readonly RefinedKind[]\n  /** Cap results (highest-confidence first). */\n  readonly maxResults?: number\n}\n\n/** A resolved origin an entry was distilled from (id + where to find it). */\nexport interface SourceRef {\n  readonly id: string\n  readonly url?: string\n  readonly title?: string\n  readonly authority?: string\n  readonly language?: string\n}\n\nexport interface ResolvedEntry {\n  readonly slug: string\n  readonly kind: string\n  readonly title: string\n  readonly body: string\n  /** Provenance — the raw source ids this entry was derived from. */\n  readonly sources: readonly string[]\n  /** Resolved provenance — id + url + title for each source, when available. */\n  readonly sourceRefs?: readonly SourceRef[]\n  readonly confidence: number\n  readonly tags: readonly string[]\n  readonly access?: string\n  readonly path: string\n}\n\nexport interface ResolveKnowledgeOptions {\n  readonly fs: FsPort\n  readonly query: CorpusEntryQuery\n  /**\n   * Access scopes the caller (operator) is cleared for. An entry passes if it\n   * has no access (public) or its access ∈ this set. Omit = no access filter.\n   */\n  readonly allowedAccess?: ReadonlySet<string>\n}\n\nexport async function resolveKnowledge(\n  opts: ResolveKnowledgeOptions\n): Promise<readonly ResolvedEntry[]> {\n  const { fs, query, allowedAccess } = opts\n  const wantTags = new Set((query.tags ?? []).map(t => t.toLowerCase()))\n  const wantKinds = query.kinds ? new Set(query.kinds) : null\n\n  let rels: readonly string[]\n  try {\n    rels = await fs.walk(\"entries\")\n  } catch {\n    return []\n  }\n\n  const hits: ResolvedEntry[] = []\n  for (const rel of rels) {\n    if (!rel.endsWith(\".md\")) continue\n    // `walk(\"entries\")` yields paths relative to the entries/ dir; readFile\n    // resolves against the workspace root, so re-prefix.\n    const path = `entries/${rel}`\n    let parsed\n    try {\n      parsed = matter(await fs.readFile(path))\n    } catch {\n      continue\n    }\n    const fm = ENTRY_FRONTMATTER.parse(parsed.data)\n    if (fm.schema !== \"knowledge.entry/v1\") continue\n\n    // Tombstone: a guild disables a pack entry by shadowing it (same path) with\n    // status \"archived\". Filtered here so the overlaid archived entry hides the\n    // pack's. Absent/active = shown — only an explicit archive subtracts.\n    if (fm.metadata?.corpus?.status === \"archived\") continue\n\n    const kind = fm.kind ?? \"\"\n    if (wantKinds && !(isRefinedKind(kind) && wantKinds.has(kind))) continue\n\n    const tags = fm.tags ?? []\n    if (wantTags.size > 0 && !tags.some(t => wantTags.has(t.toLowerCase()))) continue\n\n    const access = fm.metadata?.corpus?.access\n    if (allowedAccess && access && !allowedAccess.has(access)) continue\n\n    hits.push({\n      slug: fm.slug ?? path,\n      kind,\n      title: fm.title ?? \"\",\n      body: parsed.content.trim(),\n      sources: fm.sources ?? [],\n      ...(fm.metadata?.corpus?.source_refs\n        ? { sourceRefs: fm.metadata.corpus.source_refs }\n        : {}),\n      confidence: fm.confidence ?? 0,\n      tags,\n      ...(access ? { access } : {}),\n      path,\n    })\n  }\n\n  hits.sort((a, b) => b.confidence - a.confidence)\n  return query.maxResults !== undefined ? hits.slice(0, query.maxResults) : hits\n}\n"]}