@kosuke-ai/kosuke 1.0.47 → 1.0.48

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## 1.0.48
+
+- Command names from before the command grammar no longer run; `kosuke <group> --help` lists the current ones. The MCP server refuses the former toolsets too: a client that requests `deploy`, `members` or `personal-tasks` now gets HTTP 400 and must switch its configuration to `deploys`, `workspaces` or `tasks`. The `user` and `workspaces` toolsets no longer include the tools that moved to `crons`, `files`, `integrations`, `plugins`, `providers`, `sensei` and `skills`: request those toolsets instead.
+- Add `kosuke sensei threads create`, which lets Sensei open a new thread with its own Turn from any point of a Turn.
+- Add `kosuke sessions env sync` to deliver a project's current environment variables to a running session sandbox and restart its services.
+- `kosuke sessions skill-runs --help` now lists every `--result` value `finish` accepts. A marker it rejects, such as `--result pass`, still exits 0 and sends nothing, but prints one line on stderr saying it was not recorded and why.
+
 ## 1.0.47
 
 - `kosuke deploys queue steer` now steers on any deploy model whose runtime takes a steer, not Claude only.

package/README.md

@@ -40,10 +40,14 @@ kosuke sessions skill-runs finish kosuke:ship --result ready
 
 The sandbox supplies the session identity and its Turn credential. The server selects the
 running Chat Job. These commands accept only known switch names and result values, never
-free text. A child skill starts inside its parent and ends before the parent resumes.
+free text. `--result` takes one of `passed`, `failed`, `blocked`, `skipped`, `prototype`,
+`question`, `ready`, `cancelled` or `open_items`, and `--help` lists them. A child skill
+starts inside its parent and ends before the parent resumes.
 
 Markers are best effort: one request, a 1.5-second deadline, no retry, and exit status zero
-even for invalid input or a tracking failure. They print no success message. Without the
+even for invalid input or a tracking failure. They print no success message. Input they
+reject sends nothing and prints one line on stderr saying the marker was not recorded and
+why, without repeating the input. Without the
 main-agent marker context, they send no request. Delegated Runs do not record markers.
 Other commands keep their normal error exit codes. `sessions skill-runs --capabilities`
 prints `skill-markers-v1` without credentials, so an older CLI never receives an unsupported rule.

package/dist/commands/skill-runs.js

@@ -31,6 +31,13 @@ const RESULTS = new Set([
 ]);
 const UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
 const DEADLINE_MS = 1500;
