justin/morpheus-docs
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
20 Commits 2 Branches 0 Tags
1286cb7fdd981be20e66402277a131a8fb2a83b5
Commit Graph
20 Commits
This Branch
This Branch
All Branches
Author SHA1 Message Date
claudejustinClaude Opus 4.8
 		1286cb7fdd fix(scrape): make vision OCR a per-bundle allowlist, not a corpus sweep 
The first vision pass OCR'd every large image and, because the "transcribe
the table" prompt makes qwen render ANY image as a markdown table, it turned
60 product UI screenshots into junk "tables" in the corpus. In practice the
only image-only DATA in this corpus is the release-schedule matrix — the
upgrade-compatibility matrices etc. are already native HTML tables, no OCR
needed.

- Add BundleSpec.ocr (default False); the runner passes the OCR-enabling
  session only for bundles that opt in. Set ocr=True only on
  morpheus_release_schedule.
- Purge the 60 screenshot cache entries (keep the release-schedule one). The
  next --force refresh regenerates every other page's .md WITHOUT the bogus
  "## Image transcriptions" section, cleaning the deployed corpus + index.
- Update vision.py / refresh.yml docs to the allowlist model.

Also add scripts/vision_report.py — a self-contained HTML report pairing each
OCR'd source image with its transcription (uncertain-first) for accuracy
inspection. Regenerate anytime from corpus/.vision-cache/.

Verified: release schedule still transcribes (cache hit); cache is back to 1
entry; other bundles now pass no session so their images are left alone.

Co-Authored-By: Claude Opus 4.8 <[email protected]>
Claude-Session: https://claude.ai/code/session_01LFowQzJu7k97QLCRDSAeh1
 2026-08-06 11:38:50 -04:00
