@agentproto/knowledge 0.1.0-alpha.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 agentproto contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,23 @@
+# @agentproto/knowledge
+
+AIP-10 `KNOWLEDGE.md` reference implementation. A filesystem-first knowledge-base format where an LLM curates, links, and lints a markdown wiki on top of immutable raw sources, turning agent knowledge into a compounding artifact instead of a per-query retrieval miss.
+
+> **Status: 0.1.0-alpha.** Generated by `scripts/scaffold-aip.mjs` — `build()` and `validate()` bodies are TODOs.
+
+Spec: <https://agentproto.sh/docs/aip-10>
+
+## Usage
+
+```ts
+import { defineKnowledge } from "@agentproto/knowledge"
+
+const x = defineKnowledge({
+  id: "my-knowledge",
+  description: "Short purpose.",
+  // ...
+})
+```
+
+## License
+
+MIT — see [LICENSE](./LICENSE).

package/dist/chunk-27YWFJ6J.mjs

@@ -0,0 +1,50 @@
+import { z } from 'zod';
+import { createDoctype } from '@agentproto/define-doctype';
+
+/**
+ * @agentproto/knowledge v0.1.0-alpha
+ * AIP-10 KNOWLEDGE.md `defineKnowledge` reference implementation.
+ */
+
+var knowledgeFrontmatterSchema = z.discriminatedUnion("schema", [
+  z.object({ "schema": z.literal("knowledge.entry/v1").describe("Discriminator for curated wiki entries. Mutable doctype."), "slug": z.string().regex(new RegExp("^[a-z][a-z0-9-]*[a-z0-9]$")).min(2).max(96).describe("Stable kebab-case identifier. Used as the wikilink target ([[slug]]) and as the entry's path stem."), "kind": z.string().regex(new RegExp("^[a-z][a-z0-9-]*$")).min(2).max(32).describe("Entry kind. The wiki's KNOWLEDGE.md (entityTypes) and AGENTS.md schema together define the allowed values; common ones are 'entity', 'concept', 'summary', 'comparison', 'timeline'."), "title": z.string().min(1).max(200).describe("Human-readable page title."), "sources": z.array(z.string().regex(new RegExp("^[a-z0-9][a-z0-9-]*$")).min(2).max(96).describe("Source id (NOT path). The host resolves ids against the source registry.")).describe("Provenance \u2014 list of source ids that back the claims in this entry's body.").default([]), "confidence": z.number().gte(0).lte(1).describe("Curation agent's confidence in the entry's claims. Advisory; downstream consumers may weight it against source authority and recency.").default(1), "updated_at": z.string().datetime({ offset: true }).describe("ISO 8601 timestamp of the last patch to this entry. MUST be set on every write."), "supersedes": z.array(z.string().regex(new RegExp("^[a-z][a-z0-9-]*[a-z0-9]$"))).describe("Slugs of earlier entries that this one replaces. Resolution rules live in the wiki's KNOWLEDGE.md curation.conflictResolution policy.").default([]), "contradicts": z.array(z.string().regex(new RegExp("^[a-z][a-z0-9-]*[a-z0-9]$"))).describe("Slugs of entries whose claims conflict with this one and that the contradiction policy could not auto-resolve. Surfaces in lint.").default([]), "links": z.array(z.string().regex(new RegExp("^[a-z][a-z0-9-]*[a-z0-9]$"))).describe("OPTIONAL hint to the link resolver \u2014 slugs this entry links to. The resolver also walks the body for [[slug]] and markdown links; this field is for entries whose links are computed.").default([]), "tags": z.array(z.string().regex(new RegExp("^[a-z][a-z0-9-]*$"))).describe("Free-form tags; consumed by retrieval, search, and grouping in _index.md.").default([]), "metadata": z.record(z.string(), z.any()).describe("Vendor-specific extensions. Hosts MUST tolerate unknown keys; the spec's normative fields MUST NOT change meaning.").default({}) }).strict(),
+  z.object({ "schema": z.literal("knowledge.source/v1").describe("Discriminator for raw sources. Immutable doctype \u2014 once registered, the host MUST refuse mutations to the file's bytes."), "id": z.string().regex(new RegExp("^[a-z0-9][a-z0-9-]*$")).min(2).max(96).describe("Stable kebab-case source id, ISO-prefixed when possible (e.g. '2026-04-27-investor-call'). Entries reference sources by id, never by path."), "path": z.string().regex(new RegExp("^sources/")).describe("Path to the raw bytes, relative to the wiki root. MUST start with 'sources/'. The host pins this file once defineSource succeeds."), "title": z.string().min(1).max(200).describe("Human-readable source title."), "captured_at": z.string().datetime({ offset: true }).describe("ISO 8601 timestamp of when the source entered the wiki."), "captured_by": z.string().max(200).describe("OPTIONAL \u2014 author or operator who pinned the source. May be a user identifier, an agent id, or an upstream system name.").optional(), "content_hash": z.string().regex(new RegExp("^(sha256|sha512|blake3):[A-Fa-f0-9]+$")).describe("Cryptographic hash of the file bytes. sha256 is required by the spec; other algorithms MAY appear in additional sidecar fields. Once set, the file is pinned."), "authority": z.enum(["primary", "secondary", "rumour"]).describe("Source authority class. 'primary' = first-party document or recording; 'secondary' = derived analysis; 'rumour' = unverified claim. Consumed by contradiction policy.").default("secondary"), "language": z.string().regex(new RegExp("^[a-z]{2}(-[A-Z]{2})?$")).describe("OPTIONAL \u2014 BCP-47 language code of the source. Useful for ingest pipelines that pick a translator.").optional(), "superseded_by": z.string().regex(new RegExp("^[a-z0-9][a-z0-9-]*$")).describe("OPTIONAL \u2014 id of a newer source that replaces this one. The host writes this; agents do not edit the source file's bytes to 'correct' it. Tombstones the source for contradiction-policy purposes while preserving the original bytes.").optional(), "tags": z.array(z.string().regex(new RegExp("^[a-z][a-z0-9-]*$"))).default([]), "metadata": z.record(z.string(), z.any()).describe("Vendor-specific extensions. Hosts MUST tolerate unknown keys.").default({}) }).strict(),
+  z.object({ "schema": z.literal("knowledge.workspace/v1").describe("Discriminator for the workspace manifest doctype."), "name": z.string().regex(new RegExp("^[a-z][a-z0-9-]*[a-z0-9]$")).min(2).max(96).describe("Stable kebab-case identifier for the workspace or view."), "title": z.string().min(1).max(200).describe("Human-readable workspace title."), "description": z.string().min(1).max(2e3).describe("One-paragraph statement of purpose: what this workspace (or view) is for and who uses it."), "version": z.string().regex(new RegExp("^[0-9]+\\.[0-9]+\\.[0-9]+(-[A-Za-z0-9.-]+)?$")).describe("Semantic version of the WORKSPACE shape. Bump on entityTypes / lints / source / curation changes. Independent of the wiki's content version."), "extends": z.string().regex(new RegExp("^(\\.\\./|\\./)[^\\s]+/KNOWLEDGE\\.md$")).min(1).max(512).describe("OPTIONAL \u2014 relative path to a parent KNOWLEDGE.md. Presence of this field makes the manifest a VIEW; absence makes it a WORKSPACE ROOT. Recursive composition: parents may themselves declare `extends`. Maximum chain depth is 8.").optional(), "appliesTo": z.array(z.string().regex(new RegExp("^(ws://(operators|companies|skills)/[a-z][a-z0-9-]*|\\.\\./[^\\s]+)$")).describe("Either a ws:// ref to an AIP-9 operator / AIP-6 company / AIP-3 skill, or a relative path to a consumer workspace folder.")).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), { message: "All items must be unique!" }).describe("OPTIONAL \u2014 list of consumers this VIEW adapts the workspace for. Hosts MUST refuse the view if any binding does not resolve. Not inherited; views declare their own scope.").optional(), "curator": z.string().regex(new RegExp("^ws://operators/[a-z][a-z0-9-]*$")).describe("OPTIONAL \u2014 AIP-9 operator that curates this workspace. The host activates this operator for ingest, curation, and lint passes.").optional(), "governance": z.string().min(1).max(512).describe("OPTIONAL \u2014 AIP-7 policy or audit binding. May be a path to an AIP-7 policy file or a ws:// ref. Schema-poisoning mitigations and source-mutation audits flow through this ref.").optional(), "entityTypes": z.array(z.object({ "name": z.string().regex(new RegExp("^[A-Z][A-Za-z0-9]*$")).describe("PascalCase type name. Merge key when composing with extends parent."), "fields": z.array(z.string().regex(new RegExp("^[a-z][A-Za-z0-9_]*$"))).describe("Canonical fields for this entity type. Child views append fields to parent's set.").default([]), "icon": z.string().max(8).describe("OPTIONAL \u2014 display hint, typically a single emoji.").optional(), "description": z.string().max(1e3).describe("OPTIONAL \u2014 prose describing what entries of this type capture.").optional(), "parent": z.string().regex(new RegExp("^[A-Z][A-Za-z0-9]*$")).describe("OPTIONAL \u2014 name of another LOCAL entity type that this one extends. Used for subtyping (e.g. Investor extends Person).").optional() }).strict()).describe("Entity types this workspace recognizes. Merge-by-name against the extends parent: a child entry with the same name replaces the parent's; new names are appended.").default([]), "lints": z.array(z.object({ "id": z.string().regex(new RegExp("^[a-z][a-z0-9-]*$")).describe("Stable kebab-case lint id. Merge key when composing with extends parent."), "kind": z.enum(["require-source", "max-age", "min-confidence", "broken-ref", "orphan", "custom"]).describe("Lint algorithm. 'custom' delegates to a host-defined check identified by `id`."), "appliesTo": z.string().regex(new RegExp("^([A-Z][A-Za-z0-9]*|\\*)$")).describe("Entity type name (e.g. 'Concept') or '*' for all entries."), "severity": z.enum(["error", "warn", "info"]).describe("Lint severity. Child views may soften (warn -> info) but governance policies may forbid that."), "params": z.record(z.string(), z.any()).describe("Kind-specific parameters. e.g. { days: 90 } for 'max-age'; { min: 0.6 } for 'min-confidence'.").default({}) }).strict()).describe("Lint rules. Merge-by-id against the extends parent: a child entry with the same id replaces the parent's; new ids are appended.").default([]), "sources": z.object({ "retention": z.string().regex(new RegExp("^(forever|days:[0-9]+)$")).describe("Source retention. 'forever' (default) or 'days:<n>' for time-limited.").optional(), "signing": z.enum(["required", "optional", "none"]).describe("Whether sources must carry an AIP-7 signature. Composes with AIP-7 governance.").optional(), "hashAlgo": z.enum(["sha256", "sha512", "blake3"]).describe("Default content-hash algorithm for new sources.").optional(), "authorityDefault": z.enum(["primary", "secondary", "rumour"]).describe("Default authority assigned to new sources when defineSource omits the field.").optional() }).strict().describe("Source registry policy. Each leaf field overrides independently across the extends chain.").optional(), "curation": z.object({ "tone": z.string().max(200).describe("Free-form tone hint for the curator agent (e.g. 'academic', 'sales', 'neutral').").optional(), "depth": z.enum(["shallow", "medium", "deep"]).describe("How exhaustive the curator agent should be when distilling sources into entries.").optional(), "autoLink": z.enum(["byName", "manual", "off"]).describe("Auto-linking policy: 'byName' walks bodies for entity names and inserts wikilinks; 'manual' leaves links to the agent; 'off' disables auto-linking entirely.").optional(), "conflictResolution": z.enum(["defer", "recency", "authority", "observation-count", "keep-both"]).describe("How the curator agent resolves contradictions when sources disagree.").optional(), "newEntryThreshold": z.string().max(1e3).describe("Prose hint for when to promote a mention into a full entry (vs leaving it as a body reference).").optional() }).strict().describe("Curation policy. Each leaf field overrides independently across the extends chain.").optional(), "queryHints": z.object({ "preferRecent": z.boolean().describe("When ranking results, weight recency higher.").optional(), "preferAuthoritative": z.boolean().describe("When ranking results, weight authority='primary' higher.").optional(), "scopeTo": z.array(z.string().regex(new RegExp("^[A-Z][A-Za-z0-9]*$"))).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), { message: "All items must be unique!" }).describe("Default query scope \u2014 entity types this view focuses on. Replaced wholesale by child if present.").optional() }).strict().describe("Hints for how consumers should retrieve from this view.").optional(), "display": z.object({ "homePage": z.string().regex(new RegExp("^[a-z][a-z0-9-]*[a-z0-9]$")).describe("OPTIONAL \u2014 slug of the entry to use as the workspace landing page.").optional(), "defaultGrouping": z.enum(["kind", "tag", "source"]).describe("Default _index.md grouping.").optional() }).strict().describe("Display hints for UIs that render the workspace. Runtime-agnostic.").optional(), "metadata": z.record(z.string(), z.any()).describe("Vendor-specific extensions, namespaced under <vendor>. Deep-merged across the extends chain.").default({}) }).strict().describe("Workspace manifest doctype. Used both as the root manifest of a wiki (no `extends`) and as a per-consumer view (with `extends`). The same schema validates both modes; the host distinguishes by checking whether `extends` is set.")
+]).describe("Validates the YAML frontmatter portion of an AIP-10 entry, source, or workspace manifest. The doctype is selected via the `schema` discriminator: 'knowledge.entry/v1' (curated, mutable), 'knowledge.source/v1' (raw, immutable), or 'knowledge.workspace/v1' (workspace manifest or per-context view).");
+var defineKnowledge = createDoctype({
+  aip: 10,
+  name: "knowledge",
+  // AIP-10 has three branches with different identity fields:
+  //   entry  → slug
+  //   source → id
+  //   workspace → name
+  // Dispatch on the `schema` discriminator so the cross-AIP id-pattern
+  // check runs against the right token.
+  readIdentity: (def) => {
+    switch (def.schema) {
+      case "knowledge.entry/v1":
+        return def.slug;
+      case "knowledge.source/v1":
+        return def.id;
+      case "knowledge.workspace/v1":
+        return def.name;
+      default:
+        return "";
+    }
+  },
+  validate(def) {
+    const result = knowledgeFrontmatterSchema.safeParse(def);
+    if (!result.success) {
+      throw new Error(
+        `defineKnowledge (AIP-10): ${result.error.issues.map((i) => `${i.path.join(".")}: ${i.message}`).join("; ")}`
+      );
+    }
+  },
+  build(def) {
+    return { ...def };
+  }
+});
+
+export { defineKnowledge, knowledgeFrontmatterSchema };
+//# sourceMappingURL=chunk-27YWFJ6J.mjs.map
+//# sourceMappingURL=chunk-27YWFJ6J.mjs.map

