akm-cli 0.9.16 → 0.9.17-alpha.10

package/dist/workflows/source-ir/triggers.js

@@ -1,79 +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/.
-import { asRecord, checkKeys, cloneBoundedJson, noGithubExpression, own, presentJsonValue, sourceError, stringField, TASK_V3_MAX_SCHEDULES, } from "../../tasks/source/bounded-document.js";
-const SOURCE_LABEL = "task v3 source";
-function ctxFrom(options) {
-    return {
-        filePath: options.filePath,
-        sourceLabel: SOURCE_LABEL,
-        ...(options.lineAt ? { lineAt: options.lineAt } : {}),
-    };
-}
-const ON_KEYS = ["schedule", "workflow_dispatch"];
-function parseOn(value, ctx) {
-    const input = asRecord(value, ctx, ["on"]);
-    const keys = Object.keys(input);
-    if (keys.length === 0)
-        sourceError(ctx, ["on"], "must declare schedule and/or workflow_dispatch.");
-    const unsupported = keys.find((key) => !ON_KEYS.includes(key));
-    if (unsupported)
-        sourceError(ctx, ["on", unsupported], "is an unsupported local service event; no scheduler binding was created.");
-    const schedules = [];
-    if (own(input, "schedule")) {
-        if (!Array.isArray(input.schedule) || input.schedule.length === 0) {
-            sourceError(ctx, ["on", "schedule"], "must be a non-empty list of {cron: string} records.");
-        }
-        if (input.schedule.length > TASK_V3_MAX_SCHEDULES) {
-            sourceError(ctx, ["on", "schedule"], `accepts at most ${TASK_V3_MAX_SCHEDULES} entries.`);
-        }
-        for (const [index, raw] of input.schedule.entries()) {
-            const entry = asRecord(raw, ctx, ["on", "schedule", index]);
-            checkKeys(entry, ["cron"], ctx, ["on", "schedule", index]);
-            if (!own(entry, "cron"))
-                sourceError(ctx, ["on", "schedule", index, "cron"], "is required.");
-            const cron = stringField(entry.cron, ctx, ["on", "schedule", index, "cron"], { nonempty: true });
-            noGithubExpression(cron, ctx, ["on", "schedule", index, "cron"]);
-            schedules.push(Object.freeze({ cron, source: `on.schedule[${index}].cron`, ordinal: index }));
-        }
-    }
-    let manual = false;
-    if (own(input, "workflow_dispatch")) {
-        const dispatch = input.workflow_dispatch;
-        if (dispatch !== null) {
-            const mapping = asRecord(presentJsonValue(dispatch, ctx, ["on", "workflow_dispatch"]), ctx, [
-                "on",
-                "workflow_dispatch",
-            ]);
-            if (Object.keys(mapping).length > 0) {
-                sourceError(ctx, ["on", "workflow_dispatch"], "must be null or an empty mapping; inputs are unsupported.");
-            }
-        }
-        manual = true;
-    }
-    return Object.freeze({ manual, schedules: Object.freeze(schedules) });
-}
-/**
- * `on:` is the one canonical scheduling source a workflow YAML trigger
- * fragment has a live caller for (see file header — the task-v3 `akm:`
- * options bag this used to also accept is deleted, along with the
- * "exactly one scheduling source" choice between the two).
- */
-function compileTriggers(input, ctx) {
-    if (!own(input, "on"))
-        sourceError(ctx, ["on"], "is required.");
-    return parseOn(presentJsonValue(input.on, ctx, ["on"]), ctx);
-}
-/**
- * Classify the strict trigger fragment `{on}` into deterministic local
- * scheduler bindings. Full workflow adapters pass only that one field; this
- * rejects `jobs` and every other workflow field (and, since the review fix
- * above, `akm` too) rather than owning the document grammar.
- */
-export function classifyWorkflowYamlTriggers(value, options) {
-    const ctx = ctxFrom(options);
-    const cloned = cloneBoundedJson(value, ctx, [], { nodes: 0 });
-    const input = asRecord(cloned, ctx, []);
-    checkKeys(input, ["on"], ctx, []);
-    return compileTriggers(input, ctx);
-}

package/dist/workflows/source-ir/uses.js

