@synergenius/flow-weaver-pack-weaver 0.9.193 → 0.9.195

package/dist/node-types/review-result.js

@@ -1,5 +1,16 @@
 import { runAgentLoop, createAnthropicProvider, getOrCreateCliSession, } from '@synergenius/flow-weaver/agent';
 import { createWeaverExecutor } from '../bot/weaver-tools.js';
+/**
+ * Strip `<analysis>...</analysis>` scratchpad blocks from LLM response text.
+ * The analysis is a reasoning scaffold that improves verdict quality but
+ * should not leak into the parsed JSON output.
+ */
+export function stripAnalysis(text) {
+    const match = text.match(/<analysis>([\s\S]*?)<\/analysis>/);
+    const analysis = match?.[1]?.trim() || undefined;
+    const cleaned = text.replace(/<analysis>[\s\S]*?<\/analysis>/g, '').trim();
+    return { cleaned, analysis };
+}
 /**
  * LLM-powered task completion reviewer.
  * Makes a single judgment call: did the bot accomplish the assigned task?
@@ -77,7 +88,9 @@ Rate each criterion as PASS or FAIL:
 
 If you need to verify file contents to judge the RESULT criterion, use the read_file tool. Only read files if the evidence is ambiguous.
 
-Respond with exactly:
+First, write your reasoning inside <analysis> tags. Work through each criterion step by step, examining the evidence.
+
+After your <analysis> block, output only the following JSON — no other text outside the tags:
 {"pass": true/false, "intent": "PASS/FAIL", "execution": "PASS/FAIL", "result": "PASS/FAIL", "completeness": "PASS/FAIL", "reason": "one sentence summary"}`;
     try {
         const { env } = context;
@@ -101,11 +114,13 @@ Respond with exactly:
         ];
         const executor = createWeaverExecutor(projectDir);
         const result = await runAgentLoop(provider, reviewTools, executor, [{ role: 'user', content: prompt }], { maxIterations: 2 });
+        // Strip <analysis> scratchpad before parsing JSON verdict
+        const { cleaned: cleanedSummary } = stripAnalysis(result.summary);
         // Parse the structured response
         let pass = true;
         let reason = 'Review completed';
         let criteria = {};
-        const jsonMatch = result.summary.match(/\{[\s\S]*"pass"[\s\S]*\}/);
+        const jsonMatch = cleanedSummary.match(/\{[\s\S]*"pass"[\s\S]*\}/);
         if (jsonMatch) {
             try {
                 const parsed = JSON.parse(jsonMatch[0]);
@@ -120,15 +135,15 @@ Respond with exactly:
             catch {
                 if (jsonMatch[0].includes('"pass": false') || jsonMatch[0].includes('"pass":false')) {
                     pass = false;
-                    reason = result.summary.slice(0, 200);
+                    reason = cleanedSummary.slice(0, 200);
                 }
             }
         }
         else {
-            const lower = result.summary.toLowerCase();
+            const lower = cleanedSummary.toLowerCase();
             if (lower.includes('"pass": false') || lower.includes('"pass":false')) {
                 pass = false;
-                reason = result.summary.slice(0, 200);
+                reason = cleanedSummary.slice(0, 200);
             }
         }
         context.reviewJson = JSON.stringify({ pass, reason, ...criteria });

package/dist/node-types/review-result.js.map

@@ -1 +1 @@
-{"version":3,"file":"review-result.js","sourceRoot":"","sources":["../../src/node-types/review-result.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"review-result.js","sourceRoot":"","sources":["../../src/node-types/review-result.ts"],"names":[],"mappings":"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"}

package/dist/ui/capability-editor.js

@@ -35,7 +35,7 @@ var OP_VALIDATE = "validate";
 var OP_TSC_CHECK = "tsc_check";
 var OP_RUN_TESTS = "run_tests";
 var OP_TASK_CREATE = "task_create";
-var OP_REMEMBER = "remember";
+var OP_LEARN = "learn";
 var OP_RECALL = "recall";
 var OP_RESPOND = "respond";
 var PLAN_OPERATIONS = [
@@ -317,7 +317,7 @@ Omit assignedProfile for auto-routing.`
 var CAP_MEMORY = {
   name: "memory",
   description: "Project memory persistence.",
-  tools: [OP_REMEMBER, OP_RECALL],
+  tools: [OP_LEARN, OP_RECALL],
   prompt: `## Project Memory
 - remember(key, value): Persists a key-value pair to .weaver/project-memory.json.
 - recall(): Returns all saved key-value pairs from project memory.`

package/dist/ui/profile-editor.js

@@ -217,7 +217,7 @@ var OP_VALIDATE = "validate";
 var OP_TSC_CHECK = "tsc_check";
 var OP_RUN_TESTS = "run_tests";
 var OP_TASK_CREATE = "task_create";
-var OP_REMEMBER = "remember";
+var OP_LEARN = "learn";
 var OP_RECALL = "recall";
 
 // src/bot/capability-registry.ts
@@ -488,7 +488,7 @@ Omit assignedProfile for auto-routing.`
 var CAP_MEMORY = {
   name: "memory",
   description: "Project memory persistence.",
-  tools: [OP_REMEMBER, OP_RECALL],
+  tools: [OP_LEARN, OP_RECALL],
   prompt: `## Project Memory
 - remember(key, value): Persists a key-value pair to .weaver/project-memory.json.
 - recall(): Returns all saved key-value pairs from project memory.`

package/dist/ui/swarm-dashboard.js

@@ -2668,7 +2668,7 @@ var OP_VALIDATE = "validate";
 var OP_TSC_CHECK = "tsc_check";
 var OP_RUN_TESTS = "run_tests";
 var OP_TASK_CREATE = "task_create";
-var OP_REMEMBER = "remember";
+var OP_LEARN = "learn";
 var OP_RECALL = "recall";
 
 // src/bot/capability-registry.ts
@@ -2939,7 +2939,7 @@ Omit assignedProfile for auto-routing.`
 var CAP_MEMORY = {
   name: "memory",
   description: "Project memory persistence.",
-  tools: [OP_REMEMBER, OP_RECALL],
+  tools: [OP_LEARN, OP_RECALL],
   prompt: `## Project Memory
 - remember(key, value): Persists a key-value pair to .weaver/project-memory.json.
 - recall(): Returns all saved key-value pairs from project memory.`

package/flowweaver.manifest.json

@@ -1,7 +1,7 @@
 {
   "manifestVersion": 2,
   "name": "@synergenius/flow-weaver-pack-weaver",
-  "version": "0.9.193",
+  "version": "0.9.195",
   "description": "AI bot for Flow Weaver. Execute tasks, run workflows, evolve autonomously.",
   "engineVersion": ">=0.22.10",
   "categories": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@synergenius/flow-weaver-pack-weaver",
-  "version": "0.9.193",
+  "version": "0.9.195",
   "description": "AI bot for Flow Weaver. Execute tasks, run workflows, evolve autonomously.",
   "type": "module",
   "main": "./dist/index.js",
@@ -70,7 +70,7 @@
     "dev:install": "npm run dev && node -e \"const p=process.argv[1]; if(!p){console.error('Usage: npm run dev:install -- /path/to/project');process.exit(1)} require('child_process').execSync('npm install --no-save /tmp/synergenius-flow-weaver-pack-weaver-'+require('./package.json').version+'.tgz',{cwd:p,stdio:'inherit'}); require('child_process').execSync('find '+p+' -name fw-exec-\\* -type f -delete',{stdio:'pipe'}); console.log('✓ Installed in '+p+' (cache cleaned)')\" --"
   },
   "devDependencies": {
-    "@synergenius/flow-weaver": "^0.24.0",
+    "@synergenius/flow-weaver": "^0.24.1",
     "@types/node": "^25.3.5",
     "esbuild": "^0.27.4",
     "tsx": "^4.0.0",

package/src/bot/assistant-core.ts

@@ -155,7 +155,7 @@ export async function runAssistant(opts: AssistantOptions): Promise<void> {
 
     // Run single message, print result, exit
     await runAgentLoop(provider, tools, executor, [{ role: 'user', content: pipeInput }], {
-      systemPrompt, maxIterations: 20,
+      systemPrompt: { prefix: systemPrompt, suffix: '' }, maxIterations: 20,
       onStreamEvent: (e) => { if (e.type === 'text_delta') out(e.text); },
       onToolEvent: (e) => {
         if (e.type === 'tool_call_start') out(`\n  ${c.cyan('◆')} ${e.name}\n`);
@@ -575,7 +575,7 @@ export async function runAssistant(opts: AssistantOptions): Promise<void> {
         executor,
         history, // full conversation history
         {
-          systemPrompt,
+          systemPrompt: { prefix: systemPrompt, suffix: '' },
           maxIterations: 20,
           onStreamEvent,
           onToolEvent,

package/src/bot/capability-registry.ts

@@ -10,7 +10,7 @@ import type { CapabilityDefinition } from './capability-types.js';
 import {
   OP_WRITE_FILE, OP_READ_FILE, OP_PATCH_FILE, OP_LIST_FILES,
   OP_RUN_SHELL, OP_VALIDATE, OP_TSC_CHECK, OP_RUN_TESTS,
-  OP_TASK_CREATE, OP_REMEMBER, OP_RECALL,
+  OP_TASK_CREATE, OP_LEARN, OP_RECALL,
 } from './operations.js';
 
 // ---------------------------------------------------------------------------
@@ -313,7 +313,7 @@ Omit assignedProfile for auto-routing.`,
 const CAP_MEMORY: CapabilityDefinition = {
   name: 'memory',
   description: 'Project memory persistence.',
-  tools: [OP_REMEMBER, OP_RECALL],
+  tools: [OP_LEARN, OP_RECALL],
   prompt: `## Project Memory
 - remember(key, value): Persists a key-value pair to .weaver/project-memory.json.
 - recall(): Returns all saved key-value pairs from project memory.`,

package/src/bot/context-compactor.ts

@@ -0,0 +1,147 @@
+/**
+ * LLM-based context compaction for task retries.
+ *
+ * When a task has 3+ runs, calls a fast-tier model to produce a structured
+ * summary of all attempts. The summary replaces verbose run history in
+ * the prompt builder, preserving semantic signal (intent, errors, approaches)
+ * that cascading truncation would destroy.
+ *
+ * Uses the <analysis> scratchpad pattern — the model reasons in tags that
+ * are stripped before storing the summary.
+ */
+
+import type { Task, RunProgress, CompactedRun } from './task-types.js';
+import type { ProviderInfo } from './types.js';
+import type { CostStrategy } from './profile-types.js';
+
+/** Minimum runs before compaction triggers, indexed by cost strategy. */
+const COMPACTION_THRESHOLDS: Record<CostStrategy, number> = {
+  frugal: 5,
+  balanced: 3,
+  performance: 2,
+};
+
+const COMPACTION_SYSTEM_PROMPT = `You are a context compactor for an AI task execution system. Your job is to
+summarize the history of a task's execution runs into a concise briefing for
+the next AI worker that will continue the task.
+
+The next worker will read the workspace files directly. Your summary should
+focus on WHAT WAS TRIED and WHY IT DIDN'T FULLY SUCCEED — not on describing
+file contents (the worker will read those).
+
+CRITICAL: Respond with TEXT ONLY. Do NOT call any tools. Tool calls will be
+REJECTED and will waste your only turn.
+
+Produce a structured summary with these sections. Be terse — total output
+must be under 800 tokens.
+
+<analysis>
+Think about what patterns emerge across the runs. What keeps failing? What
+approaches were tried? Is there stagnation?
+</analysis>
+
+## Task Intent
+One sentence: what is the task trying to achieve?
+
+## Approaches Tried
+Bullet list of distinct approaches attempted across runs, with outcomes.
+
+## Key Errors
+Specific error messages or test failures that recurred. Include exact names.
+
+## Files Touched
+Files created or modified across all runs (deduplicated).
+
+## What Works
+Any partial progress that should be preserved (tests passing, files correct).
+
+## Recommended Next Step
+Based on the pattern of failures, what should the next run try differently?`;
+
+/**
+ * Strip `<analysis>...</analysis>` scratchpad from LLM response.
+ * Reuses the same pattern as review-result.ts stripAnalysis.
+ */
+function stripAnalysis(text: string): string {
+  return text.replace(/<analysis>[\s\S]*?<\/analysis>/g, '').trim();
+}
+
+/**
+ * Build the user prompt from task + run history.
+ */
+export function buildCompactionPrompt(task: Task): string {
+  const lines: string[] = [];
+  lines.push(`Task: ${task.title}`);
+  lines.push(`Description: ${task.description}`);
+  lines.push('');
+  lines.push('Run history:');
+
+  for (let i = 0; i < task.context.runHistory.length; i++) {
+    const run = task.context.runHistory[i];
+    const rp = run as RunProgress;
+    lines.push(`Run ${i + 1} (${rp.outcome}):`);
+    if (rp.summary) lines.push(`  Summary: ${rp.summary}`);
+    if (rp.filesCreated?.length) lines.push(`  Files created: ${rp.filesCreated.join(', ')}`);
+    if (rp.filesModified?.length) lines.push(`  Files modified: ${rp.filesModified.join(', ')}`);
+    if (rp.remainingWork) lines.push(`  Remaining work: ${rp.remainingWork}`);
+    if (rp.blockers?.length) lines.push(`  Blockers: ${rp.blockers.join(', ')}`);
+    lines.push('');
+  }
+
+  if (task.lastAcceptanceCheck) {
+    const ac = task.lastAcceptanceCheck;
+    const checkLines = ac.results
+      .map(r => `  ${r.name}: ${r.pass ? 'PASS' : 'FAIL'}${r.detail ? ` (${r.detail.slice(0, 100)})` : ''}`)
+      .join('\n');
+    lines.push(`Acceptance check results:\n${checkLines}`);
+  }
+
+  lines.push(`Stagnation count: ${task.context.stagnationCount}`);
+
+  return lines.join('\n');
+}
+
+/**
+ * Determine if compaction should run for this task.
+ */
+export function shouldCompact(
+  task: Task,
+  costStrategy: CostStrategy = 'balanced',
+): boolean {
+  if (task.context.compactedSummary) return false;
+  const threshold = COMPACTION_THRESHOLDS[costStrategy] ?? 3;
+  return task.context.runHistory.length >= threshold;
+}
+
+/**
+ * Compact a task's run history into a structured summary via LLM.
+ *
+ * Returns the compacted summary string, or null if the LLM call fails.
+ * Failures are non-fatal — the prompt builder falls back to the existing
+ * context decay approach.
+ *
+ * @param task - The task to compact
+ * @param pInfo - Provider info for making the LLM call
+ * @param callAIFn - The callAI function (injected for testability)
+ */
+export async function compactRunHistory(
+  task: Task,
+  pInfo: Pick<ProviderInfo, 'type' | 'apiKey' | 'model' | 'cliBinPath'>,
+  callAIFn: (
+    pInfo: Pick<ProviderInfo, 'type' | 'apiKey' | 'model' | 'cliBinPath'>,
+    systemPrompt: string,
+    userPrompt: string,
+    maxTokens: number,
+  ) => Promise<string>,
+): Promise<string | null> {
+  try {
+    const userPrompt = buildCompactionPrompt(task);
+    const response = await callAIFn(pInfo, COMPACTION_SYSTEM_PROMPT, userPrompt, 1024);
+    const cleaned = stripAnalysis(response);
+    // Sanity check: the cleaned response should have meaningful content
+    if (cleaned.length < 20) return null;
+    return cleaned;
+  } catch {
+    return null;
+  }
+}

