akm-cli 0.9.31 → 0.10.261001-beta

package/dist/commands/tasks/tasks-cli.js

@@ -27,14 +27,9 @@ import { getParsedInvocation } from "../../cli/invocation.js";
 import { parsePositiveIntFlag } from "../../cli/parse-args.js";
 import { defineGroupCommand, defineJsonCommand, EXIT_CODES, GLOBAL_OUTPUT_ARGS, output, outputWithExitCode, runWithJsonErrors, } from "../../cli/shared.js";
 import { UsageError } from "../../core/errors.js";
-import { resolveUsageEventSource } from "../../indexer/usage/usage-events.js";
-import { getOutputMode } from "../../output/context.js";
 import { TASK_RUN_BOOLEAN_FLAGS, TASK_RUN_VALUE_FLAGS } from "../../tasks/task-run-reserved-flags.js";
-import { akmSearch, parseSearchSource } from "../read/search.js";
-import { rejectRetiredSourceFlag } from "../read/search-cli.js";
 import { akmTaskExplain } from "./explain.js";
 import { akmTasksAdd, akmTasksDisable, akmTasksDoctor, akmTasksEnable, akmTasksHistory, akmTasksPrune, akmTasksRun, akmTasksSync, akmTasksSyncPlan, } from "./tasks.js";
