@astrosheep/keiyaku 2.8.1 → 2.8.2

package/build/cli/help.js

@@ -14,6 +14,7 @@ export const CLI_COMMAND_METADATA = {
     revive: command("revive", "Revive an Akuma helper session", ["keiyaku revive ARTIFACT_ID"], "none", ["cwd", "repo", "model", "effort"], "Continue a persisted helper session."),
     wait: command("wait", "Wait for an akuma projection", ["keiyaku wait <projection-address> [--timeout DURATION]", "keiyaku @addr wait <projection-address> [--timeout DURATION]"], "none", ["cwd", "repo", "contract", "timeout"], "Read an akuma projection until its outcome is available, or show a timeout snapshot."),
     tell: command("tell", "Send intent to a projection mailbox", ["keiyaku tell [--effort LEVEL] PROJECTION MESSAGE", "keiyaku @addr tell [--effort LEVEL] PROJECTION MESSAGE"], "none", ["cwd", "repo", "contract", "effort"], "Write intent to the mailbox and wake only when eligible."),
+    kill: command("kill", "Stop the current projection generation", ["keiyaku kill <projection-address>", "keiyaku @addr kill <projection-address>"], "none", ["cwd", "repo", "contract"], "Terminate the current generation while keeping the projection identity and tell ledger."),
     log: command("log", "Render a contract ledger", ["keiyaku log [-C|--cwd DIR] [--repo DIR] [--contract ADDR]", "keiyaku @addr log [-C|--cwd DIR] [--repo DIR]"], "none", ["cwd", "repo", "contract"], "Read a contract ledger."),
     akuma: command("akuma", "Inspect Akuma profiles", ["keiyaku akuma list|show"], "none", [], "Inspect configured helper profiles.", {
         subcommands: ["list", "ls", "show"],
@@ -84,6 +85,7 @@ export function renderCliHelp(version) {
         "  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.",

package/build/cli/index.js

@@ -35,6 +35,7 @@ import { buildBindDraftResponse, buildBindResponse, buildForfeitResponse, format
 import { buildCallResponse, renderAdoptedLaunchReceipt } from "./render/call.js";
 import { projectionDir, writeInboxTell } from "../core/projection-core.js";
 import { assertTellEffortSupported, tellProjection } from "../core/projection-wake.js";
+import { killProjectionGeneration } from "../core/projection-kill.js";
 import { resolveProjectionAddress } from "./projection-address.js";
 import { waitForProjection } from "../core/projection-wait.js";
 import { buildWaitResponse } from "./render/wait.js";
@@ -233,6 +234,27 @@ const CLI_COMMAND_SPECS = {
         };
         return address ? await withResolvedAddress(address, operation) : await operation();
     }),
+    kill: commandSpec("kill", async (_stdin, flags, _signal, positional) => {
+        const cwd = flags.contractId ? await repositoryDirectory(flags) : await projectDirectory(flags);
+        const [projectionAddress] = positional;
+        if (!projectionAddress)
+            throw new FlowError("EMPTY_PARAM", "kill requires a projection address");
+        const address = flags.contractId ? await resolveContractAddress(cwd, flags.contractId, flags.contractAddressSource) : undefined;
+        const operation = async () => {
+            const projection = await resolveProjectionAddress({
+                cwd,
+                address: projectionAddress,
+                scope: address,
+                verb: "kill",
+            });
+            const result = killProjectionGeneration(projectionDir(cwd, projection.id));
+            const line = result.status === "killed"
+                ? `× killed ${projection.id}`
+                : `· already resting ${projection.id}`;
+            return textResponse(line);
+        };
+        return address ? await withResolvedAddress(address, operation) : await operation();
+    }),
     log: commandSpec("log", async (_stdin, flags) => {
         const cwd = await repositoryDirectory(flags);
         const address = await resolveContractAddress(cwd, flags.contractId, flags.contractAddressSource);

package/build/cli/parse.js

@@ -9,6 +9,7 @@ const COMMISSION_SELECTOR_COMMANDS = new Set([
     "call",
     "wait",
     "tell",
+    "kill",
     "log",
     "renew",
     "petition",
@@ -21,6 +22,7 @@ const CLI_COMMAND_ORDER = [
     "revive",
     "wait",
     "tell",
+    "kill",
     "log",
     "akuma list",
     "akuma ls",
@@ -45,6 +47,7 @@ const COMMAND_FLAGS = {
     revive: ["cwd", "repo", "model", "effort"],
     wait: ["cwd", "repo", "contract", "timeout"],
     tell: ["cwd", "repo", "contract", "effort"],
+    kill: ["cwd", "repo", "contract"],
     log: ["cwd", "repo", "contract"],
     akuma: [],
     "akuma ls": ["cwd", "repo"],
@@ -99,6 +102,8 @@ export function commandPositionalRange(command) {
         return { min: 1, max: 1, label: "<projection-address>" };
     if (command === "tell")
         return { min: 2, max: 2, label: "<projection> <message>" };
+    if (command === "kill")
+        return { min: 1, max: 1, label: "<projection-address>" };
     if (isCallCommand(command))
         return { min: 0, max: 1 };
     return { min: 0, max: 0 };

package/build/core/projection-kill.js

@@ -0,0 +1,26 @@
+import { openProjectionGenerationStore } from "./projection-generation-store.js";
+export function killProjectionGeneration(projectionDirectory, nowMs = Date.now()) {
+    const store = openProjectionGenerationStore(projectionDirectory);
+    try {
+        const current = store.readCurrentGeneration();
+        if (!current)
+            return { status: "already-resting" };
+        if (current.verdict) {
+            return { status: "already-resting", executionId: current.launch.executionId };
+        }
+        const transition = store.verdictIfOpen({
+            executionId: current.launch.executionId,
+            verdict: "completed",
+            facts: {
+                operatorAction: "kill",
+                killedAt: new Date(nowMs).toISOString(),
+            },
+        });
+        return transition.status === "committed"
+            ? { status: "killed", executionId: current.launch.executionId }
+            : { status: "already-resting", executionId: current.launch.executionId };
+    }
+    finally {
+        store.close();
+    }
+}

package/build/core/projection-wake.js

@@ -116,6 +116,9 @@ export async function tellProjection(projectionDirectory, effort) {
                 ? await startCommittedSuccessor(projectionDirectory, successorExecutionId)
                 : "pending";
         }
+        if (life.phase !== "done") {
+            return "pending";
+        }
         const transition = store.launchIfSettled({
             executionId: successorExecutionId,
             facts,

package/build/generated/version.js

@@ -1,2 +1,2 @@
 // Auto-generated by scripts/generate-version.mjs
-export const VERSION = "2.8.1";
+export const VERSION = "2.8.2";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astrosheep/keiyaku",
-  "version": "2.8.1",
+  "version": "2.8.2",
   "description": "CLI for running iterative keiyaku workflows with Codex subagents.",
   "license": "MIT",
   "type": "module",