codefission 0.1.0__tar.gz

codefission-0.1.0/.gitignore

@@ -0,0 +1,20 @@
+venv/
+.venv/
+__pycache__/
+*.pyc
+node_modules/
+frontend/dist/
+.DS_Store
+.env
+data/workspaces/
+data/*.db
+data/*.db-wal
+data/*.db-shm
+backend/data/
+test_repo/
+ref_repos/
+.claude/
+.cursor/
+codefission-ai/
+codefission/static/
+dist/

codefission-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,66 @@
+# Contributing to CodeFission
+
+Thanks for your interest in contributing! Here's how to get started.
+
+## Development Setup
+
+```bash
+# Clone and set up the backend
+git clone https://github.com/your-username/codefission.git
+cd codefission
+python3 -m venv venv
+source venv/bin/activate
+pip install -r requirements.txt
+
+# Set up the frontend (with hot reload)
+cd frontend
+npm install
+npm run dev     # Starts Vite dev server on :5173
+```
+
+Run the backend separately during development:
+
+```bash
+source venv/bin/activate
+cd backend
+uvicorn main:app --reload --port 8080
+```
+
+## Project Structure
+
+```
+├── backend/          # FastAPI application
+│   ├── main.py       # App entry point and routes
+│   ├── db.py         # Database connection and migrations
+│   ├── models.py     # Pydantic models
+│   ├── tree_service.py
+│   ├── chat_service.py
+│   └── workspace_service.py
+├── frontend/         # React + TypeScript (Vite)
+│   └── src/
+│       ├── App.tsx
+│       ├── store.ts  # State management
+│       └── components/
+├── data/             # SQLite DB + git workspaces (gitignored)
+└── run.sh            # Production start script
+```
+
+## Coding Standards
+
+- **Python:** Follow PEP 8. Use type hints where practical.
+- **TypeScript:** Use strict mode. Prefer functional components with hooks.
+- **Commits:** Write concise, descriptive commit messages.
+
+## Pull Request Workflow
+
+1. Fork the repo and create a feature branch from `main`.
+2. Make your changes and test them locally.
+3. Ensure the frontend builds cleanly: `cd frontend && npm run build`
+4. Open a pull request with a clear description of what you changed and why.
+
+## Reporting Issues
+
+Open an issue on GitHub with:
+- Steps to reproduce
+- Expected vs. actual behavior
+- Browser/OS/Python version if relevant

codefission-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Tianyu Hua
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

codefission-0.1.0/Makefile

@@ -0,0 +1,27 @@
+.PHONY: dev build-frontend build publish clean test
+
+# Development: builds frontend + starts server with hot reload
+dev:
+	./run.sh
+
+# Build frontend static assets
+build-frontend:
+	cd frontend && npm install && npm run build
+
+# Bundle frontend into Python package, then build wheel + sdist
+build: build-frontend
+	rm -rf codefission/static
+	cp -r frontend/dist codefission/static
+	uv run hatch build
+
+# Publish to PyPI (builds first if needed)
+publish: build
+	uv run hatch publish
+
+# Run tests
+test:
+	uv run pytest
+
+# Clean build artifacts
+clean:
+	rm -rf frontend/dist dist codefission/static

codefission-0.1.0/PKG-INFO

@@ -0,0 +1,110 @@
+Metadata-Version: 2.4
+Name: codefission
+Version: 0.1.0
+Summary: Tree-structured AI coding assistant with git worktree isolation
+Project-URL: Homepage, https://github.com/codefission-ai/CodeFission
+Project-URL: Repository, https://github.com/codefission-ai/CodeFission
+License-Expression: MIT
+License-File: LICENSE
+Requires-Python: >=3.12
+Requires-Dist: aiosqlite
+Requires-Dist: anthropic
+Requires-Dist: claude-agent-sdk
+Requires-Dist: fastapi
+Requires-Dist: openai
+Requires-Dist: pydantic
+Requires-Dist: uvicorn[standard]
+Description-Content-Type: text/markdown
+
+# CodeFission
+
+Tree-structured AI coding assistant. Each conversation node is an isolated git worktree — branch conversations to explore alternative approaches, and each branch gets its own filesystem sandbox.
+
+## Prerequisites
+
+- [Claude Code](https://docs.anthropic.com/en/docs/claude-code) — AI backend (spawned as subprocess). Install: `npm install -g @anthropic-ai/claude-code`
+- [uv](https://docs.astral.sh/uv/installation/) — Python package manager. Install: `curl -LsSf https://astral.sh/uv/install.sh | sh`
+- [Node.js](https://nodejs.org/en/download) 18+ — frontend build. Install via system package manager or [nvm](https://github.com/nvm-sh/nvm)
+- [git](https://git-scm.com/downloads) — worktree isolation. Usually pre-installed.
+
+Authenticate Claude Code before first use:
+
+```
+claude login
+```
+
+## Quick start
+
+### Option A: Let Claude do it
+
+If you already have Claude Code installed:
+
+```
+claude -p "git clone <repo-url> codefission && cd codefission && ./run.sh"
+```
+
+### Option B: Manual
+
+```
+git clone <repo-url> codefission
+cd codefission
+./run.sh
+```
+
+On first run, `run.sh` will:
+1. Install Python dependencies via `uv` (creates `.venv/` automatically)
+2. Install npm packages and build the frontend
+3. Start the server on `http://localhost:8080`
+
+Subsequent runs skip steps 1-2 (unless dependencies or source changed).
+
+To use a different port: `./run.sh 3000`
+
+## How it works
+
+Create a tree in the sidebar, type a message, and CodeFission spawns a Claude Code session in an isolated git worktree. Branch any node to explore alternatives — each branch forks the conversation context and the filesystem state.
+
+```
+         [root]
+        /      \
+   [add auth]  [add auth]     <- same prompt, different approaches
+      |            |
+ [fix tests]  [add logging]   <- independent follow-ups
+```
+
+Every node tracks its git branch, commit, and Claude session. Child nodes fork from the parent's prompt cache so context carries over without re-sending history.
+
+## Authentication
+
+Configurable in the Settings panel (gear icon in sidebar):
+
+- **CLI (OAuth)** — default. Uses your `claude login` session. No API key needed.
+- **API Key** — provide an Anthropic API key in settings. Useful for headless/remote setups.
+
+Both modes require the Claude Code CLI binary to be installed.
+
+## Configuration
+
+Open Settings (gear icon) to configure:
+
+- **Global defaults** — provider, model, max turns, auth mode. Applies to all trees.
+- **Per-tree overrides** — provider, model, max turns. Leave as "Default" to inherit global settings.
+
+Settings persist in the backend database across sessions and devices.
+
+## Development
+
+Run tests:
+
+```
+uv run --group dev pytest
+```
+
+Frontend dev server (hot reload):
+
+```
+cd frontend
+npm run dev
+```
+
+Data is stored in `~/.codefission/` (SQLite database, git worktrees). Override with `CODEFISSION_DATA_DIR` env var.

codefission-0.1.0/README.md

@@ -0,0 +1,92 @@
+# CodeFission
+
+Tree-structured AI coding assistant. Each conversation node is an isolated git worktree — branch conversations to explore alternative approaches, and each branch gets its own filesystem sandbox.
+
+## Prerequisites
+
+- [Claude Code](https://docs.anthropic.com/en/docs/claude-code) — AI backend (spawned as subprocess). Install: `npm install -g @anthropic-ai/claude-code`
+- [uv](https://docs.astral.sh/uv/installation/) — Python package manager. Install: `curl -LsSf https://astral.sh/uv/install.sh | sh`
+- [Node.js](https://nodejs.org/en/download) 18+ — frontend build. Install via system package manager or [nvm](https://github.com/nvm-sh/nvm)
+- [git](https://git-scm.com/downloads) — worktree isolation. Usually pre-installed.
+
+Authenticate Claude Code before first use:
+
+```
+claude login
+```
+
+## Quick start
+
+### Option A: Let Claude do it
+
+If you already have Claude Code installed:
+
+```
+claude -p "git clone <repo-url> codefission && cd codefission && ./run.sh"
+```
+
+### Option B: Manual
+
+```
+git clone <repo-url> codefission
+cd codefission
+./run.sh
+```
+
+On first run, `run.sh` will:
+1. Install Python dependencies via `uv` (creates `.venv/` automatically)
+2. Install npm packages and build the frontend
+3. Start the server on `http://localhost:8080`
+
+Subsequent runs skip steps 1-2 (unless dependencies or source changed).
+
+To use a different port: `./run.sh 3000`
+
+## How it works
+
+Create a tree in the sidebar, type a message, and CodeFission spawns a Claude Code session in an isolated git worktree. Branch any node to explore alternatives — each branch forks the conversation context and the filesystem state.
+
+```
+         [root]
+        /      \
+   [add auth]  [add auth]     <- same prompt, different approaches
+      |            |
+ [fix tests]  [add logging]   <- independent follow-ups
+```
+
+Every node tracks its git branch, commit, and Claude session. Child nodes fork from the parent's prompt cache so context carries over without re-sending history.
+
+## Authentication
+
+Configurable in the Settings panel (gear icon in sidebar):
+
+- **CLI (OAuth)** — default. Uses your `claude login` session. No API key needed.
+- **API Key** — provide an Anthropic API key in settings. Useful for headless/remote setups.
+
+Both modes require the Claude Code CLI binary to be installed.
+
+## Configuration
+
+Open Settings (gear icon) to configure:
+
+- **Global defaults** — provider, model, max turns, auth mode. Applies to all trees.
+- **Per-tree overrides** — provider, model, max turns. Leave as "Default" to inherit global settings.
+
+Settings persist in the backend database across sessions and devices.
+
+## Development
+
+Run tests:
+
+```
+uv run --group dev pytest
+```
+
+Frontend dev server (hot reload):
+
+```
+cd frontend
+npm run dev
+```
+
+Data is stored in `~/.codefission/` (SQLite database, git worktrees). Override with `CODEFISSION_DATA_DIR` env var.

codefission-0.1.0/codefission/__main__.py

@@ -0,0 +1,5 @@
+"""Allow running as `python -m codefission`."""
+
+from codefission.cli import main
+
+main()

codefission-0.1.0/codefission/cli.py

@@ -0,0 +1,20 @@
+"""CLI entry point for CodeFission."""
+
+import sys
+
+import uvicorn
+
+
+def main():
+    port = int(sys.argv[1]) if len(sys.argv) > 1 else 8080
+    uvicorn.run(
+        "codefission.main:app",
+        host="0.0.0.0",
+        port=port,
+        ws_ping_interval=30,
+        ws_ping_timeout=10,
+    )
+
+
+if __name__ == "__main__":
+    main()

codefission-0.1.0/codefission/config.py

@@ -0,0 +1,29 @@
+import json
+import os
+from pathlib import Path
+
+# Fixed location for the bootstrap config (read before DB exists)
+CONFIG_FILE = Path.home() / ".codefission.json"
+
+def _load_config() -> dict:
+    if CONFIG_FILE.exists():
+        try:
+            return json.loads(CONFIG_FILE.read_text())
+        except Exception:
+            pass
+    return {}
+
+def save_config(updates: dict):
+    """Merge updates into the config file."""
+    cfg = _load_config()
+    cfg.update(updates)
+    CONFIG_FILE.write_text(json.dumps(cfg, indent=2) + "\n")
+
+_cfg = _load_config()
+
+# Data directory: config file > env var > default
+DATA_DIR = Path(
+    _cfg.get("data_dir")
+    or os.environ.get("CODEFISSION_DATA_DIR")
+    or str(Path.home() / ".codefission")
+)

codefission-0.1.0/codefission/db.py

@@ -0,0 +1,116 @@
+import aiosqlite
+from pathlib import Path
+from contextlib import asynccontextmanager
+
+from models import DEFAULT_PROVIDER, DEFAULT_MODEL
+from config import DATA_DIR
+
+DB_PATH = DATA_DIR / "codefission.db"
+
+_conn: aiosqlite.Connection | None = None
+
+
+async def _open_connection() -> aiosqlite.Connection:
+    DB_PATH.parent.mkdir(parents=True, exist_ok=True)
+    db = await aiosqlite.connect(str(DB_PATH))
+    db.row_factory = aiosqlite.Row
+    await db.execute("PRAGMA journal_mode=WAL")
+    await db.execute("PRAGMA foreign_keys=ON")
+    return db
+
+
+@asynccontextmanager
+async def get_db():
+    global _conn
+    if _conn is None:
+        _conn = await _open_connection()
+    yield _conn
+
+
+async def close_db():
+    global _conn
+    if _conn is not None:
+        await _conn.close()
+        _conn = None
+
+
+async def init_db():
+    global _conn
+    # Close existing connection (e.g. tests changing DB_PATH)
+    if _conn is not None:
+        await _conn.close()
+        _conn = None
+
+    async with get_db() as db:
+        await db.executescript("""
+            CREATE TABLE IF NOT EXISTS trees (
+                id TEXT PRIMARY KEY,
+                name TEXT NOT NULL,
+                created_at TEXT NOT NULL
+            );
+            CREATE TABLE IF NOT EXISTS nodes (
+                id TEXT PRIMARY KEY,
+                tree_id TEXT NOT NULL REFERENCES trees(id),
+                parent_id TEXT REFERENCES nodes(id),
+                user_message TEXT NOT NULL DEFAULT '',
+                assistant_response TEXT NOT NULL DEFAULT '',
+                label TEXT NOT NULL DEFAULT '',
+                status TEXT NOT NULL DEFAULT 'idle',
+                created_at TEXT NOT NULL
+            );
+            CREATE TABLE IF NOT EXISTS settings (
+                key TEXT PRIMARY KEY,
+                value TEXT
+            );
+            CREATE INDEX IF NOT EXISTS idx_nodes_tree ON nodes(tree_id);
+            CREATE INDEX IF NOT EXISTS idx_nodes_parent ON nodes(parent_id);
+        """)
+
+        # Migrate: add provider/model columns to trees if missing
+        cursor = await db.execute("PRAGMA table_info(trees)")
+        columns = {row[1] for row in await cursor.fetchall()}
+        if "provider" not in columns:
+            await db.execute(
+                f"ALTER TABLE trees ADD COLUMN provider TEXT NOT NULL DEFAULT '{DEFAULT_PROVIDER}'"
+            )
+        if "model" not in columns:
+            await db.execute(
+                f"ALTER TABLE trees ADD COLUMN model TEXT NOT NULL DEFAULT '{DEFAULT_MODEL}'"
+            )
+
+        # Migrate: add repo_mode, repo_source to trees
+        if "repo_mode" not in columns:
+            await db.execute("ALTER TABLE trees ADD COLUMN repo_mode TEXT NOT NULL DEFAULT 'none'")
+        if "repo_source" not in columns:
+            await db.execute("ALTER TABLE trees ADD COLUMN repo_source TEXT")
+
+        # Migrate: add max_turns to trees
+        if "max_turns" not in columns:
+            await db.execute("ALTER TABLE trees ADD COLUMN max_turns INTEGER")
+
+        # Migrate: add skill to trees
+        if "skill" not in columns:
+            await db.execute("ALTER TABLE trees ADD COLUMN skill TEXT NOT NULL DEFAULT ''")
+
+        # Migrate: add notes to trees
+        if "notes" not in columns:
+            await db.execute("ALTER TABLE trees ADD COLUMN notes TEXT NOT NULL DEFAULT '[]'")
+
+        # Migrate: rename provider "anthropic" → "claude-code"
+        await db.execute("UPDATE trees SET provider = 'claude-code' WHERE provider = 'anthropic'")
+
+        # Migrate: add git_branch, git_commit to nodes
+        cursor2 = await db.execute("PRAGMA table_info(nodes)")
+        node_columns = {row[1] for row in await cursor2.fetchall()}
+        if "git_branch" not in node_columns:
+            await db.execute("ALTER TABLE nodes ADD COLUMN git_branch TEXT")
+        if "git_commit" not in node_columns:
+            await db.execute("ALTER TABLE nodes ADD COLUMN git_commit TEXT")
+        if "session_id" not in node_columns:
+            await db.execute("ALTER TABLE nodes ADD COLUMN session_id TEXT")
+        if "created_by" not in node_columns:
+            await db.execute("ALTER TABLE nodes ADD COLUMN created_by TEXT NOT NULL DEFAULT 'human'")
+        if "quoted_node_ids" not in node_columns:
+            await db.execute("ALTER TABLE nodes ADD COLUMN quoted_node_ids TEXT NOT NULL DEFAULT '[]'")
+
+        await db.commit()

codefission-0.1.0/codefission/events.py

@@ -0,0 +1,103 @@
+"""Async event bus for decoupled communication between services and WebSocket layer.
+
+Adapted from WhatTheBot's core/events.py — same pub/sub pattern, CodeFission-specific events.
+"""
+
+from __future__ import annotations
+
+import asyncio
+from collections import defaultdict
+from typing import Any, Callable, Coroutine
+
+Callback = Callable[..., Coroutine[Any, Any, None]]
+
+
+class EventBus:
+    def __init__(self) -> None:
+        self._listeners: dict[str, list[Callback]] = defaultdict(list)
+
+    def on(self, event: str, callback: Callback) -> None:
+        self._listeners[event].append(callback)
+
+    def off(self, event: str, callback: Callback) -> None:
+        self._listeners[event] = [
+            cb for cb in self._listeners[event] if cb is not callback
+        ]
+
+    async def emit(self, event: str, **kwargs: Any) -> None:
+        for cb in list(self._listeners.get(event, [])):
+            asyncio.create_task(cb(**kwargs))
+
+
+# Singleton bus
+bus = EventBus()
+
+
+# ── Well-known event names (internal, backend-side) ─────────────────────
+
+STREAM_START = "stream_start"    # chat streaming begins for a node
+STREAM_DELTA = "stream_delta"    # new token(s) in a streaming response
+STREAM_END = "stream_end"        # chat streaming finished
+STREAM_ERROR = "stream_error"    # chat streaming hit an error
+NODE_CREATED = "node_created"    # a new node was created
+NODE_UPDATED = "node_updated"    # a node's data changed
+TREE_CREATED = "tree_created"    # a new tree was created
+TREE_DELETED = "tree_deleted"    # a tree was deleted
+
+
+# ── WebSocket message types (wire protocol, client ↔ server) ───────────
+
+class WS:
+    """Structured constants for WebSocket JSON message types.
+
+    Inbound  = client → server requests
+    Outbound = server → client responses/pushes
+    """
+
+    # Inbound (client → server)
+    LIST_TREES = "list_trees"
+    CREATE_TREE = "create_tree"
+    LOAD_TREE = "load_tree"
+    DELETE_TREE = "delete_tree"
+    BRANCH = "branch"
+    CHAT = "chat"
+    CANCEL = "cancel"
+    DUPLICATE = "duplicate"
+    GET_NODE = "get_node"
+    SET_REPO = "set_repo"
+    GET_NODE_FILES = "get_node_files"
+    GET_NODE_DIFF = "get_node_diff"
+    GET_FILE_CONTENT = "get_file_content"
+    SELECT_TREE = "select_tree"
+    SET_EXPANDED = "set_expanded"
+    SET_SUBTREE_COLLAPSED = "set_subtree_collapsed"
+    GET_SETTINGS = "get_settings"
+    UPDATE_GLOBAL_SETTINGS = "update_global_settings"
+    UPDATE_TREE_SETTINGS = "update_tree_settings"
+    GET_NODE_PROCESSES = "get_node_processes"
+    KILL_PROCESS = "kill_process"
+    KILL_ALL_PROCESSES = "kill_all_processes"
+    DELETE_NODE = "delete_node"
+
+    # Outbound
+    SETTINGS = "settings"
+
+    # Outbound (server → client)
+    TREES = "trees"
+    TREE_CREATED = "tree_created"
+    TREE_LOADED = "tree_loaded"
+    TREE_DELETED = "tree_deleted"
+    TREE_UPDATED = "tree_updated"
+    NODE_CREATED = "node_created"
+    NODE_DATA = "node_data"
+    NODE_FILES = "node_files"
+    NODE_DIFF = "node_diff"
+    FILE_CONTENT = "file_content"
+    STATUS = "status"
+    CHUNK = "chunk"
+    TOOL_START = "tool_start"
+    TOOL_END = "tool_end"
+    DONE = "done"
+    ERROR = "error"
+    NODE_PROCESSES = "node_processes"
+    NODES_DELETED = "nodes_deleted"