@astrosheep/keiyaku 2.9.13 → 4.0.0

package/build/cli/completion.js

@@ -1,91 +0,0 @@
-import { assertSettingsKnobUsable } from "../config/settings/disease.js";
-import { loadKeiyakuSettings } from "../config/settings/loader.js";
-import { loadAkumaCatalog } from "../config/akuma-loader.js";
-import { readRepositoryLifecycle } from "../core/repository-ledger/read-model.js";
-import { TASK_FILTER_COMPLETION } from "../core/task/query.js";
-import { allCommandMetadata, getCommandMetadata } from "./commands/metadata.js";
-function topLevelCommands() {
-    return allCommandMetadata()
-        .filter((meta) => meta.completionRank !== undefined)
-        .slice()
-        .sort((a, b) => {
-        const rankDelta = (a.completionRank ?? 0) - (b.completionRank ?? 0);
-        if (rankDelta !== 0)
-            return rankDelta;
-        return a.command < b.command ? -1 : a.command > b.command ? 1 : 0;
-    })
-        .map((meta) => meta.command);
-}
-function subcommandsFor(parent) {
-    return [...(getCommandMetadata(parent).subcommands ?? [])];
-}
-function optionsForCommandContext(context) {
-    const metadata = allCommandMetadata().find((meta) => meta.command === context);
-    return metadata ? metadata.flags.map((flag) => `--${flag}`) : [];
-}
-function filterPrefix(items, word) {
-    return items.filter((item) => item.startsWith(word));
-}
-async function contractAddressCandidates(cwd, word) {
-    const read = await readRepositoryLifecycle(cwd);
-    return filterPrefix(read.contracts.map((model) => `@${model.contract}`), word);
-}
-async function akumaCandidates(cwd, word) {
-    const loaded = await loadKeiyakuSettings(cwd);
-    assertSettingsKnobUsable(loaded, "agents");
-    return filterPrefix(Object.keys((await loadAkumaCatalog(cwd)).selected), word);
-}
-export async function renderCompletionCandidates(input) {
-    const word = input.word ?? "";
-    if (word.startsWith("@")) {
-        return (await contractAddressCandidates(input.cwd, word)).join("\n");
-    }
-    const previous = input.previous ?? "";
-    const previousWord = previous.split(/\s+/).at(-1) ?? "";
-    if (previous === "call") {
-        return filterPrefix([...(await akumaCandidates(input.cwd, word)), "--alias"], word).join("\n");
-    }
-    if (previous === "akuma") {
-        return filterPrefix(subcommandsFor("akuma"), word).join("\n");
-    }
-    if (previous === "skills") {
-        return filterPrefix(subcommandsFor("skills"), word).join("\n");
-    }
-    if (previous === "task") {
-        return filterPrefix(subcommandsFor("task"), word).join("\n");
-    }
-    if (previousWord === "--filter") {
-        return filterPrefix([TASK_FILTER_COMPLETION], word).join("\n");
-    }
-    const options = previous ? optionsForCommandContext(previous) : [];
-    if (options.length > 0) {
-        return filterPrefix(options, word).join("\n");
-    }
-    return filterPrefix(topLevelCommands(), word).join("\n");
-}
-export function renderCompletionScript(shell = "bash") {
-    if (shell === "zsh") {
-        return [
-            "#compdef keiyaku",
-            "_keiyaku() {",
-            "  local -a candidates context",
-            "  context=\"${(j: :)words[2,CURRENT-1]}\"",
-            "  candidates=(${(f)\"$(keiyaku completion --complete --word=\"${words[CURRENT]}\" --previous=\"${context}\" 2>/dev/null)\"})",
-            "  compadd -- $candidates",
-            "}",
-            "_keiyaku \"$@\"",
-        ].join("\n");
-    }
-    return [
-        "_keiyaku_completion() {",
-        "  local cur context",
-        "  cur=\"${COMP_WORDS[COMP_CWORD]}\"",
-        "  context=\"${COMP_WORDS[*]:1:$((COMP_CWORD - 1))}\"",
-        "  COMPREPLY=()",
-        "  while IFS= read -r candidate; do",
-        "    COMPREPLY+=(\"$candidate\")",
-        "  done < <(keiyaku completion --complete --word=\"$cur\" --previous=\"$context\" 2>/dev/null)",
-        "}",
-        "complete -F _keiyaku_completion keiyaku",
-    ].join("\n");
-}

