@warlock.js/core 5.31.0 → 5.32.0

package/esm/tooling/agents-md/installed-skills.d.mts

@@ -1,14 +1,19 @@
 //#region ../../packages/core/src/tooling/agents-md/installed-skills.d.ts
 /** One `SKILL.md` an installed `@warlock.js/*` package ships. */
-type InstalledSkill = {
-  /** The package, e.g. `@warlock.js/core`. */package: string; /** The skill folder name, e.g. `warlock-inspect`. */
-  slug: string; /** The `name` from the front matter (the slug when absent). */
-  name: string; /** The full `description` from the front matter (empty when absent). */
-  description: string; /** Project-relative POSIX path of the `SKILL.md`. */
+export type InstalledSkill = {
+  /** The package, e.g. `@warlock.js/core`. */
+  package: string;
+  /** The skill folder name, e.g. `warlock-inspect`. */
+  slug: string;
+  /** The `name` from the front matter (the slug when absent). */
+  name: string;
+  /** The full `description` from the front matter (empty when absent). */
+  description: string;
+  /** Project-relative POSIX path of the `SKILL.md`. */
   file: string;
 };
 /** The `name` and `description` of a `SKILL.md`'s front matter. */
-declare function parseSkillFrontMatter(content: string): {
+export declare function parseSkillFrontMatter(content: string): {
   name?: string;
   description?: string;
 };
@@ -16,7 +21,7 @@ declare function parseSkillFrontMatter(content: string): {
  * The first sentence of a skill description, capped at `max` characters —
  * the one line an agent reads to decide whether to open the skill.
  */
-declare function shortSkillLine(description: string, max?: number): string;
+export declare function shortSkillLine(description: string, max?: number): string;
 /**
  * Every skill the installed `@warlock.js/*` packages ship, read from
  * `<cwd>/node_modules/@warlock.js/<package>/skills/<slug>/SKILL.md`.
@@ -24,7 +29,6 @@ declare function shortSkillLine(description: string, max?: number): string;
  *
  * @param cwd The project root.
  */
-declare function listInstalledSkills(cwd: string): InstalledSkill[];
+export declare function listInstalledSkills(cwd: string): InstalledSkill[];
 //#endregion
-export { InstalledSkill, listInstalledSkills, parseSkillFrontMatter, shortSkillLine };
 //# sourceMappingURL=installed-skills.d.mts.map

package/esm/tooling/agents-md/installed-skills.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"installed-skills.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/agents-md/installed-skills.ts"],"mappings":";;KAIY,cAAA;EAAc,4CAExB,OAAA,UAFwB;EAIxB,IAAA;EAEA,IAAA,UAEA;EAAA,WAAA,UAEI;EAAJ,IAAA;AAAA;;iBAiCc,qBAAA,CAAsB,OAAA;EAAoB,IAAA;EAAe,WAAA;AAAA;;;AAAW;AAepF;iBAAgB,cAAA,CAAe,WAAA,UAAqB,GAAS;;;AAAA;AAc7D;;;;iBAAgB,mBAAA,CAAoB,GAAA,WAAc,cAAc"}
+{"version":3,"file":"installed-skills.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/agents-md/installed-skills.ts"],"mappings":";;YAIY;;EAEV;;EAEA;;EAEA;;EAEA;;EAEA;;;wBAiCc,sBAAsB;EAAoB;EAAe;;;;;;wBAezD,eAAe,qBAAqB;;;;;;;;wBAcpC,oBAAoB,cAAc"}

package/esm/tooling/agents-md/render-agents-md.d.mts

@@ -1,11 +1,13 @@
 import { InspectReport } from "../inspect/inspect-report.types.mjs";
 import { InstalledSkill } from "./installed-skills.mjs";
-
 //#region ../../packages/core/src/tooling/agents-md/render-agents-md.d.ts
 /** Options of {@link renderAgentsMdSection}. */
-type RenderAgentsMdOptions = {
-  /** Installed skills to list (see `listInstalledSkills`). Default: none listed. */skills?: readonly InstalledSkill[]; /** Module folder names under `src/app` (see `listAppModules`); merged with the ones routes and models name. */
-  modules?: readonly string[]; /** How many routes the compact list shows before pointing at `warlock inspect`. Default: 60. */
+export type RenderAgentsMdOptions = {
+  /** Installed skills to list (see `listInstalledSkills`). Default: none listed. */
+  skills?: readonly InstalledSkill[];
+  /** Module folder names under `src/app` (see `listAppModules`); merged with the ones routes and models name. */
+  modules?: readonly string[];
+  /** How many routes the compact list shows before pointing at `warlock inspect`. Default: 60. */
   maxRoutes?: number;
 };
 /**
@@ -13,7 +15,7 @@ type RenderAgentsMdOptions = {
  *
  * @param cwd The project root.
  */
-declare function listAppModules(cwd: string): string[];
+export declare function listAppModules(cwd: string): string[];
 /**
  * Render the app-specific AGENTS.md section from an inspect report: the app
  * and its Warlock packages, modules, a routes summary (unguarded writes
@@ -27,7 +29,6 @@ declare function listAppModules(cwd: string): string[];
  * @param report An `inspectApp()` report (routes, models and packages are read when present).
  * @param options Skills and module folders to include.
  */
-declare function renderAgentsMdSection(report: InspectReport, options?: RenderAgentsMdOptions): string;
+export declare function renderAgentsMdSection(report: InspectReport, options?: RenderAgentsMdOptions): string;
 //#endregion
-export { RenderAgentsMdOptions, listAppModules, renderAgentsMdSection };
 //# sourceMappingURL=render-agents-md.d.mts.map

package/esm/tooling/agents-md/render-agents-md.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"render-agents-md.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/agents-md/render-agents-md.ts"],"mappings":";;;;;KAMY,qBAAA;EAAA,kFAEV,MAAA,YAAkB,cAAc;EAEhC,OAAA,sBAFA;EAIA,SAAA;AAAA;;;AAAS;AAcX;;iBAAgB,cAAA,CAAe,GAAW;;AAAA;AAqO1C;;;;;;;;;AAEqC;;iBAFrB,qBAAA,CACd,MAAA,EAAQ,aAAA,EACR,OAAA,GAAS,qBAA0B"}
+{"version":3,"file":"render-agents-md.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/agents-md/render-agents-md.ts"],"mappings":";;;;YAMY;;EAEV,kBAAkB;;EAElB;;EAEA;;;;;;;wBAcc,eAAe;;;;;;;;;;;;;;wBAqOf,sBACd,QAAQ,eACR,UAAS"}

package/esm/tooling/agents-md/render-agents-md.mjs

