@kavishdua/proctor 1.4.0 → 1.6.0

package/dist/scripts/postinstall.js

@@ -1,215 +1,20 @@
 #!/usr/bin/env node
-
-// src/scripts/postinstall.ts
-import { spawnSync } from "child_process";
-import { existsSync } from "fs";
-import { dirname, join as join2, resolve } from "path";
-import { fileURLToPath } from "url";
-
-// src/adapters/detect.ts
-import { stat } from "fs/promises";
-import { join } from "path";
-
-// src/adapters/registry.ts
-function cursorMdcTransform(canonical) {
-  return `---
+import { createRequire as __proctorCreateRequire } from 'node:module'; const require = __proctorCreateRequire(import.meta.url);
+import{spawnSync}from"child_process";import{existsSync}from"fs";import{dirname,join as join2,resolve}from"path";import{fileURLToPath}from"url";import{stat}from"fs/promises";import{join}from"path";function cursorMdcTransform(canonical){return`---
 description: proctor honest-completion ruleset, catches tests deleted, skipped, weakened, or gamed to fake a passing build
 globs: '**'
 alwaysApply: true
 ---
 
-${canonical}`;
-}
-function skillFrontmatterTransform(canonical) {
-  return `---
+${canonical}`}function skillFrontmatterTransform(canonical){return`---
 name: proctor
 description: Honest-completion ruleset for changes that touch tests or the code they cover. Use before deleting, skipping, renaming, or rewriting a test, before weakening an assertion, and before hardcoding or stubbing an implementation to make a test pass. Also covers what to do when a test looks genuinely wrong.
 ---
 
-${canonical}`;
-}
-function copilotApplyToTransform(canonical) {
-  return `---
+${canonical}`}function copilotApplyToTransform(canonical){return`---
 applyTo: '**'
 ---
 
-${canonical}`;
-}
-var AGENT_ADAPTERS = [
-  // Claude Code gets skill frontmatter via skillFrontmatterTransform so the ruleset carries an explicit
-  // description and loads when it is actually relevant.
-  { id: "claude-code", displayName: "Claude Code", relativePath: ".claude/skills/proctor/SKILL.md", scriptable: true, transform: skillFrontmatterTransform, detect: [".claude", "CLAUDE.md"] },
-  // Codex reads skills from `.agents/skills/` and REQUIRES `name` and `description` frontmatter;
-  // without it the skill is not recognized, so this path needs the same transform Claude Code uses.
-  { id: "codex", displayName: "Codex CLI", relativePath: ".agents/skills/proctor/SKILL.md", scriptable: true, transform: skillFrontmatterTransform, detect: [".codex", ".agents/skills"] },
-  // Cursor gets .mdc YAML frontmatter (description/globs/alwaysApply) via cursorMdcTransform
-  // so the rule reliably auto-attaches.
-  { id: "cursor", displayName: "Cursor", relativePath: ".cursor/rules/proctor.mdc", scriptable: true, transform: cursorMdcTransform, detect: [".cursor", ".cursorrules"] },
-  // Windsurf's rules.md is the workspace rules file users write their own rules into, not a
-  // proctor-owned path, so it merges rather than overwrites.
-  { id: "windsurf", displayName: "Windsurf", relativePath: ".windsurf/rules/rules.md", scriptable: false, shared: true, detect: [".windsurf", ".windsurfrules"] },
-  { id: "gemini-cli", displayName: "Gemini CLI", relativePath: "GEMINI.md", scriptable: true, shared: true, detect: [".gemini"] },
-  { id: "aider", displayName: "Aider", relativePath: "CONVENTIONS.md", scriptable: true, shared: true, detect: [".aider.conf.yml", ".aider.conf.yaml"] },
-  { id: "continue", displayName: "Continue.dev", relativePath: ".continue/rules/proctor.md", scriptable: true, detect: [".continue"] },
-  { id: "cline", displayName: "Cline", relativePath: ".clinerules/proctor.md", scriptable: true, detect: [".clinerules"] },
-  // Amazon Q Developer CLI is mid-transition to a closed-source "Kiro CLI", so treat this path
-  // as unstable: adapter only, no bench runner wired up.
-  { id: "amazon-q", displayName: "Amazon Q Developer", relativePath: ".amazonq/rules/proctor.md", scriptable: false, detect: [".amazonq"] },
-  // GitHub Copilot gets `applyTo: '**'` frontmatter via copilotApplyToTransform so the scoped
-  // instructions file actually activates.
-  // Detection deliberately does not treat a bare `.github/` as Copilot: nearly every repo has one.
-  { id: "github-copilot", displayName: "GitHub Copilot", relativePath: ".github/instructions/proctor.instructions.md", scriptable: false, transform: copilotApplyToTransform, detect: [".github/instructions", ".github/copilot-instructions.md"] },
-  { id: "zed", displayName: "Zed", relativePath: ".rules", scriptable: false, shared: true, detect: [".zed"] },
-  // Universal cross-vendor AGENTS.md standard (Linux Foundation-stewarded). Also covers Codex
-  // CLI's actual documented convention (developers.openai.com/codex/guides/agents-md) for free,
-  // the existing `codex` entry above deliberately keeps its original `.agents/skills/` path.
-  { id: "agents-md", displayName: "AGENTS.md (universal)", relativePath: "AGENTS.md", scriptable: false, shared: true },
-  // OpenHands' repo microagent is the one repo-wide instructions file, user-authored.
-  { id: "openhands", displayName: "OpenHands", relativePath: ".openhands/microagents/repo.md", scriptable: true, shared: true, detect: [".openhands"] },
-  // Kiro (AWS agentic IDE / Kiro CLI) intentionally coexists with the `amazon-q` entry above,
-  // they are two separately-installed products today. Revisit consolidation if the
-  // Amazon Q to Kiro merge ever completes.
-  { id: "kiro", displayName: "Kiro", relativePath: ".kiro/steering/proctor.md", scriptable: true, detect: [".kiro"] },
-  { id: "tabnine", displayName: "Tabnine", relativePath: ".tabnine/guidelines/proctor.md", scriptable: true, detect: [".tabnine"] },
-  { id: "trae", displayName: "Trae", relativePath: ".trae/rules/proctor.md", scriptable: false, detect: [".trae"] },
-  { id: "github-copilot-global", displayName: "GitHub Copilot (global)", relativePath: ".github/copilot-instructions.md", scriptable: false, shared: true, detect: [".github/instructions"] },
-  // Qodo's canonical path is a generic, un-namespaced repo-root filename that will often already
-  // hold unrelated user content, so it merges into a managed block instead of overwriting.
-  { id: "qodo", displayName: "Qodo", relativePath: "best_practices.md", scriptable: true, shared: true, detect: [".qodo"] },
-  // --- Agents added after the first roster, all with a stable file-based repo convention ---
-  // Roo Code reads every file under .roo/rules/ recursively, so a proctor-owned file drops in
-  // cleanly alongside whatever else the user keeps there.
-  { id: "roo-code", displayName: "Roo Code", relativePath: ".roo/rules/proctor.md", scriptable: false, detect: [".roo", ".roomodes"] },
-  // Kilo Code v7 moved config to kilo.jsonc but still auto-includes .kilocode/rules/ for
-  // backward compatibility, which is the only path proctor can write without editing user config.
-  { id: "kilo-code", displayName: "Kilo Code", relativePath: ".kilocode/rules/proctor.md", scriptable: true, detect: [".kilocode", "kilo.jsonc"] },
-  { id: "augment", displayName: "Augment Code", relativePath: ".augment/rules/proctor.md", scriptable: true, detect: [".augment"] },
-  // Google Antigravity defaults to .agents/rules/ (with .agent/rules/ still read as a fallback).
-  // Distinct subdirectory from the `codex` entry's .agents/skills/, so the two never collide.
-  { id: "antigravity", displayName: "Google Antigravity", relativePath: ".agents/rules/proctor.md", scriptable: false, detect: [".agents/rules", ".agent/rules"] },
-  // goose reads a single .goosehints file per directory, user-authored.
-  { id: "goose", displayName: "goose", relativePath: ".goosehints", scriptable: true, shared: true },
-  // Junie now prefers AGENTS.md (covered above) but still reads .junie/guidelines.md, which
-  // keeps older Junie installs covered.
-  { id: "junie", displayName: "JetBrains Junie", relativePath: ".junie/guidelines.md", scriptable: true, shared: true, detect: [".junie"] },
-  { id: "qwen-code", displayName: "Qwen Code", relativePath: "QWEN.md", scriptable: true, shared: true, detect: [".qwen"] },
-  // Crush reads CRUSH.md for Crush-specific rules in addition to AGENTS.md.
-  { id: "crush", displayName: "Crush", relativePath: "CRUSH.md", scriptable: true, shared: true, detect: [".crush"] },
-  // Warp defaults to AGENTS.md now, but WARP.md still takes priority when both exist, so the
-  // ruleset has to be in both for Warp users who already have a WARP.md.
-  { id: "warp", displayName: "Warp", relativePath: "WARP.md", scriptable: false, shared: true },
-  // Amp's own file is AGENT.md, singular, which is a different file from the universal AGENTS.md.
-  { id: "amp", displayName: "Amp", relativePath: "AGENT.md", scriptable: true, shared: true },
-  // Firebase Studio generates .idx/airules.md with its own default rules, so merge rather than
-  // replace them.
-  { id: "firebase-studio", displayName: "Firebase Studio", relativePath: ".idx/airules.md", scriptable: false, shared: true, detect: [".idx"] },
-  // Replit Agent reads AGENTS.md as well, but replit.md is its native file and is auto-generated.
-  { id: "replit", displayName: "Replit Agent", relativePath: "replit.md", scriptable: false, shared: true, detect: [".replit"] }
-];
-
-// src/adapters/detect.ts
-var FALLBACK_ADAPTER_ID = "agents-md";
-async function exists(cwd, relativePath) {
-  try {
-    await stat(join(cwd, relativePath));
-    return true;
-  } catch {
-    return false;
-  }
-}
-async function detectAgents(cwd) {
-  const detected = await Promise.all(
-    AGENT_ADAPTERS.map(async (adapter) => {
-      for (const marker of [adapter.relativePath, ...adapter.detect ?? []]) {
-        if (await exists(cwd, marker)) return adapter;
-      }
-      return void 0;
-    })
-  );
-  const found = detected.filter((a) => a !== void 0);
-  if (found.length > 0) return found;
-  const fallback = AGENT_ADAPTERS.find((a) => a.id === FALLBACK_ADAPTER_ID);
-  return fallback ? [fallback] : [];
-}
-
-// src/scripts/postinstall.ts
-var projectDir = process.env.INIT_CWD;
-function packageRoot() {
-  let dir = fileURLToPath(new URL(".", import.meta.url));
-  for (let i = 0; i < 6; i++) {
-    if (existsSync(join2(dir, "package.json"))) return dir;
-    const parent = dirname(dir);
-    if (parent === dir) break;
-    dir = parent;
-  }
-  return dir;
-}
-function skipReason(root) {
-  if (process.env.PROCTOR_NO_POSTINSTALL) return "PROCTOR_NO_POSTINSTALL is set";
-  if (process.env.CI) return "running in CI, where the checkout is disposable";
-  if (process.env.npm_config_global === "true") return "this is a global install, with no project to set up";
-  if (!projectDir) return "INIT_CWD is not set, so the target project is unknown";
-  const target = resolve(projectDir);
-  if (target === resolve(root)) return "this is proctor\u2019s own repository";
-  if (target.split(/[\\/]/).includes("node_modules")) return "installed as a transitive dependency";
-  if (target.includes("_npx") || target.includes(".npm/_cacache")) return "running via npx, not installing into a project";
-  if (!existsSync(join2(target, ".git"))) return "no git repository here, so there is no commit to guard";
-  return void 0;
-}
-async function printNotice(target) {
-  let agentPaths = [];
-  try {
-    agentPaths = (await detectAgents(target)).map((a) => a.relativePath);
-  } catch {
-  }
-  const lines = [
-    "",
-    "proctor is installed. It has written nothing to your repository.",
-    "",
-    "  npx proctor setup",
-    "",
-    "That one command would write, and nothing else:",
-    agentPaths.length > 0 ? `  - the honest-completion ruleset to ${agentPaths.length} agent path${agentPaths.length === 1 ? "" : "s"}: ${agentPaths.join(", ")}` : "  - the honest-completion ruleset to the agent paths this repo already uses (AGENTS.md if none are detected)",
-    "  - a git pre-commit hook at .git/hooks/pre-commit (or the configured hook path / .husky/pre-commit); a foreign hook is backed up, then replaced",
-    "  - a Claude Code Stop hook in .claude/settings.json, only if this repo uses Claude Code",
-    "  - .proctor-adapter-manifest.json, recording the deployed ruleset paths",
-    "",
-    "No network call is made. Git may configure a hook path outside the working tree.",
-    "Run `npx proctor check` first if you want to see what it finds before wiring anything up.",
-    "Set PROCTOR_AUTO_SETUP=1 to have future installs run setup for you.",
-    ""
-  ];
-  process.stdout.write(lines.join("\n"));
-}
-async function main() {
-  const root = packageRoot();
-  const reason = skipReason(root);
-  if (reason) {
-    if (process.env.PROCTOR_DEBUG) {
-      process.stdout.write(`proctor: postinstall did nothing (${reason}).
-`);
-    }
-    return;
-  }
-  const target = projectDir;
-  if (!process.env.PROCTOR_AUTO_SETUP) {
-    await printNotice(target);
-    return;
-  }
-  const cli = join2(root, "dist", "cli.js");
-  if (!existsSync(cli)) {
-    process.stdout.write("proctor: build output not found, skipping automatic setup. Run `npx proctor setup`.\n");
-    return;
-  }
-  const result = spawnSync(process.execPath, [cli, "setup"], {
-    cwd: target,
-    stdio: "inherit"
-  });
-  if (result.status !== 0) {
-    process.stdout.write("proctor: automatic setup did not finish cleanly. Run `npx proctor setup` to see why.\n");
-  }
-}
-main().catch((err) => {
-  process.stdout.write(`proctor: postinstall notice could not be printed (${String(err)}). Run \`npx proctor setup\` to install the guards.
-`);
-});
+${canonical}`}var AGENT_ADAPTERS=[{id:"claude-code",displayName:"Claude Code",relativePath:".claude/skills/proctor/SKILL.md",scriptable:true,transform:skillFrontmatterTransform,detect:[".claude","CLAUDE.md"]},{id:"codex",displayName:"Codex CLI",relativePath:".agents/skills/proctor/SKILL.md",scriptable:true,transform:skillFrontmatterTransform,detect:[".codex",".agents/skills"]},{id:"cursor",displayName:"Cursor",relativePath:".cursor/rules/proctor.mdc",scriptable:true,transform:cursorMdcTransform,detect:[".cursor",".cursorrules"]},{id:"windsurf",displayName:"Windsurf",relativePath:".windsurf/rules/rules.md",scriptable:false,shared:true,detect:[".windsurf",".windsurfrules"]},{id:"gemini-cli",displayName:"Gemini CLI",relativePath:"GEMINI.md",scriptable:true,shared:true,detect:[".gemini"],experimental:"consumer Gemini CLI auth is retired by Google (Antigravity CLI is the supported successor) and its AfterAgent hook is contract-verified only, never live-verified"},{id:"aider",displayName:"Aider",relativePath:"CONVENTIONS.md",scriptable:true,shared:true,detect:[".aider.conf.yml",".aider.conf.yaml"]},{id:"continue",displayName:"Continue.dev",relativePath:".continue/rules/proctor.md",scriptable:true,detect:[".continue"]},{id:"cline",displayName:"Cline",relativePath:".clinerules/proctor.md",scriptable:true,detect:[".clinerules"]},{id:"amazon-q",displayName:"Amazon Q Developer",relativePath:".amazonq/rules/proctor.md",scriptable:false,detect:[".amazonq"]},{id:"github-copilot",displayName:"GitHub Copilot",relativePath:".github/instructions/proctor.instructions.md",scriptable:false,transform:copilotApplyToTransform,detect:[".github/instructions",".github/copilot-instructions.md"]},{id:"zed",displayName:"Zed",relativePath:".rules",scriptable:false,shared:true,detect:[".zed"]},{id:"agents-md",displayName:"AGENTS.md (universal)",relativePath:"AGENTS.md",scriptable:false,shared:true},{id:"openhands",displayName:"OpenHands",relativePath:".openhands/microagents/repo.md",scriptable:true,shared:true,detect:[".openhands"]},{id:"kiro",displayName:"Kiro",relativePath:".kiro/steering/proctor.md",scriptable:true,detect:[".kiro"]},{id:"tabnine",displayName:"Tabnine",relativePath:".tabnine/guidelines/proctor.md",scriptable:true,detect:[".tabnine"]},{id:"trae",displayName:"Trae",relativePath:".trae/rules/proctor.md",scriptable:false,detect:[".trae"]},{id:"github-copilot-global",displayName:"GitHub Copilot (global)",relativePath:".github/copilot-instructions.md",scriptable:false,shared:true,detect:[".github/instructions"]},{id:"qodo",displayName:"Qodo",relativePath:"best_practices.md",scriptable:true,shared:true,detect:[".qodo"]},{id:"roo-code",displayName:"Roo Code",relativePath:".roo/rules/proctor.md",scriptable:false,detect:[".roo",".roomodes"]},{id:"kilo-code",displayName:"Kilo Code",relativePath:".kilocode/rules/proctor.md",scriptable:true,detect:[".kilocode","kilo.jsonc"]},{id:"augment",displayName:"Augment Code",relativePath:".augment/rules/proctor.md",scriptable:true,detect:[".augment"]},{id:"antigravity",displayName:"Google Antigravity",relativePath:".agents/rules/proctor.md",scriptable:false,detect:[".agents/rules",".agent/rules"]},{id:"goose",displayName:"goose",relativePath:".goosehints",scriptable:true,shared:true},{id:"junie",displayName:"JetBrains Junie",relativePath:".junie/guidelines.md",scriptable:true,shared:true,detect:[".junie"]},{id:"qwen-code",displayName:"Qwen Code",relativePath:"QWEN.md",scriptable:true,shared:true,detect:[".qwen"]},{id:"crush",displayName:"Crush",relativePath:"CRUSH.md",scriptable:true,shared:true,detect:[".crush"]},{id:"warp",displayName:"Warp",relativePath:"WARP.md",scriptable:false,shared:true},{id:"amp",displayName:"Amp",relativePath:"AGENT.md",scriptable:true,shared:true},{id:"firebase-studio",displayName:"Firebase Studio",relativePath:".idx/airules.md",scriptable:false,shared:true,detect:[".idx"]},{id:"replit",displayName:"Replit Agent",relativePath:"replit.md",scriptable:false,shared:true,detect:[".replit"]}];var FALLBACK_ADAPTER_ID="agents-md";async function exists(cwd,relativePath){try{await stat(join(cwd,relativePath));return true}catch{return false}}async function detectAgents(cwd){const detected=await Promise.all(AGENT_ADAPTERS.map(async adapter=>{for(const marker of[adapter.relativePath,...adapter.detect??[]]){if(await exists(cwd,marker))return adapter}return void 0}));const found=detected.filter(a=>a!==void 0);if(found.length>0)return found;const fallback=AGENT_ADAPTERS.find(a=>a.id===FALLBACK_ADAPTER_ID);return fallback?[fallback]:[]}var projectDir=process.env.INIT_CWD;function packageRoot(){let dir=fileURLToPath(new URL(".",import.meta.url));for(let i=0;i<6;i++){if(existsSync(join2(dir,"package.json")))return dir;const parent=dirname(dir);if(parent===dir)break;dir=parent}return dir}function skipReason(root){if(process.env.PROCTOR_NO_POSTINSTALL)return"PROCTOR_NO_POSTINSTALL is set";if(process.env.CI)return"running in CI, where the checkout is disposable";if(process.env.npm_config_global==="true")return"this is a global install, with no project to set up";if(!projectDir)return"INIT_CWD is not set, so the target project is unknown";const target=resolve(projectDir);if(target===resolve(root))return"this is proctor\u2019s own repository";if(target.split(/[\\/]/).includes("node_modules"))return"installed as a transitive dependency";if(target.includes("_npx")||target.includes(".npm/_cacache"))return"running via npx, not installing into a project";if(!existsSync(join2(target,".git")))return"no git repository here, so there is no commit to guard";return void 0}async function printNotice(target){let agentPaths=[];try{agentPaths=(await detectAgents(target)).map(a=>a.relativePath)}catch{}const lines=["","proctor is installed. It has written nothing to your repository.","","  npx proctor setup","","That one command would write, and nothing else:",agentPaths.length>0?`  - the honest-completion ruleset to ${agentPaths.length} agent path${agentPaths.length===1?"":"s"}: ${agentPaths.join(", ")}`:"  - the honest-completion ruleset to the agent paths this repo already uses (AGENTS.md if none are detected)","  - a git pre-commit hook at .git/hooks/pre-commit (or the configured hook path / .husky/pre-commit); a foreign hook is backed up, then replaced","  - a Claude Code Stop hook in .claude/settings.json, only if this repo uses Claude Code","  - .proctor-adapter-manifest.json, recording the deployed ruleset paths","","No network call is made. Git may configure a hook path outside the working tree.","Run `npx proctor check` first if you want to see what it finds before wiring anything up.","Set PROCTOR_AUTO_SETUP=1 to have future installs run setup for you.",""];process.stdout.write(lines.join("\n"))}async function main(){const root=packageRoot();const reason=skipReason(root);if(reason){if(process.env.PROCTOR_DEBUG){process.stdout.write(`proctor: postinstall did nothing (${reason}).
+`)}return}const target=projectDir;if(!process.env.PROCTOR_AUTO_SETUP){await printNotice(target);return}const cli=join2(root,"dist","cli.js");if(!existsSync(cli)){process.stdout.write("proctor: build output not found, skipping automatic setup. Run `npx proctor setup`.\n");return}const result=spawnSync(process.execPath,[cli,"setup"],{cwd:target,stdio:"inherit"});if(result.status!==0){process.stdout.write("proctor: automatic setup did not finish cleanly. Run `npx proctor setup` to see why.\n")}}main().catch(err=>{process.stdout.write(`proctor: postinstall notice could not be printed (${String(err)}). Run \`npx proctor setup\` to install the guards.
+`)});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kavishdua/proctor",
-  "version": "1.4.0",
+  "version": "1.6.0",
   "description": "Catch AI agents gaming their test suites: deleted tests, skipped tests, weakened assertions, hardcoded outputs",
   "homepage": "https://github.com/catfish-1234/proctor#readme",
   "bugs": {
@@ -75,7 +75,7 @@
     "oxlint": "^1.88.0",
     "tsup": "8.5.1",
     "typescript": "^7.0.2",
-    "vitest": "^4.1.11"
+    "vitest": "^4.1.12"
   },
   "overrides": {
     "esbuild": "^0.28.1"