@evo-dev/core 0.0.1-alpha.19 → 0.0.1-alpha.20

package/dist/config/index.js

@@ -709,6 +709,40 @@ async function ensureOkfKnowledgeBase(homeDir) {
   }
   await rebuildOkfKnowledgeIndexes({ homeDir });
 }
+function normalizeKnowledgeSupportRef(value, path) {
+  const input = assertRecordValue(value, path);
+  const kind = readRequiredString(input.kind, `${path}.kind`);
+  if (kind !== "user-declaration" && kind !== "repo-policy" && kind !== "state-observation" && kind !== "verified-outcome" && kind !== "semantic-inference") {
+    throw new Error(`${path}.kind is invalid.`);
+  }
+  const observedAt = readRequiredString(input.observedAt, `${path}.observedAt`);
+  if (!Number.isFinite(Date.parse(observedAt)))
+    throw new Error(`${path}.observedAt is invalid.`);
+  const subjectFingerprint = input.subjectFingerprint === null ? null : sanitizeOkfText(readRequiredString(input.subjectFingerprint, `${path}.subjectFingerprint`));
+  return {
+    id: sanitizeOkfText(readRequiredString(input.id, `${path}.id`)),
+    kind,
+    sourceRefId: sanitizeOkfText(readRequiredString(input.sourceRefId, `${path}.sourceRefId`)),
+    subjectFingerprint,
+    observedAt: new Date(observedAt).toISOString()
+  };
+}
+function assertRecordValue(value, path) {
+  if (!isRecord(value))
+    throw new Error(`${path} must be an object.`);
+  return value;
+}
+function readRequiredString(value, path) {
+  if (!isNonEmptyString2(value))
+    throw new Error(`${path} must be a non-empty string.`);
+  return value;
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function isNonEmptyString2(value) {
+  return typeof value === "string" && value.trim() !== "";
+}
 async function rebuildOkfKnowledgeIndexes(input) {
   const paths2 = resolveOkfKnowledgePaths(input.homeDir);
   await mkdir(paths2.indexesDir, { recursive: true });
@@ -887,6 +921,7 @@ function parseOkfConceptFile(okfDir, filePath, content) {
     lifecycle: lifecycleParsed.lifecycle,
     lifecyclePersisted: lifecycleParsed.persisted,
     verificationSnapshot: parseOkfVerificationSnapshot(frontmatter),
+    supportRef: parseOkfKnowledgeSupportRef(frontmatter),
     title,
     description,
     tags,
@@ -897,6 +932,22 @@ function parseOkfConceptFile(okfDir, filePath, content) {
     body: parsed.body
   };
 }
+function parseOkfKnowledgeSupportRef(frontmatter) {
+  const block = extractNestedYamlBlock(frontmatter, "evodev", "supportRef");
+  if (block === null)
+    return null;
+  try {
+    return normalizeKnowledgeSupportRef({
+      id: readIndentedYamlScalar(block, "id"),
+      kind: readIndentedYamlScalar(block, "kind"),
+      sourceRefId: readIndentedYamlScalar(block, "sourceRefId"),
+      subjectFingerprint: readNullableLifecycleString(readIndentedYamlScalar(block, "subjectFingerprint")),
+      observedAt: readIndentedYamlScalar(block, "observedAt")
+    }, "evodev.supportRef");
+  } catch {
+    return null;
+  }
+}
 function parseOkfVerificationSnapshot(frontmatter) {
   const block = extractNestedYamlBlock(frontmatter, "evodev", "verificationSnapshot");
   if (block === null)
@@ -1386,9 +1437,9 @@ function parseHookSettings(value) {
   const defaults = createDefaultHookSettings();
   if (value === undefined || value === null)
     return defaults;
-  if (!isRecord(value))
+  if (!isRecord2(value))
     throw new Error("Invalid hooks settings; expected object.");
-  const observability = isRecord(value.observability) ? value.observability : undefined;
+  const observability = isRecord2(value.observability) ? value.observability : undefined;
   optionalBoolean2(observability?.metadataOnly, defaults.observability.metadataOnly, "hooks.observability.metadataOnly");
   optionalBoolean2(observability?.rawPayloadStorage, defaults.observability.rawPayloadStorage, "hooks.observability.rawPayloadStorage");
   return {
@@ -1409,9 +1460,9 @@ function parseHookSettings(value) {
   };
 }
 function parseHookTargetSettings(value, defaults, target) {
-  const targets = isRecord(value) ? value : {};
-  const targetSettings = isRecord(targets[target]) ? targets[target] : {};
-  const events = isRecord(targetSettings.events) ? targetSettings.events : {};
+  const targets = isRecord2(value) ? value : {};
+  const targetSettings = isRecord2(targets[target]) ? targets[target] : {};
+  const events = isRecord2(targetSettings.events) ? targetSettings.events : {};
   const parsedEvents = { ...defaults.events };
   for (const eventType of CANONICAL_HOOK_EVENT_TYPES) {
     parsedEvents[eventType] = optionalBoolean2(events[eventType], defaults.events[eventType], `hooks.targets.${target}.events.${eventType}`);
@@ -1428,7 +1479,7 @@ function optionalBoolean2(value, fallback, path) {
     throw new Error(`Invalid ${path}; expected boolean.`);
   return value;
 }
-function isRecord(value) {
+function isRecord2(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 
@@ -1974,7 +2025,7 @@ async function writeIndexIfMissingOrMigrate(filePath, kind, defaults) {
   } catch (error) {
     throw new EvoDevConfigError(`Invalid bootstrap index JSON (${describeFileError(error)})`, filePath);
   }
-  if (!isRecord2(existing) || existing.kind !== kind)
+  if (!isRecord3(existing) || existing.kind !== kind)
     return;
   const migrated = { ...defaults, ...existing };
   if (Object.keys(defaults).every((key) => (key in existing)))
@@ -2007,7 +2058,7 @@ function describeFileError(error) {
 function isNodeError(error) {
   return error instanceof Error && "code" in error;
 }
-function isRecord2(value) {
+function isRecord3(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 export {