MVP: establish cross-platform Computer Doctor CLI architecture with controlled E2E repair loop

.gitignore

@@ -14,6 +14,8 @@ pids
 *.pid
 *.seed
 *.pid.lock
+*.sqlite
+reports/
 
 # Directory for instrumented libs generated by jscoverage/JSCover
 lib-cov
@@ -127,6 +129,7 @@ dist
 
 # pnpm
 .pnpm-store
+package-lock.json
 
 # yarn v3
 .pnp.*

README.md

@@ -1,2 +1,39 @@
 # Computer-Doctor-CLI
-AI command line toolkit for Computer Repairing
+
+AI command line toolkit for Computer Repairing.
+
+## MVP Framework
+
+This repository now includes a TypeScript 6 + PNPM 11 oriented CLI framework with:
+
+- `commander-jsx` command tree (JSX-defined CLI)
+- React/JSX terminal rendering via `ink`
+- Unified internal command execution via `zx`
+- Vercel AI SDK planning skeleton (with controlled action allowlist)
+- TypeORM + SQLite local persistence
+- Core abstractions for platform / diagnostic / planning / action / session / report
+- Platform adapter layout for Windows (first adapter), Linux, and macOS
+- End-to-end MVP flow: session -> diagnostic -> plan -> action -> sqlite -> markdown reports
+
+## Usage
+
+```shell
+cp computer-doctor ~/Desktop
+cd ~/Desktop
+computer-doctor -h
+```
+
+## Development
+
+```bash
+pnpm install
+pnpm debug --verbose
+```
+
+## Generated artifacts
+
+- `computer-doctor.sqlite`
+- `reports/<session-id>/diagnostic.md`
+- `reports/<session-id>/plan.md`
+- `reports/<session-id>/repair.md`
+- `reports/<session-id>/rollback.md`

package.json

@@ -0,0 +1,35 @@
+{
+  "name": "computer-doctor-cli",
+  "version": "0.1.0",
+  "description": "Cross-platform CLI framework for computer repair technicians",
+  "type": "module",
+  "packageManager": "pnpm@11.0.0",
+  "bin": {
+    "computer-doctor": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsx src/index.tsx",
+    "start": "node dist/index.js",
+    "test": "tsx --test test/*.test.ts",
+    "debug": "tsx src/index.tsx mvp",
+    "pack-exe": "pnpm pack-app"
+  },
+  "dependencies": {
+    "@ai-sdk/google": "^2.0.25",
+    "ai": "^6.0.184",
+    "better-sqlite3": "^12.4.1",
+    "commander-jsx": "^0.7.3",
+    "ink": "^6.8.0",
+    "react": "^19",
+    "reflect-metadata": "0.2.2",
+    "typeorm": "^0.3.29",
+    "zx": "^8.8.5"
+  },
+  "devDependencies": {
+    "@types/node": "^24.10.1",
+    "@types/react": "^19",
+    "tsx": "^4.20.6",
+    "typescript": "^6.0.3"
+  }
+}