claudecode-linter 2.1.144 → 2.1.148-patch.2

package/dist/utils/effort.js

@@ -0,0 +1,29 @@
+import { EFFORT_LEVELS } from "../contracts.js";
+/**
+ * Validate a frontmatter `effort` value against the Claude Code contract.
+ *
+ * Claude Code's frontmatter Zod schema types `effort` as a permissive scalar
+ * (`anyOf[string,number,boolean,null]`), but the field's own `.describe()`
+ * string in the bundle reads:
+ *   "Thinking effort for the model: `low`, `medium`, `high`, `max`, or an integer."
+ *
+ * So a valid `effort` is either one of the named levels (EFFORT_LEVELS) or an
+ * integer. Anything else — a non-integer number, a boolean, an unknown string,
+ * null — is reported. Returns a human-readable reason when invalid, or null
+ * when the value is acceptable.
+ */
+export function invalidEffortReason(value) {
+    const valid = [...EFFORT_LEVELS].join(", ");
+    if (typeof value === "string") {
+        if (EFFORT_LEVELS.has(value))
+            return null;
+        return `"effort" string must be one of: ${valid} (got "${value}")`;
+    }
+    if (typeof value === "number") {
+        if (Number.isInteger(value))
+            return null;
+        return `"effort" number must be an integer (got ${value})`;
+    }
+    return `"effort" must be one of: ${valid}, or an integer (got ${JSON.stringify(value)})`;
+}
+//# sourceMappingURL=effort.js.map

package/dist/utils/frontmatter-keys.js

@@ -0,0 +1,67 @@
+import { SKILL_FRONTMATTER, AGENT_FRONTMATTER, COMMAND_FRONTMATTER, } from "../contracts.js";
+import { loadSkillFrontmatterSchema, loadAgentFrontmatterSchema, loadCommandFrontmatterSchema, } from "../plugin-schema.js";
+// Census-extraction sets (scripts/extract-contracts.ts). Used only as a
+// fallback when the auto-extracted frontmatter schema is unavailable — the
+// census extractor lags the schema walker (e.g. it was missing `effort`).
+const CENSUS_FALLBACK = {
+    skill: SKILL_FRONTMATTER,
+    agent: AGENT_FRONTMATTER,
+    command: COMMAND_FRONTMATTER,
+};
+const SCHEMA_LOADERS = {
+    skill: loadSkillFrontmatterSchema,
+    agent: loadAgentFrontmatterSchema,
+    command: loadCommandFrontmatterSchema,
+};
+const keyCache = new Map();
+/**
+ * Known frontmatter keys for an artifact — the union of the auto-extracted
+ * schema's property names (authoritative, complete, kept in sync with Claude
+ * Code's Zod) and the census-contract set. Union rather than schema-only so a
+ * key known to *either* extraction is never mis-flagged: `no-unknown-
+ * frontmatter` is advisory and a false positive is the only real harm.
+ */
+function knownKeys(kind) {
+    const cached = keyCache.get(kind);
+    if (cached)
+        return cached;
+    const merged = new Set(CENSUS_FALLBACK[kind]);
+    const schema = SCHEMA_LOADERS[kind]();
+    if (schema)
+        for (const k of schema.knownFields)
+            merged.add(k);
+    keyCache.set(kind, merged);
+    return merged;
+}
+const ARTIFACT_LABEL = {
+    skill: "skill",
+    agent: "agent",
+    command: "command",
+};
+/**
+ * Classify `key` relative to `self` (the artifact being linted).
+ *
+ * `extraKnown` lets a caller treat a few extra keys as known-for-self (some
+ * linters historically accept hyphenated aliases the contract set lists in a
+ * canonicalized form, e.g. `allowed-tools` / `argument-hint`).
+ */
+export function classifyUnknownFrontmatterKey(key, self, extraKnown = new Set()) {
+    // Known for the current artifact — not unknown at all.
+    if (knownKeys(self).has(key) || extraKnown.has(key))
+        return null;
+    // Valid for some *other* markdown artifact → misplacement.
+    for (const kind of ["skill", "agent", "command"]) {
+        if (kind === self)
+            continue;
+        if (knownKeys(kind).has(key)) {
+            return { kind: "owned-by-other", owner: kind };
+        }
+    }
+    // Valid nowhere → genuinely unfamiliar; callers stay silent.
+    return { kind: "unknown-everywhere" };
+}
+/** Human-readable label for an artifact kind ("skill", "agent", "command"). */
+export function artifactLabel(kind) {
+    return ARTIFACT_LABEL[kind];
+}
+//# sourceMappingURL=frontmatter-keys.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "claudecode-linter",
-	"version": "2.1.144",
+	"version": "2.1.148-patch.2",
 	"description": "Standalone linter for Claude Code plugins and configuration files",
 	"type": "module",
 	"bin": {
@@ -26,6 +26,12 @@
 		"contracts/plugin.schema.json",
 		"contracts/lsp.schema.json",
 		"contracts/monitors.schema.json",
+		"contracts/settings.schema.json",
+		"contracts/skill-frontmatter.schema.json",
+		"contracts/agent-frontmatter.schema.json",
+		"contracts/command-frontmatter.schema.json",
+		"contracts/mcp.schema.json",
+		"contracts/hooks.schema.json",
 		".claudecode-lint.defaults.yaml",
 		"README.md"
 	],
@@ -65,9 +71,9 @@
 		"acorn": "^8.16.0",
 		"acorn-walk": "^8.3.5",
 		"knip": "^6.0.5",
-		"npm-check-updates": "^21.0.3",
+		"npm-check-updates": "^22.2.0",
 		"tsx": "^4.21.0",
 		"typescript": "^6.0.2",
-		"vitest": "4.1.6"
+		"vitest": "4.1.7"
 	}
 }