akm-cli 0.9.31 → 0.10.261002-beta

package/schemas/akm-workflow.json

@@ -2,7 +2,7 @@
   "$schema": "http://json-schema.org/draft-07/schema#",
   "$id": "https://itlackey.github.io/akm/schemas/akm-workflow.json",
   "title": "AKM Workflow",
-  "description": "This frontmatter schema applies to and validates the Markdown (.md) workflow source: the standard AKM asset envelope plus its orchestration graph. Markdown is not the sole or only workflow source; peer GitHub-shaped .yml sources use the bounded adapter and both formats compile to source IR v1. Per-step prose instructions and gate rubrics live in the Markdown body, joined to this graph by step id. Hand-authored alongside src/workflows/program/schema.ts; see docs/reference/workflow-schema.md.",
+  "description": "This frontmatter schema validates the Markdown (.md) workflow source, the only workflow format: the standard AKM asset envelope plus its orchestration graph, compiled to source IR v1. Per-step prose instructions and gate rubrics live in the Markdown body, joined to this graph by step id. Hand-authored alongside src/workflows/program/schema.ts; see docs/reference/workflow-schema.md.",
   "type": "object",
   "required": ["steps"],
   "additionalProperties": false,
@@ -30,17 +30,6 @@
         "$ref": "#/definitions/jsonSchemaObject"
       }
     },
-    "outputs": {
-      "type": "object",
-      "minProperties": 1,
-      "description": "Named, optionally schema-validated projections of step artifacts, exported when the run completes. Names must be steps.<child>.output.<name>-addressable identifiers. Each entry: { from: steps.<id>.output(.<seg>)*, schema?: <bounded JSON Schema> }. Markdown-frontmatter only.",
-      "propertyNames": {
-        "pattern": "^[A-Za-z_][A-Za-z0-9_]*$"
-      },
-      "additionalProperties": {
-        "$ref": "#/definitions/outputDeclaration"
-      }
-    },
     "defaults": {
       "$ref": "#/definitions/defaults"
     },
@@ -136,10 +125,6 @@
       "description": "How a map step folds per-item unit results into the step artifact.",
       "enum": ["collect", "vote"]
     },
-    "isolation": {
-      "description": "Filesystem isolation for file-mutating units.",
-      "enum": ["none", "worktree"]
-    },
     "failureReason": {
       "description": "Persisted AgentFailureReason taxonomy (src/integrations/agent/spawn.ts).",
       "enum": [
@@ -162,21 +147,6 @@
       "type": "object",
       "description": "A JSON Schema declaration. The parser validates it as a schema definition against the runtime's enforced subset (src/core/json-schema.ts checkJsonSchemaDefinition): typo'd type names and keywords outside the subset (e.g. $ref, const, format, patternProperties) are authoring-time errors, not silent no-ops."
     },
-    "outputDeclaration": {
-      "type": "object",
-      "description": "One outputs: entry: a validated steps.<id>.output(.<seg>)* reference into a step artifact, plus an optional bounded JSON Schema.",
-      "required": ["from"],
-      "additionalProperties": false,
-      "properties": {
-        "from": {
-          "type": "string",
-          "description": "A steps.<id>.output(.<seg>)* reference into a step artifact. Never params.<name> — an output projects a step artifact, never a param."
-        },
-        "schema": {
-          "$ref": "#/definitions/jsonSchemaObject"
-        }
-      }
-    },
     "retry": {
       "type": "object",
       "description": "Bounded retry on transient failures, keyed on the persisted failure_reason taxonomy.",
@@ -255,7 +225,7 @@
         },
         "cwd": {
           "type": "string",
-          "description": "Optional RELATIVE working directory inside the unit's working directory (its fresh worktree under `isolation: worktree`). Absolute paths, Windows drive letters, \"~\", and \"..\" segments are rejected here, and containment is re-checked against the resolved base — symlinks included — before the command is spawned.",
+          "description": "Optional RELATIVE working directory inside the unit's working directory. Absolute paths, Windows drive letters, \"~\", and \"..\" segments are rejected here, and containment is re-checked against the resolved base — symlinks included — before the command is spawned.",
           "minLength": 1,
           "pattern": "^(?!/|\\\\|~|[A-Za-z]:)(?!.*(?:^|[/\\\\])\\.\\.(?:[/\\\\]|$)).+$"
         },
@@ -273,7 +243,7 @@
     },
     "unit": {
       "type": "object",
-      "description": "Optional dispatch-override bag for a unit/map step. A step with none of these carries the run's engine/model/timeout defaults verbatim. Declaring `exec` turns the step into a shell-command unit: it names no engine, so `engine`, `model`, and `llm` are rejected alongside it.",
+      "description": "Optional dispatch-override bag for a unit/map step. A step with none of these carries the run's engine/model/timeout defaults verbatim. Declaring `exec` turns the step into a shell-command unit: it names no engine, so `engine`, `model`, and `llm` are rejected alongside it. Declaring `workflow` (Experimental, not allowed inside `map.unit`) makes the step start a child workflow run: it names no engine or env either, and the child's last step output is the step's result.",
       "additionalProperties": false,
       "allOf": [
         {
@@ -295,12 +265,55 @@
               ]
             }
           }
