@theglitchking/gimme-the-lint 1.1.1 → 1.2.0

package/.claude-plugin/marketplace.json

@@ -0,0 +1,47 @@
+{
+  "name": "gimme-the-lint-marketplace",
+  "owner": {
+    "name": "TheGlitchKing",
+    "email": "theglitchking@users.noreply.github.com"
+  },
+  "metadata": {
+    "description": "Official marketplace for gimme-the-lint - Progressive linting with directory-chunked baselines and drift detection",
+    "version": "1.2.0"
+  },
+  "plugins": [
+    {
+      "name": "gimme-the-lint",
+      "description": "Progressive linting system with directory-chunked baselines, drift detection, and auto-healing for monorepo projects (Python + JS/TS)",
+      "version": "1.2.0",
+      "author": {
+        "name": "TheGlitchKing"
+      },
+      "homepage": "https://github.com/TheGlitchKing/gimme-the-lint",
+      "repository": "https://github.com/TheGlitchKing/gimme-the-lint.git",
+      "license": "MIT",
+      "keywords": [
+        "linting",
+        "progressive-linting",
+        "eslint",
+        "ruff",
+        "python",
+        "monorepo",
+        "git-hooks",
+        "drift-detection",
+        "claude-code"
+      ],
+      "category": "productivity",
+      "tags": [
+        "linting",
+        "progressive",
+        "baseline",
+        "drift"
+      ],
+      "source": {
+        "source": "npm",
+        "package": "@theglitchking/gimme-the-lint"
+      },
+      "strict": true
+    }
+  ]
+}

package/.claude-plugin/plugin.json

@@ -1,48 +1,22 @@
 {
   "name": "gimme-the-lint",
-  "version": "1.0.0",
-  "displayName": "Gimme The Lint",
-  "description": "Progressive linting with directory-chunked baselines, drift detection, and auto-healing for monorepo projects",
+  "description": "Progressive linting system with directory-chunked baselines, drift detection, and auto-healing for monorepo projects (Python + JS/TS)",
+  "version": "1.2.0",
   "author": {
     "name": "TheGlitchKing",
-    "email": "theglitchking@users.noreply.github.com",
-    "github": "TheGlitchKing"
+    "email": "theglitchking@users.noreply.github.com"
   },
-  "repository": {
-    "type": "github",
-    "owner": "TheGlitchKing",
-    "repo": "gimme-the-lint",
-    "url": "https://github.com/TheGlitchKing/gimme-the-lint"
-  },
-  "claudeCodeVersion": ">=1.0.0",
-  "type": "claude-plugin",
-  "category": "productivity",
-  "tags": ["linting", "progressive-linting", "eslint", "ruff", "python", "monorepo", "git-hooks", "drift-detection"],
   "license": "MIT",
-  "hooks": {},
-  "commands": [
-    {
-      "name": "lint",
-      "description": "Run progressive linting checks on the current project",
-      "file": "commands/lint.md"
-    },
-    {
-      "name": "lint:status",
-      "description": "Show progressive linting dashboard with drift detection",
-      "file": "commands/lint-status.md"
-    },
-    {
-      "name": "lint:baseline",
-      "description": "Create or refresh linting baselines",
-      "file": "commands/lint-baseline.md"
-    }
-  ],
-  "agents": [
-    {
-      "name": "linting-agent",
-      "description": "Background agent that runs progressive linting and reports results",
-      "type": "general-purpose",
-      "file": "../agents/linting-agent.md"
-    }
+  "homepage": "https://github.com/TheGlitchKing/gimme-the-lint",
+  "repository": "https://github.com/TheGlitchKing/gimme-the-lint",
+  "keywords": [
+    "linting",
+    "progressive-linting",
+    "eslint",
+    "ruff",
+    "python",
+    "monorepo",
+    "git-hooks",
+    "drift-detection"
   ]
 }

package/CHANGELOG.md

@@ -5,6 +5,17 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.1.2] - 2026-04-11
+
+### Fixed
+- Plugin manifest now passes `claude plugin validate`. Rewrote `.claude-plugin/plugin.json` to the minimal schema Claude Code actually accepts (dropped `displayName`, `claudeCodeVersion`, `type`, `commands`, `agents`, `hooks` — all of those were either unsupported keys or wrongly-shaped arrays that the validator rejected).
+- Moved command definitions from `.claude-plugin/commands/*.md` → `commands/*.md` at the repo root (Claude Code's auto-discovery convention).
+- Added YAML frontmatter (`description` field) to all three command files and to `agents/linting-agent.md`.
+
+### Added
+- `.claude-plugin/marketplace.json` — registers gimme-the-lint as a standalone Claude Code marketplace, so users can install with `claude plugin install gimme-the-lint@gimme-the-lint-marketplace`.
+- `commands/` added to npm `files` array so the plugin's slash commands actually ship in the tarball.
+
 ## [1.1.1] - 2026-03-19
 
 ### Fixed

package/agents/linting-agent.md

@@ -1,3 +1,8 @@
+---
+name: linting-agent
+description: Runs progressive linting checks via gimme-the-lint and reports violations. Invoke when the user asks to lint, check code quality, fix lint errors, create/refresh baselines, or diagnose drift.
+---
+
 # Linting Agent
 
 You are a linting agent for gimme-the-lint. Your job is to run progressive linting checks and report results clearly.

package/bin/gimme-the-lint.js

@@ -213,8 +213,23 @@ program
     program.help();
   });
 
