akm-cli 0.9.0-rc.0 → 0.9.0-rc.13

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

@@ -8,7 +8,12 @@
  * migrated to `defineJsonCommand`, which wraps the body in `runWithJsonErrors`
  * and emits the same JSON envelope (stdout/stderr/exit-code) as the inline
  * `runWithJsonErrors` form it replaces.
+ *
+ * 0.9 CLI overhaul (S8): the former top-level `extract` and `propose`
+ * commands are absorbed here as `extract` and `new` — no top-level
+ * registration remains for either spelling.
  */
+import { getParsedInvocation } from "../../cli/invocation.js";
 import { parsePositiveIntFlag } from "../../cli/parse-args.js";
 import { defineGroupCommand, defineJsonCommand, output } from "../../cli/shared.js";
 import { resolveStashDir } from "../../core/common.js";
@@ -17,10 +22,45 @@ import { UsageError } from "../../core/errors.js";
 import { resolveTriageJudgmentRunner } from "../../integrations/agent/runner.js";
 import { installLlmUsagePersistenceIfAbsent } from "../../llm/usage-persist.js";
 import { withLlmStage } from "../../llm/usage-telemetry.js";
-import { resolveImproveProfile } from "../improve/improve-profiles.js";
+import { extractCommand } from "../improve/extract-cli.js";
+import { resolveImproveStrategy } from "../improve/improve-strategies.js";
 import { drainProposals } from "./drain.js";
 import { resolveDrainPolicy } from "./drain-policies.js";
