@tyyyho/treg 1.0.0 → 1.0.2

package/README.md

@@ -9,11 +9,11 @@ downloads](https://img.shields.io/npm/dm/%40tyyyho%2Ftreg)](https://www.npmjs.co
 
 ## 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.
@@ -22,7 +22,7 @@ It focuses only on **infrastructure setup**, not application logic.
 
 ## Features
 
-`treg` can configure:
+`Treg` can configure:
 
 - **TypeScript**
 - **ESLint**
@@ -105,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
 
@@ -125,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

@@ -9,11 +9,11 @@ downloads](https://img.shields.io/npm/dm/%40tyyyho%2Ftreg)](https://www.npmjs.co
 
 ## 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.
@@ -22,7 +22,7 @@ It focuses only on **infrastructure setup**, not application logic.
 
 ## Features
 
-`treg` can configure:
+`Treg` can configure:
 
 - **TypeScript**
 - **ESLint**
@@ -105,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
 
@@ -125,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/init-prompts.js

@@ -19,6 +19,7 @@ const AI_TOOL_CHOICES = [
     { value: "claude", label: "Claude" },
     { value: "codex", label: "Codex" },
     { value: "gemini", label: "Gemini" },
+    { value: "skip", label: "skip (disable AI skill guidance)" },
 ];
 const FEATURE_CHOICES = [
     { value: "lint", label: "lint" },
@@ -67,13 +68,25 @@ async function promptSingleChoice(message, choices, defaultValue) {
     const result = await prompts.select(defaultChoice ? { ...options, initialValue: defaultChoice } : options);
     return unwrapPromptResult(result, prompts).value;
 }
-async function promptMultiChoice(message, choices, defaultValues) {
+function resolveAiToolSelection(selected) {
+    if (selected.includes("skip")) {
+        return {
+            skills: false,
+            aiTools: [],
+        };
+    }
+    return {
+        skills: selected.length > 0,
+        aiTools: selected,
+    };
+}
+async function promptMultiChoice(message, choices, defaultValues, required = false) {
     const prompts = await getPrompts();
     const result = await prompts.multiselect({
         message,
         options: mapChoiceOptions(choices),
         initialValues: choices.filter(choice => defaultValues.includes(choice.value)),
-        required: false,
+        required,
     });
     return unwrapPromptResult(result, prompts).map(choice => choice.value);
 }
@@ -124,9 +137,12 @@ export async function collectInitPrompts(defaults) {
     let aiTools = [];
     let skills = featureSelection.skills;
     if (skills) {
-        aiTools = await promptMultiChoice("5) AI tools", AI_TOOL_CHOICES, []);
-        if (aiTools.length === 0) {
-            skills = false;
+        const aiToolAnswers = await promptMultiChoice("5) AI tools (Space to select, A to toggle all)", AI_TOOL_CHOICES, [], true);
+        const aiToolSelection = resolveAiToolSelection(aiToolAnswers);
+        skills = aiToolSelection.skills;
+        aiTools = aiToolSelection.aiTools;
+        if (!skills) {
+            console.log("AI skill guidance disabled by selection: skip");
         }
     }
     else {
@@ -143,4 +159,5 @@ export async function collectInitPrompts(defaults) {
 }
 export const __testables__ = {
     toFeatureSelection,
+    resolveAiToolSelection,
 };

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": "1.0.0",
+  "version": "1.0.2",
   "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"