117 lines
4.3 KiB
JavaScript
117 lines
4.3 KiB
JavaScript
#!/usr/bin/env node
|
|
// syklus-rapport.mjs
|
|
// D5 steg 10: orkestrator for syklus-generatorene. Leser en syklus-katalog,
|
|
// bygger den forespurte rapportformen og persisterer den atomisk.
|
|
//
|
|
// Bruk:
|
|
// node syklus-rapport.mjs <syklus-dir> <form>
|
|
//
|
|
// Former: tertial | arsrapport | etatsstyring
|
|
// EN kommandoflate med argument, ikke tre kommandoer -- samme moenster som
|
|
// /okr:oppsett full|mvp|arkiver|oppdater|vis. Bare `tertial` er implementert
|
|
// i D5; arsrapport og etatsstyring kommer i steg 11-12 og svarer inntil da
|
|
// med exit 2 og en forklarende melding, aldri stum feil.
|
|
//
|
|
// Exit-koder (kontrakten commands/rapport.md mapper til norsk brukertekst):
|
|
// 0 rapporten er skrevet
|
|
// 1 domenefeil -- syklusdataene er ufullstendige eller ikke rapporterbare
|
|
// 2 bruksfeil -- feil aritet, ukjent/uimplementert form, katalog finnes ikke
|
|
//
|
|
// Klokke-soem: OKR_NOW (ISO-8601) overstyrer veggklokka, saa to kjoeringer over
|
|
// samme data gir byte-identisk fil (moenster: scripts/compose-org-profile.mjs:61).
|
|
//
|
|
// Zero npm dependencies.
|
|
|
|
import { existsSync, renameSync, statSync, unlinkSync, writeFileSync } from 'node:fs';
|
|
import { basename, join } from 'node:path';
|
|
import { fileURLToPath } from 'node:url';
|
|
|
|
import { writeFrontmatter } from '../lib/frontmatter.mjs';
|
|
import { lesSyklus } from '../lib/syklus-data.mjs';
|
|
import { tertialrapport } from '../lib/syklus-rapport.mjs';
|
|
|
|
const FORMER = {
|
|
tertial: {
|
|
filnavn: 'rapport-tertial.md',
|
|
tittel: (id) => `Tertialrapport ${id}`,
|
|
beskrivelse: 'Maskingenerert tertialrapport med committed og aspirational holdt fra hverandre.',
|
|
bygg: tertialrapport,
|
|
},
|
|
// Steg 11-12. Oppfoert her, ikke skjult, saa flaten er synlig foer den virker.
|
|
arsrapport: null,
|
|
etatsstyring: null,
|
|
};
|
|
|
|
class Bruksfeil extends Error {}
|
|
|
|
// Skrevet fil er OKF-konsept, ikke loes markdown: den lander INNE i bundlen, og
|
|
// en fil uten `type:` ville felt okf-check for hele roten. `type: Status` er
|
|
// dessuten riktig -- rapporten ER en statusflate, og blir retrievbar for
|
|
// okr-second-brain-search paa kjoepet.
|
|
// Filnavnet starter bevisst IKKE med `okr-`: ellers ville neste lesSyklus()
|
|
// plukket rapporten opp som en OKR-definisjon.
|
|
function komponer(form, syklus, naa) {
|
|
const frontmatter = writeFrontmatter({
|
|
type: 'Status',
|
|
resource: 'local',
|
|
title: form.tittel(syklus.id),
|
|
description: form.beskrivelse,
|
|
timestamp: naa,
|
|
});
|
|
return `${frontmatter}\n${form.bygg(syklus, { naa })}`;
|
|
}
|
|
|
|
// Atomisk skriv: temp i SAMME katalog (rename er kun atomisk innen filsystem),
|
|
// process.pid i navnet mot samtidige kjoeringer. Moenster: lib/innboks-write.mjs.
|
|
function skrivAtomisk(maal, innhold) {
|
|
const temp = `${maal}.${process.pid}.tmp`;
|
|
try {
|
|
writeFileSync(temp, innhold, 'utf8');
|
|
renameSync(temp, maal);
|
|
} catch (e) {
|
|
if (existsSync(temp)) {
|
|
try { unlinkSync(temp); } catch { /* opprydding er best-effort */ }
|
|
}
|
|
throw e;
|
|
}
|
|
}
|
|
|
|
export function genererRapport(syklusDir, formNavn, opts = {}) {
|
|
if (!syklusDir || !formNavn) {
|
|
throw new Bruksfeil('Bruk: node syklus-rapport.mjs <syklus-dir> <form>\n'
|
|
+ `Former: ${Object.keys(FORMER).join(' | ')}`);
|
|
}
|
|
if (!(formNavn in FORMER)) {
|
|
throw new Bruksfeil(`Ukjent form: ${formNavn}. Former: ${Object.keys(FORMER).join(' | ')}`);
|
|
}
|
|
const form = FORMER[formNavn];
|
|
if (form === null) {
|
|
throw new Bruksfeil(`Rapportformen «${formNavn}» er ikke implementert ennaa.`);
|
|
}
|
|
if (!existsSync(syklusDir) || !statSync(syklusDir).isDirectory()) {
|
|
throw new Bruksfeil(`Syklus-katalogen finnes ikke: ${syklusDir}`);
|
|
}
|
|
|
|
const naa = opts.naa || process.env.OKR_NOW || new Date().toISOString();
|
|
const syklus = lesSyklus(syklusDir);
|
|
const maal = join(syklusDir, form.filnavn);
|
|
skrivAtomisk(maal, komponer(form, syklus, naa));
|
|
return { fil: maal, syklus: syklus.id, okrer: syklus.okrer.length };
|
|
}
|
|
|
|
// --- CLI ---
|
|
const isMain = process.argv[1]
|
|
&& fileURLToPath(import.meta.url) === process.argv[1];
|
|
if (isMain) {
|
|
const [syklusDir, form] = process.argv.slice(2);
|
|
try {
|
|
const r = genererRapport(syklusDir, form);
|
|
process.stdout.write(
|
|
`Rapport skrevet: ${r.fil}\n Syklus: ${r.syklus}\n OKR rapportert: ${r.okrer}\n`,
|
|
);
|
|
process.exit(0);
|
|
} catch (e) {
|
|
process.stderr.write(`${basename(process.argv[1])}: ${e.message}\n`);
|
|
process.exit(e instanceof Bruksfeil ? 2 : 1);
|
|
}
|
|
}
|