-import { akmProposalAccept, akmProposalDiff, akmProposalList, akmProposalReject, akmProposalRevert, akmProposalShow, } from "./proposal.js";
+import { akmProposalAccept, akmProposalDiff, akmProposalList, akmProposalReject, akmProposalRevert, akmProposalShow, bulkAdjudicateProposals, } from "./proposal.js";
+import { proposeCommand } from "./propose-cli.js";
+/**
+ * `--source` was renamed to `--generator` on `proposal accept`/`proposal
+ * reject` in 0.9 (WS3/S8 — "Removed in 0.9.0"). citty is non-strict, so the
+ * retired spelling is silently absorbed rather than rejected — a bulk
+ * accept/reject invoked with `--source <name>` then has neither `--generator`
+ * nor a positional id, and falls through to the single-proposal path, which
+ * throws MISSING_REQUIRED_ARGUMENT instead of running the bulk action the
+ * caller asked for. Reject it explicitly instead.
+ */
+function rejectRetiredProposalSourceFlag(subcommand) {
+    if (!getParsedInvocation().hasFlag("--source"))
+        return;
+    throw new UsageError(`\`akm proposal ${subcommand} --source\` was renamed to \`--generator\` in 0.9. Use \`--generator <name>\` instead.`, "INVALID_FLAG_VALUE");
+}
+/**
+ * Parse + validate the shared bulk-adjudication filter flags
+ * (`--max-diff-lines`, `--older-than`). Extracted from the two verbatim
+ * copies that lived in the accept and reject bulk branches (WI-6.6).
+ */
+function parseBulkFilterFlags(args) {
+    const rawMaxDiff = args["max-diff-lines"] ? Number.parseInt(String(args["max-diff-lines"]), 10) : undefined;
+    if (rawMaxDiff !== undefined && (Number.isNaN(rawMaxDiff) || rawMaxDiff < 0)) {
+        throw new UsageError("--max-diff-lines must be a non-negative integer", "INVALID_FLAG_VALUE");
+    }
+    const rawOlderThan = args["older-than"] ? Number.parseInt(String(args["older-than"]), 10) : undefined;
+    if (rawOlderThan !== undefined && (Number.isNaN(rawOlderThan) || rawOlderThan < 0)) {
+        throw new UsageError("--older-than must be a non-negative integer (days)", "INVALID_FLAG_VALUE");
+    }
+    return {
+        maxDiffLines: rawMaxDiff,
+        olderThanMs: rawOlderThan !== undefined ? rawOlderThan * 86_400_000 : undefined,
+    };
+}
 function parseProposalStatus(raw) {
     if (raw === undefined)
         return undefined;
@@ -35,16 +75,18 @@ function parseProposalStatus(raw) {
 const proposalListCommand = defineJsonCommand({
     meta: { name: "list", description: "List proposal queue entries" },
     args: {
+        queue: { type: "string", description: "Select the proposal queue by source name" },
         status: {
             type: "string",
             description: "Filter by status (pending|accepted|rejected|reverted)",
         },
-        ref: { type: "string", description: "Filter by asset ref (type:name)" },
+        ref: { type: "string", description: "Filter by asset ref ([bundle//]conceptId, e.g. knowledge/guide.md)" },
         type: { type: "string", description: "Filter by asset type" },
     },
     run({ args }) {
         const status = parseProposalStatus(args.status);
         const result = akmProposalList({
+            queue: args.queue,
             status,
             ref: args.ref,
             type: args.type,
@@ -54,30 +96,31 @@ const proposalListCommand = defineJsonCommand({
     },
 });
 const proposalAcceptCommand = defineJsonCommand({
-    meta: { name: "accept", description: "Accept a proposal and promote it into the stash" },
+    meta: { name: "accept", description: "Accept a proposal and promote it into the bundle" },
     args: {
         id: {
             type: "positional",
-            description: "Proposal id (uuid / prefix) or asset ref (e.g. skill:akm-dream). Optional when --generator is provided.",
+            description: "Proposal id (uuid / prefix) or asset ref (e.g. skills/akm-dream). Optional when --generator is provided.",
             required: false,
         },
-        target: { type: "string", description: "Override the write target by source name" },
+        queue: { type: "string", description: "Select the proposal queue by source name" },
+        target: { type: "string", description: "Write destination; must match the proposal's recorded target" },
         // F-6 / #393: Batch accept by generator, diff size, or age.
         generator: {
             type: "string",
-            description: "F-6: Bulk-accept all pending proposals from this generator (e.g. reflect, distill). Requires no positional id.",
+            description: "Bulk-accept all pending proposals from this generator (e.g. reflect, distill). Requires no positional id.",
         },
         "max-diff-lines": {
             type: "string",
-            description: "F-6: When bulk-accepting, only accept proposals whose content is <= this many lines. Skips larger proposals.",
+            description: "When bulk-accepting, only accept proposals whose content is <= this many lines. Skips larger proposals.",
         },
         "older-than": {
             type: "string",
-            description: "F-6: When bulk-accepting, only accept proposals created more than this many days ago (e.g. '7' for 7 days).",
+            description: "When bulk-accepting, only accept proposals created more than this many days ago (e.g. '7' for 7 days).",
         },
         "dry-run": {
             type: "boolean",
-            description: "F-6: List proposals that would be bulk-accepted without accepting them.",
+            description: "List proposals that would be bulk-accepted without accepting them.",
             default: false,
         },
         yes: {
@@ -88,6 +131,7 @@ const proposalAcceptCommand = defineJsonCommand({
         },
     },
     async run({ args }) {
+        rejectRetiredProposalSourceFlag("accept");
         const generator = args.generator;
         // F-6 / #393: Bulk-accept when --generator is provided without a positional id.
         if (generator && !args.id) {
@@ -97,50 +141,27 @@ const proposalAcceptCommand = defineJsonCommand({
                 process.stderr.write("Aborted.\n");
                 return;
             }
-            const { listProposals } = await import("./repository.js");
-            const stashDir = resolveStashDir();
-            const rawMaxDiff = args["max-diff-lines"] ? Number.parseInt(String(args["max-diff-lines"]), 10) : undefined;
-            if (rawMaxDiff !== undefined && (Number.isNaN(rawMaxDiff) || rawMaxDiff < 0)) {
-                throw new UsageError("--max-diff-lines must be a non-negative integer", "INVALID_FLAG_VALUE");
-            }
-            const rawOlderThan = args["older-than"] ? Number.parseInt(String(args["older-than"]), 10) : undefined;
-            if (rawOlderThan !== undefined && (Number.isNaN(rawOlderThan) || rawOlderThan < 0)) {
-                throw new UsageError("--older-than must be a non-negative integer (days)", "INVALID_FLAG_VALUE");
-            }
-            const maxDiffLines = rawMaxDiff;
-            const olderThanMs = rawOlderThan !== undefined ? rawOlderThan * 86_400_000 : undefined;
-            const pending = listProposals(stashDir, { status: "pending" }).filter((p) => {
-                if (p.source !== generator)
-                    return false;
-                if (maxDiffLines !== undefined) {
-                    const lines = (p.payload.content ?? "").split("\n").length;
-                    if (lines > maxDiffLines)
-                        return false;
-                }
-                if (olderThanMs !== undefined) {
-                    const age = Date.now() - new Date(p.createdAt).getTime();
-                    if (age < olderThanMs)
-                        return false;
-                }
-                return true;
+            const { maxDiffLines, olderThanMs } = parseBulkFilterFlags(args);
+            const { count, results } = await bulkAdjudicateProposals({
+                action: "accept",
+                generator,
+                maxDiffLines,
+                olderThanMs,
+                dryRun: args["dry-run"],
+                queue: args.queue,
+                target: args.target,
             });
-            const results = [];
-            for (const proposal of pending) {
-                if (args["dry-run"]) {
-                    results.push({ id: proposal.id, ref: proposal.ref, source: proposal.source, dryRun: true });
-                }
-                else {
-                    const result = await akmProposalAccept({ id: proposal.id, target: args.target });
-                    results.push(result);
-                }
-            }
-            output("proposal-accept-batch", { accepted: results.length, results, dryRun: args["dry-run"] });
+            output("proposal-accept-batch", { accepted: count, results, dryRun: args["dry-run"] });
             return;
         }
         if (!args.id) {
             throw new UsageError("Usage: akm proposal accept <id>  OR  akm proposal accept --generator <generator>", "MISSING_REQUIRED_ARGUMENT");
         }
-        const result = await akmProposalAccept({ id: args.id, target: args.target });
+        const result = await akmProposalAccept({
+            id: args.id,
+            queue: args.queue,
+            target: args.target,
+        });
         output("proposal-accept", result);
     },
 });
@@ -149,26 +170,27 @@ const proposalRejectCommand = defineJsonCommand({
     args: {
         id: {
             type: "positional",
-            description: "Proposal id (uuid / prefix) or asset ref (e.g. skill:akm-dream). Optional when --generator is provided.",
+            description: "Proposal id (uuid / prefix) or asset ref (e.g. skills/akm-dream). Optional when --generator is provided.",
             required: false,
         },
         reason: { type: "string", description: "Reason for rejection (required)" },
+        queue: { type: "string", description: "Select the proposal queue by source name" },
         // F-6 / #393: Batch reject by generator, diff size, or age.
         generator: {
             type: "string",
-            description: "F-6: Bulk-reject all pending proposals from this generator (e.g. reflect, distill). Requires no positional id.",
+            description: "Bulk-reject all pending proposals from this generator (e.g. reflect, distill). Requires no positional id.",
         },
         "max-diff-lines": {
             type: "string",
-            description: "F-6: When bulk-rejecting, only reject proposals whose content is <= this many lines. Skips larger proposals.",
+            description: "When bulk-rejecting, only reject proposals whose content is <= this many lines. Skips larger proposals.",
         },
         "older-than": {
             type: "string",
-            description: "F-6: When bulk-rejecting, only reject proposals created more than this many days ago (e.g. '7' for 7 days).",
+            description: "When bulk-rejecting, only reject proposals created more than this many days ago (e.g. '7' for 7 days).",
         },
         "dry-run": {
             type: "boolean",
-            description: "F-6: List proposals that would be bulk-rejected without rejecting them.",
+            description: "List proposals that would be bulk-rejected without rejecting them.",
             default: false,
         },
         yes: {
@@ -179,6 +201,7 @@ const proposalRejectCommand = defineJsonCommand({
         },
     },
     async run({ args }) {
+        rejectRetiredProposalSourceFlag("reject");
         const generator = args.generator;
         if (!args.reason || !String(args.reason).trim()) {
             throw new UsageError("Usage: akm proposal reject <id> --reason '<reason>'  OR  akm proposal reject --generator <generator> --reason '<reason>'", "MISSING_REQUIRED_ARGUMENT");
@@ -191,44 +214,17 @@ const proposalRejectCommand = defineJsonCommand({
                 process.stderr.write("Aborted.\n");
                 return;
             }
-            const { listProposals } = await import("./repository.js");
-            const stashDir = resolveStashDir();
-            const rawMaxDiff = args["max-diff-lines"] ? Number.parseInt(String(args["max-diff-lines"]), 10) : undefined;
-            if (rawMaxDiff !== undefined && (Number.isNaN(rawMaxDiff) || rawMaxDiff < 0)) {
-                throw new UsageError("--max-diff-lines must be a non-negative integer", "INVALID_FLAG_VALUE");
-            }
-            const rawOlderThan = args["older-than"] ? Number.parseInt(String(args["older-than"]), 10) : undefined;
-            if (rawOlderThan !== undefined && (Number.isNaN(rawOlderThan) || rawOlderThan < 0)) {
-                throw new UsageError("--older-than must be a non-negative integer (days)", "INVALID_FLAG_VALUE");
-            }
-            const maxDiffLines = rawMaxDiff;
-            const olderThanMs = rawOlderThan !== undefined ? rawOlderThan * 86_400_000 : undefined;
-            const pending = listProposals(stashDir, { status: "pending" }).filter((p) => {
-                if (p.source !== generator)
-                    return false;
-                if (maxDiffLines !== undefined) {
-                    const lines = (p.payload.content ?? "").split("\n").length;
-                    if (lines > maxDiffLines)
-                        return false;
-                }
-                if (olderThanMs !== undefined) {
-                    const age = Date.now() - new Date(p.createdAt).getTime();
-                    if (age < olderThanMs)
-                        return false;
-                }
-                return true;
+            const { maxDiffLines, olderThanMs } = parseBulkFilterFlags(args);
+            const { count, results } = await bulkAdjudicateProposals({
+                action: "reject",
+                generator,
+                maxDiffLines,
+                olderThanMs,
+                dryRun: args["dry-run"],
+                queue: args.queue,
+                reason: String(args.reason),
             });
-            const results = [];
-            for (const proposal of pending) {
-                if (args["dry-run"]) {
-                    results.push({ id: proposal.id, ref: proposal.ref, source: proposal.source, dryRun: true });
-                }
-                else {
-                    const result = akmProposalReject({ id: proposal.id, reason: String(args.reason) });
-                    results.push(result);
-                }
-            }
-            output("proposal-reject-batch", { rejected: results.length, results, dryRun: args["dry-run"] });
+            output("proposal-reject-batch", { rejected: count, results, dryRun: args["dry-run"] });
             return;
         }
         if (!args.id) {
@@ -242,7 +238,11 @@ const proposalRejectCommand = defineJsonCommand({
             process.stderr.write("Aborted.\n");
             return;
         }
-        const result = akmProposalReject({ id: args.id, reason: String(args.reason) });
+        const result = await akmProposalReject({
+            id: args.id,
+            queue: args.queue,
+            reason: String(args.reason),
+        });
         output("proposal-reject", result);
     },
 });
@@ -251,13 +251,14 @@ const proposalDiffCommand = defineJsonCommand({
     args: {
         id: {
             type: "positional",
-            description: "Proposal id (uuid / prefix) or asset ref (e.g. skill:akm-dream)",
+            description: "Proposal id (uuid / prefix) or asset ref (e.g. skills/akm-dream)",
             required: true,
         },
-        target: { type: "string", description: "Override the write target by source name" },
+        queue: { type: "string", description: "Select the proposal queue by source name" },
+        target: { type: "string", description: "Diff destination; must match the proposal's recorded target" },
     },
     run({ args }) {
-        const result = akmProposalDiff({ id: args.id, target: args.target });
+        const result = akmProposalDiff({ id: args.id, queue: args.queue, target: args.target });
         output("proposal-diff", result);
     },
 });
@@ -280,33 +281,34 @@ const proposalRevertCommand = defineJsonCommand({
     args: {
         id: {
             type: "positional",
-            description: "Proposal id (full uuid) or asset ref (e.g. skill:akm-dream). UUID prefixes are not supported for archived proposals — use the full UUID.",
+            description: "Proposal id (full uuid) or asset ref (e.g. skills/akm-dream). UUID prefixes are not supported for archived proposals — use the full UUID.",
             required: true,
         },
-        target: { type: "string", description: "Override the write target by source name" },
+        queue: { type: "string", description: "Select the proposal queue by source name" },
+        target: { type: "string", description: "Write destination; must match the proposal's recorded target" },
     },
     async run({ args }) {
         const result = await akmProposalRevert({
             id: args.id,
+            queue: args.queue,
             target: args.target,
         });
         output("proposal-revert", result);
     },
 });
 // `proposal show` (#225): show a single proposal with its validation findings.
-// `akmProposalShow` already backs `akm show proposal <id>` (now deprecated); this
-// is the canonical noun-group entry point.
 const proposalShowCommand = defineJsonCommand({
     meta: { name: "show", description: "Show a single proposal and its validation findings" },
     args: {
         id: {
             type: "positional",
-            description: "Proposal id (uuid / prefix) or asset ref (e.g. skill:akm-dream)",
+            description: "Proposal id (uuid / prefix) or asset ref (e.g. skills/akm-dream)",
             required: true,
         },
+        queue: { type: "string", description: "Select the proposal queue by source name" },
     },
     run({ args }) {
-        const result = akmProposalShow({ id: args.id });
+        const result = akmProposalShow({ id: args.id, queue: args.queue });
         output("proposal-show", result);
     },
 });
@@ -353,17 +355,21 @@ const proposalDrainCommand = defineJsonCommand({
             description: "Opt into the judgment tier (llm by default; agent/sdk per config) for deferred items. No-op with a logged triage_deferred summary when no runner is configured.",
             default: false,
         },
-        profile: {
+        strategy: {
             type: "string",
-            description: "Read the triage block (policy, applyMode, ceilings, judgment) from this improve profile.",
+            description: "Read the triage block (policy, applyMode, ceilings, judgment) from this improve strategy.",
         },
     },
-    async run({ args }) {
+    async run({ args, rawArgs }) {
+        if (rawArgs.some((arg) => arg === "--profile" || arg.startsWith("--profile="))) {
+            throw new UsageError("proposal drain: --profile is retired; use --strategy.", "INVALID_FLAG_VALUE");
+        }
         const stashDir = resolveStashDir();
         const cfg = loadConfig();
-        // Phase 2: read the triage block from the named improve profile. CLI flags
+        // Phase 2: read the triage block from the named improve strategy. CLI flags
         // always override config; config supplies defaults for any flag omitted.
-        const triageConfig = args.profile !== undefined ? resolveImproveProfile(args.profile, cfg).processes?.triage : undefined;
+        const selectedStrategy = resolveImproveStrategy(args.strategy, cfg);
+        const triageConfig = selectedStrategy.config.processes?.triage;
         const policy = resolveDrainPolicy(args.policy ?? triageConfig?.policy);
         const dryRun = args["dry-run"] === true;
         const applyMode = args.promote === true ? "promote" : (triageConfig?.applyMode ?? "queue");
@@ -404,10 +410,12 @@ const proposalDrainCommand = defineJsonCommand({
         }
         // Phase 3: resolve the judgment runner when --judgment is set. Default
         // mode is llm; falls back to defaults.llm when the triage block sets
-        // neither mode nor profile (mirrors resolveValidationRunner). null when
+        // no explicit engine selection. null when
         // nothing is configured → the engine leaves deferred items unresolved and
         // emits triage_deferred.
-        const judgment = args.judgment === true ? resolveTriageJudgmentRunner(triageConfig?.judgment, cfg) : null;
+        const judgment = args.judgment === true
+            ? resolveTriageJudgmentRunner(triageConfig?.judgment, cfg, triageConfig, selectedStrategy.config)
+            : null;
         // #576: persist + attribute per-call LLM usage for the standalone drain
         // path. `IfAbsent` keeps an enclosing `akm improve` sink in charge when
         // drain runs as a sub-step; the disposer clears only a sink we installed.
@@ -416,6 +424,7 @@ const proposalDrainCommand = defineJsonCommand({
         try {
             result = await withLlmStage("drain", () => drainProposals({
                 stashDir,
+                config: cfg,
                 policy,
                 applyMode,
                 maxAccepts,
@@ -434,29 +443,28 @@ const proposalDrainCommand = defineJsonCommand({
             policy: policy.name,
             applyMode,
             dryRun,
+            strategy: selectedStrategy.name,
+            judgmentEngine: judgment?.engine ?? null,
+            judgmentKind: judgment?.kind ?? null,
             promoted: result.promoted,
             rejected: result.rejected,
             deferred: result.deferred,
             skippedByCap: result.skippedByCap,
+            staged: result.staged,
         });
     },
 });
-// ── proposal noun group (#225 / 0.8 CLI stabilization) ────────────────────────
-//
-// `akm proposal <verb>` is the canonical grammar in 0.8. The flat verbs
-// (`proposals`/`accept`/`reject`/`diff`/`revert`) remain as deprecated aliases
-// that warn to stderr and delegate to the same command bodies; they are removed
-// in 0.9.0. Bare `akm proposal` behaves as `proposal list` (mirrors `akm env`).
+// ── proposal noun group ───────────────────────────────────────────────────────
 export const proposalCommand = defineGroupCommand({
-    meta: { name: "proposal", description: "Manage the proposal queue: list, show, diff, accept, reject, revert" },
-    args: {
-        status: {
-            type: "string",
-            description: "Filter by status (pending|accepted|rejected|reverted)",
-        },
-        ref: { type: "string", description: "Filter by asset ref (type:name)" },
-        type: { type: "string", description: "Filter by asset type" },
+    meta: {
+        name: "proposal",
+        description: "Manage the proposal queue: list, show, diff, accept, reject, revert, extract, new, drain",
     },
+    // The group declared `--queue`/`--status`/`--ref`/`--type` only so the bare
+    // form could act as `proposal list`. That form is gone (see below), and
+    // `proposalListCommand` declares the identical set, so keeping them here
+    // would just advertise flags in `akm proposal --help` that no group-level
+    // body reads.
     subCommands: {
         list: proposalListCommand,
         show: proposalShowCommand,
@@ -465,16 +473,10 @@ export const proposalCommand = defineGroupCommand({
         reject: proposalRejectCommand,
         revert: proposalRevertCommand,
         drain: proposalDrainCommand,
+        extract: extractCommand,
+        new: proposeCommand,
     },
-    // Default body fires only for bare `akm proposal [--status …]`.
-    defaultRun({ args }) {
-        const status = parseProposalStatus(args.status);
-        const result = akmProposalList({
-            status,
-            ref: args.ref,
-            type: args.type,
-            includeArchive: status === "accepted" || status === "rejected" || status === "reverted",
-        });
-        output("proposal-list", result);
-    },
+    // No `defaultRun`: bare `akm proposal [--status …]` is a usage error (exit 2),
+    // the canonical bare-group behavior — owner ruling 12. `akm proposal list`
+    // takes the same flags and produces what the bare form used to.
 });

package/dist/commands/proposal/proposal-types.js

@@ -0,0 +1,56 @@
+// 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/.
+// ── Source allow-list (F-4 / #385) ──────────────────────────────────────────
+/**
+ * Curated allow-list of valid `source` values for proposals (F-4 / #385).
+ *
+ * Rationale (W3C PROV-DM 2013): Provenance records require typed, validated
+ * sources for meaningful aggregation. Accept-rate-per-source is the core
+ * self-measurement metric for recursive self-improvement: if reflect proposals
+ * are accepted at 20% and distill proposals at 60%, that guides resource
+ * allocation. Free-text typos (`"reflct"`) produce unaggregatable events.
+ *
+ * Automated sources (those in {@link AUTOMATED_PROPOSAL_SOURCES}) require a
+ * `sourceRun` field for full PROV-DM traceability.
+ */
+export const PROPOSAL_SOURCES = [
+    // Automated sources — require sourceRun for traceability.
+    "reflect",
+    "distill",
+    "consolidate",
+    "extract",
+    "improve",
+    // Semi-automated / tool-driven.
+    "feedback",
+    // Human-initiated / CLI-driven.
+    "propose",
+    "remember",
+    "import",
+    // Internal / system.
+    "distill_quality_rejected",
+    "schema-repair",
+];
+/** Automated sources that SHOULD include a `sourceRun` for PROV-DM traceability. */
+export const AUTOMATED_PROPOSAL_SOURCES = [
+    "reflect",
+    "distill",
+    "consolidate",
+    "extract",
+    "improve",
+    "schema-repair",
+];
+/**
+ * Check whether a string is a valid {@link ProposalSource}.
+ * Unknown source values are accepted with a runtime warning rather than a hard
+ * error, to allow extensions without breaking existing callers.
+ */
+export function isValidProposalSource(source) {
+    return PROPOSAL_SOURCES.includes(source);
+}
+/**
+ * Check whether a source value is an automated source requiring `sourceRun`.
+ */
+export function isAutomatedProposalSource(source) {
+    return AUTOMATED_PROPOSAL_SOURCES.includes(source);
+}