deuk-agent-rule 1.0.2 → 1.0.4

package/README.ko.md

@@ -2,77 +2,88 @@
 
 **npm 패키지:** `deuk-agent-rule` · **CLI:** `deuk-agent-rule`
 
-**English:** [README.md](README.md)
+**English:** [README.md](https://github.com/joygram/DeukAgentRules/blob/master/README.md)
 
 Cursor, Copilot, Gemini 등 여러 에이전트·도구를 함께 쓸 때를 위한 `AGENTS.md`·`.cursor/rules` 버전 관리형 템플릿. 핸드오프·간결 응답으로 비용·성능을 개선합니다.
 
 ## 워크스페이스 초기화
 
-설치만으로는 파일이 바뀌지 않습니다. **대상 프로젝트 루트**에서 CLI를 실행하거나 `--cwd`로 경로를 줍니다.
-
 ```bash
 npm install deuk-agent-rule
 npx deuk-agent-rule init
 ```
 
-첫 적용 흐름:
+`--non-interactive` 없이 실행하면 짧은 설정 질문이 시작됩니다:
 
-1. `AGENTS.md`를 둘 프로젝트 루트로 이동.
-2. `npm install deuk-agent-rule` (devDependency 권장 가능).
-3. `npx deuk-agent-rule init` — 마커가 없으면 끝에 `<!-- deuk-agent-rule:begin -->` … `<!-- deuk-agent-rule:end -->` 블록을 붙이고 안쪽을 번들 템플릿으로 채움. `.mdc`는 `.cursor/rules/`에 복사(이름 충돌 시 기본 **prefix**).
+```
+$ npx deuk-agent-rule init
+
+DeukAgentRules init — let's configure your workspace.
+
+? What is your primary tech stack?
+  1) Unity / C#
+  2) Next.js + C#
+  3) Web (React / Vue / general)
+  4) Java / Spring Boot
+  5) Other / skip
+  Choice [1-5]: 1
+
+? Which agent tools do you use? (comma-separated numbers, or 'all')
+  1) Cursor
+  2) GitHub Copilot
+  3) Gemini / Antigravity
+  4) All of the above
+  5) Other / skip
+  Choices: 1,2
+
+  Stack : unity
+  Tools : cursor, copilot
+
+AGENTS.md: injected (inject)
+rule copied: .cursor/rules/deuk-agent-rule-multi-ai-workflow.mdc
+rule copied: .cursor/rules/deuk-agent-rule-git-commit.mdc
+```
 
-패키지 업데이트 후:
+CI나 스크립트 환경에서 질문 없이 실행:
 
 ```bash
-npm update deuk-agent-rule
-npx deuk-agent-rule init
+npx deuk-agent-rule init --non-interactive
 ```
 
-`AGENTS.md`에서는 **마커 안**만 다시 갱신되고, 바깥 내용은 유지됩니다.
-
-### `init` 파라미터
-
-플래그는 모두 `init` **뒤**에 둡니다. 예: `npx deuk-agent-rule init --cwd ../다른레포 --dry-run`
-
-| 플래그 | init 기본값 | 설명 |
-|--------|-------------|------|
-| `--cwd <path>` | 현재 디렉터리 | `AGENTS.md`·`.cursor/rules/`를 쓸 레포 루트. |
-| `--dry-run` | 끔 | 쓰기 없이 할 일만 출력. |
-| `--backup` | 끔 | 덮어쓰기 전 같은 이름에 `.bak` 저장. |
-| `--tag <id>` | `deuk-agent-rule` | `<!-- <id>:begin -->` ~ `<!-- <id>:end -->` 마커 쌍. |
-| `--marker-begin` / `--marker-end` | (`--tag` 권장) | 임의 마커 문자열, **둘 다** 필요. |
-| `--agents <mode>` | `inject` | `inject` — 마커 안만 갱신(마커 없으면 블록 추가). `skip` — `AGENTS.md` 건드리지 않음. `overwrite` — 전체 교체(주의). |
-| `--rules <mode>` | `prefix` | `prefix` — 있으면 `deuk-agent-rule-foo.mdc`로 추가. `skip` — 스킵. `overwrite` — 덮어쓰기. |
-| `--append-if-no-markers` | 끔 | `merge`에서 주로 사용. |
-
-예시:
+패키지 업데이트 후:
 
 ```bash
-npx deuk-agent-rule init --cwd /path/to/repo
-npx deuk-agent-rule init --dry-run
-npx deuk-agent-rule init --tag mycompany --rules overwrite
-npx deuk-agent-rule init --agents skip --rules prefix
-npx deuk-agent-rule init --backup
+npm update deuk-agent-rule
+npx deuk-agent-rule init --non-interactive
 ```
 
-### 동작 모델
+`AGENTS.md`의 **마커 안**만 갱신되고 바깥 내용은 유지됩니다.
+
+### 주요 옵션
 
-- **관리 구역**: 마커 쌍 **사이**만 패키지가 갱신.
-- **`.mdc`**: 별도 파일로 복사; 기본 `prefix`로 기존 파일 보호.
+| 플래그 | 기본값 | 설명 |
+|--------|--------|------|
+| `--non-interactive` | 끔 | 질문 생략, 플래그 기본값으로 실행 |
+| `--cwd <path>` | 현재 디렉터리 | 대상 레포 루트 |
+| `--dry-run` | 끔 | 쓰기 없이 동작만 출력 |
+| `--tag <id>` | `deuk-agent-rule` | 마커 id: `<!-- <id>:begin/end -->` |
+| `--agents <mode>` | `inject` | `inject` \| `skip` \| `overwrite` |
+| `--rules <mode>` | `prefix` | `prefix` \| `skip` \| `overwrite` |
+| `--backup` | 끔 | 덮어쓰기 전 `*.bak` 저장 |
 
-### 번들에 포함되는 규칙
+### 번들 규칙
 
 - **`multi-ai-workflow.mdc`** — `alwaysApply: true`
 - **`git-commit.mdc`** — `alwaysApply: false`
 
 ### `merge` (엄격)
 
-옵션은 동일. 마커가 없으면 `inject`는 실패(`--append-if-no-markers` 없을 때). 기본 `--rules skip`.
+옵션 동일. 마커가 없으면 inject 실패(`--append-if-no-markers` 없을 때). 기본 `--rules skip`.
 
 ### 주의
 
-- `alwaysApply: true` 규칙이 겹치면 컨텍스트가 길어질 수 있음.
-- `postinstall`에서 `init` 자동 실행은 권장하지 않음.
+- `alwaysApply: true` 규칙이 겹치면 컨텍스트가 커질 수 있습니다.
+- `postinstall`에서 `init` 자동 실행은 권장하지 않습니다.
 
 ## 버전
 

package/README.md

@@ -2,64 +2,74 @@
 
 **npm package:** `deuk-agent-rule` · **CLI:** `deuk-agent-rule`
 
-**한국어:** [README.ko.md](README.ko.md)
+**한국어:** [README.ko.md](https://github.com/joygram/DeukAgentRules/blob/master/README.ko.md)
 
 Versioned templates for `AGENTS.md` and `.cursor/rules` for Cursor, Copilot, Gemini and similar agents: shared handoff format, concise execution, stronger cost-efficiency and responsiveness.
 
 ## Initialize a workspace
 
-Install does nothing until you run the CLI from the **target repository root** (or pass `--cwd`).
-
 ```bash
 npm install deuk-agent-rule
 npx deuk-agent-rule init
 ```
 
-Typical first run:
+Running `init` without `--non-interactive` starts a short setup flow:
 
-1. `cd` into your project root (where `AGENTS.md` should live).
-2. `npm install deuk-agent-rule` (devDependency is fine).
-3. `npx deuk-agent-rule init` — appends `<!-- deuk-agent-rule:begin -->` … `<!-- deuk-agent-rule:end -->` if missing, fills the inner region with the bundled template, and copies `.mdc` files under `.cursor/rules/` (default **prefix** on name clash).
+```
+$ npx deuk-agent-rule init
+
+DeukAgentRules init — let's configure your workspace.
+
+? What is your primary tech stack?
+  1) Unity / C#
+  2) Next.js + C#
+  3) Web (React / Vue / general)
+  4) Java / Spring Boot
+  5) Other / skip
+  Choice [1-5]: 3
+
+? Which agent tools do you use? (comma-separated numbers, or 'all')
+  1) Cursor
+  2) GitHub Copilot
+  3) Gemini / Antigravity
+  4) All of the above
+  5) Other / skip
+  Choices: all
+
+  Stack : web
+  Tools : cursor, copilot, gemini, all
+
+AGENTS.md: injected (inject)
+rule copied: .cursor/rules/deuk-agent-rule-multi-ai-workflow.mdc
+rule copied: .cursor/rules/deuk-agent-rule-git-commit.mdc
+```
 
-After a package upgrade:
+To skip questions (CI or scripted use):
 
 ```bash
-npm update deuk-agent-rule
-npx deuk-agent-rule init
+npx deuk-agent-rule init --non-interactive
 ```
 
-Only the **marker region** in `AGENTS.md` is replaced again; your text outside the markers stays.
-
-### `init` parameters
-
-All flags go **after** `init` (e.g. `npx deuk-agent-rule init --cwd ../other-repo --dry-run`).
-
-| Flag | Default (init) | Description |
-|------|----------------|-------------|
-| `--cwd <path>` | current directory | Root of the repo to modify (`AGENTS.md`, `.cursor/rules/`). |
-| `--dry-run` | off | Print planned actions; do not write files. |
-| `--backup` | off | Write `*.bak` next to any file that would be overwritten. |
-| `--tag <id>` | `deuk-agent-rule` | HTML comment markers: `<!-- <id>:begin -->` … `<!-- <id>:end -->`. |
-| `--marker-begin <s>` / `--marker-end <s>` | (use `--tag` instead) | Custom marker strings; **both** required if either is set. |
-| `--agents <mode>` | `inject` | `inject` — update only inside markers (or append block if no markers). `skip` — do not change `AGENTS.md`. `overwrite` — replace entire `AGENTS.md` with the bundle (use with care). |
-| `--rules <mode>` | `prefix` | `prefix` — if `foo.mdc` exists, write `deuk-agent-rule-foo.mdc`. `skip` — skip existing names. `overwrite` — replace on clash. |
-| `--append-if-no-markers` | off | Rare for `init` (init already appends when markers are missing). Same flag is mainly for `merge`. |
-
-Examples:
+After a package upgrade:
 
 ```bash
-npx deuk-agent-rule init --cwd /path/to/repo
-npx deuk-agent-rule init --dry-run
-npx deuk-agent-rule init --tag mycompany --rules overwrite
-npx deuk-agent-rule init --agents skip --rules prefix
-npx deuk-agent-rule init --backup
+npm update deuk-agent-rule
+npx deuk-agent-rule init --non-interactive
 ```
 
-### Product model
+Only the **marker region** in `AGENTS.md` is replaced; your text outside stays.
+
+### Key options
 
-- **Managed block in `AGENTS.md`**: Between `<!-- deuk-agent-rule:begin -->` and `<!-- deuk-agent-rule:end -->` (or your `--tag`) — `init` / `merge` replace **only** that inner content with the bundled template.
-- **Updates**: Re-run `init` after `npm update` to refresh the managed block idempotently.
-- **`.mdc`**: Copied as **separate files**; default `prefix` avoids overwriting your existing rules.
+| Flag | Default | Description |
+|------|---------|-------------|
+| `--non-interactive` | off | Skip questions; use flag defaults |
+| `--cwd <path>` | current directory | Target repo root |
+| `--dry-run` | off | Print actions without writing |
+| `--tag <id>` | `deuk-agent-rule` | Marker id: `<!-- <id>:begin/end -->` |
+| `--agents <mode>` | `inject` | `inject` \| `skip` \| `overwrite` |
+| `--rules <mode>` | `prefix` | `prefix` \| `skip` \| `overwrite` |
+| `--backup` | off | Write `*.bak` before overwrite |
 
 ### Bundled rules
 
@@ -68,11 +78,11 @@ npx deuk-agent-rule init --backup
 
 ### `merge` (stricter)
 
-Same flags; **`AGENTS.md` `inject` fails if markers are missing** unless `--append-if-no-markers`. Default **`--rules skip`**.
+Same flags; `AGENTS.md` inject fails without markers unless `--append-if-no-markers`. Default `--rules skip`.
 
 ### Caveats
 
-- Multiple `alwaysApply: true` rule files (yours + prefixed copies) all apply — trim duplicates if context grows too large.
+- Multiple `alwaysApply: true` rules all apply — trim duplicates if context grows too large.
 - Do **not** run `init` from `postinstall` without an explicit team decision.
 
 ## Versioning

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deuk-agent-rule",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "DeukAgentRules: generic AGENTS.md + .cursor rule templates with init/merge CLI (npm name: deuk-agent-rule).",
   "license": "Apache-2.0",
   "files": [

package/scripts/cli.mjs

@@ -1,5 +1,6 @@
 #!/usr/bin/env node
-import { existsSync } from "fs";
+import { existsSync, readFileSync } from "fs";
+import { createInterface } from "readline";
 import { dirname, join } from "path";
 import { fileURLToPath } from "url";
 import {
@@ -13,9 +14,122 @@ const __dirname = dirname(fileURLToPath(import.meta.url));
 const pkgRoot = join(__dirname, "..");
 const bundleRoot = join(pkgRoot, "bundle");
 
+// ---------------------------------------------------------------------------
+// Interactive prompt helpers (no external deps)
+// ---------------------------------------------------------------------------
+
+function isNonInteractive(opts) {
+  return opts.nonInteractive || process.env.CI || !process.stdin.isTTY;
+}
+
+async function ask(rl, question) {
+  return new Promise((resolve) => rl.question(question, resolve));
+}
+
+async function selectOne(rl, prompt, choices) {
+  console.log("\n" + prompt);
+  choices.forEach((c, i) => console.log(`  ${i + 1}) ${c.label}`));
+  while (true) {
+    const ans = (await ask(rl, `  Choice [1-${choices.length}]: `)).trim();
+    const idx = parseInt(ans, 10) - 1;
+    if (idx >= 0 && idx < choices.length) return choices[idx].value;
+    console.log("  Please enter a number between 1 and " + choices.length);
+  }
+}
+
+async function selectMany(rl, prompt, choices) {
+  console.log("\n" + prompt + " (comma-separated numbers, or 'all')");
+  choices.forEach((c, i) => console.log(`  ${i + 1}) ${c.label}`));
+  while (true) {
+    const ans = (await ask(rl, `  Choices: `)).trim().toLowerCase();
+    if (ans === "all" || ans === "") return choices.map((c) => c.value);
+    const parts = ans.split(/[,\s]+/).map((s) => parseInt(s, 10) - 1);
+    if (parts.every((i) => i >= 0 && i < choices.length)) {
+      return parts.map((i) => choices[i].value);
+    }
+    console.log("  Invalid selection, try again.");
+  }
+}
+
+const STACKS = [
+  { label: "Unity / C#", value: "unity" },
+  { label: "Next.js + C#", value: "nextjs-dotnet" },
+  { label: "Web (React / Vue / general)", value: "web" },
+  { label: "Java / Spring Boot", value: "java" },
+  { label: "Other / skip", value: "other" },
+];
+
+const AGENT_TOOLS = [
+  { label: "Cursor", value: "cursor" },
+  { label: "GitHub Copilot", value: "copilot" },
+  { label: "Gemini / Antigravity", value: "gemini" },
+  { label: "All of the above", value: "all" },
+  { label: "Other / skip", value: "other" },
+];
+
+async function runInteractive(opts) {
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  try {
+    console.log("\nDeukAgentRules init — let's configure your workspace.\n");
+
+    const stack = await selectOne(rl, "What is your primary tech stack?", STACKS);
+    const tools = await selectMany(rl, "Which agent tools do you use?", AGENT_TOOLS);
+
+    const targetAgents = join(opts.cwd, "AGENTS.md");
+    let agentsDefault = "inject";
+    if (!existsSync(targetAgents)) {
+      agentsDefault = "inject"; // will append markers
+      console.log("\n  No AGENTS.md found — will create with markers.");
+    } else {
+      const content = readFileSync(targetAgents, "utf8");
+      const hasMarkers = content.includes("deuk-agent-rule:begin");
+      if (!hasMarkers) {
+        const choice = await selectOne(rl, "AGENTS.md exists but has no markers. How to apply?", [
+          { label: "Append managed block at the end (safe)", value: "inject" },
+          { label: "Overwrite entire AGENTS.md", value: "overwrite" },
+          { label: "Skip AGENTS.md", value: "skip" },
+        ]);
+        agentsDefault = choice;
+      }
+    }
+
+    opts.agents = opts.agents ?? agentsDefault;
+    opts.stack = stack;
+    opts.agentTools = tools;
+
+    console.log("\n  Stack : " + stack);
+    console.log("  Tools : " + (tools.join(", ") || "none"));
+    console.log("  AGENTS: " + opts.agents + "\n");
+  } finally {
+    rl.close();
+  }
+}
+
+// ---------------------------------------------------------------------------
+// Help / arg parsing
+// ---------------------------------------------------------------------------
+
 function printHelp() {
   console.log(
-    "DeukAgentRules (npm: deuk-agent-rule) — AGENTS.md + .cursor/rules templates\n\nUsage:\n  npx deuk-agent-rule init   [options]\n  npx deuk-agent-rule merge  [options]\n\nPrimary flow:\n  npm install deuk-agent-rule\n  npx deuk-agent-rule init\n\nOptions:\n  --cwd <path>\n  --dry-run\n  --backup\n  --tag <id>\n  --marker-begin <string>\n  --marker-end <string>\n\ninit defaults: agents inject (append markers if missing), rules prefix\nmerge defaults: agents inject (fail if no markers unless --append-if-no-markers), rules skip\n\nAlso:\n  --agents skip|overwrite|inject\n  --rules skip|overwrite|prefix\n  --append-if-no-markers\n\nKorean: package README.ko.md\n",
+    `DeukAgentRules (npm: deuk-agent-rule) — AGENTS.md + .cursor/rules templates
+
+Usage:
+  npx deuk-agent-rule init   [options]   # interactive by default
+  npx deuk-agent-rule merge  [options]
+
+Options:
+  --cwd <path>          Target repo root (default: current directory)
+  --dry-run             Print actions; do not write files
+  --non-interactive     Skip questions; use defaults/flags directly
+  --tag <id>            Marker id (default: deuk-agent-rule)
+  --agents <mode>       inject | skip | overwrite
+  --rules <mode>        prefix | skip | overwrite
+  --backup              Write *.bak before overwrite
+  --append-if-no-markers
+  --marker-begin / --marker-end  Custom marker strings (both required)
+
+Korean: package README.ko.md
+`,
   );
 }
 
@@ -30,6 +144,7 @@ function parseArgs(argv) {
     agents: undefined,
     rules: undefined,
     appendIfNoMarkers: false,
+    nonInteractive: false,
   };
   for (let i = 0; i < argv.length; i++) {
     const a = argv[i];
@@ -38,6 +153,7 @@ function parseArgs(argv) {
       if (!out.cwd) throw new Error("--cwd requires a path");
     } else if (a === "--dry-run") out.dryRun = true;
     else if (a === "--backup") out.backup = true;
+    else if (a === "--non-interactive") out.nonInteractive = true;
     else if (a === "--tag") {
       out.tag = argv[++i];
       if (out.tag == null) throw new Error("--tag requires a value");
@@ -70,6 +186,10 @@ function validateMode(name, v, allowed) {
   }
 }
 
+// ---------------------------------------------------------------------------
+// init / merge runners
+// ---------------------------------------------------------------------------
+
 function runInit(opts) {
   const markers = resolveMarkers({
     tag: opts.tag,
@@ -150,7 +270,11 @@ function runMerge(opts) {
   }
 }
 
-function main() {
+// ---------------------------------------------------------------------------
+// Entry point
+// ---------------------------------------------------------------------------
+
+async function main() {
   const argv = process.argv.slice(2);
   const sub = argv[0];
   if (!sub || sub === "-h" || sub === "--help") {
@@ -175,13 +299,16 @@ function main() {
 
   if (!existsSync(bundleRoot)) {
     console.error(
-      "Missing bundle/ (run from published package or run npm run sync in deuk-agent-rule when developing in the monorepo).",
+      "Missing bundle/ (run from published package or run npm run sync in DeukAgentRules when developing).",
     );
     process.exit(1);
   }
 
   try {
     if (sub === "init") {
+      if (!isNonInteractive(opts)) {
+        await runInteractive(opts);
+      }
       runInit(opts);
     } else if (sub === "merge") {
       runMerge(opts);

package/scripts/sync-oss.mjs

@@ -29,6 +29,9 @@ mkdirSync(join(ossRoot, "scripts"), { recursive: true });
 mkdirSync(join(ossRoot, "publish"), { recursive: true });
 
 cpSync(join(pkgRoot, "publish"), join(ossRoot, "publish"), { recursive: true, force: true });
+if (existsSync(join(pkgRoot, ".github"))) {
+  cpSync(join(pkgRoot, ".github"), join(ossRoot, ".github"), { recursive: true, force: true });
+}
 cpSync(join(pkgRoot, "scripts", "cli.mjs"), join(ossRoot, "scripts", "cli.mjs"), { force: true });
 cpSync(join(pkgRoot, "scripts", "merge-logic.mjs"), join(ossRoot, "scripts", "merge-logic.mjs"), {
   force: true,
@@ -42,6 +45,12 @@ if (!existsSync(ossPublic)) {
 }
 cpSync(join(pkgRoot, "README.md"), join(ossRoot, "README.md"), { force: true });
 cpSync(join(pkgRoot, "README.ko.md"), join(ossRoot, "README.ko.md"), { force: true });
+if (existsSync(join(pkgRoot, "package-lock.json"))) {
+  cpSync(join(pkgRoot, "package-lock.json"), join(ossRoot, "package-lock.json"), { force: true });
+}
+if (existsSync(join(pkgRoot, "LICENSE"))) {
+  cpSync(join(pkgRoot, "LICENSE"), join(ossRoot, "LICENSE"), { force: true });
+}
 cpSync(join(ossPublic, "RELEASING.md"), join(ossRoot, "RELEASING.md"), { force: true });
 cpSync(join(ossPublic, "RELEASING.ko.md"), join(ossRoot, "RELEASING.ko.md"), { force: true });
 cpSync(join(ossPublic, "GITHUB_DESCRIPTION.md"), join(ossRoot, "GITHUB_DESCRIPTION.md"), {
@@ -51,7 +60,7 @@ cpSync(join(ossPublic, "GITHUB_DESCRIPTION.md"), join(ossRoot, "GITHUB_DESCRIPTI
 const srcPkg = JSON.parse(readFileSync(join(pkgRoot, "package.json"), "utf8"));
 const outPkg = {
   ...srcPkg,
-  license: "MIT",
+  license: srcPkg.license || "Apache-2.0",
   repository: {
     type: "git",
     url: gitUrl,