-program.parse(process.argv);
+// Runtime-provided subcommands: update, policy, status, relink.
+// Loaded dynamically because the runtime is ESM and this file is CJS.
+(async () => {
+  try {
+    const { registerUpdateCommands } = await import('@theglitchking/claude-plugin-runtime');
+    registerUpdateCommands(program, {
+      packageName: '@theglitchking/gimme-the-lint',
+      pluginName: 'gimme-the-lint',
+      configFile: 'gimme-the-lint.json',
+    });
+  } catch (err) {
+    // Runtime not available — degrade silently; existing subcommands still work.
+  }
 
-if (!process.argv.slice(2).length) {
-  program.help();
-}
+  program.parse(process.argv);
+
+  if (!process.argv.slice(2).length) {
+    program.help();
+  }
+})();

package/{.claude-plugin/commands → commands}/lint-baseline.md

@@ -1,3 +1,7 @@
+---
+description: Create or refresh LTTF linting baselines (captures existing violations so only NEW ones block future commits)
+---
+
 # /lint:baseline - Create or Refresh Baselines
 
 Create LTTF baselines for progressive linting. Baselines capture existing violations so only NEW violations block commits.

package/{.claude-plugin/commands → commands}/lint-status.md

@@ -1,3 +1,7 @@
+---
+description: Show the progressive linting dashboard — baseline status, drift detection, and team ownership across all tracked directories
+---
+
 # /lint:status - Progressive Linting Dashboard
 
 Show the current state of progressive linting across the codebase.

package/{.claude-plugin/commands → commands}/lint.md

@@ -1,3 +1,7 @@
+---
+description: Run progressive linting checks on the current project (only NEW violations above the baseline are flagged)
+---
+
 # /lint - Progressive Linting
 
 Run progressive linting checks on the current project. Only NEW violations are flagged — baseline violations are ignored.

package/commands/policy.md

@@ -0,0 +1,16 @@
+---
+description: Get or set the gimme-the-lint update policy (auto | nudge | off)
+allowed-tools: Bash(npx:*)
+argument-hint: "[auto|nudge|off]"
+---
+
+Arguments: $ARGUMENTS
+
+- If `$ARGUMENTS` is empty, run `npx --no @theglitchking/gimme-the-lint policy` and report the current policy and config path.
+- If `$ARGUMENTS` is one of `auto`, `nudge`, `off`, run `npx --no @theglitchking/gimme-the-lint policy $ARGUMENTS` and confirm the new setting to the user.
+- If `$ARGUMENTS` is anything else, tell the user the valid values are `auto`, `nudge`, `off`.
+
+Policies:
+- `auto`  — auto-run `npm update @theglitchking/gimme-the-lint` at session start when a newer version is available.
+- `nudge` — print a one-liner when a newer version is available (default).
+- `off`   — do not check for updates.

