Skip to content

Commit 6b95aca

Browse files
alanbldclaude
andcommitted
docs: update CLAUDE.md for v0.10.0
- Update version to 0.10.0 - Add Temporal Regimes (RFC-0012) to Key Features - Add MS Project Compatibility section with conversion workflow - Add regime: keyword to Grammar Notes - Reference MS_PROJECT_COMPARISON.md Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
1 parent cd4f152 commit 6b95aca

File tree

1 file changed

+30
-2
lines changed

1 file changed

+30
-2
lines changed

CLAUDE.md

Lines changed: 30 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ This project follows **Semantic Versioning** (SemVer):
2121

2222
Version is set in `Cargo.toml` under `[workspace.package]`:
2323
```toml
24-
version = "0.9.1"
24+
version = "0.10.0"
2525
```
2626

2727
All crates inherit this version via `version.workspace = true`.
@@ -57,7 +57,8 @@ crates/
5757
5858
playground/ # Browser-based playground (Monaco editor, WASM)
5959
syntax/ # Editor syntax highlighting (TextMate, Vim)
60-
tools/mpp_to_proj/ # MS Project companion tool (Python, 99% coverage)
60+
tools/mpp_to_proj/ # MS Project companion tool (Python, handles Manually Scheduled tasks)
61+
docs/ # Documentation (MS_PROJECT_COMPARISON.md, EDITOR_SETUP.md, RFCs)
6162
.github/workflows/ # Release workflow (cross-platform binaries)
6263
```
6364

@@ -74,6 +75,7 @@ tools/mpp_to_proj/ # MS Project companion tool (Python, 99% coverage)
7475
- **Effort-driven scheduling**: PMI-compliant Duration = Effort / Resource_Units
7576
- **Resource leveling**: RFC-0003 deterministic leveling with full audit trail (L001-L004 diagnostics)
7677
- **Progress-aware scheduling**: RFC-0008 status date resolution, remaining duration calculation, P005/P006 diagnostics
78+
- **Temporal regimes**: RFC-0012 work/event/deadline modes for calendar interaction (`regime: event` allows weekend scheduling)
7779
- **Calendar diagnostics**: C001-C023 codes for working days vs calendar days analysis
7880
- **BDD conflict analysis**: Binary Decision Diagram-based conflict detection (experimental)
7981
- **Focus view**: RFC-0006 pattern-based filtering for large Gantt charts (`--focus`, `--context-depth`)
@@ -165,6 +167,24 @@ All renderers support: `--focus="pattern"`, `--context-depth=N`, `-V` (verbose),
165167
- `crates/utf8proj-render/src/gantt.rs` - Interactive HTML Gantt chart renderer
166168
- `crates/utf8proj-render/src/excel.rs` - Excel costing report with dependencies
167169
- `docs/SCHEDULING_ANALYSIS.md` - PMI/PERT/CPM compliance analysis
170+
- `docs/MS_PROJECT_COMPARISON.md` - Feature comparison with MS Project
171+
172+
## MS Project Compatibility
173+
174+
The `tools/mpp_to_proj/` companion tool converts MS Project files (.mpp) to utf8proj format:
175+
176+
```bash
177+
python3 tools/mpp_to_proj/mpp_to_proj.py project.mpp project.proj
178+
utf8proj fix container-deps project.proj -o project_fixed.proj # Optional: inherit container deps
179+
utf8proj schedule project_fixed.proj
180+
```
181+
182+
**Validated conversions** produce identical schedules to MS Project. Key handling:
183+
- Manually Scheduled tasks → `must_start_on:` constraints
184+
- All dependency types (FS, SS, FF, SF) with lag
185+
- Container dependency inheritance via `fix container-deps`
186+
187+
See `docs/MS_PROJECT_COMPARISON.md` for full feature comparison.
168188

169189
## Example Projects
170190

@@ -271,6 +291,7 @@ task impl_api "Implement Backend API" { # Quoted string = display name
271291
- `milestone: true` or dedicated `milestone id "name" { }` syntax
272292
- `complete: 75%` (progress tracking)
273293
- `remaining: 5d` (explicit remaining duration, overrides calculated)
294+
- `regime: work | event | deadline` (temporal regime for calendar interaction)
274295

275296
**Dependency syntax:**
276297
- `depends: a` (FS - Finish-to-Start, default)
@@ -284,6 +305,13 @@ task impl_api "Implement Backend API" { # Quoted string = display name
284305
- Single date: `holiday "Easter" 2026-04-06`
285306
- Date range: `holiday "Christmas" 2025-12-25..2025-12-26`
286307

308+
**Temporal Regimes (RFC-0012):**
309+
```proj
310+
task work_task "Work Task" { regime: work } # Default: respects working days
311+
milestone release "Release" { regime: event } # Can occur on weekends/holidays
312+
milestone deadline "Deadline" { regime: deadline } # Exact date required
313+
```
314+
287315
**Constraints (declarative blocks):**
288316
```proj
289317
constraint hard_deadline {

0 commit comments

Comments
 (0)