@open-tomato/rafa 0.15.0 → 0.17.0

package/dist/index-p901zs2p.js

@@ -0,0 +1,124 @@
+// @bun
+import {
+  describeValue
+} from "./index-n3rw8rhr.js";
+
+// src/cli/spends.ts
+var SPENDS_GLYPH = "\uD83E\uDE99";
+var SPENDS_WHEN = ["always", "with", "unless", "through"];
+var FLAGGED = ["with", "unless"];
+var FLAG_SPELLING = /^--[^\s-]\S*$/;
+function flagProblem(when, flag) {
+  if (FLAGGED.includes(when)) {
+    return typeof flag === "string" && FLAG_SPELLING.test(flag) ? null : `spends.flag is ${describeValue(flag)}, expected a flag as typed, starting with --`;
+  }
+  return flag === undefined ? null : `spends.flag is ${describeValue(flag)}, expected absent when spends.when is "${when}"`;
+}
+function spendsProblem(value) {
+  if (value === undefined)
+    return null;
+  if (typeof value !== "object" || value === null || Array.isArray(value)) {
+    return `spends is ${describeValue(value)}, expected absent or a mapping`;
+  }
+  const { when, what, flag } = value;
+  if (!SPENDS_WHEN.includes(when)) {
+    return `spends.when is ${describeValue(when)}, expected one of ${SPENDS_WHEN.join(", ")}`;
+  }
+  if (typeof what !== "string") {
+    return `spends.what is ${describeValue(what)}, expected a string`;
+  }
+  return flagProblem(when, flag);
+}
+
+// src/cli/command.ts
+var COMMAND_OUTPUTS = ["text", "json", "tui"];
+var MAX_EXIT_CODE = 255;
+
+class CommandExit extends Error {
+  exitCode;
+  constructor(exitCode, message = "") {
+    super(message);
+    if (!Number.isInteger(exitCode) || exitCode < 0 || exitCode > MAX_EXIT_CODE) {
+      throw new TypeError(`CommandExit: exit code is ${describeValue(exitCode)}, expected a whole number from 0 to ${MAX_EXIT_CODE}`);
+    }
+    this.name = "CommandExit";
+    this.exitCode = exitCode;
+  }
+}
+function isListOf(value, check) {
+  return Array.isArray(value) && value.every(check);
+}
+function hasStrings(value, keys) {
+  if (typeof value !== "object" || value === null)
+    return false;
+  const record = value;
+  return keys.every((key) => typeof record[key] === "string");
+}
+function isRoutingWord(value) {
+  return typeof value === "string" && /^[^\s/-][^\s/]*$/.test(value);
+}
+function isFlag(item) {
+  if (!hasStrings(item, ["name"]))
+    return false;
+  const { deprecated } = item;
+  return deprecated === undefined || hasStrings(deprecated, ["use"]);
+}
+function fieldProblem(fields) {
+  const checks = [
+    ["subject", isRoutingWord(fields.subject), "a word with no space, no slash and no leading dash"],
+    ["action", isRoutingWord(fields.action), "a word with no space, no slash and no leading dash"],
+    ["name", typeof fields.name === "string", "a string"],
+    ["summary", typeof fields.summary === "string", "a string"],
+    ["description", typeof fields.description === "string", "a string"],
+    ["args", isListOf(fields.args, (item) => hasStrings(item, ["name"])), "a list of named arguments"],
+    ["flags", isListOf(fields.flags, isFlag), "a list of named flags, each deprecation naming its use"],
+    ["examples", isListOf(fields.examples, (item) => hasStrings(item, ["cmd", "note"])), "a list of examples"],
+    [
+      "outputs",
+      isListOf(fields.outputs, (item) => COMMAND_OUTPUTS.includes(item)),
+      `a list of ${COMMAND_OUTPUTS.join(", ")}`
+    ],
+    [
+      "aliases",
+      fields.aliases === undefined || isListOf(fields.aliases, (item) => typeof item === "string"),
+      "absent or a list of strings"
+    ],
+    [
+      "deprecated",
+      fields.deprecated === undefined || hasStrings(fields.deprecated, ["since", "use"]),
+      "absent or a mapping of since and use"
+    ],
+    ["hidden", fields.hidden === undefined || typeof fields.hidden === "boolean", "absent or a boolean"],
+    [
+      "needsProject",
+      fields.needsProject === undefined || typeof fields.needsProject === "boolean",
+      "absent or a boolean"
+    ],
+    ["exec", fields.exec === undefined || fields.exec === true, "absent or true"],
+    ["run", typeof fields.run === "function", "a function"]
+  ];
+  const failed = checks.find(([, passes]) => !passes);
+  if (failed === undefined)
+    return null;
+  const [key, , expected] = failed;
+  return `${key} is ${describeValue(fields[key])}, expected ${expected}`;
+}
+function commandProblem(value) {
+  if (typeof value !== "object" || value === null || Array.isArray(value)) {
+    return `a command is ${describeValue(value)}, expected a mapping`;
+  }
+  const fields = value;
+  const problem = fieldProblem(fields) ?? spendsProblem(fields.spends);
+  if (problem === null)
+    return null;
+  const named = isRoutingWord(fields.subject) && isRoutingWord(fields.action) ? `command "${commandSpelling(fields)}"` : "a command";
+  return `${named}: ${problem}`;
+}
+function isTopLevel(command) {
+  return command.subject === command.action;
+}
+function commandSpelling(command) {
+  return isTopLevel(command) ? command.subject : `${command.subject} ${command.action}`;
+}
+
+export { SPENDS_GLYPH, CommandExit, isRoutingWord, commandProblem, isTopLevel, commandSpelling };

