@kodr/aiwrangler 0.0.0-stage → 0.1.0

package/dist/index.js

@@ -0,0 +1,77 @@
+import {
+  authoritativeFor,
+  effectiveTruth,
+  formatReport,
+  paperSectionForSpec,
+  runCheck,
+  runPlanGate,
+  sectionById,
+  sectionsOfKind
+} from "./chunk-2CIV4KGU.js";
+import {
+  ConfigSchema,
+  PRECEDENCE,
+  activeThresholds,
+  applyEnvOverrides,
+  applyGateFlag,
+  checkCommitMessage,
+  checkRepoDiff,
+  ensurePaperText,
+  expandPath,
+  findConfigFile,
+  flattenGates,
+  loadConfig,
+  loadCorpus,
+  loadCorpusFrom,
+  parseDivergences,
+  parseDoc,
+  parseJsonc,
+  parsePaper,
+  parsePlan,
+  parseQuestions,
+  parseRules,
+  parseSpec,
+  sha256Hex,
+  shortHash,
+  slug,
+  splitMarkdown,
+  stripJsonc
+} from "./chunk-EAQASAXL.js";
+export {
+  ConfigSchema,
+  PRECEDENCE,
+  activeThresholds,
+  applyEnvOverrides,
+  applyGateFlag,
+  authoritativeFor,
+  checkCommitMessage,
+  checkRepoDiff,
+  effectiveTruth,
+  ensurePaperText,
+  expandPath,
+  findConfigFile,
+  flattenGates,
+  formatReport,
+  loadConfig,
+  loadCorpus,
+  loadCorpusFrom,
+  paperSectionForSpec,
+  parseDivergences,
+  parseDoc,
+  parseJsonc,
+  parsePaper,
+  parsePlan,
+  parseQuestions,
+  parseRules,
+  parseSpec,
+  runCheck,
+  runPlanGate,
+  sectionById,
+  sectionsOfKind,
+  sha256Hex,
+  shortHash,
+  slug,
+  splitMarkdown,
+  stripJsonc
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/mcp.js

@@ -0,0 +1,214 @@
+#!/usr/bin/env node
+import {
+  checkGate,
+  configReport,
+  isAckWriteAttempt,
+  isOverrideWriteAttempt,
+  listPendingAck,
+  loopResetGate,
+  planGate,
+  reportOverrides,
+  requestHumanAck,
+  requestHumanOverride,
+  resolveGateDir
+} from "./chunk-NQFO47CV.js";
+import "./chunk-2CIV4KGU.js";
+import "./chunk-EDVWHCQV.js";
+import "./chunk-EAQASAXL.js";
+
+// src/mcp.ts
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+
+// src/version.ts
+import { createRequire } from "module";
+var require2 = createRequire(import.meta.url);
+function packageVersion() {
+  const pkg = require2("../package.json");
+  if (typeof pkg.version !== "string" || pkg.version.length === 0) {
+    throw new Error("aiwrangler: package.json has no version");
+  }
+  return pkg.version;
+}
+
+// src/mcp.ts
+var rootArg = process.argv.slice(2).find((a) => !a.startsWith("-"));
+if (process.env.AIWRANGLER_DIR === void 0 && rootArg !== void 0) {
+  process.env.AIWRANGLER_DIR = rootArg;
+}
+var server = new McpServer(
+  { name: "aiwrangler", version: packageVersion() },
+  { capabilities: { logging: {} } }
+);
+var dirArg = z.string().optional().describe(
+  "absolute path of the workspace/repo root to operate on (config discovery walks up from here). Defaults to the server's startup root. Pass the workspace root whenever the server was started elsewhere."
+);
+server.registerTool(
+  "wrangler_config",
+  {
+    description: "AiWrangler ground-truth and gate status. Prints the effective configuration (including AIWRANGLER_* env overrides), every gate flag, the active policy thresholds, and the loaded corpus summary (spec sections, review rules, divergence rulings, open questions, one-way doors, whitepaper sections, corpus hash). Use this first in any session to confirm what AiWrangler is enforcing and that the corpus is present.",
+    inputSchema: { dir: dirArg }
+  },
+  async ({ dir }) => ({
+    content: [{ type: "text", text: safe(() => configReport(resolveGateDir(dir))) }]
+  })
+);
+server.registerTool(
+  "wrangler_plan",
+  {
+    description: "AiWrangler pre-flight plan gate. Call BEFORE writing any code. Judges the task against the ground-truth corpus (protocol spec, review rules, divergence rulings, open questions, one-way doors) and returns: an ACTION (pass | clarify | human), the reasons, and a ground-truth context pack you MUST honor while implementing. clarify means the task is ambiguous or touches an unresolved question: ask the user before coding. human means a one-way door or steering risk: stop for the owner.",
+    inputSchema: {
+      task: z.string().describe("the task as given, verbatim if possible"),
+      plan: z.string().optional().describe("your implementation plan, if you have one drafted"),
+      dir: dirArg
+    }
+  },
+  async ({ task, plan, dir }) => ({
+    content: [{ type: "text", text: await planGate(resolveGateDir(dir), { task, ...plan ? { plan } : {} }) }]
+  })
+);
+server.registerTool(
+  "wrangler_check",
+  {
+    description: "AiWrangler post-generation gate. Call BEFORE declaring a task done (and after each substantive revision). Runs deterministic checks (review rules, em dashes, deferred-work discipline, pub-API surface, test discipline) plus a Jev semantic battery (claims vs diff, scope discipline, silent defaults, comment truthfulness, spec contradictions, self-report verification) against the dirty files across all tracked repos. Returns PASS / FIX REQUIRED (with a cited, actionable fix list) / HUMAN REVIEW / DEGRADED. Fix every cited finding and re-run until PASS. Pass agent_summary and tool_output to have your status claims verified too.",
+    inputSchema: {
+      task: z.string().optional().describe("the task being implemented (improves scope and spec checks)"),
+      agent_summary: z.string().optional().describe("your summary of what you did and its status (e.g. 'tests pass, lint clean')"),
+      tool_output: z.string().optional().describe("the raw output of the build/test commands you ran, for self-report verification"),
+      cargo: z.boolean().optional().describe("also run cargo check on dirty repos"),
+      tests: z.boolean().optional().describe("also run cargo test on dirty repos (implies cargo)"),
+      dir: dirArg
+    }
+  },
+  async ({ task, agent_summary, tool_output, cargo, tests, dir }) => ({
+    content: [
+      {
+        type: "text",
+        text: await checkGate(resolveGateDir(dir), {
+          ...task ? { task } : {},
+          ...agent_summary ? { agentSummary: agent_summary } : {},
+          ...tool_output ? { toolOutput: tool_output } : {},
+          cargo: cargo ?? false,
+          tests: tests ?? false
+        })
+      }
+    ]
+  })
+);
+function safe(fn) {
+  try {
+    return fn();
+  } catch (err) {
+    return `error: ${err instanceof Error ? err.message : String(err)}`;
+  }
+}
+var decisionSchema = {
+  type: "object",
+  properties: {
+    decision: {
+      type: "string",
+      title: "Decision",
+      description: "Approve records this write. Deny leaves the gate unchanged.",
+      enum: ["approve", "deny"],
+      enumNames: ["Approve", "Deny"]
+    }
+  },
+  required: ["decision"]
+};
+async function elicitDecision(summary) {
+  try {
+    const result = await server.server.elicitInput({
+      mode: "form",
+      message: summary,
+      requestedSchema: decisionSchema
+    });
+    if (result.action === "accept" && result.content?.decision === "approve") return "approve";
+    return "deny";
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    if (message.toLowerCase().includes("does not support") && message.toLowerCase().includes("elicit")) return "unsupported";
+    return { error: message };
+  }
+}
+function toolResult(text) {
+  return { ...text.startsWith("aiwrangler:") ? { isError: true } : {}, content: [{ type: "text", text }] };
+}
+server.registerTool(
+  "wrangler_ack",
+  {
+    description: "AiWrangler HUMAN REVIEW. With no rules, note, or diffHash, lists pending human-severity findings and the diff hash. Passing rules requests an acknowledgment. Those arguments do not approve it: the server asks the human with an MCP elicitation prompt (findings, rules, diff hash, and note), or a desktop dialog if this client has no elicitation. Nothing is recorded unless the human approves. Block-severity findings cannot be acked. A diff change voids the ack.",
+    annotations: { readOnlyHint: false, destructiveHint: false },
+    inputSchema: {
+      rules: z.array(z.string()).optional().describe('rule IDs to ask the owner to acknowledge, e.g. ["RULE-10"] or ["*"]. Does not approve by itself.'),
+      note: z.string().optional().describe("shown to the owner on the approval prompt and stored if they approve"),
+      diffHash: z.string().optional().describe("diff hash from the check report; defaults to the latest recorded gate run. Does not approve by itself."),
+      dir: dirArg
+    }
+  },
+  async ({ rules, note, diffHash, dir }) => {
+    if (!isAckWriteAttempt({ rules, note, diffHash })) {
+      return { content: [{ type: "text", text: safe(() => listPendingAck(resolveGateDir(dir))) }] };
+    }
+    const text = await requestHumanAck(
+      resolveGateDir(dir),
+      { rules: rules ?? [], ...note !== void 0 ? { note } : {}, ...diffHash !== void 0 ? { diffHash } : {} },
+      { by: "mcp", elicit: elicitDecision }
+    );
+    return toolResult(text);
+  }
+);
+async function main() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  console.error(`aiwrangler-mcp: ready (root: ${resolveGateDir()})`);
+}
+server.registerTool(
+  "wrangler_override",
+  {
+    description: "AiWrangler runtime overrides. With no set, clear, or note, reports active overrides. Passing set or clear requests a change. Those arguments do not apply it: the server asks the human with an MCP elicitation prompt, or a desktop dialog if this client has no elicitation. Nothing changes unless the human approves. Overrides expire on the next PASS.",
+    annotations: { readOnlyHint: false, destructiveHint: true },
+    inputSchema: {
+      set: z.object({
+        activePolicy: z.string().optional(),
+        egressSemantic: z.boolean().optional(),
+        actionThreshold: z.number().min(0).max(1).optional(),
+        reviewThreshold: z.number().min(0).max(1).optional(),
+        gates: z.record(z.string(), z.boolean()).optional()
+      }).optional().describe("overrides to ask the owner to apply. Does not apply them by itself."),
+      clear: z.boolean().optional().describe("ask the owner to remove active overrides. Does not clear them by itself."),
+      note: z.string().optional().describe("shown to the owner on the approval prompt and stored if they approve"),
+      dir: dirArg
+    }
+  },
+  async ({ set, clear, note, dir }) => {
+    if (!isOverrideWriteAttempt({ set, clear, note })) {
+      return { content: [{ type: "text", text: safe(() => reportOverrides(resolveGateDir(dir))) }] };
+    }
+    const text = await requestHumanOverride(
+      resolveGateDir(dir),
+      {
+        ...set !== void 0 ? { set } : {},
+        ...clear === true ? { clear: true } : {},
+        ...note !== void 0 ? { note } : {}
+      },
+      { by: "mcp", elicit: elicitDecision }
+    );
+    return toolResult(text);
+  }
+);
+server.registerTool(
+  "wrangler_loop_reset",
+  {
+    description: "AiWrangler circuit-breaker reset. Call ONLY after the user has decided the repeated findings are not making progress: it clears the retry loop state so the next check starts fresh, and audits a notice. No-op when there is no loop state.",
+    inputSchema: { dir: dirArg }
+  },
+  async ({ dir }) => ({
+    content: [{ type: "text", text: safe(() => loopResetGate(resolveGateDir(dir), "mcp")) }]
+  })
+);
+main().catch((err) => {
+  console.error("aiwrangler-mcp: fatal:", err);
+  process.exit(1);
+});
+//# sourceMappingURL=mcp.js.map

