feat(okr): arkivklar-rapport med bevaringskategorier som vurderingsgrunnlag

scripts/arkivklar.mjs

@@ -0,0 +1,68 @@
+#!/usr/bin/env node
+// arkivklar.mjs
+// D7 steg 18: orkestrator for /okr:arkivklar. Leser en OKF-bundle og skriver et
+// VURDERINGSGRUNNLAG mot bevaringsforskrifta -- aldri en avgjoerelse.
+//
+// Arbeidsdelingen foelger D6-beslutning 1: lib/arkivklar.mjs eier traversering,
+// klassifisering og rendring; dette skriptet eier disk-siden (hvor rota ligger,
+// hvor rapporten havner) og CLI-kontrakten.
+//
+// STDOUT ER DEFAULT, fil er opt-in. Kommandoen (/okr:arkivklar) deklarerer
+// verken Write eller Edit, og en verify-kjoering mot tests/fixtures/ skal ikke
+// kunne skitne til fixturen. Oppgis en rapport-fil, skrives den ATOMISK
+// (temp i samme katalog + renameSync) og ALDRI inn i bundlen selv.
+//
+// INGEN SLETTEMODELL FINNES HER, og ingen skal innfoeres. Retensjonsbehovet er
+// dekket av /okr:oppsett arkiver (arkivering av syklus) og /okr:export (uttrekk).
+// Kassasjon krever Nasjonalarkivets hjemmel etter arkivlova § 13 og er ikke en
+// operasjon dette verktoeyet kan ha.
+//
+// Exit: 0 = rapport produsert · 1 = uventet feil (inkl. confinement-brudd)
+//       2 = bruksfeil (manglende/ukjent sti)
+
+import { writeFileSync, renameSync, existsSync, statSync } from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+import { traverserBundle, rapport } from '../lib/arkivklar.mjs';
+
+// Atomisk: temp-fil i SAMME katalog, deretter renameSync over maalet.
+// Speiler write-org-profile.mjs:34-40 / innboks-write.mjs.
+function writeAtomic(target, data) {
+  const dir = path.dirname(target);
+  const tmp = path.join(dir, `${path.basename(target)}.${process.pid}.tmp`);
+  writeFileSync(tmp, data);
+  renameSync(tmp, target);
+}
+
+export function byggRapport(bundleRoot, opts) {
+  return rapport(traverserBundle(bundleRoot), opts);
+}
+
+// --- CLI ---
+const isMain = process.argv[1]
+  && fileURLToPath(import.meta.url) === process.argv[1];
+if (isMain) {
+  const [bundleRoot, rapportFil] = process.argv.slice(2);
+  if (!bundleRoot) {
+    process.stderr.write('Bruk: node arkivklar.mjs <bundle-rot> [rapport-fil]\n');
+    process.exit(2);
+  }
+  if (!existsSync(bundleRoot) || !statSync(bundleRoot).isDirectory()) {
+    process.stderr.write(`Finnes ikke (eller er ikke en katalog): ${bundleRoot}\n`);
+    process.exit(2);
+  }
+  try {
+    const ut = byggRapport(bundleRoot);
+    if (rapportFil) {
+      writeAtomic(path.resolve(rapportFil), ut);
+      process.stdout.write(`Arkivklar: vurderingsgrunnlag skrevet til ${rapportFil}\n`);
+    } else {
+      process.stdout.write(ut);
+    }
+    process.exit(0);
+  } catch (e) {
+    process.stderr.write(`arkivklar: ${e.message}\n`);
+    process.exit(1);
+  }
+}