@anhlp/alp 0.0.1-beta.4 → 0.0.1-beta.6

package/packages/cli/dist/tasks.js

@@ -1,345 +0,0 @@
-// packages/cli/src/tasks.js
-import { spawn } from "node:child_process";
-import { access, readFile, writeFile } from "node:fs/promises";
-import path from "node:path";
-import { parseArgs } from "node:util";
-import { exportBeads, importBeads, parseJsonl } from "@anhlp/alp-core/beads";
-import { findFormula, formulaDirs, listFormulas, pourFormula } from "@anhlp/alp-core/formulas";
-import { describeVerification } from "@anhlp/alp-core/verify";
-import { ago } from "@anhlp/alp-client/render";
-import { parse as toml } from "smol-toml";
-import { addGate, blockersOf, checkGates, childrenOf, closeTask, compactTasks, createTask, describeGate, gateOpen, epicReport, gatesOf, linkTask, listTasks, loadTasks, readyTasks, reopenTask, resolveGate, summarize, TASKS_DIR, updateTask } from "@anhlp/alp-core/tasks";
-import { alpHome } from "@anhlp/alp-client/index";
-import { UsageError } from "./usage.js";
-var STATUS_MARK = { open: "\u25CB", in_progress: "\u25D0", review: "\u25D1", closed: "\u25CF" };
-async function taskProject(directory) {
-  const root = path.resolve(directory ?? process.cwd());
-  try {
-    await access(path.join(root, ".alp"));
-  } catch {
-    throw new Error(`${root} is not an ALP project (no .alp directory); run alp init, or pass --project`);
-  }
-  return root;
-}
-function taskRow(task, tasks) {
-  const row = summarize(task, tasks);
-  const extra = [
-    row.blockedBy ? `blocked by ${row.blockedBy.join(", ")}` : "",
-    row.gates ? `waits on ${row.gates.join("; ")}` : "",
-    row.assignee ? `@${row.assignee}` : "",
-    row.labels ? row.labels.map((label) => `#${label}`).join(" ") : ""
-  ].filter(Boolean).join("  ");
-  return `${STATUS_MARK[task.status]} ${task.id.padEnd(10)} P${task.priority} ${task.type.padEnd(7)} ${task.status.padEnd(11)} ${task.title}${extra ? `  ${extra}` : ""}`;
-}
-function warnUnreadable(errors) {
-  for (const { file, error } of errors) console.error(`alp: skipped ${file}: ${error}`);
-}
-async function tasksCommand(args) {
-  if (args[0] === "gates" || args[0] === "compact") return taskMaintenance([args[0]], args.slice(1));
-  if (args[0] === "export" || args[0] === "import") return beads(args[0], args.slice(1));
-  const { values, positionals } = parseArgs({ args, allowPositionals: true, options: {
-    all: { type: "boolean" },
-    status: { type: "string" },
-    label: { type: "string" },
-    project: { type: "string" },
-    json: { type: "boolean" }
-  } });
-  if (positionals.length > 1 || positionals.length && positionals[0] !== "ready") throw new UsageError();
-  const root = await taskProject(values.project);
-  const { tasks, errors } = await loadTasks(root);
-  warnUnreadable(errors);
-  const rows = positionals[0] === "ready" ? readyTasks(tasks) : listTasks(tasks, { status: values.status, label: values.label, all: values.all });
-  if (values.json) {
-    console.log(JSON.stringify(rows));
-    return;
-  }
-  if (!rows.length) {
-    console.log(positionals[0] === "ready" ? "No task is ready" : `No tasks in ${path.join(root, TASKS_DIR)}`);
-    return;
-  }
-  for (const task of rows) console.log(taskRow(task, tasks));
-}
-var gh = (args, { cwd }) => new Promise((resolve, reject) => {
-  const bin = process.env.ALP_GH_BIN ?? "gh";
-  const script = process.platform === "win32" && /\.[cm]?js$/i.test(bin);
-  const child = spawn(script ? process.execPath : bin, script ? [bin, ...args] : args, { cwd, stdio: ["ignore", "pipe", "pipe"] });
-  let stdout = "";
-  let stderr = "";
-  child.stdout.on("data", (chunk) => {
-    stdout += chunk;
-  });
-  child.stderr.on("data", (chunk) => {
-    stderr += chunk;
-  });
-  child.on("error", (error) => reject(error.code === "ENOENT" ? new Error("gh is not installed or not on PATH") : error));
-  child.on("close", (code) => code === 0 ? resolve(stdout) : reject(new Error(stderr.trim() || `gh exited with ${code}`)));
-});
-async function taskMaintenance([command], args) {
-  const { values, positionals: rest } = parseArgs({ args, allowPositionals: true, options: {
-    project: { type: "string" },
-    json: { type: "boolean" },
-    days: { type: "string" },
-    "dry-run": { type: "boolean" }
-  } });
-  if (rest.length) throw new UsageError();
-  const root = await taskProject(values.project);
-  if (command === "compact") {
-    const days = values.days === void 0 ? 30 : Number(values.days);
-    const changed = await compactTasks(root, { days, dryRun: values["dry-run"] }, "user");
-    if (values.json) {
-      console.log(JSON.stringify(changed));
-      return;
-    }
-    if (!changed.length) {
-      console.log(`No task closed more than ${days} days ago is left to compact`);
-      return;
-    }
-    for (const { id, before, after } of changed) console.log(`${id}  ${before} \u2192 ${after} characters`);
-    console.log(`${values["dry-run"] ? "Would compact" : "Compacted"} ${changed.length} closed ${changed.length === 1 ? "task" : "tasks"}`);
-    return;
-  }
-  const checked = await checkGates(root, gh);
-  const { tasks } = await loadTasks(root);
-  const open = tasks.filter((task) => task.status !== "closed").flatMap((task) => task.gates.filter((gate) => gateOpen(gate)).map((gate) => ({ task, gate })));
-  if (values.json) {
-    console.log(JSON.stringify({ ...checked, open: open.map(({ task, gate }) => ({ task: task.id, ...gate })) }));
-    return;
-  }
-  for (const { task, gate, detail } of checked.cleared) console.log(`\u2713 ${task} ${gate} cleared: ${detail}`);
-  for (const { task, gate, error } of checked.errors) console.error(`alp: could not check ${task} ${gate}: ${error}`);
-  if (!open.length) {
-    console.log("No open gates");
-    return;
-  }
-  for (const { task, gate } of open) {
-    const state = checked.pending.find((entry) => entry.task === task.id && entry.gate === gate.id)?.detail;
-    console.log(`\u23F8 ${task.id} ${describeGate(gate)}${state ? ` (${state})` : ""}  ${task.title}`);
-  }
-}
-async function beads(command, args) {
-  const { values, positionals } = parseArgs({ args, allowPositionals: true, options: {
-    project: { type: "string" },
-    output: { type: "string", short: "o" },
-    "dry-run": { type: "boolean" },
-    json: { type: "boolean" }
-  } });
-  const root = await taskProject(values.project);
-  if (command === "export") {
-    if (positionals.length || values["dry-run"]) throw new UsageError();
-    const { tasks, errors: errors2 } = await loadTasks(root);
-    warnUnreadable(errors2);
-    const text = exportBeads(tasks).map((record) => JSON.stringify(record)).join("\n") + (tasks.length ? "\n" : "");
-    if (values.output) {
-      await writeFile(values.output, text);
-      console.error(`Exported ${tasks.length} ${tasks.length === 1 ? "task" : "tasks"} to ${values.output}`);
-    } else {
-      process.stdout.write(text);
-    }
-    return;
-  }
-  if (positionals.length > 1 || values.output) throw new UsageError();
-  const file = positionals[0] ?? path.join(root, ".beads", "issues.jsonl");
-  const { records, errors } = parseJsonl(await readFile(file, "utf8"));
-  const report = await importBeads(root, records, { dryRun: values["dry-run"], by: "user" });
-  report.skipped.push(...errors);
-  if (values.json) {
-    console.log(JSON.stringify(report));
-    return;
-  }
-  const verb = values["dry-run"] ? "Would import" : "Imported";
-  for (const { id, from } of report.created) console.log(`+ ${id}${id !== from ? ` (from ${from})` : ""}`);
-  for (const { id, from } of report.updated) console.log(`~ ${id}${id !== from ? ` (from ${from})` : ""}`);
-  for (const { line, reason } of report.skipped.sort((a, b) => a.line - b.line)) console.error(`alp: skipped line ${line}: ${reason}`);
-  for (const warning of report.warnings) console.error(`alp: ${warning}`);
-  console.log(`${verb} ${file}: ${report.created.length} created, ${report.updated.length} updated, ${report.skipped.length} skipped`);
-}
-async function formulaCommand([action, ...args]) {
-  const { values, positionals } = parseArgs({ args, allowPositionals: true, options: {
-    project: { type: "string" },
-    var: { type: "string", multiple: true },
-    parent: { type: "string" },
-    "dry-run": { type: "boolean" },
-    json: { type: "boolean" }
-  } });
-  const root = await taskProject(values.project);
-  const home = alpHome();
-  if (action === "list") {
-    if (positionals.length) throw new UsageError();
-    const found = await listFormulas(root, home, { toml });
-    if (values.json) {
-      console.log(JSON.stringify(found));
-      return;
-    }
-    if (!found.length) {
-      console.log(`No formulas in ${formulaDirs(root, home).join(", ")}`);
-      return;
-    }
-    for (const entry of found) console.log(entry.error ? `\u2717 ${entry.name}  ${entry.file}: ${entry.error}` : `${entry.name}  ${entry.formula.steps.length} steps${entry.formula.description ? `  ${entry.formula.description.split("\n")[0]}` : ""}`);
-    return;
-  }
-  if (positionals.length !== 1) throw new UsageError();
-  const { formula, file } = await findFormula(root, home, positionals[0], { toml });
-  if (action === "show") {
-    if (values.json) {
-      console.log(JSON.stringify(formula));
-      return;
-    }
-    console.log(`${formula.formula}${formula.version ? ` v${formula.version}` : ""}  ${file}`);
-    if (formula.description) console.log(`  ${formula.description}`);
-    for (const [name, spec] of Object.entries(formula.vars)) console.log(`  --var ${name}=\u2026${spec.required ? " (required)" : spec.default !== void 0 ? ` (default ${spec.default})` : ""}${spec.description ? `  ${spec.description}` : ""}`);
-    for (const step of formula.steps) console.log(`  ${step.id}${step.type === "human" ? " [you]" : step.type !== "task" ? ` [${step.type}]` : ""}: ${step.title}${step.needs.length ? `  after ${step.needs.join(", ")}` : ""}`);
-    return;
-  }
-  if (action !== "pour") throw new UsageError();
-  const given = {};
-  for (const entry of values.var ?? []) {
-    const at = entry.indexOf("=");
-    if (at < 1) throw new UsageError();
-    given[entry.slice(0, at)] = entry.slice(at + 1);
-  }
-  const { epic, tasks } = await pourFormula(root, formula, given, "user", { dryRun: values["dry-run"], ...values.parent ? { parent: values.parent } : {} });
-  if (values.json) {
-    console.log(JSON.stringify({ epic, tasks }));
-    return;
-  }
-  console.log(`${values["dry-run"] ? "Would pour" : "Poured"} ${formula.formula} as ${epic.id}  ${epic.title}`);
-  const all = [epic, ...tasks];
-  for (const task of tasks) console.log(`  ${taskRow(task, all)}`);
-}
-var repeated = { type: "string", multiple: true };
-async function taskCommand([action, ...args]) {
-  const { values, positionals } = parseArgs({ args, allowPositionals: true, options: {
-    description: { type: "string", short: "d" },
-    priority: { type: "string", short: "p" },
-    type: { type: "string", short: "t" },
-    label: { ...repeated, short: "l" },
-    path: repeated,
-    parent: { type: "string" },
-    after: repeated,
-    related: repeated,
-    from: { type: "string" },
-    title: { type: "string" },
-    message: { type: "string", short: "m" },
-    reason: { type: "string" },
-    unverified: { type: "string" },
-    project: { type: "string" },
-    json: { type: "boolean" },
-    human: { type: "string" },
-    timer: { type: "string" },
-    pr: { type: "string" },
-    run: { type: "string" }
-  } });
-  const root = await taskProject(values.project);
-  const fields = {
-    ...values.description !== void 0 ? { description: values.description } : {},
-    ...values.priority !== void 0 ? { priority: values.priority } : {},
-    ...values.type !== void 0 ? { type: values.type } : {},
-    ...values.label ? { labels: values.label } : {},
-    ...values.path ? { paths: values.path } : {}
-  };
-  let task;
-  if (action === "add") {
-    const title = positionals.join(" ").trim();
-    if (!title) throw new UsageError();
-    task = await createTask(root, { title, ...fields, parent: values.parent, blockedBy: values.after, related: values.related, discoveredFrom: values.from }, "user");
-  } else if (action === "show") {
-    if (positionals.length !== 1) throw new UsageError();
-    const { tasks: tasks2, errors } = await loadTasks(root);
-    warnUnreadable(errors);
-    task = tasks2.find((candidate) => candidate.id === positionals[0]);
-    if (!task) throw new Error(`No task ${positionals[0]} in ${path.join(root, TASKS_DIR)}`);
-    if (values.json) {
-      console.log(JSON.stringify(task));
-      return;
-    }
-    printTask(task, tasks2);
-    return;
-  } else if (action === "report") {
-    if (positionals.length !== 1) throw new UsageError();
-    const { tasks: tasks2, errors } = await loadTasks(root);
-    warnUnreadable(errors);
-    const report = epicReport(positionals[0], tasks2);
-    console.log(values.json ? JSON.stringify(report) : report.text);
-    return;
-  } else if (action === "edit") {
-    if (positionals.length !== 1) throw new UsageError();
-    task = await updateTask(root, positionals[0], { ...fields, ...values.title !== void 0 ? { title: values.title } : {}, note: values.message }, "user");
-  } else if (action === "close") {
-    if (positionals.length !== 1) throw new UsageError();
-    task = await closeTask(root, positionals[0], { reason: values.reason, summary: values.message, unverified: values.unverified }, "user");
-  } else if (action === "reopen") {
-    if (positionals.length !== 1) throw new UsageError();
-    task = await reopenTask(root, positionals[0], { note: values.message }, "user");
-  } else if (action === "dep") {
-    const [change, id, ...rest] = positionals;
-    if (!["add", "rm"].includes(change) || !id || rest.length || !(values.after || values.parent || values.related)) throw new UsageError();
-    const links = { ...values.after ? { blockedBy: values.after } : {}, ...values.parent ? { parent: values.parent } : {}, ...values.related ? { related: values.related } : {} };
-    task = await linkTask(root, id, change === "add" ? { add: links } : { remove: links }, "user");
-  } else if (action === "gate") {
-    const [change, id, gate, ...rest] = positionals;
-    const kinds = ["human", "timer", "pr", "run"].filter((kind) => values[kind] !== void 0);
-    if (change === "add" && id && !gate && kinds.length === 1) {
-      const kind = kinds[0];
-      task = await addGate(root, id, kind === "human" ? { kind, note: values.human } : kind === "timer" ? { kind, until: values.timer } : { kind: `gh:${kind}`, ref: values[kind] }, "user");
-    } else if ((change === "clear" || change === "rm") && id && gate && !rest.length && !kinds.length) {
-      task = await resolveGate(root, id, gate, { by: "user", note: values.message, remove: change === "rm" });
-    } else {
-      throw new UsageError();
-    }
-  } else {
-    throw new UsageError();
-  }
-  if (values.json) {
-    console.log(JSON.stringify(task));
-    return;
-  }
-  const { tasks } = await loadTasks(root);
-  console.log(`${{ add: "Created", close: "Closed", reopen: "Reopened" }[action] ?? "Updated"} ${TASKS_DIR}/${task.id}.json`);
-  if (action === "gate") for (const gate of task.gates.filter((entry) => gateOpen(entry))) console.log(`  \u23F8 ${describeGate(gate)}`);
-  console.log(taskRow(task, tasks));
-  if (action === "close" && tasks.some((entry) => entry.parent === task.id)) console.log(`
-${epicReport(task.id, tasks).text}`);
-}
-function printTask(task, tasks) {
-  console.log(`${STATUS_MARK[task.status]} ${task.id}  ${task.title}`);
-  console.log(`  ${task.type}, P${task.priority}, ${task.status}${task.assignee ? ` with ${task.assignee.agent}` : ""}; created by ${task.createdBy} ${ago(task.createdAt)} ago, rev ${task.rev}`);
-  if (task.description) console.log(`
-  ${task.description.replace(/\n/g, "\n  ")}
-`);
-  const blockers = task.status === "closed" ? [] : blockersOf(task, tasks);
-  const relations = [
-    task.parent && `parent ${task.parent}`,
-    task.blockedBy.length && `after ${task.blockedBy.join(", ")}${blockers.length ? ` (open: ${blockers.join(", ")})` : ""}`,
-    task.discoveredFrom && `found during ${task.discoveredFrom}`,
-    task.related.length && `related ${task.related.join(", ")}`
-  ].filter(Boolean);
-  if (relations.length) console.log(`  ${relations.join("; ")}`);
-  for (const gate of task.gates) console.log(`  ${gateOpen(gate) ? "\u23F8" : "\u2713"} gate ${describeGate(gate)}${gate.resolved ? ` (cleared by ${gate.resolved.by}${gate.resolved.note ? `: ${gate.resolved.note}` : ""})` : ""}`);
-  const inherited = gatesOf(task, tasks).filter((label) => label.startsWith("t-"));
-  if (task.status !== "closed" && inherited.length) console.log(`  waits on its parent's gates: ${inherited.join("; ")}`);
-  if (task.compacted) console.log(`  compacted ${task.compacted.at.slice(0, 10)} from ${task.compacted.chars} characters`);
-  if (task.labels.length) console.log(`  labels: ${task.labels.join(", ")}`);
-  if (task.paths.length) console.log(`  paths: ${task.paths.join(", ")}`);
-  for (const child of childrenOf(task.id, tasks)) console.log(`  ${taskRow(child, tasks)}`);
-  if (task.verified) console.log(`  ${task.verified.skipped ? "\u2013" : task.verified.passed ? "\u2713" : "\u2717"} ${describeVerification(task.verified)}${task.verified.where ? ` in the ${task.verified.where}` : ""}, ${ago(task.verified.at)} ago`);
-  if (task.closed) console.log(`  closed ${task.closed.reason} by ${task.closed.by}${task.closed.summary ? `: ${task.closed.summary}` : ""}${task.closed.unverified ? ` (unverified: ${task.closed.unverified})` : ""}`);
-  for (const entry of task.log.slice(-10)) {
-    const { at, by, event, ...detail } = entry;
-    const text = Object.entries(detail).map(([key, value]) => `${key} ${Array.isArray(value) ? value.join(", ") : value}`).join("; ");
-    console.log(`  ${at.slice(0, 16).replace("T", " ")}  ${by} ${event}${text ? `: ${text}` : ""}`);
-  }
-}
-export {
-  STATUS_MARK,
-  beads,
-  formulaCommand,
-  gh,
-  printTask,
-  repeated,
-  taskCommand,
-  taskMaintenance,
-  taskProject,
-  taskRow,
-  tasksCommand,
-  warnUnreadable
-};

