@graphit/cli 0.1.30 → 0.1.38

package/dist/skill-version.d.ts

@@ -0,0 +1,20 @@
+export type SkillInstallKind = "claude-code" | "codex" | "cursor";
+export type SkillInstallScope = "global" | "project";
+export interface SkillInstallTarget {
+    kind: SkillInstallKind;
+    scope: SkillInstallScope;
+    path: string;
+}
+export interface SkillInstallStatus extends SkillInstallTarget {
+    installedVersion: string | null;
+    reason: "legacy-copy-present" | "missing-version" | "older-version";
+}
+interface FindOutdatedOptions {
+    homeDir?: string;
+    cwd?: string;
+}
+export declare function readSkillVersion(path: string): string | null;
+export declare function getSkillInstallTargets(options?: FindOutdatedOptions): SkillInstallTarget[];
+export declare function findOutdatedSkillInstalls(currentVersion: string, options?: FindOutdatedOptions): SkillInstallStatus[];
+export declare function formatSkillStalenessBanner(statuses: SkillInstallStatus[], currentVersion: string): string | null;
+export {};

package/dist/skill-version.js

@@ -0,0 +1,139 @@
+import { existsSync, readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+function compareVersions(left, right) {
+    const leftParts = left.split(".").map(Number);
+    const rightParts = right.split(".").map(Number);
+    for (let index = 0; index < 3; index += 1) {
+        const leftPart = leftParts[index] ?? 0;
+        const rightPart = rightParts[index] ?? 0;
+        if (leftPart > rightPart)
+            return 1;
+        if (leftPart < rightPart)
+            return -1;
+    }
+    return 0;
+}
+function readVersionJson(path) {
+    try {
+        if (!existsSync(path))
+            return null;
+        const parsed = JSON.parse(readFileSync(path, "utf-8"));
+        return typeof parsed.version === "string" ? parsed.version : null;
+    }
+    catch {
+        return null;
+    }
+}
+export function readSkillVersion(path) {
+    try {
+        const content = readFileSync(path, "utf-8");
+        const match = content.match(/^skill_version:\s*["']?([^"'\n]+)["']?\s*$/m);
+        return match?.[1] ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+function readInstalledVersion(target) {
+    if (!existsSync(target.path))
+        return null;
+    if (target.kind !== "cursor") {
+        const versionJson = readVersionJson(join(target.path.replace(/SKILL\.md$/, ""), "VERSION.json"));
+        if (versionJson)
+            return versionJson;
+    }
+    return readSkillVersion(target.path);
+}
+function isPluginManagedKind(kind) {
+    return kind === "claude-code" || kind === "codex";
+}
+export function getSkillInstallTargets(options = {}) {
+    const home = options.homeDir ?? homedir();
+    const cwd = options.cwd ?? process.cwd();
+    return [
+        {
+            kind: "claude-code",
+            scope: "global",
+            path: join(home, ".claude", "skills", "graphit", "SKILL.md"),
+        },
+        {
+            kind: "codex",
+            scope: "global",
+            path: join(home, ".codex", "skills", "graphit", "SKILL.md"),
+        },
+        {
+            kind: "cursor",
+            scope: "global",
+            path: join(home, ".cursor", "rules", "graphit.mdc"),
+        },
+        {
+            kind: "claude-code",
+            scope: "project",
+            path: join(cwd, ".claude", "skills", "graphit", "SKILL.md"),
+        },
+        {
+            kind: "codex",
+            scope: "project",
+            path: join(cwd, ".codex", "skills", "graphit", "SKILL.md"),
+        },
+        {
+            kind: "cursor",
+            scope: "project",
+            path: join(cwd, ".cursor", "rules", "graphit.mdc"),
+        },
+    ];
+}
+export function findOutdatedSkillInstalls(currentVersion, options = {}) {
+    const statuses = [];
+    for (const target of getSkillInstallTargets(options)) {
+        if (!existsSync(target.path))
+            continue;
+        const installedVersion = readInstalledVersion(target);
+        if (isPluginManagedKind(target.kind)) {
+            statuses.push({ ...target, installedVersion, reason: "legacy-copy-present" });
+            continue;
+        }
+        if (!installedVersion) {
+            statuses.push({ ...target, installedVersion: null, reason: "missing-version" });
+            continue;
+        }
+        if (compareVersions(installedVersion, currentVersion) < 0) {
+            statuses.push({ ...target, installedVersion, reason: "older-version" });
+        }
+    }
+    return statuses;
+}
+function formatKind(kind) {
+    switch (kind) {
+        case "claude-code":
+            return "Claude Code";
+        case "codex":
+            return "Codex";
+        case "cursor":
+            return "Cursor";
+    }
+}
+export function formatSkillStalenessBanner(statuses, currentVersion) {
+    if (statuses.length === 0)
+        return null;
+    const lines = statuses.map((status) => {
+        const installed = status.installedVersion ?? "unversioned";
+        if (status.reason === "legacy-copy-present") {
+            return `  - ${formatKind(status.kind)} ${status.scope}: legacy copied snapshot present (${installed})`;
+        }
+        return `  - ${formatKind(status.kind)} ${status.scope}: ${installed} → ${currentVersion}`;
+    });
+    const hasPluginManagedCopies = statuses.some((status) => isPluginManagedKind(status.kind));
+    const hasCursorCopies = statuses.some((status) => status.kind === "cursor");
+    return ("\n  Legacy copied Graphit assistant files need attention:\n" +
+        `${lines.join("\n")}\n` +
+        (hasPluginManagedCopies
+            ? "  Claude Code/Codex should use the Graphit plugin bundle. Remove old copied snapshots with `graphit setup --remove-legacy-copies` after confirming the plugin is installed.\n"
+            : "") +
+        (hasCursorCopies
+            ? "  Cursor currently uses copied rules; refresh them with `graphit setup --editor cursor --update`.\n"
+            : "") +
+        "  Update Graphit through your assistant's plugin manager whenever plugin install is available.\n\n");
+}
+//# sourceMappingURL=skill-version.js.map

package/dist/skill-version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-version.js","sourceRoot":"","sources":["../src/skill-version.ts"],"names":[],"mappings":"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"}

package/dist/update-check.js

@@ -2,6 +2,7 @@ import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
 import { homedir } from "os";
 import { join } from "path";
 import { createRequire } from "module";
+import { findOutdatedSkillInstalls, formatSkillStalenessBanner, } from "./skill-version.js";
 const require = createRequire(import.meta.url);
 const pkg = require("../package.json");
 const REGISTRY_URL = "https://registry.npmjs.org/@graphit/cli/latest";
@@ -45,13 +46,16 @@ export function getCurrentVersion() {
 }
 export function printUpdateBanner() {
     const cache = readCache();
-    if (!cache)
-        return;
     const current = getCurrentVersion();
-    if (!isNewer(cache.latestVersion, current))
-        return;
-    process.stderr.write(`\n  Update available: ${current} → ${cache.latestVersion}\n` +
-        `  Run \`npm update -g @graphit/cli\` to update\n\n`);
+    if (cache && isNewer(cache.latestVersion, current)) {
+        process.stderr.write(`\n  Update available: ${current} → ${cache.latestVersion}\n` +
+            "  Update Graphit through your assistant's plugin manager when available.\n" +
+            "  Standalone npm users can run `npm update -g @graphit/cli`.\n\n");
+    }
+    const skillBanner = formatSkillStalenessBanner(findOutdatedSkillInstalls(current), current);
+    if (skillBanner) {
+        process.stderr.write(skillBanner);
+    }
 }
 export function fireBackgroundCheck() {
     const cache = readCache();

package/dist/update-check.js.map

@@ -1 +1 @@
-{"version":3,"file":"update-check.js","sourceRoot":"","sources":["../src/update-check.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AACxE,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAC7B,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAEvC,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,GAAG,GAAG,OAAO,CAAC,iBAAiB,CAAwB,CAAC;AAE9D,MAAM,YAAY,GAAG,gDAAgD,CAAC;AACtE,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,UAAU,CAAC,CAAC;AAC9C,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,EAAE,mBAAmB,CAAC,CAAC;AACxD,MAAM,MAAM,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAOnC,SAAS,SAAS;IAChB,IAAI,CAAC;QACH,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC;YAAE,OAAO,IAAI,CAAC;QACzC,MAAM,GAAG,GAAG,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QAC9C,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAe,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CAAC,KAAiB;IACnC,IAAI,CAAC;QACH,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;YAAE,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACtE,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;IACnD,CAAC;IAAC,MAAM,CAAC;QACP,+CAA+C;IACjD,CAAC;AACH,CAAC;AAED,SAAS,OAAO,CAAC,MAAc,EAAE,OAAe;IAC9C,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACxC,MAAM,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACzC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC;QAC3C,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAAE,OAAO,KAAK,CAAC;IAC9C,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,OAAO,GAAG,CAAC,OAAO,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,MAAM,KAAK,GAAG,SAAS,EAAE,CAAC;IAC1B,IAAI,CAAC,KAAK;QAAE,OAAO;IAEnB,MAAM,OAAO,GAAG,iBAAiB,EAAE,CAAC;IACpC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,aAAa,EAAE,OAAO,CAAC;QAAE,OAAO;IAEnD,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,yBAAyB,OAAO,MAAM,KAAK,CAAC,aAAa,IAAI;QAC3D,oDAAoD,CACvD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,mBAAmB;IACjC,MAAM,KAAK,GAAG,SAAS,EAAE,CAAC;IAC1B,IAAI,KAAK,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,SAAS,GAAG,MAAM;QAAE,OAAO;IAE3D,KAAK,CAAC,YAAY,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;SACvD,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE;QACZ,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,OAAO;QACpB,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC;IACpB,CAAC,CAAC;SACD,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;QACb,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,SAAS,IAAI,IAAI,EAAE,CAAC;YAC1D,UAAU,CAAC;gBACT,aAAa,EAAG,IAA4B,CAAC,OAAO;gBACpD,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;aACtB,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC;SACD,KAAK,CAAC,GAAG,EAAE;QACV,2CAA2C;IAC7C,CAAC,CAAC,CAAC;AACP,CAAC"}
+{"version":3,"file":"update-check.js","sourceRoot":"","sources":["../src/update-check.ts"],"names":[],"mappings":"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"}

package/hooks/hooks.json

@@ -0,0 +1,30 @@
+{
+  "description": "Graphit plugin status checks",
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "startup|resume|clear|compact",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node",
+            "args": ["${CLAUDE_PLUGIN_ROOT}/scripts/plugin-status.mjs", "--hook", "SessionStart"],
+            "timeout": 5
+          }
+        ]
+      }
+    ],
+    "UserPromptSubmit": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node",
+            "args": ["${CLAUDE_PLUGIN_ROOT}/scripts/plugin-status.mjs", "--hook", "UserPromptSubmit"],
+            "timeout": 5
+          }
+        ]
+      }
+    ]
+  }
+}

