Merge branch 'develop' of github.com:codegen-sh/codegen-sdk into eagarwal-cg-10342-codebasereset-should-not-blow-away-ipynb-changes

Author: bagel897

.pre-commit-config.yaml

@@ -20,7 +20,10 @@ repos:
       - id: biome-check
         additional_dependencies: ["@biomejs/[email protected]"]
         exclude: (src/codemods/eval)|(tests/unit/skills/snapshots)|(tests/unit/codegen/sdk/output)|(tests/integration/verified_codemods)|(docs/samples)
-
+  - repo: https://github.com/ComPWA/taplo-pre-commit
+    rev: v0.9.3
+    hooks:
+      - id: taplo-format
   - repo: https://github.com/MarcoGorelli/cython-lint
     rev: v0.16.6
     hooks:

docs/building-with-codegen/codebase-visualization.mdx

@@ -20,7 +20,7 @@ This guide provides a basic overview of graph creation and customization. Like t
   width="100%"
   height="600px"
   scrolling="no"
-  src={`https://chadcode.sh/embedded/graph?id=ef312926-286d-4c13-8e09-38e1a47882f1&zoom=0.5`}
+  src={`https://codegen.sh/embedded/graph?id=ef312926-286d-4c13-8e09-38e1a47882f1&zoom=0.5`}
   className="rounded-xl "
   style={{
     backgroundColor: "#15141b",

docs/building-with-codegen/dot-codegen.mdx

@@ -11,12 +11,11 @@ The `.codegen` directory contains your project's Codegen configuration, codemods
 
 ```bash
 .codegen/
-├── config.toml         # Project configuration
-├── codemods/          # Your codemod implementations
-├── jupyter/           # Jupyter notebooks for exploration
-├── docs/             # API documentation
-├── examples/         # Example code
-└── prompts/          # AI system prompts
+├── .venv/            # Python virtual environment (gitignored)
+├── config.toml       # Project configuration
+├── codemods/         # Your codemod implementations
+├── jupyter/          # Jupyter notebooks for exploration
+└── codegen-system-prompt.txt  # AI system prompt
 ```
 
 ## Initialization
@@ -31,6 +30,20 @@ codegen init [--fetch-docs] [--repo-name NAME] [--organization-name ORG]
 The `--fetch-docs` flag downloads API documentation and examples specific to your project's programming language.
 </Note>
 
+## Virtual Environment
+
+Codegen maintains its own virtual environment in `.codegen/.venv/` to ensure consistent package versions and isolation from your project's dependencies. This environment is:
+
+- Created using `uv` for fast, reliable package management
+- Initialized with Python 3.13
+- Automatically managed by Codegen commands
+- Used for running codemods and Jupyter notebooks
+- Gitignored to avoid committing environment-specific files
+
+The environment is created during `codegen init` and used by commands like `codegen run` and `codegen notebook`.
+
+<Note>To debug codemods, you will need to set the python virtual environment in your IDE to `.codegen/.venv`</Note>
+
 ### Configuration
 
 The `config.toml` file stores your project settings:
@@ -49,13 +62,15 @@ Codegen automatically adds appropriate entries to your `.gitignore`:
 
 ```gitignore
 # Codegen
-.codegen/prompts/
+.codegen/.venv/
 .codegen/docs/
-.codegen/examples/
+.codegen/jupyter/
+.codegen/codegen-system-prompt.txt
 ```
 
 <Info>
-While prompts, docs, and examples are ignored, your codemods in `.codegen/codemods/` are tracked in Git.
+- While most directories are ignored, your codemods in `.codegen/codemods/` and `config.toml` are tracked in Git
+- The virtual environment and Jupyter notebooks are gitignored to avoid environment-specific issues
 </Info>
 
 ## Working with Codemods

docs/introduction/overview.mdx

@@ -9,7 +9,7 @@ iconType: "solid"
 
 It provides a scriptable interface to a powerful, multi-lingual language server built on top of [Tree-sitter](https://tree-sitter.github.io/tree-sitter/).
 
-export const intoSnippet = `# Codegen builds a complete graph connecting
+export const metaCode = `# Codegen builds a complete graph connecting
 #  functions, classes, imports and their relationships
 from codegen import Codebase
 
@@ -21,13 +21,23 @@ for function in codebase.functions:
         function.remove()
 `
 
+export const code = `def foo():
+  pass
+
+def bar():
+  foo()
+
+def baz():
+  pass
+`
+
 <iframe
   width="100%"
   height="300px"
   scrolling="no"
   src={`https://chadcode.sh/embedded/codemod/?code=${encodeURIComponent(
-    intoSnippet
-  )}`}
+    metaCode
+  )}&input=${encodeURIComponent(code)}`}
   style={{
     backgroundColor: "#15141b",
   }}

