fapony 0.2.1 → 0.3.3

package/src/install/detect.ts

@@ -1,14 +1,16 @@
 // src/install/detect.ts — detect which MCP clients are installed on this machine.
 //
 // Signal per client:
-//   claude   = `command -v claude` (CLI on PATH)
-//   cursor   = ~/.cursor exists (the app creates it on first run)
-//   opencode = ~/.config/opencode/{opencode.json,opencode.jsonc} exists
-//   zcode    = ~/.zcode/cli/config.json or ~/.agents/mcp.json exists
-//   codex    = ~/.codex/config.toml exists
+//   antigravity = ~/.gemini exists (the app creates it on first run)
+//   claude      = `command -v claude` (CLI on PATH)
+//   cursor      = ~/.cursor exists (the app creates it on first run)
+//   opencode    = ~/.config/opencode/{opencode.json,opencode.jsonc} exists
+//   zcode       = ~/.zcode/cli/config.json or ~/.agents/mcp.json exists
+//   codex       = ~/.codex/config.toml exists
 
 import { homedir } from "node:os";
 import { defaultCheckCmd } from "../setup.js";
+import { findGeminiDir } from "./antigravity.js";
 import { findCodexConfig } from "./codex.js";
 import { findCursorDir } from "./cursor.js";
 import { findOpencodeConfig } from "./opencode.js";
