# Roadmap: FanucProgramManager

## Overview

Console tool for CNC program transfer and file management. Fanuc FOCAS base, expanding to multi-CN (Heidenhain LSV2, Siemens FTP, Mitsubishi FTP) with NC program validation.

## Current Milestone

**v0.1 Multi-CN Release** (v0.1.0)
Status: ✅ Complete
Phases: 5 of 5 complete
Completed: 2026-05-13

## Phases

| Phase | Name | Plans | Status | Completed |
|-------|------|-------|--------|-----------|
| 1 | cnc-abstraction | 1 | ✅ Complete | 2026-05-13 |
| 2 | heidenhain | 1 | ✅ Complete | 2026-05-13 |
| 3 | siemens | 1 | ✅ Complete | 2026-05-13 |
| 4 | program-wiring | 1 | ✅ Complete | 2026-05-13 |
| 5 | nc-validator | 1 | ✅ Complete | 2026-05-13 |

## Phase Details

### Phase 1: cnc-abstraction ✅

**Goal:** Fix namespace, add all Cnc/ files to csproj, complete ICncMachine + IFanucMachine with 3-file support
**Completed:** 2026-05-13

**Delivered:**
- Namespace `Fanuc_integration.Cnc.*` → `FanucProgramManager.Cnc.*` (29 files)
- `IFocasDialect` extended: `UploadStart`/`DownloadStart` accept `short fileType`
- `IFanucMachine` interface: extends `ICncMachine` with tool offset + work zero R/W
- `CncManufacturer` enum: Fanuc, Heidenhain, Siemens
- All 29 `Cnc/**/*.cs` files added to csproj

### Phase 2: heidenhain ✅

**Goal:** Implement ICncMachine for Heidenhain TNC via LSV2 protocol
**Completed:** 2026-05-13

**Delivered:**
- `HeidenhainConnectionConfig` — IP, port 19000, credentials, timeout
- `Lsv2Client` — TCP framing, CRC-16/CCITT, login (SELECT+LOG_IN), ReceiveFile/SendFile
- `HeidenhainMachine : ICncMachine` — RunGuardedAsync pattern, state machine

### Phase 3: siemens ✅

**Goal:** Implement ICncMachine for Siemens Sinumerik via FTP
**Completed:** 2026-05-13

**Delivered:**
- `SiemensConnectionConfig` — IP, port 21, creds, program dir `/_N_MPF_DIR/`
- `SiemensFtpClient` — FtpWebRequest wrapper, ASCII mode, passive
- `SiemensMachine : ICncMachine`

**Bonus (post-apply):**
- `MitsubishiConnectionConfig` / `MitsubishiFtpClient` / `MitsubishiMachine : ICncMachine`
- `CncManufacturer.Mitsubishi` added to enum + factory + CLI

### Phase 4: program-wiring ✅

**Goal:** Wire all manufacturers into Program.cs + InputArgs
**Completed:** 2026-05-13

**Delivered:**
- `CncMachineFactory` — creates right `ICncMachine` from `InputArgs`
- `InputArgs` — added `manufacturer`, `username`, `password` fields
- `Program.cs` — full rewrite using `ICncMachine` factory; Fanuc 3-file via `IFanucMachine` cast

### Phase 5: nc-validator ✅

**Goal:** Per-manufacturer NC program validator runs inside WriteProgramAsync before upload
**Completed:** 2026-05-13

**Delivered:**
- `ValidationSeverity` / `ValidationError` / `ValidationResult` model types
- `INcProgramValidator` + `NcProgramValidator` with universal + per-manufacturer rules
- Validator injected into all 4 machine classes
- `NcProgramValidatorTests` — 30+ NUnit tests

---

## Next Milestone

**v0.2 NcProgramManager** ✅ Complete
Status: Complete
Phases: 4 of 4 complete
Completed: 2026-05-17

| Phase | Name | Plans | Status | Completed |
|-------|------|-------|--------|-----------|
| 06 | rename-cleanup | 1 | ✅ Complete | 2026-05-17 |
| 07 | license-core | 1 | ✅ Complete | 2026-05-17 |
| 08 | license-integration | 1 | ✅ Complete | 2026-05-17 |
| 09 | license-generator | 1 | ✅ Complete | 2026-05-17 |

### Phase 06: rename-cleanup ✅
**Goal:** Rename FanucProgramManager → NcProgramManager (namespace, project files, test folder). Delete dead FANUCMachine.cs.
**Completed:** 2026-05-17
**Plans:** [x] 06-01: Namespace + file rename

### Phase 07: license-core ✅
**Goal:** `IMachineFingerprint`, `ILicenseValidator`, RSA signature verification, `.lic` file model
**Completed:** 2026-05-17
**Plans:** [x] 07-01: RSA core + interfaces + 6 unit tests

### Phase 08: license-integration ✅
**Goal:** Wire license system into Program.cs, delete `checkLicense`, remove `-chiave=`, hardcode `license.lic` next to EXE
**Completed:** 2026-05-17
**Plans:** [x] 08-01: Program.cs wiring

### Phase 09: license-generator ✅
**Goal:** Separate generator console app — reads machine fingerprint, signs, writes `.lic` file
**Completed:** 2026-05-17
**Plans:** [x] 09-01: LicenseGenerator standalone tool + real public key embedded

---

## Standalone Phases (post-v0.2)

| Phase | Name | Plans | Status |
|-------|------|-------|--------|
| 10 | readme-docs | 1 | ✅ Complete | 2026-05-17 |

### Phase 10: readme-docs ✅
**Goal:** Write Italian README for NcProgramManager and LicenseGenerator repos — describe what each does, prerequisites, setup, CLI usage, license workflow.
**Depends on:** Phase 09 (license workflow complete)
**Plans:** [x] 10-01: Italian READMEs for both repos

---
*Roadmap updated: 2026-05-17 — Phase 10 readme-docs complete. Project fully documented.*