@astrosheep/keiyaku 2.9.12 → 4.0.0

package/build/cli/flags.js

@@ -1,289 +0,0 @@
-import { ACTOR_IDENTITY } from "../keiyaku.js";
-import { TASK_FILTER_GRAMMAR } from "../core/task/query.js";
-export const HELP_FLAGS = new Set(["--help", "-h"]);
-export const FLAG_SPECS = {
-    cwd: {
-        kind: "value",
-        placeholder: "DIR",
-        description: "Select the effective command directory (-C/--cwd). Defaults to the process working directory; the repository is inferred from here unless --repo is set.",
-    },
-    repo: {
-        kind: "value",
-        placeholder: "DIR",
-        description: "Override the repository inferred from the effective directory. Needed only when the contract ledger lives in a different repository; the same value as -C is always redundant.",
-    },
-    contract: {
-        kind: "value",
-        placeholder: "ADDR",
-        description: "Select a commission by place, slug, or full id (same namespace as @addr).",
-    },
-    akuma: {
-        kind: "value",
-        placeholder: "NAME",
-        description: `Start a new ${ACTOR_IDENTITY} session with the configured agent name.`,
-    },
-    model: {
-        kind: "value",
-        placeholder: "MODEL",
-        description: "Override the configured model for this agent run.",
-    },
-    effort: {
-        kind: "value",
-        placeholder: "LEVEL",
-        description: "Override effort for the generation being launched with an opaque provider-native value.",
-    },
-    projection: {
-        kind: "value",
-        placeholder: "ID",
-        description: "Akuma projection address.",
-    },
-    alias: {
-        kind: "value",
-        placeholder: "WORD",
-        description: "Move a projection alias to this newly launched call.",
-    },
-    timeout: {
-        kind: "value",
-        placeholder: "DURATION",
-        description: "Wait at most a positive duration such as 45s, 5m, or 2h (maximum 24h).",
-    },
-    any: {
-        kind: "boolean",
-        description: "For a projection set, return when the first observed member reaches a terminal state.",
-    },
-    wait: {
-        kind: "value",
-        placeholder: "DURATION",
-        description: "After acceptance, wait at most a positive duration for the projection (maximum 24h).",
-    },
-    incognito: {
-        kind: "boolean",
-        description: "Do not persist response history and do not allow revive.",
-    },
-    bare: {
-        kind: "boolean",
-        description: "Explicitly select standalone execution (also the default without --contract); history, sandbox, credentials, projection, and repository policy remain active.",
-    },
-    detach: {
-        kind: "boolean",
-        description: "Return after durable launch instead of waiting for completion.",
-    },
-    interrupt: {
-        kind: "boolean",
-        description: "Interrupt the current projection turn after saving the tell.",
-    },
-    "draft-only": {
-        kind: "boolean",
-        description: "Write a draft artifact without creating a contract workspace.",
-    },
-    exclusive: {
-        kind: "boolean",
-        description: "Reject bind if any active contract already exists.",
-    },
-    place: {
-        kind: "value",
-        placeholder: "NAME",
-        description: "Legacy bind title spelling; bind rejects it with --title migration guidance.",
-    },
-    objective: {
-        kind: "value",
-        placeholder: "TEXT",
-        description: "Set the objective for flag-generated bind Markdown.",
-    },
-    context: {
-        kind: "value",
-        placeholder: "TEXT",
-        description: "Set established facts and constraints for flag-generated bind Markdown.",
-    },
-    design: {
-        kind: "value",
-        placeholder: "TEXT",
-        description: "Set the settled design for flag-generated bind Markdown.",
-    },
-    scope: {
-        kind: "value",
-        placeholder: "GLOB",
-        description: "Add an ordered scope pattern to flag-generated bind Markdown. May be repeated.",
-    },
-    criteria: {
-        kind: "value",
-        placeholder: "CRITERION",
-        description: "Set the single declarative acceptance criterion for flag-generated bind Markdown.",
-    },
-    verification: {
-        kind: "value",
-        placeholder: "DECLARATION",
-        description: "Set the single executable verification declaration for flag-generated bind Markdown.",
-    },
-    task: {
-        kind: "value",
-        placeholder: "ID",
-        description: "Promote one ready task into the contract being bound.",
-    },
-    after: {
-        kind: "value",
-        placeholder: "ID",
-        description: "Declare that this contract depends on another contract. May be repeated.",
-    },
-    force: {
-        kind: "boolean",
-        description: "Replace an existing installed Keiyaku skill link or directory for any bundled skill.",
-    },
-    reason: {
-        kind: "value",
-        placeholder: "TEXT",
-        description: "Record a manual forfeit reason note in the contract ledger.",
-    },
-    "dry-run": {
-        kind: "boolean",
-        description: "Preview bind input or petition preflight without mutation.",
-    },
-    check: {
-        kind: "boolean",
-        description: "Derive and render the task composition without changing the board or Git state.",
-    },
-    "append-scope": {
-        kind: "value",
-        placeholder: "PATTERN",
-        description: "Append one ordered scope pattern to the contract before audit. May be repeated.",
-    },
-    renew: {
-        kind: "boolean",
-        description: "Renew onto the current target before petitioning.",
-    },
-    continue: {
-        kind: "boolean",
-        description: "Continue from the derived renew conflict scratch.",
-    },
-    abort: {
-        kind: "boolean",
-        description: "Delete the derived renew conflict scratch without moving authoritative refs.",
-    },
-    shell: {
-        kind: "value",
-        placeholder: "SHELL",
-        description: "Render a shell completion script for bash or zsh.",
-    },
-    word: {
-        kind: "value",
-        placeholder: "TEXT",
-        description: "Complete candidates matching the current shell word.",
-    },
-    previous: {
-        kind: "value",
-        placeholder: "TEXT",
-        description: "Previous shell word used to choose contextual completion candidates.",
-    },
-    complete: {
-        kind: "boolean",
-        description: "Print completion candidates instead of a shell installation script.",
-    },
-    target: {
-        kind: "value",
-        placeholder: "REF",
-        description: "Filter target-keyed status facts by branch name or full refs/heads/<name>.",
-    },
-    all: {
-        kind: "boolean",
-        description: "Show all retained items instead of the default filtered view.",
-    },
-    json: {
-        kind: "boolean",
-        description: "Render structured data as JSON.",
-    },
-    "diff-budget": {
-        kind: "value",
-        placeholder: "BYTES",
-        description: "Set the audit raw-diff presentation budget in bytes.",
-    },
-    done: {
-        kind: "boolean",
-        description: "Show terminal tasks.",
-    },
-    filter: {
-        kind: "value",
-        placeholder: TASK_FILTER_GRAMMAR,
-        description: "Filter structured facts. Repeat --filter for AND; comma values or | terms are OR.",
-    },
-    sort: {
-        kind: "value",
-        placeholder: "KEY[,KEY...]",
-        description: "Sort the selected structured collection.",
-    },
-    pri: {
-        kind: "value",
-        placeholder: "0-3",
-        description: "Set task priority from 0 through 3.",
-    },
-    needs: {
-        kind: "value",
-        placeholder: "ID",
-        description: "Add a task dependency. May be repeated.",
-    },
-    "drop-needs": {
-        kind: "value",
-        placeholder: "ID",
-        description: "Remove a task dependency. May be repeated.",
-    },
-    parent: {
-        kind: "value",
-        placeholder: "ID",
-        description: "Set the parent task.",
-    },
-    "no-parent": {
-        kind: "boolean",
-        description: "Clear the parent task.",
-    },
-    from: {
-        kind: "value",
-        placeholder: "ID",
-        description: "Add a discovery-lineage task. May be repeated.",
-    },
-    supersedes: {
-        kind: "value",
-        placeholder: "ID",
-        description: "Record that this task supersedes another task. May be repeated.",
-    },
-    "drop-supersedes": {
-        kind: "value",
-        placeholder: "ID",
-        description: "Remove a supersedes relation. May be repeated.",
-    },
-    "relates-to": {
-        kind: "value",
-        placeholder: "ID",
-        description: "Record related work. May be repeated.",
-    },
-    "drop-relates-to": {
-        kind: "value",
-        placeholder: "ID",
-        description: "Remove a related-work relation. May be repeated.",
-    },
-    title: {
-        kind: "value",
-        placeholder: "TEXT",
-        description: "Set the bind document title or replace the task title.",
-    },
-    body: {
-        kind: "value",
-        placeholder: "TEXT|-",
-        description: "Replace the task body; literal - reads stdin.",
-    },
-    append: {
-        kind: "value",
-        placeholder: "TEXT|-",
-        description: "Append a Markdown paragraph to the task body; literal - reads stdin.",
-    },
-};
-export const CONTROL_FLAGS = new Set(Object.keys(FLAG_SPECS));
-export const VALUE_FLAGS = new Set(Object.entries(FLAG_SPECS)
-    .filter(([, spec]) => spec.kind === "value")
-    .map(([name]) => name));
-export const BOOLEAN_FLAGS = new Set(Object.entries(FLAG_SPECS)
-    .filter(([, spec]) => spec.kind === "boolean")
-    .map(([name]) => name));
-export const SHORT_FLAG_ALIASES = {
-    C: "cwd",
-    d: "detach",
-    f: "force",
-};

