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

package/dist/chunk-3P23OX5X.mjs

@@ -0,0 +1,93 @@
+import { z } from 'zod';
+import matter from 'gray-matter';
+
+/**
+ * @agentproto/corpus v0.1.0-alpha
+ * Composition of AIP-10/12/18/9/15/41 — autonomous knowledge-improvement kit.
+ */
+
+var REFINED_KIND_SCHEMA = z.enum([
+  "principle",
+  "pattern",
+  "critique",
+  "summary",
+  "example"
+]);
+function isRefinedKind(value) {
+  return REFINED_KIND_SCHEMA.safeParse(value).success;
+}
+var ENTRY_FRONTMATTER = z.object({
+  schema: z.string().optional().catch(void 0),
+  slug: z.string().optional().catch(void 0),
+  kind: z.string().optional().catch(void 0),
+  title: z.string().optional().catch(void 0),
+  sources: z.array(z.string()).optional().catch(void 0),
+  confidence: z.number().optional().catch(void 0),
+  tags: z.array(z.string()).optional().catch(void 0),
+  metadata: z.object({
+    corpus: z.object({
+      access: z.string().optional().catch(void 0),
+      status: z.string().optional().catch(void 0),
+      // Resolved provenance written at promote time — the origins this
+      // entry was distilled from, so a recall can cite the real source.
+      source_refs: z.array(
+        z.object({
+          id: z.string(),
+          url: z.string().optional().catch(void 0),
+          title: z.string().optional().catch(void 0),
+          authority: z.string().optional().catch(void 0),
+          language: z.string().optional().catch(void 0)
+        }).loose()
+      ).optional().catch(void 0)
+    }).loose().optional().catch(void 0)
+  }).loose().optional().catch(void 0)
+}).loose();
+async function resolveKnowledge(opts) {
+  const { fs, query, allowedAccess } = opts;
+  const wantTags = new Set((query.tags ?? []).map((t) => t.toLowerCase()));
+  const wantKinds = query.kinds ? new Set(query.kinds) : null;
+  let rels;
+  try {
+    rels = await fs.walk("entries");
+  } catch {
+    return [];
+  }
+  const hits = [];
+  for (const rel of rels) {
+    if (!rel.endsWith(".md")) continue;
+    const path = `entries/${rel}`;
+    let parsed;
+    try {
+      parsed = matter(await fs.readFile(path));
+    } catch {
+      continue;
+    }
+    const fm = ENTRY_FRONTMATTER.parse(parsed.data);
+    if (fm.schema !== "knowledge.entry/v1") continue;
+    if (fm.metadata?.corpus?.status === "archived") continue;
+    const kind = fm.kind ?? "";
+    if (wantKinds && !(isRefinedKind(kind) && wantKinds.has(kind))) continue;
+    const tags = fm.tags ?? [];
+    if (wantTags.size > 0 && !tags.some((t) => wantTags.has(t.toLowerCase()))) continue;
+    const access = fm.metadata?.corpus?.access;
+    if (allowedAccess && access && !allowedAccess.has(access)) continue;
+    hits.push({
+      slug: fm.slug ?? path,
+      kind,
+      title: fm.title ?? "",
+      body: parsed.content.trim(),
+      sources: fm.sources ?? [],
+      ...fm.metadata?.corpus?.source_refs ? { sourceRefs: fm.metadata.corpus.source_refs } : {},
+      confidence: fm.confidence ?? 0,
+      tags,
+      ...access ? { access } : {},
+      path
+    });
+  }
+  hits.sort((a, b) => b.confidence - a.confidence);
+  return query.maxResults !== void 0 ? hits.slice(0, query.maxResults) : hits;
+}
+
+export { REFINED_KIND_SCHEMA, isRefinedKind, resolveKnowledge };
+//# sourceMappingURL=chunk-3P23OX5X.mjs.map
+//# sourceMappingURL=chunk-3P23OX5X.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/distill/types.ts","../src/knowledge/resolve.ts"],"names":["z"],"mappings":"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","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"]}

package/dist/fs.port-BHzctsoT.d.ts

