@herbertgao/pi-extensions 2026.9.5 → 2026.9.7

package/node_modules/@czottmann/pi-automode/extensions/auto-mode/hard-deny.ts

@@ -1,429 +0,0 @@
-import { statSync } from "node:fs";
-import { tmpdir } from "node:os";
-import { resolve } from "node:path";
-import {
-  analyzeBash,
-  type BashAnalysis,
-  type BashCommandAnalysis,
-  type EffectiveCommand,
-} from "./bash.ts";
-import { HOME } from "./constants.ts";
-import {
-  isProfileOrAuthorizedKeysPath,
-  isSafetyControlPath,
-  resolveInputPath,
-  resolvePathForPolicy,
-  shellPathTokenToPath,
-} from "./paths.ts";
-
-function isRecursiveRmArg(arg: string): boolean {
-  return (
-    (arg.length > 2 && arg.startsWith("--") && "--recursive".startsWith(arg)) ||
-    /^-[A-Za-z]*r[A-Za-z]*f?[A-Za-z]*$/i.test(arg) ||
-    /^-[A-Za-z]*f[A-Za-z]*r[A-Za-z]*$/i.test(arg)
-  );
-}
-
-export type RmInvocation = {
-  recursive: boolean;
-  operands: Array<{ value: string; text: string; tildeExpansion: boolean }>;
-};
-
-export function parseRmInvocation(command: EffectiveCommand): RmInvocation {
-  let recursive = false;
-  let optionsEnded = false;
-  const operands: RmInvocation["operands"] = [];
-
-  for (const [index, value] of command.args.entries()) {
-    const text = command.argTexts[index] ?? value;
-    const tildeExpansion = command.argTildeExpansions[index] ?? false;
-    if (!optionsEnded && value === "--") {
-      optionsEnded = true;
-      continue;
-    }
-    if (!optionsEnded && value !== "-" && value.startsWith("-")) {
-      if (isRecursiveRmArg(value)) recursive = true;
-      continue;
-    }
-    operands.push({ value, text, tildeExpansion });
-  }
-
-  return { recursive, operands };
-}
-
-function isUnresolvedUserHomeToken(
-  shellText: string,
-  tildeExpansion: boolean,
-): boolean {
-  return tildeExpansion && shellText !== "~" && !shellText.startsWith("~/");
-}
-
-function isSameExistingPath(left: string, right: string): boolean {
-  try {
-    const leftStat = statSync(left);
-    const rightStat = statSync(right);
-    return leftStat.dev === rightStat.dev && leftStat.ino === rightStat.ino;
-  } catch {
-    return false;
-  }
-}
-
-function matchesPathRoot(path: string, root: string): boolean {
-  if (path === root || path.startsWith(`${root}/`)) return true;
-  const lowerPath = path.toLowerCase();
-  const lowerRoot = root.toLowerCase();
-  if (lowerPath !== lowerRoot && !lowerPath.startsWith(`${lowerRoot}/`)) {
-    return false;
-  }
-  return isSameExistingPath(path.slice(0, root.length), root);
-}
-
-/**
- * Top-level directories whose deletion or wholesale modification is a
- * system-wide event. Shared between candidate validation and path
- * classification; do not inline copies.
- */
-const SYSTEM_ROOTS: ReadonlyArray<string> = [
-  "/bin",
-  "/boot",
-  "/dev",
-  "/etc",
-  "/home",
-  "/lib",
-  "/lib64",
-  "/Library",
-  "/private",
-  "/proc",
-  "/root",
-  "/run",
-  "/sbin",
-  "/sys",
-  "/System",
-  "/usr",
-  "/var",
-];
-
-/**
- * Normalize a proposed temp-root value into a comparable absolute path.
- * Returns undefined for values that cannot denote a subdirectory: the
- * empty string, `/`, and slash-only artifacts.
- */
-function normalizeRootCandidate(value: string): string | undefined {
-  const stripped = value.replace(/\/+$/, "");
-  // An empty stripped value must not fall through to `resolve()`, which
-  // would silently turn `/` into the process working directory.
-  if (!stripped) return undefined;
-  const normalized = resolve(stripped);
-  if (normalized === "/") return undefined;
-  return normalized;
-}
-
-/**
- * True when a candidate temp root would weaken the deterministic deny tiers:
- * it aliases (exact, case-folded, or dev/inode) `HOME`, `/`, or any system
- * root, or it is a proper ancestor of the canonical home directory.
- *
- * Dev/inode identity covers symlinked spellings of existing directories;
- * string comparison alone handles candidates that do not exist yet. See
- * issue #31: without these guards, `TMPDIR=/` reduced every absolute path
- * below an empty-string prefix match, and `TMPDIR=/private` made
- * `/private/etc/**` disposable.
- */
-function conflictsWithProtectedRoots(candidate: string, home: string): boolean {
-  if (candidate === "/") return true;
-  for (const protectedRoot of ["/", home, ...SYSTEM_ROOTS]) {
-    const canonical = resolve(protectedRoot);
-    if (
-      candidate === canonical ||
-      candidate.toLowerCase() === canonical.toLowerCase()
-    ) {
-      return true;
-    }
-    if (isSameExistingPath(candidate, canonical)) return true;
-  }
-  const homeCanonical = resolvePathForPolicy(home) ?? resolve(home);
-  return homeCanonical.toLowerCase().startsWith(`${candidate.toLowerCase()}/`);
-}
-
-let cachedTempRoots: ReadonlyArray<string> | undefined;
-let cachedTmpdirValue: string | undefined;
-
-/**
- * Validated launcher-declared temp-dir roots whose subtrees are treated as
- * disposable by `isRootHomeOrSystemPath`: the platform tmpdir, plus `/tmp` on
- * macOS where it exists independently of `os.tmpdir()`. Each root appears in
- * canonical and resolved spelling because callers pass symlink-resolved
- * policy paths (`/tmp` → `/private/tmp` on macOS) and unresolved fallbacks
- * alike. Values from `os.tmpdir()` are not trusted blindly; see
- * `conflictsWithProtectedRoots`. The roots themselves are never exempt:
- * deleting one is a system-wide delete.
- *
- * The memoization keys on the effective `os.tmpdir()` return value so tests
- * can mutate `TMPDIR`, `TMP`, or `TEMP` between calls.
- */
-export function tempRootCandidates(): ReadonlyArray<string> {
-  const currentTmpdir = tmpdir();
-  if (cachedTempRoots && cachedTmpdirValue === currentTmpdir) {
-    return cachedTempRoots;
-  }
-  cachedTmpdirValue = currentTmpdir;
-  cachedTempRoots = (() => {
-    const roots = new Set<string>();
-    const consider = (value: string) => {
-      const candidate = normalizeRootCandidate(value);
-      if (!candidate || conflictsWithProtectedRoots(candidate, HOME)) return;
-      roots.add(candidate);
-      const resolved = resolvePathForPolicy(candidate);
-      if (resolved) roots.add(resolved);
-    };
-    consider(currentTmpdir);
-    if (process.platform === "darwin") consider("/tmp");
-    return [...roots];
-  })();
-  return cachedTempRoots;
-}
-
-/**
- * True for `/`, the user's home root, or a top-level system root such as
- * `/etc`, `/usr`, or `/var`. Excludes the home *subtree* and the subtrees of
- * platform temp directories (`os.tmpdir()` and `/tmp` on macOS).
- *
- * On some distros (e.g. Fedora Silverblue) HOME lives under `/var`, which is
- * in `systemRoots`. Without the subtree exemption, `path.startsWith("/var/")`
- * would treat every path under HOME as a system root and hard-deny routine
- * `rm -rf ~/...`. HOME itself is still matched below, so `rm -rf ~` stays
- * blocked. `home` is a parameter so this can be unit-tested with a synthetic
- * `/var/home/...` value.
- *
- * The temp exemption mirrors the home one and covers cleanup of directories
- * created with `mktemp`, `os.tmpdir()`, or plain `/tmp` paths. On macOS these
- * resolve into `/private/tmp` or `/private/var/folders`, which used to match
- * the `/private` system root and hard-deny every temp cleanup. Deleting a
- * temp root itself still returns true; `tempRoots` is injectable for tests.
- *
- * Protection order matters (issue #31): exact `/`, the exact home root, and
- * system roots win over every exemption. Injected `tempRoots` values are
- * validated per call so hostile or malformed candidates cannot weaken the
- * deterministic tiers.
- */
-export function isRootHomeOrSystemPath(
-  path: string,
-  home: string,
-  tempRoots: ReadonlyArray<string> = tempRootCandidates(),
-): boolean {
-  if (path === "/") return true;
-  if (path === home || isSameExistingPath(path, home)) return true;
-  if (matchesPathRoot(path, home) && path.length > home.length) return false;
-  for (const root of tempRoots) {
-    const candidate = normalizeRootCandidate(root);
-    if (!candidate || conflictsWithProtectedRoots(candidate, home)) continue;
-    if (!matchesPathRoot(path, candidate)) continue;
-    // Subtree: disposable. Exact match: the temp root stays protected.
-    return path.length > candidate.length ? false : true;
-  }
-  return (
-    matchesPathRoot(path, home) ||
-    SYSTEM_ROOTS.some((root) => matchesPathRoot(path, root))
-  );
-}
-
-function segmentHardDeny(
-  segment: BashCommandAnalysis,
-  cwd: string,
-): string | undefined {
-  for (const target of segment.redirectTargets) {
-    const path = shellPathTokenToPath(target, cwd);
-    if (!path) continue;
-    const profileReason = isProfileOrAuthorizedKeysPath(path);
-    if (profileReason) return profileReason;
-    if (isSafetyControlPath(path, cwd)) {
-      return "auto-mode or permission safety-control modification is hard-denied";
-    }
-  }
-
-  for (const word of segment.words) {
-    if (
-      /^(NODE_TLS_REJECT_UNAUTHORIZED=0|GIT_SSL_NO_VERIFY=(1|true))$/i.test(
-        word,
-      )
-    ) {
-      return "TLS verification weakening is hard-denied";
-    }
-  }
-
-  const command = segment.effectiveCommand;
-  const name = command.name;
-  if (!name) return undefined;
-  const args = command.args;
-  const lowerArgs = args.map((arg) => arg.toLowerCase());
-
-  if (
-    ["curl", "wget"].includes(name) &&
-    lowerArgs.some((arg) =>
-      ["--insecure", "-k", "--no-check-certificate"].includes(arg)
-    )
-  ) {
-    return "certificate verification weakening is hard-denied";
-  }
-  if (
-    ["npm", "yarn", "pnpm"].includes(name) &&
-    lowerArgs[0] === "config" &&
-    lowerArgs[1] === "set" &&
-    ["strict-ssl", "cafile"].includes(lowerArgs[2] ?? "") &&
-    ["false", "null"].includes(lowerArgs[3] ?? "")
-  ) {
-    return "package-manager TLS weakening is hard-denied";
-  }
-  if (
-    name === "git" &&
-    lowerArgs[0] === "config" &&
-    lowerArgs.some(
-      (arg) => arg === "sslverify" || arg.endsWith(".sslverify"),
-    ) &&
-    lowerArgs.includes("false")
-  ) {
-    return "git TLS verification weakening is hard-denied";
-  }
-  if (name === "crontab" && !lowerArgs.includes("-l")) {
-    return "persistence or system service mutation is hard-denied";
-  }
-  if (
-    name === "launchctl" &&
-    ["load", "bootstrap", "enable"].includes(lowerArgs[0] ?? "")
-  ) {
-    return "persistence or system service mutation is hard-denied";
-  }
-  if (
-    name === "systemctl" &&
-    ["enable", "disable"].includes(lowerArgs[0] ?? "")
-  ) {
-    return "persistence or system service mutation is hard-denied";
-  }
-  if (name === "security" && lowerArgs[0] === "add-trusted-cert") {
-    return "platform security weakening is hard-denied";
-  }
-  if (name === "spctl" && lowerArgs.includes("--master-disable")) {
-    return "platform security weakening is hard-denied";
-  }
-  if (name === "csrutil" && lowerArgs[0] === "disable") {
-    return "platform security weakening is hard-denied";
-  }
-
-  if (name === "rm") {
-    const rm = parseRmInvocation(command);
-    if (rm.recursive) {
-      for (const { value: arg, text: shellText, tildeExpansion } of rm.operands) {
-        if (isUnresolvedUserHomeToken(shellText, tildeExpansion)) {
-          return "irreversible deletion of a user-home expansion is hard-denied";
-        }
-        const path = shellPathTokenToPath(arg, cwd, shellText);
-        const policyPath = path ? (resolvePathForPolicy(path) ?? path) : undefined;
-        const policyHome = resolvePathForPolicy(HOME) ?? HOME;
-        if (policyPath && isRootHomeOrSystemPath(policyPath, policyHome)) {
-          return "irreversible deletion of home/root/system paths is hard-denied";
-        }
-      }
-    }
-  }
-
-  if (name === "find" && lowerArgs.includes("-delete")) {
-    const root = shellPathTokenToPath(args[0] ?? "", cwd);
-    const policyRoot = root ? (resolvePathForPolicy(root) ?? root) : undefined;
-    const policyHome = resolvePathForPolicy(HOME) ?? HOME;
-    if (
-      policyRoot &&
-      isRootHomeOrSystemPath(policyRoot, policyHome) &&
-      policyRoot !== policyHome
-    ) {
-      return "system-wide delete is hard-denied";
-    }
-  }
-
-  if (["chmod", "chown"].includes(name)) {
-    for (const arg of args.filter((arg) => !arg.startsWith("-"))) {
-      const path = shellPathTokenToPath(arg, cwd);
-      if (
-        path &&
-        (path.startsWith("/etc/") ||
-          path.startsWith("/usr/") ||
-          path.startsWith("/bin/") ||
-          path.startsWith("/sbin/") ||
-          path.startsWith("/System/") ||
-          path.startsWith(resolve(HOME, ".ssh")))
-      ) {
-        return "system or SSH permission mutation is hard-denied";
-      }
-    }
-  }
-
-  if (
-    [
-      "tee",
-      "mv",
-      "cp",
-      "rm",
-      "unlink",
-      "truncate",
-      "python",
-      "python3",
-      "node",
-      "perl",
-      "ruby",
-      "sd",
-      "sed",
-    ].includes(name) &&
-    /\.pi\/automode|\.pi\/extensions|pi-automode|auto-mode\.json/i.test(
-      segment.raw,
-    )
-  ) {
-    return "auto-mode or permission safety-control modification is hard-denied";
-  }
-
-  return undefined;
-}
-
-/**
- * Deterministic deny checks for actions too risky to delegate to the classifier.
- *
- * Bash checks use the shared unbash AST analysis. The hook passes one analysis
- * through every enforcement stage so nested commands are not reparsed.
- */
-export function deterministicHardDeny(
-  toolName: string,
-  input: Record<string, unknown>,
-  cwd: string,
-  bashAnalysis?: BashAnalysis,
-): string | undefined {
-  if (toolName === "write" || toolName === "edit") {
-    const path = resolveInputPath(cwd, input.path);
-    if (!path) return undefined;
-    const policyPath = resolvePathForPolicy(path) ?? path;
-    const policyCwd = resolvePathForPolicy(cwd) ?? cwd;
-    const profileReason = isProfileOrAuthorizedKeysPath(policyPath);
-    if (profileReason) return profileReason;
-    if (isSafetyControlPath(policyPath, policyCwd)) {
-      return "auto-mode or permission safety-control modification is hard-denied";
-    }
-  }
-
-  if (toolName !== "bash") return undefined;
-  const command = typeof input.command === "string" ? input.command : "";
-  const analysis = bashAnalysis ?? analyzeBash(command);
-  if (analysis.errors.length > 0) {
-    return `Bash input could not be parsed safely: ${analysis.errors[0]?.message ?? "unknown parser error"}`;
-  }
-  for (const target of analysis.redirectTargets) {
-    const path = shellPathTokenToPath(target, cwd);
-    if (!path) continue;
-    const profileReason = isProfileOrAuthorizedKeysPath(path);
-    if (profileReason) return profileReason;
-    if (isSafetyControlPath(path, cwd)) {
-      return "auto-mode or permission safety-control modification is hard-denied";
-    }
-  }
-  for (const segment of analysis.commands) {
-    const reason = segmentHardDeny(segment, cwd);
-    if (reason) return reason;
-  }
-  return undefined;
-}

