feat(okr): okf-index (ekte format)/okf-check + okf_version per rot (SC2,SC3,SC7) [skip-docs]

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01SFW5scLL7oEwWWTv1fPQG6

scripts/okf-index.mjs

@@ -0,0 +1,118 @@
+#!/usr/bin/env node
+// okf-index.mjs
+// Genererer OKF-kompatible `index.md` per nivaa i en bundle-rot (prosjekt
+// `.claude/okr/` eller home `~/.claude/okr/org/`). Verbatim OKF-«Documents/kb
+// Layout»-index-form:
+//   # Overskrift
+//
+//   okf_version: <ver>      (KUN rot-index)
+//
+//   * [title](relativ.md) - description
+// Ingen frontmatter paa index.md (OKF-reservert). Konsept-filers `title`/
+// `description` leses via lib/frontmatter.mjs. Underkataloger faar en peker til
+// sin egen index.md. Kjoeres PER ROT (de to bundlene har ulik livssyklus).
+//
+// Idempotens / vedlikehold (NFR): en eksisterende index.md sin `# overskrift`,
+// rotens `okf_version`-verdi, og menneske-skrevne beskrivelser for underkatalog-
+// pekere bevares; konsept-entries regenereres alltid fra frontmatter (autoritativ
+// kilde). Skriving er atomisk (temp + renameSync), jf. write-org-profile.mjs.
+//
+// Zero npm dependencies (node:-builtins).
+
+import { readdirSync, readFileSync, writeFileSync, existsSync, renameSync } from 'node:fs';
+import { join, basename } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { parseFrontmatter } from '../lib/frontmatter.mjs';
+
+export const OKF_VERSION = 'kb-layout-2026-06';
+
+// "strategisk-kontekst" -> "Strategisk kontekst"
+function titleFromName(name) {
+  const spaced = name.replace(/[-_]+/g, ' ').trim();
+  return spaced.charAt(0).toUpperCase() + spaced.slice(1);
+}
+
+// Parse en eksisterende index.md for bevaring: overskrift, okf_version, og
+// beskrivelser pr. lenke (for underkatalog-pekere). Kaster aldri.
+function parseExistingIndex(path) {
+  const result = { heading: null, okfVersion: null, descByLink: {} };
+  if (!existsSync(path)) return result;
+  for (const line of readFileSync(path, 'utf8').split('\n')) {
+    if (result.heading === null && line.startsWith('# ')) {
+      result.heading = line.slice(2).trim();
+    }
+    const ver = line.match(/^okf_version:\s*(.+)$/);
+    if (ver) result.okfVersion = ver[1].trim();
+    const entry = line.match(/^\*\s*\[([^\]]*)\]\(([^)]+)\)(?:\s*-\s*(.*))?$/);
+    if (entry) result.descByLink[entry[2]] = { title: entry[1], desc: (entry[3] || '').trim() };
+  }
+  return result;
+}
+
+// Bygg en enkelt entry-linje paa OKF-form. Tom beskrivelse -> dropp ` - d`.
+function entryLine(title, link, desc) {
+  return desc ? `* [${title}](${link}) - ${desc}` : `* [${title}](${link})`;
+}
+
+// Generer og skriv index.md for EN katalog (ikke rekursivt). isRoot styrer okf_version.
+function writeIndexFor(dir, isRoot, okfVersion) {
+  const existing = parseExistingIndex(join(dir, 'index.md'));
+  const dirents = readdirSync(dir, { withFileTypes: true });
+  const subdirs = dirents.filter((e) => e.isDirectory()).map((e) => e.name).sort();
+  const concepts = dirents
+    .filter((e) => e.isFile() && e.name.endsWith('.md') && e.name !== 'index.md')
+    .map((e) => e.name)
+    .sort();
+
+  const heading = existing.heading
+    || (isRoot ? 'OKF second brain' : titleFromName(basename(dir)));
+
+  const lines = [`# ${heading}`, ''];
+  if (isRoot) {
+    lines.push(`okf_version: ${existing.okfVersion || okfVersion}`, '');
+  }
+
+  for (const sd of subdirs) {
+    const link = `${sd}/index.md`;
+    const prev = existing.descByLink[link];
+    lines.push(entryLine(prev?.title || titleFromName(sd), link, prev?.desc || 'Underkatalog.'));
+  }
+  for (const c of concepts) {
+    const { get } = parseFrontmatter(readFileSync(join(dir, c), 'utf8'));
+    const title = get('title') || titleFromName(basename(c, '.md'));
+    lines.push(entryLine(title, c, get('description') || ''));
+  }
+
+  const content = `${lines.join('\n')}\n`;
+  const tmp = join(dir, `.index.md.${process.pid}.tmp`);
+  writeFileSync(tmp, content);
+  renameSync(tmp, join(dir, 'index.md'));
+}
+
+// Generer index.md for rot + alle underkataloger, rekursivt.
+export function generateIndexes(root, opts = {}) {
+  const okfVersion = opts.okfVersion || OKF_VERSION;
+  const walk = (dir, isRoot) => {
+    writeIndexFor(dir, isRoot, okfVersion);
+    for (const e of readdirSync(dir, { withFileTypes: true })) {
+      if (e.isDirectory()) walk(join(dir, e.name), false);
+    }
+  };
+  if (!existsSync(root)) throw new Error(`Bundle-rot finnes ikke: ${root}`);
+  walk(root, true);
+}
+
+// --- CLI ---
+const isMain = process.argv[1]
+  && fileURLToPath(import.meta.url) === process.argv[1];
+if (isMain) {
+  const root = process.argv[2];
+  if (!root) {
+    process.stderr.write('Bruk: node okf-index.mjs <bundle-rot> [--okf-version <ver>]\n');
+    process.exit(2);
+  }
+  const vi = process.argv.indexOf('--okf-version');
+  const okfVersion = vi !== -1 ? process.argv[vi + 1] : undefined;
+  generateIndexes(root, { okfVersion });
+  process.stdout.write(`OKF-index generert for ${root}\n`);
+}