@@ -727,21 +727,21 @@ <h2 id="bundle-structure">📦 Bundle Structure</h2>
727727< h3 id ="file-formats "> File Formats</ h3 >
728728< h4 id ="metadatajson "> metadata.json</ h4 >
729729< div class ="highlight "> < pre > < span > </ span > < code > < span class ="p "> {</ span >
730- < span class ="w "> </ span > < span class ="nt "> " cgc_version" </ span > < span class ="p "> :</ span > < span class ="w "> </ span > < span class ="s2 "> " 0.5.0" </ span > < span class ="p "> ,</ span >
731- < span class ="w "> </ span > < span class ="nt "> " exported_at" </ span > < span class ="p "> :</ span > < span class ="w "> </ span > < span class ="s2 "> " 2026-01-13T22:00:00" </ span > < span class ="p "> ,</ span >
732- < span class ="w "> </ span > < span class ="nt "> " repo" </ span > < span class ="p "> :</ span > < span class ="w "> </ span > < span class ="s2 "> " numpy/numpy" </ span > < span class ="p "> ,</ span >
733- < span class ="w "> </ span > < span class ="nt "> " commit" </ span > < span class ="p "> :</ span > < span class ="w "> </ span > < span class ="s2 "> " a1b2c3d4" </ span > < span class ="p "> ,</ span >
734- < span class ="w "> </ span > < span class ="nt "> " languages" </ span > < span class ="p "> :</ span > < span class ="w "> </ span > < span class ="p "> [</ span > < span class ="s2 "> " python" </ span > < span class ="p "> ,</ span > < span class ="w "> </ span > < span class ="s2 "> "c" </ span > < span class ="p "> ],</ span >
735- < span class ="w "> </ span > < span class ="nt "> " format_version" </ span > < span class ="p "> :</ span > < span class ="w "> </ span > < span class ="s2 "> " 1.0" </ span >
730+ < span class ="w "> </ span > < span class ="nt "> " cgc_version" </ span > < span class ="p "> :</ span > < span class ="w "> </ span > < span class ="s2 "> " 0.5.0" </ span > < span class ="p "> ,</ span >
731+ < span class ="w "> </ span > < span class ="nt "> " exported_at" </ span > < span class ="p "> :</ span > < span class ="w "> </ span > < span class ="s2 "> " 2026-01-13T22:00:00" </ span > < span class ="p "> ,</ span >
732+ < span class ="w "> </ span > < span class ="nt "> " repo" </ span > < span class ="p "> :</ span > < span class ="w "> </ span > < span class ="s2 "> " numpy/numpy" </ span > < span class ="p "> ,</ span >
733+ < span class ="w "> </ span > < span class ="nt "> " commit" </ span > < span class ="p "> :</ span > < span class ="w "> </ span > < span class ="s2 "> " a1b2c3d4" </ span > < span class ="p "> ,</ span >
734+ < span class ="w "> </ span > < span class ="nt "> " languages" </ span > < span class ="p "> :</ span > < span class ="w "> </ span > < span class ="p "> [</ span > < span class ="s2 "> " python" </ span > < span class ="p "> ,</ span > < span class ="w "> </ span > < span class ="s2 "> "c" </ span > < span class ="p "> ],</ span >
735+ < span class ="w "> </ span > < span class ="nt "> " format_version" </ span > < span class ="p "> :</ span > < span class ="w "> </ span > < span class ="s2 "> " 1.0" </ span >
736736< span class ="p "> }</ span >
737737</ code > </ pre > </ div >
738738< h4 id ="nodesjsonl-excerpt "> nodes.jsonl (excerpt)</ h4 >
739- < div class ="highlight "> < pre > < span > </ span > < code > {" _id": " 4:abc123", " _labels" : [" Function" ], " name": " array", " path": " /numpy/core/array.py", " line_number" : 42}
740- {" _id": " 4:def456", " _labels" : [" Class" ], " name": " ndarray", " path": " /numpy/core/multiarray.py", " line_number" : 100}
739+ < div class ="highlight "> < pre > < span > </ span > < code > {" _id": " 4:abc123", " _labels" : [" Function" ], " name": " array", " path": " /numpy/core/array.py", " line_number" : 42}
740+ {" _id": " 4:def456", " _labels" : [" Class" ], " name": " ndarray", " path": " /numpy/core/multiarray.py", " line_number" : 100}
741741</ code > </ pre > </ div >
742742< h4 id ="edgesjsonl-excerpt "> edges.jsonl (excerpt)</ h4 >
743- < div class ="highlight "> < pre > < span > </ span > < code > {" from": " 4:abc123", "to": " 4:def456", " type": " CALLS", " properties" : {}}
744- {" from": " 4:xyz789", "to": " 4:def456", " type": " INHERITS", " properties" : {}}
743+ < div class ="highlight "> < pre > < span > </ span > < code > {" from": " 4:abc123", "to": " 4:def456", " type": " CALLS", " properties" : {}}
744+ {" from": " 4:xyz789", "to": " 4:def456", " type": " INHERITS", " properties" : {}}
745745</ code > </ pre > </ div >
746746< hr />
747747< h2 id ="quick-start "> 🚀 Quick Start</ h2 >
@@ -879,18 +879,18 @@ <h3 id="1-index-your-repositories">1. Index Your Repositories</h3>
879879< h3 id ="2-export-to-bundle "> 2. Export to Bundle</ h3 >
880880< div class ="highlight "> < pre > < span > </ span > < code > < span class ="c1 "> # Get commit info</ span >
881881< span class ="nv "> COMMIT</ span > < span class ="o "> =</ span > < span class ="k "> $(</ span > git< span class ="w "> </ span > rev-parse< span class ="w "> </ span > --short< span class ="w "> </ span > HEAD< span class ="k "> )</ span >
882- < span class ="nv "> TAG</ span > < span class ="o "> =</ span > < span class ="k "> $(</ span > git< span class ="w "> </ span > describe< span class ="w "> </ span > --tags< span class ="w "> </ span > --abbrev< span class ="o "> =</ span > < span class ="m "> 0</ span > < span class ="w "> </ span > < span class ="m "> 2</ span > >/dev/null< span class ="w "> </ span > < span class ="o "> ||</ span > < span class ="w "> </ span > < span class ="nb "> echo</ span > < span class ="w "> </ span > < span class ="s2 "> " main" </ span > < span class ="k "> )</ span >
882+ < span class ="nv "> TAG</ span > < span class ="o "> =</ span > < span class ="k "> $(</ span > git< span class ="w "> </ span > describe< span class ="w "> </ span > --tags< span class ="w "> </ span > --abbrev< span class ="o "> =</ span > < span class ="m "> 0</ span > < span class ="w "> </ span > < span class ="m "> 2</ span > >/dev/null< span class ="w "> </ span > < span class ="o "> ||</ span > < span class ="w "> </ span > < span class ="nb "> echo</ span > < span class ="w "> </ span > < span class ="s2 "> " main" </ span > < span class ="k "> )</ span >
883883
884884< span class ="c1 "> # Export with version info</ span >
885- cgc< span class ="w "> </ span > < span class ="nb "> export</ span > < span class ="w "> </ span > < span class ="s2 "> " your-repo-</ span > < span class ="si "> ${</ span > < span class ="nv "> TAG</ span > < span class ="si "> }</ span > < span class ="s2 "> -</ span > < span class ="si "> ${</ span > < span class ="nv "> COMMIT</ span > < span class ="si "> }</ span > < span class ="s2 "> .cgc" </ span > < span class ="w "> </ span > --repo< span class ="w "> </ span > .
885+ cgc< span class ="w "> </ span > < span class ="nb "> export</ span > < span class ="w "> </ span > < span class ="s2 "> " your-repo-</ span > < span class ="si "> ${</ span > < span class ="nv "> TAG</ span > < span class ="si "> }</ span > < span class ="s2 "> -</ span > < span class ="si "> ${</ span > < span class ="nv "> COMMIT</ span > < span class ="si "> }</ span > < span class ="s2 "> .cgc" </ span > < span class ="w "> </ span > --repo< span class ="w "> </ span > .
886886</ code > </ pre > </ div >
887887< h3 id ="3-distribute "> 3. Distribute</ h3 >
888888< h4 id ="option-a-github-releases "> Option A: GitHub Releases</ h4 >
889889< div class ="highlight "> < pre > < span > </ span > < code > < span class ="c1 "> # Create a release</ span >
890890gh< span class ="w "> </ span > release< span class ="w "> </ span > create< span class ="w "> </ span > bundles-< span class ="k "> $(</ span > date< span class ="w "> </ span > +%Y%m%d< span class ="k "> )</ span > < span class ="w "> </ span > < span class ="se "> \</ span >
891891< span class ="w "> </ span > your-repo-*.cgc< span class ="w "> </ span > < span class ="se "> \</ span >
892- < span class ="w "> </ span > --title< span class ="w "> </ span > < span class ="s2 "> " Pre-indexed Bundles - </ span > < span class ="k "> $(</ span > date< span class ="w "> </ span > +%Y-%m-%d< span class ="k "> )</ span > < span class ="s2 "> " </ span > < span class ="w "> </ span > < span class ="se "> \</ span >
893- < span class ="w "> </ span > --notes< span class ="w "> </ span > < span class ="s2 "> " Pre-indexed code graphs for instant loading" </ span >
892+ < span class ="w "> </ span > --title< span class ="w "> </ span > < span class ="s2 "> " Pre-indexed Bundles - </ span > < span class ="k "> $(</ span > date< span class ="w "> </ span > +%Y-%m-%d< span class ="k "> )</ span > < span class ="s2 "> " </ span > < span class ="w "> </ span > < span class ="se "> \</ span >
893+ < span class ="w "> </ span > --notes< span class ="w "> </ span > < span class ="s2 "> " Pre-indexed code graphs for instant loading" </ span >
894894</ code > </ pre > </ div >
895895< h4 id ="option-b-object-storage-s3-r2-gcs "> Option B: Object Storage (S3, R2, GCS)</ h4 >
896896< div class ="highlight "> < pre > < span > </ span > < code > < span class ="c1 "> # Upload to S3</ span >
@@ -950,7 +950,7 @@ <h3 id="validate-bundle">Validate Bundle</h3>
950950< h2 id ="use-cases "> 🎓 Use Cases</ h2 >
951951< h3 id ="1-ai-assistant-context "> 1. AI Assistant Context</ h3 >
952952< div class ="highlight "> < pre > < span > </ span > < code > < span class ="c1 "> # AI can now query structure instantly</ span >
953- < span class ="c1 "> # " Show me all functions that use numpy.linalg" </ span >
953+ < span class ="c1 "> # " Show me all functions that use numpy.linalg" </ span >
954954</ code > </ pre > </ div >
955955< h3 id ="2-code-analysis-pipelines "> 2. Code Analysis Pipelines</ h3 >
956956< div class ="highlight "> < pre > < span > </ span > < code > < span class ="c1 "> # CI/CD: Load pre-indexed dependencies</ span >
@@ -1042,14 +1042,14 @@ <h3 id="python-api">Python API</h3>
10421042
10431043< span class ="c1 "> # Export</ span >
10441044< span class ="n "> success</ span > < span class ="p "> ,</ span > < span class ="n "> message</ span > < span class ="o "> =</ span > < span class ="n "> bundle</ span > < span class ="o "> .</ span > < span class ="n "> export_to_bundle</ span > < span class ="p "> (</ span >
1045- < span class ="n "> output_path</ span > < span class ="o "> =</ span > < span class ="n "> Path</ span > < span class ="p "> (</ span > < span class ="s2 "> " my-bundle.cgc" </ span > < span class ="p "> ),</ span >
1046- < span class ="n "> repo_path</ span > < span class ="o "> =</ span > < span class ="n "> Path</ span > < span class ="p "> (</ span > < span class ="s2 "> " /path/to/repo" </ span > < span class ="p "> ),</ span >
1045+ < span class ="n "> output_path</ span > < span class ="o "> =</ span > < span class ="n "> Path</ span > < span class ="p "> (</ span > < span class ="s2 "> " my-bundle.cgc" </ span > < span class ="p "> ),</ span >
1046+ < span class ="n "> repo_path</ span > < span class ="o "> =</ span > < span class ="n "> Path</ span > < span class ="p "> (</ span > < span class ="s2 "> " /path/to/repo" </ span > < span class ="p "> ),</ span >
10471047 < span class ="n "> include_stats</ span > < span class ="o "> =</ span > < span class ="kc "> True</ span >
10481048< span class ="p "> )</ span >
10491049
10501050< span class ="c1 "> # Import</ span >
10511051< span class ="n "> success</ span > < span class ="p "> ,</ span > < span class ="n "> message</ span > < span class ="o "> =</ span > < span class ="n "> bundle</ span > < span class ="o "> .</ span > < span class ="n "> import_from_bundle</ span > < span class ="p "> (</ span >
1052- < span class ="n "> bundle_path</ span > < span class ="o "> =</ span > < span class ="n "> Path</ span > < span class ="p "> (</ span > < span class ="s2 "> " my-bundle.cgc" </ span > < span class ="p "> ),</ span >
1052+ < span class ="n "> bundle_path</ span > < span class ="o "> =</ span > < span class ="n "> Path</ span > < span class ="p "> (</ span > < span class ="s2 "> " my-bundle.cgc" </ span > < span class ="p "> ),</ span >
10531053 < span class ="n "> clear_existing</ span > < span class ="o "> =</ span > < span class ="kc "> False</ span >
10541054< span class ="p "> )</ span >
10551055</ code > </ pre > </ div >
0 commit comments