@theihtisham/agent-shadow-brain 7.1.3 → 7.1.4

package/dist/dashboard/v6-dashboard-html.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"v6-dashboard-html.d.ts","sourceRoot":"","sources":["../../src/dashboard/v6-dashboard-html.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,iBAAiB,sirTAqtItB,CAAC"}
+{"version":3,"file":"v6-dashboard-html.d.ts","sourceRoot":"","sources":["../../src/dashboard/v6-dashboard-html.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,iBAAiB,6trTAqtItB,CAAC"}

package/dist/dashboard/v6-dashboard-html.js

@@ -1129,9 +1129,9 @@ export const V6_DASHBOARD_HTML = `<!DOCTYPE html>
         <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><polyline points="22 12 18 12 15 21 9 3 6 12 2 12"/></svg>
         Activity
       </button>
-      <button class="nav-item" data-tab="agents" data-title="Connected Tools" title="See which AI coding tools (Claude, Cursor, Codex…) are connected to your brain.">
+      <button class="nav-item" data-tab="agents" data-title="Client setup" title="Inspect coding-client configuration and recorded tool identities.">
         <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M17 21v-2a4 4 0 0 0-4-4H5a4 4 0 0 0-4 4v2"/><circle cx="9" cy="7" r="4"/><path d="M23 21v-2a4 4 0 0 0-3-3.87"/><path d="M16 3.13a4 4 0 0 1 0 7.75"/></svg>
-        Connected Tools<span class="badge-count" id="badge-agents">0</span>
+        Client setup<span class="badge-count" id="badge-agents">0</span>
       </button>
       <button class="nav-item" data-tab="livebrain" data-title="Brain Health" title="A health check of your brain's memory quality, with tips to improve it.">
         <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M22 12h-4l-3 9L9 3l-3 9H2"/></svg>
@@ -1149,9 +1149,9 @@ export const V6_DASHBOARD_HTML = `<!DOCTYPE html>
         <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M4 19V5"/><path d="M4 6h9l1 2h6v8h-9l-1-2H4"/></svg>
         Project Memory<span class="badge-count" id="badge-ww2br">0</span>
       </button>
-      <button class="nav-item" data-tab="graph" data-title="Live Network" title="A live animation of your tools talking to the brain.">
+      <button class="nav-item" data-tab="graph" data-title="Recorded network" title="Configured clients and newly observed recorded events.">
         <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="3"/><circle cx="12" cy="12" r="8"/></svg>
-        Live Network
+        Recorded network
       </button>
       <button class="nav-item" data-tab="seeder" data-title="Add Knowledge" title="Research a topic and save it as verified, source-backed knowledge.">
         <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M12 2v20"/><path d="M5 9c0-3 2-5 7-7 5 2 7 4 7 7 0 5-4 8-7 8s-7-3-7-8z"/><path d="M8 12h8"/></svg>
@@ -1279,7 +1279,7 @@ export const V6_DASHBOARD_HTML = `<!DOCTYPE html>
 
       <div class="grid cols-4">
         <div class="card stat-card accent">
-          <div class="label">Tools Connected</div>
+          <div class="label">Recorded tools</div>
           <div class="value accent" id="ov-agents">—</div>
           <div class="trend">AI tools linked to your brain</div>
         </div>
@@ -1941,7 +1941,7 @@ export const V6_DASHBOARD_HTML = `<!DOCTYPE html>
       </div>
       <div class="grid cols-2 mt">
         <div class="card stat-card"><div class="label">Monthly Projection</div><div class="value" id="tok-proj">$—</div><div class="trend">from last 7 days</div></div>
-        <div class="card stat-card"><div class="label">Savings Available</div><div class="value" style="color:var(--success)" id="tok-save">$—</div><div class="trend up">via smart routing</div></div>
+        <div class="card stat-card"><div class="label">Estimated opportunity</div><div class="value" style="color:var(--success)" id="tok-save">$—</div><div class="trend up">manual ledger · pricing estimates</div></div>
       </div>
       <div class="warning-banner mt" id="tok-runtime-note"><strong>Accuracy</strong><span>Token records are historical. Current agent and model spend are shown separately.</span></div>
       <div class="grid cols-2 mt-lg">
@@ -2213,10 +2213,10 @@ const FEATURES = [
   ['memory','Memories','Browse and search saved knowledge'],
   ['chat','Ask the Brain','Ask questions in plain language'],
   ['activity','Activity','Live feed of what the brain is doing'],
-  ['agents','Connected Tools','Which AI tools are linked to the brain'],
+  ['agents','Client setup','Client configuration and recorded tools'],
   ['livebrain','Brain Health','Memory quality with tips to improve'],
   ['ww2br','Project Memory','Memory and status for one project'],
-  ['graph','Live Network','Live animation of tools talking to the brain'],
+  ['graph','Recorded network','Configured clients and newly observed recorded events'],
   ['seeder','Add Knowledge','Research a topic and save it as verified knowledge'],
   ['garden','Memory Garden','Watch your memories grow over time'],
   ['sabb','Sub-Agents','Share the right context with helper agents'],
@@ -2412,10 +2412,10 @@ async function refresh() {
   state.hive = hive;
   state.lastRefreshAt = Date.now();
 
-  animateNum('stat-agents', hive.totalAgentsConnected ?? 0);
+  animateNum('stat-agents', hive.totalRecordedAgents ?? hive.totalAgentsConnected ?? 0);
   animateNum('stat-memories', hive.totalMemoriesStored ?? 0);
   animateNum('stat-dreams', hive.modules.dream?.totalDreams ?? 0);
-  animateNum('stat-tools', hive.totalAgentsConnected ?? 0);
+  animateNum('stat-tools', hive.totalRecordedAgents ?? hive.totalAgentsConnected ?? 0);
   document.getElementById('badge-sabb').textContent = hive.modules.sabb?.totalSpawns ?? 0;
   document.getElementById('badge-causal').textContent = hive.modules.causal?.totalLinks ?? 0;
   document.getElementById('badge-collision').textContent = hive.modules.collision?.collisionsDetected ?? 0;
@@ -2428,7 +2428,7 @@ async function refresh() {
 async function refreshOverview() {
   const hive = state.hive || await api('/api/v6/hive-status');
   if (!hive) return;
-  animateNum('ov-agents', hive.totalAgentsConnected ?? 0);
+  animateNum('ov-agents', hive.totalRecordedAgents ?? hive.totalAgentsConnected ?? 0);
   animateNum('ov-memories', hive.totalMemoriesStored ?? 0);
   animateNum('ov-subagents', hive.modules.sabb?.totalSpawns ?? 0);
   document.getElementById('ov-subagents-sub').textContent = \`grad: \${hive.modules.sabb?.graduated ?? 0} · quar: \${hive.modules.sabb?.quarantined ?? 0}\`;
@@ -2455,7 +2455,7 @@ async function refreshOverview() {
     ['Air-gap', hive.modules.airGap?.enabled ? 'ENABLED' : 'disabled', hive.modules.airGap?.enabled ? 'good' : ''],
     ['Version', hive.version, ''],
     ['Monthly cost', '$' + (hive.modules.tokenEconomy?.monthlyProjectionUsd?.toFixed?.(2) ?? '0.00'), 'warn'],
-    ['Cost saved/mo', '$' + (hive.modules.tokenEconomy?.savingsOpportunitiesUsd?.toFixed?.(2) ?? '0.00'), 'good'],
+    ['Estimated savings opportunity', '$' + (hive.modules.tokenEconomy?.savingsOpportunitiesUsd?.toFixed?.(2) ?? '0.00'), 'good'],
   ];
   document.getElementById('ov-health').innerHTML = health.map(([k, v, cls]) => \`<div class="row"><span class="k">\${k}</span><span class="v \${cls}">\${v}</span></div>\`).join('');
 
@@ -3298,7 +3298,7 @@ async function refreshConfig() {
   document.getElementById('config-state').innerHTML = \`
     <div class="row"><span class="k">Version</span><span class="v">\${hive.version}</span></div>
     <div class="row"><span class="k">Local-first</span><span class="v \${hive.localFirst ? 'good' : 'warn'}">\${hive.localFirst ? 'YES' : 'no'}</span></div>
-    <div class="row"><span class="k">Agents connected</span><span class="v">\${hive.totalAgentsConnected}</span></div>
+    <div class="row"><span class="k">Recorded tools</span><span class="v">\${hive.totalAgentsConnected}</span></div>
     <div class="row"><span class="k">Memories stored</span><span class="v">\${hive.totalMemoriesStored}</span></div>
     <div class="row"><span class="k">Modules active</span><span class="v good">\${Object.keys(hive.modules || {}).length}</span></div>\`;
 }
@@ -3614,14 +3614,7 @@ function ingestActivity(raw, fresh) {
   if (!activityPaused) {
     appendLog(e.source, e.type, e.detail);
     if (fresh) {
-      try {
-        if (typeof graphTimer !== 'undefined' && graphTimer) {
-          const col = signalColors[e.type] || '#18ffff';
-          const srcExists = graphNodes.find(n => n.id === e.source);
-          graphSignals.push({ fromId: srcExists ? e.source : 'brain', toId: 'brain', type: e.type, color: col, progress: 0, spawnedAt: Date.now() });
-          if (graphSignals.length > 100) graphSignals = graphSignals.slice(-100);
-        }
-      } catch (err) {}
+      // Graph animation consumes the deduplicated stored-event stream in pullTopology.
       lastIngestFresh = true;
     }
   }
@@ -3707,6 +3700,7 @@ async function refreshActivity() {
 }
 
 // ──── Live Graph ───────────────────────────────────────────────────────
+let graphObservedEvents = new Set(), graphObserved = false;
 let graphFrame = 0, graphNodes = [], graphEdges = [], graphSignals = [], graphTimer = null, graphPullTimer = null;
 const signalColors = { 'memory-write':'#10e68c','subagent-spawn':'#18ffff','dream':'#a855f7','revisit':'#a855f7','counterfactual':'#a855f7','consolidation':'#a855f7','contradiction':'#ff5864','pattern-discovery':'#10e68c','collision':'#ff5864','quarantine':'#ec4899','firewall-block':'#ffb53f' };
 async function startGraph() { await pullTopology(); if (graphTimer) cancelAnimationFrame(graphTimer); graphLoop(); if (graphPullTimer) clearInterval(graphPullTimer); graphPullTimer = setInterval(pullTopology, 3000); }
@@ -3718,10 +3712,10 @@ async function pullTopology() {
   const W = canvas.width, H = canvas.height, cx = W/2, cy = H/2;
   const prev = new Map(graphNodes.map(n => [n.id, { x: n.x, y: n.y }]));
   graphNodes = [{ id:'brain', label:'HIVE MIND', x: cx, y: cy, r: 50, type:'brain', color:'#a855f7' }];
-  (topo.agents || []).forEach((a, i, arr) => {
+  (topo.agents || []).filter(a => a.configurationDetected).forEach((a, i, arr) => {
     const ang = (i / arr.length) * Math.PI * 2 - Math.PI / 2, r = 240;
     const p = prev.get(a.id);
-    graphNodes.push({ id: a.id, label: a.displayName, x: p?.x ?? cx + Math.cos(ang) * r, y: p?.y ?? cy + Math.sin(ang) * r, targetX: cx + Math.cos(ang) * r, targetY: cy + Math.sin(ang) * r, r: a.connected ? 24 : 16, type:'agent', connected: a.connected, color: a.connected ? '#18ffff' : '#556080' });
+    graphNodes.push({ id: a.id, label: a.displayName, x: p?.x ?? cx + Math.cos(ang) * r, y: p?.y ?? cy + Math.sin(ang) * r, targetX: cx + Math.cos(ang) * r, targetY: cy + Math.sin(ang) * r, r: 20, type:'agent', connected: false, color: '#8695aa' });
   });
   (topo.subAgents || []).forEach((s, i, arr) => {
     const parent = graphNodes.find(n => n.id === s.parent), ang = (i / Math.max(arr.length,1)) * Math.PI * 2, r = 130;
@@ -3730,19 +3724,25 @@ async function pullTopology() {
   });
   graphEdges = [];
   for (const n of graphNodes) {
-    if (n.type === 'agent') graphEdges.push({ from:'brain', to: n.id, active: n.connected });
-    if (n.type === 'subagent') graphEdges.push({ from: n.parent ?? 'brain', to: n.id, active: true });
+    if (n.type === 'agent') graphEdges.push({ from:'brain', to: n.id, active: false });
+    if (n.type === 'subagent') graphEdges.push({ from: n.parent ?? 'brain', to: n.id, active: false });
   }
   const now = Date.now();
   for (const e of (topo.events || [])) {
+    const eventKey = e.id || JSON.stringify([e.type,e.source,e.target,e.timestamp]);
+    if (graphObservedEvents.has(eventKey)) continue;
+    graphObservedEvents.add(eventKey);
+    if (!graphObserved) continue;
     const src = e.source ?? 'brain';
-    const srcN = graphNodes.find(n => n.id === src) ?? graphNodes[0];
+    const srcN = graphNodes.find(n => n.id === src);
     const dstN = e.type === 'subagent-spawn' ? graphNodes.find(n => n.id === e.target) : graphNodes.find(n => n.id === 'brain');
     if (!srcN || !dstN) continue;
     graphSignals.push({ fromId: srcN.id, toId: dstN.id, type: e.type, color: signalColors[e.type] || '#18ffff', progress: 0, spawnedAt: now });
   }
+  graphObserved = true;
+  if (graphObservedEvents.size > 500) graphObservedEvents = new Set([...graphObservedEvents].slice(-500));
   if (graphSignals.length > 100) graphSignals = graphSignals.slice(-100);
-  document.getElementById('graph-meta').textContent = \`\${(topo.agents || []).length} agents · \${(topo.subAgents || []).length} sub-agents · \${graphSignals.length} signals\`;
+  document.getElementById('graph-meta').textContent = \`\${(topo.agents || []).filter(a => a.configurationDetected).length} configured/detected clients · \${(topo.subAgents || []).length} recorded sub-agents · \${graphSignals.length} new event signals\`;
 }
 function graphLoop() {
   const c = document.getElementById('graph-canvas');

package/dist/dashboard/workspace-api.d.ts

@@ -3,6 +3,8 @@ import { type GlobalBrain } from '../brain/global-brain.js';
 import { type FeatureSettingsStore } from '../brain/feature-settings.js';
 import { type MemoryAnnotationsStore } from '../brain/memory-annotations.js';
 import { type ActivityJournal } from '../brain/activity-journal.js';
+import { WorkspaceRuntime } from './workspace-status.js';
+import type { ProjectHubService } from '../brain/project-hub.js';
 export interface WorkspaceDependencies {
     brain?: GlobalBrain;
     settings?: FeatureSettingsStore;
@@ -10,6 +12,10 @@ export interface WorkspaceDependencies {
     projectDir?: string;
     journal?: ActivityJournal;
     demo?: boolean;
+    localProject?: boolean;
+    runtime?: WorkspaceRuntime;
+    hub?: ProjectHubService;
+    prepareStorage?: () => Promise<string | null>;
 }
 /** The workspace API reads only the memory store and dedicated feature settings. */
 export declare function handleWorkspaceRequest(req: IncomingMessage, res: ServerResponse, dependencies?: WorkspaceDependencies): Promise<void>;

package/dist/dashboard/workspace-api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workspace-api.d.ts","sourceRoot":"","sources":["../../src/dashboard/workspace-api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACjE,OAAO,EAAkB,KAAK,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAG5E,OAAO,EAA2C,KAAK,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAClH,OAAO,EAAqC,KAAK,sBAAsB,EAAiC,MAAM,gCAAgC,CAAC;AAG/I,OAAO,EAAsB,KAAK,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAOxF,MAAM,WAAW,qBAAqB;IACpC,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC,WAAW,CAAC,EAAE,sBAAsB,CAAC;IACrC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAsED,oFAAoF;AACpF,wBAAsB,sBAAsB,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,EAAE,YAAY,GAAE,qBAA0B,GAAG,OAAO,CAAC,IAAI,CAAC,CAqM/I"}
+{"version":3,"file":"workspace-api.d.ts","sourceRoot":"","sources":["../../src/dashboard/workspace-api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEjE,OAAO,EAAkB,KAAK,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAK5E,OAAO,EAA2C,KAAK,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAClH,OAAO,EAAqC,KAAK,sBAAsB,EAAiC,MAAM,gCAAgC,CAAC;AAG/I,OAAO,EAAsB,KAAK,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAMxF,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAKjE,MAAM,WAAW,qBAAqB;IACpC,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC,WAAW,CAAC,EAAE,sBAAsB,CAAC;IACrC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B,GAAG,CAAC,EAAE,iBAAiB,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAC/C;AAwED,oFAAoF;AACpF,wBAAsB,sBAAsB,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,EAAE,YAAY,GAAE,qBAA0B,GAAG,OAAO,CAAC,IAAI,CAAC,CA4R/I"}

package/dist/dashboard/workspace-api.js

@@ -1,13 +1,22 @@
+import { randomUUID } from 'node:crypto';
 import { getGlobalBrain } from '../brain/global-brain.js';
 import { getBrainBus } from '../brain/brain-bus.js';
 import { assembleContext } from '../brain/context-assembly.js';
+import { parseContextRequest } from '../brain/context-request.js';
+import { inspectMemoryHealth } from '../brain/memory-inspection.js';
 import { FEATURE_DEFINITIONS, getFeatureSettings } from '../brain/feature-settings.js';
 import { memoryAnnotationsFor, memoryState } from '../brain/memory-annotations.js';
 import { normalizeMemorySources } from '../brain/memory-sources.js';
 import { inspectClientIntegrations } from '../brain/client-integrations.js';
 import { activityJournalFor } from '../brain/activity-journal.js';
 import { reportAgentActivity } from '../brain/activity-reporting.js';
+import { inspectProject, planProjectSkill, applyProjectSkill } from '../brain/project-kit.js';
+import { requireProjectStore, addProjectKnowledge } from '../brain/project-memory.js';
+import { ProjectFeedbackStore } from '../brain/project-feedback.js';
+import { WorkspaceRuntime } from './workspace-status.js';
+import { isProjectHubRoute, handleProjectHubRequest } from './project-hub-api.js';
 const INVENTORY_LIMIT = 2500;
+const sharedRuntime = new WorkspaceRuntime('shared');
 function sources(entry) {
     return normalizeMemorySources(entry.metadata, { limit: 8, maxChars: 500 });
 }
@@ -89,10 +98,105 @@ export async function handleWorkspaceRequest(req, res, dependencies = {}) {
         const url = new URL(req.url ?? '/', 'http://localhost');
         const route = url.pathname.slice('/api/workspace/'.length);
         const method = req.method ?? 'GET';
+        const expectedProject = req.headers['x-shadow-brain-project'];
+        if (method === 'POST' && expectedProject !== undefined && expectedProject !== dependencies.runtime?.project?.id) {
+            return send({ error: 'This port now serves a different project. Reload the portal before making changes.', code: 'WORKSPACE_PROJECT_CHANGED' }, 409);
+        }
+        const storageError = await dependencies.prepareStorage?.();
+        if (route === 'status' && method === 'GET')
+            return send((dependencies.runtime ?? sharedRuntime).status(dependencies.brain, !!dependencies.hub && !storageError, storageError));
+        if (storageError)
+            return send({ error: storageError, code: 'WORKSPACE_STORAGE_UNAVAILABLE' }, 503);
+        if (isProjectHubRoute(url.pathname)) {
+            const settings = dependencies.settings ?? getFeatureSettings();
+            const journal = dependencies.journal;
+            const correlationId = randomUUID();
+            const projectId = dependencies.runtime?.project?.id;
+            const tool = 'hub-' + (url.pathname.split('/')[4] || 'overview');
+            const record = async (kind) => {
+                if (method !== 'POST' || !journal || !settings.get().features.activityRecording)
+                    return;
+                await journal.append({ kind, source: 'reported', transport: 'host', projectId, agent: 'portal', tool, correlationId,
+                    ...(kind === 'tool-end' ? { outcome: res.statusCode < 400 ? 'success' : 'error' } : {}) }).catch(() => { });
+            };
+            await record('tool-start');
+            try {
+                await handleProjectHubRequest(req, res, dependencies.hub, url);
+            }
+            finally {
+                await record('tool-end');
+            }
+            return;
+        }
+        const local = dependencies.localProject && dependencies.projectDir && dependencies.brain
+            ? requireProjectStore(dependencies.projectDir, dependencies.brain) : undefined;
+        const projectRoutes = ['project-profile', 'project-knowledge', 'project-skill-preview', 'project-skill-apply', 'project-feedback'];
         const writes = ['memory-review', 'memory-link', 'memory-unlink'];
-        if (!['GET', 'POST'].includes(method) || (method === 'POST' && !['context', 'features', 'activity-report', ...writes].includes(route)))
+        if (!['GET', 'POST'].includes(method) || (method === 'POST' && !['context', 'context-compare', 'features', 'activity-report', ...writes, ...projectRoutes.slice(1)].includes(route)))
             return send({ error: 'Method not allowed.' }, 405);
         const settings = dependencies.settings ?? getFeatureSettings();
+        const localActivity = () => {
+            const enabled = settings.get().features.liveActivity;
+            if (!local)
+                return activity(enabled);
+            const journal = dependencies.journal ?? activityJournalFor(dependencies.brain);
+            return { enabled, activity: enabled ? journal.read({ projectId: local.projectId, limit: 200 }).events.slice(-30).reverse().map(event => ({
+                    id: event.id, type: event.kind, label: [event.tool, event.phase, event.outcome].filter(Boolean).join(' · ') || event.kind,
+                    agent: event.agent ?? '', project: local.projectName, timestamp: event.timestamp,
+                })) : [] };
+        };
+        if (projectRoutes.includes(route)) {
+            if (!local)
+                return send({ error: 'Open shadow-brain project workspace for project-local knowledge and skills.' }, 409);
+            if (route === 'project-profile')
+                return send(inspectProject(local.root));
+            if (route === 'project-feedback') {
+                const feedback = new ProjectFeedbackStore(local.root, dependencies.brain);
+                if (method === 'GET')
+                    return send(feedback.get());
+                const input = await body(req);
+                const { expectedRevision, kind, ...params } = input;
+                await dependencies.brain.init();
+                dependencies.brain.refresh();
+                if (dependencies.brain.getStorageHealth().lastError)
+                    throw new Error('Project memory could not be read; feedback was not changed.');
+                const command = { kind: kind === 'record' ? 'upsert' : kind === 'enable' ? 'toggle' : kind, ...params };
+                return send(await feedback.update(command, expectedRevision, 'user'));
+            }
+            if (method !== 'POST')
+                return send({ error: 'Use POST for project knowledge and skill requests.' }, 405);
+            const input = await body(req);
+            if (route === 'project-skill-preview')
+                return send(planProjectSkill(local.root, input));
+            const started = Date.now();
+            const correlationId = randomUUID();
+            const recordOperation = async (outcome) => {
+                if (!settings.get().features.activityRecording)
+                    return;
+                try {
+                    await (dependencies.journal ?? activityJournalFor(dependencies.brain)).append({ projectId: local.projectId,
+                        kind: outcome ? 'tool-end' : 'tool-start', source: 'reported', transport: 'host', agent: 'user', sessionId: 'project-portal',
+                        tool: route, correlationId, ...(outcome ? { outcome, durationMs: Math.max(0, Date.now() - started) } : {}) });
+                }
+                catch { /* The committed result remains valid when optional activity recording is unavailable. */ }
+            };
+            await recordOperation();
+            let result;
+            try {
+                if (route === 'project-knowledge')
+                    result = await addProjectKnowledge(local.root, dependencies.brain, input);
+                else {
+                    const { expectedPlanHash, ...params } = input;
+                    result = await applyProjectSkill(local.root, params, expectedPlanHash);
+                }
+            }
+            catch (error) {
+                await recordOperation('error');
+                throw error;
+            }
+            await recordOperation('success');
+            return send(result);
+        }
         if (route === 'features') {
             if (method === 'POST') {
                 const input = await body(req);
@@ -105,7 +209,7 @@ export async function handleWorkspaceRequest(req, res, dependencies = {}) {
             return send(settingsResponse(settings));
         }
         if (route === 'activity')
-            return send(activity(settings.get().features.liveActivity));
+            return send(localActivity());
         if (route === 'telemetry') {
             const flags = settings.get().features;
             const common = { checkedAt: new Date().toISOString(), liveEnabled: flags.liveActivity, recordingEnabled: flags.activityRecording, demo: dependencies.demo === true };
@@ -116,23 +220,29 @@ export async function handleWorkspaceRequest(req, res, dependencies = {}) {
             const cursor = qs.get('cursor');
             const journal = dependencies.journal ?? activityJournalFor(dependencies.brain ?? getGlobalBrain());
             const page = journal.read({ afterSequence: cursor === null ? undefined : bounded(cursor, 0, Number.MAX_SAFE_INTEGER, 0),
-                journalId: query(qs, 'journalId'), projectId: query(qs, 'project'), limit: bounded(qs.get('limit'), 200, 200) });
+                journalId: query(qs, 'journalId'), projectId: local?.projectId ?? query(qs, 'project'), limit: bounded(qs.get('limit'), 200, 200) });
             return send({ ...common, ...page, cursor: page.nextAfterSequence });
         }
         if (route === 'activity-report') {
             if (method !== 'POST')
                 return send({ error: 'Use POST to report activity.' }, 405);
             const input = await body(req);
+            if (local && input.projectId !== undefined && input.projectId !== local.projectId)
+                throw new TypeError('This portal is pinned to its local project.');
+            if (local)
+                input.projectId = local.projectId;
             return send(await reportAgentActivity(dependencies.brain ?? getGlobalBrain(), settings, input, dependencies.journal));
         }
-        if (!['overview', 'memories', 'graph', 'context', 'memory', 'integrations', ...writes].includes(route))
+        if (!['overview', 'memories', 'graph', 'context', 'context-compare', 'memory', 'memory-health', 'integrations', ...writes].includes(route))
             return send({ error: 'Not found.' }, 404);
-        if (route === 'context' && method !== 'POST')
+        if (['context', 'context-compare'].includes(route) && method !== 'POST')
             return send({ error: 'Use POST for context assembly.' }, 405);
         if (writes.includes(route) && method !== 'POST')
             return send({ error: 'Use POST for memory changes.' }, 405);
         const mutationInput = writes.includes(route) ? await body(req) : undefined;
         if (mutationInput) {
+            if (local && mutationInput.projectId !== local.projectId)
+                throw new TypeError('This portal is pinned to its local project.');
             if (!Number.isSafeInteger(mutationInput.expectedRevision) || Number(mutationInput.expectedRevision) < 0)
                 throw new TypeError('A current expectedRevision is required.');
             const allowed = route === 'memory-review' ? ['projectId', 'memoryId', 'state', 'note', 'expectedRevision'] :
@@ -142,41 +252,42 @@ export async function handleWorkspaceRequest(req, res, dependencies = {}) {
         }
         const brain = dependencies.brain ?? getGlobalBrain();
         if (route === 'integrations')
-            return send(inspectClientIntegrations({ projectDir: dependencies.projectDir, brain }));
+            return send(inspectClientIntegrations({ projectDir: dependencies.projectDir, brain, localProjectId: local?.projectId }));
         const annotationStore = dependencies.annotations ?? memoryAnnotationsFor(brain);
         const refresh = async () => {
             await brain.init();
-            if (writes.includes(route))
-                brain.refresh();
-            else
-                await brain.sync();
+            brain.refresh();
             if (brain.getStorageHealth().lastError)
                 throw new Error('The memory store could not be read. Check storage health.');
         };
-        if (route === 'context') {
+        if (route === 'context' || route === 'context-compare') {
             const input = await body(req);
-            if (Object.keys(input).some(key => !['projectId', 'query', 'tokenBudget', 'includeCrossProject'].includes(key)))
-                throw new TypeError('Unknown context request field.');
-            if (typeof input.projectId !== 'string' || !input.projectId.trim())
-                throw new TypeError('Choose a project.');
-            if (input.query !== undefined && typeof input.query !== 'string')
-                throw new TypeError('Task must be text.');
-            if (input.includeCrossProject !== undefined && typeof input.includeCrossProject !== 'boolean')
-                throw new TypeError('Cross-project choice must be boolean.');
-            if (input.tokenBudget !== undefined && (!Number.isSafeInteger(input.tokenBudget) || Number(input.tokenBudget) < 0 || Number(input.tokenBudget) > 12000))
-                throw new TypeError('Token budget must be an integer from 0 to 12000.');
+            const options = parseContextRequest(input);
+            if (local && (options.projectId !== local.projectId || options.includeCrossProject === true))
+                throw new TypeError('This portal is pinned to its local project.');
             const flags = settings.get().features;
             if (flags.contextAssembly)
                 await refresh();
-            const pack = assembleContext(brain, { projectId: input.projectId, query: input.query,
-                tokenBudget: input.tokenBudget, includeCrossProject: input.includeCrossProject,
-                features: flags, annotations: flags.contextAssembly ? annotationStore.get() : undefined });
-            return send(pack);
+            const common = { ...options, features: flags, annotations: flags.contextAssembly ? annotationStore.get() : undefined,
+                feedback: flags.contextAssembly && local ? new ProjectFeedbackStore(local.root, brain).get() : undefined };
+            if (route === 'context')
+                return send(assembleContext(brain, common));
+            const legacy = assembleContext(brain, { ...common, profile: 'legacy' });
+            const adaptive = assembleContext(brain, { ...common, profile: 'adaptive' });
+            const oldIds = new Set(legacy.entries.map(entry => entry.id));
+            const newIds = new Set(adaptive.entries.map(entry => entry.id));
+            return send({ legacy, adaptive, delta: { addedIds: [...newIds].filter(id => !oldIds.has(id)),
+                    removedIds: [...oldIds].filter(id => !newIds.has(id)), sharedIds: [...newIds].filter(id => oldIds.has(id)) },
+                warnings: ['Both profiles use the same memory view. Their token estimators differ; selection changes are not proof of higher accuracy.'] });
         }
         await refresh();
         const annotations = annotationStore.get();
         const qs = url.searchParams;
-        const requestedProject = query(qs, 'project');
+        const requestedProject = local?.projectId ?? query(qs, 'project');
+        if (local && query(qs, 'project') && query(qs, 'project') !== local.projectId)
+            throw new TypeError('This portal is pinned to its local project.');
+        if (route === 'memory-health')
+            return send(inspectMemoryHealth(brain, annotations, { projectId: requestedProject, limit: bounded(qs.get('limit'), 30, 100) }));
         if (route === 'memory') {
             const id = query(qs, 'id');
             if (!id || !requestedProject)
@@ -218,16 +329,23 @@ export async function handleWorkspaceRequest(req, res, dependencies = {}) {
             const committed = await annotationStore.update(command, input.expectedRevision);
             return send({ revision: committed.revision, updatedAt: committed.updatedAt });
         }
-        const inventory = brain.timeline({ limit: INVENTORY_LIMIT });
+        const recentInventory = brain.timeline({ limit: INVENTORY_LIMIT, ...(local ? { projectId: local.projectId } : {}) });
+        const inventory = requestedProject ? brain.timeline({ projectId: requestedProject, limit: INVENTORY_LIMIT }) : recentInventory;
         const projectMap = new Map();
-        for (const entry of inventory) {
+        if (local)
+            projectMap.set(local.projectId, { id: local.projectId, name: local.projectName, memories: 0, updatedAt: null });
+        for (const entry of recentInventory) {
             const project = projectMap.get(entry.projectId) ?? { id: entry.projectId, name: entry.projectName || entry.projectId, memories: 0, updatedAt: date(entry.createdAt) };
             project.memories++;
             projectMap.set(entry.projectId, project);
         }
+        if (requestedProject && inventory.length)
+            projectMap.set(requestedProject, {
+                id: requestedProject, name: inventory[0].projectName || requestedProject, memories: inventory.length, updatedAt: date(inventory[0].createdAt),
+            });
         const projects = [...projectMap.values()].sort((a, b) => a.name.localeCompare(b.name));
         const facets = { projects, categories: [...new Set(inventory.map(entry => entry.category))].sort(), agents: [...new Set(inventory.map(entry => entry.agentTool))].sort() };
-        const inventoryTruncated = brain.getStats().totalEntries > inventory.length;
+        const inventoryTruncated = requestedProject ? brain.timeline({ projectId: requestedProject, limit: INVENTORY_LIMIT + 1 }).length > INVENTORY_LIMIT : brain.getStats().totalEntries > inventory.length;
         if (route === 'overview') {
             const scoped = inventory.filter(entry => !requestedProject || entry.projectId === requestedProject);
             const quality = { total: scoped.length, sourceBacked: 0, active: 0, contested: 0, archived: 0, superseded: 0, reviewed: 0 };
@@ -238,13 +356,15 @@ export async function handleWorkspaceRequest(req, res, dependencies = {}) {
                 if (annotations.reviews[entry.id]?.projectId === entry.projectId)
                     quality.reviewed++;
             }
-            return send({ version: '7.1.3', totals: { projects: projects.length, memories: brain.getStats().totalEntries, agents: facets.agents.length },
-                projects, ...activity(settings.get().features.liveActivity), storageHealth: brain.getStorageHealth(),
+            return send({ version: '7.1.4', demo: dependencies.demo === true,
+                projectKit: local ? { available: true, projectId: local.projectId, projectName: local.projectName, root: local.root, storagePath: local.storagePath } : { available: false },
+                totals: { projects: projects.length, memories: local ? inventory.length : brain.getStats().totalEntries, agents: facets.agents.length },
+                projects, ...localActivity(), storageHealth: brain.getStorageHealth(),
                 features: settings.get().features, recentMemories: scoped.slice(0, 5).map(entry => summary(entry, annotations)), truncated: inventoryTruncated,
                 quality, scope: { projectId: requestedProject ?? null, basis: 'recent-inventory' },
                 inventoryLimit: INVENTORY_LIMIT });
         }
-        const projectId = query(qs, 'project');
+        const projectId = requestedProject;
         const category = query(qs, 'category');
         const agentTool = query(qs, 'agent');
         const search = query(qs, 'q');
@@ -288,7 +408,7 @@ export async function handleWorkspaceRequest(req, res, dependencies = {}) {
             }
             const detail = summary(entry, annotations);
             nodes.push({ id: memoryNode, kind: 'memory', label: detail.title, project: entry.projectId, category: entry.category,
-                memoryId: entry.id, effectiveState: detail.effectiveState, snippet: detail.snippet, source: detail.source, agent: entry.agentTool, updatedAt: detail.updatedAt });
+                memoryId: entry.id, effectiveState: detail.effectiveState, snippet: detail.snippet, source: detail.source, sources: detail.sources, agent: entry.agentTool, updatedAt: detail.updatedAt });
             edges.push({ source: projectNode, target: memoryNode, kind: 'belongs-to' }, { source: agentNode, target: memoryNode, kind: 'recorded-by' });
         }
         const shownById = new Map(shown.map(entry => [entry.id, entry.projectId]));
@@ -301,7 +421,7 @@ export async function handleWorkspaceRequest(req, res, dependencies = {}) {
     }
     catch (error) {
         const code = error.code;
-        send({ error: error instanceof Error ? error.message : String(error), ...(code ? { code } : {}) }, code === 'FEATURE_SETTINGS_CONFLICT' || code === 'ANNOTATIONS_CONFLICT' ? 409 : code === 'ANNOTATIONS_NOT_FOUND' ? 404 :
+        send({ error: error instanceof Error ? error.message : String(error), ...(code ? { code } : {}) }, code === 'FEATURE_SETTINGS_CONFLICT' || code === 'ANNOTATIONS_CONFLICT' || code?.includes('CONFLICT') || code?.includes('STALE') ? 409 : code === 'ANNOTATIONS_NOT_FOUND' ? 404 :
             code === 'FEATURE_SETTINGS_INVALID_PATCH' || code === 'ANNOTATIONS_INVALID_COMMAND' || code === 'ACTIVITY_JOURNAL_INVALID_EVENT' ||
                 code === 'ACTIVITY_JOURNAL_INVALID_CURSOR' || error instanceof TypeError || error instanceof RangeError ? 400 : 500);
     }