akm-cli 0.8.7 → 0.8.14

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

@@ -0,0 +1,490 @@
+// 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/.
+/**
+ * `akm proposal` command family (#225). Extracted verbatim from src/cli.ts
+ * (WS6) so the God Module shrinks; the `main.subCommands.proposal` key and
+ * every subcommand's args/output shape are byte-identical. Leaf handlers are
+ * 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.
+ */
+import { defineCommand } from "citty";
+import { hasSubcommand, parsePositiveIntFlag } from "../../cli/parse-args.js";
+import { defineJsonCommand, output, runWithJsonErrors } from "../../cli/shared.js";
+import { resolveStashDir } from "../../core/common.js";
+import { loadConfig } from "../../core/config/config.js";
+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 { drainProposals } from "./drain.js";
+import { resolveDrainPolicy } from "./drain-policies.js";
+import { akmProposalAccept, akmProposalDiff, akmProposalList, akmProposalReject, akmProposalRevert, akmProposalShow, } from "./proposal.js";
+function parseProposalStatus(raw) {
+    if (raw === undefined)
+        return undefined;
+    const trimmed = raw.trim();
+    if (!trimmed)
+        return undefined;
+    if (trimmed === "pending" || trimmed === "accepted" || trimmed === "rejected" || trimmed === "reverted") {
+        return trimmed;
+    }
+    throw new UsageError(`Invalid --status value: "${raw}". Expected one of: pending, accepted, rejected, reverted.`, "INVALID_FLAG_VALUE");
+}
+const proposalListCommand = defineJsonCommand({
+    meta: { name: "list", description: "List proposal queue entries" },
+    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" },
+    },
+    run({ 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);
+    },
+});
+const proposalAcceptCommand = defineJsonCommand({
+    meta: { name: "accept", description: "Accept a proposal and promote it into the stash" },
+    args: {
+        id: {
+            type: "positional",
+            description: "Proposal id (uuid / prefix) or asset ref (e.g. skill:akm-dream). Optional when --generator is provided.",
+            required: false,
+        },
+        target: { type: "string", description: "Override the write target by source name" },
+        // 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.",
+        },
+        "max-diff-lines": {
+            type: "string",
+            description: "F-6: 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).",
+        },
+        "dry-run": {
+            type: "boolean",
+            description: "F-6: List proposals that would be bulk-accepted without accepting them.",
+            default: false,
+        },
+        yes: {
+            type: "boolean",
+            alias: "y",
+            description: "Skip confirmation prompt (required in non-interactive mode for bulk accept)",
+            default: false,
+        },
+    },
+    async run({ args }) {
+        const generator = args.generator;
+        // F-6 / #393: Bulk-accept when --generator is provided without a positional id.
+        if (generator && !args.id) {
+            const { confirmDestructive } = await import("../../cli/confirm.js");
+            const confirmed = await confirmDestructive(`Bulk-accept all matching proposals from generator "${generator}"? This cannot be undone.`, { yes: args.yes === true || args["dry-run"] === true });
+            if (!confirmed) {
+                process.stderr.write("Aborted.\n");
+                return;
+            }
+            const { listProposals } = await import("./validators/proposals.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 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"] });
+            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 });
+        output("proposal-accept", result);
+    },
+});
+const proposalRejectCommand = defineJsonCommand({
+    meta: { name: "reject", description: "Reject a proposal and record the reason" },
+    args: {
+        id: {
+            type: "positional",
+            description: "Proposal id (uuid / prefix) or asset ref (e.g. skill:akm-dream). Optional when --generator is provided.",
+            required: false,
+        },
+        reason: { type: "string", description: "Reason for rejection (required)" },
+        // 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.",
+        },
+        "max-diff-lines": {
+            type: "string",
+            description: "F-6: 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).",
+        },
+        "dry-run": {
+            type: "boolean",
+            description: "F-6: List proposals that would be bulk-rejected without rejecting them.",
+            default: false,
+        },
+        yes: {
+            type: "boolean",
+            alias: "y",
+            description: "Skip confirmation prompt (required in non-interactive mode)",
+            default: false,
+        },
+    },
+    async run({ args }) {
+        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");
+        }
+        // F-6 / #393: Bulk-reject when --generator is provided without a positional id.
+        if (generator && !args.id) {
+            const { confirmDestructive } = await import("../../cli/confirm.js");
+            const confirmed = await confirmDestructive(`Bulk-reject all matching proposals from generator "${generator}"? This cannot be undone.`, { yes: args.yes === true || args["dry-run"] === true });
+            if (!confirmed) {
+                process.stderr.write("Aborted.\n");
+                return;
+            }
+            const { listProposals } = await import("./validators/proposals.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 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"] });
+            return;
+        }
+        if (!args.id) {
+            throw new UsageError("Usage: akm proposal reject <id> --reason '<reason>'  OR  akm proposal reject --generator <generator> --reason '<reason>'", "MISSING_REQUIRED_ARGUMENT");
+        }
+        const { confirmDestructive } = await import("../../cli/confirm.js");
+        const confirmed = await confirmDestructive(`Reject proposal "${args.id}"? This cannot be undone.`, {
+            yes: args.yes === true,
+        });
+        if (!confirmed) {
+            process.stderr.write("Aborted.\n");
+            return;
+        }
+        const result = akmProposalReject({ id: args.id, reason: String(args.reason) });
+        output("proposal-reject", result);
+    },
+});
+const proposalDiffCommand = defineJsonCommand({
+    meta: { name: "diff", description: "Show the diff for a proposal (accepts full UUID, UUID prefix, or asset ref)" },
+    args: {
+        id: {
+            type: "positional",
+            description: "Proposal id (uuid / prefix) or asset ref (e.g. skill:akm-dream)",
+            required: true,
+        },
+        target: { type: "string", description: "Override the write target by source name" },
+    },
+    run({ args }) {
+        const result = akmProposalDiff({ id: args.id, target: args.target });
+        output("proposal-diff", result);
+    },
+});
+// Phase 6C (Advantage D6c): revert an accepted proposal.
+//
+// Exit codes (mapped by `runWithJsonErrors` from the typed errors thrown by
+// `akmProposalRevert` / `revertProposal`):
+//   0 — success; prior content restored.
+//   1 — generic error (also used by `UsageError("INVALID_FLAG_VALUE")` and
+//       `UsageError("MISSING_REQUIRED_ARGUMENT")` when the proposal is not
+//       accepted, or no backup is available).
+//   1 — `NotFoundError("FILE_NOT_FOUND")` when the proposal id does not resolve.
+const proposalRevertCommand = defineJsonCommand({
+    meta: {
+        name: "revert",
+        description: "Revert an accepted proposal: restore the prior asset content from the backup captured at promotion time. " +
+            "Errors if the proposal is not accepted or has no backup (new-asset proposals leave no backup). " +
+            "Accepts the full proposal UUID or the asset ref. UUID prefixes are not supported for archived proposals — use the full UUID.",
+    },
+    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.",
+            required: true,
+        },
+        target: { type: "string", description: "Override the write target by source name" },
+    },
+    async run({ args }) {
+        const result = await akmProposalRevert({
+            id: args.id,
+            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)",
+            required: true,
+        },
+    },
+    run({ args }) {
+        const result = akmProposalShow({ id: args.id });
+        output("proposal-show", result);
+    },
+});
+const proposalDrainCommand = defineJsonCommand({
+    meta: {
+        name: "drain",
+        description: "Drain the standing pending proposal backlog using a deterministic triage policy",
+    },
+    args: {
+        policy: {
+            type: "string",
+            description: "Built-in preset (personal-stash|conservative|manual) or path to a policy file",
+        },
+        "dry-run": {
+            type: "boolean",
+            description: "List what would be accepted/rejected/deferred without writing.",
+            default: false,
+        },
+        yes: {
+            type: "boolean",
+            alias: "y",
+            description: "Skip confirmation prompt (required in non-interactive mode for promotion).",
+            default: false,
+        },
+        "max-accepts": {
+            type: "string",
+            description: "Hard per-run accept ceiling. Accepts beyond this are reported as skippedByCap.",
+        },
+        "max-diff-lines": {
+            type: "string",
+            description: "Defer (never promote) accepts whose proposed content exceeds this many lines.",
+        },
+        "older-than": {
+            type: "string",
+            description: "Only consider proposals created more than this many days ago.",
+        },
+        promote: {
+            type: "boolean",
+            description: "Promote (accept) matching proposals. Default is queue mode (stage only, no writes to assets).",
+            default: false,
+        },
+        judgment: {
+            type: "boolean",
+            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: {
+            type: "string",
+            description: "Read the triage block (policy, applyMode, ceilings, judgment) from this improve profile.",
+        },
+    },
+    async run({ args }) {
+        const stashDir = resolveStashDir();
+        const cfg = loadConfig();
+        // Phase 2: read the triage block from the named improve profile. 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 policy = resolveDrainPolicy(args.policy ?? triageConfig?.policy);
+        const dryRun = args["dry-run"] === true;
+        const applyMode = args.promote === true ? "promote" : (triageConfig?.applyMode ?? "queue");
+        const maxAccepts = parsePositiveIntFlag(args["max-accepts"], "--max-accepts") ??
+            triageConfig?.maxAcceptsPerRun ??
+            25;
+        const maxDiffLines = parsePositiveIntFlag(args["max-diff-lines"], "--max-diff-lines") ??
+            triageConfig?.maxDiffLines;
+        const rawOlderThan = parsePositiveIntFlag(args["older-than"], "--older-than");
+        const olderThanMs = rawOlderThan !== undefined ? rawOlderThan * 86_400_000 : undefined;
+        // Promotion in promote mode is destructive (commits to git, no batch revert).
+        if (applyMode === "promote" && !dryRun) {
+            const { confirmDestructive } = await import("../../cli/confirm.js");
+            const confirmed = await confirmDestructive(`Drain and promote matching pending proposals under policy "${policy.name}"? Promotions commit to git and cannot be batch-reverted.`, { yes: args.yes === true });
+            if (!confirmed) {
+                process.stderr.write("Aborted.\n");
+                return;
+            }
+        }
+        // `--older-than` is applied here as a pre-filter on excludeIds: ids that
+        // are too fresh are excluded so the engine never touches them. This reads
+        // the pending set once here; drainProposals reads the pending set again
+        // internally, so a future engine-level olderThan option could remove this
+        // second read (engine API owned by another agent — not changed here).
+        let excludeIds;
+        if (olderThanMs !== undefined) {
+            const { listProposals } = await import("./validators/proposals.js");
+            const now = Date.now();
+            excludeIds = new Set(listProposals(stashDir, { status: "pending" })
+                // Fail SAFE: exclude a proposal when its age cannot be computed
+                // (NaN createdAt) OR it is too fresh. An unparseable createdAt must
+                // never be treated as old enough to drain/promote.
+                .filter((proposal) => {
+                const age = now - new Date(proposal.createdAt).getTime();
+                return Number.isNaN(age) || age < olderThanMs;
+            })
+                .map((proposal) => proposal.id));
+        }
+        // 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
+        // nothing is configured → the engine leaves deferred items unresolved and
+        // emits triage_deferred.
+        const judgment = args.judgment === true ? resolveTriageJudgmentRunner(triageConfig?.judgment, cfg) : 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.
+        const disposeDrainUsageSink = installLlmUsagePersistenceIfAbsent();
+        let result;
+        try {
+            result = await withLlmStage("drain", () => drainProposals({
+                stashDir,
+                policy,
+                applyMode,
+                maxAccepts,
+                dryRun,
+                ...(maxDiffLines !== undefined ? { maxDiffLines } : {}),
+                ...(excludeIds ? { excludeIds } : {}),
+                judgment,
+            }));
+        }
+        finally {
+            disposeDrainUsageSink();
+        }
+        output("proposal-drain", {
+            schemaVersion: 1,
+            ok: true,
+            policy: policy.name,
+            applyMode,
+            dryRun,
+            promoted: result.promoted,
+            rejected: result.rejected,
+            deferred: result.deferred,
+            skippedByCap: result.skippedByCap,
+        });
+    },
+});
+// ── 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`).
+// Single source of truth: the routing set is derived from the subCommands keys
+// (M10) so adding a subcommand can never silently desync from `hasSubcommand`.
+const proposalSubCommands = {
+    list: proposalListCommand,
+    show: proposalShowCommand,
+    diff: proposalDiffCommand,
+    accept: proposalAcceptCommand,
+    reject: proposalRejectCommand,
+    revert: proposalRevertCommand,
+    drain: proposalDrainCommand,
+};
+const PROPOSAL_SUBCOMMAND_SET = new Set(Object.keys(proposalSubCommands));
+export const proposalCommand = defineCommand({
+    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" },
+    },
+    subCommands: proposalSubCommands,
+    run({ args }) {
+        return runWithJsonErrors(() => {
+            // citty runs the group body even after a subcommand; short-circuit so the
+            // default-to-list body only fires for bare `akm proposal [--status …]`.
+            if (hasSubcommand(args, PROPOSAL_SUBCOMMAND_SET))
+                return;
+            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);
+        });
+    },
+});

