codedna 0.4.2__tar.gz → 0.5.0__tar.gz

{codedna-0.4.2 → codedna-0.5.0}/CHANGELOG.md

@@ -1,5 +1,36 @@
 # Changelog
 
+## [0.5.0] - 2026-06-24 — "Phase 8: Demo Mode + VS Code Marketplace"
+
+### ✨ Added — Demo Mode (Part A)
+- **`codedna/demo.py`** — new module with `seed_demo_data`, `clear_demo_data`, `is_demo_active`
+  - 47 fake commits over 30 days, varying AI probability (0.1–0.9)
+  - 4 authors, 8 files, 3 sprints with realistic health scores
+  - 20% null understanding scores, 80% in [3.0, 5.0]
+  - Idempotent: tags demo rows with `__demo__` prefix
+- **`codedna demo` CLI command** — seed + auto-start dashboard
+  - `codedna demo` — seed and start dashboard
+  - `codedna demo --reset` — clear all demo rows
+  - `codedna demo --data-only` — seed without starting dashboard
+- **FastAPI endpoints** — `/demo/status`, `/demo/seed`, `/demo/reset`
+- **Dashboard banner** — orange banner at top of dashboard when demo is active
+  - Dismissable, persisted in localStorage
+  - i18n keys: `demo_banner`, `demo_close`, `demo_init_cta`
+
+### ✨ Added — VS Code Marketplace (Part B)
+- **`vscode-extension/package.json`** — full marketplace metadata
+  - `icon` (128x128 PNG), `galleryBanner`, `badges`, `keywords`, `categories`
+  - `homepage`, `bugs`, `repository`, `license: MIT`
+  - `scripts` for `compile`/`watch`/`package`/`publish`
+  - `devDependencies`: `@vscode/vsce ^2.24.0`
+- **`vscode-extension/images/icon.png`** — 128x128 dark cyan/emerald DNA helix
+- **`vscode-extension/.vscodeignore`** — excludes `src/`, `node_modules/`, `*.ts`
+- **`vscode-extension/MARKETPLACE_README.md`** — full English marketplace description
+- **`vscode-extension/PUBLISH.md`** — step-by-step publishing instructions
+
+### 🔄 Changed
+- Minor version bump (0.4.2 → 0.5.0) — major feature release, breaks the 7-patch cascade
+
 ## [0.4.2] - 2026-06-24 — "Doctor Legacy Style"
 
 ### 🎨 Redesigned

{codedna-0.4.2 → codedna-0.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: codedna
-Version: 0.4.2
+Version: 0.5.0
 Summary: AI Code Transparency Tool - detect AI-written code and measure developer understanding
 Project-URL: Homepage, https://codedna.dev
 Project-URL: Repository, https://github.com/natureco-official/codedna

{codedna-0.4.2 → codedna-0.5.0}/codedna/__init__.py

@@ -1,4 +1,4 @@
 """CodeDNA — AI Code Transparency Tool."""
 
-__version__ = "0.4.2"
+__version__ = "0.5.0"
 __app_name__ = "codedna"

{codedna-0.4.2 → codedna-0.5.0}/codedna/api.py

@@ -97,6 +97,40 @@ async def health_check() -> dict:
     }
 
 
+# ---------------------------------------------------------------------------
+# Demo mode endpoints
+# ---------------------------------------------------------------------------
+@app.get("/demo/status", tags=["Demo"])
+async def demo_status() -> dict:
+    """Check whether demo data is currently active in the database."""
+    from codedna.demo import is_demo_active, _count_demo
+    db = _db_path()
+    init_db(db)
+    active = is_demo_active(db)
+    return {
+        "active": active,
+        "counts": _count_demo(db) if active else {"commits": 0, "files": 0, "authors": 0, "sprints": 0},
+    }
+
+
+@app.post("/demo/seed", tags=["Demo"])
+async def demo_seed() -> dict:
+    """Seed the database with realistic fake demo data (idempotent)."""
+    from codedna.demo import seed_demo_data
+    db = _db_path()
+    init_db(db)
+    return seed_demo_data(db)
+
+
+@app.delete("/demo/reset", tags=["Demo"])
+async def demo_reset() -> dict:
+    """Clear all demo data from the database."""
+    from codedna.demo import clear_demo_data
+    db = _db_path()
+    deleted = clear_demo_data(db)
+    return {"deleted": deleted, "active": False}
+
+
 @app.get("/repo/summary", tags=["Repo"])
 async def repo_summary() -> dict:
     """Repo-wide summary: average AI score, total commits, risk level."""