package/dist/mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/mcp.ts","../src/version.ts"],"sourcesContent":["#!/usr/bin/env node\n// AiWrangler MCP server. Ack and override writes ask the human through MCP\n// elicitation (the client UI). If the client has no form elicitation, the\n// server falls back to a native desktop dialog. Tool arguments never authorize\n// a write by themselves. stdio transport.\n//\n//   node dist/mcp.js [rootDir]        # rootDir = default gate directory\n//   AIWRANGLER_DIR=/path node dist/mcp.js\n//\n// Per-call `dir` arguments override the startup root, so one server can\n// serve multiple workspaces.\nimport { McpServer } from \"@modelcontextprotocol/sdk/server/mcp.js\"\nimport { StdioServerTransport } from \"@modelcontextprotocol/sdk/server/stdio.js\"\nimport { z } from \"zod\"\nimport type { ElicitOutcome } from \"./approve.js\"\nimport {\n  configReport,\n  planGate,\n  checkGate,\n  isAckWriteAttempt,\n  isOverrideWriteAttempt,\n  listPendingAck,\n  reportOverrides,\n  requestHumanAck,\n  requestHumanOverride,\n  loopResetGate,\n  resolveGateDir,\n} from \"./core.js\"\nimport type { RuntimeOverrides } from \"./overrides.js\"\nimport { packageVersion } from \"./version.js\"\n\nconst rootArg = process.argv.slice(2).find((a) => !a.startsWith(\"-\"))\nif (process.env.AIWRANGLER_DIR === undefined && rootArg !== undefined) {\n  process.env.AIWRANGLER_DIR = rootArg\n}\n\nconst server = new McpServer(\n  { name: \"aiwrangler\", version: packageVersion() },\n  { capabilities: { logging: {} } },\n)\n\nconst dirArg = z\n  .string()\n  .optional()\n  .describe(\n    \"absolute path of the workspace/repo root to operate on (config discovery walks up from here). \" +\n      \"Defaults to the server's startup root. Pass the workspace root whenever the server was started elsewhere.\",\n  )\n\nserver.registerTool(\n  \"wrangler_config\",\n  {\n    description:\n      \"AiWrangler ground-truth and gate status. Prints the effective configuration (including AIWRANGLER_* env overrides), every gate flag, the active policy thresholds, and the loaded corpus summary (spec sections, review rules, divergence rulings, open questions, one-way doors, whitepaper sections, corpus hash). Use this first in any session to confirm what AiWrangler is enforcing and that the corpus is present.\",\n    inputSchema: { dir: dirArg },\n  },\n  async ({ dir }) => ({\n    content: [{ type: \"text\", text: safe(() => configReport(resolveGateDir(dir))) }],\n  }),\n)\n\nserver.registerTool(\n  \"wrangler_plan\",\n  {\n    description:\n      \"AiWrangler pre-flight plan gate. Call BEFORE writing any code. Judges the task against the ground-truth corpus (protocol spec, review rules, divergence rulings, open questions, one-way doors) and returns: an ACTION (pass | clarify | human), the reasons, and a ground-truth context pack you MUST honor while implementing. clarify means the task is ambiguous or touches an unresolved question: ask the user before coding. human means a one-way door or steering risk: stop for the owner.\",\n    inputSchema: {\n      task: z.string().describe(\"the task as given, verbatim if possible\"),\n      plan: z.string().optional().describe(\"your implementation plan, if you have one drafted\"),\n      dir: dirArg,\n    },\n  },\n  async ({ task, plan, dir }) => ({\n    content: [{ type: \"text\", text: await planGate(resolveGateDir(dir), { task, ...(plan ? { plan } : {}) }) }],\n  }),\n)\n\nserver.registerTool(\n  \"wrangler_check\",\n  {\n    description:\n      \"AiWrangler post-generation gate. Call BEFORE declaring a task done (and after each substantive revision). Runs deterministic checks (review rules, em dashes, deferred-work discipline, pub-API surface, test discipline) plus a Jev semantic battery (claims vs diff, scope discipline, silent defaults, comment truthfulness, spec contradictions, self-report verification) against the dirty files across all tracked repos. Returns PASS / FIX REQUIRED (with a cited, actionable fix list) / HUMAN REVIEW / DEGRADED. Fix every cited finding and re-run until PASS. Pass agent_summary and tool_output to have your status claims verified too.\",\n    inputSchema: {\n      task: z.string().optional().describe(\"the task being implemented (improves scope and spec checks)\"),\n      agent_summary: z.string().optional().describe(\"your summary of what you did and its status (e.g. 'tests pass, lint clean')\"),\n      tool_output: z.string().optional().describe(\"the raw output of the build/test commands you ran, for self-report verification\"),\n      cargo: z.boolean().optional().describe(\"also run cargo check on dirty repos\"),\n      tests: z.boolean().optional().describe(\"also run cargo test on dirty repos (implies cargo)\"),\n      dir: dirArg,\n    },\n  },\n  async ({ task, agent_summary, tool_output, cargo, tests, dir }) => ({\n    content: [\n      {\n        type: \"text\",\n        text: await checkGate(resolveGateDir(dir), {\n          ...(task ? { task } : {}),\n          ...(agent_summary ? { agentSummary: agent_summary } : {}),\n          ...(tool_output ? { toolOutput: tool_output } : {}),\n          cargo: cargo ?? false,\n          tests: tests ?? false,\n        }),\n      },\n    ],\n  }),\n)\n\nfunction safe(fn: () => string): string {\n  try {\n    return fn()\n  } catch (err) {\n    return `error: ${err instanceof Error ? err.message : String(err)}`\n  }\n}\n\nconst decisionSchema = {\n  type: \"object\" as const,\n  properties: {\n    decision: {\n      type: \"string\" as const,\n      title: \"Decision\",\n      description: \"Approve records this write. Deny leaves the gate unchanged.\",\n      enum: [\"approve\", \"deny\"],\n      enumNames: [\"Approve\", \"Deny\"],\n    },\n  },\n  required: [\"decision\"],\n}\n\n/** Ask the MCP client UI. Unsupported clients fall through to the OS dialog. */\nasync function elicitDecision(summary: string): Promise<ElicitOutcome> {\n  try {\n    const result = await server.server.elicitInput({\n      mode: \"form\",\n      message: summary,\n      requestedSchema: decisionSchema,\n    })\n    if (result.action === \"accept\" && result.content?.decision === \"approve\") return \"approve\"\n    return \"deny\"\n  } catch (err) {\n    const message = err instanceof Error ? err.message : String(err)\n    if (message.toLowerCase().includes(\"does not support\") && message.toLowerCase().includes(\"elicit\")) return \"unsupported\"\n    return { error: message }\n  }\n}\n\nfunction toolResult(text: string): { isError?: boolean; content: { type: \"text\"; text: string }[] } {\n  return { ...(text.startsWith(\"aiwrangler:\") ? { isError: true } : {}), content: [{ type: \"text\", text }] }\n}\n\nserver.registerTool(\n  \"wrangler_ack\",\n  {\n    description:\n      \"AiWrangler HUMAN REVIEW. With no rules, note, or diffHash, lists pending human-severity findings and the diff hash. Passing rules requests an acknowledgment. Those arguments do not approve it: the server asks the human with an MCP elicitation prompt (findings, rules, diff hash, and note), or a desktop dialog if this client has no elicitation. Nothing is recorded unless the human approves. Block-severity findings cannot be acked. A diff change voids the ack.\",\n    annotations: { readOnlyHint: false, destructiveHint: false },\n    inputSchema: {\n      rules: z.array(z.string()).optional().describe('rule IDs to ask the owner to acknowledge, e.g. [\"RULE-10\"] or [\"*\"]. Does not approve by itself.'),\n      note: z.string().optional().describe(\"shown to the owner on the approval prompt and stored if they approve\"),\n      diffHash: z.string().optional().describe(\"diff hash from the check report; defaults to the latest recorded gate run. Does not approve by itself.\"),\n      dir: dirArg,\n    },\n  },\n  async ({ rules, note, diffHash, dir }) => {\n    if (!isAckWriteAttempt({ rules, note, diffHash })) {\n      return { content: [{ type: \"text\" as const, text: safe(() => listPendingAck(resolveGateDir(dir))) }] }\n    }\n    const text = await requestHumanAck(\n      resolveGateDir(dir),\n      { rules: rules ?? [], ...(note !== undefined ? { note } : {}), ...(diffHash !== undefined ? { diffHash } : {}) },\n      { by: \"mcp\", elicit: elicitDecision },\n    )\n    return toolResult(text)\n  },\n)\n\nasync function main() {\n  const transport = new StdioServerTransport()\n  await server.connect(transport)\n  console.error(`aiwrangler-mcp: ready (root: ${resolveGateDir()})`)\n}\n\nserver.registerTool(\n  \"wrangler_override\",\n  {\n    description:\n      \"AiWrangler runtime overrides. With no set, clear, or note, reports active overrides. Passing set or clear requests a change. Those arguments do not apply it: the server asks the human with an MCP elicitation prompt, or a desktop dialog if this client has no elicitation. Nothing changes unless the human approves. Overrides expire on the next PASS.\",\n    annotations: { readOnlyHint: false, destructiveHint: true },\n    inputSchema: {\n      set: z\n        .object({\n          activePolicy: z.string().optional(),\n          egressSemantic: z.boolean().optional(),\n          actionThreshold: z.number().min(0).max(1).optional(),\n          reviewThreshold: z.number().min(0).max(1).optional(),\n          gates: z.record(z.string(), z.boolean()).optional(),\n        })\n        .optional()\n        .describe(\"overrides to ask the owner to apply. Does not apply them by itself.\"),\n      clear: z.boolean().optional().describe(\"ask the owner to remove active overrides. Does not clear them by itself.\"),\n      note: z.string().optional().describe(\"shown to the owner on the approval prompt and stored if they approve\"),\n      dir: dirArg,\n    },\n  },\n  async ({ set, clear, note, dir }) => {\n    if (!isOverrideWriteAttempt({ set, clear, note })) {\n      return { content: [{ type: \"text\" as const, text: safe(() => reportOverrides(resolveGateDir(dir))) }] }\n    }\n    const text = await requestHumanOverride(\n      resolveGateDir(dir),\n      {\n        ...(set !== undefined ? { set: set as RuntimeOverrides } : {}),\n        ...(clear === true ? { clear: true } : {}),\n        ...(note !== undefined ? { note } : {}),\n      },\n      { by: \"mcp\", elicit: elicitDecision },\n    )\n    return toolResult(text)\n  },\n)\n\nserver.registerTool(\n  \"wrangler_loop_reset\",\n  {\n    description:\n      \"AiWrangler circuit-breaker reset. Call ONLY after the user has decided the repeated findings are not making progress: it clears the retry loop state so the next check starts fresh, and audits a notice. No-op when there is no loop state.\",\n    inputSchema: { dir: dirArg },\n  },\n  async ({ dir }) => ({\n    content: [{ type: \"text\", text: safe(() => loopResetGate(resolveGateDir(dir), \"mcp\")) }],\n  }),\n)\n\nmain().catch((err) => {\n  console.error(\"aiwrangler-mcp: fatal:\", err)\n  process.exit(1)\n})\n","import { createRequire } from \"node:module\"\n\nconst require = createRequire(import.meta.url)\n\n/** Version from the nearest package.json, so the published server matches the npm package. */\nexport function packageVersion(): string {\n  const pkg = require(\"../package.json\") as { version?: unknown }\n  if (typeof pkg.version !== \"string\" || pkg.version.length === 0) {\n    throw new Error(\"aiwrangler: package.json has no version\")\n  }\n  return pkg.version\n}\n"],"mappings":"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","names":["require"]}

