@viberails/context 0.1.0 → 0.2.1

package/dist/index.cjs

@@ -24,7 +24,7 @@ __export(index_exports, {
 });
 module.exports = __toCommonJS(index_exports);
 
-// src/generate-context.ts
+// src/format-helpers.ts
 var NAMING_EXAMPLES = {
   "kebab-case": "`user-profile.ts`, not `UserProfile.ts`",
   camelCase: "`userProfile.ts`, not `user-profile.ts`",
@@ -34,6 +34,112 @@ var NAMING_EXAMPLES = {
 function conventionValue(cv) {
   return typeof cv === "string" ? cv : cv.value;
 }
+function formatDevelopmentSetup(config) {
+  const { linter, formatter } = config.stack;
+  if (!linter && !formatter) return [];
+  const lines = [];
+  lines.push("## Development setup\n");
+  const toolName = (id) => {
+    const name = id.split("@")[0];
+    if (name === "biome") return "Biome";
+    if (name === "prettier") return "Prettier";
+    if (name === "eslint") return "ESLint";
+    return name;
+  };
+  if (formatter && linter) {
+    const fmt = toolName(formatter);
+    const lint = toolName(linter);
+    if (fmt === lint) {
+      lines.push(`This project uses **${fmt}** for formatting and linting.
+`);
+    } else {
+      lines.push(`This project uses **${fmt}** for formatting and **${lint}** for linting.
+`);
+    }
+  } else if (formatter) {
+    lines.push(`This project uses **${toolName(formatter)}** for formatting.
+`);
+  } else if (linter) {
+    lines.push(`This project uses **${toolName(linter)}** for linting.
+`);
+  }
+  lines.push("- Enable format-on-save in your editor to avoid lint failures on commit.");
+  if (formatter) {
+    const fmt = toolName(formatter);
+    if (fmt === "Biome") {
+      lines.push(
+        "- If using VS Code, install the [Biome extension](https://marketplace.visualstudio.com/items?itemName=biomejs.biome) and enable format-on-save."
+      );
+    } else if (fmt === "Prettier") {
+      lines.push(
+        "- If using VS Code, install the [Prettier extension](https://marketplace.visualstudio.com/items?itemName=esbenp.prettier-vscode) and enable format-on-save."
+      );
+    }
+  }
+  return lines;
+}
+function packageHeader(pkg) {
+  const framework = pkg.stack?.framework;
+  if (framework) {
+    const name = typeof framework === "string" ? framework.split("@")[0] : framework;
+    return `### ${pkg.path} (${name})`;
+  }
+  return `### ${pkg.path}`;
+}
+function formatPackageOverrides(config) {
+  if (!config.packages || config.packages.length === 0) return [];
+  const lines = [];
+  lines.push("## Per-package rules\n");
+  lines.push("The following packages have rules that differ from the global defaults:\n");
+  for (const pkg of config.packages) {
+    lines.push(packageHeader(pkg));
+    if (pkg.conventions?.fileNaming) {
+      const val = conventionValue(pkg.conventions.fileNaming);
+      const examples = NAMING_EXAMPLES[val] ?? `e.g. \`my-module.ts\``;
+      lines.push(`- Source files use **${val}**: ${examples}.`);
+    }
+    if (pkg.conventions?.componentNaming) {
+      const val = conventionValue(pkg.conventions.componentNaming);
+      lines.push(`- Components use **${val}** naming.`);
+    }
+    if (pkg.conventions?.hookNaming) {
+      const val = conventionValue(pkg.conventions.hookNaming);
+      lines.push(`- Hooks use **${val}** naming.`);
+    }
+    if (pkg.conventions?.importAlias) {
+      const val = conventionValue(pkg.conventions.importAlias);
+      lines.push(`- Import alias: \`${val}\`.`);
+    }
+    if (pkg.rules?.maxFileLines !== void 0 && pkg.rules.maxFileLines > 0) {
+      lines.push(
+        `- Files must not exceed **${pkg.rules.maxFileLines} lines**. Split into focused modules.`
+      );
+    }
+    if (pkg.rules?.maxFunctionLines !== void 0 && pkg.rules.maxFunctionLines > 0) {
+      lines.push(
+        `- Functions must not exceed **${pkg.rules.maxFunctionLines} lines**. Extract helpers for complex logic.`
+      );
+    }
+  }
+  return lines;
+}
+function formatBoundaryRules(config) {
+  if (!config.rules.enforceBoundaries || !config.boundaries || config.boundaries.length === 0) {
+    return [];
+  }
+  const denyRules = config.boundaries.filter((r) => !r.allow);
+  if (denyRules.length === 0) return [];
+  const lines = [];
+  lines.push("## Boundary rules\n");
+  lines.push("These import boundaries are enforced:\n");
+  for (const rule of denyRules) {
+    const reason = rule.reason ? ` (${rule.reason})` : "";
+    lines.push(`- \`${rule.from}\` must NOT import from \`${rule.to}\`${reason}`);
+  }
+  return lines;
+}
+
+// src/generate-context.ts
 function formatEnforcedRules(config) {
   const { rules, conventions, structure } = config;
   const lines = [];
@@ -53,10 +159,15 @@ function formatEnforcedRules(config) {
     lines.push(`- Source files use **${val}**: ${examples}.`);
   }
   if (rules.requireTests && structure.testPattern) {
-    const srcDir = structure.srcDir ?? "src";
-    lines.push(
-      `- Every source file in \`${srcDir}/\` must have a corresponding \`${structure.testPattern}\` file.`
-    );
+    if (structure.srcDir) {
+      lines.push(
+        `- Every source file in \`${structure.srcDir}/\` must have a corresponding \`${structure.testPattern}\` file.`
+      );
+    } else {
+      lines.push(
+        `- Every source file must have a corresponding \`${structure.testPattern}\` file.`
+      );
+    }
   }
   return lines;
 }
@@ -76,30 +187,25 @@ function generateContext(config) {
   } else {
     sections.push("_(No rules configured. Edit `viberails.config.json` to add rules.)_");
   }
+  const packageLines = formatPackageOverrides(config);
+  if (packageLines.length > 0) {
+    sections.push("");
+    sections.push(packageLines.join("\n"));
+  }
   const boundaryLines = formatBoundaryRules(config);
   if (boundaryLines.length > 0) {
     sections.push("");
     sections.push(boundaryLines.join("\n"));
   }
+  const setupLines = formatDevelopmentSetup(config);
+  if (setupLines.length > 0) {
+    sections.push("");
+    sections.push(setupLines.join("\n"));
+  }
   sections.push("");
   sections.push("Run `viberails check` before committing to catch violations early.\n");
   return sections.join("\n");
 }
-function formatBoundaryRules(config) {
-  if (!config.rules.enforceBoundaries || !config.boundaries || config.boundaries.length === 0) {
-    return [];
-  }
-  const denyRules = config.boundaries.filter((r) => !r.allow);
-  if (denyRules.length === 0) return [];
-  const lines = [];
-  lines.push("## Boundary rules\n");
-  lines.push("These import boundaries are enforced:\n");
-  for (const rule of denyRules) {
-    const reason = rule.reason ? ` (${rule.reason})` : "";
-    lines.push(`- \`${rule.from}\` must NOT import from \`${rule.to}\`${reason}`);
-  }
-  return lines;
-}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   generateContext

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/generate-context.ts"],"sourcesContent":["export { generateContext } from './generate-context.js';\n","import type { ConventionValue, ViberailsConfig } from '@viberails/types';\n\n/** Naming convention examples for directive formatting. */\nconst NAMING_EXAMPLES: Record<string, string> = {\n  'kebab-case': '`user-profile.ts`, not `UserProfile.ts`',\n  camelCase: '`userProfile.ts`, not `user-profile.ts`',\n  PascalCase: '`UserProfile.ts`, not `user-profile.ts`',\n  snake_case: '`user_profile.ts`, not `UserProfile.ts`',\n};\n\n/**\n * Extract the effective value from a ConventionValue (string or object).\n */\nfunction conventionValue(cv: ConventionValue): string {\n  return typeof cv === 'string' ? cv : cv.value;\n}\n\n/**\n * Build the list of enforced rules as markdown bullet points.\n */\nfunction formatEnforcedRules(config: ViberailsConfig): string[] {\n  const { rules, conventions, structure } = config;\n  const lines: string[] = [];\n\n  if (rules.maxFileLines > 0) {\n    lines.push(\n      `- Files must not exceed **${rules.maxFileLines} lines**. Split into focused modules.`,\n    );\n  }\n\n  if (rules.maxFunctionLines > 0) {\n    lines.push(\n      `- Functions must not exceed **${rules.maxFunctionLines} lines**. Extract helpers for complex logic.`,\n    );\n  }\n\n  if (rules.enforceNaming && conventions.fileNaming) {\n    const val = conventionValue(conventions.fileNaming);\n    const examples = NAMING_EXAMPLES[val] ?? `e.g. \\`my-module.ts\\``;\n    lines.push(`- Source files use **${val}**: ${examples}.`);\n  }\n\n  if (rules.requireTests && structure.testPattern) {\n    const srcDir = structure.srcDir ?? 'src';\n    lines.push(\n      `- Every source file in \\`${srcDir}/\\` must have a corresponding \\`${structure.testPattern}\\` file.`,\n    );\n  }\n\n  return lines;\n}\n\n/**\n * Generate a rules-focused context document from a ViberailsConfig.\n *\n * The output tells AI agents what rules are enforced and that commits\n * will fail if they are violated. It does not describe the project's\n * stack, structure, or architecture — that is trivially discoverable.\n *\n * @param config - The viberails configuration\n * @returns Markdown string for `.viberails/context.md`\n */\nexport function generateContext(config: ViberailsConfig): string {\n  const sections: string[] = [];\n\n  sections.push('# viberails enforced rules\\n');\n\n  if (config.enforcement === 'enforce') {\n    sections.push('Commits will be rejected if these rules are violated:\\n');\n  } else {\n    sections.push(\n      'These rules are checked before commits. Violations will be **warned** but not blocked:\\n',\n    );\n  }\n\n  const ruleLines = formatEnforcedRules(config);\n  if (ruleLines.length > 0) {\n    sections.push(ruleLines.join('\\n'));\n  } else {\n    sections.push('_(No rules configured. Edit `viberails.config.json` to add rules.)_');\n  }\n\n  const boundaryLines = formatBoundaryRules(config);\n  if (boundaryLines.length > 0) {\n    sections.push('');\n    sections.push(boundaryLines.join('\\n'));\n  }\n\n  sections.push('');\n  sections.push('Run `viberails check` before committing to catch violations early.\\n');\n\n  return sections.join('\\n');\n}\n\n/**\n * Build the boundary rules section as markdown lines.\n * Only includes deny rules (allow: false).\n */\nfunction formatBoundaryRules(config: ViberailsConfig): string[] {\n  if (!config.rules.enforceBoundaries || !config.boundaries || config.boundaries.length === 0) {\n    return [];\n  }\n\n  const denyRules = config.boundaries.filter((r) => !r.allow);\n  if (denyRules.length === 0) return [];\n\n  const lines: string[] = [];\n  lines.push('## Boundary rules\\n');\n  lines.push('These import boundaries are enforced:\\n');\n\n  for (const rule of denyRules) {\n    const reason = rule.reason ? ` (${rule.reason})` : '';\n    lines.push(`- \\`${rule.from}\\` must NOT import from \\`${rule.to}\\`${reason}`);\n  }\n\n  return lines;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACGA,IAAM,kBAA0C;AAAA,EAC9C,cAAc;AAAA,EACd,WAAW;AAAA,EACX,YAAY;AAAA,EACZ,YAAY;AACd;AAKA,SAAS,gBAAgB,IAA6B;AACpD,SAAO,OAAO,OAAO,WAAW,KAAK,GAAG;AAC1C;AAKA,SAAS,oBAAoB,QAAmC;AAC9D,QAAM,EAAE,OAAO,aAAa,UAAU,IAAI;AAC1C,QAAM,QAAkB,CAAC;AAEzB,MAAI,MAAM,eAAe,GAAG;AAC1B,UAAM;AAAA,MACJ,6BAA6B,MAAM,YAAY;AAAA,IACjD;AAAA,EACF;AAEA,MAAI,MAAM,mBAAmB,GAAG;AAC9B,UAAM;AAAA,MACJ,iCAAiC,MAAM,gBAAgB;AAAA,IACzD;AAAA,EACF;AAEA,MAAI,MAAM,iBAAiB,YAAY,YAAY;AACjD,UAAM,MAAM,gBAAgB,YAAY,UAAU;AAClD,UAAM,WAAW,gBAAgB,GAAG,KAAK;AACzC,UAAM,KAAK,wBAAwB,GAAG,OAAO,QAAQ,GAAG;AAAA,EAC1D;AAEA,MAAI,MAAM,gBAAgB,UAAU,aAAa;AAC/C,UAAM,SAAS,UAAU,UAAU;AACnC,UAAM;AAAA,MACJ,4BAA4B,MAAM,mCAAmC,UAAU,WAAW;AAAA,IAC5F;AAAA,EACF;AAEA,SAAO;AACT;AAYO,SAAS,gBAAgB,QAAiC;AAC/D,QAAM,WAAqB,CAAC;AAE5B,WAAS,KAAK,8BAA8B;AAE5C,MAAI,OAAO,gBAAgB,WAAW;AACpC,aAAS,KAAK,yDAAyD;AAAA,EACzE,OAAO;AACL,aAAS;AAAA,MACP;AAAA,IACF;AAAA,EACF;AAEA,QAAM,YAAY,oBAAoB,MAAM;AAC5C,MAAI,UAAU,SAAS,GAAG;AACxB,aAAS,KAAK,UAAU,KAAK,IAAI,CAAC;AAAA,EACpC,OAAO;AACL,aAAS,KAAK,qEAAqE;AAAA,EACrF;AAEA,QAAM,gBAAgB,oBAAoB,MAAM;AAChD,MAAI,cAAc,SAAS,GAAG;AAC5B,aAAS,KAAK,EAAE;AAChB,aAAS,KAAK,cAAc,KAAK,IAAI,CAAC;AAAA,EACxC;AAEA,WAAS,KAAK,EAAE;AAChB,WAAS,KAAK,sEAAsE;AAEpF,SAAO,SAAS,KAAK,IAAI;AAC3B;AAMA,SAAS,oBAAoB,QAAmC;AAC9D,MAAI,CAAC,OAAO,MAAM,qBAAqB,CAAC,OAAO,cAAc,OAAO,WAAW,WAAW,GAAG;AAC3F,WAAO,CAAC;AAAA,EACV;AAEA,QAAM,YAAY,OAAO,WAAW,OAAO,CAAC,MAAM,CAAC,EAAE,KAAK;AAC1D,MAAI,UAAU,WAAW,EAAG,QAAO,CAAC;AAEpC,QAAM,QAAkB,CAAC;AACzB,QAAM,KAAK,qBAAqB;AAChC,QAAM,KAAK,yCAAyC;AAEpD,aAAW,QAAQ,WAAW;AAC5B,UAAM,SAAS,KAAK,SAAS,KAAK,KAAK,MAAM,MAAM;AACnD,UAAM,KAAK,OAAO,KAAK,IAAI,6BAA6B,KAAK,EAAE,KAAK,MAAM,EAAE;AAAA,EAC9E;AAEA,SAAO;AACT;","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/format-helpers.ts","../src/generate-context.ts"],"sourcesContent":["export { generateContext } from './generate-context.js';\n","import type { ConventionValue, PackageConfigOverrides, ViberailsConfig } from '@viberails/types';\n\n/** Naming convention examples for directive formatting. */\nexport const NAMING_EXAMPLES: Record<string, string> = {\n  'kebab-case': '`user-profile.ts`, not `UserProfile.ts`',\n  camelCase: '`userProfile.ts`, not `user-profile.ts`',\n  PascalCase: '`UserProfile.ts`, not `user-profile.ts`',\n  snake_case: '`user_profile.ts`, not `UserProfile.ts`',\n};\n\n/**\n * Extract the effective value from a ConventionValue (string or object).\n */\nexport function conventionValue(cv: ConventionValue): string {\n  return typeof cv === 'string' ? cv : cv.value;\n}\n\n/**\n * Build the \"Development setup\" section describing the project's\n * formatter and linter, with guidance on enabling format-on-save.\n */\nexport function formatDevelopmentSetup(config: ViberailsConfig): string[] {\n  const { linter, formatter } = config.stack;\n  if (!linter && !formatter) return [];\n\n  const lines: string[] = [];\n  lines.push('## Development setup\\n');\n\n  const toolName = (id: string): string => {\n    const name = id.split('@')[0];\n    if (name === 'biome') return 'Biome';\n    if (name === 'prettier') return 'Prettier';\n    if (name === 'eslint') return 'ESLint';\n    return name;\n  };\n\n  if (formatter && linter) {\n    const fmt = toolName(formatter);\n    const lint = toolName(linter);\n    if (fmt === lint) {\n      lines.push(`This project uses **${fmt}** for formatting and linting.\\n`);\n    } else {\n      lines.push(`This project uses **${fmt}** for formatting and **${lint}** for linting.\\n`);\n    }\n  } else if (formatter) {\n    lines.push(`This project uses **${toolName(formatter)}** for formatting.\\n`);\n  } else if (linter) {\n    lines.push(`This project uses **${toolName(linter)}** for linting.\\n`);\n  }\n\n  lines.push('- Enable format-on-save in your editor to avoid lint failures on commit.');\n\n  if (formatter) {\n    const fmt = toolName(formatter);\n    if (fmt === 'Biome') {\n      lines.push(\n        '- If using VS Code, install the [Biome extension](https://marketplace.visualstudio.com/items?itemName=biomejs.biome) and enable format-on-save.',\n      );\n    } else if (fmt === 'Prettier') {\n      lines.push(\n        '- If using VS Code, install the [Prettier extension](https://marketplace.visualstudio.com/items?itemName=esbenp.prettier-vscode) and enable format-on-save.',\n      );\n    }\n  }\n\n  return lines;\n}\n\n/**\n * Build the header for a package override section.\n */\nexport function packageHeader(pkg: PackageConfigOverrides): string {\n  const framework = pkg.stack?.framework;\n  if (framework) {\n    const name = typeof framework === 'string' ? framework.split('@')[0] : framework;\n    return `### ${pkg.path} (${name})`;\n  }\n  return `### ${pkg.path}`;\n}\n\n/**\n * Build the per-package overrides section as markdown lines.\n */\nexport function formatPackageOverrides(config: ViberailsConfig): string[] {\n  if (!config.packages || config.packages.length === 0) return [];\n\n  const lines: string[] = [];\n  lines.push('## Per-package rules\\n');\n  lines.push('The following packages have rules that differ from the global defaults:\\n');\n\n  for (const pkg of config.packages) {\n    lines.push(packageHeader(pkg));\n\n    if (pkg.conventions?.fileNaming) {\n      const val = conventionValue(pkg.conventions.fileNaming);\n      const examples = NAMING_EXAMPLES[val] ?? `e.g. \\`my-module.ts\\``;\n      lines.push(`- Source files use **${val}**: ${examples}.`);\n    }\n\n    if (pkg.conventions?.componentNaming) {\n      const val = conventionValue(pkg.conventions.componentNaming);\n      lines.push(`- Components use **${val}** naming.`);\n    }\n\n    if (pkg.conventions?.hookNaming) {\n      const val = conventionValue(pkg.conventions.hookNaming);\n      lines.push(`- Hooks use **${val}** naming.`);\n    }\n\n    if (pkg.conventions?.importAlias) {\n      const val = conventionValue(pkg.conventions.importAlias);\n      lines.push(`- Import alias: \\`${val}\\`.`);\n    }\n\n    if (pkg.rules?.maxFileLines !== undefined && pkg.rules.maxFileLines > 0) {\n      lines.push(\n        `- Files must not exceed **${pkg.rules.maxFileLines} lines**. Split into focused modules.`,\n      );\n    }\n\n    if (pkg.rules?.maxFunctionLines !== undefined && pkg.rules.maxFunctionLines > 0) {\n      lines.push(\n        `- Functions must not exceed **${pkg.rules.maxFunctionLines} lines**. Extract helpers for complex logic.`,\n      );\n    }\n  }\n\n  return lines;\n}\n\n/**\n * Build the boundary rules section as markdown lines.\n * Only includes deny rules (allow: false).\n */\nexport function formatBoundaryRules(config: ViberailsConfig): string[] {\n  if (!config.rules.enforceBoundaries || !config.boundaries || config.boundaries.length === 0) {\n    return [];\n  }\n\n  const denyRules = config.boundaries.filter((r) => !r.allow);\n  if (denyRules.length === 0) return [];\n\n  const lines: string[] = [];\n  lines.push('## Boundary rules\\n');\n  lines.push('These import boundaries are enforced:\\n');\n\n  for (const rule of denyRules) {\n    const reason = rule.reason ? ` (${rule.reason})` : '';\n    lines.push(`- \\`${rule.from}\\` must NOT import from \\`${rule.to}\\`${reason}`);\n  }\n\n  return lines;\n}\n","import type { ViberailsConfig } from '@viberails/types';\nimport {\n  conventionValue,\n  formatBoundaryRules,\n  formatDevelopmentSetup,\n  formatPackageOverrides,\n  NAMING_EXAMPLES,\n} from './format-helpers.js';\n\n/**\n * Build the list of enforced rules as markdown bullet points.\n */\nfunction formatEnforcedRules(config: ViberailsConfig): string[] {\n  const { rules, conventions, structure } = config;\n  const lines: string[] = [];\n\n  if (rules.maxFileLines > 0) {\n    lines.push(\n      `- Files must not exceed **${rules.maxFileLines} lines**. Split into focused modules.`,\n    );\n  }\n\n  if (rules.maxFunctionLines > 0) {\n    lines.push(\n      `- Functions must not exceed **${rules.maxFunctionLines} lines**. Extract helpers for complex logic.`,\n    );\n  }\n\n  if (rules.enforceNaming && conventions.fileNaming) {\n    const val = conventionValue(conventions.fileNaming);\n    const examples = NAMING_EXAMPLES[val] ?? `e.g. \\`my-module.ts\\``;\n    lines.push(`- Source files use **${val}**: ${examples}.`);\n  }\n\n  if (rules.requireTests && structure.testPattern) {\n    if (structure.srcDir) {\n      lines.push(\n        `- Every source file in \\`${structure.srcDir}/\\` must have a corresponding \\`${structure.testPattern}\\` file.`,\n      );\n    } else {\n      lines.push(\n        `- Every source file must have a corresponding \\`${structure.testPattern}\\` file.`,\n      );\n    }\n  }\n\n  return lines;\n}\n\n/**\n * Generate a rules-focused context document from a ViberailsConfig.\n *\n * The output tells AI agents what rules are enforced and that commits\n * will fail if they are violated. It does not describe the project's\n * stack, structure, or architecture — that is trivially discoverable.\n *\n * @param config - The viberails configuration\n * @returns Markdown string for `.viberails/context.md`\n */\nexport function generateContext(config: ViberailsConfig): string {\n  const sections: string[] = [];\n\n  sections.push('# viberails enforced rules\\n');\n\n  if (config.enforcement === 'enforce') {\n    sections.push('Commits will be rejected if these rules are violated:\\n');\n  } else {\n    sections.push(\n      'These rules are checked before commits. Violations will be **warned** but not blocked:\\n',\n    );\n  }\n\n  const ruleLines = formatEnforcedRules(config);\n  if (ruleLines.length > 0) {\n    sections.push(ruleLines.join('\\n'));\n  } else {\n    sections.push('_(No rules configured. Edit `viberails.config.json` to add rules.)_');\n  }\n\n  const packageLines = formatPackageOverrides(config);\n  if (packageLines.length > 0) {\n    sections.push('');\n    sections.push(packageLines.join('\\n'));\n  }\n\n  const boundaryLines = formatBoundaryRules(config);\n  if (boundaryLines.length > 0) {\n    sections.push('');\n    sections.push(boundaryLines.join('\\n'));\n  }\n\n  const setupLines = formatDevelopmentSetup(config);\n  if (setupLines.length > 0) {\n    sections.push('');\n    sections.push(setupLines.join('\\n'));\n  }\n\n  sections.push('');\n  sections.push('Run `viberails check` before committing to catch violations early.\\n');\n\n  return sections.join('\\n');\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACGO,IAAM,kBAA0C;AAAA,EACrD,cAAc;AAAA,EACd,WAAW;AAAA,EACX,YAAY;AAAA,EACZ,YAAY;AACd;AAKO,SAAS,gBAAgB,IAA6B;AAC3D,SAAO,OAAO,OAAO,WAAW,KAAK,GAAG;AAC1C;AAMO,SAAS,uBAAuB,QAAmC;AACxE,QAAM,EAAE,QAAQ,UAAU,IAAI,OAAO;AACrC,MAAI,CAAC,UAAU,CAAC,UAAW,QAAO,CAAC;AAEnC,QAAM,QAAkB,CAAC;AACzB,QAAM,KAAK,wBAAwB;AAEnC,QAAM,WAAW,CAAC,OAAuB;AACvC,UAAM,OAAO,GAAG,MAAM,GAAG,EAAE,CAAC;AAC5B,QAAI,SAAS,QAAS,QAAO;AAC7B,QAAI,SAAS,WAAY,QAAO;AAChC,QAAI,SAAS,SAAU,QAAO;AAC9B,WAAO;AAAA,EACT;AAEA,MAAI,aAAa,QAAQ;AACvB,UAAM,MAAM,SAAS,SAAS;AAC9B,UAAM,OAAO,SAAS,MAAM;AAC5B,QAAI,QAAQ,MAAM;AAChB,YAAM,KAAK,uBAAuB,GAAG;AAAA,CAAkC;AAAA,IACzE,OAAO;AACL,YAAM,KAAK,uBAAuB,GAAG,2BAA2B,IAAI;AAAA,CAAmB;AAAA,IACzF;AAAA,EACF,WAAW,WAAW;AACpB,UAAM,KAAK,uBAAuB,SAAS,SAAS,CAAC;AAAA,CAAsB;AAAA,EAC7E,WAAW,QAAQ;AACjB,UAAM,KAAK,uBAAuB,SAAS,MAAM,CAAC;AAAA,CAAmB;AAAA,EACvE;AAEA,QAAM,KAAK,0EAA0E;AAErF,MAAI,WAAW;AACb,UAAM,MAAM,SAAS,SAAS;AAC9B,QAAI,QAAQ,SAAS;AACnB,YAAM;AAAA,QACJ;AAAA,MACF;AAAA,IACF,WAAW,QAAQ,YAAY;AAC7B,YAAM;AAAA,QACJ;AAAA,MACF;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AACT;AAKO,SAAS,cAAc,KAAqC;AACjE,QAAM,YAAY,IAAI,OAAO;AAC7B,MAAI,WAAW;AACb,UAAM,OAAO,OAAO,cAAc,WAAW,UAAU,MAAM,GAAG,EAAE,CAAC,IAAI;AACvE,WAAO,OAAO,IAAI,IAAI,KAAK,IAAI;AAAA,EACjC;AACA,SAAO,OAAO,IAAI,IAAI;AACxB;AAKO,SAAS,uBAAuB,QAAmC;AACxE,MAAI,CAAC,OAAO,YAAY,OAAO,SAAS,WAAW,EAAG,QAAO,CAAC;AAE9D,QAAM,QAAkB,CAAC;AACzB,QAAM,KAAK,wBAAwB;AACnC,QAAM,KAAK,2EAA2E;AAEtF,aAAW,OAAO,OAAO,UAAU;AACjC,UAAM,KAAK,cAAc,GAAG,CAAC;AAE7B,QAAI,IAAI,aAAa,YAAY;AAC/B,YAAM,MAAM,gBAAgB,IAAI,YAAY,UAAU;AACtD,YAAM,WAAW,gBAAgB,GAAG,KAAK;AACzC,YAAM,KAAK,wBAAwB,GAAG,OAAO,QAAQ,GAAG;AAAA,IAC1D;AAEA,QAAI,IAAI,aAAa,iBAAiB;AACpC,YAAM,MAAM,gBAAgB,IAAI,YAAY,eAAe;AAC3D,YAAM,KAAK,sBAAsB,GAAG,YAAY;AAAA,IAClD;AAEA,QAAI,IAAI,aAAa,YAAY;AAC/B,YAAM,MAAM,gBAAgB,IAAI,YAAY,UAAU;AACtD,YAAM,KAAK,iBAAiB,GAAG,YAAY;AAAA,IAC7C;AAEA,QAAI,IAAI,aAAa,aAAa;AAChC,YAAM,MAAM,gBAAgB,IAAI,YAAY,WAAW;AACvD,YAAM,KAAK,qBAAqB,GAAG,KAAK;AAAA,IAC1C;AAEA,QAAI,IAAI,OAAO,iBAAiB,UAAa,IAAI,MAAM,eAAe,GAAG;AACvE,YAAM;AAAA,QACJ,6BAA6B,IAAI,MAAM,YAAY;AAAA,MACrD;AAAA,IACF;AAEA,QAAI,IAAI,OAAO,qBAAqB,UAAa,IAAI,MAAM,mBAAmB,GAAG;AAC/E,YAAM;AAAA,QACJ,iCAAiC,IAAI,MAAM,gBAAgB;AAAA,MAC7D;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AACT;AAMO,SAAS,oBAAoB,QAAmC;AACrE,MAAI,CAAC,OAAO,MAAM,qBAAqB,CAAC,OAAO,cAAc,OAAO,WAAW,WAAW,GAAG;AAC3F,WAAO,CAAC;AAAA,EACV;AAEA,QAAM,YAAY,OAAO,WAAW,OAAO,CAAC,MAAM,CAAC,EAAE,KAAK;AAC1D,MAAI,UAAU,WAAW,EAAG,QAAO,CAAC;AAEpC,QAAM,QAAkB,CAAC;AACzB,QAAM,KAAK,qBAAqB;AAChC,QAAM,KAAK,yCAAyC;AAEpD,aAAW,QAAQ,WAAW;AAC5B,UAAM,SAAS,KAAK,SAAS,KAAK,KAAK,MAAM,MAAM;AACnD,UAAM,KAAK,OAAO,KAAK,IAAI,6BAA6B,KAAK,EAAE,KAAK,MAAM,EAAE;AAAA,EAC9E;AAEA,SAAO;AACT;;;AC5IA,SAAS,oBAAoB,QAAmC;AAC9D,QAAM,EAAE,OAAO,aAAa,UAAU,IAAI;AAC1C,QAAM,QAAkB,CAAC;AAEzB,MAAI,MAAM,eAAe,GAAG;AAC1B,UAAM;AAAA,MACJ,6BAA6B,MAAM,YAAY;AAAA,IACjD;AAAA,EACF;AAEA,MAAI,MAAM,mBAAmB,GAAG;AAC9B,UAAM;AAAA,MACJ,iCAAiC,MAAM,gBAAgB;AAAA,IACzD;AAAA,EACF;AAEA,MAAI,MAAM,iBAAiB,YAAY,YAAY;AACjD,UAAM,MAAM,gBAAgB,YAAY,UAAU;AAClD,UAAM,WAAW,gBAAgB,GAAG,KAAK;AACzC,UAAM,KAAK,wBAAwB,GAAG,OAAO,QAAQ,GAAG;AAAA,EAC1D;AAEA,MAAI,MAAM,gBAAgB,UAAU,aAAa;AAC/C,QAAI,UAAU,QAAQ;AACpB,YAAM;AAAA,QACJ,4BAA4B,UAAU,MAAM,mCAAmC,UAAU,WAAW;AAAA,MACtG;AAAA,IACF,OAAO;AACL,YAAM;AAAA,QACJ,mDAAmD,UAAU,WAAW;AAAA,MAC1E;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AACT;AAYO,SAAS,gBAAgB,QAAiC;AAC/D,QAAM,WAAqB,CAAC;AAE5B,WAAS,KAAK,8BAA8B;AAE5C,MAAI,OAAO,gBAAgB,WAAW;AACpC,aAAS,KAAK,yDAAyD;AAAA,EACzE,OAAO;AACL,aAAS;AAAA,MACP;AAAA,IACF;AAAA,EACF;AAEA,QAAM,YAAY,oBAAoB,MAAM;AAC5C,MAAI,UAAU,SAAS,GAAG;AACxB,aAAS,KAAK,UAAU,KAAK,IAAI,CAAC;AAAA,EACpC,OAAO;AACL,aAAS,KAAK,qEAAqE;AAAA,EACrF;AAEA,QAAM,eAAe,uBAAuB,MAAM;AAClD,MAAI,aAAa,SAAS,GAAG;AAC3B,aAAS,KAAK,EAAE;AAChB,aAAS,KAAK,aAAa,KAAK,IAAI,CAAC;AAAA,EACvC;AAEA,QAAM,gBAAgB,oBAAoB,MAAM;AAChD,MAAI,cAAc,SAAS,GAAG;AAC5B,aAAS,KAAK,EAAE;AAChB,aAAS,KAAK,cAAc,KAAK,IAAI,CAAC;AAAA,EACxC;AAEA,QAAM,aAAa,uBAAuB,MAAM;AAChD,MAAI,WAAW,SAAS,GAAG;AACzB,aAAS,KAAK,EAAE;AAChB,aAAS,KAAK,WAAW,KAAK,IAAI,CAAC;AAAA,EACrC;AAEA,WAAS,KAAK,EAAE;AAChB,WAAS,KAAK,sEAAsE;AAEpF,SAAO,SAAS,KAAK,IAAI;AAC3B;","names":[]}

package/dist/index.js

@@ -1,4 +1,4 @@
-// src/generate-context.ts
+// src/format-helpers.ts
 var NAMING_EXAMPLES = {
   "kebab-case": "`user-profile.ts`, not `UserProfile.ts`",
   camelCase: "`userProfile.ts`, not `user-profile.ts`",
@@ -8,6 +8,112 @@ var NAMING_EXAMPLES = {
 function conventionValue(cv) {
   return typeof cv === "string" ? cv : cv.value;
 }
+function formatDevelopmentSetup(config) {
+  const { linter, formatter } = config.stack;
+  if (!linter && !formatter) return [];
+  const lines = [];
+  lines.push("## Development setup\n");
+  const toolName = (id) => {
+    const name = id.split("@")[0];
+    if (name === "biome") return "Biome";
+    if (name === "prettier") return "Prettier";
+    if (name === "eslint") return "ESLint";
+    return name;
+  };
+  if (formatter && linter) {
+    const fmt = toolName(formatter);
+    const lint = toolName(linter);
+    if (fmt === lint) {
+      lines.push(`This project uses **${fmt}** for formatting and linting.
+`);
+    } else {
+      lines.push(`This project uses **${fmt}** for formatting and **${lint}** for linting.
+`);
+    }
+  } else if (formatter) {
+    lines.push(`This project uses **${toolName(formatter)}** for formatting.
+`);
+  } else if (linter) {
+    lines.push(`This project uses **${toolName(linter)}** for linting.
+`);
+  }
+  lines.push("- Enable format-on-save in your editor to avoid lint failures on commit.");
+  if (formatter) {
+    const fmt = toolName(formatter);
+    if (fmt === "Biome") {
+      lines.push(
+        "- If using VS Code, install the [Biome extension](https://marketplace.visualstudio.com/items?itemName=biomejs.biome) and enable format-on-save."
+      );
+    } else if (fmt === "Prettier") {
+      lines.push(
+        "- If using VS Code, install the [Prettier extension](https://marketplace.visualstudio.com/items?itemName=esbenp.prettier-vscode) and enable format-on-save."
+      );
+    }
+  }
+  return lines;
+}
+function packageHeader(pkg) {
+  const framework = pkg.stack?.framework;
+  if (framework) {
+    const name = typeof framework === "string" ? framework.split("@")[0] : framework;
+    return `### ${pkg.path} (${name})`;
+  }
+  return `### ${pkg.path}`;
+}
+function formatPackageOverrides(config) {
+  if (!config.packages || config.packages.length === 0) return [];
+  const lines = [];
+  lines.push("## Per-package rules\n");
+  lines.push("The following packages have rules that differ from the global defaults:\n");
+  for (const pkg of config.packages) {
+    lines.push(packageHeader(pkg));
+    if (pkg.conventions?.fileNaming) {
+      const val = conventionValue(pkg.conventions.fileNaming);
+      const examples = NAMING_EXAMPLES[val] ?? `e.g. \`my-module.ts\``;
+      lines.push(`- Source files use **${val}**: ${examples}.`);
+    }
+    if (pkg.conventions?.componentNaming) {
+      const val = conventionValue(pkg.conventions.componentNaming);
+      lines.push(`- Components use **${val}** naming.`);
+    }
+    if (pkg.conventions?.hookNaming) {
+      const val = conventionValue(pkg.conventions.hookNaming);
+      lines.push(`- Hooks use **${val}** naming.`);
+    }
+    if (pkg.conventions?.importAlias) {
+      const val = conventionValue(pkg.conventions.importAlias);
+      lines.push(`- Import alias: \`${val}\`.`);
+    }
+    if (pkg.rules?.maxFileLines !== void 0 && pkg.rules.maxFileLines > 0) {
+      lines.push(
+        `- Files must not exceed **${pkg.rules.maxFileLines} lines**. Split into focused modules.`
+      );
+    }
+    if (pkg.rules?.maxFunctionLines !== void 0 && pkg.rules.maxFunctionLines > 0) {
+      lines.push(
+        `- Functions must not exceed **${pkg.rules.maxFunctionLines} lines**. Extract helpers for complex logic.`
+      );
+    }
+  }
+  return lines;
+}
+function formatBoundaryRules(config) {
+  if (!config.rules.enforceBoundaries || !config.boundaries || config.boundaries.length === 0) {
+    return [];
+  }
+  const denyRules = config.boundaries.filter((r) => !r.allow);
+  if (denyRules.length === 0) return [];
+  const lines = [];
+  lines.push("## Boundary rules\n");
+  lines.push("These import boundaries are enforced:\n");
+  for (const rule of denyRules) {
+    const reason = rule.reason ? ` (${rule.reason})` : "";
+    lines.push(`- \`${rule.from}\` must NOT import from \`${rule.to}\`${reason}`);
+  }
+  return lines;
+}
+
+// src/generate-context.ts
 function formatEnforcedRules(config) {
   const { rules, conventions, structure } = config;
   const lines = [];
@@ -27,10 +133,15 @@ function formatEnforcedRules(config) {
     lines.push(`- Source files use **${val}**: ${examples}.`);
   }
   if (rules.requireTests && structure.testPattern) {
-    const srcDir = structure.srcDir ?? "src";
-    lines.push(
-      `- Every source file in \`${srcDir}/\` must have a corresponding \`${structure.testPattern}\` file.`
-    );
+    if (structure.srcDir) {
+      lines.push(
+        `- Every source file in \`${structure.srcDir}/\` must have a corresponding \`${structure.testPattern}\` file.`
+      );
+    } else {
+      lines.push(
+        `- Every source file must have a corresponding \`${structure.testPattern}\` file.`
+      );
+    }
   }
   return lines;
 }
@@ -50,30 +161,25 @@ function generateContext(config) {
   } else {
     sections.push("_(No rules configured. Edit `viberails.config.json` to add rules.)_");
   }
+  const packageLines = formatPackageOverrides(config);
+  if (packageLines.length > 0) {
+    sections.push("");
+    sections.push(packageLines.join("\n"));
+  }
   const boundaryLines = formatBoundaryRules(config);
   if (boundaryLines.length > 0) {
     sections.push("");
     sections.push(boundaryLines.join("\n"));
   }
+  const setupLines = formatDevelopmentSetup(config);
+  if (setupLines.length > 0) {
+    sections.push("");
+    sections.push(setupLines.join("\n"));
+  }
   sections.push("");
   sections.push("Run `viberails check` before committing to catch violations early.\n");
   return sections.join("\n");
 }
-function formatBoundaryRules(config) {
-  if (!config.rules.enforceBoundaries || !config.boundaries || config.boundaries.length === 0) {
-    return [];
-  }
-  const denyRules = config.boundaries.filter((r) => !r.allow);
-  if (denyRules.length === 0) return [];
-  const lines = [];
-  lines.push("## Boundary rules\n");
-  lines.push("These import boundaries are enforced:\n");
-  for (const rule of denyRules) {
-    const reason = rule.reason ? ` (${rule.reason})` : "";
-    lines.push(`- \`${rule.from}\` must NOT import from \`${rule.to}\`${reason}`);
-  }
-  return lines;
-}
 export {
   generateContext
 };

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/generate-context.ts"],"sourcesContent":["import type { ConventionValue, ViberailsConfig } from '@viberails/types';\n\n/** Naming convention examples for directive formatting. */\nconst NAMING_EXAMPLES: Record<string, string> = {\n  'kebab-case': '`user-profile.ts`, not `UserProfile.ts`',\n  camelCase: '`userProfile.ts`, not `user-profile.ts`',\n  PascalCase: '`UserProfile.ts`, not `user-profile.ts`',\n  snake_case: '`user_profile.ts`, not `UserProfile.ts`',\n};\n\n/**\n * Extract the effective value from a ConventionValue (string or object).\n */\nfunction conventionValue(cv: ConventionValue): string {\n  return typeof cv === 'string' ? cv : cv.value;\n}\n\n/**\n * Build the list of enforced rules as markdown bullet points.\n */\nfunction formatEnforcedRules(config: ViberailsConfig): string[] {\n  const { rules, conventions, structure } = config;\n  const lines: string[] = [];\n\n  if (rules.maxFileLines > 0) {\n    lines.push(\n      `- Files must not exceed **${rules.maxFileLines} lines**. Split into focused modules.`,\n    );\n  }\n\n  if (rules.maxFunctionLines > 0) {\n    lines.push(\n      `- Functions must not exceed **${rules.maxFunctionLines} lines**. Extract helpers for complex logic.`,\n    );\n  }\n\n  if (rules.enforceNaming && conventions.fileNaming) {\n    const val = conventionValue(conventions.fileNaming);\n    const examples = NAMING_EXAMPLES[val] ?? `e.g. \\`my-module.ts\\``;\n    lines.push(`- Source files use **${val}**: ${examples}.`);\n  }\n\n  if (rules.requireTests && structure.testPattern) {\n    const srcDir = structure.srcDir ?? 'src';\n    lines.push(\n      `- Every source file in \\`${srcDir}/\\` must have a corresponding \\`${structure.testPattern}\\` file.`,\n    );\n  }\n\n  return lines;\n}\n\n/**\n * Generate a rules-focused context document from a ViberailsConfig.\n *\n * The output tells AI agents what rules are enforced and that commits\n * will fail if they are violated. It does not describe the project's\n * stack, structure, or architecture — that is trivially discoverable.\n *\n * @param config - The viberails configuration\n * @returns Markdown string for `.viberails/context.md`\n */\nexport function generateContext(config: ViberailsConfig): string {\n  const sections: string[] = [];\n\n  sections.push('# viberails enforced rules\\n');\n\n  if (config.enforcement === 'enforce') {\n    sections.push('Commits will be rejected if these rules are violated:\\n');\n  } else {\n    sections.push(\n      'These rules are checked before commits. Violations will be **warned** but not blocked:\\n',\n    );\n  }\n\n  const ruleLines = formatEnforcedRules(config);\n  if (ruleLines.length > 0) {\n    sections.push(ruleLines.join('\\n'));\n  } else {\n    sections.push('_(No rules configured. Edit `viberails.config.json` to add rules.)_');\n  }\n\n  const boundaryLines = formatBoundaryRules(config);\n  if (boundaryLines.length > 0) {\n    sections.push('');\n    sections.push(boundaryLines.join('\\n'));\n  }\n\n  sections.push('');\n  sections.push('Run `viberails check` before committing to catch violations early.\\n');\n\n  return sections.join('\\n');\n}\n\n/**\n * Build the boundary rules section as markdown lines.\n * Only includes deny rules (allow: false).\n */\nfunction formatBoundaryRules(config: ViberailsConfig): string[] {\n  if (!config.rules.enforceBoundaries || !config.boundaries || config.boundaries.length === 0) {\n    return [];\n  }\n\n  const denyRules = config.boundaries.filter((r) => !r.allow);\n  if (denyRules.length === 0) return [];\n\n  const lines: string[] = [];\n  lines.push('## Boundary rules\\n');\n  lines.push('These import boundaries are enforced:\\n');\n\n  for (const rule of denyRules) {\n    const reason = rule.reason ? ` (${rule.reason})` : '';\n    lines.push(`- \\`${rule.from}\\` must NOT import from \\`${rule.to}\\`${reason}`);\n  }\n\n  return lines;\n}\n"],"mappings":";AAGA,IAAM,kBAA0C;AAAA,EAC9C,cAAc;AAAA,EACd,WAAW;AAAA,EACX,YAAY;AAAA,EACZ,YAAY;AACd;AAKA,SAAS,gBAAgB,IAA6B;AACpD,SAAO,OAAO,OAAO,WAAW,KAAK,GAAG;AAC1C;AAKA,SAAS,oBAAoB,QAAmC;AAC9D,QAAM,EAAE,OAAO,aAAa,UAAU,IAAI;AAC1C,QAAM,QAAkB,CAAC;AAEzB,MAAI,MAAM,eAAe,GAAG;AAC1B,UAAM;AAAA,MACJ,6BAA6B,MAAM,YAAY;AAAA,IACjD;AAAA,EACF;AAEA,MAAI,MAAM,mBAAmB,GAAG;AAC9B,UAAM;AAAA,MACJ,iCAAiC,MAAM,gBAAgB;AAAA,IACzD;AAAA,EACF;AAEA,MAAI,MAAM,iBAAiB,YAAY,YAAY;AACjD,UAAM,MAAM,gBAAgB,YAAY,UAAU;AAClD,UAAM,WAAW,gBAAgB,GAAG,KAAK;AACzC,UAAM,KAAK,wBAAwB,GAAG,OAAO,QAAQ,GAAG;AAAA,EAC1D;AAEA,MAAI,MAAM,gBAAgB,UAAU,aAAa;AAC/C,UAAM,SAAS,UAAU,UAAU;AACnC,UAAM;AAAA,MACJ,4BAA4B,MAAM,mCAAmC,UAAU,WAAW;AAAA,IAC5F;AAAA,EACF;AAEA,SAAO;AACT;AAYO,SAAS,gBAAgB,QAAiC;AAC/D,QAAM,WAAqB,CAAC;AAE5B,WAAS,KAAK,8BAA8B;AAE5C,MAAI,OAAO,gBAAgB,WAAW;AACpC,aAAS,KAAK,yDAAyD;AAAA,EACzE,OAAO;AACL,aAAS;AAAA,MACP;AAAA,IACF;AAAA,EACF;AAEA,QAAM,YAAY,oBAAoB,MAAM;AAC5C,MAAI,UAAU,SAAS,GAAG;AACxB,aAAS,KAAK,UAAU,KAAK,IAAI,CAAC;AAAA,EACpC,OAAO;AACL,aAAS,KAAK,qEAAqE;AAAA,EACrF;AAEA,QAAM,gBAAgB,oBAAoB,MAAM;AAChD,MAAI,cAAc,SAAS,GAAG;AAC5B,aAAS,KAAK,EAAE;AAChB,aAAS,KAAK,cAAc,KAAK,IAAI,CAAC;AAAA,EACxC;AAEA,WAAS,KAAK,EAAE;AAChB,WAAS,KAAK,sEAAsE;AAEpF,SAAO,SAAS,KAAK,IAAI;AAC3B;AAMA,SAAS,oBAAoB,QAAmC;AAC9D,MAAI,CAAC,OAAO,MAAM,qBAAqB,CAAC,OAAO,cAAc,OAAO,WAAW,WAAW,GAAG;AAC3F,WAAO,CAAC;AAAA,EACV;AAEA,QAAM,YAAY,OAAO,WAAW,OAAO,CAAC,MAAM,CAAC,EAAE,KAAK;AAC1D,MAAI,UAAU,WAAW,EAAG,QAAO,CAAC;AAEpC,QAAM,QAAkB,CAAC;AACzB,QAAM,KAAK,qBAAqB;AAChC,QAAM,KAAK,yCAAyC;AAEpD,aAAW,QAAQ,WAAW;AAC5B,UAAM,SAAS,KAAK,SAAS,KAAK,KAAK,MAAM,MAAM;AACnD,UAAM,KAAK,OAAO,KAAK,IAAI,6BAA6B,KAAK,EAAE,KAAK,MAAM,EAAE;AAAA,EAC9E;AAEA,SAAO;AACT;","names":[]}
+{"version":3,"sources":["../src/format-helpers.ts","../src/generate-context.ts"],"sourcesContent":["import type { ConventionValue, PackageConfigOverrides, ViberailsConfig } from '@viberails/types';\n\n/** Naming convention examples for directive formatting. */\nexport const NAMING_EXAMPLES: Record<string, string> = {\n  'kebab-case': '`user-profile.ts`, not `UserProfile.ts`',\n  camelCase: '`userProfile.ts`, not `user-profile.ts`',\n  PascalCase: '`UserProfile.ts`, not `user-profile.ts`',\n  snake_case: '`user_profile.ts`, not `UserProfile.ts`',\n};\n\n/**\n * Extract the effective value from a ConventionValue (string or object).\n */\nexport function conventionValue(cv: ConventionValue): string {\n  return typeof cv === 'string' ? cv : cv.value;\n}\n\n/**\n * Build the \"Development setup\" section describing the project's\n * formatter and linter, with guidance on enabling format-on-save.\n */\nexport function formatDevelopmentSetup(config: ViberailsConfig): string[] {\n  const { linter, formatter } = config.stack;\n  if (!linter && !formatter) return [];\n\n  const lines: string[] = [];\n  lines.push('## Development setup\\n');\n\n  const toolName = (id: string): string => {\n    const name = id.split('@')[0];\n    if (name === 'biome') return 'Biome';\n    if (name === 'prettier') return 'Prettier';\n    if (name === 'eslint') return 'ESLint';\n    return name;\n  };\n\n  if (formatter && linter) {\n    const fmt = toolName(formatter);\n    const lint = toolName(linter);\n    if (fmt === lint) {\n      lines.push(`This project uses **${fmt}** for formatting and linting.\\n`);\n    } else {\n      lines.push(`This project uses **${fmt}** for formatting and **${lint}** for linting.\\n`);\n    }\n  } else if (formatter) {\n    lines.push(`This project uses **${toolName(formatter)}** for formatting.\\n`);\n  } else if (linter) {\n    lines.push(`This project uses **${toolName(linter)}** for linting.\\n`);\n  }\n\n  lines.push('- Enable format-on-save in your editor to avoid lint failures on commit.');\n\n  if (formatter) {\n    const fmt = toolName(formatter);\n    if (fmt === 'Biome') {\n      lines.push(\n        '- If using VS Code, install the [Biome extension](https://marketplace.visualstudio.com/items?itemName=biomejs.biome) and enable format-on-save.',\n      );\n    } else if (fmt === 'Prettier') {\n      lines.push(\n        '- If using VS Code, install the [Prettier extension](https://marketplace.visualstudio.com/items?itemName=esbenp.prettier-vscode) and enable format-on-save.',\n      );\n    }\n  }\n\n  return lines;\n}\n\n/**\n * Build the header for a package override section.\n */\nexport function packageHeader(pkg: PackageConfigOverrides): string {\n  const framework = pkg.stack?.framework;\n  if (framework) {\n    const name = typeof framework === 'string' ? framework.split('@')[0] : framework;\n    return `### ${pkg.path} (${name})`;\n  }\n  return `### ${pkg.path}`;\n}\n\n/**\n * Build the per-package overrides section as markdown lines.\n */\nexport function formatPackageOverrides(config: ViberailsConfig): string[] {\n  if (!config.packages || config.packages.length === 0) return [];\n\n  const lines: string[] = [];\n  lines.push('## Per-package rules\\n');\n  lines.push('The following packages have rules that differ from the global defaults:\\n');\n\n  for (const pkg of config.packages) {\n    lines.push(packageHeader(pkg));\n\n    if (pkg.conventions?.fileNaming) {\n      const val = conventionValue(pkg.conventions.fileNaming);\n      const examples = NAMING_EXAMPLES[val] ?? `e.g. \\`my-module.ts\\``;\n      lines.push(`- Source files use **${val}**: ${examples}.`);\n    }\n\n    if (pkg.conventions?.componentNaming) {\n      const val = conventionValue(pkg.conventions.componentNaming);\n      lines.push(`- Components use **${val}** naming.`);\n    }\n\n    if (pkg.conventions?.hookNaming) {\n      const val = conventionValue(pkg.conventions.hookNaming);\n      lines.push(`- Hooks use **${val}** naming.`);\n    }\n\n    if (pkg.conventions?.importAlias) {\n      const val = conventionValue(pkg.conventions.importAlias);\n      lines.push(`- Import alias: \\`${val}\\`.`);\n    }\n\n    if (pkg.rules?.maxFileLines !== undefined && pkg.rules.maxFileLines > 0) {\n      lines.push(\n        `- Files must not exceed **${pkg.rules.maxFileLines} lines**. Split into focused modules.`,\n      );\n    }\n\n    if (pkg.rules?.maxFunctionLines !== undefined && pkg.rules.maxFunctionLines > 0) {\n      lines.push(\n        `- Functions must not exceed **${pkg.rules.maxFunctionLines} lines**. Extract helpers for complex logic.`,\n      );\n    }\n  }\n\n  return lines;\n}\n\n/**\n * Build the boundary rules section as markdown lines.\n * Only includes deny rules (allow: false).\n */\nexport function formatBoundaryRules(config: ViberailsConfig): string[] {\n  if (!config.rules.enforceBoundaries || !config.boundaries || config.boundaries.length === 0) {\n    return [];\n  }\n\n  const denyRules = config.boundaries.filter((r) => !r.allow);\n  if (denyRules.length === 0) return [];\n\n  const lines: string[] = [];\n  lines.push('## Boundary rules\\n');\n  lines.push('These import boundaries are enforced:\\n');\n\n  for (const rule of denyRules) {\n    const reason = rule.reason ? ` (${rule.reason})` : '';\n    lines.push(`- \\`${rule.from}\\` must NOT import from \\`${rule.to}\\`${reason}`);\n  }\n\n  return lines;\n}\n","import type { ViberailsConfig } from '@viberails/types';\nimport {\n  conventionValue,\n  formatBoundaryRules,\n  formatDevelopmentSetup,\n  formatPackageOverrides,\n  NAMING_EXAMPLES,\n} from './format-helpers.js';\n\n/**\n * Build the list of enforced rules as markdown bullet points.\n */\nfunction formatEnforcedRules(config: ViberailsConfig): string[] {\n  const { rules, conventions, structure } = config;\n  const lines: string[] = [];\n\n  if (rules.maxFileLines > 0) {\n    lines.push(\n      `- Files must not exceed **${rules.maxFileLines} lines**. Split into focused modules.`,\n    );\n  }\n\n  if (rules.maxFunctionLines > 0) {\n    lines.push(\n      `- Functions must not exceed **${rules.maxFunctionLines} lines**. Extract helpers for complex logic.`,\n    );\n  }\n\n  if (rules.enforceNaming && conventions.fileNaming) {\n    const val = conventionValue(conventions.fileNaming);\n    const examples = NAMING_EXAMPLES[val] ?? `e.g. \\`my-module.ts\\``;\n    lines.push(`- Source files use **${val}**: ${examples}.`);\n  }\n\n  if (rules.requireTests && structure.testPattern) {\n    if (structure.srcDir) {\n      lines.push(\n        `- Every source file in \\`${structure.srcDir}/\\` must have a corresponding \\`${structure.testPattern}\\` file.`,\n      );\n    } else {\n      lines.push(\n        `- Every source file must have a corresponding \\`${structure.testPattern}\\` file.`,\n      );\n    }\n  }\n\n  return lines;\n}\n\n/**\n * Generate a rules-focused context document from a ViberailsConfig.\n *\n * The output tells AI agents what rules are enforced and that commits\n * will fail if they are violated. It does not describe the project's\n * stack, structure, or architecture — that is trivially discoverable.\n *\n * @param config - The viberails configuration\n * @returns Markdown string for `.viberails/context.md`\n */\nexport function generateContext(config: ViberailsConfig): string {\n  const sections: string[] = [];\n\n  sections.push('# viberails enforced rules\\n');\n\n  if (config.enforcement === 'enforce') {\n    sections.push('Commits will be rejected if these rules are violated:\\n');\n  } else {\n    sections.push(\n      'These rules are checked before commits. Violations will be **warned** but not blocked:\\n',\n    );\n  }\n\n  const ruleLines = formatEnforcedRules(config);\n  if (ruleLines.length > 0) {\n    sections.push(ruleLines.join('\\n'));\n  } else {\n    sections.push('_(No rules configured. Edit `viberails.config.json` to add rules.)_');\n  }\n\n  const packageLines = formatPackageOverrides(config);\n  if (packageLines.length > 0) {\n    sections.push('');\n    sections.push(packageLines.join('\\n'));\n  }\n\n  const boundaryLines = formatBoundaryRules(config);\n  if (boundaryLines.length > 0) {\n    sections.push('');\n    sections.push(boundaryLines.join('\\n'));\n  }\n\n  const setupLines = formatDevelopmentSetup(config);\n  if (setupLines.length > 0) {\n    sections.push('');\n    sections.push(setupLines.join('\\n'));\n  }\n\n  sections.push('');\n  sections.push('Run `viberails check` before committing to catch violations early.\\n');\n\n  return sections.join('\\n');\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@viberails/context",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "description": "AI context file generation for viberails",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -25,8 +25,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@viberails/types": "0.1.0",
-    "@viberails/config": "0.1.0"
+    "@viberails/types": "0.2.1",
+    "@viberails/config": "0.2.1"
   },
   "scripts": {
     "build": "tsup",