@cluesmith/codev 3.0.3 → 3.0.6

package/dist/agent-farm/servers/tower-messages.js

@@ -9,6 +9,24 @@
 import path from 'node:path';
 import { parseAddress, stripLeadingZeros } from '../utils/agent-names.js';
 import { getWorkspaceTerminals } from './tower-terminals.js';
+import { lookupBuilderSpawningArchitect } from '../state.js';
+import { DEFAULT_ARCHITECT_NAME } from '../utils/architect-name.js';
+// ============================================================================
+// Spec 755 error messages — exported as constants so producer and asserter
+// share a single source of truth. Tests assert these texts verbatim; changing
+// the wording without updating both sides will break the build.
+// ============================================================================
+export function legacyBuilderErrorMessage(builderId, registered) {
+    const names = registered.length ? registered.join(', ') : '<none>';
+    return `legacy builder ${builderId} has no spawning-architect identity and no 'main' architect is registered (registered: ${names})`;
+}
+export function architectGoneErrorMessage(builderId, missingArchitect, registered) {
+    const names = registered.length ? registered.join(', ') : '<none>';
+    return `builder ${builderId} was spawned by architect ${missingArchitect}, which is no longer registered, and no 'main' architect is registered (registered: ${names})`;
+}
+export function addressSpoofingErrorMessage(builderId) {
+    return `builder ${builderId} may only address its own spawning architect`;
+}
 /** Active WebSocket subscribers for the message bus. */
 const messageSubscribers = new Set();
 /**
@@ -50,11 +68,17 @@ export function getSubscriberCount() {
  *    - Exact match (case-insensitive) first, then tail match
  *    - Multiple tail matches → AMBIGUOUS error
  *
+ * Spec 755: when `sender` is supplied and refers to a builder, sender-affinity
+ * routing applies to `architect` and `architect:<name>` targets. Non-builder
+ * senders see the legacy main-first behavior, unchanged.
+ *
  * @param target - Address string: "agent" or "project:agent"
  * @param fallbackWorkspace - Workspace path when no project: prefix is given
+ * @param sender - Optional sender identity (a builder ID or 'architect').
+ *                 Enables affinity-aware architect routing per Spec 755.
  * @returns ResolveResult on success, ResolveError on failure
  */