package/dist/plugin.js

@@ -0,0 +1,112 @@
+import {
+  setJevWarnSink
+} from "./chunk-EDVWHCQV.js";
+import {
+  Ledger,
+  diffFingerprint,
+  findConfigFile,
+  formatFindings,
+  loadConfig,
+  runDeterministic
+} from "./chunk-EAQASAXL.js";
+
+// src/plugin.ts
+import { readFileSync, existsSync, writeFileSync, mkdirSync } from "fs";
+import { join, dirname } from "path";
+var WranglerWatchPlugin = async ({ client, directory }) => {
+  const log = (level, message) => client.app.log({ body: { service: "aiwrangler-watch", level, message } }).catch(() => {
+  });
+  if (!directory || !findConfigFile(directory) && !process.env.AIWRANGLER_CONFIG) {
+    return {};
+  }
+  let loaded;
+  try {
+    loaded = loadConfig(directory);
+  } catch (err) {
+    void log("error", `aiwrangler config failed to load; watch plugin inactive: ${err instanceof Error ? err.message : String(err)}`);
+    return {};
+  }
+  const statePath = join(loaded.root, ".aiwrangler", "watch-state.json");
+  setJevWarnSink((message) => {
+    void log("warn", message);
+    client.tui.showToast({ body: { title: "aiwrangler", message, variant: "warning", duration: 8e3 } }).catch(() => {
+    });
+    try {
+      new Ledger(loaded.config, loaded.root).append({ ts: (/* @__PURE__ */ new Date()).toISOString(), kind: "notice", message });
+    } catch {
+    }
+  });
+  let watch = { lastFingerprint: "", nudges: 0, greenAnnounced: false };
+  try {
+    if (existsSync(statePath)) watch = { ...watch, ...JSON.parse(readFileSync(statePath, "utf8")) };
+  } catch {
+    watch = { lastFingerprint: "", nudges: 0, greenAnnounced: false };
+  }
+  const save = () => {
+    mkdirSync(dirname(statePath), { recursive: true });
+    writeFileSync(statePath, JSON.stringify(watch), "utf8");
+  };
+  async function nudge(sessionID, text) {
+    try {
+      await client.session.promptAsync({
+        path: { id: sessionID },
+        body: { parts: [{ type: "text", text }] }
+      });
+    } catch (err) {
+      void log("warn", `nudge failed: ${err instanceof Error ? err.message : String(err)}`);
+    }
+  }
+  return {
+    event: async ({ event }) => {
+      const e = event;
+      if (e.type !== "session.idle") return;
+      const props = e.properties ?? {};
+      const sessionID = String(props.sessionID ?? props.id ?? "");
+      if (!sessionID) return;
+      try {
+        const loaded2 = loadConfig(directory);
+        if (!loaded2.config.gates.session.nudge) return;
+        const report = await runDeterministic(loaded2.config, loaded2.root, { cargo: false });
+        const fingerprint = diffFingerprint(
+          report.repoDiffs.flatMap((d) => d.files.map((f) => f.path + String(f.hunks.length))).join("|")
+        );
+        if (fingerprint === watch.lastFingerprint) return;
+        watch.lastFingerprint = fingerprint;
+        const blocking = report.findings.filter((f) => f.severity === "block" || f.severity === "human");
+        if (blocking.length > 0 && watch.nudges < loaded2.config.gates.session.maxNudges) {
+          watch.nudges++;
+          watch.greenAnnounced = false;
+          save();
+          await nudge(
+            sessionID,
+            [
+              "aiwrangler gate: deterministic findings on the current dirty files. Fix these before finishing, then run the wrangler_check tool for the full battery:",
+              "",
+              formatFindings(blocking)
+            ].join("\n")
+          );
+          return;
+        }
+        if (report.repoDiffs.length > 0 && blocking.length === 0 && !watch.greenAnnounced && watch.nudges > 0) {
+          watch.greenAnnounced = true;
+          save();
+          await nudge(
+            sessionID,
+            "aiwrangler gate: previous deterministic findings are resolved. Run the wrangler_check tool for the full semantic battery before declaring done."
+          );
+        }
+        if (report.repoDiffs.length === 0) {
+          watch.nudges = 0;
+          watch.greenAnnounced = false;
+          save();
+        }
+      } catch (err) {
+        void log("warn", `idle check error: ${err instanceof Error ? err.message : String(err)}`);
+      }
+    }
+  };
+};
+export {
+  WranglerWatchPlugin
+};
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/plugin.ts"],"sourcesContent":["import type { Plugin } from \"@opencode-ai/plugin\"\nimport { loadConfig, findConfigFile } from \"./config.js\"\nimport { loadCorpus } from \"./groundtruth/corpus.js\"\nimport { runDeterministic, formatFindings } from \"./gates/deterministic/index.js\"\nimport { diffFingerprint } from \"./loop.js\"\nimport { setJevWarnSink } from \"./jev/client.js\"\nimport { Ledger } from \"./ledger.js\"\nimport { readFileSync, existsSync, writeFileSync, mkdirSync } from \"node:fs\"\nimport { join, dirname } from \"node:path\"\n\ninterface WatchState {\n  lastFingerprint: string\n  nudges: number\n  greenAnnounced: boolean\n}\n\nexport const WranglerWatchPlugin: Plugin = async ({ client, directory }) => {\n  const log = (level: \"debug\" | \"info\" | \"warn\" | \"error\", message: string) =>\n    client.app.log({ body: { service: \"aiwrangler-watch\", level, message } }).catch(() => {})\n\n  if (!directory || (!findConfigFile(directory) && !process.env.AIWRANGLER_CONFIG)) {\n    return {}\n  }\n\n  let loaded\n  try {\n    loaded = loadConfig(directory)\n  } catch (err) {\n    void log(\"error\", `aiwrangler config failed to load; watch plugin inactive: ${err instanceof Error ? err.message : String(err)}`)\n    return {}\n  }\n  const statePath = join(loaded.root, \".aiwrangler\", \"watch-state.json\")\n\n  setJevWarnSink((message) => {\n    void log(\"warn\", message)\n    client.tui\n      .showToast({ body: { title: \"aiwrangler\", message, variant: \"warning\", duration: 8000 } })\n      .catch(() => {})\n    try {\n      new Ledger(loaded.config, loaded.root).append({ ts: new Date().toISOString(), kind: \"notice\", message })\n    } catch {\n      /* ledger unavailable; the app log above still captured it */\n    }\n  })\n  let watch: WatchState = { lastFingerprint: \"\", nudges: 0, greenAnnounced: false }\n  try {\n    if (existsSync(statePath)) watch = { ...watch, ...(JSON.parse(readFileSync(statePath, \"utf8\")) as WatchState) }\n  } catch {\n    watch = { lastFingerprint: \"\", nudges: 0, greenAnnounced: false }\n  }\n  const save = () => {\n    mkdirSync(dirname(statePath), { recursive: true })\n    writeFileSync(statePath, JSON.stringify(watch), \"utf8\")\n  }\n\n  async function nudge(sessionID: string, text: string) {\n    try {\n      await client.session.promptAsync({\n        path: { id: sessionID },\n        body: { parts: [{ type: \"text\", text }] },\n      })\n    } catch (err) {\n      void log(\"warn\", `nudge failed: ${err instanceof Error ? err.message : String(err)}`)\n    }\n  }\n\n  return {\n    event: async ({ event }) => {\n      const e = event as { type?: string; properties?: Record<string, any> }\n      if (e.type !== \"session.idle\") return\n      const props = e.properties ?? {}\n      const sessionID = String(props.sessionID ?? props.id ?? \"\")\n      if (!sessionID) return\n\n      try {\n        const loaded = loadConfig(directory!)\n        if (!loaded.config.gates.session.nudge) return\n        const report = await runDeterministic(loaded.config, loaded.root, { cargo: false })\n        const fingerprint = diffFingerprint(\n          report.repoDiffs\n            .flatMap((d) => d.files.map((f) => f.path + String(f.hunks.length)))\n            .join(\"|\"),\n        )\n        if (fingerprint === watch.lastFingerprint) return\n        watch.lastFingerprint = fingerprint\n\n        const blocking = report.findings.filter((f) => f.severity === \"block\" || f.severity === \"human\")\n        if (blocking.length > 0 && watch.nudges < loaded.config.gates.session.maxNudges) {\n          watch.nudges++\n          watch.greenAnnounced = false\n          save()\n          await nudge(\n            sessionID,\n            [\n              \"aiwrangler gate: deterministic findings on the current dirty files. Fix these before finishing, then run the wrangler_check tool for the full battery:\",\n              \"\",\n              formatFindings(blocking),\n            ].join(\"\\n\"),\n          )\n          return\n        }\n\n        if (report.repoDiffs.length > 0 && blocking.length === 0 && !watch.greenAnnounced && watch.nudges > 0) {\n          watch.greenAnnounced = true\n          save()\n          await nudge(\n            sessionID,\n            \"aiwrangler gate: previous deterministic findings are resolved. Run the wrangler_check tool for the full semantic battery before declaring done.\",\n          )\n        }\n        if (report.repoDiffs.length === 0) {\n          watch.nudges = 0\n          watch.greenAnnounced = false\n          save()\n        }\n      } catch (err) {\n        void log(\"warn\", `idle check error: ${err instanceof Error ? err.message : String(err)}`)\n      }\n    },\n  }\n}\n"],"mappings":"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","names":["loaded"]}