@@ -1,40 +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/.
-/**
- * The workflow `uses:` classification seam (P1a Lane B,
- * docs/plans/specs/p1a-with-rejection-classifier.md §4.2).
- *
- * `classifyWorkflowSourceUses` is the canonical non-task `uses:` classifier
- * used by direct source-IR decoding (and, via `compile.ts`, by the GitHub-YAML
- * entrypoint): it recognizes the `akm/command` builtin special case and
- * otherwise delegates to `classifyTargetRef` (src/execution/target-ref.ts),
- * the canonical classifier for `commands/`, `scripts/`, `tasks/`, and
- * `workflows/` asset refs — including `tasks/...` targets, for which
- * `classifyTargetRef`'s own `tasks/` arm is the one authority (brief §8.1;
- * P4 deleted `classifyWorkflowStepUses`'s `canonicalTaskTarget` pre-check in
- * semantics.ts, which used to match them first).
- *
- * This module imports NOTHING from `src/tasks/source-v3.ts`: workflow `uses:`
- * classification no longer delegates to the task-v3 grammar, and (P4) native
- * target classification recognizes no GitHub Action variant at all —
- * `WorkflowSourceUsesTarget` below has no `github-action` member, typed or
- * otherwise.
- */
-import { classifyTargetRef } from "../../execution/target-ref.js";
-/**
- * Canonical non-task classifier used by direct source-IR decoding (and the
- * GitHub-YAML entrypoint's default, wired via compile.ts). Layers the
- * `akm/command` builtin special case over `classifyTargetRef`, which throws
- * `UsageError` `TARGET_REF_INVALID` for anything else.
- */
-export function classifyWorkflowSourceUses(value) {
-    if (value === "akm/command") {
-        return Object.freeze({ kind: "builtin-command", ref: "akm/command" });
-    }
-    // classifyTargetRef's return type is structurally identical to this
-    // module's `{ kind: "command" | "script" | "task" | "workflow"; ref:
-    // string }` union arm, so it is assignable to WorkflowSourceUsesTarget
-    // without a cast.
-    return classifyTargetRef(value);
-}

package/dist/workflows/validator.js

@@ -1,60 +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/.
-/**
- * Cross-cutting semantic checks over an assembled `WorkflowDocument` draft
- * that need the whole document (not just one frontmatter key) at once.
- *
- * Per-key structural checks (unknown keys, id/param-name patterns, timeout
- * format, retry taxonomy, route target ordering, duplicate ids, gate/body
- * binding) all live in `parser.ts`, where line-anchored errors are cheapest to
- * produce. The workflow-only closed frontmatter allowlist that used to live
- * here (`ALLOWED_FRONTMATTER_KEYS`/`checkFrontmatterKeys`) is GONE —
- * `schemas/akm-workflow.json` (`additionalProperties: false` over the shared
- * asset envelope ∪ the workflow keys) is the closed-key authority now; this
- * module only runs checks the schema cannot express (canonical xref shape,
- * resource limits).
- */
-import { bundleRefToString, parseBundleRef } from "../core/asset/asset-ref.js";
-import { utf8Bytes, WORKFLOW_MAX_INSTRUCTION_BYTES } from "./resource-limits.js";
-export function runSemanticChecks(draft, frontmatterData, frontmatterEndLine, errors) {
-    checkXrefs(frontmatterData.xrefs, frontmatterEndLine, errors);
-    checkResourceLimits(draft, errors);
-}
-function checkXrefs(value, line, errors) {
-    if (value === undefined)
-        return;
-    if (!Array.isArray(value))
-        return; // shape already flagged by parser.ts's checkXrefs
-    for (const ref of value) {
-        try {
-            if (typeof ref !== "string")
-                throw new Error("non-canonical ref");
-            const parsed = parseBundleRef(ref);
-            if (parsed.conceptId.includes(":") || ref !== bundleRefToString(parsed))
-                throw new Error("non-canonical ref");
-        }
-        catch {
-            errors.push({
-                line,
-                message: `Workflow frontmatter "xrefs" contains an invalid or non-canonical ref: ${String(ref)}.`,
-            });
-        }
-    }
-}
-function checkResourceLimits(draft, errors) {
-    for (const step of draft.steps) {
-        if (step.instructions && utf8Bytes(step.instructions.text) > WORKFLOW_MAX_INSTRUCTION_BYTES) {
-            errors.push({
-                line: step.instructions.source.start,
-                message: `Step "${step.id}" instructions exceed the 256 KiB resource limit.`,
-            });
-        }
-        if (step.gateRubric && utf8Bytes(step.gateRubric.text) > WORKFLOW_MAX_INSTRUCTION_BYTES) {
-            errors.push({
-                line: step.gateRubric.source.start,
-                message: `Step "${step.id}" gate rubric exceeds the 256 KiB resource limit.`,
-            });
-        }
-    }
-}