akm-cli 0.9.31 → 0.10.26101002-alpha

package/dist/core/adapter/adapters/akm-workflow-adapter.js

@@ -4,9 +4,7 @@
 /**
  * The `akm-workflow` adapter — akm 0.9.0 format-family work item (#46).
  *
- * A native akm workflow bundle. AKM Markdown and the strict local GitHub-shaped
- * `.yml` subset are peer source formats. Both compile through the source IR;
- * neither source is rewritten or projected onto the other.
+ * A native akm workflow bundle: Markdown workflow sources.
  *
  * ── validate (spec §6 workflow row) ──
  *
@@ -21,15 +19,14 @@
  */
 import fs from "node:fs";
 import path from "node:path";
-import { looksLikeGithubWorkflowSource } from "../../../workflows/compile.js";
 import { parseFrontmatter } from "../../asset/frontmatter.js";
 import { toPosix } from "../../common.js";
-import { perTypeValidateChecks, workflowYamlSourceDiagnostics } from "./akm-lint.js";
+import { perTypeValidateChecks } from "./akm-lint.js";
 import { hashContent, nonEmptyString, readTags, runBaseValidateChecks } from "./shared.js";
 /** A native workflow bundle is single-component; its one component is `main`. */
 const COMPONENT_ID = "main";
