@quolu/lattice 0.12.34 → 0.13.0

package/src/todo-gantt-html.mjs

@@ -3,7 +3,7 @@ import { createHash } from 'node:crypto';
 import { serializeJsonForScript } from './todo-markdown-renderer.mjs';
 import { renderTodoGanttSvg, TODO_GANTT_STATUS_PRESENTATION } from './todo-gantt-svg.mjs';
 
-export const TODO_GANTT_RENDERER_VERSION = 'lattice.todo_gantt_renderer.v16';
+export const TODO_GANTT_RENDERER_VERSION = 'lattice.todo_gantt_renderer.v17';
 export const TODO_GANTT_PROSE_MAX_BYTES = 8 * 1024 * 1024;
 export const TODO_GANTT_HTML_MAX_BYTES = 24 * 1024 * 1024;
 
@@ -214,6 +214,74 @@ function renderPhaseProgress(readModel) {
   return `<section class="phase-overview"><h2>Phase進捗</h2><p>${guidance}</p>${liveList}${settledList}</section>`;
 }
 
+/**
+ * 図の外が語るための独立性要約を、plan単位の投影から引ける形へ畳む（ADR 0129 Decision 3）。
+ */
+function summarizeIndependence(layout) {
+  if (layout.independence === null) return null;
+  const byPlan = new Map(layout.independence.plans.map((plan) => [plan.plan_key, plan]));
+  return {
+    plans: layout.independence.plans,
+    byPlan,
+    verifiedTaskCount: layout.independence.plans
+      .reduce((total, plan) => total + plan.verified_task_count, 0),
+    unknownTaskCount: layout.independence.plans
+      .reduce((total, plan) => total + plan.unknown_task_ids.length, 0),
+    serializePairCount: layout.independence.plans
+      .reduce((total, plan) => total + plan.serialize_pairs.length, 0),
+  };
+}
+
+/** 記録が無いときだけADR 0063の既定をそのまま述べる。 */
+function dispatchBasis(summary) {
+  if (summary === null) {
+    return 'ready frontier全件が既定です。一部だけを直列着手する場合は理由が必要です。';
+  }
+  const parts = [`検証済み並列 ${summary.verifiedTaskCount}工程`];
+  if (summary.serializePairCount > 0) parts.push(`要直列 ${summary.serializePairCount}組`);
+  if (summary.unknownTaskCount > 0) parts.push(`未検査 ${summary.unknownTaskCount}工程`);
+  return `${parts.join('、')}。未検査は依存線が無くても並列可の根拠になりません。`;
+}
+
+const SEVERABILITY_LABEL = Object.freeze({
+  code_seam: 'コードの分割で並列化しうる',
+  serial: '共有状態のため直列必須',
+});
+
+/** 個別ToDoについて、競合相手と切断可能性を言葉で示す。 */
+function renderIndependenceNote(ref, node, summary) {
+  if (summary === null || node === undefined) return '';
+  const plan = summary.byPlan.get(ref.plan_key);
+  if (plan === undefined) return '';
+  const taskId = ref.task_id;
+  const state = node.visibility.independence;
+  if (state === null) return '';
+  if (state === 'verified') {
+    return '<p class="readiness-note"><strong>並列可否:</strong> 独立検証済です。記録時点の宣言境界では他のready工程と干渉しません。</p>';
+  }
+  if (state === 'unknown') {
+    return '<p class="readiness-note"><strong>並列可否:</strong> 未検査です。競合が無いのではなく、まだ判定していません。</p>';
+  }
+  const pairs = [
+    ...plan.serialize_pairs
+      .filter((pair) => pair.task_ids.includes(taskId))
+      .map((pair) => ({
+        other: pair.task_ids.find((id) => id !== taskId),
+        severability: pair.severability,
+        detail: pair.detail,
+      })),
+    ...plan.conflicts_with_active
+      .filter((entry) => entry.ready_task_id === taskId)
+      .map((entry) => ({
+        other: `${entry.active_task_id}（作業中）`,
+        severability: entry.severability,
+        detail: entry.detail,
+      })),
+  ];
+  const items = pairs.map((pair) => `<li>${escapeHtmlText(pair.other)} — ${escapeHtmlText(SEVERABILITY_LABEL[pair.severability] ?? pair.severability)}（資源 ${escapeHtmlText(pair.detail)}）</li>`).join('');
+  return `<p class="readiness-note"><strong>並列可否:</strong> 要直列です。</p><ul class="independence-conflicts">${items}</ul>`;
+}
+
 function renderRightPane(sections, layout, presentation, readModel) {
   const lookup = presentationLookup(presentation);
   const sectionByKey = new Map(sections.map((section) => [refKey(section.ref), section]));
@@ -242,11 +310,17 @@ function renderRightPane(sections, layout, presentation, readModel) {
   for (const section of sections) counts[section.state.status] += 1;
   const active = sections.filter((section) => section.state.status === 'in-progress');
   const ready = layout.nodes.filter((node) => node.visibility.next_ready);
-  const dispatchSummary = ready.length > 1
-    ? `<p class="readiness-note"><strong>同時dispatch推奨:</strong> ${ready.length}工程。ready frontier全件が既定です。一部だけを直列着手する場合は理由が必要です。</p>`
+  const independenceSummary = summarizeIndependence(layout);
+  const readyHeadline = ready.length > 1
+    ? `<p class="readiness-note"><strong>同時dispatch推奨:</strong> ${ready.length}工程。${escapeHtmlText(dispatchBasis(independenceSummary))}</p>`
     : ready.length === 1
       ? '<p class="readiness-note"><strong>着手候補:</strong> 1工程です。</p>'
       : '<p class="readiness-note">現在のready frontierは空です。</p>';
+  // ready件数によらず、記録があるなら内訳を述べる。1件の時だけ黙ると、
+  // その1件が未検査でも「候補が1つある」としか伝わらない。
+  const independenceNote = independenceSummary === null || ready.length > 1 ? ''
+    : `<p class="readiness-note"><strong>並列可否:</strong> ${escapeHtmlText(dispatchBasis(independenceSummary))}</p>`;
+  const dispatchSummary = `${readyHeadline}${independenceNote}`;
   const activeLinks = active.length === 0 ? '<p>作業中の工程はありません。</p>'
     : `<ul class="active-list">${active.map((section) => `<li><button type="button" data-select-node-key="${escapeHtmlAttribute(refKey(section.ref))}">${escapeHtmlText(taskReference(section, lookup))} — ${escapeHtmlText(section.task.title)}</button></li>`).join('')}</ul>`;
   const overview = `<section class="right-overview" data-right-panel="overview"><h1>工程を選択してください</h1><p>左の依存工程図から工程を選ぶと、題名・状態・前提・後続を表示します。</p><div class="status-summary"><span>☐ 未着手 ${counts.pending}</span><span>▶ 作業中 ${counts['in-progress']}</span><span>✅ 完了 ${counts.done}</span><span>⛔ ブロック中 ${counts.blocked}</span></div>${dispatchSummary}${renderPhaseProgress(readModel)}<h2>作業中</h2>${activeLinks}</section>`;
@@ -265,12 +339,13 @@ function renderRightPane(sections, layout, presentation, readModel) {
       ? `元plan: ${sourceRef}${sourceLine} — 行対応を確認済み`
       : `元plan: ${sourceRef}${sourceLine} — 行対応を確認できないため、本文位置との対応は表示していません`;
     const readiness = node?.visibility.next_ready
-      ? `<p class="readiness-note">ready frontierの一員です。${ready.length > 1 ? '他のready工程と同時dispatchするのが既定です。subsetだけを選ぶ場合は理由を記録してください。' : '現在の唯一の着手候補です。'}</p>`
+      ? `<p class="readiness-note">ready frontierの一員です。${ready.length > 1 ? '他のready工程と同時着手できるかは下の並列可否で判断してください。' : '現在の唯一の着手候補です。'}</p>`
       : incoming.get(key).length === 0 ? '<p class="readiness-note">登録済みの前提工程はありません。図だけではdispatch可否を判定しません。</p>' : '';
+    const independenceNote = renderIndependenceNote(section.ref, node, independenceSummary);
     // Say it plainly when the reader will not find this ToDo on the diagram.
     const foldedNote = !folds.has(key) ? ''
       : '<p class="fold-note">完走済みのため図には描いていません。図に出すには <code>lattice todo gantt --scope all</code> を実行してください。</p>';
-    return `<article class="task-detail" data-detail-key="${escapeHtmlAttribute(key)}" hidden><header><span class="detail-status status-${escapeHtmlAttribute(section.state.status)}">${escapeHtmlText(status.mark)} ${escapeHtmlText(status.label)}</span><span class="detail-reference">${escapeHtmlText(taskReference(section, lookup))}</span></header><h1>${escapeHtmlText(section.task.title)}</h1><p class="detail-category"><strong>カテゴリ:</strong> ${escapeHtmlText(category)}</p>${categoryDescription}<p><strong>正規ID:</strong> <code>${escapeHtmlText(`${section.ref.plan_key}/${section.task.task_id}`)}</code></p>${blockedReason}${readiness}${foldedNote}<section><h2>前提工程</h2>${renderRelationList(incoming.get(key), sectionByKey, lookup, '登録済みの前提工程はありません。', folds)}</section><section><h2>後続工程</h2>${renderRelationList(outgoing.get(key), sectionByKey, lookup, '登録済みの後続工程はありません。', folds)}</section><p class="anchor-status">${escapeHtmlText(anchorText)}</p><details class="task-diagnostics"><summary>開発者向け診断</summary><dl><dt>canonical ref</dt><dd><code>${escapeHtmlText(`${section.ref.project_id}/${section.ref.plan_key}/${section.task.task_id}`)}</code></dd><dt>anchor</dt><dd>${escapeHtmlText(section.anchorOutcome.anchored ? 'verified' : section.anchorOutcome.reason)}</dd></dl></details></article>`;
+    return `<article class="task-detail" data-detail-key="${escapeHtmlAttribute(key)}" hidden><header><span class="detail-status status-${escapeHtmlAttribute(section.state.status)}">${escapeHtmlText(status.mark)} ${escapeHtmlText(status.label)}</span><span class="detail-reference">${escapeHtmlText(taskReference(section, lookup))}</span></header><h1>${escapeHtmlText(section.task.title)}</h1><p class="detail-category"><strong>カテゴリ:</strong> ${escapeHtmlText(category)}</p>${categoryDescription}<p><strong>正規ID:</strong> <code>${escapeHtmlText(`${section.ref.plan_key}/${section.task.task_id}`)}</code></p>${blockedReason}${readiness}${independenceNote}${foldedNote}<section><h2>前提工程</h2>${renderRelationList(incoming.get(key), sectionByKey, lookup, '登録済みの前提工程はありません。', folds)}</section><section><h2>後続工程</h2>${renderRelationList(outgoing.get(key), sectionByKey, lookup, '登録済みの後続工程はありません。', folds)}</section><p class="anchor-status">${escapeHtmlText(anchorText)}</p><details class="task-diagnostics"><summary>開発者向け診断</summary><dl><dt>canonical ref</dt><dd><code>${escapeHtmlText(`${section.ref.project_id}/${section.ref.plan_key}/${section.task.task_id}`)}</code></dd><dt>anchor</dt><dd>${escapeHtmlText(section.anchorOutcome.anchored ? 'verified' : section.anchorOutcome.reason)}</dd></dl></details></article>`;
   }).join('');
   const taskIndex = renderTaskIndex(sections, lookup, folds, planActivity(readModel));
   return `<div class="right-toolbar"><button type="button" data-show-overview>概要</button><button type="button" data-show-selected hidden>選択工程へ戻る</button><button type="button" data-show-task-index>全工程一覧</button></div><div class="right-content">${overview}<div data-right-panel="details" hidden>${details}</div><section class="task-index" data-right-panel="task-index" hidden><h1>全工程</h1><p>Latticeに登録された全工程を現在の状態とともに表示しています。planは動いているものを最終活動の新しい順で上に、完走したものを古い順で下にまとめ、plan内は登録順です。</p>${taskIndex}</section></div>`;
@@ -291,7 +366,13 @@ function renderDiagramLegend(presentation, layout = null, expandable = false) {
     : expandable
       ? '<p class="fold-note">後続に作業中・未着手が残っていない完了工程は図から外しています。生きた工程とその直接の前提工程は必ず描きます。上のバッジを押すと外した工程も含めて描きます。総数・進捗・最長依存鎖は外す前の全工程で数えています。</p>'
       : '<p class="fold-note">後続に作業中・未着手が残っていない完了工程は図から外しています。生きた工程とその直接の前提工程は必ず描きます。外した工程は右の「全工程」から辿れ、図に出すには <code>lattice todo gantt --scope all</code> を実行してください。総数・進捗・最長依存鎖は外す前の全工程で数えています。</p>';
-  return `<div class="diagram-legend" aria-label="工程図の凡例"><span>${statusMarkup('pending', ' 未着手')}</span><span>${statusMarkup('in-progress', ' 作業中')}</span><span>${statusMarkup('done', ' 完了')}</span><span>${statusMarkup('blocked', ' ブロック中')}</span><span>破線枠: ready frontier（同時dispatch推奨）</span><span>太線: 構造上の最長依存鎖</span><span>半円: 非接触の線交差</span><span>黒丸: 論理上の合流</span>${foldChip}${categoryDetails}${foldNote}<p>縦方向は時間ではなく、登録済み依存関係による工程段階です。ready frontierは全件同時dispatchが既定です。未登録の資源・host制約によりsubsetだけを選ぶ場合は理由を記録します。構造上の最長依存鎖は各工程を同じ重みとして数え、実時間・工数・納期を表しません。</p></div>`;
+  const independenceLegend = layout.independence === null ? ''
+    : '<span>∥ 独立検証済</span><span>⛓ 要直列</span><span>? 未検査</span>';
+  // 独立性の記録がある間は「全件同時dispatchが既定」と無条件に述べない（ADR 0129 Decision 3）。
+  const dispatchSentence = layout.independence === null
+    ? 'ready frontierは全件同時dispatchが既定です。未登録の資源・host制約によりsubsetだけを選ぶ場合は理由を記録します。'
+    : '同時着手できるかはカードの並列可否で判断してください。未検査の工程は依存線が無くても並列可の根拠になりません。';
+  return `<div class="diagram-legend" aria-label="工程図の凡例"><span>${statusMarkup('pending', ' 未着手')}</span><span>${statusMarkup('in-progress', ' 作業中')}</span><span>${statusMarkup('done', ' 完了')}</span><span>${statusMarkup('blocked', ' ブロック中')}</span><span>破線枠: ready frontier</span>${independenceLegend}<span>太線: 構造上の最長依存鎖</span><span>半円: 非接触の線交差</span><span>黒丸: 論理上の合流</span>${foldChip}${categoryDetails}${foldNote}<p>縦方向は時間ではなく、登録済み依存関係による工程段階です。${dispatchSentence}構造上の最長依存鎖は各工程を同じ重みとして数え、実時間・工数・納期を表しません。</p></div>`;
 }
 
 const CSS = `
@@ -370,6 +451,11 @@ button.fold-chip[aria-expanded="true"]{border-color:var(--text-primary)}
 .status-blocked .node-surface{fill:var(--surface-1);stroke:var(--critical);stroke-width:2}
 .status-blocked .status-mark{fill:var(--critical)}
 .next-ready-node .node-surface{stroke:var(--accent);stroke-width:2;stroke-dasharray:4 3}
+/* 独立性は記号と色で示す。枠線はstatusとready frontierが使い切っている（ADR 0129）。 */
+.independence-badge{font-size:10px;font-weight:600;letter-spacing:0.02em}
+.independence-verified .independence-badge{fill:var(--good)}
+.independence-conflict .independence-badge{fill:var(--critical)}
+.independence-unknown .independence-badge{fill:var(--text-secondary)}
 .todo-node:focus .node-surface,.selected-node .node-surface{stroke:var(--text-primary);stroke-width:2.5}
 .dependency-edge .edge-route{fill:none;stroke:var(--text-secondary);stroke-width:1.5;stroke-linejoin:round;opacity:.4}
 .dependency-edge .edge-arrow{fill:var(--text-secondary);opacity:.7}

package/src/todo-gantt-layout.mjs

@@ -376,6 +376,68 @@ function crossingCount(edges, wave, transversePosition) {
   return total;
 }
 
+/**
+ * plan別の独立性投影を、task refで引ける索引と図の外が語る要約へ畳む（ADR 0129 Decision 4）。
+ *
+ * 読み出しはasync I/Oとgit実行を伴うためCLI層が行い、ここへは値として渡る。
+ * layoutは同期pureのままに保つ。
+ */
+function normalizeIndependence(value, nodesByKey) {
+  if (value === null || value === undefined) return { stateByKey: new Map(), summary: null };
+  if (!Array.isArray(value)) {
+    fail('TODO_LAYOUT_INVALID_INPUT', 'independence must be an array of plan projections');
+  }
+  const stateByKey = new Map();
+  const plans = [];
+  for (const projection of value) {
+    if (!plain(projection) || typeof projection.plan_key !== 'string'
+      || typeof projection.coverage !== 'string' || !plain(projection.frontier)) {
+      fail('TODO_LAYOUT_INVALID_INPUT', 'independence entry must carry plan_key, coverage and frontier');
+    }
+    const { plan_key: planKey, frontier } = projection;
+    const mark = (taskId, state) => {
+      const key = refKey({
+        project_id: projection.project_id, plan_key: planKey, task_id: taskId,
+      });
+      // 図に無いtaskへ状態を付けない。layoutのready判定と投影のready判定が食い違えば、
+      // 静かに無視するのでなくここで露見させる。
+      if (!nodesByKey.has(key)) {
+        fail('TODO_LAYOUT_INDEPENDENCE_DRIFT', 'independence references a task absent from layout', {
+          plan_key: planKey, task_id: taskId,
+        });
+      }
+      stateByKey.set(key, state);
+    };
+    for (const group of frontier.parallel_groups ?? []) {
+      for (const taskId of group.task_ids) mark(taskId, 'verified');
+    }
+    for (const pair of frontier.serialize_pairs ?? []) {
+      for (const taskId of pair.task_ids) mark(taskId, 'conflict');
+    }
+    for (const entry of frontier.conflicts_with_active ?? []) mark(entry.ready_task_id, 'conflict');
+    for (const entry of frontier.unknown ?? []) mark(entry.task_id, 'unknown');
+    plans.push({
+      plan_key: planKey,
+      coverage: projection.coverage,
+      verified_group_count: (frontier.parallel_groups ?? []).length,
+      verified_task_count: (frontier.parallel_groups ?? [])
+        .reduce((total, group) => total + group.task_ids.length, 0),
+      serialize_pairs: (frontier.serialize_pairs ?? []).map((pair) => ({
+        task_ids: [...pair.task_ids], type: pair.type, detail: pair.detail,
+        kind: pair.kind ?? null, severability: pair.severability ?? 'serial',
+      })),
+      conflicts_with_active: (frontier.conflicts_with_active ?? []).map((entry) => ({
+        ready_task_id: entry.ready_task_id, active_task_id: entry.active_task_id,
+        type: entry.type, detail: entry.detail,
+        kind: entry.kind ?? null, severability: entry.severability ?? 'serial',
+      })),
+      unknown_task_ids: (frontier.unknown ?? []).map(({ task_id: taskId }) => taskId).sort(compareText),
+    });
+  }
+  plans.sort((left, right) => compareText(left.plan_key, right.plan_key));
+  return { stateByKey, summary: { plans } };
+}
+
 export function layoutTodoGantt(readModel, chainProjection, options = {}) {
   const scope = options.scope ?? 'live';
   if (!TODO_GANTT_SCOPES.includes(scope)) {
@@ -404,6 +466,7 @@ export function layoutTodoGantt(readModel, chainProjection, options = {}) {
     return key;
   }));
   const readyKeys = readyTaskKeys(readModel, full.nodes, full.nodesByKey, fullWaves.incoming);
+  const independence = normalizeIndependence(options.independence ?? null, full.nodesByKey);
 
   // Only the geometry stage below sees the narrowed graph.
   const projected = scope === 'all'
@@ -575,6 +638,9 @@ export function layoutTodoGantt(readModel, chainProjection, options = {}) {
         longest_dependency_chain: longestNodeKeys.has(node.key),
         active: node.status === 'in-progress', next_ready: readyKeys.has(node.key),
         selected: false,
+        // 記録が語らないtaskはnull。「独立と分かっている」と「まだ何も言えない」を
+        // 図の上でも同じ顔にしない（ADR 0129 Decision 1）。
+        independence: independence.stateByKey.get(node.key) ?? null,
       },
       geometry,
     };
@@ -699,7 +765,7 @@ export function layoutTodoGantt(readModel, chainProjection, options = {}) {
     laneMap.get(key).task_count += 1;
   }
   return {
-    schema: 'lattice.todo_gantt_layout.v1',
+    schema: 'lattice.todo_gantt_layout.v2',
     assumptions: { logical_time: 'dependency_wave', duration_estimation: false, lane_is_presentation_only: true },
     sweep: { method: 'stable_median', rounds: SWEEP_ROUNDS, tie_break: 'previous_position_then_task_ref' },
     bounds: {
@@ -709,6 +775,8 @@ export function layoutTodoGantt(readModel, chainProjection, options = {}) {
       wave_count: layers.length,
     },
     nodes: projectedNodes,
+    // 図の外が語るための投影。カードはバッジで状態だけを示し、相手と理由は右ペインが持つ。
+    independence: independence.summary,
     edges: projectedEdges,
     // Every dependency in the plan, before folding contracted any of them away.
     // The diagram draws `edges`; anything that describes a ToDo in words — the

package/src/todo-gantt-svg.mjs

@@ -14,6 +14,19 @@ export const TODO_GANTT_STATUS_PRESENTATION = Object.freeze({
   done: Object.freeze({ mark: '✅', label: '完了' }),
 });
 
+/**
+ * 独立性バッジの記号と和名（ADR 0129 Decision 1）。
+ *
+ * 枠線はstatusとready frontierが使い切っているため、カード内の記号と色で示す。
+ * 記録が語らないtaskにはバッジを出さない——「独立と分かっている」と「まだ何も言えない」を
+ * 同じ見た目にしない。
+ */
+export const TODO_GANTT_INDEPENDENCE_PRESENTATION = Object.freeze({
+  verified: Object.freeze({ mark: '∥', label: '独立検証済', class: 'independence-verified' }),
+  conflict: Object.freeze({ mark: '⛓', label: '要直列', class: 'independence-conflict' }),
+  unknown: Object.freeze({ mark: '?', label: '未検査', class: 'independence-unknown' }),
+});
+
 export function escapeSvgText(value) {
   return String(value).replaceAll('&', '&amp;').replaceAll('<', '&lt;').replaceAll('>', '&gt;');
 }
@@ -145,6 +158,8 @@ function renderNode(node, maps) {
   if (node.visibility.active) classes.push('active-node');
   if (node.visibility.next_ready) classes.push('next-ready-node');
   if (node.visibility.selected) classes.push('selected-node');
+  const independence = TODO_GANTT_INDEPENDENCE_PRESENTATION[node.visibility.independence] ?? null;
+  if (independence !== null) classes.push(independence.class);
   const key = nodeKey(node.ref);
   const nodeLaneKey = laneKey(node.ref.plan_key, node.lane);
   const status = TODO_GANTT_STATUS_PRESENTATION[node.status] ?? { mark: '?', label: '状態不明' };
@@ -156,15 +171,19 @@ function renderNode(node, maps) {
   const spokenReference = taskNumber === undefined
     ? `ID ${node.ref.task_id}` : `工程${taskNumber.display_number}`;
   const readyLabel = node.visibility.next_ready ? '。ready frontierの同時dispatch候補' : '';
+  const independenceLabel = independence === null ? '' : `。並列可否は${independence.label}`;
   const identity = `正規ID ${node.ref.plan_key}/${node.ref.task_id}`;
-  const ariaLabel = `${spokenReference}。${status.label}。${laneLabel}。${node.title}。${identity}${readyLabel}`;
+  const ariaLabel = `${spokenReference}。${status.label}。${laneLabel}。${node.title}。${identity}${readyLabel}${independenceLabel}`;
+  // カードの右上へ寄せる。node_width／node_heightは変えないので配線規約に影響しない。
+  const independenceBadge = independence === null ? ''
+    : `<text class="independence-badge" x="${x + width - 10}" y="${y + 20}" text-anchor="end">${escapeSvgText(`${independence.mark} ${independence.label}`)}</text>`;
   const statusBar = node.status === 'in-progress'
     ? `<line class="status-bar" x1="${x + 5}" y1="${y + 6}" x2="${x + 5}" y2="${y + height - 6}"></line>` : '';
   const titleLines = wrapLabel(node.title);
   const titleMarkup = titleLines.map((line, index) => `<tspan x="${x + 10}" dy="${index === 0 ? 0 : 17}" class="node-title-line">${escapeSvgText(line)}</tspan>`).join('');
   const taskNumberAttributes = taskNumber === undefined ? ''
     : ` data-task-number="${escapeSvgAttribute(taskNumber.display_number)}" data-task-number-normalized="${escapeSvgAttribute(taskNumber.normalized_number)}" data-task-number-globally-unique="${taskNumber.globally_unique ? 'true' : 'false'}"`;
-  return `<g class="${classes.join(' ')}" data-node-key="${escapeSvgAttribute(key)}" data-lane-key="${escapeSvgAttribute(nodeLaneKey)}" data-project-id="${escapeSvgAttribute(node.ref.project_id)}" data-plan-key="${escapeSvgAttribute(node.ref.plan_key)}" data-task-id="${escapeSvgAttribute(node.ref.task_id)}"${taskNumberAttributes} tabindex="0" role="button" aria-selected="${node.visibility.selected ? 'true' : 'false'}" aria-label="${escapeSvgAttribute(ariaLabel)}"><rect class="node-surface" x="${x}" y="${y}" width="${width}" height="${height}" rx="4"></rect>${statusBar}<text class="status-mark" x="${x + 10}" y="${y + 21}">${escapeSvgText(status.mark)}</text><text class="node-meta" x="${x + 34}" y="${y + 20}">${escapeSvgText(`${status.label} · ${visibleReference}`)}</text><text class="node-title" x="${x + 10}" y="${y + 42}">${titleMarkup}</text><title>${escapeSvgText(`${spokenReference}: ${node.title} — ${status.label} — ${laneLabel} — ${identity}`)}</title></g>`;
+  return `<g class="${classes.join(' ')}" data-node-key="${escapeSvgAttribute(key)}" data-lane-key="${escapeSvgAttribute(nodeLaneKey)}" data-project-id="${escapeSvgAttribute(node.ref.project_id)}" data-plan-key="${escapeSvgAttribute(node.ref.plan_key)}" data-task-id="${escapeSvgAttribute(node.ref.task_id)}"${taskNumberAttributes} tabindex="0" role="button" aria-selected="${node.visibility.selected ? 'true' : 'false'}" aria-label="${escapeSvgAttribute(ariaLabel)}"><rect class="node-surface" x="${x}" y="${y}" width="${width}" height="${height}" rx="4"></rect>${statusBar}<text class="status-mark" x="${x + 10}" y="${y + 21}">${escapeSvgText(status.mark)}</text><text class="node-meta" x="${x + 34}" y="${y + 20}">${escapeSvgText(`${status.label} · ${visibleReference}`)}</text>${independenceBadge}<text class="node-title" x="${x + 10}" y="${y + 42}">${titleMarkup}</text><title>${escapeSvgText(`${spokenReference}: ${node.title} — ${status.label} — ${laneLabel} — ${identity}`)}</title></g>`;
 }
 
 function summaryLabel(value, maximum = 34) {
@@ -217,9 +236,9 @@ function renderTodoSummary(layout, maps) {
 }
 
 export function renderTodoGanttSvg(layout, options = {}) {
-  if (layout === null || typeof layout !== 'object' || layout.schema !== 'lattice.todo_gantt_layout.v1'
+  if (layout === null || typeof layout !== 'object' || layout.schema !== 'lattice.todo_gantt_layout.v2'
     || !Array.isArray(layout.nodes) || !Array.isArray(layout.edges)) {
-    throw new TypeError('layout must be lattice.todo_gantt_layout.v1');
+    throw new TypeError('layout must be lattice.todo_gantt_layout.v2');
   }
   const maps = presentationMaps(options.presentation);
   const summary = renderTodoSummary(layout, maps);