Vault Renderer Outputs — fin-central-intranet
This document lists vault-MD outputs produced by the tenant projector (deferred per ENGINEERING_SPEC §11.7 / FROZEN-INTENTIONAL). For the live DB CQRS projection layer, see audit/card-window-system/approved-projection-tables.json in fin-agentic.
Local index of agent-projected docs that land in this vault, scoped to FIN Central concerns (canonical Taproot, anonymized aggregates, platform observability).
Master source:
fin-agentic/docs/projections/PROJECTION_CATALOG_2026-05-15.md. This index mirrors the Central-relevant subset.
Reading this index
- Status —
LIVE(renderer + landing dir exist, has content),PLANNED(designed but renderer not yet wired or landing dir absent),FROZEN(gated by external work, e.g. anonymization verifier + multi-tenant) - Next-action gate — the single trigger that flips a PLANNED/FROZEN entry to LIVE
- Cadence — when the projection re-renders
- doc_kind — frontmatter
doc_kindvalue - Sources — event/signal rows that feed it
- Lands at — directory in this repo where the renderer deposits the doc
- Wave — sprint phase when activated
Audit reconciliation (FCI-A-04, 2026-05-23): Prior to this revision, this index advertised ~18 landing paths; on-disk verification showed ~12 of those directories did not exist. Each projection is now explicitly tagged with current state. Do not delete planned entries — they document the renderer roadmap; just don’t read a row as “shipped” unless it is tagged LIVE.
§1 Plane 3 — Taproot canonical entity profiles
These are the canonical authored-and-projected entity profiles. Authoring happens here; Tenant intranets mirror this content read-only.
| Projection | Status | doc_kind | Cadence | Lands at | Wave | Next-action gate |
|---|---|---|---|---|---|---|
commodity_profile.<commodity_id> | LIVE (101 docs on disk) | entity_profile | event-driven + manual refresh | docs/entity_profiles/commodities/<commodity_id>.md | W1 (watermelon first) | — already shipped |
variety_profile.<variety_id> | LIVE (244 docs on disk) | entity_profile | event-driven | docs/entity_profiles/varieties/<variety_id>.md | W2 | — already shipped |
vendor_profile.<vendor_id> | LIVE (142 docs on disk) | entity_profile | event-driven | docs/entity_profiles/vendors/<vendor_id>.md | W2 | — already shipped (see FCI-A-05/A-06 caveats re visibility label + provenance) |
customer_profile.<customer_id> (canonical / aggregate) | PLANNED (dir absent) | entity_profile | event-driven | docs/entity_profiles/customers/<customer_id>.md | W3 | when this lights up: first multi-tenant customer-360 projection commits a customer_profile.* doc |
region_intelligence.<region_id> | PLANNED (dir absent) | entity_profile | weekly | docs/entity_profiles/regions/<region_id>.md | W2 | when this lights up: region-renderer worker is enabled in agent runtime + first region entity is upserted into knowledge |
season_window.<window_id> | PLANNED (dir absent) | entity_profile | monthly | docs/entity_profiles/seasons/<window_id>.md | W2 | when this lights up: season-window registry seeded in knowledge.domain = season_window |
grower_profile.<grower_id> | PLANNED (dir absent) | entity_profile | event-driven | docs/entity_profiles/growers/<grower_id>.md | W2-W3 | when this lights up: grower entity domain is added to knowledge and grower-renderer is registered |
certification_profile.<cert_id> | PLANNED (dir absent) | entity_profile | annual | docs/entity_profiles/certifications/<cert_id>.md | W3 | when this lights up: certification taxonomy is seeded + annual-cadence renderer worker is enabled |
§2 Plane 3 — Aggregate intelligence (Harvest Directory) — FROZEN
FROZEN — entire section. Per §9 below and
feedback_federation_publisher_frozen.md, alldocs/aggregate_intelligence/*outputs are gated by the anonymization verifier (Slice 7) AND the N≥3-tenant minimum. At single-tenant state the projector emits and holds in a staging area; nothing publishes to this vault. Onlydocs/aggregate_intelligence/README.mdexists on disk.
Anonymized aggregates published to public Tier 0 MCP. Subject to the anonymization policy: N≥3 tenants, 7-day minimum lag, default-deny on field disposition.
| Projection | Status | doc_kind | Cadence | Lands at | Wave | Next-action gate |
|---|---|---|---|---|---|---|
commodity_situation.<commodity_id>.<year-week> | FROZEN (dir absent) | aggregate_intelligence | weekly | docs/aggregate_intelligence/commodity-situation/<commodity_id>/YYYY-WW.md | W3 | when this lights up: anonymization verifier (Slice 7) goes live AND tenant_count ≥ 3 for the commodity |
commodity_seasonal_outlook.<commodity_id>.<year> | FROZEN (dir absent) | aggregate_intelligence | annual + monthly refresh | docs/aggregate_intelligence/seasonal-outlook/<commodity_id>-YYYY.md | W3 | when this lights up: same gate as commodity_situation above (Slice 7 + N≥3 tenants) |
region_outlook.<region_id>.<year-week> | FROZEN (dir absent) | aggregate_intelligence | weekly | docs/aggregate_intelligence/region-outlook/<region_id>/YYYY-WW.md | W3 | when this lights up: regions entity domain seeded (see §1) + Slice 7 verifier live + N≥3 tenants per region |
§3 Open corpus / Tier 0 exports — FROZEN
| Projection | Status | doc_kind | Cadence | Lands at | Wave | Next-action gate |
|---|---|---|---|---|---|---|
open_corpus_export.<version> | FROZEN (dir absent) | open_corpus_export | versioned releases | docs/aggregate_intelligence/open-corpus/<version>.md | W3-W4 | when this lights up: all §2 aggregate_intelligence renderers unfreeze (same anonymization gate) AND a release-versioning policy is approved |
§4 Platform observability (cross-tenant)
| Projection | Status | doc_kind | Cadence | Lands at | Wave | Next-action gate |
|---|---|---|---|---|---|---|
kb_health_summary | PLANNED (docs/runbooks/observability/ absent) | system_projected | hourly | docs/runbooks/observability/kb-health.md (overwrite) | W1 (existing migration 043) | when this lights up: kb-health renderer worker is enabled in agent runtime AND landing dir is created |
channel_health.<tenant> | PLANNED (docs/runbooks/observability/ absent) | system_projected | hourly per-tenant | docs/runbooks/observability/channel-health-<tenant>.md | W1-W2 | when this lights up: per-tenant channel telemetry consumer is wired AND landing dir is created |
tenant_readiness.<tenant> | PLANNED (docs/runbooks/observability/ absent) | system_projected | daily | docs/runbooks/observability/tenant-readiness-<tenant>.md | W2 | when this lights up: tenant onboarding readiness aggregator runs at least one tenant-wide pass |
agent_enrichment_metrics | PLANNED (docs/runbooks/observability/ absent) | system_projected | hourly | docs/runbooks/observability/agent-enrichment.md | W2 | when this lights up: agent harness emits agent.enrichment_completed events at production volume |
federal_readiness_tracker | PLANNED (docs/runbooks/observability/ absent) | system_projected | weekly | docs/runbooks/observability/federal-readiness.md | W4 | when this lights up: federal-grade evidence requirements are formalized AND first audit window opens |
§5 Onboarding & adoption (cross-tenant rollup)
| Projection | Status | doc_kind | Cadence | Lands at | Wave | Next-action gate |
|---|---|---|---|---|---|---|
cohort_status.<tenant> | PLANNED (docs/runbooks/onboarding/ absent) | system_projected | daily | docs/runbooks/onboarding/cohort-<tenant>.md | W2 | when this lights up: cohort-onboarding event vocabulary is emitted across ≥1 tenant cohort AND landing dir is created |
Per master catalog §6.8 — aggregates onboarding events across cohort actors, surfaces lagging actors + common blockers + suggested interventions. The per-actor onboarding_progress lands in the tenant intranet, not here.
§6 Agent harness session journals (Central-tenant sessions)
| Projection | Status | doc_kind | Lands at | Next-action gate |
|---|---|---|---|---|
agent_harness_session.<session_id> (FIN Central agent sessions only) | PLANNED (docs/runbooks/sessions/ absent) | session_journal | docs/runbooks/sessions/<session_id>.md | when this lights up: agent harness session-journal renderer is enabled AND landing dir is created |
Tenant agent sessions land in their respective tenant intranets, not here.
§7 Authored doc families (human-written, not projected) — LIVE
These doc kinds ARE in the catalog (§6.4) but are AUTHORED on commit, not rendered by the projector. The webhook ingest treats them as authoritative. All families below have content on disk today.
| Doc family | Status | doc_kind | Folder | Notes |
|---|---|---|---|---|
decision_record.<topic>.<date> | LIVE (7 ADRs on disk) | decision_record | docs/decisions/ | ADR-style: context / options / decision / consequences / citations. FIN-level architectural + business decisions. |
runbook.<process> | LIVE (3 runbooks on disk) | runbook | docs/runbooks/ | Platform operational runbooks (e.g., Phase 1 demarcation, Hyperdrive provisioning, multi-tenant cutover). Subfolders observability/, onboarding/, sessions/ are PLANNED — see §4/§5/§6. |
sop.<role>.<process> | LIVE (3 SOP templates on disk) | sop | docs/sops/ | Role-universal SOP TEMPLATES (qc_inspector, foreman, buyer; receiver, box_man, porter, driver, dock_worker still PLANNED). Tenant intranets customize these with tenant-specific door numbers, role hierarchy, contacts. |
| Reference | PLANNED (docs/reference/ exists; content sparse) | authored | docs/reference/ | Specs, schemas, glossaries — next-action gate: first reference doc commit. |
| Policies | LIVE (docs/policies/anonymization/ populated) | authored | docs/policies/ | Anonymization, federal-audience, data-retention. |
§8 Reserved / deferred (per master catalog §6.9 + §6.10) — PLANNED
Acknowledged but not active in this vault yet:
| Projection | Status | Wave | Notes / next-action gate |
|---|---|---|---|
marketplace_match_log.<offer_id> | PLANNED | W4 | FIN operator audience — gate: marketplace product surface is built and first match log is generated |
marketplace_blind_intelligence.<commodity>.<window> | PLANNED / FROZEN (same anonymization gate as §2) | W4 | Public anonymized aggregate — gate: §2 anonymization verifier unfreezes |
| Cross-analysis embedded fields (commodity_season_heatmap, vendor_commodity_fulfillment_quality, region_commodity_pricing_intelligence, customer_commodity_loyalty, lot_lineage_waterfall, co_occurrence_graph, customer_substitution_patterns) | PLANNED | catalog v0.2 | Composed inside parent entity profiles in docs/entity_profiles/ — not separate docs. Gate: catalog v0.2 ships + parent renderers are extended to embed these sections. |
open_corpus_export.<version> is listed in §3 above but also gets embedded contribution from these cross-analysis fields | FROZEN | W3-W4 | Same anonymization gate as §3. |
§9 Catalog ↔ index drift guard
The renderer version registry at docs/projections/renderer-versions.md (separate file, planned for Wave 1) tracks per-projection renderer history. The catalog references it; this index does not duplicate it.
§10 Event digests — agentic newsroom (produced in fin-agentic CI)
Added 2026-07-02 (NEWSROOM N-04). Unlike §1–§6 these are NOT rendered by the tenant projector: they are generated by GitHub Actions in
fin-agentic(scripts/maint/generate-gh-digest.tsvia.github/workflows/gh-activity-digest.yml) and pushed into this vault through the GitHub Contents API (idempotent atomic upsert, 409-retry, cumulativeINDEX.mdMOC with prev/next chaining). The webhook ingest treats them like any other vault doc (knowledge.domain = 'doc').Honest producer note (2026-07-02): the scheduled workflow failed 8 consecutive runs 2026-06-27 → 2026-07-02 (missing
DIGEST_GH_TOKENorg-search auth; silent — no failure alerting), so on-disk content is frozen at daily 2026-06-25 / weekly 2026-W26 until fin-agentic NEWSROOM slices N-01 (auth restore) + N-03 (backfill) land.
| Projection | Status | doc_kind | Cadence | Lands at | Wave | Next-action gate |
|---|---|---|---|---|---|---|
github_activity_digest_daily_<YYYY_MM_DD> | LIVE (2 docs on disk: 2026-06-24, 2026-06-25; producer dark — see note) | event_digest (digest_type: daily) | daily @ 11:00 UTC (digests the completed prior day) | docs/digests/github-activity/daily/<YYYY-MM-DD>.md | NEWSROOM N0 | resumes when N-01 restores DIGEST_GH_TOKEN auth; N-03 backfills 2026-06-26 → present |
github_activity_digest_weekly_<YYYY_Wnn> | LIVE (1 doc on disk: 2026-W26; producer dark — see note) | event_digest (digest_type: weekly) | weekly @ Mon 12:00 UTC (last ISO week) | docs/digests/github-activity/weekly/<YYYY-Wnn>.md | NEWSROOM N0 | same gate as daily (N-01 + the N-03 backfill of 2026-W27) |
github_activity_digest_monthly_<YYYY_MM> | PLANNED (dir absent — no monthly run has completed yet) | event_digest (digest_type: monthly) | monthly @ 1st 13:00 UTC (prior month) | docs/digests/github-activity/monthly/<YYYY-MM>.md | NEWSROOM N0 | when this lights up: first monthly scheduled run (or the N-03 backfill of 2026-06) deposits a doc |
github_activity_digest_index | LIVE (cumulative MOC on disk) | authored (auto-maintained by the digest producer) | rewritten on every digest run | docs/digests/github-activity/INDEX.md | NEWSROOM N0 | — already shipped |
| Editorials family (newsroom dispatches) | PLANNED (dir absent) | TBD by the N-05 newsroom contract | weekly/monthly + on-demand | docs/digests/editorials/ | NEWSROOM N1–N2 | when this lights up: N-05 authority bundle (voice/anatomy/scorecard) is owner-approved AND the first promoted editorial dispatch lands (N1/N2 slices) |
Program provenance: fin-agentic docs/programs/FIN_AGENTIC_NEWSROOM_EXECUTION_PROGRAM_2026-07-02.md (+ proof tracker FIN_NEWSROOM_PROGRAM_PROOF_TRACKER.md).
Conventions
- Projection-rendered docs include
generated_by+projection_versionin frontmatter. Don’t hand-edit — overwritten on next render. - Authored docs are silent about
generated_by. - Mixed docs use
<!-- BEGIN PROJECTED -->/<!-- END PROJECTED -->markers per Engineering Spec §3.4; projector replaces only marked sections. - Status discipline (FCI-A-04 reconciliation): before marking any §1–§8 entry as
LIVE, verify (a) the landing dir exists on disk and (b) at least one non-README doc has been deposited. Otherwise it staysPLANNEDorFROZEN.
Anonymization gate (aggregate_intelligence only)
Every doc in docs/aggregate_intelligence/ passes through the anonymization verifier (Slice 7 — currently frozen per feedback_federation_publisher_frozen.md until multi-tenant). At single-tenant state, NO aggregate_intelligence docs are published; the projector emits but holds them in a staging area until the gate flips. This is the explicit reason §2/§3 are tagged FROZEN above.
Update cadence
This index updates when projections are added, retired, or relocated in the master catalog, AND whenever a PLANNED/FROZEN entry transitions to LIVE. Always cross-check against the master catalog for authoritative shape contracts.
Last revised: 2026-07-02 (NEWSROOM N-04 — §10 github-activity event-digest family registered; prior: 2026-05-23 FCI-A-04 reconciliation — LIVE/PLANNED/FROZEN tags added; original bootstrap 2026-05-15)