+        },
+        {
+          "if": {
+            "required": ["workflow"]
+          },
+          "then": {
+            "not": {
+              "anyOf": [
+                {
+                  "required": ["exec"]
+                },
+                {
+                  "required": ["engine"]
+                },
+                {
+                  "required": ["model"]
+                },
+                {
+                  "required": ["llm"]
+                },
+                {
+                  "required": ["env"]
+                }
+              ]
+            }
+          }
+        },
+        {
+          "if": {
+            "required": ["with"]
+          },
+          "then": {
+            "required": ["workflow"]
+          }
         }
       ],
       "properties": {
         "exec": {
           "$ref": "#/definitions/exec"
         },
+        "workflow": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Experimental. Canonical ref of a child workflow (`workflows/<name>` or `<bundle>//workflows/<name>`) this step starts and drives to completion."
+        },
+        "with": {
+          "type": "object",
+          "description": "Experimental. Binds the child workflow's params: each key is a declared child param, each value a literal or `{ from: <reference> }`."
+        },
         "engine": {
           "$ref": "#/definitions/engineName",
           "description": "Named engine selected when the workflow run is created."
@@ -332,9 +345,6 @@
             "minLength": 1
           },
           "description": "Env asset refs injected into the dispatched unit env. Entries must be unique: the frozen-plan decoder rejects duplicates at run start."
-        },
-        "isolation": {
-          "$ref": "#/definitions/isolation"
         }
       }
     },
@@ -362,43 +372,6 @@
         }
       }
     },
