@equationalapplications/core-okf 4.13.1 → 4.15.1

package/README.md

@@ -1,3 +1,74 @@
 # @equationalapplications/core-okf
 
-Zero-dependency primitives for producing [Open Knowledge Format](https://github.com/GoogleCloudPlatform/knowledge-catalog/blob/main/okf/SPEC.md) (OKF v0.1) bundles: YAML frontmatter serialization, concept document assembly, and `index.md`/`log.md` builders. No knowledge of any specific data model — bring your own mapping from your domain objects to `OkfFrontmatter` + body strings.
+[![npm version](https://img.shields.io/npm/v/%40equationalapplications%2Fcore-okf?label=core-okf)](https://www.npmjs.com/package/@equationalapplications/core-okf) [![npm downloads](https://img.shields.io/npm/dm/%40equationalapplications%2Fcore-okf?label=downloads)](https://www.npmjs.com/package/@equationalapplications/core-okf)
+
+## Overview
+
+A zero-dependency library for parsing and producing [Open Knowledge Format (OKF) v0.1](https://github.com/GoogleCloudPlatform/knowledge-catalog/tree/main/okf) bundles. This package provides the raw primitives to work with OKF frontmatter, concept documents, and index/log files, completely decoupled from any specific database or data model.
+
+For a ready-made `MemoryDump` ⇄ OKF bundle adapter, see the [OKF Import/Export section in `@equationalapplications/core-llm-wiki`](https://github.com/equationalapplications/expo-llm-wiki/blob/main/packages/core/README.md#okf-importexport).
+
+## Installation
+
+```bash
+npm install @equationalapplications/core-okf
+```
+
+## API Reference
+
+### `serializeFrontmatter` / `parseFrontmatter`
+
+Produces and parses YAML frontmatter for OKF concept documents.
+
+```typescript
+const yaml = serializeFrontmatter({ type: 'fact', id: 'fact_123' });
+const { frontmatter, rest } = parseFrontmatter(fileContent);
+```
+
+### `buildConceptDocument` / `parseConcept`
+
+Combines frontmatter and markdown body into a single string, or splits an existing OKF file into its component parts.
+
+```typescript
+const markdown = buildConceptDocument({ type: 'task', id: 'task_1' }, '# Buy groceries');
+const { frontmatter, body } = parseConcept(markdown);
+```
+
+### `buildIndexMd` / `buildRootIndexMd`
+
+Generates directory index lists or root OKF catalog manifests.
+
+```typescript
+const sections = [{ heading: 'Facts', entries: [{ path: 'facts/fact_123.md', title: 'Fact 123' }] }];
+const dirIndex = buildIndexMd(sections);
+const rootIndex = buildRootIndexMd('0.1', sections);
+```
+
+### `buildLogMd` / `parseLogMd`
+
+Serializes chronological append-only events or parses them back into discrete entries.
+
+```typescript
+const log = buildLogMd([{ date: '2026-06-23', text: 'Observation made' }]);
+const events = parseLogMd(logContent);
+```
+
+### `extractMarkdownLinks`
+
+Parses relative markdown cross-links to map knowledge graph edges.
+
+```typescript
+const links = extractMarkdownLinks('See [preferences](facts/fact_abc.md) for more.');
+// links: [{ text: 'preferences', path: 'facts/fact_abc.md' }]
+```
+
+## Monorepo Ecosystem
+
+| Package | Purpose |
+| --- | --- |
+| [@equationalapplications/core-llm-wiki](https://github.com/equationalapplications/expo-llm-wiki/blob/main/packages/core/README.md) | Persistent episodic memory |
+| [@equationalapplications/expo-llm-wiki](https://github.com/equationalapplications/expo-llm-wiki/blob/main/packages/expo/README.md) | Persistent episodic memory for Expo/React Native |
+| [@equationalapplications/react-llm-wiki](https://github.com/equationalapplications/expo-llm-wiki/blob/main/packages/react/README.md) | Persistent episodic memory for Web |
+| [@equationalapplications/prisma-outbox](https://github.com/equationalapplications/expo-llm-wiki/blob/main/packages/prisma-outbox/README.md) | Sync SQLite outbox events to Prisma |
+| [@equationalapplications/core-llm-tools](https://github.com/equationalapplications/expo-llm-wiki/blob/main/packages/core-llm-tools/README.md) | Gemini tool schemas and capability injector |
+| **@equationalapplications/core-okf** | Zero-dependency Open Knowledge Format (OKF) v0.1 primitives — parse and produce interoperable knowledge bundles. |

package/dist/index.d.mts

@@ -26,14 +26,52 @@ interface OkfFile {
     path: string;
     content: string;
 }
+interface OkfMarkdownLink {
+    text: string;
+    path: string;
+}
 
 declare function serializeFrontmatter(fm: OkfFrontmatter): string;
+/**
+ * Parses the subset of YAML frontmatter that {@link serializeFrontmatter} produces:
+ * scalar string/number/boolean/null values, quoted strings, and block string-lists.
+ * NOT a general YAML parser — flow collections (`[...]`/`{...}`), multi-line block
+ * scalars (`|`/`>`), anchors, and aliases are not recognized. Lines that don't match
+ * a recognized shape are silently skipped rather than throwing, so a foreign bundle
+ * never crashes
+ * the import — it just loses fidelity on the unrecognized line.
+ */
+declare function parseFrontmatter(content: string): {
+    frontmatter: OkfFrontmatter;
+    rest: string;
+};
 
 declare function buildConceptDocument(fm: OkfFrontmatter, body: string): string;
+/** Reverse of {@link buildConceptDocument}: strips the single leading blank-line separator. */
+declare function parseConcept(content: string): {
+    frontmatter: OkfFrontmatter;
+    body: string;
+};
 
 declare function buildIndexMd(sections: OkfIndexSection[]): string;
 declare function buildRootIndexMd(okfVersion: string, sections: OkfIndexSection[]): string;
 
 declare function buildLogMd(entries: OkfLogEntry[]): string;
+/**
+ * Reverse of {@link buildLogMd}. Best-effort: lines that don't match the exact
+ * `## YYYY-MM-DD` heading or `- text` bullet shape buildLogMd emits are skipped,
+ * not thrown — a foreign log.md in a different format degrades to fewer entries
+ * rather than failing the import.
+ */
+declare function parseLogMd(content: string): OkfLogEntry[];
+
+/**
+ * Extracts inline markdown links (`[text](path)`) from a concept body.
+ * Single-line regex, not a CommonMark parser — reference-style links, links
+ * split across lines, and links inside code fences are not recognized.
+ * `http(s):` and `mailto:` targets are excluded; only relative/local paths
+ * are candidates for graph edges.
+ */
+declare function extractMarkdownLinks(body: string): OkfMarkdownLink[];
 
-export { type OkfFile, type OkfFrontmatter, type OkfIndexEntry, type OkfIndexSection, type OkfLogEntry, buildConceptDocument, buildIndexMd, buildLogMd, buildRootIndexMd, serializeFrontmatter };
+export { type OkfFile, type OkfFrontmatter, type OkfFrontmatterScalar, type OkfFrontmatterValue, type OkfIndexEntry, type OkfIndexSection, type OkfLogEntry, type OkfMarkdownLink, buildConceptDocument, buildIndexMd, buildLogMd, buildRootIndexMd, extractMarkdownLinks, parseConcept, parseFrontmatter, parseLogMd, serializeFrontmatter };

package/dist/index.d.ts

@@ -26,14 +26,52 @@ interface OkfFile {
     path: string;
     content: string;
 }
+interface OkfMarkdownLink {
+    text: string;
+    path: string;
+}
 
 declare function serializeFrontmatter(fm: OkfFrontmatter): string;
+/**
+ * Parses the subset of YAML frontmatter that {@link serializeFrontmatter} produces:
+ * scalar string/number/boolean/null values, quoted strings, and block string-lists.
+ * NOT a general YAML parser — flow collections (`[...]`/`{...}`), multi-line block
+ * scalars (`|`/`>`), anchors, and aliases are not recognized. Lines that don't match
+ * a recognized shape are silently skipped rather than throwing, so a foreign bundle
+ * never crashes
+ * the import — it just loses fidelity on the unrecognized line.
+ */
+declare function parseFrontmatter(content: string): {
+    frontmatter: OkfFrontmatter;
+    rest: string;
+};
 
 declare function buildConceptDocument(fm: OkfFrontmatter, body: string): string;
+/** Reverse of {@link buildConceptDocument}: strips the single leading blank-line separator. */
+declare function parseConcept(content: string): {
+    frontmatter: OkfFrontmatter;
+    body: string;
+};
 
 declare function buildIndexMd(sections: OkfIndexSection[]): string;
 declare function buildRootIndexMd(okfVersion: string, sections: OkfIndexSection[]): string;
 
 declare function buildLogMd(entries: OkfLogEntry[]): string;
+/**
+ * Reverse of {@link buildLogMd}. Best-effort: lines that don't match the exact
+ * `## YYYY-MM-DD` heading or `- text` bullet shape buildLogMd emits are skipped,
+ * not thrown — a foreign log.md in a different format degrades to fewer entries
+ * rather than failing the import.
+ */
+declare function parseLogMd(content: string): OkfLogEntry[];
+
+/**
+ * Extracts inline markdown links (`[text](path)`) from a concept body.
+ * Single-line regex, not a CommonMark parser — reference-style links, links
+ * split across lines, and links inside code fences are not recognized.
+ * `http(s):` and `mailto:` targets are excluded; only relative/local paths
+ * are candidates for graph edges.
+ */
+declare function extractMarkdownLinks(body: string): OkfMarkdownLink[];
 
-export { type OkfFile, type OkfFrontmatter, type OkfIndexEntry, type OkfIndexSection, type OkfLogEntry, buildConceptDocument, buildIndexMd, buildLogMd, buildRootIndexMd, serializeFrontmatter };
+export { type OkfFile, type OkfFrontmatter, type OkfFrontmatterScalar, type OkfFrontmatterValue, type OkfIndexEntry, type OkfIndexSection, type OkfLogEntry, type OkfMarkdownLink, buildConceptDocument, buildIndexMd, buildLogMd, buildRootIndexMd, extractMarkdownLinks, parseConcept, parseFrontmatter, parseLogMd, serializeFrontmatter };

package/dist/index.js

@@ -63,12 +63,135 @@ function serializeFrontmatter(fm) {
   lines.push("---");
   return lines.join("\n") + "\n";
 }
+function unescapeFrontmatterString(escaped) {
+  let result = "";
+  for (let i = 0; i < escaped.length; i++) {
+    const ch = escaped[i];
+    if (ch === "\\" && i + 1 < escaped.length) {
+      const next = escaped[i + 1];
+      if (next === "n") {
+        result += "\n";
+        i++;
+        continue;
+      }
+      if (next === "r") {
+        result += "\r";
+        i++;
+        continue;
+      }
+      if (next === "t") {
+        result += "	";
+        i++;
+        continue;
+      }
+      if (next === '"') {
+        result += '"';
+        i++;
+        continue;
+      }
+      if (next === "\\") {
+        result += "\\";
+        i++;
+        continue;
+      }
+    }
+    result += ch;
+  }
+  return result;
+}
+function unescapeSingleQuotedString(escaped) {
+  return escaped.replace(/''/g, "'");
+}
+function parseQuotedScalar(raw) {
+  const trimmed = raw.trim();
+  if (trimmed.length < 2) return null;
+  if (trimmed.startsWith('"') && trimmed.endsWith('"')) {
+    return unescapeFrontmatterString(trimmed.slice(1, -1));
+  }
+  if (trimmed.startsWith("'") && trimmed.endsWith("'")) {
+    return unescapeSingleQuotedString(trimmed.slice(1, -1));
+  }
+  return null;
+}
+function parseKey(raw) {
+  return parseQuotedScalar(raw) ?? raw.trim();
+}
+function parseScalarValue(raw) {
+  const quoted = parseQuotedScalar(raw);
+  if (quoted !== null) return quoted;
+  const trimmed = raw.trim();
+  if (trimmed === "null") return null;
+  if (trimmed === "true") return true;
+  if (trimmed === "false") return false;
+  if (/^[+-]?(\d+\.?\d*|\.\d+)([eE][+-]?\d+)?$/.test(trimmed)) return Number(trimmed);
+  return trimmed;
+}
+function matchFrontmatterKeyValue(line) {
+  const keyMatch = /^(?:"(?:\\.|[^"\\])*"|'(?:''|[^'])*'|[^:]+)/.exec(line);
+  if (!keyMatch) return null;
+  const key = keyMatch[0];
+  if (line[key.length] !== ":") return null;
+  const tail = line.slice(key.length + 1);
+  return { key, value: tail.trimStart(), hasValue: tail.trim().length > 0 };
+}
+function parseFrontmatter(content) {
+  const lines = content.split(/\r?\n/);
+  const fallback = { frontmatter: { type: "" }, rest: content };
+  if (lines[0]?.trim() !== "---") return fallback;
+  let closingIndex = -1;
+  for (let i2 = 1; i2 < lines.length; i2++) {
+    if (lines[i2].trim() === "---") {
+      closingIndex = i2;
+      break;
+    }
+  }
+  if (closingIndex === -1) return fallback;
+  const frontmatter = {};
+  let i = 1;
+  while (i < closingIndex) {
+    const line = lines[i];
+    const kv = matchFrontmatterKeyValue(line);
+    if (!kv) {
+      i++;
+      continue;
+    }
+    if (kv.value.trim() === "[]") {
+      frontmatter[parseKey(kv.key)] = [];
+      i++;
+      continue;
+    }
+    if (!kv.hasValue) {
+      const key = parseKey(kv.key);
+      const items = [];
+      i++;
+      while (i < closingIndex && /^\s*-\s/.test(lines[i])) {
+        items.push(parseScalarValue(lines[i].replace(/^\s*-\s/, "")));
+        i++;
+      }
+      frontmatter[key] = items;
+      continue;
+    }
+    frontmatter[parseKey(kv.key)] = parseScalarValue(kv.value);
+    i++;
+  }
+  if (typeof frontmatter["type"] !== "string") {
+    frontmatter["type"] = "";
+  }
+  const restLines = lines.slice(closingIndex + 1);
+  const rest = restLines.length > 0 ? restLines.join("\n") : "";
+  return { frontmatter, rest };
+}
 
 // src/concept.ts
 function buildConceptDocument(fm, body) {
   return `${serializeFrontmatter(fm)}
 ${body}`;
 }
+function parseConcept(content) {
+  const { frontmatter, rest } = parseFrontmatter(content);
+  const body = rest.startsWith("\n") ? rest.slice(1) : rest;
+  return { frontmatter, body };
+}
 
 // src/index-md.ts
 function renderEntry(entry) {
@@ -123,11 +246,49 @@ function buildLogMd(entries) {
   if (lines.length === 0) return "";
   return lines.join("\n").trimEnd() + "\n";
 }
+var DATE_HEADING = /^##\s+(\d{4}-\d{2}-\d{2})\s*$/;
+var BULLET = /^-\s+(.*)$/;
+function parseLogMd(content) {
+  const entries = [];
+  let currentDate = null;
+  for (const line of content.split(/\r?\n/)) {
+    const headingMatch = DATE_HEADING.exec(line);
+    if (headingMatch) {
+      currentDate = headingMatch[1];
+      continue;
+    }
+    const bulletMatch = BULLET.exec(line);
+    if (bulletMatch && currentDate) {
+      entries.push({ date: currentDate, text: bulletMatch[1] });
+    }
+  }
+  return entries;
+}
+
+// src/markdown-links.ts
+var EXCLUDED_SCHEME = /^(https?:|mailto:)/i;
+var FENCED_CODE_BLOCK_PATTERN = /```[\s\S]*?```/g;
+function extractMarkdownLinks(body) {
+  const searchableBody = body.replace(FENCED_CODE_BLOCK_PATTERN, "");
+  const linkPattern = /\[([^\]]*)\]\(([^)\s]+)\)/g;
+  const links = [];
+  let match;
+  while ((match = linkPattern.exec(searchableBody)) !== null) {
+    const [, text, path] = match;
+    if (EXCLUDED_SCHEME.test(path)) continue;
+    links.push({ text, path });
+  }
+  return links;
+}
 
 exports.buildConceptDocument = buildConceptDocument;
 exports.buildIndexMd = buildIndexMd;
 exports.buildLogMd = buildLogMd;
 exports.buildRootIndexMd = buildRootIndexMd;
+exports.extractMarkdownLinks = extractMarkdownLinks;
+exports.parseConcept = parseConcept;
+exports.parseFrontmatter = parseFrontmatter;
+exports.parseLogMd = parseLogMd;
 exports.serializeFrontmatter = serializeFrontmatter;
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/frontmatter.ts","../src/concept.ts","../src/index-md.ts","../src/log-md.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import type { OkfFrontmatter } from './types';\n\nconst RESERVED_LITERALS = new Set(['true', 'false', 'yes', 'no', 'on', 'off', 'null', '~', '']);\n\nfunction looksLikeNumber(value: string): boolean {\n  return /^[+-]?(\\d+\\.?\\d*|\\.\\d+)([eE][+-]?\\d+)?$/.test(value);\n}\n\nfunction isIso8601Timestamp(value: string): boolean {\n  return /^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d+)?(Z|[+-]\\d{2}:\\d{2}|[+-]\\d{4}|[+-]\\d{2})$/.test(value);\n}\n\nfunction needsQuoting(value: string): boolean {\n  if (value !== value.trim()) return true;\n  if (/[\\n\\r\\t]/.test(value)) return true;\n  if (isIso8601Timestamp(value)) return false;\n\n  // Quote strings that YAML could otherwise parse as collections/indicators.\n  if (/^[-?:]\\s/.test(value)) return true;\n  if (/^[\\[\\]{}&,*%!|>'\"@`]/.test(value)) return true;\n\n  if (value.includes(':') || value.includes('#')) return true;\n  if (RESERVED_LITERALS.has(value.toLowerCase())) return true;\n  if (looksLikeNumber(value)) return true;\n  return false;\n}\n\nfunction quoteString(value: string): string {\n  const escaped = value\n    .replace(/\\\\/g, '\\\\\\\\')\n    .replace(/\"/g, '\\\\\"')\n    .replace(/\\n/g, '\\\\n')\n    .replace(/\\r/g, '\\\\r')\n    .replace(/\\t/g, '\\\\t');\n  return `\"${escaped}\"`;\n}\n\nexport function serializeScalarString(value: string): string {\n  return needsQuoting(value) ? quoteString(value) : value;\n}\n\nfunction serializeKey(key: string): string {\n  // needsQuoting() intentionally exempts ISO 8601 timestamps for *values*.\n  // For keys, quote timestamp-like scalars to avoid YAML timestamp coercion in some parsers.\n  if (/\\s/.test(key) || needsQuoting(key) || isIso8601Timestamp(key)) {\n    return quoteString(key);\n  }\n  return key;\n}\n\nfunction serializeValue(value: unknown): string {\n  if (value === null) return 'null';\n  if (typeof value === 'boolean') return String(value);\n  if (typeof value === 'number') return String(value);\n  if (typeof value === 'string') return serializeScalarString(value);\n  throw new Error(`Unsupported frontmatter value type: ${typeof value}`);\n}\n\nexport function serializeFrontmatter(fm: OkfFrontmatter): string {\n  const lines: string[] = ['---'];\n  for (const [key, value] of Object.entries(fm)) {\n    if (value === undefined) continue;\n    if (Array.isArray(value)) {\n      if (value.length === 0) {\n        lines.push(`${serializeKey(key)}: []`);\n      } else {\n        lines.push(`${serializeKey(key)}:`);\n        for (const item of value as unknown[]) {\n          if (typeof item === 'string') {\n            lines.push(`  - ${serializeScalarString(item)}`);\n          } else {\n            lines.push(`  - ${serializeValue(item)}`);\n          }\n        }\n      }\n    } else {\n      lines.push(`${serializeKey(key)}: ${serializeValue(value)}`);\n    }\n  }\n  lines.push('---');\n  return lines.join('\\n') + '\\n';\n}\n","import type { OkfFrontmatter } from './types';\nimport { serializeFrontmatter } from './frontmatter';\n\nexport function buildConceptDocument(fm: OkfFrontmatter, body: string): string {\n  return `${serializeFrontmatter(fm)}\\n${body}`;\n}\n","import { serializeScalarString } from './frontmatter';\nimport type { OkfIndexEntry, OkfIndexSection } from './types';\n\nfunction renderEntry(entry: OkfIndexEntry): string {\n  const esc = (s: string) =>\n    s\n      .replace(/\\\\/g, '\\\\\\\\')\n      .replace(/\\[/g, '\\\\[')\n      .replace(/\\]/g, '\\\\]')\n      .replace(/\\r?\\n/g, ' ');\n\n  const title = esc(entry.title);\n  const description = entry.description ? esc(entry.description) : undefined;\n\n  return description\n    ? `* [${title}](${entry.path}) - ${description}`\n    : `* [${title}](${entry.path})`;\n}\n\nfunction renderSections(sections: OkfIndexSection[]): string {\n  const lines: string[] = [];\n  for (const section of sections) {\n    lines.push(`## ${section.heading}`);\n    lines.push('');\n    for (const entry of section.entries) {\n      lines.push(renderEntry(entry));\n    }\n    lines.push('');\n  }\n  if (lines.length === 0) return '';\n  return lines.join('\\n').trimEnd() + '\\n';\n}\n\nexport function buildIndexMd(sections: OkfIndexSection[]): string {\n  return renderSections(sections);\n}\n\nexport function buildRootIndexMd(okfVersion: string, sections: OkfIndexSection[]): string {\n  const frontmatter = `---\\nokf_version: ${serializeScalarString(okfVersion)}\\n---\\n`;\n  return `${frontmatter}\\n${renderSections(sections)}`;\n}\n","import type { OkfLogEntry } from './types';\n\nexport function buildLogMd(entries: OkfLogEntry[]): string {\n  const groups = new Map<string, OkfLogEntry[]>();\n  for (const entry of entries) {\n    const group = groups.get(entry.date) ?? [];\n    group.push(entry);\n    groups.set(entry.date, group);\n  }\n\n  const dates = Array.from(groups.keys()).sort((a, b) => (a < b ? 1 : a > b ? -1 : 0));\n\n  const lines: string[] = [];\n  for (const date of dates) {\n    lines.push(`## ${date}`);\n    lines.push('');\n    for (const entry of groups.get(date)!) {\n      lines.push(`- ${entry.text}`);\n    }\n    lines.push('');\n  }\n\n  if (lines.length === 0) return '';\n  return lines.join('\\n').trimEnd() + '\\n';\n}\n"]}
+{"version":3,"sources":["../src/frontmatter.ts","../src/concept.ts","../src/index-md.ts","../src/log-md.ts","../src/markdown-links.ts"],"names":["i"],"mappings":"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","file":"index.js","sourcesContent":["import type { OkfFrontmatter, OkfFrontmatterScalar, OkfFrontmatterValue } from './types';\n\nconst RESERVED_LITERALS = new Set(['true', 'false', 'yes', 'no', 'on', 'off', 'null', '~', '']);\n\nfunction looksLikeNumber(value: string): boolean {\n  return /^[+-]?(\\d+\\.?\\d*|\\.\\d+)([eE][+-]?\\d+)?$/.test(value);\n}\n\nfunction isIso8601Timestamp(value: string): boolean {\n  return /^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d+)?(Z|[+-]\\d{2}:\\d{2}|[+-]\\d{4}|[+-]\\d{2})$/.test(value);\n}\n\nfunction needsQuoting(value: string): boolean {\n  if (value !== value.trim()) return true;\n  if (/[\\n\\r\\t]/.test(value)) return true;\n  if (isIso8601Timestamp(value)) return false;\n\n  // Quote strings that YAML could otherwise parse as collections/indicators.\n  if (/^[-?:]\\s/.test(value)) return true;\n  if (/^[\\[\\]{}&,*%!|>'\"@`]/.test(value)) return true;\n\n  if (value.includes(':') || value.includes('#')) return true;\n  if (RESERVED_LITERALS.has(value.toLowerCase())) return true;\n  if (looksLikeNumber(value)) return true;\n  return false;\n}\n\nfunction quoteString(value: string): string {\n  const escaped = value\n    .replace(/\\\\/g, '\\\\\\\\')\n    .replace(/\"/g, '\\\\\"')\n    .replace(/\\n/g, '\\\\n')\n    .replace(/\\r/g, '\\\\r')\n    .replace(/\\t/g, '\\\\t');\n  return `\"${escaped}\"`;\n}\n\nexport function serializeScalarString(value: string): string {\n  return needsQuoting(value) ? quoteString(value) : value;\n}\n\nfunction serializeKey(key: string): string {\n  // needsQuoting() intentionally exempts ISO 8601 timestamps for *values*.\n  // For keys, quote timestamp-like scalars to avoid YAML timestamp coercion in some parsers.\n  if (/\\s/.test(key) || needsQuoting(key) || isIso8601Timestamp(key)) {\n    return quoteString(key);\n  }\n  return key;\n}\n\nfunction serializeValue(value: unknown): string {\n  if (value === null) return 'null';\n  if (typeof value === 'boolean') return String(value);\n  if (typeof value === 'number') return String(value);\n  if (typeof value === 'string') return serializeScalarString(value);\n  throw new Error(`Unsupported frontmatter value type: ${typeof value}`);\n}\n\nexport function serializeFrontmatter(fm: OkfFrontmatter): string {\n  const lines: string[] = ['---'];\n  for (const [key, value] of Object.entries(fm)) {\n    if (value === undefined) continue;\n    if (Array.isArray(value)) {\n      if (value.length === 0) {\n        lines.push(`${serializeKey(key)}: []`);\n      } else {\n        lines.push(`${serializeKey(key)}:`);\n        for (const item of value as unknown[]) {\n          if (typeof item === 'string') {\n            lines.push(`  - ${serializeScalarString(item)}`);\n          } else {\n            lines.push(`  - ${serializeValue(item)}`);\n          }\n        }\n      }\n    } else {\n      lines.push(`${serializeKey(key)}: ${serializeValue(value)}`);\n    }\n  }\n  lines.push('---');\n  return lines.join('\\n') + '\\n';\n}\n\nfunction unescapeFrontmatterString(escaped: string): string {\n  let result = '';\n  for (let i = 0; i < escaped.length; i++) {\n    const ch = escaped[i];\n    if (ch === '\\\\' && i + 1 < escaped.length) {\n      const next = escaped[i + 1];\n      if (next === 'n') { result += '\\n'; i++; continue; }\n      if (next === 'r') { result += '\\r'; i++; continue; }\n      if (next === 't') { result += '\\t'; i++; continue; }\n      if (next === '\"') { result += '\"'; i++; continue; }\n      if (next === '\\\\') { result += '\\\\'; i++; continue; }\n    }\n    result += ch;\n  }\n  return result;\n}\n\nfunction unescapeSingleQuotedString(escaped: string): string {\n  return escaped.replace(/''/g, \"'\");\n}\n\nfunction parseQuotedScalar(raw: string): string | null {\n  const trimmed = raw.trim();\n  if (trimmed.length < 2) return null;\n  if (trimmed.startsWith('\"') && trimmed.endsWith('\"')) {\n    return unescapeFrontmatterString(trimmed.slice(1, -1));\n  }\n  if (trimmed.startsWith(\"'\") && trimmed.endsWith(\"'\")) {\n    return unescapeSingleQuotedString(trimmed.slice(1, -1));\n  }\n  return null;\n}\n\nfunction parseKey(raw: string): string {\n  return parseQuotedScalar(raw) ?? raw.trim();\n}\n\nfunction parseScalarValue(raw: string): OkfFrontmatterScalar {\n  const quoted = parseQuotedScalar(raw);\n  if (quoted !== null) return quoted;\n  const trimmed = raw.trim();\n  if (trimmed === 'null') return null;\n  if (trimmed === 'true') return true;\n  if (trimmed === 'false') return false;\n  if (/^[+-]?(\\d+\\.?\\d*|\\.\\d+)([eE][+-]?\\d+)?$/.test(trimmed)) return Number(trimmed);\n  return trimmed;\n}\n\nfunction matchFrontmatterKeyValue(\n  line: string,\n): { key: string; value: string; hasValue: boolean } | null {\n  const keyMatch = /^(?:\"(?:\\\\.|[^\"\\\\])*\"|'(?:''|[^'])*'|[^:]+)/.exec(line);\n  if (!keyMatch) return null;\n  const key = keyMatch[0];\n  if (line[key.length] !== ':') return null;\n  const tail = line.slice(key.length + 1);\n  return { key, value: tail.trimStart(), hasValue: tail.trim().length > 0 };\n}\n\n/**\n * Parses the subset of YAML frontmatter that {@link serializeFrontmatter} produces:\n * scalar string/number/boolean/null values, quoted strings, and block string-lists.\n * NOT a general YAML parser — flow collections (`[...]`/`{...}`), multi-line block\n * scalars (`|`/`>`), anchors, and aliases are not recognized. Lines that don't match\n * a recognized shape are silently skipped rather than throwing, so a foreign bundle\n * never crashes\n * the import — it just loses fidelity on the unrecognized line.\n */\nexport function parseFrontmatter(content: string): { frontmatter: OkfFrontmatter; rest: string } {\n  const lines = content.split(/\\r?\\n/);\n  const fallback = { frontmatter: { type: '' } as OkfFrontmatter, rest: content };\n\n  if (lines[0]?.trim() !== '---') return fallback;\n\n  let closingIndex = -1;\n  for (let i = 1; i < lines.length; i++) {\n    if (lines[i].trim() === '---') {\n      closingIndex = i;\n      break;\n    }\n  }\n  if (closingIndex === -1) return fallback;\n\n  const frontmatter: Record<string, OkfFrontmatterValue> = {};\n  let i = 1;\n  while (i < closingIndex) {\n    const line = lines[i];\n    const kv = matchFrontmatterKeyValue(line);\n    if (!kv) {\n      i++;\n      continue;\n    }\n    if (kv.value.trim() === '[]') {\n      frontmatter[parseKey(kv.key)] = [];\n      i++;\n      continue;\n    }\n    if (!kv.hasValue) {\n      const key = parseKey(kv.key);\n      const items: OkfFrontmatterScalar[] = [];\n      i++;\n      while (i < closingIndex && /^\\s*-\\s/.test(lines[i])) {\n        items.push(parseScalarValue(lines[i].replace(/^\\s*-\\s/, '')));\n        i++;\n      }\n      frontmatter[key] = items;\n      continue;\n    }\n    frontmatter[parseKey(kv.key)] = parseScalarValue(kv.value);\n    i++;\n  }\n\n  if (typeof frontmatter['type'] !== 'string') {\n    frontmatter['type'] = '';\n  }\n\n  const restLines = lines.slice(closingIndex + 1);\n  const rest = restLines.length > 0 ? restLines.join('\\n') : '';\n\n  return { frontmatter: frontmatter as OkfFrontmatter, rest };\n}\n","import type { OkfFrontmatter } from './types';\nimport { serializeFrontmatter, parseFrontmatter } from './frontmatter';\n\nexport function buildConceptDocument(fm: OkfFrontmatter, body: string): string {\n  return `${serializeFrontmatter(fm)}\\n${body}`;\n}\n\n/** Reverse of {@link buildConceptDocument}: strips the single leading blank-line separator. */\nexport function parseConcept(content: string): { frontmatter: OkfFrontmatter; body: string } {\n  const { frontmatter, rest } = parseFrontmatter(content);\n  const body = rest.startsWith('\\n') ? rest.slice(1) : rest;\n  return { frontmatter, body };\n}\n","import { serializeScalarString } from './frontmatter';\nimport type { OkfIndexEntry, OkfIndexSection } from './types';\n\nfunction renderEntry(entry: OkfIndexEntry): string {\n  const esc = (s: string) =>\n    s\n      .replace(/\\\\/g, '\\\\\\\\')\n      .replace(/\\[/g, '\\\\[')\n      .replace(/\\]/g, '\\\\]')\n      .replace(/\\r?\\n/g, ' ');\n\n  const title = esc(entry.title);\n  const description = entry.description ? esc(entry.description) : undefined;\n\n  return description\n    ? `* [${title}](${entry.path}) - ${description}`\n    : `* [${title}](${entry.path})`;\n}\n\nfunction renderSections(sections: OkfIndexSection[]): string {\n  const lines: string[] = [];\n  for (const section of sections) {\n    lines.push(`## ${section.heading}`);\n    lines.push('');\n    for (const entry of section.entries) {\n      lines.push(renderEntry(entry));\n    }\n    lines.push('');\n  }\n  if (lines.length === 0) return '';\n  return lines.join('\\n').trimEnd() + '\\n';\n}\n\nexport function buildIndexMd(sections: OkfIndexSection[]): string {\n  return renderSections(sections);\n}\n\nexport function buildRootIndexMd(okfVersion: string, sections: OkfIndexSection[]): string {\n  const frontmatter = `---\\nokf_version: ${serializeScalarString(okfVersion)}\\n---\\n`;\n  return `${frontmatter}\\n${renderSections(sections)}`;\n}\n","import type { OkfLogEntry } from './types';\n\nexport function buildLogMd(entries: OkfLogEntry[]): string {\n  const groups = new Map<string, OkfLogEntry[]>();\n  for (const entry of entries) {\n    const group = groups.get(entry.date) ?? [];\n    group.push(entry);\n    groups.set(entry.date, group);\n  }\n\n  const dates = Array.from(groups.keys()).sort((a, b) => (a < b ? 1 : a > b ? -1 : 0));\n\n  const lines: string[] = [];\n  for (const date of dates) {\n    lines.push(`## ${date}`);\n    lines.push('');\n    for (const entry of groups.get(date)!) {\n      lines.push(`- ${entry.text}`);\n    }\n    lines.push('');\n  }\n\n  if (lines.length === 0) return '';\n  return lines.join('\\n').trimEnd() + '\\n';\n}\n\nconst DATE_HEADING = /^##\\s+(\\d{4}-\\d{2}-\\d{2})\\s*$/;\nconst BULLET = /^-\\s+(.*)$/;\n\n/**\n * Reverse of {@link buildLogMd}. Best-effort: lines that don't match the exact\n * `## YYYY-MM-DD` heading or `- text` bullet shape buildLogMd emits are skipped,\n * not thrown — a foreign log.md in a different format degrades to fewer entries\n * rather than failing the import.\n */\nexport function parseLogMd(content: string): OkfLogEntry[] {\n  const entries: OkfLogEntry[] = [];\n  let currentDate: string | null = null;\n\n  for (const line of content.split(/\\r?\\n/)) {\n    const headingMatch = DATE_HEADING.exec(line);\n    if (headingMatch) {\n      currentDate = headingMatch[1];\n      continue;\n    }\n    const bulletMatch = BULLET.exec(line);\n    if (bulletMatch && currentDate) {\n      entries.push({ date: currentDate, text: bulletMatch[1] });\n    }\n  }\n\n  return entries;\n}\n","import type { OkfMarkdownLink } from './types';\n\nconst EXCLUDED_SCHEME = /^(https?:|mailto:)/i;\nconst FENCED_CODE_BLOCK_PATTERN = /```[\\s\\S]*?```/g;\n\n/**\n * Extracts inline markdown links (`[text](path)`) from a concept body.\n * Single-line regex, not a CommonMark parser — reference-style links, links\n * split across lines, and links inside code fences are not recognized.\n * `http(s):` and `mailto:` targets are excluded; only relative/local paths\n * are candidates for graph edges.\n */\nexport function extractMarkdownLinks(body: string): OkfMarkdownLink[] {\n  const searchableBody = body.replace(FENCED_CODE_BLOCK_PATTERN, '');\n  const linkPattern = /\\[([^\\]]*)\\]\\(([^)\\s]+)\\)/g;\n  const links: OkfMarkdownLink[] = [];\n  let match: RegExpExecArray | null;\n  while ((match = linkPattern.exec(searchableBody)) !== null) {\n    const [, text, path] = match;\n    if (EXCLUDED_SCHEME.test(path)) continue;\n    links.push({ text, path });\n  }\n  return links;\n}\n"]}

package/dist/index.mjs

@@ -61,12 +61,135 @@ function serializeFrontmatter(fm) {
   lines.push("---");
   return lines.join("\n") + "\n";
 }
+function unescapeFrontmatterString(escaped) {
+  let result = "";
+  for (let i = 0; i < escaped.length; i++) {
+    const ch = escaped[i];
+    if (ch === "\\" && i + 1 < escaped.length) {
+      const next = escaped[i + 1];
+      if (next === "n") {
+        result += "\n";
+        i++;
+        continue;
+      }
+      if (next === "r") {
+        result += "\r";
+        i++;
+        continue;
+      }
+      if (next === "t") {
+        result += "	";
+        i++;
+        continue;
+      }
+      if (next === '"') {
+        result += '"';
+        i++;
+        continue;
+      }
+      if (next === "\\") {
+        result += "\\";
+        i++;
+        continue;
+      }
+    }
+    result += ch;
+  }
+  return result;
+}
+function unescapeSingleQuotedString(escaped) {
+  return escaped.replace(/''/g, "'");
+}
+function parseQuotedScalar(raw) {
+  const trimmed = raw.trim();
+  if (trimmed.length < 2) return null;
+  if (trimmed.startsWith('"') && trimmed.endsWith('"')) {
+    return unescapeFrontmatterString(trimmed.slice(1, -1));
+  }
+  if (trimmed.startsWith("'") && trimmed.endsWith("'")) {
+    return unescapeSingleQuotedString(trimmed.slice(1, -1));
+  }
+  return null;
+}
+function parseKey(raw) {
+  return parseQuotedScalar(raw) ?? raw.trim();
+}
+function parseScalarValue(raw) {
+  const quoted = parseQuotedScalar(raw);
+  if (quoted !== null) return quoted;
+  const trimmed = raw.trim();
+  if (trimmed === "null") return null;
+  if (trimmed === "true") return true;
+  if (trimmed === "false") return false;
+  if (/^[+-]?(\d+\.?\d*|\.\d+)([eE][+-]?\d+)?$/.test(trimmed)) return Number(trimmed);
+  return trimmed;
+}
+function matchFrontmatterKeyValue(line) {
+  const keyMatch = /^(?:"(?:\\.|[^"\\])*"|'(?:''|[^'])*'|[^:]+)/.exec(line);
+  if (!keyMatch) return null;
+  const key = keyMatch[0];
+  if (line[key.length] !== ":") return null;
+  const tail = line.slice(key.length + 1);
+  return { key, value: tail.trimStart(), hasValue: tail.trim().length > 0 };
+}
+function parseFrontmatter(content) {
+  const lines = content.split(/\r?\n/);
+  const fallback = { frontmatter: { type: "" }, rest: content };
+  if (lines[0]?.trim() !== "---") return fallback;
+  let closingIndex = -1;
+  for (let i2 = 1; i2 < lines.length; i2++) {
+    if (lines[i2].trim() === "---") {
+      closingIndex = i2;
+      break;
+    }
+  }
+  if (closingIndex === -1) return fallback;
+  const frontmatter = {};
+  let i = 1;
+  while (i < closingIndex) {
+    const line = lines[i];
+    const kv = matchFrontmatterKeyValue(line);
+    if (!kv) {
+      i++;
+      continue;
+    }
+    if (kv.value.trim() === "[]") {
+      frontmatter[parseKey(kv.key)] = [];
+      i++;
+      continue;
+    }
+    if (!kv.hasValue) {
+      const key = parseKey(kv.key);
+      const items = [];
+      i++;
+      while (i < closingIndex && /^\s*-\s/.test(lines[i])) {
+        items.push(parseScalarValue(lines[i].replace(/^\s*-\s/, "")));
+        i++;
+      }
+      frontmatter[key] = items;
+      continue;
+    }
+    frontmatter[parseKey(kv.key)] = parseScalarValue(kv.value);
+    i++;
+  }
+  if (typeof frontmatter["type"] !== "string") {
+    frontmatter["type"] = "";
+  }
+  const restLines = lines.slice(closingIndex + 1);
+  const rest = restLines.length > 0 ? restLines.join("\n") : "";
+  return { frontmatter, rest };
+}
 
 // src/concept.ts
 function buildConceptDocument(fm, body) {
   return `${serializeFrontmatter(fm)}
 ${body}`;
 }
+function parseConcept(content) {
+  const { frontmatter, rest } = parseFrontmatter(content);
+  const body = rest.startsWith("\n") ? rest.slice(1) : rest;
+  return { frontmatter, body };
+}
 
 // src/index-md.ts
 function renderEntry(entry) {
@@ -121,7 +244,41 @@ function buildLogMd(entries) {
   if (lines.length === 0) return "";
   return lines.join("\n").trimEnd() + "\n";
 }
+var DATE_HEADING = /^##\s+(\d{4}-\d{2}-\d{2})\s*$/;
+var BULLET = /^-\s+(.*)$/;
+function parseLogMd(content) {
+  const entries = [];
+  let currentDate = null;
+  for (const line of content.split(/\r?\n/)) {
+    const headingMatch = DATE_HEADING.exec(line);
+    if (headingMatch) {
+      currentDate = headingMatch[1];
+      continue;
+    }
+    const bulletMatch = BULLET.exec(line);
+    if (bulletMatch && currentDate) {
+      entries.push({ date: currentDate, text: bulletMatch[1] });
+    }
+  }
+  return entries;
+}
+
+// src/markdown-links.ts
+var EXCLUDED_SCHEME = /^(https?:|mailto:)/i;
+var FENCED_CODE_BLOCK_PATTERN = /```[\s\S]*?```/g;
+function extractMarkdownLinks(body) {
+  const searchableBody = body.replace(FENCED_CODE_BLOCK_PATTERN, "");
+  const linkPattern = /\[([^\]]*)\]\(([^)\s]+)\)/g;
+  const links = [];
+  let match;
+  while ((match = linkPattern.exec(searchableBody)) !== null) {
+    const [, text, path] = match;
+    if (EXCLUDED_SCHEME.test(path)) continue;
+    links.push({ text, path });
+  }
+  return links;
+}
 
-export { buildConceptDocument, buildIndexMd, buildLogMd, buildRootIndexMd, serializeFrontmatter };
+export { buildConceptDocument, buildIndexMd, buildLogMd, buildRootIndexMd, extractMarkdownLinks, parseConcept, parseFrontmatter, parseLogMd, serializeFrontmatter };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/frontmatter.ts","../src/concept.ts","../src/index-md.ts","../src/log-md.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["import type { OkfFrontmatter } from './types';\n\nconst RESERVED_LITERALS = new Set(['true', 'false', 'yes', 'no', 'on', 'off', 'null', '~', '']);\n\nfunction looksLikeNumber(value: string): boolean {\n  return /^[+-]?(\\d+\\.?\\d*|\\.\\d+)([eE][+-]?\\d+)?$/.test(value);\n}\n\nfunction isIso8601Timestamp(value: string): boolean {\n  return /^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d+)?(Z|[+-]\\d{2}:\\d{2}|[+-]\\d{4}|[+-]\\d{2})$/.test(value);\n}\n\nfunction needsQuoting(value: string): boolean {\n  if (value !== value.trim()) return true;\n  if (/[\\n\\r\\t]/.test(value)) return true;\n  if (isIso8601Timestamp(value)) return false;\n\n  // Quote strings that YAML could otherwise parse as collections/indicators.\n  if (/^[-?:]\\s/.test(value)) return true;\n  if (/^[\\[\\]{}&,*%!|>'\"@`]/.test(value)) return true;\n\n  if (value.includes(':') || value.includes('#')) return true;\n  if (RESERVED_LITERALS.has(value.toLowerCase())) return true;\n  if (looksLikeNumber(value)) return true;\n  return false;\n}\n\nfunction quoteString(value: string): string {\n  const escaped = value\n    .replace(/\\\\/g, '\\\\\\\\')\n    .replace(/\"/g, '\\\\\"')\n    .replace(/\\n/g, '\\\\n')\n    .replace(/\\r/g, '\\\\r')\n    .replace(/\\t/g, '\\\\t');\n  return `\"${escaped}\"`;\n}\n\nexport function serializeScalarString(value: string): string {\n  return needsQuoting(value) ? quoteString(value) : value;\n}\n\nfunction serializeKey(key: string): string {\n  // needsQuoting() intentionally exempts ISO 8601 timestamps for *values*.\n  // For keys, quote timestamp-like scalars to avoid YAML timestamp coercion in some parsers.\n  if (/\\s/.test(key) || needsQuoting(key) || isIso8601Timestamp(key)) {\n    return quoteString(key);\n  }\n  return key;\n}\n\nfunction serializeValue(value: unknown): string {\n  if (value === null) return 'null';\n  if (typeof value === 'boolean') return String(value);\n  if (typeof value === 'number') return String(value);\n  if (typeof value === 'string') return serializeScalarString(value);\n  throw new Error(`Unsupported frontmatter value type: ${typeof value}`);\n}\n\nexport function serializeFrontmatter(fm: OkfFrontmatter): string {\n  const lines: string[] = ['---'];\n  for (const [key, value] of Object.entries(fm)) {\n    if (value === undefined) continue;\n    if (Array.isArray(value)) {\n      if (value.length === 0) {\n        lines.push(`${serializeKey(key)}: []`);\n      } else {\n        lines.push(`${serializeKey(key)}:`);\n        for (const item of value as unknown[]) {\n          if (typeof item === 'string') {\n            lines.push(`  - ${serializeScalarString(item)}`);\n          } else {\n            lines.push(`  - ${serializeValue(item)}`);\n          }\n        }\n      }\n    } else {\n      lines.push(`${serializeKey(key)}: ${serializeValue(value)}`);\n    }\n  }\n  lines.push('---');\n  return lines.join('\\n') + '\\n';\n}\n","import type { OkfFrontmatter } from './types';\nimport { serializeFrontmatter } from './frontmatter';\n\nexport function buildConceptDocument(fm: OkfFrontmatter, body: string): string {\n  return `${serializeFrontmatter(fm)}\\n${body}`;\n}\n","import { serializeScalarString } from './frontmatter';\nimport type { OkfIndexEntry, OkfIndexSection } from './types';\n\nfunction renderEntry(entry: OkfIndexEntry): string {\n  const esc = (s: string) =>\n    s\n      .replace(/\\\\/g, '\\\\\\\\')\n      .replace(/\\[/g, '\\\\[')\n      .replace(/\\]/g, '\\\\]')\n      .replace(/\\r?\\n/g, ' ');\n\n  const title = esc(entry.title);\n  const description = entry.description ? esc(entry.description) : undefined;\n\n  return description\n    ? `* [${title}](${entry.path}) - ${description}`\n    : `* [${title}](${entry.path})`;\n}\n\nfunction renderSections(sections: OkfIndexSection[]): string {\n  const lines: string[] = [];\n  for (const section of sections) {\n    lines.push(`## ${section.heading}`);\n    lines.push('');\n    for (const entry of section.entries) {\n      lines.push(renderEntry(entry));\n    }\n    lines.push('');\n  }\n  if (lines.length === 0) return '';\n  return lines.join('\\n').trimEnd() + '\\n';\n}\n\nexport function buildIndexMd(sections: OkfIndexSection[]): string {\n  return renderSections(sections);\n}\n\nexport function buildRootIndexMd(okfVersion: string, sections: OkfIndexSection[]): string {\n  const frontmatter = `---\\nokf_version: ${serializeScalarString(okfVersion)}\\n---\\n`;\n  return `${frontmatter}\\n${renderSections(sections)}`;\n}\n","import type { OkfLogEntry } from './types';\n\nexport function buildLogMd(entries: OkfLogEntry[]): string {\n  const groups = new Map<string, OkfLogEntry[]>();\n  for (const entry of entries) {\n    const group = groups.get(entry.date) ?? [];\n    group.push(entry);\n    groups.set(entry.date, group);\n  }\n\n  const dates = Array.from(groups.keys()).sort((a, b) => (a < b ? 1 : a > b ? -1 : 0));\n\n  const lines: string[] = [];\n  for (const date of dates) {\n    lines.push(`## ${date}`);\n    lines.push('');\n    for (const entry of groups.get(date)!) {\n      lines.push(`- ${entry.text}`);\n    }\n    lines.push('');\n  }\n\n  if (lines.length === 0) return '';\n  return lines.join('\\n').trimEnd() + '\\n';\n}\n"]}
+{"version":3,"sources":["../src/frontmatter.ts","../src/concept.ts","../src/index-md.ts","../src/log-md.ts","../src/markdown-links.ts"],"names":["i"],"mappings":"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","file":"index.mjs","sourcesContent":["import type { OkfFrontmatter, OkfFrontmatterScalar, OkfFrontmatterValue } from './types';\n\nconst RESERVED_LITERALS = new Set(['true', 'false', 'yes', 'no', 'on', 'off', 'null', '~', '']);\n\nfunction looksLikeNumber(value: string): boolean {\n  return /^[+-]?(\\d+\\.?\\d*|\\.\\d+)([eE][+-]?\\d+)?$/.test(value);\n}\n\nfunction isIso8601Timestamp(value: string): boolean {\n  return /^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d+)?(Z|[+-]\\d{2}:\\d{2}|[+-]\\d{4}|[+-]\\d{2})$/.test(value);\n}\n\nfunction needsQuoting(value: string): boolean {\n  if (value !== value.trim()) return true;\n  if (/[\\n\\r\\t]/.test(value)) return true;\n  if (isIso8601Timestamp(value)) return false;\n\n  // Quote strings that YAML could otherwise parse as collections/indicators.\n  if (/^[-?:]\\s/.test(value)) return true;\n  if (/^[\\[\\]{}&,*%!|>'\"@`]/.test(value)) return true;\n\n  if (value.includes(':') || value.includes('#')) return true;\n  if (RESERVED_LITERALS.has(value.toLowerCase())) return true;\n  if (looksLikeNumber(value)) return true;\n  return false;\n}\n\nfunction quoteString(value: string): string {\n  const escaped = value\n    .replace(/\\\\/g, '\\\\\\\\')\n    .replace(/\"/g, '\\\\\"')\n    .replace(/\\n/g, '\\\\n')\n    .replace(/\\r/g, '\\\\r')\n    .replace(/\\t/g, '\\\\t');\n  return `\"${escaped}\"`;\n}\n\nexport function serializeScalarString(value: string): string {\n  return needsQuoting(value) ? quoteString(value) : value;\n}\n\nfunction serializeKey(key: string): string {\n  // needsQuoting() intentionally exempts ISO 8601 timestamps for *values*.\n  // For keys, quote timestamp-like scalars to avoid YAML timestamp coercion in some parsers.\n  if (/\\s/.test(key) || needsQuoting(key) || isIso8601Timestamp(key)) {\n    return quoteString(key);\n  }\n  return key;\n}\n\nfunction serializeValue(value: unknown): string {\n  if (value === null) return 'null';\n  if (typeof value === 'boolean') return String(value);\n  if (typeof value === 'number') return String(value);\n  if (typeof value === 'string') return serializeScalarString(value);\n  throw new Error(`Unsupported frontmatter value type: ${typeof value}`);\n}\n\nexport function serializeFrontmatter(fm: OkfFrontmatter): string {\n  const lines: string[] = ['---'];\n  for (const [key, value] of Object.entries(fm)) {\n    if (value === undefined) continue;\n    if (Array.isArray(value)) {\n      if (value.length === 0) {\n        lines.push(`${serializeKey(key)}: []`);\n      } else {\n        lines.push(`${serializeKey(key)}:`);\n        for (const item of value as unknown[]) {\n          if (typeof item === 'string') {\n            lines.push(`  - ${serializeScalarString(item)}`);\n          } else {\n            lines.push(`  - ${serializeValue(item)}`);\n          }\n        }\n      }\n    } else {\n      lines.push(`${serializeKey(key)}: ${serializeValue(value)}`);\n    }\n  }\n  lines.push('---');\n  return lines.join('\\n') + '\\n';\n}\n\nfunction unescapeFrontmatterString(escaped: string): string {\n  let result = '';\n  for (let i = 0; i < escaped.length; i++) {\n    const ch = escaped[i];\n    if (ch === '\\\\' && i + 1 < escaped.length) {\n      const next = escaped[i + 1];\n      if (next === 'n') { result += '\\n'; i++; continue; }\n      if (next === 'r') { result += '\\r'; i++; continue; }\n      if (next === 't') { result += '\\t'; i++; continue; }\n      if (next === '\"') { result += '\"'; i++; continue; }\n      if (next === '\\\\') { result += '\\\\'; i++; continue; }\n    }\n    result += ch;\n  }\n  return result;\n}\n\nfunction unescapeSingleQuotedString(escaped: string): string {\n  return escaped.replace(/''/g, \"'\");\n}\n\nfunction parseQuotedScalar(raw: string): string | null {\n  const trimmed = raw.trim();\n  if (trimmed.length < 2) return null;\n  if (trimmed.startsWith('\"') && trimmed.endsWith('\"')) {\n    return unescapeFrontmatterString(trimmed.slice(1, -1));\n  }\n  if (trimmed.startsWith(\"'\") && trimmed.endsWith(\"'\")) {\n    return unescapeSingleQuotedString(trimmed.slice(1, -1));\n  }\n  return null;\n}\n\nfunction parseKey(raw: string): string {\n  return parseQuotedScalar(raw) ?? raw.trim();\n}\n\nfunction parseScalarValue(raw: string): OkfFrontmatterScalar {\n  const quoted = parseQuotedScalar(raw);\n  if (quoted !== null) return quoted;\n  const trimmed = raw.trim();\n  if (trimmed === 'null') return null;\n  if (trimmed === 'true') return true;\n  if (trimmed === 'false') return false;\n  if (/^[+-]?(\\d+\\.?\\d*|\\.\\d+)([eE][+-]?\\d+)?$/.test(trimmed)) return Number(trimmed);\n  return trimmed;\n}\n\nfunction matchFrontmatterKeyValue(\n  line: string,\n): { key: string; value: string; hasValue: boolean } | null {\n  const keyMatch = /^(?:\"(?:\\\\.|[^\"\\\\])*\"|'(?:''|[^'])*'|[^:]+)/.exec(line);\n  if (!keyMatch) return null;\n  const key = keyMatch[0];\n  if (line[key.length] !== ':') return null;\n  const tail = line.slice(key.length + 1);\n  return { key, value: tail.trimStart(), hasValue: tail.trim().length > 0 };\n}\n\n/**\n * Parses the subset of YAML frontmatter that {@link serializeFrontmatter} produces:\n * scalar string/number/boolean/null values, quoted strings, and block string-lists.\n * NOT a general YAML parser — flow collections (`[...]`/`{...}`), multi-line block\n * scalars (`|`/`>`), anchors, and aliases are not recognized. Lines that don't match\n * a recognized shape are silently skipped rather than throwing, so a foreign bundle\n * never crashes\n * the import — it just loses fidelity on the unrecognized line.\n */\nexport function parseFrontmatter(content: string): { frontmatter: OkfFrontmatter; rest: string } {\n  const lines = content.split(/\\r?\\n/);\n  const fallback = { frontmatter: { type: '' } as OkfFrontmatter, rest: content };\n\n  if (lines[0]?.trim() !== '---') return fallback;\n\n  let closingIndex = -1;\n  for (let i = 1; i < lines.length; i++) {\n    if (lines[i].trim() === '---') {\n      closingIndex = i;\n      break;\n    }\n  }\n  if (closingIndex === -1) return fallback;\n\n  const frontmatter: Record<string, OkfFrontmatterValue> = {};\n  let i = 1;\n  while (i < closingIndex) {\n    const line = lines[i];\n    const kv = matchFrontmatterKeyValue(line);\n    if (!kv) {\n      i++;\n      continue;\n    }\n    if (kv.value.trim() === '[]') {\n      frontmatter[parseKey(kv.key)] = [];\n      i++;\n      continue;\n    }\n    if (!kv.hasValue) {\n      const key = parseKey(kv.key);\n      const items: OkfFrontmatterScalar[] = [];\n      i++;\n      while (i < closingIndex && /^\\s*-\\s/.test(lines[i])) {\n        items.push(parseScalarValue(lines[i].replace(/^\\s*-\\s/, '')));\n        i++;\n      }\n      frontmatter[key] = items;\n      continue;\n    }\n    frontmatter[parseKey(kv.key)] = parseScalarValue(kv.value);\n    i++;\n  }\n\n  if (typeof frontmatter['type'] !== 'string') {\n    frontmatter['type'] = '';\n  }\n\n  const restLines = lines.slice(closingIndex + 1);\n  const rest = restLines.length > 0 ? restLines.join('\\n') : '';\n\n  return { frontmatter: frontmatter as OkfFrontmatter, rest };\n}\n","import type { OkfFrontmatter } from './types';\nimport { serializeFrontmatter, parseFrontmatter } from './frontmatter';\n\nexport function buildConceptDocument(fm: OkfFrontmatter, body: string): string {\n  return `${serializeFrontmatter(fm)}\\n${body}`;\n}\n\n/** Reverse of {@link buildConceptDocument}: strips the single leading blank-line separator. */\nexport function parseConcept(content: string): { frontmatter: OkfFrontmatter; body: string } {\n  const { frontmatter, rest } = parseFrontmatter(content);\n  const body = rest.startsWith('\\n') ? rest.slice(1) : rest;\n  return { frontmatter, body };\n}\n","import { serializeScalarString } from './frontmatter';\nimport type { OkfIndexEntry, OkfIndexSection } from './types';\n\nfunction renderEntry(entry: OkfIndexEntry): string {\n  const esc = (s: string) =>\n    s\n      .replace(/\\\\/g, '\\\\\\\\')\n      .replace(/\\[/g, '\\\\[')\n      .replace(/\\]/g, '\\\\]')\n      .replace(/\\r?\\n/g, ' ');\n\n  const title = esc(entry.title);\n  const description = entry.description ? esc(entry.description) : undefined;\n\n  return description\n    ? `* [${title}](${entry.path}) - ${description}`\n    : `* [${title}](${entry.path})`;\n}\n\nfunction renderSections(sections: OkfIndexSection[]): string {\n  const lines: string[] = [];\n  for (const section of sections) {\n    lines.push(`## ${section.heading}`);\n    lines.push('');\n    for (const entry of section.entries) {\n      lines.push(renderEntry(entry));\n    }\n    lines.push('');\n  }\n  if (lines.length === 0) return '';\n  return lines.join('\\n').trimEnd() + '\\n';\n}\n\nexport function buildIndexMd(sections: OkfIndexSection[]): string {\n  return renderSections(sections);\n}\n\nexport function buildRootIndexMd(okfVersion: string, sections: OkfIndexSection[]): string {\n  const frontmatter = `---\\nokf_version: ${serializeScalarString(okfVersion)}\\n---\\n`;\n  return `${frontmatter}\\n${renderSections(sections)}`;\n}\n","import type { OkfLogEntry } from './types';\n\nexport function buildLogMd(entries: OkfLogEntry[]): string {\n  const groups = new Map<string, OkfLogEntry[]>();\n  for (const entry of entries) {\n    const group = groups.get(entry.date) ?? [];\n    group.push(entry);\n    groups.set(entry.date, group);\n  }\n\n  const dates = Array.from(groups.keys()).sort((a, b) => (a < b ? 1 : a > b ? -1 : 0));\n\n  const lines: string[] = [];\n  for (const date of dates) {\n    lines.push(`## ${date}`);\n    lines.push('');\n    for (const entry of groups.get(date)!) {\n      lines.push(`- ${entry.text}`);\n    }\n    lines.push('');\n  }\n\n  if (lines.length === 0) return '';\n  return lines.join('\\n').trimEnd() + '\\n';\n}\n\nconst DATE_HEADING = /^##\\s+(\\d{4}-\\d{2}-\\d{2})\\s*$/;\nconst BULLET = /^-\\s+(.*)$/;\n\n/**\n * Reverse of {@link buildLogMd}. Best-effort: lines that don't match the exact\n * `## YYYY-MM-DD` heading or `- text` bullet shape buildLogMd emits are skipped,\n * not thrown — a foreign log.md in a different format degrades to fewer entries\n * rather than failing the import.\n */\nexport function parseLogMd(content: string): OkfLogEntry[] {\n  const entries: OkfLogEntry[] = [];\n  let currentDate: string | null = null;\n\n  for (const line of content.split(/\\r?\\n/)) {\n    const headingMatch = DATE_HEADING.exec(line);\n    if (headingMatch) {\n      currentDate = headingMatch[1];\n      continue;\n    }\n    const bulletMatch = BULLET.exec(line);\n    if (bulletMatch && currentDate) {\n      entries.push({ date: currentDate, text: bulletMatch[1] });\n    }\n  }\n\n  return entries;\n}\n","import type { OkfMarkdownLink } from './types';\n\nconst EXCLUDED_SCHEME = /^(https?:|mailto:)/i;\nconst FENCED_CODE_BLOCK_PATTERN = /```[\\s\\S]*?```/g;\n\n/**\n * Extracts inline markdown links (`[text](path)`) from a concept body.\n * Single-line regex, not a CommonMark parser — reference-style links, links\n * split across lines, and links inside code fences are not recognized.\n * `http(s):` and `mailto:` targets are excluded; only relative/local paths\n * are candidates for graph edges.\n */\nexport function extractMarkdownLinks(body: string): OkfMarkdownLink[] {\n  const searchableBody = body.replace(FENCED_CODE_BLOCK_PATTERN, '');\n  const linkPattern = /\\[([^\\]]*)\\]\\(([^)\\s]+)\\)/g;\n  const links: OkfMarkdownLink[] = [];\n  let match: RegExpExecArray | null;\n  while ((match = linkPattern.exec(searchableBody)) !== null) {\n    const [, text, path] = match;\n    if (EXCLUDED_SCHEME.test(path)) continue;\n    links.push({ text, path });\n  }\n  return links;\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@equationalapplications/core-okf",
-  "version": "4.13.1",
+  "version": "4.15.1",
   "description": "Zero-dependency Open Knowledge Format (OKF) v0.1 primitives: frontmatter serialization, concept documents, index.md and log.md builders.",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -12,13 +12,6 @@
       "import": "./dist/index.mjs"
     }
   },
-  "scripts": {
-    "build": "tsup",
-    "dev": "tsup --watch",
-    "typecheck": "tsc --noEmit",
-    "test": "vitest run",
-    "test:watch": "vitest"
-  },
   "files": [
     "dist",
     "LICENSE",
@@ -53,5 +46,12 @@
     "tsup": "^8.0.0",
     "typescript": "^5.4.0",
     "vitest": "4.1.5"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
   }
-}
+}