@loomhelm/multi-task-flow 0.2.8 → 0.2.10

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(),

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

@@ -32,6 +32,8 @@ import {
   validateLedger,
   validateSchedulablePlan,
   validatePlan,
+  deliveryTopologyForGroup,
+  validateDeliveryTopologies,
   defaultGroupAtoms,
   executionProfile,
   recommendedExecutionProfile,
@@ -192,6 +194,15 @@ 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],
@@ -240,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) {
@@ -254,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(
@@ -1595,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",
@@ -2401,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);
@@ -2816,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);
@@ -2829,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": {
@@ -2840,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"],
@@ -2926,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")
@@ -2956,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,
@@ -3044,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);
@@ -3079,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);

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

@@ -141,6 +141,21 @@ function deliveryGateDiagnostics(
   return diagnostics;
 }
 
+function taskPrProjection(
+  task: Ledger["tasks"][number],
+  owner: Ledger["groups"][number] | undefined,
+): { url: string | null } | null {
+  if (!task.pr || typeof task.pr !== "object" || !("state" in task.pr))
+    return task.pr && "url" in task.pr ? { url: task.pr.url ?? null } : null;
+  if (task.pr.state === "shared_delivery_unit") {
+    const deliveryPr = owner?.pr;
+    if (deliveryPr && typeof deliveryPr === "object" && "state" in deliveryPr && "pr" in deliveryPr)
+      return { url: deliveryPr.pr.url ?? null };
+    return owner?.parent_pr ? { url: owner.parent_pr.url ?? null } : null;
+  }
+  return "pr" in task.pr ? { url: task.pr.pr.url ?? null } : null;
+}
+
 function formalExecutionWarnings(ledger: Ledger): Record<string, unknown>[] {
   return ledger.groups.flatMap((group) => {
     if (group.state !== "active" || group.coordination_execution.state !== "running")
@@ -898,6 +913,7 @@ export function buildView(
       const derivedStatus = deriveBusinessStatus(canonicalAtomicNodes, { kind: "task", task_id: task.id }, milestoneEvaluations);
       return {
         ...task,
+        pr: taskPrProjection(task, owner),
         ...(() => {
           const gateDiagnostics = owner && isContributionKind(task.kind) ? deliveryGateDiagnostics(ledger, owner, task) : [];
           return { gateDiagnostics };

package/toolkit/skills/multi-task-flow/references/shared-viewer.md

@@ -2,7 +2,7 @@
 
 The formal root is `~/.local/share/multi-task-flow/`: `config/`, `data/runs/`, `releases/`, `state/`, `logs/`. `CODEX_HOME` and the invoking worktree do not select a formal instance. `MULTI_TASK_FLOW_PROFILE=test|development` requires an absolute `MULTI_TASK_FLOW_ROOT`, distinct from the formal root. Isolated profiles derive separate launchd labels, port scopes and registry roots. `TASK_ORCHESTRATION_DATA_ROOT` is an explicit ledger-only fixture override; never use it to create a second formal authority.
 
-All commands use `service.ts <command> --input -`, consuming one JSON object. Normal usage:
+All commands use `multi-task-flow service <command> --input -`, consuming one JSON object. Normal usage:
 
 - `ensure`, `renew`, `release`: `{"run_id":"example","thread_id":"main-thread","api_version":1}`.
 - `status`, `doctor`: `{}`. Inspect configured identity and runtime before remediation.

package/toolkit/skills/multi-task-flow/scripts/check-client-skills.ts

@@ -8,8 +8,9 @@ const path = resolve(root, 'skills/source-manifest.json');
 const manifest = JSON.parse(readFileSync(path, 'utf8'));
 const hash = data => createHash('sha256').update(data).digest('hex');
 const refresh = process.argv.includes('--write');
-const additional = [...JSON.parse(readFileSync(resolve(root, 'skills/support-manifest.json'), 'utf8')), 'skills/bin/modules/core/runtime.ts', 'skills/bin/package.json', 'skills/multi-task-flow/tests/service-release.test.ts', 'skills/multi-task-flow/lib/notification-delivery.ts', 'skills/multi-task-flow/tests/notification-delivery.test.ts', 'skills/multi-task-flow/lib/conversation-archive.ts', 'skills/multi-task-flow/lib/task-runtime.ts', 'skills/multi-task-flow/web/task-state.ts', 'skills/multi-task-flow/web/conversation-control.ts', 'skills/multi-task-flow/tests/ui/conversation-control.test.ts', 'skills/multi-task-flow/tests/task-runtime.test.ts'];
-if (refresh) manifest.additions = additional.map(path => ({ path, installedSha256: hash(readFileSync(resolve(root, path))) }));
+const additional = [...JSON.parse(readFileSync(resolve(root, 'skills/support-manifest.json'), 'utf8')), 'skills/bin/modules/core/runtime.ts', 'skills/bin/package.json', 'skills/multi-task-flow/tests/service-release.test.ts', 'skills/multi-task-flow/lib/notification-delivery.ts', 'skills/multi-task-flow/tests/notification-delivery.test.ts', 'skills/multi-task-flow/lib/conversation-archive.ts', 'skills/multi-task-flow/lib/task-runtime.ts', 'skills/multi-task-flow/web/task-state.ts', 'skills/multi-task-flow/web/conversation-control.ts', 'skills/multi-task-flow/tests/ui/conversation-control.test.ts', 'skills/multi-task-flow/tests/task-runtime.test.ts', 'skills/multi-task-flow/lib/atomic-orchestration.ts', 'skills/multi-task-flow/tests/atomic-orchestration-schema.test.ts', 'skills/multi-task-flow/tests/task-kind.test.ts', 'skills/multi-task-flow/web/atomic-graph-view.tsx'];
+const sourcePath = file => file.sourcePath ?? file.path;
+if (refresh) manifest.additions = additional.map(path => { const source = path.startsWith('skills/multi-task-flow/') ? 'skills/multi-task-flow-runtime/' + path.slice('skills/multi-task-flow/'.length) : path; return { path, sourcePath: source, installedSha256: hash(readFileSync(resolve(root, source))) }; });
 const findings = [];
 const gitRoot = spawnSync('git', ['rev-parse', '--show-toplevel'], { cwd:root, encoding:'utf8' });
 if (gitRoot.status === 0 && gitRoot.stdout.trim() === root) {
@@ -18,6 +19,7 @@ if (gitRoot.status === 0 && gitRoot.stdout.trim() === root) {
   const covered = new Set([...manifest.files,...(manifest.additions ?? [])].map(file => file.path));
   for (const file of tracked.stdout.split('\0').filter(Boolean)) {
     if (/\.(?:js|mjs|cjs)$/.test(file)) findings.push('owned-source-must-be-typescript:'+file);
+    if (file.startsWith('skills/multi-task-flow-runtime/')) continue;
     if (file.startsWith('skills/') && !covered.has(file) && !['skills/source-manifest.json','skills/catalog.json'].includes(file)) findings.push('unlisted:'+file);
   }
 }
@@ -27,8 +29,9 @@ for (const excluded of manifest.exclusions ?? []) {
   if (manifest.files.some(file => file.source.startsWith(excluded.sourcePrefix)) || existsSync(resolve(root, installed))) findings.push(`excluded-resource:${installed}`);
 }
 for (const file of [...manifest.files, ...(manifest.additions ?? [])]) {
-  const target = resolve(root, file.path);
-  if (!file.path.startsWith('skills/') || !target.startsWith(root + '/') || !existsSync(target)) { findings.push(`missing:${file.path}`); continue; }
+  const source = resolve(root, sourcePath(file));
+  if (!file.path.startsWith('skills/') || !source.startsWith(root + '/') || !existsSync(source)) { findings.push(`missing:${file.path}`); continue; }
+  const target = source;
   const stat = lstatSync(target);
   if (!stat.isFile() || stat.isSymbolicLink() || stat.nlink !== 1) { findings.push(`unsafe:${file.path}`); continue; }
   const digest = hash(readFileSync(target));

package/toolkit/skills/multi-task-flow/scripts/check-skills-installation.ts

@@ -12,6 +12,11 @@ export function checkSkillsInstallation(root, { probe = false } = {}) {
   const inventory = resolve(root, 'skills/source-manifest.json');
   if (!existsSync(inventory)) return { ok: false, code: 'SKILLS_INVENTORY_MISSING', root, missing: ['skills/source-manifest.json'] };
   const manifest = JSON.parse(readFileSync(inventory, 'utf8'));
+  const localPath = resource => {
+    const target = resolve(root, resource.path);
+    if (existsSync(target)) return resource.path;
+    return resource.sourcePath ?? resource.path;
+  };
   const contained = path => {
     const file = resolve(root, path);
     if (!existsSync(file)) return false;
@@ -19,14 +24,15 @@ export function checkSkillsInstallation(root, { probe = false } = {}) {
     return stat.isFile() && !stat.isSymbolicLink() && stat.nlink === 1 && realpathSync(file) === file && realpathSync(file).startsWith(realpathSync(resolve(root, 'skills')) + '/');
   };
   const missing = [...manifest.files, ...(manifest.additions ?? [])]
-    .map(file => file.path).filter(path => !path.startsWith('skills/') || path.split('/').includes('..') || !contained(path));
-  const modified = [...manifest.files, ...(manifest.additions ?? [])].filter(file => !missing.includes(file.path) && createHash("sha256").update(readFileSync(resolve(root,file.path))).digest("hex") !== file.installedSha256).map(file => file.path);
+    .map(file => localPath(file)).filter(path => !path.startsWith('skills/') || path.split('/').includes('..') || !contained(path));
+  const modified = [...manifest.files, ...(manifest.additions ?? [])].filter(file => { const path = localPath(file); return !missing.includes(path) && createHash("sha256").update(readFileSync(resolve(root,path))).digest("hex") !== file.installedSha256; }).map(file => file.path);
   const escapedImports = [];
   for (const file of [...manifest.files, ...(manifest.additions ?? [])]) {
-    if (!/\.(ts|mjs)$/.test(file.path) || !file.path.startsWith('skills/') || file.path.split('/').includes('..') || !contained(file.path)) continue;
-    const text = readFileSync(resolve(root, file.path), 'utf8');
+    const path = localPath(file);
+    if (!/\.(ts|mjs)$/.test(path) || !path.startsWith('skills/') || path.split('/').includes('..') || !contained(path)) continue;
+    const text = readFileSync(resolve(root, path), 'utf8');
     for (const match of text.matchAll(/(?:from\s*|import\s*\(?\s*)["'](\.[^"']+)["']/g)) {
-      const target = resolve(root, dirname(file.path), match[1]);
+      const target = resolve(root, dirname(path), match[1]);
       if (!target.startsWith(resolve(root, 'skills') + '/')) escapedImports.push({ file: file.path, import: match[1] });
     }
   }
@@ -46,7 +52,7 @@ export function checkSkillsInstallation(root, { probe = false } = {}) {
   const dependencies = { status:!sourceComplete ? 'not_checked' : dependencyMissing.length ? 'missing' : 'prepared', missing:dependencyMissing };
   const entrypoints = { status: dependencyMissing.length ? 'blocked' : 'not_checked', results: [] };
   if (probe && sourceComplete && runtime.available && dependencyMissing.length === 0) {
-    for (const [script, args] of [['skills/bin/plan-cli.sh',['--help']], ['skills/dot-codex-development/scripts/context.ts',['--help']], ['skills/multi-task-flow/scripts/orchestrate.ts',['view','--input','-']]]) {
+    for (const [script, args] of [['skills/bin/plan-cli.sh',['--help']], ['skills/dot-codex-development/scripts/context.ts',['--help']], ['skills/multi-task-flow-runtime/scripts/orchestrate.ts',['view','--input','-']]]) {
       const result = spawnSync(script.endsWith('.sh') ? '/bin/bash' : process.execPath, [...(script.endsWith('.sh') ? ['-p'] : ['--no-install']), resolve(root,script), ...args], { cwd:root, env: { ...process.env, BUN_RUNTIME_TRANSPILER_CACHE_PATH:'0' }, input:'{}', encoding:'utf8', timeout:30000 });
       const expected = script.endsWith('orchestrate.ts') ? 2 : 0;
       entrypoints.results.push({script, code:result.status, ok:!result.error && result.status === expected, error: result.error ? String(result.error) : result.status === expected ? undefined : result.stderr});
@@ -69,11 +75,11 @@ if (process.argv[1] && import.meta.url === pathToFileURL(resolve(process.argv[1]
   const probe = process.argv.includes('--probe');
   const args = process.argv.slice(2).filter(arg => arg !== '--probe');
   if (args.length !== 0 && (args.length !== 2 || args[0] !== '--root')) {
-    console.error('Usage: bun skills/multi-task-flow/scripts/check-skills-installation.ts [--root PATH] [--probe]');
+    console.error('Usage: bun skills/multi-task-flow-runtime/scripts/check-skills-installation.ts [--root PATH] [--probe]');
     process.exitCode = 2;
   } else {
     try {
-      const report = checkSkillsInstallation(args[1] ?? resolve(import.meta.dirname, '../..'), {probe});
+      const report = checkSkillsInstallation(args[1] ?? resolve(import.meta.dirname, '../../..'), {probe});
       console.log(JSON.stringify(report));
       process.exitCode = report.ok ? 0 : 1;
     } catch (error) {

package/toolkit/skills/multi-task-flow/scripts/import-client-skills.ts

@@ -7,7 +7,7 @@ import { dirname, resolve } from 'node:path';
 
 const source = process.argv[2];
 const commit = process.argv[3] ?? 'HEAD';
-if (!source) throw new Error('Usage: bun skills/multi-task-flow/scripts/import-client-skills.ts SOURCE_REPOSITORY [SOURCE_REF]');
+if (!source) throw new Error('Usage: bun skills/multi-task-flow-runtime/scripts/import-client-skills.ts SOURCE_REPOSITORY [SOURCE_REF]');
 const git = (...args) => execFileSync('git', ['-C', source, ...args], { maxBuffer: 32 * 1024 * 1024 });
 const tree = git('ls-tree', '-rz', commit, 'skills', 'bin', 'docs').toString().split('\0').filter(Boolean);
 const files = [];

package/toolkit/skills/multi-task-flow/scripts/package-client-skills.ts

@@ -60,8 +60,8 @@ const outputs = new Map<string, { path: string; sha256: string }>();
 function record(path: string, contents: Uint8Array): void {
   outputs.set(path, { path, sha256: createHash('sha256').update(contents).digest('hex') });
 }
-function copy(path: string, expected: string | undefined, dependency = false): void {
-  const source = resolve(root, path);
+function copy(path: string, expected: string | undefined, dependency = false, sourcePath = path): void {
+  const source = resolve(root, sourcePath);
   if (!path.startsWith('skills/') || !source.startsWith(resolve(root, 'skills') + '/')) throw new Error('Unsafe toolkit resource path');
   const stat = lstatSync(source);
   if (!stat.isFile() || stat.isSymbolicLink() || (!dependency && stat.nlink !== 1) || realpathSync(source) !== source) throw new Error('Unsafe toolkit resource: ' + path);
@@ -104,10 +104,10 @@ function copyPackageManifest(): void {
   const packageManifest = { ...manifest, files, additions, packageOmissions };
   writeGenerated('skills/source-manifest.json', Buffer.from(JSON.stringify(packageManifest, null, 2) + '\n'));
 }
-for (const file of [...manifest.files, ...(manifest.additions ?? [])]) if (!packageOmissionPaths.has(file.path)) copy(file.path, file.installedSha256);
+for (const file of [...manifest.files, ...(manifest.additions ?? [])]) if (!packageOmissionPaths.has(file.path)) copy(file.path, file.installedSha256, false, file.sourcePath ?? file.path);
 copyPackageManifest();
 copy('skills/catalog.json');
-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, false, `skills/multi-task-flow-runtime/dist/${name}`);
 if (requireDependencies) validateInstalledDependencies();
 copyRootFile('AGENTS.md');
 const packageIdentityBase = {

package/toolkit/skills/multi-task-flow/scripts/test-viewer-source.ts

@@ -10,7 +10,7 @@ const temporary = realpathSync(mkdtempSync(join(tmpdir(), 'viewer-source-test-')
 const output = join(temporary, 'package');
 const env = { ...process.env, MULTI_TASK_FLOW_PROFILE:'test', MULTI_TASK_FLOW_ROOT:join(temporary,'state') };
 try {
-  const build=spawnSync(process.execPath,[join(root,'skills/multi-task-flow/scripts/build-service.ts'),'--output',output,'--service-version','0.0.0-test'],{cwd:temporary,env,encoding:'utf8',timeout:120000});
+  const build=spawnSync(process.execPath,[join(root,'skills/multi-task-flow-runtime/scripts/build-service.ts'),'--output',output,'--service-version','0.0.0-test'],{cwd:temporary,env,encoding:'utf8',timeout:120000});
   assert.equal(build.status,0,build.stderr);
   const manifest=JSON.parse(readFileSync(join(output,'manifest.json'),'utf8'));
   assert.equal(manifest.schema_version,2);

package/toolkit/skills/multi-task-flow/tests/atomic-orchestration-schema.test.ts

@@ -25,6 +25,11 @@ test("represents closed PRs without treating them as success", () => {
   expect(parsed.state).toBe("closed");
 });
 
+test("represents a singleton task by the delivery-unit PR binding", () => {
+  const parsed = taskPrBinding.parse({ state: "shared_delivery_unit", delivery_unit_id: "du-1" });
+  expect(parsed).toEqual({ state: "shared_delivery_unit", delivery_unit_id: "du-1" });
+});
+
 test("rejects cyclic atomic graphs and empty planned milestones", () => {
   const nodes = [
     { kind: "milestone", id: "m-1", title: "M1", state: "planned", scope: { kind: "delivery_unit", delivery_unit_id: "du-1" }, acceptance: [{ kind: "node_satisfied", node_id: "w-1" }] },

package/toolkit/skills/multi-task-flow/tests/browser/README.md

@@ -5,7 +5,7 @@ The agreed seam is the rendered mock example: click a task to open details and c
 Build the existing `demo:static` surface and use its current owned preview server. In the Codex in-app browser REPL, bind the preview tab and viewport capability, import the checked-in runner, then run it:
 
 ```js
-var regression = await import("file:///absolute/repo/skills/multi-task-flow/tests/browser/card-width-regression.ts");
+var regression = await import("file:///absolute/repo/skills/multi-task-flow-runtime/tests/browser/card-width-regression.ts");
 await regression.checkCardWidths(tab, viewport);
 ```