package/packages/cli/dist/terminal.d.ts

@@ -1,8 +0,0 @@
-export function terminalCommand(args: any, { home, out }?: {
-    home?: string | undefined;
-    out?: {
-        (...data: any[]): void;
-        (message?: any, ...optionalParams: any[]): void;
-    } | undefined;
-}): Promise<void>;
-export function TERMINAL_WARNING(user?: string): string;

package/packages/cli/dist/terminal.js

@@ -1,79 +0,0 @@
-// packages/cli/src/terminal.js
-import { randomUUID } from "node:crypto";
-import { chmod, lstat, mkdir, readFile, rename, rm, writeFile } from "node:fs/promises";
-import os from "node:os";
-import path from "node:path";
-import { alpHome } from "@anhlp/alp-client/index";
-import { UsageError } from "./usage.js";
-var TERMINAL_WARNING = (user = os.userInfo().username) => [
-  `A remote terminal runs a real shell on this computer as ${user}, with that account's full access:`,
-  "every file it can read or write, any program, and the network.",
-  "A workspace only picks the directory the shell starts in. It is NOT a sandbox.",
-  "Only gateway credentials that hold the terminal.exec permission can open one (never a default);",
-  "Paseo app devices paired with this host only after alp terminal allow --paseo."
-].join("\n");
-var file = (home) => path.join(home, "terminal.json");
-async function read(home) {
-  const info = await lstat(file(home)).catch(() => void 0);
-  if (!info) return { exists: false, value: void 0, private: true };
-  const own = !process.getuid || info.uid === process.getuid();
-  const value = info.isFile() ? await readFile(file(home), "utf8").then(JSON.parse, () => void 0) : void 0;
-  return { exists: true, value, private: info.isFile() && own && !(info.mode & 63) };
-}
-async function write(home, value) {
-  await mkdir(home, { recursive: true, mode: 448 });
-  const temporary = `${file(home)}.${randomUUID().slice(0, 8)}.tmp`;
-  await writeFile(temporary, JSON.stringify(value, null, 2) + "\n", { mode: 384, flag: "wx" });
-  await chmod(temporary, 384);
-  await rename(temporary, file(home)).catch(async (error) => {
-    await rm(temporary, { force: true });
-    throw error;
-  });
-}
-async function terminalCommand(args, { home = alpHome(), out = console.log } = {}) {
-  const [action, ...rest] = args;
-  const json = rest.includes("--json");
-  const current = await read(home);
-  const limits = current.value && typeof current.value.limits === "object" && current.value.limits ? { limits: current.value.limits } : {};
-  const paseo = rest.includes("--paseo");
-  const paseoBefore = current.private && current.value?.allowPaseoTerminal === true;
-  if (action === "allow") {
-    if (!rest.includes("--yes")) {
-      out(`${TERMINAL_WARNING()}
-
-Run again with --yes to allow remote terminals on this host.`);
-      process.exitCode = 1;
-      return;
-    }
-    const allowPaseoTerminal = paseo || paseoBefore;
-    await write(home, { version: 1, allowRemoteTerminal: true, ...allowPaseoTerminal ? { allowPaseoTerminal: true } : {}, ...limits });
-    out(json ? JSON.stringify({ allowRemoteTerminal: true, allowPaseoTerminal }) : `${TERMINAL_WARNING()}
-
-Remote terminals are allowed on this host (${file(home)})${allowPaseoTerminal ? ", also for every Paseo app device paired with it" : ""}. alp terminal deny turns them off and ends every open one.`);
-    return;
-  }
-  if (action === "deny") {
-    if (paseo) {
-      const allowed = current.private && current.value?.allowRemoteTerminal === true;
-      await write(home, { version: 1, allowRemoteTerminal: allowed, ...limits });
-      out(json ? JSON.stringify({ allowRemoteTerminal: allowed, allowPaseoTerminal: false }) : "Paseo app devices can no longer open terminals on this host; the bridge ends the terminals it holds.");
-      return;
-    }
-    await write(home, { version: 1, allowRemoteTerminal: false, ...limits });
-    out(json ? JSON.stringify({ allowRemoteTerminal: false, allowPaseoTerminal: false }) : "Remote terminals are off on this host; alpd ends every open terminal within 5 seconds.");
-    return;
-  }
-  if (action === "status") {
-    const allowed = current.private && current.value?.version === 1 && current.value.allowRemoteTerminal === true;
-    const allowPaseoTerminal = allowed && current.value.allowPaseoTerminal === true;
-    const problem = current.exists && !current.private ? `${file(home)} is not a private file of this user, so terminals stay off` : void 0;
-    if (json) out(JSON.stringify({ allowRemoteTerminal: allowed, allowPaseoTerminal, ...limits, ...problem ? { problem } : {} }));
-    else out([`Remote terminals: ${allowed ? "allowed" : "off"}${allowPaseoTerminal ? " (also for paired Paseo app devices)" : ""}`, ...problem ? [problem] : [], ...allowed ? ["", TERMINAL_WARNING()] : []].join("\n"));
-    return;
-  }
-  throw new UsageError();
-}
-export {
-  TERMINAL_WARNING,
-  terminalCommand
-};

