Add knowledge graph navigator

[kkudumu]

@algora-pbc /claim #17

Summary

• adds a self-contained knowledge-graph-navigator module for scientific entity extraction, graph construction, navigation, entity pages, and recommendations
• supports project/author/affiliation/concept/tool/dataset/protocol/reference/funder nodes, relationship edges, schema.org-style metadata, graph filters, recommendation digests, and API route contracts
• includes sample corpus data, dependency-free tests, requirement mapping, CLI demo, SVG source, and demo GIF

Demo

• Demo video: https://raw.githubusercontent.com/kkudumu/SCIBASE.AI/kkudumu/knowledge-graph-navigator-17/knowledge-graph-navigator/docs/demo.mp4
• knowledge-graph-navigator/docs/demo.gif

Verification

cd knowledge-graph-navigator
npm run check
npm test
npm run demo

Review Note

Before submission I ran a local code-review pass and fixed DOI extraction so trailing sentence punctuation is not included in DOI entities. The regression is covered in test/knowledge-graph-navigator.test.js.

AI-Assisted Disclosure

This contribution was produced with AI assistance and manually reviewed/verified before submission.

Closes #17

[kkudumu]

/claim #17

[kkudumu]

/claim #17

[kkudumu]

Follow-up pushed to strengthen the exploratory navigation and recommendation-evidence parts of issue #17:

• added traceable research journeys that walk graph hops such as concept -> project -> dataset/tool/author with evidence trails
• added recommendation evidence edges so scored suggestions can be audited back to graph relationships
• surfaced journeys/evidence in demo output, tests, README, and requirement map

Verification after the update:

• cd knowledge-graph-navigator && npm run check
• cd knowledge-graph-navigator && npm test
• cd knowledge-graph-navigator && npm run demo
• git diff --check

[kkudumu]

Follow-up pushed in 509b2d8 to make the linked-data export path more explicit.

What changed:

• Added buildGraphLinkedDataExport() for JSON-LD-style graph export with schema.org-compatible entity records.
• Export now includes relationship records, evidence provenance records, evidence hashes, entity/relationship counts, and exportHash.
• Knowledge graph packets now include linkedDataExport and the route contract GET /knowledge-graph/export/jsonld.
• Updated tests, CLI demo, README, and the issue Scientific Knowledge Graph Integration #17 requirement map.

Verification rerun:

• npm run check
• npm test
• npm run demo
• git diff --check

[kkudumu]

Added a short demo video artifact for Algora/reviewer convenience:

• Demo video: https://raw.githubusercontent.com/kkudumu/SCIBASE.AI/kkudumu/knowledge-graph-navigator-17/knowledge-graph-navigator/docs/demo.mp4
• Existing GIF remains at knowledge-graph-navigator/docs/demo.gif
• CLI demo remains npm run demo

This is the same deterministic demo flow already covered by the local tests and README, now available as an MP4 video artifact.

[kkudumu]

Follow-up for the issue #17 collaboration-map and recommendation-surface scope.

Added commit 4eb66ad to cover knowledge-graph outputs that were previously lighter:

• author-author collaboration edges derived from co-authored projects
• lab-to-lab collaboration edges derived from author affiliations
• collaboration map hashes for reviewable graph output
• recommendation surfaces for project sidebars, weekly digest payloads, and discovery-mode query seeds
• new API route contracts for recommendation surfaces and collaborations
• tests, demo output, README, and requirement-map updates

Verified locally:

• npm run check -> passed
• npm test -> passed
• npm run demo -> passed and now prints collaborationMap plus recommendationSurfacesForMaya
• git diff --check -> passed

This keeps the module deterministic and self-contained while mapping more directly to the issue requirements for author graphs, lab collaboration maps, sidebar recommendations, weekly digest payloads, and discovery-mode exploration.

[kkudumu]

Updated the existing demo video with narrated voiceover explaining every major change in this PR: research graph entities and edges, traceable journeys, recommendation evidence, JSON-LD export, schema.org records, collaboration maps, sidebar recommendations, digest payloads, and discovery query seeds. The PR's existing demo-video link now points to the narrated MP4.