opencode-swarm 7.185.0 → 7.185.1

package/dist/hooks/extractors.d.ts

@@ -7,10 +7,17 @@ import { type Plan } from '../config/plan-schema';
  */
 /**
  * Extracts the current phase information from plan content.
+ *
+ * #2841: plan.md is user-writeable content and this one-liner feeds the
+ * `[SWARM CONTEXT] Phase:` architect-context injection, so it MUST pass the
+ * shared sanitizer (input-side, the same pattern as `extractPlanCursor`).
  */
 export declare function extractCurrentPhase(planContent: string): string | null;
 /**
  * Extracts the first incomplete task from the current IN PROGRESS phase.
+ *
+ * #2841: feeds the `[SWARM CONTEXT] Current task:` injection — sanitized
+ * input-side like its siblings.
  */
 export declare function extractCurrentTask(planContent: string): string | null;
 /**
@@ -24,14 +31,28 @@ export declare function extractCurrentTask(planContent: string): string | null;
  *   indented sub-bullets are filtered out here).
  * - Lines are reproduced verbatim from `raw` — bullet prefix, markers
  *   (✅ / [timestamps]) and all — then joined, trimmed and truncated.
+ *
+ * #2886: context.md is agent-written after consuming untrusted task/issue
+ * text and this return feeds the compaction `SWARM DECISIONS` LLM-context
+ * fact, so it MUST pass the shared sanitizer input-side (the same pattern as
+ * `extractCurrentPhase`); the system-enhancer wraps of this output become
+ * idempotent no-ops.
  */
 export declare function extractDecisions(contextContent: string, maxChars?: number): string | null;
 /**
  * Extracts incomplete tasks from plan content under the current IN PROGRESS phase.
+ *
+ * #2841: feeds the `SWARM TASKS` compaction fact (LLM-context injection) —
+ * sanitized input-side like its siblings.
  */
 export declare function extractIncompleteTasks(planContent: string, maxChars?: number): string | null;
 /**
  * Extracts patterns section from context content.
+ *
+ * #2886: context.md is agent-written after consuming untrusted task/issue
+ * text and this return feeds the compaction `SWARM PATTERNS` LLM-context
+ * fact, so it MUST pass the shared sanitizer input-side (the same pattern as
+ * `extractCurrentPhase`).
  */
 export declare function extractPatterns(contextContent: string, maxChars?: number): string | null;
 /**
@@ -44,6 +65,9 @@ export declare function extractPatterns(contextContent: string, maxChars?: numbe
 export declare function extractCurrentPhaseFromPlan(plan: Plan): string | null;
 /**
  * Extracts the first incomplete task from the current phase of a Plan object.
+ *
+ * #2841: task fields feed the `[SWARM CONTEXT] Current task:` injection —
+ * the composed line must pass the shared sanitizer before it is returned.
  */
 export declare function extractCurrentTaskFromPlan(plan: Plan): string | null;
 /**