package/build/cli/help.js

@@ -1,100 +0,0 @@
-import { CLI_COMMAND_METADATA, getCommandMetadata } from "./commands/metadata.js";
-export { formatSubcommandList, missingSubcommandError } from "./missing-subcommand.js";
-function indent(lines) {
-    return lines.map((line) => line ? `  ${line}` : "");
-}
-function section(lines, title, body) {
-    if (!body?.length)
-        return;
-    lines.push(title, ...indent(body), "");
-}
-function flagUsage(name, specs) {
-    const spec = specs[name];
-    if (name === "cwd") {
-        return `-C, --cwd ${spec?.placeholder ?? "DIR"}`;
-    }
-    if (name === "detach") {
-        return "-d, --detach";
-    }
-    return spec?.kind === "value" ? `--${name} ${spec.placeholder ?? "VALUE"}` : `--${name}`;
-}
-export { CLI_COMMAND_METADATA };
-export function renderCliCommandHelp(_command, spec, flagSpecs) {
-    const lines = ["Keiyaku command help", "", `${spec.command} - ${spec.summary}`, ""];
-    section(lines, "Usage:", spec.usage);
-    section(lines, "Purpose:", [spec.purpose]);
-    section(lines, "Subcommands:", spec.subcommands);
-    section(lines, "Input:", spec.input);
-    section(lines, "Options:", spec.flags.map((name) => `${flagUsage(name, flagSpecs)}  ${spec.flagDescriptions?.[name] ?? flagSpecs[name]?.description ?? ""}`));
-    section(lines, "Notes:", spec.notes);
-    section(lines, "Examples:", spec.examples);
-    return lines.join("\n").trimEnd();
-}
-export function renderCliHelp(version) {
-    return [
-        `Keiyaku ${version}`,
-        "",
-        "Usage:",
-        "  keiyaku <command> [flags]",
-        "  keiyaku @<commission> <command> [flags]",
-        "",
-        "Flow:",
-        "  bind -> delivery work -> petition",
-        "  optional: arc -> delivery work -> arc; renew on base drift",
-        "",
-        "Commands:",
-        "  bind       Create a contract ledger and workspace files.",
-        "  arc        Optional iteration; seals current intent first.",
-        "  renew      Rewrite delivery onto the current base and seal it.",
-        "  call       Start an Akuma helper session.",
-        "  wait       Wait for an akuma projection.",
-        "  revive     Revive an Akuma helper session.",
-        "  tell       Send intent to an Akuma projection.",
-        "  kill       Stop the current Akuma generation.",
-        "  log        Render a contract ledger.",
-        "  akuma      Inspect helper profiles.",
-        "  skills     Install bundled official skills.",
-        "  amend      Record an amendment.",
-        "  petition   Run settlement processing.",
-        "  forfeit    Forfeit an addressed contract.",
-        "  guide      Print workflow guidance.",
-        "  completion Print shell completion.",
-        "  status     Render the Kanshi board.",
-        "  task       Manage lightweight repository tasks.",
-        "  dump-env   Print the environment template.",
-        "",
-        "Input:",
-        "  <> means required; [] means optional.",
-        "  bind, arc, amend, and petition read document stdin only when literal `-` selects it.",
-        "  call and tell require literal BODY or `-`; literal `-` selects stdin.",
-        "  revive accepts an artifact plus optional BODY or `-`; unselected stdin is ignored.",
-        "",
-        "Configuration:",
-        "  Akuma profiles  <KEIYAKU_HOME>/akuma/*.md or .keiyaku/akuma/*.md",
-        "  Settings        <KEIYAKU_HOME>/settings.json or .keiyaku/settings.json",
-        "  Inspect         keiyaku akuma ls | keiyaku akuma show NAME",
-        "  Environment     keiyaku dump-env",
-        "  Full format     README Configuration",
-    ].join("\n");
-}
-export function buildKeiyakuGuide(version) {
-    return [
-        `# Keiyaku Guide (v${version})`,
-        "",
-        "## Workflow",
-        "`bind -> delivery work -> petition`",
-        "optional: `arc -> delivery work -> arc`; renew on base drift",
-        "",
-        "- `bind` supplies derived default intent a0.",
-        "- `arc` is an optional iteration boundary, not admission; the first explicit arc seals a0, and later arcs seal the previous open explicit arc.",
-        "- `renew` seals the current a0 or open explicit arc after a successful refresh onto the default branch.",
-        "- `petition` seals the current a0 or open explicit arc and starts settlement.",
-        "- After an explicit arc closes, loose commits require another arc before renew or petition.",
-        "- `call` and `revive` provide helper execution without changing the ledger lifecycle.",
-        "- `skills install` installs the bundled official Keiyaku skills into supported agent skill directories; force permits replacement of foreign collisions.",
-        "- `status` is read-only and reports next actions, drift, queue state, and projections.",
-    ].join("\n");
-}
-export function commandMetadata(command) {
-    return getCommandMetadata(command);
-}