package/dist/{index-2256nwj0.js → index-ps5sac9p.js}

@@ -1,396 +1,33 @@
 // @bun
-// src/pr/types.ts
-var MERGE_METHODS = Object.freeze([
-  "squash",
-  "merge",
-  "rebase"
-]);
-function isMergeMethod(value) {
-  return typeof value === "string" && MERGE_METHODS.includes(value);
-}
-
-// src/utils/declaration.ts
-var DECLARATION_KEYS = [
-  "agent",
-  "model",
-  "effort",
-  "budget",
-  "tools",
-  "skills"
-];
-var GRANULAR_KEYS = ["model", "effort", "tools"];
-var AGENT_OWNED_KEYS = ["model", "tools"];
-var MODEL_ALIASES = ["opus", "sonnet", "haiku", "fable"];
-var EFFORT_LEVELS = [
-  "low",
-  "medium",
-  "high",
-  "xhigh",
-  "max"
-];
-var DECLARATION_BLOCK = /\{([^{}]*)\}$/;
-var ENTRY_TOKEN = /^([A-Za-z_][A-Za-z0-9_-]*)=(.*)$/;
-var FULL_MODEL_NAME = /^claude-[a-z0-9][a-z0-9.-]*$/;
-var AGENT_NAME = /^[A-Za-z0-9][A-Za-z0-9_-]*$/;
-function isAgentName(value) {
-  return AGENT_NAME.test(value);
-}
-var TOOL_NAME = /^[A-Za-z][A-Za-z0-9_-]*$/;
-var SKILL_NAME = /^[A-Za-z0-9][A-Za-z0-9_-]*$/;
-var BUDGET_FLAG = "--max-budget-usd";
-var BUDGET_VALUE = /^(?:0|[1-9]\d{0,5})(?:\.\d{1,6})?$/;
-function parseBudgetUsd(value) {
-  if (!BUDGET_VALUE.test(value))
-    return null;
-  const usd = Number(value);
-  return usd > 0 ? usd : null;
-}
-function isEffortLevel(value) {
-  return EFFORT_LEVELS.includes(value);
-}
-function isModelValue(value) {
-  if (MODEL_ALIASES.includes(value))
-    return true;
-  return FULL_MODEL_NAME.test(value);
-}
-function parseToolList(value) {
-  const parts = value.split(",");
-  if (parts.length === 0)
-    return null;
-  const tools = [];
-  for (const part of parts) {
-    if (!TOOL_NAME.test(part))
-      return null;
-    if (!tools.includes(part))
-      tools.push(part);
-  }
-  return tools;
-}
-function parseSkillList(value) {
-  const parts = value.split(",");
-  if (parts.length === 0)
-    return null;
-  const skills = [];
-  for (const part of parts) {
-    if (!SKILL_NAME.test(part))
-      return null;
-    if (!skills.includes(part))
-      skills.push(part);
-  }
-  return skills;
-}
-function unusableValue(key, token) {
-  return { reason: "unusable-value", key, text: token };
-}
-function isDeclarationKey(key) {
-  return DECLARATION_KEYS.includes(key);
-}
-function tokenise(body) {
-  const trimmed = body.trim();
-  if (trimmed.length === 0)
-    return [];
-  return trimmed.split(/\s+/);
-}
-function readBlock(raw, body) {
-  const entries = [];
-  const extras = [];
-  const issues = [];
-  const seen = new Set;
-  let agent = null;
-  let model = null;
-  let effort = null;
-  let budget = null;
-  let tools = null;
-  let skills = null;
-  for (const token of tokenise(body)) {
-    const match = token.match(ENTRY_TOKEN);
-    const key = match?.[1];
-    const value = match?.[2];
-    if (key === undefined || value === undefined) {
-      issues.push({ reason: "stray-token", key: "", text: token });
-      continue;
-    }
-    const entry = { key, value };
-    entries.push(entry);
-    if (!isDeclarationKey(key)) {
-      extras.push(entry);
-      continue;
-    }
-    if (seen.has(key)) {
-      issues.push({ reason: "duplicate-key", key, text: token });
-      continue;
-    }
-    seen.add(key);
-    if (key === "agent") {
-      if (AGENT_NAME.test(value))
-        agent = value;
-      else
-        issues.push(unusableValue(key, token));
-      continue;
-    }
-    if (key === "model") {
-      if (isModelValue(value))
-        model = value;
-      else
-        issues.push(unusableValue(key, token));
-      continue;
-    }
-    if (key === "effort") {
-      if (isEffortLevel(value))
-        effort = value;
-      else
-        issues.push(unusableValue(key, token));
-      continue;
-    }
-    if (key === "budget") {
-      const usd = parseBudgetUsd(value);
-      if (usd === null)
-        issues.push(unusableValue(key, token));
-      else
-        budget = usd;
-      continue;
-    }
-    if (key === "tools") {
-      const parsed = parseToolList(value);
-      if (parsed === null)
-        issues.push(unusableValue(key, token));
-      else
-        tools = parsed;
-      continue;
-    }
-    const named = parseSkillList(value);
-    if (named === null)
-      issues.push(unusableValue(key, token));
-    else
-      skills = named;
-  }
-  if (seen.size === 0)
-    return null;
-  return {
-    raw,
-    entries,
-    extras,
-    issues,
-    agent,
-    model,
-    effort,
-    budget,
-    tools,
-    skills
-  };
-}
-function parseTaskDeclaration(taskText) {
-  const trimmed = taskText.trimEnd();
-  const match = trimmed.match(DECLARATION_BLOCK);
-  const raw = match?.[0];
-  const body = match?.[1];
-  if (raw === undefined || body === undefined) {
-    return { text: taskText, declaration: null };
-  }
-  const before = trimmed.slice(0, trimmed.length - raw.length).trimEnd();
-  if (before.length === 0)
-    return { text: taskText, declaration: null };
-  const declaration = readBlock(raw, body);
-  if (declaration === null)
-    return { text: taskText, declaration: null };
-  return { text: before, declaration };
-}
-function stripTaskDeclaration(taskText) {
-  return parseTaskDeclaration(taskText).text;
-}
-function budgetArgs(budget) {
-  return budget === null ? [] : [BUDGET_FLAG, String(budget)];
-}
-function resolveDeclarationFlags(declaration, agentDeclaresEffort) {
-  if (declaration === null)
-    return { args: [], suppressed: [] };
-  const { agent, effort } = declaration;
-  const isPresent = (key) => declaration[key] !== null;
-  const budget = budgetArgs(declaration.budget);
-  if (agent !== null) {
-    if (effort === null || agentDeclaresEffort(agent)) {
-      return { args: ["--agent", agent, ...budget], suppressed: GRANULAR_KEYS.filter(isPresent) };
-    }
-    return {
-      args: ["--agent", agent, "--effort", effort, ...budget],
-      suppressed: AGENT_OWNED_KEYS.filter(isPresent)
-    };
-  }
-  const args = [];
-  if (declaration.model !== null)
-    args.push("--model", declaration.model);
-  if (declaration.effort !== null)
-    args.push("--effort", declaration.effort);
-  args.push(...budget);
-  if (declaration.tools !== null) {
-    args.push("--tools", declaration.tools.join(","));
-  }
-  return { args, suppressed: [] };
-}
-
-// src/config-sections.ts
-function isMapping(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-function describeValue(value) {
-  if (typeof value === "string")
-    return JSON.stringify(value);
-  if (value === null)
-    return "null";
-  if (Array.isArray(value))
-    return "a list";
-  if (typeof value === "object")
-    return "a mapping";
-  return String(value);
-}
-function messageOf(error) {
-  return error instanceof Error ? error.message : String(error);
-}
-var CONFIG_VERSIONS = [1];
-var STORE_BACKENDS = ["sqlite", "ndjson"];
-var INJECT_MODES = ["full", "stage", "task"];
-var OUTPUT_MODES = ["text", "json"];
-var CLAUDE_SETTING_SOURCES = ["user", "project", "local"];
-var PR_PROVIDERS = ["gh", "none"];
-var RELEASE_AUTO = "auto";
-function accepted(value) {
-  return { value, problems: [], extras: [] };
-}
-function refused(at, raw, expected) {
-  const problem = `${at.label} is ${describeValue(raw)}, expected ${expected}`;
-  return { value: undefined, problems: [problem], extras: [] };
-}
-function refusedWith(problems) {
-  return { value: undefined, problems, extras: [] };
-}
-function mapReading(reading, map) {
-  return reading.value === undefined ? { ...reading, value: undefined } : { ...reading, value: map(reading.value) };
-}
-function below(at, step) {
-  return { label: `${at.label}${step}`, key: `${at.key}${step}` };
-}
-function oneOf(values) {
-  const expected = `one of: ${values.join(", ")}`;
-  return (raw, at) => {
-    const hit = values.find((value) => value === raw);
-    return hit === undefined ? refused(at, raw, expected) : accepted(hit);
-  };
-}
-function text(expected) {
-  return (raw, at) => typeof raw === "string" && raw.trim() !== "" ? accepted(raw) : refused(at, raw, expected);
-}
-var flag = (raw, at) => typeof raw === "boolean" ? accepted(raw) : refused(at, raw, "true or false");
-var mergeMethod = oneOf(MERGE_METHODS);
-var usdAmount = (raw, at) => {
-  const usd = typeof raw === "number" ? parseBudgetUsd(String(raw)) : null;
-  return usd === null ? refused(at, raw, "a number of US dollars above zero, at most six digits either side of the point") : accepted(usd);
-};
-var issueNumber = (raw, at) => typeof raw === "number" && Number.isSafeInteger(raw) && raw > 0 ? accepted(raw) : refused(at, raw, "an issue number, a whole number above zero");
-var dayCount = (raw, at) => typeof raw === "number" && Number.isSafeInteger(raw) && raw > 0 ? accepted(raw) : refused(at, raw, "a number of days, a whole number above zero");
-var releaseEnabled = (raw, at) => typeof raw === "boolean" || raw === RELEASE_AUTO ? accepted(raw) : refused(at, raw, `true, false or ${RELEASE_AUTO}`);
-var GITHUB_LOGIN = /^[A-Za-z0-9][A-Za-z0-9-]*(?:\[bot\])?$/;
-function isGitHubLogin(value) {
-  return typeof value === "string" && GITHUB_LOGIN.test(value);
-}
-var githubLogin = (raw, at) => isGitHubLogin(raw) ? accepted(raw) : refused(at, raw, "a GitHub login");
-function listOf(item, expected) {
-  return (raw, at) => {
-    if (!Array.isArray(raw))
-      return refused(at, raw, `a list of ${expected}`);
-    const readings = raw.map((entry, index) => item(entry, below(at, `[${index}]`)));
-    const problems = readings.flatMap((reading) => reading.problems);
-    const extras = readings.flatMap((reading) => reading.extras);
-    if (problems.length > 0)
-      return { value: undefined, problems, extras };
-    const values = readings.flatMap((reading) => reading.value === undefined ? [] : [reading.value]);
-    return { value: Object.freeze(values), problems, extras };
-  };
-}
-function subsetOf(values) {
-  const expected = `a comma-separated subset of: ${values.join(", ")}`;
-  return (raw, at) => {
-    if (typeof raw !== "string")
-      return refused(at, raw, expected);
-    const named = [];
-    for (const entry of raw.split(",")) {
-      const hit = values.find((value) => value === entry.trim());
-      if (hit === undefined || named.includes(hit))
-        return refused(at, raw, expected);
-      named.push(hit);
-    }
-    return accepted(Object.freeze(named));
-  };
-}
-var itemText = text("a non-empty string");
-function readKeyedItem(shape, raw, at) {
-  const choices = shape.kinds.join(", ");
-  if (!isMapping(raw))
-    return refused(at, raw, `a mapping naming one of: ${choices}`);
-  const entries = Object.entries(raw);
-  const kinds = shape.kinds.filter((kind2) => entries.some(([name]) => name === kind2));
-  const [kind] = kinds;
-  if (kind === undefined)
-    return refusedWith([`${at.label} names none of: ${choices}`]);
-  if (kinds.length > 1) {
-    const named2 = kinds.join(" and ");
-    return refusedWith([`${at.label} names ${named2}, expected exactly one of: ${choices}`]);
-  }
-  const optionalKeys = shape.optionalFor(kind);
-  const problems = [];
-  const extras = [];
-  const optional = new Map;
-  let named;
-  for (const [name, value] of entries) {
-    if (name !== kind && !optionalKeys.includes(name)) {
-      extras.push({ key: `${at.key}.${name}`, value });
-      continue;
-    }
-    if (name !== kind && value === null)
-      continue;
-    const reading = itemText(value, below(at, `.${name}`));
-    problems.push(...reading.problems);
-    if (reading.value === undefined)
-      continue;
-    if (name === kind)
-      named = reading.value;
-    else
-      optional.set(name, reading.value);
-  }
-  return problems.length > 0 || named === undefined ? { value: undefined, problems, extras } : { value: { kind, named, optional }, problems, extras };
-}
-var PREREQUISITE_KINDS = ["tool", "env", "service", "lsp"];
-var REQUIRED_ITEM_KEYS = [...PREREQUISITE_KINDS, "probe"];
-var OPTIONAL_ITEM_KEYS = [...REQUIRED_ITEM_KEYS, "reason"];
-var requiredPrerequisite = (raw, at) => {
-  const shape = { kinds: PREREQUISITE_KINDS, optionalFor: () => ["probe"] };
-  return mapReading(readKeyedItem(shape, raw, at), (item) => Object.freeze({
-    kind: item.kind,
-    name: item.named,
-    probe: item.optional.get("probe") ?? null
-  }));
-};
-var optionalPrerequisite = (raw, at) => {
-  const shape = { kinds: PREREQUISITE_KINDS, optionalFor: () => ["probe", "reason"] };
-  return mapReading(readKeyedItem(shape, raw, at), (item) => Object.freeze({
-    kind: item.kind,
-    name: item.named,
-    probe: item.optional.get("probe") ?? null,
-    reason: item.optional.get("reason") ?? null
-  }));
-};
-var MODULE_SOURCE_KINDS = ["npm", "github", "path"];
-var MODULE_SOURCE_KEYS = [...MODULE_SOURCE_KINDS, "ref"];
-var moduleSource = (raw, at) => {
-  const shape = {
-    kinds: MODULE_SOURCE_KINDS,
-    optionalFor: (kind) => kind === "github" ? ["ref"] : []
-  };
-  return mapReading(readKeyedItem(shape, raw, at), (item) => Object.freeze({
-    kind: item.kind,
-    location: item.named,
-    ref: item.optional.get("ref") ?? null
-  }));
-};
+import {
+  CLAUDE_SETTING_SOURCES,
+  CONFIG_VERSIONS,
+  INJECT_MODES,
+  MODULE_SOURCE_KEYS,
+  OPTIONAL_ITEM_KEYS,
+  OUTPUT_MODES,
+  PR_PROVIDERS,
+  RELEASE_AUTO,
+  REQUIRED_ITEM_KEYS,
+  STORE_BACKENDS,
+  dayCount,
+  describeValue,
+  flag,
+  githubLogin,
+  isMapping,
+  issueNumber,
+  listOf,
+  mergeMethod,
+  messageOf,
+  moduleSource,
+  oneOf,
+  optionalPrerequisite,
+  releaseEnabled,
+  requiredPrerequisite,
+  subsetOf,
+  text,
+  usdAmount
+} from "./index-n3rw8rhr.js";
 
 // src/config-schema.ts
 import { join } from "path";
@@ -425,7 +62,9 @@ var CONFIG_DEFAULTS = Object.freeze({
   releaseHeading: "## {version} \u2014 {date}, {title}",
   cleanupStaleDays: 30,
   cleanupWorktreeIdleDays: 7,
-  cleanupKeep: Object.freeze([])
+  cleanupKeep: Object.freeze([]),
+  dangerousAcceptStaleRefs: false,
+  statusNotice: true
 });
 var directory = text("a directory path");
 var trackerKind = text("a tracker kind name");
@@ -511,7 +150,13 @@ var SETTINGS = {
     key: "cleanup.keep",
     read: listOf(text("a glob pattern"), "glob patterns"),
     cli: false
-  }
+  },
+  dangerousAcceptStaleRefs: {
+    key: "dangerous.acceptStaleRefs",
+    read: flag,
+    cli: false
+  },
+  statusNotice: { key: "status.notice", read: flag, cli: false }
 };
 var SETTING_NAMES = Object.keys(SETTINGS);
 var SETTING_BY_KEY = new Map(SETTING_NAMES.map((setting) => [
@@ -608,7 +253,9 @@ function readLayer(rawOf, atOf) {
     releaseHeading: read("releaseHeading"),
     cleanupStaleDays: read("cleanupStaleDays"),
     cleanupWorktreeIdleDays: read("cleanupWorktreeIdleDays"),
-    cleanupKeep: read("cleanupKeep")
+    cleanupKeep: read("cleanupKeep"),
+    dangerousAcceptStaleRefs: read("dangerousAcceptStaleRefs"),
+    statusNotice: read("statusNotice")
   };
   return { layer, problems, extras };
 }
@@ -881,4 +528,4 @@ function activeOutputMode() {
   return activeMode;
 }
 
-export { MERGE_METHODS, isMergeMethod, isAgentName, BUDGET_FLAG, parseTaskDeclaration, stripTaskDeclaration, resolveDeclarationFlags, isMapping, describeValue, messageOf, CONFIG_VERSIONS, STORE_BACKENDS, INJECT_MODES, OUTPUT_MODES, CLAUDE_SETTING_SOURCES, PR_PROVIDERS, RELEASE_AUTO, isGitHubLogin, listOf, PREREQUISITE_KINDS, requiredPrerequisite, optionalPrerequisite, MODULE_SOURCE_KINDS, CONFIG_FILE, CONFIG_DEFAULTS, ConfigError, configFilePath, parseConfigText, resolveConfig, createTextOutput, activeOutput, activeOutputMode, RAFA_BLOCK_KINDS, isRafaBlockKind, readRafaBlocks };
+export { CONFIG_FILE, CONFIG_DEFAULTS, SETTINGS, ConfigError, configFilePath, parseConfigText, resolveConfig, createTextOutput, activeOutput, activeOutputMode, RAFA_BLOCK_KINDS, isRafaBlockKind, readRafaBlocks };