-    "routeBranch": {
-      "type": "object",
-      "required": ["match", "step"],
-      "additionalProperties": false,
-      "properties": {
-        "match": {
-          "type": ["string", "number", "boolean"],
-          "minLength": 1,
-          "description": "Branch key. An empty string is rejected: the frozen-plan decoder requires every `when` key to be non-empty."
-        },
-        "step": {
-          "$ref": "#/definitions/identifier"
-        }
-      }
-    },
-    "route": {
-      "type": "object",
-      "description": "Route on an explicit reference input to a LATER step. Targets must come after the routing step.",
-      "required": ["input", "when"],
-      "additionalProperties": false,
-      "properties": {
-        "input": {
-          "$ref": "#/definitions/reference",
-          "description": "Reference naming the value to route on."
-        },
-        "when": {
-          "type": "array",
-          "minItems": 1,
-          "items": {
-            "$ref": "#/definitions/routeBranch"
-          }
-        },
-        "default": {
-          "$ref": "#/definitions/identifier"
-        }
-      }
-    },
     "gate": {
       "type": "object",
       "description": "Optional validation-loop configuration. The rubric itself lives in the body under a `### gate` sub-heading inside the step's section; omitted or empty rubric text skips validation.",
@@ -422,7 +395,7 @@
     },
     "step": {
       "type": "object",
-      "description": "One step of the gated spine. A step with no map/route is a unit step (bare `{id: ...}` is the complete minimal declaration). At most one of map/route.",
+      "description": "One step of the gated spine. A step with no map is a unit step (bare `{id: ...}` is the complete minimal declaration).",
       "required": ["id"],
       "additionalProperties": false,
       "properties": {
@@ -435,9 +408,6 @@
         "map": {
           "$ref": "#/definitions/map"
         },
-        "route": {
-          "$ref": "#/definitions/route"
-        },
         "inputs": {
           "$ref": "#/definitions/inputs"
         },
@@ -449,13 +419,6 @@
         }
       },
       "allOf": [
-        {
-          "not": { "required": ["map", "route"] }
-        },
-        {
-          "if": { "required": ["route"] },
-          "then": { "not": { "anyOf": [{ "required": ["unit"] }, { "required": ["map"] }, { "required": ["inputs"] }] } }
-        },
         {
           "if": { "required": ["map"] },
           "then": { "not": { "required": ["unit"] } }

package/dist/assets/improve-strategies/catchup.json

@@ -1,41 +0,0 @@
-{
-  "description": "Manual catch-up \u2014 consolidation plus a judged triage drain (up to 100 accepts) with no interval minimum. Auto-accepts only when improve autonomy is enabled; otherwise proposals queue for review.",
-  "processes": {
-    "reflect": {
-      "enabled": false
-    },
-    "distill": {
-      "enabled": false
-    },
-    "consolidate": {
-      "enabled": true,
-      "allowedTypes": ["memory"],
-      "maxChunkSize": 50,
-      "minPoolSize": 0
-    },
-    "memoryInference": {
-      "enabled": false
-    },
-    "extract": {
-      "enabled": false
-    },
-    "triage": {
-      "enabled": true,
-      "applyMode": "promote",
-      "policy": "personal-stash",
-      "maxAcceptsPerRun": 100,
-      "judgment": true,
-      "maxDiffLines": 200
-    },
-    "validation": {
-      "enabled": false
-    },
-    "proactiveMaintenance": {
-      "enabled": false
-    }
-  },
-  "sync": {
-    "enabled": true,
-    "push": true
-  }
-}

package/dist/assets/improve-strategies/proactive-maintenance.json

@@ -1,24 +0,0 @@
-{
-  "description": "Opt-in proactive-maintenance pass — reflect (on negative feedback), distill, proposal triage (promote, high budget), and the proactive-maintenance lane (maxPerRun 100), which picks due assets for scoring but plans no rewrite; consolidate/memoryInference/extract off. Sync disabled: an interrupted run would otherwise leave an uncommitted backlog.",
-  "processes": {
-    "reflect": {
-      "enabled": true,
-      "allowedTypes": ["agent", "command", "knowledge", "lesson", "memory", "skill", "workflow"]
-    },
-    "distill": { "enabled": true, "allowedTypes": ["memory"] },
-    "consolidate": { "enabled": false },
-    "memoryInference": { "enabled": false },
-    "extract": { "enabled": false },
-    "validation": { "enabled": false },
-    "triage": {
-      "enabled": true,
-      "applyMode": "promote",
-      "policy": "personal-stash",
-      "maxAcceptsPerRun": 100,
-      "maxDiffLines": 200,
-      "judgment": true
-    },
-    "proactiveMaintenance": { "enabled": true, "dueDays": 30, "maxPerRun": 100 }
-  },
-  "sync": { "enabled": false }
-}

package/dist/assets/improve-strategies/quick.json

@@ -1,17 +0,0 @@
-{
-  "description": "Reflect-only pass — no extract, distill, consolidate, or memoryInference.",
-  "processes": {
-    "reflect": {
-      "enabled": true,
-      "allowedTypes": ["agent", "command", "knowledge", "lesson", "memory", "skill", "workflow"]
-    },
-    "extract": { "enabled": false },
-    "distill": { "enabled": false },
-    "consolidate": { "enabled": false },
-    "memoryInference": { "enabled": false },
-    "triage": { "enabled": false },
-    "validation": { "enabled": false },
-    "proactiveMaintenance": { "enabled": false }
-  },
-  "sync": { "enabled": true, "push": true }
-}

package/dist/assets/improve-strategies/reflect-distill.json

@@ -1,29 +0,0 @@
-{
-  "description": "Reflect + distill pass — reflect, distill, memoryInference, and proposal triage (promote); proactiveMaintenance/consolidate/extract off. Sync disabled: an interrupted run would otherwise leave an uncommitted backlog.",
-  "processes": {
-    "reflect": {
-      "enabled": true,
-      "allowedTypes": ["agent", "command", "knowledge", "lesson", "memory", "skill", "workflow"]
-    },
-    "distill": { "enabled": true, "allowedTypes": ["memory"], "requirePlannedRefs": false },
-    "consolidate": { "enabled": false },
-    "memoryInference": { "enabled": true },
-    "extract": {
-      "enabled": false,
-      "timeoutMs": 300000,
-      "triage": { "enabled": true, "minScore": 2 },
-      "minNewSessions": 1
-    },
-    "validation": { "enabled": false },
-    "triage": {
-      "enabled": true,
-      "applyMode": "promote",
-      "policy": "personal-stash",
-      "maxAcceptsPerRun": 15,
-      "maxDiffLines": 200,
-      "judgment": true
-    },
-    "proactiveMaintenance": { "enabled": false, "dueDays": 30, "maxPerRun": 15 }
-  },
-  "sync": { "enabled": false }
-}

package/dist/assets/improve-strategies/thorough.json

@@ -1,49 +0,0 @@
-{
-  "description": "Everything default runs, plus a judged triage drain of the pending-proposal backlog (up to 25 accepts per run). Auto-accepts only when improve autonomy is enabled; otherwise proposals queue for review. Identical tuning to default; improve-stage extract and proactive maintenance stay off.",
-  "processes": {
-    "reflect": {
-      "enabled": true,
-      "limit": 25,
-      "allowedTypes": ["agent", "command", "knowledge", "lesson", "memory", "skill", "workflow"]
-    },
-    "distill": {
-      "enabled": true,
-      "allowedTypes": ["memory"],
-      "requirePlannedRefs": false
-    },
-    "consolidate": {
-      "enabled": true,
-      "allowedTypes": ["memory"]
-    },
-    "memoryInference": {
-      "enabled": true
-    },
-    "extract": {
-      "enabled": false,
-      "triage": {
-        "enabled": true,
-        "minScore": 2
-      }
-    },
-    "validation": {
-      "enabled": true
-    },
-    "proactiveMaintenance": {
-      "enabled": false,
-      "dueDays": 30,
-      "maxPerRun": 15
-    },
-    "triage": {
-      "enabled": true,
-      "applyMode": "promote",
-      "policy": "personal-stash",
-      "maxAcceptsPerRun": 25,
-      "maxDiffLines": 200,
-      "judgment": true
-    }
-  },
-  "sync": {
-    "enabled": true,
-    "push": true
-  }
-}

package/dist/assets/prompts/retrieval-relevance-judge.md

@@ -1,6 +0,0 @@
-You are grading search-and-retrieval results for an AI coding agent's knowledge base (the akm tool). For the given query and ONE candidate asset, grade how useful loading this asset would be, on this scale:
-3 = exactly the asset an agent should load for this query or task; it directly answers or performs the request.
-2 = relevant and clearly useful, though not the single best asset for the query.
-1 = same general topic as the query, but would not actually help complete this specific query or task.
-0 = unrelated to the query.
-Reply with ONLY a JSON object: {"grade": <integer 0-3>, "reason": "<=25 words"}.

package/dist/assets/tasks/improve/akm-improve-catchup.yml

@@ -1,6 +0,0 @@
-version: 4
-run: akm improve --strategy catchup --skip-if-locked --require-engines
-description: Manual recovery — consolidation + triage drain (run on demand via `akm task run akm-improve-catchup`)
-# Manual-recovery task: setup offers it disabled by default. `akm task run`
-# still works manually; `akm task enable` opts this host into the schedule.
-schedule: "0 4 * * *"

package/dist/assets/tasks/improve/akm-improve-frequent.yml

@@ -1,4 +0,0 @@
-version: 4
-run: akm improve --strategy reflect-distill --skip-if-locked --require-engines
-description: Frequent learning pass (hourly at :40) — reflect, distill, memory inference, judged triage
-schedule: "40 * * * *"

package/dist/assets/tasks/improve/akm-improve-nightly.yml

@@ -1,4 +0,0 @@
-version: 4
-run: akm improve --strategy thorough --skip-if-locked --require-engines
-description: Full nightly quality sweep (daily 2:15am; suggested for server installs)
-schedule: "15 2 * * *"

package/dist/cli/retired-commands.js

@@ -1,118 +0,0 @@
-// This Source Code Form is subject to the terms of the Mozilla Public
-// License, v. 2.0. If a copy of the MPL was not distributed with this
-// file, You can obtain one at https://mozilla.org/MPL/2.0/.
-/**
- * Replacement hints for command spellings retired by the 0.9 CLI overhaul
- * (hard break — no aliases). Consulted by the unknown-command error path
- * BEFORE the edit-distance did-you-mean: distance-based suggestions are
- * actively misleading for retired spellings (`init` → "did you mean
- * `info`?", `update` → "did you mean `upgrade`?" — the latter replaces the
- * BINARY, not the sources), and an agent following them gets steered into
- * the wrong command instead of the renamed one.
- *
- * Keys are either a bare retired top-level token (`"init"`) or a
- * group-scoped `"<group> <sub>"` pair (`"env set"`). Keep entries one
- * sentence; the migration pointer is appended by the caller.
- */
-const RETIRED_COMMAND_HINTS = {
-    // Top-level verbs absorbed by the `bundle` group.
-    init: "`akm init` moved in 0.9 — use `akm bundle create`.",
-    add: "`akm add` moved in 0.9 — use `akm bundle add <source>`.",
-    list: "`akm list` moved in 0.9 — use `akm bundle list`.",
-    remove: "`akm remove` moved in 0.9 — use `akm bundle remove <source>`.",
-    update: "`akm update` moved in 0.9 — use `akm bundle update` (to update akm itself, use `akm upgrade`).",
-    // Group renamed to the singular.
-    tasks: "the `tasks` group was renamed in 0.9 — use `akm task <subcommand>`.",
-    // Verbs absorbed by the `proposal` group.
-    extract: "`akm extract` moved in 0.9 — use `akm proposal extract`.",
-    propose: "`akm propose` moved in 0.9 — use `akm proposal new`.",
-    proposals: "`akm proposals` moved in 0.9 — use `akm proposal list`.",
-    accept: "`akm accept` moved in 0.9 — use `akm proposal accept <id>`.",
-    reject: '`akm reject` moved in 0.9 — use `akm proposal reject <id> --reason "..."`.',
-    diff: "`akm diff` moved in 0.9 — use `akm proposal diff <id>`.",
-    revert: "`akm revert` moved in 0.9 — use `akm proposal revert <id>`.",
-    reflect: "`akm reflect` was folded into 0.9 — use `akm improve <ref>`.",
-    distill: "`akm distill` was folded into 0.9 — use `akm improve <ref>`.",
-    // Renamed persistence and observability verbs.
-    save: "`akm save` moved in 0.9 — use `akm sync`.",
-    events: "`akm events` moved in 0.9 — use `akm log`.",
-    // Removed observability surfaces.
-    history: "`akm history` was removed in 0.9 — use `akm log --ref <ref>` for an asset's event trail.",
-    graph: "`akm graph` was removed in 0.9. The LLM entity graph it inspected was itself retired in 0.9.17-alpha.9 — use `akm show <ref>` for an asset's declared links.",
-    lessons: "`akm lessons` was removed in 0.9 — lesson strength is indexed; use `akm search --type lesson`.",
-    lesson: "`akm lesson` was removed in 0.9 — lesson strength is indexed; use `akm search --type lesson`.",
-    // Relocated guidance / removed asset verbs.
-    mv: "`akm mv` was removed in 0.9 — move the file, then run `akm index` and `akm lint` (to carry ranking signal: `bun scripts/rekey-asset-ref.ts <old-ref> <new-ref>`).",
-    // Pre-0.9 removals agents still trip over.
-    wiki: "the `akm wiki` family was removed in 0.9 — wikis are ordinary knowledge assets; ingest with `akm import <url> --path <subdir>`.",
-    backup: "`akm backup` was removed in 0.9 — stop writers and archive current config, data, state, and writable bundles with your normal backup tooling.",
-    vault: "the `akm vault ...` family was removed in 0.9 — use `akm env list`/`akm env create` for a whole `.env` group, or `akm secret set <name>` for a single sensitive value.",
-    // Group-scoped retirements.
-    "env set": "`akm env set` was removed in 0.9 — edit the `.env` file directly; akm loads it as-is.",
-    "env unset": "`akm env unset` was removed in 0.9 — edit the `.env` file directly; akm loads it as-is.",
-    "registry search": "`akm registry search` was folded into `akm search --from registry` in 0.9.",
-    "registry build-index": "`akm registry build-index` moved in 0.9 — maintainers run `bun scripts/build-registry-index.ts`.",
-    "workflow template": "`akm workflow template` was folded into `akm workflow create --print` in 0.9.",
-    "workflow validate": "`akm workflow validate` was folded into `akm lint --type workflows` in 0.9 (add `--fail-on-flagged` for CI gates).",
-    "workflow watch": "`akm workflow watch` was removed in 0.9 — use `akm log --run <run-id>`.",
-    "workflow start": "`akm workflow start` was removed in 0.9 — use `akm workflow run <ref>`.",
-    "workflow next": "`akm workflow next` was removed in 0.9 — use `akm workflow status <target>` to inspect or `akm workflow run <target>` to execute.",
-    "workflow complete": "`akm workflow complete` was removed in 0.9 — `akm workflow run <target>` completes steps automatically; use `akm workflow status <target>` to inspect.",
-    "workflow brief": "`akm workflow brief` was removed — the external-driver protocol is gone; `akm workflow run <target>` executes the run and `akm workflow status <target>` inspects it.",
-    "workflow report": "`akm workflow report` was removed — the external-driver protocol is gone; `akm workflow run <target>` dispatches and records units itself.",
-    "config show": "`akm config show` was removed in 0.9 — use `akm config list`.",
-    "config validate": "`akm config validate` was removed in 0.9 — the config file is validated on every load.",
-    "task init": "`akm task init` was removed in 0.9 — `akm setup` seeds the default schedules.",
-    "task show": "there is no `task show` — task files are indexed assets; use `akm show <ref>`.",
-    "task remove": "there is no `task remove` — delete the task YAML, then run `akm task sync` to unbind it.",
-    // `improve canary` is NOT here: `akm improve` is a leaf command (a
-    // positional `ref`, not a subcommand group), so "canary" never reaches the
-    // unknown-command path this table serves — `improve-cli.ts` already
-    // self-diagnoses it with a more specific, correct message before this
-    // table would ever be consulted.
-    "log tail": "`akm log tail` was removed in 0.9 — poll `akm log --since @offset:<id>` (the durable cursor).",
-    "log list": "`akm log list` was flattened in 0.9 — bare `akm log` is the same surface.",
-};
-const MIGRATION_POINTER = "Full rename table: `akm help migrate 0.9.0`.";
-/**
- * Replacement hint for a retired spelling, or undefined when the attempted
- * token isn't a known retirement. `parentPath` is the group path already
- * resolved before the unknown token (empty at root), so `env set` and a
- * hypothetical top-level `set` can't collide.
- */
-export function retiredCommandHint(parentPath, attempted) {
-    const key = parentPath.length === 0 ? attempted : `${parentPath[parentPath.length - 1]} ${attempted}`;
-    const entry = RETIRED_COMMAND_HINTS[key];
-    return entry === undefined ? undefined : `${entry} ${MIGRATION_POINTER}`;
-}
-/**
- * Same idea as {@link RETIRED_COMMAND_HINTS}, but for FLAGS the 0.9 overhaul
- * removed outright rather than commands. Consulted by
- * `src/cli/unknown-flags.ts` BEFORE its own edit-distance did-you-mean, for
- * the same reason: a distance-based suggestion on a retired flag can point at
- * an unrelated survivor rather than the real replacement procedure.
- *
- * Keys are the FULL resolved command path joined with spaces, plus the flag
- * exactly as the unknown-flag scanner reports it (leading dashes, long form
- * only — `--background`, not `-b`): `"<cmd> [sub...] --flag"`. The command
- * path is whatever `unknown-flags.ts`'s `KnownArgs.path` resolved (e.g.
- * `["proposal", "extract"]` for the flag's CURRENT location, not any retired
- * top-level spelling — that command-level retirement is already handled by
- * {@link retiredCommandHint} before flag scanning ever runs).
- */
-const RETIRED_FLAG_HINTS = {
-    "index --background": "`--background` was removed in 0.9 — the flag never actually backgrounded; use `--quiet`.",
-    "setup --detect-only": "`--detect-only` was removed in 0.9 — environment detection runs inside `akm setup`; `akm info` reports the configured capabilities.",
-    "setup --reset-recommended": "`--reset-recommended` was removed in 0.9 — `akm setup` now offers to apply recommended defaults interactively.",
-    "proposal extract --watch": "`--watch` was removed in 0.9 — schedule `akm proposal extract --auto` as a task instead.",
-    "proposal extract --debounce-ms": "`--debounce-ms` was removed in 0.9 — schedule `akm proposal extract --auto` as a task instead.",
-};
-/**
- * Replacement hint for a retired flag on its current command path, or
- * undefined when the attempted spelling isn't a known retirement.
- */
-export function retiredFlagHint(path, attempted) {
-    const key = `${path.join(" ")} ${attempted}`;
-    const entry = RETIRED_FLAG_HINTS[key];
-    return entry === undefined ? undefined : `${entry} ${MIGRATION_POINTER}`;
-}