xsxx03-art
94 lines
3.5 KiB
Markdown
94 lines
3.5 KiB
Markdown
# PDK Root Technology Migration Implementation Plan
|
|
|
|
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
|
|
|
|
**Goal:** Make `opt_pdk_public/foundries` and `opt_pdk_atlas/foundries` the single source of truth for both component PDK assets and `technology.yml` manifests, then remove the redundant `mxpic/` folder from `mxpic_EDA`.
|
|
|
|
**Architecture:** The backend resolves a role-scoped PDK root from the current Flask session. Technology listing, manifest reads, project-scoped library browsing, SVG preview, and GDS export all use that same root. A directory directly under `<role_pdk_root>/<foundry>` is treated as a technology only when it contains `technology.yml`.
|
|
|
|
**Tech Stack:** Flask backend, local YAML manifests, PowerShell/Node static tests, `mxpic_router`/Nazca build path.
|
|
|
|
---
|
|
|
|
### Task 1: Regression Tests for New PDK Source of Truth
|
|
|
|
**Files:**
|
|
- Modify: `tests/layout-backend-static.test.js`
|
|
|
|
- [ ] **Step 1: Write the failing test**
|
|
|
|
Add assertions that `backend/server.py` no longer defines `EDA_PDK_ROOT`/`YML_PATH`, does not reference `mxpic/PDKs`, lists technologies from `current_pdk_root()`, checks for `technology.yml`, and reads manifests from the active role PDK root.
|
|
|
|
- [ ] **Step 2: Run test to verify it fails**
|
|
|
|
Run: `node tests/layout-backend-static.test.js`
|
|
|
|
Expected before implementation: FAIL because the backend still scans `EDA_PDK_ROOT`.
|
|
|
|
### Task 2: Backend Migration
|
|
|
|
**Files:**
|
|
- Modify: `backend/server.py`
|
|
|
|
- [ ] **Step 1: Update root helpers**
|
|
|
|
Remove `PDK_PUBLIC_ROOT`, `EDA_PDK_ROOT`, and `YML_PATH` from active path configuration. Add a helper that safely builds `<current_pdk_root>/<foundry>/<technology>/technology.yml`.
|
|
|
|
- [ ] **Step 2: Update technology APIs**
|
|
|
|
Change `/api/technologies` and `/api/technologies/<foundry>/<technology>/manifest` to use `current_pdk_root()`. Only return technology folders containing `technology.yml`.
|
|
|
|
- [ ] **Step 3: Update build-time manifest lookup**
|
|
|
|
Change `technology_manifest_path_for_project(project)` to read the project `foundry/technology` ID and return the manifest path under the active role PDK root.
|
|
|
|
### Task 3: Documentation and Static Contract Updates
|
|
|
|
**Files:**
|
|
- Modify: `README.md`
|
|
- Modify: `INTRANET_DEPLOYMENT.md`
|
|
- Modify: `PDK_TECHNOLOGY_XSECTION_LOADING.md`
|
|
- Modify: `GDS_SVG_GENERATION_LOGIC.md`
|
|
- Modify: `tests/layout-backend-static.test.js`
|
|
|
|
- [ ] **Step 1: Update docs**
|
|
|
|
Replace old `mxpic/PDKs` source-of-truth language with role PDK root language.
|
|
|
|
- [ ] **Step 2: Keep tests aligned**
|
|
|
|
Remove assertions that require `mxpic/PDKs/Silterra/.../technology.yml` to exist inside `mxpic_EDA`.
|
|
|
|
### Task 4: Remove Redundant EDA PDK Folder
|
|
|
|
**Files:**
|
|
- Delete: `mxpic/`
|
|
|
|
- [ ] **Step 1: Verify target path**
|
|
|
|
Run: `Resolve-Path mxpic` and confirm it resolves inside `D:\mxpic\mxpic_EDA`.
|
|
|
|
- [ ] **Step 2: Delete folder**
|
|
|
|
Run: `Remove-Item -LiteralPath D:\mxpic\mxpic_EDA\mxpic -Recurse -Force`.
|
|
|
|
### Task 5: Verification
|
|
|
|
**Files:**
|
|
- Test: `tests/*.test.js`
|
|
|
|
- [ ] **Step 1: Run focused tests**
|
|
|
|
Run: `node tests/layout-backend-static.test.js`
|
|
|
|
- [ ] **Step 2: Run full static suite**
|
|
|
|
Run each `tests/*.test.js` file with Node.
|
|
|
|
- [ ] **Step 3: Check old references**
|
|
|
|
Run: `rg -n "EDA_PDK_ROOT|YML_PATH|mxpic/PDKs|mxpic\\\\PDKs" backend frontend tests README.md INTRANET_DEPLOYMENT.md GDS_SVG_GENERATION_LOGIC.md PDK_TECHNOLOGY_XSECTION_LOADING.md`
|
|
|
|
Expected: no active-code references to the deleted internal PDK root.
|
|
|