opencode-swarm 7.130.2 → 7.132.0

package/dist/cli/{index-6fqj8fcp.js → index-99tq1zd5.js}

@@ -12,14 +12,14 @@ import {
   detectPosixWrites,
   detectWindowsWrites,
   resolveWriteTargets
-} from "./index-etdgtk3m.js";
+} from "./index-8w3sp149.js";
 import {
   checkFileAuthority,
   classifyFile,
   isInDeclaredScope,
   redactPath,
   redactShellCommand
-} from "./index-hjar4crm.js";
+} from "./index-fegng5pv.js";
 
 // src/services/guardrail-explain-service.ts
 import path from "path";

package/dist/cli/{index-jvyn76xe.js → index-e630fw43.js}

@@ -2,18 +2,18 @@
 import {
   ALLOWED_SKILL_PATH_PREFIXES,
   validateSkillPath
-} from "./index-wy3q73j2.js";
+} from "./index-zah4qws8.js";
 import {
   computeOutcomeSignal,
   readKnowledge,
   resolveHiveKnowledgePath,
   resolveSwarmKnowledgePath,
   transactKnowledge
-} from "./index-ts9wh1ba.js";
+} from "./index-6mcx76j9.js";
 import {
   effectiveRetrievalOutcomes,
   readKnowledgeCounterRollups
-} from "./index-jxha73tm.js";
+} from "./index-nsxchdx0.js";
 import {
   init_knowledge_types,
   isActiveStatus

package/dist/cli/{index-nr5pr54q.js → index-exs5bt14.js}

@@ -8,7 +8,7 @@ import {
   init_constants,
   init_schema,
   resolveExternalSkillsConfig
-} from "./index-5xxgeksy.js";
+} from "./index-5x3g1q91.js";
 import {
   advisoryWarn,
   init_warning_buffer

package/dist/cli/{index-hjar4crm.js → index-fegng5pv.js}

@@ -3,7 +3,7 @@ import {
   init_constants,
   init_schema,
   stripKnownSwarmPrefix
-} from "./index-5xxgeksy.js";
+} from "./index-5x3g1q91.js";
 import {
   init_logger,
   warn

package/dist/cli/{index-jxha73tm.js → index-nsxchdx0.js}

@@ -608,7 +608,7 @@ async function applyKnowledgeVerdictFeedback(directory, options) {
       deltas.push({ id, delta });
     }
     if (deltas.length > 0) {
-      const { bumpKnowledgeConfidenceBatch } = await import("./knowledge-store-h8bp9eje.js");
+      const { bumpKnowledgeConfidenceBatch } = await import("./knowledge-store-73ykq5j3.js");
       await bumpKnowledgeConfidenceBatch(directory, deltas, options?.floorOptions);
     }
     return {

package/dist/cli/{index-3rnkyb60.js → index-ppkp20fp.js}

@@ -6,13 +6,13 @@ import {
   resolveSwarmKnowledgePath,
   transactKnowledge,
   wordBigrams
-} from "./index-ts9wh1ba.js";
+} from "./index-6mcx76j9.js";
 import {
   countEntryContradictionsInWindow,
   countEntryViolationsInWindow,
   readKnowledgeEvents,
   recordKnowledgeEvent
-} from "./index-jxha73tm.js";
+} from "./index-nsxchdx0.js";
 import {
   init_knowledge_types,
   isActiveStatus
@@ -190,11 +190,11 @@ async function maybeQuarantineOnContradiction(directory, entryId, threshold, win
         alreadyInactive: true
       };
     }
-    const { quarantineEntry } = await import("./knowledge-validator-sz9v1fdq.js");
+    const { quarantineEntry } = await import("./knowledge-validator-tnadtt1h.js");
     let policyConfig;
     try {
-      const { KnowledgeConfigSchema } = await import("./schema-fkpn2r1s.js");
-      const { loadPluginConfigWithMeta } = await import("./index-agte9w1e.js");
+      const { KnowledgeConfigSchema } = await import("./schema-1kwmcayk.js");
+      const { loadPluginConfigWithMeta } = await import("./index-zrh07ykv.js");
       const { config: loadedConfig } = loadPluginConfigWithMeta(directory);
       policyConfig = KnowledgeConfigSchema.parse(loadedConfig.knowledge ?? {});
     } catch {

package/dist/cli/{index-p6qgjkbt.js → index-q0ysv66x.js}

@@ -8,7 +8,7 @@ import {
   init_constants,
   init_schema,
   stripKnownSwarmPrefix
-} from "./index-5xxgeksy.js";
+} from "./index-5x3g1q91.js";
 import {
   log
 } from "./index-zgwm4ryv.js";
