@loomhelm/multi-task-flow 0.2.7 → 0.2.9

package/toolkit/skills/multi-task-flow/dist/index.html

@@ -50,6 +50,7 @@
               <button id="tab-tasks" type="button" role="tab" aria-selected="false" aria-controls="tasks-view" data-tab="tasks">任务</button>
             </div>
             <label class="search input"><i data-lucide="search" aria-hidden="true"></i><span class="sr-only">搜索任务</span><input id="search" type="search" placeholder="搜索任务"></label>
+            <div id="task-view-tools" class="task-view-tools" aria-label="任务视图工具"><span id="task-count" class="section-count"></span><div id="task-layout-switch" class="layout-switch" role="group" aria-label="对象布局"><button id="task-layout-board" type="button" class="icon-button layout-option" aria-label="看板布局" aria-describedby="task-layout-board-tooltip" aria-pressed="true"><i data-lucide="columns-3"></i><span id="task-layout-board-tooltip" class="layout-tooltip" role="tooltip">看板布局：按交付单元分列展示任务</span></button><button id="task-layout-grid" type="button" class="icon-button layout-option" aria-label="网格布局" aria-describedby="task-layout-grid-tooltip" aria-pressed="false"><i data-lucide="layout-grid"></i><span id="task-layout-grid-tooltip" class="layout-tooltip" role="tooltip">网格布局：平铺展示任务</span></button></div></div>
             </div>
             <div class="filters">
             <span class="filter-caption">筛选视图</span>
@@ -70,7 +71,6 @@
             <div id="connection-notice" class="notice" role="status" hidden></div>
             <div id="phase-notice" class="notice notice-neutral" role="status" hidden><span id="phase-notice-text"></span><button type="button" id="phase-jump" class="text-button">查看实际进度</button></div>
             <div id="operation-warning" class="notice" role="status" hidden></div>
-            <div id="plan-state" class="notice plan-state" aria-label="计划与运行状态" hidden></div>
             <div id="plan-warning" class="notice notice-warning" role="status" hidden></div>
             <div id="load-error" class="notice notice-error" role="alert" hidden></div>
             <div id="graph-view" class="canvas-view" role="tabpanel" aria-labelledby="tab-graph"><div id="graph-projection-warning" class="notice notice-warning" role="status" hidden></div><div id="graph" aria-label="任务依赖图"></div><div id="atomic-graph" aria-label="原子任务依赖图" hidden></div><div id="graph-a11y" class="graph-a11y" role="list" aria-label="依赖图节点列表"></div><div id="graph-empty" class="empty" hidden>暂无任务</div></div>
@@ -79,11 +79,11 @@
           </div>
           <div id="tasks-view" class="workspace-tasks" role="tabpanel" aria-labelledby="tab-tasks" hidden>
             <section id="group-section" class="task-list-section" aria-labelledby="group-heading"><div class="section-heading"><h2 id="group-heading">交付单元</h2></div><div id="group-list" class="task-list" role="list"></div></section>
-            <section id="task-section" class="task-list-section" aria-labelledby="task-heading"><div class="section-heading"><h2 id="task-heading">任务</h2><div class="section-heading-actions"><span id="task-count" class="section-count"></span><div id="task-layout-switch" class="layout-switch" role="group" aria-label="对象布局"><button id="task-layout-board" type="button" class="icon-button layout-option" aria-label="看板布局" aria-describedby="task-layout-board-tooltip" aria-pressed="true"><i data-lucide="columns-3"></i><span id="task-layout-board-tooltip" class="layout-tooltip" role="tooltip">看板布局：按交付单元分列展示任务</span></button><button id="task-layout-grid" type="button" class="icon-button layout-option" aria-label="网格布局" aria-describedby="task-layout-grid-tooltip" aria-pressed="false"><i data-lucide="layout-grid"></i><span id="task-layout-grid-tooltip" class="layout-tooltip" role="tooltip">网格布局：平铺展示任务</span></button></div></div></div><div id="task-list" class="task-list" role="list"></div></section>
+            <section id="task-section" class="task-list-section"><div id="task-list" class="task-list" role="list"></div></section>
           </div>
         </div>
         <div id="details-backdrop" class="details-backdrop" hidden></div>
