@parallel-cli/parallel 0.4.9 → 0.5.0

package/dist/agents/tools.js

@@ -29,7 +29,7 @@ export const TOOL_DEFINITIONS = [
         type: 'function',
         function: {
             name: 'list_files',
-            description: 'List project files (recursive, ignores node_modules/.git/dist). Use it first to understand the structure.',
+            description: 'List project files (recursive, ignores node_modules/.git/dist). Use only when shared project context does not already identify the relevant area.',
             parameters: {
                 type: 'object',
                 properties: {
@@ -47,6 +47,8 @@ export const TOOL_DEFINITIONS = [
                 type: 'object',
                 properties: {
                     path: { type: 'string', description: 'Relative file path' },
+                    startLine: { type: 'integer', description: 'Optional first line, 1-based' },
+                    endLine: { type: 'integer', description: 'Optional last line, inclusive' },
                 },
                 required: ['path'],
             },
@@ -70,6 +72,22 @@ export const TOOL_DEFINITIONS = [
             },
         },
     },
+    {
+        type: 'function',
+        function: {
+            name: 'read_artifact',
+            description: 'Read a targeted line range from a long tool output previously stored as an artifact.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    id: { type: 'string', description: 'Artifact id returned by a previous tool result' },
+                    startLine: { type: 'integer', description: 'First line, 1-based' },
+                    lineCount: { type: 'integer', description: 'Number of lines, max 200' },
+                },
+                required: ['id'],
+            },
+        },
+    },
     {
         type: 'function',
         function: {
@@ -120,7 +138,7 @@ export const TOOL_DEFINITIONS = [
         type: 'function',
         function: {
             name: 'inspect_project',
-            description: 'Batch read-only inspection: list files under paths and/or run several regex searches in one call. Prefer this over cascades of grep/head/tail/wc/awk for exploratory checks.',
+            description: 'Batch targeted read-only inspection: list files under task-relevant paths and/or run several regex searches in one call. Prefer this over generic repository exploration or cascades of grep/head/tail/wc/awk.',
             parameters: {
                 type: 'object',
                 properties: {
@@ -185,7 +203,7 @@ export const TOOL_DEFINITIONS = [
         type: 'function',
         function: {
             name: 'update_steps',
-            description: 'Update the visible Cursor-style task checklist. At task start create 3-6 concrete steps; during work keep exactly one active step and mark completed steps done.',
+            description: 'Update the visible Cursor-style task checklist. At task start create 3-6 outcome-oriented steps; do not add a generic project-exploration step when shared context already covers it. Keep exactly one active step.',
             parameters: {
                 type: 'object',
                 properties: {
@@ -315,12 +333,15 @@ export class ToolExecutor {
     requestQuestion;
     skills;
     mode;
+    onInspect;
+    profile;
+    maxOutput;
     /** Last content this agent has seen for each file — basis of adaptive merging. */
     lastRead = new Map();
     /** Questions already asked — capped at 3 per task. */
     questionsAsked = 0;
     planApproved = false;
-    constructor(board, agentId, agentName, projectRoot, requestApproval, requestQuestion, skills, mode = 'task') {
+    constructor(board, agentId, agentName, projectRoot, requestApproval, requestQuestion, skills, mode = 'task', onInspect, profile = 'standard', maxOutput = MAX_OUTPUT) {
         this.board = board;
         this.agentId = agentId;
         this.agentName = agentName;
@@ -329,6 +350,9 @@ export class ToolExecutor {
         this.requestQuestion = requestQuestion;
         this.skills = skills;
         this.mode = mode;
+        this.onInspect = onInspect;
+        this.profile = profile;
+        this.maxOutput = maxOutput;
     }
     resolve(rel) {
         const root = path.resolve(this.projectRoot);
@@ -344,6 +368,7 @@ export class ToolExecutor {
     }
     rememberRead(relPath, content) {
         this.lastRead.set(relPath, { content, revision: this.board.fileRevision(relPath) });
+        this.onInspect?.(this.agentId, relPath, content);
     }
     adaptationMessage(relPath, seen, current, verb = 'was modified') {
         this.board.recordConflict(relPath);
@@ -421,9 +446,11 @@ export class ToolExecutor {
                 case 'list_files':
                     return this.listFiles(args?.path ?? '.');
                 case 'read_file':
-                    return this.readFile(args.path);
+                    return this.readFile(args.path, args?.startLine, args?.endLine);
                 case 'read_many':
                     return this.readMany(args.paths);
+                case 'read_artifact':
+                    return this.readArtifact(args.id, args?.startLine, args?.lineCount);
                 case 'write_file':
                     return this.writeFile(args.path, args.content);
                 case 'edit_file':
@@ -622,16 +649,18 @@ export class ToolExecutor {
             return '(empty folder)';
         return out.join('\n');
     }
-    readFile(rel) {
+    readFile(rel, requestedStart, requestedEnd) {
         const abs = this.resolve(rel);
         const relPath = this.relOf(rel);
         const content = fs.readFileSync(abs, 'utf8');
         this.rememberRead(relPath, content);
         this.board.resolveConflict(relPath);
         const lines = content.split('\n');
-        const numbered = lines.map((l, i) => `${String(i + 1).padStart(4)}|${l}`).join('\n');
-        return numbered.length > MAX_OUTPUT
-            ? numbered.slice(0, MAX_OUTPUT) + `\n... (truncated, ${lines.length} lines total)`
+        const start = Math.max(1, Math.floor(Number(requestedStart) || 1));
+        const end = Math.min(lines.length, Math.max(start, Math.floor(Number(requestedEnd) || lines.length)));
+        const numbered = lines.slice(start - 1, end).map((l, i) => `${String(start + i).padStart(4)}|${l}`).join('\n');
+        return numbered.length > this.maxOutput
+            ? numbered.slice(0, this.maxOutput) + `\n... (truncated; requested ${start}-${end}, ${lines.length} lines total)`
             : numbered;
     }
     readMany(paths) {
@@ -648,8 +677,9 @@ export class ToolExecutor {
                 this.board.resolveConflict(relPath);
                 const lines = content.split('\n');
                 const numbered = lines.map((l, i) => `${String(i + 1).padStart(4)}|${l}`).join('\n');
-                const body = numbered.length > Math.floor(MAX_OUTPUT / relPaths.length)
-                    ? numbered.slice(0, Math.floor(MAX_OUTPUT / relPaths.length)) + `\n... (truncated, ${lines.length} lines total)`
+                const perFile = Math.max(1_000, Math.floor(this.maxOutput / relPaths.length));
+                const body = numbered.length > perFile
+                    ? numbered.slice(0, perFile) + `\n... (truncated, ${lines.length} lines total)`
                     : numbered;
                 chunks.push(`--- ${relPath} (${lines.length} lines) ---\n${body}`);
             }
@@ -659,6 +689,19 @@ export class ToolExecutor {
         }
         return chunks.join('\n\n');
     }
+    readArtifact(id, requestedStart, requestedCount) {
+        const safeId = String(id ?? '');
+        if (!/^artifact-\d+\.txt$/.test(safeId))
+            return 'ERROR: invalid artifact id.';
+        const file = path.join(this.projectRoot, '.parallel', 'runs', this.agentId, 'artifacts', safeId);
+        if (!fs.existsSync(file))
+            return `ERROR: artifact not found: ${safeId}`;
+        const lines = fs.readFileSync(file, 'utf8').split('\n');
+        const start = Math.max(1, Math.floor(Number(requestedStart) || 1));
+        const count = Math.min(200, Math.max(1, Math.floor(Number(requestedCount) || 80)));
+        const end = Math.min(lines.length, start + count - 1);
+        return lines.slice(start - 1, end).map((line, index) => `${String(start + index).padStart(4)}|${line}`).join('\n');
+    }
     /**
      * Adaptive co-editing: writing is NEVER blocked by another agent.
      * But if the file changed under you since your last read, you first get
@@ -737,7 +780,8 @@ export class ToolExecutor {
         }
         const results = [];
         const walk = (dir, depth) => {
-            if (depth > 6 || results.length > 100)
+            const resultLimit = this.profile === 'quick' ? 40 : this.profile === 'standard' ? 80 : 150;
+            if (depth > 6 || results.length >= resultLimit)
                 return;
             let entries;
             try {
@@ -765,11 +809,15 @@ export class ToolExecutor {
                         continue;
                     }
                     const lines = content.split('\n');
-                    for (let i = 0; i < lines.length && results.length <= 100; i++) {
+                    let matched = false;
+                    for (let i = 0; i < lines.length && results.length < resultLimit; i++) {
                         if (re.test(lines[i])) {
+                            matched = true;
                             results.push(`${path.relative(this.projectRoot, full)}:${i + 1}: ${lines[i].trim().slice(0, 160)}`);
                         }
                     }
+                    if (matched)
+                        this.onInspect?.(this.agentId, path.relative(this.projectRoot, full), content);
                 }
             }
         };
@@ -829,12 +877,17 @@ export class ToolExecutor {
                 return;
             }
             const lines = content.split('\n');
+            let matched = false;
             for (let i = 0; i < lines.length && matches.length <= 200; i++) {
                 for (const { raw, re } of regexes) {
-                    if (re.test(lines[i]))
+                    if (re.test(lines[i])) {
+                        matched = true;
                         matches.push(`${raw} :: ${relPath}:${i + 1}: ${lines[i].trim().slice(0, 140)}`);
+                    }
                 }
             }
+            if (matched)
+                this.onInspect?.(this.agentId, relPath, content);
         };
         for (const rel of paths)
             visit(this.resolve(rel), 0);
@@ -863,11 +916,12 @@ export class ToolExecutor {
                     out += '\n(process killed: 120s timeout)';
                 else if (err)
                     out += `\n(exit code: ${err.code ?? 1})`;
-                if (out.length > MAX_OUTPUT)
-                    out = out.slice(0, MAX_OUTPUT) + '\n... (output truncated)';
                 const result = out || '(no output, success)';
                 const changed = this.recordShellMutations(before);
-                this.board.log(this.agentId, 'tool_result', result);
+                const logged = result.length > this.maxOutput
+                    ? `${result.slice(0, this.maxOutput)}\n... (${result.length.toLocaleString()} characters; full output retained as an agent artifact)`
+                    : result;
+                this.board.log(this.agentId, 'tool_result', logged);
                 resolve(changed > 0 ? `${result}\n\nTracked shell mutations: ${changed} file${changed === 1 ? '' : 's'}.` : result);
             });
         });

package/dist/commands.js

@@ -9,9 +9,9 @@ import { t } from './i18n.js';
 // inspect the session → git safety net → session & config → exit.
 export const COMMANDS = [
     // create agents
-    { name: '/ask', args: '[Name:] <question> [--model=m]', descKey: 'cmd.ask', group: 'modes', aliases: ['/a'] },
-    { name: '/task', args: '[Name:] <task> [--model=m] [#skill]', descKey: 'cmd.task', group: 'modes', aliases: ['/t'] },
-    { name: '/plan', args: '[Name:] <task> [--model=m]', descKey: 'cmd.plan', group: 'modes', aliases: ['/p'] },
+    { name: '/ask', args: '[Name:] <question> [--quick|--standard|--deep] [--model=m]', descKey: 'cmd.ask', group: 'modes', aliases: ['/a'] },
+    { name: '/task', args: '[Name:] <task> [--quick|--standard|--deep] [--model=m] [#skill]', descKey: 'cmd.task', group: 'modes', aliases: ['/t'] },
+    { name: '/plan', args: '[Name:] <task> [--quick|--standard|--deep] [--model=m]', descKey: 'cmd.plan', group: 'modes', aliases: ['/p'] },
     { name: '/review', args: '[agent|all] [prompt]', descKey: 'cmd.review', group: 'modes' },
     { name: '/issue', args: '<n>', descKey: 'cmd.issue', group: 'git' },
     { name: '/specialist', args: '<name> <task> | new <name> [global]', descKey: 'cmd.specialist', group: 'modes' },
@@ -39,6 +39,7 @@ export const COMMANDS = [
     { name: '/diff', args: '', descKey: 'cmd.diff', group: 'views' },
     { name: '/cost', args: '', descKey: 'cmd.cost', group: 'views' },
     { name: '/status', args: '', descKey: 'cmd.status', group: 'views' },
+    { name: '/memory', args: '[refresh]', descKey: 'cmd.memory', group: 'views' },
     // sessions
     { name: '/save', args: '[name]', descKey: 'cmd.save', group: 'git' },
     { name: '/sessions', args: '', descKey: 'cmd.sessions', group: 'git' },
@@ -172,6 +173,10 @@ async function doctorReport(ctl, ui) {
     }
     lines.push(commandExists('git') ? t('m.doctorGitOk') : t('m.doctorGitMissing'));
     lines.push(commandExists('gh') ? t('m.doctorGhOk') : t('m.doctorGhMissing'));
+    const memory = ctl.projectContextStatus();
+    if (['idle', 'fallback', 'error'].includes(memory.status) && level !== 'error')
+        level = 'warn';
+    lines.push(t('m.doctorMemory', { status: memory.status, date: memory.generatedAt ?? '—' }));
     ui.system(t('m.doctorReport', { lines: lines.join('\n') }), level);
 }
 /**
@@ -225,12 +230,21 @@ function spawnFrom(arg, ctl, ui, images, specialist, mode = 'task') {
     }
     // optional --model=xxx flag
     let model;
+    let profile;
     let task = arg;
     const mFlag = task.match(/\s--model=(\S+)/);
     if (mFlag) {
         model = mFlag[1];
         task = task.replace(mFlag[0], '').trim();
     }
+    for (const candidate of ['quick', 'standard', 'deep']) {
+        const flag = `--${candidate}`;
+        if (new RegExp(`(^|\\s)${flag}(?=\\s|$)`).test(task)) {
+            profile = candidate;
+            task = task.replace(new RegExp(`(^|\\s)${flag}(?=\\s|$)`), ' ').trim();
+            break;
+        }
+    }
     // optional #skill tokens → force-load these skills at the start of the task
     const forced = [];
     const available = ctl.getSkills();
@@ -249,11 +263,12 @@ function spawnFrom(arg, ctl, ui, images, specialist, mode = 'task') {
     // optional "Name:" prefix
     const named = task.match(/^([\p{L}\p{N}_-]{1,16}):\s+(.+)$/su);
     const finalTask = named ? named[2] : task;
-    const agent = ctl.spawnAgent(finalTask, named ? named[1] : undefined, model, images, specialist, undefined, mode);
+    const agent = ctl.spawnAgent(finalTask, named ? named[1] : undefined, model, images, specialist, undefined, mode, profile);
     if (!agent)
         return ui.system(specialist ? t('m.noSpecialist', { name: specialist }) : t('m.spawnFail'), 'error');
     ui.system(t('m.spawned', { name: agent.name, model: model ? ` (${model})` : '' }) +
         ` /${mode}` +
+        ` [${ctl.board.agents.get(agent.id)?.profile ?? profile ?? 'auto'}]` +
         (specialist ? ` 🎓${specialist}` : '') +
         (forced.length > 0 ? ` 🧩${forced.join(',')}` : ''), 'info');
 }
@@ -495,6 +510,34 @@ export function executeInput(raw, ctl, ui, images) {
         case '/cost':
             ui.setView('cost');
             return;
+        case '/memory': {
+            if (arg && arg !== 'refresh')
+                return ui.system(t('m.usageMemory'), 'warn');
+            if (arg === 'refresh') {
+                ui.system(t('memory.indexing'), 'info');
+                void ctl.refreshProjectContext().then(() => {
+                    const memory = ctl.projectContextStatus();
+                    ui.system(t('m.memoryStatus', {
+                        status: memory.status,
+                        date: memory.generatedAt ?? '—',
+                        model: memory.model ?? '—',
+                        tokens: memory.tokensIn + memory.tokensOut,
+                        cost: memory.cost === null ? '—' : memory.cost.toFixed(4),
+                    }), memory.status === 'ready' ? 'ok' : 'warn');
+                });
+                return;
+            }
+            const memory = ctl.projectContextStatus();
+            const index = ctl.projectIndexStatus();
+            ui.system(t('m.memoryStatus', {
+                status: memory.status,
+                date: memory.generatedAt ?? '—',
+                model: memory.model ?? '—',
+                tokens: memory.tokensIn + memory.tokensOut,
+                cost: memory.cost === null ? '—' : memory.cost.toFixed(4),
+            }) + ` · index ${index.files} files/${index.symbols} symbols`, memory.status === 'ready' ? 'ok' : memory.status === 'indexing' ? 'info' : 'warn');
+            return;
+        }
         case '/status': {
             const p = ctl.sessionProvider();
             const agents = [...ctl.board.agents.values()];
@@ -502,8 +545,22 @@ export function executeInput(raw, ctl, ui, images) {
             const cost = agents.reduce((s, a) => s + (a.cost ?? 0), 0);
             const changed = new Set(ctl.board.changes.map((c) => c.path)).size;
             const pm = p ? `${p.name}:${ctl.session.model}` : '-';
+            const memory = ctl.projectContextStatus();
+            const profiles = agents.reduce((counts, agent) => {
+                counts[agent.profile] = (counts[agent.profile] ?? 0) + 1;
+                return counts;
+            }, {});
             // Multiline: each metric on its own line for readability.
-            ui.system(t('m.status', { pm, approval: ctl.session.approvalMode, total: agents.length, active, changed, cost: cost.toFixed(3) }), 'info');
+            ui.system(t('m.status', {
+                pm,
+                approval: ctl.session.approvalMode,
+                total: agents.length,
+                active,
+                changed,
+                cost: cost.toFixed(3),
+                memory: memory.status,
+                memoryCost: memory.cost === null ? '—' : memory.cost.toFixed(4),
+            }) + `\nProfiles: ${Object.entries(profiles).map(([profile, count]) => `${profile}=${count}`).join(', ') || 'none'}`, 'info');
             return;
         }
         case '/raw':

package/dist/controller.js

@@ -5,11 +5,14 @@ import { exec, execFileSync, spawn } from 'node:child_process';
 import { Blackboard } from './coordination/blackboard.js';
 import { LLMClient } from './llm/client.js';
 import { Agent } from './agents/agent.js';
-import { configFile, saveConfig, getProvider, upsertProvider } from './config.js';
-import { priceFor, fmtCost } from './pricing.js';
+import { configFile, saveConfig, getProvider, providerReady, upsertProvider } from './config.js';
+import { priceFor, fmtCost, costOf } from './pricing.js';
 import { loadSkills, loadSpecialists } from './skills.js';
 import { t } from './i18n.js';
 import { chmodPrivateTree, ensurePrivateDir, sanitizeForPersistence, writeFileAtomicPrivate } from './security.js';
+import { ProjectContextStore, } from './project-context.js';
+import { ProjectIndex } from './project-index.js';
+import { classifyExecutionProfile, EXECUTION_BUDGETS } from './agents/execution-policy.js';
 const AGENT_COLORS = ['#f3e7c7', 'magenta', 'yellow', 'green', 'whiteBright', 'redBright', '#c8bfa6', 'magentaBright'];
 export function normalizeShellApprovalMode(mode) {
     if (mode === 'ask' || mode === 'auto-safe' || mode === 'yolo')
@@ -85,6 +88,8 @@ export class Controller extends EventEmitter {
     config;
     projectRoot;
     board;
+    projectContext;
+    projectIndex;
     agents = new Map();
     approvals = [];
     questions = [];
@@ -106,11 +111,25 @@ export class Controller extends EventEmitter {
     sessionOnlyProvider = null;
     sessionRetentionDays = 30;
     sessionRetentionMax = 30;
+    restoredSessionContext = '';
     constructor(config, projectRoot) {
         super();
         this.config = config;
         this.projectRoot = projectRoot;
         this.board = new Blackboard(projectRoot);
+        this.projectContext = new ProjectContextStore(projectRoot, (status, detail) => {
+            const text = status === 'indexing'
+                ? t('memory.indexing')
+                : status === 'ready'
+                    ? t('memory.ready')
+                    : status === 'fallback'
+                        ? t('memory.fallback', { detail: detail ?? '' })
+                        : '';
+            if (text)
+                this.board.log('', 'memory', text);
+            this.emit('update');
+        });
+        this.projectIndex = new ProjectIndex(projectRoot);
         const p = getProvider(config);
         this.session = {
             providerName: p?.name ?? '',
@@ -122,6 +141,10 @@ export class Controller extends EventEmitter {
         this.board.on('agent-event', (ev) => this.onAgentEvent(ev));
         this.board.on('note', (note) => this.nudgeFromNote(note));
         this.hardenPrivateState();
+        queueMicrotask(() => {
+            this.projectIndex.refresh();
+            void this.prewarmProjectContext();
+        });
         // Autosave: the session (+ conversations, written live by agents) survives a crash.
         const autosave = setInterval(() => this.saveSession(), 30_000);
         autosave.unref();
@@ -165,6 +188,69 @@ export class Controller extends EventEmitter {
         }
         return c;
     }
+    projectContextGenerator() {
+        const provider = this.sessionProvider();
+        const model = this.session.model || provider?.defaultModel || provider?.models[0] || '';
+        if (!provider || !model || !providerReady(provider))
+            return undefined;
+        const llm = this.llmFor(provider, model);
+        const price = priceFor(provider, model);
+        return async (messages) => {
+            const result = await llm.chat(messages);
+            return {
+                content: result.message.content ?? '',
+                tokensIn: result.tokensIn,
+                tokensOut: result.tokensOut,
+                model,
+                cost: price ? costOf(price, result.tokensIn, result.tokensOut) : null,
+            };
+        };
+    }
+    prewarmProjectContext(force = false) {
+        return this.projectContext.refresh(this.projectContextGenerator(), force);
+    }
+    refreshProjectContext() {
+        this.projectIndex.refresh();
+        return this.prewarmProjectContext(true);
+    }
+    projectContextStatus() {
+        return this.projectContext.statusSnapshot();
+    }
+    projectIndexStatus() {
+        return this.projectIndex.status();
+    }
+    async projectContextBootstrap(task = '') {
+        const agents = [...this.board.agents.values()]
+            .map((agent) => `- ${agent.name} [${agent.state}] ${agent.task}` +
+            (agent.currentAction ? ` | current: ${agent.currentAction}` : '') +
+            (agent.lastResult ? ` | result: ${agent.lastResult.slice(0, 600)}` : ''))
+            .join('\n');
+        const notes = this.board.notes
+            .slice(-20)
+            .map((note) => `- ${note.from} → ${note.to}: ${note.content.slice(0, 500)}`)
+            .join('\n');
+        const changes = this.board.changes
+            .slice(-20)
+            .map((change) => `- ${change.agentName}: ${change.path}`)
+            .join('\n');
+        const preSpawnContext = `PRE-SPAWN SESSION CONTEXT
+Agents:
+${agents || '- none'}
+Recent notes:
+${notes || '- none'}
+Changes made before this agent started:
+${changes || '- none'}`;
+        const shared = this.projectContext.snapshot();
+        const targeted = this.projectIndex.retrieve(task);
+        return [
+            shared,
+            targeted,
+            preSpawnContext,
+            this.restoredSessionContext ? `RESTORED SESSION CONTEXT\n${this.restoredSessionContext}` : '',
+        ]
+            .filter(Boolean)
+            .join('\n\n');
+    }
     // ---------- sound cues (terminal bell) ----------
     onAgentEvent(ev) {
         if (ev.type === 'conflict' && ev.path) {
@@ -207,6 +293,10 @@ export class Controller extends EventEmitter {
     nudgeFromNote(note) {
         if (note.to === 'user' || note.from === 'system')
             return;
+        // User steering is urgent. Ordinary team notes are consumed as a batch on
+        // the next natural turn so they do not discard an in-flight model call.
+        if (note.from !== 'user' && !/\b(urgent|blocker|blocked|conflict|collision)\b/i.test(note.content))
+            return;
         const recipients = note.to === 'all'
             ? [...this.board.agents.values()].filter((a) => a.name.toLowerCase() !== note.from.toLowerCase())
             : [this.board.getAgentByName(note.to)].filter((a) => Boolean(a));
@@ -335,7 +425,7 @@ export class Controller extends EventEmitter {
         return out;
     }
     /** Launch agent N+1 — works at any time, even while others are running. */
-    spawnAgent(task, name, modelSpec, images, specialistName, initialHistory, mode = 'task') {
+    spawnAgent(task, name, modelSpec, images, specialistName, initialHistory, mode = 'task', forcedProfile) {
         // Specialist persona: role appended to the system prompt, may pin a model.
         let specialist;
         if (specialistName) {
@@ -358,6 +448,8 @@ export class Controller extends EventEmitter {
         // A custom name keeps its alias, so the agent stays addressable both ways.
         const alias = `a${this.agentSeq}`;
         const agentName = name?.trim() || alias;
+        const profile = classifyExecutionProfile(task, mode, forcedProfile);
+        const budget = EXECUTION_BUDGETS[profile];
         const color = AGENT_COLORS[(this.agentSeq - 1) % AGENT_COLORS.length];
         // Conversation file (JSONL, appended live) — enables /restore after a save.
         let historyFile;
@@ -376,11 +468,13 @@ export class Controller extends EventEmitter {
             color,
             task,
             mode,
+            profile,
             model: resolved.model,
             llm: this.llmFor(resolved.provider, resolved.model),
             board: this.board,
             projectRoot: this.projectRoot,
             maxSteps: this.config.maxStepsPerAgent,
+            budget,
             requestApproval: this.requestApproval,
             requestQuestion: this.requestQuestion,
             images,
@@ -390,6 +484,27 @@ export class Controller extends EventEmitter {
             projectMemory: this.projectMemory(),
             historyFile,
             initialHistory,
+            projectContext: this.projectContextBootstrap(task),
+            onInspect: (agentId, relPath, content) => {
+                this.projectContext.recordInspection(agentId, relPath, content);
+                const current = this.board.agents.get(agentId);
+                if (current) {
+                    current.inspectedFiles = this.projectContext.inspectedFiles(agentId);
+                }
+            },
+            onComplete: (agentId, summary) => {
+                const info = this.board.agents.get(agentId);
+                if (!info)
+                    return;
+                const changedFiles = [...new Set(this.board.changes.filter((change) => change.agentId === agentId).map((change) => change.path))];
+                this.projectContext.recordOutcome(agentId, {
+                    agentName: info.name,
+                    task: info.task,
+                    result: summary,
+                    changedFiles,
+                });
+                this.projectIndex.refresh();
+            },
         });
         if (historyFile)
             this.conversationFiles.set(id, historyFile);
@@ -479,7 +594,7 @@ export class Controller extends EventEmitter {
         if (history.length === 0)
             return 'no-conversation';
         const modelSpec = sa.model ? (sa.providerName ? `${sa.providerName}:${sa.model}` : sa.model) : undefined;
-        return this.spawnAgent(sa.task, sa.name, modelSpec, undefined, sa.specialist, history, sa.mode ?? 'task');
+        return this.spawnAgent(sa.task, sa.name, modelSpec, undefined, sa.specialist, history, sa.mode ?? 'task', sa.profile);
     }
     pauseAgent(name) {
         const a = this.findAgent(name);
@@ -728,8 +843,10 @@ export class Controller extends EventEmitter {
                     alias: a.alias,
                     task: a.task,
                     mode: a.mode,
+                    profile: a.profile,
                     state: a.state,
                     lastResult: a.lastResult,
+                    startedAt: a.startedAt,
                     steps: a.steps,
                     tokensIn: a.tokensIn,
                     tokensOut: a.tokensOut,
@@ -742,6 +859,7 @@ export class Controller extends EventEmitter {
                     ctxPct: a.ctxPct,
                     progressSteps: a.progressSteps,
                     perf: a.perf,
+                    inspectedFiles: a.inspectedFiles,
                     conversation: this.conversationFiles.get(a.id),
                 })),
                 notes: this.board.notes.slice(-200),
@@ -749,6 +867,12 @@ export class Controller extends EventEmitter {
                 fileActivity: [...this.board.fileActivity.values()].slice(-100),
                 workMapWarnings: this.board.workMapWarnings.slice(-80),
                 changedFiles: [...new Set(this.board.changes.map((c) => c.path))],
+                projectContext: {
+                    schemaVersion: 1,
+                    generatedAt: this.projectContextStatus().generatedAt,
+                    fingerprint: this.projectContextStatus().fingerprint,
+                    status: this.projectContextStatus().status,
+                },
             };
             const file = path.join(dir, `session-${this.sessionStamp}.json`);
             writeFileAtomicPrivate(file, sanitizeForPersistence(JSON.stringify(data, null, 2)));
@@ -783,13 +907,17 @@ export class Controller extends EventEmitter {
         if (data.name)
             this.sessionName = data.name;
         const tasks = data.agents.map((a) => `${a.name} [${a.state}] : ${a.task}${a.lastResult ? ` → ${a.lastResult}` : ''}`);
+        this.restoredSessionContext = `Previous session saved at ${data.savedAt}.
+Past agents:
+${tasks.join('\n')}
+Files changed then: ${(data.changedFiles ?? []).join(', ') || '(none)'}`;
         this.board.hydrate({
             notes: data.notes ?? [],
             changes: data.changes ?? [],
             fileActivity: data.fileActivity ?? [],
             workMapWarnings: data.workMapWarnings ?? [],
         });
-        this.board.addNote('system', 'all', `Previous session restored (${data.savedAt}). Past work:\n${tasks.join('\n')}\nFiles changed then: ${(data.changedFiles ?? []).join(', ') || '(none)'}`);
+        this.board.addNote('system', 'all', this.restoredSessionContext);
         this.board.log('', 'system', t('m.sessionRestored', { date: new Date(data.savedAt).toLocaleString() }));
         // Financial history: per-agent cost/steps/tokens of the restored session.
         const withCost = data.agents.filter((a) => a.cost !== undefined || a.tokensIn !== undefined);
@@ -809,6 +937,7 @@ export class Controller extends EventEmitter {
         this.session.providerName = r.provider.name;
         this.session.model = r.model;
         this.emit('update');
+        void this.prewarmProjectContext();
         return { provider: r.provider.name, model: r.model };
     }
     setSessionProvider(name) {
@@ -819,6 +948,7 @@ export class Controller extends EventEmitter {
         this.session.providerName = p.name;
         this.session.model = p.defaultModel || p.models[0] || '';
         this.emit('update');
+        void this.prewarmProjectContext();
         return true;
     }
     setSessionProviderConfig(p) {
@@ -827,6 +957,7 @@ export class Controller extends EventEmitter {
         this.session.model = p.defaultModel || p.models[0] || '';
         this.llmCache.clear();
         this.emit('update');
+        void this.prewarmProjectContext();
     }
     setSessionApprovalMode(mode) {
         this.session.approvalMode = mode;