v1.0.0 — CodeAtlas initial release

Visualize any codebase in 5 minutes. Local-first, privacy-focused.

Features:
- Multi-language parsing: JavaScript, TypeScript, Python, Java
- Three perspectives: System Framework, Logic Operation, Data Journey
- AI-powered analysis: Claude, Gemini, OpenAI, Ollama
- Wiki knowledge export + Obsidian knowledge graph
- i18n: English + Traditional Chinese
- Zero-config launch: npm install -g codeatlas && codeatlas

MIT License — Copyright 2026 Stanshy

Author: Stanshy

.eslintrc.js

@@ -0,0 +1,93 @@
+/** @type {import('eslint').Linter.Config} */
+module.exports = {
+  root: true,
+  parser: '@typescript-eslint/parser',
+  parserOptions: {
+    ecmaVersion: 2022,
+    sourceType: 'module',
+    project: true,
+  },
+  plugins: ['@typescript-eslint'],
+  extends: [
+    'eslint:recommended',
+    'plugin:@typescript-eslint/recommended',
+    'plugin:@typescript-eslint/recommended-requiring-type-checking',
+  ],
+  rules: {
+    '@typescript-eslint/no-explicit-any': 'error',
+    '@typescript-eslint/no-unused-vars': ['error', { argsIgnorePattern: '^_' }],
+    '@typescript-eslint/consistent-type-imports': ['error', { prefer: 'type-imports' }],
+    '@typescript-eslint/no-import-type-side-effects': 'error',
+    'no-console': ['warn', { allow: ['warn', 'error'] }],
+  },
+  ignorePatterns: ['dist/', 'node_modules/', '*.js', '!.eslintrc.js'],
+  overrides: [
+    {
+      // Parser provider files use dynamic require() to load optional native
+      // bindings and WASM modules.  The external modules have no TypeScript
+      // type declarations, so `any` is the intentional escape hatch here.
+      files: [
+        'packages/core/src/parser/providers/native-tree-sitter.ts',
+        'packages/core/src/parser/providers/wasm-tree-sitter.ts',
+        'packages/core/src/parser/providers/typescript-compiler.ts',
+      ],
+      rules: {
+        '@typescript-eslint/no-explicit-any': 'off',
+        '@typescript-eslint/no-unsafe-assignment': 'off',
+        '@typescript-eslint/no-unsafe-call': 'off',
+        '@typescript-eslint/no-unsafe-member-access': 'off',
+        '@typescript-eslint/no-unsafe-argument': 'off',
+        '@typescript-eslint/no-redundant-type-constituents': 'off',
+        '@typescript-eslint/no-unnecessary-type-assertion': 'off',
+        '@typescript-eslint/consistent-type-imports': 'off',
+      },
+    },
+    {
+      // AI provider stubs intentionally have no await — they throw immediately
+      // or return a static string.  The async signature is required by the
+      // SummaryProvider interface so callers can await them uniformly.
+      files: [
+        'packages/core/src/ai/anthropic.ts',
+        'packages/core/src/ai/disabled.ts',
+        'packages/core/src/ai/openai.ts',
+      ],
+      rules: {
+        '@typescript-eslint/require-await': 'off',
+      },
+    },
+    {
+      // scanner/index.ts uses a safe cast on readdir's return type because the
+      // TypeScript overload signature does not narrow to string names when
+      // encoding:'utf8' is passed; the cast is correct and intentional.
+      files: ['packages/core/src/scanner/index.ts'],
+      rules: {
+        '@typescript-eslint/no-unnecessary-type-assertion': 'off',
+      },
+    },
+    {
+      // server.ts uses a manually-typed reply helper that returns `any` so it
+      // works with both Fastify v4 and v5 reply signatures without importing
+      // the concrete generic type.
+      files: ['packages/cli/src/server.ts'],
+      rules: {
+        '@typescript-eslint/no-unsafe-call': 'off',
+        '@typescript-eslint/no-unsafe-member-access': 'off',
+      },
+    },
+    {
+      // CLI command files must use console.log/warn/error to communicate with
+      // the terminal — that is their sole output mechanism.
+      files: ['packages/cli/src/commands/**/*.ts'],
+      rules: {
+        'no-console': 'off',
+      },
+    },
+    {
+      // web.ts is a CLI sub-command that also uses console for server status.
+      files: ['packages/cli/src/web.ts'],
+      rules: {
+        'no-console': 'off',
+      },
+    },
+  ],
+};

.github/workflows/ci.yml

@@ -0,0 +1,57 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  ci:
+    runs-on: ubuntu-latest
+    timeout-minutes: 10
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 9
+
+      - name: Get pnpm store directory
+        shell: bash
+        run: echo "STORE_PATH=$(pnpm store path --silent)" >> $GITHUB_ENV
+
+      - name: Cache pnpm dependencies
+        uses: actions/cache@v4
+        with:
+          path: ${{ env.STORE_PATH }}
+          key: ${{ runner.os }}-pnpm-store-${{ hashFiles('**/pnpm-lock.yaml') }}
+          restore-keys: |
+            ${{ runner.os }}-pnpm-store-
+
+      - name: Install dependencies
+        run: pnpm install
+
+      - name: Lint
+        run: pnpm run lint
+
+      - name: Type Check
+        run: pnpm run type-check
+
+      - name: Build
+        run: pnpm run build
+
+      - name: Test
+        run: pnpm run test

.gitignore

