fapony 0.3.3 → 0.3.5

package/src/init-mem.ts

@@ -6,7 +6,7 @@
 
 import { existsSync, readdirSync, readFileSync, rmSync } from "node:fs";
 import { join } from "node:path";
-import { DEFAULT_MEM_DIR, FAPONY_DIR, loadConfig } from "./db/index.js";
+import { DEFAULT_MEM_DIR, FAPONY_DIR, loadConfig } from "./core/config.js";
 import { walkDir } from "./util.js";
 
 export function cmdInitMem(args: string[]): void {

package/src/init.ts

@@ -21,7 +21,7 @@ import {
   memoryDir,
   planDir,
   specDir,
-} from "./db/index.js";
+} from "./core/config.js";
 import { isAffirmative } from "./util.js";
 
 const FAPONY_README = `# .fapony/ — fapony project dir (plans, specs, memory)

package/src/install/claude.ts

@@ -232,6 +232,7 @@ function installClaudeHooks(dryRun: boolean, deps: InstallDeps): void {
   installStopHook(dryRun, deps);
   installReadHintHook(dryRun, deps);
   installEditHintHook(dryRun, deps);
+  installMvGuardHook(dryRun, deps);
   installSessionStartHook(dryRun, deps);
 }
 
@@ -276,6 +277,22 @@ function installEditHintHook(dryRun: boolean, deps: InstallDeps): void {
   });
 }
 
+/**
+ * PreToolUse hook on Bash: denies a raw `git mv` of a plan file into a done/
+ * directory, pointing at `fapony mem plan-sweep --apply` instead — that
+ * command does the link rewrite a plain `git mv` skips. The one fapony hook
+ * that blocks besides Stop; matcher "Bash" keeps the spawn off every other
+ * tool call.
+ */
+function installMvGuardHook(dryRun: boolean, deps: InstallDeps): void {
+  ensureClaudeHook(dryRun, deps, {
+    event: "PreToolUse",
+    matcher: "Bash",
+    subcommand: "hook-mv-guard",
+    label: "plan-mv guard",
+  });
+}
+
 /**
  * SessionStart hook: injects `fapony mem kickoff` as context when the repo has
  * a mem log, and stays silent when it does not. Context only — SessionStart

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);
 }
 
 /**
@@ -608,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

@@ -37,6 +37,8 @@ export {
   cmdInstallOpencode,
   commitHintPluginSource,
   editHintPluginSource,
+  gitAutonomyPluginSource,
+  type OpencodeInstallOpts,
   readHintPluginSource,
 } from "./install/opencode.js";
 export {
@@ -58,6 +60,10 @@ 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") {
@@ -81,12 +87,12 @@ 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 antigravity|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: antigravity, opencode, claude, cursor, zcode, codex`,
@@ -125,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;
   }
@@ -154,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 {
@@ -166,6 +172,7 @@ function installPlatform(
   platform: string,
   dryRun: boolean,
   deps: InstallDeps,
+  opts: { gitAutonomy?: boolean } = {},
 ): void {
   switch (platform) {
     case "antigravity":
@@ -178,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),