57 lines
2.6 KiB
Markdown
57 lines
2.6 KiB
Markdown
# Agent Notes (InfraFabric Shadow Dossier Generator)
|
|
|
|
This repo generates **Shadow Dossiers** by applying versioned style bibles (e.g., IF.DAVE) to extracted source documents.
|
|
|
|
## Current “Dave” baseline
|
|
|
|
- Latest bible: `style_bibles/IF_DAVE_BIBLE_v1.9.md` (`if://bible/dave/v1.9`)
|
|
- Public static copy: https://infrafabric.io/static/hosted/bibles/IF_DAVE_BIBLE_v1.9.md
|
|
- v1.8 generator behavior (implemented in `src/revoice/generate.py`):
|
|
- Adds `MIRROR COMPLETENESS: OK|DEGRADED` (and optional hard fail via `REVOICE_QUALITY_GATE=1`)
|
|
- Adds `## Claims Register (source-attributed)` for measurable claims (numbers, %, tiers, retention windows)
|
|
- Defaults Action Pack ON for v1.8 (disable via `REVOICE_NO_ACTION_PACK=1`)
|
|
- Domain-aware Action Pack gates: hardware/identity, sensors/enforcers, detection/analysis, automation/agentic
|
|
|
|
## Static hosting (critical trap)
|
|
|
|
Public static mirror is served from `pct 210:/srv/hosted-static/public` at:
|
|
- `https://infrafabric.io/static/hosted/…`
|
|
|
|
There is a sync job that mirrors `https://git.infrafabric.io/danny/hosted.git` into `/srv/hosted-static/public` every ~5 minutes.
|
|
|
|
**Important:** The sync uses `rsync --delete`, so anything not in the mirrored repo would normally be removed. To keep operator-generated review artifacts stable, the sync script now excludes:
|
|
- `bibles/`
|
|
- `review/`
|
|
|
|
So **publish operator-generated bibles/review packs under**:
|
|
- `/srv/hosted-static/public/bibles/…`
|
|
- `/srv/hosted-static/public/review/…`
|
|
|
|
## Week review packs (v1.8)
|
|
|
|
Week v1.8 packs are published here:
|
|
- Index: `https://infrafabric.io/static/hosted/review/week-v1.8/2025-12-27/index.md`
|
|
- Full single-file bundle: `https://infrafabric.io/static/hosted/review/week-v1.8/2025-12-27/week.pack.md`
|
|
|
|
Each day also has:
|
|
- `/<day>.pack.md` (offline-friendly; embeds source + dossier + trace + marketing thread)
|
|
- `/<day>.shadow.md`
|
|
- `/<day>.trace.json`
|
|
- `/<day>.marketing.md`
|
|
|
|
## Week review packs (v1.9)
|
|
|
|
Week v1.9 packs are published here:
|
|
- Index: `https://infrafabric.io/static/hosted/review/week-v1.9/2025-12-28/index.md`
|
|
- Full single-file bundle: `https://infrafabric.io/static/hosted/review/week-v1.9/2025-12-28/week.pack.md`
|
|
|
|
## Week pack generator (local)
|
|
|
|
To regenerate a week bundle locally (and then publish to hosted-static), use:
|
|
- `re-voice/tools/week_pack/build_week.py`
|
|
|
|
## OpSec / sharing rules
|
|
|
|
- Do not leak internal hostnames, paths, container IDs, or pipeline errors into outputs.
|
|
- For external reviewers, prefer **static** review packs (`/static/hosted/review/...`) or red-team app bundles (`/static/pack/<id>.md`).
|
|
- Avoid deep-linking Forgejo for public review; use `infrafabric.io/static/...` mirrors instead.
|