claude_version 1.4.1

Claude Code version manager: install, upgrade, and session lifecycle
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

# docs/

### Scope

**Responsibilities:** Documentation for the `claude_version` crate covering behavioral requirements, design patterns, and algorithms.
**In Scope:** CLI reference (`cli/`), feature requirements (`feature/`), version lock design (`pattern/`), settings inference algorithm (`algorithm/`), design rationale, and doc cross-reference graph.
**Out of Scope:** Source code (→ `src/`), automated tests (→ `tests/`), build scripts (→ `verb/`).

### Responsibility Table

| File | Responsibility |
|------|----------------|
| `algorithm/` | Settings type inference and config resolution algorithms |
| `cli/` | CLI reference: commands, flags, types, parameter groups, user stories, formats |
| `feature/` | Version management, process lifecycle, settings, dry-run, CLI design, config command |
| `pattern/` | 5-layer version lock design pattern |
| `pitfall/` | Confirmed design traps: chmod side effects, symlink retarget bypass |
| `doc_graph.yml` | Cross-reference graph for all doc instances |
| `entity.md` | Master index of doc entity types and instances |

### Exception Records

- **`entity.md` (flat file, not entity directory):** Stored as `docs/entity.md` rather than `docs/entity/readme.md`. The standard Entity Infrastructure Pair (`readme.md` + `procedure.md`) applies to directories that hold operable instances. `entity.md` is a cross-entity index — its content spans all entity types and does not belong inside any single entity directory. A flat file at `docs/entity.md` is intentional; no `entity/` directory is warranted.