package/dist/chunk-27YWFJ6J.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/schema.ts","../src/define-knowledge.ts"],"names":[],"mappings":";;;;;;;;AAeO,IAAM,0BAAA,GAA6B,CAAA,CAAE,kBAAA,CAAmB,QAAA,EAAU;AAAA,EACvE,CAAA,CAAE,OAAO,EAAE,QAAA,EAAU,EAAE,OAAA,CAAQ,oBAAoB,CAAA,CAAE,QAAA,CAAS,0DAA0D,CAAA,EAAG,QAAQ,CAAA,CAAE,MAAA,EAAO,CAAE,KAAA,CAAM,IAAI,MAAA,CAAO,2BAA2B,CAAC,CAAA,CAAE,GAAA,CAAI,CAAC,CAAA,CAAE,GAAA,CAAI,EAAE,CAAA,CAAE,QAAA,CAAS,oGAAoG,CAAA,EAAG,MAAA,EAAQ,CAAA,CAAE,QAAO,CAAE,KAAA,CAAM,IAAI,MAAA,CAAO,mBAAmB,CAAC,EAAE,GAAA,CAAI,CAAC,CAAA,CAAE,GAAA,CAAI,EAAE,CAAA,CAAE,SAAS,sLAAsL,CAAA,EAAG,OAAA,EAAS,CAAA,CAAE,MAAA,EAAO,CAAE,IAAI,CAAC,CAAA,CAAE,GAAA,CAAI,GAAG,CAAA,CAAE,QAAA,CAAS,4BAA4B,CAAA,EAAG,SAAA,EAAW,CAAA,CAAE,KAAA,CAAM,CAAA,CAAE,MAAA,GAAS,KAAA,CAAM,IAAI,MAAA,CAAO,sBAAsB,CAAC,CAAA,CAAE,IAAI,CAAC,CAAA,CAAE,GAAA,CAAI,EAAE,CAAA,CAAE,QAAA,CAAS,0EAA0E,CAAC,CAAA,CAAE,QAAA,CAAS,iFAA4E,CAAA,CAAE,OAAA,CAAQ,EAAW,CAAA,EAAG,YAAA,EAAc,CAAA,CAAE,MAAA,EAAO,CAAE,IAAI,CAAC,CAAA,CAAE,GAAA,CAAI,CAAC,CAAA,CAAE,QAAA,CAAS,uIAAuI,CAAA,CAAE,OAAA,CAAQ,CAAC,CAAA,EAAG,YAAA,EAAc,CAAA,CAAE,QAAO,CAAE,QAAA,CAAS,EAAE,MAAA,EAAQ,IAAA,EAAM,EAAE,QAAA,CAAS,iFAAiF,CAAA,EAAG,YAAA,EAAc,CAAA,CAAE,KAAA,CAAM,EAAE,MAAA,EAAO,CAAE,KAAA,CAAM,IAAI,MAAA,CAAO,2BAA2B,CAAC,CAAC,CAAA,CAAE,QAAA,CAAS,uIAAuI,CAAA,CAAE,OAAA,CAAQ,EAAW,CAAA,EAAG,aAAA,EAAe,CAAA,CAAE,KAAA,CAAM,CAAA,CAAE,QAAO,CAAE,KAAA,CAAM,IAAI,MAAA,CAAO,2BAA2B,CAAC,CAAC,CAAA,CAAE,QAAA,CAAS,kIAAkI,CAAA,CAAE,OAAA,CAAQ,EAAW,CAAA,EAAG,OAAA,EAAS,CAAA,CAAE,KAAA,CAAM,CAAA,CAAE,MAAA,GAAS,KAAA,CAAM,IAAI,MAAA,CAAO,2BAA2B,CAAC,CAAC,EAAE,QAAA,CAAS,4LAAuL,CAAA,CAAE,OAAA,CAAQ,EAAW,GAAG,MAAA,EAAQ,CAAA,CAAE,KAAA,CAAM,CAAA,CAAE,MAAA,EAAO,CAAE,MAAM,IAAI,MAAA,CAAO,mBAAmB,CAAC,CAAC,CAAA,CAAE,SAAS,2EAA2E,CAAA,CAAE,OAAA,CAAQ,EAAW,CAAA,EAAG,YAAY,CAAA,CAAE,MAAA,CAAO,CAAA,CAAE,MAAA,EAAO,EAAG,CAAA,CAAE,KAAK,CAAA,CAAE,QAAA,CAAS,oHAAoH,CAAA,CAAE,OAAA,CAAQ,EAAW,CAAA,EAAG,CAAA,CAAE,MAAA,EAAO;AAAA,EAC54E,EAAE,MAAA,CAAO,EAAE,UAAU,CAAA,CAAE,OAAA,CAAQ,qBAAqB,CAAA,CAAE,QAAA,CAAS,8HAAyH,CAAA,EAAG,MAAM,CAAA,CAAE,MAAA,GAAS,KAAA,CAAM,IAAI,OAAO,sBAAsB,CAAC,CAAA,CAAE,GAAA,CAAI,CAAC,CAAA,CAAE,GAAA,CAAI,EAAE,CAAA,CAAE,QAAA,CAAS,4IAA4I,CAAA,EAAG,MAAA,EAAQ,CAAA,CAAE,MAAA,GAAS,KAAA,CAAM,IAAI,OAAO,WAAW,CAAC,EAAE,QAAA,CAAS,mIAAmI,CAAA,EAAG,OAAA,EAAS,EAAE,MAAA,EAAO,CAAE,IAAI,CAAC,CAAA,CAAE,IAAI,GAAG,CAAA,CAAE,QAAA,CAAS,8BAA8B,GAAG,aAAA,EAAe,CAAA,CAAE,QAAO,CAAE,QAAA,CAAS,EAAE,MAAA,EAAQ,IAAA,EAAM,CAAA,CAAE,SAAS,yDAAyD,CAAA,EAAG,eAAe,CAAA,CAAE,MAAA,GAAS,GAAA,CAAI,GAAG,EAAE,QAAA,CAAS,8HAAyH,EAAE,QAAA,EAAS,EAAG,gBAAgB,CAAA,CAAE,MAAA,GAAS,KAAA,CAAM,IAAI,MAAA,CAAO,uCAAuC,CAAC,CAAA,CAAE,QAAA,CAAS,+JAA+J,CAAA,EAAG,WAAA,EAAa,EAAE,IAAA,CAAK,CAAC,SAAA,EAAU,WAAA,EAAY,QAAQ,CAAC,CAAA,CAAE,SAAS,uKAAuK,CAAA,CAAE,QAAQ,WAAW,CAAA,EAAG,UAAA,EAAY,CAAA,CAAE,QAAO,CAAE,KAAA,CAAM,IAAI,MAAA,CAAO,wBAAwB,CAAC,CAAA,CAAE,QAAA,CAAS,yGAAoG,CAAA,CAAE,QAAA,IAAY,eAAA,EAAiB,CAAA,CAAE,QAAO,CAAE,KAAA,CAAM,IAAI,MAAA,CAAO,sBAAsB,CAAC,CAAA,CAAE,SAAS,6OAAwO,CAAA,CAAE,UAAS,EAAG,MAAA,EAAQ,EAAE,KAAA,CAAM,CAAA,CAAE,MAAA,EAAO,CAAE,MAAM,IAAI,MAAA,CAAO,mBAAmB,CAAC,CAAC,EAAE,OAAA,CAAQ,EAAW,CAAA,EAAG,YAAY,CAAA,CAAE,MAAA,CAAO,EAAE,MAAA,EAAO,EAAG,EAAE,GAAA,EAAK,EAAE,QAAA,CAAS,+DAA+D,EAAE,OAAA,CAAQ,EAAW,CAAA,EAAG,EAAE,MAAA,EAAO;AAAA,EACvsE,CAAA,CAAE,MAAA,CAAO,EAAE,QAAA,EAAU,EAAE,OAAA,CAAQ,wBAAwB,CAAA,CAAE,QAAA,CAAS,mDAAmD,CAAA,EAAG,MAAA,EAAQ,CAAA,CAAE,MAAA,GAAS,KAAA,CAAM,IAAI,MAAA,CAAO,2BAA2B,CAAC,CAAA,CAAE,GAAA,CAAI,CAAC,CAAA,CAAE,IAAI,EAAE,CAAA,CAAE,QAAA,CAAS,yDAAyD,GAAG,OAAA,EAAS,CAAA,CAAE,MAAA,EAAO,CAAE,IAAI,CAAC,CAAA,CAAE,GAAA,CAAI,GAAG,CAAA,CAAE,QAAA,CAAS,iCAAiC,CAAA,EAAG,eAAe,CAAA,CAAE,MAAA,EAAO,CAAE,GAAA,CAAI,CAAC,CAAA,CAAE,GAAA,CAAI,GAAI,CAAA,CAAE,SAAS,2FAA2F,CAAA,EAAG,SAAA,EAAW,CAAA,CAAE,QAAO,CAAE,KAAA,CAAM,IAAI,MAAA,CAAO,8CAA8C,CAAC,CAAA,CAAE,QAAA,CAAS,8IAA8I,GAAG,SAAA,EAAW,CAAA,CAAE,MAAA,EAAO,CAAE,MAAM,IAAI,MAAA,CAAO,wCAAwC,CAAC,CAAA,CAAE,GAAA,CAAI,CAAC,CAAA,CAAE,IAAI,GAAG,CAAA,CAAE,QAAA,CAAS,yOAAoO,EAAE,QAAA,EAAS,EAAG,WAAA,EAAa,CAAA,CAAE,MAAM,CAAA,CAAE,MAAA,EAAO,CAAE,KAAA,CAAM,IAAI,MAAA,CAAO,sEAAsE,CAAC,CAAA,CAAE,SAAS,2HAA2H,CAAC,CAAA,CAAE,MAAA,CAAO,CAAC,GAAA,KAAQ,GAAA,CAAI,KAAA,CAAM,CAAC,MAAM,CAAA,KAAM,GAAA,CAAI,OAAA,CAAQ,IAAI,CAAA,IAAK,CAAC,CAAA,EAAG,EAAE,SAAS,2BAAA,EAA6B,CAAA,CAAE,QAAA,CAAS,iLAA4K,CAAA,CAAE,QAAA,EAAS,EAAG,SAAA,EAAW,EAAE,MAAA,EAAO,CAAE,KAAA,CAAM,IAAI,OAAO,kCAAkC,CAAC,CAAA,CAAE,QAAA,CAAS,qIAAgI,CAAA,CAAE,QAAA,EAAS,EAAG,YAAA,EAAc,EAAE,MAAA,EAAO,CAAE,GAAA,CAAI,CAAC,EAAE,GAAA,CAAI,GAAG,CAAA,CAAE,QAAA,CAAS,qLAAgL,CAAA,CAAE,QAAA,EAAS,EAAG,eAAe,CAAA,CAAE,KAAA,CAAM,CAAA,CAAE,MAAA,CAAO,EAAE,MAAA,EAAQ,CAAA,CAAE,MAAA,EAAO,CAAE,MAAM,IAAI,MAAA,CAAO,qBAAqB,CAAC,EAAE,QAAA,CAAS,qEAAqE,CAAA,EAAG,QAAA,EAAU,EAAE,KAAA,CAAM,CAAA,CAAE,MAAA,EAAO,CAAE,MAAM,IAAI,MAAA,CAAO,sBAAsB,CAAC,CAAC,CAAA,CAAE,QAAA,CAAS,mFAAmF,CAAA,CAAE,OAAA,CAAQ,EAAW,CAAA,EAAG,QAAQ,CAAA,CAAE,MAAA,EAAO,CAAE,GAAA,CAAI,CAAC,CAAA,CAAE,QAAA,CAAS,yDAAoD,CAAA,CAAE,UAAS,EAAG,aAAA,EAAe,CAAA,CAAE,MAAA,GAAS,GAAA,CAAI,GAAI,CAAA,CAAE,QAAA,CAAS,qEAAgE,CAAA,CAAE,QAAA,EAAS,EAAG,QAAA,EAAU,EAAE,MAAA,EAAO,CAAE,KAAA,CAAM,IAAI,OAAO,qBAAqB,CAAC,CAAA,CAAE,QAAA,CAAS,6HAAwH,CAAA,CAAE,QAAA,EAAS,EAAG,CAAA,CAAE,MAAA,EAAQ,CAAA,CAAE,SAAS,mKAAmK,CAAA,CAAE,OAAA,CAAQ,EAAW,CAAA,EAAG,OAAA,EAAS,CAAA,CAAE,KAAA,CAAM,EAAE,MAAA,CAAO,EAAE,IAAA,EAAM,CAAA,CAAE,QAAO,CAAE,KAAA,CAAM,IAAI,MAAA,CAAO,mBAAmB,CAAC,CAAA,CAAE,QAAA,CAAS,0EAA0E,GAAG,MAAA,EAAQ,CAAA,CAAE,IAAA,CAAK,CAAC,gBAAA,EAAiB,SAAA,EAAU,gBAAA,EAAiB,YAAA,EAAa,UAAS,QAAQ,CAAC,CAAA,CAAE,QAAA,CAAS,gFAAgF,CAAA,EAAG,WAAA,EAAa,CAAA,CAAE,MAAA,GAAS,KAAA,CAAM,IAAI,MAAA,CAAO,2BAA2B,CAAC,CAAA,CAAE,QAAA,CAAS,2DAA2D,CAAA,EAAG,YAAY,CAAA,CAAE,IAAA,CAAK,CAAC,OAAA,EAAQ,QAAO,MAAM,CAAC,CAAA,CAAE,QAAA,CAAS,+FAA+F,CAAA,EAAG,QAAA,EAAU,CAAA,CAAE,MAAA,CAAO,CAAA,CAAE,MAAA,EAAO,EAAG,CAAA,CAAE,KAAK,CAAA,CAAE,QAAA,CAAS,+FAA+F,EAAE,OAAA,CAAQ,EAAW,CAAA,EAAG,CAAA,CAAE,MAAA,EAAQ,CAAA,CAAE,SAAS,iIAAiI,CAAA,CAAE,OAAA,CAAQ,EAAW,CAAA,EAAG,SAAA,EAAW,CAAA,CAAE,MAAA,CAAO,EAAE,WAAA,EAAa,CAAA,CAAE,MAAA,EAAO,CAAE,MAAM,IAAI,MAAA,CAAO,yBAAyB,CAAC,CAAA,CAAE,QAAA,CAAS,uEAAuE,CAAA,CAAE,UAAS,EAAG,SAAA,EAAW,CAAA,CAAE,IAAA,CAAK,CAAC,UAAA,EAAW,UAAA,EAAW,MAAM,CAAC,EAAE,QAAA,CAAS,gFAAgF,CAAA,CAAE,QAAA,IAAY,UAAA,EAAY,CAAA,CAAE,IAAA,CAAK,CAAC,UAAS,QAAA,EAAS,QAAQ,CAAC,CAAA,CAAE,SAAS,iDAAiD,CAAA,CAAE,QAAA,EAAS,EAAG,oBAAoB,CAAA,CAAE,IAAA,CAAK,CAAC,SAAA,EAAU,WAAA,EAAY,QAAQ,CAAC,CAAA,CAAE,SAAS,8EAA8E,CAAA,CAAE,QAAA,EAAS,EAAG,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA,CAAS,2FAA2F,CAAA,CAAE,QAAA,EAAS,EAAG,UAAA,EAAY,EAAE,MAAA,CAAO,EAAE,MAAA,EAAQ,CAAA,CAAE,QAAO,CAAE,GAAA,CAAI,GAAG,CAAA,CAAE,SAAS,kFAAkF,CAAA,CAAE,QAAA,EAAS,EAAG,SAAS,CAAA,CAAE,IAAA,CAAK,CAAC,SAAA,EAAU,QAAA,EAAS,MAAM,CAAC,CAAA,CAAE,SAAS,kFAAkF,CAAA,CAAE,QAAA,EAAS,EAAG,YAAY,CAAA,CAAE,IAAA,CAAK,CAAC,QAAA,EAAS,UAAS,KAAK,CAAC,CAAA,CAAE,QAAA,CAAS,8JAA8J,CAAA,CAAE,QAAA,EAAS,EAAG,oBAAA,EAAsB,EAAE,IAAA,CAAK,CAAC,OAAA,EAAQ,SAAA,EAAU,aAAY,mBAAA,EAAoB,WAAW,CAAC,CAAA,CAAE,SAAS,sEAAsE,CAAA,CAAE,QAAA,EAAS,EAAG,mBAAA,EAAqB,CAAA,CAAE,MAAA,EAAO,CAAE,IAAI,GAAI,CAAA,CAAE,QAAA,CAAS,iGAAiG,EAAE,QAAA,EAAS,EAAG,CAAA,CAAE,QAAO,CAAE,QAAA,CAAS,oFAAoF,CAAA,CAAE,UAAS,EAAG,YAAA,EAAc,CAAA,CAAE,MAAA,CAAO,EAAE,cAAA,EAAgB,CAAA,CAAE,OAAA,EAAQ,CAAE,SAAS,8CAA8C,CAAA,CAAE,QAAA,EAAS,EAAG,uBAAuB,CAAA,CAAE,OAAA,EAAQ,CAAE,QAAA,CAAS,0DAA0D,CAAA,CAAE,QAAA,EAAS,EAAG,WAAW,CAAA,CAAE,KAAA,CAAM,CAAA,CAAE,MAAA,GAAS,KAAA,CAAM,IAAI,MAAA,CAAO,qBAAqB,CAAC,CAAC,CAAA,CAAE,MAAA,CAAO,CAAC,QAAQ,GAAA,CAAI,KAAA,CAAM,CAAC,IAAA,EAAM,MAAM,GAAA,CAAI,OAAA,CAAQ,IAAI,CAAA,IAAK,CAAC,CAAA,EAAG,EAAE,OAAA,EAAS,2BAAA,EAA6B,CAAA,CAAE,QAAA,CAAS,uGAAkG,CAAA,CAAE,QAAA,EAAS,EAAG,CAAA,CAAE,QAAO,CAAE,QAAA,CAAS,yDAAyD,CAAA,CAAE,UAAS,EAAG,SAAA,EAAW,CAAA,CAAE,MAAA,CAAO,EAAE,UAAA,EAAY,CAAA,CAAE,MAAA,EAAO,CAAE,MAAM,IAAI,MAAA,CAAO,2BAA2B,CAAC,EAAE,QAAA,CAAS,yEAAoE,CAAA,CAAE,QAAA,IAAY,iBAAA,EAAmB,CAAA,CAAE,IAAA,CAAK,CAAC,QAAO,KAAA,EAAM,QAAQ,CAAC,CAAA,CAAE,SAAS,6BAA6B,CAAA,CAAE,QAAA,EAAS,EAAG,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA,CAAS,oEAAoE,CAAA,CAAE,QAAA,EAAS,EAAG,UAAA,EAAY,EAAE,MAAA,CAAO,CAAA,CAAE,MAAA,EAAO,EAAG,EAAE,GAAA,EAAK,CAAA,CAAE,QAAA,CAAS,8FAA8F,CAAA,CAAE,OAAA,CAAQ,EAAW,GAAG,CAAA,CAAE,MAAA,EAAO,CAAE,SAAS,qOAAqO;AACrnO,CAAC,CAAA,CAAE,SAAS,0SAA0S;ACF/S,IAAM,kBAAkB,aAAA,CAAoD;AAAA,EACjF,GAAA,EAAK,EAAA;AAAA,EACL,IAAA,EAAM,WAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAON,YAAA,EAAc,CAAC,GAAA,KAA6B;AAC1C,IAAA,QAAQ,IAAI,MAAA;AAAQ,MAClB,KAAK,oBAAA;AACH,QAAA,OAAO,GAAA,CAAI,IAAA;AAAA,MACb,KAAK,qBAAA;AACH,QAAA,OAAO,GAAA,CAAI,EAAA;AAAA,MACb,KAAK,wBAAA;AACH,QAAA,OAAO,GAAA,CAAI,IAAA;AAAA,MACb;AACE,QAAA,OAAO,EAAA;AAAA;AACX,EACF,CAAA;AAAA,EACA,SAAS,GAAA,EAAK;AACZ,IAAA,MAAM,MAAA,GAAS,0BAAA,CAA2B,SAAA,CAAU,GAAG,CAAA;AACvD,IAAA,IAAI,CAAC,OAAO,OAAA,EAAS;AACnB,MAAA,MAAM,IAAI,KAAA;AAAA,QACR,CAAA,0BAAA,EAA6B,OAAO,KAAA,CAAM,MAAA,CACvC,IAAI,CAAC,CAAA,KAAM,GAAG,CAAA,CAAE,IAAA,CAAK,KAAK,GAAG,CAAC,KAAK,CAAA,CAAE,OAAO,EAAE,CAAA,CAC9C,IAAA,CAAK,IAAI,CAAC,CAAA;AAAA,OACf;AAAA,IACF;AAAA,EAIF,CAAA;AAAA,EACA,MAAM,GAAA,EAAK;AAKT,IAAA,OAAO,EAAE,GAAG,GAAA,EAAI;AAAA,EAClB;AACF,CAAC","file":"chunk-27YWFJ6J.mjs","sourcesContent":["/**\n * AIP-10 KNOWLEDGE.md frontmatter zod schema.\n *\n * Generated from `resources/aip-10/draft/KNOWLEDGE.schema.json` via\n * json-schema-to-zod. Imported by both `define-knowledge.ts` (TS path\n * validation) and `manifest/index.ts` (.md path validation) so every\n * field-level constraint runs in both authoring paths from a single\n * source of truth — re-run scaffold-aip to refresh after spec changes.\n *\n * Cross-field rules (if/then/allOf in JSON Schema) don't translate\n * cleanly and live in `define-knowledge.ts`'s `validate(def)` instead.\n */\n\nimport { z } from \"zod\"\n\nexport const knowledgeFrontmatterSchema = z.discriminatedUnion(\"schema\", [\n  z.object({ \"schema\": z.literal(\"knowledge.entry/v1\").describe(\"Discriminator for curated wiki entries. Mutable doctype.\"), \"slug\": z.string().regex(new RegExp(\"^[a-z][a-z0-9-]*[a-z0-9]$\")).min(2).max(96).describe(\"Stable kebab-case identifier. Used as the wikilink target ([[slug]]) and as the entry's path stem.\"), \"kind\": z.string().regex(new RegExp(\"^[a-z][a-z0-9-]*$\")).min(2).max(32).describe(\"Entry kind. The wiki's KNOWLEDGE.md (entityTypes) and AGENTS.md schema together define the allowed values; common ones are 'entity', 'concept', 'summary', 'comparison', 'timeline'.\"), \"title\": z.string().min(1).max(200).describe(\"Human-readable page title.\"), \"sources\": z.array(z.string().regex(new RegExp(\"^[a-z0-9][a-z0-9-]*$\")).min(2).max(96).describe(\"Source id (NOT path). The host resolves ids against the source registry.\")).describe(\"Provenance — list of source ids that back the claims in this entry's body.\").default([] as never), \"confidence\": z.number().gte(0).lte(1).describe(\"Curation agent's confidence in the entry's claims. Advisory; downstream consumers may weight it against source authority and recency.\").default(1), \"updated_at\": z.string().datetime({ offset: true }).describe(\"ISO 8601 timestamp of the last patch to this entry. MUST be set on every write.\"), \"supersedes\": z.array(z.string().regex(new RegExp(\"^[a-z][a-z0-9-]*[a-z0-9]$\"))).describe(\"Slugs of earlier entries that this one replaces. Resolution rules live in the wiki's KNOWLEDGE.md curation.conflictResolution policy.\").default([] as never), \"contradicts\": z.array(z.string().regex(new RegExp(\"^[a-z][a-z0-9-]*[a-z0-9]$\"))).describe(\"Slugs of entries whose claims conflict with this one and that the contradiction policy could not auto-resolve. Surfaces in lint.\").default([] as never), \"links\": z.array(z.string().regex(new RegExp(\"^[a-z][a-z0-9-]*[a-z0-9]$\"))).describe(\"OPTIONAL hint to the link resolver — slugs this entry links to. The resolver also walks the body for [[slug]] and markdown links; this field is for entries whose links are computed.\").default([] as never), \"tags\": z.array(z.string().regex(new RegExp(\"^[a-z][a-z0-9-]*$\"))).describe(\"Free-form tags; consumed by retrieval, search, and grouping in _index.md.\").default([] as never), \"metadata\": z.record(z.string(), z.any()).describe(\"Vendor-specific extensions. Hosts MUST tolerate unknown keys; the spec's normative fields MUST NOT change meaning.\").default({} as never) }).strict(),\n  z.object({ \"schema\": z.literal(\"knowledge.source/v1\").describe(\"Discriminator for raw sources. Immutable doctype — once registered, the host MUST refuse mutations to the file's bytes.\"), \"id\": z.string().regex(new RegExp(\"^[a-z0-9][a-z0-9-]*$\")).min(2).max(96).describe(\"Stable kebab-case source id, ISO-prefixed when possible (e.g. '2026-04-27-investor-call'). Entries reference sources by id, never by path.\"), \"path\": z.string().regex(new RegExp(\"^sources/\")).describe(\"Path to the raw bytes, relative to the wiki root. MUST start with 'sources/'. The host pins this file once defineSource succeeds.\"), \"title\": z.string().min(1).max(200).describe(\"Human-readable source title.\"), \"captured_at\": z.string().datetime({ offset: true }).describe(\"ISO 8601 timestamp of when the source entered the wiki.\"), \"captured_by\": z.string().max(200).describe(\"OPTIONAL — author or operator who pinned the source. May be a user identifier, an agent id, or an upstream system name.\").optional(), \"content_hash\": z.string().regex(new RegExp(\"^(sha256|sha512|blake3):[A-Fa-f0-9]+$\")).describe(\"Cryptographic hash of the file bytes. sha256 is required by the spec; other algorithms MAY appear in additional sidecar fields. Once set, the file is pinned.\"), \"authority\": z.enum([\"primary\",\"secondary\",\"rumour\"]).describe(\"Source authority class. 'primary' = first-party document or recording; 'secondary' = derived analysis; 'rumour' = unverified claim. Consumed by contradiction policy.\").default(\"secondary\"), \"language\": z.string().regex(new RegExp(\"^[a-z]{2}(-[A-Z]{2})?$\")).describe(\"OPTIONAL — BCP-47 language code of the source. Useful for ingest pipelines that pick a translator.\").optional(), \"superseded_by\": z.string().regex(new RegExp(\"^[a-z0-9][a-z0-9-]*$\")).describe(\"OPTIONAL — id of a newer source that replaces this one. The host writes this; agents do not edit the source file's bytes to 'correct' it. Tombstones the source for contradiction-policy purposes while preserving the original bytes.\").optional(), \"tags\": z.array(z.string().regex(new RegExp(\"^[a-z][a-z0-9-]*$\"))).default([] as never), \"metadata\": z.record(z.string(), z.any()).describe(\"Vendor-specific extensions. Hosts MUST tolerate unknown keys.\").default({} as never) }).strict(),\n  z.object({ \"schema\": z.literal(\"knowledge.workspace/v1\").describe(\"Discriminator for the workspace manifest doctype.\"), \"name\": z.string().regex(new RegExp(\"^[a-z][a-z0-9-]*[a-z0-9]$\")).min(2).max(96).describe(\"Stable kebab-case identifier for the workspace or view.\"), \"title\": z.string().min(1).max(200).describe(\"Human-readable workspace title.\"), \"description\": z.string().min(1).max(2000).describe(\"One-paragraph statement of purpose: what this workspace (or view) is for and who uses it.\"), \"version\": z.string().regex(new RegExp(\"^[0-9]+\\\\.[0-9]+\\\\.[0-9]+(-[A-Za-z0-9.-]+)?$\")).describe(\"Semantic version of the WORKSPACE shape. Bump on entityTypes / lints / source / curation changes. Independent of the wiki's content version.\"), \"extends\": z.string().regex(new RegExp(\"^(\\\\.\\\\./|\\\\./)[^\\\\s]+/KNOWLEDGE\\\\.md$\")).min(1).max(512).describe(\"OPTIONAL — relative path to a parent KNOWLEDGE.md. Presence of this field makes the manifest a VIEW; absence makes it a WORKSPACE ROOT. Recursive composition: parents may themselves declare `extends`. Maximum chain depth is 8.\").optional(), \"appliesTo\": z.array(z.string().regex(new RegExp(\"^(ws://(operators|companies|skills)/[a-z][a-z0-9-]*|\\\\.\\\\./[^\\\\s]+)$\")).describe(\"Either a ws:// ref to an AIP-9 operator / AIP-6 company / AIP-3 skill, or a relative path to a consumer workspace folder.\")).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), { message: \"All items must be unique!\" }).describe(\"OPTIONAL — list of consumers this VIEW adapts the workspace for. Hosts MUST refuse the view if any binding does not resolve. Not inherited; views declare their own scope.\").optional(), \"curator\": z.string().regex(new RegExp(\"^ws://operators/[a-z][a-z0-9-]*$\")).describe(\"OPTIONAL — AIP-9 operator that curates this workspace. The host activates this operator for ingest, curation, and lint passes.\").optional(), \"governance\": z.string().min(1).max(512).describe(\"OPTIONAL — AIP-7 policy or audit binding. May be a path to an AIP-7 policy file or a ws:// ref. Schema-poisoning mitigations and source-mutation audits flow through this ref.\").optional(), \"entityTypes\": z.array(z.object({ \"name\": z.string().regex(new RegExp(\"^[A-Z][A-Za-z0-9]*$\")).describe(\"PascalCase type name. Merge key when composing with extends parent.\"), \"fields\": z.array(z.string().regex(new RegExp(\"^[a-z][A-Za-z0-9_]*$\"))).describe(\"Canonical fields for this entity type. Child views append fields to parent's set.\").default([] as never), \"icon\": z.string().max(8).describe(\"OPTIONAL — display hint, typically a single emoji.\").optional(), \"description\": z.string().max(1000).describe(\"OPTIONAL — prose describing what entries of this type capture.\").optional(), \"parent\": z.string().regex(new RegExp(\"^[A-Z][A-Za-z0-9]*$\")).describe(\"OPTIONAL — name of another LOCAL entity type that this one extends. Used for subtyping (e.g. Investor extends Person).\").optional() }).strict()).describe(\"Entity types this workspace recognizes. Merge-by-name against the extends parent: a child entry with the same name replaces the parent's; new names are appended.\").default([] as never), \"lints\": z.array(z.object({ \"id\": z.string().regex(new RegExp(\"^[a-z][a-z0-9-]*$\")).describe(\"Stable kebab-case lint id. Merge key when composing with extends parent.\"), \"kind\": z.enum([\"require-source\",\"max-age\",\"min-confidence\",\"broken-ref\",\"orphan\",\"custom\"]).describe(\"Lint algorithm. 'custom' delegates to a host-defined check identified by `id`.\"), \"appliesTo\": z.string().regex(new RegExp(\"^([A-Z][A-Za-z0-9]*|\\\\*)$\")).describe(\"Entity type name (e.g. 'Concept') or '*' for all entries.\"), \"severity\": z.enum([\"error\",\"warn\",\"info\"]).describe(\"Lint severity. Child views may soften (warn -> info) but governance policies may forbid that.\"), \"params\": z.record(z.string(), z.any()).describe(\"Kind-specific parameters. e.g. { days: 90 } for 'max-age'; { min: 0.6 } for 'min-confidence'.\").default({} as never) }).strict()).describe(\"Lint rules. Merge-by-id against the extends parent: a child entry with the same id replaces the parent's; new ids are appended.\").default([] as never), \"sources\": z.object({ \"retention\": z.string().regex(new RegExp(\"^(forever|days:[0-9]+)$\")).describe(\"Source retention. 'forever' (default) or 'days:<n>' for time-limited.\").optional(), \"signing\": z.enum([\"required\",\"optional\",\"none\"]).describe(\"Whether sources must carry an AIP-7 signature. Composes with AIP-7 governance.\").optional(), \"hashAlgo\": z.enum([\"sha256\",\"sha512\",\"blake3\"]).describe(\"Default content-hash algorithm for new sources.\").optional(), \"authorityDefault\": z.enum([\"primary\",\"secondary\",\"rumour\"]).describe(\"Default authority assigned to new sources when defineSource omits the field.\").optional() }).strict().describe(\"Source registry policy. Each leaf field overrides independently across the extends chain.\").optional(), \"curation\": z.object({ \"tone\": z.string().max(200).describe(\"Free-form tone hint for the curator agent (e.g. 'academic', 'sales', 'neutral').\").optional(), \"depth\": z.enum([\"shallow\",\"medium\",\"deep\"]).describe(\"How exhaustive the curator agent should be when distilling sources into entries.\").optional(), \"autoLink\": z.enum([\"byName\",\"manual\",\"off\"]).describe(\"Auto-linking policy: 'byName' walks bodies for entity names and inserts wikilinks; 'manual' leaves links to the agent; 'off' disables auto-linking entirely.\").optional(), \"conflictResolution\": z.enum([\"defer\",\"recency\",\"authority\",\"observation-count\",\"keep-both\"]).describe(\"How the curator agent resolves contradictions when sources disagree.\").optional(), \"newEntryThreshold\": z.string().max(1000).describe(\"Prose hint for when to promote a mention into a full entry (vs leaving it as a body reference).\").optional() }).strict().describe(\"Curation policy. Each leaf field overrides independently across the extends chain.\").optional(), \"queryHints\": z.object({ \"preferRecent\": z.boolean().describe(\"When ranking results, weight recency higher.\").optional(), \"preferAuthoritative\": z.boolean().describe(\"When ranking results, weight authority='primary' higher.\").optional(), \"scopeTo\": z.array(z.string().regex(new RegExp(\"^[A-Z][A-Za-z0-9]*$\"))).refine((arr) => arr.every((item, i) => arr.indexOf(item) == i), { message: \"All items must be unique!\" }).describe(\"Default query scope — entity types this view focuses on. Replaced wholesale by child if present.\").optional() }).strict().describe(\"Hints for how consumers should retrieve from this view.\").optional(), \"display\": z.object({ \"homePage\": z.string().regex(new RegExp(\"^[a-z][a-z0-9-]*[a-z0-9]$\")).describe(\"OPTIONAL — slug of the entry to use as the workspace landing page.\").optional(), \"defaultGrouping\": z.enum([\"kind\",\"tag\",\"source\"]).describe(\"Default _index.md grouping.\").optional() }).strict().describe(\"Display hints for UIs that render the workspace. Runtime-agnostic.\").optional(), \"metadata\": z.record(z.string(), z.any()).describe(\"Vendor-specific extensions, namespaced under <vendor>. Deep-merged across the extends chain.\").default({} as never) }).strict().describe(\"Workspace manifest doctype. Used both as the root manifest of a wiki (no `extends`) and as a per-consumer view (with `extends`). The same schema validates both modes; the host distinguishes by checking whether `extends` is set.\"),\n]).describe(\"Validates the YAML frontmatter portion of an AIP-10 entry, source, or workspace manifest. The doctype is selected via the `schema` discriminator: 'knowledge.entry/v1' (curated, mutable), 'knowledge.source/v1' (raw, immutable), or 'knowledge.workspace/v1' (workspace manifest or per-context view).\")\n\nexport type KnowledgeFrontmatter = z.infer<typeof knowledgeFrontmatterSchema>\n","import { createDoctype } from \"@agentproto/define-doctype\"\nimport { knowledgeFrontmatterSchema } from \"./schema.js\"\nimport type { KnowledgeDefinition, KnowledgeHandle } from \"./types.js\"\n\n/**\n * AIP-10 reference implementation of `defineKnowledge`.\n *\n * Built on `createDoctype` so the cross-AIP invariants (id pattern,\n * description length, top-level freeze, \"defineKnowledge (AIP-10): …\"\n * error prefix) run uniformly with every other AIP defineX.\n *\n * Field-level validation runs the schema-derived zod from\n * `./schema.ts` against the input. Same source of truth as the .md\n * path uses (`parseKnowledgeManifest`), so a malformed TS-authored\n * definition fails with the same diagnostic as a malformed manifest.\n * Cross-field rules go in `validate(def)` after the zod check.\n */\nexport const defineKnowledge = createDoctype<KnowledgeDefinition, KnowledgeHandle>({\n  aip: 10,\n  name: \"knowledge\",\n  // AIP-10 has three branches with different identity fields:\n  //   entry  → slug\n  //   source → id\n  //   workspace → name\n  // Dispatch on the `schema` discriminator so the cross-AIP id-pattern\n  // check runs against the right token.\n  readIdentity: (def: KnowledgeDefinition) => {\n    switch (def.schema) {\n      case \"knowledge.entry/v1\":\n        return def.slug\n      case \"knowledge.source/v1\":\n        return def.id\n      case \"knowledge.workspace/v1\":\n        return def.name\n      default:\n        return \"\"\n    }\n  },\n  validate(def) {\n    const result = knowledgeFrontmatterSchema.safeParse(def)\n    if (!result.success) {\n      throw new Error(\n        `defineKnowledge (AIP-10): ${result.error.issues\n          .map((i) => `${i.path.join(\".\")}: ${i.message}`)\n          .join(\"; \")}`,\n      )\n    }\n    // TODO: spec-10-specific cross-field rules (if/then/allOf in\n    // the JSON Schema) — those don't translate to zod cleanly and\n    // belong here. See @agentproto/operator's autonomy=gated rule.\n  },\n  build(def) {\n    // Default build: spread the validated definition into a fresh object.\n    // Hand-tune for nested freezing (Object.freeze on arrays/objects) and\n    // for fields that need defaults applied — see @agentproto/operator\n    // for a reference shape.\n    return { ...def } as KnowledgeHandle\n  },\n})\n"]}

