@oddessentials/repo-standards 4.3.0 → 5.0.0

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/version.ts"],"sourcesContent":["import { fileURLToPath } from \"node:url\";\nimport { readFileSync } from \"node:fs\";\nimport { join, dirname } from \"node:path\";\nimport type {\n  MasterJson,\n  StackChecklistJson,\n  StackId,\n  CiSystem,\n} from \"./types.js\";\nimport { STANDARDS_VERSION, STANDARDS_SCHEMA_VERSION } from \"./version.js\";\n\n// Re-export types for consumers\nexport type { MasterJson, StackChecklistJson, StackId, CiSystem };\n\n// Re-export version info (stable API contract)\nexport { STANDARDS_VERSION, STANDARDS_SCHEMA_VERSION };\n\n// ESM equivalent of __dirname\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = dirname(__filename);\n\n// Path to config directory:\n// - When running from src/ (dev/test): use repo root config/\n// - When running from dist/ (installed): use dist/config/\nconst isDevMode = __dirname.includes(\"src\");\nconst configDir = isDevMode\n  ? join(__dirname, \"..\", \"config\")\n  : join(__dirname, \"config\");\n\n/** Load the master spec JSON from the packaged dist directory */\nexport function loadMasterSpec(): MasterJson {\n  const filePath = join(configDir, \"standards.json\");\n  return JSON.parse(readFileSync(filePath, \"utf8\"));\n}\n\n/** Load a stack-specific checklist (optionally filtered by CI system) */\nexport function loadBaseline(\n  stack: StackId,\n  ci?: CiSystem,\n): StackChecklistJson {\n  const suffix = ci ? `.${ci}` : \"\";\n  const file = `standards.${stack}${suffix}.json`;\n  const filePath = join(configDir, file);\n  return JSON.parse(readFileSync(filePath, \"utf8\"));\n}\n\n/** List all supported stacks (derived from the master spec) */\nexport function listSupportedStacks(): readonly StackId[] {\n  const spec = loadMasterSpec();\n  return Object.keys(spec.stacks) as StackId[];\n}\n\n/** List all supported CI systems (derived from the master spec) */\nexport function listSupportedCiSystems(): readonly CiSystem[] {\n  const spec = loadMasterSpec();\n  return spec.ciSystems as CiSystem[];\n}\n\n/**\n * PUBLIC API CONTRACT (semver-governed)\n * Alias for loadBaseline - loads stack-specific standards checklist.\n * Breaking changes to this function signature require a major version bump.\n */\nexport function getStandards(\n  stack: StackId,\n  ci?: CiSystem,\n): StackChecklistJson {\n  return loadBaseline(stack, ci);\n}\n\n/**\n * PUBLIC API CONTRACT (semver-governed)\n * Alias for loadMasterSpec - loads the master standards schema.\n * Breaking changes to this function signature require a major version bump.\n */\nexport function getSchema(): MasterJson {\n  return loadMasterSpec();\n}\n","/**\n * AUTO-GENERATED at build time by scripts/build.ts\n * DO NOT EDIT MANUALLY\n *\n * This module provides version information for the repo-standards package.\n * Consumers should import from here instead of package.json to avoid\n * ESM/CJS interop issues.\n */\n\nexport const STANDARDS_VERSION = '4.2.0';\nexport const STANDARDS_SCHEMA_VERSION = 4;\n"],"mappings":";AAAA,SAAS,qBAAqB;AAC9B,SAAS,oBAAoB;AAC7B,SAAS,MAAM,eAAe;;;ACOvB,IAAM,oBAAoB;AAC1B,IAAM,2BAA2B;;;ADQxC,IAAMA,cAAa,cAAc,YAAY,GAAG;AAChD,IAAMC,aAAY,QAAQD,WAAU;AAKpC,IAAM,YAAYC,WAAU,SAAS,KAAK;AAC1C,IAAM,YAAY,YACd,KAAKA,YAAW,MAAM,QAAQ,IAC9B,KAAKA,YAAW,QAAQ;AAGrB,SAAS,iBAA6B;AAC3C,QAAM,WAAW,KAAK,WAAW,gBAAgB;AACjD,SAAO,KAAK,MAAM,aAAa,UAAU,MAAM,CAAC;AAClD;AAGO,SAAS,aACd,OACA,IACoB;AACpB,QAAM,SAAS,KAAK,IAAI,EAAE,KAAK;AAC/B,QAAM,OAAO,aAAa,KAAK,GAAG,MAAM;AACxC,QAAM,WAAW,KAAK,WAAW,IAAI;AACrC,SAAO,KAAK,MAAM,aAAa,UAAU,MAAM,CAAC;AAClD;AAGO,SAAS,sBAA0C;AACxD,QAAM,OAAO,eAAe;AAC5B,SAAO,OAAO,KAAK,KAAK,MAAM;AAChC;AAGO,SAAS,yBAA8C;AAC5D,QAAM,OAAO,eAAe;AAC5B,SAAO,KAAK;AACd;AAOO,SAAS,aACd,OACA,IACoB;AACpB,SAAO,aAAa,OAAO,EAAE;AAC/B;AAOO,SAAS,YAAwB;AACtC,SAAO,eAAe;AACxB;","names":["__filename","__dirname"]}
+{"version":3,"sources":["../src/index.ts","../src/version.ts"],"sourcesContent":["import { fileURLToPath } from \"node:url\";\nimport { readFileSync } from \"node:fs\";\nimport { join, dirname } from \"node:path\";\nimport type {\n  MasterJson,\n  StackChecklistJson,\n  StackId,\n  CiSystem,\n} from \"./types.js\";\nimport { STANDARDS_VERSION, STANDARDS_SCHEMA_VERSION } from \"./version.js\";\n\n// Re-export types for consumers\nexport type { MasterJson, StackChecklistJson, StackId, CiSystem };\n\n// Re-export version info (stable API contract)\nexport { STANDARDS_VERSION, STANDARDS_SCHEMA_VERSION };\n\n// ESM equivalent of __dirname\nconst __filename = fileURLToPath(import.meta.url);\nconst __dirname = dirname(__filename);\n\n// Path to config directory:\n// - When running from src/ (dev/test): use repo root config/\n// - When running from dist/ (installed): use dist/config/\nconst isDevMode = __dirname.includes(\"src\");\nconst configDir = isDevMode\n  ? join(__dirname, \"..\", \"config\")\n  : join(__dirname, \"config\");\n\n/** Load the master spec JSON from the packaged dist directory */\nexport function loadMasterSpec(): MasterJson {\n  const filePath = join(configDir, \"standards.json\");\n  return JSON.parse(readFileSync(filePath, \"utf8\"));\n}\n\n/** Load a stack-specific checklist (optionally filtered by CI system) */\nexport function loadBaseline(\n  stack: StackId,\n  ci?: CiSystem,\n): StackChecklistJson {\n  const suffix = ci ? `.${ci}` : \"\";\n  const file = `standards.${stack}${suffix}.json`;\n  const filePath = join(configDir, file);\n  return JSON.parse(readFileSync(filePath, \"utf8\"));\n}\n\n/** List all supported stacks (derived from the master spec) */\nexport function listSupportedStacks(): readonly StackId[] {\n  const spec = loadMasterSpec();\n  return Object.keys(spec.stacks) as StackId[];\n}\n\n/** List all supported CI systems (derived from the master spec) */\nexport function listSupportedCiSystems(): readonly CiSystem[] {\n  const spec = loadMasterSpec();\n  return spec.ciSystems as CiSystem[];\n}\n\n/**\n * PUBLIC API CONTRACT (semver-governed)\n * Alias for loadBaseline - loads stack-specific standards checklist.\n * Breaking changes to this function signature require a major version bump.\n */\nexport function getStandards(\n  stack: StackId,\n  ci?: CiSystem,\n): StackChecklistJson {\n  return loadBaseline(stack, ci);\n}\n\n/**\n * PUBLIC API CONTRACT (semver-governed)\n * Alias for loadMasterSpec - loads the master standards schema.\n * Breaking changes to this function signature require a major version bump.\n */\nexport function getSchema(): MasterJson {\n  return loadMasterSpec();\n}\n","/**\n * AUTO-GENERATED at build time by scripts/build.ts\n * DO NOT EDIT MANUALLY\n *\n * This module provides version information for the repo-standards package.\n * Consumers should import from here instead of package.json to avoid\n * ESM/CJS interop issues.\n */\n\nexport const STANDARDS_VERSION = '4.4.0';\nexport const STANDARDS_SCHEMA_VERSION = 4;\n"],"mappings":";AAAA,SAAS,qBAAqB;AAC9B,SAAS,oBAAoB;AAC7B,SAAS,MAAM,eAAe;;;ACOvB,IAAM,oBAAoB;AAC1B,IAAM,2BAA2B;;;ADQxC,IAAMA,cAAa,cAAc,YAAY,GAAG;AAChD,IAAMC,aAAY,QAAQD,WAAU;AAKpC,IAAM,YAAYC,WAAU,SAAS,KAAK;AAC1C,IAAM,YAAY,YACd,KAAKA,YAAW,MAAM,QAAQ,IAC9B,KAAKA,YAAW,QAAQ;AAGrB,SAAS,iBAA6B;AAC3C,QAAM,WAAW,KAAK,WAAW,gBAAgB;AACjD,SAAO,KAAK,MAAM,aAAa,UAAU,MAAM,CAAC;AAClD;AAGO,SAAS,aACd,OACA,IACoB;AACpB,QAAM,SAAS,KAAK,IAAI,EAAE,KAAK;AAC/B,QAAM,OAAO,aAAa,KAAK,GAAG,MAAM;AACxC,QAAM,WAAW,KAAK,WAAW,IAAI;AACrC,SAAO,KAAK,MAAM,aAAa,UAAU,MAAM,CAAC;AAClD;AAGO,SAAS,sBAA0C;AACxD,QAAM,OAAO,eAAe;AAC5B,SAAO,OAAO,KAAK,KAAK,MAAM;AAChC;AAGO,SAAS,yBAA8C;AAC5D,QAAM,OAAO,eAAe;AAC5B,SAAO,KAAK;AACd;AAOO,SAAS,aACd,OACA,IACoB;AACpB,SAAO,aAAa,OAAO,EAAE;AAC/B;AAOO,SAAS,YAAwB;AACtC,SAAO,eAAe;AACxB;","names":["__filename","__dirname"]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@oddessentials/repo-standards",
   "private": false,
-  "version": "4.3.0",
+  "version": "5.0.0",
   "description": "Standards and CI filtering utilities for multi-stack repository governance.",
   "type": "module",
   "bin": {

package/scripts/generate-readme-counts.ts

@@ -0,0 +1,39 @@
+// scripts/generate-readme-counts.ts
+// Generates checklist item counts dynamically from standards.json
+// Prevents count rot by computing at build time
+
+import fs from "node:fs";
+import path from "node:path";
+
+interface MasterJson {
+  version: number;
+  checklist: {
+    core: unknown[];
+    recommended: unknown[];
+    optionalEnhancements: unknown[];
+  };
+}
+
+function main() {
+  const rootDir = process.cwd();
+  const masterPath = path.join(rootDir, "config", "standards.json");
+
+  if (!fs.existsSync(masterPath)) {
+    console.error(`standards.json not found at ${masterPath}`);
+    process.exit(1);
+  }
+
+  const raw = fs.readFileSync(masterPath, "utf8");
+  const master: MasterJson = JSON.parse(raw);
+
+  const coreCount = master.checklist.core.length;
+  const recommendedCount = master.checklist.recommended.length;
+  const optionalCount = master.checklist.optionalEnhancements.length;
+
+  // Output markdown snippet for README
+  console.log(
+    `**${coreCount} core** (required), **${recommendedCount} recommended**, **${optionalCount} optional enhancements**`,
+  );
+}
+
+main();

package/scripts/validate-schema.ts

@@ -18,11 +18,21 @@ interface ValidationResult {
 
 interface ChecklistItem {
   id: string;
+  executionStage?: string;
   appliesTo?: { stacks?: string[]; ciSystems?: string[] };
   ciHints?: Record<string, unknown>;
   stackHints?: Record<string, unknown>;
 }
 
+const VALID_EXECUTION_STAGES = new Set([
+  "pre-commit",
+  "pre-push",
+  "ci-pr",
+  "ci-main",
+  "release",
+  "nightly",
+]);
+
 interface MigrationStep {
   focusIds?: string[];
 }
@@ -196,6 +206,40 @@ function validateCoverageThreshold(config: Config): ValidationResult {
   return { valid: true, errors: [] };
 }
 
+/**
+ * Validate executionStage coverage - all items should have a valid executionStage
+ */
+function validateExecutionStageCoverage(config: Config): ValidationResult {
+  const allItems = [
+    ...config.checklist.core,
+    ...config.checklist.recommended,
+    ...config.checklist.optionalEnhancements,
+  ];
+
+  const errors: string[] = [];
+  const stageCounts: Record<string, number> = {};
+
+  for (const item of allItems) {
+    if (!item.executionStage) {
+      errors.push(`Item "${item.id}" is missing executionStage`);
+    } else if (!VALID_EXECUTION_STAGES.has(item.executionStage)) {
+      errors.push(
+        `Item "${item.id}" has invalid executionStage "${item.executionStage}"`,
+      );
+    } else {
+      stageCounts[item.executionStage] =
+        (stageCounts[item.executionStage] ?? 0) + 1;
+    }
+  }
+
+  // Log stage distribution (informational, not an error)
+  if (errors.length === 0 && Object.keys(stageCounts).length > 0) {
+    // This is just for debugging, not shown in normal output
+  }
+
+  return { valid: errors.length === 0, errors };
+}
+
 /**
  * Generate a normalized, deterministic string representation of the config.
  * Uses deep stable key ordering at all depths.
@@ -236,6 +280,7 @@ export function validateStandardsConfig(
     validateStackReferences(config),
     validateCiHintKeys(config),
     validateCoverageThreshold(config),
+    validateExecutionStageCoverage(config),
   ];
 
   const allErrors = results.flatMap((r) => r.errors);
@@ -278,6 +323,7 @@ export function validateStandardsSchema(): void {
   console.log("✓ All appliesTo.stacks reference valid stack keys");
   console.log("✓ All ciHints keys are valid ciSystems");
   console.log("✓ Coverage threshold semantics are valid");
+  console.log("✓ All items have valid executionStage");
 }
 
 // CLI entry point