@cluesmith/codev 3.0.2 → 3.0.5

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;AAoElD,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,CAmFf"}

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

@@ -17,7 +17,7 @@ import crypto from 'node:crypto';
 import { exec } from 'node:child_process';
 import { promisify } from 'node:util';
 import { homedir, tmpdir } from 'node:os';
-import { encodeWorkspacePath, decodeWorkspacePath } from '../lib/tower-client.js';
+import { decodeWorkspacePath } from '../lib/tower-client.js';
 import { readCloudConfig } from '../lib/cloud-config.js';
 import { fileURLToPath } from 'node:url';
 import { version } from '../../version.js';
@@ -32,12 +32,12 @@ 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 { computeAnalytics } from './analytics.js';
 import { getAllTasks, executeTask, getTaskId } from './tower-cron.js';
 import { getGlobalDb } from '../db/index.js';
-import { getWorkspaceTerminals, getTerminalManager, getWorkspaceTerminalsEntry, getNextShellId, saveTerminalSession, isSessionPersistent, deleteTerminalSession, removeTerminalFromRegistry, deleteWorkspaceTerminalSessions, deleteFileTabsForWorkspace, saveFileTab, deleteFileTab, getTerminalsForWorkspace, getTerminalSessionById, getActiveShellLabels, updateTerminalLabel, } from './tower-terminals.js';
+import { getWorkspaceTerminals, getTerminalManager, getWorkspaceTerminalsEntry, getNextShellId, saveTerminalSession, isSessionPersistent, deleteTerminalSession, removeTerminalFromRegistry, deleteWorkspaceTerminalSessions, deleteFileTabsForWorkspace, saveFileTab, deleteFileTab, getRehydratedTerminalsEntry, getTerminalSessionById, getActiveShellLabels, updateTerminalLabel, } from './tower-terminals.js';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 // Singleton cache for overview endpoint (Spec 0126 Phase 4)
@@ -124,6 +124,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 +181,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;
@@ -265,7 +318,11 @@ async function handleTerminalCreate(req, res, ctx) {
         const cwd = typeof body.cwd === 'string' ? body.cwd : undefined;
         const env = typeof body.env === 'object' && body.env !== null ? body.env : undefined;
         const label = typeof body.label === 'string' ? body.label : undefined;
-        // Optional session persistence via shellper
+        // Optional session persistence via shellper.
+        // The whitelist below is the gate that keeps `'dev'` (ephemeral dev PTYs)
+        // out of SQLite and shellper — the dev process dies with Tower, so
+        // persisting a row would point at a non-existent process. Add new
+        // persistent terminal kinds here if you ever introduce one.
         const workspacePath = typeof body.workspacePath === 'string' ? body.workspacePath : null;
         const termType = typeof body.type === 'string' && ['builder', 'shell'].includes(body.type) ? body.type : null;
         const roleId = typeof body.roleId === 'string' ? body.roleId : null;
@@ -531,14 +588,15 @@ async function handleOverview(res, url, workspaceOverride) {
         res.end(JSON.stringify({ builders: [], pendingPRs: [], backlog: [] }));
         return;
     }
-    // Build set of active builder role_ids (lowercased) from live terminal sessions
-    const wsTerminals = getWorkspaceTerminals();
-    const entry = wsTerminals.get(normalizeWorkspacePath(workspaceRoot));
+    // Build set of active builder role_ids (lowercased) from live terminal sessions.
+    // Bugfix #718: rehydrate the wsTerminals entry from SQLite + shellper before
+    // reading, matching what /api/state has always done. Without this the sidebar
+    // diverges from the dashboard after any state-loss event (Tower restart with
+    // non-shellper sessions, crashed builders, etc.).
+    const entry = await getRehydratedTerminalsEntry(workspaceRoot);
     const activeBuilderRoleIds = new Set();
-    if (entry) {
-        for (const key of entry.builders.keys()) {
-            activeBuilderRoleIds.add(key.toLowerCase());
-        }
+    for (const key of entry.builders.keys()) {
+        activeBuilderRoleIds.add(key.toLowerCase());
     }
     const data = await overviewCache.getOverview(workspaceRoot, activeBuilderRoleIds);
     res.writeHead(200, { 'Content-Type': 'application/json' });
@@ -654,8 +712,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
@@ -1110,13 +1170,10 @@ async function handleWorkspaceRoutes(req, res, ctx, url) {
 // Workspace API sub-handlers
 // ============================================================================
 async function handleWorkspaceState(res, workspacePath) {
-    // Refresh cache via getTerminalsForWorkspace (handles SQLite sync
-    // and shellper reconnection in one place)
-    const encodedPath = encodeWorkspacePath(workspacePath);
-    const proxyUrl = `/workspace/${encodedPath}/`;
-    await getTerminalsForWorkspace(workspacePath, proxyUrl);
-    // Now read from the refreshed cache
-    const entry = getWorkspaceTerminalsEntry(workspacePath);
+    // Rehydrate wsTerminals (SQLite sync + shellper reconnect) before reading.
+    // Shared with /api/overview so both endpoints always see a freshly-reconciled
+    // entry — see getRehydratedTerminalsEntry doc.
+    const entry = await getRehydratedTerminalsEntry(workspacePath);
     const manager = getTerminalManager();
     const state = {
         architect: null,
@@ -1133,15 +1190,18 @@ 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);
+    // Add architect if exists.
+    // Spec 755: /api/state preserves the scalar `state.architect` shape.
+    // Prefer 'main', else first registered architect by name.
+    const architectTerminalId = entry.architects.get('main') ?? entry.architects.values().next().value;
+    if (architectTerminalId) {
+        const session = manager.getSession(architectTerminalId);
         if (session) {
             state.architect = {
                 port: 0,
                 pid: session.pid || 0,
-                terminalId: entry.architect,
-                persistent: isSessionPersistent(entry.architect, session),
+                terminalId: architectTerminalId,
+                persistent: isSessionPersistent(architectTerminalId, session),
             };
         }
     }
@@ -1504,9 +1564,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) {
@@ -1525,9 +1590,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);