package/dist/index.d.ts

@@ -0,0 +1,32 @@
+import { K as KnowledgeDefinition, a as KnowledgeHandle } from './types-7B2qkOIb.js';
+
+/**
+ * AIP-10 reference implementation of `defineKnowledge`.
+ *
+ * Built on `createDoctype` so the cross-AIP invariants (id pattern,
+ * description length, top-level freeze, "defineKnowledge (AIP-10): …"
+ * error prefix) run uniformly with every other AIP defineX.
+ *
+ * Field-level validation runs the schema-derived zod from
+ * `./schema.ts` against the input. Same source of truth as the .md
+ * path uses (`parseKnowledgeManifest`), so a malformed TS-authored
+ * definition fails with the same diagnostic as a malformed manifest.
+ * Cross-field rules go in `validate(def)` after the zod check.
+ */
+declare const defineKnowledge: (def: KnowledgeDefinition) => KnowledgeHandle;
+
+/**
+ * @agentproto/knowledge — AIP-10 KNOWLEDGE.md `defineKnowledge` reference impl.
+ *
+ * A filesystem-first knowledge-base format where an LLM curates, links, and lints a markdown wiki on top of immutable raw sources, turning agent knowledge into a compounding artifact instead of a per-query retrieval miss.
+ *
+ * Spec: https://agentproto.sh/docs/aip-10
+ *
+ * Authoring paths:
+ *   - TS:  `defineKnowledge({...})` → `KnowledgeHandle`
+ *   - MD:  `parseKnowledgeManifest(src) → knowledgeFromManifest({...})` → `KnowledgeHandle`
+ */
+declare const SPEC_NAME: "agentknowledge/v1";
+declare const SPEC_VERSION: "1.0.0-alpha";
+
+export { KnowledgeDefinition, KnowledgeHandle, SPEC_NAME, SPEC_VERSION, defineKnowledge };

