pi-openappa 0.0.0-stage → 0.1.0

package/test/fixtures/mock-appa.mjs

@@ -0,0 +1,104 @@
+#!/usr/bin/env node
+/**
+ * Scripted `appa hook` stand-in for tests. Behavior is selected with
+ * MOCK_MODE; every received payload is appended to MOCK_RECORD as JSONL so
+ * tests can assert byte-exact echoes across PreToolUse/PostToolUse.
+ */
+import { appendFileSync } from "node:fs";
+
+let raw = "";
+process.stdin.on("data", (chunk) => {
+  raw += chunk;
+});
+process.stdin.on("end", () => {
+  let payload = {};
+  try {
+    payload = JSON.parse(raw);
+  } catch {
+    payload = {};
+  }
+  if (process.env.MOCK_RECORD) {
+    appendFileSync(process.env.MOCK_RECORD, `${JSON.stringify(payload)}\n`);
+    appendFileSync(
+      `${process.env.MOCK_RECORD}.argv`,
+      `${JSON.stringify(process.argv.slice(2))}\n`,
+    );
+  }
+  const event = payload.hook_event_name;
+  const mode = process.env.MOCK_MODE ?? "allow";
+
+  if (mode === "sleep") {
+    setTimeout(() => process.exit(0), 2000);
+    return;
+  }
+  if (mode === "crash") {
+    console.error("appa hook failed to start: mock crash");
+    process.exit(-1);
+    return;
+  }
+
+  if (event === "PreToolUse") {
+    if (mode === "deny-stderr") {
+      console.error("OpenAPPA hook blocked: not declared in this policy");
+      process.exit(2);
+      return;
+    }
+    if (mode === "deny-json") {
+      process.stdout.write(JSON.stringify({ error: "tool host/claude-code/X is not declared" }));
+      console.error("OpenAPPA hook blocked: tool host/claude-code/X is not declared");
+      process.exit(2);
+      return;
+    }
+    if (mode === "deny-permission") {
+      process.stdout.write(
+        JSON.stringify({
+          hookSpecificOutput: {
+            hookEventName: "PreToolUse",
+            permissionDecision: "deny",
+            permissionDecisionReason: "appa: this command may not run here",
+          },
+        }),
+      );
+      process.exit(0);
+      return;
+    }
+    process.stdout.write(
+      JSON.stringify({
+        hookSpecificOutput: {
+          hookEventName: "PreToolUse",
+          permissionDecision: "allow",
+          permissionDecisionReason: "appa: the call is released",
+        },
+      }),
+    );
+    process.exit(0);
+    return;
+  }
+
+  if (event === "PostToolUse" && mode === "replace-result") {
+    process.stdout.write(
+      JSON.stringify({
+        decision: "block",
+        reason: "this outcome does not match the open dispatch; it is not reported",
+        hookSpecificOutput: {
+          hookEventName: "PostToolUse",
+          updatedToolOutput: {
+            exitcode: 0,
+            stdout: "[appa] the tool result was withheld by policy",
+          },
+        },
+      }),
+    );
+    process.exit(0);
+    return;
+  }
+
+  if (event === "PostToolUse" && mode === "deny-result") {
+    console.error("OpenAPPA hook blocked: result may not cross");
+    process.exit(2);
+    return;
+  }
+
+  process.stdout.write("{}");
+  process.exit(0);
+});

package/tsconfig.json

@@ -0,0 +1,16 @@
+{
+  "compilerOptions": {
+    "target": "ES2023",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "lib": ["ES2023"],
+    "types": ["node"],
+    "strict": true,
+    "noUncheckedIndexedAccess": true,
+    "exactOptionalPropertyTypes": true,
+    "noEmit": true,
+    "skipLibCheck": true,
+    "allowImportingTsExtensions": true
+  },
+  "include": ["extensions/**/*.ts", "src/**/*.ts", "test/**/*.ts"]
+}