@@ -0,0 +1,60 @@
+/**
+ * FsPort — filesystem boundary the corpus kit consumes.
+ *
+ * Structural interface, NOT a nominal one — any object exposing this
+ * shape satisfies it. Matches the existing Guilde `WorkspaceFsLike`
+ * convention (projects/guilde/packages/core/src/services/role-source/
+ * workspace.ts:38-47) so cloud and local topologies share the same
+ * minimal contract.
+ *
+ * Paths are relative to the workspace root (no leading slash). The
+ * concrete implementation (MastraFilesystem in cloud, local-fs in CLI,
+ * mcp-filesystem for hybrid topologies) does the resolution.
+ */
+interface FsStat {
+    readonly kind: "file" | "directory";
+    readonly bytes?: number;
+    readonly modifiedAt?: Date;
+}
+interface FsPort {
+    /** True if a file or directory exists at `path`. */
+    exists(path: string): Promise<boolean>;
+    /** Read a file as UTF-8 text. Throws on missing path. */
+    readFile(path: string): Promise<string>;
+    /**
+     * Write a file atomically — caller assumes content is persisted on
+     * resolve. Implementations are expected to write to a temp file +
+     * rename so partial writes never become visible.
+     */
+    writeFile(path: string, content: string): Promise<void>;
+    /**
+     * Append to a file. MUST be atomic against concurrent appends to the
+     * same path — used by the event emitter for _log.md. If the file
+     * does not exist, create it.
+     */
+    appendFile(path: string, content: string): Promise<void>;
+    /**
+     * List immediate children of a directory. Returns names only (NOT
+     * full paths). Throws if `path` is not a directory.
+     */
+    readdir(path: string): Promise<readonly string[]>;
+    /**
+     * Recursive directory listing — returns workspace-relative paths of
+     * every file under `path`. Skips directories starting with `.`.
+     */
+    walk(path: string): Promise<readonly string[]>;
+    /** File metadata. Returns null if the path doesn't exist. */
+    stat(path: string): Promise<FsStat | null>;
+    /**
+     * Acquire a cross-process advisory lock on `path`. Used by the
+     * writer for atomic multi-file transactions (entry write + _index
+     * regen + _log append). Implementations MAY no-op for single-process
+     * topologies (local CLI), but cloud hosts MUST enforce real locking.
+     */
+    lock(path: string): Promise<FsLockHandle>;
+}
+interface FsLockHandle {
+    release(): Promise<void>;
+}
+
+export type { FsPort as F, FsStat as a, FsLockHandle as b };

package/dist/index.d.ts

@@ -1,5 +1,6 @@
-import { FsPort, ClockPort, IdentityPort, FetcherPort, FsStat, FsLockHandle, EvalRubricPort, EvalContextPort, EvaluatorPort } from './ports/index.js';
+import { ClockPort, IdentityPort, FetcherPort, EvalRubricPort, EvalContextPort, EvaluatorPort } from './ports/index.js';
 export { CallerIdentity, EvalInputPort, EvalResultPort, FetchedSource, FetchedSourceKind, systemClock } from './ports/index.js';
+import { F as FsPort, a as FsStat, b as FsLockHandle } from './fs.port-BHzctsoT.js';
 import { z } from 'zod';
 import { Registry } from '@agentproto/registry';
 

package/dist/index.mjs

@@ -1,4 +1,6 @@
 export { systemClock } from './chunk-KYX2DTEH.mjs';
+import { REFINED_KIND_SCHEMA, resolveKnowledge } from './chunk-3P23OX5X.mjs';
+export { REFINED_KIND_SCHEMA, isRefinedKind, resolveKnowledge } from './chunk-3P23OX5X.mjs';
 import { CandidatesSidecar } from './chunk-UPX26MYH.mjs';
 export { CandidatesSidecar, SidecarDuplicateError, SidecarNotFoundError } from './chunk-UPX26MYH.mjs';
 import matter from 'gray-matter';
@@ -1054,16 +1056,6 @@ function sanitizeTag(raw) {
   const t = raw.toLowerCase().normalize("NFD").replace(/[̀-ͯ]/g, "").replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").replace(/-{2,}/g, "-");
   return /^[a-z][a-z0-9-]*$/.test(t) ? t : null;
 }
