noterai 0.1.0

package/README.md

@@ -0,0 +1,368 @@
+# Noter
+
+A locally-run, browser-based AI agent dashboard that monitors AI agent activity, summarizes context using a local or cloud LLM, and generates next-step task suggestions and implementation prompts.
+
+> **npm package:** [`noterai`](https://www.npmjs.com/package/noterai) — install with `npx noterai` or `npm install -g noterai`. The CLI command is `noter`.
+
+## Architecture
+
+```
+┌─────────────────────────────────┐     ┌─────────────────────────────────┐
+│  OpenCode (SSE port 4096)       │     │  Claude Code (MCP stdio)        │
+└────────────┬────────────────────┘     └────────────┬────────────────────┘
+             │ SSE                                   │ MCP
+             └────────────────┬──────────────────────┘
+                              │
+                    ┌─────────▼──────────┐
+                    │  Express Backend   │  port 3000
+                    │  (packages/server) │
+                    │                  │
+                    │  • EventStore    │  200 events, FIFO ring buffer
+                    │  • StateManager  │  summary, suggestions, notes, prompts
+                    │  • Summarizer    │  Ollama + ai-sdk generateObject
+                    │  • Suggester     │  Ollama + ai-sdk generateObject
+                    │  • PromptBuilder │  Ollama / Anthropic / OpenAI / Gemini
+                    │  • OllamaQueue   │  serialized inference queue
+                    │  • OllamaCache   │  memoized provider instances
+                    │  • wsServer      │  ping/pong heartbeat, 1MB msg limit
+                    │  • MCP Server    │  stdio transport, send_event + get_state
+                    └─────────┬────────┘
+                              │ WebSocket + HTTP
+                    ┌─────────▼──────────┐
+                    │  React Frontend    │  port 5173 (dev) / served static
+                    │  (packages/client) │
+                    │                  │
+                    │  • 2x2 grid layout│  Editorial Brutalism design system
+                    │  • wsClient      │  auto-reconnect, exponential backoff
+                    │  • 4 panels      │  Notes, Tasks, Context, Prompts
+                    └──────────────────┘
+```
+
+## Quick Start
+
+### From npm (no clone needed)
+
+```bash
+npx noterai              # Run without installing (opens browser automatically)
+npx noterai serve         # Production server without auto-opening browser
+npx noterai serve --open  # Production server + auto-open browser
+npx noterai help          # Show all commands
+npx noterai version       # Print version
+
+# Or install globally:
+npm install -g noterai
+noter                     # Then run directly
+```
+
+### From source (development)
+
+```bash
+git clone https://github.com/oniwakaa/noter.git && cd noter
+pnpm install
+pnpm run dev
+```
+
+The dashboard opens at `http://localhost:5173`. The backend runs on `http://localhost:3000`.
+
+> **Note:** `pnpm run dev` starts both the backend server (`:3000`) and the Vite dev client (`:5173`) concurrently.
+
+## Prerequisites
+
+- **Node.js** >= 20 (tested on v24.4.1)
+- **pnpm** >= 10 (tested on v10.30.3)
+- **Ollama** running locally with at least one model pulled (check `ollama list`)
+  - Default model in `.env.example` is `falcon-h1r:7b-q4_K_M` — **update `.env` to a model you have installed** (e.g. `deepseek-v4-flash:cloud` or `gemma4:e4b`)
+- *(Optional)* **OpenCode** CLI for OpenCode SSE event ingestion
+- *(Optional)* API keys if using cloud LLM providers for prompt generation (Anthropic, OpenAI, Gemini)
+
+## Environment Variables
+
+Copy `.env.example` to `.env` and adjust values:
+
+```bash
+cp .env.example .env
+```
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `PORT` | `3000` | Backend HTTP/WebSocket server port |
+| `VITE_SERVER_PORT` | `3000` | **Must match `PORT`** — used by Vite proxy and WebSocket client |
+| `OLLAMA_BASE_URL` | `http://localhost:11434` | Ollama API endpoint |
+| `OLLAMA_MODEL` | `falcon-h1r:7b-q4_K_M` | Model for summarization & suggestions. **Must be a model you have pulled locally.** |
+| `CONTEXT_OFFLOAD_THRESHOLD` | `0.8` | Auto-offload model when accumulated context exceeds this % of context window (0.0–1.0) |
+| `VRAM_LIMIT_GB` | `6` | VRAM display limit for the Ollama status memory bar |
+| `OPENCODE_PORT` | `4096` | OpenCode SSE stream port (only when `ACTIVE_SOURCE` includes `opencode`) |
+| `ACTIVE_SOURCE` | `generic` | Event source: `opencode`, `claude-code`, `codex`, `factory-droid`, `pi`, `generic`, `auto`, `both`, or `all` |
+| `NOTER_EVENT_LOG` | `/tmp/noter-events.jsonl` | Path to JSONL event log for file-based adapters (Droid, Pi) |
+| `GENERIC_LOG_PATH` | `/tmp/noter-generic-events.jsonl` | Path to JSONL event log for the generic adapter |
+| `LLM_PROVIDER` | `ollama` | Prompt generation provider: `ollama`, `anthropic`, `openai`, `gemini` |
+| `ANTHROPIC_API_KEY` | *(empty)* | Required when `LLM_PROVIDER=anthropic` |
+| `OPENAI_API_KEY` | *(empty)* | Required when `LLM_PROVIDER=openai` |
+| `GEMINI_API_KEY` | *(empty)* | Required when `LLM_PROVIDER=gemini` |
+
+## Scripts
+
+### Root (`package.json`)
+
+| Script | Description |
+|--------|-------------|
+| `pnpm run dev` | Start both server and client concurrently |
+| `pnpm run dev:server` | Start backend only (Express + WebSocket on port 3000) |
+| `pnpm run dev:client` | Start frontend only (Vite dev server on port 5173) |
+| `pnpm run build` | Build shared + server + client + bin for production |
+| `pnpm run typecheck` | TypeScript strict mode check (both packages) |
+| `pnpm run test` | Run full Vitest suite (server + client workspaces) |
+
+### Sub-package scripts
+
+```bash
+# Client build
+cd packages/client && pnpm run build   # tsc && vite build
+cd packages/client && pnpm run preview  # preview production build
+
+# Server build
+cd packages/server && pnpm run build    # tsc
+cd packages/server && pnpm run build:mcp  # tsc, outputs dist/mcp-server.js
+```
+
+### CLI (`bin/noter.ts` / `bin/noter.js`)
+
+The package exposes a `noter` CLI via the `bin` field:
+
+```bash
+noter --help             # Show all commands
+noter version            # Print version
+noter serve              # Production server (serves static frontend + API)
+noter serve --open        # Production server + auto-open browser
+noter dev                 # Development mode (hot-reload)
+noter build               # Build client & server for production
+PORT=8080 noter serve     # Custom port
+```
+
+## Project Structure
+
+```
+noter/
+├── bin/
+│   ├── noter.ts              # CLI source (compiled to noter.js for publish)
+│   ├── noter.js              # Compiled CLI entry point (gitignored, built on publish)
+│   └── tsconfig.json         # Bin-specific tsconfig (node16 module resolution)
+├── packages/
+│   ├── server/               # Express + WebSocket backend
+│   │   ├── src/
+│   │   │   ├── adapters/
+│   │   │   │   ├── opencodeAdapter.ts   # OpenCode SSE → AgentEvent
+│   │   │   │   ├── claudeAdapter.ts     # Claude Code MCP → AgentEvent
+│   │   │   │   ├── codexAdapter.ts      # OpenAI Codex CLI MCP → AgentEvent
+│   │   │   │   ├── droidAdapter.ts      # Factory Droid hooks → AgentEvent
+│   │   │   │   ├── piAdapter.ts         # Pi (pi.dev) hooks → AgentEvent
+│   │   │   │   └── genericAdapter.ts    # Generic JSONL/webhook → AgentEvent
+│   │   │   ├── llm/
+│   │   │   │   ├── ollamaClient.ts      # Low-level Ollama client (60s timeout, AbortController)
+│   │   │   │   ├── ollamaCache.ts       # Memoized createOllama() provider instances
+│   │   │   │   ├── ollamaQueue.ts       # Serialized inference queues (suggester + inference)
+│   │   │   │   ├── summarizer.ts        # ContextSummary generation from events
+│   │   │   │   ├── suggester.ts         # TaskSuggestion[] generation from context + notes
+│   │   │   │   └── promptBuilder.ts   # GeneratedPrompt from task + context + notes
+│   │   │   ├── routes/
+│   │   │   │   ├── notes.ts           # POST /api/notes → save + fire-and-forget suggest
+│   │   │   │   ├── prompt.ts          # POST /api/prompt (by taskId) + GET /:taskId
+│   │   │   │   ├── summarize.ts       # POST /api/summarize (mutex-guarded)
+│   │   │   │   └── ollama.ts          # GET /api/ollama/status + POST /api/ollama/offload
+│   │   │   ├── config.ts              # AppConfig, types, loadConfig(), Zod-like validation
+│   │   │   ├── eventStore.ts          # In-memory FIFO ring buffer (200 max)
+│   │   │   ├── stateManager.ts        # Shared state + task→prompt map
+│   │   │   ├── wsServer.ts            # WebSocketServer wrapper (heartbeat, 1MB limit)
+│   │   │   ├── mcp-server.ts          # MCP stdio server (send_event, get_state tools)
+│   │   │   └── index.ts               # createApp() factory + listenServer() + startServer()
+│   │   └── package.json
+│   └── client/               # React + Vite frontend
+│       ├── src/
+│       │   ├── components/
+│       │   │   ├── NotesPanel.tsx       # Debounced textarea, drag-to-delete
+│       │   │   ├── SuggestionsPanel.tsx # Task cards, priority badges, conflict warnings
+│       │   │   ├── ContextPanel.tsx     # Summary fields, Ollama status, activity log
+│       │   │   ├── PromptsPanel.tsx     # Build → expand prompt, copy to clipboard
+│       │   │   └── OllamaStatus.tsx    # Model name, connection, VRAM bar, offload
+│       │   ├── styles/
+│       │   │   └── tokens.css           # DESIGN.md tokens: monochrome, zero-radius, no shadows
+│       │   ├── App.tsx                  # 2x2 grid, top nav, dark/light toggle
+│       │   ├── wsClient.ts              # Singleton WebSocket client (reconnect backoff)
+│       │   ├── localDeletions.ts        # Drag-delete tracking set
+│       │   ├── types.ts                 # Shared TypeScript interfaces
+│       │   └── test/                    # Component tests (RTL + jsdom)
+│       └── package.json
+├── .env.example              # All environment variables with comments
+├── vitest.workspace.ts        # Server (node) + Client (jsdom) test workspaces
+├── tsconfig.base.json         # Shared TypeScript strict config
+├── pnpm-workspace.yaml        # Monorepo workspace definition
+└── README.md                  # This file
+```
+
+## Frontend Panels
+
+The UI is a fixed 2x2 viewport grid separated by 1px solid dividers (`outline_variant`).
+
+| Panel | Grid Position | Description |
+|-------|--------------|-------------|
+| **Notes** | Top-left | Borderless textarea with debounced save (500ms POST to `/api/notes`). Supports drag-to-delete: drop a task card here to remove it. |
+| **Suggested Tasks** | Top-right | Task cards (`TaskSuggestion[]`) with priority badges (high/medium/low), conflict warnings, and a **"Build →"** action to generate a prompt. |
+| **Agent Context** | Bottom-left | `ContextSummary` fields: what's happening, files changed, current goal, blockers. Includes Ollama status (model, VRAM bar, offload button). Terminal-style activity log. |
+| **Suggested Prompts** | Bottom-right | List of generated prompts. Click **"Build →"** to expand a prompt row (animated from `0fr` to `1fr`). Each prompt has a copy-to-clipboard button. |
+
+**Design System:** High-End Editorial Brutalism — zero `border-radius`, no `box-shadow`, monochrome palette (`#131313` surface), Space Grotesk for labels, Geist Mono for data/code. See [`DESIGN.md`](./DESIGN.md) for full spec.
+
+## WebSocket Message Types
+
+All messages are typed as `WsMessage` union. The client auto-reconnects with exponential backoff (500ms → 30s max).
+
+```typescript
+type WsMessage =
+  | { type: 'sync';    payload: { events: AgentEvent[]; summary: ContextSummary | null; suggestions: TaskSuggestion[]; notes: HumanNotes | null } }
+  | { type: 'event';   payload: AgentEvent }
+  | { type: 'summary';  payload: ContextSummary }
+  | { type: 'suggestions'; payload: TaskSuggestion[] }
+  | { type: 'notes';   payload: HumanNotes };
+```
+
+- **`sync`** — sent to every new WebSocket connection to hydrate frontend state.
+- **`event`** — broadcast when a new agent event is ingested.
+- **`summary`** — broadcast when the summarizer generates a new context summary.
+- **`suggestions`** — broadcast when new task suggestions are generated.
+- **`notes`** — broadcast when notes are updated.
+
+**Server-side protections:** ping/pong heartbeat every 30s (stale connections terminated), maximum message size 1MB.
+
+## API Endpoints
+
+### `GET /health`
+Returns `{"status":"ok"}` — used by services.yaml healthcheck and CLI startup verification.
+
+### `POST /api/notes`
+**Body:** `{ content: string, updatedAt: number }` (Zod-validated)
+
+Saves notes, returns `{ saved: true }` immediately, then **fire-and-forget** generates `TaskSuggestion[]` via the suggester queue. Suggestions are broadcast via WebSocket.
+
+### `POST /api/prompt`
+**Body:** `{ taskId: string }` (Zod-validated)
+
+Generates a `GeneratedPrompt` for the given task using the configured `LLM_PROVIDER`. Uses shared `INFERENCE_QUEUE` to serialize with summarization. Returns `404` if taskId not found, `500` if API key missing or generation fails.
+
+**Also:** `GET /api/prompt/:taskId` — retrieve a previously generated prompt for a task.
+
+### `POST /api/summarize`
+**Body:** none required.
+
+Triggers context summarization manually. Mutex-guarded: concurrent requests return `202` without duplicate Ollama calls. Returns `ContextSummary` with fields: `whatIsHappening`, `filesChanged`, `currentGoal`, `blockers`, `rawEventCount`.
+
+### `GET /api/ollama/status`
+Returns Ollama `/api/ps` response formatted with `models[]` and `memory{}` (totalSize, totalVram, usedPercent).
+
+### `POST /api/ollama/offload`
+Offloads all loaded Ollama models (sends `keep_alive: 0`).
+
+## MCP Integration
+
+Noter exposes an MCP server via stdio transport for use with Claude Code, Cursor, VS Code Copilot, Continue.dev, Windsurf, and OpenAI Codex CLI.
+
+**Tools:**
+- **`send_event`** — Push an agent event into the pipeline. Zod-validated against `AgentEvent` schema. Stored in `eventStore`, broadcast via WebSocket, and processed by the summarizer.
+- **`get_state`** — Returns current application state (summary, suggestions, notes) as JSON.
+
+**Configuration** — add to your agent's MCP settings (e.g. `~/.claude/mcp.json`, `.cursor/mcp.json`, or equivalent):
+
+```json
+{
+  "mcpServers": {
+    "noter": {
+      "command": "node",
+      "args": ["packages/server/dist/mcp-server.js"]
+    }
+  }
+}
+```
+
+### Per-Harness Setup
+
+**Claude Code & OpenAI Codex CLI:**
+Both use the same MCP protocol. Add the MCP server config above to your agent's settings, then set `ACTIVE_SOURCE=claude-code` (or `codex`, or `all`).
+
+**Factory Droid:**
+Droid writes events to `/tmp/noter-events.jsonl` via its hooks system. The `droidAdapter.ts` watches this file automatically when `ACTIVE_SOURCE` includes `factory-droid`.
+
+**Pi (pi.dev):**
+Pi extensions can emit events to the same JSONL file. Install a `noter-bridge.ts` extension in Pi that writes `{ type, sessionId, payload, timestamp }` lines to `NOTER_EVENT_LOG`.
+
+**OpenCode:**
+Run `opencode` with the `--events` flag pointing to `http://localhost:${OPENCODE_PORT}`. The `opencodeAdapter.ts` connects via SSE.
+
+**Generic (any harness):**
+The generic adapter watches a JSONL file (default: `/tmp/noter-generic-events.jsonl`) for events from any agent harness. Zero-config — just write JSON events to the default path, or set `GENERIC_LOG_PATH` for a custom path. Set `ACTIVE_SOURCE=generic` (the default).
+
+## Ollama Integration
+
+- **Provider caching:** `ollamaCache.ts` memoizes `createOllama()` instances by `baseURL` so the same provider config is reused across summarizer, suggester, and prompt builder.
+- **Queue serialization:** `ollamaQueue.ts` provides two queues:
+  - `INFERENCE_QUEUE` — shared between summarizer and prompt builder (prevents concurrent calls).
+  - `SUGGESTER_QUEUE` — dedicated queue for suggestion generation (runs independently).
+- **Timeout:** `ollamaClient.ts` uses `AbortController` with a 60-second default timeout. Configurable via `OllamaClientOptions.timeout`.
+- **Context auto-offload:** Tracks accumulated token usage and automatically offloads models when the context window threshold (`CONTEXT_OFFLOAD_THRESHOLD`) is exceeded.
+
+## LLM Providers for Prompt Generation
+
+| Provider | Model ID | Requires Key |
+|----------|---------|-------------|
+| `ollama` | Configured `OLLAMA_MODEL` | No |
+| `anthropic` | `claude-sonnet-4-20250514` | `ANTHROPIC_API_KEY` |
+| `openai` | `gpt-4o` | `OPENAI_API_KEY` |
+| `gemini` | `gemini-2.5-flash` | `GEMINI_API_KEY` |
+
+## Event Sources
+
+| Source | Adapter | Transport | Trigger |
+|--------|---------|-----------|---------|
+| **OpenCode** | `opencodeAdapter.ts` | SSE (`http://localhost:${OPENCODE_PORT}`) | `session.idle`, `tool.before/after`, `message.updated` |
+| **Claude Code** | `claudeAdapter.ts` | MCP stdio | `send_event` tool calls |
+| **OpenAI Codex CLI** | `codexAdapter.ts` | MCP stdio | `send_event` tool calls |
+| **Factory Droid** | `droidAdapter.ts` | File hooks (`AGENTDESK_EVENT_LOG`) | `tool.before/after`, `session.start/end` |
+| **Pi (pi.dev)** | `piAdapter.ts` | File hooks (`AGENTDESK_EVENT_LOG`) | `tool_call`, `tool_result`, `agent_start/end` |
+| **Generic** | `genericAdapter.ts` | JSONL file watcher + webhook | Any harness writing JSON events |
+
+Set `ACTIVE_SOURCE=all` to ingest from all supported harnesses simultaneously.
+
+## Testing
+
+```bash
+# Full suite (server + client)
+pnpm run test
+
+# Server only (node environment)
+pnpm vitest run --project server
+
+# Client only (jsdom environment)
+pnpm vitest run --project client
+
+# With coverage
+pnpm vitest run --coverage
+```
+
+- **Server tests:** 30+ test files covering routes, adapters (5 harnesses), LLM pipeline, config validation, WebSocket server, MCP server, session management, and CLI.
+- **Client tests:** 10+ component test files using React Testing Library + jsdom.
+
+## TypeScript
+
+Strict mode enabled across both packages. Root `tsconfig.base.json` provides shared compiler options.
+
+```bash
+pnpm run typecheck   # Both packages
+```
+
+## Security
+
+- No hardcoded secrets in source files.
+- `.env` is in `.gitignore`.
+- API keys are read exclusively via `loadConfig()` in `config.ts`.
+
+## License
+
+MIT

package/bin/noter.js

@@ -0,0 +1,218 @@
+#!/usr/bin/env node
+// noter — CLI-first repo-aware startup
+//
+// When launched inside a git repository, automatically:
+//   1. Detects the repository root
+//   2. Loads AGENTS.md / AGENT.md as repo instructions
+//   3. Matches active harness sessions for this repo
+//   4. Injects all context into the running server
+import { createApp, listenServer } from '../packages/server/dist/index.js';
+import { loadConfig } from '../packages/server/dist/config.js';
+import { resolveRepoContext, formatStartupLog } from '../packages/server/dist/repoContext.js';
+import { stateManager } from '../packages/server/dist/stateManager.js';
+import { execSync } from 'child_process';
+import { resolve, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { existsSync, readFileSync } from 'fs';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const ROOT = resolve(__dirname, '..');
+const CLIENT_DIST = resolve(ROOT, 'packages/client/dist');
+const PACKAGE_JSON = resolve(ROOT, 'package.json');
+function log(msg) {
+    console.log(`[noter] ${msg}`);
+}
+function logError(msg) {
+    console.error(`[noter] ${msg}`);
+}
+function getVersion() {
+    const raw = readFileSync(PACKAGE_JSON, 'utf-8');
+    const pkg = JSON.parse(raw);
+    return pkg.version ?? '0.0.1';
+}
+function showHelp() {
+    const version = getVersion();
+    const help = `
+noter v${version} — CLI-first repo-aware AI agent dashboard
+
+Usage:
+  noter [command] [options]
+
+Commands:
+  (default)    Start with repo-aware context (auto-detect repo, load AGENTS.md)
+  serve        Start the production server (serves frontend + API)
+  dev          Start development mode (hot-reload client & server)
+  build        Build client and server for production
+  help         Show this help message
+  version      Print the version number
+
+Options:
+  serve --open     Open the browser after starting the server
+  serve --no-open  Do not open the browser (default for 'serve')
+
+Repo-Aware Behavior:
+  When launched inside a git repository, noter automatically:
+    - Detects the repository root (walks up from CWD to find .git)
+    - Loads AGENTS.md or AGENT.md from the repo root (AGENTS.md takes precedence)
+    - Matches active harness sessions (Pi, Factory Droid) by repo path
+    - Injects repo instructions into summarization, suggestions, and prompts
+  When launched from a non-repo directory, all repo-specific features are skipped.
+
+Environment Variables:
+  PORT                  Server port (default: 3000)
+  OLLAMA_BASE_URL       Ollama API URL (default: http://localhost:11434)
+  OLLAMA_MODEL          Ollama model name (default: falcon-h1r:7b-q4_K_M)
+  ACTIVE_SOURCE         Event source: opencode | claude-code | codex | factory-droid | pi | generic | auto
+  LLM_PROVIDER          LLM provider: ollama | anthropic | openai | gemini
+  OPENCODE_PORT          OpenCode SSE port (default: 4096)
+  ANTHROPIC_API_KEY      API key for Anthropic
+  OPENAI_API_KEY         API key for OpenAI
+  GEMINI_API_KEY         API key for Google Gemini
+
+Examples:
+  noter                    Repo-aware startup + open browser
+  noter serve              Start server without opening browser
+  noter serve --open       Start server and open browser
+  noter dev                Start development mode
+  noter build              Build for production
+  PORT=8080 noter serve    Start server on port 8080
+`.trim();
+    console.log(help);
+}
+async function build() {
+    log('Building client...');
+    execSync('pnpm run build', { cwd: resolve(ROOT, 'packages/client'), stdio: 'inherit' });
+    log('Building server...');
+    execSync('pnpm run build', { cwd: resolve(ROOT, 'packages/server'), stdio: 'inherit' });
+    log('Build complete.');
+}
+async function serve(openBrowser) {
+    // Auto-build if client dist is missing
+    if (!existsSync(CLIENT_DIST)) {
+        log('Client build not found. Building...');
+        await build();
+    }
+    // Resolve repo context BEFORE starting the server
+    const cwd = process.cwd();
+    const repoCtx = resolveRepoContext(cwd);
+    // Log startup context
+    for (const line of formatStartupLog(repoCtx)) {
+        log(line);
+    }
+    // Store repo context in state manager so it's available to all routes/LLM prompts
+    stateManager.setRepoContext(repoCtx);
+    // Lazy-load config to pick up env vars (including PORT)
+    const cfg = loadConfig();
+    const { default: express } = await import('express');
+    const appServer = await createApp();
+    // Serve static frontend in production
+    appServer.app.use(express.static(CLIENT_DIST));
+    // Express v5 SPA fallback — catch-all route using {*path} parameter
+    appServer.app.get('{*path}', (_req, res) => {
+        res.sendFile(resolve(CLIENT_DIST, 'index.html'));
+    });
+    const port = cfg.port;
+    try {
+        await listenServer(appServer, port);
+    }
+    catch (err) {
+        logError(err.message);
+        process.exit(1);
+    }
+    log(`Noter running at http://localhost:${port}`);
+    if (openBrowser) {
+        const url = `http://localhost:${port}`;
+        log(`Opening browser at ${url}`);
+        const opener = process.platform === 'darwin' ? 'open' : process.platform === 'win32' ? 'start' : 'xdg-open';
+        try {
+            execSync(`${opener} ${url}`);
+        }
+        catch {
+            log(`Could not open browser. Visit ${url} manually.`);
+        }
+    }
+    log('Press Ctrl+C to stop.');
+    // Graceful shutdown handlers
+    const shutdown = async (signal) => {
+        log(`Received ${signal}, shutting down gracefully...`);
+        try {
+            await appServer.close();
+        }
+        catch {
+            // Ignore errors during shutdown
+        }
+        process.exit(0);
+    };
+    process.on('SIGINT', () => shutdown('SIGINT'));
+    process.on('SIGTERM', () => shutdown('SIGTERM'));
+}
+async function main() {
+    const args = process.argv.slice(2);
+    const command = args[0];
+    switch (command) {
+        case 'help':
+        case '--help':
+        case '-h':
+            showHelp();
+            process.exit(0);
+            break;
+        case 'version':
+        case '--version':
+        case '-v':
+            console.log(`noter v${getVersion()}`);
+            process.exit(0);
+            break;
+        case 'build':
+            try {
+                await build();
+            }
+            catch (err) {
+                logError(`Build failed: ${err.message}`);
+                process.exit(1);
+            }
+            break;
+        case 'serve': {
+            const openBrowser = args.includes('--open');
+            try {
+                await serve(openBrowser);
+            }
+            catch (err) {
+                logError(`Server error: ${err.message}`);
+                process.exit(1);
+            }
+            break;
+        }
+        case 'dev':
+            log('Starting development mode...');
+            try {
+                execSync('pnpm run dev', { cwd: ROOT, stdio: 'inherit' });
+            }
+            catch (err) {
+                logError(`Dev server error: ${err.message}`);
+                process.exit(1);
+            }
+            break;
+        case undefined:
+            // Default: repo-aware serve with browser open
+            try {
+                await serve(true);
+            }
+            catch (err) {
+                logError(`Server error: ${err.message}`);
+                process.exit(1);
+            }
+            break;
+        default:
+            // Unknown command — show help and exit 1
+            logError(`Unknown command: ${command}`);
+            console.log();
+            showHelp();
+            process.exit(1);
+            break;
+    }
+}
+main().catch((err) => {
+    logError(`Fatal error: ${err instanceof Error ? err.message : String(err)}`);
+    process.exit(1);
+});
+//# sourceMappingURL=noter.js.map

package/bin/noter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"noter.js","sourceRoot":"","sources":["noter.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "noterai",
+  "version": "0.1.0",
+  "description": "Locally-run, browser-based AI agent dashboard for developers using LLM coding assistants",
+  "type": "module",
+  "license": "MIT",
+  "keywords": [
+    "ai",
+    "agent",
+    "dashboard",
+    "llm",
+    "claude",
+    "codex",
+    "opencode",
+    "developer-tools",
+    "cli"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/oniwakaa/noter.git"
+  },
+  "homepage": "https://github.com/oniwakaa/noter#readme",
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "bin": {
+    "noter": "./bin/noter.js"
+  },
+  "files": [
+    "bin/noter.js",
+    "bin/noter.js.map",
+    "packages/client/dist",
+    "packages/server/dist",
+    "packages/shared/dist",
+    "scripts/postbuild.js"
+  ],
+  "scripts": {
+    "dev:server": "pnpm --filter @noter/server run dev",
+    "dev:client": "pnpm --filter @noter/client run dev",
+    "dev": "concurrently \"pnpm run dev:server\" \"pnpm run dev:client\"",
+    "build:shared": "pnpm --filter @noter/shared run build",
+    "build:server": "pnpm --filter @noter/server run build",
+    "build:client": "pnpm --filter @noter/client run build",
+    "build:bin": "tsc -p bin/tsconfig.json",
+    "postbuild": "node scripts/postbuild.js",
+    "build": "pnpm run build:shared && pnpm run build:server && pnpm run build:client && pnpm run build:bin && pnpm run postbuild",
+    "typecheck": "pnpm --filter @noter/server run typecheck && pnpm --filter @noter/client run typecheck",
+    "test": "vitest run",
+    "prepublishOnly": "pnpm run build && pnpm run typecheck && pnpm run test"
+  },
+  "dependencies": {
+    "@ai-sdk/anthropic": "^3.0.74",
+    "@ai-sdk/google": "^3.0.67",
+    "@ai-sdk/openai": "^3.0.58",
+    "@opencode-ai/sdk": "^1.3.3",
+    "ai": "^6.0.174",
+    "ai-sdk-ollama": "^3.8.3",
+    "better-sqlite3": "^12.3.1",
+    "dotenv": "^17.3.1",
+    "express": "^5.0.1",
+    "ws": "^8.18.0",
+    "zod": "^3.25.76"
+  },
+  "devDependencies": {
+    "@playwright/test": "^1.60.0",
+    "@vitest/coverage-v8": "^4.1.5",
+    "concurrently": "^9.1.2",
+    "typescript": "^5.8.2",
+    "vite": "^6.4.2",
+    "vitest": "^4.1.5"
+  },
+  "packageManager": "pnpm@10.30.3"
+}