@tyyyho/treg 0.1.26 → 1.0.1

package/README.md

@@ -7,16 +7,13 @@ downloads](https://img.shields.io/npm/dm/%40tyyyho%2Ftreg)](https://www.npmjs.co
 [![License](https://img.shields.io/npm/l/%40tyyyho%2Ftreg)](https://www.npmjs.com/package/%40tyyyho%2Ftreg)
 ![TypeScript](https://img.shields.io/badge/TypeScript-5.x-3178C6?logo=typescript&logoColor=white)
 
-[繁體中文 README](./README.zh-hant.md)
-
 ## Overview
 
-**treg** is a CLI tool that injects an **engineering
-"immune system"** into your project.
+**Treg** is a CLI tool that injects an **engineering immune system** into your project.
 
 When humans and AI collaborate and iterate rapidly, repositories often
 accumulate inconsistent tooling, style drift, and fragile workflows.\
-`treg` helps maintain balance by establishing a clean and consistent
+`Treg` helps maintain balance by establishing a clean and consistent
 development baseline.
 
 It focuses only on **infrastructure setup**, not application logic.
@@ -25,7 +22,7 @@ It focuses only on **infrastructure setup**, not application logic.
 
 ## Features
 
-`treg` can configure:
+`Treg` can configure:
 
 - **TypeScript**
 - **ESLint**
@@ -108,7 +105,7 @@ Default formatter:
 
 ## AI Skills
 
-`treg` can update AI guidance files for development tools.
+`Treg` can update AI guidance files for development tools.
 
 Tool File
 
@@ -128,7 +125,7 @@ Behavior:
 
 ## Philosophy
 
-`treg` is intentionally minimal.
+`Treg` is intentionally minimal.
 
 It does not generate application architecture.\
 It focuses only on establishing the engineering infrastructure that

package/README.npm.md

@@ -7,16 +7,13 @@ downloads](https://img.shields.io/npm/dm/%40tyyyho%2Ftreg)](https://www.npmjs.co
 [![License](https://img.shields.io/npm/l/%40tyyyho%2Ftreg)](https://www.npmjs.com/package/%40tyyyho%2Ftreg)
 ![TypeScript](https://img.shields.io/badge/TypeScript-5.x-3178C6?logo=typescript&logoColor=white)
 
-[繁體中文 README](./README.zh-hant.md)
-
 ## Overview
 
-**treg** is a CLI tool that injects an **engineering
-"immune system"** into your project.
+**Treg** is a CLI tool that injects an **engineering immune system** into your project.
 
 When humans and AI collaborate and iterate rapidly, repositories often
 accumulate inconsistent tooling, style drift, and fragile workflows.\
-`treg` helps maintain balance by establishing a clean and consistent
+`Treg` helps maintain balance by establishing a clean and consistent
 development baseline.
 
 It focuses only on **infrastructure setup**, not application logic.
@@ -25,7 +22,7 @@ It focuses only on **infrastructure setup**, not application logic.
 
 ## Features
 
-`treg` can configure:
+`Treg` can configure:
 
 - **TypeScript**
 - **ESLint**
@@ -108,7 +105,7 @@ Default formatter:
 
 ## AI Skills
 
-`treg` can update AI guidance files for development tools.
+`Treg` can update AI guidance files for development tools.
 
 Tool File
 
@@ -128,7 +125,7 @@ Behavior:
 
 ## Philosophy
 
-`treg` is intentionally minimal.
+`Treg` is intentionally minimal.
 
 It does not generate application architecture.\
 It focuses only on establishing the engineering infrastructure that

package/README.zh-hant.md

@@ -1,6 +1,6 @@
 <div align="center">
 
-<img src="https://capsule-render.vercel.app/api?type=waving&color=0:0F172A,30:1D4ED8,70:7C3AED,100:22C55E&height=260&section=header&text=treg&fontSize=72&fontColor=ffffff&animation=fadeIn&fontAlignY=38&desc=Inject%20an%20immune%20system%20into%20your%20codebase&descSize=20&descAlignY=58" width="100%" />
+<img src="https://capsule-render.vercel.app/api?type=waving&color=0:0F172A,30:1D4ED8,70:7C3AED,100:22C55E&height=260&section=header&text=Treg&fontSize=72&fontColor=ffffff&animation=fadeIn&fontAlignY=38&desc=Inject%20an%20immune%20system%20into%20your%20codebase&descSize=20&descAlignY=58" width="100%" />
 
 # @tyyyho/treg（繁體中文）
 
@@ -18,19 +18,19 @@
 
 ## 概覽
 
-**treg**
+**Treg**
 
 它是一個為專案注入「免疫系統」的 CLI 工具。  
 當開發者與 AI 高速協作時，程式碼庫很容易出現規範不一致、規則重複、流程脆弱等問題。  
-`treg` 的角色就像調節型 T 細胞：協助恢復平衡、抑制可避免的混亂，讓專案維持 **乾淨、可維護、可擴展**。
+`Treg` 的角色就像調節型 T 細胞：協助恢復平衡、抑制可避免的混亂，讓專案維持 **乾淨、可維護、可擴展**。
 
-`treg` 不產生產品商業邏輯，而是專注於建立可長期保持穩定的工程基線。
+`Treg` 不產生產品商業邏輯，而是專注於建立可長期保持穩定的工程基線。
 
 > **先規範開發流程，才不會被流程反過來牽制。**
 
 ---
 
-## 為什麼需要 treg
+## 為什麼需要 Treg
 
 在 AI 輔助開發時代，專案速度可以很快。  
 但速度若缺少約束，通常會留下看不見的技術債：
@@ -41,13 +41,13 @@
 - 測試覆蓋缺漏
 - AI 使用規則不清
 
-`treg` 透過一次初始化流程，把一致的工程基線套用到既有 repository。
+`Treg` 透過一次初始化流程，把一致的工程基線套用到既有 repository。
 
 ---
 
-## treg 會建立什麼
+## Treg 會建立什麼
 
-`treg` 可配置：
+`Treg` 可配置：
 
 - **TypeScript**
 - **Linting**（ESLint）
@@ -94,7 +94,7 @@ npx @tyyyho/treg add --features lint,format
 
 ## init 互動流程
 
-執行 `init` 時，`treg` 會依序詢問：
+執行 `init` 時，`Treg` 會依序詢問：
 
 1. **Package manager**  
    `pnpm | npm | yarn | bun`
@@ -205,7 +205,7 @@ nuxt -> next -> react -> vue -> svelte -> node
 
 ## AI Skills 行為
 
-`treg` 可更新所選 AI 工具的說明文件：
+`Treg` 可更新所選 AI 工具的說明文件：
 
 | Tool   | File        |
 | ------ | ----------- |
@@ -224,7 +224,7 @@ nuxt -> next -> react -> vue -> svelte -> node
 
 ## 核心理念
 
-`treg` 的設計刻意保持單一職責。
+`Treg` 的設計刻意保持單一職責。
 
 它 **不** 是完整專案產生器。  
 它 **不** 取代團隊判斷。  

package/dist/init-project/mrm-rules/ai-skills.js

@@ -1,7 +1,7 @@
 import { existsSync } from "node:fs";
 import { promises as fs } from "node:fs";
 import path from "node:path";
-const SKILL_SECTION_HEADING = "## treg AI Skills";
+const SKILL_SECTION_HEADING = "## Treg AI Skills";
 const SKILLS_BASE_DIR = "skills";
 const AI_TOOL_DOCS = {
     claude: "CLAUDE.md",
@@ -10,7 +10,7 @@ const AI_TOOL_DOCS = {
 };
 const FEATURE_SKILLS = {
     format: {
-        name: "treg/format",
+        name: "Treg/format",
         description: "Run and verify formatting rules.",
         when: "Before committing or after broad edits, normalize formatting across the codebase.",
         checklist: [
@@ -20,7 +20,7 @@ const FEATURE_SKILLS = {
         ],
     },
     husky: {
-        name: "treg/husky",
+        name: "Treg/husky",
         description: "Verify and maintain git hook automation.",
         when: "When pre-commit and pre-push checks must stay enforced and consistent.",
         checklist: [
@@ -30,7 +30,7 @@ const FEATURE_SKILLS = {
         ],
     },
     lint: {
-        name: "treg/lint",
+        name: "Treg/lint",
         description: "Run and validate lint rules.",
         when: "After adding rules or changing tooling, verify lint consistency.",
         checklist: [
@@ -40,7 +40,7 @@ const FEATURE_SKILLS = {
         ],
     },
     test: {
-        name: "treg/test",
+        name: "Treg/test",
         description: "Validate test runner setup and execution.",
         when: "When test rules are added or test configuration changes.",
         checklist: [
@@ -50,7 +50,7 @@ const FEATURE_SKILLS = {
         ],
     },
     typescript: {
-        name: "treg/typescript",
+        name: "Treg/typescript",
         description: "Validate TypeScript strictness and config.",
         when: "When tsconfig or strict typing rules are changed.",
         checklist: [

package/dist/init-project/package-manager.js

@@ -1,5 +1,6 @@
 import { execSync } from "node:child_process";
 import { existsSync } from "node:fs";
+import { readFileSync } from "node:fs";
 import path from "node:path";
 export function detectPackageManager(projectDir) {
     if (existsSync(path.join(projectDir, "pnpm-lock.yaml"))) {
@@ -63,8 +64,62 @@ export function installPackages(pm, projectDir, packages, isDev, dryRun = false)
         command = `yarn add ${isDev ? "-D " : ""}${list}`;
     }
     else {
-        command = `npm install ${isDev ? "-D " : ""}${list}`;
+        const useLegacyPeerDeps = shouldUseNpmLegacyPeerDeps(projectDir);
+        if (useLegacyPeerDeps) {
+            console.log(`${dryRun ? "[dry-run] " : ""}Detected react-scripts with TypeScript >= 5; using --legacy-peer-deps for npm compatibility`);
+        }
+        command = `npm install ${isDev ? "-D " : ""}${list}${useLegacyPeerDeps ? " --legacy-peer-deps" : ""}`;
     }
     console.log(`${dryRun ? "[dry-run] " : ""}Installing ${isDev ? "dev " : ""}dependencies: ${packages.join(", ")}`);
     runCommand(command, projectDir, dryRun);
 }
+function shouldUseNpmLegacyPeerDeps(projectDir) {
+    const packageJson = readPackageJson(projectDir);
+    if (!packageJson)
+        return false;
+    const reactScriptsVersion = getDeclaredVersion(packageJson, "react-scripts");
+    if (!reactScriptsVersion)
+        return false;
+    const typescriptVersion = getDeclaredVersion(packageJson, "typescript");
+    if (!typescriptVersion)
+        return false;
+    const major = extractMajorVersion(typescriptVersion);
+    return major !== null && major >= 5;
+}
+function readPackageJson(projectDir) {
+    const packageJsonPath = path.join(projectDir, "package.json");
+    if (!existsSync(packageJsonPath))
+        return null;
+    try {
+        return JSON.parse(readFileSync(packageJsonPath, "utf8"));
+    }
+    catch {
+        return null;
+    }
+}
+function getDeclaredVersion(packageJson, packageName) {
+    const fromDependencies = packageJson.dependencies?.[packageName];
+    if (fromDependencies)
+        return fromDependencies;
+    const fromDevDependencies = packageJson.devDependencies?.[packageName];
+    if (fromDevDependencies)
+        return fromDevDependencies;
+    const fromPeerDependencies = packageJson.peerDependencies?.[packageName];
+    if (fromPeerDependencies)
+        return fromPeerDependencies;
+    const fromOptionalDependencies = packageJson.optionalDependencies?.[packageName];
+    if (fromOptionalDependencies)
+        return fromOptionalDependencies;
+    return null;
+}
+function extractMajorVersion(rawVersion) {
+    const match = rawVersion.match(/\d+/);
+    if (!match)
+        return null;
+    const major = Number.parseInt(match[0], 10);
+    return Number.isNaN(major) ? null : major;
+}
+export const __testables__ = {
+    shouldUseNpmLegacyPeerDeps,
+    extractMajorVersion,
+};

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@tyyyho/treg",
-  "version": "0.1.26",
-  "description": "Treg is a CLI tool that injects an engineering \"immune system\" into existing projects.",
+  "version": "1.0.1",
+  "description": "Treg is a CLI tool that injects an engineering immune system into existing projects.",
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/TyyyHo/treg"
+    "url": "https://github.com/TyyyHo/Treg"
   },
   "bin": {
     "treg": "dist/init-project.js"