@@ -926,6 +926,14 @@ function validateConfigKey(path2, value) {
       emitObjectTypeMismatch("memory", value, findings);
       break;
     }
+    case "learning": {
+      emitObjectTypeMismatch("learning", value, findings);
+      break;
+    }
+    case "consensus": {
+      emitObjectTypeMismatch("consensus", value, findings);
+      break;
+    }
     case "curator": {
       emitObjectTypeMismatch("curator", value, findings);
       break;

package/dist/cli/{index-jvwkxz8q.js → index-qg1cj1ev.js}

@@ -1,10 +1,10 @@
 // @bun
 import {
   handleGuardrailExplain
-} from "./index-6fqj8fcp.js";
+} from "./index-99tq1zd5.js";
 import {
   handleGuardrailLog
-} from "./index-zft4hp35.js";
+} from "./index-64z5dvam.js";
 import {
   COMMAND_REGISTRY,
   SWARM_COMMAND_TOOL_ALLOWLIST,
@@ -83,28 +83,28 @@ import {
   handleWriteRetroCommand,
   normalizeSwarmCommandInput,
   resolveCommand
-} from "./index-etdgtk3m.js";
-import"./index-hjar4crm.js";
-import"./index-p6qgjkbt.js";
-import"./index-kzvwb2se.js";
+} from "./index-8w3sp149.js";
+import"./index-fegng5pv.js";
+import"./index-q0ysv66x.js";
+import"./index-03zyn94g.js";
 import"./index-4905hd2m.js";
 import"./index-134d35c1.js";
 import"./index-9f71ye47.js";
-import"./index-jvyn76xe.js";
-import"./index-3rnkyb60.js";
-import"./index-s8h2cedv.js";
+import"./index-e630fw43.js";
+import"./index-ppkp20fp.js";
+import"./index-sbq3gbjs.js";
 import"./index-vxv732ex.js";
 import"./index-c8s9a3zh.js";
 import"./index-9ss2m4rs.js";
 import"./index-g4mnf3p5.js";
-import"./index-wy3q73j2.js";
-import"./index-xa29259t.js";
+import"./index-zah4qws8.js";
+import"./index-2dtwjx39.js";
 import"./index-rtry5xyf.js";
-import"./index-ts9wh1ba.js";
-import"./index-jxha73tm.js";
+import"./index-6mcx76j9.js";
+import"./index-nsxchdx0.js";
 import"./index-ae75rja9.js";
 import"./index-q27bajqb.js";
-import"./index-nr5pr54q.js";
+import"./index-exs5bt14.js";
 import"./index-k5jrywpr.js";
 import"./index-n832052r.js";
 import {
@@ -113,7 +113,7 @@ import {
   init_constants,
   init_schema,
   stripKnownSwarmPrefix
-} from "./index-5xxgeksy.js";
+} from "./index-5x3g1q91.js";
 import"./index-bk5tah7q.js";
 import"./index-8fwhhayc.js";
 import"./index-q1exe2b3.js";

package/dist/cli/{index-s8h2cedv.js → index-sbq3gbjs.js}

@@ -2,7 +2,7 @@
 import {
   readKnowledge,
   transactKnowledge
-} from "./index-ts9wh1ba.js";
+} from "./index-6mcx76j9.js";
 import {
   resolveKnowledgeStoreDir
 } from "./index-q27bajqb.js";

package/dist/cli/{index-wy3q73j2.js → index-zah4qws8.js}

@@ -1,7 +1,7 @@
 // @bun
 import {
   authorizeCuration
-} from "./index-xa29259t.js";
+} from "./index-2dtwjx39.js";
 import {
   findNearDuplicate,
   inferTags,
@@ -9,7 +9,7 @@ import {
   resolveSwarmKnowledgePath,
   resolveSwarmRejectedPath,
   transactKnowledge
-} from "./index-ts9wh1ba.js";
+} from "./index-6mcx76j9.js";
 import {
   resolveKnowledgeStoreDir
 } from "./index-q27bajqb.js";
@@ -32,6 +32,21 @@ var import_proper_lockfile = __toESM(require_proper_lockfile(), 1);
 import { appendFile, mkdir } from "fs/promises";
 import * as path from "path";
 init_logger();