package/packages/cli/dist/usage.d.ts

@@ -1,3 +0,0 @@
-export const USAGE: "Usage:\n  alp <init|upgrade|update> [directory]\n  alp setup [directory] [--runtime codex|claude|mix] [--prefer claude|codex]\n            [--claude-model M] [--codex-model M] [--claude-supervisor M] [--codex-supervisor M]\n            [--claude-oracle M] [--codex-oracle M]   write Ph\u1EDF/Cafe's agent profiles to .alp/settings.json\n  alp daemon <start|stop|restart>\n  alp daemon status [--json]             liveness and readiness; exit 0 ready, 3 not running, 4 not ready\n  alp daemon <install|uninstall>         run alpd as a login service that restarts after a crash\n  alp acp                                serve ALP to an editor (Zed, JetBrains) over the Agent Client Protocol on stdio\n  alp web [--print]                      open the ALP web app on this machine (alp-web, loopback); --print only prints its address\n  alp web rotate                         give alp web a new token: open pages lose access; prints the new address\n  alp web pair [--on|--off]              the link that pairs Paseo's app on another device through the relay; --on or --off turns the relay on or off\n  alp terminal <allow [--paseo] --yes|deny [--paseo]|status> [--json]   remote terminals (a shell as you on this host; a workspace is not a sandbox), off by default\n  alp doctor [--project DIR] [--fix] [--json]   check this machine and project; --fix repairs what is safe to\n  alp backup [-o FILE] [--project DIR]... [--no-projects] [--stop] [--json]   sessions, settings, library and tasks in one file\n  alp backup verify <file> [--json] | alp backup list [--json]\n  alp restore <file> [--home-only] [--dry-run] [--stop] [--replace-newer] [--json]   checks the whole backup first; keeps what it replaces\n            alpd must be stopped for both; --stop stops it and starts it again after\n  alp run [--agent A] [--team pho|cafe|ID] [--model M] [--mode read-only|workspace-write|full-access] [--thinking T] [--project DIR] [--json] <prompt>\n  alp schedule create --session ID --at ISO_WITH_OFFSET --prompt TEXT [--project DIR] [--json]\n  alp schedule list [--status pending|delivered|failed|cancelled] [--project DIR] [--json]\n  alp schedule <show|cancel> ID [--project DIR] [--json]   one-shot wake; timer gates only unblock tasks\n  alp ps [--all]\n  alp top [session] [--once]\n  alp attach <session> [--json]\n  alp send <session> [--prompt] [--json] <text>\n            child default: user mail; --prompt: explicit new prompt to a live root or child\n  alp questions [--json]\n  alp answer <question> <text> | alp answer <question> --dismiss [--reason R]\n  alp log <session> [--json]\n  alp board [--project DIR] [--json]\n  alp <agents|skills|mcp|hooks> [--project DIR] [--json]   the library: built-in, ~/.alp and project entries\n  alp providers [--json]                    ACP and Antigravity providers in your library\n  alp teams [--project DIR] [--json]         teams sessions run in: members, delegation, house rules\n  alp agent <new|edit> <name> [--project [DIR]] [--from A] [-d text] [--provider P] [--model M] [--thinking T] [--mode M]\n            [--skills a,b] [--mcp a,b] [--hooks a,b] [--instructions FILE]\n  alp team <new|edit> <id> [--project [DIR]] [--from ID] [--label L] [-d text] [--main A] [--member name=role]...\n            [--member-model name=M]... [--member-thinking name=T]... [--delegate owner=a,b]... [--max-peers N]\n            [--supervisor A] [--supervisor-model M] [--supervisor-thinking T] [--no-supervisor] [--rules FILE]\n  alp skill new <name> [--project [DIR]] [--from S] [--file FILE]\n  alp mcp add <name> [--project [DIR]] (--command C [--arg A]... [--env K=V]... [--cwd D] | --url U [--header K=V]...)\n  alp hook add <name> [--project [DIR]] --event E --command C [--blocking] [--timeout SEC] [--match-agent A] [--match-label L]\n  alp provider add <id> --command C [--arg A]... [--env K=V]... [--label L] [-d text] [--models a,b]   an ACP agent; use id antigravity for native agy\n  alp provider edit antigravity --read-only-mode instructions|reject   opt into prompt-only read-only for advisory roles\n  alp <agent|team|skill|mcp|hook|provider> <rm|show> <name> [--project [DIR]] | <cp|mv> <from> <to> [--project [DIR]]\n  alp <mcp|hook|provider> test <name> [--project [DIR]]   list an MCP server's tools; run a hook once; initialize a provider\n            without --project, changes go to your library in ~/.alp; built-in agents and teams are never changed\n  alp trust [--project DIR] | --revoke [--project DIR] | --list [--json]   whether the project's hooks may run\n  alp permissions [--project DIR] [--json]   each agent's permission profile\n  alp permissions check <agent> \"<command>\"  what that agent's profile says about a command\n  alp tasks [ready] [--all] [--status S] [--label L] [--project DIR] [--json]\n  alp tasks gates [--json]                 open gates; checks GitHub ones\n  alp tasks compact [--days 30] [--dry-run]\n  alp tasks export [-o file.jsonl]          as beads JSONL\n  alp tasks import [file.jsonl] [--dry-run]  beads JSONL; default .beads/issues.jsonl\n  alp formula list | show <name> | pour <name> [--var k=v]... [--parent ID] [--dry-run]\n  alp task add <title> [-d text] [-p 0-4] [-t task|bug|feature|chore|epic] [--parent ID] [--after ID]... [-l label]... [--path P]... [--from ID]\n  alp task show <id> [--json]\n  alp task report <epic> [--json]           what an epic came to: tasks, time, rework, verification\n  alp task edit <id> [--title T] [-d text] [-p N] [-t type] [-l label]... [--path P]... [-m note]\n  alp task close <id> [--reason done|wontfix|duplicate|superseded] [-m summary] [--unverified \"why\"]\n  alp verify [--project DIR] [--task ID] [--json]   run the project's verify commands; --task records the result\n  alp task reopen <id> [-m note]\n  alp task dep <add|rm> <id> [--after ID]... [--parent ID] [--related ID]...\n  alp task gate add <id> --human \"question\" | --timer +2h|ISO | --pr N|owner/repo#N | --run N|owner/repo#N\n  alp task gate <clear|rm> <id> <gate> [-m note]\n  alp pause [codex|claude] [--now] [-m reason] | alp pause status   hold delegation; --now parks running assignments\n  alp resume [codex|claude]                  lift a pause; parked assignments continue\n  alp language [name | --reset]              the language agents and ALP write to you in; default Vietnamese\n  alp recall <assignment|task> [--project DIR] [--json] <question>   ask a finished assignment about its work\n  alp interrupt <session>";
-export class UsageError extends Error {
-}

