okr/commands/innboks.md
2026-07-16 20:34:08 +02:00

2.5 KiB

name description allowed-tools argument-hint
okr:innboks Ingest dokumenter fra innboksen (.claude/okr/innboks/) til OKF-treet - deterministisk konvertering, splitting og indeksering Read, Bash, Glob (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:

    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.