# 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.8.md` (`if://bible/dave/v1.8`)
- Public static copy: https://infrafabric.io/static/hosted/bibles/IF_DAVE_BIBLE_v1.8.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`

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