feat(okr): /okr:innboks kommando (tynn wrapper, ASCII) [skip-docs]

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
Kjell Tore Guttormsen 2026-07-16 20:34:08 +02:00
commit 79d3c1ee64

57
commands/innboks.md Normal file
View file

@ -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.