Skip to content

docs: reconcile against v0.3.0 source repos (Research Facility, Dashboard V2, promising signals counts)#2

Merged
alias8818 merged 1 commit into
mainfrom
docs/audit-reconcile-source-repos-2026-05-21
May 21, 2026
Merged

docs: reconcile against v0.3.0 source repos (Research Facility, Dashboard V2, promising signals counts)#2
alias8818 merged 1 commit into
mainfrom
docs/audit-reconcile-source-repos-2026-05-21

Conversation

@alias8818
Copy link
Copy Markdown
Owner

@alias8818 alias8818 commented May 21, 2026

Summary

Reconciled enoch-docs against three source repos to verify every public claim. All changes are source-grounded — nothing was invented.

Source repos audited

Repo Key files
enoch-agentic-research-system (v0.3.0) README.md, CHANGELOG.md, VERSION, config.example.json, docs/research-facility.md, docs/dashboard-v2-todo-2026-05-21.md, docs/current-runtime-snapshot.md, enoch_control_plane/ source tree
enoch-ai-research-corpus README.md, quality/claim_evidence_audit.json (388 rows, 388/388 strict pass), papers/ (388 dirs counted)
enoch-promising-signals README.md, data/manifest.json (519 signals, 452 useful_signal, 67 compute_scale_blocked), schemas/promising-signal.schema.json

Changes

Modified (5)

  • AGENTS.md — Replaced empty Mintlify placeholders with real project terminology, style rules, and content boundaries
  • concepts/control-plane.mdx — Referenced Dashboard V2 explicitly (/control/dashboard-v2), added v1 read-model lane note
  • guides/idea-intake.mdx — Updated intake stages diagram to show Research Facility upstream; cross-reference link
  • reference/promising-signals.mdx — Added current 519-signal export counts, 5 curation buckets, regeneration commands, and source file links (all verified from data/manifest.json)
  • docs.json — Added concepts/research-facility to Core Concepts nav

Added (2)

  • concepts/research-facility.mdx — New page: 4 ledgers (source/candidate/admission/lineage), 7 generation modes, candidate contract, bounded cycle endpoint with default policy, provider-backed generation flow, guardrails
  • docs-audit-notes.md — Full reconciliation summary with source authority mapping, verification results, and remaining uncertainties

Validation

Check Result
MDX frontmatter 21/21 files have valid title
Internal links 0 broken links across all pages
Image references All 5 resolve to existing PNGs
Nav coverage 20/20 nav entries resolve
Stale terms (TODO, FIXME, coming soon) None found
wake_gate / omx_wake_gate Correctly marked as compatibility/historical
Private LAN IPs / internal hostnames None leaked into docs text
Private secrets / tokens None present

Remaining uncertainties

  1. Corpus docs/reproducibility.md still says "496/496" — stale in the corpus repo, not fixed here.
  2. Hugging Face export referenced in evidence-and-artifacts.mdx was not independently verified.
  3. Dashboard screenshots (5 PNGs) assumed representative; not visually compared against live V2.
  4. Paper/artifact counts (388/388) verified from claim_evidence_audit.json. Counts change on re-import.

What was not changed

  • No pages removed — all existing pages are still accurate.
  • No stale roadmap/backlog pages found to remove.
  • No double-check on the Hugging Face export pipeline.
  • No capability claims invented or guessed.

Note

Low Risk
Low risk documentation-only updates; main risk is minor user confusion if any counts/paths change upstream after this snapshot.

Overview
Reconciles public docs language and claims against audited v0.3.0 sources. AGENTS.md replaces Mintlify placeholders with project terminology, writing standards, and documentation boundaries.

Adds a new Research Facility core concept page describing candidate generation/admission/promotion (ledgers, modes, guardrails, and bounded-cycle endpoints), links it into the nav (docs.json), and updates guides/idea-intake.mdx to show the facility as the upstream intake stage.

Updates concepts/control-plane.mdx to explicitly name Dashboard V2 (/control/dashboard-v2) as the canonical operator shell and note that operator lanes consume bounded /control/api/v1/* read models, and refreshes reference/promising-signals.mdx with verified export counts/buckets plus regeneration + validation commands. Adds docs-audit-notes.md capturing the audit sources, checks run, and remaining uncertainties.

Reviewed by Cursor Bugbot for commit ef3bb55. Bugbot is set up for automated code reviews on this repo. Configure here.

…oard V2, promising signals counts)

Reconciled enoch-docs against three source repos and verified all claims.
Updated AGENTS.md with real project terminology and content boundaries.
Added Research Facility concept page covering ledgers, generation modes,
bounded cycle, and guardrails (sourced from enoch-agentic-research-system/docs/research-facility.md).
Updated control-plane page to reference Dashboard V2 explicitly.
Updated idea-intake intake stages diagram to show Research Facility upstream.
Updated promising-signals page with verified current export counts (519
signals, 452 useful_signal, 67 compute_scale_blocked) from manifest.json.
Updated docs.json navigation to include new Research Facility page.
Added docs-audit-notes.md summarizing reconciliation and remaining uncertainties.

Validation: 21 MDX files, 20 nav entries, 0 broken links, 0 stale terms,
0 leaked internal hostnames/IPs.

Co-authored-by: factory-droid[bot] <138933559+factory-droid[bot]@users.noreply.github.com>
@mintlify
Copy link
Copy Markdown

mintlify Bot commented May 21, 2026

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
solo-09d10f60 🟢 Ready View Preview May 21, 2026, 7:22 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.

@alias8818 alias8818 merged commit 7530cd3 into main May 21, 2026
3 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant