@aipper/aiws 0.0.28 → 0.0.30

package/src/commands/codex-install-prompts.js

@@ -1,68 +0,0 @@
-import path from "node:path";
-import { loadTemplate } from "../spec.js";
-import { UserError } from "../errors.js";
-import { copyFile, ensureDir, pathExists, readText, writeText } from "../fs.js";
-import { normalizeNewlines } from "../hash.js";
-import { findManagedBlock, upsertManagedBlock } from "../managed-blocks.js";
-import { codexBackupPathFor, codexBackupStamp, listTemplateCodexPrompts, resolveCodexPromptsDir } from "../codex-prompts.js";
-
-/**
- * @param {{ templateId: string, promptsDir?: string, force?: boolean, dryRun?: boolean }} options
- */
-export async function codexInstallPromptsCommand(options) {
-  const templateId = String(options.templateId || "workspace");
-  const tpl = await loadTemplate(templateId);
-
-  const promptsDir = resolveCodexPromptsDir(options.promptsDir);
-  const dryRun = options.dryRun === true;
-  if (!dryRun) await ensureDir(promptsDir);
-
-  const promptFiles = await listTemplateCodexPrompts(tpl);
-
-  /** @type {string[]} */
-  const created = [];
-  /** @type {string[]} */
-  const updated = [];
-  /** @type {string[]} */
-  const overwritten = [];
-  let backupStamp = "";
-
-  for (const pf of promptFiles) {
-    const { filename, blockId, templateText, innerText } = pf;
-    const destAbs = path.join(promptsDir, filename);
-    if (!(await pathExists(destAbs))) {
-      if (!dryRun) await writeText(destAbs, templateText);
-      created.push(filename);
-      continue;
-    }
-
-    const currentText = normalizeNewlines(await readText(destAbs));
-    const existingBlock = findManagedBlock(currentText, blockId);
-    if (!existingBlock) {
-      if (!options.force) {
-        throw new UserError("Codex prompt file exists and is not AIWS-managed; refusing to overwrite.", {
-          details: `File: ${destAbs}\nHint: re-run with --force to overwrite (a backup will be created).`,
-        });
-      }
-      if (!backupStamp) backupStamp = codexBackupStamp();
-      const backup = codexBackupPathFor(promptsDir, filename, backupStamp);
-      if (!dryRun) {
-        await copyFile(destAbs, backup);
-        await writeText(destAbs, templateText);
-      }
-      overwritten.push(filename);
-      continue;
-    }
-
-    const res = upsertManagedBlock(currentText, blockId, innerText, { insertIfMissing: false });
-    if (res.changed) {
-      if (!dryRun) await writeText(destAbs, res.nextText);
-      updated.push(filename);
-    }
-  }
-
-  console.log(`${dryRun ? "✓ (dry-run)" : "✓"} aiws codex install-prompts: ${promptsDir}`);
-  if (created.length > 0) console.log(`created: ${created.join(", ")}`);
-  if (updated.length > 0) console.log(`updated: ${updated.join(", ")}`);
-  if (overwritten.length > 0) console.log(`overwritten: ${overwritten.join(", ")}`);
-}

package/src/commands/codex-install-skills.js

@@ -1,74 +0,0 @@
-import fs from "node:fs/promises";
-import path from "node:path";
-import { loadTemplate } from "../spec.js";
-import { UserError } from "../errors.js";
-import { copyFile, ensureDir, pathExists, readText, writeText } from "../fs.js";
-import { normalizeNewlines } from "../hash.js";
-import { findManagedBlock, upsertManagedBlock } from "../managed-blocks.js";
-import { codexSkillsBackupPathFor, codexSkillsBackupStamp, listTemplateCodexSkills, resolveCodexSkillsDir } from "../codex-skills.js";
-
-/**
- * @param {{ templateId: string, skillsDir?: string, force?: boolean, dryRun?: boolean }} options
- */
-export async function codexInstallSkillsCommand(options) {
-  const templateId = String(options.templateId || "workspace");
-  const tpl = await loadTemplate(templateId);
-
-  const skillsDir = resolveCodexSkillsDir(options.skillsDir);
-  const dryRun = options.dryRun === true;
-  if (!dryRun) await ensureDir(skillsDir);
-  const skillsDirIsSymlink = await fs
-    .lstat(skillsDir)
-    .then((st) => st.isSymbolicLink())
-    .catch(() => false);
-  const skillsDirReal = skillsDirIsSymlink ? await fs.realpath(skillsDir).catch(() => skillsDir) : skillsDir;
-
-  const skillFiles = await listTemplateCodexSkills(tpl);
-
-  /** @type {string[]} */
-  const created = [];
-  /** @type {string[]} */
-  const updated = [];
-  /** @type {string[]} */
-  const overwritten = [];
-  let backupStamp = "";
-
-  for (const sf of skillFiles) {
-    const destAbs = path.join(skillsDir, sf.skillName, "SKILL.md");
-    if (!(await pathExists(destAbs))) {
-      if (!dryRun) await writeText(destAbs, sf.managedText);
-      created.push(sf.skillName);
-      continue;
-    }
-
-    const currentText = normalizeNewlines(await readText(destAbs));
-    const existingBlock = findManagedBlock(currentText, sf.blockId);
-    if (!existingBlock) {
-      if (!options.force) {
-        throw new UserError("Codex skill exists and is not AIWS-managed; refusing to overwrite.", {
-          details: `File: ${destAbs}\nHint: re-run with --force to overwrite (a backup will be created).`,
-        });
-      }
-      if (!backupStamp) backupStamp = codexSkillsBackupStamp();
-      const backup = codexSkillsBackupPathFor(skillsDir, sf.skillName, backupStamp);
-      if (!dryRun) {
-        await copyFile(destAbs, backup);
-        await writeText(destAbs, sf.managedText);
-      }
-      overwritten.push(sf.skillName);
-      continue;
-    }
-
-    const res = upsertManagedBlock(currentText, sf.blockId, sf.innerText, { insertIfMissing: false });
-    if (res.changed) {
-      if (!dryRun) await writeText(destAbs, res.nextText);
-      updated.push(sf.skillName);
-    }
-  }
-
-  const header = skillsDirIsSymlink && skillsDirReal !== skillsDir ? `${skillsDir} -> ${skillsDirReal}` : skillsDir;
-  console.log(`${dryRun ? "✓ (dry-run)" : "✓"} aiws codex install-skills: ${header}`);
-  if (created.length > 0) console.log(`created: ${created.join(", ")}`);
-  if (updated.length > 0) console.log(`updated: ${updated.join(", ")}`);
-  if (overwritten.length > 0) console.log(`overwritten: ${overwritten.join(", ")}`);
-}

package/src/commands/codex-status-prompts.js

@@ -1,55 +0,0 @@
-import path from "node:path";
-import { loadTemplate } from "../spec.js";
-import { normalizeNewlines } from "../hash.js";
-import { findManagedBlock } from "../managed-blocks.js";
-import { pathExists, readText } from "../fs.js";
-import { listTemplateCodexPrompts, resolveCodexPromptsDir } from "../codex-prompts.js";
-
-/**
- * @param {{ templateId: string, promptsDir?: string }} options
- */
-export async function codexStatusPromptsCommand(options) {
-  const templateId = String(options.templateId || "workspace");
-  const tpl = await loadTemplate(templateId);
-
-  const promptsDir = resolveCodexPromptsDir(options.promptsDir);
-  const promptFiles = await listTemplateCodexPrompts(tpl);
-
-  /** @type {Array<{ filename: string, status: "ok" | "missing" | "unmanaged" | "outdated" }>} */
-  const rows = [];
-
-  for (const pf of promptFiles) {
-    const destAbs = path.join(promptsDir, pf.filename);
-    if (!(await pathExists(destAbs))) {
-      rows.push({ filename: pf.filename, status: "missing" });
-      continue;
-    }
-
-    const currentText = normalizeNewlines(await readText(destAbs));
-    const block = findManagedBlock(currentText, pf.blockId);
-    if (!block) {
-      rows.push({ filename: pf.filename, status: "unmanaged" });
-      continue;
-    }
-
-    rows.push({ filename: pf.filename, status: block.innerText === pf.innerText ? "ok" : "outdated" });
-  }
-
-  const counts = rows.reduce(
-    (acc, r) => {
-      acc[r.status]++;
-      return acc;
-    },
-    /** @type {{ ok: number, missing: number, unmanaged: number, outdated: number }} */ ({ ok: 0, missing: 0, unmanaged: 0, outdated: 0 }),
-  );
-
-  console.log(`✓ aiws codex status: ${promptsDir}`);
-  console.log(`ok=${counts.ok} missing=${counts.missing} unmanaged=${counts.unmanaged} outdated=${counts.outdated}`);
-  for (const r of rows) {
-    console.log(`${r.status}\t${r.filename}`);
-  }
-  if (counts.missing > 0 || counts.outdated > 0) {
-    console.log("Next: aiws codex install-prompts");
-  }
-}
-

