docs: reconcile against v0.3.0 source repos (Research Facility, Dashboard V2, promising signals counts)#2
Merged
Conversation
…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>
|
Preview deployment for your docs. Learn more about Mintlify Previews.
💡 Tip: Enable Workflows to automatically generate PRs for you. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Reconciled
enoch-docsagainst three source repos to verify every public claim. All changes are source-grounded — nothing was invented.Source repos audited
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 treeenoch-ai-research-corpusREADME.md,quality/claim_evidence_audit.json(388 rows, 388/388 strict pass),papers/(388 dirs counted)enoch-promising-signalsREADME.md,data/manifest.json(519 signals, 452 useful_signal, 67 compute_scale_blocked),schemas/promising-signal.schema.jsonChanges
Modified (5)
AGENTS.md— Replaced empty Mintlify placeholders with real project terminology, style rules, and content boundariesconcepts/control-plane.mdx— Referenced Dashboard V2 explicitly (/control/dashboard-v2), added v1 read-model lane noteguides/idea-intake.mdx— Updated intake stages diagram to show Research Facility upstream; cross-reference linkreference/promising-signals.mdx— Added current 519-signal export counts, 5 curation buckets, regeneration commands, and source file links (all verified fromdata/manifest.json)docs.json— Addedconcepts/research-facilityto Core Concepts navAdded (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, guardrailsdocs-audit-notes.md— Full reconciliation summary with source authority mapping, verification results, and remaining uncertaintiesValidation
titleTODO,FIXME,coming soon)wake_gate/omx_wake_gateRemaining uncertainties
docs/reproducibility.mdstill says "496/496" — stale in the corpus repo, not fixed here.evidence-and-artifacts.mdxwas not independently verified.claim_evidence_audit.json. Counts change on re-import.What was not changed
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.mdreplaces Mintlify placeholders with project terminology, writing standards, and documentation boundaries.Adds a new
Research Facilitycore concept page describing candidate generation/admission/promotion (ledgers, modes, guardrails, and bounded-cycle endpoints), links it into the nav (docs.json), and updatesguides/idea-intake.mdxto show the facility as the upstream intake stage.Updates
concepts/control-plane.mdxto 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 refreshesreference/promising-signals.mdxwith verified export counts/buckets plus regeneration + validation commands. Addsdocs-audit-notes.mdcapturing 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.