@astrosheep/keiyaku 2.9.4 → 2.9.6

package/build/agents/providers/pi/registration.js

@@ -109,7 +109,7 @@ export const piRegistration = {
         return loader ? { ...terms, loader } : terms;
     },
     nativePolicyOwnership: () => null,
-    startLive: async ({ terms, signal, reviveTerms, onSyncCheckpoint, onIngress }) => {
+    startLive: async ({ terms, signal, reviveTerms, onSyncCheckpoint, onSessionAdmission, onIngress }) => {
         if (terms.provider !== PI_PROVIDER) {
             throw new Error(`startLive expected ${PI_PROVIDER}`);
         }
@@ -125,6 +125,7 @@ export const piRegistration = {
                 appendSystemPromptOverride: piTerms.appendSystemPromptOverride,
                 onSyncCheckpoint,
                 onEvidence: piTerms.onEvidence,
+                onSessionAdmission,
                 onIngress,
                 initialTurn: piTerms.initialTurn,
                 loader: piTerms.loader,
@@ -137,6 +138,7 @@ export const piRegistration = {
             appendSystemPromptOverride: piTerms.appendSystemPromptOverride,
             onSyncCheckpoint,
             onEvidence: piTerms.onEvidence,
+            onSessionAdmission,
             onIngress,
             initialTurn: piTerms.initialTurn,
             loader: piTerms.loader,

package/build/agents/types.js

@@ -1,5 +1,7 @@
 export const SUBAGENT_FAILURE_CODES = [
     "SUBAGENT_TIMEOUT",
+    "SUBAGENT_TRANSPORT_ERROR",
+    "SUBAGENT_POLICY_BUDGET",
     "SUBAGENT_NON_ZERO_EXIT",
     "SUBAGENT_SPAWN_ERROR",
     "SUBAGENT_EXEC_ERROR",

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

@@ -2,7 +2,7 @@ export const meta = {
     command: "akuma",
     summary: "Inspect Akuma profiles",
     usage: ["keiyaku akuma ls|view"],
-    stdin: "none",
+    stdin: { mode: "argument" },
     flags: [],
     purpose: "Inspect configured helper profiles.",
     subcommands: ["ls", "view"],

package/build/cli/commands/akuma/list/meta-ls.js

@@ -2,7 +2,7 @@ export const meta = {
     command: "akuma ls",
     summary: "List Akuma profiles",
     usage: ["keiyaku akuma ls [-C|--cwd DIR] [--repo DIR]"],
-    stdin: "none",
+    stdin: { mode: "argument" },
     flags: ["cwd", "repo"],
     purpose: "List configured helper profiles.",
     notes: ["Project profiles override user profiles, which override builtins."],

package/build/cli/commands/akuma/view/meta.js

@@ -2,7 +2,7 @@ export const meta = {
     command: "akuma view",
     summary: "View one Akuma profile",
     usage: ["keiyaku akuma view NAME [-C|--cwd DIR] [--repo DIR]"],
-    stdin: "none",
+    stdin: { mode: "argument" },
     flags: ["cwd", "repo"],
     purpose: "Read one configured helper profile and its current nonterminal projections.",
 };

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

@@ -2,11 +2,11 @@ export const meta = {
     command: "amend",
     summary: "Record an amendment",
     usage: [
-        "keiyaku amend [-C|--cwd DIR] [--repo DIR] [--contract ADDR] < amendment.md",
-        "keiyaku @addr amend [-C|--cwd DIR] [--repo DIR] < amendment.md",
+        "keiyaku amend [-C|--cwd DIR] [--repo DIR] [--contract ADDR] - < amendment.md",
+        "keiyaku @addr amend [-C|--cwd DIR] [--repo DIR] - < amendment.md",
     ],
-    stdin: "required",
+    stdin: { mode: "document", selector: { kind: "positional", index: 0, required: true, rejectBlank: true } },
     flags: ["cwd", "repo", "contract"],
-    purpose: "Append a prose amendment and optional structured scope delta.",
+    purpose: "Append a prose amendment and optional Scope Append gitignore-pattern delta.",
     completionRank: 8,
 };

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

@@ -4,7 +4,7 @@ import { buildArcResponse } from "../../../render/arc.js";
 import { renderCoreResult } from "../../../render/shared.js";
 import { effectiveDirectory, repositoryDirectory } from "../../shared.js";
 export const handler = async (stdin, flags) => {
-    const parsed = buildArcInput(stdin, effectiveDirectory(flags), flags.waivePaths, flags.contractId, flags.contractAddressSource);
+    const parsed = buildArcInput(stdin, effectiveDirectory(flags), flags.appendScope, flags.contractId, flags.contractAddressSource);
     const cwd = await repositoryDirectory(flags, "arc");
     const address = await resolveExistingContractAddress(cwd, flags.contractId, flags.contractAddressSource, effectiveDirectory(flags));
     return renderCoreResult(arcKeiyaku({

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

@@ -2,11 +2,11 @@ export const meta = {
     command: "arc",
     summary: "Optional iteration; seals current intent first",
     usage: [
-        "keiyaku arc [-C|--cwd DIR] [--repo DIR] [--contract ADDR] [--waive PATH] < arc.md",
-        "keiyaku @addr arc [-C|--cwd DIR] [--repo DIR] [--waive PATH] < arc.md",
+        "keiyaku arc [-C|--cwd DIR] [--repo DIR] [--contract ADDR] [--append-scope PATTERN] - < arc.md",
+        "keiyaku @addr arc [-C|--cwd DIR] [--repo DIR] [--append-scope PATTERN] - < arc.md",
     ],
-    stdin: "required",
-    flags: ["cwd", "repo", "contract", "waive"],
+    stdin: { mode: "document", selector: { kind: "positional", index: 0, required: true, rejectBlank: true } },
+    flags: ["cwd", "repo", "contract", "append-scope"],
     purpose: "Optional iteration boundary: record the next title, objective, and brief, and seal the current intent first.",
     input: [
         "# <arc title>",

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

@@ -0,0 +1,16 @@
+import { auditContract } from "../../../../core/audit.js";
+import { resolveContractAddress, withResolvedAddress } from "../../../../core/addressing.js";
+import { buildAuditConstructionFailure, buildAuditResponse } from "../../../render/audit.js";
+import { effectiveDirectory, repositoryDirectory } from "../../shared.js";
+export const handler = async (_stdin, flags) => {
+    try {
+        const cwd = await repositoryDirectory(flags, "audit");
+        const address = await resolveContractAddress(cwd, flags.contractId, flags.contractAddressSource, effectiveDirectory(flags));
+        return await withResolvedAddress(address, async () => {
+            return buildAuditResponse(await auditContract({ cwd, address, diffBudgetBytes: flags.auditDiffBudgetBytes }), flags.json === true);
+        });
+    }
+    catch (error) {
+        return buildAuditConstructionFailure(error, flags.json === true);
+    }
+};

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

@@ -0,0 +1,16 @@
+export const meta = {
+    command: "audit",
+    summary: "Read settlement facts from one pinned delivery candidate",
+    usage: [
+        "keiyaku audit [-C|--cwd DIR] [--repo DIR] [--contract ADDR] [--diff-budget BYTES] [--json]",
+        "keiyaku @<id> audit [--diff-budget BYTES] [--json]",
+    ],
+    stdin: { mode: "argument" },
+    flags: ["cwd", "repo", "contract", "diff-budget", "json"],
+    purpose: "Inspect one pinned delivery candidate, report settlement facts, and recheck its coordinates without mutating the source repository.",
+    notes: [
+        "Audit never invokes an Akuma or settles the contract.",
+        "Exit 0 means the report was constructed; exit 1 carries a typed construction cause.",
+    ],
+    completionRank: 9,
+};

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

@@ -2,14 +2,14 @@ export const meta = {
     command: "bind",
     summary: "Create a contract ledger and workspace files",
     usage: [
-        "keiyaku bind [-C|--cwd DIR] [--repo DIR] [--task ID]... <<'KEIYAKU'",
+        "keiyaku bind [-C|--cwd DIR] [--repo DIR] [--task ID]... [- < contract.md]",
         "keiyaku bind [-C|--cwd DIR] [--repo DIR] [--task ID]... --place NAME --objective TEXT --scope GLOB --checks CHECK [--dry-run]",
     ],
-    stdin: "optional",
+    stdin: { mode: "document", selector: { kind: "positional", index: 0, required: false, rejectBlank: false } },
     flags: ["cwd", "repo", "after", "exclusive", "draft-only", "place", "objective", "scope", "checks", "task", "dry-run"],
     // contract is parseable only so the mouth can reject it with bind-specific copy.
     parseFlags: ["cwd", "repo", "contract", "after", "exclusive", "draft-only", "place", "objective", "scope", "checks", "task", "dry-run"],
-    purpose: "Bind a Keiyaku from contract Markdown on stdin.",
+    purpose: "Bind a Keiyaku from contract Markdown selected by literal -.",
     input: [
         "# <name>",
         "",
@@ -17,36 +17,45 @@ export const meta = {
         "<what the commission should accomplish>",
         "",
         "## Scope",
-        "- <pattern>",
+        "```",
+        "<pattern>",
+        "<another-pattern>",
+        "```",
         "",
         "## Checks",
         "- <verification>",
     ],
     notes: [
         "bind creates a contract and does not accept @addr or --contract.",
-        "Primary form is stdin Markdown (full document below).",
-        "With --task, title and body supply name/objective defaults; stdin may send only the missing sections and any present section overrides the task default.",
-        "Domain flags remain available as a full-document alternative; they cannot mix with stdin Markdown.",
+        "Primary document form is literal - followed by Markdown on stdin (full document below).",
+        "With --task, title and body supply name/objective defaults; literal - may send only the missing sections and any present section overrides the task default.",
+        "Domain flags remain available as a full-document alternative; they cannot mix with Markdown selected by literal -.",
     ],
     examples: [
         [
-            "keiyaku bind <<'KEIYAKU'",
+            "keiyaku bind - <<'KEIYAKU'",
             "# <name>",
             "",
             "## Objective",
             "<what the commission should accomplish>",
             "",
             "## Scope",
-            "- <pattern>",
+            "```",
+            "<pattern>",
+            "<another-pattern>",
+            "```",
             "",
             "## Checks",
             "- <verification>",
             "KEIYAKU",
         ].join("\n"),
         [
-            "keiyaku bind --task fix-flaky-pump <<'KEIYAKU'",
+            "keiyaku bind --task fix-flaky-pump - <<'KEIYAKU'",
             "## Scope",
-            "- <pattern>",
+            "```",
+            "<pattern>",
+            "<another-pattern>",
+            "```",
             "",
             "## Checks",
             "- <verification>",

package/build/cli/commands/contract/catalog.js

@@ -2,6 +2,7 @@ import { meta as bindMeta } from "./bind/meta.js";
 import { meta as arcMeta } from "./arc/meta.js";
 import { meta as logMeta } from "./log/meta.js";
 import { meta as amendMeta } from "./amend/meta.js";
+import { meta as auditMeta } from "./audit/meta.js";
 import { meta as renewMeta } from "./renew/meta.js";
 import { meta as petitionMeta } from "./petition/meta.js";
 import { meta as forfeitMeta } from "./forfeit/meta.js";
@@ -10,6 +11,7 @@ export const contractCatalog = [
     { meta: arcMeta, load: () => import("./arc/handler.js") },
     { meta: logMeta, load: () => import("./log/handler.js") },
     { meta: amendMeta, load: () => import("./amend/handler.js") },
+    { meta: auditMeta, load: () => import("./audit/handler.js") },
     { meta: renewMeta, load: () => import("./renew/handler.js") },
     { meta: petitionMeta, load: () => import("./petition/handler.js") },
     { meta: forfeitMeta, load: () => import("./forfeit/handler.js") },

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.",
 };