package/node_modules/@czottmann/pi-automode/extensions/auto-mode/log.ts

@@ -1,173 +0,0 @@
-import { createHash, randomBytes } from "node:crypto";
-import { appendFileSync, mkdirSync } from "node:fs";
-import { homedir } from "node:os";
-import { basename, dirname, extname, isAbsolute, join, resolve } from "node:path";
-import type {
-  ClassifierIo,
-  ClassifierIoAttempt,
-  ClassifierReasoningLog,
-  ClassificationDecision,
-  DecisionKind,
-} from "./types.ts";
-
-/** A final allow/block decision for a tool call. */
-export type DecisionLogEntry = {
-  type: "decision";
-  ts: string;
-  decisionId: string;
-  sessionId?: string;
-  cwd: string;
-  tool: string;
-  summary: string;
-  kind: DecisionKind;
-  outcome: "allow" | "block";
-  reason: string;
-  classifierModel?: string;
-  reasoning: ClassifierReasoningLog;
-};
-
-/** The classifier prompt, raw responses, and parsed decision for one action. */
-export type ClassifierLogEntry = {
-  type: "classifier";
-  ts: string;
-  decisionId: string;
-  model: string;
-  reasoning: ClassifierIo["reasoning"];
-  prompt: ClassifierIo["prompt"];
-  attempts: ClassifierIoAttempt[];
-  durationMs: number;
-  parsed: ClassificationDecision;
-};
-
-/** A ccusage-compatible record for one classifier model response. */
-export type ClassifierUsageLogEntry = {
-  type: "message";
-  timestamp: string;
-  message: {
-    role: "assistant";
-    model: string;
-    usage: NonNullable<ClassifierIoAttempt["response"]>["usage"];
-  };
-};
-
-export type LogEntry =
-  | DecisionLogEntry
-  | ClassifierLogEntry
-  | ClassifierUsageLogEntry;
-
-export type Logger = {
-  enabled: boolean;
-  classifierIo: boolean;
-  append(entry: LogEntry): void;
-};
-
-export type LoggerOptions = {
-  enabled: boolean;
-  classifierIo: boolean;
-  sessionFile?: string;
-  sessionDir: string;
-  /** Effective cwd for an in-memory session. */
-  sessionCwd?: string;
-  sessionId: string;
-  /** Test/embedder override. Runtime uses ~/.pi/agent/extensions/pi-automode/logs. */
-  logRoot?: string;
-  /** Test clock used for the UTC date partition. */
-  now?: Date;
-};
-
-export const DEFAULT_AUTOMODE_LOG_ROOT = join(
-  homedir(),
-  ".pi/agent/extensions/pi-automode/logs",
-);
-
-const VALID_SESSION_ID =
-  /^[A-Za-z0-9](?:[A-Za-z0-9._-]*[A-Za-z0-9])?$/;
-
-function safeLogSessionId(sessionId: string): string {
-  if (VALID_SESSION_ID.test(sessionId)) return sessionId;
-  const digest = createHash("sha256")
-    .update(sessionId)
-    .digest("hex")
-    .slice(0, 16);
-  return `invalid-${digest}`;
-}
-
-/** Short id linking a classifier entry to its decision entry in the same file. */
-export function newDecisionId(): string {
-  return randomBytes(4).toString("hex");
-}
-
-/**
- * Derive the log file path from the current session: the session file's
- * directory with `-pi-automode` inserted before the extension. Falls back to
- * an absolute session directory when one is available. In-memory sessions use
- * an application-owned, project- and date-partitioned directory instead of a
- * relative path resolved against the launching process cwd.
- */
-export function resolveLogPath(
-  sessionFile: string | undefined,
-  sessionDir: string,
-  sessionId: string,
-  sessionCwd = process.cwd(),
-  logRoot = DEFAULT_AUTOMODE_LOG_ROOT,
-  now = new Date(),
-): string {
-  if (sessionFile) {
-    const ext = extname(sessionFile);
-    const stem = ext ? basename(sessionFile, ext) : basename(sessionFile);
-    return join(dirname(sessionFile), `${stem}-pi-automode${ext}`);
-  }
-
-  const logFile = `${safeLogSessionId(sessionId)}-pi-automode.jsonl`;
-  if (isAbsolute(sessionDir)) {
-    return join(sessionDir, logFile);
-  }
-
-  const resolvedCwd = resolve(sessionCwd);
-  const projectDir = `--${
-    resolvedCwd.replace(/^[/\\]/, "").replace(/[/\\:]/g, "-")
-  }--`;
-  const dateDir = now.toISOString().slice(0, 10);
-  const resolvedLogRoot = isAbsolute(logRoot)
-    ? logRoot
-    : DEFAULT_AUTOMODE_LOG_ROOT;
-  return join(
-    resolvedLogRoot,
-    projectDir,
-    dateDir,
-    logFile,
-  );
-}
-
-/** Append one JSON object as a line. Failures are swallowed: logging must
- *  never change a safety decision. */
-function appendJsonl(path: string, entry: unknown): void {
-  try {
-    mkdirSync(dirname(path), { recursive: true });
-    appendFileSync(path, `${JSON.stringify(entry)}\n`, "utf8");
-  } catch {
-    // Fail open.
-  }
-}
-
-/** Build a logger bound to one session's log path. No-ops when disabled. */
-export function createLogger(opts: LoggerOptions): Logger {
-  const { enabled, classifierIo } = opts;
-  const path = resolveLogPath(
-    opts.sessionFile,
-    opts.sessionDir,
-    opts.sessionId,
-    opts.sessionCwd,
-    opts.logRoot,
-    opts.now,
-  );
-  return {
-    enabled,
-    classifierIo,
-    append(entry) {
-      if (!enabled) return;
-      if (entry.type === "classifier" && !classifierIo) return;
-      appendJsonl(path, entry);
-    },
-  };
-}