@micelio/eslint-config 0.1.2 → 0.2.1

package/dist/standard.d.ts

@@ -2,6 +2,8 @@
 export declare const STANDARD_PATH = "docs/engineering-standard.md";
 /** The SHA-256 of each released version of the standard, by `major.minor`. */
 export type StandardHashes = Record<string, string>;
+/** The SHA-256 of each synced file (agent prompts, skills, pull request template), by path in the repository. */
+export type FileHashes = Record<string, string>;
 /** What `lintStandard` found. */
 export interface StandardResult {
     /** True when the local copy is the one published for the pinned version. */
@@ -21,14 +23,21 @@ export declare function readPin(agents: string): string | null;
 export declare function setPin(agents: string, version: string): string | null;
 /** Reads the version a copy of the standard says it is, or `null` when its header is missing. */
 export declare function standardVersion(standard: string): string | null;
-/** Loads the hashes bundled in this package. */
+/** Loads the hash of each released version of the standard bundled in this package. */
 export declare function loadHashes(): StandardHashes;
+/** Loads the hash of each file the sync carries next to the standard, by path in the repository. */
+export declare function loadFileHashes(): FileHashes;
 /**
  * Checks that the copy of the standard in `root` is the one published for the version its
  * `AGENTS.md` pins (standard, section 16). A repository may pin an older version on purpose:
  * the pinned one is checked, not the latest.
  *
  * @param root - The repository root.
+ * It also checks the synced files the repository has (`.claude/agents/*.md`, the skills, the pull
+ * request template) against `fileHashes`, but only when the pin is the newest version this package
+ * knows: a repository that stays on an older version on purpose keeps the older files too.
+ *
  * @param hashes - The published hashes; the ones bundled in this package by default.
+ * @param fileHashes - The published hashes of the synced files; the bundled ones by default.
  */
-export declare function lintStandard(root: string, hashes?: StandardHashes): StandardResult;
+export declare function lintStandard(root: string, hashes?: StandardHashes, fileHashes?: FileHashes): StandardResult;

package/dist/standard.js

@@ -31,20 +31,53 @@ export function setPin(agents, version) {
 export function standardVersion(standard) {
     return HEADER.exec(standard)?.[1] ?? null;
 }
-/** Loads the hashes bundled in this package. */
-export function loadHashes() {
+/** Reads `standard-hashes.json`, bundled in this package. */
+function readHashesFile() {
     const file = new URL('../standard-hashes.json', import.meta.url);
     return JSON.parse(readFileSync(file, 'utf8'));
 }
+/** Loads the hash of each released version of the standard bundled in this package. */
+export function loadHashes() {
+    const hashes = {};
+    for (const [key, value] of Object.entries(readHashesFile())) {
+        if (typeof value === 'string')
+            hashes[key] = value;
+    }
+    return hashes;
+}
+/** Loads the hash of each file the sync carries next to the standard, by path in the repository. */
+export function loadFileHashes() {
+    const files = {};
+    for (const [path, value] of Object.entries(readHashesFile().files ?? {})) {
+        if (typeof value === 'string')
+            files[path] = value;
+    }
+    return files;
+}
+/** The newest version in `hashes`, compared as numbers. */
+function latestVersion(hashes) {
+    const order = (version) => version.split('.').map(Number);
+    const [latest] = Object.keys(hashes).sort((a, b) => {
+        const [ax = 0, ay = 0] = order(a);
+        const [bx = 0, by = 0] = order(b);
+        return bx - ax || by - ay;
+    });
+    return latest ?? null;
+}
 /**
  * Checks that the copy of the standard in `root` is the one published for the version its
  * `AGENTS.md` pins (standard, section 16). A repository may pin an older version on purpose:
  * the pinned one is checked, not the latest.
  *
  * @param root - The repository root.
+ * It also checks the synced files the repository has (`.claude/agents/*.md`, the skills, the pull
+ * request template) against `fileHashes`, but only when the pin is the newest version this package
+ * knows: a repository that stays on an older version on purpose keeps the older files too.
+ *
  * @param hashes - The published hashes; the ones bundled in this package by default.
+ * @param fileHashes - The published hashes of the synced files; the bundled ones by default.
  */
-export function lintStandard(root, hashes = loadHashes()) {
+export function lintStandard(root, hashes = loadHashes(), fileHashes = loadFileHashes()) {
     const agentsPath = join(root, 'AGENTS.md');
     if (!existsSync(agentsPath)) {
         return {
@@ -78,5 +111,19 @@ export function lintStandard(root, hashes = loadHashes()) {
             message: `${STANDARD_PATH} does not match standard ${pin}, the version AGENTS.md pins (sha256 ${actual}, published ${expected}). Restore it, or sync it from bogd3v/micelio-engineering.`,
         };
     }
+    const stale = pin === latestVersion(hashes)
+        ? Object.entries(fileHashes)
+            .filter(([path, hash]) => {
+            const file = join(root, path);
+            return existsSync(file) && hashOf(readFileSync(file)) !== hash;
+        })
+            .map(([path]) => path)
+        : [];
+    if (stale.length > 0) {
+        return {
+            ok: false,
+            message: `${stale.join(', ')} ${stale.length === 1 ? 'does' : 'do'} not match the published copy of standard ${pin}. Restore ${stale.length === 1 ? 'it' : 'them'} if edited by hand, or, in a sync pull request, upgrade @micelio/eslint-config to the release that publishes the new hashes.`,
+        };
+    }
     return { ok: true, message: `Standard ${pin}: ${STANDARD_PATH} matches the published copy.` };
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@micelio/eslint-config",
-  "version": "0.1.2",
+  "version": "0.2.1",
   "description": "The ESLint flat config of the Micelio repositories, the licence allowlist behind lint:licenses and lint:standard.",
   "license": "MIT-0",
   "repository": {
@@ -32,9 +32,9 @@
   },
   "dependencies": {
     "eslint-config-prettier": "^10.1.8",
-    "eslint-plugin-jsdoc": "^65.3.6",
+    "eslint-plugin-jsdoc": "^65.4.2",
     "eslint-plugin-tsdoc": "0.5.4",
-    "typescript-eslint": "^8.71.2"
+    "typescript-eslint": "^8.72.1"
   },
   "peerDependencies": {
     "eslint": "^10.12.0",

package/standard-hashes.json

@@ -1,4 +1,16 @@
 {
   "1.4": "0f1202bbd02a83f216313b84be4744d66ccbee60bc01b39bfc7f67cefd30e139",
-  "1.5": "c3ee8aa9a13945e073dedeecbb7ba3a9587ec0ef6878e426eb4be7a0398d93a1"
+  "1.5": "c3ee8aa9a13945e073dedeecbb7ba3a9587ec0ef6878e426eb4be7a0398d93a1",
+  "1.6": "ea74875d30586378a64d90feb59ce197d3efa7f07e867108f3849f5308cc1f92",
+  "files": {
+    ".claude/agents/master.md": "ee982318762bccb42a8a68dfaf51628087dcd7d4563be5b8a08b1ffabea7adbd",
+    ".claude/agents/planner.md": "b71c815c78875252c9574b74e581115c9814903bc05c11a992689d8af979f7e8",
+    ".claude/agents/reviewer.md": "62b9addeab36c5166b674dd1b1cdae92c382b00a563ccbd2b652227932b7ef52",
+    ".claude/agents/verifier.md": "9d42abc7329774c51f63f1079182e42720b052f1f3ef5b05019c9729aa394958",
+    ".claude/agents/worker.md": "8390a223c983ec5ea7254e1f7fd1de79cfd1bb4c73936a133ddfb6ffd7f25d45",
+    ".claude/skills/ship-pr/SKILL.md": "c6267ca9022252dbd48a90c19940d70f7515857792b5df5d2e6a8320f2ecfb51",
+    ".claude/skills/blind-review/SKILL.md": "914d96d06ff3d34b711702c2a77315a387b3529e672eeead48fc830875a1f4ae",
+    ".claude/skills/verify-pr/SKILL.md": "8a6c66d9b8933af550038f58587868665daa90c7ac631fc648d92b366bd7e516",
+    ".github/pull_request_template.md": "3ae627043b11a7f26283ee90f68ac8ba6b6b2fb6a24a97f23637ae8ef9dd23e0"
+  }
 }