@fortemi/core 2026.7.0 → 2026.7.1

package/README.md

@@ -126,10 +126,11 @@ Use this subpath for Pagenary-style command palettes, static docs search, and
 vanilla JavaScript review surfaces. The top-level `@fortemi/core` export remains
 available for full archive/runtime integrations.
 
-The record contract keeps the existing flat fields for filtering and search:
-`facets`, `tags`, `concepts`, `relationships`, and `provenance`. Static
-consumers that render metadata tabs can also read optional rich fields from full
-records:
+The AIWG index adapter accepts both `aiwg.fortemi.index.export.v1` and
+`aiwg.fortemi.index.export.v2` envelopes. The v1 record contract keeps the
+existing flat fields for filtering and search: `facets`, `tags`, `concepts`,
+`relationships`, and `provenance`. Static consumers that render metadata tabs
+can also read optional rich fields from full records:
 
 - `skos_concepts`: concept ids plus labels, definitions, schemes, notation, URIs,
   alternate labels, and metadata.
@@ -140,10 +141,14 @@ records:
 - `relationships[*].metadata`: optional relationship labels, confidence,
   privacy, and structured metadata.
 
-These fields are additive to `aiwg.fortemi.index.record.v1`. Existing consumers
-can ignore them and continue querying the flat fields. Chunked indexes with a
-projection keep rich metadata in detail records; call `getRecord(id)` before
-rendering a metadata panel.
+These fields are additive to `aiwg.fortemi.index.record.v1`. Version 2 records
+can also carry AIWG migration fields such as `search`, `chunks`, `embeddings`,
+`source.origin`, `source.generated`, `source.checksum`, `source.updated_at`,
+`privacy.locality`, and compatibility metadata. Query helpers use v2 `search`
+and `chunks` text when the old top-level `title`/`text` fields are absent.
+Existing consumers can ignore the v2 fields and continue querying the flat
+fields. Chunked indexes with a projection keep rich metadata in detail records;
+call `getRecord(id)` before rendering a metadata panel.
 
 Large static indexes can use the chunked browser path instead of downloading one
 full `aiwg.fortemi.index.export.v1` file. Host a manifest plus deterministic part
@@ -179,9 +184,11 @@ results, but the controller keeps only a bounded part cache and never sets a
 materialized full export in `getIndex()`.
 
 AIWG records can use project-specific string types such as `aiwg.skill`,
-`aiwg.command`, `aiwg.rule`, `aiwg.requirement`, and `research.ref`. Validation
-still enforces required record fields, but it does not require unknown AIWG,
-research, or documentation domains to collapse into `aiwg.artifact`.
+`aiwg.agent`, `aiwg.command`, `aiwg.rule`, `aiwg.flow`, `aiwg.bundle`,
+`aiwg.kb.page`, `aiwg.memory.entry`, `aiwg.issue`, `research.ref`, and
+`aiwg.research.profile`. Validation still enforces required record fields, but
+it does not require unknown AIWG, research, KB, memory, issue, or documentation
+domains to collapse into `aiwg.artifact`.
 
 For AIWG command-palette parity, opt into discovery ranking instead of the
 default deterministic substring lookup:
