brainclaw 0.29.2 → 1.5.3

package/dist/core/context.js

@@ -1,4 +1,7 @@
+import { execSync } from 'node:child_process';
+import fs from 'node:fs';
 import path from 'node:path';
+import { readProjectVision } from './io.js';
 import { loadActiveProject } from './active-project.js';
 import { checkBrainclawInstallableUpdate, renderBrainclawInstallableUpdateNotice } from './brainclaw-version.js';
 import { loadConfig } from './config.js';
@@ -15,11 +18,14 @@ import { resolveCurrentHostId } from './host.js';
 import { inferProjectFromTarget, loadInstructions, resolveInstructions } from './instructions.js';
 import { buildCurrentAgentResumeSummary, buildReputationRankingLookup } from './reputation.js';
 import { loadState } from './state.js';
+import { readAuditLog } from './audit.js';
 import { listCandidates } from './candidates.js';
-import { listClaims, isClaimExpired } from './claims.js';
+import { listClaims, isClaimExpired, assessClaimLiveness } from './claims.js';
+import { listAssignments } from './assignments.js';
 import { listRuntimeNotes } from './runtime.js';
 import { isTrapActive, listOperationalTraps } from './traps.js';
 import { buildEstimationReport } from '../commands/estimation-report.js';
+import { detectStaleness } from './staleness.js';
 export const CONTEXT_SCHEMA_VERSION = '1.2';
 export function buildContext(options = {}) {
     const requestedCwd = options.cwd ?? process.cwd();
@@ -28,18 +34,21 @@ export function buildContext(options = {}) {
     const config = loadConfig(contextCwd);
     // Resolve parent stores for multi-store merge (walk-up from cwd)
     const storeChain = resolveStoreChain(contextCwd);
-    const profile = options.profile ?? config.profile ?? 'dev';
     const projectMode = config.project_mode ?? 'auto';
     const projectStrategy = config.projects?.strategy ?? 'manual';
     const currentHost = resolveCurrentHostId();
     const memoryVersion = getVisibleMemoryVersion({ cwd: contextCwd, hostId: options.host, allHosts: options.allHosts });
     const target = normalizeContextTarget(options.target, requestedCwd, contextCwd);
     const project = options.project?.trim() || inferProjectFromTarget(target, config);
-    const agent = options.agent?.trim() || config.current_agent?.trim();
-    const currentAgentIdentity = agent
-        ? (options.agent?.trim() ? findAgentIdentityByName(agent, contextCwd) : resolveCurrentAgentIdentity(contextCwd))
-        : undefined;
-    const profileMaxItems = { compact: 6, copilot: 5, quick: 3 };
+    // Agent resolution: explicit param > resolveCurrentAgentIdentity (env + detection).
+    // config.current_agent is NOT used — it's a singleton global that cross-contaminates in multi-agent.
+    const currentAgentIdentity = options.agent?.trim()
+        ? findAgentIdentityByName(options.agent.trim(), contextCwd)
+        : resolveCurrentAgentIdentity(contextCwd);
+    const agent = options.agent?.trim() || currentAgentIdentity?.agent_name;
+    // Profile resolution: explicit param > agent default > config default > 'dev'
+    const profile = options.profile ?? currentAgentIdentity?.context_profile ?? config.profile ?? 'dev';
+    const profileMaxItems = { dense: 20, compact: 6, copilot: 5, quick: 3, briefing: 5, 'claude-desktop': 8 };
     const maxItems = options.maxItems ?? profileMaxItems[profile] ?? 8;
     const maxChars = options.maxChars && options.maxChars > 0 ? options.maxChars : undefined;
     // Instructions will be resolved after parent-store merge below (line ~460)
@@ -48,6 +57,8 @@ export function buildContext(options = {}) {
         compact: ['plan', 'constraint'],
         copilot: ['constraint', 'trap'],
         quick: ['constraint', 'plan'],
+        briefing: ['trap', 'constraint', 'decision'],
+        'claude-desktop': ['plan', 'handoff', 'candidate'],
     };
     const allowedSections = profileSections[profile];
     const items = [];
@@ -83,6 +94,7 @@ export function buildContext(options = {}) {
             score: 0,
             reasons: [],
             extra: c.status,
+            plan_id: c.plan_id,
             provenance: {
                 actor: c.author,
                 actor_id: c.author_id,
@@ -102,6 +114,7 @@ export function buildContext(options = {}) {
             score: 0,
             reasons: [],
             extra: d.related_paths?.join(', '),
+            plan_id: d.plan_id,
             provenance: {
                 actor: d.author,
                 actor_id: d.author_id,
@@ -121,6 +134,7 @@ export function buildContext(options = {}) {
             score: 0,
             reasons: [],
             extra: `${t.severity}, visibility:${t.visibility ?? 'shared'}`,
+            plan_id: t.plan_id,
             provenance: {
                 actor: t.author,
                 actor_id: t.author_id,
@@ -344,9 +358,9 @@ export function buildContext(options = {}) {
             item.score += 5;
             item.reasons = uniqueReasons([...item.reasons, 'agent-layer: my assigned plan']);
         }
-        // Layer 2: boost items authored by me (+2)
+        // Layer 2: boost items authored by me (+0.5)
         if (item.score >= 0 && item.provenance?.actor === agentName) {
-            item.score += 2;
+            item.score += 0.5;
             item.reasons = uniqueReasons([...item.reasons, 'agent-layer: my authored item']);
         }
         // Reputation signal
@@ -381,28 +395,32 @@ export function buildContext(options = {}) {
     });
     const memoryDensity = classifyMemoryDensity(selected.length);
     const bootstrapEnabled = options.bootstrap !== false;
-    let bootstrapAvailable = hasReusableBootstrapProfile(target, contextCwd);
+    const testMode = process.env.BRAINCLAW_TEST_MODE === '1';
+    let bootstrapAvailable = false;
     let derivedSignals;
-    if (bootstrapEnabled && (options.refreshBootstrap || memoryDensity === 'low')) {
-        const bootstrap = runBootstrapProfile({
-            target,
-            refresh: options.refreshBootstrap,
-            cwd: contextCwd,
-        });
-        bootstrapAvailable = bootstrap.profile.seed_count > 0;
-        if (memoryDensity === 'low') {
+    if (!testMode) {
+        bootstrapAvailable = hasReusableBootstrapProfile(target, contextCwd);
+        if (bootstrapEnabled && (options.refreshBootstrap || memoryDensity === 'low')) {
+            const bootstrap = runBootstrapProfile({
+                target,
+                refresh: options.refreshBootstrap,
+                cwd: contextCwd,
+            });
+            bootstrapAvailable = bootstrap.profile.seed_count > 0;
+            if (memoryDensity === 'low') {
+                const signals = selectDerivedSignals(target, 5, contextCwd);
+                if (signals.length > 0) {
+                    derivedSignals = signals;
+                }
+            }
+        }
+        else if (bootstrapEnabled && bootstrapAvailable && memoryDensity === 'low') {
             const signals = selectDerivedSignals(target, 5, contextCwd);
             if (signals.length > 0) {
                 derivedSignals = signals;
             }
         }
     }
-    else if (bootstrapEnabled && bootstrapAvailable && memoryDensity === 'low') {
-        const signals = selectDerivedSignals(target, 5, contextCwd);
-        if (signals.length > 0) {
-            derivedSignals = signals;
-        }
-    }
     const executionSensitive = isExecutionSensitiveTarget(target);
     const derivedUsesExecution = derivedSignals?.some((signal) => signal.source_kind === 'machine') ?? false;
     const derivedUsesTooling = derivedSignals?.some((signal) => signal.source_kind === 'skill' || signal.source_kind === 'mcp') ?? false;
@@ -424,17 +442,44 @@ export function buildContext(options = {}) {
     // Build open_work: active claims and in_progress plans owned by the current agent
     // Reuses myClaims computed in agent-layer scoring above
     let openWork;
+    const currentSession = loadCurrentSession(contextCwd);
     if (currentAgentIdentity || agent) {
         const claimPlanIds = new Set(myClaims.map((c) => c.plan_id).filter(Boolean));
+        const activeAssignments = listAssignments(contextCwd, { agent: agentName }).filter((assignment) => !['completed', 'failed', 'expired', 'rerouted'].includes(assignment.status));
         const inProgressPlans = state.plan_items.filter((p) => p.status === 'in_progress' &&
             (p.assignee === agentName || claimPlanIds.has(p.id)));
-        if (myClaims.length > 0 || inProgressPlans.length > 0) {
+        if (myClaims.length > 0 || activeAssignments.length > 0 || inProgressPlans.length > 0) {
             openWork = {
-                active_claims: myClaims.map(({ id, scope, description, created_at, plan_id, expires_at }) => ({ id, scope, description, created_at, plan_id, expires_at })),
+                active_claims: myClaims.map((c) => ({
+                    id: c.id,
+                    scope: c.scope,
+                    description: c.description,
+                    created_at: c.created_at,
+                    plan_id: c.plan_id,
+                    expires_at: c.expires_at,
+                    liveness: assessClaimLiveness(c, { cwd: contextCwd }).status,
+                })),
+                active_assignments: activeAssignments.map(({ id, status, scope, description, plan_id, last_heartbeat_at }) => ({
+                    id,
+                    status,
+                    scope,
+                    description,
+                    plan_id,
+                    last_heartbeat_at,
+                })),
                 in_progress_plans: inProgressPlans.map(({ id, text, assignee }) => ({ id, text, assignee })),
             };
         }
     }
+    const sessionMetrics = buildSessionMetrics({
+        cwd: contextCwd,
+        sessionId: currentSession?.session_id,
+        sessionStartedAt: currentSession?.started_at,
+        agentName: agentName,
+        agentId: currentAgentIdentity?.agent_id,
+        activeClaimsCount: openWork?.active_claims.length ?? 0,
+        runtimeNotes,
+    });
     // Cross-project items (subscriber links — read-only, always injected, bypass scoring)
     const crossProjectItems = [];
     for (const link of resolveCrossProjectLinks(contextCwd)) {
@@ -442,27 +487,50 @@ export function buildContext(options = {}) {
             continue;
         try {
             const linkedState = loadCrossProjectState(link.absolutePath);
+            for (const p of linkedState.plan_items.filter((plan) => plan.status !== 'done' && plan.status !== 'dropped')) {
+                crossProjectItems.push({
+                    id: p.id, section: 'cross_project', text: `[plan] ${p.text}`,
+                    tags: p.tags, score: 0, reasons: [], from_project: link.projectName,
+                    extra: `${p.status}, ${p.priority}`,
+                });
+            }
             for (const d of linkedState.recent_decisions) {
                 crossProjectItems.push({
                     id: d.id, section: 'cross_project', text: d.text,
                     tags: d.tags, score: 0, reasons: [], from_project: link.projectName,
+                    plan_id: d.plan_id,
                 });
             }
             for (const c of linkedState.active_constraints) {
                 crossProjectItems.push({
                     id: c.id, section: 'cross_project', text: c.text,
                     tags: c.tags, score: 0, reasons: [], from_project: link.projectName,
+                    plan_id: c.plan_id,
                 });
             }
             for (const t of linkedState.known_traps.filter((trap) => isTrapActive(trap))) {
                 crossProjectItems.push({
                     id: t.id, section: 'cross_project', text: t.text,
                     tags: t.tags, score: 0, reasons: [], from_project: link.projectName,
+                    plan_id: t.plan_id,
                 });
             }
         }
         catch { /* skip unavailable linked project */ }
     }
+    // Staleness detection: non-blocking, capped at 5 warnings to keep context lean.
+    // Phase 4 Sprint 1 Lane A step 3 (pln#390): runtime_note staleness now
+    // flows through the same surface.
+    let staleWarnings;
+    try {
+        const pendingCandidatesForStaleness = listCandidates('pending', contextCwd);
+        const runtimeNotesForStaleness = listRuntimeNotes(undefined, contextCwd);
+        const staleReport = detectStaleness(state.plan_items, state.known_traps, state.open_handoffs, pendingCandidatesForStaleness, Date.now(), runtimeNotesForStaleness);
+        if (staleReport.warnings.length > 0) {
+            staleWarnings = staleReport.warnings.slice(0, 5);
+        }
+    }
+    catch { /* non-fatal */ }
     const result = {
         context_schema: CONTEXT_SCHEMA_VERSION,
         profile,
@@ -471,6 +539,7 @@ export function buildContext(options = {}) {
         project_mode: projectMode,
         project_strategy: projectStrategy,
         current_host: currentHost,
+        project_vision: readProjectVision(contextCwd),
         host_filter: options.host,
         all_hosts: options.allHosts ?? false,
         memory_version: memoryVersion,
@@ -493,6 +562,7 @@ export function buildContext(options = {}) {
         resolved_instructions: resolvedInstructions,
         resume_summary: resumeSummary,
         open_work: openWork,
+        session_metrics: sessionMetrics,
         stores: storeChain.length > 1
             ? storeChain.map(({ cwd, depth, role }) => ({ cwd, depth, role }))
             : undefined,
@@ -509,6 +579,7 @@ export function buildContext(options = {}) {
         cross_project_items: crossProjectItems.length > 0 ? crossProjectItems : undefined,
         claim_conflicts: detectClaimConflicts(myClaims, otherActiveClaims),
         workflow_hints: buildWorkflowHints(myClaims, openWork, state.plan_items),
+        stale_warnings: staleWarnings,
         selected,
     };
     if (options.digest) {
@@ -520,7 +591,7 @@ export function renderContextMarkdown(result, explain = false) {
     const lines = [];
     lines.push(`# Agent Context (${result.profile})`);
     lines.push('');
-    if (result.open_work && (result.open_work.active_claims.length > 0 || result.open_work.in_progress_plans.length > 0)) {
+    if (result.open_work && (result.open_work.active_claims.length > 0 || result.open_work.active_assignments.length > 0 || result.open_work.in_progress_plans.length > 0)) {
         lines.push('## ⚠ Your open work');
         lines.push('');
         if (result.open_work.active_claims.length > 0) {
@@ -530,10 +601,22 @@ export function renderContextMarkdown(result, explain = false) {
                 const planRef = claim.plan_id ? ` [plan: ${claim.plan_id}]` : '';
                 const expired = claim.expires_at && claim.expires_at < now ? ' ⚠ EXPIRED — run brainclaw prune' : '';
                 const ttlInfo = claim.expires_at && !expired ? ` (expires ${claim.expires_at.slice(0, 16).replace('T', ' ')})` : '';
-                lines.push(`- [${claim.id}] ${claim.description}${planRef}${ttlInfo}${expired}`);
+                const livenessTag = claim.liveness && claim.liveness !== 'live' && claim.liveness !== 'young'
+                    ? ` [${claim.liveness.toUpperCase()}]`
+                    : '';
+                lines.push(`- [${claim.id}] ${claim.description}${planRef}${ttlInfo}${livenessTag}${expired}`);
                 lines.push(`  scope: ${claim.scope}`);
             }
         }
+        if (result.open_work.active_assignments.length > 0) {
+            lines.push('Active assignments (runtime state):');
+            for (const assignment of result.open_work.active_assignments) {
+                const planRef = assignment.plan_id ? ` [plan: ${assignment.plan_id}]` : '';
+                const heartbeat = assignment.last_heartbeat_at ? ` [heartbeat: ${assignment.last_heartbeat_at.slice(0, 16).replace('T', ' ')}]` : '';
+                lines.push(`- [${assignment.id}] ${assignment.description}${planRef} (${assignment.status})${heartbeat}`);
+                lines.push(`  scope: ${assignment.scope}`);
+            }
+        }
         if (result.open_work.in_progress_plans.length > 0) {
             lines.push('In-progress plan items (update status when done):');
             for (const plan of result.open_work.in_progress_plans) {
@@ -542,6 +625,17 @@ export function renderContextMarkdown(result, explain = false) {
         }
         lines.push('');
     }
+    if (result.session_metrics) {
+        lines.push('## Session metrics');
+        lines.push('');
+        lines.push(`- Active claims: ${result.session_metrics.active_claims}`);
+        lines.push(`- Edits since last Brainclaw write: ${result.session_metrics.edits_since_last_memory}`);
+        lines.push(`- Session duration: ${result.session_metrics.session_duration_minutes} min`);
+        if (result.session_metrics.last_brainclaw_write) {
+            lines.push(`- Last Brainclaw write: ${result.session_metrics.last_brainclaw_write}`);
+        }
+        lines.push('');
+    }
     if (result.estimation_calibration) {
         lines.push(`Estimation calibration: ${result.estimation_calibration}`);
         lines.push('');
@@ -553,6 +647,9 @@ export function renderContextMarkdown(result, explain = false) {
     if (result.agent_id && result.agent) {
         lines.push(`Agent ID: ${result.agent_id}`);
     }
+    if (result.project_vision) {
+        lines.push(`Project vision: ${result.project_vision.split('\n')[0]}`);
+    }
     lines.push(`Project mode: ${result.project_mode} (${result.project_strategy})`);
     if (result.active_project) {
         const ap = result.active_project;
@@ -701,8 +798,9 @@ export function renderContextMarkdown(result, explain = false) {
     for (const item of result.selected) {
         const tags = item.tags.length ? ` [${item.tags.join(', ')}]` : '';
         const extra = item.extra ? ` (${item.extra})` : '';
+        const planRef = item.plan_id ? ` [plan: ${item.plan_id}]` : '';
         const why = explain && item.reasons.length ? ` {why: ${item.reasons.join(', ')}}` : '';
-        lines.push(`- [${item.id}] <${item.section}> ${item.text}${extra}${tags}${why}`);
+        lines.push(`- [${item.id}] <${item.section}> ${item.text}${extra}${planRef}${tags}${why}`);
     }
     if (result.derived_signals && result.derived_signals.length > 0) {
         lines.push('');
@@ -770,6 +868,12 @@ export function renderContextPromptTemplate(result, compact = false) {
             lines.push(`sd=${result.context_diff.since_session ?? ''}`);
             lines.push(`dc=${result.context_diff.counts.total}`);
         }
+        if (result.stale_warnings && result.stale_warnings.length > 0) {
+            lines.push(`sw=${result.stale_warnings.length}`);
+            for (const w of result.stale_warnings) {
+                lines.push(`  - en=${w.entity} id=${w.id} ag=${w.age_days} tx="${w.reason}"`);
+            }
+        }
         if (result.resume_summary) {
             lines.push(`rt=${result.resume_summary.internal_trust}`);
             lines.push('rs:');
@@ -798,6 +902,9 @@ export function renderContextPromptTemplate(result, compact = false) {
         }
         lines.push(`project_mode: ${result.project_mode}`);
         lines.push(`project_strategy: ${result.project_strategy}`);
+        if (result.project_vision) {
+            lines.push(`project_vision: "${result.project_vision.split('\n')[0]}"`);
+        }
         if (result.active_project) {
             lines.push(`active_project: ${result.active_project.name ?? result.active_project.path}`);
             lines.push(`active_project_switched: ${result.active_project.switched_at}`);
@@ -883,22 +990,42 @@ export function renderContextPromptTemplate(result, compact = false) {
                 lines.push(`    - ${item}`);
             }
         }
+        if (result.stale_warnings && result.stale_warnings.length > 0) {
+            lines.push('stale_warnings:');
+            for (const w of result.stale_warnings) {
+                lines.push(`  - entity=${w.entity} id=${w.id} age_days=${w.age_days} reason="${w.reason}" action="${w.suggested_action}"`);
+            }
+        }
         if (result.target) {
             lines.push(`target: ${result.target}`);
         }
     }
-    if (result.open_work && (result.open_work.active_claims.length > 0 || result.open_work.in_progress_plans.length > 0)) {
+    if (result.open_work && (result.open_work.active_claims.length > 0 || result.open_work.active_assignments.length > 0 || result.open_work.in_progress_plans.length > 0)) {
         lines.push(compact ? 'ow:' : 'open_work:');
         if (result.open_work.active_claims.length > 0) {
             lines.push(compact ? '  claims:' : '  active_claims:');
             for (const claim of result.open_work.active_claims) {
+                const lv = claim.liveness ? (compact ? ` lv=${claim.liveness}` : ` liveness=${claim.liveness}`) : '';
                 if (compact) {
                     const planRef = claim.plan_id ? ` pl=${claim.plan_id}` : '';
-                    lines.push(`    - id=${claim.id}${planRef} sc="${claim.scope}" tx="${claim.description}"`);
+                    lines.push(`    - id=${claim.id}${planRef} sc="${claim.scope}" tx="${claim.description}"${lv}`);
                 }
                 else {
                     const planRef = claim.plan_id ? ` plan_id=${claim.plan_id}` : '';
-                    lines.push(`    - id=${claim.id}${planRef} scope="${claim.scope}" description="${claim.description}"`);
+                    lines.push(`    - id=${claim.id}${planRef} scope="${claim.scope}" description="${claim.description}"${lv}`);
+                }
+            }
+        }
+        if (result.open_work.active_assignments.length > 0) {
+            lines.push(compact ? '  assignments:' : '  active_assignments:');
+            for (const assignment of result.open_work.active_assignments) {
+                if (compact) {
+                    const planRef = assignment.plan_id ? ` pl=${assignment.plan_id}` : '';
+                    lines.push(`    - id=${assignment.id}${planRef} st=${assignment.status} sc="${assignment.scope}" tx="${assignment.description}"`);
+                }
+                else {
+                    const planRef = assignment.plan_id ? ` plan_id=${assignment.plan_id}` : '';
+                    lines.push(`    - id=${assignment.id}${planRef} status=${assignment.status} scope="${assignment.scope}" description="${assignment.description}"`);
                 }
             }
         }
@@ -914,6 +1041,25 @@ export function renderContextPromptTemplate(result, compact = false) {
             }
         }
     }
+    if (result.session_metrics) {
+        lines.push(compact ? 'sm:' : 'session_metrics:');
+        if (compact) {
+            lines.push(`  ac=${result.session_metrics.active_claims}`);
+            lines.push(`  ed=${result.session_metrics.edits_since_last_memory}`);
+            lines.push(`  dur=${result.session_metrics.session_duration_minutes}`);
+            if (result.session_metrics.last_brainclaw_write) {
+                lines.push(`  lbw=${result.session_metrics.last_brainclaw_write}`);
+            }
+        }
+        else {
+            lines.push(`  active_claims: ${result.session_metrics.active_claims}`);
+            lines.push(`  edits_since_last_memory: ${result.session_metrics.edits_since_last_memory}`);
+            lines.push(`  session_duration_minutes: ${result.session_metrics.session_duration_minutes}`);
+            if (result.session_metrics.last_brainclaw_write) {
+                lines.push(`  last_brainclaw_write: ${result.session_metrics.last_brainclaw_write}`);
+            }
+        }
+    }
     lines.push(compact ? 'ins:' : 'instructions:');
     if (result.resolved_instructions.length === 0) {
         lines.push(compact ? '  - n' : '  - none');
@@ -941,14 +1087,16 @@ export function renderContextPromptTemplate(result, compact = false) {
             if (compact) {
                 const tags = item.tags.length ? ` tg=[${item.tags.join(',')}]` : '';
                 const extra = item.extra ? ` ex="${item.extra}"` : '';
+                const planRef = item.plan_id ? ` pl=${item.plan_id}` : '';
                 const why = item.reasons.length ? ` why=[${item.reasons.join('|')}]` : '';
-                lines.push(`  - id=${item.id} tp=${item.section}${tags}${extra}${why} tx="${item.text}"`);
+                lines.push(`  - id=${item.id} tp=${item.section}${tags}${extra}${planRef}${why} tx="${item.text}"`);
             }
             else {
                 const tags = item.tags.length ? ` tags=[${item.tags.join(',')}]` : '';
                 const extra = item.extra ? ` extra="${item.extra}"` : '';
+                const planRef = item.plan_id ? ` plan=${item.plan_id}` : '';
                 const why = item.reasons.length ? ` why=[${item.reasons.join(', ')}]` : '';
-                lines.push(`  - id=${item.id} type=${item.section}${tags}${extra}${why} text="${item.text}"`);
+                lines.push(`  - id=${item.id} type=${item.section}${tags}${extra}${planRef}${why} text="${item.text}"`);
             }
         }
     }
@@ -979,6 +1127,119 @@ export function renderContextPromptTemplate(result, compact = false) {
     lines.push('```');
     return lines.join('\n');
 }
+/**
+ * Render context as an ultra-compact scope briefing (< 500 chars).
+ * Designed for pre-action injection: only what matters for THIS scope, NOW.
+ *
+ * Output example:
+ *   scope: src/core/agent-files.ts
+ *   traps: [high] MCP server hérite env vars VS Code
+ *   claims: no conflict
+ *   decisions: brainclawMcpEntry preserves existing command
+ *   confidence: high (3 items, freshest 2d ago)
+ */
+export function renderContextBriefing(result) {
+    const lines = [];
+    if (result.target) {
+        lines.push(`scope: ${result.target}`);
+    }
+    // Traps (high severity first, max 2)
+    const traps = result.selected
+        .filter(i => i.section === 'trap')
+        .slice(0, 2);
+    if (traps.length > 0) {
+        for (const t of traps) {
+            const severity = t.extra?.match(/\b(high|medium|low)\b/)?.[0] ?? '';
+            const text = t.text.length > 80 ? t.text.slice(0, 77) + '...' : t.text;
+            lines.push(`trap: [${severity}] ${text}`);
+        }
+    }
+    // Claim conflicts
+    if (result.claim_conflicts && result.claim_conflicts.length > 0) {
+        for (const c of result.claim_conflicts.slice(0, 2)) {
+            lines.push(`conflict: ${c.other_agent} claims ${c.other_scope}`);
+        }
+    }
+    else {
+        lines.push('claims: no conflict');
+    }
+    // Recent decisions (max 1, truncated)
+    const decisions = result.selected
+        .filter(i => i.section === 'decision')
+        .slice(0, 1);
+    if (decisions.length > 0) {
+        const text = decisions[0].text.length > 80 ? decisions[0].text.slice(0, 77) + '...' : decisions[0].text;
+        lines.push(`decision: ${text}`);
+    }
+    // Confidence score based on item count and scope activity
+    const totalItems = result.selected.length;
+    const hasActivity = result.scoped_activity != null;
+    let confidence = 'low';
+    if (totalItems >= 3 && hasActivity) {
+        confidence = 'high';
+    }
+    else if (totalItems >= 1) {
+        confidence = 'medium';
+    }
+    lines.push(`confidence: ${confidence} (${totalItems} items${hasActivity ? ', scope has recent activity' : ''})`);
+    // Sequence position placeholder (populated when Sequences land)
+    // lines.push(`sequence: ...`);
+    return lines.join('\n');
+}
+/**
+ * Render context for Claude Desktop: surface tasks, inbox items, and active plans.
+ * Excludes traps, constraints, and decisions — Claude Desktop sessions are task-oriented.
+ * Target output: < 1500 chars, actionable items only.
+ */
+export function renderContextClaudeDesktop(result) {
+    const lines = [];
+    lines.push('# Brainclaw — Claude Desktop Session');
+    lines.push('');
+    // Active plans (task queue)
+    const plans = result.selected.filter(i => i.section === 'plan');
+    if (plans.length > 0) {
+        lines.push('## Tasks');
+        for (const p of plans.slice(0, 5)) {
+            const status = p.extra?.match(/\b(todo|in_progress|blocked)\b/)?.[0] ?? 'todo';
+            const text = p.text.length > 100 ? p.text.slice(0, 97) + '...' : p.text;
+            lines.push(`- [${status}] ${text} (${p.id})`);
+        }
+        lines.push('');
+    }
+    // Open handoffs (pending work from other agents)
+    const handoffs = result.selected.filter(i => i.section === 'handoff');
+    if (handoffs.length > 0) {
+        lines.push('## Inbox');
+        for (const h of handoffs.slice(0, 3)) {
+            const from = h.provenance?.actor ?? 'unknown';
+            const text = h.text.length > 100 ? h.text.slice(0, 97) + '...' : h.text;
+            lines.push(`- from:${from} — ${text}`);
+        }
+        lines.push('');
+    }
+    // Candidates (review items)
+    const candidates = result.selected.filter(i => i.section === 'candidate');
+    if (candidates.length > 0) {
+        lines.push('## Review');
+        for (const c of candidates.slice(0, 3)) {
+            const text = c.text.length > 100 ? c.text.slice(0, 97) + '...' : c.text;
+            lines.push(`- ${text} (${c.id})`);
+        }
+        lines.push('');
+    }
+    if (plans.length === 0 && handoffs.length === 0 && candidates.length === 0) {
+        lines.push('No pending tasks. Use `bclaw_quick_capture` to queue work for Claude Desktop.');
+    }
+    // Claim conflicts (always show if present)
+    if (result.claim_conflicts && result.claim_conflicts.length > 0) {
+        lines.push('## Conflicts');
+        for (const c of result.claim_conflicts.slice(0, 2)) {
+            lines.push(`- ${c.other_agent} claims ${c.other_scope}`);
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
 export function buildScopedActivity(input) {
     const target = input.target?.trim();
     if (!target) {
@@ -1077,6 +1338,85 @@ function classifyMemoryDensity(selectedCount) {
         return 'medium';
     return 'high';
 }
+const BRAINCLAW_WRITE_ACTIONS = ['create', 'update', 'delete', 'accept', 'reject', 'trust_change', 'promote_direct', 'rollback'];
+function buildSessionMetrics(input) {
+    if (!input.sessionId || !input.sessionStartedAt || !input.agentName) {
+        return undefined;
+    }
+    const sessionId = input.sessionId;
+    const startedAtMs = Date.parse(input.sessionStartedAt);
+    if (!Number.isFinite(startedAtMs)) {
+        return undefined;
+    }
+    const runtimeWrites = input.runtimeNotes
+        .filter((note) => note.agent === input.agentName
+        && note.session_id === sessionId
+        && ((note.note_type ?? 'observation') === 'observation'))
+        .map((note) => note.created_at);
+    const auditWrites = readAuditLog({ since: input.sessionStartedAt, actor: input.agentId ?? input.agentName }, input.cwd)
+        .filter((entry) => belongsToSession(entry, sessionId))
+        .filter((entry) => BRAINCLAW_WRITE_ACTIONS.includes(entry.action))
+        .map((entry) => entry.timestamp);
+    const lastBrainclawWrite = [...runtimeWrites, ...auditWrites].sort().at(-1);
+    const editsSinceLastMemory = countChangedFilesSince(input.cwd, lastBrainclawWrite ?? input.sessionStartedAt);
+    return {
+        active_claims: input.activeClaimsCount,
+        edits_since_last_memory: editsSinceLastMemory,
+        session_duration_minutes: Math.max(0, Math.floor((Date.now() - startedAtMs) / 60_000)),
+        last_brainclaw_write: lastBrainclawWrite,
+    };
+}
+function belongsToSession(entry, sessionId) {
+    return !entry.session_id || entry.session_id === sessionId;
+}
+function countChangedFilesSince(cwd, since) {
+    const sinceMs = Date.parse(since);
+    if (!Number.isFinite(sinceMs)) {
+        return 0;
+    }
+    try {
+        const output = execSync('git status --porcelain --untracked-files=normal', {
+            cwd,
+            encoding: 'utf-8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+        }).trim();
+        if (!output) {
+            return 0;
+        }
+        const changedPaths = new Set();
+        for (const line of output.split(/\r?\n/)) {
+            const rawPath = line.slice(3).trim();
+            const resolvedPath = rawPath.includes(' -> ') ? rawPath.split(' -> ').pop() ?? rawPath : rawPath;
+            if (resolvedPath && shouldCountEditedPath(resolvedPath)) {
+                changedPaths.add(resolvedPath);
+            }
+        }
+        let count = 0;
+        for (const relativePath of changedPaths) {
+            const absolutePath = path.join(cwd, relativePath);
+            try {
+                if (!fs.existsSync(absolutePath)) {
+                    count++;
+                    continue;
+                }
+                if (fs.statSync(absolutePath).mtimeMs >= sinceMs) {
+                    count++;
+                }
+            }
+            catch {
+                count++;
+            }
+        }
+        return count;
+    }
+    catch {
+        return 0;
+    }
+}
+function shouldCountEditedPath(relativePath) {
+    const normalized = relativePath.replace(/\\/g, '/');
+    return !normalized.startsWith('.brainclaw/') && !normalized.startsWith('.git/');
+}
 function summariseAgentTooling(snapshot) {
     return {
         agents_md_present: snapshot.agents_md_present,
@@ -1226,6 +1566,13 @@ function computeRelevance(item, terms, profile, target) {
         score += 1;
         reasons.push('runtime execution signal');
     }
+    if (profile === 'dense') {
+        // Dense profile: boost all actionable sections equally for maximum coverage
+        if (item.section === 'decision' || item.section === 'trap' || item.section === 'candidate' || item.section === 'runtime') {
+            score += 2;
+            reasons.push('profile boost: dense');
+        }
+    }
     if (profile === 'dev' && (item.section === 'decision' || item.section === 'trap')) {
         score += 2;
         reasons.push('profile boost: dev');