@tom2012/cc-web 1.5.10

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 zbc0315
+
+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.

package/README.md

@@ -0,0 +1,339 @@
+# CC Web
+
+A self-hosted web application (and macOS Electron desktop app) that provides a browser-based interface for [Claude Code](https://docs.anthropic.com/en/docs/claude-code) CLI sessions. Create projects, each with a persistent terminal running Claude Code, and interact with them through a real-time terminal UI.
+
+**Current version**: v1.5.10 | [GitHub](https://github.com/zbc0315/cc-web) | MIT License
+
+## Features
+
+- **Project Management**: Create, open, start, stop, and delete projects from a dashboard
+- **Real-time Terminal**: Full xterm.js terminal in the browser, connected to Claude Code via WebSocket
+- **Persistent Sessions**: Conversation history stored in each project's `.ccweb/` folder — survives uninstall/reinstall (max 20 sessions per project, auto-pruned)
+- **Permission Modes**: Run Claude in limited mode (asks before acting) or unlimited mode (`--dangerously-skip-permissions`)
+- **Shortcuts Panel**: Define reusable prompt commands at project or global level with inheritance
+- **Session History**: Browse past conversations with full message history
+- **Graph Visualization**: Topology graph from `.notebook/graph.yaml` with zoom/pan (layered DAG layout)
+- **File Browser**: Browse directories and preview/edit files with zoom-level memory per file
+- **Auto-restart**: Terminals automatically recover from crashes
+- **Usage Tracking**: Monitor Claude Code plan usage directly from the dashboard
+- **In-app Updates**: Check GitHub releases, download, and install without leaving the app
+- **Localhost Auto-auth**: Local access skips login entirely; JWT only required for remote access
+- **Auto Port Switching**: Backend tries ports 3001–3020 and reports the actual port
+- **Dark/Light Theme**: Toggle between themes
+
+## Prerequisites
+
+- **Node.js** >= 18
+- **Claude Code CLI** installed and authenticated (`claude` command available in PATH)
+
+## Quick Start — npm / npx
+
+The fastest way to get running:
+
+```bash
+# Try without installing (one-time)
+npx cc-web
+
+# Or install globally
+npm install -g cc-web
+ccweb
+```
+
+On first launch you'll be prompted to set a username and password. The server auto-selects an available port (starting from 3001) and opens your browser automatically.
+
+### CLI Commands
+
+```bash
+ccweb                      # start (interactive prompts)
+ccweb start --daemon       # start in background, no prompts
+ccweb start --foreground   # start in foreground, no prompts
+ccweb stop                 # stop background server
+ccweb status               # show PID, port, data location
+ccweb open                 # open browser to running server
+ccweb setup                # reconfigure username / password
+ccweb enable-autostart     # start automatically on login
+ccweb disable-autostart    # remove auto-start
+ccweb logs                 # tail background log file
+```
+
+All user data (credentials, projects, sessions) is stored in `~/.ccweb/` and survives package updates.
+
+**Auto-start on login**: `ccweb enable-autostart` registers a launchd agent (macOS) or systemd user service (Linux) so the server starts automatically when you log in.
+
+## Quick Start — from source (development)
+
+```bash
+# 1. Clone the repository
+git clone https://github.com/zbc0315/cc-web.git
+cd cc-web
+
+# 2. Install dependencies
+npm run install:all
+
+# 3. First-time setup (creates login credentials)
+npm run setup
+
+# 4. Start backend (Terminal 1)
+npm run dev:backend
+
+# 5. Start frontend (Terminal 2)
+npm run dev:frontend
+```
+
+Open http://localhost:5173 in your browser.
+
+## Architecture
+
+```
+Browser (React/Vite :5173 dev | Express :3001 prod)
+    │
+    ├── REST API ──────────► Express (:3001, auto-switches port if busy)
+    │                              │
+    └── WebSocket ─────────► ws server (same port)
+                                   │
+                              TerminalManager
+                                   │
+                              node-pty (PTY, user's $SHELL -ilc "claude")
+                                   │
+                              claude / claude --dangerously-skip-permissions
+```
+
+### Backend (`backend/src/`)
+
+| File | Purpose |
+|------|---------|
+| `index.ts` | Express + WS server, route mounting, static frontend serving, auto port switching, project config migration |
+| `auth.ts` | JWT middleware, localhost auto-auth (`isLocalRequest`), `generateLocalToken()` |
+| `config.ts` | File-based JSON store, `.ccweb/` per-project config helpers |
+| `terminal-manager.ts` | PTY lifecycle (`$SHELL -ilc "claude"`), scrollback buffer (5 MB), auto-restart, activity tracking |
+| `session-manager.ts` | Tails Claude's JSONL files, stores sessions in `.ccweb/sessions/`, prunes to latest 20 per project |
+| `usage-terminal.ts` | Claude Code OAuth usage stats |
+| `routes/auth.ts` | `POST /login`, `GET /local-token` (localhost only) |
+| `routes/projects.ts` | CRUD + start/stop + `POST /open` (restore from `.ccweb/`) |
+| `routes/update.ts` | `GET /check-running`, `POST /prepare` (save memory → wait idle → stop all) |
+| `routes/filesystem.ts` | Directory browser, file read/write |
+| `routes/shortcuts.ts` | Global shortcut CRUD with inheritance |
+
+### Frontend (`frontend/src/`)
+
+| File/Dir | Purpose |
+|----------|---------|
+| `App.tsx` | Router with auto-auth `PrivateRoute` (local token for localhost) |
+| `pages/LoginPage.tsx` | Login form, auto-login on localhost |
+| `pages/DashboardPage.tsx` | Project grid, new/open project, fullscreen toggle, update button |
+| `pages/ProjectPage.tsx` | Three-panel layout: FileTree \| WebTerminal \| RightPanel |
+| `components/WebTerminal.tsx` | xterm.js terminal with fit addon |
+| `components/RightPanel.tsx` | Three tabs: Shortcuts / History / Graph |
+| `components/ShortcutPanel.tsx` | Project + global shortcuts, dialog editor for add/edit |
+| `components/GraphPreview.tsx` | SVG topology graph of `.notebook/graph.yaml` (layered DAG, zoom/pan) |
+| `components/FileTree.tsx` | Expandable directory tree |
+| `components/FilePreviewDialog.tsx` | File viewer with plain/rendered/edit modes, zoom memory per file |
+| `components/UpdateButton.tsx` | In-app update: check GitHub → save memory → download → install |
+| `components/OpenProjectDialog.tsx` | Open existing project from `.ccweb/` folder |
+| `components/NewProjectDialog.tsx` | 3-step wizard: name → folder → permissions |
+| `lib/api.ts` | Typed REST client, dynamic base URL (relative in prod, localhost:3001 in dev) |
+| `lib/websocket.ts` | `useProjectWebSocket` hook, dynamic WS URL |
+| `components/ui/` | shadcn/ui components (zinc theme) |
+
+### Data Storage
+
+**Application data** (`data/` — gitignored, or `~/Library/Application Support/cc-web/data/` in Electron):
+
+```
+data/
+├── config.json              ← credentials & JWT secret
+├── projects.json            ← registered project list
+└── global-shortcuts.json    ← shared shortcut commands
+```
+
+**Per-project data** (inside each project folder, portable):
+
+```
+your-project/
+├── .ccweb/
+│   ├── project.json         ← project metadata (id, name, mode, created)
+│   └── sessions/            ← conversation history (max 20, auto-pruned)
+│       └── {timestamp}-{uuid}.json
+└── .notebook/               ← structured notes
+    ├── pages/
+    └── graph.yaml
+```
+
+The `.ccweb/` folder travels with the project. If you reinstall CC Web later, use **Open Project** to point at the folder and all history is restored.
+
+## WebSocket Protocol
+
+**Client → Server:**
+
+| Type | Payload | Purpose |
+|------|---------|---------|
+| `auth` | `{ token }` | Authenticate (skipped for localhost) |
+| `terminal_subscribe` | `{ cols, rows }` | Subscribe + replay scrollback |
+| `terminal_input` | `{ data }` | Keystrokes to PTY |
+| `terminal_resize` | `{ cols, rows }` | Resize PTY |
+
+**Server → Client:**
+
+| Type | Payload | Purpose |
+|------|---------|---------|
+| `connected` | `{ projectId }` | Ready |
+| `status` | `{ status }` | running/stopped/restarting |
+| `terminal_data` | `{ data }` | PTY output |
+| `terminal_subscribed` | `{}` | Subscription confirmed |
+| `error` | `{ message }` | Error |
+
+Localhost WebSocket connections are pre-authenticated — no `auth` message needed.
+
+## REST API
+
+| Method | Endpoint | Purpose |
+|--------|----------|---------|
+| `POST` | `/api/auth/login` | Login, returns JWT |
+| `GET` | `/api/auth/local-token` | Get local token (localhost only) |
+| `GET` | `/api/projects` | List all projects |
+| `POST` | `/api/projects` | Create new project |
+| `POST` | `/api/projects/open` | Open existing project by folder path |
+| `DELETE` | `/api/projects/:id` | Delete project |
+| `PATCH` | `/api/projects/:id/start` | Start project terminal |
+| `PATCH` | `/api/projects/:id/stop` | Stop project terminal |
+| `GET` | `/api/projects/:id/sessions` | List sessions |
+| `GET` | `/api/projects/:id/sessions/:sid` | Get session with messages |
+| `GET` | `/api/projects/activity` | Terminal activity timestamps |
+| `GET` | `/api/projects/usage` | Claude Code usage stats |
+| `GET/POST/PUT/DELETE` | `/api/shortcuts` | Global shortcut CRUD |
+| `GET` | `/api/filesystem` | Browse directories |
+| `POST` | `/api/filesystem/mkdir` | Create folder |
+| `GET/PUT` | `/api/filesystem/file` | Read/write files |
+| `GET` | `/api/update/check-running` | Check if processes are running |
+| `POST` | `/api/update/prepare` | Save memory, wait idle, stop all |
+
+## macOS Desktop App (Electron)
+
+CC Web can be packaged as a standalone macOS app using Electron.
+
+```bash
+# Install all dependencies first
+npm run install:all
+npm install
+
+# Build DMG (outputs to release/)
+npm run dist:dmg
+```
+
+The DMG will be at `release/CCWeb-{version}-arm64.dmg`. Double-click to install.
+
+On first launch, the app auto-generates login credentials and displays them in a dialog. Local access (localhost) skips login entirely. You'll need `claude` CLI installed and authenticated on your machine.
+
+**Update flow**: Download zip from GitHub releases → extract with `ditto` → replace app via detached shell script (no code signing required).
+
+### Building for other architectures
+
+Edit the `arch` field in `package.json` under `build.mac.target`:
+- `["arm64"]` — Apple Silicon (default)
+- `["x64"]` — Intel Mac
+- `["arm64", "x64"]` — Universal
+
+## Server Deployment (without Electron)
+
+```bash
+# Build everything
+npm run build
+
+# Run backend (serves built frontend statically)
+cd backend
+npm start
+
+# Or use pm2
+pm2 start backend/dist/index.js --name cc-web
+pm2 save
+pm2 startup
+```
+
+Environment variables:
+
+| Variable | Purpose | Default |
+|----------|---------|---------|
+| `CCWEB_DATA_DIR` | Override data directory | `data/` relative to backend |
+| `CCWEB_PORT` | Preferred server port | `3001` |
+
+## Build & Release
+
+```bash
+# Full build (frontend + backend + electron)
+npm run build:all
+
+# Build DMG + ZIP for release
+npm run dist
+
+# Release checklist:
+# 1. Bump version in package.json
+# 2. Update currentVersion in frontend/src/components/UpdateButton.tsx
+# 3. npm run dist
+# 4. git add -A && git commit && git push
+# 5. gh release create vX.Y.Z --title "CCWeb vX.Y.Z" \
+#      release/CCWeb-X.Y.Z-arm64.dmg \
+#      release/CCWeb-X.Y.Z-arm64-mac.zip \
+#      release/CCWeb-X.Y.Z-arm64-mac.zip.blockmap \
+#      release/latest-mac.yml
+```
+
+> **Note**: `productName` in `package.json` must not contain spaces (currently `CCWeb`), otherwise GitHub mangles the filename and auto-update gets 404.
+
+## Development Guide
+
+### Project Structure
+
+```
+cc-web/
+├── package.json         ← Root scripts + Electron build config
+├── setup.js             ← Interactive credential setup
+├── electron/
+│   ├── main.ts          ← Electron main process
+│   └── tsconfig.json
+├── backend/
+│   ├── package.json
+│   ├── tsconfig.json
+│   └── src/             ← TypeScript source
+└── frontend/
+    ├── package.json
+    ├── tsconfig.json
+    ├── vite.config.ts
+    ├── tailwind.config.js
+    └── src/             ← React + TypeScript source
+```
+
+### Key Design Decisions
+
+- **PTY-first**: Spawns the real `claude` CLI via `node-pty` using the user's `$SHELL -ilc`. All Claude Code features (slash commands, MCP, hooks, etc.) work natively.
+- **No database**: Pure JSON files, in-memory CRUD. Simple to understand, back up, and debug.
+- **Per-project `.ccweb/`**: Data travels with the project folder, survives app reinstall.
+- **Session tailing**: Reads Claude Code's native JSONL (`~/.claude/projects/`) rather than parsing PTY output.
+- **Scrollback buffer**: 5 MB per terminal for client reconnect replay.
+- **Session pruning**: Keeps latest 20 sessions per project, deletes oldest on new session start.
+- **Zoom memory**: `FilePreviewDialog` persists zoom level per file path in `localStorage`.
+- **Auto port switching**: Backend tries ports 3001–3020, reports actual port to Electron via IPC.
+- **Localhost auto-auth**: Local requests skip JWT verification entirely.
+
+### Adding a New API Endpoint
+
+1. Add the route handler in `backend/src/routes/*.ts`
+2. Auth is already applied — routes are mounted under `authMiddleware`
+3. Add the typed call in `frontend/src/lib/api.ts`
+4. Call it from your component
+
+### Adding a New Frontend Page
+
+1. Create `frontend/src/pages/YourPage.tsx`
+2. Add a route in `frontend/src/App.tsx`
+3. Use existing UI components from `frontend/src/components/ui/`
+
+### Tech Stack
+
+**Backend**: Node.js, Express, WebSocket (ws), node-pty, TypeScript
+**Frontend**: React 18, Vite, Tailwind CSS, shadcn/ui, xterm.js, TypeScript
+**Desktop**: Electron
+**Auth**: JWT (bcryptjs for password hashing)
+
+## License
+
+MIT

package/backend/dist/auth.d.ts

@@ -0,0 +1,15 @@
+import { Request, Response, NextFunction } from 'express';
+export interface AuthRequest extends Request {
+    user?: {
+        username: string;
+    };
+}
+/** Check if request originates from localhost */
+export declare function isLocalRequest(req: Request): boolean;
+export declare function verifyToken(token: string): {
+    username: string;
+} | null;
+/** Generate a JWT for local access (no credentials needed) */
+export declare function generateLocalToken(): string;
+export declare function authMiddleware(req: AuthRequest, res: Response, next: NextFunction): void;
+//# sourceMappingURL=auth.d.ts.map

package/backend/dist/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAI1D,MAAM,WAAW,WAAY,SAAQ,OAAO;IAC1C,IAAI,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7B;AAED,iDAAiD;AACjD,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAOpD;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAQtE;AAED,8DAA8D;AAC9D,wBAAgB,kBAAkB,IAAI,MAAM,CAG3C;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,YAAY,GAAG,IAAI,CA2BxF"}

package/backend/dist/auth.js

@@ -0,0 +1,92 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isLocalRequest = isLocalRequest;
+exports.verifyToken = verifyToken;
+exports.generateLocalToken = generateLocalToken;
+exports.authMiddleware = authMiddleware;
+const jwt = __importStar(require("jsonwebtoken"));
+const config_1 = require("./config");
+/** Check if request originates from localhost */
+function isLocalRequest(req) {
+    const ip = req.ip || req.socket.remoteAddress || '';
+    return (ip === '127.0.0.1' ||
+        ip === '::1' ||
+        ip === '::ffff:127.0.0.1');
+}
+function verifyToken(token) {
+    try {
+        const config = (0, config_1.getConfig)();
+        const decoded = jwt.verify(token, config.jwtSecret);
+        return { username: decoded.username };
+    }
+    catch {
+        return null;
+    }
+}
+/** Generate a JWT for local access (no credentials needed) */
+function generateLocalToken() {
+    const config = (0, config_1.getConfig)();
+    return jwt.sign({ username: config.username }, config.jwtSecret, { expiresIn: '30d' });
+}
+function authMiddleware(req, res, next) {
+    // Local access: auto-authenticate without token
+    if (isLocalRequest(req)) {
+        try {
+            const config = (0, config_1.getConfig)();
+            req.user = { username: config.username };
+        }
+        catch {
+            req.user = { username: 'local' };
+        }
+        next();
+        return;
+    }
+    // Remote access: require Bearer token
+    const authHeader = req.headers['authorization'];
+    if (!authHeader || !authHeader.startsWith('Bearer ')) {
+        res.status(401).json({ error: 'Unauthorized' });
+        return;
+    }
+    const token = authHeader.slice(7);
+    const user = verifyToken(token);
+    if (!user) {
+        res.status(401).json({ error: 'Invalid or expired token' });
+        return;
+    }
+    req.user = user;
+    next();
+}
+//# sourceMappingURL=auth.js.map

package/backend/dist/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AASA,wCAOC;AAED,kCAQC;AAGD,gDAGC;AAED,wCA2BC;AA5DD,kDAAoC;AACpC,qCAAqC;AAMrC,iDAAiD;AACjD,SAAgB,cAAc,CAAC,GAAY;IACzC,MAAM,EAAE,GAAG,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,MAAM,CAAC,aAAa,IAAI,EAAE,CAAC;IACpD,OAAO,CACL,EAAE,KAAK,WAAW;QAClB,EAAE,KAAK,KAAK;QACZ,EAAE,KAAK,kBAAkB,CAC1B,CAAC;AACJ,CAAC;AAED,SAAgB,WAAW,CAAC,KAAa;IACvC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAA,kBAAS,GAAE,CAAC;QAC3B,MAAM,OAAO,GAAG,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,SAAS,CAAyB,CAAC;QAC5E,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,8DAA8D;AAC9D,SAAgB,kBAAkB;IAChC,MAAM,MAAM,GAAG,IAAA,kBAAS,GAAE,CAAC;IAC3B,OAAO,GAAG,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,EAAE,MAAM,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;AACzF,CAAC;AAED,SAAgB,cAAc,CAAC,GAAgB,EAAE,GAAa,EAAE,IAAkB;IAChF,gDAAgD;IAChD,IAAI,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC;QACxB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAA,kBAAS,GAAE,CAAC;YAC3B,GAAG,CAAC,IAAI,GAAG,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC;QAC3C,CAAC;QAAC,MAAM,CAAC;YACP,GAAG,CAAC,IAAI,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;QACnC,CAAC;QACD,IAAI,EAAE,CAAC;QACP,OAAO;IACT,CAAC;IAED,sCAAsC;IACtC,MAAM,UAAU,GAAG,GAAG,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;IAChD,IAAI,CAAC,UAAU,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QACrD,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC,CAAC;QAChD,OAAO;IACT,CAAC;IACD,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAClC,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;IAChC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,0BAA0B,EAAE,CAAC,CAAC;QAC5D,OAAO;IACT,CAAC;IACD,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC;IAChB,IAAI,EAAE,CAAC;AACT,CAAC"}

package/backend/dist/config.d.ts

@@ -0,0 +1,33 @@
+import { Project, Config, CliTool } from './types';
+export interface GlobalShortcut {
+    id: string;
+    label: string;
+    command: string;
+    parentId?: string;
+}
+export declare const DATA_DIR: string;
+export declare function initDataDirs(): void;
+export declare function getConfig(): Config;
+export declare function getProjects(): Project[];
+export declare function saveProjects(projects: Project[]): void;
+export declare function getProject(id: string): Project | undefined;
+export declare function saveProject(project: Project): void;
+export declare function deleteProject(id: string): void;
+export declare function getGlobalShortcuts(): GlobalShortcut[];
+export declare function saveGlobalShortcuts(shortcuts: GlobalShortcut[]): void;
+export interface ProjectConfig {
+    id: string;
+    name: string;
+    permissionMode: 'limited' | 'unlimited';
+    cliTool: CliTool;
+    createdAt: string;
+}
+export declare function ccwebDir(folderPath: string): string;
+export declare function ccwebSessionsDir(folderPath: string): string;
+/** Write .ccweb/project.json into the project folder */
+export declare function writeProjectConfig(folderPath: string, project: Project): void;
+/** Read .ccweb/project.json from a project folder. Returns null if not found. */
+export declare function readProjectConfig(folderPath: string): ProjectConfig | null;
+/** Update .ccweb/project.json (partial update) */
+export declare function updateProjectConfig(folderPath: string, updates: Partial<ProjectConfig>): void;
+//# sourceMappingURL=config.d.ts.map

package/backend/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAEnD,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,eAAO,MAAM,QAAQ,QAAmE,CAAC;AAYzF,wBAAgB,YAAY,IAAI,IAAI,CAOnC;AAED,wBAAgB,SAAS,IAAI,MAAM,CAMlC;AAED,wBAAgB,WAAW,IAAI,OAAO,EAAE,CAIvC;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,IAAI,CAEtD;AAED,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAE1D;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CASlD;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAE9C;AAED,wBAAgB,kBAAkB,IAAI,cAAc,EAAE,CAGrD;AAED,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,cAAc,EAAE,GAAG,IAAI,CAErE;AAOD,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,SAAS,GAAG,WAAW,CAAC;IACxC,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAE3D;AAED,wDAAwD;AACxD,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAW7E;AAED,iFAAiF;AACjF,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAQ1E;AAED,kDAAkD;AAClD,wBAAgB,mBAAmB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,GAAG,IAAI,CAM7F"}

package/backend/dist/config.js

@@ -0,0 +1,155 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DATA_DIR = void 0;
+exports.initDataDirs = initDataDirs;
+exports.getConfig = getConfig;
+exports.getProjects = getProjects;
+exports.saveProjects = saveProjects;
+exports.getProject = getProject;
+exports.saveProject = saveProject;
+exports.deleteProject = deleteProject;
+exports.getGlobalShortcuts = getGlobalShortcuts;
+exports.saveGlobalShortcuts = saveGlobalShortcuts;
+exports.ccwebDir = ccwebDir;
+exports.ccwebSessionsDir = ccwebSessionsDir;
+exports.writeProjectConfig = writeProjectConfig;
+exports.readProjectConfig = readProjectConfig;
+exports.updateProjectConfig = updateProjectConfig;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+exports.DATA_DIR = process.env.CCWEB_DATA_DIR || path.join(__dirname, '../../data');
+/** Atomic write: write to temp file then rename, preventing corruption on crash */
+function atomicWriteSync(filePath, data) {
+    const tmpPath = filePath + `.tmp.${process.pid}`;
+    fs.writeFileSync(tmpPath, data, 'utf-8');
+    fs.renameSync(tmpPath, filePath);
+}
+const CONFIG_FILE = path.join(exports.DATA_DIR, 'config.json');
+const PROJECTS_FILE = path.join(exports.DATA_DIR, 'projects.json');
+const SHORTCUTS_FILE = path.join(exports.DATA_DIR, 'global-shortcuts.json');
+function initDataDirs() {
+    if (!fs.existsSync(exports.DATA_DIR)) {
+        fs.mkdirSync(exports.DATA_DIR, { recursive: true });
+    }
+    if (!fs.existsSync(PROJECTS_FILE)) {
+        fs.writeFileSync(PROJECTS_FILE, JSON.stringify([], null, 2), 'utf-8');
+    }
+}
+function getConfig() {
+    if (!fs.existsSync(CONFIG_FILE)) {
+        throw new Error('Config file not found. Please run: npm run setup');
+    }
+    const raw = fs.readFileSync(CONFIG_FILE, 'utf-8');
+    return JSON.parse(raw);
+}
+function getProjects() {
+    if (!fs.existsSync(PROJECTS_FILE))
+        return [];
+    const raw = fs.readFileSync(PROJECTS_FILE, 'utf-8');
+    return JSON.parse(raw);
+}
+function saveProjects(projects) {
+    atomicWriteSync(PROJECTS_FILE, JSON.stringify(projects, null, 2));
+}
+function getProject(id) {
+    return getProjects().find((p) => p.id === id);
+}
+function saveProject(project) {
+    const projects = getProjects();
+    const index = projects.findIndex((p) => p.id === project.id);
+    if (index >= 0) {
+        projects[index] = project;
+    }
+    else {
+        projects.push(project);
+    }
+    saveProjects(projects);
+}
+function deleteProject(id) {
+    saveProjects(getProjects().filter((p) => p.id !== id));
+}
+function getGlobalShortcuts() {
+    if (!fs.existsSync(SHORTCUTS_FILE))
+        return [];
+    return JSON.parse(fs.readFileSync(SHORTCUTS_FILE, 'utf-8'));
+}
+function saveGlobalShortcuts(shortcuts) {
+    atomicWriteSync(SHORTCUTS_FILE, JSON.stringify(shortcuts, null, 2));
+}
+// ── .ccweb/ per-project config ────────────────────────────────────────────────
+const CCWEB_DIR = '.ccweb';
+const PROJECT_CONFIG_FILE = 'project.json';
+function ccwebDir(folderPath) {
+    return path.join(folderPath, CCWEB_DIR);
+}
+function ccwebSessionsDir(folderPath) {
+    return path.join(folderPath, CCWEB_DIR, 'sessions');
+}
+/** Write .ccweb/project.json into the project folder */
+function writeProjectConfig(folderPath, project) {
+    const dir = ccwebDir(folderPath);
+    fs.mkdirSync(dir, { recursive: true });
+    const config = {
+        id: project.id,
+        name: project.name,
+        permissionMode: project.permissionMode,
+        cliTool: project.cliTool,
+        createdAt: project.createdAt,
+    };
+    atomicWriteSync(path.join(dir, PROJECT_CONFIG_FILE), JSON.stringify(config, null, 2));
+}
+/** Read .ccweb/project.json from a project folder. Returns null if not found. */
+function readProjectConfig(folderPath) {
+    const file = path.join(ccwebDir(folderPath), PROJECT_CONFIG_FILE);
+    if (!fs.existsSync(file))
+        return null;
+    try {
+        return JSON.parse(fs.readFileSync(file, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+/** Update .ccweb/project.json (partial update) */
+function updateProjectConfig(folderPath, updates) {
+    const existing = readProjectConfig(folderPath);
+    if (!existing)
+        return;
+    const merged = { ...existing, ...updates };
+    const dir = ccwebDir(folderPath);
+    atomicWriteSync(path.join(dir, PROJECT_CONFIG_FILE), JSON.stringify(merged, null, 2));
+}
+//# sourceMappingURL=config.js.map