{codedna-0.4.2 → codedna-0.5.0}/codedna/cli.py

@@ -2055,6 +2055,97 @@ def update(
         console.print()
 
 
+# ---------------------------------------------------------------------------
+# codedna demo (seed database with realistic fake data)
+# ---------------------------------------------------------------------------
+@app.command()
+def demo(
+    reset: bool = typer.Option(False, "--reset", help="Clear all demo data"),
+    data_only: bool = typer.Option(False, "--data-only", help="Seed data only, don't start dashboard"),
+) -> None:
+    """Load demo data into the database (idempotent) and open the dashboard."""
+    from codedna.demo import seed_demo_data, clear_demo_data, is_demo_active
+    from codedna.db import get_db_path
+
+    db_path = get_db_path()
+
+    console.print()
+    if reset:
+        deleted = clear_demo_data(db_path)
+        console.print(
+            Panel(
+                f"[bold green]✓ Demo data cleared.[/bold green]\n\n"
+                f"[dim]Removed:[/dim] [yellow]{deleted}[/yellow] [dim]rows[/dim]",
+                title="[bold cyan]🧬 CodeDNA — Demo Reset[/bold cyan]",
+                border_style="cyan",
+                padding=(1, 2),
+            )
+        )
+        console.print()
+        return
+
+    # Seed
+    if is_demo_active(db_path):
+        console.print(
+            Panel(
+                "[bold yellow]⚠ Demo data already seeded.[/bold yellow]\n\n"
+                "[dim]Run [bold]codedna demo --reset[/bold] to clear and re-seed.[/dim]",
+                title="[bold yellow]🧬 CodeDNA — Demo Mode[/bold yellow]",
+                border_style="yellow",
+                padding=(1, 2),
+            )
+        )
+        console.print()
+        return
+
+    console.print("[bold cyan]🧬 CodeDNA Demo Mode[/bold cyan]")
+    console.print("─" * 40)
+    console.print()
+
+    with console.status("[dim]Seeding demo data...[/dim]"):
+        counts = seed_demo_data(db_path)
+
+    console.print(f"  [green]✓[/green] [bold]{counts['commits']}[/bold] commits loaded")
+    console.print(f"  [green]✓[/green] [bold]{counts['files']}[/bold] files analyzed")
+    console.print(f"  [green]✓[/green] [bold]{counts['authors']}[/bold] developer profiles created")
+    console.print(f"  [green]✓[/green] [bold]{counts['sprints']}[/bold] sprints recorded")
+    console.print()
+
+    # Summary panel
+    body = (
+        f"[bold green]✓ Demo data ready![/bold green]\n\n"
+        f"[dim]Dashboard:[/dim] [cyan]http://localhost:3000[/cyan]\n"
+        f"[dim]API:[/dim]       [cyan]http://localhost:8000[/cyan]\n\n"
+        f"[yellow]⚠ Demo data is fake — for previewing the dashboard only.[/yellow]\n"
+        f"[dim]Run [bold]codedna demo --reset[/bold] to clear demo data.[/dim]"
+    )
+    console.print(Panel(body, border_style="green", padding=(1, 2)))
+    console.print()
+
+    if data_only:
+        console.print("[dim]--data-only flag set, dashboard not started.[/dim]")
+        console.print()
+        return
+
+    # Try to start dashboard (subprocess so we don't block this command)
+    import subprocess
+    import sys
+    console.print("[dim]Starting dashboard in background...[/dim]")
+    try:
+        subprocess.Popen(
+            [sys.executable, "-m", "codedna", "dashboard"],
+            stdout=subprocess.DEVNULL,
+            stderr=subprocess.DEVNULL,
+            start_new_session=True,
+        )
+        console.print(f"  [green]✓[/green] Dashboard starting at [cyan]http://localhost:3000[/cyan]")
+        console.print(f"  [dim]API at [cyan]http://localhost:8000[/cyan][/dim]")
+    except Exception as e:
+        console.print(f"  [yellow]⚠ Could not auto-start dashboard: {e}[/yellow]")
+        console.print(f"  [dim]Run [bold]codedna dashboard[/bold] manually to start it.[/dim]")
+    console.print()
+
+
 # ---------------------------------------------------------------------------
 # codedna setup (interactive AI analysis configuration wizard)
 # ---------------------------------------------------------------------------

codedna-0.5.0/codedna/demo.py

@@ -0,0 +1,245 @@
+"""
+Demo mode — seeds the database with realistic fake data for new users.
+
+Does NOT perform real code analysis.
+All data is deterministic (random.seed(42)) and tagged with '__demo__' prefix.
+"""
+from __future__ import annotations
+
+import json
+import random
+import sqlite3
+import time
+from pathlib import Path
+from typing import Optional
+
+DEMO_COMMIT_PREFIX = "__demo__"
+
+# ── Seed data ───────────────────────────────────────────────────────────
+AUTHORS = [
+    "alice@example.com",
+    "bob@example.com",
+    "carol@example.com",
+    "dave@example.com",
+]
+
+FILES = [
+    "src/auth/handler.py",
+    "src/api/routes.py",
+    "src/utils/helpers.py",
+    "src/db/models.py",
+    "tests/test_auth.py",
+    "tests/test_api.py",
+    "src/payments/checkout.py",
+    "src/notifications/email.py",
+]
+
+SPRINT_NAMES = ["Sprint 23 — Auth refactor", "Sprint 24 — API v2", "Sprint 25 — Payments"]
+
+
+# ── Helpers ────────────────────────────────────────────────────────────
+def is_demo_active(db_path: Path) -> bool:
+    """Return True if demo data exists in the database."""
+    if not db_path.exists():
+        return False
+    try:
+        with sqlite3.connect(str(db_path)) as conn:
+            row = conn.execute(
+                "SELECT COUNT(*) AS c FROM commits WHERE commit_hash LIKE ?",
+                (f"{DEMO_COMMIT_PREFIX}%",),
+            ).fetchone()
+            return bool(row and row[0] > 0)
+    except sqlite3.DatabaseError:
+        return False
+
+
+def clear_demo_data(db_path: Path) -> int:
+    """Remove all demo rows. Returns number of rows deleted."""
+    if not db_path.exists():
+        return 0
+    deleted = 0
+    with sqlite3.connect(str(db_path)) as conn:
+        # file_scores first (FK to commits)
+        cur = conn.execute(
+            "DELETE FROM file_scores WHERE commit_hash LIKE ?",
+            (f"{DEMO_COMMIT_PREFIX}%",),
+        )
+        deleted += cur.rowcount
+        cur = conn.execute(
+            "DELETE FROM commits WHERE commit_hash LIKE ?",
+            (f"{DEMO_COMMIT_PREFIX}%",),
+        )
+        deleted += cur.rowcount
+        cur = conn.execute(
+            "DELETE FROM file_ownership WHERE file_path LIKE ?",
+            (f"{DEMO_COMMIT_PREFIX}%",),
+        )
+        deleted += cur.rowcount
+        cur = conn.execute(
+            "DELETE FROM sprints WHERE sprint_name LIKE ?",
+            (f"{DEMO_COMMIT_PREFIX}%",),
+        )
+        deleted += cur.rowcount
+        conn.commit()
+    return deleted
+
+
+def _rand_understanding() -> Optional[float]:
+    """Realistic understanding distribution: 20% null, 80% in [3.0, 5.0]."""
+    if random.random() < 0.2:
+        return None
+    return round(random.uniform(3.0, 5.0), 2)
+
+
+def _rand_ai_probability() -> float:
+    """AI probability varies 0.1–0.9."""
+    return round(random.uniform(0.1, 0.9), 2)
+
+
+def _complexity_label(score: float) -> str:
+    if score >= 70:
+        return "high"
+    if score >= 40:
+        return "medium"
+    return "low"
+
+
+def _complexity_score() -> float:
+    return round(random.uniform(20.0, 90.0), 1)
+
+
+def _commit_hash(idx: int) -> str:
+    return f"{DEMO_COMMIT_PREFIX}{idx:04d}"
+
+
+# ── Main seeder ────────────────────────────────────────────────────────
+def seed_demo_data(db_path: Path) -> dict:
+    """
+    Seed database with demo data. Idempotent — skips if demo data already exists.
+    Returns: {"commits": N, "files": N, "authors": N, "sprints": N}
+    """
+    random.seed(42)
+    db_path.parent.mkdir(parents=True, exist_ok=True)
+
+    # Make sure schema exists
+    from codedna.db import init_db
+    init_db(db_path)
+
+    if is_demo_active(db_path):
+        existing = _count_demo(db_path)
+        existing["status"] = "already_seeded"
+        return existing
+
+    now = int(time.time())
+    day = 24 * 60 * 60
+
+    with sqlite3.connect(str(db_path)) as conn:
+        # ── Commits (47 over last 30 days) ─────────────────────────────
+        commit_hashes: list[str] = []
+        for i in range(47):
+            ch = _commit_hash(i)
+            commit_hashes.append(ch)
+            author = random.choice(AUTHORS)
+            ts = now - random.randint(0, 30) * day - random.randint(0, 86400)
+            files_changed = random.randint(1, 4)
+            understanding = _rand_understanding()
+            conn.execute(
+                """INSERT INTO commits (commit_hash, author, timestamp, files_changed, understanding_score)
+                   VALUES (?, ?, ?, ?, ?)""",
+                (ch, author, ts, files_changed, understanding),
+            )
+
+            # file_scores for this commit (1–3 files per commit)
+            n_files = random.randint(1, 3)
+            for _ in range(n_files):
+                fpath = random.choice(FILES)
+                ai_p = _rand_ai_probability()
+                cx = _complexity_score()
+                cmt_ratio = round(random.uniform(0.05, 0.25), 2)
+                conn.execute(
+                    """INSERT INTO file_scores
+                       (commit_hash, file_path, ai_probability, complexity_score,
+                        comment_ratio, understanding_score, ai_tool_guess)
+                       VALUES (?, ?, ?, ?, ?, ?, ?)""",
+                    (
+                        ch,
+                        fpath,
+                        ai_p,
+                        cx,
+                        cmt_ratio,
+                        _rand_understanding(),
+                        random.choice(["cursor", "copilot", "claude", "chatgpt"]),
+                    ),
+                )
+
+        # ── file_ownership (1–3 owners per file) ───────────────────────
+        for fpath in FILES:
+            owners = random.sample(AUTHORS, k=random.randint(1, 3))
+            for owner in owners:
+                lines = random.randint(20, 300)
+                last_t = now - random.randint(0, 30) * day
+                conn.execute(
+                    """INSERT OR IGNORE INTO file_ownership
+                       (file_path, author, lines_owned, last_touched, avg_understanding)
+                       VALUES (?, ?, ?, ?, ?)""",
+                    (f"{DEMO_COMMIT_PREFIX}{fpath}", owner, lines, last_t, _rand_understanding()),
+                )
+
+        # ── Sprints (3) ────────────────────────────────────────────────
+        sprint_scores = [82.0, 61.0, 74.0]
+        for i, (name, score) in enumerate(zip(SPRINT_NAMES, sprint_scores)):
+            start = now - (3 - i) * 14 * day
+            end = start + 14 * day
+            conn.execute(
+                """INSERT INTO sprints
+                   (sprint_name, start_date, end_date, total_lines_ai, total_lines_human,
+                    avg_understanding, debt_delta_hours, health_score)
+                   VALUES (?, ?, ?, ?, ?, ?, ?, ?)""",
+                (
+                    f"{DEMO_COMMIT_PREFIX}{name}",
+                    start,
+                    end,
+                    random.randint(200, 800),
+                    random.randint(100, 500),
+                    round(random.uniform(3.0, 4.5), 2),
+                    round(random.uniform(-2.0, 5.0), 1),
+                    score,
+                ),
+            )
+
+        conn.commit()
+
+    return _count_demo(db_path)
+
+
+def _count_demo(db_path: Path) -> dict:
+    """Return counts of demo-tagged rows."""
+    out = {"commits": 0, "files": 0, "authors": 0, "sprints": 0}
+    if not db_path.exists():
+        return out
+    with sqlite3.connect(str(db_path)) as conn:
+        row = conn.execute(
+            "SELECT COUNT(*) FROM commits WHERE commit_hash LIKE ?",
+            (f"{DEMO_COMMIT_PREFIX}%",),
+        ).fetchone()
+        out["commits"] = row[0] if row else 0
+
+        row = conn.execute(
+            "SELECT COUNT(DISTINCT author) FROM commits WHERE commit_hash LIKE ?",
+            (f"{DEMO_COMMIT_PREFIX}%",),
+        ).fetchone()
+        out["authors"] = row[0] if row else 0
+
+        row = conn.execute(
+            "SELECT COUNT(DISTINCT file_path) FROM file_scores WHERE commit_hash LIKE ?",
+            (f"{DEMO_COMMIT_PREFIX}%",),
+        ).fetchone()
+        out["files"] = row[0] if row else 0
+
+        row = conn.execute(
+            "SELECT COUNT(*) FROM sprints WHERE sprint_name LIKE ?",
+            (f"{DEMO_COMMIT_PREFIX}%",),
+        ).fetchone()
+        out["sprints"] = row[0] if row else 0
+
+    return out

{codedna-0.4.2 → codedna-0.5.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "codedna"
-version = "0.4.2"
+version = "0.5.0"
 description = "AI Code Transparency Tool - detect AI-written code and measure developer understanding"
 readme = "README.md"
 requires-python = ">=3.10"

codedna-0.5.0/vscode-extension/.vscodeignore

@@ -0,0 +1,6 @@
+.vscode/**
+src/**
+node_modules/**
+*.ts
+tsconfig.json
+.gitignore

codedna-0.5.0/vscode-extension/MARKETPLACE_README.md

@@ -0,0 +1,68 @@
+# CodeDNA — AI Code Transparency for VS Code
+
+**Understand every line of code you commit. Is it really yours, or AI's?**
+
+CodeDNA shows AI risk and developer understanding scores directly in your editor. Inline decorations flag AI-heavy code, the status bar displays the current file's risk level, and a single click opens the full dashboard for sprint health, bus factor, and technical debt analysis.
+
+## Features
+
+- **Status bar indicator** — current file's AI risk score, color-coded (green/yellow/red)
+- **Inline decorations** — gutter icons next to AI-generated lines
+- **Dashboard link** — one-click access to the full CodeDNA dashboard
+- **Auto-refresh** — pulls latest scores from your local CodeDNA server
+- **Free & open source** — works offline, no telemetry, no cloud lock-in
+
+## Requirements
+
+- **Python 3.10+**
+- **codedna package** — `pip install codedna` (or `uv tool install codedna`)
+- **Local API server** — `codedna serve` must be running (default: `http://localhost:8000`)
+
+## Quick Start
+
+1. **Install the CLI:**
+   ```bash
+   pip install codedna
+   # or
+   uv tool install codedna
+   ```
+
+2. **Start the API server** in your project:
+   ```bash
+   cd your-project
+   codedna init
+   codedna serve
+   ```
+
+3. **Install this extension** from the VS Code marketplace, then open any file in your project. The status bar will show the AI risk score for the current file.
+
+## Extension Settings
+
+| Setting | Default | Description |
+|---------|---------|-------------|
+| `codedna.apiUrl` | `http://localhost:8000` | CodeDNA API server URL |
+| `codedna.dashboardUrl` | `http://localhost:3000` | CodeDNA dashboard URL |
+| `codedna.enabled` | `true` | Enable/disable the extension |
+
+## Commands
+
+- `CodeDNA: Refresh` — re-fetch scores from the API
+- `CodeDNA: Open Dashboard` — open the dashboard in your browser
+- `CodeDNA: Show File Risk` — show detailed risk breakdown for the current file
+
+## Known Limitations
+
+- Requires a local `codedna serve` instance (no cloud mode yet)
+- Status bar shows the latest commit score, not real-time analysis
+- Dashboard requires a separate Next.js process (`codedna dashboard`)
+
+## Links
+
+- [GitHub](https://github.com/natureco-official/codedna)
+- [PyPI](https://pypi.org/project/codedna/)
+- [Documentation](https://github.com/natureco-official/codedna/blob/main/README.md)
+- [Issue tracker](https://github.com/natureco-official/codedna/issues)
+
+## License
+
+MIT © 2026 NatureCo

codedna-0.5.0/vscode-extension/PUBLISH.md

@@ -0,0 +1,64 @@
+# Publishing to VS Code Marketplace
+
+## One-time setup
+
+1. **Create a publisher** at https://marketplace.visualstudio.com/manage
+   - Publisher ID must be exactly: `codedna`
+
+2. **Get a Personal Access Token** from https://dev.azure.com
+   - Organization: `Marketplace`
+   - Scopes: `Marketplace → Manage`
+
+3. **Login locally:**
+   ```bash
+   npx vsce login codedna
+   ```
+   (paste the PAT when prompted)
+
+## Publish
+
+```bash
+cd vscode-extension
+npm install
+npm run compile
+npx vsce package        # creates codedna-vscode-0.1.0.vsix
+npx vsce publish        # publishes to marketplace
+```
+
+The extension will be live at:
+`https://marketplace.visualstudio.com/items?itemName=codedna.codedna-vscode`
+
+## Update
+
+Bump version in `package.json`, then:
+
+```bash
+npx vsce publish patch  # 0.1.0 → 0.1.1
+npx vsce publish minor  # 0.1.0 → 0.2.0
+npx vsce publish major  # 0.1.0 → 1.0.0
+```
+
+Or edit `package.json` manually and run `npx vsce publish` (no flag = use new version).
+
+## Test locally
+
+```bash
+# Build the .vsix
+npx vsce package
+
+# Install in your VS Code
+code --install-extension codedna-vscode-0.1.0.vsix
+
+# Or use the development version
+code --install-extension .
+
+# Then test by opening a project that has `codedna serve` running
+```
+
+## Pre-flight checklist
+
+- [ ] `package.json` icon path resolves to a valid 128x128 PNG
+- [ ] `MARKETPLACE_README.md` is up to date with current features
+- [ ] `npm run compile` produces `out/extension.js` without errors
+- [ ] `npx vsce package` creates a `.vsix` file (no errors about missing icon, repository, license)
+- [ ] Bumped version (can't publish same version twice)

{codedna-0.4.2 → codedna-0.5.0}/vscode-extension/package.json

@@ -4,10 +4,42 @@
   "description": "AI Code Transparency — inline risk & understanding indicators",
   "version": "0.1.0",
   "publisher": "codedna",
+  "icon": "images/icon.png",
+  "galleryBanner": {
+    "color": "#0a0a0a",
+    "theme": "dark"
+  },
+  "badges": [
+    {
+      "url": "https://img.shields.io/pypi/v/codedna",
+      "href": "https://pypi.org/project/codedna/",
+      "description": "PyPI version"
+    }
+  ],
+  "keywords": ["ai", "code-quality", "git", "developer-tools", "technical-debt"],
+  "categories": ["Other", "Linters"],
+  "homepage": "https://github.com/natureco-official/codedna",
+  "bugs": {
+    "url": "https://github.com/natureco-official/codedna/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/natureco-official/codedna"
+  },
+  "license": "MIT",
   "engines": { "vscode": "^1.85.0" },
-  "categories": ["Other"],
   "activationEvents": ["onStartupFinished"],
   "main": "./out/extension.js",
+  "scripts": {
+    "compile": "tsc -p ./",
+    "watch": "tsc -watch -p ./",
+    "vscode:prepublish": "npm run compile",
+    "package": "vsce package",
+    "publish": "vsce publish"
+  },
+  "devDependencies": {
+    "@vscode/vsce": "^2.24.0"
+  },
   "contributes": {
     "configuration": {
       "title": "CodeDNA",