@yawlabs/ctxlint 0.12.3 → 0.13.0

package/mcp-config-lint-rules.json

@@ -1,5 +1,5 @@
 {
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$schema": "https://raw.githubusercontent.com/YawLabs/ctxlint/main/schemas/ctxlint-catalog.schema.json",
   "specVersion": "1.0.0-draft",
   "specDate": "2026-04-07",
   "mcpSpecCompatibility": "2025-11-25",

package/mcph-config-lint-rules.json

@@ -1,5 +1,5 @@
 {
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$schema": "https://raw.githubusercontent.com/YawLabs/ctxlint/main/schemas/ctxlint-catalog.schema.json",
   "specVersion": "1.0.0-draft",
   "specDate": "2026-04-16",
   "mcphSchemaReference": "https://raw.githubusercontent.com/YawLabs/mcph/main/schemas/mcph.config.v1.json",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yawlabs/ctxlint",
-  "version": "0.12.3",
+  "version": "0.13.0",
   "mcpName": "io.github.YawLabs/ctxlint",
   "description": "Lint your AI agent context files, MCP server configs, and session data against your actual codebase",
   "bin": {
@@ -10,6 +10,8 @@
   "scripts": {
     "build": "node build.mjs",
     "dev": "node build.mjs",
+    "generate": "node scripts/generate-catalog-prose.mjs",
+    "generate:check": "node scripts/generate-catalog-prose.mjs --check",
     "test": "vitest",
     "test:run": "vitest run",
     "test:coverage": "vitest run --coverage --coverage.reporter=text-summary --coverage.reporter=html --coverage.exclude='**/__tests__/**' --coverage.exclude='**/fixtures/**' --coverage.exclude='dist/**' --coverage.exclude='build.mjs' --coverage.exclude='coverage-report.mjs'",
@@ -56,10 +58,13 @@
     "CONTEXT_LINT_SPEC.md",
     "MCP_CONFIG_LINT_SPEC.md",
     "AGENT_SESSION_LINT_SPEC.md",
+    "AGENT_SKILL_LINT_SPEC.md",
     "context-lint-rules.json",
     "mcp-config-lint-rules.json",
     "mcph-config-lint-rules.json",
     "agent-session-lint-rules.json",
+    "agent-skill-lint-rules.json",
+    "schemas/ctxlint-catalog.schema.json",
     "LICENSE",
     "README.md"
   ],

package/schemas/ctxlint-catalog.schema.json

@@ -0,0 +1,94 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://raw.githubusercontent.com/YawLabs/ctxlint/main/schemas/ctxlint-catalog.schema.json",
+  "title": "ctxlint rule catalog",
+  "description": "Governing schema for the machine-readable rule catalogs that back the ctxlint specifications (context-, mcp-config-, mcph-config-, agent-session-lint-rules.json). Defines the shared metadata block + the rule/category shape every catalog must satisfy. Per-catalog extras (formats, clients, agents, dataSources, target, mcphSchemaReference) are permitted via additionalProperties.",
+  "type": "object",
+  "required": ["$schema", "specVersion", "specDate", "repository", "categories", "rules"],
+  "additionalProperties": true,
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "description": "Points at this governing schema so editors and CI validate against it."
+    },
+    "title": {
+      "type": "string",
+      "description": "Optional human title for the catalog."
+    },
+    "description": {
+      "type": "string",
+      "description": "Optional human description of the catalog's scope."
+    },
+    "specVersion": {
+      "type": "string",
+      "description": "Semantic version of the specification this catalog implements.",
+      "pattern": "^[0-9]+\\.[0-9]+\\.[0-9]+(-[0-9A-Za-z.-]+)?$"
+    },
+    "specDate": {
+      "type": "string",
+      "description": "ISO date (YYYY-MM-DD) the spec version was authored/updated.",
+      "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$"
+    },
+    "mcpSpecCompatibility": {
+      "type": "string",
+      "description": "Shared optional field: the Model Context Protocol wire-spec version this catalog tracks (date-stamped, e.g. \"2025-11-25\"). Present only on catalogs whose rules are bound to the MCP protocol version (mcp-config). Absent (meaningfully) on catalogs that are protocol-agnostic (context, agent-session, mcph-config).",
+      "pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$"
+    },
+    "repository": {
+      "type": "string",
+      "format": "uri",
+      "description": "Canonical repository URL for the reference implementation."
+    },
+    "categories": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "$ref": "#/$defs/category" }
+    },
+    "rules": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "$ref": "#/$defs/rule" }
+    }
+  },
+  "$defs": {
+    "category": {
+      "type": "object",
+      "required": ["id", "name", "description"],
+      "additionalProperties": true,
+      "properties": {
+        "id": { "type": "string", "minLength": 1 },
+        "name": { "type": "string", "minLength": 1 },
+        "description": { "type": "string", "minLength": 1 },
+        "scope": { "type": "string" }
+      }
+    },
+    "rule": {
+      "type": "object",
+      "required": [
+        "id",
+        "category",
+        "severity",
+        "description",
+        "trigger",
+        "message",
+        "fixable",
+        "stability"
+      ],
+      "additionalProperties": true,
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Stable rule ID in ctxlint `category/slug` format (a single `/` separator). NOTE: the sibling mcp-compliance project uses `category-suffix` (a `-` separator) instead; the difference is deliberate -- see CONTRIBUTING.md \"Rule ID format\".",
+          "pattern": "^[a-z0-9-]+/[a-z0-9-]+$"
+        },
+        "category": { "type": "string", "minLength": 1 },
+        "severity": { "type": "string", "enum": ["error", "warning", "info"] },
+        "description": { "type": "string", "minLength": 1 },
+        "trigger": { "type": "string", "minLength": 1 },
+        "message": { "type": "string", "minLength": 1 },
+        "fixable": { "type": "boolean" },
+        "stability": { "type": "string", "enum": ["stable", "experimental"] }
+      }
+    }
+  }
+}