hatch.toml

@@ -12,9 +12,9 @@ tool = ["uv", "pip"]
 [envs.hatch-build.overrides]
 matrix.tool.installer = { value = "{matrix:tool}" }
 matrix.tool.scripts = [
-    { key = "pip", value = "{env:HATCH_UV} pip {args}", if = [
-        "uv",
-    ] },
+  { key = "pip", value = "{env:HATCH_UV} pip {args}", if = [
+    "uv",
+  ] },
 ]
 
 [version]
@@ -25,19 +25,19 @@ UV_EXTRA_INDEX_URL = "https://[email protected].
 
 [build.targets.wheel.hooks.cython]
 dependencies = [
-    "hatch-cython @ git+https://github.com/codegen-sh/hatch-cython.git",
-    "cython>=3.0.11",
-    "tree-sitter",
-    "networkx",
+  "hatch-cython @ git+https://github.com/codegen-sh/hatch-cython.git",
+  "cython>=3.0.11",
+  "tree-sitter",
+  "networkx",
 ]
 
 [build.targets.wheel.hooks.cython.options]
 src = "codegen/sdk"
 compile_args = [
-    "-O3",
-    { platforms = [
-        "darwin",
-    ], arch = "arm64", arg = "-mcpu=apple-m1" },
+  "-O3",
+  { platforms = [
+    "darwin",
+  ], arch = "arm64", arg = "-mcpu=apple-m1" },
 ]
 cythonize_kwargs = { annotate = true, nthreads = 16, exclude_failures = false, cache = true }
 compiled_sdist = true
@@ -57,27 +57,30 @@ c_string_type = "unicode"
 
 [build.targets.wheel.hooks.cython.options.files]
 exclude = [
-    "**/__init__.py",
-    "**/code_generation",
-    "**/skills",
-    "**/codebase/factory",
-    "**/guides",
-    "**/testing",
-    "**/codebase_graph_utils.py",
+  "**/__init__.py",
+  "**/code_generation",
+  "**/skills",
+  "**/codebase/factory",
+  "**/guides",
+  "**/testing",
+  "**/codebase_graph_utils.py",
 ]
 
 [build.targets.wheel]
 macos-max-compat = false
 
 [build]
-packages = [
-    "src/codegen",
-]
-
-[metadata.hooks.vcs]
-Homepage = "https://github.com/codegen-sh/codegen-sdk"
-source_archive = "https://github.com/codegen-sh/codegen-sdk/archive/{commit_hash}.zip"
+packages = ["src/codegen"]
 
+[metadata.hooks.vcs.urls]
+Homepage = "https://www.codegen.com/"
+Repository = "https://github.com/codegen-sh/codegen-sdk"
+download = "https://github.com/codegen-sh/codegen-sdk/archive/{commit_hash}.zip"
+Changelog = "https://docs.codegen.com/changelog/changelog"
+Releasenotes = "https://github.com/codegen-sh/codegen-sdk/releases"
+Issues = "https://github.com/codegen-sh/codegen-sdk/issues"
+Documentation = "https://docs.codegen.sh"
+Playground = "https://www.codegen.sh/"
 
 [build.targets.wheel.hooks.custom]
 enable-by-default = false