{"id":51508520,"url":"https://github.com/blackwell-systems/knowing-viz","last_synced_at":"2026-07-08T03:30:35.612Z","repository":{"id":358123296,"uuid":"1240123373","full_name":"blackwell-systems/knowing-viz","owner":"blackwell-systems","description":"React graph visualization for knowing. Sigma.js 2D + Three.js 3D, 6 grouping algorithms, provenance/edge-type/blame filtering, timeline snapshot diff, Zustand state, framer-motion animations.","archived":false,"fork":false,"pushed_at":"2026-07-08T01:58:19.000Z","size":8267,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-07-08T03:26:52.523Z","etag":null,"topics":["code-intelligence","graph-visualization","graphology","react","sigma-js","software-architecture","static-site","threejs","visualization","zustand"],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/blackwell-systems.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-15T19:44:28.000Z","updated_at":"2026-07-08T01:58:24.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/blackwell-systems/knowing-viz","commit_stats":null,"previous_names":["blackwell-systems/knowing-viz"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/blackwell-systems/knowing-viz","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blackwell-systems%2Fknowing-viz","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blackwell-systems%2Fknowing-viz/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blackwell-systems%2Fknowing-viz/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blackwell-systems%2Fknowing-viz/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/blackwell-systems","download_url":"https://codeload.github.com/blackwell-systems/knowing-viz/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/blackwell-systems%2Fknowing-viz/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35251015,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-08T02:00:06.796Z","response_time":61,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["code-intelligence","graph-visualization","graphology","react","sigma-js","software-architecture","static-site","threejs","visualization","zustand"],"created_at":"2026-07-08T03:30:35.002Z","updated_at":"2026-07-08T03:30:35.606Z","avatar_url":"https://github.com/blackwell-systems.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"assets/knowing-viz-banner.png\" alt=\"knowing-viz\" width=\"600\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"LICENSE\"\u003e\u003cimg src=\"https://img.shields.io/badge/license-MIT-blue.svg\" alt=\"License\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/blackwell-systems/knowing\"\u003e\u003cimg src=\"https://img.shields.io/badge/powered_by-knowing-brightgreen.svg\" alt=\"Powered by knowing\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/blackwell-systems\"\u003e\u003cimg src=\"https://raw.githubusercontent.com/blackwell-systems/blackwell-docs-theme/main/badge-trademark.svg\" alt=\"Blackwell Systems\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cstrong\u003eInteractive graph visualization for cross-repo software relationships.\u003c/strong\u003e\n\u003c/p\u003e\n\n## What This Is\n\nA static site that visualizes [knowing](https://github.com/blackwell-systems/knowing)'s knowledge graph: nodes (symbols), edges (relationships), cross-repo connections, provenance tiers, and blast radius. No backend, no database, no auth. Reads a JSON export from knowing and renders it.\n\n## Views\n\n**Galaxy View:** All repos as clusters, cross-repo edges as arcs between them. Nodes sized by blast radius. The hero screenshot.\n\n**Blast Radius View:** Click a symbol, see all transitive callers fan out. Cross-repo callers highlighted. Confidence shown as edge opacity.\n\n**Timeline View:** Scrub through commits. New edges glow, removed edges fade. Visualizes the event-sourced history.\n\n**Provenance Overlay:** Toggle between static edges (blue), runtime edges (green), and stale edges (red).\n\n## Usage\n\n```bash\n# In your knowing repo, export the graph\nknowing export \u003e graph.json\n\n# Copy to this project\ncp graph.json public/demo-graph.json\n\n# Run locally\nnpm install\nnpm run dev\n```\n\nOr use the pre-baked demo data from polywave-go + polywave-web (228 cross-repo edges).\n\n## Data Source\n\nThis project consumes JSON exported by `knowing export`. No runtime dependency on knowing. The JSON schema:\n\n```json\n{\n  \"repos\": [{\"id\": \"...\", \"url\": \"...\", \"nodeCount\": 6340}],\n  \"nodes\": [{\"id\": \"hash\", \"label\": \"pkg.Func\", \"kind\": \"function\", \"repo\": \"...\", \"package\": \"...\"}],\n  \"edges\": [{\"source\": \"hash1\", \"target\": \"hash2\", \"type\": \"calls\", \"provenance\": \"lsp_resolved\", \"confidence\": 0.9, \"crossRepo\": true}],\n  \"snapshots\": [{\"hash\": \"...\", \"commit\": \"abc123\", \"timestamp\": 1715700000}]\n}\n```\n\n## Tech Stack\n\n- [Cytoscape.js](https://js.cytoscape.org/) (2D interactive graph)\n- [Three.js](https://threejs.org/) (3D galaxy view for screenshots)\n- [Vite](https://vite.dev/) (build tool)\n- TypeScript\n- Static deployment (GitHub Pages)\n\n## Relationship to knowing\n\n`knowing` is the system of record. `knowing-viz` is a read-only visualization layer that consumes exported data. No code is shared between the two projects. Screenshots generated here are used in knowing's README.\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblackwell-systems%2Fknowing-viz","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fblackwell-systems%2Fknowing-viz","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fblackwell-systems%2Fknowing-viz/lists"}