-/** The two authoritative workflow source formats. `.yaml` is deliberately not accepted. */
-const WORKFLOW_EXTS = new Set([".md", ".yml"]);
+/** The authoritative workflow source format. */
+const WORKFLOW_EXTS = new Set([".md"]);
 /** Strip the recognized workflow extension from a component-root-relative path → conceptId. */
 function conceptIdOf(relPath) {
     return toPosix(relPath).replace(/\.(?:md|yml)$/i, "");
@@ -94,10 +91,6 @@ async function validate(c, changes, ctx) {
         if (!WORKFLOW_EXTS.has(ext) || isReservedDocFile(path.basename(change.path)))
             continue;
         const relPath = toPosix(change.path);
-        if (ext === ".yml") {
-            diagnostics.push(...workflowYamlSourceDiagnostics(relPath, raw, relPath, c.root).errors);
-            continue;
-        }
         if (!isWorkflowFile(raw))
             continue;
         const p = parseFrontmatter(raw);
@@ -140,8 +133,6 @@ function hasTopLevelWorkflowFile(root, entries) {
         catch {
             continue;
         }
-        if (ext === ".yml" && looksLikeGithubWorkflowSource(raw))
-            return true;
         if (ext === ".md" && parseFrontmatter(raw).data.type === "workflow")
             return true;
     }
@@ -150,25 +141,15 @@ function hasTopLevelWorkflowFile(root, entries) {
 export const akmWorkflowAdapter = {
     id: "akm-workflow",
     version: "0.9.2",
-    extensions: [".md", ".yml"],
+    extensions: [".md"],
     recognize,
     validate,
     readCandidates(c, conceptId) {
         const posix = toPosix(conceptId);
-        const canonical = posix.replace(/\.(?:md|yml)$/i, "");
-        return /\.(?:md|yml)$/i.test(posix)
+        const canonical = posix.replace(/\.md$/i, "");
+        return /\.md$/i.test(posix)
             ? [{ path: path.join(c.root, posix), conceptId: canonical }]
-            : [
-                { path: path.join(c.root, `${posix}.md`), conceptId: canonical },
-                { path: path.join(c.root, `${posix}.yml`), conceptId: canonical },
-            ];
-    },
-    /** Markdown remains the default; an explicit `.md`/`.yml` suffix is preserved. */
-    placeNew(c, conceptId) {
-        const posix = toPosix(conceptId);
-        if (/\.(?:md|yml)$/i.test(posix))
-            return path.join(c.root, posix);
-        return path.join(c.root, `${posix}.md`);
+            : [{ path: path.join(c.root, `${posix}.md`), conceptId: canonical }];
     },
     /** Workflows live anywhere under the component root. */
     directoryList() {
@@ -176,7 +157,7 @@ export const akmWorkflowAdapter = {
     },
     /**
      * Install-time probe (§1.2): a root holding an explicitly typed Markdown
-     * workflow or a complete GitHub-shaped YAML workflow at top level.
+     * workflow at top level.
      */
     looksLikeRoot(root) {
         let entries;

package/dist/core/adapter/adapters/dotenv-adapter.js

@@ -29,7 +29,7 @@
  */
 import fs from "node:fs";
 import path from "node:path";
-import { assetPathCandidatesForName, assetPathForName, typeForStashDir } from "../../asset/asset-placement.js";
+import { assetPathCandidatesForName, typeForStashDir } from "../../asset/asset-placement.js";
 import { scanEnvKeyNames, toPosix } from "../../common.js";
 import { dangerousEnvKeyDiagnostics } from "./akm-lint.js";
 import { hashContent } from "./shared.js";
@@ -171,25 +171,6 @@ export const dotenvAdapter = {
             : [primary, `${primary}.sensitive`, `${primary}.lock`]);
         return expanded.map((candidatePath) => ({ path: candidatePath, conceptId: posix }));
     },
-    /**
-     * env places to `env/<name>.env`, secret to `secrets/<name>` (identity join,
-     * no extension logic) — reusing the shared `assetPathForName` so the env
-     * default-alias / already-suffixed / nested-secret edge cases match the akm
-     * placement convention exactly.
-     */
-    placeNew(c, conceptId) {
-        const posix = toPosix(conceptId);
-        const slash = posix.indexOf("/");
-        if (slash > 0) {
-            const head = posix.slice(0, slash);
-            const rest = posix.slice(slash + 1);
-            const type = typeForStashDir(head);
-            if ((type === "env" || type === "secret") && rest.length > 0) {
-                return assetPathForName(type, path.join(c.root, head), rest);
-            }
-        }
-        return path.join(c.root, posix);
-    },
     /** The dotenv bundle owns its `env/` + `secrets/` dirs. */
     directoryList() {
         return [ENV_DIR, SECRETS_DIR];

package/dist/core/adapter/adapters/generic-files-adapter.js

@@ -107,16 +107,6 @@ export const genericFilesAdapter = {
             ? documentCandidates
             : [{ path: path.join(c.root, posix), conceptId: posix }, ...documentCandidates];
     },
-    /**
-     * IDENTITY placement (open-question-5): a conceptId that carries an extension
-     * (`script`/`file`) places to itself; an extension-less conceptId (a
-     * `document`) appends `.md`.
-     */
-    placeNew(c, conceptId) {
-        const posix = toPosix(conceptId);
-        const hasExt = path.extname(posix) !== "";
-        return path.join(c.root, hasExt ? posix : `${posix}.md`);
-    },
     /** generic-files is EXPLICIT-CONFIG ONLY — never auto-selected (§1.2), so this never fires. */
     looksLikeRoot() {
         return false;

package/dist/core/adapter/adapters/llm-wiki-adapter.js

@@ -395,10 +395,6 @@ export const llmWikiAdapter = {
         const canonical = toPosix(conceptId).replace(/\.md$/i, "");
         return [{ path: path.join(c.root, `${canonical}.md`), conceptId: canonical }];
     },
-    /** `<c.root>/<conceptId>.md` — the conceptId already carries its `pages/`/`raw/` prefix (placement golden). */
-    placeNew(c, conceptId) {
-        return path.join(c.root, `${conceptId}.md`);
-    },
     /** The wiki owns its whole root (schema/index/log at root plus pages/ + raw/); one component. */
     directoryList(_c) {
         return ["."];

package/dist/core/adapter/adapters/tool-dir-shared.js

@@ -126,29 +126,6 @@ export function recognizeToolDir(layout, c, file) {
         doc.tags = tags;
     return doc;
 }
-/**
- * placeNew() for a tool-dir adapter (spec §7: "AKM workspace layout IS the tool
- * dir minus the prefix"). Writes NORMALIZE to the canonical plural subdir
- * (open-question-6): a `command/foo` concept still places at `commands/foo.md`.
- * The instruction file is fixed at the component root.
- */
-export function placeNewToolDir(layout, c, conceptId) {
-    const posix = toPosix(conceptId);
-    if (posix === layout.instructionConceptId)
-        return path.join(c.root, layout.instructionFile);
-    const segs = posix.split("/").filter((s) => s.length > 0);
-    const head = segs[0];
-    const rest = segs.slice(1).join("/");
-    if (rest.length > 0) {
-        if (layout.skillDirs.has(head))
-            return path.join(c.root, CANONICAL_SKILL_DIR, rest, SKILL_MANIFEST);
-        if (layout.commandDirs.has(head))
-            return path.join(c.root, CANONICAL_COMMAND_DIR, `${rest}.md`);
-        if (layout.agentDirs.has(head))
-            return path.join(c.root, CANONICAL_AGENT_DIR, `${rest}.md`);
-    }
-    return path.join(c.root, `${posix}.md`);
-}
 /** List native read spellings. */
 export function readCandidatesToolDir(layout, c, conceptId) {
     const posix = toPosix(conceptId);
@@ -263,7 +240,6 @@ export function makeToolDirAdapter(layout, looksLikeRoot) {
         renderExecutionSource: (c, file) => renderToolDirExecutionSource(layout, c, file),
         validate: (c, changes, ctx) => validateToolDir(layout, c, changes, ctx),
         readCandidates: (c, conceptId) => readCandidatesToolDir(layout, c, conceptId),
-        placeNew: (c, conceptId) => placeNewToolDir(layout, c, conceptId),
         directoryList: () => [CANONICAL_COMMAND_DIR, CANONICAL_AGENT_DIR, CANONICAL_SKILL_DIR],
         looksLikeRoot,
     };

package/dist/core/adapter/adapters/website-snapshot-adapter.js

@@ -15,8 +15,8 @@
  * `stash/knowledge/` prefix. `manifest.json` is snapshot PROVENANCE
  * (`{url, fetchedAt}`), read by the probe but never indexed as a concept.
  *
- * Read-only ⇒ NO `placeNew` (Mode B export routes content through the
- * DESTINATION adapter, which owns placement). `validate` runs base checks only
+ * Read-only (Mode B export routes content through the DESTINATION adapter,
+ * which owns placement). `validate` runs base checks only
  * (a mirror the adapter does not author has no native validators); `updated`
  * never appears on a snapshot page, so `missing-updated` is filtered out.
  *
@@ -129,8 +129,8 @@ export const websiteSnapshotAdapter = {
         const canonical = toPosix(conceptId).replace(/\.md$/i, "");
         return [{ path: path.join(c.root, PAGES_PREFIX, `${canonical}.md`), conceptId: canonical }];
     },
-    // No placeNew: the snapshot is READ-ONLY (Mode A). Export (Mode B) routes
-    // content through the DESTINATION adapter, which owns placement.
+    // The snapshot is READ-ONLY (Mode A). Export (Mode B) routes content through
+    // the DESTINATION adapter, which owns placement.
     /**
      * Install-time probe (§1.2): a root carrying the snapshot provenance
      * `manifest.json` (`{url, fetchedAt}`). No other bundle root carries this

package/dist/core/adapter/recognize-match.js

@@ -7,10 +7,9 @@ import { directoryMatcher, extensionMatcher, parentDirHintMatcher, smartMdMatche
  * registration index `runMatchers` uses for tie-breaking. (The `wiki` matcher
  * was removed in chunk 4 — the wiki asset-type is retired; LLM Wiki content is
  * served by the first-class `llm-wiki` adapter, not the akm adapter. The old
- * YAML workflow-program matcher is also gone: peer Markdown and GitHub-shaped
- * `.yml` workflow sources are both path-owned by residence under `workflows/`
- * (with Markdown frontmatter as an additional signal), while source IR owns
- * their distinct parse/compile semantics.)
+ * YAML workflow-program matcher is also gone: Markdown workflow sources are
+ * path-owned by residence under `workflows/`, with Markdown frontmatter as an
+ * additional signal.)
  */
 const AKM_MATCHERS = [
     extensionMatcher,

package/dist/core/common.js

@@ -4,7 +4,6 @@
 import crypto from "node:crypto";
 import fs from "node:fs";
 import path from "node:path";
-import { migrateLegacySourceShape } from "./config/legacy-source-shape-shim.js";
 import { ConfigError } from "./errors.js";
 import { getConfigPath, getDefaultStashDir, getRegistryCacheDir, getRegistryIndexCacheDir } from "./paths.js";
 // ── Constants ───────────────────────────────────────────────────────────────
@@ -306,7 +305,7 @@ function readStashDirFromConfig() {
         const parsed = JSON.parse(stripJsonComments(text));
         if (typeof parsed !== "object" || parsed === null)
             return undefined;
-        const raw = migrateLegacySourceShape(parsed, configPath);
+        const raw = parsed;
         // 0.9.0 config-shape cutover (spec §10.1): the primary stash is the
         // `defaultBundle`'s filesystem `path`. Read it directly (no config module
         // import) so the primary-stash location survives the stashDir → bundles
@@ -920,6 +919,23 @@ export function wellFormedUnicode(value) {
 export function isRecord(value) {
     return typeof value === "object" && value !== null && !Array.isArray(value);
 }
+/** The value when it is a plain object, else undefined (for `?.` chains over unknown JSON). */
+export function asRecord(value) {
+    return isRecord(value) ? value : undefined;
+}
+/**
+ * Parse JSONC: comments stripped by {@link stripJsonComments}, and trailing
+ * commas (`[a, b,]`, `{"k": 1,}`) tolerated, as OpenCode's own `.jsonc` reader does.
+ */
+export function parseJsonc(text) {
+    const stripped = stripJsonComments(text);
+    try {
+        return JSON.parse(stripped);
+    }
+    catch {
+        return JSON.parse(stripped.replace(/,(\s*[}\]])/g, "$1"));
+    }
+}
 /** `JSON.parse` that returns `undefined` instead of throwing. */
 export function tryParseJson(raw) {
     try {

package/dist/core/config/config-schema.js

@@ -39,8 +39,8 @@
  *   enforced at save time via `superRefine` on the top-level schema.
  */
 import { z } from "zod";
-import { HARNESS_MODEL_WORK_IDS } from "../../integrations/harnesses/ids.js";
-import { BUILTIN_IMPROVE_STRATEGY_NAMES, IMPROVE_ENGINE_PROCESSES } from "./engine-semantics.js";
+import { HARNESS_MODEL_WORK_IDS } from "../../integrations/harnesses/index.js";
+import { BUILTIN_IMPROVE_STRATEGY_NAMES, IMPROVE_ENGINE_PROCESSES, REMOVED_IMPROVE_STRATEGY_NAMES, } from "./engine-semantics.js";
 import { EmbeddingConnectionConfigSchema } from "./schema/embedding.js";
 import { EnginesSchema } from "./schema/engines.js";
 import { ExecutionPolicyConfigSchema } from "./schema/execution.js";
@@ -113,8 +113,9 @@ export const AkmConfigShape = {
     index: IndexConfigSchema.optional(),
     registries: z.array(RegistryConfigEntrySchema).optional(),
     // `bundles` + `defaultBundle` are the only source configuration shape. The
-    // retired `stashDir`/`sources[]`/`installed[]` keys are rejected at load;
-    // there is no runtime config translator. `defaultBundle` names the primary
+    // retired `stashDir`/`sources[]`/`installed[]` keys are rejected at load,
+    // naming the 0.9.x `akm migrate apply` that converts them; there is no
+    // runtime config translator. `defaultBundle` names the primary
     // bundle used for short-ref resolution.
     bundles: BundlesConfigSchema.optional(),
     defaultBundle: nonEmptyString.optional(),
@@ -138,8 +139,10 @@ export const AkmConfigBaseSchema = z.object(AkmConfigShape).passthrough();
  * Per-key overrides for unsupported pre-cutover source shapes.
  */
 const RETIRED_SOURCE_SHAPE_KEY_MESSAGES = {
-    stashDir: "stashDir is not supported; configure `bundles`, or use `akm config path --all` / `akm info` to inspect current paths.",
+    stashDir: "stashDir is not supported; configure `bundles`, or use `akm info` to inspect current paths.",
 };
+/** The one message for a config older than 0.9.15: only akm 0.9.x converts it. */
+const PRE_FLOOR_CONFIG_REMEDY = "This config predates akm 0.9.15 and 0.10 does not convert it: run `akm migrate apply` with akm 0.9.x, then upgrade.";
 export const AkmConfigSchema = AkmConfigBaseSchema.superRefine((config, ctx) => {
     const raw = config;
     // Only the current source shape enters the runtime. There is no config
@@ -149,7 +152,7 @@ export const AkmConfigSchema = AkmConfigBaseSchema.superRefine((config, ctx) =>
             ctx.addIssue({
                 code: z.ZodIssueCode.custom,
                 path: [key],
-                message: RETIRED_SOURCE_SHAPE_KEY_MESSAGES[key] ?? `${key} is not supported; configure the current bundles shape`,
+                message: `${RETIRED_SOURCE_SHAPE_KEY_MESSAGES[key] ?? `${key} is not supported; configure the current bundles shape`} ${PRE_FLOOR_CONFIG_REMEDY}`,
             });
         }
     }
@@ -194,15 +197,6 @@ export const AkmConfigSchema = AkmConfigBaseSchema.superRefine((config, ctx) =>
             });
         }
     }
-    for (const key of ["llm", "agent", "improve"]) {
-        if (config.defaults && key in config.defaults) {
-            ctx.addIssue({
-                code: z.ZodIssueCode.custom,
-                path: ["defaults", key],
-                message: `defaults.${key} is retired in 0.9`,
-            });
-        }
-    }
     for (const [name, engine] of Object.entries(config.engines ?? {})) {
         if (engine.kind === "agent" && engine.llmEngine) {
             const fallback = config.engines?.[engine.llmEngine];
@@ -267,6 +261,9 @@ export const AkmConfigSchema = AkmConfigBaseSchema.superRefine((config, ctx) =>
         // (src/commands/improve/improve-strategies.ts) refuses it lazily, at
         // improve-invocation time, with the same message either way.
         defaultStrategy !== "graph-refresh" &&
+        // The strategies removed in 0.10 (#1130) are exempt for the same reason:
+        // `resolveImproveStrategy` refuses them lazily, naming `default`.
+        !REMOVED_IMPROVE_STRATEGY_NAMES.includes(defaultStrategy) &&
         !BUILTIN_IMPROVE_STRATEGY_NAMES.includes(defaultStrategy) &&
         !config.improve?.strategies?.[defaultStrategy]) {
         ctx.addIssue({

package/dist/core/config/config-types.js

@@ -1,21 +1,12 @@
 // 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/.
-// VALID_HARNESS_IDS / HARNESS_AGENT_DISPATCH_IDS derive from the dependency-free
-// harnesses/ids.ts leaf (WI-9.8 KILL 3), NOT the full HARNESS_REGISTRY barrel
-// (`../../integrations/harnesses`) — that barrel transitively pulls in every
-// harness's agent-builder and the agent runtime, which is what fused config
-// into the same import-cycle SCC as `integrations/agent/*`. `harnesses/index.ts`
-// asserts at construction time that its registry matches this leaf, so the two
-// cannot silently drift (see `tests/harnesses-registry.test.ts` for the
-// value-level pin). config ← harnesses/ids is the only import direction (the
-// leaf imports nothing), so there is no cycle.
-import { HARNESS_AGENT_DISPATCH_IDS, VALID_HARNESS_IDS } from "../../integrations/harnesses/ids.js";
+// Harness ids derive from the harness registry; nothing the registry imports
+// reaches `core/config` at runtime, so there is no cycle.
+import { HARNESS_AGENT_DISPATCH_IDS, VALID_HARNESS_IDS } from "../../integrations/harnesses/index.js";
 /**
- * Canonical list of valid agent harness / platform ids. Derived from the
- * dependency-free harness-id leaf (#562/WI-9.8) so the Zod `AgentPlatformSchema`
- * enum, the agent-engine platform union, and setup's `DetectedHarness` union
- * all derive from one place and cannot drift. Add a harness in
- * `src/integrations/harnesses/index.ts` (and its `ids.ts` mirror entry).
+ * Canonical list of valid agent harness / platform ids, derived from the harness
+ * registry so the Zod `AgentPlatformSchema` enum, the agent-engine platform
+ * union, and setup's `DetectedHarness` union cannot drift.
  */
 export { HARNESS_AGENT_DISPATCH_IDS, VALID_HARNESS_IDS };

package/dist/core/config/config-walker.js

@@ -34,11 +34,11 @@ import { isApiKeyReference } from "./schema/primitives.js";
  */
 function parsePath(dotted) {
     if (!dotted) {
-        throw new UsageError("Config key is required.", "INVALID_FLAG_VALUE", unknownKeyHint(""));
+        throw new UsageError("Config key is required.", "INVALID_FLAG_VALUE", unknownKeyHint());
     }
     const segments = dotted.split(".");
     if (segments.some((s) => !s)) {
-        throw new UsageError(`Invalid config key "${dotted}": empty segment between dots.`, "INVALID_FLAG_VALUE", unknownKeyHint(dotted));
+        throw new UsageError(`Invalid config key "${dotted}": empty segment between dots.`, "INVALID_FLAG_VALUE", unknownKeyHint());
     }
     return segments;
 }
@@ -150,7 +150,7 @@ export function configGet(config, dotted) {
     const path = parsePath(dotted);
     const schema = resolveSchemaAt(path, config);
     if (!schema) {
-        throw new UsageError(`Unknown config key: ${dotted}`, "INVALID_FLAG_VALUE", unknownKeyHint(dotted));
+        throw new UsageError(`Unknown config key: ${dotted}`, "INVALID_FLAG_VALUE", unknownKeyHint());
     }
     let cursor = config;
     for (const segment of path) {
@@ -266,7 +266,7 @@ export function configUnset(config, dotted) {
     // Validate the path resolves to a real schema field (so typos don't no-op).
     const schema = resolveSchemaAt(path, config);
     if (!schema) {
-        throw new UsageError(`Unknown config key: ${dotted}`, "INVALID_FLAG_VALUE", unknownKeyHint(dotted));
+        throw new UsageError(`Unknown config key: ${dotted}`, "INVALID_FLAG_VALUE", unknownKeyHint());
     }
     return unsetPath(config, path);
 }
@@ -467,24 +467,7 @@ function unsetPath(config, path) {
     return next;
 }
 // ── Hint generation (#460) ──────────────────────────────────────────────────
-/**
- * Per-key "use X instead" guidance for config keys retired before the 0.9
- * cutover, keyed on the first dotted-path segment. Mitigation item 3: the
- * generic "valid top-level keys" hint doesn't tell a pre-0.9 user what
- * replaced the key they typed — this does.
- */
-const RETIRED_KEY_HINTS = {
-    stashDir: "stashDir was removed in 0.9; get the stash path from `akm config path --all` or `akm info`.",
-    sources: "sources is not supported; configure `bundles` instead.",
-    installed: "installed is not supported; configure `bundles` instead.",
-    wikiName: "the wiki subsystem was removed in 0.9; wikis are ordinary knowledge assets now — see `akm import`.",
-    wiki: "the wiki subsystem was removed in 0.9; wikis are ordinary knowledge assets now — see `akm import`.",
-    llm: "llm was replaced by named engines configuration in 0.9; configure `engines` instead.",
-};
-export function unknownKeyHint(attempted) {
+export function unknownKeyHint() {
     const keys = listTopLevelConfigKeys();
-    const generic = `Valid top-level keys: ${keys.join(", ")}. Use dotted paths for nested values (e.g. embedding.endpoint, engines.<name>.model).`;
-    const firstSegment = attempted.split(".")[0] ?? "";
-    const retiredHint = RETIRED_KEY_HINTS[firstSegment];
-    return retiredHint ? `${retiredHint} ${generic}` : generic;
+    return `Valid top-level keys: ${keys.join(", ")}. Use dotted paths for nested values (e.g. embedding.endpoint, engines.<name>.model).`;
 }

package/dist/core/config/config.js

@@ -5,18 +5,16 @@ import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
 import { isDeepStrictEqual } from "node:util";
-import { isBundleSlug, parseBundleRef } from "../asset/asset-ref.js";
+import { isBundleSlug } from "../asset/asset-ref.js";
 import { deriveBundleId } from "../bundle-id.js";
 import { isRecord, resolveStashDir } from "../common.js";
 import { ConfigError } from "../errors.js";
-import { liftLegacyEngineExtraParams } from "../extra-params.js";
 import { formatRegistryLabel, hasRegistryUrlCredentials } from "../registry-url.js";
 import { acquireConfigLock, backupExistingConfig, parseConfigText, readConfigText, withConfigLock, writeConfigAtomic, } from "./config-io.js";
 import { AkmConfigSchema, CURRENT_CONFIG_VERSION } from "./config-schema.js";
 import { bundleComponentConfig, bundleContentRoot, bundleContentRoots, bundleSourceId, bundlesToSourceEntries, filesystemBundleSourceId, isBundleEnabled, } from "./config-sources.js";
 import { resolveSchemaAt } from "./config-walker.js";
 import { deepMergeConfig, isPlainObject } from "./deep-merge.js";
-import { migrateLegacySourceShape } from "./legacy-source-shape-shim.js";
 import { isApiKeyReference, SECRET_STORE_REFERENCE_PATTERN } from "./schema/primitives.js";
 export { stripJsonComments } from "./config-io.js";
 import { getConfigPath } from "../paths.js";
@@ -95,18 +93,16 @@ export function loadUserConfig() {
  * Run the per-file config pipeline every raw config object goes through
  * before it is either validated (the local/top-level file) or merged in as
  * an `extends` base: JSONC parse already done by the caller, then the
- * `configVersion` read ({@link readConfigVersion}), then the legacy
- * `stashDir`/`sources[]`/`installed[]` shim, then the legacy `extraParams`
- * lift (#852). Unknown keys are not an error: the schema drops them in
- * memory. Shared by {@link parseAndValidateConfigText} (the local file) and
- * {@link resolveExtendsChain} (each base in the chain) so a fleet-shared base
- * config can carry its own `configVersion` / legacy shape independently of
+ * `configVersion` read ({@link readConfigVersion}). Unknown keys are not an
+ * error: the schema drops them in memory. A shape older than 0.9.15 is not
+ * converted here; it fails validation with a message naming `akm migrate
+ * apply` under akm 0.9.x. Shared by {@link parseAndValidateConfigText} (the
+ * local file) and {@link resolveExtendsChain} (each base in the chain) so a
+ * fleet-shared base config can carry its own `configVersion` independently of
  * the file that extends it.
  */
 function runConfigFilePipeline(text, sourcePath) {
-    const versioned = readConfigVersion(parseConfigText(text, sourcePath), sourcePath);
-    const parsedRaw = migrateLegacySourceShape(versioned, sourcePath);
-    return liftExtraParamsOrThrow(parsedRaw, sourcePath);
+    return readConfigVersion(parseConfigText(text, sourcePath), sourcePath);
 }
 /**
  * `configVersion` is read, never gated on. `"0.9.0"` is the only value akm
@@ -124,30 +120,6 @@ function readConfigVersion(raw, sourcePath) {
     }
     return { ...raw, configVersion: CURRENT_CONFIG_VERSION };
 }
-/**
- * #852 (following #815): a config still using legacy `extraParams` keys —
- * e.g. `reasoning_effort`, a documented 0.9.1 workaround — needs to be
- * rewritten onto the first-class engine field they now shadow. This used
- * to happen silently, in memory, on every load; that ran forever and never
- * converged. The lift itself is now `akm migrate apply`'s job (see
- * scripts/akm-migrate/migrate/config-extra-params.ts) and persists to disk, so a
- * config that has not been migrated yet fails closed here instead of
- * silently drifting from what's on disk.
- */
-function liftExtraParamsOrThrow(parsedRaw, sourcePath) {
-    const where = sourcePath ? ` at ${sourcePath}` : "";
-    const { config: liftedConfig, lifted, conflicts } = liftLegacyEngineExtraParams(parsedRaw);
-    if (conflicts.length > 0) {
-        const lines = conflicts
-            .map((c) => `  - engines.${c.engine}.extraParams.${c.key} (${JSON.stringify(c.extraParamsValue)}) conflicts with engines.${c.engine}.${c.field} (${JSON.stringify(c.fieldValue)})`)
-            .join("\n");
-        throw new ConfigError(`Invalid config${where}: extraParams and the first-class field disagree:\n${lines}\n\nEach extraParams key above has a first-class equivalent and akm will not guess which value you meant — remove the extraParams entry once the field carries the value you want.`, "INVALID_CONFIG_FILE");
-    }
-    if (lifted.length > 0) {
-        warnOnce(`config:extra-params-lift${sourcePath ? `:${sourcePath}` : ""}`, `Config${where} uses deprecated extraParams keys with first-class equivalents — auto-lifted in memory:\n  - ${lifted.join("\n  - ")}\n\nRun \`akm migrate apply\` to rewrite the config file and silence this warning.`);
-    }
-    return liftedConfig;
-}
 /**
  * Resolve a local file's `extends` chain and validate the merged result
  * (deep-merged under `DEFAULT_CONFIG`) via Zod ({@link AkmConfigSchema}).
@@ -184,10 +156,11 @@ function buildEffectiveConfig(liftedLocalRaw, sourcePath) {
  * guarantees apply as any other retired config key (AGENTS.md "Reading
  * persisted data"): a config setting one keeps loading, is named once by
  * the unknown-key warning, and is dropped only by `akm migrate apply`.
- * Both were retired in 0.9.17-alpha.9: `index.graph` (the LLM entity-graph
- * extraction pass) and `index.metadataEnhance` (LLM metadata enrichment).
+ * `index.graph` (the LLM entity-graph extraction pass) and
+ * `index.metadataEnhance` (LLM metadata enrichment) were retired in
+ * 0.9.17-alpha.9; `index.stalenessDetection` before them.
  */
-const RETIRED_CATCHALL_KEY_PATHS = new Set(["index.graph", "index.metadataEnhance"]);
+const RETIRED_CATCHALL_KEY_PATHS = new Set(["index.graph", "index.metadataEnhance", "index.stalenessDetection"]);
 /**
  * Every dotted key in `raw` the schema does not know, at any depth (arrays
  * are not descended). Unknown keys are never an error: they are a typo, or a
@@ -656,9 +629,9 @@ function configWriteBody(localRaw, current, next, persistTopLevelKeys = []) {
 }
 /**
  * The migrator's one config step. The reader already tolerates every shape
- * akm has written (`configVersion` read as current, legacy source layout,
- * `extraParams` lift, unknown keys dropped); this writes that current shape back to
- * `config.json` — the same body `mutateConfig` writes — so the tolerance
+ * 0.9.15 and later wrote (`configVersion` read as current, 0.9.16
+ * `{kind, ref, sourceId}` scheduler entries, unknown keys dropped); this
+ * writes that current shape back to `config.json` — the same body `mutateConfig` writes — so the tolerance
  * becomes durable. Reports without writing unless `apply` is set.
  */
 export function normalizeConfigFile(configPath, options) {
@@ -670,7 +643,7 @@ export function normalizeConfigFile(configPath, options) {
         const localRaw = runConfigFilePipeline(text, configPath);
         const current = buildEffectiveConfig(localRaw, configPath);
         const next = validateCompleteConfig({ ...current, configVersion: CURRENT_CONFIG_VERSION });
-        const body = withSchedulerOnDisk(configWriteBody(localRaw, current, next), next);
+        const body = configWriteBody(localRaw, current, next);
         for (const keyPath of unknownConfigKeyPaths(body))
             deleteConfigPath(body, keyPath);
         // `improve.strategies["graph-refresh"]` is schema-valid (any name is a
@@ -747,7 +720,6 @@ export async function mutateConfigWithPrecommit(mutate, precommit, options) {
         release();
     }
 }
-const UNBOUND_SCHEDULER_SOURCE_ID = `sha256:${"0".repeat(64)}`;
 /**
  * The source identity 0.9.16 bound a scheduler grant to: the configured
  * bundle's source id, or the implicit `AKM_BUNDLE_DIR` stash's. `undefined`
@@ -767,41 +739,6 @@ export function schedulerSourceIdFor(config, bundleId) {
         return undefined;
     }
 }
-/**
- * `scheduler.enabled` is a list of refs in memory but is written in the
- * `{kind, ref, sourceId}` shape 0.9.16 reads, so that release still runs
- * against a config this one wrote (the upgrade rehearsal's read-back). This
- * release reads either shape; the object form can go once no supported
- * release is strict about it.
- */
-function schedulerEnabledOnDisk(config) {
-    const enabled = config.scheduler?.enabled;
-    if (enabled === undefined)
-        return undefined;
-    return enabled.map((ref) => {
-        let bundle;
-        let conceptId = "";
-        try {
-            const parsed = parseBundleRef(ref);
-            bundle = parsed.bundle;
-            conceptId = parsed.conceptId;
-        }
-        catch {
-            return ref;
-        }
-        return {
-            kind: conceptId.startsWith("workflows/") ? "workflow" : "task",
-            ref,
-            sourceId: (bundle !== undefined ? schedulerSourceIdFor(config, bundle) : undefined) ?? UNBOUND_SCHEDULER_SOURCE_ID,
-        };
-    });
-}
-function withSchedulerOnDisk(body, config) {
-    const onDisk = schedulerEnabledOnDisk(config);
-    if (onDisk === undefined || !isPlainConfigObject(body.scheduler))
-        return body;
-    return { ...body, scheduler: { ...body.scheduler, enabled: onDisk } };
-}
 /**
  * Strip literal apiKey fields before writing config to disk.
  * API keys are expected to come from environment variables
@@ -866,7 +803,7 @@ export function sanitizeConfigForWrite(config) {
             warn(`Config sanitizer dropped registry entr${droppedRegistries.length === 1 ? "y" : "ies"} with URL credentials before writing to disk:\n  - ${droppedRegistries.join("\n  - ")}\n\nRegistry URLs must be credential-free; configure a credential-free HTTPS endpoint.`);
         }
     }
-    return withSchedulerOnDisk(sanitized, config);
+    return sanitized;
 }
 export function updateConfig(partial) {
     return mutateConfig((current) => deepMergeConfig(current, partial)).config;

package/dist/core/config/engine-semantics.js

@@ -2,11 +2,15 @@
 // 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/.
 export const ENGINE_NAME_PATTERN_SOURCE = "^(?!akm-)[a-z][a-z0-9]*(?:-[a-z0-9]+)*$";
-export const BUILTIN_IMPROVE_STRATEGY_NAMES = [
-    "default",
+export const BUILTIN_IMPROVE_STRATEGY_NAMES = ["default", "consolidate"];
+/**
+ * Built-in strategies removed in 0.10 (#1130, #1129). A user-defined strategy of the
+ * same name still resolves (it inherits `default`); naming one with no such
+ * block fails at resolution, not at config load.
+ */
+export const REMOVED_IMPROVE_STRATEGY_NAMES = [
     "quick",
     "thorough",
-    "consolidate",
     "catchup",
     "reflect-distill",
     "proactive-maintenance",

package/dist/core/config/schema/engines.js

@@ -7,13 +7,13 @@
  * no behavior change.
  */
 import { z } from "zod";
-// Harness ids come straight from the dependency-free `harnesses/ids` leaf (the
-// same source `config-types.ts` re-exports them from). Importing them here
-// rather than via `../config-types` keeps `schema/*` free of any edge to
-// `config-types`, which type-derives from this barrel via
-// `typeof import("./config-schema")` — routing through config-types would mint
-// a config-schema ↔ config-types type cycle that collapses inference.
-import { HARNESS_AGENT_DISPATCH_IDS, HARNESS_NATIVE_AGENT_IDS, VALID_HARNESS_IDS, } from "../../../integrations/harnesses/ids.js";
+// Harness ids come straight from the harness registry (the same source
+// `config-types.ts` re-exports them from). Importing them here rather than via
+// `../config-types` keeps `schema/*` free of any edge to `config-types`, which
+// type-derives from this barrel via `typeof import("./config-schema")` —
+// routing through config-types would mint a config-schema ↔ config-types type
+// cycle that collapses inference.
+import { HARNESS_AGENT_DISPATCH_IDS, HARNESS_NATIVE_AGENT_IDS, VALID_HARNESS_IDS, } from "../../../integrations/harnesses/index.js";
 import { WORKFLOW_MAX_TIMEOUT_MS } from "../../../workflows/resource-limits.js";
 import { chatCompletionsEndpoint, ExtraParamsSchema, engineName, nonEmptyString, positiveInt, symbolicOrWarnApiKey, } from "./primitives.js";
 /**