package/build/cli/draft-artifact.js

@@ -1,50 +0,0 @@
-import * as fs from "fs/promises";
-import * as path from "path";
-import { DRAFT_ARTIFACT_NOTICE, KEIYAKU_DRAFT_DIR } from "../keiyaku.js";
-const DRAFT_SLUG_FALLBACK = "keiyaku-draft";
-function normalizeDraftRelativePath(relativePath) {
-    return relativePath.split(path.sep).join("/");
-}
-function formatDraftTimestamp(now) {
-    const year = String(now.getFullYear());
-    const month = String(now.getMonth() + 1).padStart(2, "0");
-    const day = String(now.getDate()).padStart(2, "0");
-    const hour = String(now.getHours()).padStart(2, "0");
-    const minute = String(now.getMinutes()).padStart(2, "0");
-    const second = String(now.getSeconds()).padStart(2, "0");
-    return `${year}${month}${day}-${hour}${minute}${second}`;
-}
-function toDraftSlug(title) {
-    const normalized = title
-        .trim()
-        .toLowerCase()
-        .replace(/[^\p{Script=Han}a-z0-9]+/gu, "-")
-        .replace(/-+/g, "-")
-        .replace(/^-+/, "")
-        .replace(/-+$/, "");
-    return normalized || DRAFT_SLUG_FALLBACK;
-}
-function buildDraftArtifactRelativePath(title, now = new Date()) {
-    const filename = `${formatDraftTimestamp(now)}_${toDraftSlug(title)}.md`;
-    return normalizeDraftRelativePath(path.join(KEIYAKU_DRAFT_DIR, filename));
-}
-function buildDraftArtifactMarkdown(content, now) {
-    return [
-        "---",
-        "generated_by: keiyaku",
-        "type: draft",
-        `time: '${now.toISOString()}'`,
-        `notice: '${DRAFT_ARTIFACT_NOTICE}'`,
-        "---",
-        "",
-        content,
-    ].join("\n");
-}
-export async function writeDraftArtifact(input) {
-    const now = input.now ?? new Date();
-    const relativePath = buildDraftArtifactRelativePath(input.title, now);
-    const absolutePath = path.join(input.cwd, relativePath);
-    await fs.mkdir(path.dirname(absolutePath), { recursive: true });
-    await fs.writeFile(absolutePath, buildDraftArtifactMarkdown(input.content, now), "utf-8");
-    return relativePath;
-}

package/build/cli/flags.js

