@fortemi/core 2026.7.13 → 2026.7.15

package/dist/index.js

@@ -3493,6 +3493,7 @@ function createFortemi(config) {
 
 // src/server-compatibility.ts
 var FORTEMI_COMPATIBILITY_PATH = "/api/v1/system/compatibility";
+var FORTEMI_SERVER_COMPATIBILITY_REVISION = "2026-07-06";
 var FORTEMI_COMPATIBILITY_STATES = [
   "available",
   "degraded",
@@ -7634,6 +7635,164 @@ var knowledge_shard_v2_implementation_receipt_default = {
     schemaBundleSha256: "66dee80876c73fdc8756541c72e96ae189c098113a831c849d619381c4121c02"
   }};
 
+// schemas/knowledge-shard-v2.cross-repository.receipt.json
+var knowledge_shard_v2_cross_repository_receipt_default = {
+  cells: [
+    {
+      id: "pglite-full-v1-to-pglite",
+      producer: "react-pglite",
+      consumer: "react-pglite",
+      status: "passed",
+      tests: [
+        "full-v1-store: validates, persists all components and bytes, and converges on re-export",
+        "full-v1-store: produces and converges a complete full-v1 archive from live PGlite state",
+        "full-v1-store: rejects corrupt, incomplete, oversized, and transactional-failure inputs"
+      ],
+      coverage: [
+        "all-33-components",
+        "all-34-count-fields",
+        "attachment-bytes",
+        "signatures",
+        "identities",
+        "relationships",
+        "timestamps",
+        "tombstones",
+        "absent-null-empty-value",
+        "768-dimensional-embeddings",
+        "embedding-contract-lineage",
+        "skos",
+        "provenance",
+        "graph-community",
+        "current-minus-two",
+        "current",
+        "next-major-rejection",
+        "malformed-input",
+        "tampered-input",
+        "resource-limits",
+        "repeated-imports",
+        "zero-mutation-on-rejection"
+      ]
+    },
+    {
+      id: "aiwg-full-v1-to-pglite",
+      producer: "aiwg-index-converter",
+      consumer: "react-pglite",
+      status: "passed",
+      tests: [
+        "aiwg-index-full-shard: verifies the committed source, implementation, archive, and authority receipt",
+        "aiwg-index-full-shard: imports through PGlite and converges on exact logical files",
+        "portable-contract: validates rejection, presence, signature, limit, and mutation invariants"
+      ],
+      coverage: [
+        "all-33-components",
+        "all-34-count-fields",
+        "attachment-bytes",
+        "signatures",
+        "identities",
+        "relationships",
+        "timestamps",
+        "tombstones",
+        "absent-null-empty-value",
+        "768-dimensional-embeddings",
+        "embedding-contract-lineage",
+        "skos",
+        "provenance",
+        "graph-community",
+        "current-minus-two",
+        "current",
+        "next-major-rejection",
+        "malformed-input",
+        "tampered-input",
+        "resource-limits",
+        "repeated-imports",
+        "zero-mutation-on-rejection"
+      ]
+    },
+    {
+      id: "pglite-full-v1-to-fortemi",
+      producer: "react-pglite",
+      consumer: "fortemi-postgresql",
+      status: "passed",
+      tests: [
+        "tests::shard_schema_2_accepts_independent_react_and_aiwg_full_v1_archives",
+        "tests::shard_schema_2_clean_destinations_preserve_independent_full_v1_archives",
+        "tests::shard_schema_2_dispatch_covers_the_complete_authority_field_inventory"
+      ],
+      coverage: [
+        "all-33-components",
+        "all-34-count-fields",
+        "attachment-bytes",
+        "signatures",
+        "identities",
+        "relationships",
+        "timestamps",
+        "tombstones",
+        "absent-null-empty-value",
+        "768-dimensional-embeddings",
+        "embedding-contract-lineage",
+        "skos",
+        "provenance",
+        "graph-community",
+        "current-minus-two",
+        "current",
+        "next-major-rejection",
+        "malformed-input",
+        "tampered-input",
+        "resource-limits",
+        "repeated-imports",
+        "zero-mutation-on-rejection"
+      ]
+    },
+    {
+      id: "aiwg-full-v1-to-fortemi",
+      producer: "aiwg-index-converter",
+      consumer: "fortemi-postgresql",
+      status: "passed",
+      tests: [
+        "tests::shard_schema_2_accepts_independent_react_and_aiwg_full_v1_archives",
+        "tests::shard_schema_2_clean_destinations_preserve_independent_full_v1_archives",
+        "tests::shard_schema_2_dispatch_covers_the_complete_authority_field_inventory"
+      ],
+      coverage: [
+        "all-33-components",
+        "all-34-count-fields",
+        "attachment-bytes",
+        "signatures",
+        "identities",
+        "relationships",
+        "timestamps",
+        "tombstones",
+        "absent-null-empty-value",
+        "768-dimensional-embeddings",
+        "embedding-contract-lineage",
+        "skos",
+        "provenance",
+        "graph-community",
+        "current-minus-two",
+        "current",
+        "next-major-rejection",
+        "malformed-input",
+        "tampered-input",
+        "resource-limits",
+        "repeated-imports",
+        "zero-mutation-on-rejection"
+      ]
+    }
+  ],
+  advertisement: {
+    backend: "pglite",
+    schemaVersion: "2.0.0",
+    profile: "full-v1",
+    operations: [
+      "import",
+      "export"
+    ],
+    enabled: true
+  },
+  claims: {
+    suiteWide: false,
+    recordStoreFullV1: false}};
+
 // src/shard/profile-registry.ts
 var CORE_V1_COMPONENTS = [
   "notes",
@@ -7643,7 +7802,38 @@ var CORE_V1_COMPONENTS = [
   "links"
 ];
 var ALL_PROFILES = ["core-v1", "full-v1", "record-v1"];
+var FULL_V1_RECEIPT_CELLS = [
+  "pglite-full-v1-to-pglite",
+  "aiwg-full-v1-to-pglite",
+  "pglite-full-v1-to-fortemi",
+  "aiwg-full-v1-to-fortemi"
+];
+var FULL_V1_RECEIPT_COVERAGE = [
+  "all-33-components",
+  "all-34-count-fields",
+  "attachment-bytes",
+  "signatures",
+  "identities",
+  "relationships",
+  "timestamps",
+  "tombstones",
+  "absent-null-empty-value",
+  "768-dimensional-embeddings",
+  "embedding-contract-lineage",
+  "skos",
+  "provenance",
+  "graph-community",
+  "current-minus-two",
+  "current",
+  "next-major-rejection",
+  "malformed-input",
+  "tampered-input",
+  "resource-limits",
+  "repeated-imports",
+  "zero-mutation-on-rejection"
+];
 var FULL_V1_IMPLEMENTED = knowledge_shard_v2_implementation_receipt_default.authority.schemaBundleSha256 === knowledge_shard_v2_schema_receipt_default.schemaBundle.sha256;
+var FULL_V1_ADVERTISEMENT_RECEIPT_PASSED = knowledge_shard_v2_cross_repository_receipt_default.cells.length === FULL_V1_RECEIPT_CELLS.length && knowledge_shard_v2_cross_repository_receipt_default.cells.every((cell, index) => cell.id === FULL_V1_RECEIPT_CELLS[index] && cell.status === "passed" && JSON.stringify(cell.coverage) === JSON.stringify(FULL_V1_RECEIPT_COVERAGE)) && knowledge_shard_v2_cross_repository_receipt_default.advertisement.backend === "pglite" && knowledge_shard_v2_cross_repository_receipt_default.advertisement.schemaVersion === "2.0.0" && knowledge_shard_v2_cross_repository_receipt_default.advertisement.profile === "full-v1" && JSON.stringify(knowledge_shard_v2_cross_repository_receipt_default.advertisement.operations) === JSON.stringify(["import", "export"]) && knowledge_shard_v2_cross_repository_receipt_default.advertisement.enabled === true && knowledge_shard_v2_cross_repository_receipt_default.claims.suiteWide === false && knowledge_shard_v2_cross_repository_receipt_default.claims.recordStoreFullV1 === false;
 var ALL_COMPONENTS = [
   "notes",
   "collections",
@@ -7736,12 +7926,14 @@ function getKnowledgeShardProfileRegistry() {
 }
 function createShardCapabilityReport(input) {
   const requestedSchemaVersion = input.requestedSchemaVersion ?? null;
-  const authorityPending = requestedSchemaVersion === "2.0.0";
-  const advertisedProfiles = authorityPending ? [] : [...BACKEND_PROFILES[input.backend][input.operation]];
   const requestedProfile = input.requestedProfile;
   const knownProfile = requestedProfile && isKnownProfile(requestedProfile) ? requestedProfile : null;
-  const authorityStatus = requestedProfile === null ? "unprofiled" : knownProfile ? authorityPending ? "candidate" : registryEntry(knownProfile).authority_status : "unknown";
-  const backendSupported = !authorityPending && knownProfile !== null && advertisedProfiles.includes(knownProfile);
+  const schema2Requested = requestedSchemaVersion === "2.0.0";
+  const receiptBackedSchema2FullV1 = schema2Requested && requestedProfile === "full-v1" && input.backend === "pglite" && FULL_V1_ADVERTISEMENT_RECEIPT_PASSED;
+  const authorityPending = schema2Requested && !receiptBackedSchema2FullV1;
+  const advertisedProfiles = schema2Requested ? receiptBackedSchema2FullV1 ? ["full-v1"] : [] : [...BACKEND_PROFILES[input.backend][input.operation]];
+  const authorityStatus = requestedProfile === null ? "unprofiled" : knownProfile ? receiptBackedSchema2FullV1 ? "supported" : authorityPending ? "candidate" : registryEntry(knownProfile).authority_status : "unknown";
+  const backendSupported = knownProfile !== null && (receiptBackedSchema2FullV1 || !authorityPending && advertisedProfiles.includes(knownProfile));
   const backendComponents = new Set(BACKEND_COMPONENTS[input.backend][input.operation]);
   const profileComponents = knownProfile === "core-v1" ? CORE_V1_COMPONENTS : BACKEND_COMPONENTS[input.backend][input.operation];
   const supportedComponents = profileComponents.filter(
@@ -31143,6 +31335,86 @@ function validateOptionalRichMetadata(item, index, errors) {
   if (item.compatibility !== void 0 && !isPlainRecord(item.compatibility)) {
     errors.push("items[" + index + "].compatibility must be an object");
   }
+  if (item.operational_state !== void 0) {
+    const at = "items[" + index + "].operational_state";
+    if (!isPlainRecord(item.operational_state)) {
+      errors.push(at + " must be an object");
+    } else {
+      const state = item.operational_state;
+      const allowedClassifications = /* @__PURE__ */ new Set([
+        "fresh",
+        "historical",
+        "superseded",
+        "contradicted",
+        "needs-source"
+      ]);
+      const allowedConfidence = /* @__PURE__ */ new Set(["source", "candidate", "reviewed", "rejected"]);
+      const stringFields = [
+        "source_repo",
+        "source_kind",
+        "source_id",
+        "observed_state",
+        "observed_at",
+        "source_updated_at",
+        "evidence_url",
+        "evidence_path",
+        "observer",
+        "stale_after"
+      ];
+      const arrayFields = ["supersedes", "contradicts"];
+      const allowedFields = /* @__PURE__ */ new Set([
+        ...stringFields,
+        ...arrayFields,
+        "classification",
+        "confidence",
+        "current_action_selector"
+      ]);
+      if (!allowedClassifications.has(String(state.classification))) {
+        errors.push(at + ".classification must be fresh, historical, superseded, contradicted, or needs-source");
+      }
+      for (const field of stringFields) {
+        if (state[field] !== void 0 && !hasString(state[field])) {
+          errors.push(at + "." + field + " must be a non-empty string");
+        }
+      }
+      for (const field of ["observed_at", "source_updated_at", "stale_after"]) {
+        if (state[field] !== void 0 && (typeof state[field] !== "string" || Number.isNaN(Date.parse(state[field])))) {
+          errors.push(at + "." + field + " must be a date-time string");
+        }
+      }
+      for (const field of arrayFields) {
+        if (!isOptionalStringArray(state[field])) {
+          errors.push(at + "." + field + " must be a string array");
+        }
+      }
+      if (state.confidence !== void 0 && !allowedConfidence.has(String(state.confidence))) {
+        errors.push(at + ".confidence must be source, candidate, reviewed, or rejected");
+      }
+      if (state.current_action_selector !== void 0 && typeof state.current_action_selector !== "boolean") {
+        errors.push(at + ".current_action_selector must be a boolean");
+      }
+      if (Object.keys(state).some((field) => !allowedFields.has(field))) {
+        errors.push(at + " contains unsupported fields");
+      }
+    }
+  }
+  if (item.state_transfer !== void 0) {
+    const at = "items[" + index + "].state_transfer";
+    if (!isPlainRecord(item.state_transfer)) {
+      errors.push(at + " must be an object");
+    } else {
+      const stateTransfer = item.state_transfer;
+      const deletedAt = stateTransfer.deleted_at;
+      if (!Object.hasOwn(stateTransfer, "deleted_at")) {
+        errors.push(at + ".deleted_at is required");
+      } else if (deletedAt !== null && (typeof deletedAt !== "string" || Number.isNaN(Date.parse(deletedAt)))) {
+        errors.push(at + ".deleted_at must be a date-time string or null");
+      }
+      if (Object.keys(stateTransfer).some((field) => field !== "deleted_at")) {
+        errors.push(at + " contains unsupported fields");
+      }
+    }
+  }
 }
 function isPrivacyClassification(value) {
   return value === "private" || value === "sanitized" || value === "public";
@@ -31172,7 +31444,9 @@ var V2_ONLY_RECORD_FIELDS = [
   "skos_concepts",
   "skos_relations",
   "provenance_events",
-  "compatibility"
+  "compatibility",
+  "operational_state",
+  "state_transfer"
 ];
 var V2_ONLY_SOURCE_FIELDS = ["origin", "generated", "checksum", "updated_at"];
 var V2_ONLY_RELATIONSHIP_FIELDS = ["target_path", "direction", "metadata"];
@@ -32762,1178 +33036,233 @@ function communityIdsFor(item, options) {
   if (item.concepts.length > 0) return item.concepts.map((concept) => `concept:${concept}`);
   return [`type:${item.type}`];
 }
-var encoder4 = new TextEncoder();
-var UUID_NAMESPACE = "7ab5d1f8-29d2-5e35-9e2f-3a45de171a9e";
-function uuid(kind, id) {
-  return v5(`${kind}:${id}`, UUID_NAMESPACE);
-}
-function own(value, field) {
-  return Object.prototype.hasOwnProperty.call(value, field);
-}
-function timestamp(value) {
-  if (!value || Number.isNaN(Date.parse(value))) return void 0;
-  return new Date(value).toISOString();
-}
-function addLoss(losses, code, message, details = {}) {
-  losses.push({ code, message, ...details });
-}
-function encode(values, encoding) {
-  return encoder4.encode(encoding === "json-array" ? JSON.stringify(values) : values.map((value) => JSON.stringify(value)).join("\n"));
-}
-function noteTitle(record, losses) {
-  if (own(record, "title")) return record.title ?? null;
-  const derived = record.search?.title ?? record.search?.name;
-  addLoss(losses, "aiwg-title-not-native", derived ? "Title was derived from the AIWG search projection." : "AIWG supplied no title; the nullable destination field is null.", {
-    component: "notes",
-    record_id: record.id,
-    field_path: "/title",
-    source_state: "absent",
-    destination_capability: "nullable-value",
-    action: derived ? "degrade" : "default"
-  });
-  return derived ?? null;
-}
-function noteContent(record, losses) {
-  if (own(record, "text")) return record.text ?? "";
-  if (own(record.search ?? {}, "body")) {
-    addLoss(
-      losses,
-      "aiwg-content-search-projection",
-      "Content was derived from the AIWG search projection.",
-      {
-        component: "notes",
-        record_id: record.id,
-        field_path: "/original_content",
-        source_state: "absent",
-        destination_capability: "required-string",
-        action: "degrade"
+
+// schemas/aiwg-fortemi-index-export.schema.json
+var aiwg_fortemi_index_export_schema_default = {
+  $schema: "https://json-schema.org/draft/2020-12/schema",
+  $id: "https://aiwg.io/schemas/aiwg-fortemi-index-export.json",
+  title: "AIWG Fortemi Index Export",
+  type: "object",
+  additionalProperties: false,
+  required: ["schema_version", "generated_at", "source", "items"],
+  properties: {
+    schema_version: {
+      enum: ["aiwg.fortemi.index.export.v1", "aiwg.fortemi.index.export.v2"]
+    },
+    generated_at: {
+      type: "string",
+      format: "date-time"
+    },
+    source: {
+      type: "object",
+      additionalProperties: false,
+      required: ["repo", "privacy"],
+      properties: {
+        repo: {
+          type: "string",
+          minLength: 1
+        },
+        privacy: {
+          $ref: "#/$defs/privacy"
+        },
+        graph: {
+          type: "string",
+          minLength: 1
+        }
+      }
+    },
+    compatibility: {
+      type: "object",
+      additionalProperties: false,
+      required: ["previous_schema_version", "strategy"],
+      properties: {
+        previous_schema_version: {
+          const: "aiwg.fortemi.index.export.v1"
+        },
+        strategy: {
+          const: "supported"
+        }
+      }
+    },
+    items: {
+      type: "array",
+      items: {
+        $ref: "#/$defs/record"
       }
-    );
-    return record.search?.body ?? "";
-  }
-  if (record.chunks?.length) {
-    addLoss(losses, "aiwg-content-chunk-projection", "Content was assembled from AIWG chunks.", {
-      component: "notes",
-      record_id: record.id,
-      field_path: "/original_content",
-      source_state: "absent",
-      destination_capability: "required-string",
-      action: "degrade"
-    });
-    return record.chunks.map((chunk) => {
-      if (own(chunk, "text")) return chunk.text ?? "";
-      if (own(chunk, "body")) return chunk.body ?? "";
-      if (own(chunk, "summary")) return chunk.summary ?? "";
-      return "";
-    }).join("\n\n");
-  }
-  addLoss(
-    losses,
-    "aiwg-content-unavailable",
-    "AIWG supplied no body; the required destination string is empty.",
-    {
-      component: "notes",
-      record_id: record.id,
-      field_path: "/original_content",
-      source_state: "absent",
-      destination_capability: "required-string",
-      action: "default"
     }
-  );
-  return "";
-}
-function createdAt(record, losses) {
-  const source = timestamp(record.source.updated_at);
-  if (source) return source;
-  addLoss(
-    losses,
-    "aiwg-created-at-unavailable",
-    "AIWG has no distinct creation timestamp; updated_at was used.",
+  },
+  allOf: [
     {
-      component: "notes",
-      record_id: record.id,
-      field_path: "/created_at",
-      source_state: "absent",
-      destination_capability: "required-date-time",
-      action: "default"
-    }
-  );
-  return new Date(record.updated_at).toISOString();
-}
-function safeUri(value) {
-  if (!value) return null;
-  try {
-    return new URL(value).toString();
-  } catch {
-    return null;
-  }
-}
-function schemeName(concept) {
-  return concept.scheme && concept.scheme.length > 0 ? concept.scheme : "aiwg";
-}
-async function convertAiwgIndexToFullV1(index, options = {}) {
-  const losses = [];
-  const exportedAt = timestamp(options.createdAt) ?? new Date(index.generated_at).toISOString();
-  const records = [...index.items].sort((a, b) => a.id.localeCompare(b.id));
-  const noteIds = new Map(records.map((record) => [record.id, uuid("record", record.id)]));
-  const rows = /* @__PURE__ */ new Map();
-  for (const component of Object.keys(FULL_V1_COMPONENT_FILES)) rows.set(component, []);
-  const tags = /* @__PURE__ */ new Set();
-  for (const record of records) {
-    const noteId = noteIds.get(record.id);
-    const content = noteContent(record, losses);
-    const sourceCreatedAt = createdAt(record, losses);
-    const updatedAt = new Date(record.updated_at).toISOString();
-    const recordTags = [...new Set(record.tags)].sort();
-    recordTags.forEach((tag) => tags.add(tag));
-    if (record.binary_sources?.length) {
-      addLoss(
-        losses,
-        "aiwg-attachment-bytes-unavailable",
-        "Attachment references have no bytes, so full-v1 attachment projections were omitted.",
-        {
-          component: "notes",
-          count: record.binary_sources.length,
-          record_id: record.id,
-          field_path: "/attachments",
-          source_state: "value",
-          destination_capability: "mandatory-blob-sidecar",
-          action: "omit"
+      if: {
+        properties: {
+          schema_version: {
+            const: "aiwg.fortemi.index.export.v1"
+          }
         }
-      );
-    }
-    const unmappedRecordFields = [
-      Object.keys(record.facets).length > 0 ? "facets" : null,
-      record.search !== void 0 ? "search" : null,
-      record.chunks !== void 0 ? "chunks" : null,
-      record.compatibility !== void 0 ? "compatibility" : null
-    ].filter((field) => field !== null);
-    if (unmappedRecordFields.length > 0) {
-      addLoss(
-        losses,
-        "aiwg-record-fields-unmapped",
-        "AIWG fields without a native full-v1 component were not hidden in note metadata.",
-        {
-          component: "notes",
-          record_id: record.id,
-          source_state: "value",
-          action: "omit",
-          destination_capability: "native-full-v1-components",
-          reason: unmappedRecordFields.join(",")
+      },
+      then: {
+        not: {
+          required: ["compatibility"]
+        },
+        properties: {
+          source: {
+            not: {
+              required: ["graph"]
+            }
+          },
+          items: {
+            items: {
+              allOf: [
+                {
+                  properties: {
+                    schema_version: {
+                      const: "aiwg.fortemi.index.record.v1"
+                    }
+                  }
+                },
+                {
+                  $ref: "#/$defs/v1RecordCompatibility"
+                }
+              ]
+            }
+          }
         }
-      );
-    }
-    rows.get("notes").push({
-      id: noteId,
-      title: noteTitle(record, losses),
-      original_content: content,
-      revised_content: content,
-      metadata: { aiwg_source: {
-        record_id: record.id,
-        record_type: record.type,
-        repository: index.source.repo,
-        graph: index.source.graph ?? null,
-        source: record.source,
-        privacy: record.privacy
-      } },
-      format: "markdown",
-      source: "aiwg-index",
-      starred: false,
-      archived: false,
-      collection_id: null,
-      created_at: sourceCreatedAt,
-      updated_at: updatedAt,
-      tags: recordTags,
-      attachments: []
-    });
-    const hash = await sha256Hex(encoder4.encode(content));
-    rows.get("note_originals").push({
-      id: uuid("note-original", record.id),
-      note_id: noteId,
-      content,
-      hash: `sha256:${hash}`,
-      user_created_at: sourceCreatedAt,
-      user_last_edited_at: updatedAt,
-      version_number: 1
-    });
-    rows.get("note_revised_current").push({
-      note_id: noteId,
-      content,
-      last_revision_id: null,
-      ai_metadata: null
-    });
-  }
-  rows.set("tags", [...tags].sort().map((name) => ({ name, created_at: exportedAt })));
-  const relationshipInput = [];
-  for (const record of records) {
-    for (const [position, relationship] of record.relationships.entries()) {
-      const target = noteIds.get(relationship.target_id) ?? null;
-      const key = `${record.id}\0${position}\0${relationship.type}\0${relationship.target_id}`;
-      rows.get("links").push({
-        id: uuid("relationship", key),
-        from_note_id: noteIds.get(record.id),
-        to_note_id: target,
-        to_url: target ? null : `aiwg://record/${encodeURIComponent(relationship.target_id)}`,
-        kind: relationship.type,
-        score: own(relationship, "confidence") ? relationship.confidence ?? null : null,
-        created_at: new Date(record.updated_at).toISOString(),
-        metadata: target ? relationship.metadata ?? null : {
-          direction: relationship.direction ?? null,
-          label: relationship.label ?? null,
-          privacy: relationship.privacy ?? null,
-          source_path: relationship.source_path ?? null,
-          target_path: relationship.target_path ?? null,
-          source_metadata: relationship.metadata ?? null
+      }
+    },
+    {
+      if: {
+        properties: {
+          schema_version: {
+            const: "aiwg.fortemi.index.export.v2"
+          }
         }
-      });
-      relationshipInput.push({ source: record.id, position, relationship });
-      if (!target) continue;
-      let weight = relationship.confidence;
-      if (weight === void 0) {
-        weight = 1;
-        addLoss(
-          losses,
-          "aiwg-relationship-weight-unavailable",
-          "Graph weight defaulted because relationship confidence is absent.",
-          {
-            component: "graph_edges",
-            record_id: record.id,
-            field_path: `/relationships/${position}/confidence`,
-            source_state: "absent",
-            destination_capability: "required-number",
-            action: "default"
+      },
+      then: {
+        required: ["compatibility"],
+        properties: {
+          source: {
+            required: ["graph"]
+          },
+          items: {
+            items: {
+              properties: {
+                schema_version: {
+                  const: "aiwg.fortemi.index.record.v2"
+                }
+              }
+            }
           }
-        );
-      }
-      rows.get("graph_edges").push({
-        graph_source_id: "aiwg-relationships",
-        from_note_id: noteIds.get(record.id),
-        to_note_id: target,
-        weight,
-        kind: "manual",
-        rank: position,
-        metadata: {
-          type: relationship.type,
-          direction: relationship.direction ?? null,
-          label: relationship.label ?? null,
-          privacy: relationship.privacy ?? null,
-          source_path: relationship.source_path ?? null,
-          target_path: relationship.target_path ?? null,
-          source_metadata: relationship.metadata ?? null
         }
-      });
-    }
-  }
-  if (rows.get("graph_edges").length) {
-    rows.get("graph_sources").push({
-      id: "aiwg-relationships",
-      name: "AIWG relationships",
-      kind: "imported",
-      source_table: "manual",
-      embedding_set_id: null,
-      virtual_set_id: null,
-      model: null,
-      dimension: null,
-      truncate_dimension: null,
-      metric: null,
-      algorithm: null,
-      parameters: null,
-      input_hash: `sha256:${await sha256Hex(encoder4.encode(JSON.stringify(relationshipInput)))}`,
-      freshness: { status: "fresh", checked_at: exportedAt },
-      created_at: exportedAt
-    });
-  }
-  const concepts = /* @__PURE__ */ new Map();
-  const conceptMembers = /* @__PURE__ */ new Map();
-  for (const record of records) {
-    for (const id of record.concepts) {
-      conceptMembers.set(id, [...conceptMembers.get(id) ?? [], record]);
+      }
     }
-    for (const concept of record.skos_concepts ?? []) {
-      const existing = concepts.get(concept.id);
-      if (existing && JSON.stringify(existing) !== JSON.stringify(concept)) {
-        addLoss(
-          losses,
-          "aiwg-skos-concept-conflict",
-          "Different metadata was supplied for one concept; the first sorted record won.",
+  ],
+  $defs: {
+    privacy: {
+      enum: ["private", "sanitized", "public"]
+    },
+    recordType: {
+      type: "string",
+      minLength: 1
+    },
+    stringArray: {
+      type: "array",
+      items: {
+        type: "string"
+      }
+    },
+    numberArray: {
+      type: "array",
+      items: {
+        type: "number"
+      }
+    },
+    v1RecordCompatibility: {
+      type: "object",
+      not: {
+        anyOf: [
           {
-            component: "skos_concepts",
-            record_id: concept.id,
-            destination_capability: "single-concept-identity",
-            action: "degrade"
+            required: ["name"]
+          },
+          {
+            required: ["summary"]
+          },
+          {
+            required: ["search"]
+          },
+          {
+            required: ["chunks"]
+          },
+          {
+            required: ["embeddings"]
+          },
+          {
+            required: ["compatibility"]
+          },
+          {
+            required: ["skos_concepts"]
+          },
+          {
+            required: ["skos_relations"]
+          },
+          {
+            required: ["provenance_events"]
+          },
+          {
+            required: ["operational_state"]
+          },
+          {
+            required: ["state_transfer"]
           }
-        );
-      } else if (!existing) concepts.set(concept.id, concept);
-    }
-  }
-  for (const id of conceptMembers.keys()) {
-    if (!concepts.has(id)) {
-      concepts.set(id, { id, prefLabel: id });
-      addLoss(
-        losses,
-        "aiwg-skos-metadata-unavailable",
-        "A referenced concept had no SKOS metadata; its id is used as the label.",
-        {
-          component: "skos_concepts",
-          record_id: id,
-          field_path: "/prefLabel",
-          source_state: "absent",
-          destination_capability: "required-label",
-          action: "default"
-        }
-      );
-    }
-  }
-  const schemeIds = new Map(
-    [...new Set([...concepts.values()].map(schemeName))].sort().map((name) => [name, uuid("skos-scheme", name)])
-  );
-  for (const [name, id] of schemeIds) {
-    rows.get("skos_schemes").push({
-      id,
-      uri: null,
-      notation: name,
-      title: name,
-      description: null,
-      creator: "aiwg-index",
-      publisher: null,
-      rights: null,
-      version: null,
-      is_active: true,
-      is_system: false,
-      created_at: exportedAt,
-      updated_at: exportedAt,
-      issued_at: null,
-      modified_at: null,
-      embedding: null,
-      embedding_model: null,
-      embedded_at: null
-    });
-  }
-  const conceptIds = new Map([...concepts.keys()].sort().map((id) => [id, uuid("skos-concept", id)]));
-  for (const [sourceId, concept] of [...concepts].sort(([a], [b]) => a.localeCompare(b))) {
-    const id = conceptIds.get(sourceId);
-    const schemeId = schemeIds.get(schemeName(concept));
-    const memberCount = conceptMembers.get(sourceId)?.length ?? 0;
-    if (concept.uri && !safeUri(concept.uri)) addLoss(
-      losses,
-      "aiwg-skos-uri-invalid",
-      "AIWG concept URI is not a valid authority URI and was mapped to null.",
-      {
-        component: "skos_concepts",
-        record_id: sourceId,
-        field_path: "/uri",
-        source_state: "value",
-        destination_capability: "uri",
-        action: "omit"
-      }
-    );
-    const unmappedConceptMetadata = Object.keys(concept.metadata ?? {}).filter((key) => key !== "domain");
-    if (unmappedConceptMetadata.length > 0) addLoss(
-      losses,
-      "aiwg-skos-metadata-unmapped",
-      "AIWG concept metadata without a native full-v1 field was omitted.",
-      {
-        component: "skos_concepts",
-        record_id: sourceId,
-        source_state: "value",
-        action: "omit",
-        destination_capability: "native-skos-fields",
-        reason: unmappedConceptMetadata.join(",")
-      }
-    );
-    rows.get("skos_concepts").push({
-      id,
-      primary_scheme_id: schemeId,
-      uri: safeUri(concept.uri),
-      notation: concept.notation ?? sourceId,
-      facet_type: null,
-      facet_source: "aiwg-index",
-      facet_domain: typeof concept.metadata?.domain === "string" ? concept.metadata.domain : null,
-      facet_scope: null,
-      status: "candidate",
-      promoted_at: null,
-      deprecated_at: null,
-      deprecation_reason: null,
-      replaced_by_id: null,
-      note_count: memberCount,
-      first_used_at: memberCount ? exportedAt : null,
-      last_used_at: memberCount ? exportedAt : null,
-      depth: 0,
-      broader_count: 0,
-      narrower_count: 0,
-      related_count: 0,
-      antipatterns: null,
-      antipattern_checked_at: null,
-      created_at: exportedAt,
-      updated_at: exportedAt,
-      embedding: null,
-      embedding_model: null,
-      embedded_at: null
-    });
-    rows.get("skos_scheme_memberships").push({
-      concept_id: id,
-      scheme_id: schemeId,
-      is_top_concept: true,
-      added_at: exportedAt
-    });
-    rows.get("skos_labels").push({
-      id: uuid("skos-label", `${sourceId}:pref:${concept.prefLabel}`),
-      concept_id: id,
-      label_type: "pref_label",
-      value: concept.prefLabel,
-      language: "und",
-      created_at: exportedAt
-    });
-    for (const label of concept.altLabels ?? []) rows.get("skos_labels").push({
-      id: uuid("skos-label", `${sourceId}:alt:${label}`),
-      concept_id: id,
-      label_type: "alt_label",
-      value: label,
-      language: "und",
-      created_at: exportedAt
-    });
-    if (concept.definition !== void 0) rows.get("skos_notes").push({
-      id: uuid("skos-note", `${sourceId}:definition`),
-      concept_id: id,
-      note_type: "definition",
-      value: concept.definition,
-      language: "und",
-      author: null,
-      source: concept.uri ?? null,
-      created_at: exportedAt,
-      updated_at: exportedAt
-    });
-  }
-  for (const record of records) {
-    for (const [position, sourceId] of record.concepts.entries()) {
-      const conceptId = conceptIds.get(sourceId);
-      if (conceptId) rows.get("note_skos_tags").push({
-        note_id: noteIds.get(record.id),
-        concept_id: conceptId,
-        source: "aiwg-index",
-        confidence: null,
-        relevance_score: null,
-        is_primary: position === 0,
-        created_at: new Date(record.updated_at).toISOString(),
-        created_by: "aiwg-index"
-      });
-    }
-    for (const relation of record.skos_relations ?? []) {
-      const subject = conceptIds.get(relation.source_id);
-      const object = conceptIds.get(relation.target_id);
-      if (!subject || !object || !["broader", "narrower", "related"].includes(relation.type)) {
-        addLoss(
-          losses,
-          "aiwg-skos-relation-unrepresentable",
-          "SKOS relation could not be mapped to the native full-v1 relation enum.",
-          {
-            component: "skos_relations",
-            record_id: record.id,
-            destination_capability: "broader-narrower-related",
-            action: "omit"
+        ]
+      },
+      properties: {
+        source: {
+          not: {
+            anyOf: [
+              {
+                required: ["origin"]
+              },
+              {
+                required: ["generated"]
+              },
+              {
+                required: ["checksum"]
+              },
+              {
+                required: ["updated_at"]
+              }
+            ]
           }
-        );
-        continue;
-      }
-      const unmappedRelationFields = [
-        relation.source_path !== void 0 ? "source_path" : null,
-        relation.metadata !== void 0 ? "metadata" : null
-      ].filter((field) => field !== null);
-      if (unmappedRelationFields.length > 0) {
-        addLoss(
-          losses,
-          "aiwg-skos-relation-fields-unmapped",
-          "AIWG SKOS relation fields have no native full-v1 destination fields.",
-          {
-            component: "skos_relations",
-            record_id: record.id,
-            source_state: "value",
-            destination_capability: "native-skos-relation-fields",
-            action: "omit",
-            reason: unmappedRelationFields.join(",")
+        },
+        relationships: {
+          items: {
+            not: {
+              anyOf: [
+                {
+                  required: ["target_path"]
+                },
+                {
+                  required: ["direction"]
+                },
+                {
+                  required: ["label"]
+                },
+                {
+                  required: ["confidence"]
+                },
+                {
+                  required: ["privacy"]
+                },
+                {
+                  required: ["metadata"]
+                }
+              ]
+            }
           }
-        );
-        continue;
-      }
-      rows.get("skos_relations").push({
-        id: uuid("skos-relation", `${relation.source_id}:${relation.type}:${relation.target_id}`),
-        subject_id: subject,
-        object_id: object,
-        relation_type: relation.type,
-        inference_score: null,
-        is_inferred: false,
-        is_validated: false,
-        created_at: new Date(record.updated_at).toISOString(),
-        created_by: "aiwg-index"
-      });
-    }
-  }
-  for (const record of records) {
-    for (const [position, event] of (record.provenance_events ?? []).entries()) {
-      const start = timestamp(event.started_at);
-      if (!start) addLoss(
-        losses,
-        "aiwg-provenance-start-unavailable",
-        "Activity start defaulted to record updated_at.",
-        {
-          component: "provenance_activities",
-          record_id: event.id ?? `${record.id}:${position}`,
-          field_path: "/started_at",
-          source_state: "absent",
-          action: "default"
-        }
-      );
-      rows.get("provenance_activities").push({
-        id: uuid("provenance-event", event.id ?? `${record.id}:${position}`),
-        note_id: noteIds.get(record.id),
-        revision_id: null,
-        activity_type: event.activity,
-        model_name: event.agent ?? null,
-        started_at: start ?? new Date(record.updated_at).toISOString(),
-        ended_at: timestamp(event.ended_at) ?? null,
-        metadata: {
-          source: event.source ?? null,
-          path: event.path ?? null,
-          confidence: event.confidence ?? null,
-          privacy: event.privacy ?? null,
-          attributes: event.attributes ?? null
-        }
-      });
-    }
-    for (const [position, provenance] of record.provenance.entries()) {
-      rows.get("provenance_activities").push({
-        id: uuid("provenance-field", `${record.id}:${position}:${provenance.field}`),
-        note_id: noteIds.get(record.id),
-        revision_id: null,
-        activity_type: `source:${provenance.field}`,
-        model_name: provenance.source,
-        started_at: new Date(record.updated_at).toISOString(),
-        ended_at: null,
-        metadata: { path: provenance.path, confidence: provenance.confidence, privacy: provenance.privacy }
-      });
-    }
-  }
-  const embeddingGroups = /* @__PURE__ */ new Map();
-  for (const record of records) {
-    for (const [position, embedding] of (record.embeddings ?? []).entries()) {
-      const vector = embedding.embedding ?? embedding.vector;
-      if (!vector || vector.length !== 768) {
-        addLoss(
-          losses,
-          "aiwg-embedding-dimension-unrepresentable",
-          "Only 768-dimensional vectors satisfy the full-v1 authority.",
-          {
-            component: "embeddings",
-            record_id: embedding.id ?? `${record.id}:${position}`,
-            field_path: "/vector",
-            source_state: vector ? "value" : "absent",
-            destination_capability: "768-dimensional-vector",
-            action: "omit"
-          }
-        );
-        continue;
-      }
-      const model = embedding.model ?? "aiwg-unknown";
-      if (!embedding.model) addLoss(
-        losses,
-        "aiwg-embedding-model-unavailable",
-        "Embedding model defaulted because AIWG did not supply one.",
-        {
-          component: "embeddings",
-          record_id: embedding.id ?? `${record.id}:${position}`,
-          field_path: "/model",
-          source_state: "absent",
-          action: "default"
-        }
-      );
-      let group = embeddingGroups.get(model);
-      if (!group) {
-        group = { config: uuid("embedding-config", model), set: uuid("embedding-set", model), count: 0 };
-        embeddingGroups.set(model, group);
-      }
-      group.count += 1;
-      const unmappedEmbeddingFields = [
-        embedding.granularity !== void 0 ? "granularity" : null,
-        embedding.source_path !== void 0 ? "source_path" : null,
-        embedding.metadata !== void 0 ? "metadata" : null,
-        embedding.input_hash !== void 0 && !/^[0-9a-f]{64}$/.test(embedding.input_hash) ? "input_hash" : null
-      ].filter((field) => field !== null);
-      if (unmappedEmbeddingFields.length > 0) addLoss(
-        losses,
-        "aiwg-embedding-fields-unmapped",
-        "AIWG embedding fields without a native full-v1 field were omitted.",
-        {
-          component: "embeddings",
-          record_id: embedding.id ?? `${record.id}:${position}`,
-          source_state: "value",
-          action: "omit",
-          destination_capability: "native-embedding-fields",
-          reason: unmappedEmbeddingFields.join(",")
-        }
-      );
-      rows.get("embeddings").push({
-        id: uuid("embedding", embedding.id ?? `${record.id}:${position}`),
-        note_id: noteIds.get(record.id),
-        embedding_set_id: group.set,
-        chunk_index: position,
-        text: record.text ?? "",
-        vector,
-        model,
-        contract_fingerprint: /^[0-9a-f]{64}$/.test(embedding.input_hash ?? "") ? embedding.input_hash : null,
-        created_at: new Date(record.updated_at).toISOString()
-      });
-    }
-  }
-  for (const [model, group] of [...embeddingGroups].sort(([a], [b]) => a.localeCompare(b))) {
-    rows.get("embedding_configs").push({
-      id: group.config,
-      name: model,
-      description: null,
-      model,
-      dimension: 768,
-      chunk_size: 1,
-      chunk_overlap: 0,
-      hnsw_m: null,
-      hnsw_ef_construction: null,
-      ivfflat_lists: null,
-      is_default: null,
-      supports_mrl: null,
-      matryoshka_dims: null,
-      default_truncate_dim: null,
-      provider: null,
-      provider_config: null,
-      content_types: null,
-      strengths: null,
-      limitations: null,
-      recommended_for: null,
-      benchmark_scores: null,
-      is_available: null,
-      document_composition: {},
-      created_at: exportedAt,
-      updated_at: exportedAt
-    });
-    rows.get("embedding_sets").push({
-      id: group.set,
-      name: model,
-      slug: uuid("embedding-slug", model),
-      description: null,
-      purpose: null,
-      usage_hints: null,
-      keywords: null,
-      set_type: "full",
-      mode: "manual",
-      criteria: null,
-      embedding_config_id: group.config,
-      truncate_dim: null,
-      auto_embed_rules: null,
-      index_status: "ready",
-      index_type: null,
-      last_indexed_at: exportedAt,
-      document_count: null,
-      embedding_count: group.count,
-      embeddings_current: true,
-      index_size_bytes: null,
-      is_system: false,
-      is_active: true,
-      auto_refresh: false,
-      refresh_interval: null,
-      last_refresh_at: null,
-      agent_metadata: null,
-      created_at: exportedAt,
-      updated_at: exportedAt,
-      created_by: "aiwg-index"
-    });
-    const noteIdSet = new Set(rows.get("embeddings").filter((item) => item.embedding_set_id === group.set).map((item) => item.note_id));
-    for (const noteId of [...noteIdSet].sort()) rows.get("embedding_set_members").push({
-      embedding_set_id: group.set,
-      note_id: noteId,
-      membership_type: "materialized",
-      added_at: exportedAt,
-      added_by: "aiwg-index"
-    });
-  }
-  if (losses.length > 0) {
-    return {
-      success: false,
-      archive: null,
-      profile: "full-v1",
-      schema_version: "2.0.0",
-      lossless: false,
-      losses,
-      receipt: {
-        schema_version: "fortemi.aiwg-full-v1-conversion-receipt.v1",
-        source_schema_version: "aiwg.fortemi.index.export.v2",
-        authority_repository: knowledge_shard_v2_schema_receipt_default.source.repository,
-        authority_commit: knowledge_shard_v2_schema_receipt_default.source.commit,
-        authority_contract_sha256: knowledge_shard_v2_schema_receipt_default.source.contractSha256,
-        authority_schema_bundle_sha256: knowledge_shard_v2_schema_receipt_default.schemaBundle.sha256,
-        manifest_sha256: null,
-        component_checksums: {},
-        contract_valid: false,
-        signed: false
-      }
-    };
-  }
-  const files = /* @__PURE__ */ new Map();
-  const components = Object.keys(FULL_V1_COMPONENT_FILES);
-  const counts = { community_sets: 0 };
-  for (const component of components) {
-    const spec = FULL_V1_COMPONENT_FILES[component];
-    const componentRows = rows.get(component) ?? [];
-    files.set(spec.file, encode(componentRows, spec.encoding));
-    counts[component] = componentRows.length;
-  }
-  const checksums = {};
-  for (const [file, bytes] of files) checksums[file] = await sha256Hex(bytes);
-  const manifest = {
-    version: "2.0.0",
-    profile: "full-v1",
-    producer: { name: "fortemi-core-aiwg-index", version: options.matricVersion ?? "fortemi-core" },
-    format: SHARD_FORMAT,
-    created_at: exportedAt,
-    components,
-    counts,
-    checksums,
-    min_reader_version: "2.0.0"
-  };
-  const manifestBytes = encoder4.encode(JSON.stringify(manifest, null, 2));
-  files.set("manifest.json", manifestBytes);
-  const validation = await validateFullV1ShardArchive(files);
-  if (!validation.valid) {
-    throw new Error(`Generated AIWG full-v1 shard failed authority validation: ${validation.errors.join("; ")}`);
-  }
-  return {
-    success: true,
-    archive: packTarGz(files),
-    profile: "full-v1",
-    schema_version: "2.0.0",
-    lossless: losses.length === 0,
-    losses,
-    receipt: {
-      schema_version: "fortemi.aiwg-full-v1-conversion-receipt.v1",
-      source_schema_version: "aiwg.fortemi.index.export.v2",
-      authority_repository: knowledge_shard_v2_schema_receipt_default.source.repository,
-      authority_commit: knowledge_shard_v2_schema_receipt_default.source.commit,
-      authority_contract_sha256: knowledge_shard_v2_schema_receipt_default.source.contractSha256,
-      authority_schema_bundle_sha256: knowledge_shard_v2_schema_receipt_default.schemaBundle.sha256,
-      manifest_sha256: await sha256Hex(manifestBytes),
-      component_checksums: checksums,
-      contract_valid: true,
-      signed: false
-    }
-  };
-}
-
-// src/aiwg-index-shard.ts
-var AIWG_SHARD_UUID_NAMESPACE = "7ab5d1f8-29d2-5e35-9e2f-3a45de171a9e";
-var shardEncoder = new TextEncoder();
-var shardDecoder = new TextDecoder();
-function aiwgShardUuid(kind, id) {
-  return v5(`${kind}:${id}`, AIWG_SHARD_UUID_NAMESPACE);
-}
-function aiwgShardTimestamp(value, fallback) {
-  if (!value || Number.isNaN(Date.parse(value))) return fallback;
-  return new Date(value).toISOString();
-}
-function aiwgRecordTitle(record) {
-  return record.title ?? record.search?.title ?? record.search?.name ?? record.id;
-}
-function aiwgRecordContent(record) {
-  if (record.text) return record.text;
-  if (record.search?.body) return record.search.body;
-  const chunks = record.chunks?.map((chunk) => chunk.text ?? chunk.body ?? chunk.summary ?? "").filter(Boolean);
-  if (chunks?.length) return chunks.join("\n\n");
-  return record.search?.summary ?? "";
-}
-function aiwgShardMetadata(index, record) {
-  return {
-    aiwg_fortemi_index: {
-      envelope: {
-        schema_version: index.schema_version,
-        generated_at: index.generated_at,
-        source: index.source,
-        ...index.compatibility ? { compatibility: index.compatibility } : {}
-      },
-      record
-    }
-  };
-}
-function encodeJsonLines(values) {
-  return shardEncoder.encode(values.map((value) => JSON.stringify(value)).join("\n"));
-}
-async function aiwgFortemiIndexToKnowledgeShard(index, options = {}) {
-  if (options.includeNativeRichComponents) {
-    throw new Error(
-      "Native AIWG full-v1 conversion requires aiwgFortemiIndexToKnowledgeShardWithReport so semantic losses cannot be discarded"
-    );
-  }
-  const validation = validateAiwgFortemiIndexExport(index);
-  if (!validation.valid) {
-    throw new Error(`Invalid AIWG Fortemi index export:
-${validation.errors.join("\n")}`);
-  }
-  if (index.schema_version !== "aiwg.fortemi.index.export.v2") {
-    throw new Error("Knowledge Shard conversion requires aiwg.fortemi.index.export.v2");
-  }
-  const createdAt2 = aiwgShardTimestamp(options.createdAt ?? index.generated_at, (/* @__PURE__ */ new Date()).toISOString());
-  const noteIds = new Map(index.items.map((record) => [record.id, aiwgShardUuid("record", record.id)]));
-  const notes = index.items.map((record) => {
-    const content = aiwgRecordContent(record);
-    return {
-      id: noteIds.get(record.id),
-      title: aiwgRecordTitle(record),
-      original_content: content,
-      revised_content: content,
-      metadata: aiwgShardMetadata(index, record),
-      collection_id: null,
-      attachments: [],
-      format: "markdown",
-      source: "aiwg-index",
-      starred: false,
-      archived: false,
-      tags: [...new Set(record.tags)].sort(),
-      created_at: aiwgShardTimestamp(record.source.updated_at ?? record.updated_at, createdAt2),
-      updated_at: aiwgShardTimestamp(record.updated_at, createdAt2),
-      deleted_at: null
-    };
-  });
-  const links = [];
-  for (const record of index.items) {
-    for (const [position, relationship] of record.relationships.entries()) {
-      const targetNoteId = noteIds.get(relationship.target_id) ?? null;
-      links.push({
-        id: aiwgShardUuid(
-          "relationship",
-          `${record.id}\0${position}\0${relationship.type}\0${relationship.target_id}`
-        ),
-        from_note_id: noteIds.get(record.id),
-        to_note_id: targetNoteId,
-        to_url: targetNoteId ? null : `aiwg://record/${encodeURIComponent(relationship.target_id)}`,
-        kind: relationship.type,
-        score: relationship.confidence ?? 1,
-        created_at: aiwgShardTimestamp(record.updated_at, createdAt2),
-        metadata: {
-          aiwg_fortemi_index: {
-            source_record_id: record.id,
-            target_record_id: relationship.target_id,
-            relationship
-          }
-        }
-      });
-    }
-  }
-  const files = /* @__PURE__ */ new Map();
-  const components = ["notes", "tags"];
-  const counts = {
-    notes: notes.length,
-    tags: [...new Set(notes.flatMap((note) => note.tags))].length
-  };
-  files.set("notes.jsonl", encodeJsonLines(notes));
-  files.set("tags.json", shardEncoder.encode(JSON.stringify(
-    [...new Set(notes.flatMap((note) => note.tags))].sort().map((name) => ({ name, created_at: createdAt2 }))
-  )));
-  const addComponent = (component, filename, values, jsonLines = true) => {
-    if (values.length === 0) return;
-    components.push(component);
-    counts[component] = values.length;
-    files.set(filename, jsonLines ? encodeJsonLines(values) : shardEncoder.encode(JSON.stringify(values)));
-  };
-  addComponent("links", "links.jsonl", links);
-  const checksums = {};
-  for (const [filename, bytes] of files) checksums[filename] = await sha256Hex(bytes);
-  const manifest = {
-    version: CURRENT_SHARD_VERSION,
-    profile: "core-v1",
-    producer: {
-      name: "fortemi-core-aiwg-index",
-      version: options.matricVersion ?? "fortemi-core"
-    },
-    format: SHARD_FORMAT,
-    created_at: createdAt2,
-    components,
-    counts: {
-      notes: 0,
-      collections: 0,
-      tags: 0,
-      templates: 0,
-      links: 0,
-      embedding_sets: 0,
-      embedding_set_members: 0,
-      embeddings: 0,
-      embedding_configs: 0,
-      ...counts
-    },
-    checksums,
-    min_reader_version: CURRENT_SHARD_VERSION
-  };
-  files.set("manifest.json", shardEncoder.encode(JSON.stringify(manifest, null, 2)));
-  const contractValidation = await validateCoreV1ShardArchive(files);
-  if (!contractValidation.valid) {
-    throw new Error(
-      `Generated AIWG core-v1 shard failed canonical validation: ${contractValidation.errors.join("; ")}`
-    );
-  }
-  return packTarGz(files);
-}
-async function aiwgFortemiIndexToKnowledgeShardWithReport(index, options = {}) {
-  const validation = validateAiwgFortemiIndexExport(index);
-  if (!validation.valid) {
-    throw new Error(`Invalid AIWG Fortemi index export:
-${validation.errors.join("\n")}`);
-  }
-  if (index.schema_version !== "aiwg.fortemi.index.export.v2") {
-    throw new Error("Full-v1 Knowledge Shard conversion requires aiwg.fortemi.index.export.v2");
-  }
-  return convertAiwgIndexToFullV1(index, options);
-}
-function aiwgFortemiIndexFromKnowledgeShard(bytes) {
-  const files = unpackTarGz(bytes);
-  const noteBytes = files.get("notes.jsonl");
-  const notes = (noteBytes ? shardDecoder.decode(noteBytes) : "").split("\n").filter(Boolean).map((line) => JSON.parse(line));
-  if (notes.length === 0) throw new Error("Knowledge Shard contains no AIWG index notes");
-  let envelope;
-  const items = [];
-  for (const note of notes) {
-    const metadata = note.metadata && typeof note.metadata === "object" && !Array.isArray(note.metadata) ? note.metadata.aiwg_fortemi_index : void 0;
-    if (!metadata || typeof metadata !== "object" || Array.isArray(metadata)) {
-      throw new Error(`Knowledge Shard note ${note.id} has no AIWG index metadata`);
-    }
-    const value = metadata;
-    envelope ??= value.envelope;
-    items.push(value.record);
-  }
-  const restored = {
-    ...envelope,
-    items: items.sort((left, right) => left.id.localeCompare(right.id))
-  };
-  const validation = validateAiwgFortemiIndexExport(restored);
-  if (!validation.valid) {
-    throw new Error(`Knowledge Shard contains invalid AIWG index metadata:
-${validation.errors.join("\n")}`);
-  }
-  return restored;
-}
-
-// schemas/aiwg-fortemi-index-export.schema.json
-var aiwg_fortemi_index_export_schema_default = {
-  $schema: "https://json-schema.org/draft/2020-12/schema",
-  $id: "https://aiwg.io/schemas/aiwg-fortemi-index-export.json",
-  title: "AIWG Fortemi Index Export",
-  type: "object",
-  additionalProperties: false,
-  required: ["schema_version", "generated_at", "source", "items"],
-  properties: {
-    schema_version: {
-      enum: ["aiwg.fortemi.index.export.v1", "aiwg.fortemi.index.export.v2"]
-    },
-    generated_at: {
-      type: "string",
-      format: "date-time"
-    },
-    source: {
-      type: "object",
-      additionalProperties: false,
-      required: ["repo", "privacy"],
-      properties: {
-        repo: {
-          type: "string",
-          minLength: 1
-        },
-        privacy: {
-          $ref: "#/$defs/privacy"
-        },
-        graph: {
-          type: "string",
-          minLength: 1
-        }
-      }
-    },
-    compatibility: {
-      type: "object",
-      additionalProperties: false,
-      required: ["previous_schema_version", "strategy"],
-      properties: {
-        previous_schema_version: {
-          const: "aiwg.fortemi.index.export.v1"
-        },
-        strategy: {
-          const: "supported"
-        }
-      }
-    },
-    items: {
-      type: "array",
-      items: {
-        $ref: "#/$defs/record"
-      }
-    }
-  },
-  allOf: [
-    {
-      if: {
-        properties: {
-          schema_version: {
-            const: "aiwg.fortemi.index.export.v1"
-          }
-        }
-      },
-      then: {
-        not: {
-          required: ["compatibility"]
-        },
-        properties: {
-          source: {
-            not: {
-              required: ["graph"]
-            }
-          },
-          items: {
-            items: {
-              allOf: [
-                {
-                  properties: {
-                    schema_version: {
-                      const: "aiwg.fortemi.index.record.v1"
-                    }
-                  }
-                },
-                {
-                  $ref: "#/$defs/v1RecordCompatibility"
-                }
-              ]
-            }
-          }
-        }
-      }
-    },
-    {
-      if: {
-        properties: {
-          schema_version: {
-            const: "aiwg.fortemi.index.export.v2"
-          }
-        }
-      },
-      then: {
-        required: ["compatibility"],
-        properties: {
-          source: {
-            required: ["graph"]
-          },
-          items: {
-            items: {
-              properties: {
-                schema_version: {
-                  const: "aiwg.fortemi.index.record.v2"
-                }
-              }
-            }
-          }
-        }
-      }
-    }
-  ],
-  $defs: {
-    privacy: {
-      enum: ["private", "sanitized", "public"]
-    },
-    recordType: {
-      type: "string",
-      minLength: 1
-    },
-    stringArray: {
-      type: "array",
-      items: {
-        type: "string"
-      }
-    },
-    numberArray: {
-      type: "array",
-      items: {
-        type: "number"
-      }
-    },
-    v1RecordCompatibility: {
-      type: "object",
-      not: {
-        anyOf: [
-          {
-            required: ["name"]
-          },
-          {
-            required: ["summary"]
-          },
-          {
-            required: ["search"]
-          },
-          {
-            required: ["chunks"]
-          },
-          {
-            required: ["embeddings"]
-          },
-          {
-            required: ["compatibility"]
-          },
-          {
-            required: ["skos_concepts"]
-          },
-          {
-            required: ["skos_relations"]
-          },
-          {
-            required: ["provenance_events"]
-          }
-        ]
-      },
-      properties: {
-        source: {
-          not: {
-            anyOf: [
-              {
-                required: ["origin"]
-              },
-              {
-                required: ["generated"]
-              },
-              {
-                required: ["checksum"]
-              },
-              {
-                required: ["updated_at"]
-              }
-            ]
-          }
-        },
-        relationships: {
-          items: {
-            not: {
-              anyOf: [
-                {
-                  required: ["target_path"]
-                },
-                {
-                  required: ["direction"]
-                },
-                {
-                  required: ["label"]
-                },
-                {
-                  required: ["confidence"]
-                },
-                {
-                  required: ["privacy"]
-                },
-                {
-                  required: ["metadata"]
-                }
-              ]
-            }
-          }
-        },
-        privacy: {
-          not: {
-            required: ["locality"]
+        },
+        privacy: {
+          not: {
+            required: ["locality"]
           }
         }
       }
@@ -34337,98 +33666,1124 @@ var aiwg_fortemi_index_export_schema_default = {
               }
             }
           }
-        },
-        updated_at: {
-          type: "string",
-          format: "date-time"
+        },
+        operational_state: {
+          $ref: "#/$defs/operationalState"
+        },
+        state_transfer: {
+          $ref: "#/$defs/stateTransfer"
+        },
+        updated_at: {
+          type: "string",
+          format: "date-time"
+        }
+      }
+    },
+    operationalState: {
+      type: "object",
+      additionalProperties: false,
+      required: ["classification"],
+      properties: {
+        source_repo: { type: "string", minLength: 1 },
+        source_kind: { type: "string", minLength: 1 },
+        source_id: { type: "string", minLength: 1 },
+        observed_state: { type: "string", minLength: 1 },
+        observed_at: { type: "string", format: "date-time" },
+        source_updated_at: { type: "string", format: "date-time" },
+        evidence_url: { type: "string", format: "uri" },
+        evidence_path: { type: "string", minLength: 1 },
+        observer: { type: "string", minLength: 1 },
+        supersedes: { $ref: "#/$defs/stringArray" },
+        contradicts: { $ref: "#/$defs/stringArray" },
+        stale_after: { type: "string", format: "date-time" },
+        classification: {
+          enum: ["fresh", "historical", "superseded", "contradicted", "needs-source"]
+        },
+        confidence: {
+          enum: ["source", "candidate", "reviewed", "rejected"]
+        },
+        current_action_selector: { type: "boolean" }
+      }
+    },
+    stateTransfer: {
+      type: "object",
+      additionalProperties: false,
+      required: ["deleted_at"],
+      properties: {
+        deleted_at: {
+          type: ["string", "null"],
+          format: "date-time"
+        }
+      }
+    }
+  }
+};
+
+// src/aiwg-index-schema.ts
+var PROJECTED_FIELDS = [
+  "schema_version",
+  "id",
+  "type",
+  "title",
+  "text",
+  "facets",
+  "tags",
+  "concepts",
+  "privacy"
+];
+var ajvInstance;
+var exportValidator;
+var projectedRecordValidator;
+function getAiwgFortemiIndexExportSchema() {
+  return aiwg_fortemi_index_export_schema_default;
+}
+function getAjv() {
+  if (!ajvInstance) {
+    ajvInstance = new Ajv2020({
+      allErrors: true,
+      strict: false,
+      validateFormats: false
+    });
+    ajvInstance.addSchema(aiwg_fortemi_index_export_schema_default);
+  }
+  return ajvInstance;
+}
+function formatErrors2(errors) {
+  return (errors ?? []).map((error) => {
+    const path = error.instancePath || "(root)";
+    return `${path} ${error.message ?? "is invalid"}`;
+  });
+}
+function getExportValidator() {
+  exportValidator ??= getAjv().getSchema(aiwg_fortemi_index_export_schema_default.$id) ?? getAjv().compile(aiwg_fortemi_index_export_schema_default);
+  return exportValidator;
+}
+function getProjectedRecordValidator() {
+  if (!projectedRecordValidator) {
+    const properties = Object.fromEntries(Object.keys(aiwg_fortemi_index_export_schema_default.$defs.record.properties).map((field) => [
+      field,
+      { $ref: `${aiwg_fortemi_index_export_schema_default.$id}#/$defs/record/properties/${field}` }
+    ]));
+    projectedRecordValidator = getAjv().compile({
+      type: "object",
+      required: PROJECTED_FIELDS,
+      properties,
+      additionalProperties: true,
+      allOf: [
+        {
+          if: {
+            properties: {
+              schema_version: { const: "aiwg.fortemi.index.record.v1" }
+            }
+          },
+          then: { $ref: `${aiwg_fortemi_index_export_schema_default.$id}#/$defs/v1RecordCompatibility` }
+        }
+      ]
+    });
+  }
+  return projectedRecordValidator;
+}
+function validateAiwgFortemiIndexExportSchema(value) {
+  const validate = getExportValidator();
+  const schemaValue = value && typeof value === "object" && Array.isArray(value.items) ? {
+    ...value,
+    items: value.items.map((item) => {
+      if (!item || typeof item !== "object" || Array.isArray(item)) return item;
+      const schemaRecord = { ...item };
+      Reflect.deleteProperty(schemaRecord, "binary_sources");
+      return schemaRecord;
+    })
+  } : value;
+  const valid = validate(schemaValue);
+  return { valid, errors: formatErrors2(validate.errors) };
+}
+function validateAiwgFortemiProjectedRecordSchema(value) {
+  const validate = getProjectedRecordValidator();
+  const valid = validate(value);
+  return { valid, errors: formatErrors2(validate.errors) };
+}
+var encoder4 = new TextEncoder();
+var UUID_NAMESPACE = "7ab5d1f8-29d2-5e35-9e2f-3a45de171a9e";
+function uuid(kind, id) {
+  return v5(`${kind}:${id}`, UUID_NAMESPACE);
+}
+function own(value, field) {
+  return Object.prototype.hasOwnProperty.call(value, field);
+}
+function timestamp(value) {
+  if (!value || Number.isNaN(Date.parse(value))) return void 0;
+  return new Date(value).toISOString();
+}
+function addLoss(losses, code, message, details = {}) {
+  losses.push({ code, message, ...details });
+}
+function encode(values, encoding) {
+  return encoder4.encode(encoding === "json-array" ? JSON.stringify(values) : values.map((value) => JSON.stringify(value)).join("\n"));
+}
+function noteTitle(record, losses) {
+  if (own(record, "title")) return record.title ?? null;
+  const derived = record.search?.title ?? record.search?.name;
+  addLoss(losses, "aiwg-title-not-native", derived ? "Title was derived from the AIWG search projection." : "AIWG supplied no title; the nullable destination field is null.", {
+    component: "notes",
+    record_id: record.id,
+    field_path: "/title",
+    source_state: "absent",
+    destination_capability: "nullable-value",
+    action: derived ? "degrade" : "default"
+  });
+  return derived ?? null;
+}
+function noteContent(record, losses) {
+  if (own(record, "text")) return record.text ?? "";
+  if (own(record.search ?? {}, "body")) {
+    addLoss(
+      losses,
+      "aiwg-content-search-projection",
+      "Content was derived from the AIWG search projection.",
+      {
+        component: "notes",
+        record_id: record.id,
+        field_path: "/original_content",
+        source_state: "absent",
+        destination_capability: "required-string",
+        action: "degrade"
+      }
+    );
+    return record.search?.body ?? "";
+  }
+  if (record.chunks?.length) {
+    addLoss(losses, "aiwg-content-chunk-projection", "Content was assembled from AIWG chunks.", {
+      component: "notes",
+      record_id: record.id,
+      field_path: "/original_content",
+      source_state: "absent",
+      destination_capability: "required-string",
+      action: "degrade"
+    });
+    return record.chunks.map((chunk) => {
+      if (own(chunk, "text")) return chunk.text ?? "";
+      if (own(chunk, "body")) return chunk.body ?? "";
+      if (own(chunk, "summary")) return chunk.summary ?? "";
+      return "";
+    }).join("\n\n");
+  }
+  addLoss(
+    losses,
+    "aiwg-content-unavailable",
+    "AIWG supplied no body; the required destination string is empty.",
+    {
+      component: "notes",
+      record_id: record.id,
+      field_path: "/original_content",
+      source_state: "absent",
+      destination_capability: "required-string",
+      action: "default"
+    }
+  );
+  return "";
+}
+function createdAt(record, losses) {
+  const source = timestamp(record.source.updated_at);
+  if (source) return source;
+  addLoss(
+    losses,
+    "aiwg-created-at-unavailable",
+    "AIWG has no distinct creation timestamp; updated_at was used.",
+    {
+      component: "notes",
+      record_id: record.id,
+      field_path: "/created_at",
+      source_state: "absent",
+      destination_capability: "required-date-time",
+      action: "default"
+    }
+  );
+  return new Date(record.updated_at).toISOString();
+}
+function safeUri(value) {
+  if (!value) return null;
+  try {
+    return new URL(value).toString();
+  } catch {
+    return null;
+  }
+}
+function schemeName(concept) {
+  return concept.scheme && concept.scheme.length > 0 ? concept.scheme : "aiwg";
+}
+async function convertAiwgIndexToFullV1(index, options = {}) {
+  const losses = [];
+  const exportedAt = timestamp(options.createdAt) ?? new Date(index.generated_at).toISOString();
+  const records = [...index.items].sort((a, b) => a.id.localeCompare(b.id));
+  const noteIds = new Map(records.map((record) => [record.id, uuid("record", record.id)]));
+  const rows = /* @__PURE__ */ new Map();
+  for (const component of Object.keys(FULL_V1_COMPONENT_FILES)) rows.set(component, []);
+  const tags = /* @__PURE__ */ new Set();
+  for (const record of records) {
+    const noteId = noteIds.get(record.id);
+    const content = noteContent(record, losses);
+    const sourceCreatedAt = createdAt(record, losses);
+    const updatedAt = new Date(record.updated_at).toISOString();
+    const recordTags = [...new Set(record.tags)].sort();
+    recordTags.forEach((tag) => tags.add(tag));
+    if (record.binary_sources?.length) {
+      addLoss(
+        losses,
+        "aiwg-attachment-bytes-unavailable",
+        "Attachment references have no bytes, so full-v1 attachment projections were omitted.",
+        {
+          component: "notes",
+          count: record.binary_sources.length,
+          record_id: record.id,
+          field_path: "/attachments",
+          source_state: "value",
+          destination_capability: "mandatory-blob-sidecar",
+          action: "omit"
+        }
+      );
+    }
+    const unmappedRecordFields = [
+      Object.keys(record.facets).length > 0 ? "facets" : null,
+      record.search !== void 0 ? "search" : null,
+      record.chunks !== void 0 ? "chunks" : null,
+      record.compatibility !== void 0 ? "compatibility" : null
+    ].filter((field) => field !== null);
+    if (unmappedRecordFields.length > 0) {
+      addLoss(
+        losses,
+        "aiwg-record-fields-unmapped",
+        "AIWG fields without a native full-v1 component were not hidden in note metadata.",
+        {
+          component: "notes",
+          record_id: record.id,
+          source_state: "value",
+          action: "omit",
+          destination_capability: "native-full-v1-components",
+          reason: unmappedRecordFields.join(",")
+        }
+      );
+    }
+    rows.get("notes").push({
+      id: noteId,
+      title: noteTitle(record, losses),
+      original_content: content,
+      revised_content: content,
+      metadata: { aiwg_source: {
+        record_id: record.id,
+        record_type: record.type,
+        repository: index.source.repo,
+        graph: index.source.graph ?? null,
+        source: record.source,
+        privacy: record.privacy
+      } },
+      format: "markdown",
+      source: "aiwg-index",
+      starred: false,
+      archived: false,
+      collection_id: null,
+      created_at: sourceCreatedAt,
+      updated_at: updatedAt,
+      tags: recordTags,
+      attachments: []
+    });
+    const hash = await sha256Hex(encoder4.encode(content));
+    rows.get("note_originals").push({
+      id: uuid("note-original", record.id),
+      note_id: noteId,
+      content,
+      hash: `sha256:${hash}`,
+      user_created_at: sourceCreatedAt,
+      user_last_edited_at: updatedAt,
+      version_number: 1
+    });
+    rows.get("note_revised_current").push({
+      note_id: noteId,
+      content,
+      last_revision_id: null,
+      ai_metadata: null
+    });
+  }
+  rows.set("tags", [...tags].sort().map((name) => ({ name, created_at: exportedAt })));
+  const relationshipInput = [];
+  for (const record of records) {
+    for (const [position, relationship] of record.relationships.entries()) {
+      const target = noteIds.get(relationship.target_id) ?? null;
+      const key = `${record.id}\0${position}\0${relationship.type}\0${relationship.target_id}`;
+      rows.get("links").push({
+        id: uuid("relationship", key),
+        from_note_id: noteIds.get(record.id),
+        to_note_id: target,
+        to_url: target ? null : `aiwg://record/${encodeURIComponent(relationship.target_id)}`,
+        kind: relationship.type,
+        score: own(relationship, "confidence") ? relationship.confidence ?? null : null,
+        created_at: new Date(record.updated_at).toISOString(),
+        metadata: target ? relationship.metadata ?? null : {
+          direction: relationship.direction ?? null,
+          label: relationship.label ?? null,
+          privacy: relationship.privacy ?? null,
+          source_path: relationship.source_path ?? null,
+          target_path: relationship.target_path ?? null,
+          source_metadata: relationship.metadata ?? null
+        }
+      });
+      relationshipInput.push({ source: record.id, position, relationship });
+      if (!target) continue;
+      let weight = relationship.confidence;
+      if (weight === void 0) {
+        weight = 1;
+        addLoss(
+          losses,
+          "aiwg-relationship-weight-unavailable",
+          "Graph weight defaulted because relationship confidence is absent.",
+          {
+            component: "graph_edges",
+            record_id: record.id,
+            field_path: `/relationships/${position}/confidence`,
+            source_state: "absent",
+            destination_capability: "required-number",
+            action: "default"
+          }
+        );
+      }
+      rows.get("graph_edges").push({
+        graph_source_id: "aiwg-relationships",
+        from_note_id: noteIds.get(record.id),
+        to_note_id: target,
+        weight,
+        kind: "manual",
+        rank: position,
+        metadata: {
+          type: relationship.type,
+          direction: relationship.direction ?? null,
+          label: relationship.label ?? null,
+          privacy: relationship.privacy ?? null,
+          source_path: relationship.source_path ?? null,
+          target_path: relationship.target_path ?? null,
+          source_metadata: relationship.metadata ?? null
+        }
+      });
+    }
+  }
+  if (rows.get("graph_edges").length) {
+    rows.get("graph_sources").push({
+      id: "aiwg-relationships",
+      name: "AIWG relationships",
+      kind: "imported",
+      source_table: "manual",
+      embedding_set_id: null,
+      virtual_set_id: null,
+      model: null,
+      dimension: null,
+      truncate_dimension: null,
+      metric: null,
+      algorithm: null,
+      parameters: null,
+      input_hash: `sha256:${await sha256Hex(encoder4.encode(JSON.stringify(relationshipInput)))}`,
+      freshness: { status: "fresh", checked_at: exportedAt },
+      created_at: exportedAt
+    });
+  }
+  const concepts = /* @__PURE__ */ new Map();
+  const conceptMembers = /* @__PURE__ */ new Map();
+  for (const record of records) {
+    for (const id of record.concepts) {
+      conceptMembers.set(id, [...conceptMembers.get(id) ?? [], record]);
+    }
+    for (const concept of record.skos_concepts ?? []) {
+      const existing = concepts.get(concept.id);
+      if (existing && JSON.stringify(existing) !== JSON.stringify(concept)) {
+        addLoss(
+          losses,
+          "aiwg-skos-concept-conflict",
+          "Different metadata was supplied for one concept; the first sorted record won.",
+          {
+            component: "skos_concepts",
+            record_id: concept.id,
+            destination_capability: "single-concept-identity",
+            action: "degrade"
+          }
+        );
+      } else if (!existing) concepts.set(concept.id, concept);
+    }
+  }
+  for (const id of conceptMembers.keys()) {
+    if (!concepts.has(id)) {
+      concepts.set(id, { id, prefLabel: id });
+      addLoss(
+        losses,
+        "aiwg-skos-metadata-unavailable",
+        "A referenced concept had no SKOS metadata; its id is used as the label.",
+        {
+          component: "skos_concepts",
+          record_id: id,
+          field_path: "/prefLabel",
+          source_state: "absent",
+          destination_capability: "required-label",
+          action: "default"
+        }
+      );
+    }
+  }
+  const schemeIds = new Map(
+    [...new Set([...concepts.values()].map(schemeName))].sort().map((name) => [name, uuid("skos-scheme", name)])
+  );
+  for (const [name, id] of schemeIds) {
+    rows.get("skos_schemes").push({
+      id,
+      uri: null,
+      notation: name,
+      title: name,
+      description: null,
+      creator: "aiwg-index",
+      publisher: null,
+      rights: null,
+      version: null,
+      is_active: true,
+      is_system: false,
+      created_at: exportedAt,
+      updated_at: exportedAt,
+      issued_at: null,
+      modified_at: null,
+      embedding: null,
+      embedding_model: null,
+      embedded_at: null
+    });
+  }
+  const conceptIds = new Map([...concepts.keys()].sort().map((id) => [id, uuid("skos-concept", id)]));
+  for (const [sourceId, concept] of [...concepts].sort(([a], [b]) => a.localeCompare(b))) {
+    const id = conceptIds.get(sourceId);
+    const schemeId = schemeIds.get(schemeName(concept));
+    const memberCount = conceptMembers.get(sourceId)?.length ?? 0;
+    if (concept.uri && !safeUri(concept.uri)) addLoss(
+      losses,
+      "aiwg-skos-uri-invalid",
+      "AIWG concept URI is not a valid authority URI and was mapped to null.",
+      {
+        component: "skos_concepts",
+        record_id: sourceId,
+        field_path: "/uri",
+        source_state: "value",
+        destination_capability: "uri",
+        action: "omit"
+      }
+    );
+    const unmappedConceptMetadata = Object.keys(concept.metadata ?? {}).filter((key) => key !== "domain");
+    if (unmappedConceptMetadata.length > 0) addLoss(
+      losses,
+      "aiwg-skos-metadata-unmapped",
+      "AIWG concept metadata without a native full-v1 field was omitted.",
+      {
+        component: "skos_concepts",
+        record_id: sourceId,
+        source_state: "value",
+        action: "omit",
+        destination_capability: "native-skos-fields",
+        reason: unmappedConceptMetadata.join(",")
+      }
+    );
+    rows.get("skos_concepts").push({
+      id,
+      primary_scheme_id: schemeId,
+      uri: safeUri(concept.uri),
+      notation: concept.notation ?? sourceId,
+      facet_type: null,
+      facet_source: "aiwg-index",
+      facet_domain: typeof concept.metadata?.domain === "string" ? concept.metadata.domain : null,
+      facet_scope: null,
+      status: "candidate",
+      promoted_at: null,
+      deprecated_at: null,
+      deprecation_reason: null,
+      replaced_by_id: null,
+      note_count: memberCount,
+      first_used_at: memberCount ? exportedAt : null,
+      last_used_at: memberCount ? exportedAt : null,
+      depth: 0,
+      broader_count: 0,
+      narrower_count: 0,
+      related_count: 0,
+      antipatterns: null,
+      antipattern_checked_at: null,
+      created_at: exportedAt,
+      updated_at: exportedAt,
+      embedding: null,
+      embedding_model: null,
+      embedded_at: null
+    });
+    rows.get("skos_scheme_memberships").push({
+      concept_id: id,
+      scheme_id: schemeId,
+      is_top_concept: true,
+      added_at: exportedAt
+    });
+    rows.get("skos_labels").push({
+      id: uuid("skos-label", `${sourceId}:pref:${concept.prefLabel}`),
+      concept_id: id,
+      label_type: "pref_label",
+      value: concept.prefLabel,
+      language: "und",
+      created_at: exportedAt
+    });
+    for (const label of concept.altLabels ?? []) rows.get("skos_labels").push({
+      id: uuid("skos-label", `${sourceId}:alt:${label}`),
+      concept_id: id,
+      label_type: "alt_label",
+      value: label,
+      language: "und",
+      created_at: exportedAt
+    });
+    if (concept.definition !== void 0) rows.get("skos_notes").push({
+      id: uuid("skos-note", `${sourceId}:definition`),
+      concept_id: id,
+      note_type: "definition",
+      value: concept.definition,
+      language: "und",
+      author: null,
+      source: concept.uri ?? null,
+      created_at: exportedAt,
+      updated_at: exportedAt
+    });
+  }
+  for (const record of records) {
+    for (const [position, sourceId] of record.concepts.entries()) {
+      const conceptId = conceptIds.get(sourceId);
+      if (conceptId) rows.get("note_skos_tags").push({
+        note_id: noteIds.get(record.id),
+        concept_id: conceptId,
+        source: "aiwg-index",
+        confidence: null,
+        relevance_score: null,
+        is_primary: position === 0,
+        created_at: new Date(record.updated_at).toISOString(),
+        created_by: "aiwg-index"
+      });
+    }
+    for (const relation of record.skos_relations ?? []) {
+      const subject = conceptIds.get(relation.source_id);
+      const object = conceptIds.get(relation.target_id);
+      if (!subject || !object || !["broader", "narrower", "related"].includes(relation.type)) {
+        addLoss(
+          losses,
+          "aiwg-skos-relation-unrepresentable",
+          "SKOS relation could not be mapped to the native full-v1 relation enum.",
+          {
+            component: "skos_relations",
+            record_id: record.id,
+            destination_capability: "broader-narrower-related",
+            action: "omit"
+          }
+        );
+        continue;
+      }
+      const unmappedRelationFields = [
+        relation.source_path !== void 0 ? "source_path" : null,
+        relation.metadata !== void 0 ? "metadata" : null
+      ].filter((field) => field !== null);
+      if (unmappedRelationFields.length > 0) {
+        addLoss(
+          losses,
+          "aiwg-skos-relation-fields-unmapped",
+          "AIWG SKOS relation fields have no native full-v1 destination fields.",
+          {
+            component: "skos_relations",
+            record_id: record.id,
+            source_state: "value",
+            destination_capability: "native-skos-relation-fields",
+            action: "omit",
+            reason: unmappedRelationFields.join(",")
+          }
+        );
+        continue;
+      }
+      rows.get("skos_relations").push({
+        id: uuid("skos-relation", `${relation.source_id}:${relation.type}:${relation.target_id}`),
+        subject_id: subject,
+        object_id: object,
+        relation_type: relation.type,
+        inference_score: null,
+        is_inferred: false,
+        is_validated: false,
+        created_at: new Date(record.updated_at).toISOString(),
+        created_by: "aiwg-index"
+      });
+    }
+  }
+  for (const record of records) {
+    for (const [position, event] of (record.provenance_events ?? []).entries()) {
+      const start = timestamp(event.started_at);
+      if (!start) addLoss(
+        losses,
+        "aiwg-provenance-start-unavailable",
+        "Activity start defaulted to record updated_at.",
+        {
+          component: "provenance_activities",
+          record_id: event.id ?? `${record.id}:${position}`,
+          field_path: "/started_at",
+          source_state: "absent",
+          action: "default"
+        }
+      );
+      rows.get("provenance_activities").push({
+        id: uuid("provenance-event", event.id ?? `${record.id}:${position}`),
+        note_id: noteIds.get(record.id),
+        revision_id: null,
+        activity_type: event.activity,
+        model_name: event.agent ?? null,
+        started_at: start ?? new Date(record.updated_at).toISOString(),
+        ended_at: timestamp(event.ended_at) ?? null,
+        metadata: {
+          source: event.source ?? null,
+          path: event.path ?? null,
+          confidence: event.confidence ?? null,
+          privacy: event.privacy ?? null,
+          attributes: event.attributes ?? null
+        }
+      });
+    }
+    for (const [position, provenance] of record.provenance.entries()) {
+      rows.get("provenance_activities").push({
+        id: uuid("provenance-field", `${record.id}:${position}:${provenance.field}`),
+        note_id: noteIds.get(record.id),
+        revision_id: null,
+        activity_type: `source:${provenance.field}`,
+        model_name: provenance.source,
+        started_at: new Date(record.updated_at).toISOString(),
+        ended_at: null,
+        metadata: { path: provenance.path, confidence: provenance.confidence, privacy: provenance.privacy }
+      });
+    }
+  }
+  const embeddingGroups = /* @__PURE__ */ new Map();
+  for (const record of records) {
+    for (const [position, embedding] of (record.embeddings ?? []).entries()) {
+      const vector = embedding.embedding ?? embedding.vector;
+      if (!vector || vector.length !== 768) {
+        addLoss(
+          losses,
+          "aiwg-embedding-dimension-unrepresentable",
+          "Only 768-dimensional vectors satisfy the full-v1 authority.",
+          {
+            component: "embeddings",
+            record_id: embedding.id ?? `${record.id}:${position}`,
+            field_path: "/vector",
+            source_state: vector ? "value" : "absent",
+            destination_capability: "768-dimensional-vector",
+            action: "omit"
+          }
+        );
+        continue;
+      }
+      const model = embedding.model ?? "aiwg-unknown";
+      if (!embedding.model) addLoss(
+        losses,
+        "aiwg-embedding-model-unavailable",
+        "Embedding model defaulted because AIWG did not supply one.",
+        {
+          component: "embeddings",
+          record_id: embedding.id ?? `${record.id}:${position}`,
+          field_path: "/model",
+          source_state: "absent",
+          action: "default"
         }
+      );
+      let group = embeddingGroups.get(model);
+      if (!group) {
+        group = { config: uuid("embedding-config", model), set: uuid("embedding-set", model), count: 0 };
+        embeddingGroups.set(model, group);
       }
+      group.count += 1;
+      const unmappedEmbeddingFields = [
+        embedding.granularity !== void 0 ? "granularity" : null,
+        embedding.source_path !== void 0 ? "source_path" : null,
+        embedding.metadata !== void 0 ? "metadata" : null,
+        embedding.input_hash !== void 0 && !/^[0-9a-f]{64}$/.test(embedding.input_hash) ? "input_hash" : null
+      ].filter((field) => field !== null);
+      if (unmappedEmbeddingFields.length > 0) addLoss(
+        losses,
+        "aiwg-embedding-fields-unmapped",
+        "AIWG embedding fields without a native full-v1 field were omitted.",
+        {
+          component: "embeddings",
+          record_id: embedding.id ?? `${record.id}:${position}`,
+          source_state: "value",
+          action: "omit",
+          destination_capability: "native-embedding-fields",
+          reason: unmappedEmbeddingFields.join(",")
+        }
+      );
+      rows.get("embeddings").push({
+        id: uuid("embedding", embedding.id ?? `${record.id}:${position}`),
+        note_id: noteIds.get(record.id),
+        embedding_set_id: group.set,
+        chunk_index: position,
+        text: record.text ?? "",
+        vector,
+        model,
+        contract_fingerprint: /^[0-9a-f]{64}$/.test(embedding.input_hash ?? "") ? embedding.input_hash : null,
+        created_at: new Date(record.updated_at).toISOString()
+      });
     }
   }
-};
-
-// src/aiwg-index-schema.ts
-var PROJECTED_FIELDS = [
-  "schema_version",
-  "id",
-  "type",
-  "title",
-  "text",
-  "facets",
-  "tags",
-  "concepts",
-  "privacy"
-];
-var ajvInstance;
-var exportValidator;
-var projectedRecordValidator;
-function getAiwgFortemiIndexExportSchema() {
-  return aiwg_fortemi_index_export_schema_default;
-}
-function getAjv() {
-  if (!ajvInstance) {
-    ajvInstance = new Ajv2020({
-      allErrors: true,
-      strict: false,
-      validateFormats: false
+  for (const [model, group] of [...embeddingGroups].sort(([a], [b]) => a.localeCompare(b))) {
+    rows.get("embedding_configs").push({
+      id: group.config,
+      name: model,
+      description: null,
+      model,
+      dimension: 768,
+      chunk_size: 1,
+      chunk_overlap: 0,
+      hnsw_m: null,
+      hnsw_ef_construction: null,
+      ivfflat_lists: null,
+      is_default: null,
+      supports_mrl: null,
+      matryoshka_dims: null,
+      default_truncate_dim: null,
+      provider: null,
+      provider_config: null,
+      content_types: null,
+      strengths: null,
+      limitations: null,
+      recommended_for: null,
+      benchmark_scores: null,
+      is_available: null,
+      document_composition: {},
+      created_at: exportedAt,
+      updated_at: exportedAt
+    });
+    rows.get("embedding_sets").push({
+      id: group.set,
+      name: model,
+      slug: uuid("embedding-slug", model),
+      description: null,
+      purpose: null,
+      usage_hints: null,
+      keywords: null,
+      set_type: "full",
+      mode: "manual",
+      criteria: null,
+      embedding_config_id: group.config,
+      truncate_dim: null,
+      auto_embed_rules: null,
+      index_status: "ready",
+      index_type: null,
+      last_indexed_at: exportedAt,
+      document_count: null,
+      embedding_count: group.count,
+      embeddings_current: true,
+      index_size_bytes: null,
+      is_system: false,
+      is_active: true,
+      auto_refresh: false,
+      refresh_interval: null,
+      last_refresh_at: null,
+      agent_metadata: null,
+      created_at: exportedAt,
+      updated_at: exportedAt,
+      created_by: "aiwg-index"
+    });
+    const noteIdSet = new Set(rows.get("embeddings").filter((item) => item.embedding_set_id === group.set).map((item) => item.note_id));
+    for (const noteId of [...noteIdSet].sort()) rows.get("embedding_set_members").push({
+      embedding_set_id: group.set,
+      note_id: noteId,
+      membership_type: "materialized",
+      added_at: exportedAt,
+      added_by: "aiwg-index"
     });
-    ajvInstance.addSchema(aiwg_fortemi_index_export_schema_default);
   }
-  return ajvInstance;
+  if (losses.length > 0) {
+    return {
+      success: false,
+      archive: null,
+      profile: "full-v1",
+      schema_version: "2.0.0",
+      lossless: false,
+      losses,
+      receipt: {
+        schema_version: "fortemi.aiwg-full-v1-conversion-receipt.v1",
+        source_schema_version: "aiwg.fortemi.index.export.v2",
+        authority_repository: knowledge_shard_v2_schema_receipt_default.source.repository,
+        authority_commit: knowledge_shard_v2_schema_receipt_default.source.commit,
+        authority_contract_sha256: knowledge_shard_v2_schema_receipt_default.source.contractSha256,
+        authority_schema_bundle_sha256: knowledge_shard_v2_schema_receipt_default.schemaBundle.sha256,
+        manifest_sha256: null,
+        component_checksums: {},
+        contract_valid: false,
+        signed: false
+      }
+    };
+  }
+  const files = /* @__PURE__ */ new Map();
+  const components = Object.keys(FULL_V1_COMPONENT_FILES);
+  const counts = { community_sets: 0 };
+  for (const component of components) {
+    const spec = FULL_V1_COMPONENT_FILES[component];
+    const componentRows = rows.get(component) ?? [];
+    files.set(spec.file, encode(componentRows, spec.encoding));
+    counts[component] = componentRows.length;
+  }
+  const checksums = {};
+  for (const [file, bytes] of files) checksums[file] = await sha256Hex(bytes);
+  const manifest = {
+    version: "2.0.0",
+    profile: "full-v1",
+    producer: { name: "fortemi-core-aiwg-index", version: options.matricVersion ?? "fortemi-core" },
+    format: SHARD_FORMAT,
+    created_at: exportedAt,
+    components,
+    counts,
+    checksums,
+    min_reader_version: "2.0.0"
+  };
+  const manifestBytes = encoder4.encode(JSON.stringify(manifest, null, 2));
+  files.set("manifest.json", manifestBytes);
+  const validation = await validateFullV1ShardArchive(files);
+  if (!validation.valid) {
+    throw new Error(`Generated AIWG full-v1 shard failed authority validation: ${validation.errors.join("; ")}`);
+  }
+  return {
+    success: true,
+    archive: packTarGz(files),
+    profile: "full-v1",
+    schema_version: "2.0.0",
+    lossless: losses.length === 0,
+    losses,
+    receipt: {
+      schema_version: "fortemi.aiwg-full-v1-conversion-receipt.v1",
+      source_schema_version: "aiwg.fortemi.index.export.v2",
+      authority_repository: knowledge_shard_v2_schema_receipt_default.source.repository,
+      authority_commit: knowledge_shard_v2_schema_receipt_default.source.commit,
+      authority_contract_sha256: knowledge_shard_v2_schema_receipt_default.source.contractSha256,
+      authority_schema_bundle_sha256: knowledge_shard_v2_schema_receipt_default.schemaBundle.sha256,
+      manifest_sha256: await sha256Hex(manifestBytes),
+      component_checksums: checksums,
+      contract_valid: true,
+      signed: false
+    }
+  };
 }
-function formatErrors2(errors) {
-  return (errors ?? []).map((error) => {
-    const path = error.instancePath || "(root)";
-    return `${path} ${error.message ?? "is invalid"}`;
-  });
+
+// src/aiwg-index-shard.ts
+var AIWG_SHARD_UUID_NAMESPACE = "7ab5d1f8-29d2-5e35-9e2f-3a45de171a9e";
+var shardEncoder = new TextEncoder();
+var shardDecoder = new TextDecoder();
+function aiwgShardUuid(kind, id) {
+  return v5(`${kind}:${id}`, AIWG_SHARD_UUID_NAMESPACE);
 }
-function getExportValidator() {
-  exportValidator ??= getAjv().getSchema(aiwg_fortemi_index_export_schema_default.$id) ?? getAjv().compile(aiwg_fortemi_index_export_schema_default);
-  return exportValidator;
+function aiwgShardTimestamp(value, fallback) {
+  if (!value || Number.isNaN(Date.parse(value))) return fallback;
+  return new Date(value).toISOString();
 }
-function getProjectedRecordValidator() {
-  if (!projectedRecordValidator) {
-    const properties = Object.fromEntries(Object.keys(aiwg_fortemi_index_export_schema_default.$defs.record.properties).map((field) => [
-      field,
-      { $ref: `${aiwg_fortemi_index_export_schema_default.$id}#/$defs/record/properties/${field}` }
-    ]));
-    projectedRecordValidator = getAjv().compile({
-      type: "object",
-      required: PROJECTED_FIELDS,
-      properties,
-      additionalProperties: true,
-      allOf: [
-        {
-          if: {
-            properties: {
-              schema_version: { const: "aiwg.fortemi.index.record.v1" }
-            }
-          },
-          then: { $ref: `${aiwg_fortemi_index_export_schema_default.$id}#/$defs/v1RecordCompatibility` }
+function aiwgRecordTitle(record) {
+  return record.title ?? record.search?.title ?? record.search?.name ?? record.id;
+}
+function aiwgRecordContent(record) {
+  if (record.text) return record.text;
+  if (record.search?.body) return record.search.body;
+  const chunks = record.chunks?.map((chunk) => chunk.text ?? chunk.body ?? chunk.summary ?? "").filter(Boolean);
+  if (chunks?.length) return chunks.join("\n\n");
+  return record.search?.summary ?? "";
+}
+function aiwgRecordCollectionPaths(record) {
+  const segments = record.source.repo_relative_path.split("/").filter((segment) => segment.length > 0 && segment !== ".");
+  const directorySegments = segments.slice(0, -1);
+  return directorySegments.map((_, index) => directorySegments.slice(0, index + 1).join("/"));
+}
+function aiwgShardMetadata(index, record) {
+  return {
+    aiwg_fortemi_index: {
+      envelope: {
+        schema_version: index.schema_version,
+        generated_at: index.generated_at,
+        source: index.source,
+        ...index.compatibility ? { compatibility: index.compatibility } : {}
+      },
+      record
+    }
+  };
+}
+function encodeJsonLines(values) {
+  return shardEncoder.encode(values.map((value) => JSON.stringify(value)).join("\n"));
+}
+function validateAiwgIndexForShard(index) {
+  const contractValidation = validateAiwgFortemiIndexExportSchema(index);
+  const semanticValidation = validateAiwgFortemiIndexExport(index);
+  const errors = [...contractValidation.errors, ...semanticValidation.errors];
+  if (errors.length > 0) {
+    throw new Error(`Invalid AIWG Fortemi index export:
+${errors.join("\n")}`);
+  }
+}
+async function aiwgFortemiIndexToKnowledgeShard(index, options = {}) {
+  if (options.includeNativeRichComponents) {
+    throw new Error(
+      "Native AIWG full-v1 conversion requires aiwgFortemiIndexToKnowledgeShardWithReport so semantic losses cannot be discarded"
+    );
+  }
+  validateAiwgIndexForShard(index);
+  if (index.schema_version !== "aiwg.fortemi.index.export.v2") {
+    throw new Error("Knowledge Shard conversion requires aiwg.fortemi.index.export.v2");
+  }
+  const createdAt2 = aiwgShardTimestamp(options.createdAt ?? index.generated_at, (/* @__PURE__ */ new Date()).toISOString());
+  const noteIds = new Map(index.items.map((record) => [record.id, aiwgShardUuid("record", record.id)]));
+  const collectionPaths = [...new Set(index.items.flatMap(aiwgRecordCollectionPaths))].sort();
+  const collectionIds = new Map(
+    collectionPaths.map((path) => [path, aiwgShardUuid("collection", path)])
+  );
+  const collectionNoteCounts = /* @__PURE__ */ new Map();
+  for (const record of index.items) {
+    const collectionPath = aiwgRecordCollectionPaths(record).at(-1);
+    if (collectionPath) {
+      collectionNoteCounts.set(collectionPath, (collectionNoteCounts.get(collectionPath) ?? 0) + 1);
+    }
+  }
+  const collections = collectionPaths.map((path) => {
+    const segments = path.split("/");
+    const parentPath = segments.slice(0, -1).join("/");
+    return {
+      id: collectionIds.get(path),
+      name: segments.at(-1),
+      description: null,
+      parent_id: parentPath ? collectionIds.get(parentPath) : null,
+      created_at: createdAt2,
+      note_count: collectionNoteCounts.get(path) ?? 0
+    };
+  });
+  const notes = index.items.map((record) => {
+    const content = aiwgRecordContent(record);
+    const recordCollectionPaths = aiwgRecordCollectionPaths(record);
+    const collectionPath = recordCollectionPaths.at(-1);
+    return {
+      id: noteIds.get(record.id),
+      title: aiwgRecordTitle(record),
+      original_content: content,
+      revised_content: content,
+      metadata: aiwgShardMetadata(index, record),
+      collection_id: collectionPath ? collectionIds.get(collectionPath) : null,
+      attachments: [],
+      format: "markdown",
+      source: "aiwg-index",
+      starred: false,
+      archived: false,
+      tags: [...new Set(record.tags)].sort(),
+      created_at: aiwgShardTimestamp(record.source.updated_at ?? record.updated_at, createdAt2),
+      updated_at: aiwgShardTimestamp(record.updated_at, createdAt2),
+      deleted_at: record.state_transfer?.deleted_at ?? null
+    };
+  });
+  const links = [];
+  for (const record of index.items) {
+    for (const [position, relationship] of record.relationships.entries()) {
+      const targetNoteId = noteIds.get(relationship.target_id) ?? null;
+      links.push({
+        id: aiwgShardUuid(
+          "relationship",
+          `${record.id}\0${position}\0${relationship.type}\0${relationship.target_id}`
+        ),
+        from_note_id: noteIds.get(record.id),
+        to_note_id: targetNoteId,
+        to_url: targetNoteId ? null : `aiwg://record/${encodeURIComponent(relationship.target_id)}`,
+        kind: relationship.type,
+        score: relationship.confidence ?? 1,
+        created_at: aiwgShardTimestamp(record.updated_at, createdAt2),
+        metadata: {
+          aiwg_fortemi_index: {
+            source_record_id: record.id,
+            target_record_id: relationship.target_id,
+            relationship
+          }
         }
-      ]
-    });
+      });
+    }
   }
-  return projectedRecordValidator;
+  const files = /* @__PURE__ */ new Map();
+  const components = ["notes"];
+  const counts = {
+    notes: notes.length
+  };
+  files.set("notes.jsonl", encodeJsonLines(notes));
+  const addComponent = (component, filename, values, jsonLines = true) => {
+    if (values.length === 0) return;
+    components.push(component);
+    counts[component] = values.length;
+    files.set(filename, jsonLines ? encodeJsonLines(values) : shardEncoder.encode(JSON.stringify(values)));
+  };
+  addComponent("collections", "collections.json", collections, false);
+  const tags = [...new Set(notes.flatMap((note) => note.tags))].sort().map((name) => ({ name, created_at: createdAt2 }));
+  components.push("tags");
+  counts.tags = tags.length;
+  files.set("tags.json", shardEncoder.encode(JSON.stringify(tags)));
+  addComponent("links", "links.jsonl", links);
+  const checksums = {};
+  for (const [filename, bytes] of files) checksums[filename] = await sha256Hex(bytes);
+  const manifest = {
+    version: CURRENT_SHARD_VERSION,
+    profile: "core-v1",
+    producer: {
+      name: "fortemi-core-aiwg-index",
+      version: options.matricVersion ?? "fortemi-core"
+    },
+    format: SHARD_FORMAT,
+    created_at: createdAt2,
+    components,
+    counts: {
+      notes: 0,
+      collections: 0,
+      tags: 0,
+      templates: 0,
+      links: 0,
+      embedding_sets: 0,
+      embedding_set_members: 0,
+      embeddings: 0,
+      embedding_configs: 0,
+      ...counts
+    },
+    checksums,
+    min_reader_version: CURRENT_SHARD_VERSION
+  };
+  files.set("manifest.json", shardEncoder.encode(JSON.stringify(manifest, null, 2)));
+  const contractValidation = await validateCoreV1ShardArchive(files);
+  if (!contractValidation.valid) {
+    throw new Error(
+      `Generated AIWG core-v1 shard failed canonical validation: ${contractValidation.errors.join("; ")}`
+    );
+  }
+  return packTarGz(files);
 }
-function validateAiwgFortemiIndexExportSchema(value) {
-  const validate = getExportValidator();
-  const schemaValue = value && typeof value === "object" && Array.isArray(value.items) ? {
-    ...value,
-    items: value.items.map((item) => {
-      if (!item || typeof item !== "object" || Array.isArray(item)) return item;
-      const schemaRecord = { ...item };
-      Reflect.deleteProperty(schemaRecord, "binary_sources");
-      return schemaRecord;
-    })
-  } : value;
-  const valid = validate(schemaValue);
-  return { valid, errors: formatErrors2(validate.errors) };
+async function aiwgFortemiIndexToKnowledgeShardWithReport(index, options = {}) {
+  validateAiwgIndexForShard(index);
+  if (index.schema_version !== "aiwg.fortemi.index.export.v2") {
+    throw new Error("Full-v1 Knowledge Shard conversion requires aiwg.fortemi.index.export.v2");
+  }
+  return convertAiwgIndexToFullV1(index, options);
 }
-function validateAiwgFortemiProjectedRecordSchema(value) {
-  const validate = getProjectedRecordValidator();
-  const valid = validate(value);
-  return { valid, errors: formatErrors2(validate.errors) };
+function aiwgFortemiIndexFromKnowledgeShard(bytes) {
+  const files = unpackTarGz(bytes);
+  const noteBytes = files.get("notes.jsonl");
+  const notes = (noteBytes ? shardDecoder.decode(noteBytes) : "").split("\n").filter(Boolean).map((line) => JSON.parse(line));
+  if (notes.length === 0) throw new Error("Knowledge Shard contains no AIWG index notes");
+  let envelope;
+  const items = [];
+  for (const note of notes) {
+    const metadata = note.metadata && typeof note.metadata === "object" && !Array.isArray(note.metadata) ? note.metadata.aiwg_fortemi_index : void 0;
+    if (!metadata || typeof metadata !== "object" || Array.isArray(metadata)) {
+      throw new Error(`Knowledge Shard note ${note.id} has no AIWG index metadata`);
+    }
+    const value = metadata;
+    envelope ??= value.envelope;
+    items.push(value.record);
+  }
+  const restored = {
+    ...envelope,
+    items: items.sort((left, right) => left.id.localeCompare(right.id))
+  };
+  const validation = validateAiwgFortemiIndexExport(restored);
+  if (!validation.valid) {
+    throw new Error(`Knowledge Shard contains invalid AIWG index metadata:
+${validation.errors.join("\n")}`);
+  }
+  return restored;
 }
 
 // src/records/types.ts
@@ -36476,8 +36831,8 @@ async function importShardToRecords(store, data, options) {
 }
 
 // src/index.ts
-var VERSION = "2026.7.13";
+var VERSION = "2026.7.15";
 
-export { AIWG_SCAN_REQUIRED_FIELDS, AllowlistTrustStore, ArchiveManager, AttachmentsRepository, CORE_V1_COMPONENTS, CURRENT_MIGRATION_HEAD, CURRENT_SHARD_VERSION, CanonicalAttachmentsRepository, CanonicalNotesRepository, CapabilityManager, CaptureKnowledgeInputSchema, CollectionsRepository, CommunitiesRepository, DB_SNAPSHOT_SCHEMA_VERSION, DbSnapshotVersionError, EMBED_REQUEST_KIND, EMBED_RESPONSE_KIND, EmbeddingSetsRepository, FORTEMI_COMPATIBILITY_PATH, FORTEMI_COMPATIBILITY_STATES, FORTEMI_REQUIRED_COMPATIBILITY_CAPABILITIES, FallbackRouter, FortemiToolManifest, GetNoteInputSchema, GraphRepository, IdbRecordStore, JOB_CAPABILITIES, JOB_PRIORITIES, JobQueueWorker, LOCAL_ENDPOINTS, LinksRepository, ListNotesInputSchema, ManageArchiveInputSchema, ManageAttachmentsInputSchema, ManageCapabilitiesInputSchema, ManageCollectionsInputSchema, ManageLinksInputSchema, ManageNoteInputSchema, ManageTagsInputSchema, MemoryBlobStore, MemoryRecordStore, MigrationRunner, NotesRepository, OpenAICompatibleProvider, PGliteStorageBackend, PGliteStorageBackendFactory, PGliteWorkerClient, PGliteWorkerStorageBackend, PGliteWorkerStorageBackendFactory, ProvenanceRepository, ProviderRegistry, RECORD_COLLECTIONS, RECORD_SCHEMA_VERSION, RECORD_STORE_CAPABILITIES, SHARD_FORMAT, SIGNATURE_ENTRY, SIGNING_ENVELOPE_VERSION, SUPPORTED_PGLITE_VERSION, SearchInputSchema, SearchRepository, SkosRepository, TagsRepository, TransactionProxy, TypedEventBus, VERSION, aiRevisionHandler, aiwgFortemiIndexFromKnowledgeShard, aiwgFortemiIndexToCommunityGraph, aiwgFortemiIndexToKnowledgeShard, aiwgFortemiIndexToKnowledgeShardWithReport, allMigrations, appendPluginScript, assertAiwgFortemiChunkManifest, assertAiwgFortemiChunkPart, assertAiwgFortemiIndexExport, assertAiwgStaticEmbeddingSet, assertShardComponentRecord, buildAiwgChunkedIndex, buildAiwgStaticEmbeddingSet, buildNoteConditions, buildPluginCsp, captureKnowledge, chunkText, classifyError, classifyModel, clearPrefetchedShard, collectionFromShard, collectionToShard, computeBlobHash, computeHash, computeSri, conceptTaggingHandler, cosineSimilarity, createAiwgFetchChunkLoader, createAiwgFetchDetailLoader, createAiwgIndexController, createAiwgReviewDecisionExport, createBlobStore, createCosineSemanticProvider, createCspReportHandler, createFortemi, createLazyBlobStore, createLegacyProvider, createPGliteBackend, createPGliteInstance, createRecordBackend, createRecordStore, createRemoteBackend, createRoutes, createShardBackend, createShardCapabilityReport, createWorkerEmbedFunction, defaultStorageBackendFactory, detectCommunities, detectGpuCapabilities, detectInferenceCapabilities, discoverLocalProviders, dropAttachmentProjection, dropNoteProjection, dumpDbSnapshot, embeddingConfigToShard, embeddingFromShard, embeddingGenerationHandler, embeddingSetFromShard, embeddingSetMemberToShard, embeddingSetToShard, embeddingToShard, enqueueFullWorkflow, enqueueJob, enqueueNoteCreationJobs, estimateModelFit, estimateVramMB, estimateVramTier, exportShard, exportShardFromRecords, exportShardFromRecordsWithReport, exportShardWithReport, fetchAndValidateFortemiCompatibility, fetchPluginScript, filterAiwgRecordsByPrivacy, findAiwgStaticDuplicatePairs, formatFortemiCompatibilitySummary, fortemiCompatibilityUrl, fortemiManifest, fromPrefetched, generateId, getAiwgFortemiFacets, getAiwgFortemiIndexExportSchema, getEmbedFunction, getFortemiBridge, getFortemiSecretStore, getJobQueueStatus, getKnowledgeShardContractReceipt, getKnowledgeShardProfileRegistry, getKnowledgeShardSchema, getLlmFunction, getNote, getPrefetchedSha256, handleEmbedRequests, hasFortemiSecureSecrets, importShard, importShardToRecords, isPluginScriptAllowed, isShardPrefetched, isShardSigningSupported, linkFromShard, linkToShard, linkingHandler, listNotes, manageArchive, manageAttachments, manageCapabilities, manageCollections, manageLinks, manageNote, manageTags, matchRoute, migrateLegacyBlobStore, noteFromShard, noteSkosTagToShard, noteToShard, openShard, packTarGz, parseCspReport, prefetchShard, profileSupportError, projectAttachments, projectNotes, projectRecords, provenanceEdgeToShard, queryAiwgFortemiIndex, queryAiwgHybridIndex, queryAiwgSemanticIndex, registerLlmCapability, registerSemanticCapability, registerSemanticCapabilityWorker, registerServiceWorker, restoreDbSnapshot, searchTool, selectBackend, selectLlmModel, setEmbedFunction, setLlmFunction, sha256Hex, sidecarBlobDigests, signShard, skosConceptToShard, skosRelationToShard, skosSchemeToShard, suggestTags, tagsToShard, templateToShard, titleGenerationHandler, unpackTarGz, unregisterLlmCapability, unregisterSemanticCapability, urlLinkToShard, validateAiwgFortemiChunkManifest, validateAiwgFortemiChunkPart, validateAiwgFortemiIndexExport, validateAiwgFortemiIndexExportSchema, validateAiwgFortemiProjectedRecordSchema, validateAiwgStaticEmbeddingSet, validateChecksums, validateCoreV1ShardArchive, validateFortemiCompatibilityResponse, validateFullV1ShardArchive, validateRecordV1ShardArchive, validateShardArchive, validateShardComponentRecord, validateShardManifest, verifyDbSnapshotMeta, verifyShardSignature, verifySri };
+export { AIWG_SCAN_REQUIRED_FIELDS, AllowlistTrustStore, ArchiveManager, AttachmentsRepository, CORE_V1_COMPONENTS, CURRENT_MIGRATION_HEAD, CURRENT_SHARD_VERSION, CanonicalAttachmentsRepository, CanonicalNotesRepository, CapabilityManager, CaptureKnowledgeInputSchema, CollectionsRepository, CommunitiesRepository, DB_SNAPSHOT_SCHEMA_VERSION, DbSnapshotVersionError, EMBED_REQUEST_KIND, EMBED_RESPONSE_KIND, EmbeddingSetsRepository, FORTEMI_COMPATIBILITY_PATH, FORTEMI_COMPATIBILITY_STATES, FORTEMI_REQUIRED_COMPATIBILITY_CAPABILITIES, FORTEMI_SERVER_COMPATIBILITY_REVISION, FallbackRouter, FortemiToolManifest, GetNoteInputSchema, GraphRepository, IdbRecordStore, JOB_CAPABILITIES, JOB_PRIORITIES, JobQueueWorker, LOCAL_ENDPOINTS, LinksRepository, ListNotesInputSchema, ManageArchiveInputSchema, ManageAttachmentsInputSchema, ManageCapabilitiesInputSchema, ManageCollectionsInputSchema, ManageLinksInputSchema, ManageNoteInputSchema, ManageTagsInputSchema, MemoryBlobStore, MemoryRecordStore, MigrationRunner, NotesRepository, OpenAICompatibleProvider, PGliteStorageBackend, PGliteStorageBackendFactory, PGliteWorkerClient, PGliteWorkerStorageBackend, PGliteWorkerStorageBackendFactory, ProvenanceRepository, ProviderRegistry, RECORD_COLLECTIONS, RECORD_SCHEMA_VERSION, RECORD_STORE_CAPABILITIES, SHARD_FORMAT, SIGNATURE_ENTRY, SIGNING_ENVELOPE_VERSION, SUPPORTED_PGLITE_VERSION, SearchInputSchema, SearchRepository, SkosRepository, TagsRepository, TransactionProxy, TypedEventBus, VERSION, aiRevisionHandler, aiwgFortemiIndexFromKnowledgeShard, aiwgFortemiIndexToCommunityGraph, aiwgFortemiIndexToKnowledgeShard, aiwgFortemiIndexToKnowledgeShardWithReport, allMigrations, appendPluginScript, assertAiwgFortemiChunkManifest, assertAiwgFortemiChunkPart, assertAiwgFortemiIndexExport, assertAiwgStaticEmbeddingSet, assertShardComponentRecord, buildAiwgChunkedIndex, buildAiwgStaticEmbeddingSet, buildNoteConditions, buildPluginCsp, captureKnowledge, chunkText, classifyError, classifyModel, clearPrefetchedShard, collectionFromShard, collectionToShard, computeBlobHash, computeHash, computeSri, conceptTaggingHandler, cosineSimilarity, createAiwgFetchChunkLoader, createAiwgFetchDetailLoader, createAiwgIndexController, createAiwgReviewDecisionExport, createBlobStore, createCosineSemanticProvider, createCspReportHandler, createFortemi, createLazyBlobStore, createLegacyProvider, createPGliteBackend, createPGliteInstance, createRecordBackend, createRecordStore, createRemoteBackend, createRoutes, createShardBackend, createShardCapabilityReport, createWorkerEmbedFunction, defaultStorageBackendFactory, detectCommunities, detectGpuCapabilities, detectInferenceCapabilities, discoverLocalProviders, dropAttachmentProjection, dropNoteProjection, dumpDbSnapshot, embeddingConfigToShard, embeddingFromShard, embeddingGenerationHandler, embeddingSetFromShard, embeddingSetMemberToShard, embeddingSetToShard, embeddingToShard, enqueueFullWorkflow, enqueueJob, enqueueNoteCreationJobs, estimateModelFit, estimateVramMB, estimateVramTier, exportShard, exportShardFromRecords, exportShardFromRecordsWithReport, exportShardWithReport, fetchAndValidateFortemiCompatibility, fetchPluginScript, filterAiwgRecordsByPrivacy, findAiwgStaticDuplicatePairs, formatFortemiCompatibilitySummary, fortemiCompatibilityUrl, fortemiManifest, fromPrefetched, generateId, getAiwgFortemiFacets, getAiwgFortemiIndexExportSchema, getEmbedFunction, getFortemiBridge, getFortemiSecretStore, getJobQueueStatus, getKnowledgeShardContractReceipt, getKnowledgeShardProfileRegistry, getKnowledgeShardSchema, getLlmFunction, getNote, getPrefetchedSha256, handleEmbedRequests, hasFortemiSecureSecrets, importShard, importShardToRecords, isPluginScriptAllowed, isShardPrefetched, isShardSigningSupported, linkFromShard, linkToShard, linkingHandler, listNotes, manageArchive, manageAttachments, manageCapabilities, manageCollections, manageLinks, manageNote, manageTags, matchRoute, migrateLegacyBlobStore, noteFromShard, noteSkosTagToShard, noteToShard, openShard, packTarGz, parseCspReport, prefetchShard, profileSupportError, projectAttachments, projectNotes, projectRecords, provenanceEdgeToShard, queryAiwgFortemiIndex, queryAiwgHybridIndex, queryAiwgSemanticIndex, registerLlmCapability, registerSemanticCapability, registerSemanticCapabilityWorker, registerServiceWorker, restoreDbSnapshot, searchTool, selectBackend, selectLlmModel, setEmbedFunction, setLlmFunction, sha256Hex, sidecarBlobDigests, signShard, skosConceptToShard, skosRelationToShard, skosSchemeToShard, suggestTags, tagsToShard, templateToShard, titleGenerationHandler, unpackTarGz, unregisterLlmCapability, unregisterSemanticCapability, urlLinkToShard, validateAiwgFortemiChunkManifest, validateAiwgFortemiChunkPart, validateAiwgFortemiIndexExport, validateAiwgFortemiIndexExportSchema, validateAiwgFortemiProjectedRecordSchema, validateAiwgStaticEmbeddingSet, validateChecksums, validateCoreV1ShardArchive, validateFortemiCompatibilityResponse, validateFullV1ShardArchive, validateRecordV1ShardArchive, validateShardArchive, validateShardComponentRecord, validateShardManifest, verifyDbSnapshotMeta, verifyShardSignature, verifySri };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map