@tekmidian/pai 1.0.0 → 1.0.2

package/scripts/build-hooks.mjs

@@ -1,311 +0,0 @@
-#!/usr/bin/env node
-/**
- * Build TypeScript hooks into standalone .mjs files using esbuild.
- *
- * Each hook is fully self-contained — lib/ dependencies are inlined.
- * Output: dist/hooks/<name>.mjs with #!/usr/bin/env node shebang.
- *
- * With --sync: also creates/updates symlinks (or copies on Windows) from
- * ~/.claude/Hooks/ and ~/.claude/ to the built/source files, plus the
- * PAI_HOME/agents and PAI_HOME/commands adapter symlinks at ~/.claude/agents
- * and ~/.claude/commands (once `pai config migrate` has populated them once).
- * This ensures that `bun run build` is the only step needed to deploy updates.
- */
-
-import { buildSync } from "esbuild";
-import {
-  readdirSync,
-  statSync,
-  chmodSync,
-  existsSync,
-  mkdirSync,
-  symlinkSync,
-  lstatSync,
-  readlinkSync,
-  unlinkSync,
-  copyFileSync,
-  readFileSync,
-  writeFileSync,
-  renameSync,
-  rmSync,
-} from "fs";
-import { join, resolve, basename } from "path";
-import { homedir, platform } from "os";
-import { paiHomeDir as resolvePaiHomeDir, syncSkipReason } from "./lib/sync-guard.mjs";
-
-const HOOKS_SRC = "src/hooks/ts";
-const HOOKS_OUT = "dist/hooks";
-const doSync = process.argv.includes("--sync");
-
-// Bundled CJS deps (e.g. yaml) call require() for Node builtins like
-// "process". esbuild's ESM output leaves those calls as a `require` that
-// only exists at runtime if the module defines it — plain .mjs run via node
-// has no `require`, so the call throws "Dynamic require of ... is not
-// supported". createRequire gives every bundle a real one.
-//
-// PAI_QUIET_NOTICES=1 silences one-time stderr notices (e.g. the PAI_DIR
-// deprecation warning in pai-paths.ts) for every hook and standalone script
-// built here — their stderr is machinery Claude Code inspects for errors and
-// the statusline pipes through, never a human terminal, so it must stay
-// clean. Set only if unset, so a caller that deliberately wants the notices
-// (debugging) can still get them.
-const REQUIRE_SHIM = {
-  js: "import { createRequire as __paiCreateRequire } from 'node:module';\nconst require = __paiCreateRequire(import.meta.url);\nif (!process.env.PAI_QUIET_NOTICES) process.env.PAI_QUIET_NOTICES = '1';",
-};
-
-// Collect all .ts entry points (skip lib/ — those are bundled into each hook)
-function collectEntryPoints(dir) {
-  const entries = [];
-  for (const name of readdirSync(dir)) {
-    const full = join(dir, name);
-    if (name === "lib") continue;
-    if (statSync(full).isDirectory()) {
-      entries.push(...collectEntryPoints(full));
-    } else if (name.endsWith(".ts") && !name.endsWith(".test.ts")) {
-      entries.push(full);
-    }
-  }
-  return entries;
-}
-
-const entryPoints = collectEntryPoints(HOOKS_SRC);
-
-console.log(`Building ${entryPoints.length} hooks with esbuild...`);
-
-// Build into a staging directory, then rename each artefact into place.
-//
-// ~/.claude/Hooks/*.mjs are symlinks to these files, and every LIVE Claude Code
-// session executes them on each tool call. esbuild truncates-then-writes, so
-// building straight to the output path leaves a window in which the file does
-// not exist — any hook firing during a build in another session dies with
-// "No such file or directory". That is not hypothetical: a rebuild here breaks
-// hooks in every other session that happens to fire during it.
-//
-// rename(2) within one filesystem is atomic, so a concurrent session sees
-// either the previous build or the new one, never a partial or absent file.
-const STAGING = join(HOOKS_OUT, ".staging");
-rmSync(STAGING, { recursive: true, force: true });
-mkdirSync(STAGING, { recursive: true });
-
-for (const entry of entryPoints) {
-  const name = basename(entry).replace(/\.ts$/, ".mjs");
-  const staged = join(STAGING, name);
-
-  buildSync({
-    entryPoints: [entry],
-    bundle: true,
-    platform: "node",
-    target: "node20",
-    format: "esm",
-    outfile: staged,
-    sourcemap: true,
-    banner: REQUIRE_SHIM,
-  });
-
-  chmodSync(staged, 0o755);
-
-  // The sourceMappingURL comment is a bare filename, so the map must land in
-  // the same directory as the module. Move it first: a stale map for a moment
-  // is harmless, a missing module is not.
-  const stagedMap = `${staged}.map`;
-  if (existsSync(stagedMap)) {
-    renameSync(stagedMap, join(HOOKS_OUT, `${name}.map`));
-  }
-  renameSync(staged, join(HOOKS_OUT, name));
-}
-
-rmSync(STAGING, { recursive: true, force: true });
-
-console.log(`✔ ${entryPoints.length} hooks built to ${HOOKS_OUT}/`);
-
-// ---------------------------------------------------------------------------
-// Standalone worker status-line: src/workers/standalone/status-line.ts →
-// dist/worker-status-line.mjs (same atomic-staging rules; it runs on every
-// statusline refresh of every live session).
-// ---------------------------------------------------------------------------
-
-// [entry, output name in dist/hooks/]
-const STANDALONE_ENTRIES = [
-  ["src/workers/standalone/status-line.ts", "worker-status-line.mjs"],
-  // detached proxy for openai-protocol providers; spawned from dist, not
-  // symlinked into ~/.claude, so it is NOT in the --sync list below
-  ["src/workers/standalone/proxy.ts", "worker-proxy.mjs"],
-  // detached worker session pool host (src/workers/pool-host.ts); spawned
-  // from dist like the proxy, NOT symlinked into ~/.claude
-  ["src/workers/standalone/pool-host.ts", "worker-pool-host.mjs"],
-];
-
-mkdirSync(STAGING, { recursive: true });
-for (const [entry, name] of STANDALONE_ENTRIES) {
-  const staged = join(STAGING, name);
-  buildSync({
-    entryPoints: [entry],
-    bundle: true,
-    platform: "node",
-    target: "node20",
-    format: "esm",
-    outfile: staged,
-    sourcemap: true,
-    banner: REQUIRE_SHIM,
-    // the pool host pulls the storage factory (via run.ts → project-config),
-    // whose embeddings backend needs the native onnx binding — native .node
-    // files can never be bundled; resolve it at runtime like the rest of
-    // node_modules (the host runs from dist/, inside the repo)
-    external: ["onnxruntime-node"],
-  });
-  chmodSync(staged, 0o755);
-  const stagedMap = `${staged}.map`;
-  if (existsSync(stagedMap)) {
-    renameSync(stagedMap, join(HOOKS_OUT, `${name}.map`));
-  }
-  mkdirSync(HOOKS_OUT, { recursive: true });
-  renameSync(staged, join(HOOKS_OUT, name));
-}
-
-rmSync(STAGING, { recursive: true, force: true });
-
-console.log(
-  `✔ ${STANDALONE_ENTRIES.length} standalone script(s) built to ${HOOKS_OUT}/ (${STANDALONE_ENTRIES.map(([, n]) => n).join(", ")})`
-);
-
-// ---------------------------------------------------------------------------
-// --sync: Symlink (or copy on Windows) all deployable files to ~/.claude/
-// ---------------------------------------------------------------------------
-
-const skipReason = doSync ? syncSkipReason() : null;
-if (skipReason) {
-  // Only the canonical install repoints the live ~/.claude symlinks — see
-  // scripts/lib/sync-guard.mjs.
-  console.log(skipReason.startsWith("skipping") ? skipReason : `✔ Hook symlinks skipped: ${skipReason}`);
-} else if (doSync) {
-  const useSymlinks = platform() !== "win32";
-  const claudeDir = join(homedir(), ".claude");
-  const hooksTarget = join(claudeDir, "Hooks");
-  mkdirSync(hooksTarget, { recursive: true });
-
-  let created = 0;
-  let updated = 0;
-  let current = 0;
-
-  /**
-   * Ensure `target` is a symlink (or copy on Windows) pointing to `source`.
-   * Replaces stale symlinks and plain-file copies with correct symlinks.
-   * Never overwrites non-symlink, non-PAI files (user's own scripts).
-   */
-  function syncFile(source, target) {
-    const absSource = resolve(source);
-
-    if (!existsSync(absSource)) {
-      console.warn(`  ⚠ Source not found: ${source}`);
-      return;
-    }
-
-    // Check existing target (lstat doesn't follow symlinks)
-    let isUpdate = false;
-    try {
-      const stat = lstatSync(target);
-      if (stat.isSymbolicLink()) {
-        if (resolve(readlinkSync(target)) === absSource) {
-          current++;
-          return;
-        }
-        unlinkSync(target);
-        isUpdate = true;
-      } else if (stat.isFile()) {
-        unlinkSync(target);
-        isUpdate = true;
-      } else {
-        return; // Directory or something unexpected — don't touch
-      }
-    } catch {
-      // Target doesn't exist — fresh install
-    }
-
-    if (useSymlinks) {
-      symlinkSync(absSource, target);
-    } else {
-      copyFileSync(absSource, target);
-      chmodSync(target, 0o755);
-    }
-
-    if (isUpdate) {
-      updated++;
-    } else {
-      created++;
-    }
-  }
-
-  // 1. TypeScript hooks: dist/hooks/*.mjs → ~/.claude/Hooks/*.mjs
-  // (worker-proxy.mjs and worker-pool-host.mjs are spawned from dist, not
-  // hooks — skip them)
-  const mjsFiles = readdirSync(HOOKS_OUT).filter(
-    (f) => f.endsWith(".mjs") && f !== "worker-proxy.mjs" && f !== "worker-pool-host.mjs"
-  );
-  for (const filename of mjsFiles) {
-    syncFile(join(HOOKS_OUT, filename), join(hooksTarget, filename));
-  }
-
-  // 2. Shell hooks: src/hooks/*.sh → ~/.claude/Hooks/pai-*.sh
-  const shellHooks = [
-    ["src/hooks/pre-compact.sh", "pai-pre-compact.sh"],
-    ["src/hooks/session-stop.sh", "pai-session-stop.sh"],
-    ["src/hooks/session-autosave.sh", "pai-session-autosave.sh"],
-    ["src/hooks/ztk-auto.sh", "ztk-auto.sh"],
-    ["src/hooks/ztk-passthrough.mjs", "ztk-passthrough.mjs"],
-  ];
-  for (const [src, destName] of shellHooks) {
-    if (existsSync(src)) {
-      syncFile(src, join(hooksTarget, destName));
-    }
-  }
-
-  // 3. Root scripts: statusline + tab-color → ~/.claude/
-  const rootScripts = ["statusline-command.sh", "tab-color-command.sh"];
-  for (const script of rootScripts) {
-    if (existsSync(script)) {
-      syncFile(script, join(claudeDir, script));
-    }
-  }
-
-  // 4. Standalone worker status-line: dist/worker-status-line.mjs → ~/.claude/
-  syncFile(join(HOOKS_OUT, "worker-status-line.mjs"), join(claudeDir, "worker-status-line.mjs"));
-
-  // 5. Content dirs with an adapter symlink: PAI_HOME/agents, PAI_HOME/commands
-  // → ~/.claude/agents, ~/.claude/commands. Only acts once `pai config migrate`
-  // has populated the PAI_HOME copy on this machine — a real (non-symlink)
-  // agents/commands dir is the operator's un-migrated authored content and is
-  // never touched here, same rule as syncFile() above.
-  function syncContentDirSymlink(paiHomeSubdir, targetDir) {
-    if (!existsSync(paiHomeSubdir)) return; // not migrated yet — nothing to link to
-
-    try {
-      const stat = lstatSync(targetDir);
-      if (stat.isSymbolicLink()) {
-        if (resolve(readlinkSync(targetDir)) === resolve(paiHomeSubdir)) {
-          current++;
-          return;
-        }
-        unlinkSync(targetDir);
-        symlinkSync(resolve(paiHomeSubdir), targetDir);
-        updated++;
-        return;
-      }
-      // Real directory — leave it alone (`pai config migrate` is what moves it).
-      return;
-    } catch {
-      // Target doesn't exist — fresh symlink.
-      symlinkSync(resolve(paiHomeSubdir), targetDir);
-      created++;
-    }
-  }
-
-  const paiHomeDir = resolvePaiHomeDir();
-  syncContentDirSymlink(join(paiHomeDir, "agents"), join(claudeDir, "agents"));
-  syncContentDirSymlink(join(paiHomeDir, "commands"), join(claudeDir, "commands"));
-
-  const parts = [];
-  if (created > 0) parts.push(`${created} created`);
-  if (updated > 0) parts.push(`${updated} updated`);
-  if (current > 0) parts.push(`${current} current`);
-  console.log(`✔ Hook symlinks synced: ${parts.join(", ")}`);
-}