-        <div class="details-slot" hidden><aside id="details" class="details" aria-label="详情" aria-hidden="true" tabindex="-1"><div class="details-heading"><button type="button" id="close-details" class="icon-button mobile-close" data-tooltip="关闭详情" aria-label="关闭详情"><i data-lucide="x"></i></button><div id="details-summary"></div></div><div id="details-content" class="details-empty"><span class="empty-rule" aria-hidden="true"></span><strong>选择交付单元或任务</strong><span>查看依赖、运行时间和原生会话链接</span></div></aside></div>
+        <div class="details-slot" hidden><div id="details-resize" class="details-resize" role="separator" aria-orientation="horizontal" aria-label="调整详情高度" tabindex="0"></div><aside id="details" class="details" aria-label="详情" aria-hidden="true" tabindex="-1"><div class="details-heading"><button type="button" id="close-details" class="icon-button mobile-close" data-tooltip="关闭详情" aria-label="关闭详情"><i data-lucide="x"></i></button><div id="details-summary"></div></div><div id="details-content" class="details-empty"><span class="empty-rule" aria-hidden="true"></span><strong>选择交付单元或任务</strong><span>查看依赖、运行时间和原生会话链接</span></div></aside></div>
       </section>
     </main>
   </div>

package/toolkit/skills/multi-task-flow/lib/atomic-orchestration.ts

