discoclaw 0.5.0 → 0.5.2

package/.context/memory.md

@@ -33,7 +33,10 @@ Bot:             We've been working through your Express → Fastify migration.
 
 Structured store of user facts. Each item has a kind (fact, preference, project,
 constraint, person, tool, workflow), deduplication by content hash, and a 200-item
-cap per user. Injected into every prompt.
+cap per user. Items track `hitCount` (incremented each time the item is selected
+for prompt injection) and `lastHitAt` (timestamp of most recent selection).
+Injected into every prompt using a blended score of recency and usage frequency
+rather than raw `updatedAt` alone.
 
 **What the user sees:**
 - The bot knows your preferences, projects, and key facts across all conversations.
@@ -53,7 +56,7 @@ Bot:   Given your preference for Rust in systems work, I'd lean that way —
 
 #### Consolidation
 
-When the active item count for a user crosses a threshold (`DISCOCLAW_DURABLE_CONSOLIDATION_THRESHOLD`, default `100`), consolidation can be triggered to prune and merge the list. A single `fast`-tier model call receives all active items and is asked to return a revised list — removing exact duplicates, merging near-duplicates, dropping clearly stale items, and preserving everything that is still plausibly useful. The model must not invent new facts or change the meaning of existing ones.
+When the active item count for a user crosses a threshold (`DISCOCLAW_DURABLE_CONSOLIDATION_THRESHOLD`, default `100`), consolidation can be triggered to prune and merge the list. A single `fast`-tier model call receives all active items and is asked to return a revised list — removing exact duplicates, merging near-duplicates, dropping clearly stale items, and preserving everything that is still plausibly useful. The model must not invent new facts or change the meaning of existing ones. Items with low `hitCount` and stale `lastHitAt` are natural eviction candidates — the blended score surfaces which items the AI actually uses versus those that were added once and never referenced again.
 
 The revised list is applied atomically: items absent from the model's output are deprecated via `deprecateItems()`; new or rewritten items are written via `addItem()`. Items present verbatim in the output are left untouched (no unnecessary writes).
 
@@ -183,17 +186,18 @@ no separator). The three memory builders run in `Promise.all` so they add no lat
 
 | Layer | Default budget | Default state | How it stays within budget |
 |-------|---------------|---------------|---------------------------|
-| Durable memory | 2000 chars | on | Sorts active items by recency, adds one at a time, stops when next line would exceed budget. Older facts silently excluded. |
+| Durable memory | 2000 chars | on | Ranks active items by blended score (recency + hit frequency), adds one at a time, stops when next line would exceed budget. Low-scoring items silently excluded. |
 | Rolling summary | 2000 chars | on | The `fast`-tier model is prompted with `"Keep the summary under {maxChars} characters"`. Replaces itself each update rather than growing. |
 | Message history | 3000 chars | on | Fetches up to 10 messages, walks backward from newest. Bot messages truncated to fit; user messages that don't fit cause a hard stop. |
 | Short-term memory | 1000 chars | **on** | Filters by max age (default 6h), sorts newest-first, accumulates lines until budget hit. |
+| Open tasks | 600 chars | **on** | Queries TaskStore for non-closed tasks at invocation time, formats as a compact list. |
 | Auto-extraction | n/a | **off** | Write-side only — extracts facts for future prompts, adds nothing to the current turn. |
 | Workspace files | no budget | on (DMs only) | Loaded as file paths, not inlined. The runtime reads them on demand. |
 
 ### Default prompt overhead
 
-With the three enabled layers at default settings, worst-case memory overhead is
-**~7000 chars (~1750 tokens)**. With all layers enabled, ~8000 chars (~2000 tokens).
+With the four enabled layers at default settings, worst-case memory overhead is
+**~8600 chars (~2150 tokens)**.
 This is modest against typical `capable`-tier context windows.
 
 In practice most prompts use far less — a user with 5 durable items and a short summary
@@ -201,7 +205,7 @@ might add ~500 chars total. Sections with no data produce zero overhead.
 
 ### Where the budgets are enforced
 
-- **Durable**: `selectItemsForInjection()` in `durable-memory.ts:152`
+- **Durable**: `selectItemsForInjection()` in `durable-memory.ts:152` — scores items using `hitCount`, `lastHitAt`, and `updatedAt`; increments hit counters on selected items
 - **Short-term**: `selectEntriesForInjection()` in `shortterm-memory.ts:113`
 - **Summary**: `fast`-tier prompt constraint in `summarizer.ts:63`
 - **History**: `fetchMessageHistory()` in `message-history.ts:38`
@@ -216,6 +220,7 @@ Memory sections are injected into every prompt in this order:
 Context files (PA + MEMORY.md + daily logs + channel context)
   → Durable memory section (up to 2000 chars)
   → Short-term memory section (up to 1000 chars)