package/commands/relink.md

@@ -0,0 +1,6 @@
+---
+description: Re-run the skill linker — refresh symlinks from node_modules into .claude/skills/
+allowed-tools: Bash(npx:*)
+---
+
+Run `npx --no @theglitchking/gimme-the-lint relink` and report the result.

package/commands/status.md

@@ -0,0 +1,6 @@
+---
+description: Show installed version, latest available version, current update policy, and hook registration state
+allowed-tools: Bash(npx:*)
+---
+
+Run `npx --no @theglitchking/gimme-the-lint status` and relay the output to the user verbatim.

package/commands/update.md

@@ -0,0 +1,6 @@
+---
+description: Update gimme-the-lint to the latest version (runs npm update + re-links skills)
+allowed-tools: Bash(npx:*)
+---
+
+Run `npx --no @theglitchking/gimme-the-lint update` and report the before/after versions to the user. If the project doesn't have a local install, fall back to `npx -y @theglitchking/gimme-the-lint update` and note that in your summary.

package/hooks/hooks.json

@@ -0,0 +1,15 @@
+{
+  "description": "gimme-the-lint update-check hook — nudges/auto-updates per policy.",
+  "hooks": {
+    "SessionStart": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node \"${CLAUDE_PLUGIN_ROOT}/hooks/session-start.mjs\""
+          }
+        ]
+      }
+    ]
+  }
+}

