X_SSL_Net/docs/task_plan.md

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

• 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

• Summarize project status in Chinese
• List risks and recommended first work items
• Status: complete

Phase 5: Readiness Fixes

• Fix ignore rules so lib/data/ can be tracked while /data/ stays ignored
• Add root dependency manifest
• Add XNet2d forward shape test
• 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