+const RESULT_CHOICES = [...RESULTS].join('|');
+// `run` answers --help before Commander, so this is the only help an agent reads: it names
+// every result, or an agent following it must guess one.
+const USAGE = `kosuke sessions skill-runs start <name> [--fix] [--sync] [--no-review]
+kosuke sessions skill-runs finish <name> [--result ${RESULT_CHOICES}]
+Best effort: one request, 1.5-second deadline, always exits 0.
+`;
 async function appendMarker(path, value) {
     try {
         const stat = await lstat(path).catch(() => null);
@@ -91,37 +98,49 @@ export async function runSkillMarkerCommand(args, options = {}) {
     const [group, noun] = HAND_WRITTEN.sessionsSkillRuns.command;
     if (args[0] !== group || args[1] !== noun)
         return false;
-    const { env = process.env, fetch: request = globalThis.fetch, stdout = (text) => process.stdout.write(text), timeoutMs = DEADLINE_MS, } = options;
+    const { env = process.env, fetch: request = globalThis.fetch, stdout = (text) => process.stdout.write(text), stderr = (line) => process.stderr.write(line + '\n'), timeoutMs = DEADLINE_MS, } = options;
+    // Still exit 0, but say why, so an agent can correct a rejected marker. Never echo the input:
+    // it may be free text.
+    const notRecorded = (why) => {
+        try {
+            stderr(`kosuke: skill marker not recorded: ${why}. See kosuke sessions skill-runs --help.`);
+        }
+        catch {
+            // Reporting is best effort too.
+        }
+        return true;
+    };
     if (args.length === 3 && args[2] === '--capabilities') {
         stdout('skill-markers-v1\n');
         return true;
     }
     if (args.includes('--help') || args.includes('-h')) {
-        stdout('kosuke sessions skill-runs start <name> [--fix] [--sync] [--no-review]\nkosuke sessions skill-runs finish <name> [--result <verdict>]\nBest effort: one request, 1.5-second deadline, always exits 0.\n');
+        stdout(USAGE);
         return true;
     }
     const [, , verb, rawName, ...rest] = args;
-    // Alias: `end`, the verb before the grammar, which older Factory Skills still run.
-    const action = verb === 'finish' || verb === 'end' ? 'end' : verb;
-    if ((action !== 'start' && action !== 'end') ||
-        !rawName ||
-        !/^(?:kosuke:)?[a-z][a-z0-9-]{0,79}$/.test(rawName))
-        return true;
+    if (verb !== 'start' && verb !== 'finish')
+        return notRecorded('use start or finish');
+    if (!rawName || !/^(?:kosuke:)?[a-z][a-z0-9-]{0,79}$/.test(rawName))
+        return notRecorded('give a skill name, such as kosuke:ship');
     const flags = [];
+    const action = verb === 'finish' ? 'end' : 'start';
     let result;
     for (let index = 0; index < rest.length; index++) {
         const value = rest[index];
         if (value === '--result' && action === 'end' && result === undefined) {
             result = rest[++index];
             if (!result || !RESULTS.has(result))
-                return true;
+                return notRecorded(`--result takes one of ${RESULT_CHOICES}`);
         }
         else if (FLAGS.has(value)) {
             if (!flags.includes(value))
                 flags.push(value);
         }
+        else if (value === '--result')
+            return notRecorded(action === 'start' ? 'only finish takes --result' : '--result is given once');
         else
-            return true;
+            return notRecorded('an argument is not a known switch');
     }
     const bridge = env.KOSUKE_SKILL_MARKER_FILE;
     const clockId = env.KOSUKE_SKILL_CLOCK_ID;
@@ -225,7 +244,7 @@ export function attachSkillMarkerCommands(program, options = {}) {
         for (const flag of FLAGS)
             command.option(flag);
         if (action === 'finish')
-            command.option('--result <verdict>', 'A known result, such as passed, failed, blocked, or ready.');
+            command.option('--result <verdict>', `One known result: ${RESULT_CHOICES}.`);
         command.action(async (_name, _flags, cmd) => {
             await runSkillMarkerCommand(cmd.parent.parent.parent.args, options);
         });

package/dist/generated/commands/index.js

@@ -229,113 +229,115 @@ import { operation as o227 } from './sensei/sessions-assessments-create.js';
 import { operation as o228 } from './sensei/sessions-facts-get.js';
 import { operation as o229 } from './sensei/suggestions-create.js';
 import { operation as o230 } from './sensei/threads-close.js';
-import { operation as o231 } from './sensei/threads-get.js';
-import { operation as o232 } from './sensei/threads-list.js';
-import { operation as o233 } from './sensei/threads-move.js';
-import { operation as o234 } from './sensei/threads-split.js';
-import { operation as o235 } from './sensei/tickets-merge.js';
-import { operation as o236 } from './sensei/watch-reads-finish.js';
-import { operation as o237 } from './sensei/widgets-get.js';
-import { operation as o238 } from './sensei/writing-get.js';
-import { operation as o239 } from './sensei/writing-set.js';
-import { operation as o240 } from './sensei/writing-samples-create.js';
-import { operation as o241 } from './sessions/app-stack-start.js';
-import { operation as o242 } from './sessions/artifacts-create.js';
-import { operation as o243 } from './sessions/artifacts-get.js';
-import { operation as o244 } from './sessions/artifacts-list.js';
-import { operation as o245 } from './sessions/create.js';
-import { operation as o246 } from './sessions/delete.js';
-import { operation as o247 } from './sessions/desktop-control-set.js';
-import { operation as o248 } from './sessions/desktop-get.js';
-import { operation as o249 } from './sessions/desktop-start.js';
-import { operation as o250 } from './sessions/diff-comments-create.js';
-import { operation as o251 } from './sessions/diff-comments-delete.js';
-import { operation as o252 } from './sessions/diff-comments-list.js';
-import { operation as o253 } from './sessions/diff-comments-update.js';
-import { operation as o254 } from './sessions/diff-commits-list.js';
-import { operation as o255 } from './sessions/diff-files-list.js';
-import { operation as o256 } from './sessions/diff-patch-get.js';
-import { operation as o257 } from './sessions/files-get.js';
-import { operation as o258 } from './sessions/files-list.js';
-import { operation as o259 } from './sessions/files-set.js';
-import { operation as o260 } from './sessions/get.js';
-import { operation as o261 } from './sessions/git-state-get.js';
-import { operation as o262 } from './sessions/go-ahead-delete.js';
-import { operation as o263 } from './sessions/go-ahead-set.js';
-import { operation as o264 } from './sessions/jobs-cancel.js';
-import { operation as o265 } from './sessions/jobs-get.js';
-import { operation as o266 } from './sessions/jobs-list.js';
-import { operation as o267 } from './sessions/labels-set.js';
-import { operation as o268 } from './sessions/labels-update.js';
-import { operation as o269 } from './sessions/list.js';
-import { operation as o270 } from './sessions/list--all.js';
-import { operation as o271 } from './sessions/mark-read.js';
-import { operation as o272 } from './sessions/messages-get.js';
-import { operation as o273 } from './sessions/messages-list.js';
-import { operation as o274 } from './sessions/prompt-update.js';
-import { operation as o275 } from './sessions/qa-runs-finish.js';
-import { operation as o276 } from './sessions/qa-runs-fixes-create.js';
-import { operation as o277 } from './sessions/qa-runs-get.js';
-import { operation as o278 } from './sessions/qa-runs-results-create.js';
-import { operation as o279 } from './sessions/qa-runs-start.js';
-import { operation as o280 } from './sessions/qa-runs-stop.js';
-import { operation as o281 } from './sessions/qa-set.js';
-import { operation as o282 } from './sessions/queue-delete.js';
-import { operation as o283 } from './sessions/queue-list.js';
-import { operation as o284 } from './sessions/queue-move.js';
-import { operation as o285 } from './sessions/queue-resume.js';
-import { operation as o286 } from './sessions/queue-send.js';
-import { operation as o287 } from './sessions/queue-steer.js';
-import { operation as o288 } from './sessions/queue-update.js';
-import { operation as o289 } from './sessions/review-set.js';
-import { operation as o290 } from './sessions/runtime-commands-run.js';
-import { operation as o291 } from './sessions/search.js';
-import { operation as o292 } from './sessions/send.js';
-import { operation as o293 } from './sessions/start.js';
-import { operation as o294 } from './sessions/steer.js';
-import { operation as o295 } from './sessions/update.js';
-import { operation as o296 } from './skills/create.js';
-import { operation as o297 } from './skills/create--personal.js';
-import { operation as o298 } from './skills/delete.js';
-import { operation as o299 } from './skills/delete--personal.js';
-import { operation as o300 } from './skills/get.js';
-import { operation as o301 } from './skills/get--personal.js';
-import { operation as o302 } from './skills/list.js';
-import { operation as o303 } from './skills/list--personal.js';
-import { operation as o304 } from './skills/update.js';
-import { operation as o305 } from './skills/update--personal.js';
-import { operation as o306 } from './tasks/create.js';
-import { operation as o307 } from './tasks/create--personal.js';
-import { operation as o308 } from './tasks/delete.js';
-import { operation as o309 } from './tasks/delete--personal.js';
-import { operation as o310 } from './tasks/get.js';
-import { operation as o311 } from './tasks/get--personal.js';
-import { operation as o312 } from './tasks/labels-list.js';
-import { operation as o313 } from './tasks/list.js';
-import { operation as o314 } from './tasks/list--all.js';
-import { operation as o315 } from './tasks/list--personal.js';
-import { operation as o316 } from './tasks/move.js';
-import { operation as o317 } from './tasks/move--personal.js';
-import { operation as o318 } from './tasks/start.js';
-import { operation as o319 } from './tasks/start--personal.js';
-import { operation as o320 } from './tasks/update.js';
-import { operation as o321 } from './tasks/update--personal.js';
-import { operation as o322 } from './user/api-keys-delete.js';
-import { operation as o323 } from './user/profile-get.js';
-import { operation as o324 } from './user/push-devices-create.js';
-import { operation as o325 } from './user/push-devices-delete.js';
-import { operation as o326 } from './user/usage-get.js';
-import { operation as o327 } from './workspaces/artifacts-search.js';
-import { operation as o328 } from './workspaces/credits-get.js';
-import { operation as o329 } from './workspaces/get.js';
-import { operation as o330 } from './workspaces/list.js';
-import { operation as o331 } from './workspaces/members-list.js';
-import { operation as o332 } from './workspaces/members-list--all.js';
-import { operation as o333 } from './workspaces/sandbox-limit-get.js';
-import { operation as o334 } from './workspaces/sandboxes-stop.js';
-import { operation as o335 } from './workspaces/timezone-set.js';
-import { operation as o336 } from './workspaces/usage-breakdown-get.js';
-import { operation as o337 } from './workspaces/usage-get.js';
+import { operation as o231 } from './sensei/threads-create.js';
+import { operation as o232 } from './sensei/threads-get.js';
+import { operation as o233 } from './sensei/threads-list.js';
+import { operation as o234 } from './sensei/threads-move.js';
+import { operation as o235 } from './sensei/threads-split.js';
+import { operation as o236 } from './sensei/tickets-merge.js';
+import { operation as o237 } from './sensei/watch-reads-finish.js';
+import { operation as o238 } from './sensei/widgets-get.js';
+import { operation as o239 } from './sensei/writing-get.js';
+import { operation as o240 } from './sensei/writing-set.js';
+import { operation as o241 } from './sensei/writing-samples-create.js';
+import { operation as o242 } from './sessions/app-stack-start.js';
+import { operation as o243 } from './sessions/artifacts-create.js';
+import { operation as o244 } from './sessions/artifacts-get.js';
+import { operation as o245 } from './sessions/artifacts-list.js';
+import { operation as o246 } from './sessions/create.js';
+import { operation as o247 } from './sessions/delete.js';
+import { operation as o248 } from './sessions/desktop-control-set.js';
+import { operation as o249 } from './sessions/desktop-get.js';
+import { operation as o250 } from './sessions/desktop-start.js';
+import { operation as o251 } from './sessions/diff-comments-create.js';
+import { operation as o252 } from './sessions/diff-comments-delete.js';
+import { operation as o253 } from './sessions/diff-comments-list.js';
+import { operation as o254 } from './sessions/diff-comments-update.js';
+import { operation as o255 } from './sessions/diff-commits-list.js';
+import { operation as o256 } from './sessions/diff-files-list.js';
+import { operation as o257 } from './sessions/diff-patch-get.js';
+import { operation as o258 } from './sessions/env-sync.js';
+import { operation as o259 } from './sessions/files-get.js';
+import { operation as o260 } from './sessions/files-list.js';
+import { operation as o261 } from './sessions/files-set.js';
+import { operation as o262 } from './sessions/get.js';
+import { operation as o263 } from './sessions/git-state-get.js';
+import { operation as o264 } from './sessions/go-ahead-delete.js';
+import { operation as o265 } from './sessions/go-ahead-set.js';
+import { operation as o266 } from './sessions/jobs-cancel.js';
+import { operation as o267 } from './sessions/jobs-get.js';
+import { operation as o268 } from './sessions/jobs-list.js';
+import { operation as o269 } from './sessions/labels-set.js';
+import { operation as o270 } from './sessions/labels-update.js';
+import { operation as o271 } from './sessions/list.js';
+import { operation as o272 } from './sessions/list--all.js';
+import { operation as o273 } from './sessions/mark-read.js';
+import { operation as o274 } from './sessions/messages-get.js';
+import { operation as o275 } from './sessions/messages-list.js';
+import { operation as o276 } from './sessions/prompt-update.js';
+import { operation as o277 } from './sessions/qa-runs-finish.js';
+import { operation as o278 } from './sessions/qa-runs-fixes-create.js';
+import { operation as o279 } from './sessions/qa-runs-get.js';
+import { operation as o280 } from './sessions/qa-runs-results-create.js';
+import { operation as o281 } from './sessions/qa-runs-start.js';
+import { operation as o282 } from './sessions/qa-runs-stop.js';
+import { operation as o283 } from './sessions/qa-set.js';
+import { operation as o284 } from './sessions/queue-delete.js';
+import { operation as o285 } from './sessions/queue-list.js';
+import { operation as o286 } from './sessions/queue-move.js';
+import { operation as o287 } from './sessions/queue-resume.js';
+import { operation as o288 } from './sessions/queue-send.js';
+import { operation as o289 } from './sessions/queue-steer.js';
+import { operation as o290 } from './sessions/queue-update.js';
+import { operation as o291 } from './sessions/review-set.js';
+import { operation as o292 } from './sessions/runtime-commands-run.js';
+import { operation as o293 } from './sessions/search.js';
+import { operation as o294 } from './sessions/send.js';
+import { operation as o295 } from './sessions/start.js';
+import { operation as o296 } from './sessions/steer.js';
+import { operation as o297 } from './sessions/update.js';
+import { operation as o298 } from './skills/create.js';
+import { operation as o299 } from './skills/create--personal.js';
+import { operation as o300 } from './skills/delete.js';
+import { operation as o301 } from './skills/delete--personal.js';
+import { operation as o302 } from './skills/get.js';
+import { operation as o303 } from './skills/get--personal.js';
+import { operation as o304 } from './skills/list.js';
+import { operation as o305 } from './skills/list--personal.js';
+import { operation as o306 } from './skills/update.js';
+import { operation as o307 } from './skills/update--personal.js';
+import { operation as o308 } from './tasks/create.js';
+import { operation as o309 } from './tasks/create--personal.js';
+import { operation as o310 } from './tasks/delete.js';
+import { operation as o311 } from './tasks/delete--personal.js';
+import { operation as o312 } from './tasks/get.js';
+import { operation as o313 } from './tasks/get--personal.js';
+import { operation as o314 } from './tasks/labels-list.js';
+import { operation as o315 } from './tasks/list.js';
+import { operation as o316 } from './tasks/list--all.js';
+import { operation as o317 } from './tasks/list--personal.js';
+import { operation as o318 } from './tasks/move.js';
+import { operation as o319 } from './tasks/move--personal.js';
+import { operation as o320 } from './tasks/start.js';
+import { operation as o321 } from './tasks/start--personal.js';
+import { operation as o322 } from './tasks/update.js';
+import { operation as o323 } from './tasks/update--personal.js';
+import { operation as o324 } from './user/api-keys-delete.js';
+import { operation as o325 } from './user/profile-get.js';
+import { operation as o326 } from './user/push-devices-create.js';
+import { operation as o327 } from './user/push-devices-delete.js';
+import { operation as o328 } from './user/usage-get.js';
+import { operation as o329 } from './workspaces/artifacts-search.js';
+import { operation as o330 } from './workspaces/credits-get.js';
+import { operation as o331 } from './workspaces/get.js';
+import { operation as o332 } from './workspaces/list.js';
+import { operation as o333 } from './workspaces/members-list.js';
+import { operation as o334 } from './workspaces/members-list--all.js';
+import { operation as o335 } from './workspaces/sandbox-limit-get.js';
+import { operation as o336 } from './workspaces/sandboxes-stop.js';
+import { operation as o337 } from './workspaces/timezone-set.js';
+import { operation as o338 } from './workspaces/usage-breakdown-get.js';
+import { operation as o339 } from './workspaces/usage-get.js';
 export const operations = [
     o0,
     o1,
@@ -675,4 +677,6 @@ export const operations = [
     o335,
     o336,
     o337,
+    o338,
+    o339,
 ];

package/dist/generated/commands/sensei/threads-create.js

@@ -0,0 +1,35 @@
+export const operation = {
+    "method": "post",
+    "path": "/api/sensei/thread-create",
+    "command": [
+        "sensei",
+        "threads",
+        "create"
+    ],
+    "summary": "Open a new thread for the member, at any point of this Turn, on a prompt you write. Only Sensei calls it, for a separate topic that should not go on in this thread. Never for the asks of the member’s message that started this thread: `sensei threads split` does that. The new thread gets its own Turn, which may read Queued, and links back here; nothing of this thread goes with it, so the prompt says all it needs. A Turn opens at most 3 threads, and so do the threads opened from one thread in all. Answers the new thread id and turn id: do not do that work here.",
+    "pathParams": [],
+    "query": [],
+    "body": {
+        "fields": [
+            {
+                "name": "prompt",
+                "flag": "prompt",
+                "kind": "string",
+                "required": true,
+                "description": "What the new thread’s Turn does, whole, in words that stand without this thread: it reads nothing else of it."
+            },
+            {
+                "name": "title",
+                "flag": "title",
+                "kind": "string",
+                "required": false,
+                "description": "A short title for the new thread. Without it, the thread is named by the prompt."
+            }
+        ],
+        "required": true
+    },
+    "multipart": null,
+    "attachments": false,
+    "anonymous": false,
+    "agents": "all"
+};

package/dist/generated/commands/sessions/env-sync.js

@@ -0,0 +1,21 @@
+export const operation = {
+    "method": "post",
+    "path": "/api/projects/{projectId}/chat-sessions/{sessionId}/env-sync",
+    "command": [
+        "sessions",
+        "env",
+        "sync"
+    ],
+    "summary": "Deliver the project's saved environment variables, with its services and setup commands, to a chat session's running sandbox and restart its setup and services, so a variable added after the sandbox booted reaches them. Answers status synced with the variable names, never their values, once the services answer again, or status running when setup outlasts ten minutes and the sync goes on. Refused, never queued: 409 TURN_RUNNING while a turn runs, SANDBOX_NOT_RUNNING when the sandbox is not up (it is not woken), SANDBOX_PROVISIONING or SANDBOX_NOT_READY while it is created or boots, APP_STACK_STARTING during an App stack start and SANDBOX_BUSY while another update changes it; 422 ENV_SYNC_FAILED when setup or a service did not come back.",
+    "pathParams": [
+        "projectId",
+        "sessionId"
+    ],
+    "query": [],
+    "body": null,
+    "multipart": null,
+    "attachments": false,
+    "answerTimeoutMs": 660000,
+    "anonymous": false,
+    "agents": "all"
+};

package/dist/generated/commands/sessions/qa-set.js

@@ -6,7 +6,7 @@ export const operation = {
         "qa",
         "set"
     ],
-    "summary": "Record the commit QA passed on as the session's qaPassedSha: a member's override, or the session's own agent. `sessions qa runs finish` records it when the whole checklist passed. A pull request is done when qaPassedSha equals its head.",
+    "summary": "Record the commit QA passed on as the session's qaPassedSha: a member's override. `sessions qa runs finish` records it when the whole checklist passed. A pull request is done when qaPassedSha equals its head.",
     "pathParams": [
         "projectId",
         "sessionId"

package/dist/program.js

@@ -6,15 +6,13 @@ import { attachIntegrationsCommands } from './commands/integrations.js';
 import { attachWatchCommand } from './commands/watch.js';
 import { operations } from './generated/commands/index.js';
 import { attachCommand } from './runtime/attach.js';
-import { attachFormerCommands } from './runtime/former-commands.js';
 import { formsOf } from './runtime/variants.js';
 import { agentTokenOf, isReachable } from './runtime/agent-tokens.js';
 import { createRuntime, ExitSignal } from './runtime/runtime.js';
 import { version } from './runtime/version.js';
 /**
  * The command tree: the commands `commands/hand-written.ts` lists by hand, everything else
- * from the generated descriptors, one leaf per command over its forms, then the former
- * names as hidden aliases. Global flags are read
+ * from the generated descriptors, one leaf per command over its forms. Global flags are read
  * before any subcommand runs, so the runtime the subcommands share is built once, from them.
  */
 export function createProgram(options = {}) {
@@ -61,7 +59,6 @@ export function createProgram(options = {}) {
     // The job stream admits a member's API key only; it closes 4401 on every narrower token.
     if (narrowedTo === null)
         attachWatchCommand(program, lazy, options.watch);
-    attachFormerCommands(program, operations.filter(reaches), lazy);
     return program;
 }
 /** Run to completion; an ExitSignal has already reported and set the exit code. */

package/dist/runtime/attach.js

@@ -13,16 +13,13 @@ export function attachCommand(root, forms, runtime, { reachable = () => true } =
     const [only] = forms;
     if (forms.length === 1 && !only.variant) {
         // A hidden operation sits beside a hand-written command in a visible group.
-        return attachLeaf(root, only.command, only, runtime, {
-            hidden: only.hidden === true,
-            groupsHidden: false,
-        });
+        return attachLeaf(root, only.command, only, runtime, only.hidden === true);
     }
     return attachForms(root, forms, runtime, reachable);
 }
-/** A single-form leaf: the command as it was before forms, which aliases reuse. */
-export function attachLeaf(root, path, operation, runtime, { hidden, groupsHidden = hidden, fixed = {}, formerFlags = {} }) {
-    const parent = groupFor(root, path.slice(0, -1), { hidden: groupsHidden });
+/** A leaf for an operation with a single form. */
+function attachLeaf(root, path, operation, runtime, hidden) {
+    const parent = groupFor(root, path.slice(0, -1));
     const leaf = parent.command(path[path.length - 1], { hidden });
     leaf.description(operation.summary);
     for (const name of operation.pathParams) {
@@ -31,25 +28,13 @@ export function attachLeaf(root, path, operation, runtime, { hidden, groupsHidde
     const fields = fieldsOf(operation);
     for (const field of fields)
         addFieldOptions(leaf, field, field.description ?? '');
-    for (const [former, current] of Object.entries(formerFlags)) {
-        const field = fields.find((candidate) => candidate.flag === current);
-        if (!field) {
-            throw new Error(`kosuke ${path.join(' ')}: --${former} names --${current}, not a flag.`);
-        }
-        const option = new Option(`--${former} <value>`).hideHelp();
-        // Repeated as it was, `--project-ids a --project-ids b`, or one JSON list.
-        if (field.repeated)
-            option.argParser(collect).default(undefined);
-        leaf.addOption(option);
-    }
     addBodyOptions(leaf, operation);
     leaf.action(async (...args) => {
         const options = args[args.length - 2];
         const positionals = args.slice(0, operation.pathParams.length);
         try {
             checkFileFlags(options, fields.filter((field) => field.file).map((field) => field.flag));
-            // `personal` where a workspace id goes, on a command with no personal form. An alias
-            // leaf runs a personal form by its old path, which takes no workspace id at all.
+            // Refuse `personal` where a workspace id goes on a command with no personal form.
             if (!operation.variant)
                 selectForm([operation], { first: positionals[0], flags: {} });
         }
@@ -58,19 +43,13 @@ export function attachLeaf(root, path, operation, runtime, { hidden, groupsHidde
                 leaf.error(error.message);
             throw error;
         }
-        const values = Object.fromEntries(fields.map((field) => {
-            const former = Object.entries(formerFlags).find(([, current]) => current === field.flag);
-            const formerValue = former
-                ? formerValueOf(field, options[optionKey(former[0])])
-                : undefined;
-            return [
-                field.name,
-                options[optionKey(field.flag)] ?? fileValue(field, options) ?? formerValue,
-            ];
-        }));
+        const values = Object.fromEntries(fields.map((field) => [
+            field.name,
+            options[optionKey(field.flag)] ?? fileValue(field, options),
+        ]));
         await run(leaf, runtime, operation, {
             pathParams: Object.fromEntries(operation.pathParams.map((name, i) => [name, positionals[i]])),
-            fields: { ...values, ...fixed },
+            fields: values,
             wholeBody: readWholeBody({
                 body: options.body,
                 bodyFile: options.bodyFile,
@@ -242,22 +221,6 @@ function parseForForm(field, raw) {
         return raw === 'true';
     return field.repeated ? [raw] : raw;
 }
-/** The value of a renamed flag, by the rule its field had: one JSON list, or the values given. */
-function formerValueOf(field, raw) {
-    if (Array.isArray(raw))
-        return raw.flatMap((value) => formerValueOf(field, value));
-    if (typeof raw !== 'string')
-        return raw;
-    if (!field.repeated)
-        return field.kind === 'json' ? jsonParser(raw) : raw;
-    try {
-        const parsed = JSON.parse(raw);
-        return Array.isArray(parsed) ? parsed : [raw];
-    }
-    catch {
-        return [raw];
-    }
-}
 function addFieldOptions(leaf, field, description) {
     leaf.addOption(optionFor({ ...field, description }));
     if (field.file) {
@@ -279,13 +242,12 @@ function addBodyOptions(leaf, operation) {
         leaf.option('--attach <path>', 'Attach a file; repeat for several. Sends the request as multipart.', collect, []);
     }
 }
-/** A group created here is hidden when asked; one that already exists keeps what it is. */
-export function groupFor(root, path, { hidden = false } = {}) {
+/** Find or create the command groups on the way to a leaf. */
+export function groupFor(root, path) {
     let current = root;
     for (const segment of path) {
         const existing = current.commands.find((command) => command.name() === segment);
-        current =
-            existing ?? current.command(segment, { hidden }).description(`${humanize(segment)} commands`);
+        current = existing ?? current.command(segment).description(`${humanize(segment)} commands`);
     }
     return current;
 }