@@ -77,6 +77,7 @@ export const atomicEdge = z
 
 export const taskPrBinding = z.discriminatedUnion("state", [
   z.object({ state: z.literal("unbound") }).strict(),
+  z.object({ state: z.literal("shared_delivery_unit"), delivery_unit_id: id }).strict(),
   z.object({ state: z.literal("open"), pr: atomicExternalRef, branch: text, base_branch: text }).strict(),
   z.object({ state: z.literal("merged"), pr: atomicExternalRef, branch: text, merge_sha: text }).strict(),
   z.object({ state: z.literal("closed"), pr: atomicExternalRef, branch: text, closed_at: timestamp, closed_reason: z.enum(["abandoned", "superseded", "provider_closed", "replaced"]) }).strict(),
@@ -93,6 +94,15 @@ export type AtomicNode = z.infer<typeof atomicNode>;
 export type AtomicEdge = z.infer<typeof atomicEdge>;
 export type TaskPrBinding = z.infer<typeof taskPrBinding>;
 export type DeliveryUnitExternalFacts = z.infer<typeof deliveryUnitExternalFacts>;
+export type ContributionStartContext = {
+  delivery_unit_kind?: "bootstrap" | "regular";
+  owner_kind?: "main" | "group";
+  execution_owner?: "main" | "delivery_agent" | "task_agent";
+  conversation_policy?: "main_owned" | "delivery_owned" | "task_agent" | "none";
+  active?: boolean;
+  workspace_ready?: boolean;
+  parent_pr_status?: "definitively_absent" | "unknown" | "pending" | "present";
+};
 
 export type DerivedBusinessStatus = "planned" | "ready" | "running" | "blocked" | "completed";
 
@@ -125,10 +135,23 @@ export function deriveBusinessStatus(
   return "planned";
 }
 
-export function validateContributionStart(node: AtomicNode, deliveryUnit: { pr: DeliveryUnitExternalFacts; parent_branch?: string | null }): void {
+export function validateContributionStart(
+  node: AtomicNode,
+  deliveryUnit: { pr: DeliveryUnitExternalFacts; parent_branch?: string | null },
+  context: ContributionStartContext = {},
+): void {
   if (node.kind !== "work" || node.activity_type !== "contribution" || node.state !== "starting") return;
-  if (deliveryUnit.pr.state !== "published" && deliveryUnit.pr.state !== "merged") throw new Error("Contribution work requires a published DeliveryUnit PR before starting");
-  if (!deliveryUnit.parent_branch) throw new Error("Contribution work requires a DeliveryUnit parent branch before starting");
+  const bootstrapException =
+    context.delivery_unit_kind === "bootstrap" &&
+    context.owner_kind === "main" &&
+    context.execution_owner === "main" &&
+    context.conversation_policy === "main_owned" &&
+    context.active === true &&
+    context.workspace_ready === true &&
+    context.parent_pr_status === "definitively_absent" &&
+    deliveryUnit.pr.state === "unpublished";
+  if (!bootstrapException && deliveryUnit.pr.state !== "published" && deliveryUnit.pr.state !== "merged") throw new Error("Contribution work requires a published DeliveryUnit PR before starting");
+  if (!bootstrapException && !deliveryUnit.parent_branch) throw new Error("Contribution work requires a DeliveryUnit parent branch before starting");
 }
 
 export type MilestoneEvaluation =

package/toolkit/skills/multi-task-flow/lib/engine.ts

@@ -32,6 +32,8 @@ import {
   validateLedger,
   validateSchedulablePlan,
   validatePlan,
+  deliveryTopologyForGroup,
+  validateDeliveryTopologies,
   defaultGroupAtoms,
   executionProfile,
   recommendedExecutionProfile,
@@ -192,9 +194,20 @@ function taskPrRef(task: Ledger["tasks"][number]): ExternalRef | null {
   if (task.pr && "state" in task.pr) return "pr" in task.pr ? task.pr.pr : null;
   return task.pr;
 }
+function isSharedDeliveryTask(
+  ledger: Ledger,
+  task: Ledger["tasks"][number],
+): boolean {
+  return (
+    isContributionKind(task.kind) &&
+    deliveryTopologyForGroup(ledger.tasks, task.group_id) === "shared_delivery"
+  );
+}
 function requireContributionDispatchGate(
   ledger: Ledger,
   owner: Ledger["groups"][number],
+  requireParentPr = true,
+  retryAction: "dispatch-claim" | "task-update" = "dispatch-claim",
 ): void {
   if (legacyLedger(ledger)) return;
   const workspaceAtom = owner.atoms.find((atom) => atom.lifecycle_stage === "workspace_ready");
@@ -202,23 +215,30 @@ function requireContributionDispatchGate(
   const missing: string[] = [];
   if (owner.lifecycle.workspace_ready !== "passed" || workspaceAtom?.status !== "completed")
     missing.push("workspace_ready");
-  if (owner.lifecycle.pr_created !== "passed" || !deliveryUnitPr(owner) || prAtom?.status !== "completed")
+  const parentPrRequired = requireParentPr || !parentPrDefinitivelyAbsent(ledger, owner);
+  if (parentPrRequired && !parentPrReady(ledger, owner, prAtom))
     missing.push("parent_pr");
   if (missing.length)
     throw new ContractError(
       "DELIVERY_GATE_PENDING",
-      "Contribution task cannot start before the delivery-unit parent PR is created and verified",
+      missing.includes("parent_pr")
+        ? "Contribution task cannot start before the delivery-unit parent PR is created and verified"
+        : "Contribution task cannot start before the delivery-unit workspace is ready",
       4,
       {
         target_type: "group",
         target_id: owner.id,
         missing,
         recovery: [
-          "lifecycle-record workspace_ready",
-          "group-atom-update workspace_ready completed",
-          "publish-pr-claim + publish-pr-resolve for the parent PR",
-          "group-atom-update pr_created completed",
-          "retry dispatch-claim",
+          ...(missing.includes("workspace_ready") ? [
+            "lifecycle-record workspace_ready",
+            "group-atom-update workspace_ready completed",
+          ] : []),
+          ...(missing.includes("parent_pr") ? [
+            "publish-pr-claim + publish-pr-resolve for the parent PR",
+            "group-atom-update pr_created completed",
+            `retry ${retryAction}`,
+          ] : [`retry ${retryAction}`]),
         ],
       },
     );
@@ -231,6 +251,8 @@ function ensureSchedulable(ledger: Ledger, candidate: Plan): void {
   const contributionTasks = ledger.tasks.filter(
     (item) => item.disposition === "active" && isContributionKind(item.kind),
   );
+  if (ledger.contract_version >= 3)
+    validateDeliveryTopologies(contributionTasks, true);
   const groupIds = new Set(contributionTasks.map((item) => item.group_id));
   const missing: string[] = [];
   for (const groupId of groupIds) {
@@ -245,9 +267,19 @@ function ensureSchedulable(ledger: Ledger, candidate: Plan): void {
     }
   }
   for (const task of contributionTasks) {
+    const topology = deliveryTopologyForGroup(contributionTasks, task.group_id);
     const hasTaskPublication = candidate.actions.some(
       (action) => action.task_id === task.id,
     );
+    if (topology === "shared_delivery") {
+      requireCondition(
+        !hasTaskPublication,
+        "PLAN_NOT_DISPATCHABLE",
+        `Shared delivery task ${task.id} must not declare a task-level PR action`,
+        3,
+      );
+      continue;
+    }
     if (!hasTaskPublication) continue;
     for (const kind of ["publish_branch", "publish_pr"] as const) {
       const planned = candidate.actions.some(
@@ -409,6 +441,7 @@ function prReceipt(
   prValue: z.infer<typeof externalRef>,
   baseSha?: string,
   headSha?: string,
+  receiptState?: z.infer<typeof providerReceipt>["state"],
 ): boolean {
   const latest = latestPublication(ledger, targetId, "pr_published");
   return (
@@ -419,7 +452,43 @@ function prReceipt(
     latest.receipt.resource_id === prValue.id &&
     stable(latest.receipt.pr) === stable(prValue) &&
     (baseSha === undefined || latest.receipt.base_sha === baseSha) &&
-    (headSha === undefined || latest.receipt.head_sha === headSha)
+    (headSha === undefined || latest.receipt.head_sha === headSha) &&
+    (receiptState === undefined || latest.receipt.state === receiptState)
+  );
+}
+function parentPrReady(
+  ledger: Ledger,
+  owner: Ledger["groups"][number],
+  prAtom = owner.atoms.find((atom) => atom.lifecycle_stage === "pr_created"),
+): boolean {
+  const pr = deliveryUnitPr(owner);
+  const canonicalState = owner.pr && "state" in owner.pr ? owner.pr.state : null;
+  return (
+    owner.lifecycle.pr_created === "passed" &&
+    prAtom?.status === "completed" &&
+    !!pr &&
+    (canonicalState === null || canonicalState === "published") &&
+    prReceipt(ledger, owner.id, pr, undefined, undefined, "open")
+  );
+}
+function parentPrDefinitivelyAbsent(
+  ledger: Ledger,
+  owner: Ledger["groups"][number],
+): boolean {
+  const latest = latestPublication(ledger, owner.id, "pr_published");
+  const publicationPending = ledger.operations.some(
+    (item) =>
+      item.kind === "publish_pr" &&
+      item.target_id === owner.id &&
+      activeOperation(item),
+  );
+  return Boolean(
+    !publicationPending &&
+      latest &&
+      latest.status === "failed" &&
+      latest.receipt?.resource_type === "pr" &&
+      latest.receipt.state === "absent" &&
+      !deliveryUnitPr(owner),
   );
 }
 function requireDevelopmentTarget(
@@ -1549,6 +1618,15 @@ export function execute(
         (item) => item.id === target.group_id,
         "Group",
       );
+      requireCondition(
+        !isSharedDeliveryTask(ledger, target),
+        "SHARED_DELIVERY_UNIT_DISPATCH",
+        "A single-contribution delivery unit is dispatched through its delivery-unit conversation; do not create a task conversation",
+        3,
+        {
+          recovery: ["dispatch-group-claim", "dispatch-resolve", "task-update"],
+        },
+      );
       requireCondition(
         groupOwnerThread(ledger, owner),
         "GROUP_NOT_READY",
@@ -2355,6 +2433,15 @@ export function execute(
       const targetId = parse(id, payload.target_id);
       requireOwner(ledger, request, targetType, targetId);
       requireDevelopmentTarget(ledger, targetType, targetId);
+      if (targetType === "task") {
+        const taskTarget = find(ledger.tasks, (item) => item.id === targetId, "Task");
+        requireCondition(
+          !isSharedDeliveryTask(ledger, taskTarget),
+          "SHARED_DELIVERY_UNIT_PR",
+          "A shared delivery task reuses the delivery-unit PR and cannot publish a task PR",
+          3,
+        );
+      }
       requireLifecycle(ledger, targetType, targetId, "workspace_ready");
       const target = lifecycleTarget(ledger, targetType, targetId) as any;
       const branch = string(payload.branch);
@@ -2770,7 +2857,10 @@ export function execute(
     case "task-runtime-observe": {
       onlyMain(request.actor);
       const target = find(ledger.tasks, item => item.id === parse(id, payload.task_id), "Task");
-      requireCondition(target.thread_id === payload.thread_id, "RESOURCE_MISMATCH", "Runtime observation thread does not match task", 4);
+      const observedThread = isSharedDeliveryTask(ledger, target)
+        ? ledger.groups.find((item) => item.id === target.group_id)?.agent_thread_id
+        : target.thread_id;
+      requireCondition(observedThread === payload.thread_id, "RESOURCE_MISMATCH", "Runtime observation thread does not match task", 4);
       const runtime = z.enum(["active", "idle", "unknown"]).parse(payload.runtime);
       const observedAt = z.iso.datetime().parse(payload.observed_at);
       if (runtime === "idle") requireCondition(typeof payload.turn_id === "string" && payload.turn_id.length > 0, "EVIDENCE_REQUIRED", "Idle observation requires a confirmed terminal turn identity", 4);
@@ -2783,7 +2873,7 @@ export function execute(
         target.state = target.agent_resume_state ?? "running";
         delete target.agent_resume_state;
       }
-      if (previous !== target.state) addEvent(ledger, request, "task_runtime_observed", target.id, { task_id: target.id, thread_id: target.thread_id, turn_id: payload.turn_id ?? null, observed_at: observedAt, runtime, state: target.state, previous_state: previous });
+      if (previous !== target.state) addEvent(ledger, request, "task_runtime_observed", target.id, { task_id: target.id, thread_id: observedThread, turn_id: payload.turn_id ?? null, observed_at: observedAt, runtime, state: target.state, previous_state: previous });
       return { state: target.state };
     }
     case "task-update": {
@@ -2794,11 +2884,16 @@ export function execute(
         target.conversation_policy === "main_owned" &&
         request.actor.role === "main" &&
         request.actor.thread_id === ledger.control.owner_thread_id;
+      const sharedOwned =
+        isSharedDeliveryTask(ledger, target) &&
+        request.actor.role === "group" &&
+        ledger.groups.find((item) => item.id === target.group_id)?.agent_thread_id ===
+          request.actor.thread_id;
       const state = z
         .enum(["running", "waiting", "blocked", "completed", "closed"])
         .parse(payload.state);
       const allowed: Record<string, string[]> = {
-        planned: mainOwned ? ["running", "waiting", "blocked"] : [],
+        planned: mainOwned || sharedOwned ? ["running", "waiting", "blocked"] : [],
         starting: ["running", "waiting", "blocked"],
         running: ["waiting", "blocked"],
         agent_idle: ["running", "waiting", "blocked"],
@@ -2837,7 +2932,22 @@ export function execute(
       const occupiedSlot = target.state === "agent_idle";
       if (state === "running" && isContributionKind(target.kind)) {
         const owner = find(ledger.groups, (item) => item.id === target.group_id, "Group");
-        requireContributionDispatchGate(ledger, owner);
+        const bootstrapMainOwnedStart =
+          mainOwned &&
+          owner.delivery_unit_kind === "bootstrap" &&
+          owner.owner_kind === "main";
+        requireCondition(
+          owner.state === "active",
+          "GROUP_NOT_READY",
+          "Task group is not active",
+          4,
+        );
+        requireContributionDispatchGate(
+          ledger,
+          owner,
+          !bootstrapMainOwnedStart,
+          "task-update",
+        );
       }
       if (state === "running" && previousState !== "starting" && !occupiedSlot) {
         requireCondition(
@@ -2865,9 +2975,9 @@ export function execute(
       }
       if (state === "running" && previousState === "planned")
         requireCondition(
-          mainOwned && ready(ledger, target.id),
+          (mainOwned || sharedOwned) && ready(ledger, target.id),
           "MAIN_TASK_REQUIRED",
-          "Only the bound main conversation can start a main-owned task directly",
+          "Only the task owner can start a planned task directly",
           3,
         );
       if (state === "completed")
@@ -2895,7 +3005,10 @@ export function execute(
         );
         if (isContributionKind(target.kind))
           requireCondition(
-            legacyLedger(ledger) || target.lifecycle.pr_merged === "passed",
+            legacyLedger(ledger) ||
+              target.lifecycle.pr_merged === "passed" ||
+              (isSharedDeliveryTask(ledger, target) &&
+                ledger.groups.find((item) => item.id === target.group_id)?.lifecycle.pr_merged === "passed"),
             "PR_NOT_MERGED",
             "Contribution task PR must merge before closeout",
             4,
@@ -2935,7 +3048,7 @@ export function execute(
       }
       const eventType =
         state === "running"
-          ? previousState === "starting"
+          ? previousState === "starting" || previousState === "planned"
             ? "task_started"
             : "task_resumed"
           : state === "waiting"
@@ -2983,6 +3096,7 @@ export function execute(
       const target = find(ledger.tasks, (item) => item.id === taskId, "Task");
       const owner = find(ledger.groups, (item) => item.id === target.group_id, "Group");
       requireCondition(isContributionKind(target.kind), "TASK_MISMATCH", "Only contribution tasks can be equivalently integrated", 3);
+      requireCondition(!isSharedDeliveryTask(ledger, target), "SHARED_DELIVERY_UNIT_PR", "Shared delivery tasks do not have a child PR to integrate", 3);
       requireCondition(["blocked", "agent_idle", "running"].includes(target.state), "INVALID_TRANSITION", "Task is not awaiting integration", 3);
       requireCondition(target.atoms.every((atom) => atom.status === "completed"), "ATOMS_PENDING", "Complete the task atoms before integration", 4);
       const taskPr = parse(externalRef, payload.task_pr);
@@ -3018,8 +3132,13 @@ export function execute(
         target.conversation_policy === "main_owned" &&
         request.actor.role === "main" &&
         request.actor.thread_id === ledger.control.owner_thread_id;
+      const sharedOwned =
+        isSharedDeliveryTask(ledger, target) &&
+        request.actor.role === "group" &&
+        ledger.groups.find((item) => item.id === target.group_id)?.agent_thread_id ===
+          request.actor.thread_id;
       requireCondition(
-        (request.actor.role === "task" || mainOwned) && taskExecutionState(target) === "running",
+        (request.actor.role === "task" || mainOwned || sharedOwned) && taskExecutionState(target) === "running",
         "FORBIDDEN",
         "The running task owner updates its atoms",
         3,

package/toolkit/skills/multi-task-flow/lib/package-source.ts

@@ -5,8 +5,8 @@ export const digest = value => createHash('sha256').update(value).digest('hex');
 export function copySkillSources(root, output, { dependencies = false } = {}) {
   const manifest = JSON.parse(readFileSync(join(root, 'skills/source-manifest.json'), 'utf8'));
   const files = new Map();
-  const copy = (path, expected) => {
-    const source = resolve(root, path);
+  const copy = (path, expected, sourcePath = path) => {
+    const source = resolve(root, sourcePath);
     if (!path.startsWith('skills/') || !source.startsWith(resolve(root, 'skills') + '/')) throw new Error('Unsafe source resource: ' + path);
     const stat = lstatSync(source);
     if (!stat.isFile() || stat.isSymbolicLink() || realpathSync(source) !== source || (!path.includes('/node_modules/') && stat.nlink !== 1)) throw new Error('Unsafe source resource: ' + path);
@@ -15,9 +15,9 @@ export function copySkillSources(root, output, { dependencies = false } = {}) {
     const target = join(output, path); mkdirSync(dirname(target), { recursive: true, mode: 0o700 }); cpSync(source, target);
     files.set(path, sha256);
   };
-  for (const file of [...manifest.files, ...(manifest.additions ?? [])]) copy(file.path, file.installedSha256);
+  for (const file of [...manifest.files, ...(manifest.additions ?? [])]) copy(file.path, file.installedSha256, file.sourcePath ?? file.path);
   for (const path of ['skills/source-manifest.json', 'skills/catalog.json']) copy(path);
-  for (const name of ['index.html','app.js','app.css']) copy('skills/multi-task-flow/dist/' + name);
+  for (const name of ['index.html','app.js','app.css']) copy('skills/multi-task-flow/dist/' + name, undefined, 'skills/multi-task-flow-runtime/dist/' + name);
   if (dependencies) {
     const walk = path => {
       for (const entry of readdirSync(join(root, path), { withFileTypes: true })) {
@@ -26,7 +26,7 @@ export function copySkillSources(root, output, { dependencies = false } = {}) {
         if (entry.isDirectory()) walk(child); else copy(child);
       }
     };
-    for (const path of ['skills/node_modules', 'skills/multi-task-flow/node_modules']) {
+    for (const path of ['skills/node_modules', 'skills/multi-task-flow-runtime/node_modules']) {
       if (!existsSync(join(root, path))) throw new Error('Prepared dependency directory missing: ' + path);
       walk(path);
     }

package/toolkit/skills/multi-task-flow/lib/schema.ts

@@ -384,7 +384,7 @@ export const task = z
       .nullable()
       .default(null),
     delivery_policy: z
-      .enum(["parent_pr", "child_pr", "evidence", "none"])
+      .enum(["parent_pr", "child_pr", "shared_delivery_unit", "evidence", "none"])
       .nullable()
       .default(null),
     superseded_by_task_id: nullableText.default(null),
@@ -772,7 +772,7 @@ const taskExecutionPolicyDeclaration = z
       .enum(["main_owned", "delivery_owned", "task_agent", "none"])
       .nullable(),
     delivery_policy: z
-      .enum(["parent_pr", "child_pr", "evidence", "none"])
+      .enum(["parent_pr", "child_pr", "shared_delivery_unit", "evidence", "none"])
       .nullable(),
   })
   .strict();
@@ -820,6 +820,8 @@ export function taskExecutionPolicyIssues(
   if (owner === "main" && delivery === "child_pr") issues.push({ code: "TASK_EXECUTION_POLICY_CONFLICT", message: "Main Agent 不得拥有 child PR" });
   if (owner === "delivery_agent" && delivery === "child_pr") issues.push({ code: "TASK_EXECUTION_POLICY_CONFLICT", message: "交付 Agent 不得拥有 child PR" });
   if (owner === "task_agent" && delivery === "parent_pr") issues.push({ code: "TASK_EXECUTION_POLICY_CONFLICT", message: "Task Agent 不得拥有 parent PR" });
+  if (delivery === "shared_delivery_unit" && owner !== "delivery_agent") issues.push({ code: "TASK_EXECUTION_POLICY_CONFLICT", message: "共享交付任务必须由交付 Agent 持有" });
+  if (delivery === "shared_delivery_unit" && conversation !== "delivery_owned") issues.push({ code: "TASK_EXECUTION_POLICY_CONFLICT", message: "共享交付任务必须复用交付单元对话" });
   if (conversation === "none" && ["child_pr", "evidence"].includes(delivery)) issues.push({ code: "TASK_EXECUTION_POLICY_CONFLICT", message: "无对话任务不能声明 child PR 或验证证据" });
   return issues;
 }
@@ -846,6 +848,82 @@ export function validateTaskExecutionPolicies(tasks: readonly Task[], requireCom
 export function isContributionKind(kind: Task["kind"]): boolean {
   return kind === "contribution" || kind === "development";
 }
+
+export type DeliveryTopology = "shared_delivery" | "multi_task_integration" | "none";
+
+export function deliveryTopologyForGroup(
+  tasks: readonly Pick<Task, "group_id" | "kind" | "disposition">[],
+  groupId: string,
+): DeliveryTopology {
+  const count = tasks.filter(
+    (task) =>
+      task.group_id === groupId &&
+      task.disposition === "active" &&
+      isContributionKind(task.kind),
+  ).length;
+  return count === 0
+    ? "none"
+    : count === 1
+      ? "shared_delivery"
+      : "multi_task_integration";
+}
+
+/**
+ * Validate the execution policy derived from the main Agent's approved grouping.
+ * The grouping itself is a planning decision; this function only checks that the
+ * resulting one-task/multi-task topology is represented consistently at runtime.
+ */
+export function validateDeliveryTopologies(
+  tasks: readonly Task[],
+  requireComplete = false,
+): void {
+  const groupIds = new Set(
+    tasks
+      .filter((task) => task.disposition === "active" && isContributionKind(task.kind))
+      .map((task) => task.group_id),
+  );
+  for (const groupId of groupIds) {
+    const topology = deliveryTopologyForGroup(tasks, groupId);
+    const contributionTasks = tasks.filter(
+      (task) =>
+        task.group_id === groupId &&
+        task.disposition === "active" &&
+        isContributionKind(task.kind),
+    );
+    if (!requireComplete) {
+      if (contributionTasks.some((task) => task.delivery_policy === "shared_delivery_unit"))
+        requireCondition(
+          topology === "shared_delivery",
+          "DELIVERY_TOPOLOGY_CONFLICT",
+          `Delivery unit ${groupId} can use shared delivery only with one contribution task`,
+          3,
+        );
+      continue;
+    }
+    for (const task of contributionTasks) {
+      if (topology === "shared_delivery") {
+        requireCondition(
+          task.execution_owner === "delivery_agent" &&
+            task.conversation_policy === "delivery_owned" &&
+            task.delivery_policy === "shared_delivery_unit",
+          "DELIVERY_TOPOLOGY_CONFLICT",
+          `Task ${task.id} must use the delivery-unit conversation and shared PR topology`,
+          3,
+        );
+      } else {
+        requireCondition(
+          task.execution_owner === "task_agent" &&
+            task.conversation_policy === "task_agent" &&
+            task.delivery_policy === "child_pr",
+          "DELIVERY_TOPOLOGY_CONFLICT",
+          `Task ${task.id} must use an independent Task Agent and child PR in a multi-task delivery unit`,
+          3,
+        );
+      }
+    }
+  }
+}
+
 export function isCanonicalTaskKind(kind: Task["kind"]): boolean {
   return ["contribution", "release", "deployment", "verification"].includes(kind);
 }
@@ -2121,6 +2199,8 @@ export function validateLedger(value: unknown): Ledger {
     }
     for (const task of parsed.tasks.filter((item) => isContributionKind(item.kind))) {
       requireCondition(taskPrBinding.safeParse(task.pr).success, "ATOMIC_CONTRACT_REQUIRED", "Contract-3 contribution Task PR must use TaskPrBinding", 3);
+      if (task.pr?.state === "shared_delivery_unit")
+        requireCondition(task.pr.delivery_unit_id === task.group_id, "DELIVERY_TOPOLOGY_CONFLICT", "Shared task PR binding must reference its delivery unit", 3);
     }
   }
   for (const collection of [

package/toolkit/skills/multi-task-flow/lib/service-pages.ts

@@ -8,26 +8,6 @@ export function viewerPage(
 
 const runPathPattern = /^\/runs\/[A-Za-z0-9][A-Za-z0-9_.-]{0,127}\/$/;
 const viewIdPattern = /^[A-Za-z0-9][A-Za-z0-9_.-]{0,127}$/;
-const viewParamValidators: Record<string, (value: string) => boolean> = {
-  tab: (value) => /^(graph|atomic|planned|actual)$/.test(value),
-  graph: (value) => /^(aggregate|atomic)$/.test(value),
-  layout: (value) => /^(board|grid)$/.test(value),
-  q: (value) => value.length <= 200 && !/[\u0000-\u001f\u007f]/.test(value),
-  group: (value) => viewIdPattern.test(value),
-  state: (value) => viewIdPattern.test(value),
-  kind: (value) => viewIdPattern.test(value),
-  plan: (value) => viewIdPattern.test(value),
-  selected: (value) => /^(task|group|milestone):[A-Za-z0-9][A-Za-z0-9_.-]{0,127}$/.test(value),
-  detail: (value) => value === "1" || value === "true",
-  zoom: (value) => {
-    const zoom = Number(value);
-    return Number.isFinite(zoom) && zoom >= 0.2 && zoom <= 2.5;
-  },
-  plannedStart: (value) => value.length <= 64 && !Number.isNaN(Date.parse(value)),
-  plannedEnd: (value) => value.length <= 64 && !Number.isNaN(Date.parse(value)),
-  actualStart: (value) => value.length <= 64 && !Number.isNaN(Date.parse(value)),
-  actualEnd: (value) => value.length <= 64 && !Number.isNaN(Date.parse(value)),
-};
 const maxTimelineSpanMs = 10_000 * 365.25 * 24 * 60 * 60 * 1000;
 
 export type ViewerTarget = { target: string; ticket: string | null };
@@ -50,15 +30,10 @@ export function parseViewerTarget(
     if (ticketValues.length > 1 || (ticketValues.length > 0 && !allowTicket)) return null;
     const ticket = ticketValues[0] ?? null;
     if (ticket !== null && (ticket.length > 100 || /[\u0000-\u001f\u007f]/.test(ticket))) return null;
-    let selected = false;
-    let detail = false;
     for (const [key, parameter] of url.searchParams) {
       if (key === "ticket") continue;
-      if (home || /[\u0000-\u001f\u007f]/.test(parameter) || !viewParamValidators[key] || url.searchParams.getAll(key).length !== 1 || !viewParamValidators[key]!(parameter)) return null;
-      if (key === "selected") selected = true;
-      if (key === "detail") detail = true;
+      if (home || /[\u0000-\u001f\u007f]/.test(key) || /[\u0000-\u001f\u007f]/.test(parameter)) return null;
     }
-    if (detail && !selected) return null;
     for (const [start, end] of [["plannedStart", "plannedEnd"], ["actualStart", "actualEnd"]] as const) {
       const startValue = url.searchParams.get(start);
       const endValue = url.searchParams.get(end);