package/src/bot/memory-extraction-worker.ts

@@ -0,0 +1,58 @@
+/**
+ * Fire-and-forget memory extraction worker.
+ *
+ * Schedules heuristic extraction from completed runs into the KnowledgeStore.
+ * Uses AsyncMutex to serialize concurrent writes from parallel bot slots.
+ * Errors are caught and logged — never blocks task release.
+ */
+
+import { AsyncMutex } from './async-mutex.js';
+import { KnowledgeStore } from './knowledge-store.js';
+import { extractMemoryFacts } from './memory-extractor.js';
+import type { Task, RunProgress } from './task-types.js';
+
+/** Maximum total knowledge entries before skipping pattern:* writes. */
+const MAX_TOTAL_ENTRIES = 100;
+
+const mutex = new AsyncMutex();
+
+/**
+ * Schedule a fire-and-forget memory extraction.
+ * Returns immediately — extraction runs async in the background.
+ */
+export function scheduleMemoryExtraction(
+  projectDir: string,
+  task: Task,
+  runProgress: RunProgress,
+): void {
+  _doExtract(projectDir, task, runProgress).catch(err => {
+    if (process.env.WEAVER_VERBOSE) {
+      console.warn('[swarm] memory extraction failed:', err);
+    }
+  });
+}
+
+async function _doExtract(
+  projectDir: string,
+  task: Task,
+  runProgress: RunProgress,
+): Promise<void> {
+  await mutex.runExclusive(async () => {
+    const store = new KnowledgeStore(projectDir);
+    const existing = store.list();
+    const existingKeys = new Set(existing.map(e => e.key));
+
+    // If over the cap, only allow project:* overwrites (no new pattern:* entries)
+    const overCap = existing.length >= MAX_TOTAL_ENTRIES;
+
+    const facts = extractMemoryFacts(task, runProgress, existingKeys);
+
+    for (const fact of facts) {
+      // Skip pattern:* entries when over cap (project:* overwrites are always allowed)
+      if (overCap && fact.key.startsWith('pattern:') && !existingKeys.has(fact.key)) {
+        continue;
+      }
+      store.learn(fact.key, fact.value, `run:${runProgress.runId}`);
+    }
+  });
+}

