@astrosheep/keiyaku 2.9.4 → 2.9.5

package/build/cli/commands/contract/forfeit/meta.js

@@ -5,7 +5,7 @@ export const meta = {
         "keiyaku forfeit [-C|--cwd DIR] [--repo DIR] [--contract ADDR] [--reason TEXT]",
         "keiyaku @addr forfeit [-C|--cwd DIR] [--repo DIR] [--reason TEXT]",
     ],
-    stdin: "none",
+    stdin: { mode: "argument" },
     flags: ["cwd", "repo", "contract", "reason"],
     purpose: "Record an abandoned contract without sealing it.",
     completionRank: 11,

package/build/cli/commands/contract/log/meta.js

@@ -5,7 +5,7 @@ export const meta = {
         "keiyaku log [-C|--cwd DIR] [--repo DIR] [--contract ADDR]",
         "keiyaku @addr log [-C|--cwd DIR] [--repo DIR]",
     ],
-    stdin: "none",
+    stdin: { mode: "argument" },
     flags: ["cwd", "repo", "contract"],
     purpose: "Read a contract ledger.",
     completionRank: 5,

package/build/cli/commands/contract/petition/handler.js

@@ -10,13 +10,12 @@ export const handler = async (stdin, flags, signal) => {
     const cwd = await repositoryDirectory(flags, "petition");
     const address = await resolveExistingContractAddress(cwd, flags.contractId, flags.contractAddressSource, effectiveDirectory(flags));
     return await withResolvedAddress(address, async () => {
-        const input = buildPetitionClaimInput({ cwd, contractId: address.binding.commissionId, stdin, signal, waivePaths: flags.waivePaths });
+        const input = buildPetitionClaimInput({ cwd, contractId: address.binding.commissionId, stdin, signal, appendScope: flags.appendScope });
         if (flags.dryRun) {
             return buildPetitionPreviewResponse(await previewPetition({
                 cwd,
                 contractId: address.binding.commissionId,
                 oath: input.oath,
-                waivePaths: flags.waivePaths,
             }), flags.json === true);
         }
         return buildPetitionClaimResponse({ ...await petitionKeiyaku(input), address }, input);

package/build/cli/commands/contract/petition/meta.js

@@ -2,19 +2,19 @@ export const meta = {
     command: "petition",
     summary: "Run or preview the gated settlement pipeline",
     usage: [
-        "keiyaku petition [-C|--cwd DIR] [--repo DIR] [--contract ADDR] [--waive PATH] [< petition.md]",
-        "keiyaku @<id> petition [-C|--cwd DIR] [--repo DIR] [--waive PATH] [< petition.md]",
-        "keiyaku @<id> petition --dry-run [--json] [< petition.md]",
+        "keiyaku petition [-C|--cwd DIR] [--repo DIR] [--contract ADDR] [--append-scope PATTERN] [- < petition.md]",
+        "keiyaku @<id> petition [-C|--cwd DIR] [--repo DIR] [--append-scope PATTERN] [- < petition.md]",
+        "keiyaku @<id> petition --dry-run [--json] [- < petition.md]",
     ],
-    stdin: "optional",
-    flags: ["cwd", "repo", "contract", "waive", "dry-run", "json"],
+    stdin: { mode: "document", selector: { kind: "positional", index: 0, required: false, rejectBlank: false } },
+    flags: ["cwd", "repo", "contract", "append-scope", "dry-run", "json"],
     purpose: "Seal the current a0 or open explicit arc, queue the contract, and run verdict and claim processing; dry-run previews deterministic gates without mutation.",
     input: [
         "## Oath",
         "<free first-person attestation>",
     ],
     notes: [
-        "Petition stdin is optional at the command mouth; a missing, empty, or blank oath is rejected by the settlement gate with OATH_MISSING.",
+        "Petition stdin is optional and read only when literal - is supplied; a missing, empty, or blank oath is rejected by the settlement gate with OATH_MISSING.",
         "The machine checks only that the oath is present. Accepted oath text is persisted in the petition entry and hidden from the reviewer.",
         "Base drift requires explicit `keiyaku renew` before petition.",
         "Dry-run never runs verification or review and exits 0, 1, or 2.",

package/build/cli/commands/contract/renew/handler.js

@@ -10,7 +10,7 @@ export const handler = async (_stdin, flags) => {
         : resolveExistingContractAddress;
     const address = await resolveAddress(cwd, flags.contractId, flags.contractAddressSource, effectiveDirectory(flags));
     if (flags.renewContinue) {
-        return renderCoreResult(continueRenewKeiyaku({ cwd, address, waivePaths: flags.waivePaths }), buildRenewResponse);
+        return renderCoreResult(continueRenewKeiyaku({ cwd, address, appendScope: flags.appendScope }), buildRenewResponse);
     }
     if (flags.renewAbort) {
         return renderCoreResult(abortRenewKeiyaku({ cwd, address }), buildRenewAbortResponse);
@@ -18,7 +18,7 @@ export const handler = async (_stdin, flags) => {
     return renderCoreResult(renewKeiyaku({
         cwd,
         address,
-        waivePaths: flags.waivePaths,
+        appendScope: flags.appendScope,
         resolveConflicts: flags.renewResolve,
     }), buildRenewResponse);
 };

package/build/cli/commands/contract/renew/meta.js

@@ -2,12 +2,12 @@ export const meta = {
     command: "renew",
     summary: "Rewrite delivery onto the current base",
     usage: [
-        "keiyaku renew [-C|--cwd DIR] [--repo DIR] [--contract ADDR] [--waive PATH] [--resolve]",
-        "keiyaku @<id> renew --continue [--waive PATH]",
+        "keiyaku renew [-C|--cwd DIR] [--repo DIR] [--contract ADDR] [--append-scope PATTERN] [--resolve]",
+        "keiyaku @<id> renew --continue [--append-scope PATTERN]",
         "keiyaku @<id> renew --abort",
     ],
-    stdin: "none",
-    flags: ["cwd", "repo", "contract", "waive", "resolve", "continue", "abort"],
+    stdin: { mode: "argument" },
+    flags: ["cwd", "repo", "contract", "append-scope", "resolve", "continue", "abort"],
     purpose: "Capture receipts, rewrite delivery onto the default branch, then seal the current a0 or open explicit arc and record the renewal.",
     notes: [
         "After an explicit arc closes, refuses loose commits until another arc is open.",

package/build/cli/commands/metadata.js

@@ -12,6 +12,7 @@ import { meta as akumaViewMeta } from "./akuma/view/meta.js";
 import { meta as skillsMeta } from "./skills/skills/meta.js";
 import { meta as skillsInstallMeta } from "./skills/install/meta.js";
 import { meta as amendMeta } from "./contract/amend/meta.js";
+import { meta as auditMeta } from "./contract/audit/meta.js";
 import { meta as renewMeta } from "./contract/renew/meta.js";
 import { meta as petitionMeta } from "./contract/petition/meta.js";
 import { meta as forfeitMeta } from "./contract/forfeit/meta.js";
@@ -31,14 +32,14 @@ import { meta as taskDoctorMeta } from "./task/doctor/meta.js";
 import { meta as dumpEnvMeta } from "./system/dump-env/meta.js";
 export const COMMAND_METADATA_ORDER = [
     "bind", "arc", "call", "revive", "wait", "tell", "kill", "log",
-    "akuma", "akuma ls", "akuma view", "skills", "skills install", "amend",
+    "akuma", "akuma ls", "akuma view", "skills", "skills install", "amend", "audit",
     "renew", "petition", "forfeit", "guide", "completion", "status", "task",
     "task add", "task show", "task ls", "task start", "task stop", "task done",
     "task drop", "task update", "task doctor", "dump-env",
 ];
 const COMMAND_METADATA = [
     bindMeta, arcMeta, callMeta, reviveMeta, waitMeta, tellMeta, killMeta, logMeta,
-    akumaMeta, akumaLsMeta, akumaViewMeta, skillsMeta, skillsInstallMeta, amendMeta,
+    akumaMeta, akumaLsMeta, akumaViewMeta, skillsMeta, skillsInstallMeta, amendMeta, auditMeta,
     renewMeta, petitionMeta, forfeitMeta, guideMeta, completionMeta, statusMeta,
     taskMeta, taskAddMeta, taskShowMeta, taskLsMeta, taskStartMeta, taskStopMeta,
     taskDoneMeta, taskDropMeta, taskUpdateMeta, taskDoctorMeta, dumpEnvMeta,

package/build/cli/commands/projection/call/meta.js

@@ -2,7 +2,10 @@ export const meta = {
     command: "call",
     summary: "Start an Akuma helper session",
     usage: ["keiyaku call NAME [--wait DURATION] <BODY|->"],
-    stdin: "none",
+    stdin: {
+        mode: "argument",
+        selector: { kind: "positional", index: 0, required: true, rejectBlank: true },
+    },
     flags: ["cwd", "repo", "contract", "akuma", "model", "effort", "incognito", "bare", "detach", "alias", "wait"],
     purpose: "Run a scoped helper task.",
     completionRank: 2,

package/build/cli/commands/projection/kill/meta.js

@@ -5,7 +5,7 @@ export const meta = {
         "keiyaku kill <projection-address> [--wait DURATION]",
         "keiyaku @addr kill <projection-address> [--wait DURATION]",
     ],
-    stdin: "none",
+    stdin: { mode: "argument" },
     flags: ["cwd", "repo", "contract", "wait"],
     purpose: "Terminate the current generation while keeping the projection identity and tell ledger.",
 };

package/build/cli/commands/projection/revive/meta.js

@@ -2,7 +2,10 @@ export const meta = {
     command: "revive",
     summary: "Revive an Akuma helper session",
     usage: ["keiyaku revive ARTIFACT [BODY|-]"],
-    stdin: "none",
+    stdin: {
+        mode: "argument",
+        selector: { kind: "positional", index: 1, required: false, rejectBlank: true },
+    },
     flags: ["cwd", "repo", "model", "effort"],
     purpose: "Continue a persisted helper session.",
     completionRank: 4,

package/build/cli/commands/projection/status/meta.js

@@ -2,7 +2,7 @@ export const meta = {
     command: "status",
     summary: "Show the Kanshi board",
     usage: ["keiyaku status [PROJECTION] [-C|--cwd DIR] [--repo DIR] [--target REF] [--all]"],
-    stdin: "none",
+    stdin: { mode: "argument" },
     flags: ["cwd", "repo", "target", "all"],
     purpose: "Read the Kanshi board or filter it to one projection without mutation.",
     completionRank: 14,

package/build/cli/commands/projection/tell/handler.js

@@ -11,7 +11,7 @@ export const handler = async (body, flags, signal, positional) => runProjectionC
         throw new FlowError("EMPTY_PARAM", "tell requires a projection address and message");
     const projection = await resolveProjectionCommandTarget(ctx, projectionAddress, "tell");
     assertTellEffortSupported(projection.directory, flags.effort);
-    // Mailbox first: do not inspect phase before this immutable write.
+    // Address admission and any effort validation precede the durable mailbox write.
     writeInboxTell(projection.directory, body, Date.now(), { effort: flags.effort });
     await tellProjection(projection.directory, projection.id, flags.effort);
     if (flags.timeoutMs === undefined)

package/build/cli/commands/projection/tell/meta.js

@@ -2,7 +2,10 @@ export const meta = {
     command: "tell",
     summary: "Send intent to a projection mailbox",
     usage: ["keiyaku tell PROJECTION [--wait DURATION] [--] <BODY|->"],
-    stdin: "none",
+    stdin: {
+        mode: "argument",
+        selector: { kind: "positional", index: 1, required: true, rejectBlank: true },
+    },
     flags: ["cwd", "repo", "contract", "effort", "wait"],
     purpose: "Write intent to the mailbox and wake only when eligible.",
     completionRank: 3,

package/build/cli/commands/projection/wait/meta.js

@@ -7,7 +7,7 @@ export const meta = {
         "keiyaku wait <projection-address> <projection-address>... (--any|--all) [--timeout DURATION]",
         "keiyaku @addr wait [<projection-address>...] (--any|--all) [--timeout DURATION]",
     ],
-    stdin: "none",
+    stdin: { mode: "argument" },
     flags: ["cwd", "repo", "contract", "timeout", "any", "all"],
     flagDescriptions: {
         all: "For a projection set, return only after every admitted member reaches a terminal state.",

package/build/cli/commands/skills/install/meta.js

@@ -2,7 +2,7 @@ export const meta = {
     command: "skills install",
     summary: "Install the official Keiyaku skills",
     usage: ["keiyaku skills install [-f|--force]"],
-    stdin: "none",
+    stdin: { mode: "argument" },
     flags: ["force"],
     purpose: "Install the bundled official Keiyaku skills into supported agent skill directories.",
     notes: ["Force permits replacement of foreign collisions."],

package/build/cli/commands/skills/skills/meta.js

@@ -2,7 +2,7 @@ export const meta = {
     command: "skills",
     summary: "Install official skills",
     usage: ["keiyaku skills install"],
-    stdin: "none",
+    stdin: { mode: "argument" },
     flags: [],
     purpose: "Install bundled official Keiyaku skills into supported agent skill directories.",
     subcommands: ["install"],

package/build/cli/commands/system/completion/meta.js

@@ -2,7 +2,7 @@ export const meta = {
     command: "completion",
     summary: "Print shell completion",
     usage: ["keiyaku completion [--shell bash|zsh]"],
-    stdin: "none",
+    stdin: { mode: "argument" },
     flags: ["cwd", "repo", "shell", "word", "previous", "complete"],
     purpose: "Print command and address candidates.",
     completionRank: 13,

package/build/cli/commands/system/dump-env/meta.js

@@ -2,7 +2,7 @@ export const meta = {
     command: "dump-env",
     summary: "Print the environment template",
     usage: ["keiyaku dump-env"],
-    stdin: "none",
+    stdin: { mode: "argument" },
     flags: [],
     purpose: "Print supported environment keys.",
     notes: ["Keiyaku loads <KEIYAKU_HOME>/.env, then .keiyaku/.env; process environment values win."],

package/build/cli/commands/system/guide/meta.js

@@ -2,7 +2,7 @@ export const meta = {
     command: "guide",
     summary: "Print the Keiyaku guide",
     usage: ["keiyaku guide"],
-    stdin: "none",
+    stdin: { mode: "argument" },
     flags: [],
     purpose: "Print workflow guidance.",
     completionRank: 12,

package/build/cli/commands/task/add/handler.js

@@ -1,7 +1,7 @@
 import { createTask, resolveTaskCreator, } from "../../../../core/task/index.js";
 import { parseTaskAddInput, runTaskMutationCommand } from "../shared.js";
-export const handler = async (stdin, flags, _signal, positional) => {
-    const input = parseTaskAddInput(positional[0] === "-" ? stdin : positional[0]);
+export const handler = async (stdin, flags) => {
+    const input = parseTaskAddInput(stdin);
     return runTaskMutationCommand(flags, async (repository, cwd) => createTask(repository, {
         ...input,
         creator: await resolveTaskCreator(cwd),

package/build/cli/commands/task/add/meta.js

@@ -2,7 +2,10 @@ export const meta = {
     command: "task add",
     summary: "Add a task",
     usage: ["keiyaku task add [-C|--cwd DIR] [--needs ID] [--parent ID] [--from ID] [--pri 0-3] <BODY|->"],
-    stdin: "none",
+    stdin: {
+        mode: "argument",
+        selector: { kind: "positional", index: 0, required: true, rejectBlank: true },
+    },
     flags: ["cwd", "needs", "parent", "from", "pri"],
     purpose: "Create a lightweight task from a title and optional body.",
 };

package/build/cli/commands/task/doctor/meta.js

@@ -2,7 +2,7 @@ export const meta = {
     command: "task doctor",
     summary: "Diagnose the task board",
     usage: ["keiyaku task doctor [-C|--cwd DIR]"],
-    stdin: "none",
+    stdin: { mode: "argument" },
     flags: ["cwd"],
     purpose: "Report task state counts, supported board diseases, and lock state without repair.",
 };

package/build/cli/commands/task/done/meta.js

@@ -2,7 +2,7 @@ export const meta = {
     command: "task done",
     summary: "Complete a task",
     usage: ["keiyaku task done [-C|--cwd DIR] [ID]"],
-    stdin: "none",
+    stdin: { mode: "argument" },
     flags: ["cwd"],
     purpose: "Complete an open or in-progress task.",
 };

package/build/cli/commands/task/drop/meta.js

@@ -2,7 +2,7 @@ export const meta = {
     command: "task drop",
     summary: "Drop a task",
     usage: ["keiyaku task drop [-C|--cwd DIR] ID"],
-    stdin: "none",
+    stdin: { mode: "argument" },
     flags: ["cwd"],
     purpose: "Abandon an open or in-progress task.",
 };

package/build/cli/commands/task/ls/handler.js

@@ -1,11 +1,17 @@
-import { readTaskBoard } from "../../../../core/task/index.js";
-import { renderTaskList, renderTaskListJson } from "../../../render/task.js";
+import { readTaskBoard, selectTaskList } from "../../../../core/task/index.js";
+import { renderSelectedTaskList, renderSelectedTaskListJson } from "../../../render/task.js";
 import { textResponse } from "../../../render/shared.js";
 import { taskJsonText, taskSelection, withTaskCommandRepository } from "../shared.js";
 export const handler = async (_stdin, flags) => {
     const board = await withTaskCommandRepository(flags, (repository) => readTaskBoard(repository));
     const selection = taskSelection(flags);
+    const tasks = selectTaskList(board.tasks, {
+        selection,
+        filters: flags.taskFilters,
+        sort: flags.taskSort,
+        nowMs: Date.now(),
+    });
     return textResponse(flags.json
-        ? taskJsonText(renderTaskListJson(board.tasks, selection))
-        : renderTaskList(board.tasks, { selection }));
+        ? taskJsonText(renderSelectedTaskListJson(tasks))
+        : renderSelectedTaskList(tasks));
 };

package/build/cli/commands/task/ls/meta.js

@@ -1,8 +1,8 @@
 export const meta = {
     command: "task ls",
     summary: "List tasks",
-    usage: ["keiyaku task ls [-C|--cwd DIR] [--all|--done] [--json]"],
-    stdin: "none",
-    flags: ["cwd", "all", "done", "json"],
+    usage: ["keiyaku task ls [-C|--cwd DIR] [--all|--done] [--filter EXPR] [--sort KEYS] [--json]"],
+    stdin: { mode: "argument" },
+    flags: ["cwd", "all", "done", "filter", "sort", "json"],
     purpose: "List tasks from the working-tree board.",
 };

package/build/cli/commands/task/show/meta.js

@@ -2,7 +2,7 @@ export const meta = {
     command: "task show",
     summary: "Show one task and its children tree",
     usage: ["keiyaku task show [-C|--cwd DIR] ID [--json]"],
-    stdin: "none",
+    stdin: { mode: "argument" },
     flags: ["cwd", "json"],
     purpose: "Read one task and every descendant linked by parent edges.",
 };

package/build/cli/commands/task/start/meta.js

@@ -2,7 +2,7 @@ export const meta = {
     command: "task start",
     summary: "Start a task",
     usage: ["keiyaku task start [-C|--cwd DIR] ID"],
-    stdin: "none",
+    stdin: { mode: "argument" },
     flags: ["cwd"],
     purpose: "Move an open task to in_progress.",
 };

package/build/cli/commands/task/stop/meta.js

@@ -2,7 +2,7 @@ export const meta = {
     command: "task stop",
     summary: "Stop a task",
     usage: ["keiyaku task stop [-C|--cwd DIR] [ID]"],
-    stdin: "none",
+    stdin: { mode: "argument" },
     flags: ["cwd"],
     purpose: "Return an in-progress task to open.",
 };

package/build/cli/commands/task/task/meta.js

@@ -3,7 +3,7 @@ export const meta = {
     command: "task",
     summary: "Manage lightweight repository tasks",
     usage: ["keiyaku task <subcommand>"],
-    stdin: "none",
+    stdin: { mode: "argument" },
     flags: [],
     purpose: "Manage the file-backed task board.",
     subcommands: TASK_SUBCOMMANDS,

package/build/cli/commands/task/update/handler.js

@@ -1,10 +1,9 @@
 import { updateTask } from "../../../../core/task/index.js";
 import { runTaskMutationCommand } from "../shared.js";
-export const handler = async (stdin, flags, _signal, positional) => {
-    const body = flags.taskBody === "-" ? stdin : flags.taskBody;
+export const handler = async (_stdin, flags, _signal, positional) => {
     return runTaskMutationCommand(flags, (repository) => updateTask(repository, positional[0], {
         ...(flags.taskTitle === undefined ? {} : { title: flags.taskTitle }),
-        ...(body === undefined ? {} : { body }),
+        ...(flags.taskBody === undefined ? {} : { body: flags.taskBody }),
         ...(flags.taskPri === undefined ? {} : { pri: flags.taskPri }),
         ...(flags.taskNeeds === undefined ? {} : { addNeeds: flags.taskNeeds }),
         ...(flags.taskDropNeeds === undefined ? {} : { dropNeeds: flags.taskDropNeeds }),

package/build/cli/commands/task/update/meta.js

@@ -2,7 +2,10 @@ export const meta = {
     command: "task update",
     summary: "Update task facts",
     usage: ["keiyaku task update [-C|--cwd DIR] ID [--title TEXT] [--body TEXT|-] [--pri 0-3] [--needs ID] [--drop-needs ID] [--parent ID|--no-parent] [--from ID]"],
-    stdin: "none",
+    stdin: {
+        mode: "argument",
+        selector: { kind: "flag", name: "taskBody", required: false, rejectBlank: false },
+    },
     flags: ["cwd", "title", "body", "pri", "needs", "drop-needs", "parent", "no-parent", "from"],
     purpose: "Change mutable task facts.",
 };

package/build/cli/flags.js

@@ -118,10 +118,10 @@ export const FLAG_SPECS = {
         kind: "boolean",
         description: "Preview bind input or petition preflight without mutation.",
     },
-    waive: {
+    "append-scope": {
         kind: "value",
-        placeholder: "PATH",
-        description: "Allow one explicit out-of-scope path for this seal. May be repeated.",
+        placeholder: "PATTERN",
+        description: "Append one ordered scope pattern to the contract before audit. May be repeated.",
     },
     resolve: {
         kind: "boolean",
@@ -167,10 +167,25 @@ export const FLAG_SPECS = {
         kind: "boolean",
         description: "Render task 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: "FIELD OP VALUE",
+        description: "Filter structured task facts. Repeat for AND; comma-separated values are OR.",
+    },
+    sort: {
+        kind: "value",
+        placeholder: "KEY[,KEY...]",
+        description: "Sort by priority ascending, modified descending, or created descending.",
+    },
     pri: {
         kind: "value",
         placeholder: "0-3",

package/build/cli/help.js

@@ -62,9 +62,9 @@ export function renderCliHelp(version) {
         "",
         "Input:",
         "  <> means required; [] means optional.",
-        "  bind, arc, and amend read Markdown from stdin.",
-        "  call and tell require literal BODY or `-`; only literal `-` opens stdin.",
-        "  revive accepts an artifact plus optional BODY or `-`; only literal `-` opens stdin.",
+        "  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",