depgraph

Codemap

Hypergraph of Codemap + AST

Hypercodemap

Philosophy

The source code is compiled into an AST, ultimately integrated into a hypergraph.

The hypergraph contains all knowledge of the sourcecode, AI driven.

It doesn’t have to be AI driven, but as a human it’s too long to do… AI already encoded most of the hard comprehension (NLP). Adapting to code is the next step.

Cool part about the hypergraph is that it can be rewritten in realtime as code changes. You’ll see nodes getting pulled together and other’s pushed away. New nodes created constantly while building a new feature.

The source code is "alive" ?

Add in runtime execution visualization with this and it could end up making something beautifully artistic.

Or add in the ability to retroactively improve itself, not just runtime vars, but dynamically writing new functions. What is the role of the human in this exploration? Where do AIs get lost in their ability to “write new code”. To go further.

How to use it?

It’s primarily a source code navigation system. You can analyze how dependencies are created between function calls. Who uses those dependencies.

The primary tool is “Gather” – Pull nodes towards selected node.

The secondary tool is “Rewind” – X time goes backwards #time.

There are many more controls. You’ll find your own style of navigation eventually I’m sure.

Time

At the moment “time” really just means nodes will return to a state. In most cases nodes return to T0, when the depgraph is initialized. However, there are nuances to what it means to be at T0. Mostly it’s when the depgraph is recomputed, eventually will be realtime with constant updates. Then the real question will be HOW OFTEN. Funny when talking about time.

Anyways so time is just a timeline, currently linear, of the source code. This is git. Another layer of the hypergraph to add !

AI Use

Source code already has a structure. AST is a different tool than NLP. AST is the concrete guide. AST now needs contextual awareness of the meta purpose of the AST. Ex: what does it mean to build a turret to protect the NPCs. Humans and AI understand what that story means. Allegedly. And if it doesn’t then it’s really good at creating categories, and putting words to what were seeing in code, when we tell it what to do and it understands and it just does it

I think where AI gets lost its in really complex stuff, like making the depgraph, had to restore and try again (x10).

Navigator

I think it’s interesting to see how systems can be explored. We have maps for a lot of things… But we’re at a point where those things are maybe too complicated to describe easily with paragraphs. Creating visual clusters of hierarchical information. Displayed in a dynamic way, such that all your curiosities are explored.

How a game works. That was the primary purpose. To explore the code a different way than linearly. Because ultimately code is NOT LINEAR. Yet we continue to read it linearly. It is a hypergraph and navigating it is required due to information overload. AI may do this by themselves within their embedding/context.

Codemap cluster boundaries