package/packages/cli/dist/usage.js

@@ -1,78 +0,0 @@
-// packages/cli/src/usage.js
-var USAGE = `Usage:
-  alp <init|upgrade|update> [directory]
-  alp setup [directory] [--runtime codex|claude|mix] [--prefer claude|codex]
-            [--claude-model M] [--codex-model M] [--claude-supervisor M] [--codex-supervisor M]
-            [--claude-oracle M] [--codex-oracle M]   write Ph\u1EDF/Cafe's agent profiles to .alp/settings.json
-  alp daemon <start|stop|restart>
-  alp daemon status [--json]             liveness and readiness; exit 0 ready, 3 not running, 4 not ready
-  alp daemon <install|uninstall>         run alpd as a login service that restarts after a crash
-  alp acp                                serve ALP to an editor (Zed, JetBrains) over the Agent Client Protocol on stdio
-  alp web [--print]                      open the ALP web app on this machine (alp-web, loopback); --print only prints its address
-  alp web rotate                         give alp web a new token: open pages lose access; prints the new address
-  alp web pair [--on|--off]              the link that pairs Paseo's app on another device through the relay; --on or --off turns the relay on or off
-  alp terminal <allow [--paseo] --yes|deny [--paseo]|status> [--json]   remote terminals (a shell as you on this host; a workspace is not a sandbox), off by default
-  alp doctor [--project DIR] [--fix] [--json]   check this machine and project; --fix repairs what is safe to
-  alp backup [-o FILE] [--project DIR]... [--no-projects] [--stop] [--json]   sessions, settings, library and tasks in one file
-  alp backup verify <file> [--json] | alp backup list [--json]
-  alp restore <file> [--home-only] [--dry-run] [--stop] [--replace-newer] [--json]   checks the whole backup first; keeps what it replaces
-            alpd must be stopped for both; --stop stops it and starts it again after
-  alp run [--agent A] [--team pho|cafe|ID] [--model M] [--mode read-only|workspace-write|full-access] [--thinking T] [--project DIR] [--json] <prompt>
-  alp schedule create --session ID --at ISO_WITH_OFFSET --prompt TEXT [--project DIR] [--json]
-  alp schedule list [--status pending|delivered|failed|cancelled] [--project DIR] [--json]
-  alp schedule <show|cancel> ID [--project DIR] [--json]   one-shot wake; timer gates only unblock tasks
-  alp ps [--all]
-  alp top [session] [--once]
-  alp attach <session> [--json]
-  alp send <session> [--prompt] [--json] <text>
-            child default: user mail; --prompt: explicit new prompt to a live root or child
-  alp questions [--json]
-  alp answer <question> <text> | alp answer <question> --dismiss [--reason R]
-  alp log <session> [--json]
-  alp board [--project DIR] [--json]
-  alp <agents|skills|mcp|hooks> [--project DIR] [--json]   the library: built-in, ~/.alp and project entries
-  alp providers [--json]                    ACP and Antigravity providers in your library
-  alp teams [--project DIR] [--json]         teams sessions run in: members, delegation, house rules
-  alp agent <new|edit> <name> [--project [DIR]] [--from A] [-d text] [--provider P] [--model M] [--thinking T] [--mode M]
-            [--skills a,b] [--mcp a,b] [--hooks a,b] [--instructions FILE]
-  alp team <new|edit> <id> [--project [DIR]] [--from ID] [--label L] [-d text] [--main A] [--member name=role]...
-            [--member-model name=M]... [--member-thinking name=T]... [--delegate owner=a,b]... [--max-peers N]
-            [--supervisor A] [--supervisor-model M] [--supervisor-thinking T] [--no-supervisor] [--rules FILE]
-  alp skill new <name> [--project [DIR]] [--from S] [--file FILE]
-  alp mcp add <name> [--project [DIR]] (--command C [--arg A]... [--env K=V]... [--cwd D] | --url U [--header K=V]...)
-  alp hook add <name> [--project [DIR]] --event E --command C [--blocking] [--timeout SEC] [--match-agent A] [--match-label L]
-  alp provider add <id> --command C [--arg A]... [--env K=V]... [--label L] [-d text] [--models a,b]   an ACP agent; use id antigravity for native agy
-  alp provider edit antigravity --read-only-mode instructions|reject   opt into prompt-only read-only for advisory roles
-  alp <agent|team|skill|mcp|hook|provider> <rm|show> <name> [--project [DIR]] | <cp|mv> <from> <to> [--project [DIR]]
-  alp <mcp|hook|provider> test <name> [--project [DIR]]   list an MCP server's tools; run a hook once; initialize a provider
-            without --project, changes go to your library in ~/.alp; built-in agents and teams are never changed
-  alp trust [--project DIR] | --revoke [--project DIR] | --list [--json]   whether the project's hooks may run
-  alp permissions [--project DIR] [--json]   each agent's permission profile
-  alp permissions check <agent> "<command>"  what that agent's profile says about a command
-  alp tasks [ready] [--all] [--status S] [--label L] [--project DIR] [--json]
-  alp tasks gates [--json]                 open gates; checks GitHub ones
-  alp tasks compact [--days 30] [--dry-run]
-  alp tasks export [-o file.jsonl]          as beads JSONL
-  alp tasks import [file.jsonl] [--dry-run]  beads JSONL; default .beads/issues.jsonl
-  alp formula list | show <name> | pour <name> [--var k=v]... [--parent ID] [--dry-run]
-  alp task add <title> [-d text] [-p 0-4] [-t task|bug|feature|chore|epic] [--parent ID] [--after ID]... [-l label]... [--path P]... [--from ID]
-  alp task show <id> [--json]
-  alp task report <epic> [--json]           what an epic came to: tasks, time, rework, verification
-  alp task edit <id> [--title T] [-d text] [-p N] [-t type] [-l label]... [--path P]... [-m note]
-  alp task close <id> [--reason done|wontfix|duplicate|superseded] [-m summary] [--unverified "why"]
-  alp verify [--project DIR] [--task ID] [--json]   run the project's verify commands; --task records the result
-  alp task reopen <id> [-m note]
-  alp task dep <add|rm> <id> [--after ID]... [--parent ID] [--related ID]...
-  alp task gate add <id> --human "question" | --timer +2h|ISO | --pr N|owner/repo#N | --run N|owner/repo#N
-  alp task gate <clear|rm> <id> <gate> [-m note]
-  alp pause [codex|claude] [--now] [-m reason] | alp pause status   hold delegation; --now parks running assignments
-  alp resume [codex|claude]                  lift a pause; parked assignments continue
-  alp language [name | --reset]              the language agents and ALP write to you in; default Vietnamese
-  alp recall <assignment|task> [--project DIR] [--json] <question>   ask a finished assignment about its work
-  alp interrupt <session>`;
-var UsageError = class extends Error {
-};
-export {
-  USAGE,
-  UsageError
-};

