@fitlab-ai/agent-infra 0.11.14 → 0.12.0

package/dist/lib/merge.js

@@ -4,6 +4,7 @@ import path from 'node:path';
 import crypto from 'node:crypto';
 import { removeDirRecursive } from './remove-dir.js';
 import { validateCurrentTaskContract } from './task/current-contract.js';
+import { resolveProjectTaskWorkspaceRoot } from './task/workspace-root.js';
 const TASK_ID_RE = /^TASK-\d{8}-\d{6}$/;
 const FRONTMATTER_RE = /^---\r?\n([\s\S]*?)\r?\n---(?:\r?\n|$)/;
 const TITLE_RE = /^# (.+)$/m;
@@ -800,7 +801,7 @@ function mergeArchiveSection(sourceArchive, localArchive, report) {
     return sourceTasks.length;
 }
 function printSection(lines, name, counts) {
-    const title = `${SECTION_LABELS[name].padEnd(9, ' ')} (.agents/workspace/${name}/):`;
+    const title = `${SECTION_LABELS[name].padEnd(9, ' ')} (task workspace/${name}/):`;
     lines.push(title);
     const allEntries = [
         ['copied', '✓ Copied  '],
@@ -820,7 +821,7 @@ function printSection(lines, name, counts) {
     lines.push('');
 }
 function printArchiveSection(lines, counts) {
-    const title = `${SECTION_LABELS.archive.padEnd(9, ' ')} (.agents/workspace/archive/):`;
+    const title = `${SECTION_LABELS.archive.padEnd(9, ' ')} (task workspace/archive/):`;
     lines.push(title);
     if (counts.copied.length === 0 && counts.skipped.length === 0) {
         lines.push('  (no changes)', '');
@@ -891,7 +892,7 @@ async function cmdMerge(args) {
         throw new Error(`Source path is not a directory: ${sourcePath}`);
     }
     const repoRoot = process.cwd();
-    const workspaceDir = path.join(repoRoot, '.agents', 'workspace');
+    const workspaceDir = resolveProjectTaskWorkspaceRoot(repoRoot);
     const archiveDir = path.join(workspaceDir, 'archive');
     const backupStamp = formatBackupTimestamp(new Date());
     const projectKey = resolveRecoveryProjectKey(repoRoot);

package/dist/lib/platform/pr-change-report.js

@@ -379,19 +379,26 @@ function runMechanicalChangeReport(repoRoot, baseSha, headSha) {
         throw new Error(`${validated.error.code}: ${validated.error.message}`);
     return validated.value;
 }
+const DOCUMENTATION_CATEGORY = { label: '文档', prefixes: ['docs/'] };
 const CHANGE_CATEGORIES = [
     { label: '运行时代码', prefixes: ['bin/', 'lib/', 'src/', 'scripts/'] },
     { label: '测试与校验', prefixes: ['test/', 'tests/'] },
     { label: '模板与生成内容', prefixes: ['templates/'] },
     { label: '技能与协作配置', prefixes: ['.agents/'] },
-    { label: '文档与其他', prefixes: [] }
+    DOCUMENTATION_CATEGORY,
+    { label: '其他', prefixes: [] }
 ];
 function emptyChangeTotals() {
     return { files: 0, textFiles: 0, binaryFiles: 0, additions: 0, deletions: 0, oldBytes: 0, newBytes: 0, netBytes: 0 };
 }
 function categoryForChangeFile(file) {
     const filePath = file.newPath || file.oldPath || '';
-    return CHANGE_CATEGORIES.find((category) => category.prefixes.some((prefix) => filePath.startsWith(prefix))) || CHANGE_CATEGORIES[CHANGE_CATEGORIES.length - 1];
+    const category = CHANGE_CATEGORIES.find((entry) => entry.prefixes.some((prefix) => prefix && filePath.startsWith(prefix)));
+    if (category)
+        return category;
+    if (/\.(?:md|mdx|markdown|rst)$/i.test(filePath))
+        return DOCUMENTATION_CATEGORY;
+    return CHANGE_CATEGORIES[CHANGE_CATEGORIES.length - 1];
 }
 function summarizeChangeCategories(files) {
     const summaries = new Map();
@@ -492,7 +499,7 @@ function renderEvidence(evidence) {
 function renderPrechecks(checks) {
     return checks.flatMap((check) => [
         `- **${PRECHECK_LABELS[check.id]}（${check.id}）**：${check.verdict === 'pass' ? '通过' : '需复核'}。${escapeReportText(check.rationale)}`,
-        ...check.evidence.slice(0, 1).map(renderEvidence)
+        ...check.evidence.map(renderEvidence)
     ]);
 }
 function renderCanonicalChangeReport(report) {

package/dist/lib/platform/pr-summary.js

@@ -4,7 +4,6 @@ import { createHash } from 'node:crypto';
 import { enumerateArtifacts } from '../task/artifacts.js';
 import { parseTypedTaskFrontmatter } from '../task/frontmatter.js';
 import { resolveTaskRef } from '../task/resolve-ref.js';
-import { TaskExecutionLockError, withTaskExecutionLock } from '../task/task-execution-lock.js';
 import { readPrDeliveryFact } from '../task/pr-delivery-fact.js';
 import { resolvePlatformProviderContext } from './context.js';
 import { normalizeCommentContent } from './issue-comments.js';
@@ -348,7 +347,7 @@ async function reportWrite(taskRef, options) {
         return { ...context, report: null };
     let knownPrNumber = null;
     try {
-        return await withTaskExecutionLock(resolved.repoRoot, resolved.taskId, options.agent, async () => {
+        return await (async () => {
             const { taskContent, boundFact, factError } = readBoundTaskSnapshot(resolved.taskMdPath);
             if (factError)
                 return {
@@ -433,13 +432,10 @@ async function reportWrite(taskRef, options) {
                 operations: [{ name: 'change-report:write', status: 'applied', reasonCode: null }],
                 report: { ...reportInfo, status: 'written' }
             };
-        });
+        })();
     }
     catch (error) {
-        const lockError = error instanceof TaskExecutionLockError
-            ? { code: error.code, message: error.message, retryable: error.code === 'ORCHESTRATION_LOCK_BUSY' }
-            : { code: 'PR_CHANGE_REPORT_FAILED', message: error instanceof Error ? error.message : String(error), retryable: false };
-        return { ...basePlatformResult(lockError.retryable ? 'blocked' : 'failed', context, resolved.taskId, knownPrNumber, lockError), report: null };
+        return { ...basePlatformResult('failed', context, resolved.taskId, knownPrNumber, { code: 'PR_CHANGE_REPORT_FAILED', message: error instanceof Error ? error.message : String(error), retryable: false }), report: null };
     }
 }
 async function syncPullRequestSummary(taskRef, options) {
@@ -492,7 +488,7 @@ async function syncPullRequestSummary(taskRef, options) {
     const loaded = await resolvePlatformProviderContext({ cwd: resolved.repoRoot, client: options.client });
     const context = loaded.ok ? loaded.value.context : loaded.context;
     if (!loaded.ok || !context.platform.repository || !['no-op', 'degraded'].includes(context.status)) {
-        // This diagnostic-only read preserves the known PR target when context resolution fails before the execution lock.
+        // Preserve the known PR target for diagnostics when provider context resolution fails.
         knownPrNumber = boundPrNumberForWarning(resolved.taskMdPath);
         return preserveFailure(context);
     }
@@ -737,15 +733,10 @@ async function syncPullRequestSummary(taskRef, options) {
                 persistenceFailure: (error) => fail('failed', context, error, prNumber)
             });
         };
-        return await (options.lockAlreadyHeld
-            ? execute()
-            : withTaskExecutionLock(resolved.repoRoot, resolved.taskId, options.agent, execute));
+        return await execute();
     }
     catch (error) {
-        const lockError = error instanceof TaskExecutionLockError
-            ? { code: error.code, message: error.message, retryable: error.code === 'ORCHESTRATION_LOCK_BUSY' }
-            : { code: 'PR_SUMMARY_FAILED', message: error instanceof Error ? error.message : String(error), retryable: false };
-        return fail(lockError.retryable ? 'blocked' : 'failed', context, lockError);
+        return fail('failed', context, { code: 'PR_SUMMARY_FAILED', message: error instanceof Error ? error.message : String(error), retryable: false });
     }
 }
 export { buildPullRequestSummary, reconcileSummaryComment, reportWrite, summaryCommentState, summaryContext, summaryMarker, syncPullRequestSummary, warningResultForPrimary };

package/dist/lib/platform/pull-requests.js

@@ -14,7 +14,6 @@ import { planPullRequestMetadata } from './pull-request-metadata.js';
 import { planInLabelUpdate, validateInLabelMapping } from './in-label-sync.js';
 import { platformResult } from './types.js';
 import { inspectCompletionArtifacts } from '../task/finalization-artifacts.js';
-import { TaskExecutionLockError, withTaskExecutionLock } from '../task/task-execution-lock.js';
 import { resolveDeliveryTarget } from '../task/delivery-target.js';
 import { mergeOperationWarnings } from '../task/operation-outcome.js';
 import { buildBoundFact, buildSkippedFact, factFrontmatterMutation, readPrDeliveryFact } from '../task/pr-delivery-fact.js';
@@ -1007,16 +1006,9 @@ async function createPlatformPullRequestImpl(taskRef, options) {
         }), PRECONDITION_NOT_CREATED);
     }
     try {
-        return withTaskExecutionLock(base.resolved.repoRoot, base.resolved.taskId, 'platform-pr.create', () => createExternalPullRequest(taskRef, options, base));
+        return await createExternalPullRequest(taskRef, options, base);
     }
     catch (error) {
-        if (error instanceof TaskExecutionLockError) {
-            return withCreation(result('blocked', base.resolved.taskId, base.issueNumber, null, {
-                platform: base.context.platform,
-                capabilities: base.context.capabilities,
-                error: { code: error.code, message: error.message, retryable: true }
-            }), PRECONDITION_NOT_CREATED);
-        }
         return withCreation(result('failed', base.resolved.taskId, base.issueNumber, null, {
             platform: base.context.platform,
             capabilities: base.context.capabilities,
@@ -1456,7 +1448,7 @@ function readProjectPrFlow(repoRoot) {
         return undefined;
     }
 }
-function skipPlatformPullRequestFactUnlocked(resolved, options) {
+function applySkippedPullRequestFact(resolved, options) {
     let content;
     let frontmatter;
     try {
@@ -1533,13 +1525,9 @@ async function skipPlatformPullRequestFact(taskRef, options) {
             error: { code: 'TASK_STATE_INVALID', message: 'platform-pr skip requires an active task', retryable: false }
         });
     try {
-        return withTaskExecutionLock(resolved.repoRoot, resolved.taskId, 'platform-pr.skip', () => skipPlatformPullRequestFactUnlocked(resolved, options));
+        return await applySkippedPullRequestFact(resolved, options);
     }
     catch (error) {
-        if (error instanceof TaskExecutionLockError)
-            return result('blocked', resolved.taskId, null, null, {
-                error: { code: error.code, message: error.message, retryable: true }
-            });
         return result('failed', resolved.taskId, null, null, {
             error: { code: 'PR_SKIP_FAILED', message: error instanceof Error ? error.message : String(error), retryable: false }
         });

package/dist/lib/pr-review/evidence-grading.js

@@ -3,6 +3,7 @@ import path from 'node:path';
 import { parseTypedTaskFrontmatter } from '../task/frontmatter.js';
 import { readPrDeliveryFact } from '../task/pr-delivery-fact.js';
 import { resourceIdentityEquals, resourceIdentityNumber } from '../platform/resource-identity.js';
+import { resolveProjectTaskWorkspaceRoot } from '../task/workspace-root.js';
 import { taskIssueIdentity } from '../platform/task-identities.js';
 export class HostResolutionError extends Error {
     code;
@@ -35,12 +36,12 @@ export function extractClosingIssueNumbers(body) {
     return result;
 }
 /**
- * Scan `.agents/workspace/active/{task-id}/task.md` files for tasks bound to the
+ * Scan active project task workspace task.md files for tasks bound to the
  * PR number or to one of the PR's closing issues. A task is emitted at most once;
  * a verified fact identity hit takes priority over the issue-identity reverse lookup.
  */
 export function collectHostCandidates(input) {
-    const activeRoot = path.join(input.workspaceRoot, '.agents', 'workspace', 'active');
+    const activeRoot = path.join(resolveProjectTaskWorkspaceRoot(input.workspaceRoot), 'active');
     const candidates = [];
     let entries;
     try {

package/dist/lib/process-data/index.js

@@ -1,6 +1,8 @@
 import fs from 'node:fs';
+import os from 'node:os';
 import path from 'node:path';
 import { detectRepoRoot } from '../task/resolve-ref.js';
+import { resolveProjectTaskWorkspaceRoot } from '../task/workspace-root.js';
 import { acquireGitHubCheckpoint, commitGitHubCheckpoint, readGitHubCheckpoint, releaseGitHubCheckpoint } from './checkpoint.js';
 import { materializeJson, materializeSnapshot } from './materialize.js';
 import { normalizeResources } from './normalize.js';
@@ -48,17 +50,27 @@ function parseArgs(args, valueOptions, booleanOptions) {
     return { positionals, options };
 }
 function dataRoot(repoRoot, requested) {
-    const workspace = path.resolve(repoRoot, '.agents', 'workspace');
-    const resolved = path.resolve(repoRoot, requested ?? path.join('.agents', 'workspace', 'process-data'));
-    const relative = path.relative(repoRoot, resolved);
-    if (!relative || relative.startsWith('..') || path.isAbsolute(relative))
-        throw new Error('data root must be inside the repository');
+    let boundary = repoRoot;
+    let input = requested;
+    if (input === undefined) {
+        const config = JSON.parse(fs.readFileSync(path.join(repoRoot, '.agents', '.airc.json'), 'utf8'));
+        if (typeof config.project !== 'string' || !/^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(config.project)) {
+            throw new Error('.agents/.airc.json must contain a valid project name in its project field');
+        }
+        boundary = path.resolve(os.homedir());
+        input = path.join(boundary, '.agent-infra', 'data-store', config.project);
+    }
+    const resolved = path.resolve(repoRoot, input);
+    const workspace = resolveProjectTaskWorkspaceRoot(repoRoot);
     const taskRoots = ['active', 'blocked', 'completed', 'archive'].map((state) => path.join(workspace, state));
     if (resolved === workspace || taskRoots.some((taskRoot) => resolved === taskRoot || resolved.startsWith(`${taskRoot}${path.sep}`))) {
         throw new Error('data root cannot be the workspace root or a task directory');
     }
+    const relative = path.relative(repoRoot, resolved);
+    if (requested !== undefined && (!relative || relative.startsWith('..') || path.isAbsolute(relative)))
+        throw new Error('data root must be inside the repository');
     let current = resolved;
-    while (current !== repoRoot) {
+    while (current !== boundary) {
         if (fs.existsSync(current) && fs.lstatSync(current).isSymbolicLink())
             throw new Error('data root cannot traverse a symlink');
         current = path.dirname(current);

package/dist/lib/process-data/sources.js

@@ -2,6 +2,7 @@ import fs from 'node:fs';
 import path from 'node:path';
 import { createGitHubClient } from '../platform/github-client.js';
 import { enumerateAllTaskDirs } from '../task/resolve-ref.js';
+import { resolveProjectTaskWorkspaceRoot } from '../task/workspace-root.js';
 import { captureText, inspectPrivacy, redactExcerpt } from './privacy.js';
 import { canonicalJsonBytes, sha256 } from './store.js';
 function endpointForPage(endpoint, page, perPage) {
@@ -103,6 +104,11 @@ function fetchRestCollection(options) {
     };
 }
 function relativeIdentity(repoRoot, filePath) {
+    const workspaceRoot = resolveProjectTaskWorkspaceRoot(repoRoot);
+    const taskRelative = path.relative(workspaceRoot, filePath);
+    if (taskRelative && !taskRelative.startsWith('..') && !path.isAbsolute(taskRelative)) {
+        return path.posix.join('task-workspace', taskRelative.split(path.sep).join('/'));
+    }
     const relative = path.relative(repoRoot, filePath);
     if (!relative || relative.startsWith('..') || path.isAbsolute(relative))
         throw new Error(`path escapes repository: ${filePath}`);

package/dist/lib/run/index.js

@@ -4,6 +4,7 @@ import { loadServerConfig } from '../server/config.js';
 import { resolveSandboxTarget } from '../sandbox/workspace-identity.js';
 import { createRunId, runInSandbox } from '../sandbox/capture.js';
 import { loadShortIdByTaskId, normalizeShortIdInput } from '../task/short-id.js';
+import { resolveProjectTaskWorkspaceRoot } from '../task/workspace-root.js';
 import { buildTuiCommand, renderPrompt, selectTui } from './tui.js';
 import { getSkillRunSpec } from './skills.js';
 import { runHostCommand } from './host.js';
@@ -133,7 +134,7 @@ function readShortIdLength(repoRoot) {
     return 2;
 }
 function readActiveShortIdRegistry(repoRoot) {
-    const registryPath = path.join(repoRoot, '.agents', 'workspace', 'active', '.short-ids.json');
+    const registryPath = path.join(resolveProjectTaskWorkspaceRoot(repoRoot), 'active', '.short-ids.json');
     try {
         const data = JSON.parse(fs.readFileSync(registryPath, 'utf8'));
         return data && typeof data === 'object' && data.ids && typeof data.ids === 'object' ? data.ids : {};
@@ -157,7 +158,7 @@ function resolveActiveTaskIdentity(taskRef, repoRoot) {
     }
     if (!taskId)
         return null;
-    const taskDir = path.join(repoRoot, '.agents', 'workspace', 'active', taskId);
+    const taskDir = path.join(resolveProjectTaskWorkspaceRoot(repoRoot), 'active', taskId);
     if (!fs.existsSync(path.join(taskDir, 'task.md')))
         return null;
     return { taskId, taskDir, taskRef: resolvedTaskRef };

package/dist/lib/sandbox/commands/create.js

@@ -1040,7 +1040,7 @@ export async function create(args, { runProjectInitCommand = true, workspace: wo
                             const completedTaskSource = target.workspace.mode === 'task-bound'
                                 ? prepareSandboxCompletedTaskMountSource(effectiveConfig.repoRoot, target.workspace.taskId)
                                 : null;
-                            prepareSandboxWorkspaceMountTargets(worktree, target.workspace.mode === 'task-bound' ? target.workspace.taskId : undefined);
+                            prepareSandboxWorkspaceMountTargets(effectiveConfig.repoRoot);
                             if (previousCutoverSnapshot) {
                                 assertSandboxControlCutoverSnapshot(previousCutoverSnapshot);
                                 if (previousManifest) {
@@ -1177,6 +1177,10 @@ export async function create(args, { runProjectInitCommand = true, workspace: wo
                                         : []),
                                     '--label',
                                     `${sandboxRuntimeCapabilityLabel(effectiveConfig)}=${capabilityPlan.runtimeSignature}`,
+                                    // Every task sandbox runs without seccomp and AppArmor filtering;
+                                    // capabilities and namespace isolation remain unchanged.
+                                    '--security-opt', 'seccomp=unconfined',
+                                    '--security-opt', 'apparmor=unconfined',
                                     ...coreVolumes,
                                     ...buildClipboardVolumeArgs(engine, effectiveConfig.home),
                                     ...dotfilesMount,

package/dist/lib/sandbox/commands/enter.js

@@ -13,7 +13,7 @@ import { resolveSandboxTarget } from '../workspace-identity.js';
 const USAGE = `Usage: ai sandbox exec [--recreate] <branch | TASK-id | N> [cmd...]
 
 N references an active task short id from
-.agents/workspace/active/.short-ids.json. They resolve only via that
+the read-only task-workspace mount at /task-workspace/active/.short-ids.json. They resolve only via that
 registry — they do not reference a container's row position in
 'ai sandbox ls' output. --recreate rebuilds the matched container while
 preserving its task or branch identity. The same token after the target is

package/dist/lib/sandbox/commands/list-running.js

@@ -5,6 +5,7 @@ import { runSafeEngine, runVerboseEngine } from '../shell.js';
 import { resolveTaskBranch } from '../task-resolver.js';
 import { isRemovedHashShortIdInput } from '../../task/short-id.js';
 import { parseSandboxWorkspaceIdentity } from '../workspace-identity.js';
+import { resolveProjectTaskWorkspaceRoot } from '../../task/workspace-root.js';
 export function containerListFormat() {
     return '{{.Names}}\t{{.Status}}\t{{.Labels}}';
 }
@@ -111,7 +112,7 @@ function tryResolveFromRegistry(arg, repoRoot) {
         throw new Error(`Registry returned malformed task id for '${arg}': ${JSON.stringify(taskId)}`);
     }
     for (const sub of ['active', 'completed', 'blocked', 'archive']) {
-        const taskMdPath = path.join(repoRoot, '.agents', 'workspace', sub, taskId, 'task.md');
+        const taskMdPath = path.join(resolveProjectTaskWorkspaceRoot(repoRoot), sub, taskId, 'task.md');
         if (!fs.existsSync(taskMdPath))
             continue;
         const content = fs.readFileSync(taskMdPath, 'utf8');

package/dist/lib/sandbox/control/client.js

@@ -1,6 +1,8 @@
 import fs from 'node:fs';
 import path from 'node:path';
 import { randomUUID } from 'node:crypto';
+import { resolveProjectTaskWorkspaceRoot } from '../../task/workspace-root.js';
+import { detectRepoRoot } from '../../task/resolve-ref.js';
 import { SANDBOX_CONTROL_MAX_BYTES, SANDBOX_CONTROL_STATUS_STALE_MS, isSandboxControlFamily } from './protocol.js';
 import { readSandboxControlPayload, readSandboxControlStatus } from './state.js';
 import { accessSandboxTaskView, taskViewFromStatus } from './task-view.js';
@@ -127,19 +129,12 @@ const CONTROL_TASK_ID_RE = /^TASK-\d{8}-\d{6}$/;
 const CONTROL_SHORT_ID_RE = /^\d+$/;
 // Use the current short-id contract for the first visible active registry.
 export function resolveVisibleActiveShortId(ref) {
-    let dir = process.cwd();
-    for (let depth = 0; depth < 64; depth += 1) {
-        const registryPath = path.join(dir, '.agents', 'workspace', 'active', '.short-ids.json');
-        if (fs.existsSync(registryPath)) {
-            const resolved = resolveShortIdReadOnly(ref, dir, { shortIdLength: configuredShortIdLength(dir) });
-            return resolved.ok ? resolved.taskId : null;
-        }
-        const parent = path.dirname(dir);
-        if (parent === dir)
-            break;
-        dir = parent;
-    }
-    return null;
+    const repoRoot = detectRepoRoot();
+    const registryPath = path.join(resolveProjectTaskWorkspaceRoot(repoRoot), 'active', '.short-ids.json');
+    if (!fs.existsSync(registryPath))
+        return null;
+    const resolved = resolveShortIdReadOnly(ref, repoRoot, { shortIdLength: configuredShortIdLength(repoRoot) });
+    return resolved.ok ? resolved.taskId : null;
 }
 // A request's leading argument is only a task reference for some families and
 // may be a documented short id. Compare canonical ids so a bound sandbox keeps

package/dist/lib/sandbox/control/completed-reentry.js

@@ -4,6 +4,7 @@ import { resolveTaskWorkspace } from '../task-resolver.js';
 import { assertGitWorktreeBinding } from '../../git/worktree-identity.js';
 import { parseTypedTaskFrontmatter } from '../../task/frontmatter.js';
 import { readTaskFinalizationReceipt } from '../../task/finalization.js';
+import { resolveProjectTaskWorkspaceRoot } from '../../task/workspace-root.js';
 import { inspectSandboxControlContainer } from './container-identity.js';
 import { atomicWriteJson, readSandboxControlStatus } from './state.js';
 import { taskViewForManifest } from './task-view.js';
@@ -40,7 +41,7 @@ export async function prepareCompletedReentry(manifest, inspect = inspectSandbox
         || previous.receipt.requestId !== view.receipt.requestId
         || previous.receipt.revision > view.receipt.revision)
         throw invalid();
-    const completedRoot = fs.realpathSync.native(path.join(manifest.repoRoot, '.agents', 'workspace', 'completed'));
+    const completedRoot = fs.realpathSync.native(path.join(resolveProjectTaskWorkspaceRoot(manifest.repoRoot), 'completed'));
     const source = fs.realpathSync.native(path.join(completedRoot, manifest.taskId));
     if (source !== path.join(completedRoot, manifest.taskId))
         throw invalid();

package/dist/lib/sandbox/control/lifecycle.js

@@ -518,27 +518,8 @@ function readTaskCompletionManifest(root, binding) {
     }
     return manifest;
 }
-export async function quiesceSandboxControlForTaskCompletion(root, binding, timeoutMs = DEFAULT_QUIESCE_TIMEOUT_MS) {
-    const resolvedRoot = path.resolve(root);
-    const manifest = readTaskCompletionManifest(resolvedRoot, binding);
-    markSandboxControlRootQuiescing(resolvedRoot);
-    const deadline = Date.now() + timeoutMs;
-    const startupPath = path.join(resolvedRoot, BROKER_STARTING_FILE);
-    const brokerPath = path.join(resolvedRoot, 'broker.json');
-    while (true) {
-        const startup = readStartupOwner(startupPath);
-        if (fs.existsSync(startupPath) && !startup)
-            throw new Error('SANDBOX_CONTROL_BROKER_START_TRANSITION');
-        const broker = readBrokerOwner(brokerPath);
-        if (broker && (broker.token !== manifest.token || broker.generation !== manifest.generation)) {
-            throw new Error('SANDBOX_CONTROL_OWNER_MISMATCH');
-        }
-        if (!startup && !broker)
-            return;
-        if (Date.now() >= deadline)
-            throw new Error('SANDBOX_CONTROL_BROKER_DRAIN_TIMEOUT');
-        await new Promise((resolve) => setTimeout(resolve, 25));
-    }
+export function validateSandboxControlTaskIdentity(root, binding) {
+    readTaskCompletionManifest(path.resolve(root), binding);
 }
 function recordSandboxRemovalPending(root, manifest, phase, journal) {
     const pendingPath = path.join(root, 'removal-pending.json');

package/dist/lib/sandbox/control/task-view.js

@@ -1,5 +1,6 @@
 import fs from 'node:fs';
 import path from 'node:path';
+import { resolveProjectTaskWorkspaceRoot } from '../../task/workspace-root.js';
 export const SANDBOX_TASK_VIEW_STATES = ['not-applicable', 'current', 'finalized-stale', 'unknown'];
 export const SANDBOX_TASK_VIEW_SOURCES = ['active', 'completed', 'unknown'];
 function invalidView(message) {
@@ -71,8 +72,9 @@ export function taskViewForManifest(params) {
     if (params.mode !== 'task-bound' || !params.taskId) {
         return { state: 'not-applicable', taskId: null, observedSource: null, receipt: null, reasonCode: null };
     }
-    const active = path.join(params.repoRoot, '.agents', 'workspace', 'active', params.taskId, 'task.md');
-    const completed = path.join(params.repoRoot, '.agents', 'workspace', 'completed', params.taskId, 'task.md');
+    const taskRoot = resolveProjectTaskWorkspaceRoot(params.repoRoot);
+    const active = path.join(taskRoot, 'active', params.taskId, 'task.md');
+    const completed = path.join(taskRoot, 'completed', params.taskId, 'task.md');
     const activeExists = fs.existsSync(active);
     const completedExists = fs.existsSync(completed);
     if (activeExists === completedExists) {

package/dist/lib/sandbox/mounts.js

@@ -11,12 +11,12 @@ function workspaceStateMounts(workspaceViewRoot, taskBound) {
         .map(({ state, hostPath }) => taskBound && state === 'active'
         ? {
             hostPaths: [path.join(hostPath, '.short-ids.json')],
-            containerPath: '/workspace/.agents/workspace/active/.short-ids.json',
+            containerPath: '/task-workspace/active/.short-ids.json',
             readOnly: true
         }
         : {
             hostPaths: [hostPath],
-            containerPath: path.posix.join('/workspace/.agents/workspace', state),
+            containerPath: path.posix.join('/task-workspace', state),
             readOnly: true
         });
 }
@@ -37,13 +37,13 @@ function taskWorkspaceMounts(taskSources, taskBound, overrides) {
     const taskId = overrides.taskId;
     const mounts = [{
             hostPaths: taskSources,
-            containerPath: path.posix.join('/workspace/.agents/workspace/active', taskId),
+            containerPath: path.posix.join('/task-workspace/active', taskId),
             readOnly: false
         }];
     if (overrides.completedTaskSource)
         mounts.push({
             hostPaths: [overrides.completedTaskSource],
-            containerPath: path.posix.join('/workspace/.agents/workspace/completed', taskId),
+            containerPath: path.posix.join('/task-workspace/completed', taskId),
             readOnly: false
         });
     return mounts;

package/dist/lib/sandbox/recovery.js

@@ -11,6 +11,7 @@ import { sandboxCoreBindMounts } from './mounts.js';
 import { resolveSandboxGitMetadata } from './git-metadata.js';
 import { assertSandboxTaskSource, sandboxCompletedTaskMountSource, sandboxControlPaths, sandboxWorkspaceViewPaths } from './workspace-view.js';
 import { resolveTaskWorkspace } from './task-resolver.js';
+import { resolveProjectTaskWorkspaceRoot } from '../task/workspace-root.js';
 import { parseSandboxWorkspaceIdentity, sameSandboxWorkspaceIdentity } from './workspace-identity.js';
 import { inspectWorktree } from './worktree-safety.js';
 import { commandForEngine, runEngine, runOkEngine, runProbe, runVerboseEngine } from './shell.js';
@@ -277,11 +278,13 @@ export function classifySandboxRecovery(snapshot) {
         });
     }
     if (snapshot.workspaceTopology === 'legacy-parent') {
+        const legacyRoot = snapshot.mounts.some((mount) => mount.path === '/task-workspace')
+            ? '/task-workspace' : '/workspace/.agents/workspace';
         findings.push({
             repairKind: 'hard-failure',
             code: 'SANDBOX_WORKSPACE_TOPOLOGY_MISMATCH',
             message: 'Sandbox uses the legacy workspace parent-mount topology; recreate the container explicitly to migrate it.',
-            path: '/workspace/.agents/workspace'
+            path: legacyRoot
         });
     }
     if (snapshot.taskView && !snapshot.taskView.readable) {
@@ -302,7 +305,8 @@ export function classifySandboxRecovery(snapshot) {
     }
     for (const mount of snapshot.mounts) {
         if (snapshot.workspaceTopology === 'legacy-parent'
-            && mount.path.startsWith('/workspace/.agents/workspace'))
+            && (mount.path.startsWith('/workspace/.agents/workspace')
+                || mount.path.startsWith('/task-workspace')))
             continue;
         if (mount.actualType !== mount.expectedType
             || !mount.sourceMatches
@@ -386,14 +390,15 @@ function inspectContainer(engine, container, runFn) {
     return parsed[0];
 }
 function workspaceTopology(mountsByDestination) {
-    if (mountsByDestination.has('/workspace/.agents/workspace'))
+    if (mountsByDestination.has('/workspace/.agents/workspace')
+        || mountsByDestination.has('/task-workspace'))
         return 'legacy-parent';
     const perState = [
-        '/workspace/.agents/workspace/active',
-        '/workspace/.agents/workspace/active/.short-ids.json',
-        '/workspace/.agents/workspace/completed',
-        '/workspace/.agents/workspace/blocked',
-        '/workspace/.agents/workspace/archive'
+        '/task-workspace/active',
+        '/task-workspace/active/.short-ids.json',
+        '/task-workspace/completed',
+        '/task-workspace/blocked',
+        '/task-workspace/archive'
     ];
     return perState.some((destination) => mountsByDestination.has(destination))
         ? 'per-state'
@@ -421,8 +426,9 @@ function sourceCandidates(engine, hostPath) {
     return [...new Set(candidates.map((candidate) => normalizeMountSource(engine, candidate)))];
 }
 function recoveryTaskSources(repoRoot, taskId) {
-    const activePath = path.join(repoRoot, '.agents', 'workspace', 'active', taskId);
-    const completedPath = path.join(repoRoot, '.agents', 'workspace', 'completed', taskId);
+    const taskRoot = resolveProjectTaskWorkspaceRoot(repoRoot);
+    const activePath = path.join(taskRoot, 'active', taskId);
+    const completedPath = path.join(taskRoot, 'completed', taskId);
     if (fs.existsSync(activePath) && !fs.existsSync(completedPath)) {
         const source = assertSandboxTaskSource(repoRoot, taskId);
         return { mountPaths: [source], accessiblePaths: [source] };
@@ -435,12 +441,12 @@ function recoveryTaskSources(repoRoot, taskId) {
     if (task.state !== 'completed') {
         throw new Error(`SANDBOX_TASK_SOURCE_STATE_UNSUPPORTED: task ${taskId} is ${task.state}`);
     }
-    const completedRoot = fs.realpathSync.native(path.join(repoRoot, '.agents', 'workspace', 'completed'));
+    const completedRoot = fs.realpathSync.native(path.join(taskRoot, 'completed'));
     const completedSource = fs.realpathSync.native(path.dirname(task.taskMd));
     if (path.dirname(completedSource) !== completedRoot) {
         throw new Error(`SANDBOX_TASK_SOURCE_INVALID: ${completedSource} is not under completed workspace`);
     }
-    const historicalActivePath = path.join(repoRoot, '.agents', 'workspace', 'active', taskId);
+    const historicalActivePath = path.join(taskRoot, 'active', taskId);
     const mountPaths = [completedSource, historicalActivePath];
     if (fs.existsSync(historicalActivePath)) {
         try {
@@ -456,7 +462,7 @@ function recoveryTaskSources(repoRoot, taskId) {
 export function startCompletedSandboxContainer(params) {
     const taskSources = recoveryTaskSources(params.config.repoRoot, params.taskId);
     const completedSource = taskSources.accessiblePaths[0];
-    const activeRoot = path.join(params.config.repoRoot, '.agents', 'workspace', 'active');
+    const activeRoot = path.join(resolveProjectTaskWorkspaceRoot(params.config.repoRoot), 'active');
     const historicalSource = path.join(activeRoot, params.taskId);
     fs.mkdirSync(activeRoot, { recursive: true });
     let replacedEmptyRoot = false;
@@ -559,11 +565,11 @@ function expectedMounts(params) {
         expectedType: 'bind',
         hostPaths: mount.hostPaths,
         ...(taskSources !== null && taskId !== null
-            && mount.containerPath === `/workspace/.agents/workspace/active/${taskId}`
+            && mount.containerPath === `/task-workspace/active/${taskId}`
             ? { sourceAccessiblePaths: taskSources.accessiblePaths }
             : {}),
         ...(completedTaskSource !== null && taskId !== null
-            && mount.containerPath === `/workspace/.agents/workspace/completed/${taskId}`
+            && mount.containerPath === `/task-workspace/completed/${taskId}`
             ? { sourceAccessiblePaths: [completedTaskSource] }
             : {}),
         expectedRW: !mount.readOnly
@@ -664,7 +670,7 @@ export function collectSandboxRecoverySnapshot(params) {
     const tools = [...capabilityPlan.tools];
     const topology = workspaceTopology(mountsByDestination);
     const taskViewPath = workspace.mode === 'task-bound'
-        ? `/workspace/.agents/workspace/active/${workspace.taskId}/task.md`
+        ? `/task-workspace/active/${workspace.taskId}/task.md`
         : null;
     const seeds = declaredTmpfsSeedEntries(tools).map((seed) => {
         const mounted = mountsByDestination.get(seed.stagingPath)?.Type === 'bind';
@@ -856,6 +862,10 @@ function canRetryFreshReadiness(findings) {
         && finding.code !== 'SANDBOX_WORKSPACE_TOPOLOGY_MISMATCH'
         && finding.path !== undefined
         && (finding.path.startsWith('/workspace/.agents/workspace')
+            || finding.path.startsWith('/task-workspace/active')
+            || finding.path.startsWith('/task-workspace/blocked')
+            || finding.path.startsWith('/task-workspace/completed')
+            || finding.path.startsWith('/task-workspace/archive')
             || finding.path === '/home/devuser/.host-shell-config'
             || finding.path === '/home/devuser/.bash_aliases'
             || finding.path === '/run/agent-infra/runtime'));