package/src/bot/memory-extractor.ts

@@ -0,0 +1,213 @@
+/**
+ * Heuristic memory extraction from completed bot runs.
+ *
+ * Pure function — takes structured run data and returns candidate
+ * knowledge entries. No I/O, no LLM calls, no side effects.
+ *
+ * Key namespaces:
+ * - project:*  — canonical project facts (test runner, build tool, linter, pkg manager)
+ * - pattern:blocker:*  — recurring blockers
+ * - pattern:stagnation:*  — stalled task patterns
+ * - pattern:success:*  — first-run success patterns
+ */
+
+import type { Task, RunProgress } from './task-types.js';
+
+export interface MemoryFact {
+  key: string;
+  value: string;
+}
+
+/** Maximum facts to extract per run. */
+const MAX_FACTS_PER_RUN = 5;
+
+/** Maximum key length. */
+const MAX_KEY_LENGTH = 80;
+
+/** Maximum value length. */
+const MAX_VALUE_LENGTH = 500;
+
+// ── Detection patterns ──────────────────────────────────────────────
+
+interface DetectionRule {
+  key: string;
+  pattern: RegExp;
+  value: string;
+}
+
+const TEST_RUNNERS: DetectionRule[] = [
+  { key: 'project:test-runner', pattern: /\bvitest\b/i, value: 'vitest' },
+  { key: 'project:test-runner', pattern: /\bjest\b/i, value: 'jest' },
+  { key: 'project:test-runner', pattern: /\bmocha\b/i, value: 'mocha' },
+  { key: 'project:test-runner', pattern: /\bplaywright\b/i, value: 'playwright' },
+];
+
+const BUILD_TOOLS: DetectionRule[] = [
+  { key: 'project:build-tool', pattern: /\bvite\b/i, value: 'vite' },
+  { key: 'project:build-tool', pattern: /\bwebpack\b/i, value: 'webpack' },
+  { key: 'project:build-tool', pattern: /\besbuild\b/i, value: 'esbuild' },
+  { key: 'project:build-tool', pattern: /\btsc\b/i, value: 'tsc' },
+];
+
+const PKG_MANAGERS: DetectionRule[] = [
+  { key: 'project:pkg-manager', pattern: /\bpnpm\b/i, value: 'pnpm' },
+  { key: 'project:pkg-manager', pattern: /\byarn\b/i, value: 'yarn' },
+  { key: 'project:pkg-manager', pattern: /\bbun\b/i, value: 'bun' },
+  { key: 'project:pkg-manager', pattern: /\bnpm\b/i, value: 'npm' },
+];
+
+const LINTERS: DetectionRule[] = [
+  { key: 'project:linter', pattern: /\bbiome\b/i, value: 'biome' },
+  { key: 'project:linter', pattern: /\beslint\b/i, value: 'eslint' },
+  { key: 'project:linter', pattern: /\bprettier\b/i, value: 'prettier' },
+];
+
+// ── Helpers ──────────────────────────────────────────────────────────
+
+function truncate(s: string, max: number): string {
+  return s.length <= max ? s : s.slice(0, max - 3) + '...';
+}
+
+function normalizeBlockerKey(text: string): string {
+  return text
+    .toLowerCase()
+    .replace(/[^a-z0-9\s-]/g, '')
+    .trim()
+    .replace(/\s+/g, '-')
+    .slice(0, 40);
+}
+
+function searchableText(rp: RunProgress): string {
+  const parts = [rp.summary ?? ''];
+  if (rp.checks) {
+    for (const v of Object.values(rp.checks)) {
+      parts.push(String(v));
+    }
+  }
+  return parts.join(' ');
+}
+
+function detectFirst(
+  text: string,
+  rules: DetectionRule[],
+): MemoryFact | undefined {
+  for (const rule of rules) {
+    if (rule.pattern.test(text)) {
+      return { key: rule.key, value: rule.value };
+    }
+  }
+  return undefined;
+}
+
+function countExtensions(files: string[]): Record<string, number> {
+  const counts: Record<string, number> = {};
+  for (const f of files) {
+    const ext = f.includes('.') ? '.' + f.split('.').pop() : '(none)';
+    counts[ext] = (counts[ext] ?? 0) + 1;
+  }
+  return counts;
+}
+
+// ── Main extraction ─────────────────────────────────────────────────
+
+/**
+ * Extract generalizable facts from a completed run.
+ *
+ * @param task - The task that was executed
+ * @param rp - The run's progress/result data
+ * @param existingKeys - Keys already in the KnowledgeStore (for dedup)
+ * @returns Array of facts to persist (max MAX_FACTS_PER_RUN)
+ */
+export function extractMemoryFacts(
+  task: Task,
+  rp: RunProgress,
+  existingKeys: Set<string>,
+): MemoryFact[] {
+  const facts: MemoryFact[] = [];
+  const text = searchableText(rp);
+  const allFiles = [...rp.filesCreated, ...rp.filesModified];
+
+  // ── Project-level facts (overwrite existing) ──
+
+  const testRunner = detectFirst(text, TEST_RUNNERS);
+  if (testRunner) facts.push(testRunner);
+
+  const buildTool = detectFirst(text, BUILD_TOOLS);
+  if (buildTool) facts.push(buildTool);
+
+  const pkgManager = detectFirst(text, PKG_MANAGERS);
+  if (pkgManager) facts.push(pkgManager);
+
+  const linter = detectFirst(text, LINTERS);
+  if (linter) facts.push(linter);
+
+  // ── Source file pattern ──
+
+  if (allFiles.length >= 3 && !existingKeys.has('project:source-pattern')) {
+    const extCounts = countExtensions(allFiles);
+    const dominant = Object.entries(extCounts)
+      .sort(([, a], [, b]) => b - a)
+      .slice(0, 3)
+      .map(([ext, count]) => `${ext} (${count})`)
+      .join(', ');
+    facts.push({
+      key: 'project:source-pattern',
+      value: truncate(dominant, MAX_VALUE_LENGTH),
+    });
+  }
+
+  // ── Blockers ──
+
+  if (rp.blockers && rp.blockers.length > 0) {
+    for (const blocker of rp.blockers.slice(0, 2)) {
+      const normalized = normalizeBlockerKey(blocker);
+      if (!normalized) continue;
+      const key = truncate(`pattern:blocker:${normalized}`, MAX_KEY_LENGTH);
+      if (!existingKeys.has(key)) {
+        facts.push({ key, value: truncate(blocker, MAX_VALUE_LENGTH) });
+      }
+    }
+  }
+
+  // ── Stagnation pattern ──
+
+  if (
+    rp.outcome === 'stalled' &&
+    task.context.stagnationCount > 1
+  ) {
+    const key = truncate(`pattern:stagnation:${task.id}`, MAX_KEY_LENGTH);
+    if (!existingKeys.has(key)) {
+      facts.push({
+        key,
+        value: truncate(
+          `Task "${task.title}" stalled ${task.context.stagnationCount}x. Last: ${rp.summary}`,
+          MAX_VALUE_LENGTH,
+        ),
+      });
+    }
+  }
+
+  // ── First-run success pattern ──
+
+  if (
+    rp.outcome === 'completed' &&
+    task.context.runHistory.length <= 1
+  ) {
+    const key = truncate(
+      `pattern:success:${rp.profileId}:${task.complexity ?? 'unknown'}`,
+      MAX_KEY_LENGTH,
+    );
+    if (!existingKeys.has(key)) {
+      facts.push({
+        key,
+        value: truncate(
+          `Profile ${rp.profileId} completed ${task.complexity ?? 'unknown'}-complexity task on first run`,
+          MAX_VALUE_LENGTH,
+        ),
+      });
+    }
+  }
+
+  // Enforce max facts per run
+  return facts.slice(0, MAX_FACTS_PER_RUN);
+}

package/src/bot/operations.ts

@@ -38,8 +38,10 @@ export const OP_TASK_CREATE = 'task_create';
 // Memory
 // ---------------------------------------------------------------------------
 
-export const OP_REMEMBER = 'remember';
+export const OP_LEARN = 'learn';
 export const OP_RECALL = 'recall';
+/** @deprecated Use OP_LEARN. Kept for step-executor backward compat. */
+export const OP_REMEMBER = 'remember';
 
 // ---------------------------------------------------------------------------
 // Passthrough (no execution needed)