claude 43d891968e fix(ci): derive image name from $GITHUB_REPOSITORY, not the event payload (#7) 
Co-authored-by: claude <[email protected]>
 2026-08-06 10:56:56 -04:00
hvm-docs-refresh 24fb31427e weekly refresh: 2026-08-03T06:49Z — 141 content change(s) across 4 bundle(s) 
141 content change(s) across 4 bundle(s)
637 sidecar metadata update(s)
1 new bundle(s) added
1 other file change(s)

Bundles with content changes:
  morpheus_user_manual_8_1_0: 24 page(s)
    - GUID-10D04894-711A-400A-98A7-A3DECE437CDA
    - GUID-17E0EBC8-A495-4198-82BD-63D9D38D6F74
    - GUID-27FB9EA7-F54A-4B56-B3C8-0E5BF78A62C6
    - GUID-3159C5BA-04D5-4035-9842-86197618F7D2
    - GUID-3A627DBF-D797-42A2-A9AC-AAC321376068
    ... and 19 more
  morpheus_user_manual_8_1_1: 24 page(s)
    - GUID-10D04894-711A-400A-98A7-A3DECE437CDA
    - GUID-17E0EBC8-A495-4198-82BD-63D9D38D6F74
    - GUID-27FB9EA7-F54A-4B56-B3C8-0E5BF78A62C6
    - GUID-3159C5BA-04D5-4035-9842-86197618F7D2
    - GUID-3A627DBF-D797-42A2-A9AC-AAC321376068
    ... and 19 more
  morpheus_user_manual_8_1_2: 25 page(s)
    - GUID-10D04894-711A-400A-98A7-A3DECE437CDA
    - GUID-17E0EBC8-A495-4198-82BD-63D9D38D6F74
    - GUID-27FB9EA7-F54A-4B56-B3C8-0E5BF78A62C6
    - GUID-3159C5BA-04D5-4035-9842-86197618F7D2
    - GUID-3A627DBF-D797-42A2-A9AC-AAC321376068
    ... and 20 more
  morpheus_user_manual_9_0_0 (NEW): 68 page(s)
    - GUID-0FD5F034-5B03-4C0D-AC45-806952C6BC75
    - GUID-10D04894-711A-400A-98A7-A3DECE437CDA
    - GUID-17E0EBC8-A495-4198-82BD-63D9D38D6F74
    - GUID-1CF5D90B-ABF3-4151-A9CE-275EB6C32BE4
    - GUID-1E34E0C0-1929-4DBC-BCFA-F47144B3343E
    ... and 63 more

Bundles with sidecar-only drift (1): .vision-cache
 2026-08-03 06:49:18 +00:00
hvm-docs-refresh 4f9475825b weekly refresh: 2026-07-27T06:53Z — 129 content change(s) across 5 bundle(s) 
129 content change(s) across 5 bundle(s)
65 sidecar metadata update(s)
1 new bundle(s) added
1 other file change(s)

Bundles with content changes:
  morpheus_release_notes_9_0_1 (NEW): 1 page(s)
    - sd00008269en_us
  morpheus_user_manual_8_1_0: 32 page(s)
    - GUID-173469C2-D5C6-47F6-8A01-41C3D73B679B
    - GUID-1F30FE4D-FAD1-444B-9570-E20C339F257C
    - GUID-2CE25FBB-DE0F-4B4C-8FF7-07535555A706
    - GUID-3715BCDE-48A0-4FC5-A388-1E84C3EF7AF8
    - GUID-39D4284E-C733-48AD-94DE-CD929AEB0431
    ... and 27 more
  morpheus_user_manual_8_1_1: 32 page(s)
    - GUID-173469C2-D5C6-47F6-8A01-41C3D73B679B
    - GUID-1F30FE4D-FAD1-444B-9570-E20C339F257C
    - GUID-2CE25FBB-DE0F-4B4C-8FF7-07535555A706
    - GUID-3715BCDE-48A0-4FC5-A388-1E84C3EF7AF8
    - GUID-39D4284E-C733-48AD-94DE-CD929AEB0431
    ... and 27 more
  morpheus_user_manual_8_1_2: 32 page(s)
    - GUID-173469C2-D5C6-47F6-8A01-41C3D73B679B
    - GUID-1F30FE4D-FAD1-444B-9570-E20C339F257C
    - GUID-2CE25FBB-DE0F-4B4C-8FF7-07535555A706
    - GUID-3715BCDE-48A0-4FC5-A388-1E84C3EF7AF8
    - GUID-39D4284E-C733-48AD-94DE-CD929AEB0431
    ... and 27 more
  morpheus_user_manual_9_0_0: 32 page(s)
    - GUID-173469C2-D5C6-47F6-8A01-41C3D73B679B
    - GUID-1F30FE4D-FAD1-444B-9570-E20C339F257C
    - GUID-2CE25FBB-DE0F-4B4C-8FF7-07535555A706
    - GUID-3715BCDE-48A0-4FC5-A388-1E84C3EF7AF8
    - GUID-39D4284E-C733-48AD-94DE-CD929AEB0431
    ... and 27 more

Bundles with sidecar-only drift (5): .vision-cache, morpheus_release_notes_8_1_0, morpheus_release_notes_8_1_1, morpheus_release_notes_8_1_2, morpheus_release_notes_9_0_0
 2026-07-27 06:53:37 +00:00
hvm-docs-refresh 6686b033e6 weekly refresh: 2026-07-23T14:45Z — 156 content change(s) across 4 bundle(s) 
156 content change(s) across 4 bundle(s)
60 sidecar metadata update(s)

Bundles with content changes:
  morpheus_user_manual_8_1_0: 39 page(s)
    - GUID-06F0DB01-64F2-4D07-93F8-38AC80DBB09B
    - GUID-0A5AD977-07F5-4278-9CB3-F7D8AB8427A3
    - GUID-173469C2-D5C6-47F6-8A01-41C3D73B679B
    - GUID-180B8370-AEF2-45C1-9E72-99FF796CB222
    - GUID-2277183A-E315-4439-A885-C111A77C7154
    ... and 34 more
  morpheus_user_manual_8_1_1: 39 page(s)
    - GUID-06F0DB01-64F2-4D07-93F8-38AC80DBB09B
    - GUID-0A5AD977-07F5-4278-9CB3-F7D8AB8427A3
    - GUID-173469C2-D5C6-47F6-8A01-41C3D73B679B
    - GUID-180B8370-AEF2-45C1-9E72-99FF796CB222
    - GUID-2277183A-E315-4439-A885-C111A77C7154
    ... and 34 more
  morpheus_user_manual_8_1_2: 39 page(s)
    - GUID-06F0DB01-64F2-4D07-93F8-38AC80DBB09B
    - GUID-0A5AD977-07F5-4278-9CB3-F7D8AB8427A3
    - GUID-173469C2-D5C6-47F6-8A01-41C3D73B679B
    - GUID-180B8370-AEF2-45C1-9E72-99FF796CB222
    - GUID-2277183A-E315-4439-A885-C111A77C7154
    ... and 34 more
  morpheus_user_manual_9_0_0: 39 page(s)
    - GUID-06F0DB01-64F2-4D07-93F8-38AC80DBB09B
    - GUID-0A5AD977-07F5-4278-9CB3-F7D8AB8427A3
    - GUID-173469C2-D5C6-47F6-8A01-41C3D73B679B
    - GUID-180B8370-AEF2-45C1-9E72-99FF796CB222
    - GUID-2277183A-E315-4439-A885-C111A77C7154
    ... and 34 more

Bundles with sidecar-only drift (1): .vision-cache
 2026-07-23 14:45:49 +00:00
claude 698196bd63 feat(scrape): vision OCR of image-only doc pages (support matrices) (#5) 
Co-authored-by: claude <[email protected]>
 2026-07-23 09:48:38 -04:00
hvm-docs-refresh caf562b7c3 weekly refresh: 2026-07-20T06:05Z — 0 content change(s) across 0 bundle(s) 
0 content change(s) across 0 bundle(s)
0 sidecar metadata update(s)
 2026-07-20 06:05:29 +00:00
hvm-docs-refresh 450380bbe8 weekly refresh: 2026-07-15T15:20Z — 587 content change(s) across 2 bundle(s) 
587 content change(s) across 2 bundle(s)
2167 sidecar metadata update(s)
2 new bundle(s) added
1 other file change(s)

Bundles with content changes:
  morpheus_release_notes_9_0_0 (NEW): 1 page(s)
    - sd00008017en_us
  morpheus_user_manual_9_0_0 (NEW): 586 page(s)
    - GUID-008B6CB0-CC99-4E40-89CE-2EA5D3389D8F
    - GUID-00CE7A1B-7CBC-4227-B285-2E8E4FFC73B1
    - GUID-00E2C383-D602-4EAD-BE7F-64E69F5DD5C1
    - GUID-014CB518-CCE4-449A-9BCC-241FF8FEA3C5
    - GUID-016909A4-5AF9-4DE7-8088-DB62BBC6B00C
    ... and 581 more

Bundles with sidecar-only drift (6): morpheus_release_notes_8_1_0, morpheus_release_notes_8_1_1, morpheus_release_notes_8_1_2, morpheus_user_manual_8_1_0, morpheus_user_manual_8_1_1, morpheus_user_manual_8_1_2
 2026-07-15 15:20:40 +00:00
claude 2922161cc7 fix(scrape): auto-discover new Morpheus versions; pin 9.0.0 (#4) 
Co-authored-by: claude <[email protected]>
 2026-07-15 11:17:27 -04:00
hvm-docs-refresh 7b2c39bb0a weekly refresh: 2026-06-29T06:04Z — 0 content change(s) across 0 bundle(s) 
0 content change(s) across 0 bundle(s)
0 sidecar metadata update(s)
 2026-06-29 06:04:21 +00:00
hvm-docs-refresh 12298d1c7d weekly refresh: 2026-06-22T06:18Z — 1 content change(s) across 1 bundle(s) 
1 content change(s) across 1 bundle(s)
0 sidecar metadata update(s)

Bundles with content changes:
  morpheus_quickspecs: 1 page(s)
    - a50009231enw
 2026-06-22 06:18:14 +00:00
justin b29f5636fc rag: resilient embedder — rotate/split on endpoint errors; 4-GPU embed pool (#3) 2026-06-10 15:47:03 -04:00
hvm-docs-refresh 5b929e40c2 weekly refresh: 2026-05-25T06:09Z — 0 content change(s) across 0 bundle(s) 
0 content change(s) across 0 bundle(s)
0 sidecar metadata update(s)
 2026-05-25 06:09:23 +00:00
justin c8362953bb remove submit_doc_bug tool 2026-05-24 07:44:40 -04:00
hvm-docs-refresh 797750a4dc weekly refresh: 2026-05-22T19:31Z — 1599 content change(s) across 7 bundle(s) 
1599 content change(s) across 7 bundle(s)
1599 sidecar metadata update(s)
7 new bundle(s) added

Bundles with content changes:
  morpheus_quickspecs (NEW): 1 page(s)
    - a50009231enw
  morpheus_release_notes_8_1_0 (NEW): 1 page(s)
    - sd00007496en_us
  morpheus_release_notes_8_1_1 (NEW): 1 page(s)
    - sd00007610en_us
  morpheus_release_notes_8_1_2 (NEW): 1 page(s)
    - sd00007733en_us
  morpheus_user_manual_8_1_0 (NEW): 531 page(s)
    - GUID-008B6CB0-CC99-4E40-89CE-2EA5D3389D8F
    - GUID-00CE7A1B-7CBC-4227-B285-2E8E4FFC73B1
    - GUID-00E2C383-D602-4EAD-BE7F-64E69F5DD5C1
    - GUID-014CB518-CCE4-449A-9BCC-241FF8FEA3C5
    - GUID-016909A4-5AF9-4DE7-8088-DB62BBC6B00C
    ... and 526 more
  morpheus_user_manual_8_1_1 (NEW): 532 page(s)
    - GUID-008B6CB0-CC99-4E40-89CE-2EA5D3389D8F
    - GUID-00CE7A1B-7CBC-4227-B285-2E8E4FFC73B1
    - GUID-00E2C383-D602-4EAD-BE7F-64E69F5DD5C1
    - GUID-014CB518-CCE4-449A-9BCC-241FF8FEA3C5
    - GUID-016909A4-5AF9-4DE7-8088-DB62BBC6B00C
    ... and 527 more
  morpheus_user_manual_8_1_2 (NEW): 532 page(s)
    - GUID-008B6CB0-CC99-4E40-89CE-2EA5D3389D8F
    - GUID-00CE7A1B-7CBC-4227-B285-2E8E4FFC73B1
    - GUID-00E2C383-D602-4EAD-BE7F-64E69F5DD5C1
    - GUID-014CB518-CCE4-449A-9BCC-241FF8FEA3C5
    - GUID-016909A4-5AF9-4DE7-8088-DB62BBC6B00C
    ... and 527 more
 2026-05-22 19:31:35 +00:00
justin a9889ffdd6 fix: un-ignore corpus/ and tag commits as morpheus-docs-refresh (#1) 2026-05-22 15:29:52 -04:00
justinandClaude Opus 4.7 fa448f94e1 build out morpheus-docs MCP stack, mirroring hvm-docs through Phases 1-13 
Initial scaffold: the docs-mcp-template clone with all the
HVM-validated stack ported across, customized for Morpheus
Enterprise (PRODUCT_NAME=morpheus, server name morpheus-docs).

Bundles (live-discovered 2026-05-22; 1710 cataloged pages total):
* morpheus_user_manual_8_1_0  sd00007510en_us  568 pages (Feb 2026)
* morpheus_user_manual_8_1_1  sd00007621en_us  569 pages (Mar 2026)
* morpheus_user_manual_8_1_2  sd00007732en_us  569 pages (Apr 2026)
* morpheus_release_notes_8_1_0  sd00007496en_us  single-doc
* morpheus_release_notes_8_1_1  sd00007610en_us  single-doc
* morpheus_release_notes_8_1_2  sd00007733en_us  single-doc
* morpheus_quickspecs            a50009231enw     html-file (live
  curl_cffi against www.hpe.com; all 12+ Enterprise SKUs captured —
  S6E64..S6E73AAE for new/renewal/upgrade × 1/3/5-yr terms, plus
  services SKUs HA124A1#V38/V39 and H46SBA1).

No Deployment Guide or Qualification Matrix on HPE Support for
Morpheus Enterprise specifically — the only QM (sd00006551en_us)
covers HVM clusters managed by Morpheus and lives in hvm-docs.

Stack carried forward from hvm-docs:
* rag/{index,chunk,embeddings,bm25}.py — including the
  MAX_CHARS=4000 chunk-cap fix for table-dense content
* docs_mcp/{server,usage}.py — 11 MCP tools, BM25-default search,
  cross-encoder rerank, hybrid behind HYBRID_SEARCH=true,
  morpheus_api_lessons (renamed from hvm_api_lessons), env-gated
  submit_doc_bug
* docs_mcp/api_lessons.md — Morpheus-specific scaffold covering
  licensing model, HVM elevation path, REST vs Plugin API, with
  TODO markers for sections to flesh out from real ops experience
* scrape/{runner,quickspecs,changelog,bundles}.py — TOC + single-doc
  + html-file modes, curl_cffi Chrome120 for www.hpe.com edge bypass
* eval/{retrievers,run_eval}.py + queries.jsonl scaffold (4 placeholder
  queries; populate after first scrape)
* scripts/{rerank_server,usage_report,registry_gc}.py
* .gitea/workflows/{refresh,image-only}.yml — same Gitea Actions
  setup zerto-docs uses (push LAN, pull public-URL, GPU Ollama pool)
* deploy/docker-compose.yml — morpheus-docs-mcp service definition,
  shared jina-rerank sidecar, Watchtower-labeled
* Dockerfile, requirements.txt, requirements-rerank.txt

Verified locally: scrape produced 1599 .md pages (some TOC entries
are parent-only and yield no body), 6353 chunks all under the 4 KB
cap, MCP server boots and lists 11 tools cleanly.

Co-Authored-By: Claude Opus 4.7 (1M context) <[email protected]>
 2026-05-22 15:26:24 -04:00
justinandClaude Opus 4.7 43728320bf ci: default PRODUCT_NAME to repo name (caught by template dispatch test) 
First dispatch on the empty template failed at Chroma collection
creation because PRODUCT_NAME was the literal string "<product>"
(YAML doesn't expand placeholders), and Chroma rejects collection
names containing characters outside [a-zA-Z0-9._-]:

  chromadb.errors.InvalidArgumentError: Validation error: name:
  Expected a name containing 3-512 characters from [a-zA-Z0-9._-],
  starting and ending with a character in [a-zA-Z0-9]. Got:
  <product>_docs

Same fix as the IMAGE env: derive from the repo name dynamically
via ${{ github.event.repository.name }}. Cloners can still override
explicitly, but a fresh clone now runs the index-rebuild step
cleanly out of the box.

Verified by re-dispatch — should fail next at docker login (placeholder
REGISTRY_PUSH hostname), which is the next-expected fail point and a
real per-deployment config the cloner has to fill in.

Co-Authored-By: Claude Opus 4.7 (1M context) <[email protected]>
 2026-05-22 09:37:07 -04:00
justinandClaude Opus 4.7 33b0fd652e ci: derive image name + package linking from repo, add link step 
Both workflows had a static IMAGE env (<owner>/<product>-docs-mcp)
and a static --package arg in the GC step. Switch both to Gitea
Actions context variables so a clone of the template into any repo
name works on the first CI run without find/replace:

  IMAGE: ${{ github.repository_owner }}/${{ github.event.repository.name }}
  --owner ${{ github.repository_owner }}
  --package ${{ github.event.repository.name }}

Also add the "Link container package to this repo" step that was
missing from the template (and which, naively copy-pasted from the
reference build, would have linked everything back to docs-mcp-
template). The new step derives owner + package + link-target all
from the running repo's context.

The github.* namespace is Gitea Actions' inherited GitHub-Actions
context — values come from the Gitea server, not github.com. Same
mechanism the reference build's $GITHUB_SHA tag-builder uses.

CLAUDE.md updated to note that image and package naming are
repo-derived; only registry endpoints and the Ollama URL need
per-clone editing.

Co-Authored-By: Claude Opus 4.7 (1M context) <[email protected]>
 2026-05-22 09:34:26 -04:00
justinandClaude Opus 4.7 9ba615c8ee initial: docs-mcp-template — build guide + scaffolded server 
Template for building hosted MCP servers over a product's public
documentation. Distilled from one production build; everything
product-specific has been factored out.

Contents:

- PLAN.md — comprehensive build guide. 13 phases from project
  skeleton through weekly_digest. Includes the gotchas
  ("fetch-depth: 0 always", reranker per-pair token limit,
  Cloudflare body cap, dash-not-bash on Gitea runners), the
  decisions worth carrying forward, and a per-product
  customization checklist.

- CLAUDE.md — guidance for Claude Code working in a clone of this
  template. Phase identification table, conventions (env-gating +
  operator confirmation for side-effecting tools, defensive
  fallback for retrieval components), common commands.

- README.md — quick-start summary.

Scaffolded code (all signature-stable, with NotImplementedError
stubs where phase-specific work is required):

  docs_mcp/server.py    FastMCP server, stateless_http=True, with
                        search_docs / get_page / list_versions
                        baseline tools and commented stubs for the
                        rest of the phase set.
  docs_mcp/usage.py     TimedCall telemetry, JSONL, daily rotation,
                        90-day retention. Reusable as-is.
  rag/embeddings.py     Ollama embedder (nomic-embed-text default),
                        load-balanced across N URLs. Reusable.
  rag/chunk.py          Paragraph-aware chunker with synthetic
                        chunk 0. Per-product tunable.
  rag/index.py          Chroma + BM25 builder. --rebuild and
                        --bm25-only flags.
  rag/bm25.py           SQLite FTS5 lexical index. Reusable.
  scrape/changelog.py   --cached / --ref / --json / --history-out.
                        Reusable.
  scrape/README.md      What you write per-product.
  eval/queries.jsonl.example
                        Curate ~25 hand-labeled queries here.
  eval/retrievers.py    Retriever protocol + stub classes.
  eval/run_eval.py      MRR / Recall@K / nDCG@K harness skeleton.
  scripts/usage_report.py
                        Standalone log analyzer; the
                        FOLLOW-UP CHECKS pattern noted in the
                        module docstring.
  scripts/registry_gc.py
                        Gitea container registry cleanup. Reusable.

Deployment + CI:

  Dockerfile               Python 3.12-slim; COPY corpus + chroma
                           + bm25 last for cache efficiency.
  deploy/docker-compose.yml MCP + reranker sidecar + Watchtower.
                           Templated with <placeholders>.
  .gitea/workflows/refresh.yml    Weekly cron + manual dispatch.
                                  fetch-depth: 0, retry-on-race,
                                  three-tag image scheme.
  .gitea/workflows/image-only.yml Code-only ship cycle, ~18min.

Co-Authored-By: Claude Opus 4.7 (1M context) <[email protected]>
 2026-05-22 09:18:17 -04:00