package/dist/index.mjs

@@ -0,0 +1,14 @@
+export { defineKnowledge } from './chunk-27YWFJ6J.mjs';
+
+/**
+ * @agentproto/knowledge v0.1.0-alpha
+ * AIP-10 KNOWLEDGE.md `defineKnowledge` reference implementation.
+ */
+
+// src/index.ts
+var SPEC_NAME = "agentknowledge/v1";
+var SPEC_VERSION = "1.0.0-alpha";
+
+export { SPEC_NAME, SPEC_VERSION };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;AAYO,IAAM,SAAA,GAAY;AAClB,IAAM,YAAA,GAAe","file":"index.mjs","sourcesContent":["/**\n * @agentproto/knowledge — AIP-10 KNOWLEDGE.md `defineKnowledge` reference impl.\n *\n * A filesystem-first knowledge-base format where an LLM curates, links, and lints a markdown wiki on top of immutable raw sources, turning agent knowledge into a compounding artifact instead of a per-query retrieval miss.\n *\n * Spec: https://agentproto.sh/docs/aip-10\n *\n * Authoring paths:\n *   - TS:  `defineKnowledge({...})` → `KnowledgeHandle`\n *   - MD:  `parseKnowledgeManifest(src) → knowledgeFromManifest({...})` → `KnowledgeHandle`\n */\n\nexport const SPEC_NAME = \"agentknowledge/v1\" as const\nexport const SPEC_VERSION = \"1.0.0-alpha\" as const\n\nexport { defineKnowledge } from \"./define-knowledge.js\"\nexport type { KnowledgeDefinition, KnowledgeHandle } from \"./types.js\"\n"]}