+  → Open tasks section (up to 600 chars)
   → Rolling summary section (up to 2000 chars)
   → Message history (up to 3000 chars)
   → Discord actions

package/.context/pa.md

@@ -26,6 +26,7 @@ Templates live in `templates/workspace/` and are scaffolded on first run (copy-i
 - **Never go silent.** Acknowledge before tool calls.
 - Narrate failures and pivots.
 - Summarize outcomes; don't assume the user saw tool output.
+- **Close the loop.** When query actions return data, answer the user's original question in the same response. Don't chain query after query without delivering a conclusion. If you need more data, say what you're checking and why — but every auto-follow-up response should either deliver the answer or visibly advance toward one.
 - **Never edit `tasks.jsonl`, cron store files, or other data files directly.** Always use the corresponding discord action (`taskUpdate`, `taskCreate`, `cronUpdate`, etc.). Direct file edits bypass Discord thread sync and leave the UI stale.
 
 ## Discord Formatting

package/.context/tasks.md

@@ -5,6 +5,13 @@ Tasks are backed by an in-process `TaskStore` and synced to Discord forum thread
 Ground-zero post-hard-cut refactor tracker: `docs/tasks-ground-zero-post-hard-cut-plan.md`
 Ground-zero task architecture refactor status: COMPLETE (FROZEN), verified on 2026-02-21.
 
+## Prompt Injection
+
+Open task statuses are injected into prompts at invocation time, sourced directly
+from the TaskStore. This ensures every new session starts with accurate task state
+regardless of rolling summary freshness. See `.context/memory.md` for assembly order
+and token budget.
+
 ## Data Model
 
 Canonical type: `TaskData` in `src/tasks/types.ts`.

package/.context/voice.md

@@ -83,6 +83,6 @@ When `voiceEnabled=true`, the post-connect block in `src/index.ts` initializes t
 | `DEEPGRAM_API_KEY` | — | Required for deepgram STT and TTS |
 | `DEEPGRAM_STT_MODEL` | `nova-3-conversationalai` | Deepgram STT model name |
 | `DEEPGRAM_TTS_VOICE` | `aura-2-asteria-en` | Deepgram TTS voice name |
-| `DEEPGRAM_TTS_SPEED` | `1.0` | Deepgram TTS playback speed (range 0.5–1.5) |
+| `DEEPGRAM_TTS_SPEED` | `1.3` | Deepgram TTS playback speed (range 0.5–1.5) |
 | `CARTESIA_API_KEY` | — | Required for cartesia TTS |
 | *(built-in)* | — | Telegraphic style instruction hardcoded into every voice AI invocation — front-loads the answer, strips preambles/markdown/filler, keeps responses short for TTS latency. Not an env var; not overridable by `DISCOCLAW_VOICE_SYSTEM_PROMPT`. |

package/.env.example

@@ -32,7 +32,7 @@ DISCORD_ALLOW_USER_IDS=
 # connect and persisted to system-scaffold.json. Only set this to override the auto-created channel.
 #DISCOCLAW_CRON_FORUM=
 
-# Default model for cron job execution: fast | capable (or concrete model names).
+# Default model for cron job execution: fast | capable | deep (or concrete model names).
 # Defaults to capable (resolves to Sonnet on Claude Code) — avoids using Opus on routine cron work.
 # Override at runtime via `!models set cron-exec <model>`.
 #DISCOCLAW_CRON_EXEC_MODEL=capable
@@ -62,7 +62,7 @@ DISCORD_GUILD_ID=
 # Disable Codex session persistence/resume (workaround for session DB issues):
 #CODEX_DISABLE_SESSIONS=1
 
-# Model tier: fast | capable (provider-agnostic).
+# Model tier: fast | capable | deep (provider-agnostic).
 # Concrete model names (e.g. opus, sonnet, gpt-4o) are still accepted as passthrough.
 #RUNTIME_MODEL=capable
 

package/.env.example.full

@@ -49,36 +49,40 @@ DISCORD_ALLOW_USER_IDS=
 #PRIMARY_RUNTIME=claude
 
 # --- Primary models ---
-# Model tier: fast | capable (provider-agnostic).
+# Model tier: fast | capable | deep (provider-agnostic).
 # Concrete model names (e.g. opus, sonnet, gpt-4o) are still accepted as passthrough.
 #RUNTIME_MODEL=capable
 
 # --- Fast-tier default ---
 # Sets the default model for all "small" tasks (summary, cron, cron auto-tag, task auto-tag).
-# Individual overrides (DISCOCLAW_SUMMARY_MODEL, etc.) still win when set.
+# Valid tiers: fast | capable | deep. Individual overrides (DISCOCLAW_SUMMARY_MODEL, etc.) still win when set.
 #DISCOCLAW_FAST_MODEL=fast
 
 # --- Tier model overrides ---
 # Override the concrete model resolved for any runtime × tier combination.
-# Format: DISCOCLAW_TIER_<RUNTIME>_<FAST|CAPABLE>=<model>
+# Format: DISCOCLAW_TIER_<RUNTIME>_<FAST|CAPABLE|DEEP>=<model>
 # Unset = use the built-in default shown in the comments.
 # Concrete model names (e.g. sonnet, gpt-4o-mini) are passed through unchanged.
 #
 # Claude Code adapter (default: fast=haiku, capable=sonnet):
 #DISCOCLAW_TIER_CLAUDE_CODE_FAST=haiku
 #DISCOCLAW_TIER_CLAUDE_CODE_CAPABLE=sonnet
+#DISCOCLAW_TIER_CLAUDE_CODE_DEEP=claude-opus-4-6
 #
 # Gemini CLI adapter (default: fast=gemini-2.5-flash, capable=gemini-2.5-pro):
 #DISCOCLAW_TIER_GEMINI_FAST=gemini-2.5-flash
 #DISCOCLAW_TIER_GEMINI_CAPABLE=gemini-2.5-pro
+#DISCOCLAW_TIER_GEMINI_DEEP=gemini-2.5-pro
 #
 # OpenAI-compatible adapter (default: adapter-default for both tiers):
 #DISCOCLAW_TIER_OPENAI_FAST=gpt-4o-mini
 #DISCOCLAW_TIER_OPENAI_CAPABLE=gpt-4o
+#DISCOCLAW_TIER_OPENAI_DEEP=
 #
 # Codex CLI adapter (default: adapter-default for both tiers):
 #DISCOCLAW_TIER_CODEX_FAST=
 #DISCOCLAW_TIER_CODEX_CAPABLE=
+#DISCOCLAW_TIER_CODEX_DEEP=
 #
 # Tool-tier map — override which tool tier a model resolves to.
 # Comma-separated model=tier pairs. Tiers: basic, standard, full.
@@ -111,9 +115,9 @@ DISCORD_ALLOW_USER_IDS=
 # Cron — forum-based scheduled tasks (enabled by default)
 # ----------------------------------------------------------
 # Forum channel ID is auto-created on first connect (see AUTO-DETECTED above).
-# Model tier for cron execution: fast | capable (concrete names accepted as passthrough).
+# Model tier for cron execution: fast | capable | deep (concrete names accepted as passthrough).
 #DISCOCLAW_CRON_MODEL=fast
-# Default model tier for cron job execution (fast | capable, concrete names accepted as passthrough).
+# Default model tier for cron job execution (fast | capable | deep, concrete names accepted as passthrough).
 # Defaults to capable (resolves to Sonnet on Claude Code) — avoids using Opus on routine cron work.
 # Per-job overrides and AI-classified model still win when set. Override at runtime via
 # `!models set cron-exec <model>`.
@@ -331,7 +335,7 @@ DISCOCLAW_DISCORD_ACTIONS_DEFER=1
 #USE_GROUP_DIR_CWD=0
 # Tools available to the runtime (Glob, Grep, Write now included by default).
 #RUNTIME_TOOLS=Bash,Read,Write,Edit,Glob,Grep,WebSearch,WebFetch
-# Fallback model tier when primary is overloaded (concrete names accepted as passthrough).
+# Fallback model tier when primary is overloaded: fast | capable | deep (concrete names accepted as passthrough).
 #RUNTIME_FALLBACK_MODEL=fast
 # Max USD spend per Claude CLI process. One-shot: per invocation.
 # Multi-turn: per session lifetime (accumulates across turns). Recommend $5-10.
@@ -529,7 +533,7 @@ DISCOCLAW_DISCORD_ACTIONS_IMAGEGEN=0
 # in system-scaffold.json). Only set this to override the auto-discovered channel.
 # Leave unset to disable transcript mirroring.
 #DISCOCLAW_VOICE_LOG_CHANNEL=  # e.g. "voice-log" if using the default scaffold
-# Model for voice AI responses: tier (fast | capable) or concrete name (sonnet, opus, haiku).
+# Model for voice AI responses: tier (fast | capable | deep) or concrete name (sonnet, opus, haiku).
 # Independent of RUNTIME_MODEL — allows tuning voice latency vs quality separately from chat.
 # Switchable at runtime via `modelSet voice <model>`.
 # Default: follows DISCOCLAW_FAST_MODEL (override here for voice-specific tuning).
@@ -545,8 +549,8 @@ DISCOCLAW_DISCORD_ACTIONS_IMAGEGEN=0
 # Deepgram TTS voice for speech synthesis (default: aura-2-asteria-en).
 # See https://developers.deepgram.com/docs/tts-models for available voices.
 #DEEPGRAM_TTS_VOICE=aura-2-asteria-en
-# Deepgram TTS playback speed (range: 0.5–1.5, default: 1.0).
+# Deepgram TTS playback speed (range: 0.5–1.5, default: 1.3).
 # Values below 1.0 slow down speech; values above 1.0 speed it up.
-#DEEPGRAM_TTS_SPEED=1.0
+#DEEPGRAM_TTS_SPEED=1.3
 # API key for Cartesia Sonic-3 TTS. Required when DISCOCLAW_TTS_PROVIDER=cartesia.
 #CARTESIA_API_KEY=

package/dist/config.js

@@ -249,7 +249,7 @@ export function parseConfig(env) {
     const deepgramTtsSpeed = (() => {
         const raw = parseTrimmedString(env, 'DEEPGRAM_TTS_SPEED');
         if (raw == null)
-            return undefined;
+            return 1.3;
         const n = parseFloat(raw);
         if (!Number.isFinite(n) || n < 0.5 || n > 1.5) {
             throw new Error(`DEEPGRAM_TTS_SPEED must be a number between 0.5 and 1.5, got "${raw}"`);

package/dist/cron/auto-tag.js

@@ -59,7 +59,7 @@ export async function autoTagCron(runtime, name, prompt, availableTags, opts) {
 // Model tier classification
 // ---------------------------------------------------------------------------
 /**
- * Classify whether a cron job needs capable-tier or can run on fast.
+ * Classify whether a cron job needs deep/capable-tier or can run on fast.
  *
  * Two-step logic:
  * 1. Cadence default: frequent/hourly (>1x/day) → fast immediately (cost optimization).
@@ -70,10 +70,11 @@ export async function classifyCronModel(runtime, name, prompt, cadence, opts) {
     if (cadence === 'frequent' || cadence === 'hourly') {
         return 'fast';
     }
-    const classifyPrompt = `Does this scheduled task require advanced reasoning (complex analysis, ` +
-        `multi-step planning, nuanced writing) or can it be handled with basic ` +
-        `capabilities (simple lookups, templated responses, data formatting)?\n\n` +
-        `Reply with ONLY one word: "capable" or "fast"\n\n` +
+    const classifyPrompt = `Does this scheduled task require heavy reasoning (complex analysis, ` +
+        `multi-step planning, deep code review), standard advanced capabilities ` +
+        `(nuanced writing, moderate analysis), or basic capabilities ` +
+        `(simple lookups, templated responses, data formatting)?\n\n` +
+        `Reply with ONLY one word: "deep", "capable", or "fast"\n\n` +
         `Job name: ${name}\n` +
         `Instruction: ${prompt.slice(0, 500)}`;
     let finalText = '';
@@ -96,5 +97,7 @@ export async function classifyCronModel(runtime, name, prompt, cadence, opts) {
         }
     }
     const output = (finalText || deltaText).trim().toLowerCase();
-    return output === 'capable' ? 'capable' : 'fast';
+    if (output === 'capable' || output === 'deep')
+        return output;
+    return 'fast';
 }

package/dist/cron/cron-sync-coordinator.test.js

@@ -9,6 +9,7 @@ vi.mock('./cron-sync.js', () => ({
         tagsApplied: 1,
         namesUpdated: 0,
         statusMessagesUpdated: 1,
+        promptMessagesCreated: 0,
         orphansDetected: 0,
     })),
 }));
@@ -40,7 +41,7 @@ describe('CronSyncCoordinator', () => {
         vi.resetAllMocks();
         mockReload.mockResolvedValue(2);
         mockRunCronSync.mockResolvedValue({
-            tagsApplied: 1, namesUpdated: 0, statusMessagesUpdated: 1, orphansDetected: 0,
+            tagsApplied: 1, namesUpdated: 0, statusMessagesUpdated: 1, promptMessagesCreated: 0, orphansDetected: 0,
         });
     });
     it('reloads tag map before sync when tagMapPath is set', async () => {
@@ -69,7 +70,7 @@ describe('CronSyncCoordinator', () => {
     it('coalesced concurrent sync returns null', async () => {
         let resolveSync;
         mockRunCronSync.mockImplementation(() => new Promise((resolve) => {
-            resolveSync = () => resolve({ tagsApplied: 0, namesUpdated: 0, statusMessagesUpdated: 0, orphansDetected: 0 });
+            resolveSync = () => resolve({ tagsApplied: 0, namesUpdated: 0, statusMessagesUpdated: 0, promptMessagesCreated: 0, orphansDetected: 0 });
         }));
         const coordinator = new CronSyncCoordinator(makeOpts());
         const first = coordinator.sync();
@@ -85,10 +86,10 @@ describe('CronSyncCoordinator', () => {
         mockRunCronSync.mockImplementation(() => new Promise((resolve) => {
             callCount++;
             if (callCount === 1) {
-                resolveSync = () => resolve({ tagsApplied: 0, namesUpdated: 0, statusMessagesUpdated: 0, orphansDetected: 0 });
+                resolveSync = () => resolve({ tagsApplied: 0, namesUpdated: 0, statusMessagesUpdated: 0, promptMessagesCreated: 0, orphansDetected: 0 });
             }
             else {
-                resolve({ tagsApplied: 0, namesUpdated: 0, statusMessagesUpdated: 0, orphansDetected: 0 });
+                resolve({ tagsApplied: 0, namesUpdated: 0, statusMessagesUpdated: 0, promptMessagesCreated: 0, orphansDetected: 0 });
             }
         }));
         const coordinator = new CronSyncCoordinator(makeOpts());

package/dist/cron/cron-sync.js

@@ -1,3 +1,4 @@
+import { EmbedBuilder } from 'discord.js';
 import { CADENCE_TAGS } from './run-stats.js';
 import { detectCadence } from './cadence.js';
 import { autoTagCron, classifyCronModel } from './auto-tag.js';
@@ -24,13 +25,14 @@ export async function runCronSync(opts) {
     const forum = await resolveForumChannel(client, forumId);
     if (!forum) {
         log?.warn({ forumId }, 'cron-sync: forum not found');
-        return { tagsApplied: 0, namesUpdated: 0, statusMessagesUpdated: 0, orphansDetected: 0 };
+        return { tagsApplied: 0, namesUpdated: 0, statusMessagesUpdated: 0, promptMessagesCreated: 0, orphansDetected: 0 };
     }
     const tagMap = opts.tagMap;
     const purposeTags = purposeTagNames(tagMap);
     let tagsApplied = 0;
     let namesUpdated = 0;
     let statusMessagesUpdated = 0;
+    let promptMessagesCreated = 0;
     let orphansDetected = 0;
     const asEditableCronThread = (value) => {
         if (!value || typeof value !== 'object')
@@ -172,6 +174,51 @@ export async function runCronSync(opts) {
         }
         await sleep(throttleMs);
     }
+    // Phase 3.5: Prompt message backfill.
+    for (const job of jobs) {
+        const fullJob = scheduler.getJob(job.id);
+        if (!fullJob?.cronId)
+            continue;
+        const record = statsStore.getRecord(fullJob.cronId);
+        if (!record?.prompt || record.promptMessageId)
+            continue;
+        try {
+            let thread = null;
+            const cached = client.channels.cache.get(fullJob.threadId);
+            if (cached && cached.isThread()) {
+                thread = cached;
+            }
+            else {
+                try {
+                    const fetched = await client.channels.fetch(fullJob.threadId);
+                    if (fetched && fetched.isThread())
+                        thread = fetched;
+                }
+                catch {
+                    // Thread may have been deleted.
+                }
+            }
+            if (!thread)
+                continue;
+            const embed = new EmbedBuilder()
+                .setTitle('\uD83D\uDCCB Cron Prompt')
+                .setDescription(record.prompt.slice(0, 4096))
+                .setColor(0x5865F2);
+            const msg = await thread.send({ embeds: [embed], allowedMentions: { parse: [] } });
+            try {
+                await msg.pin();
+            }
+            catch {
+                // Non-fatal if pin fails.
+            }
+            await statsStore.upsertRecord(record.cronId, record.threadId, { promptMessageId: msg.id });
+            promptMessagesCreated++;
+        }
+        catch (err) {
+            log?.warn({ err, cronId: fullJob.cronId }, 'cron-sync:phase3.5 prompt message failed');
+        }
+        await sleep(throttleMs);
+    }
     // Phase 4: Orphan detection (non-destructive, log only).
     for (const thread of threads.values()) {
         const editableThread = asEditableCronThread(thread);
@@ -184,6 +231,6 @@ export async function runCronSync(opts) {
             log?.warn({ threadId: editableThread.id, name: editableThread.name }, 'cron-sync:phase4 orphan thread (no registered job)');
         }
     }
-    log?.info({ tagsApplied, namesUpdated, statusMessagesUpdated, orphansDetected }, 'cron-sync: complete');
-    return { tagsApplied, namesUpdated, statusMessagesUpdated, orphansDetected };
+    log?.info({ tagsApplied, namesUpdated, statusMessagesUpdated, promptMessagesCreated, orphansDetected }, 'cron-sync: complete');
+    return { tagsApplied, namesUpdated, statusMessagesUpdated, promptMessagesCreated, orphansDetected };
 }

package/dist/cron/cron-tag-map-watcher.test.js

@@ -12,7 +12,7 @@ function mockLog() {
 }
 function makeCoordinator() {
     return {
-        sync: vi.fn(async () => ({ tagsApplied: 0, namesUpdated: 0, statusMessagesUpdated: 0, orphansDetected: 0 })),
+        sync: vi.fn(async () => ({ tagsApplied: 0, namesUpdated: 0, statusMessagesUpdated: 0, promptMessagesCreated: 0, orphansDetected: 0 })),
     };
 }
 describe('startCronTagMapWatcher', () => {

package/dist/cron/executor.js

@@ -1,5 +1,6 @@
 import { acquireCronLock, releaseCronLock } from './job-lock.js';
 import { resolveChannel } from '../discord/action-utils.js';
+import { DiscordTransportClient } from '../discord/transport-client.js';
 import * as discordActions from '../discord/actions.js';
 import { sendChunks, appendUnavailableActionTypesNotice, appendParseFailureNotice } from '../discord/output-common.js';
 import { buildPromptPreamble, loadWorkspacePaFiles, inlineContextFiles, resolveEffectiveTools } from '../discord/prompt-common.js';
@@ -253,6 +254,7 @@ export async function executeCronJob(job, ctx) {
                     channelId: targetChannel.id,
                     messageId: '',
                     deferScheduler: ctx.deferScheduler,
+                    transport: new DiscordTransportClient(guild, ctx.client),
                     confirmation: {
                         mode: 'automated',
                     },
@@ -270,11 +272,8 @@ export async function executeCronJob(job, ctx) {
                     metrics.recordActionResult(result.ok);
                     ctx.log?.info({ flow: 'cron', jobId: job.id, ok: result.ok }, 'obs.action.result');
                 }
-                const displayLines = discordActions.buildDisplayResultLines(actions, results);
                 const anyActionSucceeded = results.some((r) => r.ok);
-                processedText = displayLines.length > 0
-                    ? cleanText.trimEnd() + '\n\n' + displayLines.join('\n')
-                    : cleanText.trimEnd();
+                processedText = discordActions.appendActionResults(cleanText.trimEnd(), actions, results);
                 // When all display lines were suppressed and there's no prose, skip posting.
                 if (!processedText.trim() && anyActionSucceeded && strippedUnrecognizedTypes.length === 0 && parseFailuresCount === 0) {
                     ctx.log?.info({ jobId: job.id }, 'cron:reply suppressed (actions-only, no display text)');

package/dist/cron/run-stats.js

@@ -5,7 +5,7 @@ import crypto from 'node:crypto';
 // Types
 // ---------------------------------------------------------------------------
 export const CADENCE_TAGS = ['yearly', 'frequent', 'hourly', 'daily', 'weekly', 'monthly'];
-export const CURRENT_VERSION = 7;
+export const CURRENT_VERSION = 8;
 // ---------------------------------------------------------------------------
 // Stable Cron ID generation
 // ---------------------------------------------------------------------------
@@ -313,5 +313,9 @@ export async function loadRunStats(filePath) {
     if (store.version === 6) {
         store.version = 7;
     }
+    // Migrate v7 → v8: no-op — new field (promptMessageId) is optional and defaults to absent.
+    if (store.version === 7) {
+        store.version = 8;
+    }
     return new CronRunStats(store, filePath);
 }

package/dist/cron/run-stats.test.js

@@ -38,7 +38,7 @@ describe('CronRunStats', () => {
     it('creates empty store on missing file', async () => {
         const stats = await loadRunStats(statsPath);
         const store = stats.getStore();
-        expect(store.version).toBe(7);
+        expect(store.version).toBe(8);
         expect(Object.keys(store.jobs)).toHaveLength(0);
     });
     it('upserts and retrieves records by cronId', async () => {
@@ -244,7 +244,7 @@ describe('CronRunStats', () => {
 describe('emptyStore', () => {
     it('returns valid initial structure', () => {
         const store = emptyStore();
-        expect(store.version).toBe(7);
+        expect(store.version).toBe(8);
         expect(store.updatedAt).toBeGreaterThan(0);
         expect(Object.keys(store.jobs)).toHaveLength(0);
     });
@@ -271,7 +271,7 @@ describe('loadRunStats version migration', () => {
         };
         await fs.writeFile(statsPath, JSON.stringify(v3Store), 'utf-8');
         const stats = await loadRunStats(statsPath);
-        expect(stats.getStore().version).toBe(7);
+        expect(stats.getStore().version).toBe(8);
         const rec = stats.getRecord('cron-migrated');
         expect(rec).toBeDefined();
         expect(rec.cronId).toBe('cron-migrated');
@@ -301,7 +301,7 @@ describe('loadRunStats version migration', () => {
         };
         await fs.writeFile(statsPath, JSON.stringify(v4Store), 'utf-8');
         const stats = await loadRunStats(statsPath);
-        expect(stats.getStore().version).toBe(7);
+        expect(stats.getStore().version).toBe(8);
         const rec = stats.getRecord('cron-v4');
         expect(rec).toBeDefined();
         expect(rec.cronId).toBe('cron-v4');
@@ -331,7 +331,7 @@ describe('loadRunStats version migration', () => {
         };
         await fs.writeFile(statsPath, JSON.stringify(v5Store), 'utf-8');
         const stats = await loadRunStats(statsPath);
-        expect(stats.getStore().version).toBe(7);
+        expect(stats.getStore().version).toBe(8);
         const rec = stats.getRecord('cron-v5');
         expect(rec).toBeDefined();
         expect(rec.cronId).toBe('cron-v5');
@@ -367,7 +367,7 @@ describe('loadRunStats version migration', () => {
         };
         await fs.writeFile(statsPath, JSON.stringify(v6Store), 'utf-8');
         const stats = await loadRunStats(statsPath);
-        expect(stats.getStore().version).toBe(7);
+        expect(stats.getStore().version).toBe(8);
         const rec = stats.getRecord('cron-v6');
         expect(rec).toBeDefined();
         expect(rec.cronId).toBe('cron-v6');

package/dist/discord/actions-config.js

@@ -297,7 +297,7 @@ export function configActionsPromptSection() {
 <discord-action>{"type":"modelSet","role":"fast","model":"haiku"}</discord-action>
 \`\`\`
 - \`role\` (required): One of \`chat\`, \`fast\`, \`forge-drafter\`, \`forge-auditor\`, \`summary\`, \`cron\`, \`cron-exec\`, \`voice\`.
-- \`model\` (required): Model tier (\`fast\`, \`capable\`), concrete model name (\`haiku\`, \`sonnet\`, \`opus\`), runtime name (\`openrouter\`, \`gemini\` — for \`chat\` role, swaps the active runtime adapter), or \`default\` (for cron-exec only, to revert to the env-configured default (Sonnet by default)).
+- \`model\` (required): Model tier (\`fast\`, \`capable\`, \`deep\`), concrete model name (\`haiku\`, \`sonnet\`, \`opus\`), runtime name (\`openrouter\`, \`gemini\` — for \`chat\` role, swaps the active runtime adapter), or \`default\` (for cron-exec only, to revert to the env-configured default (Sonnet by default)).
 
 **Roles:**
 | Role | What it controls |

package/dist/discord/actions-crons.js

@@ -1,3 +1,4 @@
+import { EmbedBuilder } from 'discord.js';
 import { Cron } from 'croner';
 import { CADENCE_TAGS, generateCronId } from '../cron/run-stats.js';
 import { detectCadence } from '../cron/cadence.js';
@@ -56,7 +57,10 @@ const ALL_KNOWN_ACTION_TYPES = new Set([
 // Helpers
 // ---------------------------------------------------------------------------
 function buildStarterContent(schedule, timezone, channel, prompt) {
-    return `**Schedule:** \`${schedule}\` (${timezone})\n**Channel:** #${channel}\n\n${prompt}`;
+    const truncatedPrompt = prompt.length > 200
+        ? `${prompt.slice(0, 200)}… *(full prompt pinned below)*`
+        : prompt;
+    return `**Schedule:** \`${schedule}\` (${timezone})\n**Channel:** #${channel}\n\n${truncatedPrompt}`;
 }
 function validateCronDefinition(def) {
     const timezone = String(def.timezone ?? '').trim();
@@ -211,6 +215,22 @@ export async function executeCronAction(action, ctx, cronCtx) {
                 await ensureStatusMessage(cronCtx.client, thread.id, cronId, record, cronCtx.statsStore, { log: cronCtx.log });
             }
             catch { }
+            // Post pinned prompt message (embed) so the full prompt is always retrievable.
+            try {
+                const embed = new EmbedBuilder()
+                    .setTitle('\uD83D\uDCCB Cron Prompt')
+                    .setDescription(action.prompt.slice(0, 4096))
+                    .setColor(0x5865F2);
+                const promptMsg = await thread.send({ embeds: [embed], allowedMentions: { parse: [] } });
+                try {
+                    await promptMsg.pin();
+                }
+                catch { /* non-fatal */ }
+                await cronCtx.statsStore.upsertRecord(cronId, thread.id, { promptMessageId: promptMsg.id });
+            }
+            catch (err) {
+                cronCtx.log?.warn({ err, cronId }, 'cron:action:create prompt message failed');
+            }
             cronCtx.forumCountSync?.requestUpdate();
             return { ok: true, summary: `Cron "${action.name}" created (${cronId}), schedule: ${action.schedule}, model: ${model}${action.routingMode ? `, routing: ${action.routingMode}` : ''}` };
         }
@@ -336,6 +356,50 @@ export async function executeCronAction(action, ctx, cronCtx) {
                 }
             }
             catch { }
+            // Update or create the pinned prompt message when prompt changes.
+            if (action.prompt !== undefined) {
+                try {
+                    const updatedRecord = cronCtx.statsStore.getRecord(action.cronId);
+                    const embed = new EmbedBuilder()
+                        .setTitle('\uD83D\uDCCB Cron Prompt')
+                        .setDescription(newPrompt.slice(0, 4096))
+                        .setColor(0x5865F2);
+                    if (updatedRecord?.promptMessageId) {
+                        // Try to edit the existing prompt message.
+                        const thread = cronCtx.client.channels.cache.get(record.threadId);
+                        if (thread && thread.isThread()) {
+                            try {
+                                const existing = await thread.messages.fetch(updatedRecord.promptMessageId);
+                                await existing.edit({ embeds: [embed], allowedMentions: { parse: [] } });
+                            }
+                            catch {
+                                // Message may have been deleted; create a new one.
+                                const msg = await thread.send({ embeds: [embed], allowedMentions: { parse: [] } });
+                                try {
+                                    await msg.pin();
+                                }
+                                catch { /* non-fatal */ }
+                                await cronCtx.statsStore.upsertRecord(action.cronId, record.threadId, { promptMessageId: msg.id });
+                            }
+                        }
+                    }
+                    else {
+                        // No existing prompt message — create one.
+                        const thread = cronCtx.client.channels.cache.get(record.threadId);
+                        if (thread && thread.isThread()) {
+                            const msg = await thread.send({ embeds: [embed], allowedMentions: { parse: [] } });
+                            try {
+                                await msg.pin();
+                            }
+                            catch { /* non-fatal */ }
+                            await cronCtx.statsStore.upsertRecord(action.cronId, record.threadId, { promptMessageId: msg.id });
+                        }
+                    }
+                }
+                catch (err) {
+                    cronCtx.log?.warn({ err, cronId: action.cronId }, 'cron:action:update prompt message failed');
+                }
+            }
             // Update thread tags if needed.
             if (action.tags !== undefined || action.schedule !== undefined) {
                 try {
@@ -422,10 +486,11 @@ export async function executeCronAction(action, ctx, cronCtx) {
                 lines.push(`Allowed actions: ${record.allowedActions.join(', ')}`);
             if (record.lastErrorMessage)
                 lines.push(`Last error: ${record.lastErrorMessage}`);
-            if (job) {
-                const promptText = job.def.prompt;
-                const truncated = promptText.length > 500 ? `${promptText.slice(0, 500)}... (truncated)` : promptText;
-                lines.push(`Prompt: ${truncated}`);
+            // Return full prompt text — prefer the persisted record prompt (always full),
+            // falling back to the scheduler def (also full).
+            const promptText = record.prompt ?? job?.def.prompt;
+            if (promptText) {
+                lines.push(`Prompt: ${promptText}`);
             }
             return { ok: true, summary: lines.join('\n') };
         }
@@ -580,7 +645,7 @@ export async function executeCronAction(action, ctx, cronCtx) {
                     }
                     return {
                         ok: true,
-                        summary: `Cron sync complete: ${result.tagsApplied} tags, ${result.namesUpdated} names, ${result.statusMessagesUpdated} status msgs, ${result.orphansDetected} orphans`,
+                        summary: `Cron sync complete: ${result.tagsApplied} tags, ${result.namesUpdated} names, ${result.statusMessagesUpdated} status msgs, ${result.promptMessagesCreated} prompt msgs, ${result.orphansDetected} orphans`,
                     };
                 }
                 else {
@@ -605,7 +670,7 @@ export async function executeCronAction(action, ctx, cronCtx) {
                     cronCtx.forumCountSync?.requestUpdate();
                     return {
                         ok: true,
-                        summary: `Cron sync complete: ${result.tagsApplied} tags, ${result.namesUpdated} names, ${result.statusMessagesUpdated} status msgs, ${result.orphansDetected} orphans`,
+                        summary: `Cron sync complete: ${result.tagsApplied} tags, ${result.namesUpdated} names, ${result.statusMessagesUpdated} status msgs, ${result.promptMessagesCreated} prompt msgs, ${result.orphansDetected} orphans`,
                     };
                 }
             }
@@ -655,7 +720,7 @@ export function cronActionsPromptSection() {
 - \`prompt\` (required): The instruction text.
 - \`timezone\` (optional, default: system timezone, or DEFAULT_TIMEZONE env if set): IANA timezone.
 - \`tags\` (optional): Comma-separated purpose tags.
-- \`model\` (optional): "fast" or "capable" (auto-classified if omitted).
+- \`model\` (optional): "fast", "capable", or "deep" (auto-classified if omitted).
 - \`routingMode\` (optional): Set to \`"json"\` to enable JSON routing mode. In this mode the executor uses the JSON router to dispatch structured responses. The prompt may contain \`{{channel}}\` and \`{{channelId}}\` placeholders which are expanded to the target channel name and ID at runtime.
 - \`allowedActions\` (optional): Comma-separated list of Discord action types this job may emit (e.g., "cronList,cronShow"). Restricts the AI to only these action types during execution. Rejects unrecognized type names. Requires at least one entry if provided.