package/dist/tools.js

@@ -0,0 +1,127 @@
+import {
+  checkGate,
+  configReport,
+  isAckWriteAttempt,
+  isOverrideWriteAttempt,
+  listPendingAck,
+  loopResetGate,
+  planGate,
+  reportOverrides,
+  requestHumanAck,
+  requestHumanOverride
+} from "./chunk-NQFO47CV.js";
+import "./chunk-2CIV4KGU.js";
+import "./chunk-EDVWHCQV.js";
+import "./chunk-EAQASAXL.js";
+
+// src/tools.ts
+import { tool } from "@opencode-ai/plugin";
+var wrangler_config = tool({
+  description: "AiWrangler ground-truth and gate status. Prints the effective configuration (including AIWRANGLER_* env overrides), every gate flag, the active policy thresholds, and the loaded corpus summary (spec sections, review rules, divergence rulings, open questions, one-way doors, whitepaper sections, corpus hash). Use this first in any session to confirm what AiWrangler is enforcing and that the corpus is present.",
+  args: {},
+  async execute(_args, ctx) {
+    const dir = ctx.directory ?? process.cwd();
+    try {
+      return configReport(dir);
+    } catch (err) {
+      return `error: ${err instanceof Error ? err.message : String(err)}`;
+    }
+  }
+});
+var wrangler_plan = tool({
+  description: "AiWrangler pre-flight plan gate. Call BEFORE writing any code. Judges the task against the ground-truth corpus (protocol spec, review rules, divergence rulings, open questions, one-way doors) and returns: an ACTION (pass | clarify | human), the reasons, and a ground-truth context pack you MUST honor while implementing. clarify means the task is ambiguous or touches an unresolved question: ask the user before coding. human means a one-way door or steering risk: stop for the owner.",
+  args: {
+    task: tool.schema.string().describe("the task as given, verbatim if possible"),
+    plan: tool.schema.string().optional().describe("your implementation plan, if you have one drafted")
+  },
+  async execute(args, ctx) {
+    const dir = ctx.directory ?? process.cwd();
+    return planGate(dir, {
+      task: args.task,
+      ...args.plan ? { plan: args.plan } : {},
+      ...ctx.sessionID !== void 0 ? { sessionID: ctx.sessionID } : {}
+    });
+  }
+});
+var wrangler_check = tool({
+  description: "AiWrangler post-generation gate. Call BEFORE declaring a task done (and after each substantive revision). Runs deterministic checks (review rules, em dashes, deferred-work discipline, pub-API surface, test discipline) plus a Jev semantic battery (claims vs diff, scope discipline, silent defaults, comment truthfulness, spec contradictions, self-report verification) against the dirty files across all tracked repos. Returns PASS / FIX REQUIRED (with a cited, actionable fix list) / HUMAN REVIEW / DEGRADED. Fix every cited finding and re-run until PASS. Pass agent_summary and tool_output to have your status claims verified too.",
+  args: {
+    task: tool.schema.string().optional().describe("the task being implemented (improves scope and spec checks)"),
+    agent_summary: tool.schema.string().optional().describe("your summary of what you did and its status (e.g. 'tests pass, lint clean')"),
+    tool_output: tool.schema.string().optional().describe("the raw output of the build/test commands you ran, for self-report verification"),
+    cargo: tool.schema.boolean().default(false).describe("also run cargo check on dirty repos"),
+    tests: tool.schema.boolean().default(false).describe("also run cargo test on dirty repos (implies cargo)")
+  },
+  async execute(args, ctx) {
+    const dir = ctx.directory ?? process.cwd();
+    return checkGate(dir, {
+      ...args.task ? { task: args.task } : {},
+      ...args.agent_summary ? { agentSummary: args.agent_summary } : {},
+      ...args.tool_output ? { toolOutput: args.tool_output } : {},
+      cargo: args.cargo || args.tests || false,
+      tests: args.tests || false,
+      ...ctx.sessionID !== void 0 ? { sessionID: ctx.sessionID } : {}
+    });
+  }
+});
+var wrangler_ack = tool({
+  description: "AiWrangler HUMAN REVIEW. With no rules, note, or diffHash, lists pending human-severity findings and the diff hash. Passing rules requests an acknowledgment. Those arguments do not approve it: this native tool has no MCP elicitation channel, so it shows a desktop dialog. Nothing is recorded unless the owner approves. Prefer the MCP server inside opencode, which can elicit in the editor. Block-severity findings cannot be acked.",
+  args: {
+    rules: tool.schema.array(tool.schema.string()).optional().describe("rule IDs to ask the owner to acknowledge. Does not approve by itself."),
+    note: tool.schema.string().optional().describe("shown to the owner on the approval prompt and stored if they approve"),
+    diffHash: tool.schema.string().optional().describe("diff hash from the check report; defaults to the latest recorded gate run")
+  },
+  async execute(args, ctx) {
+    const dir = ctx.directory ?? process.cwd();
+    if (!isAckWriteAttempt(args)) return listPendingAck(dir);
+    return requestHumanAck(
+      dir,
+      { rules: args.rules ?? [], ...args.note !== void 0 ? { note: args.note } : {}, ...args.diffHash !== void 0 ? { diffHash: args.diffHash } : {} },
+      { by: "opencode" }
+    );
+  }
+});
+var wrangler_override = tool({
+  description: "AiWrangler runtime overrides. With no set, clear, or note, reports active overrides. Passing set or clear requests a change. Those arguments do not apply it: this native tool shows a desktop dialog because it has no MCP elicitation channel. Nothing changes unless the owner approves. Prefer the MCP server inside opencode. Overrides expire on the next PASS.",
+  args: {
+    set: tool.schema.object({
+      activePolicy: tool.schema.string().optional(),
+      egressSemantic: tool.schema.boolean().optional(),
+      actionThreshold: tool.schema.number().min(0).max(1).optional(),
+      reviewThreshold: tool.schema.number().min(0).max(1).optional(),
+      gates: tool.schema.record(tool.schema.string(), tool.schema.boolean()).optional()
+    }).optional().describe("overrides to ask the owner to apply. Does not apply them by itself."),
+    clear: tool.schema.boolean().optional().describe("ask the owner to remove active overrides. Does not clear them by itself."),
+    note: tool.schema.string().optional().describe("shown to the owner on the approval prompt and stored if they approve")
+  },
+  async execute(args, ctx) {
+    const dir = ctx.directory ?? process.cwd();
+    if (!isOverrideWriteAttempt(args)) return reportOverrides(dir);
+    return requestHumanOverride(
+      dir,
+      {
+        ...args.set !== void 0 ? { set: args.set } : {},
+        ...args.clear === true ? { clear: true } : {},
+        ...args.note !== void 0 ? { note: args.note } : {}
+      },
+      { by: "opencode" }
+    );
+  }
+});
+var wrangler_loop_reset = tool({
+  description: "AiWrangler circuit-breaker reset. Call ONLY after the user has decided repeated findings are not making progress: clears the retry loop state so the next check starts fresh, and audits a notice. No-op when there is no loop state.",
+  args: {},
+  async execute(_args, ctx) {
+    const dir = ctx.directory ?? process.cwd();
+    return loopResetGate(dir, "opencode");
+  }
+});
+export {
+  wrangler_ack,
+  wrangler_check,
+  wrangler_config,
+  wrangler_loop_reset,
+  wrangler_override,
+  wrangler_plan
+};
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/tools.ts"],"sourcesContent":["import { tool } from \"@opencode-ai/plugin\"\nimport {\n  configReport,\n  planGate,\n  checkGate,\n  isAckWriteAttempt,\n  isOverrideWriteAttempt,\n  listPendingAck,\n  reportOverrides,\n  requestHumanAck,\n  requestHumanOverride,\n  loopResetGate,\n} from \"./core.js\"\nimport type { RuntimeOverrides } from \"./overrides.js\"\n\nexport const wrangler_config = tool({\n  description:\n    \"AiWrangler ground-truth and gate status. Prints the effective configuration (including AIWRANGLER_* env overrides), every gate flag, the active policy thresholds, and the loaded corpus summary (spec sections, review rules, divergence rulings, open questions, one-way doors, whitepaper sections, corpus hash). Use this first in any session to confirm what AiWrangler is enforcing and that the corpus is present.\",\n  args: {},\n  async execute(_args, ctx) {\n    const dir = ctx.directory ?? process.cwd()\n    try {\n      return configReport(dir)\n    } catch (err) {\n      return `error: ${err instanceof Error ? err.message : String(err)}`\n    }\n  },\n})\n\nexport const wrangler_plan = tool({\n  description:\n    \"AiWrangler pre-flight plan gate. Call BEFORE writing any code. Judges the task against the ground-truth corpus (protocol spec, review rules, divergence rulings, open questions, one-way doors) and returns: an ACTION (pass | clarify | human), the reasons, and a ground-truth context pack you MUST honor while implementing. clarify means the task is ambiguous or touches an unresolved question: ask the user before coding. human means a one-way door or steering risk: stop for the owner.\",\n  args: {\n    task: tool.schema.string().describe(\"the task as given, verbatim if possible\"),\n    plan: tool.schema.string().optional().describe(\"your implementation plan, if you have one drafted\"),\n  },\n  async execute(args, ctx) {\n    const dir = ctx.directory ?? process.cwd()\n    return planGate(dir, {\n      task: args.task,\n      ...(args.plan ? { plan: args.plan } : {}),\n      ...(ctx.sessionID !== undefined ? { sessionID: ctx.sessionID } : {}),\n    })\n  },\n})\n\nexport const wrangler_check = tool({\n  description:\n    \"AiWrangler post-generation gate. Call BEFORE declaring a task done (and after each substantive revision). Runs deterministic checks (review rules, em dashes, deferred-work discipline, pub-API surface, test discipline) plus a Jev semantic battery (claims vs diff, scope discipline, silent defaults, comment truthfulness, spec contradictions, self-report verification) against the dirty files across all tracked repos. Returns PASS / FIX REQUIRED (with a cited, actionable fix list) / HUMAN REVIEW / DEGRADED. Fix every cited finding and re-run until PASS. Pass agent_summary and tool_output to have your status claims verified too.\",\n  args: {\n    task: tool.schema.string().optional().describe(\"the task being implemented (improves scope and spec checks)\"),\n    agent_summary: tool.schema.string().optional().describe(\"your summary of what you did and its status (e.g. 'tests pass, lint clean')\"),\n    tool_output: tool.schema.string().optional().describe(\"the raw output of the build/test commands you ran, for self-report verification\"),\n    cargo: tool.schema.boolean().default(false).describe(\"also run cargo check on dirty repos\"),\n    tests: tool.schema.boolean().default(false).describe(\"also run cargo test on dirty repos (implies cargo)\"),\n  },\n  async execute(args, ctx) {\n    const dir = ctx.directory ?? process.cwd()\n    return checkGate(dir, {\n      ...(args.task ? { task: args.task } : {}),\n      ...(args.agent_summary ? { agentSummary: args.agent_summary } : {}),\n      ...(args.tool_output ? { toolOutput: args.tool_output } : {}),\n      cargo: args.cargo || args.tests || false,\n      tests: args.tests || false,\n      ...(ctx.sessionID !== undefined ? { sessionID: ctx.sessionID } : {}),\n    })\n  },\n})\n\nexport const wrangler_ack = tool({\n  description:\n    \"AiWrangler HUMAN REVIEW. With no rules, note, or diffHash, lists pending human-severity findings and the diff hash. Passing rules requests an acknowledgment. Those arguments do not approve it: this native tool has no MCP elicitation channel, so it shows a desktop dialog. Nothing is recorded unless the owner approves. Prefer the MCP server inside opencode, which can elicit in the editor. Block-severity findings cannot be acked.\",\n  args: {\n    rules: tool.schema.array(tool.schema.string()).optional().describe(\"rule IDs to ask the owner to acknowledge. Does not approve by itself.\"),\n    note: tool.schema.string().optional().describe(\"shown to the owner on the approval prompt and stored if they approve\"),\n    diffHash: tool.schema.string().optional().describe(\"diff hash from the check report; defaults to the latest recorded gate run\"),\n  },\n  async execute(args, ctx) {\n    const dir = ctx.directory ?? process.cwd()\n    if (!isAckWriteAttempt(args)) return listPendingAck(dir)\n    return requestHumanAck(\n      dir,\n      { rules: args.rules ?? [], ...(args.note !== undefined ? { note: args.note } : {}), ...(args.diffHash !== undefined ? { diffHash: args.diffHash } : {}) },\n      { by: \"opencode\" },\n    )\n  },\n})\n\nexport const wrangler_override = tool({\n  description:\n    \"AiWrangler runtime overrides. With no set, clear, or note, reports active overrides. Passing set or clear requests a change. Those arguments do not apply it: this native tool shows a desktop dialog because it has no MCP elicitation channel. Nothing changes unless the owner approves. Prefer the MCP server inside opencode. Overrides expire on the next PASS.\",\n  args: {\n    set: tool.schema\n      .object({\n        activePolicy: tool.schema.string().optional(),\n        egressSemantic: tool.schema.boolean().optional(),\n        actionThreshold: tool.schema.number().min(0).max(1).optional(),\n        reviewThreshold: tool.schema.number().min(0).max(1).optional(),\n        gates: tool.schema.record(tool.schema.string(), tool.schema.boolean()).optional(),\n      })\n      .optional()\n      .describe(\"overrides to ask the owner to apply. Does not apply them by itself.\"),\n    clear: tool.schema.boolean().optional().describe(\"ask the owner to remove active overrides. Does not clear them by itself.\"),\n    note: tool.schema.string().optional().describe(\"shown to the owner on the approval prompt and stored if they approve\"),\n  },\n  async execute(args, ctx) {\n    const dir = ctx.directory ?? process.cwd()\n    if (!isOverrideWriteAttempt(args)) return reportOverrides(dir)\n    return requestHumanOverride(\n      dir,\n      {\n        ...(args.set !== undefined ? { set: args.set as RuntimeOverrides } : {}),\n        ...(args.clear === true ? { clear: true } : {}),\n        ...(args.note !== undefined ? { note: args.note } : {}),\n      },\n      { by: \"opencode\" },\n    )\n  },\n})\n\nexport const wrangler_loop_reset = tool({\n  description:\n    \"AiWrangler circuit-breaker reset. Call ONLY after the user has decided repeated findings are not making progress: clears the retry loop state so the next check starts fresh, and audits a notice. No-op when there is no loop state.\",\n  args: {},\n  async execute(_args, ctx) {\n    const dir = ctx.directory ?? process.cwd()\n    return loopResetGate(dir, \"opencode\")\n  },\n})\n"],"mappings":"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","names":[]}