fapony 0.3.0 → 0.3.4

package/src/install/opencode.ts

@@ -81,9 +81,15 @@ function isConfigured(mcp: Record<string, unknown> | undefined): boolean {
   );
 }
 
+export interface OpencodeInstallOpts {
+  /** Opt-in only: write the git-autonomy rewrite plugin. Never default. */
+  gitAutonomy?: boolean;
+}
+
 export function cmdInstallOpencode(
   dryRun: boolean,
   deps: InstallDeps = {},
+  opts: OpencodeInstallOpts = {},
 ): void {
   const exitFn = deps.exit ?? defaultExit;
   const getHome = deps.homedir ?? homedir;
@@ -115,6 +121,7 @@ export function cmdInstallOpencode(
     installCommitHintPlugin(dryRun, getHome);
     installEditHintPlugin(dryRun, getHome);
     installSessionStartPlugin(dryRun, getHome);
+    if (opts.gitAutonomy) installGitAutonomyPlugin(dryRun, getHome);
     return;
   }
 
@@ -140,6 +147,7 @@ export function cmdInstallOpencode(
     installCommitHintPlugin(dryRun, getHome);
     installEditHintPlugin(dryRun, getHome);
     installSessionStartPlugin(dryRun, getHome);
+    if (opts.gitAutonomy) installGitAutonomyPlugin(dryRun, getHome);
     return;
   }
 
@@ -163,6 +171,7 @@ export function cmdInstallOpencode(
   installCommitHintPlugin(dryRun, getHome);
   installEditHintPlugin(dryRun, getHome);
   installSessionStartPlugin(dryRun, getHome);
+  if (opts.gitAutonomy) installGitAutonomyPlugin(dryRun, getHome);
 }
 
 /**
@@ -335,10 +344,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 {
@@ -350,16 +359,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" });
@@ -374,6 +392,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
@@ -488,8 +512,8 @@ function installEditHintPlugin(dryRun: boolean, getHome: () => string): void {
 }
 
 /**
- * OpenCode plugin — session-start context via `fapony mem kickoff`, the
- * OpenCode parity of Claude's SessionStart hook.
+ * 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
@@ -500,19 +524,29 @@ function installEditHintPlugin(dryRun: boolean, getHome: () => string): void {
  * 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 kickoff exits nonzero or prints nothing (no mem log in scope), never
- * throws. `process.execPath` is the bun running opencode itself — no PATH
- * dependency. Logic shared via `capContext` in src/hook.ts, same one-copy
- * shape as the other three plugins.
+ * 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 \`fapony mem kickoff\` as context once per
-// session, silent when the repo has no mem log. Annotate only: never blocks.
-// Generated by \`fapony install\` — edit src/hook.ts in the fapony checkout.
-import { capContext } from ${hookModule};
+  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();
@@ -522,15 +556,8 @@ export const FaponySessionStart = async ({ directory }) => {
         const sessionID = input?.sessionID;
         if (!sessionID || seen.has(sessionID)) return;
         seen.add(sessionID);
-        const { spawnSync } = require("node:child_process");
-        const kick = spawnSync(process.execPath, [${faponyTs}, "mem", "kickoff"], {
-          cwd: directory,
-          encoding: "utf-8",
-        });
-        if (kick.status !== 0) return;
-        const out = (kick.stdout ?? "").toString().trim();
-        if (!out) return;
-        output.system.push(capContext(out));
+        const ctx = sessionStartContext(directory, ${faponyTs});
+        if (ctx) output.system.push(ctx);
       } catch {
         // context must never break a session start
       }
@@ -553,7 +580,16 @@ function installSessionStartPlugin(
     } catch {
       current = "";
     }
-    if (current.includes("capContext")) {
+    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;
     }
@@ -581,3 +617,108 @@ function installSessionStartPlugin(
     `  session start: ${dryRun ? "would write" : "wrote"} ${pluginPath}`,
   );
 }
+
+/**
+ * OpenCode plugin — git-autonomy rewrites, the parity of the personal
+ * `git-autonomy.ts` plugin. Two hooks because the policy lives on two
+ * surfaces the other never sees:
+ * `experimental.chat.system.transform` (system prompt) + `tool.definition`
+ * (bash tool description).
+ *
+ * OPT-IN ONLY — written only when `fapony install` gets `--git-autonomy`.
+ * Never on the default path, never via `--all` unless the flag rides along.
+ * The policy is an opinion (commit-as-you-go), not a utility, and the file
+ * name is `fapony-git-autonomy.ts`: the user's own `git-autonomy.ts` is a
+ * different file and is never touched — delete it by hand after verifying.
+ *
+ * Logic lives in src/adapters/hooks/git-autonomy.ts
+ * (rewriteGitAutonomySystem / rewriteGitAutonomyTool) — the plugin imports
+ * it from the install root, so `git pull` updates every client. No baked
+ * regex in the generated body: a baked copy would rot silently when upstream
+ * rewords the policy, the same failure this module's gitAutonomyStatus
+ * exists to name. Never throws: a rewrite must not break a session start
+ * or hide a tool.
+ */
+export function gitAutonomyPluginSource(root: string): string {
+  const hookModule = JSON.stringify(join(root, "src", "hook.ts"));
+  return `// fapony git-autonomy — rewrites opencode's ask-first git policy to
+// commit-as-you-go on both surfaces that carry it (system prompt +
+// bash tool description), and cuts the tone few-shot examples.
+// OPT-IN: written only by \`fapony install --platform opencode --git-autonomy\`.
+// Generated by \`fapony install\` — logic lives in src/adapters/hooks/git-autonomy.ts.
+import { rewriteGitAutonomySystem, rewriteGitAutonomyTool } from ${hookModule};
+
+export const FaponyGitAutonomy = async () => ({
+  "experimental.chat.system.transform": async (
+    _input: unknown,
+    output: { system: string[] },
+  ) => {
+    try {
+      for (let i = 0; i < output.system.length; i++) {
+        output.system[i] = rewriteGitAutonomySystem(output.system[i]).text;
+      }
+    } catch {
+      // a rewrite must never break a session start
+    }
+  },
+  "tool.definition": async (
+    input: { toolID: string },
+    output: { description: string; parameters: unknown },
+  ) => {
+    try {
+      const r = rewriteGitAutonomyTool(input.toolID, output.description);
+      output.description = r.description;
+    } catch {
+      // a rewrite must never hide a tool
+    }
+  },
+});
+`;
+}
+
+function installGitAutonomyPlugin(
+  dryRun: boolean,
+  getHome: () => string,
+): void {
+  const pluginsDir = join(getHome(), ".config", "opencode", "plugins");
+  const pluginPath = join(pluginsDir, "fapony-git-autonomy.ts");
+  if (existsSync(pluginPath)) {
+    let current = "";
+    try {
+      current = readFileSync(pluginPath, "utf-8");
+    } catch {
+      current = "";
+    }
+    if (current.includes("FaponyGitAutonomy")) {
+      // Ours — and generated, so never overwritten. Same stale-check shape
+      // as the session-start plugin: an older generation must say so instead
+      // of "no change", or a fixed rewrite never reaches the client.
+      if (current !== gitAutonomyPluginSource(INSTALL_ROOT)) {
+        console.error(
+          `  git-autonomy: stale fapony plugin — delete ${pluginPath} and re-run install --git-autonomy`,
+        );
+        return;
+      }
+      console.error(`  git-autonomy: already installed — no change`);
+      return;
+    }
+    console.error(
+      `  git-autonomy: ${pluginPath} exists but isn't fapony's — not overwriting.`,
+    );
+    return;
+  }
+  if (!dryRun) {
+    try {
+      mkdirSync(pluginsDir, { recursive: true });
+      writeFileSync(pluginPath, gitAutonomyPluginSource(INSTALL_ROOT), "utf-8");
+    } catch (e) {
+      console.error(
+        `  git-autonomy: failed to write — ${(e as Error).message}`,
+      );
+      return;
+    }
+  }
+  console.error(
+    `  git-autonomy: ${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,
@@ -35,6 +37,8 @@ export {
   cmdInstallOpencode,
   commitHintPluginSource,
   editHintPluginSource,
+  gitAutonomyPluginSource,
+  type OpencodeInstallOpts,
   readHintPluginSource,
 } from "./install/opencode.js";
 export {
@@ -56,8 +60,16 @@ export async function cmdInstall(
   const platform = args.find((a) => !a.startsWith("--"));
   const dryRun = args.includes("--dry-run");
   const installAll = args.includes("--all");
+  // Opt-in only: the git-autonomy rewrite is an opinion (commit-as-you-go),
+  // not a utility — never installed unless this flag rides along, including
+  // via --all. Opencode-only; other platforms ignore it.
+  const gitAutonomy = args.includes("--git-autonomy");
 
   // --- explicit platform: original behavior, unchanged ---
+  if (platform === "antigravity") {
+    cmdInstallAntigravity(dryRun, deps);
+    return;
+  }
   if (platform === "claude") {
     cmdInstallClaude(dryRun, deps);
     return;
@@ -75,15 +87,15 @@ export async function cmdInstall(
     return;
   }
   if (platform === "opencode") {
-    cmdInstallOpencode(dryRun, deps);
+    cmdInstallOpencode(dryRun, deps, { gitAutonomy });
     return;
   }
   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] [--git-autonomy]`,
     );
     console.error(
-      `  supported platforms: opencode, claude, cursor, zcode, codex`,
+      `  supported platforms: antigravity, opencode, claude, cursor, zcode, codex`,
     );
     (deps.exit ?? defaultExit)(1);
     return;
@@ -107,7 +119,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>`,
@@ -119,7 +131,7 @@ export async function cmdInstall(
   if (installAll) {
     console.error();
     for (const client of found) {
-      installPlatform(client.platform, dryRun, deps);
+      installPlatform(client.platform, dryRun, deps, { gitAutonomy });
     }
     return;
   }
@@ -148,7 +160,7 @@ export async function cmdInstall(
     for (const client of found) {
       const answer = await askFn(`install into ${client.platform}?`, "Y");
       if (isAffirmative(answer)) {
-        installPlatform(client.platform, dryRun, deps);
+        installPlatform(client.platform, dryRun, deps, { gitAutonomy });
       }
     }
   } finally {
@@ -160,8 +172,12 @@ function installPlatform(
   platform: string,
   dryRun: boolean,
   deps: InstallDeps,
+  opts: { gitAutonomy?: boolean } = {},
 ): void {
   switch (platform) {
+    case "antigravity":
+      cmdInstallAntigravity(dryRun, deps);
+      break;
     case "claude":
       cmdInstallClaude(dryRun, deps);
       break;
@@ -169,7 +185,7 @@ function installPlatform(
       cmdInstallCursor(dryRun, deps);
       break;
     case "opencode":
-      cmdInstallOpencode(dryRun, deps);
+      cmdInstallOpencode(dryRun, deps, opts);
       break;
     case "zcode":
       cmdInstallZcode(dryRun, deps);

package/src/lint-baseline.ts

@@ -14,8 +14,7 @@
 import { execSync } from "node:child_process";
 import { mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
 import { join, relative } from "node:path";
-import { DEFAULT_EVIDENCE_FILE } from "./db/index.js";
-import { faponyDir } from "./db/load.js";
+import { DEFAULT_EVIDENCE_FILE, faponyDir } from "./core/config.js";
 import { assertSafe } from "./safety.js";
 
 const USAGE =

package/src/map.ts

@@ -41,19 +41,36 @@ export interface ExportScan {
   error: string | null;
 }
 
-// --- Parse gate ---
+// --- Parse gate (injectable: default is Bun.Transpiler, no Node fallback —
+// Bun-only is a repo constraint. Pass a custom scanner to extractExports()
+// to reuse this module outside Bun or in tests.) ---
 
-let transpiler: Bun.Transpiler | null = null;
+export interface ExportScanner {
+  scan(source: string): { exports: string[] };
+}
+
+function createBunScanner(): ExportScanner {
+  const transpiler = new Bun.Transpiler({ loader: "tsx" });
+  return {
+    scan: (source) => transpiler.scan(source) as { exports: string[] },
+  };
+}
+
+let defaultScanner: ExportScanner | null = null;
+
+function getDefaultScanner(): ExportScanner {
+  if (!defaultScanner) defaultScanner = createBunScanner();
+  return defaultScanner;
+}
 
 interface ScanResult {
   error: string | null;
   exports: string[];
 }
 
-function scanSource(source: string): ScanResult {
+function scanSource(source: string, scanner: ExportScanner): ScanResult {
   try {
-    if (!transpiler) transpiler = new Bun.Transpiler({ loader: "tsx" });
-    const scanned = transpiler.scan(source) as { exports: string[] };
+    const scanned = scanner.scan(source);
     return { error: null, exports: scanned.exports };
   } catch (e) {
     return {
@@ -150,8 +167,12 @@ function braceNames(
 
 const VAR_DECL_RE = /^export\s+(?:const|let|var)\b/;
 
-export function extractExports(source: string): ExportScan {
-  const scanned = scanSource(source);
+export function extractExports(
+  source: string,
+  scanner?: ExportScanner,
+): ExportScan {
+  const s = scanner ?? getDefaultScanner();
+  const scanned = scanSource(source, s);
   if (scanned.error) return { symbols: [], error: scanned.error };
 
   // Ambient declarations (`export declare ...`) are invisible to scan(), so
@@ -161,7 +182,7 @@ export function extractExports(source: string): ExportScan {
     /^([ \t]*)export\s+declare\s+/gm,
     "$1export ",
   );
-  const strippedScan = scanSource(stripped);
+  const strippedScan = scanSource(stripped, s);
   const valid = new Set([
     ...scanned.exports,
     ...(strippedScan.error ? [] : strippedScan.exports),