@@ -1,321 +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).",
-    },
-    entry: {
-        kind: "value",
-        placeholder: "N",
-        description: "Select one zero-based retained history entry from an addressed projection.",
-    },
-    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 fork.",
-    },
-    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.",
-    },
-    audit: {
-        kind: "boolean",
-        description: "Run the ordinary read-only audit after a completed renew.",
-    },
-    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.",
-    },
-    limit: {
-        kind: "value",
-        placeholder: "COUNT",
-        description: "Limit terminal rows in the Akuma roster.",
-    },
-    offset: {
-        kind: "value",
-        placeholder: "COUNT",
-        description: "Skip terminal rows in the Akuma roster.",
-    },
-    raw: {
-        kind: "boolean",
-        description: "Include retained raw event bodies when inspecting one history entry.",
-    },
-    "diff-budget": {
-        kind: "value",
-        placeholder: "BYTES",
-        description: "Set the audit raw-diff presentation budget in bytes.",
-    },
-    "skip-diff-body": {
-        kind: "boolean",
-        description: "Suppress raw diff hunk bodies from the human audit presentation without changing audit evidence or checks.",
-    },
-    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: 0 (highest) through 3 (lowest).",
-    },
-    needs: {
-        kind: "value",
-        placeholder: "ID",
-        description: "Order execution: this task needs another task first. May be repeated.",
-    },
-    "drop-needs": {
-        kind: "value",
-        placeholder: "ID",
-        description: "Remove an execution-ordering dependency. May be repeated.",
-    },
-    parent: {
-        kind: "value",
-        placeholder: "ID",
-        description: "Organize task hierarchy under a parent task.",
-    },
-    "no-parent": {
-        kind: "boolean",
-        description: "Clear the hierarchy parent task.",
-    },
-    from: {
-        kind: "value",
-        placeholder: "ID",
-        description: "Record work discovered while doing another task. May be repeated.",
-    },
-    supersedes: {
-        kind: "value",
-        placeholder: "ID",
-        description: "Record that this task replaces another task. May be repeated.",
-    },
-    "drop-supersedes": {
-        kind: "value",
-        placeholder: "ID",
-        description: "Remove a replacement relation. May be repeated.",
-    },
-    "relates-to": {
-        kind: "value",
-        placeholder: "ID",
-        description: "Record a thematic relation without ordering or replacement. May be repeated.",
-    },
-    "drop-relates-to": {
-        kind: "value",
-        placeholder: "ID",
-        description: "Remove a thematic 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.",
-    },
-    note: {
-        kind: "value",
-        placeholder: "TEXT|-",
-        description: "Append an immutable task note; 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,99 +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) => `${spec.flagUsages?.[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 -> make and commit changes -> petition",
-        "  optional: arc -> make and commit changes -> arc; renew when the target moves",
-        "",
-        "Commands:",
-        "  bind       Create a contract and its workspace.",
-        "  arc        Seal the current stage and begin another.",
-        "  renew      Refresh committed changes onto the contract target.",
-        "  call       Start an Akuma projection.",
-        "  wait       Wait for a projection.",
-        "  fork       Start a projection from a response artifact.",
-        "  tell       Send a message to a projection.",
-        "  kill       Stop a projection's active run.",
-        "  log        Show a contract history.",
-        "  akuma      Inspect available Akuma definitions.",
-        "  skills     Install bundled official skills.",
-        "  amend      Record an amendment.",
-        "  petition   Ask Keiyaku to settle a contract.",
-        "  forfeit    End a contract without claiming it.",
-        "  guide      Print workflow guidance.",
-        "  completion Print shell completion.",
-        "  status     Show contracts, tasks, and projections that need attention.",
-        "  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.",
-        "  fork accepts an artifact plus optional BODY or `-`; unselected stdin is ignored.",
-        "",
-        "Configuration:",
-        "  Akuma definitions  <KEIYAKU_HOME>/akuma/*.md or .keiyaku/akuma/*.md",
-        "  Settings        <KEIYAKU_HOME>/settings.json or .keiyaku/settings.json",
-        "  Inspect         keiyaku akuma list | keiyaku akuma show NAME",
-        "  Environment     keiyaku dump-env",
-        "  Full format     README Configuration",
-    ].join("\n");
-}
-export function buildKeiyakuGuide(version) {
-    return [
-        `# Keiyaku Guide (v${version})`,
-        "",
-        "A task is a planning item: it does not create a workspace or start work.",
-        "A contract is one bounded delivery with its own workspace. It begins bound and ends claimed when settlement lands it, or forfeited when it is ended without a claim.",
-        "An Akuma is a callable worker definition. A projection is one run of an Akuma.",
-        "",
-        "`bind -> make and commit changes -> petition`",
-        "",
-        "Binding a contract establishes its first delivery stage. A `seal` records that stage's committed changes and scope at a lifecycle boundary.",
-        "`arc` is an optional boundary: it seals the current stage and opens the next. Use arcs only for successive stages of one contract and one final settlement; they do not create separately claimable work.",
-        "When the contract target moves, `renew` refreshes the committed changes onto it and seals the refreshed current stage.",
-        "`petition` seals the current stage, runs the contract's settlement checks, and claims the contract only when they pass. If a settlement gate fails, the contract is not claimed; address the reported problem and petition again.",
-        "Use separate tasks and contracts for work with separate acceptance, ownership, or waiting needs. `status` shows the work that needs attention.",
-    ].join("\n");
-}
-export function commandMetadata(command) {
-    return getCommandMetadata(command);
-}