57 lines
2.5 KiB
Markdown
57 lines
2.5 KiB
Markdown
---
|
|
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.
|