package/package.json

@@ -1,15 +1,18 @@
 {
   "name": "@graphit/cli",
-  "version": "0.1.30",
+  "version": "0.1.38",
   "description": "Graphit CLI - Build custom dashboards from any AI coding assistant",
   "type": "module",
   "bin": {
     "graphit": "./dist/index.js"
   },
   "scripts": {
-    "build": "tsc",
+    "build": "npm run sync:version && tsc",
     "dev": "tsx src/index.ts",
-    "lint": "tsc --noEmit"
+    "lint": "npm run check:version && tsc --noEmit",
+    "test": "npm run build && node --test test/*.test.mjs",
+    "sync:version": "node scripts/sync-plugin-version.mjs",
+    "check:version": "node scripts/sync-plugin-version.mjs --check"
   },
   "engines": {
     "node": ">=18"
@@ -17,6 +20,8 @@
   "files": [
     "dist",
     "skills",
+    "hooks",
+    "scripts",
     ".claude-plugin",
     ".codex-plugin"
   ],

package/scripts/plugin-status.mjs

@@ -0,0 +1,285 @@
+#!/usr/bin/env node
+
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const REGISTRY_URL = "https://registry.npmjs.org/@graphit/cli/latest";
+const TTL_MS = 24 * 60 * 60 * 1000;
+const args = new Set(process.argv.slice(2));
+const hookIndex = process.argv.indexOf("--hook");
+const hookEvent = hookIndex >= 0 ? process.argv[hookIndex + 1] : null;
+const pluginRoot =
+  process.env.CLAUDE_PLUGIN_ROOT ??
+  process.env.CODEX_PLUGIN_ROOT ??
+  process.env.GRAPHIT_PLUGIN_ROOT ??
+  dirname(dirname(fileURLToPath(import.meta.url)));
+const cacheRoot =
+  process.env.CLAUDE_PLUGIN_DATA ??
+  process.env.CODEX_PLUGIN_DATA ??
+  process.env.GRAPHIT_PLUGIN_DATA ??
+  join(homedir(), ".graphit");
+
+function readJson(path) {
+  return JSON.parse(readFileSync(path, "utf-8"));
+}
+
+function tryReadJson(path) {
+  try {
+    if (!existsSync(path)) return null;
+    return readJson(path);
+  } catch {
+    return null;
+  }
+}
+
+function readFrontmatterVersion(path) {
+  try {
+    const content = readFileSync(path, "utf-8");
+    return content.match(/^skill_version:\s*["']?([^"'\n]+)["']?\s*$/m)?.[1] ?? null;
+  } catch {
+    return null;
+  }
+}
+
+function compareVersions(left, right) {
+  const leftParts = left.split(".").map(Number);
+  const rightParts = right.split(".").map(Number);
+
+  for (let index = 0; index < 3; index += 1) {
+    const leftPart = leftParts[index] ?? 0;
+    const rightPart = rightParts[index] ?? 0;
+    if (leftPart > rightPart) return 1;
+    if (leftPart < rightPart) return -1;
+  }
+
+  return 0;
+}
+
+function copiedSkillTargets(home = homedir(), cwd = process.cwd()) {
+  return [
+    { kind: "claude-code", label: "Claude Code global", scope: "global", path: join(home, ".claude", "skills", "graphit", "SKILL.md") },
+    { kind: "codex", label: "Codex global", scope: "global", path: join(home, ".codex", "skills", "graphit", "SKILL.md") },
+    { kind: "cursor", label: "Cursor global", scope: "global", path: join(home, ".cursor", "rules", "graphit.mdc") },
+    { kind: "claude-code", label: "Claude Code project", scope: "project", path: join(cwd, ".claude", "skills", "graphit", "SKILL.md") },
+    { kind: "codex", label: "Codex project", scope: "project", path: join(cwd, ".codex", "skills", "graphit", "SKILL.md") },
+    { kind: "cursor", label: "Cursor project", scope: "project", path: join(cwd, ".cursor", "rules", "graphit.mdc") },
+  ];
+}
+
+function isPluginManagedKind(kind) {
+  return kind === "claude-code" || kind === "codex";
+}
+
+function readCopiedSkillVersion(path) {
+  if (!existsSync(path)) return null;
+  const versionJson = path.endsWith("SKILL.md")
+    ? tryReadJson(join(dirname(path), "VERSION.json"))
+    : null;
+  return versionJson?.version ?? readFrontmatterVersion(path);
+}
+
+function readCache(path) {
+  try {
+    if (!existsSync(path)) return null;
+    return readJson(path);
+  } catch {
+    return null;
+  }
+}
+
+function writeCache(path, entry) {
+  try {
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, JSON.stringify(entry), "utf-8");
+  } catch {
+    // Cache writes should never break startup hooks.
+  }
+}
+
+async function getLatestVersion(currentVersion) {
+  if (args.has("--skip-network")) return null;
+
+  const cachePath = join(cacheRoot, "plugin-status.json");
+  const cache = readCache(cachePath);
+  if (cache?.latestVersion && Date.now() - cache.checkedAt < TTL_MS) {
+    return cache.latestVersion;
+  }
+
+  try {
+    const response = await fetch(REGISTRY_URL, { signal: AbortSignal.timeout(1500) });
+    if (!response.ok) return cache?.latestVersion ?? null;
+    const data = await response.json();
+    if (data && typeof data.version === "string") {
+      writeCache(cachePath, { latestVersion: data.version, checkedAt: Date.now() });
+      return data.version;
+    }
+  } catch {
+    return cache?.latestVersion ?? null;
+  }
+
+  return currentVersion;
+}
+
+function shouldRunForPrompt() {
+  if (hookEvent !== "UserPromptSubmit") return true;
+
+  let input = "";
+  try {
+    input = readFileSync(0, "utf-8");
+  } catch {
+    return false;
+  }
+
+  const parsed = tryParseJson(input);
+  const prompt = String(parsed?.prompt ?? parsed?.user_prompt ?? input).toLowerCase();
+  return (
+    prompt.includes("graphit") &&
+    /\b(update|version|status|doctor|plugin|stale|staleness)\b/.test(prompt)
+  );
+}
+
+function tryParseJson(value) {
+  try {
+    return JSON.parse(value);
+  } catch {
+    return null;
+  }
+}
+
+async function collectStatus() {
+  const packageJson = readJson(join(pluginRoot, "package.json"));
+  const currentVersion = packageJson.version;
+  const findings = [];
+  const metadata = [];
+  const claudePlugin = tryReadJson(join(pluginRoot, ".claude-plugin", "plugin.json"));
+  const codexPlugin = tryReadJson(join(pluginRoot, ".codex-plugin", "plugin.json"));
+  const marketplace = tryReadJson(join(pluginRoot, ".claude-plugin", "marketplace.json"));
+  const marketplacePlugin = marketplace?.plugins?.find((plugin) => plugin.name === "graphit");
+
+  const versionChecks = [
+    [".claude-plugin/plugin.json", claudePlugin?.version],
+    [".codex-plugin/plugin.json", codexPlugin?.version],
+    [".claude-plugin/marketplace.json metadata", marketplace?.metadata?.version],
+    [".claude-plugin/marketplace.json plugin", marketplacePlugin?.version],
+    ["skills/graphit/VERSION.json", tryReadJson(join(pluginRoot, "skills", "graphit", "VERSION.json"))?.version],
+    ["skills/graphit/SKILL.md", readFrontmatterVersion(join(pluginRoot, "skills", "graphit", "SKILL.md"))],
+    ["skills/graphit/graphit.mdc", readFrontmatterVersion(join(pluginRoot, "skills", "graphit", "graphit.mdc"))],
+  ];
+
+  for (const [label, version] of versionChecks) {
+    if (version !== currentVersion) {
+      findings.push({
+        type: "metadata-drift",
+        message: `${label} is ${version ?? "missing"}, expected ${currentVersion}`,
+        remediation: "Run `npm run sync:version` before publishing @graphit/cli.",
+      });
+    }
+    metadata.push({ label, version: version ?? null });
+  }
+
+  const marketplaceSource = marketplacePlugin?.source;
+  const sourceMatches =
+    marketplaceSource?.source === "npm" &&
+    marketplaceSource.package === packageJson.name &&
+    marketplaceSource.version === currentVersion;
+  metadata.push({
+    label: ".claude-plugin/marketplace.json source",
+    version: marketplaceSource?.version ?? null,
+    source: marketplaceSource ?? null,
+  });
+  if (!sourceMatches) {
+    findings.push({
+      type: "metadata-drift",
+      message: `.claude-plugin/marketplace.json source is ${
+        marketplaceSource ? JSON.stringify(marketplaceSource) : "missing"
+      }, expected npm source ${packageJson.name}@${currentVersion}`,
+      remediation: "Run `npm run sync:version` before publishing @graphit/cli.",
+    });
+  }
+
+  const latestVersion = await getLatestVersion(currentVersion);
+  if (latestVersion && compareVersions(latestVersion, currentVersion) > 0) {
+    findings.push({
+      type: "package-update",
+      message: `@graphit/cli update available: ${currentVersion} -> ${latestVersion}`,
+      remediation: "Update Graphit through your assistant's plugin manager. Claude Code users can run `claude plugin update graphit`; Codex plugin users should use the Codex plugin update command. Standalone npm users can run `npm update -g @graphit/cli`.",
+    });
+  }
+
+  for (const target of copiedSkillTargets()) {
+    const { label, path } = target;
+    if (!existsSync(path)) continue;
+    const version = readCopiedSkillVersion(path);
+    if (isPluginManagedKind(target.kind)) {
+      findings.push({
+        type: "legacy-copied-skill-present",
+        message: `${label} legacy copied skill exists at ${path} (${version ?? "unversioned"})`,
+        remediation: "Claude Code and Codex should use the Graphit plugin bundle. Remove legacy copied snapshots with `graphit setup --remove-legacy-copies` after confirming the plugin is installed.",
+      });
+      continue;
+    }
+
+    if (!version || compareVersions(version, currentVersion) < 0) {
+      findings.push({
+        type: "copied-skill-stale",
+        message: `${label} copied skill is ${version ?? "unversioned"}, expected ${currentVersion}`,
+        remediation: "Cursor currently uses copied rules; refresh them with `graphit setup --editor cursor --update`.",
+      });
+    }
+  }
+
+  return {
+    packageName: packageJson.name,
+    sourceOfTruth: "plugin-bundle",
+    currentVersion,
+    latestVersion,
+    metadata,
+    findings,
+  };
+}
+
+function formatPlain(status) {
+  if (status.findings.length === 0) {
+    return `Graphit plugin status OK (${status.currentVersion}).`;
+  }
+
+  return [
+    `Graphit plugin status needs attention (${status.currentVersion}):`,
+    ...status.findings.map((finding) => `- ${finding.message}\n  ${finding.remediation}`),
+  ].join("\n");
+}
+
+function formatHookContext(status) {
+  if (status.findings.length === 0) return null;
+
+  return [
+    "Graphit plugin status check found actionable update/version information.",
+    ...status.findings.map((finding) => `- ${finding.message}. ${finding.remediation}`),
+  ].join("\n");
+}
+
+if (hookEvent && !shouldRunForPrompt()) {
+  process.exit(0);
+}
+
+const status = await collectStatus();
+
+if (args.has("--json")) {
+  console.log(JSON.stringify(status, null, 2));
+} else if (hookEvent) {
+  const additionalContext = formatHookContext(status);
+  if (additionalContext) {
+    console.log(JSON.stringify({
+      hookSpecificOutput: {
+        hookEventName: hookEvent,
+        additionalContext,
+      },
+    }));
+  }
+} else if (!args.has("--quiet") || status.findings.length > 0) {
+  console.log(formatPlain(status));
+}
+
+process.exit(status.findings.length > 0 && args.has("--fail-on-findings") ? 1 : 0);