+
+// src/hooks/actionability-predicate.ts
+function hasNonEmptyList(v) {
+  return Array.isArray(v) && v.length > 0;
+}
+function validateActionability(entry) {
+  const hasPredicate = hasNonEmptyList(entry.forbidden_actions) || hasNonEmptyList(entry.required_actions) || hasNonEmptyList(entry.verification_checks) || typeof entry.verification_predicate === "string" && entry.verification_predicate.trim().length > 0;
+  const hasScope = hasNonEmptyList(entry.applies_to_tools) || hasNonEmptyList(entry.applies_to_agents);
+  if (hasPredicate && hasScope)
+    return { actionable: true };
+  const reason = !hasPredicate && !hasScope ? "missing_predicate_and_scope" : !hasPredicate ? "missing_predicate" : "missing_scope";
+  return { actionable: false, reason };
+}
+
+// src/hooks/knowledge-validator.ts
 var DANGEROUS_COMMAND_ERROR_PATTERNS = [
   /\brm\s+-rf\b/,
   /\bsudo\s+rm\b/,
@@ -522,17 +537,6 @@ function validateActionableFields(fields) {
   }
   return { valid: errors.length === 0, errors };
 }
-function hasNonEmptyList(v) {
-  return Array.isArray(v) && v.length > 0;
-}
-function validateActionability(entry) {
-  const hasPredicate = hasNonEmptyList(entry.forbidden_actions) || hasNonEmptyList(entry.required_actions) || hasNonEmptyList(entry.verification_checks) || typeof entry.verification_predicate === "string" && entry.verification_predicate.trim().length > 0;
-  const hasScope = hasNonEmptyList(entry.applies_to_tools) || hasNonEmptyList(entry.applies_to_agents);
-  if (hasPredicate && hasScope)
-    return { actionable: true };
-  const reason = !hasPredicate && !hasScope ? "missing_predicate_and_scope" : !hasPredicate ? "missing_predicate" : "missing_scope";
-  return { actionable: false, reason };
-}
 function resolveUnactionablePath(directory) {
   return path.join(resolveKnowledgeStoreDir(directory), "knowledge-unactionable.jsonl");
 }
@@ -818,4 +822,4 @@ var _internals = {
   hasSignificantOverlap
 };
 
-export { DANGEROUS_COMMAND_ERROR_PATTERNS, DANGEROUS_COMMAND_WARNING_PATTERNS, DANGEROUS_COMMAND_PATTERNS, SECURITY_DEGRADING_PATTERNS, INVISIBLE_FORMAT_CHARS, INJECTION_PATTERNS, scanContentSafety, validateLesson, ACTIONABLE_STRING_MAX, ACTIONABLE_LIST_MAX, RETIRED_SKILL_HISTORY_MAX, ALLOWED_SKILL_PATH_PREFIXES, validateSkillPath, validateSkillCandidatePath, validateActionableFields, validateActionability, resolveUnactionablePath, appendUnactionable, auditEntryHealth, quarantineEntry, restoreEntry, unarchiveEntry, _internals };
+export { validateActionability, DANGEROUS_COMMAND_ERROR_PATTERNS, DANGEROUS_COMMAND_WARNING_PATTERNS, DANGEROUS_COMMAND_PATTERNS, SECURITY_DEGRADING_PATTERNS, INVISIBLE_FORMAT_CHARS, INJECTION_PATTERNS, scanContentSafety, validateLesson, ACTIONABLE_STRING_MAX, ACTIONABLE_LIST_MAX, RETIRED_SKILL_HISTORY_MAX, ALLOWED_SKILL_PATH_PREFIXES, validateSkillPath, validateSkillCandidatePath, validateActionableFields, resolveUnactionablePath, appendUnactionable, auditEntryHealth, quarantineEntry, restoreEntry, unarchiveEntry, _internals };

package/dist/cli/{index-agte9w1e.js → index-zrh07ykv.js}