@@ -203,14 +210,19 @@ Chunked indexes also support graph navigation without loading a full export:
 const neighbors = await controller.neighbors('aiwg:requirement:search', {
   direction: 'both',
   relationshipType: 'cites',
+  relationshipDirection: 'downstream',
 })
 
 const graph = await controller.toCommunityGraphChunked()
 ```
 
-When scan parts are projected, relationship traversal scans the parts and
-lazy-loads detail records only when relationships are not present in the scan
-projection.
+Relationship edges preserve v2 `source_path`, `target_path`, and
+`direction: 'upstream' | 'downstream' | 'related'` values. Use
+`direction: 'in' | 'out' | 'both'` for graph orientation around a node and
+`relationshipDirection` for AIWG dependency/citation/profile/KB direction
+semantics. When scan parts are projected, relationship traversal scans the parts
+and lazy-loads detail records only when relationships are not present in the
+scan projection.
 
 Static semantic search uses an optional sidecar contract:
 
@@ -281,11 +293,11 @@ pnpm add @fortemi/react @fortemi/core react
 
 ## Documentation
 
-- [Repository API](https://github.com/Fortemi/fortemi-react/blob/main/docs/api-reference.md#repositories)
-- [Integration guide](https://github.com/Fortemi/fortemi-react/blob/main/docs/integration.md)
-- [Search guide](https://github.com/Fortemi/fortemi-react/blob/main/docs/search.md)
-- [Extending Fortemi](https://github.com/Fortemi/fortemi-react/blob/main/docs/extending.md)
-- [Supply-chain controls](https://github.com/Fortemi/fortemi-react/blob/main/docs/security/supply-chain.md)
+- [Repository API](https://github.com/Fortemi/fortemi-react/blob/main/docs/content/api-reference.md#repositories)
+- [Integration guide](https://github.com/Fortemi/fortemi-react/blob/main/docs/content/guides/integration.md)
+- [Search guide](https://github.com/Fortemi/fortemi-react/blob/main/docs/content/guides/search.md)
+- [Extending Fortemi](https://github.com/Fortemi/fortemi-react/blob/main/docs/content/advanced/extending.md)
+- [Supply-chain controls](https://github.com/Fortemi/fortemi-react/blob/main/docs/content/security/supply-chain.md)
 
 ## License
 

package/dist/aiwg-index.d.ts

@@ -1,17 +1,26 @@
 type AiwgFortemiKnownRecordType = 'crm.contact' | 'crm.organization' | 'crm.event' | 'crm.interaction' | 'aiwg.artifact' | 'docs.page';
 type AiwgFortemiRecordType = AiwgFortemiKnownRecordType | `aiwg.${string}` | `research.${string}` | `docs.${string}` | string;
+type AiwgFortemiRecordSchemaVersion = 'aiwg.fortemi.index.record.v1' | 'aiwg.fortemi.index.record.v2';
+type AiwgFortemiIndexExportSchemaVersion = 'aiwg.fortemi.index.export.v1' | 'aiwg.fortemi.index.export.v2';
 type AiwgPrivacyClassification = 'private' | 'sanitized' | 'public';
 type AiwgProvenanceConfidence = 'source' | 'candidate' | 'reviewed' | 'rejected';
 type AiwgReviewAction = 'accept' | 'reject' | 'defer';
+type AiwgFortemiRelationshipDirection = 'upstream' | 'downstream' | 'related';
 interface AiwgFortemiRecordSource {
     path: string;
     repo_relative_path: string;
     locator: string;
+    origin?: string;
+    generated?: boolean;
+    checksum?: string;
+    updated_at?: string;
 }
 interface AiwgFortemiRelationship {
     type: string;
     target_id: string;
     source_path?: string;
+    target_path?: string;
+    direction?: AiwgFortemiRelationshipDirection;
     label?: string;
     confidence?: number;
     privacy?: AiwgPrivacyClassification;
@@ -54,18 +63,53 @@ interface AiwgFortemiProvenanceEvent {
     privacy?: AiwgPrivacyClassification;
     attributes?: Record<string, unknown>;
 }
+interface AiwgFortemiSearchProjection {
+    title?: string;
+    name?: string;
+    summary?: string;
+    body?: string;
+    triggers?: string[];
+    aliases?: string[];
+    capability?: string;
+    tags?: string[];
+    phase?: string;
+    type?: string;
+    frontmatter?: Record<string, unknown>;
+}
+interface AiwgFortemiChunk {
+    id?: string;
+    text?: string;
+    body?: string;
+    summary?: string;
+    source_path?: string;
+    metadata?: Record<string, unknown>;
+}
+interface AiwgFortemiRecordEmbedding {
+    id?: string;
+    embedding?: number[];
+    vector?: number[];
+    model?: string;
+    granularity?: string;
+    input_hash?: string;
+    source_path?: string;
+    metadata?: Record<string, unknown>;
+}
 interface AiwgFortemiRecord {
-    schema_version: 'aiwg.fortemi.index.record.v1';
+    schema_version: AiwgFortemiRecordSchemaVersion;
     id: string;
     type: AiwgFortemiRecordType;
     source: AiwgFortemiRecordSource;
-    title: string;
-    text: string;
+    title?: string;
+    text?: string;
     facets: Record<string, string[]>;
     tags: string[];
     concepts: string[];
     relationships: AiwgFortemiRelationship[];
     provenance: AiwgFortemiProvenance[];
+    search?: AiwgFortemiSearchProjection;
+    chunks?: AiwgFortemiChunk[];
+    embeddings?: AiwgFortemiRecordEmbedding[];
+    compatibility?: Record<string, unknown>;
     /** Optional rich SKOS metadata for static consumers that need labels/definitions without opening a shard. */
     skos_concepts?: AiwgFortemiSkosConcept[];
     /** Optional SKOS relationship edges among concepts referenced by this record. */
@@ -75,17 +119,23 @@ interface AiwgFortemiRecord {
     privacy: {
         classification: AiwgPrivacyClassification;
         pii: boolean;
+        locality?: string;
     };
     updated_at: string;
 }
 interface AiwgFortemiIndexExport {
-    schema_version: 'aiwg.fortemi.index.export.v1';
+    schema_version: AiwgFortemiIndexExportSchemaVersion;
     generated_at: string;
     source: {
         repo: string;
         privacy: AiwgPrivacyClassification;
+        origin?: string;
+        generated?: boolean;
+        checksum?: string;
+        updated_at?: string;
     };
     items: AiwgFortemiRecord[];
+    compatibility?: Record<string, unknown>;
 }
 interface AiwgFortemiChunkPartRef {
     href: string;
@@ -215,6 +265,7 @@ type AiwgRelationshipSetOperation = 'intersection' | 'union' | 'difference';
 interface AiwgRelationshipTraversalOptions {
     direction?: AiwgRelationshipDirection;
     relationshipType?: string;
+    relationshipDirection?: AiwgFortemiRelationshipDirection;
     limit?: number;
 }
 interface AiwgRelationshipQueryOptions extends AiwgRelationshipTraversalOptions {
@@ -227,6 +278,8 @@ interface AiwgRelationshipEdgeSummary {
     target_id: string;
     type: string;
     source_path?: string;
+    target_path?: string;
+    direction?: AiwgFortemiRelationshipDirection;
 }
 interface AiwgRelationshipNodeSummary {
     id: string;
@@ -381,4 +434,4 @@ declare function aiwgFortemiIndexToCommunityGraph(index: AiwgFortemiIndexExport,
     }[];
 };
 
-export { AIWG_SCAN_REQUIRED_FIELDS, type AiwgChunkedIndexBuildOptions, type AiwgChunkedIndexBuildResult, type AiwgChunkedIndexDetailLoader, type AiwgChunkedIndexLoadOptions, type AiwgChunkedIndexLoader, type AiwgChunkedIndexProgress, type AiwgChunkedIndexProgressPhase, type AiwgChunkedIndexQueryOptions, type AiwgChunkedIndexQueryResult, type AiwgChunkedIndexValidationResult, type AiwgDetailIdEncoding, type AiwgFortemiChunkDetailRef, type AiwgFortemiChunkManifest, type AiwgFortemiChunkPart, type AiwgFortemiChunkPartRef, type AiwgFortemiIndexExport, type AiwgFortemiKnownRecordType, type AiwgFortemiProjectedRecord, type AiwgFortemiProvenance, type AiwgFortemiProvenanceEvent, type AiwgFortemiRecord, type AiwgFortemiRecordSource, type AiwgFortemiRecordType, type AiwgFortemiRelationship, type AiwgFortemiSkosConcept, type AiwgFortemiSkosRelation, type AiwgFortemiSkosRelationType, type AiwgIndexController, type AiwgIndexControllerListener, type AiwgIndexControllerSnapshot, type AiwgIndexGraphOptions, type AiwgIndexQueryMatch, type AiwgIndexQueryOptions, type AiwgIndexQueryRankedItem, type AiwgIndexQueryResult, type AiwgIndexQueryWeights, type AiwgIndexValidationResult, type AiwgPrivacyClassification, type AiwgProvenanceConfidence, type AiwgRelationshipDirection, type AiwgRelationshipEdgeSummary, type AiwgRelationshipNodeSummary, type AiwgRelationshipQueryOptions, type AiwgRelationshipSetOperation, type AiwgRelationshipSetOptions, type AiwgRelationshipSetResult, type AiwgRelationshipTraversalOptions, type AiwgRelationshipTraversalResult, type AiwgReviewAction, type AiwgReviewDecision, type AiwgReviewDecisionExport, type AiwgReviewInput, type AiwgStaticDuplicatePair, type AiwgStaticEmbeddingRecord, type AiwgStaticEmbeddingSet, type AiwgStaticHybridQueryOptions, type AiwgStaticSemanticQueryOptions, type AiwgStaticSemanticResult, aiwgDetailHrefForId, aiwgFortemiIndexToCommunityGraph, assertAiwgFortemiChunkManifest, assertAiwgFortemiChunkPart, assertAiwgFortemiIndexExport, assertAiwgStaticEmbeddingSet, buildAiwgChunkedIndex, createAiwgFetchChunkLoader, createAiwgFetchDetailLoader, createAiwgIndexController, createAiwgReviewDecisionExport, encodeAiwgDetailId, findAiwgStaticDuplicatePairs, getAiwgFortemiFacets, queryAiwgFortemiIndex, queryAiwgHybridIndex, queryAiwgSemanticIndex, validateAiwgFortemiChunkManifest, validateAiwgFortemiChunkPart, validateAiwgFortemiIndexExport, validateAiwgStaticEmbeddingSet };
+export { AIWG_SCAN_REQUIRED_FIELDS, type AiwgChunkedIndexBuildOptions, type AiwgChunkedIndexBuildResult, type AiwgChunkedIndexDetailLoader, type AiwgChunkedIndexLoadOptions, type AiwgChunkedIndexLoader, type AiwgChunkedIndexProgress, type AiwgChunkedIndexProgressPhase, type AiwgChunkedIndexQueryOptions, type AiwgChunkedIndexQueryResult, type AiwgChunkedIndexValidationResult, type AiwgDetailIdEncoding, type AiwgFortemiChunk, type AiwgFortemiChunkDetailRef, type AiwgFortemiChunkManifest, type AiwgFortemiChunkPart, type AiwgFortemiChunkPartRef, type AiwgFortemiIndexExport, type AiwgFortemiIndexExportSchemaVersion, type AiwgFortemiKnownRecordType, type AiwgFortemiProjectedRecord, type AiwgFortemiProvenance, type AiwgFortemiProvenanceEvent, type AiwgFortemiRecord, type AiwgFortemiRecordEmbedding, type AiwgFortemiRecordSchemaVersion, type AiwgFortemiRecordSource, type AiwgFortemiRecordType, type AiwgFortemiRelationship, type AiwgFortemiRelationshipDirection, type AiwgFortemiSearchProjection, type AiwgFortemiSkosConcept, type AiwgFortemiSkosRelation, type AiwgFortemiSkosRelationType, type AiwgIndexController, type AiwgIndexControllerListener, type AiwgIndexControllerSnapshot, type AiwgIndexGraphOptions, type AiwgIndexQueryMatch, type AiwgIndexQueryOptions, type AiwgIndexQueryRankedItem, type AiwgIndexQueryResult, type AiwgIndexQueryWeights, type AiwgIndexValidationResult, type AiwgPrivacyClassification, type AiwgProvenanceConfidence, type AiwgRelationshipDirection, type AiwgRelationshipEdgeSummary, type AiwgRelationshipNodeSummary, type AiwgRelationshipQueryOptions, type AiwgRelationshipSetOperation, type AiwgRelationshipSetOptions, type AiwgRelationshipSetResult, type AiwgRelationshipTraversalOptions, type AiwgRelationshipTraversalResult, type AiwgReviewAction, type AiwgReviewDecision, type AiwgReviewDecisionExport, type AiwgReviewInput, type AiwgStaticDuplicatePair, type AiwgStaticEmbeddingRecord, type AiwgStaticEmbeddingSet, type AiwgStaticHybridQueryOptions, type AiwgStaticSemanticQueryOptions, type AiwgStaticSemanticResult, aiwgDetailHrefForId, aiwgFortemiIndexToCommunityGraph, assertAiwgFortemiChunkManifest, assertAiwgFortemiChunkPart, assertAiwgFortemiIndexExport, assertAiwgStaticEmbeddingSet, buildAiwgChunkedIndex, createAiwgFetchChunkLoader, createAiwgFetchDetailLoader, createAiwgIndexController, createAiwgReviewDecisionExport, encodeAiwgDetailId, findAiwgStaticDuplicatePairs, getAiwgFortemiFacets, queryAiwgFortemiIndex, queryAiwgHybridIndex, queryAiwgSemanticIndex, validateAiwgFortemiChunkManifest, validateAiwgFortemiChunkPart, validateAiwgFortemiIndexExport, validateAiwgStaticEmbeddingSet };

package/dist/aiwg-index.js

@@ -15,8 +15,6 @@ var REQUIRED_RECORD_FIELDS = [
   "id",
   "type",
   "source",
-  "title",
-  "text",
   "facets",
   "tags",
   "concepts",
@@ -57,6 +55,12 @@ function isPlainRecord(value) {
 function isOptionalStringArray(value) {
   return value === void 0 || Array.isArray(value) && value.every((item) => typeof item === "string");
 }
+function isSupportedIndexSchemaVersion(value) {
+  return value === "aiwg.fortemi.index.export.v1" || value === "aiwg.fortemi.index.export.v2";
+}
+function isSupportedRecordSchemaVersion(value) {
+  return value === "aiwg.fortemi.index.record.v1" || value === "aiwg.fortemi.index.record.v2";
+}
 function validateOptionalRichMetadata(item, index, errors) {
   if (item.skos_concepts !== void 0) {
     if (!Array.isArray(item.skos_concepts)) {
@@ -103,28 +107,80 @@ function validateOptionalRichMetadata(item, index, errors) {
       if (relationship.metadata !== void 0 && !isPlainRecord(relationship.metadata)) {
         errors.push("items[" + index + "].relationships[" + relationshipIndex + "].metadata must be an object");
       }
+      if (relationship.direction !== void 0 && relationship.direction !== "upstream" && relationship.direction !== "downstream" && relationship.direction !== "related") {
+        errors.push("items[" + index + "].relationships[" + relationshipIndex + "].direction must be upstream, downstream, or related");
+      }
+      if (relationship.target_path !== void 0 && typeof relationship.target_path !== "string") {
+        errors.push("items[" + index + "].relationships[" + relationshipIndex + "].target_path must be a string");
+      }
+    }
+  }
+  if (item.search !== void 0) {
+    if (!isPlainRecord(item.search)) {
+      errors.push("items[" + index + "].search must be an object");
+    } else {
+      if (!isOptionalStringArray(item.search.triggers)) errors.push("items[" + index + "].search.triggers must be a string array");
+      if (!isOptionalStringArray(item.search.aliases)) errors.push("items[" + index + "].search.aliases must be a string array");
+      if (!isOptionalStringArray(item.search.tags)) errors.push("items[" + index + "].search.tags must be a string array");
+      if (item.search.frontmatter !== void 0 && !isPlainRecord(item.search.frontmatter)) {
+        errors.push("items[" + index + "].search.frontmatter must be an object");
+      }
+    }
+  }
+  if (item.chunks !== void 0) {
+    if (!Array.isArray(item.chunks)) {
+      errors.push("items[" + index + "].chunks must be an array when present");
+    } else {
+      for (const [chunkIndex, chunk] of item.chunks.entries()) {
+        if (!isPlainRecord(chunk)) errors.push("items[" + index + "].chunks[" + chunkIndex + "] must be an object");
+        if (chunk.metadata !== void 0 && !isPlainRecord(chunk.metadata)) {
+          errors.push("items[" + index + "].chunks[" + chunkIndex + "].metadata must be an object");
+        }
+      }
+    }
+  }
+  if (item.embeddings !== void 0) {
+    if (!Array.isArray(item.embeddings)) {
+      errors.push("items[" + index + "].embeddings must be an array when present");
+    } else {
+      for (const [embeddingIndex, embedding] of item.embeddings.entries()) {
+        if (!isPlainRecord(embedding)) errors.push("items[" + index + "].embeddings[" + embeddingIndex + "] must be an object");
+        const vector = embedding.embedding ?? embedding.vector;
+        if (vector !== void 0 && (!Array.isArray(vector) || !vector.every((entry) => typeof entry === "number"))) {
+          errors.push("items[" + index + "].embeddings[" + embeddingIndex + "].embedding/vector must be a number array");
+        }
+        if (embedding.metadata !== void 0 && !isPlainRecord(embedding.metadata)) {
+          errors.push("items[" + index + "].embeddings[" + embeddingIndex + "].metadata must be an object");
+        }
+      }
     }
   }
+  if (item.compatibility !== void 0 && !isPlainRecord(item.compatibility)) {
+    errors.push("items[" + index + "].compatibility must be an object");
+  }
 }
 function validateAiwgFortemiIndexExport(value) {
   const errors = [];
   const counts = {};
   const data = value;
-  if (data?.schema_version !== "aiwg.fortemi.index.export.v1") {
-    errors.push("schema_version must be aiwg.fortemi.index.export.v1");
+  if (!isSupportedIndexSchemaVersion(data?.schema_version)) {
+    errors.push("schema_version must be aiwg.fortemi.index.export.v1 or aiwg.fortemi.index.export.v2");
   }
   if (!hasString(data?.generated_at)) errors.push("generated_at is required");
   if (!hasString(data?.source?.repo)) errors.push("source.repo is required");
   if (!hasString(data?.source?.privacy)) errors.push("source.privacy is required");
   if (!Array.isArray(data?.items)) errors.push("items must be an array");
+  if (data.compatibility !== void 0 && !isPlainRecord(data.compatibility)) {
+    errors.push("compatibility must be an object");
+  }
   const ids = /* @__PURE__ */ new Set();
   let previousId = "";
   for (const [index, item] of (data.items ?? []).entries()) {
     for (const field of REQUIRED_RECORD_FIELDS) {
       if (!(field in item)) errors.push("items[" + index + "]." + field + " is required");
     }
-    if (item.schema_version !== "aiwg.fortemi.index.record.v1") {
-      errors.push("items[" + index + "].schema_version must be aiwg.fortemi.index.record.v1");
+    if (!isSupportedRecordSchemaVersion(item.schema_version)) {
+      errors.push("items[" + index + "].schema_version must be aiwg.fortemi.index.record.v1 or aiwg.fortemi.index.record.v2");
     }
     if (!hasString(item.id)) errors.push("items[" + index + "].id is required");
     if (hasString(item.id) && ids.has(item.id)) errors.push("duplicate id: " + item.id);
@@ -138,6 +194,12 @@ function validateAiwgFortemiIndexExport(value) {
     if (!hasString(item.source?.path)) errors.push("items[" + index + "].source.path is required");
     if (!hasString(item.source?.repo_relative_path)) errors.push("items[" + index + "].source.repo_relative_path is required");
     if (!hasString(item.source?.locator)) errors.push("items[" + index + "].source.locator is required");
+    if (typeof item.title !== "string" && typeof item.search?.title !== "string" && typeof item.search?.name !== "string") {
+      errors.push("items[" + index + "].title or search.title/search.name is required");
+    }
+    if (typeof item.text !== "string" && typeof item.search?.body !== "string" && typeof item.search?.summary !== "string") {
+      errors.push("items[" + index + "].text or search.body/search.summary is required");
+    }
     if (!Array.isArray(item.tags)) errors.push("items[" + index + "].tags must be an array");
     if (!Array.isArray(item.concepts)) errors.push("items[" + index + "].concepts must be an array");
     if (!Array.isArray(item.relationships)) errors.push("items[" + index + "].relationships must be an array");
@@ -218,8 +280,8 @@ function validateProjectedRecords(items) {
   const ids = /* @__PURE__ */ new Set();
   let previousId = "";
   for (const [index, item] of items.entries()) {
-    if (item.schema_version !== "aiwg.fortemi.index.record.v1") {
-      errors.push("items[" + index + "].schema_version must be aiwg.fortemi.index.record.v1");
+    if (!isSupportedRecordSchemaVersion(item.schema_version)) {
+      errors.push("items[" + index + "].schema_version must be aiwg.fortemi.index.record.v1 or aiwg.fortemi.index.record.v2");
     }
     if (!hasString(item.id)) errors.push("items[" + index + "].id is required");
     if (hasString(item.id) && ids.has(item.id)) errors.push("duplicate id: " + item.id);
@@ -229,8 +291,12 @@ function validateProjectedRecords(items) {
     }
     if (hasString(item.id)) previousId = item.id;
     if (!hasString(item.type)) errors.push("items[" + index + "].type must be a non-empty string");
-    if (!hasString(item.title)) errors.push("items[" + index + "].title is required");
-    if (typeof item.text !== "string") errors.push("items[" + index + "].text is required");
+    if (typeof item.title !== "string" && typeof item.search?.title !== "string" && typeof item.search?.name !== "string") {
+      errors.push("items[" + index + "].title or search.title/search.name is required");
+    }
+    if (typeof item.text !== "string" && typeof item.search?.body !== "string" && typeof item.search?.summary !== "string") {
+      errors.push("items[" + index + "].text or search.body/search.summary is required");
+    }
     if (!item.facets || typeof item.facets !== "object" || Array.isArray(item.facets)) {
       errors.push("items[" + index + "].facets must be an object");
     }
@@ -322,6 +388,38 @@ function getAiwgFortemiFacets(items) {
   }
   return result;
 }
+function recordTitle(item) {
+  return item.title ?? item.search?.title ?? item.search?.name ?? item.id;
+}
+function recordText(item) {
+  return item.text ?? item.search?.body ?? item.search?.summary ?? item.chunks?.map((chunk) => chunk.text ?? chunk.body ?? chunk.summary ?? "").filter(Boolean).join("\n") ?? "";
+}
+function recordSearchValues(item) {
+  const search = item.search;
+  const values = [
+    item.id,
+    recordTitle(item),
+    recordText(item),
+    search?.title,
+    search?.name,
+    search?.summary,
+    search?.body,
+    search?.capability,
+    search?.phase,
+    search?.type,
+    ...search?.triggers ?? [],
+    ...search?.aliases ?? [],
+    ...search?.tags ?? [],
+    ...(item.chunks ?? []).flatMap((chunk) => [chunk.text, chunk.body, chunk.summary, chunk.source_path])
+  ];
+  if (search?.frontmatter) {
+    for (const value of Object.values(search.frontmatter)) {
+      if (typeof value === "string") values.push(value);
+      else if (Array.isArray(value)) values.push(...value.filter((entry) => typeof entry === "string"));
+    }
+  }
+  return values.filter((value) => typeof value === "string" && value.length > 0);
+}
 function buildAiwgChunkedIndex(index, options = {}) {
   const partSize = hasPositiveInteger(options.partSize) ? options.partSize : 500;
   const projection = options.projection;
@@ -383,14 +481,21 @@ function matchesFacetFilters(item, filters) {
 function queryMatches(item, q) {
   if (!q) return [];
   const matches = [];
-  if (item.title.toLowerCase().includes(q)) matches.push({ field: "title", value: item.title });
-  if (item.text.toLowerCase().includes(q)) matches.push({ field: "text", value: item.text });
+  const title = recordTitle(item);
+  const text = recordText(item);
+  if (title.toLowerCase().includes(q)) matches.push({ field: "title", value: title });
+  if (text.toLowerCase().includes(q)) matches.push({ field: "text", value: text });
   for (const tag of item.tags) {
     if (tag.toLowerCase().includes(q)) matches.push({ field: "tag", value: tag });
   }
   for (const concept of item.concepts) {
     if (concept.toLowerCase().includes(q)) matches.push({ field: "concept", value: concept });
   }
+  for (const value of recordSearchValues(item)) {
+    if (value !== title && value !== text && value.toLowerCase().includes(q)) {
+      matches.push({ field: "text", value, score: DEFAULT_QUERY_WEIGHTS.text });
+    }
+  }
   return matches;
 }
 var DISCOVERY_STOPWORDS = /* @__PURE__ */ new Set([
@@ -446,17 +551,28 @@ function discoveryMatches(item, query) {
   const idParts = item.id.split(/[:/]/);
   const names = [
     item.id,
-    item.title,
+    recordTitle(item),
+    item.search?.name,
+    item.search?.title,
+    ...item.search?.aliases ?? [],
     ...idParts,
     ...facetValues(item, ["name", "canonical_name", "command", "skill", "agent", "rule"])
-  ].filter(Boolean);
-  const triggers = facetValues(item, ["trigger", "triggers", "trigger_phrase", "trigger_phrases"]);
+  ].filter((value) => hasString(value));
+  const triggers = [
+    ...facetValues(item, ["trigger", "triggers", "trigger_phrase", "trigger_phrases"]),
+    ...item.search?.triggers ?? []
+  ];
   const capabilities = [
     ...facetValues(item, ["capability", "capabilities", "summary", "description"]),
+    item.search?.capability,
+    item.search?.summary,
+    item.search?.phase,
+    item.search?.type,
+    ...item.search?.tags ?? [],
     ...item.concepts,
     ...item.tags
-  ];
-  const sourceValues = [item.source?.path, item.source?.repo_relative_path, item.source?.locator].filter(Boolean);
+  ].filter((value) => hasString(value));
+  const sourceValues = [item.source?.path, item.source?.repo_relative_path, item.source?.locator].filter((value) => hasString(value));
   for (const name of names) {
     const canonicalName = canonicalDiscoveryName(name);
     if (!canonicalName) continue;
@@ -466,8 +582,9 @@ function discoveryMatches(item, query) {
       addDiscoveryMatch(matches, { field: "id", value: name, score: 48, reason: "near canonical name" });
     }
   }
-  const titleOverlap = tokenOverlapScore(tokens, item.title);
-  if (titleOverlap > 0) addDiscoveryMatch(matches, { field: "title", value: item.title, score: 18 * titleOverlap, reason: "title token overlap" });
+  const title = recordTitle(item);
+  const titleOverlap = tokenOverlapScore(tokens, title);
+  if (titleOverlap > 0) addDiscoveryMatch(matches, { field: "title", value: title, score: 18 * titleOverlap, reason: "title token overlap" });
   for (const trigger of triggers) {
     const overlap = tokenOverlapScore(tokens, trigger);
     if (overlap > 0) addDiscoveryMatch(matches, { field: "facet", value: trigger, score: 34 * overlap, reason: "trigger phrase" });
@@ -476,8 +593,9 @@ function discoveryMatches(item, query) {
     const overlap = tokenOverlapScore(tokens, capability);
     if (overlap > 0) addDiscoveryMatch(matches, { field: "concept", value: capability, score: 22 * overlap, reason: "capability overlap" });
   }
-  const textOverlap = tokenOverlapScore(tokens, item.text);
-  if (textOverlap > 0) addDiscoveryMatch(matches, { field: "text", value: item.text, score: 8 * textOverlap, reason: "body token overlap" });
+  const text = recordText(item);
+  const textOverlap = tokenOverlapScore(tokens, text);
+  if (textOverlap > 0) addDiscoveryMatch(matches, { field: "text", value: text, score: 8 * textOverlap, reason: "body token overlap" });
   for (const source of sourceValues) {
     const overlap = tokenOverlapScore(tokens, source);
     if (overlap > 0) addDiscoveryMatch(matches, { field: "source", value: source, score: 2 * overlap, reason: "path overlap" });
@@ -505,7 +623,7 @@ function createSnippet(item, matches, q, maxLength) {
   const textMatch = matches.find((match) => match.field === "text");
   const titleMatch = matches.find((match) => match.field === "title");
   const firstMatch = textMatch ?? titleMatch ?? matches[0];
-  return clipSnippet(firstMatch?.value ?? item.text, q, maxLength);
+  return clipSnippet(firstMatch?.value ?? recordText(item), q, maxLength);
 }
 function createRankedEntries(items, q, options, ordinalBase = 0) {
   const weights = { ...DEFAULT_QUERY_WEIGHTS, ...options.weights };
@@ -767,13 +885,16 @@ function edgeFromRelationship(sourceId, relationship) {
     source_id: sourceId,
     target_id: relationship.target_id,
     type: relationship.type,
-    ...relationship.source_path ? { source_path: relationship.source_path } : {}
+    ...relationship.source_path ? { source_path: relationship.source_path } : {},
+    ...relationship.target_path ? { target_path: relationship.target_path } : {},
+    ...relationship.direction ? { direction: relationship.direction } : {}
   };
 }
 function relationshipMatches(edge, options = {}) {
   const type = relationshipTypeFilter(options);
   const direction = options.direction ?? "both";
   if (type && edge.type !== type) return false;
+  if (options.relationshipDirection && edge.direction !== options.relationshipDirection) return false;
   if (options.sourceId && edge.source_id !== options.sourceId) return false;
   if (options.targetId && edge.target_id !== options.targetId) return false;
   if (direction === "out" && options.targetId && edge.target_id !== options.targetId) return false;
@@ -781,7 +902,7 @@ function relationshipMatches(edge, options = {}) {
   return true;
 }
 function nodeSummary(item) {
-  return { id: item.id, type: item.type, title: item.title };
+  return { id: item.id, type: item.type, title: recordTitle(item) };
 }
 function addNode(nodes, item) {
   if (item) nodes.set(item.id, nodeSummary(item));