diff --git a/commands/innboks.md b/commands/innboks.md new file mode 100644 index 0000000..21d2153 --- /dev/null +++ b/commands/innboks.md @@ -0,0 +1,57 @@ +--- +name: okr:innboks +description: Ingest dokumenter fra innboksen (.claude/okr/innboks/) til OKF-treet - deterministisk konvertering, splitting og indeksering +allowed-tools: Read, Bash, Glob +argument-hint: "(ingen argumenter - kommandoen leser hele innboksen)" +--- + +# OKR Innboks - Ingest droppede dokumenter til kunnskapstreet + +Kjoer dokumenter droppet i `.claude/okr/innboks/` gjennom den deterministiske +ingestion-pipelinen: konvertering (txt/md/docx/eml/pdf), heading-splitting, +OKF-frontmatter, relasjoner og indeksering. Originalene bevares alltid i +innboksen (ikke-destruktivt); hvert dokument valideres mot en streng +sikkerhetsgate og rulles tilbake alene hvis det feiler. + +"Auto-oppdage" betyr her: kommandoen walker hele drop-zonen naar den kjoeres og +tar alle droppede filer i ett sveip (ingen bakgrunns-daemon). Ukjente filtyper +skippes med beskjed, de feller aldri kjoeringen. + +## Forutsetninger + +- Node.js 22 eller nyere. +- For binaerformater (.docx/.eml/.pdf) trengs npm-avhengighetene: kjoer + `npm install --ignore-scripts` i plugin-rota FOERST. Rapporter + installasjonshintet til brukeren hvis skriptet melder at en avhengighet + mangler - installer ALDRI automatisk. +- Rene tekstfiler (.txt/.md) trenger ingen npm-avhengigheter. + +## Arbeidsflyt + +1. **Sjekk innboksen** - list filene med Glob (`.claude/okr/innboks/*`). Er den + tom, si det og stopp (ingen grunn til aa kjoere pipelinen). + +2. **Kjoer ingestion** via Bash: + ```bash + node ${CLAUDE_PLUGIN_ROOT}/scripts/innboks-ingest.mjs .claude/okr/innboks .claude/okr + ``` + +3. **Tolk exit-koden**: + - `0` - alle dokumenter ingested (eventuelle skip av ukjente filtyper er OK). + Oppsummer for brukeren: antall dokumenter, hvor konseptene havnet + (`strategisk-kontekst/`, `dokumenter/`, ...), og at originalene ligger + igjen i innboksen. + - `1` - minst ett dokument ble avvist av sikkerhetsgaten og rullet tilbake + (staar listet i output med aarsak), eller en skrivekollisjon mot en + haandkuratert fil ble avvist. Rapporter aarsaken per dokument. De oevrige + dokumentene er ingested som normalt. + - `2` - bruksfeil (innboks eller bundle-rot finnes ikke). Sjekk at + `.claude/okr/` er satt opp (`/okr:oppsett`). + +4. **Vis resultatet** - les rot-indeksen (`.claude/okr/index.md`) og nevn de + nye oppfoeringene. Ved behov kan brukeren finne igjen innholdet med + soeke-skillen (okr-second-brain-search). + +**Merk (v1-begrensninger):** PDF-er konverteres flatt (ett konsept per PDF, +ingen heading-splitting); vedlegg i .eml ignoreres. Beriket splitting kommer i +en senere versjon.