@@ -7,7 +7,7 @@ import {
   loadPluginConfigWithMeta,
   loadPluginConfigWithMetaAsync,
   resolveWorktreeIsolationConfig
-} from "./index-nr5pr54q.js";
+} from "./index-exs5bt14.js";
 import {
   ApprovalEvidenceSchema,
   BaseEvidenceSchema,
@@ -59,7 +59,7 @@ import {
   WorktreeIsolationConfigSchema,
   isQAAgent,
   isSubagent
-} from "./index-5xxgeksy.js";
+} from "./index-5x3g1q91.js";
 import"./index-bk5tah7q.js";
 import {
   MigrationStatusSchema,

package/dist/cli/index.js

@@ -7,34 +7,34 @@ import {
   getPluginLockFilePaths,
   package_default,
   resolveCommand
-} from "./index-etdgtk3m.js";
-import"./index-hjar4crm.js";
-import"./index-p6qgjkbt.js";
-import"./index-kzvwb2se.js";
+} from "./index-8w3sp149.js";
+import"./index-fegng5pv.js";
+import"./index-q0ysv66x.js";
+import"./index-03zyn94g.js";
 import"./index-4905hd2m.js";
 import"./index-134d35c1.js";
 import"./index-9f71ye47.js";
-import"./index-jvyn76xe.js";
-import"./index-3rnkyb60.js";
-import"./index-s8h2cedv.js";
+import"./index-e630fw43.js";
+import"./index-ppkp20fp.js";
+import"./index-sbq3gbjs.js";
 import"./index-vxv732ex.js";
 import"./index-c8s9a3zh.js";
 import"./index-9ss2m4rs.js";
 import"./index-g4mnf3p5.js";
-import"./index-wy3q73j2.js";
-import"./index-xa29259t.js";
+import"./index-zah4qws8.js";
+import"./index-2dtwjx39.js";
 import"./index-rtry5xyf.js";
-import"./index-ts9wh1ba.js";
-import"./index-jxha73tm.js";
+import"./index-6mcx76j9.js";
+import"./index-nsxchdx0.js";
 import"./index-ae75rja9.js";
 import"./index-q27bajqb.js";
-import"./index-nr5pr54q.js";
+import"./index-exs5bt14.js";
 import"./index-k5jrywpr.js";
 import"./index-n832052r.js";
 import {
   DEFAULT_AGENT_CONFIGS,
   init_constants
-} from "./index-5xxgeksy.js";
+} from "./index-5x3g1q91.js";
 import"./index-bk5tah7q.js";
 import"./index-8fwhhayc.js";
 import"./index-q1exe2b3.js";

package/dist/cli/{knowledge-escalator-1ypz0266.js → knowledge-escalator-5hv2dwhz.js}

@@ -8,9 +8,9 @@ import {
   maybeEscalateOnViolation,
   maybeQuarantineOnContradiction,
   readRecentEscalations
-} from "./index-3rnkyb60.js";
-import"./index-ts9wh1ba.js";
-import"./index-jxha73tm.js";
+} from "./index-ppkp20fp.js";
+import"./index-6mcx76j9.js";
+import"./index-nsxchdx0.js";
 import"./index-ae75rja9.js";
 import"./index-q27bajqb.js";
 import"./index-bk5tah7q.js";

package/dist/cli/{knowledge-events-yvcczmja.js → knowledge-events-434663dp.js}

@@ -26,7 +26,7 @@ import {
   resolveKnowledgeCounterBaselinePath,
   resolveKnowledgeEventsPath,
   resolveLegacyApplicationLogPath
-} from "./index-jxha73tm.js";
+} from "./index-nsxchdx0.js";
 import"./index-ae75rja9.js";
 import"./index-q27bajqb.js";
 import"./index-zgwm4ryv.js";

package/dist/cli/{knowledge-store-h8bp9eje.js → knowledge-store-73ykq5j3.js}

@@ -13,6 +13,7 @@ import {
   computeContentHash,
   computeOutcomeSignal,
   confirmEntriesPhase,
+  dedupeCapped,
   enforceKnowledgeCap,
   findNearDuplicate,
   getArchivedKnowledgeIds,
@@ -40,7 +41,7 @@ import {
   transactKnowledge,
   transactKnowledgeWithCas,
   wordBigrams
-} from "./index-ts9wh1ba.js";
+} from "./index-6mcx76j9.js";
 import {
   resolveHiveDataDir
 } from "./index-ae75rja9.js";
@@ -83,6 +84,7 @@ export {
   getArchivedKnowledgeIds,
   findNearDuplicate,
   enforceKnowledgeCap,
+  dedupeCapped,
   confirmEntriesPhase,
   computeOutcomeSignal,
   computeContentHash,

package/dist/cli/{knowledge-validator-sz9v1fdq.js → knowledge-validator-tnadtt1h.js}

@@ -23,11 +23,11 @@ import {
   validateLesson,
   validateSkillCandidatePath,
   validateSkillPath
-} from "./index-wy3q73j2.js";
-import"./index-xa29259t.js";
+} from "./index-zah4qws8.js";
+import"./index-2dtwjx39.js";
 import"./index-rtry5xyf.js";
