@clearlydev/nx-archweave 0.3.1 → 0.3.3

package/dist/generators/_chunks/chunk-IIDOBI42.js

@@ -0,0 +1,616 @@
+import {
+  renderLineDiff
+} from "./chunk-3A6RZUCZ.js";
+import {
+  resolveFsdPolicy
+} from "./chunk-5MI3O4VZ.js";
+import {
+  readBoundaryTags
+} from "./chunk-6ZTIUBB2.js";
+import {
+  resolveDryRun
+} from "./chunk-TUN34LAQ.js";
+import {
+  readToolkitConfig,
+  recordAiHosts,
+  resolveAiHostsOption,
+  resolveLocaleOption,
+  rulesFilesFor
+} from "./chunk-EXYZLL7A.js";
+
+// ../templates/dist/agents/agent-sections.js
+var UNIVERSAL_AGENT_SECTION_IDS = [
+  "think-before-coding",
+  "simplicity-first",
+  "surgical-changes",
+  "goal-driven-execution",
+  "code-structure"
+];
+var PLACEHOLDER_AGENT_SECTION_IDS = ["project-goal", "architecture-boundary"];
+var TEAM_AGENT_SECTION_ID = "team-rules";
+var FSD_AGENT_SECTION_ID = "fsd-structure";
+var DEFAULT_AGENT_SECTION_IDS = [
+  ...UNIVERSAL_AGENT_SECTION_IDS,
+  "safety-rules",
+  "language-policy",
+  ...PLACEHOLDER_AGENT_SECTION_IDS
+];
+var EN_SECTIONS = {
+  "think-before-coding": {
+    id: "think-before-coding",
+    heading: "Think Before Coding",
+    body: [
+      "Before writing any code, restate the problem in your own words and identify what could go wrong.",
+      "Read the surrounding code and existing patterns before introducing new ones \u2014 consistency beats",
+      "personal preference. When a request is ambiguous, make the most reasonable interpretation and say",
+      "what you assumed, rather than guessing silently or blocking on a question you could answer yourself.",
+      "Prefer understanding the root cause of a problem over patching its symptoms."
+    ].join("\n")
+  },
+  "simplicity-first": {
+    id: "simplicity-first",
+    heading: "Simplicity First",
+    body: [
+      "Choose the simplest design that solves the actual problem in front of you, not the one you might",
+      "have tomorrow. Avoid speculative abstraction, unnecessary configuration, and generic frameworks",
+      "built for requirements nobody has asked for yet. A straightforward, slightly duplicated solution",
+      "that is easy to read beats a clever, general one that is hard to follow. Add complexity only when",
+      "a concrete, current need demands it."
+    ].join("\n")
+  },
+  "surgical-changes": {
+    id: "surgical-changes",
+    heading: "Surgical Changes",
+    body: [
+      "Change only what the task requires. Do not reformat, rename, or refactor unrelated code while",
+      "fixing something else \u2014 unrelated changes make review harder and hide the actual fix in noise.",
+      "Keep diffs small and focused so a reviewer can see exactly what changed and why. If you notice an",
+      "unrelated problem while working, note it separately instead of folding it into the current change."
+    ].join("\n")
+  },
+  "goal-driven-execution": {
+    id: "goal-driven-execution",
+    heading: "Goal-Driven Execution",
+    body: [
+      "Keep the actual goal in view, not just the literal instruction. If a requested step turns out to",
+      "be unnecessary, harmful, or based on a wrong assumption once you're in the code, say so and propose",
+      "the better path instead of executing it mechanically. Finish what you start: a task is done when it",
+      "actually works, not when the obvious-looking code has been written. Verify before declaring success."
+    ].join("\n")
+  },
+  "code-structure": {
+    id: "code-structure",
+    heading: "Code Structure and Abstraction",
+    body: [
+      "Keep functions and modules focused on one responsibility; split a file or function when it starts",
+      "accumulating unrelated concerns rather than letting it grow into a god object. Name things after",
+      "what they do or represent, not after their implementation detail. Extract an abstraction only after",
+      "a pattern has actually repeated \u2014 not in anticipation of a repetition that may never come."
+    ].join("\n")
+  },
+  "safety-rules": {
+    id: "safety-rules",
+    heading: "Safety Rules",
+    body: [
+      "Never force-push to shared branches, never bypass required status checks, and never disable or",
+      "delete CI/CD configuration just to make a failing check pass.",
+      "Do not read, print, or commit the contents of secret files (`.env`, credential files, private",
+      "keys) \u2014 treat anything matching a common secret pattern as off-limits unless the user has already",
+      "shared its contents with you directly.",
+      "Do not run destructive commands (`rm -rf`, `git reset --hard`, `git clean -f`, force pushes)",
+      "without explicit confirmation, and check for uncommitted work first.",
+      "Do not send repository contents, credentials, or user data to any external service.",
+      "When you are unsure whether an action is safe, stop and ask instead of proceeding.",
+      "",
+      "<!-- TODO: list project-specific protected resources (e.g. production config files, protected",
+      "branches, restricted directories, external services this project must never call in tests). -->"
+    ].join("\n")
+  },
+  "language-policy": {
+    id: "language-policy",
+    heading: "Language Policy",
+    body: [
+      "Communicate with the user in English. Write code, identifiers, comments, commit messages, and",
+      "documentation in English as well, unless the user explicitly asks for another language for a",
+      "specific piece of content."
+    ].join("\n")
+  },
+  "team-rules": {
+    id: "team-rules",
+    heading: "Team Rules",
+    body: [
+      "This repository is shared by a team: optimize for the reviewer, not for yourself.",
+      "Keep each pull request small and about one thing, fill in the pull request template, and link",
+      "the issue it closes.",
+      "Treat review findings as work, not opinions: address every P0/P1 finding before asking for",
+      "another look, answer each comment, and never merge your own pull request or dismiss a review",
+      "to get it through.",
+      "Respect module ownership: a change that crosses a module or layer boundary needs that",
+      "module's owner in the review. Never weaken a module-boundary lint rule, add an eslint-disable",
+      "for one, or retag a project to get an import past the boundary \u2014 propose the boundary change",
+      "in the pull request description instead.",
+      "Changes to shared code (the `shared` layer, `shared-types`, root configuration) affect every",
+      "team member: keep them backward compatible, call them out in the pull request, and keep them",
+      "separate from feature work.",
+      "Never commit directly to a protected branch; work on a branch and bring it up to date with",
+      "its base before requesting review.",
+      "",
+      "<!-- TODO: list team-specific conventions (module owners / CODEOWNERS, required reviewers,",
+      "branch naming, release process). -->"
+    ].join("\n")
+  },
+  "fsd-structure": {
+    id: "fsd-structure",
+    heading: "Frontend Structure (FSD Lite)",
+    body: [
+      'The frontend app follows canonical Feature-Sliced Design. "Lite" means only that the default scope',
+      "is `app`, `pages`, `features`, `entities` and `shared` (`widgets` only on request) and that Solo",
+      "workspaces get warnings instead of errors \u2014 the rules themselves are the canonical ones:",
+      "- A layer imports only layers below it: app > pages > widgets > features > entities > shared.",
+      "- Slices on one layer (pages, widgets, features, entities) never import each other; move the",
+      "  shared part one layer down, or expose it through the other slice's `@x/<consumer>` public API.",
+      "- Import a slice only through its `index.ts`; never reach into its `ui/`, `model/` or `api/` files.",
+      "- `app` and `shared` hold segments, not slices; shared segments are named by purpose (`ui`, `api`,",
+      "  `model`, `lib`, `config`), never by essence (`components`, `hooks`, `utils`, `types`).",
+      "Create slices with the generators (`nx g @clearlydev/nx-archweave:page|widget|feature|entity|shared --name=\u2026`,",
+      "`--segments=ui,api` for extra segments).",
+      "The `archweave/fsd-boundaries` ESLint rule reports violations: fix the import, never disable the",
+      "rule or add an eslint-disable for it. On Next.js the pages layer is the `_pages/` directory."
+    ].join("\n")
+  },
+  "project-goal": {
+    id: "project-goal",
+    heading: "Project Goal",
+    body: "<!-- TODO: describe this project's goal, target users, and what success looks like. -->"
+  },
+  "architecture-boundary": {
+    id: "architecture-boundary",
+    heading: "Architecture Boundary",
+    body: "<!-- TODO: describe this project's module boundaries, ownership rules, and which modules may or may not depend on which. -->"
+  }
+};
+var KO_SECTIONS = {
+  "think-before-coding": {
+    id: "think-before-coding",
+    heading: "\uCF54\uB529 \uC804\uC5D0 \uBA3C\uC800 \uC0DD\uAC01\uD558\uAE30",
+    body: [
+      "\uCF54\uB4DC\uB97C \uC791\uC131\uD558\uAE30 \uC804\uC5D0 \uBB38\uC81C\uB97C \uC2A4\uC2A4\uB85C\uC758 \uB9D0\uB85C \uB2E4\uC2DC \uC815\uB9AC\uD558\uACE0 \uBB34\uC5C7\uC774 \uC798\uBABB\uB420 \uC218 \uC788\uB294\uC9C0 \uD30C\uC545\uD55C\uB2E4.",
+      "\uC0C8 \uD328\uD134\uC744 \uB3C4\uC785\uD558\uAE30 \uC804\uC5D0 \uC8FC\uBCC0 \uCF54\uB4DC\uC640 \uAE30\uC874 \uAD00\uB840\uB97C \uBA3C\uC800 \uC77D\uB294\uB2E4 \u2014 \uAC1C\uC778 \uCDE8\uD5A5\uBCF4\uB2E4 \uC77C\uAD00\uC131\uC774 \uC6B0\uC120\uC774\uB2E4.",
+      "\uC694\uCCAD\uC774 \uBAA8\uD638\uD560 \uB54C\uB294 \uAC00\uC7A5 \uD569\uB9AC\uC801\uC778 \uD574\uC11D\uC744 \uD0DD\uD558\uACE0 \uBB34\uC5C7\uC744 \uAC00\uC815\uD588\uB294\uC9C0 \uBC1D\uD78C\uB2E4. \uC2A4\uC2A4\uB85C \uB2F5\uD560 \uC218 \uC788\uB294",
+      "\uC9C8\uBB38\uC73C\uB85C \uC791\uC5C5\uC744 \uB9C9\uC9C0 \uB9D0\uACE0, \uC870\uC6A9\uD788 \uCD94\uCE21\uB9CC \uD558\uC9C0\uB3C4 \uC54A\uB294\uB2E4. \uC99D\uC0C1\uC744 \uB55C\uC9C8\uD558\uAE30\uBCF4\uB2E4 \uADFC\uBCF8 \uC6D0\uC778\uC744 \uC774\uD574\uD558\uB294",
+      "\uCABD\uC744 \uC6B0\uC120\uD55C\uB2E4."
+    ].join("\n")
+  },
+  "simplicity-first": {
+    id: "simplicity-first",
+    heading: "\uB2E8\uC21C\uD568 \uC6B0\uC120",
+    body: [
+      "\uC9C0\uAE08 \uB208\uC55E\uC758 \uBB38\uC81C\uB97C \uD574\uACB0\uD558\uB294 \uAC00\uC7A5 \uB2E8\uC21C\uD55C \uC124\uACC4\uB97C \uC120\uD0DD\uD55C\uB2E4 \u2014 \uB0B4\uC77C \uD544\uC694\uD560\uC9C0\uB3C4 \uBAA8\uB974\uB294 \uAC83\uAE4C\uC9C0 \uB300\uBE44\uD558\uC9C0",
+      "\uC54A\uB294\uB2E4. \uC544\uBB34\uB3C4 \uC694\uCCAD\uD558\uC9C0 \uC54A\uC740 \uC694\uAD6C\uC0AC\uD56D\uC744 \uC704\uD55C \uCD94\uCE21\uC131 \uCD94\uC0C1\uD654, \uBD88\uD544\uC694\uD55C \uC124\uC815, \uBC94\uC6A9 \uD504\uB808\uC784\uC6CC\uD06C\uB97C",
+      "\uD53C\uD55C\uB2E4. \uC77D\uAE30 \uC26C\uC6B4 \uC57D\uAC04\uC758 \uC911\uBCF5\uC774 \uC788\uB294 \uD574\uBC95\uC774, \uC774\uD574\uD558\uAE30 \uC5B4\uB824\uC6B4 \uC601\uB9AC\uD558\uACE0 \uBC94\uC6A9\uC801\uC778 \uD574\uBC95\uBCF4\uB2E4 \uB0AB\uB2E4.",
+      "\uAD6C\uCCB4\uC801\uC774\uACE0 \uD604\uC7AC \uC874\uC7AC\uD558\uB294 \uD544\uC694\uAC00 \uC788\uC744 \uB54C\uB9CC \uBCF5\uC7A1\uB3C4\uB97C \uCD94\uAC00\uD55C\uB2E4."
+    ].join("\n")
+  },
+  "surgical-changes": {
+    id: "surgical-changes",
+    heading: "\uC678\uACFC\uC801 \uBCC0\uACBD",
+    body: [
+      "\uC791\uC5C5\uC5D0 \uD544\uC694\uD55C \uBD80\uBD84\uB9CC \uBCC0\uACBD\uD55C\uB2E4. \uB2E4\uB978 \uBB38\uC81C\uB97C \uACE0\uCE58\uB294 \uAE40\uC5D0 \uAD00\uB828 \uC5C6\uB294 \uCF54\uB4DC\uB97C \uC7AC\uD3EC\uB9F7\uD558\uAC70\uB098, \uC774\uB984\uC744",
+      "\uBC14\uAFB8\uAC70\uB098, \uB9AC\uD329\uD130\uB9C1\uD558\uC9C0 \uC54A\uB294\uB2E4 \u2014 \uAD00\uB828 \uC5C6\uB294 \uBCC0\uACBD\uC740 \uB9AC\uBDF0\uB97C \uC5B4\uB835\uAC8C \uB9CC\uB4E4\uACE0 \uC2E4\uC81C \uC218\uC815 \uB0B4\uC6A9\uC744 \uB178\uC774\uC988",
+      "\uC18D\uC5D0 \uC228\uAE34\uB2E4. diff\uB97C \uC791\uACE0 \uC9D1\uC911\uB418\uAC8C \uC720\uC9C0\uD574 \uB9AC\uBDF0\uC5B4\uAC00 \uBB34\uC5C7\uC774, \uC65C \uBC14\uB00C\uC5C8\uB294\uC9C0 \uC815\uD655\uD788 \uBCFC \uC218 \uC788\uAC8C \uD55C\uB2E4.",
+      "\uC791\uC5C5 \uC911 \uAD00\uB828 \uC5C6\uB294 \uBB38\uC81C\uB97C \uBC1C\uACAC\uD558\uBA74 \uD604\uC7AC \uBCC0\uACBD\uC5D0 \uC11E\uC9C0 \uB9D0\uACE0 \uBCC4\uB3C4\uB85C \uC54C\uB9B0\uB2E4."
+    ].join("\n")
+  },
+  "goal-driven-execution": {
+    id: "goal-driven-execution",
+    heading: "\uBAA9\uD45C \uC9C0\uD5A5 \uC2E4\uD589",
+    body: [
+      "\uBB38\uC790 \uADF8\uB300\uB85C\uC758 \uC9C0\uC2DC\uAC00 \uC544\uB2C8\uB77C \uC2E4\uC81C \uBAA9\uD45C\uB97C \uACC4\uC18D \uC5FC\uB450\uC5D0 \uB454\uB2E4. \uCF54\uB4DC\uB97C \uC0B4\uD3B4\uBCF4\uB2C8 \uC694\uCCAD\uBC1B\uC740 \uB2E8\uACC4\uAC00",
+      "\uBD88\uD544\uC694\uD558\uAC70\uB098, \uD574\uB86D\uAC70\uB098, \uC798\uBABB\uB41C \uAC00\uC815\uC5D0 \uAE30\uBC18\uD55C \uAC83\uC73C\uB85C \uB4DC\uB7EC\uB098\uBA74 \uAE30\uACC4\uC801\uC73C\uB85C \uC2E4\uD589\uD558\uC9C0 \uB9D0\uACE0 \uADF8\uB807\uB2E4\uACE0",
+      "\uB9D0\uD55C \uB4A4 \uB354 \uB098\uC740 \uACBD\uB85C\uB97C \uC81C\uC548\uD55C\uB2E4. \uC2DC\uC791\uD55C \uC77C\uC740 \uB05D\uB0B8\uB2E4 \u2014 \uADF8\uB7F4\uB4EF\uD574 \uBCF4\uC774\uB294 \uCF54\uB4DC\uB97C \uC791\uC131\uD588\uC744 \uB54C\uAC00 \uC544\uB2C8\uB77C",
+      "\uC2E4\uC81C\uB85C \uB3D9\uC791\uD560 \uB54C\uAC00 \uC644\uB8CC\uB2E4. \uC131\uACF5\uC744 \uC120\uC5B8\uD558\uAE30 \uC804\uC5D0 \uBC18\uB4DC\uC2DC \uAC80\uC99D\uD55C\uB2E4."
+    ].join("\n")
+  },
+  "code-structure": {
+    id: "code-structure",
+    heading: "\uCF54\uB4DC \uAD6C\uC870\uC640 \uCD94\uC0C1\uD654",
+    body: [
+      "\uD568\uC218\uC640 \uBAA8\uB4C8\uC744 \uD558\uB098\uC758 \uCC45\uC784\uC5D0 \uC9D1\uC911\uC2DC\uD0A8\uB2E4. God object\uB85C \uCEE4\uC9C0\uB3C4\uB85D \uB450\uC9C0 \uB9D0\uACE0, \uAD00\uB828 \uC5C6\uB294 \uAD00\uC2EC\uC0AC\uAC00",
+      "\uC313\uC774\uAE30 \uC2DC\uC791\uD558\uBA74 \uD30C\uC77C\uC774\uB098 \uD568\uC218\uB97C \uBD84\uB9AC\uD55C\uB2E4. \uAD6C\uD604 \uC138\uBD80\uC0AC\uD56D\uC774 \uC544\uB2C8\uB77C \uD558\uB294 \uC77C\uC774\uB098 \uB098\uD0C0\uB0B4\uB294 \uB300\uC0C1\uC744",
+      "\uAE30\uC900\uC73C\uB85C \uC774\uB984\uC744 \uC9D3\uB294\uB2E4. \uD328\uD134\uC774 \uC2E4\uC81C\uB85C \uBC18\uBCF5\uB41C \uB4A4\uC5D0\uB9CC \uCD94\uC0C1\uD654\uB97C \uCD94\uCD9C\uD55C\uB2E4 \u2014 \uC5B8\uC820\uAC00 \uBC18\uBCF5\uB420\uC9C0\uB3C4 \uBAA8\uB978\uB2E4\uB294",
+      "\uC608\uCE21\uB9CC\uC73C\uB85C \uBBF8\uB9AC \uCD94\uCD9C\uD558\uC9C0 \uC54A\uB294\uB2E4."
+    ].join("\n")
+  },
+  "safety-rules": {
+    id: "safety-rules",
+    heading: "\uC548\uC804 \uADDC\uCE59",
+    body: [
+      "\uACF5\uC720 \uBE0C\uB79C\uCE58\uC5D0 force-push\uD558\uC9C0 \uC54A\uACE0, \uD544\uC218 \uC0C1\uD0DC \uAC80\uC0AC\uB97C \uC6B0\uD68C\uD558\uC9C0 \uC54A\uC73C\uBA70, \uC2E4\uD328\uD558\uB294 \uAC80\uC0AC\uB97C \uD1B5\uACFC\uC2DC\uD0A4\uAE30",
+      "\uC704\uD574 CI/CD \uC124\uC815\uC744 \uBE44\uD65C\uC131\uD654\uD558\uAC70\uB098 \uC0AD\uC81C\uD558\uC9C0 \uC54A\uB294\uB2E4.",
+      "\uBE44\uBC00 \uD30C\uC77C(`.env`, \uC790\uACA9 \uC99D\uBA85 \uD30C\uC77C, \uAC1C\uC778 \uD0A4)\uC758 \uB0B4\uC6A9\uC744 \uC77D\uAC70\uB098 \uCD9C\uB825\uD558\uAC70\uB098 \uCEE4\uBC0B\uD558\uC9C0 \uC54A\uB294\uB2E4 \u2014 \uC0AC\uC6A9\uC790\uAC00",
+      "\uBA3C\uC800 \uC9C1\uC811 \uB0B4\uC6A9\uC744 \uACF5\uC720\uD558\uC9C0 \uC54A\uB294 \uD55C, \uC77C\uBC18\uC801\uC778 \uBE44\uBC00 \uD30C\uC77C \uD328\uD134\uC5D0 \uD574\uB2F9\uD558\uB294 \uAC83\uC740 \uC811\uADFC \uAE08\uC9C0 \uB300\uC0C1\uC73C\uB85C",
+      "\uCDE8\uAE09\uD55C\uB2E4.",
+      "\uBA85\uC2DC\uC801 \uD655\uC778 \uC5C6\uC774 \uD30C\uAD34\uC801 \uBA85\uB839(`rm -rf`, `git reset --hard`, `git clean -f`, force-push)\uC744 \uC2E4\uD589\uD558\uC9C0",
+      "\uC54A\uC73C\uBA70, \uC2E4\uD589 \uC804 \uCEE4\uBC0B\uB418\uC9C0 \uC54A\uC740 \uC791\uC5C5\uC774 \uC788\uB294\uC9C0 \uBA3C\uC800 \uD655\uC778\uD55C\uB2E4.",
+      "\uC800\uC7A5\uC18C \uB0B4\uC6A9, \uC790\uACA9 \uC99D\uBA85, \uC0AC\uC6A9\uC790 \uB370\uC774\uD130\uB97C \uC678\uBD80 \uC11C\uBE44\uC2A4\uB85C \uC804\uC1A1\uD558\uC9C0 \uC54A\uB294\uB2E4.",
+      "\uC5B4\uB5A4 \uB3D9\uC791\uC774 \uC548\uC804\uD55C\uC9C0 \uD655\uC2E0\uC774 \uC11C\uC9C0 \uC54A\uC73C\uBA74 \uC9C4\uD589\uD558\uC9C0 \uB9D0\uACE0 \uBA3C\uC800 \uC9C8\uBB38\uD55C\uB2E4.",
+      "",
+      // The marker itself stays in English, matching the Language Policy's "code/comments in
+      // English" rule and giving tooling a single locale-invariant string to check for.
+      "<!-- TODO: list project-specific protected resources (e.g. production config files, protected",
+      "branches, restricted directories, external services this project must never call in tests). -->"
+    ].join("\n")
+  },
+  "language-policy": {
+    id: "language-policy",
+    heading: "\uC5B8\uC5B4 \uC815\uCC45",
+    body: [
+      "\uC0AC\uC6A9\uC790\uC640\uC758 \uB300\uD654\uB294 \uD55C\uAD6D\uC5B4\uB85C \uC9C4\uD589\uD55C\uB2E4. \uCF54\uB4DC, \uC2DD\uBCC4\uC790, \uC8FC\uC11D, \uCEE4\uBC0B \uBA54\uC2DC\uC9C0, \uBB38\uC11C\uB294 \uC0AC\uC6A9\uC790\uAC00 \uD2B9\uC815",
+      "\uD56D\uBAA9\uC5D0 \uB300\uD574 \uB2E4\uB978 \uC5B8\uC5B4\uB97C \uBA85\uC2DC\uC801\uC73C\uB85C \uC694\uCCAD\uD558\uC9C0 \uC54A\uB294 \uD55C \uC601\uC5B4\uB85C \uC791\uC131\uD55C\uB2E4."
+    ].join("\n")
+  },
+  "team-rules": {
+    id: "team-rules",
+    heading: "\uD300 \uADDC\uCE59",
+    body: [
+      "\uC774 \uC800\uC7A5\uC18C\uB294 \uD300\uC774 \uD568\uAED8 \uC4F4\uB2E4 \u2014 \uC790\uC2E0\uC774 \uC544\uB2C8\uB77C \uB9AC\uBDF0\uC5B4\uB97C \uC704\uD574 \uCD5C\uC801\uD654\uD55C\uB2E4.",
+      "PR\uC740 \uC791\uAC8C, \uD55C \uAC00\uC9C0 \uC8FC\uC81C\uB9CC \uB2E4\uB8E8\uBA70, PR \uD15C\uD50C\uB9BF\uC744 \uCC44\uC6B0\uACE0 \uB2EB\uB294 \uC774\uC288\uB97C \uB9C1\uD06C\uD55C\uB2E4.",
+      "\uB9AC\uBDF0 finding\uC740 \uC758\uACAC\uC774 \uC544\uB2C8\uB77C \uC791\uC5C5\uC774\uB2E4 \u2014 \uC7AC\uB9AC\uBDF0\uB97C \uC694\uCCAD\uD558\uAE30 \uC804\uC5D0 P0/P1 finding\uC744 \uBAA8\uB450 \uD574\uACB0\uD558\uACE0,",
+      "\uCF54\uBA58\uD2B8\uB9C8\uB2E4 \uB2F5\uD558\uBA70, \uC790\uAE30 PR\uC744 \uC2A4\uC2A4\uB85C \uBA38\uC9C0\uD558\uAC70\uB098 \uB9AC\uBDF0\uB97C dismiss\uD574\uC11C \uD1B5\uACFC\uC2DC\uD0A4\uC9C0 \uC54A\uB294\uB2E4.",
+      "\uBAA8\uB4C8 \uC18C\uC720\uAD8C\uC744 \uC874\uC911\uD55C\uB2E4 \u2014 \uBAA8\uB4C8\uC774\uB098 \uB808\uC774\uC5B4 \uACBD\uACC4\uB97C \uB118\uB294 \uBCC0\uACBD\uC740 \uD574\uB2F9 \uBAA8\uB4C8 \uC624\uB108\uC758 \uB9AC\uBDF0\uAC00 \uD544\uC694\uD558\uB2E4.",
+      "import\uB97C \uACBD\uACC4 \uB108\uBA38\uB85C \uD1B5\uACFC\uC2DC\uD0A4\uAE30 \uC704\uD574 module-boundary \uB9B0\uD2B8 \uADDC\uCE59\uC744 \uC57D\uD654\uD558\uAC70\uB098, eslint-disable\uC744",
+      "\uCD94\uAC00\uD558\uAC70\uB098, \uD504\uB85C\uC81D\uD2B8 \uD0DC\uADF8\uB97C \uBC14\uAFB8\uC9C0 \uC54A\uB294\uB2E4 \u2014 \uACBD\uACC4 \uBCC0\uACBD\uC740 PR \uBCF8\uBB38\uC5D0\uC11C \uC81C\uC548\uD55C\uB2E4.",
+      "\uACF5\uC720 \uCF54\uB4DC(`shared` \uB808\uC774\uC5B4, `shared-types`, \uB8E8\uD2B8 \uC124\uC815) \uBCC0\uACBD\uC740 \uD300 \uC804\uC6D0\uC5D0\uAC8C \uC601\uD5A5\uC744 \uC900\uB2E4 \u2014 \uD558\uC704",
+      "\uD638\uD658\uC744 \uC720\uC9C0\uD558\uACE0, PR\uC5D0 \uBA85\uC2DC\uD558\uBA70, \uAE30\uB2A5 \uC791\uC5C5\uACFC \uBD84\uB9AC\uD55C\uB2E4.",
+      "\uBCF4\uD638 \uBE0C\uB79C\uCE58\uC5D0 \uC9C1\uC811 \uCEE4\uBC0B\uD558\uC9C0 \uC54A\uB294\uB2E4 \u2014 \uBE0C\uB79C\uCE58\uC5D0\uC11C \uC791\uC5C5\uD558\uACE0 \uB9AC\uBDF0 \uC694\uCCAD \uC804\uC5D0 \uBCA0\uC774\uC2A4\uC640 \uB3D9\uAE30\uD654\uD55C\uB2E4.",
+      "",
+      // The marker stays in English, matching the Safety Rules precedent (one locale-invariant
+      // string for tooling to check).
+      "<!-- TODO: list team-specific conventions (module owners / CODEOWNERS, required reviewers,",
+      "branch naming, release process). -->"
+    ].join("\n")
+  },
+  "fsd-structure": {
+    id: "fsd-structure",
+    heading: "\uD504\uB860\uD2B8\uC5D4\uB4DC \uAD6C\uC870 (FSD Lite)",
+    body: [
+      '\uD504\uB860\uD2B8\uC5D4\uB4DC \uC571\uC740 \uC815\uC2DD Feature-Sliced Design\uC744 \uB530\uB978\uB2E4. "Lite"\uB294 \uAE30\uBCF8 \uBC94\uC704\uAC00 `app`, `pages`, `features`,',
+      "`entities`, `shared`\uC774\uACE0(`widgets`\uB294 \uC694\uCCAD\uD560 \uB54C\uB9CC), Solo \uC6CC\uD06C\uC2A4\uD398\uC774\uC2A4\uC5D0\uC11C\uB294 \uC704\uBC18\uC744 \uC5D0\uB7EC\uAC00 \uC544\uB2CC",
+      "\uACBD\uACE0\uB85C \uC54C\uB9B0\uB2E4\uB294 \uB73B\uC77C \uBFD0\uC774\uB2E4 \u2014 \uADDC\uCE59 \uC790\uCCB4\uB294 \uC815\uC2DD FSD \uADF8\uB300\uB85C\uB2E4:",
+      "- \uB808\uC774\uC5B4\uB294 \uC790\uAE30\uBCF4\uB2E4 \uC544\uB798 \uB808\uC774\uC5B4\uB9CC import\uD55C\uB2E4: app > pages > widgets > features > entities > shared.",
+      "- \uAC19\uC740 \uB808\uC774\uC5B4\uC758 \uC2AC\uB77C\uC774\uC2A4\uB07C\uB9AC(pages, widgets, features, entities)\uB294 import\uD558\uC9C0 \uC54A\uB294\uB2E4. \uACF5\uC720\uD560 \uCF54\uB4DC\uB294",
+      "  \uD55C \uB808\uC774\uC5B4 \uC544\uB798\uB85C \uB0B4\uB9AC\uAC70\uB098, \uC0C1\uB300 \uC2AC\uB77C\uC774\uC2A4\uC758 `@x/<consumer>` \uACF5\uAC1C API\uB85C\uB9CC \uB178\uCD9C\uD55C\uB2E4.",
+      "- \uC2AC\uB77C\uC774\uC2A4\uB294 `index.ts`\uB97C \uD1B5\uD574\uC11C\uB9CC import\uD55C\uB2E4. `ui/`, `model/`, `api/` \uB0B4\uBD80 \uD30C\uC77C\uC5D0 \uC9C1\uC811 \uB2FF\uC9C0 \uC54A\uB294\uB2E4.",
+      "- `app`\uACFC `shared`\uB294 \uC2AC\uB77C\uC774\uC2A4\uAC00 \uC544\uB2C8\uB77C \uC138\uADF8\uBA3C\uD2B8\uB97C \uAC00\uC9C4\uB2E4. shared \uC138\uADF8\uBA3C\uD2B8 \uC774\uB984\uC740 \uBAA9\uC801\uD615(`ui`, `api`,",
+      "  `model`, `lib`, `config`)\uC73C\uB85C \uC9D3\uACE0, \uBCF8\uC9C8\uD615(`components`, `hooks`, `utils`, `types`)\uC740 \uC4F0\uC9C0 \uC54A\uB294\uB2E4.",
+      "\uC2AC\uB77C\uC774\uC2A4\uB294 generator\uB85C \uB9CC\uB4E0\uB2E4(`nx g @clearlydev/nx-archweave:page|widget|feature|entity|shared --name=\u2026`,",
+      "\uCD94\uAC00 \uC138\uADF8\uBA3C\uD2B8\uB294 `--segments=ui,api`).",
+      "`archweave/fsd-boundaries` ESLint \uADDC\uCE59\uC774 \uC704\uBC18\uC744 \uC54C\uB824 \uC900\uB2E4: import\uB97C \uACE0\uCE58\uB418, \uADDC\uCE59\uC744 \uB044\uAC70\uB098 eslint-disable\uB85C",
+      "\uB118\uAE30\uC9C0 \uC54A\uB294\uB2E4. Next.js\uC5D0\uC11C\uB294 pages \uB808\uC774\uC5B4\uAC00 `_pages/` \uD3F4\uB354\uB2E4."
+    ].join("\n")
+  },
+  "project-goal": {
+    id: "project-goal",
+    heading: "\uD504\uB85C\uC81D\uD2B8 \uBAA9\uD45C",
+    body: "<!-- TODO: \uC774 \uD504\uB85C\uC81D\uD2B8\uC758 \uBAA9\uD45C, \uB300\uC0C1 \uC0AC\uC6A9\uC790, \uC131\uACF5 \uAE30\uC900\uC744 \uC791\uC131\uD558\uC138\uC694. -->"
+  },
+  "architecture-boundary": {
+    id: "architecture-boundary",
+    heading: "\uC544\uD0A4\uD14D\uCC98 \uACBD\uACC4",
+    body: "<!-- TODO: \uC774 \uD504\uB85C\uC81D\uD2B8\uC758 \uBAA8\uB4C8 \uACBD\uACC4, \uC18C\uC720 \uADDC\uCE59, \uC5B4\uB5A4 \uBAA8\uB4C8\uC774 \uC5B4\uB5A4 \uBAA8\uB4C8\uC5D0 \uC758\uC874\uD560 \uC218 \uC788\uB294\uC9C0\uB97C \uC791\uC131\uD558\uC138\uC694. -->"
+  }
+};
+var AGENT_RULE_SECTIONS = {
+  en: EN_SECTIONS,
+  ko: KO_SECTIONS
+};
+
+// ../templates/dist/agents/fsd-policy-notes.js
+var NOTES = {
+  en: {
+    heading: "This workspace also configures:",
+    groups: "- A folder that only groups slices (`features/mypage/{order,claims}`) holds no code and no `index.ts`; each slice in it is separate, and slices in one group never import each other either. Create one with `--group=<name>`.",
+    component: "- `shared` exposes each component through its own `index.ts` (`shared/ui/button`); import that, not the files inside it.",
+    file: "- Inside `shared`, files may be imported directly (`shared/lib/format/currency`); `shared` still never imports a layer above it.",
+    tests: "- Test files (`*.spec.ts`, `*.test.ts`, `__tests__/`) may import another slice's internals; upward imports stay forbidden there too."
+  },
+  ko: {
+    heading: "\uC774 \uC6CC\uD06C\uC2A4\uD398\uC774\uC2A4\uB294 \uB2E4\uC74C\uB3C4 \uC124\uC815\uD588\uB2E4:",
+    groups: "- \uC2AC\uB77C\uC774\uC2A4\uB97C \uBB36\uAE30\uB9CC \uD558\uB294 \uD3F4\uB354(`features/mypage/{order,claims}`)\uC5D0\uB294 \uCF54\uB4DC\uB3C4 `index.ts`\uB3C4 \uB450\uC9C0 \uC54A\uB294\uB2E4. \uADF8 \uC548\uC758 \uC2AC\uB77C\uC774\uC2A4\uB294 \uAC01\uAC01 \uB3C5\uB9BD\uC774\uB77C, \uAC19\uC740 \uADF8\uB8F9 \uC548\uC5D0\uC11C\uB3C4 \uC11C\uB85C import\uD558\uC9C0 \uC54A\uB294\uB2E4. \uADF8\uB8F9 \uC548\uC5D0 \uB9CC\uB4E4 \uB54C\uB294 `--group=<\uC774\uB984>`\uC744 \uC4F4\uB2E4.",
+    component: "- `shared`\uB294 \uCEF4\uD3EC\uB10C\uD2B8\uB9C8\uB2E4 \uC790\uAE30 `index.ts`\uB85C \uACF5\uAC1C\uD55C\uB2E4(`shared/ui/button`). \uADF8 index\uB97C import\uD558\uACE0, \uC548\uCABD \uD30C\uC77C\uC5D0\uB294 \uB2FF\uC9C0 \uC54A\uB294\uB2E4.",
+    file: "- `shared` \uC548\uC758 \uD30C\uC77C\uC740 \uC9C1\uC811 import\uD574\uB3C4 \uB41C\uB2E4(`shared/lib/format/currency`). \uB2E4\uB9CC `shared`\uB294 \uC5EC\uC804\uD788 \uC704 \uB808\uC774\uC5B4\uB97C import\uD558\uC9C0 \uC54A\uB294\uB2E4.",
+    tests: "- \uD14C\uC2A4\uD2B8 \uD30C\uC77C(`*.spec.ts`, `*.test.ts`, `__tests__/`)\uC740 \uB2E4\uB978 \uC2AC\uB77C\uC774\uC2A4\uC758 \uB0B4\uBD80 \uD30C\uC77C\uC744 import\uD574\uB3C4 \uB41C\uB2E4. \uC704 \uB808\uC774\uC5B4 import\uB294 \uD14C\uC2A4\uD2B8\uC5D0\uC11C\uB3C4 \uAE08\uC9C0\uB2E4."
+  }
+};
+function buildFsdPolicyNotes(locale, notes) {
+  const text = NOTES[locale];
+  const lines = [
+    ...notes.sliceGroups ? [text.groups] : [],
+    ...notes.sharedPublicApi === "component" ? [text.component] : notes.sharedPublicApi === "file" ? [text.file] : [],
+    ...notes.testFiles ? [text.tests] : []
+  ];
+  return lines.length === 0 ? "" : [text.heading, ...lines].join("\n");
+}
+
+// ../templates/dist/agents/module-boundaries.js
+function buildModuleBoundariesSection(locale, tags) {
+  const { frontend, backend, shared } = tags;
+  if (locale === "ko") {
+    return {
+      id: "module-boundaries",
+      heading: "\uBAA8\uB4C8 \uACBD\uACC4",
+      body: [
+        "\uB8E8\uD2B8 ESLint \uC124\uC815\uC758 `@nx/enforce-module-boundaries` \uADDC\uCE59\uC774 \uD504\uB85C\uC81D\uD2B8 \uD0DC\uADF8\uB85C \uD504\uB860\uD2B8\uC5D4\uB4DC\uC640 \uBC31\uC5D4\uB4DC\uB97C \uB098\uB208\uB2E4:",
+        `- \`${frontend}\` \uD504\uB85C\uC81D\uD2B8\uB294 \`${backend}\` \uD504\uB85C\uC81D\uD2B8\uB97C import\uD558\uC9C0 \uC54A\uACE0, \uADF8 \uBC18\uB300\uB3C4 \uB9C8\uCC2C\uAC00\uC9C0\uB2E4.`,
+        `- \`${shared}\` \uD504\uB85C\uC81D\uD2B8(shared-types \uB77C\uC774\uBE0C\uB7EC\uB9AC \uB4F1)\uB294 \uC5B4\uB290 \uCABD\uB3C4 import\uD558\uC9C0 \uC54A\uB294\uB2E4.`,
+        "- \uC774 \uD0DC\uADF8\uAC00 \uD558\uB098\uB3C4 \uC5C6\uB294 \uD504\uB85C\uC81D\uD2B8\uB294 \uADDC\uCE59 \uBC16\uC5D0 \uC788\uB2E4. \uB77C\uC774\uBE0C\uB7EC\uB9AC\uB97C \uB9CC\uB4E4 \uB54C\uB294 \uBC14\uB85C \uC790\uAE30 \uCABD \uD0DC\uADF8\uB97C \uBD99\uC778\uB2E4:",
+        `  \`nx g @nx/js:lib libs/<name> --tags=${shared}\` (\uD504\uB860\uD2B8\uC5D4\uB4DC \uC804\uC6A9\uC774\uBA74 \`${frontend}\`, \uBC31\uC5D4\uB4DC \uC804\uC6A9\uC774\uBA74 \`${backend}\`).`,
+        `import\uB97C \uD1B5\uACFC\uC2DC\uD0A4\uB824\uACE0 \uD0DC\uADF8\uB97C \uC9C0\uC6B0\uAC70\uB098 \`depConstraints\`\uB97C \uB290\uC2A8\uD558\uAC8C \uD558\uC9C0 \uC54A\uB294\uB2E4. \uD568\uAED8 \uC4F0\uB294 \uCF54\uB4DC\uB294 \`${shared}\``,
+        "\uB77C\uC774\uBE0C\uB7EC\uB9AC\uB85C \uC62E\uAE34\uB2E4."
+      ].join("\n")
+    };
+  }
+  return {
+    id: "module-boundaries",
+    heading: "Module Boundaries",
+    body: [
+      "The root ESLint config's `@nx/enforce-module-boundaries` rule keeps the frontend and the backend apart by project tag:",
+      `- \`${frontend}\` projects never import \`${backend}\` projects, and the other way round.`,
+      `- \`${shared}\` projects (such as the shared-types library) import neither side.`,
+      "- A project with none of these tags is outside the rule. When you create a library, give it its side right away:",
+      `  \`nx g @nx/js:lib libs/<name> --tags=${shared}\` (\`${frontend}\` or \`${backend}\` for code only one side uses).`,
+      `Never remove a tag or loosen the \`depConstraints\` to make an import pass; move the shared code into a \`${shared}\``,
+      "library instead."
+    ].join("\n")
+  };
+}
+
+// ../template-engine/dist/agent-rules/compose-agent-rules.js
+function resolveDefaultAgentSectionIds(teamRules, fsdStructure = false) {
+  let ids = [...DEFAULT_AGENT_SECTION_IDS];
+  const insertAfter = (anchorId, id) => {
+    const anchor = ids.indexOf(anchorId);
+    if (anchor === -1) {
+      throw new Error(`composeAgentRules: the default composition no longer contains ${anchorId}`);
+    }
+    ids = [...ids.slice(0, anchor + 1), id, ...ids.slice(anchor + 1)];
+  };
+  if (fsdStructure)
+    insertAfter("code-structure", FSD_AGENT_SECTION_ID);
+  if (teamRules)
+    insertAfter("language-policy", TEAM_AGENT_SECTION_ID);
+  return ids;
+}
+function renderSections(sections) {
+  return `${sections.map((section) => `## ${section.heading}
+
+${section.body}`).join("\n\n")}
+`;
+}
+function composeAgentRules(input) {
+  const sectionIds = input.sections ?? resolveDefaultAgentSectionIds(input.teamRules ?? false, input.fsdStructure ?? false);
+  const notes = input.fsdPolicy === void 0 ? "" : buildFsdPolicyNotes(input.locale, input.fsdPolicy);
+  const sections = sectionIds.map((id) => {
+    const section = AGENT_RULE_SECTIONS[input.locale][id];
+    return id === FSD_AGENT_SECTION_ID && notes !== "" ? { ...section, body: `${section.body}
+
+${notes}` } : section;
+  });
+  if (input.moduleBoundaries !== void 0 && input.sections === void 0) {
+    const anchor = sections.findIndex((section) => section.id === FSD_AGENT_SECTION_ID);
+    const at = (anchor === -1 ? sections.findIndex((section) => section.id === "code-structure") : anchor) + 1;
+    sections.splice(at, 0, buildModuleBoundariesSection(input.locale, input.moduleBoundaries));
+  }
+  const content = renderSections(sections);
+  return input.files.map((filePath) => ({ filePath, content }));
+}
+
+// ../template-engine/dist/agent-rules/validate-agent-rules.js
+var LOCALES = ["en", "ko"];
+function headingsFor(id) {
+  return LOCALES.map((locale) => `## ${AGENT_RULE_SECTIONS[locale][id].heading}`);
+}
+var REQUIRED_SECTION_IDS = ["safety-rules", "language-policy"];
+function validateAgentRules(content, extraRequired = []) {
+  return [...REQUIRED_SECTION_IDS, ...extraRequired].every((id) => headingsFor(id).some((heading) => content.includes(heading)));
+}
+
+// ../template-engine/dist/agent-rules/marker-block.js
+import { createHash } from "node:crypto";
+var AGENT_RULES_BLOCK_START = "<!-- nx-archweave:agent-rules start -->";
+var AGENT_RULES_BLOCK_END = "<!-- nx-archweave:agent-rules end -->";
+var START_MARKER = /<!-- nx-archweave:agent-rules start(?: hash=([0-9a-f]{12}))? -->/g;
+function normalizeForHash(text) {
+  return text.replace(/\r\n/g, "\n").replace(/[ \t]+$/gm, "");
+}
+function hashOf(body) {
+  return createHash("sha256").update(normalizeForHash(body)).digest("hex").slice(0, 12);
+}
+function withFinalNewline(body) {
+  return body.endsWith("\n") ? body : `${body}
+`;
+}
+function renderAgentRulesBlock(body, eol = "\n") {
+  const content = withFinalNewline(normalizeForHash(body));
+  const lines = `<!-- nx-archweave:agent-rules start hash=${hashOf(content)} -->
+${content}${AGENT_RULES_BLOCK_END}`;
+  return eol === "\n" ? lines : lines.replace(/\r?\n/g, eol);
+}
+function countOf(text, needle) {
+  return text.split(needle).length - 1;
+}
+function applyAgentRulesBlock(existing, body, options = {}) {
+  if (existing === null || existing.length === 0)
+    return { kind: "create", text: `${renderAgentRulesBlock(body)}
+` };
+  const eol = existing.includes("\r\n") ? "\r\n" : "\n";
+  const block = renderAgentRulesBlock(body, eol);
+  const starts = [...existing.matchAll(START_MARKER)];
+  const ends = countOf(existing, AGENT_RULES_BLOCK_END);
+  if (starts.length === 0 && ends === 0) {
+    const head = existing.endsWith("\n") ? existing : `${existing}${eol}`;
+    return { kind: "append", text: `${head}${eol}${block}${eol}` };
+  }
+  if (starts.length !== 1 || ends !== 1) {
+    return {
+      kind: "unrecognized",
+      reason: `expected one ${AGENT_RULES_BLOCK_START} \u2026 ${AGENT_RULES_BLOCK_END} pair, found ${starts.length} start and ${ends} end marker(s)`
+    };
+  }
+  const startMatch = starts[0];
+  const start = startMatch.index ?? 0;
+  const end = existing.indexOf(AGENT_RULES_BLOCK_END);
+  if (end < start)
+    return { kind: "unrecognized", reason: "the end marker comes before the start marker" };
+  const text = existing.slice(0, start) + block + existing.slice(end + AGENT_RULES_BLOCK_END.length);
+  if (text === existing)
+    return { kind: "unchanged" };
+  const bodyStart = start + startMatch[0].length + (existing.startsWith("\r\n", start + startMatch[0].length) ? 2 : 1);
+  const existingBody = normalizeForHash(existing.slice(bodyStart, end));
+  const generatedBody = withFinalNewline(normalizeForHash(body));
+  const recordedHash = startMatch[1];
+  const untouched = recordedHash !== void 0 ? hashOf(existingBody) === recordedHash : existingBody === generatedBody;
+  if (!untouched && options.overwrite !== true)
+    return { kind: "user-modified", existingBody, generatedBody };
+  return { kind: "replace", text };
+}
+
+// src/generators/add-agent-rules/render.ts
+var ACTION_LINE = {
+  created: (result) => `${result.filePath}: created`,
+  appended: (result) => `${result.filePath}: nx-archweave block added after the existing content (nothing else changed)`,
+  updated: (result) => `${result.filePath}: nx-archweave block updated (nothing outside it changed)`,
+  unchanged: (result) => `${result.filePath}: unchanged`,
+  unrecognized: (result) => `${result.filePath}: not written \u2014 ${result.reason ?? "the nx-archweave markers could not be placed"}`,
+  "user-modified": (result) => `${result.filePath}: not written \u2014 the nx-archweave block was edited by hand, so it is kept`
+};
+function renderAddAgentRulesReport(report) {
+  const lines = [];
+  lines.push(report.dryRun ? "add-agent-rules dry-run \u2014 no files were written." : "add-agent-rules:");
+  lines.push(`  hosts: ${report.hosts.join(", ")}`);
+  lines.push(`  locale: ${report.locale}`);
+  lines.push(`  teamRules: ${report.teamRules}`);
+  lines.push("");
+  for (const file of report.files) {
+    lines.push(`  ${ACTION_LINE[file.action](file)}`);
+    if (file.action === "user-modified") {
+      lines.push("    What this run would write instead (your block \u2192 generated):");
+      for (const line of (file.diff ?? "").split("\n")) lines.push(`    ${line}`);
+      lines.push("    Rerun with --overwriteBlock to replace the block with the generated one.");
+    }
+  }
+  const RECORD_LINE = {
+    created: "toolkit.config.json: aiHosts recorded (file created)",
+    updated: "toolkit.config.json: aiHosts recorded",
+    unchanged: "toolkit.config.json: aiHosts already recorded",
+    unrecognized: "toolkit.config.json: not a JSON object \u2014 aiHosts not recorded (fix the file, then rerun)",
+    "not-applied": "toolkit.config.json: aiHosts not recorded \u2014 a file above was not written",
+    "not-requested": null
+  };
+  const recordLine = RECORD_LINE[report.hostsRecord];
+  if (recordLine !== null) lines.push(`  ${recordLine}`);
+  if (report.files.some((file) => file.action === "unrecognized")) {
+    lines.push("");
+    lines.push('Manual fix needed: keep exactly one "<!-- nx-archweave:agent-rules start \u2026 -->" \u2026 "<!-- nx-archweave:agent-rules end -->"');
+    lines.push("pair in the file (or remove both markers), then rerun add-agent-rules.");
+  }
+  if (report.dryRun) {
+    lines.push("");
+    lines.push("Generated content preview:");
+    for (const file of report.files) {
+      if (file.content === null) continue;
+      lines.push("");
+      lines.push(`--- ${file.filePath} ---`);
+      lines.push(file.content);
+    }
+  }
+  return lines.join("\n");
+}
+
+// src/generators/add-agent-rules/generator.ts
+function resolveTeamRules(option, config) {
+  if (option !== void 0) return option;
+  const agentRules = config?.["agentRules"];
+  const teamRules = typeof agentRules === "object" && agentRules !== null ? agentRules["teamRules"] : void 0;
+  return typeof teamRules === "boolean" ? teamRules : false;
+}
+function resolveFsdStructure(config) {
+  const fsd = config?.["fsd"];
+  const enabled = typeof fsd === "object" && fsd !== null ? fsd["enabled"] : void 0;
+  if (typeof enabled === "boolean") return enabled;
+  const frontend = config?.["frontend"];
+  return typeof frontend === "string" && frontend !== "none";
+}
+function resolveModuleBoundaries(config) {
+  const backend = config?.["backend"];
+  return backend === "express" || backend === "nest" ? readBoundaryTags(config) : void 0;
+}
+var POLICY_KEYS = ["preset", "sliceGroups", "sharedPublicApi", "testFiles"];
+function resolveFsdPolicyNotes(config) {
+  const fsd = config?.["fsd"];
+  if (typeof fsd !== "object" || fsd === null || !POLICY_KEYS.some((key) => key in fsd)) return void 0;
+  const policy = resolveFsdPolicy(fsd);
+  return { sliceGroups: policy.sliceGroups !== false, sharedPublicApi: policy.sharedPublicApi, testFiles: policy.testFiles !== false };
+}
+function runAddAgentRules(tree, options, { recordHosts = true, fsdStructure, moduleBoundaries } = {}) {
+  const config = readToolkitConfig(tree);
+  const hosts = resolveAiHostsOption(options.hosts, config);
+  const files = rulesFilesFor(hosts);
+  const locale = resolveLocaleOption(options.locale, config);
+  const teamRules = resolveTeamRules(options.teamRules, config);
+  const dryRun = options.dryRun ?? false;
+  const boundaries = moduleBoundaries === void 0 ? resolveModuleBoundaries(config) : moduleBoundaries ?? void 0;
+  const composed = composeAgentRules({
+    files,
+    locale,
+    teamRules,
+    fsdStructure: fsdStructure ?? resolveFsdStructure(config),
+    fsdPolicy: resolveFsdPolicyNotes(config),
+    ...boundaries !== void 0 ? { moduleBoundaries: boundaries } : {}
+  });
+  const results = composed.map(({ filePath, content }) => {
+    if (!validateAgentRules(content, teamRules ? ["team-rules"] : [])) {
+      throw new Error(
+        `Generated ${filePath} is missing a required section (Safety Rules, Language Policy${teamRules ? ", Team Rules" : ""})`
+      );
+    }
+    const existing = tree.read(filePath, "utf-8");
+    const outcome = applyAgentRulesBlock(existing, content, { overwrite: options.overwriteBlock === true });
+    switch (outcome.kind) {
+      case "unchanged":
+        return { filePath, action: "unchanged", reason: null, content: null };
+      case "unrecognized":
+        return { filePath, action: "unrecognized", reason: outcome.reason, content: null };
+      case "user-modified":
+        return {
+          filePath,
+          action: "user-modified",
+          reason: null,
+          content: null,
+          diff: renderLineDiff(outcome.existingBody, outcome.generatedBody)
+        };
+      case "create":
+      case "append":
+      case "replace": {
+        if (!dryRun) tree.write(filePath, outcome.text);
+        const action = outcome.kind === "create" ? "created" : outcome.kind === "append" ? "appended" : "updated";
+        return { filePath, action, reason: null, content: dryRun ? outcome.text : null };
+      }
+    }
+  });
+  const explicit = options.hosts !== void 0 && options.hosts.length > 0;
+  const allApplied = results.every((file) => file.action !== "unrecognized");
+  const hostsRecord = explicit && recordHosts ? allApplied ? recordAiHosts(tree, hosts, !dryRun) : "not-applied" : "not-requested";
+  return { dryRun, locale, hosts, teamRules, files: results, hostsRecord };
+}
+async function addAgentRulesGenerator(tree, options) {
+  console.log(renderAddAgentRulesReport(runAddAgentRules(tree, { ...options, dryRun: resolveDryRun(options) })));
+}
+var generator_default = addAgentRulesGenerator;
+
+export {
+  renderAddAgentRulesReport,
+  runAddAgentRules,
+  addAgentRulesGenerator,
+  generator_default
+};