@@ -0,0 +1,65 @@
+# Dependencies
+node_modules/
+.pnp
+.pnp.js
+
+# Build outputs
+dist/
+build/
+out/
+
+# TypeScript incremental build info
+*.tsbuildinfo
+
+# CodeAtlas runtime
+.codeatlas/
+
+# Test coverage
+coverage/
+.nyc_output/
+
+# Environment variables
+.env
+.env.local
+.env.*.local
+
+# Logs
+*.log
+npm-debug.log*
+pnpm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+logs/
+
+# OS generated files
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+ehthumbs.db
+Thumbs.db
+
+# Editor directories and files
+.vscode/*
+!.vscode/extensions.json
+!.vscode/settings.json
+.idea/
+*.swp
+*.swo
+*~
+
+# Vitest
+.vitest-cache/
+
+# Claude Code harness runtime
+.claude/hook-execution.jsonl
+.claude/settings.local.json
+
+# Internal files — excluded from GitHub (orphan branch)
+# These are kept in local git history but not pushed to public repo
+CLAUDE.md
+.claude/
+.knowledge/
+proposal/
+.tasks/

.npmrc

@@ -0,0 +1 @@
+ignore-scripts=false

.prettierrc

@@ -0,0 +1,11 @@
+{
+  "semi": true,
+  "singleQuote": true,
+  "trailingComma": "all",
+  "printWidth": 100,
+  "tabWidth": 2,
+  "useTabs": false,
+  "bracketSpacing": true,
+  "arrowParens": "always",
+  "endOfLine": "lf"
+}

CHANGELOG.md

@@ -0,0 +1,86 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/).
+
+---
+
+## [1.0.0] - 2026-04-10
+
+### Added
+
+**Core Parsing Engine**
+- Multi-language static analysis for JavaScript, TypeScript, Python, and Java using tree-sitter Node.js bindings
+- Import resolution and dependency graph construction for all supported languages
+- Class, method, and function extraction with signature-level granularity
+- Endpoint detection for REST API routes across common frameworks
+- Incremental parsing support to avoid re-analyzing unchanged files
+
+**Three Perspectives Visualization**
+- System Framework (SF) view — directory-level architecture overview with automatic role classification (controller, service, model, utility, config, and more)
+- Logic Operation (LO) view — method-level call flow graph with category grouping, showing how functions invoke each other across file boundaries
+- Data Journey (DJ) view — endpoint-level request tracing with step-by-step data flow from HTTP entry point through service and persistence layers
+
+**AI-Powered Analysis**
+- Pluggable AI provider architecture supporting Claude (Anthropic), Gemini (Google), OpenAI, and Ollama (local)
+- AI-generated code summaries at the file, class, and method level
+- Intelligent role classification to distinguish controllers, services, repositories, and utilities without manual annotation
+- Endpoint description generation for REST APIs including parameter and response documentation
+- All AI features are optional — the tool is fully functional with AI disabled
+
+**Wiki Knowledge Export**
+- Generate Obsidian-compatible Markdown files from any analyzed codebase
+- Cross-referenced internal links using `[[WikiLink]]` notation for seamless navigation
+- Interactive knowledge graph rendered from exported Markdown in Obsidian Graph View
+- Structured export covering architecture overview, module descriptions, and endpoint references
+- `codeatlas wiki` command for standalone export without opening the full web UI
+
+**Web UI**
+- React-based visualization powered by React Flow for node-graph rendering and D3.js for force-directed layouts
+- Three-perspective tab navigation with persistent view state across perspective switches
+- Context-sensitive detail panels for nodes — shows summary, file path, dependencies, and AI analysis when available
+- Toolbar with search, filter, and layout controls for large graphs
+- Camera preset shortcuts for navigating complex graphs quickly
+- DJPanel for endpoint flow inspection with expandable step trace
+- LODetailPanel and SFDetailPanel for method-level and directory-level node details respectively
+
+**CLI Interface**
+- `codeatlas` — launch the web UI in the default browser with welcome screen
+- `codeatlas web` — start the local Fastify server and open the visualization UI
+- `codeatlas wiki` — run analysis and export Obsidian-compatible Markdown to the output directory
+- `codeatlas analyze` — run static analysis only and output graph JSON without starting the web server
+
+**Welcome and Onboarding Experience**
+- Zero-config launch: running `codeatlas` opens the browser directly to a project selection screen
+- Recent projects list with quick-open support
+- AI provider setup guidance with step-by-step configuration instructions built into the UI
+- First-run detection with contextual hints for new users
+
+**Progress Tracking**
+- Real-time analysis progress reporting via Server-Sent Events (SSE) streaming
+- Per-file progress updates during large project analysis
+- Error reporting inline without aborting the full analysis run
+
+**i18n: Internationalization**
+- Full English and Traditional Chinese (zh-TW) language support across the entire web UI
+- Language toggle accessible from the toolbar
+- All UI strings, panel labels, tooltips, error messages, and onboarding copy translated
+- i18n architecture designed for additional language contributions
+
+**Privacy-First Architecture**
+- All analysis runs locally on the user's machine
+- Code and graph data never leave the local environment
+- No telemetry, no analytics, no network requests during analysis
+- AI features use the user's own API keys with direct provider connections — no proxy
+
+**Developer Experience**
+- pnpm monorepo with three packages: `@codeatlas/core`, `@codeatlas/cli`, `@codeatlas/web`
+- `fixtures/` directory with sample projects in TypeScript, JavaScript, Python, and Java for reproducible testing
+- Vitest test suite covering the core parsing engine and graph construction logic
+- Fastify server with clean separation between static file serving and API routing
+- Graph JSON output format versioned and documented in `api-design.md`
+
+---
+
+[1.0.0]: https://github.com/Stanshy/CodeAtlas/releases/tag/v1.0.0