@sha3/code-standards 0.1.2 → 0.1.4

package/README.md

@@ -53,12 +53,14 @@ Default generated contract includes structural class/file blocks such as:
 - `consts`
 - `types`
 - `private:attributes`
+- `protected:attributes`
 - `private:properties`
 - `public:properties`
 - `constructor`
 - `static:properties`
 - `factory`
 - `private:methods`
+- `protected:methods`
 - `public:methods`
 - `static:methods`
 
@@ -72,6 +74,7 @@ All blocks MUST exist even when empty (`// empty`).
 
 Additional blocking defaults:
 
+- Max line length is 160 chars, and lines should stay on one line when they fit.
 - `if`/`else`/loop statements MUST always use braces.
 - README updates MUST follow a top-tier quality standard (see `standards/readme.md`).
 
@@ -107,17 +110,21 @@ After `init`, your new repo contains:
 - `ai/codex.md`, `ai/cursor.md`, `ai/copilot.md`, `ai/windsurf.md`
 - `ai/examples/rules/*.ts` (good/bad examples per rule)
 - `ai/examples/demo/src/*` (feature-folder demo with classes and section blocks)
+- `src/config.ts` for centralized hardcoded configuration values
 - `.gitignore` preconfigured for Node/TypeScript output
 - lint/format/typecheck/test-ready project template
 
 That means the next step is **not** configuring tools. The next step is telling your assistant to obey `AGENTS.md` before coding.
 
+Generated project code is TypeScript-only: implementation and tests live in `.ts` files.
+
 ## TypeScript Example Files
 
 `init` now stores code examples in `.ts` files instead of embedding them inside `AGENTS.md`.
 
 Demo structure generated by default:
 
+- `ai/examples/demo/src/config.ts`
 - `ai/examples/demo/src/invoices/invoice-service.ts`
 - `ai/examples/demo/src/invoices/invoice-errors.ts`
 - `ai/examples/demo/src/invoices/invoice-types.ts`
@@ -278,6 +285,7 @@ Commands:
 ### `init` options
 
 `init` always uses the current working directory as target.
+An existing `.git/` directory is allowed without `--force`.
 
 - `--template <node-lib|node-service>`
 - `--yes`

package/bin/code-standards.mjs

@@ -55,12 +55,14 @@ const DEFAULT_PROFILE = {
     "consts",
     "types",
     "private:attributes",
+    "protected:attributes",
     "private:properties",
     "public:properties",
     "constructor",
     "static:properties",
     "factory",
     "private:methods",
+    "protected:methods",
     "public:methods",
     "static:methods"
   ],
