# Docdex Single Daemon Task List
This task list translates `docs/single_daemon.md` into implementable work items.
## Phase 1: Singleton Daemon + Lock
- Add `docdexd daemon` command (multi-repo service).
- Files: `src/cli/mod.rs`, `src/cli/commands/serve.rs`, new `src/daemon/multi_repo.rs`.
- Acceptance: `docdexd daemon` starts and stays resident.
- Implement lockfile with OS locking at `~/.docdex/daemon.lock`.
- Files: `src/daemon/lock.rs`, `src/daemon.rs`.
- Acceptance: second daemon exits with clear error; stale lock is detected and replaced.
- Add `ensure_daemon()` to CLI entrypoints.
- Files: `src/cli/mod.rs`, `src/cli/commands/*`.
- Acceptance: CLI auto-spawns daemon if `/healthz` unreachable.
- Detached spawn per OS (no window flash on Windows).
- Files: `src/cli/daemon_spawn.rs`.
- Acceptance: background spawn works on macOS/Linux/Windows.
## Phase 2: Context-Aware Multi-Repo Mounting
- Add `POST /v1/initialize` endpoint for HTTP/SSE clients.
- Files: `src/api/v1/initialize.rs`, `src/search/mod.rs`, `docs/http_api.md`, `openapi/mcoda.yaml`.
- Acceptance: returns `{repo_id, status}` for known/unknown repos.
- Add MCP initialize handling for `rootUri`.
- Files: `crates/mcp-server/src/lib.rs`.
- Acceptance: MCP initialize mounts repo and returns repo metadata.
- Implement RepoManager map: `repo_id -> RepoHandle`.
- Files: `src/daemon/multi_repo.rs`, `src/index/mod.rs`.
- Acceptance: multiple repos can be mounted concurrently.
- Async background index crawl on new repo or stale index.
- Files: `src/index/mod.rs`, `src/daemon/multi_repo.rs`.
- Acceptance: new repo returns `status: indexing` and finishes in background.
## Phase 3: Dynamic Lifecycle + Re-indexing
- Add `.docdexignore` parser and optional `.gitignore` honoring.
- Files: `src/index/ignore.rs`, `src/index/mod.rs`, docs update.
- Acceptance: ignored paths are excluded from index and watcher updates.
- LRU watcher lifecycle with idle/hibernate timers.
- Files: `src/daemon/multi_repo.rs`, `src/watcher.rs`.
- Acceptance: repo watcher stops after 24h idle and reloads on demand.
- Persist last_accessed + lifecycle state.
- Files: `src/state_layout.rs`, `src/daemon/multi_repo.rs`.
- Acceptance: daemon restart preserves idle/active state.
## Phase 4: Shared MCP Transport + Stdio Proxy
- Add MCP Unix socket listener.
- Files: `crates/mcp-server/src/server.rs`, config + CLI flags.
- Acceptance: multiple clients can connect to socket concurrently.
- Add HTTP/SSE MCP endpoint (optional transport).
- Files: `crates/mcp-server/src/server.rs`, docs.
- Acceptance: MCP requests over HTTP/SSE accepted.
- Add stdio proxy that forwards to socket.
- Files: `crates/mcp-server/src/proxy.rs`, CLI entrypoint.
- Acceptance: Codex can use proxy while only one MCP server runs.
## Phase 5: Auto-Config + Startup
- Implement idempotent config injector for all listed clients.
- Files: `npm/lib/install.js`, new `npm/lib/install_configs.js`.
- Acceptance: running npm install twice does not duplicate entries.
- Automatic port selection and injection.
- Files: `npm/lib/install_configs.js`, `npm/lib/install.js`, daemon config.
- Acceptance: installer detects port conflicts, chooses free port, injects correct URL.
- Add startup integration:
- macOS LaunchAgent, Linux systemd user, Windows Task Scheduler.
- Files: `npm/lib/startup/*.js`, docs.
- Acceptance: daemon auto-starts after reboot on each OS.
- First-run message on startup registration failure.
- Files: `npm/lib/startup/*.js`, `npm/lib/install.js`.
- Acceptance: message emitted only when OS startup integration fails.
- Document all changes in README + release notes.
- Files: `README.md`, `docs/CHANGELOG.md`, `docs/http_api.md`.
- Acceptance: docs reference new daemon/initialize/SSE/MCP setup.
## Tests
- Add unit tests for lockfile behavior.
- Add integration tests for `/v1/initialize`.
- Add MCP socket/stdio proxy tests.
- Add installer config injection tests.
- Add tests for automatic port selection + config injection.
- Add tests for startup failure message gating.
- Update `docs/test_artifacts.md` with new tests.