@@ -23,10 +25,10 @@ export interface DetectedClient {
 
 /**
  * Detect which MCP clients are available on this machine.
- * Returns one entry per platform, ordered: claude, cursor, opencode, zcode, codex.
+ * Returns one entry per platform, ordered: antigravity, claude, cursor, opencode, zcode, codex.
  *
  * Uses resolvers from each provider (file/dir-exists check) for
- * cursor/opencode/zcode/codex, and `command -v claude` for claude — all
+ * antigravity/cursor/opencode/zcode/codex, and `command -v claude` for claude — all
  * through injected deps for testability.
  */
 export function detectClients(deps: InstallDeps = {}): DetectedClient[] {
@@ -35,12 +37,20 @@ export function detectClients(deps: InstallDeps = {}): DetectedClient[] {
 
   const claude = checkCmd("claude");
 
+  const geminiDir = findGeminiDir(getHome);
   const cursorDir = findCursorDir(getHome);
   const opencodePath = findOpencodeConfig(getHome);
   const zcodeResult = findZcodeConfig(getHome);
   const codexPath = findCodexConfig(getHome);
 
   return [
+    {
+      platform: "antigravity",
+      installed: geminiDir !== null,
+      why: geminiDir
+        ? `dir at ${geminiDir}`
+        : "no ~/.gemini directory (open Antigravity once)",
+    },
     {
       platform: "claude",
       installed: claude,

package/src/install/opencode.ts

@@ -114,6 +114,7 @@ export function cmdInstallOpencode(
     installReadHintPlugin(dryRun, getHome);
     installCommitHintPlugin(dryRun, getHome);
     installEditHintPlugin(dryRun, getHome);
+    installSessionStartPlugin(dryRun, getHome);
     return;
   }
 
@@ -138,6 +139,7 @@ export function cmdInstallOpencode(
     installReadHintPlugin(dryRun, getHome);
     installCommitHintPlugin(dryRun, getHome);
     installEditHintPlugin(dryRun, getHome);
+    installSessionStartPlugin(dryRun, getHome);
     return;
   }
 
@@ -160,6 +162,7 @@ export function cmdInstallOpencode(
   installReadHintPlugin(dryRun, getHome);
   installCommitHintPlugin(dryRun, getHome);
   installEditHintPlugin(dryRun, getHome);
+  installSessionStartPlugin(dryRun, getHome);
 }
 
 /**
@@ -332,10 +335,10 @@ export const FaponyCommitHint = async ({ directory }) => {
 export function editHintPluginSource(root: string): string {
   const hookModule = JSON.stringify(join(root, "src", "hook.ts"));
   return `// fapony edit hint — annotates edits to source files that have importers
-// with the importer count plus the review-seed command that lists them.
+// with the importer count, plus mem/debt context rows about the file.
 // Annotate only: never blocks, dedupe per (session, file) inside editHintFor.
 // Generated by \`fapony install\` — edit src/hook.ts in the fapony checkout.
-import { editHintFor, recordHintFire } from ${hookModule};
+import { editHintFor, readContextData, recordHintFire } from ${hookModule};
 
 export const FaponyEditHint = async ({ directory }) => {
   return {
@@ -347,16 +350,25 @@ export const FaponyEditHint = async ({ directory }) => {
         // spends the per-session dedupe row or logs a fire that never showed.
         if (typeof output.output !== "string") return;
         const filePath = input.args?.filePath;
+        const parts = [];
         const hint = editHintFor({
           filePath,
           cwd: directory,
           session: input.sessionID,
         });
+        if (hint) parts.push(hint);
+        // Attach mem/debt context (same as read hint — annotate only, cap 5 lines)
+        const ctx = readContextData(filePath, directory);
+        if (ctx) {
+          for (const line of [...ctx.debtLines, ...ctx.memLines]) {
+            parts.push(line);
+          }
+        }
+        if (parts.length > 0) {
+          output.output = output.output + "\\n" + parts.join("\\n");
 
-        // --- hint-fire log (PLAN-edit-importer-hint, opencode parity) ---
-        // After output — best-effort, never block the hint.
-        if (hint) {
-          output.output = output.output + "\\n" + hint;
+          // --- hint-fire log (PLAN-edit-importer-hint, opencode parity) ---
+          // After output — best-effort, never block the hint.
           try {
             const { spawnSync } = require("node:child_process");
             const git = spawnSync("git", ["rev-parse", "--show-toplevel"], { cwd: directory, encoding: "utf-8" });
@@ -371,6 +383,12 @@ export const FaponyEditHint = async ({ directory }) => {
                 } catch { return null; }
               })() : null;
               recordHintFire({ ts: new Date().toISOString(), worktree, surface: "edit", file: rel, count: 1 });
+              if (ctx?.debtIds?.length) {
+                recordHintFire({ ts: new Date().toISOString(), worktree, surface: "debt", file: rel, count: ctx.debtIds.length, ids: ctx.debtIds });
+              }
+              if (ctx?.memLines?.length) {
+                recordHintFire({ ts: new Date().toISOString(), worktree, surface: "mem", file: rel, count: ctx.memLines.length });
+              }
             }
           } catch {
             // best-effort
@@ -483,3 +501,110 @@ function installEditHintPlugin(dryRun: boolean, getHome: () => string): void {
     `  edit hint: ${dryRun ? "would write" : "wrote"} ${pluginPath}`,
   );
 }
+
+/**
+ * OpenCode plugin — session-start context, the parity of Claude's SessionStart
+ * hook.
+ *
+ * Why `experimental.chat.system.transform` and not the `event` hook on
+ * `session.created`: the event hook is observer-only (returns void, no
+ * injection channel), while system.transform's `output.system` is the
+ * documented injection point (`packages/plugin/src/index.ts`: input
+ * `{ sessionID?, model }`, output `{ system: string[] }`). The context lands
+ * on the first model dispatch instead of at session creation — one step late,
+ * the same shape as every other OpenCode hint (annotate-after), and arguably
+ * better: sessions that never dispatch never pay the spawn.
+ *
+ * The guard (no mem log = silence), the kickoff spawn and the cap all live in
+ * `sessionStartContext` (src/hook.ts), imported at runtime like the read /
+ * commit / edit hint plugins — so `git pull` updates this client too. It used
+ * to bake `mem kickoff` into the generated body and push stdout, which injected
+ * kickoff's "# <path> — 0 entries" header into every session of every repo
+ * with no mem log (bug mub2ezhi) and could not be fixed by a pull. One import,
+ * one implementation, shared with the Claude/Codex hooks.
+ *
+ * Once per session (closure Set — the factory runs once per server), silent
+ * when `sessionStartContext` returns null (no mem log in scope), never throws.
+ * `process.execPath` is the bun running opencode itself — no PATH dependency.
+ * Verified against OpenCode 1.18.29; `experimental.chat.system.transform` is an
+ * experimental hook, so a rename makes this plugin quiet with no error — check
+ * on OpenCode upgrades.
+ */
+export function sessionStartPluginSource(root: string): string {
+  const hookModule = JSON.stringify(join(root, "src", "hook.ts"));
+  const faponyTs = JSON.stringify(join(root, "fapony.ts"));
+  return `// fapony session start — injects the \`fapony mem kickoff\` digest as context
+// once per session via sessionStartContext, silent when the repo has no mem log.
+// Annotate only: never blocks.
+// Generated by \`fapony install\` — logic lives in src/hook.ts (sessionStartContext).
+import { sessionStartContext } from ${hookModule};
+
+export const FaponySessionStart = async ({ directory }) => {
+  const seen = new Set();
+  return {
+    "experimental.chat.system.transform": async (input, output) => {
+      try {
+        const sessionID = input?.sessionID;
+        if (!sessionID || seen.has(sessionID)) return;
+        seen.add(sessionID);
+        const ctx = sessionStartContext(directory, ${faponyTs});
+        if (ctx) output.system.push(ctx);
+      } catch {
+        // context must never break a session start
+      }
+    },
+  };
+};
+`;
+}
+
+function installSessionStartPlugin(
+  dryRun: boolean,
+  getHome: () => string,
+): void {
+  const pluginsDir = join(getHome(), ".config", "opencode", "plugins");
+  const pluginPath = join(pluginsDir, "fapony-session-start.ts");
+  if (existsSync(pluginPath)) {
+    let current = "";
+    try {
+      current = readFileSync(pluginPath, "utf-8");
+    } catch {
+      current = "";
+    }
+    if (current.includes("FaponySessionStart")) {
+      // Ours — and generated, so never overwritten. A file baked by an older
+      // fapony differs from what we generate now: say so instead of "no change",
+      // which is how the pre-hook plugin (mub2ezhi) would have been kept.
+      if (current !== sessionStartPluginSource(INSTALL_ROOT)) {
+        console.error(
+          `  session start: stale fapony plugin — delete ${pluginPath} and re-run install`,
+        );
+        return;
+      }
+      console.error(`  session start: already installed — no change`);
+      return;
+    }
+    console.error(
+      `  session start: ${pluginPath} exists but isn't fapony's — not overwriting.`,
+    );
+    return;
+  }
+  if (!dryRun) {
+    try {
+      mkdirSync(pluginsDir, { recursive: true });
+      writeFileSync(
+        pluginPath,
+        sessionStartPluginSource(INSTALL_ROOT),
+        "utf-8",
+      );
+    } catch (e) {
+      console.error(
+        `  session start: failed to write — ${(e as Error).message}`,
+      );
+      return;
+    }
+  }
+  console.error(
+    `  session start: ${dryRun ? "would write" : "wrote"} ${pluginPath}`,
+  );
+}

package/src/install.ts

@@ -12,6 +12,7 @@
 // ZCode gets skill/<name>/ symlinked into ~/.agents/skills.
 
 import { createInterface } from "node:readline";
+import { cmdInstallAntigravity } from "./install/antigravity.js";
 import { cmdInstallClaude } from "./install/claude.js";
 import { cmdInstallCodex } from "./install/codex.js";
 import { cmdInstallCursor } from "./install/cursor.js";
@@ -22,6 +23,7 @@ import { cmdInstallZcode } from "./install/zcode.js";
 import { ask } from "./setup.js";
 import { isAffirmative } from "./util.js";
 
+export { cmdInstallAntigravity } from "./install/antigravity.js";
 export {
   claudeAddArgs,
   claudeGetArgs,
@@ -58,6 +60,10 @@ export async function cmdInstall(
   const installAll = args.includes("--all");
 
   // --- explicit platform: original behavior, unchanged ---
+  if (platform === "antigravity") {
+    cmdInstallAntigravity(dryRun, deps);
+    return;
+  }
   if (platform === "claude") {
     cmdInstallClaude(dryRun, deps);
     return;
@@ -80,10 +86,10 @@ export async function cmdInstall(
   }
   if (platform !== undefined) {
     console.error(
-      `usage: fapony install --platform opencode|claude|cursor|zcode|codex [--dry-run]`,
+      `usage: fapony install --platform antigravity|opencode|claude|cursor|zcode|codex [--dry-run]`,
     );
     console.error(
-      `  supported platforms: opencode, claude, cursor, zcode, codex`,
+      `  supported platforms: antigravity, opencode, claude, cursor, zcode, codex`,
     );
     (deps.exit ?? defaultExit)(1);
     return;
@@ -107,7 +113,7 @@ export async function cmdInstall(
   if (found.length === 0) {
     console.error();
     console.error(
-      `  no MCP client found (looked for claude on PATH; config files for cursor, opencode, zcode, codex).`,
+      `  no MCP client found (looked for claude on PATH; config files for antigravity, cursor, opencode, zcode, codex).`,
     );
     console.error(
       `  open the app once, then re-run — or force with: fapony install --platform <name>`,
@@ -162,6 +168,9 @@ function installPlatform(
   deps: InstallDeps,
 ): void {
   switch (platform) {
+    case "antigravity":
+      cmdInstallAntigravity(dryRun, deps);
+      break;
     case "claude":
       cmdInstallClaude(dryRun, deps);
       break;

package/src/lint-baseline.ts

@@ -52,12 +52,12 @@ function gitSha(cwd: string): string {
   return p.exitCode === 0 ? p.stdout.toString().trim().slice(0, 12) : "none";
 }
 
-function baselinePath(worktree: string): string {
+export function baselinePath(worktree: string): string {
   const key = worktree.replace(/[^A-Za-z0-9._-]+/g, "_");
   return join(faponyDir(), "lint-baseline", `${key}.json`);
 }
 
-function readEvidenceLintCmd(worktree: string): string | null {
+export function readEvidenceLintCmd(worktree: string): string | null {
   const evidence = join(worktree, DEFAULT_EVIDENCE_FILE);
   try {
     const parsed = JSON.parse(readFileSync(evidence, "utf-8")) as {

package/src/mcp/primitives.ts

@@ -157,7 +157,7 @@ export interface VerificationReport {
   evidence: EvidenceItem[];
   /** Evidence summary (computed from evidence array). */
   evidence_summary: EvidenceSummary;
-  /** Verdict grade + note (from gate/verdict_submit, or null if not yet). */
+  /** Verdict grade + note (from the frozen gate/verdict ledger, or null if never graded). */
   verdict: {
     grade: string;
     note: string;

package/src/mcp/tools/index.ts

@@ -6,86 +6,11 @@
 // saves more than it costs (see CLAUDE.md "จ่าย token อย่างฉลาด"). Keep
 // descriptions imperative — say what to send, not why it matters.
 
-import { VERDICT_GRADES } from "../../parse.js";
-import { REASON_CODES, REGIME_CODES } from "../types.js";
-
-export { toolMemAdd, toolMemFind } from "./mem.js";
-export { toolPassiveUsage } from "./usage.js";
-export { toolVerdictSubmit } from "./verdict.js";
+export { toolMemAdd, toolMemClose, toolMemFind } from "./mem.js";
 
 // --- Tool definitions ---
 
 export const TOOLS = [
-  {
-    name: "verdict_submit",
-    description:
-      "Grade a finished unit of work — every unit that ends, including work " +
-      "that went right the first time. Submit 'fail' the moment a first " +
-      "attempt turns out wrong, then a pass-family verdict once the fix is " +
-      "verified. Never leave a run open: one stuck at running/fixing absorbs " +
-      "later unrelated verdicts for that worktree. Without run_id, binds to " +
-      "the latest open run for the same worktree+plan, else creates one.",
-    inputSchema: {
-      type: "object" as const,
-      properties: {
-        run_id: {
-          type: "number",
-          description: "Existing run to attach to. Omitted = bind or create.",
-        },
-        verdict: {
-          type: "string",
-          enum: [...VERDICT_GRADES],
-          description: "Verdict grade",
-        },
-        reason_code: {
-          type: "string",
-          enum: [...REASON_CODES],
-          description:
-            "Failure reason. Clean passes take 'none', never 'other'.",
-        },
-        regime: {
-          type: "string",
-          enum: [...REGIME_CODES],
-          description:
-            "Task shape: code=feature/refactor, fix=debugging a defect, " +
-            "review=reviewing a diff, plan=producing a plan or spec, " +
-            "inquiry=questions without editing files, test=writing tests",
-        },
-        note: {
-          type: "string",
-          description:
-            "Standalone note — read months later with no access to this " +
-            "conversation. Required when reason_code = 'other'.",
-        },
-        worktree: {
-          type: "string",
-          description:
-            "Absolute repo path (git rev-parse --show-toplevel). Every query " +
-            "scopes by it, so a bare name or an omission files the verdict " +
-            "where nothing reads it. Neither case errors.",
-        },
-        plan: {
-          type: "string",
-          description: "Plan file path, for a new run",
-        },
-        session_id: {
-          type: "string",
-          description:
-            "Client session id (Claude Code/Codex: the transcript .jsonl " +
-            "path; OpenCode/ZCode: the session id) — this is what attributes " +
-            "the verdict to a model. Cannot find it → omit, never invent one.",
-        },
-        files: {
-          type: "array",
-          items: { type: "string" },
-          description:
-            "Repo-relative paths this unit touched. Optional, but always " +
-            "send them: nothing else records where the work landed.",
-        },
-      },
-      required: ["verdict", "reason_code", "regime"],
-    },
-  },
   {
     name: "mem_find",
     description:
@@ -179,43 +104,29 @@ export const TOOLS = [
     },
   },
   {
-    name: "fapony_usage",
+    name: "mem_close",
     description:
-      "Query passive usage across every coding client on this machine — " +
-      "OpenCode, Claude Code, Codex, and ZCode — on one ruler: token counts, " +
-      "cost, and breakdown by model. No client's own session log can see " +
-      "another's, so this is the only way to compare them. Filter by " +
-      "worktree and time range.",
+      "Close a mem row by id with a tombstone message (what was done). " +
+      "The write half of closing what mem_find shows as open — id must exist. " +
+      "Returns the ref and timestamp.",
     inputSchema: {
       type: "object" as const,
       properties: {
         worktree: {
           type: "string",
-          description: "Filter by worktree path (absolute)",
-        },
-        since: {
-          type: "number",
-          description:
-            "Unix timestamp — include sessions created at or after this time",
-        },
-        until: {
-          type: "number",
           description:
-            "Unix timestamp — include sessions created at or before this time",
+            "Absolute path (git rev-parse --show-toplevel) — required",
         },
-        detail: {
-          type: "boolean",
-          description:
-            "If true, include tool-call breakdown + step counts per session " +
-            "(activity signal, not quality). Default false keeps output compact.",
+        id: {
+          type: "string",
+          description: "The row id to close",
         },
-        json: {
-          type: "boolean",
-          description:
-            "If true, return raw JSON PassiveUsageResult. If false (default), return human-readable text.",
+        text: {
+          type: "string",
+          description: "Tombstone message — what was done (commit sha counts)",
         },
       },
-      required: [],
+      required: ["worktree", "id", "text"],
     },
   },
 ];

package/src/mcp/tools/mem.ts

@@ -235,3 +235,74 @@ export function toolMemAdd(args: Record<string, unknown>): ToolResult {
     return errorResult(e instanceof Error ? e.message : String(e));
   }
 }
+
+// --- mem_close ---
+//
+// A separate tool on purpose, not kind:"close" inside mem_add: a close row
+// carries {ref, text} with no files[] and no spec, while mem_add requires a
+// non-empty files[] (and a spec for hold) — folding them into one schema
+// would make required fields depend on the value of another field, the shape
+// models call wrong most often. Mirrors CLI `mem close <id> "<msg>"`
+// (commands/write.ts cmdClose): the id must exist; the tombstone voids the
+// claim by itself.
+
+export interface MemCloseResult {
+  ref: string;
+  text: string;
+  ts: string;
+}
+
+export function memClose(args: {
+  worktree: string;
+  id: string;
+  text: string;
+}): MemCloseResult {
+  if (!args.id.trim()) {
+    throw new Error("id is required");
+  }
+  if (!args.text.trim()) {
+    throw new Error("text is required and must not be empty");
+  }
+
+  initStore(args.worktree);
+  const all = rows();
+  if (!all.some((r) => "id" in r && r.id === args.id)) {
+    throw new Error(`no id "${args.id}" in the log`);
+  }
+
+  const ts = new Date().toISOString();
+  put({ kind: "close", ref: args.id, text: args.text });
+
+  return { ref: args.id, text: args.text, ts };
+}
+
+export function toolMemClose(args: Record<string, unknown>): ToolResult {
+  const worktree =
+    typeof args.worktree === "string" ? args.worktree.trim() : "";
+  if (!worktree) {
+    return errorResult(
+      "worktree is required and must be an absolute path " +
+        "(git rev-parse --show-toplevel)",
+    );
+  }
+  if (!worktree.startsWith("/")) {
+    return errorResult(`worktree must be an absolute path, got: ${worktree}`);
+  }
+
+  const id = typeof args.id === "string" ? args.id.trim() : "";
+  if (!id) {
+    return errorResult("id is required — the row id to close");
+  }
+
+  const text = typeof args.text === "string" ? args.text.trim() : "";
+  if (!text) {
+    return errorResult("text is required and must not be empty");
+  }
+
+  try {
+    const result = memClose({ worktree, id, text });
+    return jsonResult(result);
+  } catch (e) {
+    return errorResult(e instanceof Error ? e.message : String(e));
+  }
+}