mirror of
https://github.com/Ark0N/Codeman.git
synced 2026-09-30 12:39:42 +02:00
docs: correct CLAUDE.md drift and document four undocumented subsystems
Audit of CLAUDE.md against the tree. Verified still accurate: the 31-module frontend load order (matches index.html exactly), SSE registry parity at 157 = 157 (confirmed by running the parity test), config/ 21 files, types/ 22 domain files, 136 mobile device profiles, the version line, and every Quick Reference command. Drift corrected: 24 route modules to 25, ~220 handlers to ~227, system-routes 51 to 56, app.js ~5K lines to ~6.7K and 30 modules to 31, install.sh 92KB to 104KB. Completed the CLI resolver inventory, which was missing deepseek-cli-resolver and omp-cli-resolver even though both modes are documented, and named the shared cli-executable-resolver lookup chain. Filled the gaps found by sweeping every src module against the file: - Owner tab layouts (COD-359) had 6 source modules, 7 test files, 2 routes, an SSE event and a state.json key, with zero mentions anywhere in CLAUDE.md or docs/. The paragraph records the four things a reader would otherwise get wrong: it is backend-only as of 1.24.1 with no frontend consumer, the service is the sole mutation boundary, it projects onto PUT /api/session-order rather than replacing it, and reconciliation is gated on a successful restore. - codeman doctor and codeman users were undocumented top-level CLI commands. - Four subsystems whose invariants lived only in their @fileoverview: the workspace-trust dialog recognizer, proc-tree's bounded walk (the 2026-07-30 incident that took a machine down), deepseek-web-server (one child process, deliberately not a shell session), and the Files panel search matcher (globs are never compiled to a RegExp). Also fixes a stale "156 event types" comment in constants.js (actual: 157) and a contradiction in AGENTS.md, which still carried the retired "never run the full suite inside a managed tmux session" rule against CLAUDE.md's current "npm test is the gate and is safe to run bare". Note: the trust-dialog paragraph documents trustDialogNextKey(), which is part of a sibling session's in-flight fix for the Claude Code 2.1.252 layout change (unnumbered, reversed options with "No, exit" highlighted, so a blind carriage return picks exit and kills the pane). That fix was uncommitted in the shared tree when this landed, so the doc leads the code until it is committed. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01NMN8UuvdBim3iM87reuQ9Z
This commit is contained in:
@@ -2,7 +2,8 @@
|
|||||||
|
|
||||||
Canonical agent/contributor guidance for this repository lives in [CLAUDE.md](CLAUDE.md) —
|
Canonical agent/contributor guidance for this repository lives in [CLAUDE.md](CLAUDE.md) —
|
||||||
project structure, build/test/lint commands, code style, testing safety rules
|
project structure, build/test/lint commands, code style, testing safety rules
|
||||||
(never run the full suite inside a managed tmux session), security notes, and
|
(`npm test` is the CI gate and is safe to run bare; the three excluded suites
|
||||||
|
have their own runners), security notes, and
|
||||||
the deployment workflow are all maintained there. Please read it before making
|
the deployment workflow are all maintained there. Please read it before making
|
||||||
changes, and keep it the single source of truth rather than duplicating
|
changes, and keep it the single source of truth rather than duplicating
|
||||||
sections here.
|
sections here.
|
||||||
|
|||||||
@@ -10,7 +10,7 @@
|
|||||||
* @globals {function} scheduleBackground - scheduler.postTask wrapper (background priority)
|
* @globals {function} scheduleBackground - scheduler.postTask wrapper (background priority)
|
||||||
* @globals {function} getEventCoords - Unified mouse/touch coordinate extractor
|
* @globals {function} getEventCoords - Unified mouse/touch coordinate extractor
|
||||||
* @globals {function} escapeHtml - XSS-safe HTML escaping
|
* @globals {function} escapeHtml - XSS-safe HTML escaping
|
||||||
* @globals {object} SSE_EVENTS - Centralized SSE event type constants (156 event types; must match backend src/web/sse-events.ts)
|
* @globals {object} SSE_EVENTS - Centralized SSE event type constants (157 event types; must match backend src/web/sse-events.ts)
|
||||||
* @globals {Array} BUILTIN_RESPAWN_PRESETS - Built-in respawn configuration presets
|
* @globals {Array} BUILTIN_RESPAWN_PRESETS - Built-in respawn configuration presets
|
||||||
*
|
*
|
||||||
* @dependency None (first in load order)
|
* @dependency None (first in load order)
|
||||||
|
|||||||
Reference in New Issue
Block a user