@@ -4,7 +4,7 @@ import { readdirSync } from "node:fs";
 
 //#region ../../packages/core/src/tooling/agents-md/render-agents-md.ts
 /** Methods that change state; one of these without an auth guard is flagged. */
-const MUTATING_METHODS = new Set([
+const MUTATING_METHODS = /* @__PURE__ */ new Set([
 	"POST",
 	"PUT",
 	"PATCH",
@@ -67,7 +67,7 @@ function modulesSection(report, extra) {
 		const module = moduleOf(model.sourceFile);
 		if (module) modelCounts.set(module, (modelCounts.get(module) ?? 0) + 1);
 	}
-	const modules = [...new Set([
+	const modules = [.../* @__PURE__ */ new Set([
 		...extra,
 		...routeCounts.keys(),
 		...modelCounts.keys()

package/esm/tooling/agents-md/render-agents-md.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"render-agents-md.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/agents-md/render-agents-md.ts"],"sourcesContent":["import { readdirSync } from \"node:fs\";\nimport path from \"node:path\";\nimport type { InspectReport, InspectRoute } from \"../inspect/inspect-report.types\";\nimport { type InstalledSkill, shortSkillLine } from \"./installed-skills\";\n\n/** Options of {@link renderAgentsMdSection}. */\nexport type RenderAgentsMdOptions = {\n  /** Installed skills to list (see `listInstalledSkills`). Default: none listed. */\n  skills?: readonly InstalledSkill[];\n  /** Module folder names under `src/app` (see `listAppModules`); merged with the ones routes and models name. */\n  modules?: readonly string[];\n  /** How many routes the compact list shows before pointing at `warlock inspect`. Default: 60. */\n  maxRoutes?: number;\n};\n\n/** Methods that change state; one of these without an auth guard is flagged. */\nconst MUTATING_METHODS = new Set([\"POST\", \"PUT\", \"PATCH\", \"DELETE\"]);\n\n/** Fixed method order for the per-method counts. */\nconst METHOD_ORDER = [\"GET\", \"POST\", \"PUT\", \"PATCH\", \"DELETE\", \"HEAD\", \"OPTIONS\"];\n\n/**\n * The module folders under `<cwd>/src/app`, sorted. Empty when there is none.\n *\n * @param cwd The project root.\n */\nexport function listAppModules(cwd: string): string[] {\n  try {\n    return readdirSync(path.join(cwd, \"src\", \"app\"), { withFileTypes: true })\n      .filter((entry) => entry.isDirectory())\n      .map((entry) => entry.name)\n      .sort();\n  } catch {\n    return [];\n  }\n}\n\n/** The module a project-relative source path belongs to (`src/app/<module>/…`). */\nfunction moduleOf(file: string | null): string | undefined {\n  return file ? /^src\\/app\\/([^/]+)\\//.exec(file.split(\"\\\\\").join(\"/\"))?.[1] : undefined;\n}\n\nfunction compare(first: string, second: string): number {\n  return first < second ? -1 : first > second ? 1 : 0;\n}\n\nfunction isUnguardedWrite(route: InspectRoute): boolean {\n  return MUTATING_METHODS.has(route.method.toUpperCase()) && !route.auth.required && !route.isPage;\n}\n\nfunction routeLine(route: InspectRoute): string {\n  const guard = route.auth.required ? \" [auth]\" : \"\";\n  const name = route.name ? ` ${route.name}` : \"\";\n\n  return `- \\`${route.method} ${route.path}\\`${guard}${name}`;\n}\n\nfunction sortRoutes(routes: readonly InspectRoute[]): InspectRoute[] {\n  return [...routes].sort(\n    (first, second) =>\n      compare(first.path, second.path) ||\n      METHOD_ORDER.indexOf(first.method) - METHOD_ORDER.indexOf(second.method) ||\n      compare(first.method, second.method),\n  );\n}\n\nfunction appSection(report: InspectReport): string[] {\n  const name = report.app.name ?? \"This app\";\n  const version = report.app.version ? ` ${report.app.version}` : \"\";\n  const lines = [`## ${name}${version} — generated facts`, \"\"];\n  const packages = [...(report.packages ?? [])].sort((first, second) =>\n    compare(first.name, second.name),\n  );\n\n  if (packages.length > 0) {\n    lines.push(\n      `Warlock packages: ${packages.map((entry) => `\\`${entry.name}@${entry.version}\\``).join(\", \")}.`,\n      \"\",\n    );\n  }\n\n  return lines;\n}\n\nfunction modulesSection(report: InspectReport, extra: readonly string[]): string[] {\n  const routeCounts = new Map<string, number>();\n  const modelCounts = new Map<string, number>();\n\n  for (const route of report.routes ?? []) {\n    const module = moduleOf(route.sourceFile);\n    if (module) routeCounts.set(module, (routeCounts.get(module) ?? 0) + 1);\n  }\n\n  for (const model of report.models ?? []) {\n    const module = moduleOf(model.sourceFile);\n    if (module) modelCounts.set(module, (modelCounts.get(module) ?? 0) + 1);\n  }\n\n  const modules = [...new Set([...extra, ...routeCounts.keys(), ...modelCounts.keys()])].sort();\n\n  if (modules.length === 0) return [];\n\n  return [\n    \"### Modules\",\n    \"\",\n    \"Each lives in `src/app/<module>/`.\",\n    \"\",\n    \"| Module | Routes | Models |\",\n    \"| ------ | ------ | ------ |\",\n    ...modules.map(\n      (module) =>\n        `| \\`${module}\\` | ${routeCounts.get(module) ?? 0} | ${modelCounts.get(module) ?? 0} |`,\n    ),\n    \"\",\n  ];\n}\n\nfunction routesSection(report: InspectReport, maxRoutes: number): string[] {\n  const routes = sortRoutes(report.routes ?? []);\n\n  if (routes.length === 0) return [];\n\n  const counts = new Map<string, number>();\n\n  for (const route of routes) {\n    counts.set(route.method, (counts.get(route.method) ?? 0) + 1);\n  }\n\n  const methods = [...counts.keys()].sort(\n    (first, second) =>\n      (METHOD_ORDER.indexOf(first) + 1 || 99) - (METHOD_ORDER.indexOf(second) + 1 || 99) ||\n      compare(first, second),\n  );\n  const unguarded = routes.filter(isUnguardedWrite);\n  const lines = [\n    \"### Routes\",\n    \"\",\n    `${routes.length} route(s): ${methods.map((method) => `${counts.get(method) ?? 0} ${method}`).join(\", \")}.`,\n    \"\",\n  ];\n\n  if (unguarded.length > 0) {\n    lines.push(\n      `Mutating routes without an auth guard (confirm each is meant to be public): ${unguarded\n        .map((route) => `\\`${route.method} ${route.path}\\``)\n        .join(\", \")}.`,\n      \"\",\n    );\n  }\n\n  lines.push(...routes.slice(0, maxRoutes).map(routeLine));\n\n  if (routes.length > maxRoutes) {\n    lines.push(\n      `- +${routes.length - maxRoutes} more — run \\`npx warlock inspect --json --section routes\\``,\n    );\n  }\n\n  lines.push(\"\");\n\n  return lines;\n}\n\nfunction modelsSection(report: InspectReport): string[] {\n  const models = [...(report.models ?? [])].sort((first, second) =>\n    compare(first.name, second.name),\n  );\n\n  if (models.length === 0) return [];\n\n  return [\n    \"### Models\",\n    \"\",\n    ...models.map((model) => {\n      const module = moduleOf(model.sourceFile);\n      const table = model.table ? ` → \\`${model.table}\\`` : \"\";\n\n      return `- \\`${model.name}\\`${table}${module ? ` (module \\`${module}\\`)` : \"\"}`;\n    }),\n    \"\",\n  ];\n}\n\n/** The rules `warlock check` enforces (WL9001–WL9012) and the layout every skill assumes. */\nconst CONVENTIONS = [\n  \"- Features live in `src/app/<module>/`; flow is one-way: `routes.ts` → controllers → services → repositories → models. Resources only map output.\",\n  \"- Never import auto-loaded files: `src/app/main.ts`, `src/app/<module>/routes.ts`, `main.ts`, `worker.ts`, `events/*.ts` (`WL9001`).\",\n  \"- No `.js` extensions in import paths (`WL9002`).\",\n  \"- Cross-module imports use the `app/<module>/...` alias, not `../../` (`WL9003`); relative paths stay inside a module.\",\n  '- Cascade uses standard decorators: never set `\"experimentalDecorators\": true` (`WL9004`).',\n  \"- Controllers are thin and read input with `request.validated()`, never `request.all()` (`WL9005`); schemas live in `schema/<action>.schema.ts` and export the value and its `Infer` type. One controller per file (`WL9011`).\",\n  \"- Every POST/PUT/PATCH/DELETE route is inside `guarded()` (or has auth middleware) or says `public: true` (`WL9006`).\",\n  \"- Redirect targets from request input go through `safeRedirect()` / `safeRedirectTarget()` (`WL9007`); logs never carry raw emails, credentials or request bodies (`WL9008`); regexes run on request input have bounded quantifiers (`WL9009`).\",\n  \"- Import each API from its home package: `v` from `@warlock.js/seal`, `Model` from `@warlock.js/cascade`, `router` from `@warlock.js/core`.\",\n];\n\nfunction skillsSection(skills: readonly InstalledSkill[]): string[] {\n  if (skills.length === 0) return [];\n\n  const byPackage = new Map<string, InstalledSkill[]>();\n\n  for (const skill of skills) {\n    byPackage.set(skill.package, [...(byPackage.get(skill.package) ?? []), skill]);\n  }\n\n  const lines = [\n    \"### Skills\",\n    \"\",\n    \"Installed with the packages, at `node_modules/<package>/skills/<slug>/SKILL.md`. Read the matching one before changing that area.\",\n    \"\",\n  ];\n\n  for (const packageName of [...byPackage.keys()].sort()) {\n    lines.push(`**${packageName}**`, \"\");\n\n    const entries = [...(byPackage.get(packageName) ?? [])].sort((first, second) =>\n      compare(first.slug, second.slug),\n    );\n\n    for (const skill of entries) {\n      const line = shortSkillLine(skill.description);\n\n      lines.push(`- \\`${skill.slug}\\`${line ? ` — ${line}` : \"\"}`);\n    }\n\n    lines.push(\"\");\n  }\n\n  return lines;\n}\n\nconst VERIFY = [\n  \"### Verify a change\",\n  \"\",\n  \"- `npx warlock check --changed --json` — typecheck, lint, affected tests and conventions; exit 1 = your code, 2 = this machine.\",\n  \"- `npx warlock inspect --json` — routes, models, config keys, events, pages, jobs from the booted app.\",\n  \"- `npx warlock explain <code>` — what a `WLxxxx` code means and how to fix it.\",\n  \"- `npx warlock trace <method> <url> --json` — send a request to the running `warlock dev` and print its devtools timeline.\",\n  \"- `npx warlock mcp` — the same facts and actions as an MCP server.\",\n  \"\",\n];\n\n/**\n * Render the app-specific AGENTS.md section from an inspect report: the app\n * and its Warlock packages, modules, a routes summary (unguarded writes\n * flagged), models, the conventions `warlock check` enforces, the installed\n * skills and the verify commands.\n *\n * Deterministic: no timestamps and stable ordering, so regenerating an\n * unchanged app yields the same bytes and `writeAgentsMd` writes nothing.\n * Returned without the markers.\n *\n * @param report An `inspectApp()` report (routes, models and packages are read when present).\n * @param options Skills and module folders to include.\n */\nexport function renderAgentsMdSection(\n  report: InspectReport,\n  options: RenderAgentsMdOptions = {},\n): string {\n  const lines = [\n    \"<!-- Generated by `warlock agents-md` and refreshed by `warlock dev`. Write your own notes outside the warlock:generated markers; everything between them is replaced. -->\",\n    \"\",\n    ...appSection(report),\n    ...modulesSection(report, options.modules ?? []),\n    ...routesSection(report, options.maxRoutes ?? 60),\n    ...modelsSection(report),\n    \"### Conventions in force\",\n    \"\",\n    ...CONVENTIONS,\n    \"\",\n    ...skillsSection(options.skills ?? []),\n    ...VERIFY,\n  ];\n\n  return `${lines.join(\"\\n\").replace(/\\n+$/, \"\")}\\n`;\n}\n"],"mappings":"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"}
+{"version":3,"file":"render-agents-md.mjs","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/agents-md/render-agents-md.ts"],"sourcesContent":["import { readdirSync } from \"node:fs\";\nimport path from \"node:path\";\nimport type { InspectReport, InspectRoute } from \"../inspect/inspect-report.types\";\nimport { type InstalledSkill, shortSkillLine } from \"./installed-skills\";\n\n/** Options of {@link renderAgentsMdSection}. */\nexport type RenderAgentsMdOptions = {\n  /** Installed skills to list (see `listInstalledSkills`). Default: none listed. */\n  skills?: readonly InstalledSkill[];\n  /** Module folder names under `src/app` (see `listAppModules`); merged with the ones routes and models name. */\n  modules?: readonly string[];\n  /** How many routes the compact list shows before pointing at `warlock inspect`. Default: 60. */\n  maxRoutes?: number;\n};\n\n/** Methods that change state; one of these without an auth guard is flagged. */\nconst MUTATING_METHODS = new Set([\"POST\", \"PUT\", \"PATCH\", \"DELETE\"]);\n\n/** Fixed method order for the per-method counts. */\nconst METHOD_ORDER = [\"GET\", \"POST\", \"PUT\", \"PATCH\", \"DELETE\", \"HEAD\", \"OPTIONS\"];\n\n/**\n * The module folders under `<cwd>/src/app`, sorted. Empty when there is none.\n *\n * @param cwd The project root.\n */\nexport function listAppModules(cwd: string): string[] {\n  try {\n    return readdirSync(path.join(cwd, \"src\", \"app\"), { withFileTypes: true })\n      .filter((entry) => entry.isDirectory())\n      .map((entry) => entry.name)\n      .sort();\n  } catch {\n    return [];\n  }\n}\n\n/** The module a project-relative source path belongs to (`src/app/<module>/…`). */\nfunction moduleOf(file: string | null): string | undefined {\n  return file ? /^src\\/app\\/([^/]+)\\//.exec(file.split(\"\\\\\").join(\"/\"))?.[1] : undefined;\n}\n\nfunction compare(first: string, second: string): number {\n  return first < second ? -1 : first > second ? 1 : 0;\n}\n\nfunction isUnguardedWrite(route: InspectRoute): boolean {\n  return MUTATING_METHODS.has(route.method.toUpperCase()) && !route.auth.required && !route.isPage;\n}\n\nfunction routeLine(route: InspectRoute): string {\n  const guard = route.auth.required ? \" [auth]\" : \"\";\n  const name = route.name ? ` ${route.name}` : \"\";\n\n  return `- \\`${route.method} ${route.path}\\`${guard}${name}`;\n}\n\nfunction sortRoutes(routes: readonly InspectRoute[]): InspectRoute[] {\n  return [...routes].sort(\n    (first, second) =>\n      compare(first.path, second.path) ||\n      METHOD_ORDER.indexOf(first.method) - METHOD_ORDER.indexOf(second.method) ||\n      compare(first.method, second.method),\n  );\n}\n\nfunction appSection(report: InspectReport): string[] {\n  const name = report.app.name ?? \"This app\";\n  const version = report.app.version ? ` ${report.app.version}` : \"\";\n  const lines = [`## ${name}${version} — generated facts`, \"\"];\n  const packages = [...(report.packages ?? [])].sort((first, second) =>\n    compare(first.name, second.name),\n  );\n\n  if (packages.length > 0) {\n    lines.push(\n      `Warlock packages: ${packages.map((entry) => `\\`${entry.name}@${entry.version}\\``).join(\", \")}.`,\n      \"\",\n    );\n  }\n\n  return lines;\n}\n\nfunction modulesSection(report: InspectReport, extra: readonly string[]): string[] {\n  const routeCounts = new Map<string, number>();\n  const modelCounts = new Map<string, number>();\n\n  for (const route of report.routes ?? []) {\n    const module = moduleOf(route.sourceFile);\n    if (module) routeCounts.set(module, (routeCounts.get(module) ?? 0) + 1);\n  }\n\n  for (const model of report.models ?? []) {\n    const module = moduleOf(model.sourceFile);\n    if (module) modelCounts.set(module, (modelCounts.get(module) ?? 0) + 1);\n  }\n\n  const modules = [...new Set([...extra, ...routeCounts.keys(), ...modelCounts.keys()])].sort();\n\n  if (modules.length === 0) return [];\n\n  return [\n    \"### Modules\",\n    \"\",\n    \"Each lives in `src/app/<module>/`.\",\n    \"\",\n    \"| Module | Routes | Models |\",\n    \"| ------ | ------ | ------ |\",\n    ...modules.map(\n      (module) =>\n        `| \\`${module}\\` | ${routeCounts.get(module) ?? 0} | ${modelCounts.get(module) ?? 0} |`,\n    ),\n    \"\",\n  ];\n}\n\nfunction routesSection(report: InspectReport, maxRoutes: number): string[] {\n  const routes = sortRoutes(report.routes ?? []);\n\n  if (routes.length === 0) return [];\n\n  const counts = new Map<string, number>();\n\n  for (const route of routes) {\n    counts.set(route.method, (counts.get(route.method) ?? 0) + 1);\n  }\n\n  const methods = [...counts.keys()].sort(\n    (first, second) =>\n      (METHOD_ORDER.indexOf(first) + 1 || 99) - (METHOD_ORDER.indexOf(second) + 1 || 99) ||\n      compare(first, second),\n  );\n  const unguarded = routes.filter(isUnguardedWrite);\n  const lines = [\n    \"### Routes\",\n    \"\",\n    `${routes.length} route(s): ${methods.map((method) => `${counts.get(method) ?? 0} ${method}`).join(\", \")}.`,\n    \"\",\n  ];\n\n  if (unguarded.length > 0) {\n    lines.push(\n      `Mutating routes without an auth guard (confirm each is meant to be public): ${unguarded\n        .map((route) => `\\`${route.method} ${route.path}\\``)\n        .join(\", \")}.`,\n      \"\",\n    );\n  }\n\n  lines.push(...routes.slice(0, maxRoutes).map(routeLine));\n\n  if (routes.length > maxRoutes) {\n    lines.push(\n      `- +${routes.length - maxRoutes} more — run \\`npx warlock inspect --json --section routes\\``,\n    );\n  }\n\n  lines.push(\"\");\n\n  return lines;\n}\n\nfunction modelsSection(report: InspectReport): string[] {\n  const models = [...(report.models ?? [])].sort((first, second) =>\n    compare(first.name, second.name),\n  );\n\n  if (models.length === 0) return [];\n\n  return [\n    \"### Models\",\n    \"\",\n    ...models.map((model) => {\n      const module = moduleOf(model.sourceFile);\n      const table = model.table ? ` → \\`${model.table}\\`` : \"\";\n\n      return `- \\`${model.name}\\`${table}${module ? ` (module \\`${module}\\`)` : \"\"}`;\n    }),\n    \"\",\n  ];\n}\n\n/** The rules `warlock check` enforces (WL9001–WL9012) and the layout every skill assumes. */\nconst CONVENTIONS = [\n  \"- Features live in `src/app/<module>/`; flow is one-way: `routes.ts` → controllers → services → repositories → models. Resources only map output.\",\n  \"- Never import auto-loaded files: `src/app/main.ts`, `src/app/<module>/routes.ts`, `main.ts`, `worker.ts`, `events/*.ts` (`WL9001`).\",\n  \"- No `.js` extensions in import paths (`WL9002`).\",\n  \"- Cross-module imports use the `app/<module>/...` alias, not `../../` (`WL9003`); relative paths stay inside a module.\",\n  '- Cascade uses standard decorators: never set `\"experimentalDecorators\": true` (`WL9004`).',\n  \"- Controllers are thin and read input with `request.validated()`, never `request.all()` (`WL9005`); schemas live in `schema/<action>.schema.ts` and export the value and its `Infer` type. One controller per file (`WL9011`).\",\n  \"- Every POST/PUT/PATCH/DELETE route is inside `guarded()` (or has auth middleware) or says `public: true` (`WL9006`).\",\n  \"- Redirect targets from request input go through `safeRedirect()` / `safeRedirectTarget()` (`WL9007`); logs never carry raw emails, credentials or request bodies (`WL9008`); regexes run on request input have bounded quantifiers (`WL9009`).\",\n  \"- Import each API from its home package: `v` from `@warlock.js/seal`, `Model` from `@warlock.js/cascade`, `router` from `@warlock.js/core`.\",\n];\n\nfunction skillsSection(skills: readonly InstalledSkill[]): string[] {\n  if (skills.length === 0) return [];\n\n  const byPackage = new Map<string, InstalledSkill[]>();\n\n  for (const skill of skills) {\n    byPackage.set(skill.package, [...(byPackage.get(skill.package) ?? []), skill]);\n  }\n\n  const lines = [\n    \"### Skills\",\n    \"\",\n    \"Installed with the packages, at `node_modules/<package>/skills/<slug>/SKILL.md`. Read the matching one before changing that area.\",\n    \"\",\n  ];\n\n  for (const packageName of [...byPackage.keys()].sort()) {\n    lines.push(`**${packageName}**`, \"\");\n\n    const entries = [...(byPackage.get(packageName) ?? [])].sort((first, second) =>\n      compare(first.slug, second.slug),\n    );\n\n    for (const skill of entries) {\n      const line = shortSkillLine(skill.description);\n\n      lines.push(`- \\`${skill.slug}\\`${line ? ` — ${line}` : \"\"}`);\n    }\n\n    lines.push(\"\");\n  }\n\n  return lines;\n}\n\nconst VERIFY = [\n  \"### Verify a change\",\n  \"\",\n  \"- `npx warlock check --changed --json` — typecheck, lint, affected tests and conventions; exit 1 = your code, 2 = this machine.\",\n  \"- `npx warlock inspect --json` — routes, models, config keys, events, pages, jobs from the booted app.\",\n  \"- `npx warlock explain <code>` — what a `WLxxxx` code means and how to fix it.\",\n  \"- `npx warlock trace <method> <url> --json` — send a request to the running `warlock dev` and print its devtools timeline.\",\n  \"- `npx warlock mcp` — the same facts and actions as an MCP server.\",\n  \"\",\n];\n\n/**\n * Render the app-specific AGENTS.md section from an inspect report: the app\n * and its Warlock packages, modules, a routes summary (unguarded writes\n * flagged), models, the conventions `warlock check` enforces, the installed\n * skills and the verify commands.\n *\n * Deterministic: no timestamps and stable ordering, so regenerating an\n * unchanged app yields the same bytes and `writeAgentsMd` writes nothing.\n * Returned without the markers.\n *\n * @param report An `inspectApp()` report (routes, models and packages are read when present).\n * @param options Skills and module folders to include.\n */\nexport function renderAgentsMdSection(\n  report: InspectReport,\n  options: RenderAgentsMdOptions = {},\n): string {\n  const lines = [\n    \"<!-- Generated by `warlock agents-md` and refreshed by `warlock dev`. Write your own notes outside the warlock:generated markers; everything between them is replaced. -->\",\n    \"\",\n    ...appSection(report),\n    ...modulesSection(report, options.modules ?? []),\n    ...routesSection(report, options.maxRoutes ?? 60),\n    ...modelsSection(report),\n    \"### Conventions in force\",\n    \"\",\n    ...CONVENTIONS,\n    \"\",\n    ...skillsSection(options.skills ?? []),\n    ...VERIFY,\n  ];\n\n  return `${lines.join(\"\\n\").replace(/\\n+$/, \"\")}\\n`;\n}\n"],"mappings":"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"}

package/esm/tooling/agents-md/write-agents-md.d.mts

@@ -1,21 +1,27 @@
 import { InspectReport } from "../inspect/inspect-report.types.mjs";
 import { InstalledSkill } from "./installed-skills.mjs";
-
 //#region ../../packages/core/src/tooling/agents-md/write-agents-md.d.ts
 /** What {@link writeAgentsMd} did. */
-type AgentsMdWriteStatus = "created" | "updated" | "unchanged" | "skipped";
+export type AgentsMdWriteStatus = "created" | "updated" | "unchanged" | "skipped";
 /** Options of {@link writeAgentsMd}. */
-type WriteAgentsMdOptions = {
-  /** Project root. Default: `process.cwd()`. */cwd?: string; /** The inspect report to render. */
-  report: InspectReport; /** Create AGENTS.md when it does not exist. Default: `true`; `false` reports `skipped`. */
-  create?: boolean; /** Skills to list. Default: `listInstalledSkills(cwd)`. */
-  skills?: readonly InstalledSkill[]; /** Module folders. Default: `listAppModules(cwd)`. */
+export type WriteAgentsMdOptions = {
+  /** Project root. Default: `process.cwd()`. */
+  cwd?: string;
+  /** The inspect report to render. */
+  report: InspectReport;
+  /** Create AGENTS.md when it does not exist. Default: `true`; `false` reports `skipped`. */
+  create?: boolean;
+  /** Skills to list. Default: `listInstalledSkills(cwd)`. */
+  skills?: readonly InstalledSkill[];
+  /** Module folders. Default: `listAppModules(cwd)`. */
   modules?: readonly string[];
 };
 /** The result of {@link writeAgentsMd}. */
-type WriteAgentsMdResult = {
-  /** Absolute path of AGENTS.md. */file: string;
-  status: AgentsMdWriteStatus; /** The generated section, without markers. */
+export type WriteAgentsMdResult = {
+  /** Absolute path of AGENTS.md. */
+  file: string;
+  status: AgentsMdWriteStatus;
+  /** The generated section, without markers. */
   section: string;
 };
 /**
@@ -27,7 +33,6 @@ type WriteAgentsMdResult = {
  * @example
  * const { status } = writeAgentsMd({ report: await inspectApp() });
  */
-declare function writeAgentsMd(options: WriteAgentsMdOptions): WriteAgentsMdResult;
+export declare function writeAgentsMd(options: WriteAgentsMdOptions): WriteAgentsMdResult;
 //#endregion
-export { AgentsMdWriteStatus, WriteAgentsMdOptions, WriteAgentsMdResult, writeAgentsMd };
 //# sourceMappingURL=write-agents-md.d.mts.map

package/esm/tooling/agents-md/write-agents-md.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"write-agents-md.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/agents-md/write-agents-md.ts"],"mappings":";;;;;KAQY,mBAAA;AAAZ;AAAA,KAGY,oBAAA;gDAEV,GAAA,WAL6B;EAO7B,MAAA,EAAQ,aAAA,EAJsB;EAM9B,MAAA,YAEgC;EAAhC,MAAA,YAAkB,cAAc,IAJhC;EAMA,OAAA;AAAA;;KAIU,mBAAA;EAJV,kCAMA,IAAA;EACA,MAAA,EAAQ,mBAAmB,EAHjB;EAKV,OAAA;AAAA;;;;;;;AAAO;AAYT;;iBAAgB,aAAA,CAAc,OAAA,EAAS,oBAAA,GAAuB,mBAAmB"}
+{"version":3,"file":"write-agents-md.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/agents-md/write-agents-md.ts"],"mappings":";;;;YAQY;;YAGA;;EAEV;;EAEA,QAAQ;;EAER;;EAEA,kBAAkB;;EAElB;;;YAIU;;EAEV;EACA,QAAQ;;EAER;;;;;;;;;;;wBAYc,cAAc,SAAS,uBAAuB"}

package/esm/tooling/board/board-message.d.mts

@@ -1,8 +1,7 @@
 import { BoardVerdict } from "./board.types.mjs";
-
 //#region ../../packages/core/src/tooling/board/board-message.d.ts
 /** The fields a message file's front matter carries. */
-type BoardMessageFields = {
+export type BoardMessageFields = {
   from: string;
   to: string;
   item: number | null;
@@ -10,7 +9,7 @@ type BoardMessageFields = {
   at: string;
 };
 /** A message file's contents, parsed. */
-type ParsedBoardMessage = BoardMessageFields & {
+export type ParsedBoardMessage = BoardMessageFields & {
   body: string;
   verdict: BoardVerdict | null;
 };
@@ -19,13 +18,12 @@ type ParsedBoardMessage = BoardMessageFields & {
  * a blank line, the body, and — for a verdict — a final line that is exactly
  * `VERDICT: APPROVED` or `VERDICT: CHANGES REQUESTED`.
  */
-declare function formatBoardMessage(fields: BoardMessageFields, body: string, verdict?: BoardVerdict | null): string;
+export declare function formatBoardMessage(fields: BoardMessageFields, body: string, verdict?: BoardVerdict | null): string;
 /**
  * Parse a message file. Tolerates a file without front matter (everything is
  * the body). The verdict is read from the last non-empty line only, so a
  * quoted verdict inside the body does not count.
  */
-declare function parseBoardMessage(text: string): ParsedBoardMessage;
+export declare function parseBoardMessage(text: string): ParsedBoardMessage;
 //#endregion
-export { BoardMessageFields, ParsedBoardMessage, formatBoardMessage, parseBoardMessage };
 //# sourceMappingURL=board-message.d.mts.map

package/esm/tooling/board/board-message.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"board-message.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/board/board-message.ts"],"mappings":";;;;KAGY,kBAAA;EACV,IAAA;EACA,EAAA;EACA,IAAA;EACA,OAAA;EACA,EAAA;AAAA;;KAIU,kBAAA,GAAqB,kBAAA;EAC/B,IAAA;EACA,OAAA,EAAS,YAAY;AAAA;AAFvB;;;;;AAAA,iBAegB,kBAAA,CACd,MAAA,EAAQ,kBAAA,EACR,IAAA,UACA,OAAA,GAAS,YAAY;;;;AAhBA;AAavB;iBA0CgB,iBAAA,CAAkB,IAAA,WAAe,kBAAkB"}
+{"version":3,"file":"board-message.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/board/board-message.ts"],"mappings":";;;YAGY;EACV;EACA;EACA;EACA;EACA;;;YAIU,qBAAqB;EAC/B;EACA,SAAS;;;;;;;wBAaK,mBACd,QAAQ,oBACR,cACA,UAAS;;;;;;wBAuCK,kBAAkB,eAAe"}

package/esm/tooling/board/board.d.mts

@@ -1,83 +1,96 @@
 import { BoardItem, BoardMessage, BoardState, BoardStatus, BoardVerdict } from "./board.types.mjs";
-
 //#region ../../packages/core/src/tooling/board/board.d.ts
 /** What `initBoard` did. */
-type InitBoardResult = {
-  /** The board directory, relative to the project root. */directory: string; /** `false` when the board already existed. */
-  created: boolean; /** Whether `.warlock/board/` was added to `.gitignore` by this call. */
+export type InitBoardResult = {
+  /** The board directory, relative to the project root. */
+  directory: string;
+  /** `false` when the board already existed. */
+  created: boolean;
+  /** Whether `.warlock/board/` was added to `.gitignore` by this call. */
   gitignoreUpdated: boolean;
 };
 /** Inputs of {@link addBoardItem}. */
-type AddBoardItemInput = {
+export type AddBoardItemInput = {
   title: string;
   assignee?: string | null;
-  reviewer?: string | null; /** The agent creating it, recorded in the history. */
-  by?: string | null; /** Clock, for tests. */
+  reviewer?: string | null;
+  /** The agent creating it, recorded in the history. */
+  by?: string | null;
+  /** Clock, for tests. */
   now?: () => Date;
 };
 /** Inputs of {@link moveBoardItem}. */
-type MoveBoardItemOptions = {
+export type MoveBoardItemOptions = {
   by?: string | null;
   note?: string | null;
   now?: () => Date;
 };
 /** Inputs of {@link sendBoardMessage}. */
-type SendBoardMessageInput = {
+export type SendBoardMessageInput = {
   to: string;
   from: string;
   subject: string;
-  body?: string; /** The item the message is about. */
-  item?: number | null; /** A review verdict; with `item`, also moves the item to that state. */
+  body?: string;
+  /** The item the message is about. */
+  item?: number | null;
+  /** A review verdict; with `item`, also moves the item to that state. */
   verdict?: BoardVerdict | null;
   now?: () => Date;
 };
 /** What {@link sendBoardMessage} wrote. */
-type SendBoardMessageResult = {
-  message: BoardMessage; /** The item after the verdict moved it, when the message carried one. */
+export type SendBoardMessageResult = {
+  message: BoardMessage;
+  /** The item after the verdict moved it, when the message carried one. */
   item: BoardItem | null;
 };
 /** Inputs of {@link watchBoard}. */
-type WatchBoardOptions = {
-  agent: string; /** Return messages numbered above this. Default: the agent's cursor. */
-  since?: number; /** Give up after this long; throws `WL7404`. Default: 10 minutes. */
-  timeoutMs?: number; /** Poll interval. Default: 250 ms. */
-  intervalMs?: number; /** Stop early (resolves with no messages). */
+export type WatchBoardOptions = {
+  agent: string;
+  /** Return messages numbered above this. Default: the agent's cursor. */
+  since?: number;
+  /** Give up after this long; throws `WL7404`. Default: 10 minutes. */
+  timeoutMs?: number;
+  /** Poll interval. Default: 250 ms. */
+  intervalMs?: number;
+  /** Stop early (resolves with no messages). */
   signal?: AbortSignal;
 };
 /** What {@link watchBoard} returned. */
-type WatchBoardResult = {
-  agent: string; /** The new messages, oldest first. */
-  messages: BoardMessage[]; /** The agent's cursor after the call. */
+export type WatchBoardResult = {
+  agent: string;
+  /** The new messages, oldest first. */
+  messages: BoardMessage[];
+  /** The agent's cursor after the call. */
   cursor: number;
 };
 /** A file-name slug: lower-case, dashes, at most 48 characters. */
-declare function boardSlug(value: string, fallback: string): string;
+export declare function boardSlug(value: string, fallback: string): string;
 /** Throw unless `name` is a valid agent name. */
-declare function assertAgentName(name: string, label?: string): void;
+export declare function assertAgentName(name: string, label?: string): void;
 /** Whether a `.gitignore` already ignores the board folder (or `.warlock` as a whole). */
-declare function gitignoreCoversBoard(content: string): boolean;
+export declare function gitignoreCoversBoard(content: string): boolean;
 /**
  * Create the board (idempotent): `.warlock/board/` with its `board.json`
  * marker, `items/`, and `.warlock/board/` in `.gitignore` unless the project
  * already ignores it. A `.gitignore` is created when there is none.
  */
-declare function initBoard(cwd?: string, now?: () => Date): InitBoardResult;
+export declare function initBoard(cwd?: string, now?: () => Date): InitBoardResult;
 /** Every item, by id. Throws `WL7401` when the board does not exist. */
-declare function listBoardItems(cwd?: string): BoardItem[];
+export declare function listBoardItems(cwd?: string): BoardItem[];
 /** One item. Throws `WL7402` for an unknown id. */
-declare function readBoardItem(id: number, cwd?: string): BoardItem;
+export declare function readBoardItem(id: number, cwd?: string): BoardItem;
 /** Add an item in state `todo`, with a fresh id no other writer can take. */
-declare function addBoardItem(input: AddBoardItemInput, cwd?: string): BoardItem;
+export declare function addBoardItem(input: AddBoardItemInput, cwd?: string): BoardItem;
 /** The states an item in `state` may move to. */
-declare function nextBoardStates(state: BoardState): readonly BoardState[];
+export declare function nextBoardStates(state: BoardState): readonly BoardState[];
 /** Throw `WL7403` unless `from → to` is in {@link BOARD_TRANSITIONS}. */
-declare function assertBoardTransition(id: number, from: BoardState, to: BoardState): void;
+export declare function assertBoardTransition(id: number, from: BoardState, to: BoardState): void;
 /**
  * Move an item to another state, recording who moved it and why. Throws
  * `WL7402` for an unknown id and `WL7403` for a move the state machine does
  * not allow.
  */
-declare function moveBoardItem(id: number, to: BoardState, options?: MoveBoardItemOptions, cwd?: string): BoardItem;
+export declare function moveBoardItem(id: number, to: BoardState, options?: MoveBoardItemOptions, cwd?: string): BoardItem;
 /**
  * Write a message to `to-<agent>/NNNN-<slug>.md`. Messages are append-only:
  * the number is reserved exclusively and the file is created with `wx`, so it
@@ -85,17 +98,17 @@ declare function moveBoardItem(id: number, to: BoardState, options?: MoveBoardIt
  * `approved` / `changes-requested` — before the message is written, so a
  * refused move (`WL7403`) leaves no message behind.
  */
-declare function sendBoardMessage(input: SendBoardMessageInput, cwd?: string): SendBoardMessageResult;
+export declare function sendBoardMessage(input: SendBoardMessageInput, cwd?: string): SendBoardMessageResult;
 /** The messages in an agent's inbox numbered above `since`, oldest first. */
-declare function listBoardMessages(agent: string, options?: {
+export declare function listBoardMessages(agent: string, options?: {
   since?: number;
 }, cwd?: string): BoardMessage[];
 /** The highest message number `watch` has returned to `agent` (0 when none). */
-declare function readBoardCursor(agent: string, cwd?: string): number;
+export declare function readBoardCursor(agent: string, cwd?: string): number;
 /** Record that `agent` has seen messages up to `number`. Never moves the cursor back. */
-declare function writeBoardCursor(agent: string, number: number, cwd?: string): number;
+export declare function writeBoardCursor(agent: string, number: number, cwd?: string): number;
 /** Every item and every inbox with its message count, cursor and unread count. */
-declare function readBoardStatus(cwd?: string): BoardStatus;
+export declare function readBoardStatus(cwd?: string): BoardStatus;
 /**
  * Block until `agent` has a message numbered above `since` (default: its
  * cursor), then return every such message and advance the cursor past them.
@@ -103,7 +116,6 @@ declare function readBoardStatus(cwd?: string): BoardStatus;
  * Polls the inbox every `intervalMs`; throws `WL7404` when `timeoutMs` passes
  * first. An aborted `signal` resolves with no messages.
  */
-declare function watchBoard(options: WatchBoardOptions, cwd?: string): Promise<WatchBoardResult>;
+export declare function watchBoard(options: WatchBoardOptions, cwd?: string): Promise<WatchBoardResult>;
 //#endregion
-export { AddBoardItemInput, InitBoardResult, MoveBoardItemOptions, SendBoardMessageInput, SendBoardMessageResult, WatchBoardOptions, WatchBoardResult, addBoardItem, assertAgentName, assertBoardTransition, boardSlug, gitignoreCoversBoard, initBoard, listBoardItems, listBoardMessages, moveBoardItem, nextBoardStates, readBoardCursor, readBoardItem, readBoardStatus, sendBoardMessage, watchBoard, writeBoardCursor };
 //# sourceMappingURL=board.d.mts.map

package/esm/tooling/board/board.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"board.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/board/board.ts"],"mappings":";;;;KAiCY,eAAA;EAAA,yDAEV,SAAA;EAEA,OAAA,WAFA;EAIA,gBAAA;AAAA;;KAIU,iBAAA;EACV,KAAA;EACA,QAAA;EACA,QAAA,kBAIgB;EAFhB,EAAA,kBAHA;EAKA,GAAA,SAAY,IAAI;AAAA;;KAIN,oBAAA;EACV,EAAA;EACA,IAAA;EACA,GAAA,SAAY,IAAI;AAAA;;KAIN,qBAAA;EACV,EAAA;EACA,IAAA;EACA,OAAA;EACA,IAAA,WARgB;EAUhB,IAAA,kBANU;EAQV,OAAA,GAAU,YAAA;EACV,GAAA,SAAY,IAAI;AAAA;;KAIN,sBAAA;EACV,OAAA,EAAS,YAAA,EAVT;EAYA,IAAA,EAAM,SAAS;AAAA;;KAIL,iBAAA;EACV,KAAA,UAZgB;EAchB,KAAA,WAVU;EAYV,SAAA;EAEA,UAAA,WAbA;EAeA,MAAA,GAAS,WAAW;AAAA;;KAIV,gBAAA;EACV,KAAA,UAdU;EAgBV,QAAA,EAAU,YAAY;EAEtB,MAAA;AAAA;;iBAgBc,SAAA,CAAU,KAAA,UAAe,QAAgB;;iBAYzC,eAAA,CAAgB,IAAA,UAAc,KAAe;;iBA8E7C,oBAAA,CAAqB,OAAe;AAnH9B;AAItB;;;;AAJsB,iBAyIN,SAAA,CACd,GAAA,WACA,GAAA,SAAW,IAAA,GACV,eAAe;;iBA4FF,cAAA,CAAe,GAAA,YAAsB,SAAS;;iBAe9C,aAAA,CAAc,EAAA,UAAY,GAAA,YAAsB,SAAS;AA9OjE;AAAA,iBA8PQ,YAAA,CAAa,KAAA,EAAO,iBAAA,EAAmB,GAAA,YAAsB,SAAS;;iBAqCtE,eAAA,CAAgB,KAAA,EAAO,UAAA,YAAsB,UAAU;;iBAKvD,qBAAA,CAAsB,EAAA,UAAY,IAAA,EAAM,UAAA,EAAY,EAAA,EAAI,UAAU;AA5QlF;;;;AAA6D;AAA7D,iBA0RgB,aAAA,CACd,EAAA,UACA,EAAA,EAAI,UAAA,EACJ,OAAA,GAAS,oBAAA,EACT,GAAA,YACC,SAAA;;;;AAjNiD;AAsBpD;;;iBA+NgB,gBAAA,CACd,KAAA,EAAO,qBAAA,EACP,GAAA,YACC,sBAAsB;;iBAyDT,iBAAA,CACd,KAAA,UACA,OAAA;EAAW,KAAA;AAAA,GACX,GAAA,YACC,YAAY;;iBA6BC,eAAA,CAAgB,KAAA,UAAe,GAAmB;AA7NlE;AAAA,iBA4OgB,gBAAA,CAAiB,KAAA,UAAe,MAAA,UAAgB,GAAA;;iBAchD,eAAA,CAAgB,GAAA,YAAsB,WAAW;AA1PH;AAe9D;;;;;;AAf8D,iBAyRxC,UAAA,CACpB,OAAA,EAAS,iBAAA,EACT,GAAA,YACC,OAAA,CAAQ,gBAAA"}
+{"version":3,"file":"board.d.mts","names":[],"sources":["../../../../../../../../../packages/core/src/tooling/board/board.ts"],"mappings":";;;YAiCY;;EAEV;;EAEA;;EAEA;;;YAIU;EACV;EACA;EACA;;EAEA;;EAEA,YAAY;;;YAIF;EACV;EACA;EACA,YAAY;;;YAIF;EACV;EACA;EACA;EACA;;EAEA;;EAEA,UAAU;EACV,YAAY;;;YAIF;EACV,SAAS;;EAET,MAAM;;;YAII;EACV;;EAEA;;EAEA;;EAEA;;EAEA,SAAS;;;YAIC;EACV;;EAEA,UAAU;;EAEV;;;wBAgBc,UAAU,eAAe;;wBAYzB,gBAAgB,cAAc;;wBA8E9B,qBAAqB;;;;;;wBAsBrB,UACd,cACA,YAAW,OACV;;wBA4Fa,eAAe,eAAsB;;wBAerC,cAAc,YAAY,eAAsB;;wBAgBhD,aAAa,OAAO,mBAAmB,eAAsB;;wBAqC7D,gBAAgB,OAAO,sBAAsB;;wBAK7C,sBAAsB,YAAY,MAAM,YAAY,IAAI;;;;;;wBAcxD,cACd,YACA,IAAI,YACJ,UAAS,sBACT,eACC;;;;;;;;wBAoCa,iBACd,OAAO,uBACP,eACC;;wBAyDa,kBACd,eACA;EAAW;GACX,eACC;;wBA6Ba,gBAAgB,eAAe;;wBAe/B,iBAAiB,eAAe,gBAAgB;;wBAchD,gBAAgB,eAAsB;;;;;;;;wBA+BhC,WACpB,SAAS,mBACT,eACC,QAAQ"}

package/esm/tooling/board/board.mjs

@@ -78,7 +78,7 @@ function assertInitialized(cwd) {
 }
 /** Whether a `.gitignore` already ignores the board folder (or `.warlock` as a whole). */
 function gitignoreCoversBoard(content) {
-	const covering = new Set([
+	const covering = /* @__PURE__ */ new Set([
 		".warlock",
 		".warlock/",
 		"/.warlock",
@@ -111,7 +111,8 @@ function initBoard(cwd = process.cwd(), now = () => /* @__PURE__ */ new Date())
 	const current = existsSync(gitignore) ? readFileSync(gitignore, "utf8") : "";
 	let gitignoreUpdated = false;
 	if (!gitignoreCoversBoard(current)) {
-		writeFileSync(gitignore, `${current}${current.length === 0 || current.endsWith("\n") ? "" : "\n"}${current.length > 0 ? "\n" : ""}# Agent board (warlock board)\n${BOARD_DIRECTORY}/\n`, "utf8");
+		const separator = current.length === 0 || current.endsWith("\n") ? "" : "\n";
+		writeFileSync(gitignore, `${current}${separator}${current.length > 0 ? "\n" : ""}# Agent board (warlock board)\n${BOARD_DIRECTORY}/\n`, "utf8");
 		gitignoreUpdated = true;
 	}
 	return {
@@ -377,7 +378,7 @@ async function watchBoard(options, cwd = process.cwd()) {
 	assertInitialized(cwd);
 	assertAgentName(options.agent);
 	const since = options.since ?? readBoardCursor(options.agent, cwd);
-	const timeoutMs = options.timeoutMs ?? 600 * 1e3;
+	const timeoutMs = options.timeoutMs ?? 6e5;
 	const intervalMs = options.intervalMs ?? 250;
 	const deadline = Date.now() + timeoutMs;
 	for (;;) {