package/scripts/build-skill-stubs.mjs

@@ -1,216 +0,0 @@
-#!/usr/bin/env node
-/**
- * Generate SKILL.md files from MCP prompt definitions.
- *
- * Sources (in order):
- *   1. src/daemon-mcp/prompts/*.ts       — PAI built-in prompts (tracked in git)
- *   2. src/daemon-mcp/prompts/custom/*.ts — User-created prompts (gitignored)
- *
- * Each prompt becomes a discoverable Claude Code skill at:
- *   dist/skills/<TitleCase>/SKILL.md
- *
- * Installation: `pai setup` or `pai skills sync` symlinks (macOS/Linux)
- * or copies (Windows) each skill directory into ~/.claude/skills/.
- *
- * With --sync: also creates/updates symlinks in ~/.claude/skills/ after
- * generating stubs. This is called automatically during `bun run build`.
- *
- * Source of truth: the TypeScript prompt files. Skills are regenerated on
- * every build — never edit the generated SKILL.md files by hand.
- */
-
-import {
-  readFileSync,
-  writeFileSync,
-  mkdirSync,
-  existsSync,
-  readdirSync,
-  symlinkSync,
-  lstatSync,
-  readlinkSync,
-  unlinkSync,
-} from "fs";
-import { join, resolve } from "path";
-import { homedir, platform } from "os";
-import { syncSkipReason } from "./lib/sync-guard.mjs";
-
-const PROMPTS_DIR = "src/daemon-mcp/prompts";
-const CUSTOM_DIR = join(PROMPTS_DIR, "custom");
-const STUBS_OUT = "dist/skills";
-const doSync = process.argv.includes("--sync");
-
-// kebab-case → TitleCase for Claude Code's skill scanner
-function toTitleCase(promptName) {
-  return promptName
-    .split("-")
-    .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
-    .join("");
-}
-
-// Extract description and full content from a prompt .ts file
-function parsePrompt(filePath) {
-  const src = readFileSync(filePath, "utf-8");
-
-  // Extract the description field
-  const descMatch = src.match(/description:\s*["'`]([^"'`]+)["'`]/);
-  if (!descMatch) return null;
-  const description = descMatch[1];
-
-  // Extract USE WHEN line
-  const useWhenMatch = src.match(/USE WHEN[^\n]+/);
-  const useWhen = useWhenMatch ? useWhenMatch[0] : "";
-
-  // Extract the full content template string
-  // Match content: `...` handling escaped backticks (\`) inside
-  const contentMatch = src.match(/content:\s*`((?:[^`\\]|\\[\s\S])*)`/);
-  if (!contentMatch) return null;
-  // Unescape template literal escapes
-  const content = contentMatch[1]
-    .replace(/\\`/g, "`")
-    .replace(/\\\$/g, "$")
-    .replace(/\\'/g, "'")
-    .replace(/\\n/g, "\n");
-
-  return { description, useWhen, content };
-}
-
-// Read export list from index.ts to get built-in prompt file names
-function getBuiltinPromptNames() {
-  const indexSrc = readFileSync(join(PROMPTS_DIR, "index.ts"), "utf-8");
-  const names = [];
-  for (const match of indexSrc.matchAll(
-    /export\s+\{[^}]+\}\s+from\s+["']\.\/([^"']+)\.js["']/g
-  )) {
-    names.push(match[1]);
-  }
-  return names;
-}
-
-// Scan custom/ directory for user-created prompt files
-function getCustomPromptNames() {
-  if (!existsSync(CUSTOM_DIR)) return [];
-  return readdirSync(CUSTOM_DIR)
-    .filter((f) => f.endsWith(".ts") && f !== "index.ts")
-    .map((f) => f.replace(/\.ts$/, ""));
-}
-
-// Sync symlinks: create/update symlinks in ~/.claude/skills/
-function syncSymlinks(generatedNames) {
-  const skillsDir = join(homedir(), ".claude", "skills");
-  mkdirSync(skillsDir, { recursive: true });
-
-  const useSymlinks = platform() !== "win32";
-  let created = 0;
-  let updated = 0;
-  let current = 0;
-
-  for (const name of generatedNames) {
-    const source = resolve(join(STUBS_OUT, name));
-    const target = join(skillsDir, name);
-
-    // lstat once: dangling links must count as symlinks (existsSync misses them)
-    let entry;
-    try {
-      entry = lstatSync(target);
-    } catch {
-      // absent — fresh install
-    }
-
-    // Never overwrite non-symlink directories (user's own skills)
-    if (entry && !entry.isSymbolicLink()) {
-      continue;
-    }
-
-    // Check existing symlink (may be dangling)
-    if (entry) {
-      if (resolve(readlinkSync(target)) === source) {
-        current++;
-        continue;
-      }
-      unlinkSync(target);
-      updated++;
-    }
-
-    if (useSymlinks) {
-      symlinkSync(source, target);
-    } else {
-      mkdirSync(target, { recursive: true });
-      writeFileSync(
-        join(target, "SKILL.md"),
-        readFileSync(join(source, "SKILL.md")),
-      );
-    }
-    created++;
-  }
-
-  // Clean up stale symlinks from old user/ location
-  const oldUserDir = join(skillsDir, "user");
-  if (existsSync(oldUserDir)) {
-    for (const name of generatedNames) {
-      const oldTarget = join(oldUserDir, name);
-      if (existsSync(oldTarget) && lstatSync(oldTarget).isSymbolicLink()) {
-        unlinkSync(oldTarget);
-      }
-    }
-  }
-
-  const parts = [];
-  if (created > 0) parts.push(`${created} created`);
-  if (updated > 0) parts.push(`${updated} updated`);
-  if (current > 0) parts.push(`${current} current`);
-  console.log(`✔ Skill symlinks synced: ${parts.join(", ")}`);
-}
-
-// --- Main ---
-
-const builtinNames = getBuiltinPromptNames();
-const customNames = getCustomPromptNames();
-let generated = 0;
-const generatedDirNames = [];
-
-mkdirSync(STUBS_OUT, { recursive: true });
-
-// Process all prompts (built-in + custom)
-for (const [fileName, dir] of [
-  ...builtinNames.map((n) => [n, PROMPTS_DIR]),
-  ...customNames.map((n) => [n, CUSTOM_DIR]),
-]) {
-  const filePath = join(dir, `${fileName}.ts`);
-  const parsed = parsePrompt(filePath);
-  if (!parsed) {
-    console.warn(`⚠ Skipping ${fileName}: could not parse`);
-    continue;
-  }
-
-  const dirName = toTitleCase(fileName);
-  const outDir = join(STUBS_OUT, dirName);
-  const outFile = join(outDir, "SKILL.md");
-
-  mkdirSync(outDir, { recursive: true });
-
-  const skill = [
-    "---",
-    `name: ${dirName}`,
-    `description: "${parsed.description}. ${parsed.useWhen}"`,
-    "---",
-    "",
-    parsed.content.trim(),
-    "",
-  ].join("\n");
-
-  writeFileSync(outFile, skill);
-  generatedDirNames.push(dirName);
-  generated++;
-}
-
-const customLabel = customNames.length > 0 ? ` (${builtinNames.length} built-in + ${customNames.length} custom)` : "";
-console.log(`✔ ${generated} skill stubs generated in ${STUBS_OUT}/${customLabel}`);
-
-const skipReason = doSync ? syncSkipReason() : null;
-if (skipReason) {
-  // Only the canonical install repoints the live ~/.claude/skills symlinks —
-  // see scripts/lib/sync-guard.mjs.
-  console.log(skipReason.startsWith("skipping") ? skipReason : `✔ Skill symlinks skipped: ${skipReason}`);
-} else if (doSync) {
-  syncSymlinks(generatedDirNames);
-}

package/scripts/copy-defaults.mjs

@@ -1,46 +0,0 @@
-#!/usr/bin/env node
-/**
- * copy-defaults.mjs — ship the defaults files into dist.
- *
- * src/config/defaults/config.yaml and workers.yaml are the shipped policy
- * values (thresholds, limits, intervals, lists, mappings) that
- * src/config/shipped-defaults.ts loads first and deep-merges UNDER the user's
- * ~/.pai/config.yaml and workers.yaml. tsdown bundles code only, so this step
- * copies the YAML files to dist/config/defaults/ — the same directory the
- * bundled loader module resolves them from (dirname(import.meta.url)).
- */
-
-import { copyFileSync, mkdirSync, existsSync, readFileSync } from "node:fs";
-import { join, resolve } from "node:path";
-
-const SRC_DIR = resolve("src/config/defaults");
-const DIST_DIR = resolve(process.argv[2] ?? "dist", "config/defaults");
-const FILES = ["config.yaml", "workers.yaml"];
-
-mkdirSync(DIST_DIR, { recursive: true });
-for (const name of FILES) {
-  const src = join(SRC_DIR, name);
-  if (!existsSync(src)) {
-    console.error(`copy-defaults: ${src} is missing — the shipped defaults must ship with the build`);
-    process.exit(1);
-  }
-  // sanity: the file must parse as a YAML mapping (cheap check, no yaml dep here)
-  const text = readFileSync(src, "utf8");
-  if (!text.trim().length) {
-    console.error(`copy-defaults: ${src} is empty`);
-    process.exit(1);
-  }
-  copyFileSync(src, join(DIST_DIR, name));
-  console.log(`copy-defaults: ${src} → ${join(DIST_DIR, name)}`);
-}
-
-// the saved cockpit layout is optional: it exists once `pai cockpit layout export` has written it
-const LAYOUT = join(SRC_DIR, "cockpit-layout.json");
-if (existsSync(LAYOUT)) {
-  copyFileSync(LAYOUT, join(DIST_DIR, "cockpit-layout.json"));
-  console.log(`copy-defaults: ${LAYOUT} → ${join(DIST_DIR, "cockpit-layout.json")}`);
-}
-
-// esbuild bundles (tests, hooks) emit into directories next to where the
-// loader module sits; a bundle's shippedDefaultsDir() falls back to
-// <cwd>/src/config/defaults, which is SRC_DIR itself — nothing extra needed.