@tyyyho/treg 0.1.5 → 0.1.6

package/README.md

@@ -6,9 +6,9 @@ It applies infra setup such as lint, format, TypeScript, test, husky, and AI ski
 ## Quick Start
 
 ```bash
-pnpm dlx @tyyyho/treg init <project-dir> --framework react
+pnpm dlx @tyyyho/treg init --framework react
 # or
-npx @tyyyho/treg init <project-dir> --framework react
+npx @tyyyho/treg init --framework react
 ```
 
 `init` requires `--framework`.
@@ -16,7 +16,7 @@ npx @tyyyho/treg init <project-dir> --framework react
 ## Commands
 
 ```bash
-npx @tyyyho/treg <command> [projectDir] [options]
+npx @tyyyho/treg <command> [options]
 ```
 
 - `init`: Initialize infra rules (requires `--framework`)
@@ -28,12 +28,14 @@ npx @tyyyho/treg <command> [projectDir] [options]
 - `--framework <node|react|next|vue|svelte|nuxt>`: Target framework
 - `--framework-version <major>`: Optional major version hint (react only)
 - `--features <lint,format,typescript,test,husky>`: Features to install (defaults to all)
+- `--dir <path>`: Target directory (defaults to current directory)
 - `--test-runner <jest|vitest>`: Test runner when test feature is enabled
 - `--pm <pnpm|npm|yarn|auto>`: Package manager (auto-detected by default)
 - `--force`: Overwrite existing config files
 - `--dry-run`: Print full plan without writing files
 - `--skip-husky-install`: Skip husky install command
-- `--skills`: Update existing `AGENTS.md`/`CLAUDE.md` with skill guidance
+- `--skills`: Update existing `AGENTS.md`/`CLAUDE.md` with skill guidance (enabled by default)
+- `--no-skills`: Disable skill guidance updates
 - `--help`: Show help
 
 ## Features
@@ -51,37 +53,43 @@ Default feature set:
 Initialize a React project:
 
 ```bash
-npx @tyyyho/treg init . --framework react
+npx @tyyyho/treg init --framework react
 ```
 
 Add only lint + format:
 
 ```bash
-npx @tyyyho/treg add . --features lint,format
+npx @tyyyho/treg add --features lint,format
 ```
 
 Use Vitest for test feature:
 
 ```bash
-npx @tyyyho/treg init . --framework node --features test --test-runner vitest
+npx @tyyyho/treg init --framework node --features test --test-runner vitest
 ```
 
 Use react major version variant:
 
 ```bash
-npx @tyyyho/treg init . --framework react --framework-version 18
+npx @tyyyho/treg init --framework react --framework-version 18
 ```
 
 Preview changes only:
 
 ```bash
-npx @tyyyho/treg init . --framework react --dry-run
+npx @tyyyho/treg init --framework react --dry-run
 ```
 
 Update AI skill guidance:
 
 ```bash
-npx @tyyyho/treg add . --features lint,format,husky --skills
+npx @tyyyho/treg add --features lint,format,husky
+```
+
+Target a different directory explicitly:
+
+```bash
+npx @tyyyho/treg init --framework react --dir ./packages/web
 ```
 
 ## Notes

package/dist/init-project/cli.js

@@ -1,9 +1,27 @@
 const ALLOWED_COMMANDS = ["init", "add", "list"];
-const ALLOWED_PACKAGE_MANAGERS = ["pnpm", "npm", "yarn", "auto"];
-const ALLOWED_FRAMEWORKS = ["node", "react", "next", "vue", "svelte", "nuxt"];
-const ALLOWED_FEATURES = ["lint", "format", "typescript", "test", "husky"];
+const ALLOWED_PACKAGE_MANAGERS = [
+    "pnpm",
+    "npm",
+    "yarn",
+    "auto",
+];
+const ALLOWED_FRAMEWORKS = [
+    "node",
+    "react",
+    "next",
+    "vue",
+    "svelte",
+    "nuxt",
+];
+const ALLOWED_FEATURES = [
+    "lint",
+    "format",
+    "typescript",
+    "test",
+    "husky",
+];
 const ALLOWED_TEST_RUNNERS = ["jest", "vitest"];
-export const USAGE = `Usage: treg <command> [projectDir] [options]
+export const USAGE = `Usage: treg <command> [options]
 
 Commands:
   init                                Initialize infra rules in a project (requires --framework)
@@ -16,74 +34,104 @@ Options:
   --framework-version <major>         Optional framework major version hint
   --features <lint,format,typescript,test,husky>
                                       Features to install (all selected by default)
+  --dir <path>                        Target directory (defaults to current directory)
   --test-runner <jest|vitest>         Test runner when test feature is enabled
   --pm <pnpm|npm|yarn|auto>           Package manager (auto-detected if omitted)
   --force                             Overwrite existing config files
   --dry-run                           Print planned changes without writing files
   --skip-husky-install                Do not run husky install