package/dist/commands/{proposal.js → proposal/proposal.js}

@@ -11,17 +11,28 @@
  * fallback in the output layer — every shape is registered explicitly in
  * `src/output/shapes.ts` and `src/output/text.ts`.
  */
-import { resolveStashDir } from "../core/common";
-import { loadConfig } from "../core/config";
-import { UsageError } from "../core/errors";
-import { appendEvent } from "../core/events";
-import { archiveProposal, createProposal, diffProposal, getProposal, isProposalSkipped, listProposals, promoteProposal, resolveProposalId, revertProposal, validateProposal, } from "../core/proposals";
+import { resolveStashDir } from "../../core/common.js";
+import { loadConfig } from "../../core/config/config.js";
+import { UsageError } from "../../core/errors.js";
+import { appendEvent } from "../../core/events.js";
+import { archiveProposal, createProposal, diffProposal, getProposal, isProposalSkipped, listProposals, promoteProposal, resolveProposalId, revertProposal, validateProposal, } from "./validators/proposals.js";
 // ── Shared helpers ──────────────────────────────────────────────────────────
 function resolveStash(stashDir) {
     if (stashDir)
         return stashDir;
     return resolveStashDir();
 }
+/**
+ * Thin in-process read of the pending proposal queue, used by the health HTML
+ * report builder (#582) so it never shells out to `akm proposal list`.
+ *
+ * Deliberately narrow (one optional arg, returns the storage-layer rows) so
+ * the parallel proposal-storage-to-SQLite consolidation only has to swap this
+ * one function's body.
+ */
+export function listPendingProposals(stashDir) {
+    return listProposals(resolveStash(stashDir), { status: "pending" });
+}
 export function akmProposalList(options = {}) {
     const stash = resolveStash(options.stashDir);
     // `--status accepted|rejected|reverted` implies archive-inclusion since the
@@ -141,7 +152,7 @@ export function akmProposalCreate(options) {
  *     (raised by `resolveProposalId` / `getProposal`).
  *   - Proposal is not `status === "accepted"` → `UsageError("INVALID_FLAG_VALUE")`
  *     with message `"only accepted proposals can be reverted ..."`.
- *   - No `backup` field, or the backup file is missing on disk →
+ *   - No backup content on the record (new-asset proposals capture none) →
  *     `UsageError` with message `"no backup available for this proposal ..."`.
  *
  * On success, emits a `proposal_reverted` event for observability, mirroring

package/dist/commands/{propose.js → proposal/propose.js}

@@ -13,17 +13,17 @@
  * `akm reflect`. `propose_invoked` is emitted at command entry.
  */
 import fs from "node:fs";
-import { parseAssetRef } from "../core/asset-ref";
-import { TYPE_DIRS } from "../core/asset-spec";
-import { resolveStashDir } from "../core/common";
-import { ConfigError, UsageError } from "../core/errors";
-import { appendEvent } from "../core/events";
-import { createProposal, isProposalSkipped, } from "../core/proposals";
-import { runAgent, } from "../integrations/agent";
-import { resolveProcessAgentProfile } from "../integrations/agent/config";
-import { buildProposePrompt, parseAgentProposalPayload } from "../integrations/agent/prompts";
-import { runAgentSdk } from "../integrations/agent/sdk-runner";
-import { baseFailureFields, enoentHintMessage, isEnoentFailure, loadAgentConfigFromDisk, resolveAgentProfile, } from "./agent-support";
+import { parseAssetRef } from "../../core/asset/asset-ref.js";
+import { TYPE_DIRS } from "../../core/asset/asset-spec.js";
+import { resolveStashDir } from "../../core/common.js";
+import { ConfigError, UsageError } from "../../core/errors.js";
+import { appendEvent } from "../../core/events.js";
+import { runAgent, } from "../../integrations/agent/index.js";
+import { resolveProcessAgentProfile } from "../../integrations/agent/config.js";
+import { buildProposePrompt, parseAgentProposalPayload } from "../../integrations/agent/prompts.js";
+import { runAgentSdk } from "../../integrations/harnesses/opencode-sdk/index.js";
+import { baseFailureFields, enoentHintMessage, isEnoentFailure, loadAgentConfigFromDisk, resolveAgentProfile, } from "../agent/agent-support.js";
+import { createProposal, isProposalSkipped, } from "./validators/proposals.js";
 function failureEnvelope(result, type, name, fallbackReason = "non_zero_exit") {
     return {
         ...baseFailureFields(result, fallbackReason),

package/dist/{core → commands/proposal/validators}/proposal-quality-validators.js

@@ -58,8 +58,8 @@
  *     assets where the absolute ceiling takes over.
  */
 // ── Reflect-size guard ───────────────────────────────────────────────────────
-import { parseFrontmatter } from "./frontmatter";
-import { detectTruncatedDescription, TRUNCATION_TRAILING_WORDS } from "./text-truncation";
+import { parseFrontmatter } from "../../../core/asset/frontmatter.js";
+import { detectTruncatedDescription, TRUNCATION_TRAILING_WORDS } from "../../../core/text-truncation.js";
 // ── Description / when_to_use shape ─────────────────────────────────────────
 export const HEADING_FRAGMENT_PATTERNS = [
     /^for example\b/i,
@@ -115,7 +115,11 @@ export function isValidDescription(value, inputRef, options = {}) {
             reason: `description has ${backtickCount} backticks (unbalanced); likely contains a malformed code fragment`,
         };
     if (/^when\b/i.test(v))
-        return { ok: false, reason: "description starts with 'When' — that pattern belongs in when_to_use" };
+        return {
+            ok: false,
+            reason: "description starts with 'When' — that pattern belongs in when_to_use",
+            severity: "warn",
+        };
     if (!options.skipRefTailCheck) {
         const refTail = inputRef.split(":").pop()?.toLowerCase() ?? "";
         if (refTail.length >= 6 && v.toLowerCase().includes(refTail) && v.length < refTail.length + 40)
@@ -299,6 +303,7 @@ const lessonContentQualityValidator = {
             findings.push({
                 kind: "invalid-description",
                 message: `Lesson proposal ${proposal.id} (${proposal.ref}) has an invalid description: ${descCheck.reason}.`,
+                ...(descCheck.severity ? { severity: descCheck.severity } : {}),
             });
         const wtuCheck = isValidWhenToUse(fm.when_to_use, proposal.ref);
         if (!wtuCheck.ok)

package/dist/{core → commands/proposal/validators}/proposal-validators.js

@@ -1,10 +1,10 @@
 // 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 { parseAssetRef } from "./asset-ref";
-import { parseFrontmatter } from "./frontmatter";
-import { lintLessonContent } from "./lesson-lint";
-import { defaultProposalQualityValidators } from "./proposal-quality-validators";
+import { parseAssetRef } from "../../../core/asset/asset-ref.js";
+import { parseFrontmatter } from "../../../core/asset/frontmatter.js";
+import { lintLessonContent } from "../../../core/lesson-lint.js";
+import { defaultProposalQualityValidators } from "./proposal-quality-validators.js";
 const genericProposalValidator = {
     name: "generic-proposal-validator",
     appliesTo: () => true,
@@ -65,5 +65,5 @@ export function runProposalValidators(proposal, validators = defaultProposalVali
         if (ctx.stop)
             break;
     }
-    return { ok: findings.length === 0, findings };
+    return { ok: findings.every((f) => f.severity === "warn"), findings };
 }