Skip to content

Add cross-Mech gap analyses, visualizations, and 17-Mech fleet coverage - #618

Merged
realmarcin merged 2 commits into
mainfrom
feat/gap-visualizations-analyses-20261115
Nov 16, 2026
Merged

realmarcin merged 2 commits into
mainfrom
feat/gap-visualizations-analyses-20261115

Conversation

@realmarcin

Copy link
Copy Markdown
Contributor

Summary

  • Account visibly for all 17 public fleet Mechs (16 corpus Mechs in _gaps/sources.json plus EdgeMech curation infrastructure in _fleet/infrastructure.json) across the Knowledge Gaps overview grid, 17-row breakdown chart, embedding map missing-fleet disclosure, source coverage disclosures, and static HTML summary while failing closed on unlisted Mech names.
  • Enrich the search index projection (posed_date, resolved_date, has_experiments, evidence_stances, attach_layers) and add URL-synced facets (layer, stance, experiments, ref, month), removable active-filter chips, and posed-date sorts.
  • Add the live-filtered Cross-Mech analyses section (#gap-analyses-title): 17-row All-Mechs stacked breakdown (kind / status / stance / layer), 16x16 Source x Vocabulary pollination matrix, posed/resolved monthly SVG timeline, and reference concentration / cross-Mech citation list.
  • Upgrade shared-vocabulary co-occurrence with Jaccard and normalized PMI (npmi) specificity ranking plus an interactive circular SVG entity network.
  • Extend the embedding map with color-by lenses (stance, layer, experiments, bridge) and toggleable cross-Mech nearest-neighbor arcs.
  • Build and wire a hashed analytics.<sha16>.json synthesis sidecar (27.8 KiB gzipped) covering original-vector cross-Mech semantic bridges, proposed experiments, unmatched phrase candidates, and entity embedding cohesion / duplicate-input clusters, with isolated failure handling and retry.

Verification

  • python3 -m unittest discover -s tests -v (390 passed)
  • node --test tests/gap-search.test.js tests/gap-embedding.test.js (36 passed)
  • python3 scripts/gaps/build.py --claw-root .temp/claw-gap-contract --check
  • python3 scripts/fleet/assemble_page.py --check
  • Headless Chrome QA (scripts/adhoc/check_gap_visualizations_20261116.py) at 1280px, 620px, and 390px in light and dark themes plus isolated analytics 503 failure/retry

Account for all 17 public fleet Mechs (16 corpus Mechs plus EdgeMech curation infrastructure) across the Knowledge Gaps overview, breakdown bars, embedding map notes, coverage disclosures, and static summary while failing closed on unlisted Mech names.

Add live-filtered cross-Mech analyses (17-row breakdown chart, 16x16 Source x Vocabulary matrix, posed/resolved timeline, citation concentration, Jaccard/NPMI co-occurrence network, and embedding map lenses/neighbor arcs) plus a hashed synthesis sidecar covering semantic bridges, proposed experiments, unmatched phrase candidates, and entity embedding cohesion.
- Bound calendar-month validation (01-12) and replace string month stepping
  with bounded integer month arithmetic so malformed dates cannot hang the
  timeline loop (#619).
- Keep entity-cohesion drill-down, active-filter chips (view/term/term2),
  breakdown segment/lifecycle untoggles, modifier-click link handling, SVG
  aria-pressed state, and map display-control resets consistent (#620).
- Fail closed when _fleet/infrastructure.json is missing unless explicitly
  opted out, and validate analytics sidecar schema, build_id, terms_sha256,
  and embedding_inputs_sha256 bindings at build time and in the browser (#621).
- Canonicalize URL-formatted DOI/PubMed citations and dotted-CURIE / HTTP
  attaches_to paths identically across Python build helpers and JS search (#622).
- Add theme-aware WCAG >= 3:1 chart tokens, explicit dark/light heading and
  segment contrast checks, 720px co-occurrence SVG width, middle-truncated
  long reference labels, mobile numeric-column wrapping guards, and corrected
  coverage documentation examples (#623).
- Align 8-section overview QA, dynamic visualization QA expectations, and live
  deployment verification with infrastructure and analytics sidecars (#624).

Fixes #619
Fixes #620
Fixes #621
Fixes #622
Fixes #623
Fixes #624
@realmarcin
realmarcin merged commit bc50236 into main Nov 16, 2026
1 check passed
@realmarcin
realmarcin deleted the feat/gap-visualizations-analyses-20261115 branch November 16, 2026 23:56
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