docs: refresh against v1.41.25 ground truth (2026-06-20)#3
Merged
Conversation
Source repos updated since the 2026-05-21 audit; this refresh grounds
the public docs against the current runtime.
Verified against:
- alias8818/enoch-agentic-research-system VERSION=1.41.25 (2026-06-20)
- alias8818/enoch-agentic-research-system docs/current-runtime-snapshot.md
- alias8818/enoch-agentic-research-system config.example.json
- alias8818/enoch-agentic-research-system docs/openapi.json
- alias8818/enoch-ai-research-corpus quality/{packaging_provenance_report,
claim_evidence_audit}.json
- alias8818/enoch-promising-signals data/manifest.json
Concrete fixes:
- release-notes.mdx: add current version pointer (1.41.25, 2026-06-20)
and reference canonical CHANGELOG.md for full version history.
- current-runtime-snapshot.mdx: document Dashboard V2 cutover
(/control/dashboard 307 -> /control/dashboard-v2), surface the
'enoch-core.exe.xyz' private alias as a non-public fact, add an
operator-dashboard table.
- introduction.mdx: corpus counts 388/388 -> 389/389, add Note that
the JSON files are the source of truth.
- quickstart.mdx: redirect -> /control/dashboard-v2, note token-length
parity with source repo quickstart (32 vs 48).
- deployment.mdx: dashboard URL -> /control/dashboard-v2.
- configuration/overview.mdx: add operational_trace_* and
hermes_alert_webhook_* field groups that exist in source config but
were missing from the docs.
- reference/api-endpoints.mdx: include /control/dashboard-v2 among
unauthenticated dashboard shell paths.
- index.mdx: dashboard mention -> Dashboard V2.
Screenshots: all five PNGs in images/ currently expose the
compatibility-only 'Supabase' footer string and internal paper IDs/counts
that drift over time. Added explicit <Info> placeholders in dispatch-flow,
paper-artifacts, and authorship-provenance noting each image is pending
replacement with a redacted, public-safe capture.
docs-audit-notes.md: appended a 2026-06-20 section cataloguing the drift
and what remains open (screenshot replacement, continued CHANGELOG.md
mirroring policy).
Validation: node scripts/validate-docs.mjs passes (22 MDX files, 21 nav
entries).
Co-Authored-By: Claude <noreply@anthropic.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
Full Mintlify docs refresh against the current source-repo ground truth. Every page in
enoch-docswas cross-checked against the system repo (enoch-agentic-research-system, v1.41.25, 2026-06-20), the corpus repo (enoch-ai-research-corpus), and the promising-signals repo (enoch-promising-signals). 12 files changed, +96 / -12.What changed
Source-grounded fixes (committed)
<Info>pointing to canonicalCHANGELOG.mdand surfacing the actual current version (1.41.25, 2026-06-20). The old page listed only milestones through 0.3.0, while the system repo has 176 published entries. We keep the 0.1.0 / 0.2.0 / 0.3.0 entries because they introduced public terminology (ENOCH_CONFIG,control_api_bearer_token,.enoch/project_decision.jsoncontract), but the canonical changelog is now the source of truth for version history./control/dashboard307 →/control/dashboard-v2, merged 2026-05-21). Surfaces the private deploy aliasenoch-core.exe.xyzas a non-public fact. Adds an operator-dashboard table.quality/packaging_provenance_report.jsonandquality/claim_evidence_audit.json). Adds a<Note>that both JSON files are the source of truth and that counts must be re-verified before external quoting./control/dashboard-v2. Added a<Note>that the source repo'sdocs/quickstart.mduses 32-byte tokens while this page (anddocs/deployment-guide.md) use 48-byte tokens; both are valid./control/dashboard-v2.operational_trace_*andhermes_alert_webhook_*field groups that exist inenoch_control_plane/config.pyandconfig.example.jsonbut were missing from the docs./control/dashboard-v2to the unauthenticated dashboard shell paths list.Screenshot redaction — public-repo safety (placeholders committed; replacements still pending)
All five PNGs in
images/currently leak details that conflict with this repo's public-facing framing:dashboard-status-blocked.pngdashboard-active-queue.pngdashboard-queued-queue.pngdashboard-paper-reviews.pngdashboard-papers.pngThese images are still referenced from
guides/dispatch-flow.mdx,guides/paper-artifacts.mdx, andreference/authorship-provenance.mdx. Each reference now has an explicit<Info>block noting the PNG is pending replacement with a redacted, public-safe capture (re-captured after the V2 cutover, with the "Supabase" footer removed or relabeled).This PR does not replace the PNGs — replacing them requires re-running
dashboard_v2_smoke.pyagainst a public-safe view and exporting fresh captures. That work is tracked indocs-audit-notes.mdunder "What remains open" so a follow-up PR can land the actual image swaps.Validation
node scripts/validate-docs.mjspasses (22 MDX files, 21 docs.json navigation entries).Out of scope (per the original task)
This PR does not modify anything outside
enoch-docs/. Source repos, scripts in/home/jeremy/Desktop/projects/enoch-release/, and parent-folder scratch files were read for fact-checking only.Reviewer checklist
release-notes.mdxmatches the team's preferred CHANGELOG mirroring policy.current-runtime-snapshot.mdxoperator-dashboard table reads correctly on Mintlify render.<Info>block) is acceptable; if you'd rather we replace the PNGs in this PR, please flag and we'll generate redacted captures from a public-safe dashboard view.configuration/overview.mdxJSON example for the newoperational_trace_*block against the latestconfig.example.jsonfrom the system repo.introduction.mdx389/389 counts against the canonical JSON files in the corpus repo before merging.🤖 Generated with Claude Code