package/src/commands/codex-status-skills.js

@@ -1,63 +0,0 @@
-import fs from "node:fs/promises";
-import path from "node:path";
-import { loadTemplate } from "../spec.js";
-import { normalizeNewlines } from "../hash.js";
-import { findManagedBlock } from "../managed-blocks.js";
-import { pathExists, readText } from "../fs.js";
-import { listTemplateCodexSkills, resolveCodexSkillsDir } from "../codex-skills.js";
-
-/**
- * @param {{ templateId: string, skillsDir?: string }} options
- */
-export async function codexStatusSkillsCommand(options) {
-  const templateId = String(options.templateId || "workspace");
-  const tpl = await loadTemplate(templateId);
-
-  const skillsDir = resolveCodexSkillsDir(options.skillsDir);
-  const skillsDirIsSymlink = await fs
-    .lstat(skillsDir)
-    .then((st) => st.isSymbolicLink())
-    .catch(() => false);
-  const skillsDirReal = skillsDirIsSymlink ? await fs.realpath(skillsDir).catch(() => skillsDir) : skillsDir;
-  const skillFiles = await listTemplateCodexSkills(tpl);
-
-  /** @type {Array<{ name: string, status: "ok" | "missing" | "unmanaged" | "outdated" }>} */
-  const rows = [];
-
-  for (const sf of skillFiles) {
-    const destAbs = path.join(skillsDir, sf.skillName, "SKILL.md");
-    if (!(await pathExists(destAbs))) {
-      rows.push({ name: sf.skillName, status: "missing" });
-      continue;
-    }
-
-    const currentText = normalizeNewlines(await readText(destAbs));
-    const block = findManagedBlock(currentText, sf.blockId);
-    if (!block) {
-      rows.push({ name: sf.skillName, status: "unmanaged" });
-      continue;
-    }
-    rows.push({ name: sf.skillName, status: block.innerText === sf.innerText ? "ok" : "outdated" });
-  }
-
-  const counts = rows.reduce(
-    (acc, r) => {
-      acc[r.status]++;
-      return acc;
-    },
-    /** @type {{ ok: number, missing: number, unmanaged: number, outdated: number }} */ ({ ok: 0, missing: 0, unmanaged: 0, outdated: 0 }),
-  );
-
-  const header = skillsDirIsSymlink && skillsDirReal !== skillsDir ? `${skillsDir} -> ${skillsDirReal}` : skillsDir;
-  console.log(`✓ aiws codex status-skills: ${header}`);
-  console.log(`ok=${counts.ok} missing=${counts.missing} unmanaged=${counts.unmanaged} outdated=${counts.outdated}`);
-  for (const r of rows) {
-    console.log(`${r.status}\t${r.name}`);
-  }
-  if (counts.ok === 0 && counts.missing === rows.length && skillsDirIsSymlink) {
-    console.log("Note: skills dir is a symlink; if you installed to a different dir, pass --dir (or set CODEX_HOME).");
-  }
-  if (counts.missing > 0 || counts.outdated > 0) {
-    console.log("Next: aiws codex install-skills");
-  }
-}

package/src/commands/codex-uninstall-prompts.js