package/dist/manifest/index.d.ts

@@ -0,0 +1,161 @@
+import { z } from 'zod';
+import { a as KnowledgeHandle } from '../types-7B2qkOIb.js';
+
+/**
+ * AIP-10 KNOWLEDGE.md frontmatter zod schema.
+ *
+ * Generated from `resources/aip-10/draft/KNOWLEDGE.schema.json` via
+ * json-schema-to-zod. Imported by both `define-knowledge.ts` (TS path
+ * validation) and `manifest/index.ts` (.md path validation) so every
+ * field-level constraint runs in both authoring paths from a single
+ * source of truth — re-run scaffold-aip to refresh after spec changes.
+ *
+ * Cross-field rules (if/then/allOf in JSON Schema) don't translate
+ * cleanly and live in `define-knowledge.ts`'s `validate(def)` instead.
+ */
+
+declare const knowledgeFrontmatterSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    schema: z.ZodLiteral<"knowledge.entry/v1">;
+    slug: z.ZodString;
+    kind: z.ZodString;
+    title: z.ZodString;
+    sources: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    confidence: z.ZodDefault<z.ZodNumber>;
+    updated_at: z.ZodString;
+    supersedes: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    contradicts: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    links: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    tags: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodAny>>;
+}, z.core.$strict>, z.ZodObject<{
+    schema: z.ZodLiteral<"knowledge.source/v1">;
+    id: z.ZodString;
+    path: z.ZodString;
+    title: z.ZodString;
+    captured_at: z.ZodString;
+    captured_by: z.ZodOptional<z.ZodString>;
+    content_hash: z.ZodString;
+    authority: z.ZodDefault<z.ZodEnum<{
+        primary: "primary";
+        secondary: "secondary";
+        rumour: "rumour";
+    }>>;
+    language: z.ZodOptional<z.ZodString>;
+    superseded_by: z.ZodOptional<z.ZodString>;
+    tags: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodAny>>;
+}, z.core.$strict>, z.ZodObject<{
+    schema: z.ZodLiteral<"knowledge.workspace/v1">;
+    name: z.ZodString;
+    title: z.ZodString;
+    description: z.ZodString;
+    version: z.ZodString;
+    extends: z.ZodOptional<z.ZodString>;
+    appliesTo: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    curator: z.ZodOptional<z.ZodString>;
+    governance: z.ZodOptional<z.ZodString>;
+    entityTypes: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        fields: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        icon: z.ZodOptional<z.ZodString>;
+        description: z.ZodOptional<z.ZodString>;
+        parent: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>>;
+    lints: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        kind: z.ZodEnum<{
+            custom: "custom";
+            "require-source": "require-source";
+            "max-age": "max-age";
+            "min-confidence": "min-confidence";
+            "broken-ref": "broken-ref";
+            orphan: "orphan";
+        }>;
+        appliesTo: z.ZodString;
+        severity: z.ZodEnum<{
+            error: "error";
+            warn: "warn";
+            info: "info";
+        }>;
+        params: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodAny>>;
+    }, z.core.$strict>>>;
+    sources: z.ZodOptional<z.ZodObject<{
+        retention: z.ZodOptional<z.ZodString>;
+        signing: z.ZodOptional<z.ZodEnum<{
+            optional: "optional";
+            required: "required";
+            none: "none";
+        }>>;
+        hashAlgo: z.ZodOptional<z.ZodEnum<{
+            sha256: "sha256";
+            sha512: "sha512";
+            blake3: "blake3";
+        }>>;
+        authorityDefault: z.ZodOptional<z.ZodEnum<{
+            primary: "primary";
+            secondary: "secondary";
+            rumour: "rumour";
+        }>>;
+    }, z.core.$strict>>;
+    curation: z.ZodOptional<z.ZodObject<{
+        tone: z.ZodOptional<z.ZodString>;
+        depth: z.ZodOptional<z.ZodEnum<{
+            shallow: "shallow";
+            medium: "medium";
+            deep: "deep";
+        }>>;
+        autoLink: z.ZodOptional<z.ZodEnum<{
+            byName: "byName";
+            manual: "manual";
+            off: "off";
+        }>>;
+        conflictResolution: z.ZodOptional<z.ZodEnum<{
+            authority: "authority";
+            defer: "defer";
+            recency: "recency";
+            "observation-count": "observation-count";
+            "keep-both": "keep-both";
+        }>>;
+        newEntryThreshold: z.ZodOptional<z.ZodString>;
+    }, z.core.$strict>>;
+    queryHints: z.ZodOptional<z.ZodObject<{
+        preferRecent: z.ZodOptional<z.ZodBoolean>;
+        preferAuthoritative: z.ZodOptional<z.ZodBoolean>;
+        scopeTo: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>>;
+    display: z.ZodOptional<z.ZodObject<{
+        homePage: z.ZodOptional<z.ZodString>;
+        defaultGrouping: z.ZodOptional<z.ZodEnum<{
+            kind: "kind";
+            tag: "tag";
+            source: "source";
+        }>>;
+    }, z.core.$strict>>;
+    metadata: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodAny>>;
+}, z.core.$strict>], "schema">;
+type KnowledgeFrontmatter = z.infer<typeof knowledgeFrontmatterSchema>;
+
+/**
+ * AIP-10 KNOWLEDGE.md sidecar parser + manifest-to-handle constructor.
+ *
+ * Mirror of `@agentproto/tool/manifest` and `@agentproto/driver/manifest`:
+ * the .md provides metadata; the TS module supplies any spec-specific
+ * runtime bits (schemas, execute bodies, …) that can't live in
+ * frontmatter. Both inputs end up in `defineKnowledge` so the cross-AIP
+ * invariants run uniformly.
+ *
+ *
+ * The frontmatter zod schema below was generated from
+ * `resources/aip-10/draft/KNOWLEDGE.schema.json` via json-schema-to-zod.
+ * Re-run scaffold-aip to refresh after spec changes (or hand-tune
+ * any constraint the converter doesn't capture cleanly).
+ */
+
+interface KnowledgeManifest {
+    frontmatter: KnowledgeFrontmatter;
+    body: string;
+}
+declare function parseKnowledgeManifest(source: string): KnowledgeManifest;
+declare function knowledgeFromManifest(manifest: KnowledgeManifest): KnowledgeHandle;
+
+export { type KnowledgeFrontmatter, type KnowledgeManifest, knowledgeFromManifest, knowledgeFrontmatterSchema, parseKnowledgeManifest };