-import"./index-ts9wh1ba.js";
-import"./index-jxha73tm.js";
+import"./index-6mcx76j9.js";
+import"./index-nsxchdx0.js";
 import"./index-ae75rja9.js";
 import"./index-q27bajqb.js";
 import"./index-bk5tah7q.js";

package/dist/cli/{scan-cursor-k9zyt374.js → scan-cursor-e33n9pej.js}

@@ -4,8 +4,8 @@ import {
   alreadyCuratedThisGeneration,
   claimNextScanBatch,
   getScanStatus
-} from "./index-s8h2cedv.js";
-import"./index-ts9wh1ba.js";
+} from "./index-sbq3gbjs.js";
+import"./index-6mcx76j9.js";
 import"./index-ae75rja9.js";
 import"./index-q27bajqb.js";
 import"./index-bk5tah7q.js";

package/dist/cli/{schema-fkpn2r1s.js → schema-1kwmcayk.js}

@@ -16,6 +16,7 @@ import {
   CheckpointConfigSchema,
   CompactionAdvisoryConfigSchema,
   CompactionConfigSchema,
+  ConsensusConfigSchema,
   ContextBudgetConfigSchema,
   ContextMapConfigSchema,
   CouncilConfigSchema,
@@ -48,6 +49,7 @@ import {
   KnowledgeConfigSchema,
   LeanTurboConfigSchema,
   LeanTurboStrategyConfigSchema,
+  LearningConfigSchema,
   LintConfigSchema,
   MemoryConfigSchema,
   ModelPricingConfigSchema,
@@ -89,7 +91,7 @@ import {
   resolveGeneratedAgentRole,
   resolveGuardrailsConfig,
   stripKnownSwarmPrefix
-} from "./index-5xxgeksy.js";
+} from "./index-5x3g1q91.js";
 import"./index-bk5tah7q.js";
 import"./index-zjygnfay.js";
 import"./index-bpmtbmy9.js";
@@ -137,6 +139,7 @@ export {
   ModelPricingConfigSchema,
   MemoryConfigSchema,
   LintConfigSchema,
+  LearningConfigSchema,
   LeanTurboStrategyConfigSchema,
   LeanTurboConfigSchema,
   KnowledgeConfigSchema,
@@ -169,6 +172,7 @@ export {
   CouncilConfigSchema,
   ContextMapConfigSchema,
   ContextBudgetConfigSchema,
+  ConsensusConfigSchema,
   CompactionConfigSchema,
   CompactionAdvisoryConfigSchema,
   CheckpointConfigSchema,

package/dist/cli/{skill-generator-a6a9jxfd.js → skill-generator-k111qfdw.js}

@@ -33,12 +33,12 @@ import {
   sanitizeSlug,
   selectCandidateEntries,
   writeEvalStub
-} from "./index-jvyn76xe.js";
-import"./index-wy3q73j2.js";
-import"./index-xa29259t.js";
+} from "./index-e630fw43.js";
+import"./index-zah4qws8.js";
+import"./index-2dtwjx39.js";
 import"./index-rtry5xyf.js";
-import"./index-ts9wh1ba.js";
-import"./index-jxha73tm.js";
+import"./index-6mcx76j9.js";
+import"./index-nsxchdx0.js";
 import"./index-ae75rja9.js";
 import"./index-q27bajqb.js";
 import"./index-bk5tah7q.js";

package/dist/commands/consolidate.d.ts

@@ -1,6 +1,20 @@
+import type { SkillImproveResult } from '../services/skill-improver.js';
+/**
+ * Render the success summary for a completed consolidation run.
+ *
+ * Extracted as a pure function so the reporting surface — in particular the
+ * #1821 AC21 duplicate-suppression line, whose only production consumer is this
+ * command — is testable without mocking `runSkillConsolidation`.
+ */
+declare function buildConsolidateSummary(improver: SkillImproveResult | undefined, statePath: string, fallbackMaxCalls: number): string;
 export declare function handleConsolidateCommand(directory: string, args: string[], options?: {
     sessionID?: string;
 }): Promise<string>;
 export declare const _internals: {
     handleConsolidateCommand: typeof handleConsolidateCommand;
 };
+/** Pure-function seam for tests (writing-tests SKILL.md, Tier 0). */
+export declare const _test_exports: {
+    buildConsolidateSummary: typeof buildConsolidateSummary;
+};
+export {};

package/dist/commands/curate.d.ts

@@ -7,6 +7,7 @@
  *
  * Returns a summary with counts, or zero counts for empty-state.
  */
+import { loadPluginConfigWithMeta } from '../config/index.js';
 import { checkHivePromotions } from '../hooks/hive-promoter.js';
 import { readKnowledge, resolveSwarmKnowledgePath } from '../hooks/knowledge-store.js';
 import { readSwarmFileAsync } from '../hooks/utils.js';
@@ -15,6 +16,7 @@ export declare const _internals: {
     readKnowledge: typeof readKnowledge;
     resolveSwarmKnowledgePath: typeof resolveSwarmKnowledgePath;
     readSwarmFileAsync: typeof readSwarmFileAsync;
+    loadPluginConfigWithMeta: typeof loadPluginConfigWithMeta;
     loadCuratorDeps: () => Promise<{
         CuratorConfigSchema: import("zod").ZodObject<{
             enabled: import("zod").ZodDefault<import("zod").ZodBoolean>;

package/dist/commands/promote.d.ts

@@ -9,5 +9,30 @@
  * - /swarm promote --force --reason "<why>" ... — Override failed policy gates
  *   with a durable, audited override record (issue #1847 §4). An exact entry id
  *   alone is NEVER authorization to bypass policy; an explicit override is.
+ * - /swarm promote --applies-to-tools <a,b> --required-actions <a,b> "<text>"
+ *   — Supply the actionability fields the default-on `actionability_floor`
+ *   policy gate requires (issue #1821 A3). Without these the direct-text path
+ *   has no swarm entry to inherit a predicate/scope from and every promotion
+ *   would be blocked, forcing operators into `--force` and poisoning the
+ *   override-audit signal. Ignored on `--from-swarm`, which inherits the source
+ *   entry's own actionable-directive fields.
  */
+import { type ManualActionabilityFields } from '../hooks/hive-promoter';
+/** Everything `/swarm promote`'s argument vector can express. */
+export interface ParsedPromoteArgs {
+    category?: string;
+    lessonId?: string;
+    lessonText?: string;
+    force: boolean;
+    reason?: string;
+    actionable: ManualActionabilityFields;
+}
+/**
+ * Pure argument parser for `/swarm promote`.
+ *
+ * Exported so the token-classification rules can be tested directly — the
+ * command handler itself performs real knowledge-store I/O, which would force a
+ * mock around the one thing worth asserting here.
+ */
+export declare function parsePromoteArgs(args: string[]): ParsedPromoteArgs;
 export declare function handlePromoteCommand(directory: string, args: string[]): Promise<string>;

package/dist/commands/registry.d.ts

@@ -698,8 +698,8 @@ export declare const COMMAND_REGISTRY: {
     readonly promote: {
         readonly handler: (ctx: CommandContext) => Promise<string>;
         readonly description: "Manually promote lesson to hive knowledge (policy-gated; --force --reason overrides with audit)";
-        readonly details: "Promotes a lesson directly to hive knowledge (--category flag sets category) or references an existing swarm lesson by ID (--from-swarm). Promotion runs the one policy evaluator inside a single cross-process transaction (#1847). A policy failure blocks promotion unless --force --reason \"<why>\" is supplied, which records a durable, audited override. An exact entry id alone is never authorization to bypass policy. Either direct text or --from-swarm ID is required.";
-        readonly args: "--category <category>, --from-swarm <lesson-id>, <lesson-text>";
+        readonly details: "Promotes a lesson to hive knowledge directly (--category) or via an existing swarm lesson (--from-swarm), in one cross-process policy transaction (#1847). A policy failure blocks promotion unless --force --reason \"<why>\" is given (audited); an entry id alone is not authorization. Requires direct text or --from-swarm. An actionability floor (#1821) needs at least one predicate flag and one scope flag (see args), unless knowledge.promotion_require_actionable=false.";
+        readonly args: "--category <category>, --from-swarm <lesson-id>, --applies-to-tools <a,b>, --applies-to-agents <a,b>, --required-actions <a,b>, --forbidden-actions <a,b>, --verification-checks <a,b>, --force --reason <why>, <lesson-text>";
         readonly category: "utility";
         readonly toolPolicy: "none";
     };