@@ -88,11 +90,7 @@ const PROFILE_QUESTIONS = [
   {
     key: "return_policy",
     prompt: "Return policy",
-    options: [
-      "single_return_strict_no_exceptions",
-      "single_return_with_guard_clauses",
-      "free_return_style"
-    ]
+    options: ["single_return_strict_no_exceptions", "single_return_with_guard_clauses", "free_return_style"]
   },
   {
     key: "class_design",
@@ -202,9 +200,7 @@ function parseInitArgs(argv) {
     const token = argv[i];
 
     if (!token.startsWith("-")) {
-      throw new Error(
-        `Positional project names are not supported: ${token}. Run init from your target directory.`
-      );
+      throw new Error(`Positional project names are not supported: ${token}. Run init from your target directory.`);
     }
 
     if (token === "--template") {
@@ -394,11 +390,10 @@ async function ensureTargetReady(targetPath, force) {
   }
 
   const entries = await readdir(targetPath);
+  const nonGitEntries = entries.filter((entry) => entry !== ".git");
 
-  if (entries.length > 0 && !force) {
-    throw new Error(
-      `Target directory is not empty: ${targetPath}. Use --force to continue and overwrite files.`
-    );
+  if (nonGitEntries.length > 0 && !force) {
+    throw new Error(`Target directory is not empty: ${targetPath}. Use --force to continue and overwrite files.`);
   }
 }
 
@@ -455,9 +450,7 @@ function validateProfile(profile, schema, sourceLabel) {
     return;
   }
 
-  const details = (validate.errors ?? [])
-    .map((issue) => `${issue.instancePath || "/"}: ${issue.message ?? "invalid"}`)
-    .join("; ");
+  const details = (validate.errors ?? []).map((issue) => `${issue.instancePath || "/"}: ${issue.message ?? "invalid"}`).join("; ");
 
   throw new Error(`Invalid profile at ${sourceLabel}: ${details}`);
 }
@@ -549,12 +542,7 @@ async function createProfileInteractively(baseProfile) {
 
   try {
     for (const question of PROFILE_QUESTIONS) {
-      profile[question.key] = await askChoice(
-        rl,
-        question.prompt,
-        question.options,
-        profile[question.key]
-      );
+      profile[question.key] = await askChoice(rl, question.prompt, question.options, profile[question.key]);
     }
   } finally {
     rl.close();
@@ -572,9 +560,7 @@ async function runProfile(rawOptions) {
   const packageRoot = resolvePackageRoot();
   const schema = await loadProfileSchema(packageRoot);
   const defaultProfilePath = getBundledProfilePath(packageRoot);
-  const outputPath = rawOptions.profilePath
-    ? path.resolve(process.cwd(), rawOptions.profilePath)
-    : defaultProfilePath;
+  const outputPath = rawOptions.profilePath ? path.resolve(process.cwd(), rawOptions.profilePath) : defaultProfilePath;
   const shouldUseNonInteractive = rawOptions.nonInteractive || !process.stdin.isTTY;
   const exists = await pathExists(outputPath);
 
@@ -589,11 +575,7 @@ async function runProfile(rawOptions) {
     });
 
     try {
-      const shouldOverwrite = await promptYesNo(
-        rl,
-        `Profile already exists at ${outputPath}. Overwrite?`,
-        false
-      );
+      const shouldOverwrite = await promptYesNo(rl, `Profile already exists at ${outputPath}. Overwrite?`, false);
 
       if (!shouldOverwrite) {
         console.log("Profile update cancelled.");
@@ -655,44 +637,30 @@ function buildAlternativeRules(profile) {
 
   if (profile.return_policy !== "single_return_strict_no_exceptions") {
     codeRules.push(
-      "### Return Policy Override (MUST)\n\n" +
-        `- The active return policy is \`${profile.return_policy}\` and MUST be respected for all new functions.`
+      "### Return Policy Override (MUST)\n\n" + `- The active return policy is \`${profile.return_policy}\` and MUST be respected for all new functions.`
     );
   }
 
   if (profile.function_size_policy !== "max_30_lines_soft") {
-    codeRules.push(
-      "### Function Size Override (MUST)\n\n" +
-        `- The active function-size policy is \`${profile.function_size_policy}\` and MUST be enforced.`
-    );
+    codeRules.push("### Function Size Override (MUST)\n\n" + `- The active function-size policy is \`${profile.function_size_policy}\` and MUST be enforced.`);
   }
 
   if (profile.error_handling !== "exceptions_with_typed_errors") {
-    codeRules.push(
-      "### Error Handling Override (MUST)\n\n" +
-        `- The active error-handling policy is \`${profile.error_handling}\`.`
-    );
+    codeRules.push("### Error Handling Override (MUST)\n\n" + `- The active error-handling policy is \`${profile.error_handling}\`.`);
   }
 
   if (profile.async_style !== "async_await_only") {
-    codeRules.push(
-      "### Async Style Override (MUST)\n\n" +
-        `- The active async policy is \`${profile.async_style}\` and MUST be followed in new code.`
-    );
+    codeRules.push("### Async Style Override (MUST)\n\n" + `- The active async policy is \`${profile.async_style}\` and MUST be followed in new code.`);
   }
 
   let architectureRule = "";
   if (profile.architecture !== "feature_folders") {
-    architectureRule =
-      "### Architecture Override (MUST)\n\n" +
-      `- The active architecture is \`${profile.architecture}\` and MUST take precedence.`;
+    architectureRule = "### Architecture Override (MUST)\n\n" + `- The active architecture is \`${profile.architecture}\` and MUST take precedence.`;
   }
 
   let testingRule = "";
   if (profile.testing_policy !== "tests_required_for_behavior_change") {
-    testingRule =
-      "### Testing Override (MUST)\n\n" +
-      `- The active testing policy is \`${profile.testing_policy}\`.`;
+    testingRule = "### Testing Override (MUST)\n\n" + `- The active testing policy is \`${profile.testing_policy}\`.`;
   }
 
   return {
@@ -721,14 +689,7 @@ async function buildRuleSections(packageRoot, profile) {
   const readmeRule = await readRule("readme.md");
 
   const alternatives = buildAlternativeRules(profile);
-  const codeGenerationRules = [
-    classRule,
-    functionRule,
-    returnRule,
-    controlFlowRule,
-    errorRule,
-    asyncRule
-  ];
+  const codeGenerationRules = [classRule, functionRule, returnRule, controlFlowRule, errorRule, asyncRule];
 
   if (alternatives.codeRules.length > 0) {
     codeGenerationRules.push(...alternatives.codeRules);
@@ -742,13 +703,7 @@ async function buildRuleSections(packageRoot, profile) {
 }
 
 async function renderProjectAgents(packageRoot, targetDir, projectName, profile) {
-  const templatePath = path.join(
-    packageRoot,
-    "resources",
-    "ai",
-    "templates",
-    "agents.project.template.md"
-  );
+  const templatePath = path.join(packageRoot, "resources", "ai", "templates", "agents.project.template.md");
   const template = await readFile(templatePath, "utf8");
   const sections = await buildRuleSections(packageRoot, profile);
 
@@ -806,11 +761,7 @@ async function maybeInitializeProfileInteractively(packageRoot, profilePath) {
   });
 
   try {
-    const shouldInit = await promptYesNo(
-      rl,
-      `Profile not found at ${profilePath}. Initialize it with package defaults?`,
-      true
-    );
+    const shouldInit = await promptYesNo(rl, `Profile not found at ${profilePath}. Initialize it with package defaults?`, true);
 
     if (!shouldInit) {
       throw new Error("Profile initialization declined by user.");
@@ -873,9 +824,7 @@ async function promptForMissing(options) {
     const resolved = { ...options };
 
     if (!resolved.template) {
-      const templateAnswer = await rl.question(
-        "Choose template (node-lib/node-service) [node-lib]: "
-      );
+      const templateAnswer = await rl.question("Choose template (node-lib/node-service) [node-lib]: ");
       const normalized = templateAnswer.trim() || "node-lib";
 
       if (!TEMPLATE_NAMES.includes(normalized)) {
@@ -899,13 +848,7 @@ async function promptForMissing(options) {
 
 async function validateInitResources(packageRoot, templateName) {
   const templateDir = path.join(packageRoot, "templates", templateName);
-  const agentsTemplatePath = path.join(
-    packageRoot,
-    "resources",
-    "ai",
-    "templates",
-    "agents.project.template.md"
-  );
+  const agentsTemplatePath = path.join(packageRoot, "resources", "ai", "templates", "agents.project.template.md");
   const adaptersTemplateDir = path.join(packageRoot, "resources", "ai", "templates", "adapters");
   const examplesTemplateDir = path.join(packageRoot, "resources", "ai", "templates", "examples");
 
@@ -943,8 +886,7 @@ async function runInit(rawOptions) {
 
   const targetPath = path.resolve(process.cwd());
   const inferredProjectName = path.basename(targetPath);
-  const projectName =
-    inferredProjectName && inferredProjectName !== path.sep ? inferredProjectName : "my-project";
+  const projectName = inferredProjectName && inferredProjectName !== path.sep ? inferredProjectName : "my-project";
   const packageName = sanitizePackageName(projectName);
 
   await ensureTargetReady(targetPath, options.force);

package/eslint/test.mjs

@@ -4,11 +4,7 @@ import nodeConfig from "./node.mjs";
 export default [
   ...nodeConfig,
   {
-    files: [
-      "**/*.test.{js,mjs,cjs,ts,mts,cts}",
-      "**/*.spec.{js,mjs,cjs,ts,mts,cts}",
-      "test/**/*.{js,mjs,cjs,ts,mts,cts}"
-    ],
+    files: ["**/*.test.{js,mjs,cjs,ts,mts,cts}", "**/*.spec.{js,mjs,cjs,ts,mts,cts}", "test/**/*.{js,mjs,cjs,ts,mts,cts}"],
     languageOptions: {
       globals: {
         ...globals.mocha,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sha3/code-standards",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "AI-first code standards, tooling exports, and project initializer",
   "type": "module",
   "bin": {

package/prettier/index.cjs

@@ -1,5 +1,5 @@
 module.exports = {
-  printWidth: 100,
+  printWidth: 160,
   tabWidth: 2,
   useTabs: false,
   semi: true,

package/profiles/default.profile.json

@@ -18,12 +18,14 @@
     "consts",
     "types",
     "private:attributes",
+    "protected:attributes",
     "private:properties",
     "public:properties",
     "constructor",
     "static:properties",
     "factory",
     "private:methods",
+    "protected:methods",
     "public:methods",
     "static:methods"
   ],

package/profiles/schema.json

@@ -43,11 +43,7 @@
     },
     "return_policy": {
       "type": "string",
-      "enum": [
-        "single_return_strict_no_exceptions",
-        "single_return_with_guard_clauses",
-        "free_return_style"
-      ]
+      "enum": ["single_return_strict_no_exceptions", "single_return_with_guard_clauses", "free_return_style"]
     },
     "class_design": {
       "type": "string",
@@ -87,8 +83,8 @@
     },
     "comment_section_blocks": {
       "type": "array",
-      "minItems": 13,
-      "maxItems": 13,
+      "minItems": 15,
+      "maxItems": 15,
       "items": {
         "type": "string",
         "enum": [
@@ -97,12 +93,14 @@
           "consts",
           "types",
           "private:attributes",
+          "protected:attributes",
           "private:properties",
           "public:properties",
           "constructor",
           "static:properties",
           "factory",
           "private:methods",
+          "protected:methods",
           "public:methods",
           "static:methods"
         ]
@@ -113,12 +111,14 @@
         "consts",
         "types",
         "private:attributes",
+        "protected:attributes",
         "private:properties",
         "public:properties",
         "constructor",
         "static:properties",
         "factory",
         "private:methods",
+        "protected:methods",
         "public:methods",
         "static:methods"
       ]

package/resources/ai/templates/examples/demo/src/billing/billing-service.ts

@@ -8,6 +8,7 @@
  * @section imports:internals
  */
 
+import { BILLING_CURRENCY_SYMBOL, STATUS_SERVICE_URL } from "../config.js";
 import type { InvoiceService } from "../invoices/invoice-service.js";
 import type { InvoiceSummary } from "../invoices/invoice-types.js";
 
@@ -15,7 +16,7 @@ import type { InvoiceSummary } from "../invoices/invoice-types.js";
  * @section consts
  */
 
-const CURRENCY_SYMBOL = "$";
+// empty
 
 /**
  * @section types
@@ -26,6 +27,7 @@ export type BillingSnapshot = {
   invoiceCount: number;
   totalAmount: number;
   formattedTotal: string;
+  statusServiceUrl: string;
 };
 
 export class BillingService {
@@ -35,6 +37,12 @@ export class BillingService {
 
   // empty
 
+  /**
+   * @section protected:attributes
+   */
+
+  // empty
+
   /**
    * @section private:properties
    */
@@ -75,10 +83,16 @@ export class BillingService {
    */
 
   private formatCurrency(amount: number): string {
-    const formattedAmount = `${CURRENCY_SYMBOL}${amount.toFixed(2)}`;
+    const formattedAmount = `${BILLING_CURRENCY_SYMBOL}${amount.toFixed(2)}`;
     return formattedAmount;
   }
 
+  /**
+   * @section protected:methods
+   */
+
+  // empty
+
   /**
    * @section public:methods
    */
@@ -89,7 +103,8 @@ export class BillingService {
       customerId,
       invoiceCount: summary.count,
       totalAmount: summary.totalAmount,
-      formattedTotal: this.formatCurrency(summary.totalAmount)
+      formattedTotal: this.formatCurrency(summary.totalAmount),
+      statusServiceUrl: STATUS_SERVICE_URL
     };
     return snapshot;
   }

package/resources/ai/templates/examples/demo/src/config.ts

@@ -0,0 +1,3 @@
+export const MINIMUM_INVOICE_AMOUNT = 0;
+export const BILLING_CURRENCY_SYMBOL = "$";
+export const STATUS_SERVICE_URL = "https://status.example.com/health";

package/resources/ai/templates/examples/demo/src/invoices/invoice-errors.ts

@@ -29,6 +29,12 @@ export class InvalidInvoiceCommandError extends Error {
 
   // empty
 
+  /**
+   * @section protected:attributes
+   */
+
+  // empty
+
   /**
    * @section private:properties
    */
@@ -72,6 +78,12 @@ export class InvalidInvoiceCommandError extends Error {
 
   // empty
 
+  /**
+   * @section protected:methods
+   */
+
+  // empty
+
   /**
    * @section public:methods
    */

package/resources/ai/templates/examples/demo/src/invoices/invoice-service.ts

@@ -8,6 +8,7 @@ import { randomUUID } from "node:crypto";
  * @section imports:internals
  */
 
+import { MINIMUM_INVOICE_AMOUNT } from "../config.js";
 import { InvalidInvoiceCommandError } from "./invoice-errors.js";
 import type { CreateInvoiceCommand, Invoice, InvoiceSummary } from "./invoice-types.js";
 
@@ -15,7 +16,7 @@ import type { CreateInvoiceCommand, Invoice, InvoiceSummary } from "./invoice-ty
  * @section consts
  */
 
-const MINIMUM_INVOICE_AMOUNT = 0;
+// empty
 
 /**
  * @section types
@@ -30,6 +31,12 @@ export class InvoiceService {
 
   // empty
 
+  /**
+   * @section protected:attributes
+   */
+
+  // empty
+
   /**
    * @section private:properties
    */
@@ -89,6 +96,12 @@ export class InvoiceService {
     return invoice;
   }
 
+  /**
+   * @section protected:methods
+   */
+
+  // empty
+
   /**
    * @section public:methods
    */

package/resources/ai/templates/examples/rules/async-bad.ts

@@ -33,6 +33,12 @@ export class InvoiceSyncService {
 
   // empty
 
+  /**
+   * @section protected:attributes
+   */
+
+  // empty
+
   /**
    * @section private:properties
    */
@@ -76,6 +82,12 @@ export class InvoiceSyncService {
 
   // empty
 
+  /**
+   * @section protected:methods
+   */
+
+  // empty
+
   /**
    * @section public:methods
    */

package/resources/ai/templates/examples/rules/async-good.ts

@@ -33,6 +33,12 @@ export class InvoiceSyncService {
 
   // empty
 
+  /**
+   * @section protected:attributes
+   */
+
+  // empty
+
   /**
    * @section private:properties
    */
@@ -76,6 +82,12 @@ export class InvoiceSyncService {
 
   // empty
 
+  /**
+   * @section protected:methods
+   */
+
+  // empty
+
   /**
    * @section public:methods
    */

package/resources/ai/templates/examples/rules/class-first-bad.ts

@@ -30,6 +30,12 @@ export class InvoiceService {
 
   // empty
 
+  /**
+   * @section protected:attributes
+   */
+
+  // empty
+
   /**
    * @section private:properties
    */
@@ -69,6 +75,12 @@ export class InvoiceService {
 
   // empty
 
+  /**
+   * @section protected:methods
+   */
+
+  // empty
+
   /**
    * @section public:methods
    */

package/resources/ai/templates/examples/rules/class-first-good.ts

@@ -30,6 +30,12 @@ export class InvoiceService {
 
   private readonly requestId: string;
 
+  /**
+   * @section protected:attributes
+   */
+
+  // empty
+
   /**
    * @section private:properties
    */
@@ -81,6 +87,12 @@ export class InvoiceService {
     return invoice;
   }
 
+  /**
+   * @section protected:methods
+   */
+
+  // empty
+
   /**
    * @section public:methods
    */

package/resources/ai/templates/examples/rules/constructor-bad.ts

@@ -30,6 +30,12 @@ export class InvoiceIdBuilder {
 
   // empty
 
+  /**
+   * @section protected:attributes
+   */
+
+  // empty
+
   /**
    * @section private:properties
    */
@@ -79,6 +85,12 @@ export class InvoiceIdBuilder {
     return year;
   }
 
+  /**
+   * @section protected:methods
+   */
+
+  // empty
+
   /**
    * @section public:methods
    */

package/resources/ai/templates/examples/rules/constructor-good.ts

@@ -30,6 +30,12 @@ export class InvoiceIdBuilder {
 
   // empty
 
+  /**
+   * @section protected:attributes
+   */
+
+  // empty
+
   /**
    * @section private:properties
    */
@@ -78,6 +84,12 @@ export class InvoiceIdBuilder {
     return year;
   }
 
+  /**
+   * @section protected:methods
+   */
+
+  // empty
+
   /**
    * @section public:methods
    */

package/resources/ai/templates/examples/rules/control-flow-bad.ts

@@ -29,6 +29,12 @@ export class ControlFlowPolicy {
 
   // empty
 
+  /**
+   * @section protected:attributes
+   */
+
+  // empty
+
   /**
    * @section private:properties
    */
@@ -68,6 +74,12 @@ export class ControlFlowPolicy {
 
   // empty
 
+  /**
+   * @section protected:methods
+   */
+
+  // empty
+
   /**
    * @section public:methods
    */

package/resources/ai/templates/examples/rules/control-flow-good.ts

@@ -29,6 +29,12 @@ export class FeatureGate {
 
   // empty
 
+  /**
+   * @section protected:attributes
+   */
+
+  // empty
+
   /**
    * @section private:properties
    */
@@ -70,6 +76,12 @@ export class FeatureGate {
 
   // empty
 
+  /**
+   * @section protected:methods
+   */
+
+  // empty
+
   /**
    * @section public:methods
    */

package/resources/ai/templates/examples/rules/errors-bad.ts

@@ -29,6 +29,12 @@ export class InvoiceLookup {
 
   // empty
 
+  /**
+   * @section protected:attributes
+   */
+
+  // empty
+
   /**
    * @section private:properties
    */
@@ -68,6 +74,12 @@ export class InvoiceLookup {
 
   // empty
 
+  /**
+   * @section protected:methods
+   */
+
+  // empty
+
   /**
    * @section public:methods
    */

package/resources/ai/templates/examples/rules/errors-good.ts

@@ -29,6 +29,12 @@ export class InvoiceNotFoundError extends Error {
 
   // empty
 
+  /**
+   * @section protected:attributes
+   */
+
+  // empty
+
   /**
    * @section private:properties
    */
@@ -72,6 +78,12 @@ export class InvoiceNotFoundError extends Error {
 
   // empty
 
+  /**
+   * @section protected:methods
+   */
+
+  // empty
+
   /**
    * @section public:methods
    */

package/resources/ai/templates/examples/rules/functions-bad.ts

@@ -30,6 +30,12 @@ export class PaymentNormalizer {
 
   // empty
 
+  /**
+   * @section protected:attributes
+   */
+
+  // empty
+
   /**
    * @section private:properties
    */
@@ -69,6 +75,12 @@ export class PaymentNormalizer {
 
   // empty
 
+  /**
+   * @section protected:methods
+   */
+
+  // empty
+
   /**
    * @section public:methods
    */

package/resources/ai/templates/examples/rules/functions-good.ts

@@ -30,6 +30,12 @@ export class PaymentNormalizer {
 
   // empty
 
+  /**
+   * @section protected:attributes
+   */
+
+  // empty
+
   /**
    * @section private:properties
    */
@@ -82,6 +88,12 @@ export class PaymentNormalizer {
     return sanitizedMetadata;
   }
 
+  /**
+   * @section protected:methods
+   */
+
+  // empty
+
   /**
    * @section public:methods
    */

package/resources/ai/templates/examples/rules/returns-bad.ts

@@ -29,6 +29,12 @@ export class InvoiceStatusPresenter {
 
   // empty
 
+  /**
+   * @section protected:attributes
+   */
+
+  // empty
+
   /**
    * @section private:properties
    */
@@ -68,6 +74,12 @@ export class InvoiceStatusPresenter {
 
   // empty
 
+  /**
+   * @section protected:methods
+   */
+
+  // empty
+
   /**
    * @section public:methods
    */

package/resources/ai/templates/examples/rules/returns-good.ts

@@ -29,6 +29,12 @@ export class InvoiceStatusPresenter {
 
   // empty
 
+  /**
+   * @section protected:attributes
+   */
+
+  // empty
+
   /**
    * @section private:properties
    */
@@ -68,6 +74,12 @@ export class InvoiceStatusPresenter {
 
   // empty
 
+  /**
+   * @section protected:methods
+   */
+
+  // empty
+
   /**
    * @section public:methods
    */

package/resources/ai/templates/examples/rules/testing-bad.ts

@@ -29,6 +29,12 @@ export class InvoiceEscalationPolicy {
 
   // empty
 
+  /**
+   * @section protected:attributes
+   */
+
+  // empty
+
   /**
    * @section private:properties
    */
@@ -68,6 +74,12 @@ export class InvoiceEscalationPolicy {
 
   // empty
 
+  /**
+   * @section protected:methods
+   */
+
+  // empty
+
   /**
    * @section public:methods
    */

package/resources/ai/templates/examples/rules/testing-good.ts

@@ -30,6 +30,12 @@ export class InvoiceEscalationPolicy {
 
   // empty
 
+  /**
+   * @section protected:attributes
+   */
+
+  // empty
+
   /**
    * @section private:properties
    */
@@ -73,6 +79,12 @@ export class InvoiceEscalationPolicy {
     return dayCount;
   }
 
+  /**
+   * @section protected:methods
+   */
+
+  // empty
+
   /**
    * @section public:methods
    */

package/resources/ai/templates/rules/architecture.md

@@ -3,9 +3,11 @@
 - Code MUST be organized by feature (for example: `src/users`, `src/billing`, `src/invoices`).
 - Each feature MUST keep its own domain model, application services, and infrastructure adapters grouped by feature.
 - Cross-feature imports MUST happen through explicit public entry points.
+- Hardcoded, non-parameterized configuration MUST be centralized in `src/config.ts` (for example, external service URLs).
 
 Good example:
 
+- `ai/examples/demo/src/config.ts`
 - `ai/examples/demo/src/invoices/invoice-service.ts`
 - `ai/examples/demo/src/invoices/invoice-errors.ts`
 - `ai/examples/demo/src/invoices/invoice-types.ts`

package/resources/ai/templates/rules/class-first.md

@@ -14,12 +14,14 @@
   - `consts`
   - `types`
   - `private:attributes`
+  - `protected:attributes`
   - `private:properties`
   - `public:properties`
   - `constructor`
   - `static:properties`
   - `factory`
   - `private:methods`
+  - `protected:methods`
   - `public:methods`
   - `static:methods`
 - All section blocks MUST exist even when empty, using `// empty` after the section marker.

package/resources/ai/templates/rules/functions.md

@@ -4,6 +4,9 @@
 - Functions MUST implement one responsibility.
 - Long functions MUST be split into private helper methods.
 - Types MUST be preferred over interfaces for local modeling unless a public contract requires an interface.
+- New implementation and test files MUST be `.ts`.
+- JavaScript source files (`.js`, `.mjs`, `.cjs`) are not allowed in `src/` or `test/`.
+- If a declaration/expression fits in one line within 160 chars, it MUST stay on one line.
 
 Good example:
 

package/resources/ai/templates/rules/testing.md

@@ -2,6 +2,7 @@
 
 - Any behavior change MUST include or update tests.
 - Tests MUST validate behavior, not implementation details.
+- Test files MUST be TypeScript (`*.test.ts`).
 - Comments MUST be explicit and extensive when logic is non-trivial.
 - Async workflows MUST use `async/await` style only.
 

package/standards/architecture.md

@@ -14,11 +14,12 @@ Two templates are supported:
 Both templates SHOULD keep this baseline structure:
 
 - `src/` for implementation.
+- `src/config.ts` for non-parameterized hardcoded configuration values.
 - `test/` for automated tests.
-- `eslint.config.mjs`, `prettier.config.cjs`, and `tsconfig.json` at root.
+- Root tooling config files (`eslint`, `prettier`, `tsconfig`) at project root.
 
 ## Boundary Rules
 
 - Keep feature modules cohesive.
 - Avoid cyclic dependencies.
-- Keep configuration centralized at project root.
+- Keep hardcoded application configuration centralized in `src/config.ts`.

package/standards/manifest.json

@@ -12,7 +12,7 @@
   },
   "formatting": {
     "prettier": true,
-    "lineLength": 100,
+    "lineLength": 160,
     "semi": true,
     "singleQuote": false
   },

package/standards/schema.json

@@ -4,16 +4,7 @@
   "title": "Code Standards Manifest",
   "type": "object",
   "additionalProperties": false,
-  "required": [
-    "meta",
-    "language",
-    "formatting",
-    "naming",
-    "architecture",
-    "testing",
-    "tooling",
-    "ai"
-  ],
+  "required": ["meta", "language", "formatting", "naming", "architecture", "testing", "tooling", "ai"],
   "properties": {
     "meta": {
       "type": "object",
@@ -42,7 +33,7 @@
       "required": ["prettier", "lineLength", "semi", "singleQuote"],
       "properties": {
         "prettier": { "type": "boolean" },
-        "lineLength": { "type": "integer", "minimum": 80, "maximum": 140 },
+        "lineLength": { "type": "integer", "minimum": 80, "maximum": 200 },
         "semi": { "type": "boolean" },
         "singleQuote": { "type": "boolean" }
       }

package/standards/style.md

@@ -5,13 +5,16 @@ All code MUST follow the canonical rules in `standards/manifest.json`.
 ## Formatting
 
 - Use Prettier for formatting.
-- Use a max line length of 100.
+- Use a max line length of 160.
+- Keep lines as compact as possible: if a declaration/expression fits in one line within 160 chars, keep it on one line.
 - Use semicolons.
 - Use double quotes for strings.
 
 ## TypeScript
 
 - Use strict TypeScript mode.
+- Project implementation and tests MUST be TypeScript-only (`.ts`).
+- JavaScript source files (`.js`, `.mjs`, `.cjs`) are not allowed in `src/` or `test/`.
 - Avoid `any` unless there is no viable alternative.
 - Prefer explicit return types for exported functions.
 - Use type-only imports when possible.
@@ -40,14 +43,16 @@ Required block names:
 3. `consts`
 4. `types`
 5. `private:attributes`
-6. `private:properties`
-7. `public:properties`
-8. `constructor`
-9. `static:properties`
-10. `factory`
-11. `private:methods`
-12. `public:methods`
-13. `static:methods`
+6. `protected:attributes`
+7. `private:properties`
+8. `public:properties`
+9. `constructor`
+10. `static:properties`
+11. `factory`
+12. `private:methods`
+13. `protected:methods`
+14. `public:methods`
+15. `static:methods`
 
 All section blocks MUST be present even when empty. Empty sections MUST include:
 

package/standards/testing.md

@@ -5,7 +5,7 @@ Projects MUST use the Node test runner.
 ## Location
 
 - Store tests under `test/`.
-- Use `*.test.ts` or `*.test.js` naming.
+- Use `*.test.ts` naming only.
 
 ## Commands
 

package/templates/node-lib/src/config.ts

@@ -0,0 +1 @@
+export const GREETING_PREFIX = "Hello";

package/templates/node-lib/src/index.ts

@@ -1,3 +1,5 @@
+import { GREETING_PREFIX } from "./config.js";
+
 export function greet(name: string): string {
-  return `Hello, ${name}`;
+  return `${GREETING_PREFIX}, ${name}`;
 }

package/templates/node-service/src/config.ts

@@ -0,0 +1,3 @@
+export const RESPONSE_CONTENT_TYPE = "application/json";
+export const DEFAULT_PORT = 3000;
+export const EXTERNAL_STATUS_URL = "https://status.example.com/health";

package/templates/node-service/src/index.ts

@@ -1,15 +1,16 @@
 import { createServer } from "node:http";
+import { DEFAULT_PORT, EXTERNAL_STATUS_URL, RESPONSE_CONTENT_TYPE } from "./config.js";
 
 export function buildServer() {
   return createServer((_, response) => {
     response.statusCode = 200;
-    response.setHeader("content-type", "application/json");
-    response.end(JSON.stringify({ ok: true }));
+    response.setHeader("content-type", RESPONSE_CONTENT_TYPE);
+    response.end(JSON.stringify({ ok: true, statusSource: EXTERNAL_STATUS_URL }));
   });
 }
 
 if (process.env.NODE_ENV !== "test") {
-  const port = Number(process.env.PORT ?? "3000");
+  const port = Number(process.env.PORT ?? String(DEFAULT_PORT));
   const server = buildServer();
   server.listen(port, () => {
     console.log(`service listening on http://localhost:${port}`);

package/templates/node-service/test/smoke.test.ts

@@ -22,7 +22,7 @@ test("service responds with ok payload", async () => {
   const json = await response.json();
 
   assert.equal(response.status, 200);
-  assert.deepEqual(json, { ok: true });
+  assert.deepEqual(json, { ok: true, statusSource: "https://status.example.com/health" });
 
   await new Promise<void>((resolve, reject) => {
     server.close((error) => {