@@ -1,55 +0,0 @@
-import path from "node:path";
-import fs from "node:fs/promises";
-import { loadTemplate } from "../spec.js";
-import { normalizeNewlines } from "../hash.js";
-import { findManagedBlock } from "../managed-blocks.js";
-import { copyFile, pathExists, readText } from "../fs.js";
-import { codexBackupPathFor, codexBackupStamp, listTemplateCodexPrompts, resolveCodexPromptsDir } from "../codex-prompts.js";
-
-/**
- * @param {{ templateId: string, promptsDir?: string }} options
- */
-export async function codexUninstallPromptsCommand(options) {
-  const templateId = String(options.templateId || "workspace");
-  const tpl = await loadTemplate(templateId);
-
-  const promptsDir = resolveCodexPromptsDir(options.promptsDir);
-  const promptFiles = await listTemplateCodexPrompts(tpl);
-
-  const backupStamp = codexBackupStamp();
-  const backupDir = path.join(promptsDir, ".aiws", "backups", "codex-prompts", backupStamp);
-
-  /** @type {string[]} */
-  const removed = [];
-  /** @type {string[]} */
-  const skippedUnmanaged = [];
-  /** @type {string[]} */
-  const missing = [];
-
-  for (const pf of promptFiles) {
-    const destAbs = path.join(promptsDir, pf.filename);
-    if (!(await pathExists(destAbs))) {
-      missing.push(pf.filename);
-      continue;
-    }
-
-    const currentText = normalizeNewlines(await readText(destAbs));
-    const block = findManagedBlock(currentText, pf.blockId);
-    if (!block) {
-      skippedUnmanaged.push(pf.filename);
-      continue;
-    }
-
-    const backup = codexBackupPathFor(promptsDir, pf.filename, backupStamp);
-    await copyFile(destAbs, backup);
-    await fs.unlink(destAbs);
-    removed.push(pf.filename);
-  }
-
-  console.log(`✓ aiws codex uninstall-prompts: ${promptsDir}`);
-  if (removed.length > 0) console.log(`removed: ${removed.join(", ")}`);
-  if (removed.length > 0) console.log(`backup: ${backupDir}`);
-  if (skippedUnmanaged.length > 0) console.log(`skipped (unmanaged): ${skippedUnmanaged.join(", ")}`);
-  if (missing.length > 0) console.log(`missing: ${missing.join(", ")}`);
-}
-

package/src/commands/codex-uninstall-skills.js

@@ -1,62 +0,0 @@
-import path from "node:path";
-import fs from "node:fs/promises";
-import { loadTemplate } from "../spec.js";
-import { normalizeNewlines } from "../hash.js";
-import { findManagedBlock } from "../managed-blocks.js";
-import { copyFile, pathExists, readText } from "../fs.js";
-import { codexSkillsBackupPathFor, codexSkillsBackupStamp, listTemplateCodexSkills, resolveCodexSkillsDir } from "../codex-skills.js";
-
-/**
- * @param {{ templateId: string, skillsDir?: string }} options
- */
-export async function codexUninstallSkillsCommand(options) {
-  const templateId = String(options.templateId || "workspace");
-  const tpl = await loadTemplate(templateId);
-
-  const skillsDir = resolveCodexSkillsDir(options.skillsDir);
-  const skillFiles = await listTemplateCodexSkills(tpl);
-
-  const backupStamp = codexSkillsBackupStamp();
-  const backupDir = path.join(skillsDir, ".aiws", "backups", "codex-skills", backupStamp);
-
-  /** @type {string[]} */
-  const removed = [];
-  /** @type {string[]} */
-  const skippedUnmanaged = [];
-  /** @type {string[]} */
-  const missing = [];
-
-  for (const sf of skillFiles) {
-    const destDir = path.join(skillsDir, sf.skillName);
-    const destAbs = path.join(destDir, "SKILL.md");
-    if (!(await pathExists(destAbs))) {
-      missing.push(sf.skillName);
-      continue;
-    }
-
-    const currentText = normalizeNewlines(await readText(destAbs));
-    const block = findManagedBlock(currentText, sf.blockId);
-    if (!block) {
-      skippedUnmanaged.push(sf.skillName);
-      continue;
-    }
-
-    const backup = codexSkillsBackupPathFor(skillsDir, sf.skillName, backupStamp);
-    await copyFile(destAbs, backup);
-    await fs.unlink(destAbs);
-    // Only remove the directory if it's empty after removing SKILL.md.
-    try {
-      await fs.rmdir(destDir);
-    } catch {
-      // ignore
-    }
-    removed.push(sf.skillName);
-  }
-
-  console.log(`✓ aiws codex uninstall-skills: ${skillsDir}`);
-  if (removed.length > 0) console.log(`removed: ${removed.join(", ")}`);
-  if (removed.length > 0) console.log(`backup: ${backupDir}`);
-  if (skippedUnmanaged.length > 0) console.log(`skipped (unmanaged): ${skippedUnmanaged.join(", ")}`);
-  if (missing.length > 0) console.log(`missing: ${missing.join(", ")}`);
-}
-

