refactor(agents): extract agents-template-path leaf module (#136)

Break application ↔ agents-init import cycle by moving resolveAgentsTemplateDir to a leaf module. Re-export preserved; docs + boundary verification kit added.

Author: SutuSebastian

docs/agents.md

@@ -170,6 +170,7 @@ Warning goes to stderr only so `codemap skill > file.md` stays clean.
 
 | Source                                     | Role                                                                                                                                                                                                                                                                             |
 | ------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **`src/agents-template-path.ts`**          | **`resolveAgentsTemplateDir()`** — leaf bundled `templates/agents/` resolver; shared by init and `application/*` live-fetch without import cycles.                                                                                                                               |
 | **`src/agents-init-targets.ts`**           | **`AgentsInitTarget`** + symlink-style integration ids — shared by init and MCP registry without import cycles.                                                                                                                                                                  |
 | **`src/agents-init.ts`**                   | **`runAgentsInit`**, **`upsertCodemapPointerFile`**, **`listRegularFilesRecursive`**, **`applyAgentsInitTargets`** (per-file **`copyFileSync`** / **`symlinkFilesGranular`**), **`ensureGitignoreCodemapPattern`** (writes `<state-dir>/.gitignore`), **`targetsNeedLinkMode`**. |
 | **`src/agents-init-mcp-registry.ts`**      | **`AGENTS_INIT_MCP_REGISTRY`** — paths, formats, defaults, docs URLs (source of truth for the MCP table below).                                                                                                                                                                  |

docs/architecture.md

@@ -17,12 +17,12 @@ import {
   ensureGitignoreCodemapPattern,
   listRegularFilesRecursive,
   relPathToAbsSegments,
-  resolveAgentsTemplateDir,
   runAgentsInit,
   targetsNeedLinkMode,
   upsertCodemapPointerFile,
 } from "./agents-init";
 import { CODEMAP_MCP_PERMISSION_ALLOW } from "./agents-init-mcp";
+import { resolveAgentsTemplateDir } from "./agents-template-path";
 import {
   buildHookBlock,
   isCodemapHookInstalled,

src/agents-init.test.ts

@@ -10,25 +10,15 @@ import {
   writeFileSync,
 } from "node:fs";
 import { dirname, join, relative } from "node:path";
-import { fileURLToPath } from "node:url";
 
 import { applyAgentsInitMcp } from "./agents-init-mcp";
 import { resolveAgentsInitMcpTargets } from "./agents-init-mcp-registry";
 import type { AgentsInitTarget } from "./agents-init-targets";
+import { resolveAgentsTemplateDir } from "./agents-template-path";
 import { installGitHooks, uninstallGitHooks } from "./application/git-hooks";
 import { ensureStateGitignore, resolveStateDir } from "./application/state-dir";
 
-/**
- * Directory containing `rules/` and `skills/` (next to `dist/` in published packages).
- */
-export function resolveAgentsTemplateDir(): string {
-  return join(
-    dirname(fileURLToPath(import.meta.url)),
-    "..",
-    "templates",
-    "agents",
-  );
-}
+export { resolveAgentsTemplateDir } from "./agents-template-path";
 
 /**
  * Every regular file path under `dir` relative to `dir` (POSIX-style `/`).

src/agents-init.ts

@@ -0,0 +1,16 @@
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+/**
+ * Bundled `templates/agents/` path — shared by `agents init` and
+ * `application/*` live-fetch surfaces. Leaf module avoids
+ * `application → agents-init → application` import cycles.
+ */
+export function resolveAgentsTemplateDir(): string {
+  return join(
+    dirname(fileURLToPath(import.meta.url)),
+    "..",
+    "templates",
+    "agents",
+  );
+}

src/agents-template-path.ts

@@ -16,7 +16,7 @@
 import { existsSync, readdirSync, readFileSync } from "node:fs";
 import { join } from "node:path";
 
-import { resolveAgentsTemplateDir } from "../agents-init";
+import { resolveAgentsTemplateDir } from "../agents-template-path";
 import { createTables } from "../db";
 import { openCodemapDatabase } from "../sqlite-db";
 import { listQueryRecipeCatalog } from "./query-recipes";

src/application/agent-content.ts

@@ -1,7 +1,7 @@
 import { existsSync, statSync } from "node:fs";
 import { join } from "node:path";
 
-import { resolveAgentsTemplateDir } from "../agents-init";
+import { resolveAgentsTemplateDir } from "../agents-template-path";
 import { getProjectRoot, getStateDir } from "../runtime";
 import { loadAllRecipes } from "./recipes-loader";
 import type { LoadedRecipe } from "./recipes-loader";