package/hooks/session-start.mjs

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+import { runSessionStart } from "@theglitchking/claude-plugin-runtime";
+
+await runSessionStart({
+  packageName: "@theglitchking/gimme-the-lint",
+  pluginName: "gimme-the-lint",
+  configFile: "gimme-the-lint.json",
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theglitchking/gimme-the-lint",
-  "version": "1.1.1",
+  "version": "1.2.0",
   "description": "Progressive linting system with directory-chunked baselines, drift detection, and auto-healing for monorepo projects (Python + JS/TS)",
   "keywords": [
     "linting",
@@ -34,7 +34,7 @@
     "gimme-the-lint": "./bin/gimme-the-lint.js"
   },
   "scripts": {
-    "postinstall": "node ./bin/postinstall.js",
+    "postinstall": "node ./scripts/link-skills.mjs",
     "setup:venv": "bash ./scripts/setup-venv.sh",
     "install:hooks": "bash ./githooks/install.sh",
     "lint:init": "node ./bin/gimme-the-lint.js init",
@@ -42,7 +42,6 @@
     "check:fix": "node ./bin/gimme-the-lint.js check --fix",
     "baseline": "node ./bin/gimme-the-lint.js baseline",
     "dashboard": "node ./bin/gimme-the-lint.js dashboard",
-    "prepublishOnly": "bash ./scripts/validate-version.sh",
     "test": "node --test tests/*.test.js"
   },
   "files": [
@@ -50,8 +49,10 @@
     "scripts/",
     "templates/",
     "githooks/",
+    "hooks/",
     "lib/",
     ".claude-plugin/",
+    "commands/",
     "agents/",
     "docs/",
     "install.sh",
@@ -61,12 +62,13 @@
     "CHANGELOG.md"
   ],
   "engines": {
-    "node": ">=18.0.0"
+    "node": ">=20.0.0"
   },
   "publishConfig": {
     "access": "public"
   },
   "dependencies": {
+    "@theglitchking/claude-plugin-runtime": "^0.1.0",
     "chalk": "^4.1.2",
     "commander": "^12.1.0",
     "fs-extra": "^11.2.0"

package/scripts/link-skills.mjs

@@ -0,0 +1,22 @@
+#!/usr/bin/env node
+// Postinstall — delegates to @theglitchking/claude-plugin-runtime.
+
+import { runPostinstall } from "@theglitchking/claude-plugin-runtime";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const packageRoot = resolve(dirname(fileURLToPath(import.meta.url)), "..");
+
+try {
+  runPostinstall({
+    packageName: "@theglitchking/gimme-the-lint",
+    pluginName: "gimme-the-lint",
+    configFile: "gimme-the-lint.json",
+    skillsDir: null,
+    packageRoot,
+    hookCommand:
+      "node ./node_modules/@theglitchking/gimme-the-lint/hooks/session-start.mjs",
+  });
+} catch (err) {
+  console.warn(`[gimme-the-lint] postinstall failed: ${err?.message || err}`);
+}

package/bin/postinstall.js

@@ -1,29 +0,0 @@
-#!/usr/bin/env node
-'use strict';
-
-// Post-install script for gimme-the-lint
-// Runs after npm install to show next steps
-// Does NOT auto-setup venv (user should opt-in via `gimme-the-lint install`)
-
-const isGlobal = process.env.npm_config_global === 'true';
-
-console.log('');
-console.log('  gimme-the-lint installed successfully!');
-console.log('');
-
-if (isGlobal) {
-  console.log('  Global install detected. Usage:');
-  console.log('    cd your-project');
-  console.log('    gimme-the-lint install    Initialize configs & venv');
-  console.log('    gimme-the-lint baseline   Create linting baselines');
-  console.log('    gimme-the-lint hooks      Install git hooks');
-} else {
-  console.log('  Next steps:');
-  console.log('    npx gimme-the-lint install    Initialize configs & venv');
-  console.log('    npx gimme-the-lint baseline   Create linting baselines');
-  console.log('    npx gimme-the-lint hooks      Install git hooks');
-}
-
-console.log('');
-console.log('  Documentation: https://github.com/TheGlitchKing/gimme-the-lint');
-console.log('');

package/scripts/validate-version.sh

@@ -1,46 +0,0 @@
-#!/usr/bin/env bash
-# gimme-the-lint: Version Validation (pre-publish check)
-# Ensures package.json version, CHANGELOG.md, and git tag are in sync
-
-set -e
-
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-PACKAGE_DIR="$(cd "$SCRIPT_DIR/.." && pwd)"
-
-RED='\033[0;31m'
-GREEN='\033[0;32m'
-YELLOW='\033[1;33m'
-NC='\033[0m'
-
-PKG_VERSION=$(node -p "require('${PACKAGE_DIR}/package.json').version")
-
-echo "Validating version: v${PKG_VERSION}"
-
-# Check CHANGELOG has entry for this version
-if [ -f "${PACKAGE_DIR}/CHANGELOG.md" ]; then
-    if grep -q "## \[${PKG_VERSION}\]" "${PACKAGE_DIR}/CHANGELOG.md" || grep -q "## ${PKG_VERSION}" "${PACKAGE_DIR}/CHANGELOG.md"; then
-        echo -e "${GREEN}✓${NC} CHANGELOG.md has entry for v${PKG_VERSION}"
-    else
-        echo -e "${YELLOW}⚠${NC} CHANGELOG.md missing entry for v${PKG_VERSION}"
-    fi
-else
-    echo -e "${YELLOW}⚠${NC} CHANGELOG.md not found"
-fi
-
-# Check README exists
-if [ -f "${PACKAGE_DIR}/README.md" ]; then
-    echo -e "${GREEN}✓${NC} README.md exists"
-else
-    echo -e "${RED}✗${NC} README.md missing"
-    exit 1
-fi
-
-# Check LICENSE exists
-if [ -f "${PACKAGE_DIR}/LICENSE" ]; then
-    echo -e "${GREEN}✓${NC} LICENSE exists"
-else
-    echo -e "${RED}✗${NC} LICENSE missing"
-    exit 1
-fi
-
-echo -e "${GREEN}✓${NC} Version validation passed: v${PKG_VERSION}"