package/src/commands/dashboard.js

@@ -1,205 +0,0 @@
-import fs from "node:fs/promises";
-import http from "node:http";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-import { UserError } from "../errors.js";
-import { runCommand } from "../exec.js";
-import { pathExists } from "../fs.js";
-import { loadWorkflowStageContracts as loadWorkflowStageContractsSpec } from "../spec.js";
-import { computeChangeNextAdvice, computeChangeStatus, validateChangeArtifacts } from "./change.js";
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-
-function send(res, status, headers, body) {
-  res.writeHead(status, headers);
-  res.end(body);
-}
-
-function sendJson(res, status, obj) {
-  send(res, status, { "content-type": "application/json; charset=utf-8" }, JSON.stringify(obj, null, 2));
-}
-
-function guessContentType(p) {
-  const ext = path.extname(p).toLowerCase();
-  if (ext === ".html") return "text/html; charset=utf-8";
-  if (ext === ".css") return "text/css; charset=utf-8";
-  if (ext === ".js") return "text/javascript; charset=utf-8";
-  if (ext === ".json") return "application/json; charset=utf-8";
-  return "application/octet-stream";
-}
-
-function safeJoin(baseDir, rel) {
-  const abs = path.resolve(baseDir, rel);
-  const baseAbs = path.resolve(baseDir);
-  if (!abs.startsWith(baseAbs + path.sep) && abs !== baseAbs) {
-    throw new UserError("Invalid path.", { exitCode: 1 });
-  }
-  return abs;
-}
-
-/**
- * @param {string} absPath
- */
-async function resolveGitRoot(absPath) {
-  let res;
-  try {
-    res = await runCommand("git", ["rev-parse", "--show-toplevel"], { cwd: absPath });
-  } catch (e) {
-    throw new UserError("git is required for aiws dashboard commands.", { details: e instanceof Error ? e.message : String(e) });
-  }
-  if (res.code !== 0) {
-    throw new UserError("Not a git repository.", { details: res.stderr || res.stdout });
-  }
-  const root = String(res.stdout || "").trim();
-  if (!root) throw new UserError("Failed to resolve git repository root.");
-  return root;
-}
-
-/**
- * @param {string} gitRoot
- */
-async function ensureTruthFiles(gitRoot) {
-  const required = ["AI_PROJECT.md", "AI_WORKSPACE.md", "REQUIREMENTS.md"];
-  const missing = [];
-  for (const f of required) {
-    if (!(await pathExists(path.join(gitRoot, f)))) missing.push(f);
-  }
-  if (missing.length > 0) {
-    throw new UserError("AI Workspace truth files missing.", {
-      details: `Root: ${gitRoot}\nMissing:\n${missing.map((m) => `- ${m}`).join("\n")}\n\nHint: run \`aiws init .\` (new) or \`aiws update .\` (migrate).`,
-      exitCode: 1,
-    });
-  }
-}
-
-async function listChangeIds(gitRoot) {
-  const dir = path.join(gitRoot, "changes");
-  try {
-    const entries = await fs.readdir(dir, { withFileTypes: true });
-    return entries.filter((e) => e.isDirectory()).map((e) => e.name).sort();
-  } catch {
-    return [];
-  }
-}
-
-export async function loadWorkflowStageContracts() {
-  return loadWorkflowStageContractsSpec();
-}
-
-/**
- * @param {string} gitRoot
- */
-export async function collectDashboardChanges(gitRoot) {
-  const ids = await listChangeIds(gitRoot);
-  const changes = [];
-  for (const id of ids) {
-    try {
-      const st = await computeChangeStatus(gitRoot, id);
-      const nextAdvice = await computeChangeNextAdvice(gitRoot, id);
-      changes.push({
-        ...st,
-        collaboration: st.collaboration?.counts || null,
-        nextAdvice,
-        governance: st.governance || null,
-      });
-    } catch (e) {
-      changes.push({ changeId: id, ok: false, error: e instanceof Error ? e.message : String(e) });
-    }
-  }
-  return changes;
-}
-
-function parseUrl(reqUrl) {
-  const u = new URL(reqUrl || "/", "http://127.0.0.1");
-  return { pathname: u.pathname, searchParams: u.searchParams };
-}
-
-export async function dashboardServeCommand(options) {
-  const gitRoot = await resolveGitRoot(process.cwd());
-  await ensureTruthFiles(gitRoot);
-
-  const host = String(options.host || "127.0.0.1").trim() || "127.0.0.1";
-  const port = Number.isFinite(options.port) ? options.port : Number.parseInt(String(options.port || "3456"), 10);
-  if (!Number.isFinite(port) || port < 0 || port > 65535) {
-    throw new UserError(`Invalid --port: ${options.port}`, { exitCode: 1 });
-  }
-
-  const dashboardDir = path.join(__dirname, "..", "dashboard");
-  const assetsDir = path.join(dashboardDir);
-
-  const server = http.createServer(async (req, res) => {
-    try {
-      const { pathname, searchParams } = parseUrl(req.url || "/");
-      if ((req.method || "GET") !== "GET") {
-        sendJson(res, 405, { ok: false, error: "method not allowed" });
-        return;
-      }
-
-      if (pathname === "/api/changes") {
-        const changes = await collectDashboardChanges(gitRoot);
-        sendJson(res, 200, { ok: true, changes });
-        return;
-      }
-
-      if (pathname === "/api/workflow-stages") {
-        const stages = await loadWorkflowStageContracts();
-        sendJson(res, 200, stages);
-        return;
-      }
-
-      const m = pathname.match(/^\/api\/change\/([^/]+)\/validate$/);
-      if (m) {
-        const changeId = decodeURIComponent(m[1] || "");
-        const strict = searchParams.get("strict") === "1" || searchParams.get("strict") === "true";
-        const allowTruthDrift = searchParams.get("allow_truth_drift") === "1" || searchParams.get("allow_truth_drift") === "true";
-        const checkScope = searchParams.get("check_scope") === "1" || searchParams.get("check_scope") === "true";
-        const result = await validateChangeArtifacts(gitRoot, changeId, { strict, allowTruthDrift, checkScope });
-        sendJson(res, 200, result);
-        return;
-      }
-
-      if (pathname === "/" || pathname === "/index.html") {
-        const p = path.join(dashboardDir, "index.html");
-        const text = await fs.readFile(p);
-        send(res, 200, { "content-type": "text/html; charset=utf-8" }, text);
-        return;
-      }
-
-      if (pathname.startsWith("/assets/")) {
-        const rel = pathname.replace(/^\/assets\//, "");
-        const p = safeJoin(assetsDir, rel);
-        const buf = await fs.readFile(p);
-        send(res, 200, { "content-type": guessContentType(p) }, buf);
-        return;
-      }
-
-      sendJson(res, 404, { ok: false, error: "not found" });
-    } catch (e) {
-      sendJson(res, 500, { ok: false, error: e instanceof Error ? e.message : String(e) });
-    }
-  });
-
-  await new Promise((resolve, reject) => {
-    server.once("error", reject);
-    server.listen({ host, port }, () => resolve());
-  });
-
-  const addr = server.address();
-  const realPort = addr && typeof addr === "object" ? addr.port : port;
-  console.log(`✓ aiws dashboard serve`);
-  console.log(`root: ${gitRoot}`);
-  console.log(`url: http://${host}:${realPort}/`);
-  console.log("note: press Ctrl+C to stop");
-
-  await new Promise((resolve) => {
-    let stopping = false;
-    const stop = () => {
-      if (stopping) return;
-      stopping = true;
-      server.close(() => resolve());
-    };
-    process.once("SIGINT", stop);
-    process.once("SIGTERM", stop);
-  });
-}

package/src/commands/hooks-install.js

@@ -1,92 +0,0 @@
-import path from "node:path";
-import fs from "node:fs/promises";
-import { resolveWorkspaceRoot } from "../workspace.js";
-import { runCommand } from "../exec.js";
-import { pathExists, readText } from "../fs.js";
-import { UserError } from "../errors.js";
-import { loadTemplate } from "../spec.js";
-import { copyTemplateFileToWorkspace } from "../template.js";
-
-/**
- * @param {string} absPath
- */
-async function resolveGitRoot(absPath) {
-  let res;
-  try {
-    res = await runCommand("git", ["rev-parse", "--show-toplevel"], { cwd: absPath });
-  } catch (e) {
-    throw new UserError("git is required for hooks commands.", { details: e instanceof Error ? e.message : String(e) });
-  }
-  if (res.code !== 0) {
-    throw new UserError("Not a git repository.", { details: res.stderr || res.stdout });
-  }
-  const root = String(res.stdout || "").trim();
-  if (!root) throw new UserError("Failed to resolve git repository root.");
-  return root;
-}
-
-/**
- * @param {fs.Stats} st
- */
-function isExecutable(st) {
-  return (st.mode & 0o111) !== 0;
-}
-
-/**
- * Resolve template id for a repo:
- * - Prefer `.aiws/manifest.json` if present.
- * - Else default to `workspace`.
- *
- * @param {string} gitRoot
- */
-async function resolveTemplateIdForRepo(gitRoot) {
-  const manifestPath = path.join(gitRoot, ".aiws", "manifest.json");
-  if (!(await pathExists(manifestPath))) return "workspace";
-  try {
-    const stored = JSON.parse(await readText(manifestPath));
-    const templateId = String(stored.template_id || "").trim();
-    return templateId || "workspace";
-  } catch {
-    return "workspace";
-  }
-}
-
-/**
- * @param {{ targetPath: string }} options
- */
-export async function hooksInstallCommand(options) {
-  const workspaceRoot = await resolveWorkspaceRoot(options.targetPath, { create: false });
-  const gitRoot = await resolveGitRoot(workspaceRoot);
-
-  const templateId = await resolveTemplateIdForRepo(gitRoot);
-  const tpl = await loadTemplate(templateId);
-
-  const hookFiles = [".githooks/commit-msg", ".githooks/pre-commit", ".githooks/pre-push"];
-  /** @type {string[]} */
-  const created = [];
-  /** @type {string[]} */
-  const chmodded = [];
-
-  for (const rel of hookFiles) {
-    const abs = path.join(gitRoot, ...rel.split("/"));
-    if (!(await pathExists(abs))) {
-      await copyTemplateFileToWorkspace({ templateDir: tpl.templateDir, workspaceRoot: gitRoot, relPosix: rel, chmod: 0o755 });
-      created.push(rel);
-      continue;
-    }
-    const st = await fs.stat(abs);
-    if (!isExecutable(st)) {
-      await fs.chmod(abs, 0o755);
-      chmodded.push(rel);
-    }
-  }
-
-  const setRes = await runCommand("git", ["config", "core.hooksPath", ".githooks"], { cwd: gitRoot });
-  if (setRes.code !== 0) {
-    throw new UserError("Failed to set git core.hooksPath.", { details: setRes.stderr || setRes.stdout });
-  }
-
-  console.log(`✓ aiws hooks install: ${gitRoot}`);
-  if (created.length > 0) console.log(`created: ${created.join(", ")}`);
-  if (chmodded.length > 0) console.log(`chmod: ${chmodded.join(", ")}`);
-}