-export function resolveTarget(target, fallbackWorkspace) {
+export function resolveTarget(target, fallbackWorkspace, sender) {
     const { project, agent } = parseAddress(target);
     // Validate: empty or whitespace-only agent is a malformed address
     if (!agent || !agent.trim()) {
@@ -63,6 +87,20 @@ export function resolveTarget(target, fallbackWorkspace) {
             message: 'Malformed address: agent name is empty.',
         };
     }
+    // Spec 755: `architect:<name>` is a per-architect address WITHIN the
+    // current workspace, not a `project:agent` cross-workspace address.
+    // parseAddress can't distinguish them (the grammar is overloaded), so we
+    // intercept here. The resolver below applies the spoofing check when
+    // sender is a builder.
+    if (project && project.toLowerCase() === 'architect') {
+        if (!fallbackWorkspace) {
+            return {
+                code: 'NO_CONTEXT',
+                message: 'Cannot resolve architect:<name> address without workspace context.',
+            };
+        }
+        return resolveArchitectByName(agent, fallbackWorkspace, sender);
+    }
     // Determine the workspace path
     let workspacePath;
     if (project) {
@@ -81,7 +119,43 @@ export function resolveTarget(target, fallbackWorkspace) {
         workspacePath = fallbackWorkspace;
     }
     // Resolve agent within the workspace
-    return resolveAgentInWorkspace(agent, workspacePath);
+    return resolveAgentInWorkspace(agent, workspacePath, sender);
+}
+/**
+ * Resolve `architect:<name>` to a terminal ID within the given workspace.
+ *
+ * Spec 755 enforcement when sender is a builder:
+ *   - If the builder's `spawned_by_architect` matches `<name>`: allowed.
+ *   - If it doesn't match: rejected with the spoofing error.
+ * Non-builder senders may address any architect by name.
+ */
+function resolveArchitectByName(name, workspacePath, sender) {
+    const allWorkspaces = getWorkspaceTerminals();
+    const entry = allWorkspaces.get(workspacePath);
+    if (!entry) {
+        return {
+            code: 'NOT_FOUND',
+            message: `Workspace '${workspacePath}' has no registered terminals.`,
+        };
+    }
+    // Spoofing check: builder senders can only address their own architect.
+    if (sender) {
+        const spawningArchitect = lookupBuilderSpawningArchitect(sender, workspacePath);
+        if (spawningArchitect !== undefined && spawningArchitect !== name) {
+            return {
+                code: 'NOT_FOUND',
+                message: addressSpoofingErrorMessage(sender),
+            };
+        }
+    }
+    const terminalId = entry.architects.get(name);
+    if (!terminalId) {
+        return {
+            code: 'NOT_FOUND',
+            message: `Architect '${name}' not found in workspace '${path.basename(workspacePath)}'.`,
+        };
+    }
+    return { terminalId, workspacePath, agent: name };
 }
 /**
  * Find a workspace path by matching the basename of registered workspace paths.
@@ -111,9 +185,23 @@ function findWorkspaceByBasename(projectName) {
 /**
  * Resolve an agent name to a terminal ID within a specific workspace.
  *
- * Checks architect first, then builders by exact match, then builders by tail match.
+ * Checks architect first (with Spec 755 affinity-aware routing when `sender`
+ * is a builder), then builders by exact match, then builders by tail match.
+ *
+ * Spec 755 architect resolution:
+ *   - Fast path: single-architect workspace with name 'main' — return that
+ *     terminal directly. Identical to today's behavior; avoids the state.db
+ *     read entirely for the common case.
+ *   - Builder sender, target 'architect': look up the builder's
+ *     spawnedByArchitect. If that architect is registered, route there.
+ *     Otherwise fall back to 'main', else error with the spec-mandated
+ *     legacy-builder / architect-gone messages.
+ *   - Builder sender, target 'architect:<name>': allowed only if <name>
+ *     matches the sender's spawnedByArchitect. Otherwise rejected (spoofing).
+ *   - Non-builder sender (or no sender), target 'architect': route to 'main'
+ *     (or first registered if 'main' is absent). Unchanged from today.
  */
-function resolveAgentInWorkspace(agent, workspacePath) {
+function resolveAgentInWorkspace(agent, workspacePath, sender) {
     const allWorkspaces = getWorkspaceTerminals();
     const entry = allWorkspaces.get(workspacePath);
     if (!entry) {
@@ -122,16 +210,58 @@ function resolveAgentInWorkspace(agent, workspacePath) {
             message: `Workspace '${workspacePath}' has no registered terminals.`,
         };
     }
-    // Check architect
+    // Check architect (Spec 755 affinity-aware path).
     if (agent === 'architect' || agent === 'arch') {
-        if (!entry.architect) {
+        if (entry.architects.size === 0) {
             return {
                 code: 'NOT_FOUND',
                 message: `No architect terminal found in workspace '${path.basename(workspacePath)}'.`,
             };
         }
-        return { terminalId: entry.architect, workspacePath, agent: 'architect' };
+        // Single-architect fast path: most workspaces have only 'main'.
+        // Identical answer to the full resolution path, but skips the state.db
+        // read entirely. Guarantees latency parity for solo-architect users.
+        if (entry.architects.size === 1 && entry.architects.has(DEFAULT_ARCHITECT_NAME)) {
+            const terminalId = entry.architects.get(DEFAULT_ARCHITECT_NAME);
+            return { terminalId, workspacePath, agent: 'architect' };
+        }
+        // Builder-context detection via state.db row presence. Three-valued
+        // result distinguishes "builder with explicit name" / "legacy builder"
+        // / "not a builder" — see lookupBuilderSpawningArchitect.
+        const spawningArchitect = sender ? lookupBuilderSpawningArchitect(sender, workspacePath) : undefined;
+        if (spawningArchitect !== undefined && sender) {
+            // Sender is a builder.
+            if (spawningArchitect === null) {
+                // Legacy builder: row exists, spawnedByArchitect is null. Route to
+                // 'main' if present; else fail with the spec's verbatim message.
+                const main = entry.architects.get(DEFAULT_ARCHITECT_NAME);
+                if (main)
+                    return { terminalId: main, workspacePath, agent: 'architect' };
+                return {
+                    code: 'NOT_FOUND',
+                    message: legacyBuilderErrorMessage(sender, [...entry.architects.keys()]),
+                };
+            }
+            // Builder has an explicit spawning architect.
+            const target = entry.architects.get(spawningArchitect);
+            if (target)
+                return { terminalId: target, workspacePath, agent: 'architect' };
+            // Architect-gone fallback: route to 'main' if present; else fail.
+            const main = entry.architects.get(DEFAULT_ARCHITECT_NAME);
+            if (main)
+                return { terminalId: main, workspacePath, agent: 'architect' };
+            return {
+                code: 'NOT_FOUND',
+                message: architectGoneErrorMessage(sender, spawningArchitect, [...entry.architects.keys()]),
+            };
+        }
+        // Non-builder sender (or no sender): 'main' first, then first registered.
+        const terminalId = entry.architects.get(DEFAULT_ARCHITECT_NAME) ?? entry.architects.values().next().value;
+        return { terminalId, workspacePath, agent: 'architect' };
     }
+    // `architect:<name>` addressing is handled earlier in resolveTarget via
+    // resolveArchitectByName. Reaching this point means the agent is a plain
+    // workspace-local name (builder/shell), so we fall through to those.
     // Check builders — exact match (case-insensitive)
     for (const [builderId, terminalId] of entry.builders) {
         if (builderId.toLowerCase() === agent) {

package/dist/agent-farm/servers/tower-messages.js.map

@@ -1 +1 @@
-{"version":3,"file":"tower-messages.js","sourceRoot":"","sources":["../../../src/agent-farm/servers/tower-messages.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tower-messages.js","sourceRoot":"","sources":["../../../src/agent-farm/servers/tower-messages.ts"],"names":[],"mappings":"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"}

package/dist/agent-farm/servers/tower-routes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tower-routes.d.ts","sourceRoot":"","sources":["../../../src/agent-farm/servers/tower-routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,IAAI,MAAM,WAAW,CAAC;AAa7B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAIxE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAmElD,gFAAgF;AAChF,wBAAgB,eAAe,CAAC,GAAG,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAMtG;AAED,sGAAsG;AACtG,wBAAgB,cAAc,IAAI,IAAI,CAErC;AAMD,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACjE,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,kBAAkB,EAAE,MAAM,cAAc,GAAG,IAAI,CAAC;IAChD,qBAAqB,EAAE,CAAC,YAAY,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IACjH,YAAY,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,IAAI,CAAC;IAC1C,eAAe,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;CACvC;AAsCD,wBAAsB,aAAa,CACjC,GAAG,EAAE,IAAI,CAAC,eAAe,EACzB,GAAG,EAAE,IAAI,CAAC,cAAc,EACxB,GAAG,EAAE,YAAY,GAChB,OAAO,CAAC,IAAI,CAAC,CA6Ef"}
+{"version":3,"file":"tower-routes.d.ts","sourceRoot":"","sources":["../../../src/agent-farm/servers/tower-routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,IAAI,MAAM,WAAW,CAAC;AAa7B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAIxE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAqElD,gFAAgF;AAChF,wBAAgB,eAAe,CAAC,GAAG,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAMtG;AAED,sGAAsG;AACtG,wBAAgB,cAAc,IAAI,IAAI,CAErC;AAMD,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACjE,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,kBAAkB,EAAE,MAAM,cAAc,GAAG,IAAI,CAAC;IAChD,qBAAqB,EAAE,CAAC,YAAY,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IACjH,YAAY,EAAE,CAAC,MAAM,EAAE,SAAS,KAAK,IAAI,CAAC;IAC1C,eAAe,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;CACvC;AAuCD,wBAAsB,aAAa,CACjC,GAAG,EAAE,IAAI,CAAC,eAAe,EACzB,GAAG,EAAE,IAAI,CAAC,cAAc,EACxB,GAAG,EAAE,YAAY,GAChB,OAAO,CAAC,IAAI,CAAC,CAmFf"}

package/dist/agent-farm/servers/tower-routes.js

@@ -32,8 +32,9 @@ import { resolveTarget, broadcastMessage, isResolveError } from './tower-message
 import { formatArchitectMessage, formatBuilderMessage } from '../utils/message-format.js';
 import { SendBuffer } from './send-buffer.js';
 import { writeMessageToSession } from './message-write.js';
-import { getKnownWorkspacePaths, getInstances, getDirectorySuggestions, launchInstance, killTerminalWithShellper, stopInstance, } from './tower-instances.js';
+import { getKnownWorkspacePaths, getInstances, getDirectorySuggestions, launchInstance, killTerminalWithShellper, stopInstance, addArchitect, } from './tower-instances.js';
 import { OverviewCache } from './overview.js';
+import { fetchIssue } from '../../lib/github.js';
 import { computeAnalytics } from './analytics.js';
 import { getAllTasks, executeTask, getTaskId } from './tower-cron.js';
 import { getGlobalDb } from '../db/index.js';
@@ -66,6 +67,7 @@ const ROUTES = {
     'GET /api/terminals': (_req, res) => handleTerminalList(res),
     'GET /api/status': (_req, res) => handleStatus(res),
     'GET /api/overview': (_req, res, url) => handleOverview(res, url),
+    'GET /api/issue': (_req, res, url) => handleIssueView(res, url),
     'GET /api/analytics': (_req, res, url) => handleAnalytics(res, url),
     'POST /api/overview/refresh': (_req, res, _url, ctx) => handleOverviewRefresh(res, ctx),
     'GET /api/events': (req, res, _url, ctx) => handleSSEEvents(req, res, ctx),
@@ -124,6 +126,11 @@ export async function handleRequest(req, res, ctx) {
         if (workspaceApiMatch) {
             return await handleWorkspaceAction(req, res, ctx, workspaceApiMatch);
         }
+        // Workspace API: /api/workspaces/:encodedPath/architects (Spec 755 — multi-architect)
+        const architectsMatch = url.pathname.match(/^\/api\/workspaces\/([^/]+)\/architects$/);
+        if (architectsMatch) {
+            return await handleAddArchitect(req, res, architectsMatch);
+        }
         // Terminal-specific routes: /api/terminals/:id/* (Spec 0090 Phase 2)
         const terminalRouteMatch = url.pathname.match(/^\/api\/terminals\/([^/]+)(\/.*)?$/);
         if (terminalRouteMatch) {
@@ -176,6 +183,54 @@ async function handleListWorkspaces(res) {
     res.writeHead(200, { 'Content-Type': 'application/json' });
     res.end(JSON.stringify({ workspaces }));
 }
+/**
+ * POST /api/workspaces/:encodedPath/architects (Spec 755)
+ * Body: { name?: string }
+ * Adds a named architect terminal to an active workspace.
+ * Returns 200 { success: true, name, terminalId } on success,
+ * 400 / 404 with { success: false, error } otherwise.
+ */
+async function handleAddArchitect(req, res, match) {
+    if (req.method !== 'POST') {
+        res.writeHead(405, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({ error: 'Method not allowed' }));
+        return;
+    }
+    const [, encodedPath] = match;
+    let workspacePath;
+    try {
+        workspacePath = decodeWorkspacePath(encodedPath);
+        if (!workspacePath || (!workspacePath.startsWith('/') && !/^[A-Za-z]:[\\/]/.test(workspacePath))) {
+            throw new Error('Invalid path');
+        }
+        workspacePath = normalizeWorkspacePath(workspacePath);
+    }
+    catch {
+        res.writeHead(400, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({ error: 'Invalid workspace path encoding' }));
+        return;
+    }
+    let body;
+    try {
+        body = (await parseJsonBody(req));
+    }
+    catch {
+        res.writeHead(400, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({ error: 'Invalid JSON body' }));
+        return;
+    }
+    const result = await addArchitect(workspacePath, body.name);
+    if (result.success) {
+        res.writeHead(200, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({ success: true, name: result.name, terminalId: result.terminalId }));
+    }
+    else {
+        // Distinguish "workspace not active" (404) from validation errors (400).
+        const status = result.error?.includes('not running') ? 404 : 400;
+        res.writeHead(status, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({ success: false, error: result.error }));
+    }
+}
 async function handleWorkspaceAction(req, res, ctx, match) {
     const [, encodedPath, action] = match;
     let workspacePath;
@@ -549,6 +604,30 @@ async function handleOverview(res, url, workspaceOverride) {
     res.writeHead(200, { 'Content-Type': 'application/json' });
     res.end(JSON.stringify(data));
 }
+async function handleIssueView(res, url) {
+    // Workspace resolution mirrors handleOverview: ?workspace= param, else
+    // the first known non-builder workspace path.
+    let workspaceRoot = url.searchParams.get('workspace');
+    if (!workspaceRoot) {
+        const knownPaths = getKnownWorkspacePaths();
+        workspaceRoot = knownPaths.find(p => !p.includes('/.builders/')) || null;
+    }
+    const number = url.searchParams.get('number');
+    if (!workspaceRoot || !number) {
+        res.writeHead(400, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({ error: 'Missing workspace or number' }));
+        return;
+    }
+    // Routes through the `issue-view` forge concept (forge-agnostic).
+    const issue = await fetchIssue(number, { cwd: workspaceRoot });
+    if (!issue) {
+        res.writeHead(404, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({ error: `Issue #${number} not found or forge unavailable` }));
+        return;
+    }
+    res.writeHead(200, { 'Content-Type': 'application/json' });
+    res.end(JSON.stringify(issue));
+}
 function handleOverviewRefresh(res, ctx) {
     overviewCache.invalidate();
     // Bugfix #388: Broadcast SSE event so all connected dashboard clients
@@ -659,8 +738,10 @@ async function handleSend(req, res, ctx) {
     const raw = options.raw === true;
     const noEnter = options.noEnter === true;
     const interrupt = options.interrupt === true;
-    // Resolve the target address to a terminal ID
-    const result = resolveTarget(to, workspace);
+    // Resolve the target address to a terminal ID.
+    // Spec 755: pass `from` so architect resolution is sender-affinity-aware
+    // when the sender is a builder. Non-builder senders see unchanged behavior.
+    const result = resolveTarget(to, workspace, from);
     if (isResolveError(result)) {
         const statusCode = result.code === 'AMBIGUOUS' ? 409
             : result.code === 'NO_CONTEXT' ? 400
@@ -1120,8 +1201,11 @@ async function handleWorkspaceState(res, workspacePath) {
     // entry — see getRehydratedTerminalsEntry doc.
     const entry = await getRehydratedTerminalsEntry(workspacePath);
     const manager = getTerminalManager();
+    // Spec 761: type as DashboardState directly to prevent inline-literal drift.
+    // ArchitectState.name (Spec 761) carries the architect's stable identity.
     const state = {
         architect: null,
+        architects: [],
         builders: [],
         utils: [],
         annotations: [],
@@ -1135,18 +1219,32 @@ async function handleWorkspaceState(res, workspacePath) {
         } })(),
         teamEnabled: await hasTeam(path.join(workspacePath, 'codev', 'team')),
     };
-    // Add architect if exists
-    if (entry.architect) {
-        const session = manager.getSession(entry.architect);
-        if (session) {
-            state.architect = {
-                port: 0,
-                pid: session.pid || 0,
-                terminalId: entry.architect,
-                persistent: isSessionPersistent(entry.architect, session),
-            };
-        }
+    // Spec 761: build the architects collection from entry.architects.
+    // - Skip entries whose session is unavailable (race / stale registration).
+    // - Move 'main' to index 0 when present so consumers can rely on
+    //   architects[0] as the default architect.
+    // Spec 755: the scalar `state.architect` is preserved as a backward-compat
+    // pointer to the same default architect (architects[0] when present).
+    const collectedArchitects = [];
+    for (const [architectName, terminalId] of entry.architects) {
+        const session = manager.getSession(terminalId);
+        if (!session)
+            continue;
+        collectedArchitects.push({
+            name: architectName,
+            port: 0,
+            pid: session.pid || 0,
+            terminalId,
+            persistent: isSessionPersistent(terminalId, session),
+        });
     }
+    const mainIdx = collectedArchitects.findIndex(a => a.name === 'main');
+    if (mainIdx > 0) {
+        const [mainEntry] = collectedArchitects.splice(mainIdx, 1);
+        collectedArchitects.unshift(mainEntry);
+    }
+    state.architects = collectedArchitects;
+    state.architect = collectedArchitects[0] ?? null;
     // Add shells from refreshed cache
     for (const [shellId, terminalId] of entry.shells) {
         const session = manager.getSession(terminalId);
@@ -1506,9 +1604,14 @@ async function handleWorkspaceTabDelete(res, ctx, workspacePath, tabId) {
         }
     }
     else if (tabId === 'architect') {
-        terminalId = entry.architect;
-        if (terminalId) {
-            entry.architect = undefined;
+        // Spec 755: tabId 'architect' targets the architect surfaced by /api/state
+        // — prefer 'main', else the first registered.
+        const name = entry.architects.has('main')
+            ? 'main'
+            : entry.architects.keys().next().value;
+        if (name) {
+            terminalId = entry.architects.get(name);
+            entry.architects.delete(name);
         }
     }
     if (terminalId) {
@@ -1527,9 +1630,10 @@ async function handleWorkspaceTabDelete(res, ctx, workspacePath, tabId) {
 async function handleWorkspaceStopAll(res, workspacePath) {
     const entry = getWorkspaceTerminalsEntry(workspacePath);
     const manager = getTerminalManager();
-    // Kill all terminals (disable shellper auto-restart if applicable)
-    if (entry.architect) {
-        await killTerminalWithShellper(manager, entry.architect);
+    // Kill all terminals (disable shellper auto-restart if applicable).
+    // Spec 755: iterate all named architects, not just the singleton.
+    for (const terminalId of entry.architects.values()) {
+        await killTerminalWithShellper(manager, terminalId);
     }
     for (const terminalId of entry.shells.values()) {
         await killTerminalWithShellper(manager, terminalId);