package/dist/manifest/index.mjs

@@ -0,0 +1,28 @@
+import { knowledgeFrontmatterSchema, defineKnowledge } from '../chunk-27YWFJ6J.mjs';
+export { knowledgeFrontmatterSchema } from '../chunk-27YWFJ6J.mjs';
+import matter from 'gray-matter';
+
+/**
+ * @agentproto/knowledge v0.1.0-alpha
+ * AIP-10 KNOWLEDGE.md `defineKnowledge` reference implementation.
+ */
+function parseKnowledgeManifest(source) {
+  const parsed = matter(source);
+  if (Object.keys(parsed.data).length === 0) {
+    throw new Error("parseKnowledgeManifest: missing or empty frontmatter");
+  }
+  const result = knowledgeFrontmatterSchema.safeParse(parsed.data);
+  if (!result.success) {
+    throw new Error(
+      `parseKnowledgeManifest: invalid frontmatter \u2014 ${result.error.issues.map((i) => `${i.path.join(".")}: ${i.message}`).join("; ")}`
+    );
+  }
+  return { frontmatter: result.data, body: parsed.content };
+}
+function knowledgeFromManifest(manifest) {
+  return defineKnowledge(manifest.frontmatter);
+}
+
+export { knowledgeFromManifest, parseKnowledgeManifest };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/manifest/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/manifest/index.ts"],"names":[],"mappings":";;;;;;;;AA8BO,SAAS,uBAAuB,MAAA,EAAmC;AACxE,EAAA,MAAM,MAAA,GAAS,OAAO,MAAM,CAAA;AAC5B,EAAA,IAAI,OAAO,IAAA,CAAK,MAAA,CAAO,IAAI,CAAA,CAAE,WAAW,CAAA,EAAG;AACzC,IAAA,MAAM,IAAI,MAAM,sDAAsD,CAAA;AAAA,EACxE;AACA,EAAA,MAAM,MAAA,GAAS,0BAAA,CAA2B,SAAA,CAAU,MAAA,CAAO,IAAI,CAAA;AAC/D,EAAA,IAAI,CAAC,OAAO,OAAA,EAAS;AACnB,IAAA,MAAM,IAAI,KAAA;AAAA,MACR,CAAA,mDAAA,EAAiD,OAAO,KAAA,CAAM,MAAA,CAC3D,IAAI,CAAC,CAAA,KAAM,GAAG,CAAA,CAAE,IAAA,CAAK,KAAK,GAAG,CAAC,KAAK,CAAA,CAAE,OAAO,EAAE,CAAA,CAC9C,IAAA,CAAK,IAAI,CAAC,CAAA;AAAA,KACf;AAAA,EACF;AACA,EAAA,OAAO,EAAE,WAAA,EAAa,MAAA,CAAO,IAAA,EAAM,IAAA,EAAM,OAAO,OAAA,EAAQ;AAC1D;AAEO,SAAS,sBAAsB,QAAA,EAA8C;AAKlF,EAAA,OAAO,eAAA,CAAgB,SAAS,WAA6C,CAAA;AAC/E","file":"index.mjs","sourcesContent":["/**\n * AIP-10 KNOWLEDGE.md sidecar parser + manifest-to-handle constructor.\n *\n * Mirror of `@agentproto/tool/manifest` and `@agentproto/driver/manifest`:\n * the .md provides metadata; the TS module supplies any spec-specific\n * runtime bits (schemas, execute bodies, …) that can't live in\n * frontmatter. Both inputs end up in `defineKnowledge` so the cross-AIP\n * invariants run uniformly.\n *\n *\n * The frontmatter zod schema below was generated from\n * `resources/aip-10/draft/KNOWLEDGE.schema.json` via json-schema-to-zod.\n * Re-run scaffold-aip to refresh after spec changes (or hand-tune\n * any constraint the converter doesn't capture cleanly).\n */\n\nimport matter from \"gray-matter\"\nimport { knowledgeFrontmatterSchema, type KnowledgeFrontmatter } from \"../schema.js\"\nimport { defineKnowledge } from \"../define-knowledge.js\"\nimport type { KnowledgeDefinition, KnowledgeHandle } from \"../types.js\"\n\n// Re-export so consumers can import the schema + inferred type either\n// from \"@@agentproto/knowledge/manifest\" or directly from \"@@agentproto/knowledge/schema\".\nexport { knowledgeFrontmatterSchema, type KnowledgeFrontmatter }\n\nexport interface KnowledgeManifest {\n  frontmatter: KnowledgeFrontmatter\n  body: string\n}\n\nexport function parseKnowledgeManifest(source: string): KnowledgeManifest {\n  const parsed = matter(source)\n  if (Object.keys(parsed.data).length === 0) {\n    throw new Error(\"parseKnowledgeManifest: missing or empty frontmatter\")\n  }\n  const result = knowledgeFrontmatterSchema.safeParse(parsed.data)\n  if (!result.success) {\n    throw new Error(\n      `parseKnowledgeManifest: invalid frontmatter — ${result.error.issues\n        .map((i) => `${i.path.join(\".\")}: ${i.message}`)\n        .join(\"; \")}`,\n    )\n  }\n  return { frontmatter: result.data, body: parsed.content }\n}\n\nexport function knowledgeFromManifest(manifest: KnowledgeManifest): KnowledgeHandle {\n  // The zod-validated frontmatter is structurally compatible with\n  // KnowledgeDefinition; the cast pins the typing once the manifest\n  // schema and the TS interface diverge (e.g. handle has frozen fields\n  // a literal config doesn't carry yet).\n  return defineKnowledge(manifest.frontmatter as unknown as KnowledgeDefinition)\n}\n"]}