package/packages/cli/dist/web-service.d.ts

@@ -1,38 +0,0 @@
-/** The alp-web service script beside this CLI; a clear error when this CLI was built without it. */
-export function alpWebEntry(): string;
-/**
- * The process that owns alp web's lock, if it is proven safe to stop; else why not. `kind` says
- * whether waiting can help: `transient` (an owner still starting has not published web.json yet),
- * `foreign` (proven not to be the integration: another user's, another boot's, or a reused pid) or
- * `unknown` (it cannot be proven either way, for example without ps or on Windows).
- *
- * The reuse proof compares the lock's wall-clock `startedAt` with the process's start from ps: a
- * wall clock stepped back by more than two seconds after the lock was written could make a reused
- * pid look older than the lock. A step forward only refuses.
- * @param {string} home
- * @returns {Promise<{ pid: number, app: unknown } | { reason: string, alive: boolean, kind?: 'transient' | 'foreign' | 'unknown' }>}
- */
-export function webOwner(home: string): Promise<{
-    pid: number;
-    app: unknown;
-} | {
-    reason: string;
-    alive: boolean;
-    kind?: "transient" | "foreign" | "unknown";
-}>;
-/**
- * Stops the Paseo integration from before its rename when it still runs as integration `web` (its
- * web.json has no `app: 'alp-web'`), so alp-web can take the lock and web.port. Returns the pid it
- * stopped. A process that cannot be proven to be that integration is left alone.
- * @param {string} home
- */
-export function stopPreRenamePaseo(home: string): Promise<number | undefined>;
-/**
- * Stops whatever runs as integration `web` (alp-web, or the Paseo integration from before its
- * rename), waiting up to `timeoutMs` for a starting owner to publish what proves it. Resolves once
- * no live process owns the lock; refuses at once an owner that is foreign or cannot be proven.
- * @param {string} home @param {number} [timeoutMs]
- */
-export function stopWebService(home: string, timeoutMs?: number): Promise<number | undefined>;
-/** The opening of the message for a web lock held by a process alp would not stop. @param {string} home */
-export function refusal(home: string): string;