-  --skills                            Update AGENTS.md/CLAUDE.md with feature skill guidance
+  --skills                            Update AGENTS.md/CLAUDE.md with feature skill guidance (default: enabled)
+  --no-skills                         Disable AGENTS.md/CLAUDE.md skill guidance updates
   -h, --help                          Show help
 `;
+function includes(allowed, value) {
+    return allowed.includes(value);
+}
+function isCommandName(value) {
+    return includes(ALLOWED_COMMANDS, value);
+}
+function isPackageManagerOption(value) {
+    return includes(ALLOWED_PACKAGE_MANAGERS, value);
+}
+function isFrameworkId(value) {
+    return includes(ALLOWED_FRAMEWORKS, value);
+}
+function isFeatureName(value) {
+    return includes(ALLOWED_FEATURES, value);
+}
+function isTestRunner(value) {
+    return includes(ALLOWED_TEST_RUNNERS, value);
+}
 export function parseArgs(argv) {
     const options = {
         command: "init",
         projectDir: null,
         framework: null,
         frameworkVersion: null,
-        features: new Array(),
+        features: [],
         testRunner: "jest",
         pm: null,
         force: false,
         dryRun: false,
         skipHuskyInstall: false,
-        skills: false,
+        skills: true,
         help: false,
     };
     let cursor = 0;
     const firstArg = argv[0];
-    if (firstArg && ALLOWED_COMMANDS.includes(firstArg)) {
+    if (firstArg && isCommandName(firstArg)) {
         options.command = firstArg;
         cursor = 1;
     }
     for (let i = cursor; i < argv.length; i += 1) {
         const arg = argv[i];
+        if (!arg) {
+            continue;
+        }
         if (arg === "-h" || arg === "--help") {
             options.help = true;
         }
         else if (arg === "--framework") {
-            options.framework = argv[i + 1];
+            options.framework = readFlagValue(argv, i, "--framework");
             i += 1;
         }
         else if (arg.startsWith("--framework=")) {
-            options.framework = arg.split("=")[1];
+            options.framework = readInlineFlagValue(arg, "--framework");
         }
         else if (arg === "--framework-version") {
-            options.frameworkVersion = argv[i + 1];
+            options.frameworkVersion = readFlagValue(argv, i, "--framework-version");
             i += 1;
         }
         else if (arg.startsWith("--framework-version=")) {
-            options.frameworkVersion = arg.split("=")[1];
+            options.frameworkVersion = readInlineFlagValue(arg, "--framework-version");
         }
         else if (arg === "--features") {
             options.features.push(...parseCsvValue(argv[i + 1], "--features"));
             i += 1;
         }
         else if (arg.startsWith("--features=")) {
-            options.features.push(...parseCsvValue(arg.split("=")[1], "--features"));
+            options.features.push(...parseCsvValue(readInlineFlagValue(arg, "--features"), "--features"));
+        }
+        else if (arg === "--dir") {
+            options.projectDir = readFlagValue(argv, i, "--dir");
+            i += 1;
+        }
+        else if (arg.startsWith("--dir=")) {
+            options.projectDir = readInlineFlagValue(arg, "--dir");
         }
         else if (arg === "--test-runner") {
-            options.testRunner = argv[i + 1];
+            options.testRunner = readFlagValue(argv, i, "--test-runner");
             i += 1;
         }
         else if (arg.startsWith("--test-runner=")) {
-            options.testRunner = arg.split("=")[1];
+            options.testRunner = readInlineFlagValue(arg, "--test-runner");
         }
         else if (arg === "--pm") {
-            options.pm = argv[i + 1];
+            options.pm = readFlagValue(argv, i, "--pm");
             i += 1;
         }
         else if (arg.startsWith("--pm=")) {
-            options.pm = arg.split("=")[1];
+            options.pm = readInlineFlagValue(arg, "--pm");
         }
         else if (arg === "--force") {
             options.force = true;
@@ -97,8 +145,8 @@ export function parseArgs(argv) {
         else if (arg === "--skills") {
             options.skills = true;
         }
-        else if (!arg.startsWith("-") && !options.projectDir) {
-            options.projectDir = arg;
+        else if (arg === "--no-skills") {
+            options.skills = false;
         }
         else {
             throw new Error(`Unknown argument: ${arg}`);
@@ -107,6 +155,20 @@ export function parseArgs(argv) {
     validateParsedOptions(options);
     return options;
 }
+function readFlagValue(argv, index, flagName) {
+    const value = argv[index + 1];
+    if (!value) {
+        throw new Error(`Missing value for ${flagName}`);
+    }
+    return value;
+}
+function readInlineFlagValue(arg, flagName) {
+    const [, rawValue] = arg.split("=", 2);
+    if (!rawValue) {
+        throw new Error(`Missing value for ${flagName}`);
+    }
+    return rawValue;
+}
 function parseCsvValue(rawValue, flagName) {
     if (!rawValue) {
         throw new Error(`Missing value for ${flagName}`);
@@ -117,13 +179,16 @@ function parseCsvValue(rawValue, flagName) {
         .filter(Boolean);
 }
 function validateParsedOptions(options) {
-    if (!ALLOWED_COMMANDS.includes(options.command)) {
+    if (!isCommandName(options.command)) {
         throw new Error(`Unsupported command: ${options.command}`);
     }
-    if (options.pm && !ALLOWED_PACKAGE_MANAGERS.includes(options.pm)) {
+    if (options.projectDir === "") {
+        throw new Error("Missing value for --dir");
+    }
+    if (options.pm && !isPackageManagerOption(options.pm)) {
         throw new Error(`Unsupported package manager: ${options.pm}`);
     }
-    if (options.framework && !ALLOWED_FRAMEWORKS.includes(options.framework)) {
+    if (options.framework && !isFrameworkId(options.framework)) {
         throw new Error(`Unsupported framework: ${options.framework}`);
     }
     if (options.frameworkVersion && !/^\d+$/.test(options.frameworkVersion)) {
@@ -134,11 +199,11 @@ function validateParsedOptions(options) {
         options.framework !== "react") {
         throw new Error(`Unsupported --framework-version for framework: ${options.framework}`);
     }
-    if (!ALLOWED_TEST_RUNNERS.includes(options.testRunner)) {
+    if (!isTestRunner(options.testRunner)) {
         throw new Error(`Unsupported test runner: ${options.testRunner}`);
     }
     for (const feature of options.features) {
-        if (!ALLOWED_FEATURES.includes(feature)) {
+        if (!isFeatureName(feature)) {
             throw new Error(`Unsupported feature in --features: ${feature}`);
         }
     }

package/dist/init-project/frameworks/react/index.js

@@ -11,8 +11,8 @@ export const reactFramework = {
     },
 };
 const REACT_VARIANTS = {
-    18: reactV18Framework,
-    19: reactV19Framework,
+    "18": reactV18Framework,
+    "19": reactV19Framework,
 };
 export function resolveReactFramework(packageJson, frameworkVersion) {
     if (frameworkVersion && REACT_VARIANTS[frameworkVersion]) {

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

@@ -48,6 +48,13 @@ const FEATURE_SKILLS = {
         ],
     },
 };
+const FEATURE_STEP_LABELS = {
+    format: "格式處理",
+    husky: "Git hook 維護",
+    lint: "Lint 規則檢查",
+    test: "測試規則調整",
+    typescript: "TypeScript 型別與設定",
+};
 function resolveSkillsDoc(projectDir) {
     const agentsPath = path.join(projectDir, "AGENTS.md");
     if (existsSync(agentsPath)) {
@@ -118,23 +125,28 @@ function buildSkillSection(context) {
         START_MARKER,
         "## treg AI Skills",
         "",
-        "以下 skill 可在 agent 任務完成前引用，確保基礎建設規則正確且可重跑：",
+        "### 執行步驟與 Skill 對應",
         "",
     ];
-    for (const feature of enabled) {
+    if (enabled.length === 0) {
+        lines.push("1. 本次未啟用任何 feature，無需呼叫 skill。");
+        lines.push("");
+        lines.push(END_MARKER);
+        lines.push("");
+        return lines.join("\n");
+    }
+    enabled.forEach((feature, index) => {
         const skill = FEATURE_SKILLS[feature];
         if (!skill)
-            continue;
+            return;
         const skillRelativePath = getSkillRelativePath(feature);
-        lines.push(`### ${feature}`);
-        lines.push(`- Skill: [${skill.name}](${skillRelativePath})`);
-        lines.push(`- 使用時機: ${skill.when}`);
+        const stepLabel = FEATURE_STEP_LABELS[feature] ?? feature;
+        lines.push(`${index + 1}. ${stepLabel}：呼叫 [${skill.name}](${skillRelativePath})`);
         if (feature === "test") {
-            lines.push(`- 目前測試工具: \`${testRunner}\``);
+            lines.push(`   - 目前測試工具：\`${testRunner}\``);
         }
-        lines.push(`- 驗證清單: ${skill.checklist.join("、")}`);
-        lines.push("");
-    }
+    });
+    lines.push("");
     lines.push(END_MARKER);
     lines.push("");
     return lines.join("\n");

package/dist/init-project/mrm-rules/husky.js

@@ -45,14 +45,17 @@ export async function runHuskyRule(context) {
         return;
     }
     if (!dryRun) {
-        if (pm === "pnpm") {
-            runCommand("pnpm exec husky", projectDir, false);
-        }
-        else if (pm === "yarn") {
-            runCommand("yarn husky", projectDir, false);
-        }
-        else {
-            runCommand("npx husky", projectDir, false);
-        }
+        runHuskyInstallCommand(pm, projectDir);
+    }
+}
+function runHuskyInstallCommand(pm, projectDir) {
+    if (pm === "pnpm") {
+        runCommand("pnpm exec husky", projectDir, false);
+        return;
+    }
+    if (pm === "yarn") {
+        runCommand("yarn husky", projectDir, false);
+        return;
     }
+    runCommand("npx husky", projectDir, false);
 }

package/dist/init-project/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tyyyho/treg",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "description": "CLI tool for initializing development conventions in existing projects.",
   "license": "MIT",
   "repository": {