package/dist/types-7B2qkOIb.d.ts

@@ -0,0 +1,293 @@
+/**
+ * AIP-10 KnowledgeDefinition + KnowledgeHandle.
+ *
+ * `KnowledgeDefinition` was generated from
+ * `resources/aip-10/draft/KNOWLEDGE.schema.json` via json-schema-to-typescript.
+ * `KnowledgeHandle` is the readonly view of the same shape; tighten it
+ * by hand for fields that get defaults applied in build().
+ */
+/**
+ * Validates the YAML frontmatter portion of an AIP-10 entry, source, or workspace manifest. The doctype is selected via the `schema` discriminator: 'knowledge.entry/v1' (curated, mutable), 'knowledge.source/v1' (raw, immutable), or 'knowledge.workspace/v1' (workspace manifest or per-context view).
+ */
+type KnowledgeDefinition = Entry | Source | Workspace;
+/**
+ * Workspace manifest doctype. Used both as the root manifest of a wiki (no `extends`) and as a per-consumer view (with `extends`). The same schema validates both modes; the host distinguishes by checking whether `extends` is set.
+ */
+type Workspace = {
+    [k: string]: unknown;
+} & {
+    /**
+     * Discriminator for the workspace manifest doctype.
+     */
+    schema: "knowledge.workspace/v1";
+    /**
+     * Stable kebab-case identifier for the workspace or view.
+     */
+    name: string;
+    /**
+     * Human-readable workspace title.
+     */
+    title: string;
+    /**
+     * One-paragraph statement of purpose: what this workspace (or view) is for and who uses it.
+     */
+    description: string;
+    /**
+     * Semantic version of the WORKSPACE shape. Bump on entityTypes / lints / source / curation changes. Independent of the wiki's content version.
+     */
+    version: string;
+    /**
+     * OPTIONAL — relative path to a parent KNOWLEDGE.md. Presence of this field makes the manifest a VIEW; absence makes it a WORKSPACE ROOT. Recursive composition: parents may themselves declare `extends`. Maximum chain depth is 8.
+     */
+    extends?: string;
+    /**
+     * OPTIONAL — list of consumers this VIEW adapts the workspace for. Hosts MUST refuse the view if any binding does not resolve. Not inherited; views declare their own scope.
+     */
+    appliesTo?: string[];
+    /**
+     * OPTIONAL — AIP-9 operator that curates this workspace. The host activates this operator for ingest, curation, and lint passes.
+     */
+    curator?: string;
+    /**
+     * OPTIONAL — AIP-7 policy or audit binding. May be a path to an AIP-7 policy file or a ws:// ref. Schema-poisoning mitigations and source-mutation audits flow through this ref.
+     */
+    governance?: string;
+    /**
+     * Entity types this workspace recognizes. Merge-by-name against the extends parent: a child entry with the same name replaces the parent's; new names are appended.
+     */
+    entityTypes?: {
+        /**
+         * PascalCase type name. Merge key when composing with extends parent.
+         */
+        name: string;
+        /**
+         * Canonical fields for this entity type. Child views append fields to parent's set.
+         */
+        fields?: string[];
+        /**
+         * OPTIONAL — display hint, typically a single emoji.
+         */
+        icon?: string;
+        /**
+         * OPTIONAL — prose describing what entries of this type capture.
+         */
+        description?: string;
+        /**
+         * OPTIONAL — name of another LOCAL entity type that this one extends. Used for subtyping (e.g. Investor extends Person).
+         */
+        parent?: string;
+    }[];
+    /**
+     * Lint rules. Merge-by-id against the extends parent: a child entry with the same id replaces the parent's; new ids are appended.
+     */
+    lints?: {
+        /**
+         * Stable kebab-case lint id. Merge key when composing with extends parent.
+         */
+        id: string;
+        /**
+         * Lint algorithm. 'custom' delegates to a host-defined check identified by `id`.
+         */
+        kind: "require-source" | "max-age" | "min-confidence" | "broken-ref" | "orphan" | "custom";
+        /**
+         * Entity type name (e.g. 'Concept') or '*' for all entries.
+         */
+        appliesTo: string;
+        /**
+         * Lint severity. Child views may soften (warn -> info) but governance policies may forbid that.
+         */
+        severity: "error" | "warn" | "info";
+        /**
+         * Kind-specific parameters. e.g. { days: 90 } for 'max-age'; { min: 0.6 } for 'min-confidence'.
+         */
+        params?: {
+            [k: string]: unknown;
+        };
+    }[];
+    /**
+     * Source registry policy. Each leaf field overrides independently across the extends chain.
+     */
+    sources?: {
+        /**
+         * Source retention. 'forever' (default) or 'days:<n>' for time-limited.
+         */
+        retention?: string;
+        /**
+         * Whether sources must carry an AIP-7 signature. Composes with AIP-7 governance.
+         */
+        signing?: "required" | "optional" | "none";
+        /**
+         * Default content-hash algorithm for new sources.
+         */
+        hashAlgo?: "sha256" | "sha512" | "blake3";
+        /**
+         * Default authority assigned to new sources when defineSource omits the field.
+         */
+        authorityDefault?: "primary" | "secondary" | "rumour";
+    };
+    /**
+     * Curation policy. Each leaf field overrides independently across the extends chain.
+     */
+    curation?: {
+        /**
+         * Free-form tone hint for the curator agent (e.g. 'academic', 'sales', 'neutral').
+         */
+        tone?: string;
+        /**
+         * How exhaustive the curator agent should be when distilling sources into entries.
+         */
+        depth?: "shallow" | "medium" | "deep";
+        /**
+         * Auto-linking policy: 'byName' walks bodies for entity names and inserts wikilinks; 'manual' leaves links to the agent; 'off' disables auto-linking entirely.
+         */
+        autoLink?: "byName" | "manual" | "off";
+        /**
+         * How the curator agent resolves contradictions when sources disagree.
+         */
+        conflictResolution?: "defer" | "recency" | "authority" | "observation-count" | "keep-both";
+        /**
+         * Prose hint for when to promote a mention into a full entry (vs leaving it as a body reference).
+         */
+        newEntryThreshold?: string;
+    };
+    /**
+     * Hints for how consumers should retrieve from this view.
+     */
+    queryHints?: {
+        /**
+         * When ranking results, weight recency higher.
+         */
+        preferRecent?: boolean;
+        /**
+         * When ranking results, weight authority='primary' higher.
+         */
+        preferAuthoritative?: boolean;
+        /**
+         * Default query scope — entity types this view focuses on. Replaced wholesale by child if present.
+         */
+        scopeTo?: string[];
+    };
+    /**
+     * Display hints for UIs that render the workspace. Runtime-agnostic.
+     */
+    display?: {
+        /**
+         * OPTIONAL — slug of the entry to use as the workspace landing page.
+         */
+        homePage?: string;
+        /**
+         * Default _index.md grouping.
+         */
+        defaultGrouping?: "kind" | "tag" | "source";
+    };
+    /**
+     * Vendor-specific extensions, namespaced under <vendor>. Deep-merged across the extends chain.
+     */
+    metadata?: {
+        [k: string]: unknown;
+    };
+};
+interface Entry {
+    /**
+     * Discriminator for curated wiki entries. Mutable doctype.
+     */
+    schema: "knowledge.entry/v1";
+    /**
+     * Stable kebab-case identifier. Used as the wikilink target ([[slug]]) and as the entry's path stem.
+     */
+    slug: string;
+    /**
+     * Entry kind. The wiki's KNOWLEDGE.md (entityTypes) and AGENTS.md schema together define the allowed values; common ones are 'entity', 'concept', 'summary', 'comparison', 'timeline'.
+     */
+    kind: string;
+    /**
+     * Human-readable page title.
+     */
+    title: string;
+    /**
+     * Provenance — list of source ids that back the claims in this entry's body.
+     */
+    sources?: string[];
+    /**
+     * Curation agent's confidence in the entry's claims. Advisory; downstream consumers may weight it against source authority and recency.
+     */
+    confidence?: number;
+    /**
+     * ISO 8601 timestamp of the last patch to this entry. MUST be set on every write.
+     */
+    updated_at: string;
+    /**
+     * Slugs of earlier entries that this one replaces. Resolution rules live in the wiki's KNOWLEDGE.md curation.conflictResolution policy.
+     */
+    supersedes?: string[];
+    /**
+     * Slugs of entries whose claims conflict with this one and that the contradiction policy could not auto-resolve. Surfaces in lint.
+     */
+    contradicts?: string[];
+    /**
+     * OPTIONAL hint to the link resolver — slugs this entry links to. The resolver also walks the body for [[slug]] and markdown links; this field is for entries whose links are computed.
+     */
+    links?: string[];
+    /**
+     * Free-form tags; consumed by retrieval, search, and grouping in _index.md.
+     */
+    tags?: string[];
+    /**
+     * Vendor-specific extensions. Hosts MUST tolerate unknown keys; the spec's normative fields MUST NOT change meaning.
+     */
+    metadata?: {
+        [k: string]: unknown;
+    };
+}
+interface Source {
+    /**
+     * Discriminator for raw sources. Immutable doctype — once registered, the host MUST refuse mutations to the file's bytes.
+     */
+    schema: "knowledge.source/v1";
+    /**
+     * Stable kebab-case source id, ISO-prefixed when possible (e.g. '2026-04-27-investor-call'). Entries reference sources by id, never by path.
+     */
+    id: string;
+    /**
+     * Path to the raw bytes, relative to the wiki root. MUST start with 'sources/'. The host pins this file once defineSource succeeds.
+     */
+    path: string;
+    /**
+     * Human-readable source title.
+     */
+    title: string;
+    /**
+     * ISO 8601 timestamp of when the source entered the wiki.
+     */
+    captured_at: string;
+    /**
+     * OPTIONAL — author or operator who pinned the source. May be a user identifier, an agent id, or an upstream system name.
+     */
+    captured_by?: string;
+    /**
+     * Cryptographic hash of the file bytes. sha256 is required by the spec; other algorithms MAY appear in additional sidecar fields. Once set, the file is pinned.
+     */
+    content_hash: string;
+    /**
+     * Source authority class. 'primary' = first-party document or recording; 'secondary' = derived analysis; 'rumour' = unverified claim. Consumed by contradiction policy.
+     */
+    authority?: "primary" | "secondary" | "rumour";
+    /**
+     * OPTIONAL — BCP-47 language code of the source. Useful for ingest pipelines that pick a translator.
+     */
+    language?: string;
+    /**
+     * OPTIONAL — id of a newer source that replaces this one. The host writes this; agents do not edit the source file's bytes to 'correct' it. Tombstones the source for contradiction-policy purposes while preserving the original bytes.
+     */
+    superseded_by?: string;
+    tags?: string[];
+    /**
+     * Vendor-specific extensions. Hosts MUST tolerate unknown keys.
+     */
+    metadata?: {
+        [k: string]: unknown;
+    };
+}
+type KnowledgeHandle = Readonly<KnowledgeDefinition>;
+
+export type { KnowledgeDefinition as K, KnowledgeHandle as a };

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "@agentproto/knowledge",
+  "version": "0.1.0-alpha.1",
+  "description": "@agentproto/knowledge — AIP-10 KNOWLEDGE.md reference implementation. A filesystem-first knowledge-base format where an LLM curates, links, and lints a markdown wiki on top of immutable raw sources, turning agent knowledge into a compounding artifact instead of a per-query retrieval miss.",
+  "keywords": [
+    "agentproto",
+    "aip-10",
+    "knowledge",
+    "defineKnowledge",
+    "open-standard",
+    "agentic"
+  ],
+  "homepage": "https://agentproto.sh/docs/aip-10",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/agentproto/ts",
+    "directory": "packages/knowledge"
+  },
+  "bugs": {
+    "url": "https://github.com/agentproto/ts/issues"
+  },
+  "license": "MIT",
+  "type": "module",
+  "main": "dist/index.mjs",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "default": "./dist/index.mjs"
+    },
+    "./manifest": {
+      "types": "./dist/manifest/index.d.ts",
+      "import": "./dist/manifest/index.mjs",
+      "default": "./dist/manifest/index.mjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "gray-matter": "^4.0.3",
+    "zod": "^4.4.3",
+    "@agentproto/define-doctype": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.6.2",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.4",
+    "@agentproto/tooling": "0.1.0-alpha.0"
+  },
+  "scripts": {
+    "dev": "tsup --watch",
+    "build": "tsup",
+    "clean": "rm -rf dist",
+    "check-types": "tsc --noEmit",
+    "test": "vitest run --passWithNoTests",
+    "test:watch": "vitest"
+  }
+}