-import { akmTaskValidate } from "./validate.js";
 /** Shared `--bundle <bundle>` arg wired onto every task subcommand. */
 const bundleArg = {
     bundle: {
@@ -70,31 +65,6 @@ function hasFlagNamed(name) {
     }
     return false;
 }
-/**
- * `--target` was renamed to `--bundle` on `task` in 0.9 (S8.4). citty is
- * non-strict, so the retired spelling is silently absorbed rather than
- * rejected — reject it explicitly instead (mirrors improve-cli.ts /
- * remember-cli.ts). The generic pre-dispatch gate cannot catch it either: it
- * exempts `target` on every `task` subcommand precisely so this handler can
- * answer with the rename (`../../cli/unknown-flags`'s `SELF_DIAGNOSED_FLAGS`),
- * and that exemption is keyed on the flag NAME — so `--target=team` must be
- * rejected here by name too, or nothing rejects it at all.
- *
- * Rejecting by NAME means `--target=<value>` can no longer carry a declared
- * task input named `target` either (0.9.2 review round 2). That is settled on
- * the DECLARATION side, not by narrowing this rejecter back to whole-token
- * matching: `target` is listed in `TASK_RUN_SELF_DIAGNOSED_FLAGS`
- * (`../../tasks/task-run-reserved-flags.ts`), so `parseInputDeclarations`
- * refuses `inputs: {target: …}` with TASK_SOURCE_INVALID at authoring time and
- * no task can reach `akm task run` needing the flag this throws on. Do not
- * re-narrow the match here — the silently-ignored `--target=team` that round 1
- * closed would come straight back.
- */
-function rejectRetiredTaskTargetFlag() {
-    if (!hasFlagNamed("target"))
-        return;
-    throw new UsageError("`akm task --target` was renamed to `--bundle` in 0.9. Use `--bundle <name>` instead.", "INVALID_FLAG_VALUE");
-}
 /**
  * `--scheduled` is `akm task run`'s own declared flag (an internal marker for
  * scheduler-generated runs) — `task explain` declares no such flag. Because
@@ -131,9 +101,7 @@ function rejectExplainScheduledFlag() {
 // that knows the task's declared contract (Stage 2, src/tasks/run/load-task.ts)
 // — coercion happens once, there. `akm task run`'s own declared flags
 // (GLOBAL_OUTPUT_ARGS, --bundle, --scheduled) are excluded so they are never
-// mistaken for inputs (B-33); `--target` is excluded too, but only because
-// `rejectRetiredTaskTargetFlag()` above always runs first and throws before
-// this is ever reached (B-32) — it is not itself special-cased below.
+// mistaken for inputs (B-33).
 // `TASK_RUN_VALUE_FLAGS` / `TASK_RUN_BOOLEAN_FLAGS` are re-exported here
 // (unchanged in name, location, and value) from a dependency-free leaf module
 // so `src/tasks/source/task-source-v4.ts` can reject a declared `inputs:`
@@ -212,7 +180,7 @@ const tasksAddCommand = defineJsonCommand({
         },
         command: {
             type: "string",
-            description: 'Exact shell string to run on the schedule (no AI agent), e.g. "akm improve --strategy reflect-distill".',
+            description: 'Exact shell string to run on the schedule (no AI agent), e.g. "akm improve --strategy consolidate".',
         },
         engine: { type: "string", description: "Engine to use for prompt targets (default: defaults.engine)" },
         model: { type: "string", description: "Model override for prompt targets" },
@@ -231,7 +199,6 @@ const tasksAddCommand = defineJsonCommand({
         },
     },
     async run({ args }) {
-        rejectRetiredTaskTargetFlag();
         const result = await akmTasksAdd({
             id: args.id,
             schedule: args.schedule,
@@ -274,7 +241,6 @@ const tasksRunCommand = defineCommand({
     },
     async run({ args, rawArgs }) {
         await runWithJsonErrors(async () => {
-            rejectRetiredTaskTargetFlag();
             const inputFlags = parseTaskInputFlags(rawArgs, args.id);
             const envelope = await akmTasksRun(args.id, {
                 scheduled: args.scheduled === true,
@@ -299,7 +265,6 @@ const tasksEnableCommand = defineJsonCommand({
         ...bundleArg,
     },
     async run({ args }) {
-        rejectRetiredTaskTargetFlag();
         output("task-enable", await akmTasksEnable(args.ref, { target: args.bundle }));
     },
 });
@@ -310,7 +275,6 @@ const tasksDisableCommand = defineJsonCommand({
         ...bundleArg,
     },
     async run({ args }) {
-        rejectRetiredTaskTargetFlag();
         output("task-disable", await akmTasksDisable(args.ref, { target: args.bundle }));
     },
 });
@@ -336,7 +300,6 @@ const tasksHistoryCommand = defineJsonCommand({
         ...bundleArg,
     },
     async run({ args }) {
-        rejectRetiredTaskTargetFlag();
         const limit = parsePositiveIntFlag(args.limit ?? undefined);
         const id = resolveTaskHistoryId(args.task, args.id);
         const result = await akmTasksHistory({ id, limit, target: args.bundle });
@@ -376,7 +339,6 @@ const tasksSyncCommand = defineJsonCommand({
         },
     },
     async run({ args }) {
-        rejectRetiredTaskTargetFlag();
         const rebind = args.rebind === true;
         if (args["dry-run"] === true) {
             const preview = await akmTasksSyncPlan({}, args.bundle, { rebind });
@@ -405,7 +367,6 @@ const tasksExplainCommand = defineJsonCommand({
         ...bundleArg,
     },
     async run({ args, rawArgs }) {
-        rejectRetiredTaskTargetFlag();
         // `--scheduled` must be rejected BEFORE the shared scanner below ever
         // sees it — the scanner treats it as `task run`'s own reserved flag
         // (silently skipped, never surfaced as unknown) rather than explain's,
@@ -434,35 +395,6 @@ const tasksDoctorCommand = defineJsonCommand({
         output("task-doctor", result);
     },
 });
-/**
- * #907: `akm task validate`'s exit-code contract — `valid` succeeds (exit
- * 0); `blocked`/`invalid`/`not-a-task` are diagnosed defects the caller must
- * act on (exit 1, mirroring `task sync`'s own `failures.length > 0 ->
- * EXIT_CODES.GENERAL`). A missing path or an unreadable file never reaches
- * this function at all — `akmTaskValidate` throws a `UsageError` for those,
- * which `defineJsonCommand`'s wrapping already maps to exit 2.
- */
-export function taskValidateExitCode(result) {
-    return result.outcome === "valid" ? undefined : EXIT_CODES.GENERAL;
-}
-const tasksValidateCommand = defineJsonCommand({
-    meta: {
-        name: "validate",
-        description: "Parse a single task file by filesystem path — not a concept ref, and the file need not live in a " +
-            "configured bundle — and report the same diagnostic `akm task sync` would produce for it. Read-only; " +
-            "never touches the scheduler.",
-    },
-    args: {
-        path: { type: "positional", description: "Filesystem path to a task source YAML file", required: true },
-    },
-    async run({ args }) {
-        const result = await akmTaskValidate(args.path);
-        output("task-validate", result);
-        const exitCode = taskValidateExitCode(result);
-        if (exitCode !== undefined)
-            process.exitCode = exitCode;
-    },
-});
 /**
  * #851: `akm task prune`'s exit-code contract mirrors `task sync --dry-run`'s
  * (`taskSyncDryRunExitCode` above) — non-zero whenever the preview lists
@@ -503,47 +435,6 @@ const tasksPruneCommand = defineJsonCommand({
         outputWithExitCode("task-prune", result, taskPruneExitCode(result));
     },
 });
-/**
- * #951: `akm task list` — a pure, zero-logic delegating alias for
- * `akm search --type task`. 0.9.0 removed `task list` because it was a
- * second, redundant IMPLEMENTATION of task listing, not because the
- * spelling itself was off-limits; this reuses `search`'s exact envelope
- * (its `results` alias comes along for free) instead of adding a second one.
- * `query`/`--limit`/`--from` are handled identically to `searchCommand.run()`
- * for the same inputs, including the retired `--source` guard (`../read/
- * search-cli.ts`'s `rejectRetiredSourceFlag`, reused rather than copied) so
- * `akm task list --source x` fails with the same actionable rename message
- * as `akm search --type task --source x` instead of citty's silent absorb.
- */
-const tasksListCommand = defineJsonCommand({
-    meta: { name: "list", description: "List task assets (alias for `akm search --type task`)" },
-    args: {
-        query: {
-            type: "positional",
-            description: "Search query (omit to list all tasks)",
-            required: false,
-            default: "",
-        },
-        limit: { type: "string", description: "Maximum number of results" },
-        from: { type: "string", description: "Search source (local|registry|all)", default: "local" },
-    },
-    async run({ args }) {
-        rejectRetiredSourceFlag();
-        const query = (args.query ?? "").trim();
-        const limit = parsePositiveIntFlag(args.limit ?? undefined);
-        const source = parseSearchSource(args.from);
-        const outputMode = getOutputMode();
-        const result = await akmSearch({
-            query,
-            type: "task",
-            limit,
-            source,
-            eventSource: resolveUsageEventSource(),
-            attributionProjection: outputMode.shape === "agent" ? "agent" : outputMode.detail,
-        });
-        output("search", result);
-    },
-});
 export const taskCommand = defineGroupCommand({
     meta: {
         name: "task",
@@ -555,16 +446,14 @@ export const taskCommand = defineGroupCommand({
         disable: tasksDisableCommand,
         run: tasksRunCommand,
         explain: tasksExplainCommand,
-        validate: tasksValidateCommand,
         history: tasksHistoryCommand,
-        list: tasksListCommand,
         sync: tasksSyncCommand,
         prune: tasksPruneCommand,
         doctor: tasksDoctorCommand,
     },
     // Bare `akm task` reports scheduler diagnostics. Deeper inspection of
-    // individual tasks is the generic `akm show <bundle//tasks/id>`; `list`
-    // above is a delegating alias for `akm search --type task` (#951).
+    // individual tasks is the generic `akm show <bundle//tasks/id>`; listing is
+    // `akm search --type task`.
     // No `defaultRun`: bare `akm task` is a usage error (exit 2), the canonical
     // bare-group behavior — owner ruling 12. Run `akm task doctor` for what the
     // bare form used to run.

package/dist/commands/workflow/plan.js

@@ -16,13 +16,12 @@
  * `request.persona`, `request.conversation`, `request.runtime.environment`,
  * and a script target's `bytesBase64` are never read at all.
  */
-import path from "node:path";
 import { loadConfig } from "../../core/config/config.js";
 import { buildExecutionFromWire } from "../../integrations/agent/execution.js";
 import { freezeWorkflow } from "../../workflows/freeze/freeze.js";
 import { computePlanHash } from "../../workflows/ir/plan-hash.js";
 import { loadWorkflowAsset } from "../../workflows/runtime/workflow-asset-loader.js";
-/** The step's dispatch unit — the map template for a fan-out, else the root unit. Undefined for a route step. */
+/** The step's dispatch unit — the map template for a fan-out, else the root unit. Undefined for a step not yet frozen. */
 function stepUnit(step) {
     const root = step.root;
     if (!root)
@@ -41,41 +40,23 @@ function projectInputBinding(binding) {
         ? { name: binding.name, kind: "literal", value: binding.value }
         : { name: binding.name, kind: "reference", from: binding.from };
 }
-function childExportedOutputNames(frozenPlan) {
-    return frozenPlan.outputs ? Object.keys(frozenPlan.outputs) : ["runId", "status"];
-}
-/**
- * A `child-workflow` target's `expansion`. Recurses into the embedded
- * plan's own steps in the identical shape — `usesById` is
- * omitted for the recursive call because a nested child's own authored
- * source is not available here (only its already-frozen plan is), so a
- * task-wrapped step nested inside a child conservatively reports `via:
- * "direct"` rather than guessing at its authoring surface.
- */
+/** A `child-workflow` target's `expansion`. Recurses into the embedded plan's own steps in the identical shape. */
 function childExpansion(target) {
     return {
         via: "child",
         childRef: target.ref,
         childPlanHash: target.planHash,
-        childVia: target.via,
-        ...(target.taskRef !== undefined ? { childTaskRef: target.taskRef } : {}),
-        childOutputs: childExportedOutputNames(target.frozenPlan),
-        steps: target.frozenPlan.steps.map((step, index) => projectStep(step, index, undefined)),
+        steps: target.frozenPlan.steps.map((step, index) => projectStep(step, index)),
     };
 }
-/** The task/child expansion boundary for one step (§4.6). */
-function stepExpansion(step, frozenTarget, usesById) {
-    if (frozenTarget?.kind === "child-workflow")
-        return childExpansion(frozenTarget);
-    const uses = usesById?.get(step.stepId);
-    if (uses?.startsWith("tasks/"))
-        return { via: "task", taskRef: uses };
-    return { via: "direct" };
+/** The child expansion boundary for one step (§4.6). */
+function stepExpansion(frozenTarget) {
+    return frozenTarget?.kind === "child-workflow" ? childExpansion(frozenTarget) : { via: "direct" };
 }
-function projectStep(step, sequenceIndex, usesById) {
+function projectStep(step, sequenceIndex) {
     const unit = stepUnit(step);
     const frozenTarget = unit?.frozenTarget;
-    const kind = step.route ? "route" : step.root?.kind === "map" ? "map" : "unit";
+    const kind = step.root?.kind === "map" ? "map" : "unit";
     const inputBindings = frozenTarget?.inputBindings;
     return {
         stepId: step.stepId,
@@ -92,7 +73,7 @@ function projectStep(step, sequenceIndex, usesById) {
             judgeEngine: step.gate.frozenJudge ? step.gate.frozenJudge.request.engine.name : null,
         },
         ...(step.outputSchema !== undefined ? { outputSchema: step.outputSchema } : {}),
-        expansion: stepExpansion(step, frozenTarget, usesById),
+        expansion: stepExpansion(frozenTarget),
     };
 }
 /**
@@ -130,13 +111,11 @@ export async function akmWorkflowPlan(ref) {
     const config = loadConfig();
     const frozen = await freezeWorkflow(asset, config);
     const plan = frozen.plan;
-    const usesById = new Map(asset.plan.steps.map((step) => [step.stepId, step.spec?.uses]));
-    const sourceFormat = path.extname(asset.path).toLowerCase() === ".md" ? "markdown" : "github-yaml";
     return {
         ok: true,
         ref: asset.ref,
         title: asset.title,
-        sourceFormat,
+        sourceFormat: "markdown",
         sourcePath: asset.path,
         irVersion: plan.irVersion,
         planHash: computePlanHash(plan),
@@ -144,8 +123,7 @@ export async function akmWorkflowPlan(ref) {
         execution: plan.execution,
         ...(plan.budget ? { budget: plan.budget } : {}),
         ...(plan.params ? { params: plan.params } : {}),
-        ...(plan.outputs ? { outputs: plan.outputs } : {}),
-        steps: plan.steps.map((step, index) => projectStep(step, index, usesById)),
+        steps: plan.steps.map((step, index) => projectStep(step, index)),
         notices: collectLoweringNotices(plan, config),
         warnings: frozen.warnings.map((warning) => warning.message),
     };

package/dist/commands/workflow-cli.js

@@ -4,8 +4,8 @@
 /**
  * `akm workflow` command family. `run` is the canonical start/resume/execute
  * surface; the former public `start`, `next`, and `complete` lifecycle is gone.
- * `create --print` emits Markdown; execution accepts peer `.md` and
- * GitHub-shaped `.yml` workflow sources. Validate with `akm lint --type workflows`.
+ * `create --print` emits Markdown, the only workflow source format. Validate
+ * with `akm lint --type workflows`.
  */
 import { getStringArg } from "../cli/parse-args.js";
 import { defineGroupCommand, defineJsonCommand, EXIT_CODES, output, outputWithExitCode } from "../cli/shared.js";
@@ -129,11 +129,6 @@ const workflowCreateCommand = defineJsonCommand({
             description: "Overwrite an existing workflow. Combined with --from, replaces its content; alone, replaces it with a fresh template.",
             default: false,
         },
-        reset: {
-            type: "boolean",
-            description: "Deprecated alias for --force with no --from (replaces an existing workflow with a fresh template).",
-            default: false,
-        },
         print: {
             type: "boolean",
             description: "Print the RAW template that would be written to stdout without creating anything — pipe it to a file as a starter document",

package/dist/core/adapter/adapter-ids.js

@@ -2,8 +2,7 @@
 // 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/.
 /**
- * Dependency-free adapter-id table (#909) — mirrors
- * `src/integrations/harnesses/ids.ts`'s split from its own heavy barrel.
+ * Dependency-free adapter-id table (#909).
  *
  * `core/config/schema/sources-bundles.ts` needs one small, DATA-shaped fact
  * about the adapter registry: the canonical ordered id list, to validate

package/dist/core/adapter/adapters/agent-skills-adapter.js

@@ -231,10 +231,6 @@ export const agentSkillsAdapter = {
     readCandidates(c, conceptId) {
         return [{ path: path.join(c.root, conceptId, SKILL_MANIFEST), conceptId }];
     },
-    /** A skill places to `<name>/SKILL.md`; the conceptId IS the package directory (spec §4.5). */
-    placeNew(c, conceptId) {
-        return path.join(c.root, conceptId, SKILL_MANIFEST);
-    },
     /** Install-time probe (§1.2): a root that directly contains one or more `<name>/SKILL.md` skill packages. */
     looksLikeRoot(root) {
         let entries;

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

@@ -39,23 +39,22 @@
  * conceptId = `<stash-subdir>/<canonical-name>` — the placement stash-subdir
  * (`stashDirFor(type)`) followed by the winning type's canonical name
  * (`deriveCanonicalAssetNameFromStashRoot`: skill = its dir, script keeps its
- * extension, Markdown strips `.md`, workflow strips its peer `.md`/`.yml`
+ * extension, Markdown strips `.md`, workflow strips its `.md`
  * extension, env/task strip their ext, and secret/session keep the natural
  * path). For Markdown types this IS the OKF concept ID (path − `.md`); it is
- * the same spelling {@link placeNew} consumes, so
- * recognize/place share one identity (D-R2 resolved the earlier split). The
+ * the same spelling `readCandidates` consumes, so
+ * recognize/read share one identity (D-R2 resolved the earlier split). The
  * `type` is carried separately on `IndexDocument.type`, per §0.2 (type ≠
  * identity), and `entry.name` keeps the BARE canonical name for FTS parity.
  *
- * ── placeNew / directoryList / looksLikeRoot: type-driven placement ──
+ * ── readCandidates / directoryList / looksLikeRoot: type-driven placement ──
  *
  * Placement is type-driven (`path-resolver.ts#buildDiskCandidates`: the primary
  * candidate is `assetPathForName(ref.type, join(root, stashDirFor(ref.type)),
- * ref.name)`). §5.1 removes `type` from the ref, so {@link placeNew} recovers
+ * ref.name)`). §5.1 removes `type` from the ref, so `readCandidates` recovers
  * it from the conceptId's LEADING path segment — the qualified `<stash-subdir>/
  * <name>` form of §1.3 — reverse-mapping that segment against the placement
- * stash-subdir map and then delegating to `assetPathForName`. See the method
- * doc for the recognize/place conceptId-spelling note.
+ * stash-subdir map and then delegating to `assetPathCandidatesForName`.
  *
  * ── validate: base checks only (WI-B) ──
  *
@@ -82,11 +81,11 @@
 import fs from "node:fs";
 import path from "node:path";
 import { applyPostContributorFields, applyPreContributorFields, extractPackageMetadata, getMarkdownFragmentContent, hasMarkdownFragmentContent, setMarkdownFragmentContent, } from "../../../indexer/passes/metadata.js";
-import { assetPathCandidatesForName, assetPathForName, deriveCanonicalAssetNameFromStashRoot, placementTypes, stashDirFor, stashDirNames, } from "../../asset/asset-placement.js";
+import { assetPathCandidatesForName, deriveCanonicalAssetNameFromStashRoot, placementTypes, stashDirFor, stashDirNames, } from "../../asset/asset-placement.js";
 import { parseFrontmatter } from "../../asset/frontmatter.js";
 import { executionDefaultsFromFrontmatter, renderMarkdownExecutionSource } from "../execution-source.js";
 import { recognizeMatch } from "../recognize-match.js";
-import { perTypeValidateChecks, skillDirectoryDiagnostics, workflowYamlSourceDiagnostics } from "./akm-lint.js";
+import { perTypeValidateChecks, skillDirectoryDiagnostics } from "./akm-lint.js";
 import { applyFoldedMetadata, foldRecognizedMetadata } from "./akm-metadata.js";
 import { hashContent, RESERVED_FILES, runBaseValidateChecks } from "./shared.js";
 // `recognizeMatch` + the builtin matcher list moved to the cycle-free leaf
@@ -285,7 +284,7 @@ function recognize(c, file) {
     const stashDir = stashDirFor(match.type);
     const canonicalName = stashDir !== undefined ? conceptId.slice(stashDir.length + 1) : conceptId;
     // conceptId = the QUALIFIED `<stash-subdir>/<canonical-name>` spelling
-    // (ref-grammar decision D-R2): the same form `placeNew` consumes; Markdown
+    // (ref-grammar decision D-R2): the same form `readCandidates` consumes; Markdown
     // types use the OKF concept ID (path − .md), while workflows strip either
     // peer source extension. Both branches feed a
     // BARE canonicalName (the abstain fallback is the basename, above), so the
@@ -419,12 +418,6 @@ async function validate(c, changes, ctx) {
         const overlay = buildOverlayContext(c.root, change.path, raw);
         const match = recognizeMatch(overlay);
         const type = match?.type;
-        // A complete GitHub-shaped `on` + `jobs` document is workflow-owned. It
-        // never flows through task-v3 parsing or Markdown base/frontmatter checks.
-        if (type === "workflow" && overlay.ext === ".yml") {
-            diagnostics.push(...workflowYamlSourceDiagnostics(change.path, raw, change.path, c.root).errors);
-            continue;
-        }
         // Task parsing belongs to perTypeValidateChecks' canonical v3 parser. Base
         // checks need only a frontmatter-free placeholder here.
         let parsed;
@@ -519,38 +512,6 @@ export const akmAdapter = {
             conceptId: posix,
         }));
     },
-    /**
-     * Type-driven placement (§5.1), reproducing `path-resolver.ts#buildDiskCandidates`:
-     * the primary candidate is
-     * `assetPathForName(type, join(root, stashDirFor(type)), name)`.
-     *
-     * §5.1 removes `type` from the ref, so the winning type is recovered from the
-     * conceptId's LEADING path segment — the §1.3 qualified `<stash-subdir>/<name>`
-     * form (e.g. `knowledge/http-caching`, `workflows/release`, `skills/<dir>`).
-     * The leading segment is reverse-mapped against the placement stash-subdir map;
-     * the remainder is the per-type name handed to `assetPathForName`. An
-     * unqualified conceptId (no recognized leading stash-subdir) falls back to a
-     * direct `<root>/<conceptId>.md` — the same `${name}.md` fallback
-     * `buildDiskCandidates` carries (`preserveDirectNameFallback`).
-     *
-     * `recognize()` emits the SAME qualified spelling (ref-grammar decision
-     * D-R2), so recognize/place share one canonical identity — the earlier
-     * bare-vs-qualified split is resolved.
-     */
-    placeNew(c, conceptId) {
-        const posix = conceptId.replace(/\\/g, "/");
-        const slash = posix.indexOf("/");
-        if (slash > 0) {
-            const head = posix.slice(0, slash);
-            const rest = posix.slice(slash + 1);
-            const type = stashDirToType(head);
-            if (type !== undefined && rest.length > 0) {
-                const typeDir = path.join(c.root, head);
-                return assetPathForName(type, typeDir, rest);
-            }
-        }
-        return path.join(c.root, `${posix}.md`);
-    },
     /** The AKM workspace's owned stash subdirs (§7): the placement stash-subdir names, feeding git exact-path staging. */
     directoryList(_c) {
         return [...new Set(stashDirNames())];

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

@@ -52,6 +52,8 @@
  */
 import path from "node:path";
 import { isDangerousEnvKey } from "../../../commands/lint/env-key-rules.js";
+import { backendNameForPlatform } from "../../../tasks/backends/index.js";
+import { assertTaskScheduleCronValid, assertTaskScheduleInputsSatisfyContract } from "../../../tasks/schedule-gates.js";
 import { parseTaskSource } from "../../../tasks/source/parse-task-source.js";
 import { taskSourceErrorDetail } from "../../../tasks/source-v3.js";
 import { checkWorkflowPlan, compileWorkflowSource } from "../../../workflows/compile.js";
@@ -216,7 +218,6 @@ export async function perTypeValidateChecks(args) {
         case "task":
             return taskDiagnostics(relPath, raw, workspaceRoot);
         case "workflow":
-            // Markdown lint handles `.md`; peer GitHub-shaped `.yml` sources enter through the workflow source adapter.
             return ext === ".md" ? workflowDiagnostics(relPath, raw, body) : [];
         case "memory":
             return memoryDiagnostics(relPath, data, body, ctx);
@@ -259,14 +260,21 @@ export function factDiagnostics(relPath, data) {
  * through the strict task-v3 grammar, `version: 4` through task source v4.
  * Keeping raw YAML at this boundary preserves duplicate-key, alias/tag,
  * source-location, descriptor, resource-bound, and migration-hint behavior.
+ *
+ * A file that parses must also pass the two per-source gates `akm task sync`
+ * runs before it installs a schedule (the schedule inputs satisfy the declared
+ * contract; the cron suits the local scheduler backend), so `akm lint --type
+ * tasks` never reports clean a task that sync would refuse.
  */
 export function taskDiagnostics(relPath, raw, workspaceRoot) {
     try {
-        parseTaskSource({
+        const parsed = parseTaskSource({
             filePath: relPath,
             yaml: raw,
             ...(workspaceRoot ? { workspaceRoot } : {}),
         });
+        assertTaskScheduleInputsSatisfyContract(parsed.v4, relPath);
+        assertTaskScheduleCronValid(parsed.v4, backendNameForPlatform());
         return [];
     }
     catch (cause) {
@@ -310,30 +318,6 @@ export function workflowStructureDiagnostics(relPath, raw, parsePath) {
 function lineOf(err) {
     return typeof err.line === "number" && Number.isFinite(err.line) && err.line > 0 ? { line: err.line } : {};
 }
-/**
- * Compile one peer GitHub-shaped `.yml` source through the shared source-IR
- * frontend. YAML has no Markdown frontmatter/base/stub pass and currently
- * emits fatal source diagnostics only; keeping the same two-channel result
- * shape lets the ordinary sweep and both workflow adapters route it exactly
- * like the established Markdown frontend without inventing another parser.
- */
-export function workflowYamlSourceDiagnostics(relPath, raw, parsePath, workspaceRoot) {
-    if (isAkmRegistryCachePath(parsePath))
-        return { errors: [], warnings: [] };
-    const compiled = compileWorkflowSource(raw, { path: parsePath, workspaceRoot });
-    if (compiled.ok)
-        return { errors: [], warnings: [] };
-    return {
-        errors: compiled.errors.map((error) => ({
-            file: relPath,
-            issue: "invalid-workflow-structure",
-            detail: error.message,
-            fixed: false,
-            ...lineOf(error),
-        })),
-        warnings: [],
-    };
-}
 /**
  * ONE parse+compile of a workflow through the unified frontend, returning both
  * halves of what it produces: fatal `invalid-workflow-structure` findings, and

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

@@ -1,60 +1,6 @@
 // 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/.
-/**
- * Index-time metadata fold for the `akm` adapter's `recognize` — akm 0.9.0
- * chunk-2, WI-C, implementing spec §2 ("the nine index-time metadata
- * contributors move into recognize") + the workflow contributor.
- *
- * This leaf reproduces the 11 `registerMetadataContributor` sites keyed on the
- * winning RENDERER name (exactly how each contributor's `appliesTo({ rendererName })`
- * selects):
- *
- *   - `output/renderers.ts` (9): toc-metadata (knowledge-md),
- *     lesson-frontmatter-metadata, memory-frontmatter-metadata,
- *     script-comment-metadata, env-file-metadata, secret-file-metadata,
- *     task-yaml-metadata, session-md-metadata, fact-md-metadata;
- *   - `workflows/renderer.ts` (1): workflow-document-metadata (the historical
- *     `workflow-md` renderer id now presents both peer workflow sources).
- *
- * ── Cycle-safety (chunk-2 ratchet, baseline 18) ──
- *
- * Imported ONLY by `akm-adapter.ts` (itself imported by nothing in `src/` — see
- * that file's header), so this leaf can never gain an inbound edge from a cycle
- * participant and therefore can never JOIN a cycle. It VALUE-imports the pure
- * parsers each contributor already uses so the fold cannot drift from them:
- * `parseFrontmatter`, `parseMarkdownToc`, the peer-source
- * `compileWorkflowSource` frontend/projection, and env key-name scanning.
- * `output/renderers.ts` / `workflows/renderer.ts` are the
- * cycle-sensitive modules whose contributor bodies live in this port — their
- * ONE non-importable helper (`metadata.ts#extractDescriptionFromComments`, a
- * heavy cycle-participant module) is copied verbatim below as
- * {@link extractDescriptionFromComments} rather than imported. Verified:
- * `bun scripts/lint-import-cycles.ts` stays at 18.
- *
- * ── What is folded, and where it lands on the IndexDocument ──
- *
- * The contributors mutate a `IndexDocument`; {@link foldRecognizedMetadata} returns
- * the same fields as a plain {@link FoldedMetadata}, which `recognize` maps onto
- * `IndexDocument` first-class fields (`tags`/`searchHints`/`description`/
- * `confidence`) and, for the fields without a first-class home
- * (`toc`/`parameters`/`source`), onto `documentJson` (opaque adapter extras).
- * The seed is a MINIMAL entry (name+type only): this isolates exactly what the
- * contributors add, which is what the parity test compares against
- * `applyMetadataContributors` run on the same minimal seed.
- *
- * ── Tolerance note ──
- *
- * Every contributor that reads/parses content is reproduced with the SAME
- * try/catch tolerance it has today (toc/memory/session/fact/task swallow parse
- * errors). Workflow source compilation fails closed in the drain (a broken
- * workflow is dropped); here the compile/projection is wrapped
- * so a broken workflow yields no folded metadata instead of throwing out of the
- * synchronous `recognize` — the drop-the-entry behavior is an index-drain
- * concern (Chunk 4/5), not recognition's. On the valid Chunk-0b fixture this
- * distinction never triggers.
- */
-import { parseBuiltinCommandAction } from "../../../commands/command/builtin-action.js";
 import { scanEnvKeyNames } from "../../../commands/env/env.js";
 import { parseTaskSource } from "../../../tasks/source/parse-task-source.js";
 import { compileWorkflowSource, workflowStepInstructions } from "../../../workflows/compile.js";
@@ -130,21 +76,6 @@ function applyFrontmatterDescriptionAndTags(fm, out) {
 function storedCommandRef(action) {
     return action?.kind === "stored" ? action.ref : undefined;
 }
-/** The asset a workflow step targets: its `uses:` ref, or the ref of a stored `akm/command`. Prose and `run:` steps target none. */
-function workflowStepTarget(spec) {
-    if (!spec?.uses)
-        return undefined;
-    if (spec.uses !== "akm/command")
-        return spec.uses;
-    if (spec.commandMode !== "stored-ref")
-        return undefined;
-    try {
-        return storedCommandRef(parseBuiltinCommandAction(spec.with));
-    }
-    catch {
-        return undefined;
-    }
-}
 /** Collect + finalize a searchHints set the way every contributor does (`Array.from(hints).filter(Boolean)`, assigned only when non-empty). */
 function finalizeHints(out, hints) {
     if (hints.size > 0)
@@ -352,9 +283,8 @@ export function foldRecognizedMetadata(rendererName, file) {
                     hints.add(workflowStepInstructions(step));
                     if (step.gate.criteria[0])
                         hints.add(step.gate.criteria[0]);
-                    const used = workflowStepTarget(step.spec);
-                    if (used)
-                        uses.add(used);
+                    if (step.spec?.workflow)
+                        uses.add(step.spec.workflow);
                 }
                 out.searchHints = Array.from(hints).filter(Boolean);
                 if (uses.size > 0)

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

@@ -114,11 +114,6 @@ export const akmTaskAdapter = {
             { path: path.join(c.root, `${posix}.yaml`), conceptId: posix },
         ];
     },
-    /** A task places to `<conceptId>.yml`; an already-suffixed conceptId is idempotent. */
-    placeNew(c, conceptId) {
-        const posix = toPosix(conceptId);
-        return path.join(c.root, /\.yml$/i.test(posix) ? posix : `${posix}.yml`);
-    },
     /** Tasks live anywhere under the component root. */
     directoryList() {
         return ["."];