# Task Plan: Repository Audit and Readiness Fixes

## Goal
Read the X_SSL_Net repository, summarize its current state, and apply agreed readiness fixes for dependency tracking, data package tracking, smoke verification, and model shape testing.

## Current Phase
Phase 5

## Phases

### Phase 1: Inventory
- [x] Capture file layout, git state, and local instructions
- [ ] Read top-level docs and core configuration
- **Status:** in_progress

### Phase 2: Architecture Review
- [ ] Read training entrypoint, trainer, model, losses, metrics, and scripts
- [ ] Identify dataset assumptions and experiment flow
- **Status:** pending

### Phase 3: Verification
- [ ] Check dependency/import health where feasible
- [ ] Inspect tests or absence of tests
- **Status:** pending

### Phase 4: Delivery
- [x] Summarize project status in Chinese
- [x] List risks and recommended first work items
- **Status:** complete

### Phase 5: Readiness Fixes
- [x] Fix ignore rules so `lib/data/` can be tracked while `/data/` stays ignored
- [x] Add root dependency manifest
- [x] Add XNet2d forward shape test
- [x] Run syntax checks, model test, split check, and smoke training
- **Status:** complete

## Key Questions
1. What is the project intended to train/evaluate?
2. What are the main code paths and config contracts?
3. What is currently modified or incomplete?
4. What blocks immediate development or execution?

## Decisions Made
| Decision | Rationale |
|----------|-----------|
| Keep audit planning files in repo root | Required by planning-with-files skill for multi-step work |
| Do not implement SSL Trainer now | User explicitly requested items 1-4 only and said item 5 is not needed |

## Errors Encountered
| Error | Attempt | Resolution |
|-------|---------|------------|
| CPU XNet2d forward with VMamba global branches fails in `cross_scan_fn` with `Expected a cuda device, but got: cpu` | Ran model shape test and CPU smoke training | Kept CPU test coverage by disabling global branches inside the test; ran full-model smoke on CUDA |