claudecode-linter 2.1.150 → 2.1.152

package/dist/plugin-schema.js

@@ -25,36 +25,87 @@ function getAjv() {
     addFormats(ajvShared);
     return ajvShared;
 }
-function loadCompiledSchema(fileName) {
-    if (compiledCache.has(fileName))
-        return compiledCache.get(fileName) ?? null;
+function tryReadFile(relPath) {
     const candidates = [
-        ...assetCandidates(import.meta.url, ["..", "contracts", fileName]),
-        ...assetCandidates(import.meta.url, ["..", "..", "contracts", fileName]),
+        ...assetCandidates(import.meta.url, ["..", ...relPath]),
+        ...assetCandidates(import.meta.url, ["..", "..", ...relPath]),
     ];
-    let raw = null;
     for (const p of candidates) {
         try {
-            raw = readFileSync(p, "utf8");
-            break;
+            return readFileSync(p, "utf8");
         }
         catch {
             // try next
         }
     }
+    return null;
+}
+/**
+ * Compile a schema document, handling both wrapper shapes:
+ *   - extracted (`{ extractedFromClaudeCodeVersion, schema: {...} }`)
+ *   - bare JSON Schema (the schemastore.org files, no envelope)
+ */
+function compileSchemaDoc(raw, sourceLabel) {
+    const parsed = JSON.parse(raw);
+    let schema;
+    let version;
+    if ("extractedFromClaudeCodeVersion" in parsed &&
+        typeof parsed.extractedFromClaudeCodeVersion === "string" &&
+        "schema" in parsed &&
+        typeof parsed.schema === "object" &&
+        parsed.schema !== null) {
+        schema = parsed.schema;
+        version = parsed.extractedFromClaudeCodeVersion;
+    }
+    else {
+        // Bare schemastore document. Strip `$id` (Ajv registers it globally
+        // and trips `$id already exists` on a second compile) and any
+        // `$schema` meta-pointer Ajv2020 can't resolve (draft-07 etc.).
+        const { $id: _id, $schema: _meta, ...rest } = parsed;
+        void _id;
+        void _meta;
+        schema = rest;
+        version = sourceLabel;
+    }
+    const propSrc = schema.properties ?? {};
+    return {
+        validate: getAjv().compile(schema),
+        extractedFromVersion: version,
+        knownFields: new Set(Object.keys(propSrc)),
+    };
+}
+function loadCompiledSchema(fileName) {
+    if (compiledCache.has(fileName))
+        return compiledCache.get(fileName) ?? null;
+    const raw = tryReadFile(["contracts", fileName]);
     if (!raw) {
         compiledCache.set(fileName, null);
         return null;
     }
-    const wrapped = JSON.parse(raw);
-    const compiled = {
-        validate: getAjv().compile(wrapped.schema),
-        extractedFromVersion: wrapped.extractedFromClaudeCodeVersion,
-        knownFields: new Set(Object.keys(wrapped.schema.properties ?? {})),
-    };
+    const compiled = compileSchemaDoc(raw, fileName);
     compiledCache.set(fileName, compiled);
     return compiled;
 }
+/**
+ * Load a schemastore.org-curated schema from `contracts/schemastore/`.
+ * Schemastore is preferred for top-level artifact validation because it's
+ * Anthropic's own published source of truth and stays stable across Claude
+ * Code minifier rotations. The Zod-extracted schemas (`loadCompiledSchema`)
+ * remain authoritative for sub-shapes schemastore doesn't enumerate.
+ */
+function loadSchemastoreSchema(fileName) {
+    const cacheKey = `schemastore/${fileName}`;
+    if (compiledCache.has(cacheKey))
+        return compiledCache.get(cacheKey) ?? null;
+    const raw = tryReadFile(["contracts", "schemastore", fileName]);
+    if (!raw) {
+        compiledCache.set(cacheKey, null);
+        return null;
+    }
+    const compiled = compileSchemaDoc(raw, `schemastore:${fileName}`);
+    compiledCache.set(cacheKey, compiled);
+    return compiled;
+}
 export function loadLspSchema() {
     return loadCompiledSchema("lsp.schema.json");
 }
@@ -62,8 +113,24 @@ export function loadMonitorsSchema() {
     return loadCompiledSchema("monitors.schema.json");
 }
 export function loadSettingsSchema() {
+    // gitea#6: prefer the Zod-extracted schema (runtime truth, e.g.
+    // `disableAutoMode` is `boolean` in 2.1.150) over schemastore (which
+    // still lists it as a string literal — out of date). Schemastore is
+    // only used for artifacts with no Zod source (marketplace, keybindings).
     return loadCompiledSchema("settings.schema.json");
 }
+/**
+ * Marketplace and keybindings schemas come exclusively from schemastore —
+ * there is no Zod source for them in the Claude Code bundle. Returns null
+ * if the user's install was shipped without the schemastore bundle (rare;
+ * the package.json includes them in `files`).
+ */
+export function loadMarketplaceSchema() {
+    return loadSchemastoreSchema("marketplace.schema.json");
+}
+export function loadKeybindingsSchema() {
+    return loadSchemastoreSchema("keybindings.schema.json");
+}
 export function loadMcpJsonSchema() {
     return loadCompiledSchema("mcp.schema.json");
 }
@@ -82,36 +149,17 @@ export function loadCommandFrontmatterSchema() {
 export function loadPluginSchema() {
     if (cached)
         return cached;
-    const candidates = [
-        ...assetCandidates(import.meta.url, ["..", "contracts", "plugin.schema.json"]),
-        ...assetCandidates(import.meta.url, [
-            "..",
-            "..",
-            "contracts",
-            "plugin.schema.json",
-        ]),
-    ];
-    let raw = null;
-    for (const p of candidates) {
-        try {
-            raw = readFileSync(p, "utf8");
-            break;
-        }
-        catch {
-            // try next
-        }
-    }
+    // gitea#6: prefer the Zod-extracted plugin.schema.json (runtime truth);
+    // schemastore copy stays committed at `contracts/schemastore/` for
+    // reference and for the marketplace/keybindings artifacts only.
+    const raw = tryReadFile(["contracts", "plugin.schema.json"]);
     if (!raw)
         return null;
-    const wrapped = JSON.parse(raw);
-    const ajv = new Ajv2020({ allErrors: true, strict: false });
-    addFormats(ajv);
-    const validate = ajv.compile(wrapped.schema);
-    const knownFields = new Set(Object.keys(wrapped.schema.properties ?? {}));
+    const compiled = compileSchemaDoc(raw, "plugin.schema.json");
     cached = {
-        validate,
-        extractedFromVersion: wrapped.extractedFromClaudeCodeVersion,
-        knownFields,
+        validate: compiled.validate,
+        extractedFromVersion: compiled.extractedFromVersion,
+        knownFields: compiled.knownFields,
     };
     return cached;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "claudecode-linter",
-	"version": "2.1.150",
+	"version": "2.1.152",
 	"description": "Standalone linter for Claude Code plugins and configuration files",
 	"type": "module",
 	"bin": {
@@ -17,8 +17,9 @@
 		"deps:update": "ncu -u",
 		"knip": "knip --exclude types",
 		"check-deps": "tsx scripts/check-deps.ts",
-		"extract-contracts": "tsx scripts/extract-contracts.ts && tsx scripts/extract-plugin-schema.ts",
+		"extract-contracts": "tsx scripts/extract-contracts.ts && tsx scripts/extract-plugin-schema.ts && tsx scripts/fetch-schemastore.ts",
 		"extract-plugin-schema": "tsx scripts/extract-plugin-schema.ts",
+		"fetch-schemastore": "tsx scripts/fetch-schemastore.ts",
 		"generate-contracts": "tsx scripts/generate-contracts.ts"
 	},
 	"files": [
@@ -32,6 +33,7 @@
 		"contracts/command-frontmatter.schema.json",
 		"contracts/mcp.schema.json",
 		"contracts/hooks.schema.json",
+		"contracts/schemastore/*.json",
 		".claudecode-lint.defaults.yaml",
 		"README.md"
 	],