-var REFINED_KIND_SCHEMA = z.enum([
-  "principle",
-  "pattern",
-  "critique",
-  "summary",
-  "example"
-]);
-function isRefinedKind(value) {
-  return REFINED_KIND_SCHEMA.safeParse(value).success;
-}
 var DISTILLED_ITEM = z.object({
   kind: REFINED_KIND_SCHEMA,
   title: z.string(),
@@ -1282,77 +1274,6 @@ async function enumerateWindowRefs(source, distilled) {
   }
   return refs;
 }
-var ENTRY_FRONTMATTER = z.object({
-  schema: z.string().optional().catch(void 0),
-  slug: z.string().optional().catch(void 0),
-  kind: z.string().optional().catch(void 0),
-  title: z.string().optional().catch(void 0),
-  sources: z.array(z.string()).optional().catch(void 0),
-  confidence: z.number().optional().catch(void 0),
-  tags: z.array(z.string()).optional().catch(void 0),
-  metadata: z.object({
-    corpus: z.object({
-      access: z.string().optional().catch(void 0),
-      status: z.string().optional().catch(void 0),
-      // Resolved provenance written at promote time — the origins this
-      // entry was distilled from, so a recall can cite the real source.
-      source_refs: z.array(
-        z.object({
-          id: z.string(),
-          url: z.string().optional().catch(void 0),
-          title: z.string().optional().catch(void 0),
-          authority: z.string().optional().catch(void 0),
-          language: z.string().optional().catch(void 0)
-        }).loose()
-      ).optional().catch(void 0)
-    }).loose().optional().catch(void 0)
-  }).loose().optional().catch(void 0)
-}).loose();
-async function resolveKnowledge(opts) {
-  const { fs, query, allowedAccess } = opts;
-  const wantTags = new Set((query.tags ?? []).map((t) => t.toLowerCase()));
-  const wantKinds = query.kinds ? new Set(query.kinds) : null;
-  let rels;
-  try {
-    rels = await fs.walk("entries");
-  } catch {
-    return [];
-  }
-  const hits = [];
-  for (const rel of rels) {
-    if (!rel.endsWith(".md")) continue;
-    const path = `entries/${rel}`;
-    let parsed;
-    try {
-      parsed = matter(await fs.readFile(path));
-    } catch {
-      continue;
-    }
-    const fm = ENTRY_FRONTMATTER.parse(parsed.data);
-    if (fm.schema !== "knowledge.entry/v1") continue;
-    if (fm.metadata?.corpus?.status === "archived") continue;
-    const kind = fm.kind ?? "";
-    if (wantKinds && !(isRefinedKind(kind) && wantKinds.has(kind))) continue;
-    const tags = fm.tags ?? [];
-    if (wantTags.size > 0 && !tags.some((t) => wantTags.has(t.toLowerCase()))) continue;
-    const access = fm.metadata?.corpus?.access;
-    if (allowedAccess && access && !allowedAccess.has(access)) continue;
-    hits.push({
-      slug: fm.slug ?? path,
-      kind,
-      title: fm.title ?? "",
-      body: parsed.content.trim(),
-      sources: fm.sources ?? [],
-      ...fm.metadata?.corpus?.source_refs ? { sourceRefs: fm.metadata.corpus.source_refs } : {},
-      confidence: fm.confidence ?? 0,
-      tags,
-      ...access ? { access } : {},
-      path
-    });
-  }
-  hits.sort((a, b) => b.confidence - a.confidence);
-  return query.maxResults !== void 0 ? hits.slice(0, query.maxResults) : hits;
-}
 
 // src/knowledge/overlay-fs.ts
 var WHITEOUT_SUFFIX = ".whiteout";
@@ -3375,6 +3296,6 @@ function joinPath5(a, b) {
 var SPEC_NAME = "agentcorpus/v1";
 var SPEC_VERSION = "0.1.0-alpha";
 
-export { ANY_REF, ClaudeDistiller, ConversationImporter, CorpusEventEmitter, CorpusIndexer, CorpusLinter, CorpusPromoter, CorpusValidator, CorpusVersionConflictError, CorpusWorkspaceReader, CorpusWorkspaceWriter, DEFAULT_TRANSITIONS, DistillRunner, EMPTY_SELECTOR, IllegalPlaybookTransitionError, IllegalTransitionError, ImporterRunner, KbMigrationImporter, LocalFilesImporter, MemFs, OperatorOverlayResolver, OverlayFs, PlaybookEvaluator, PlaybookLifecycle, PlaybookNotFoundError, PlaybookRegistry, PromoteRejectedError, REFINED_KIND_SCHEMA, ReadOnlyFs, ReviewerTrackRecord, SPEC_NAME, SPEC_VERSION, StackResolver, SyncRunner, WELL_KNOWN_AXES, WHITEOUT_SUFFIX, WebImporter, aggregateReviewerScores, appendAttestation, assertTransition, buildDistillPrompt, buildOverlayFromStack, canTransition, capabilityAxis, chunkText, compileLegacyPlaybookBinding, computeReviewerCalibration, createAxisRegistry, createDistillRegistry, enumerateWindowRefs, evaluateAccess, evaluateCapability, evaluateGate, extractAutoPromoteConfig, flattenPackRefs, identityAxis, isEmptySelector, isEntrySlug, isRefinedKind, isSourceSlug, makeAttestation, matchAttachmentRefs, matchAttachments, matchesLanguageFilter, matchesSelector, normalizeLanguageTag, parseItems, parseSelectorFrontmatter, parseWindowRef, partitionStackRefs, pearsonCorrelation, positionAxis, prefixedRefNormalizer, readAccessModes, readAccessSpec, readAttestations, readEntryLanguage, readOperatorLocale, readWorkspaceDefaultLanguage, renderOverlays, resolveKnowledge, resolveLanguageFilter, roleAxis, runDistill, scanDistilledSourceIds, slugify, transitionGraphFromCollection, uniqueSlug, windowRef, windowSlug };
+export { ANY_REF, ClaudeDistiller, ConversationImporter, CorpusEventEmitter, CorpusIndexer, CorpusLinter, CorpusPromoter, CorpusValidator, CorpusVersionConflictError, CorpusWorkspaceReader, CorpusWorkspaceWriter, DEFAULT_TRANSITIONS, DistillRunner, EMPTY_SELECTOR, IllegalPlaybookTransitionError, IllegalTransitionError, ImporterRunner, KbMigrationImporter, LocalFilesImporter, MemFs, OperatorOverlayResolver, OverlayFs, PlaybookEvaluator, PlaybookLifecycle, PlaybookNotFoundError, PlaybookRegistry, PromoteRejectedError, ReadOnlyFs, ReviewerTrackRecord, SPEC_NAME, SPEC_VERSION, StackResolver, SyncRunner, WELL_KNOWN_AXES, WHITEOUT_SUFFIX, WebImporter, aggregateReviewerScores, appendAttestation, assertTransition, buildDistillPrompt, buildOverlayFromStack, canTransition, capabilityAxis, chunkText, compileLegacyPlaybookBinding, computeReviewerCalibration, createAxisRegistry, createDistillRegistry, enumerateWindowRefs, evaluateAccess, evaluateCapability, evaluateGate, extractAutoPromoteConfig, flattenPackRefs, identityAxis, isEmptySelector, isEntrySlug, isSourceSlug, makeAttestation, matchAttachmentRefs, matchAttachments, matchesLanguageFilter, matchesSelector, normalizeLanguageTag, parseItems, parseSelectorFrontmatter, parseWindowRef, partitionStackRefs, pearsonCorrelation, positionAxis, prefixedRefNormalizer, readAccessModes, readAccessSpec, readAttestations, readEntryLanguage, readOperatorLocale, readWorkspaceDefaultLanguage, renderOverlays, resolveLanguageFilter, roleAxis, runDistill, scanDistilledSourceIds, slugify, transitionGraphFromCollection, uniqueSlug, windowRef, windowSlug };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map