re-voice/AGENTS.md

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.