claude-dev-env 8.95.0 → 8.96.0

package/.agents/skills/correction/playbooks/fix.md

@@ -8,7 +8,7 @@ Use this playbook when this session lands the fix for the correction itself. One
 4. Search for an existing control: a rule, hook, lint, test, or skill that already names this mistake. A control that exists and still let the mistake through makes this a repeat.
 5. Choose the layer with [`correction-lens.md`](../../../../docs/rule-guides/correction-lens.md). When `Repeat` is `yes`, or step 4 found a control, go one layer above the one that failed.
 6. Land the control in the repository whose code, CI, or agents it guards, per the guide's "Where the control lands" section. When that repository is not in this session, add it. When it cannot be added, print the brief, name the missing repository, and stop.
-7. Prove the control. Show it fail on the mistake from the brief's `Evidence` line, then pass with the change, per [`falsify-before-green.md`](../../../../rules/falsify-before-green.md) and [`proof-before-pull-request.md`](../../../../docs/rule-guides/proof-before-pull-request.md). Without that proof, open no pull request.
-8. Open the pull request through `pr-lifecycle`. Put the brief, the layer, and both proof results in the body.
+7. Prove the control. Show it fail on the mistake from the brief's `Evidence` line, then pass with the change, per [`falsify-before-green.md`](../../../../rules/falsify-before-green.md) and [`proof-before-pull-request.md`](../../../../docs/rule-guides/proof-before-pull-request.md). Without that proof, open no pull request. When the control is a hook, read the correction instructions of the repository from step 6 as step 3 does. When they name an incident eval, add the incident as a case to that eval in the same pull request. Run the eval's compare against the base branch and keep the line that shows the case fails on the base and holds on the branch.
+8. Open the pull request through `pr-lifecycle`. Put the brief, the layer, and both proof results in the body. When step 7 added an incident case, also name its path and its compare line.
 
 **Reply:** the layer chosen, why each higher layer cannot hold the lesson, and the pull request link.

package/.agents/skills/correction/scripts/test_correction_task_card.py

@@ -140,3 +140,10 @@ def test_should_return_the_playbook_from_step_two() -> None:
     handed_off_steps = correction_task_card.handed_off_playbook_steps(FIX_PLAYBOOK_TEXT)
     assert handed_off_steps.startswith("2. ")
     assert "pull request link" in handed_off_steps
+
+
+def test_should_hand_off_the_incident_case_step_with_the_proof() -> None:
+    handed_off_steps = correction_task_card.handed_off_playbook_steps(FIX_PLAYBOOK_TEXT)
+    proof_step = handed_off_steps.split("\n7. ", 1)[1].split("\n8. ", 1)[0]
+    assert "incident eval" in proof_step
+    assert "same pull request" in proof_step

package/.agents/skills/pr-visual/README.md

@@ -10,6 +10,8 @@ python scripts/render.py SCENE.json --out RUN/visual.html --links-only
 python scripts/verify.py RUN/visual.html --out RUN/proof
 ```
 
+An issue URL captures a tracker epic, its sub-issues, and the pull requests their bodies link. Its scene renders in the same viewer, and each source opens the captured issue or pull request. The rendered scene draws every card in a state lane, grouped under its epic, and each card opens its own state diagram of what it fixes and how it is proven. `fixtures/tracker.scene.json` shows the shape.
+
 Flow diagrams, decision trees, dependency graphs, comparisons, bar charts, line charts, and scatter plots share the same source details. Numerical chart coordinates resolve JSON pointers against captured source files. The renderer does not supply an independent semantic code review.
 
 Try the synthetic fixture gallery from this directory:

package/.agents/skills/pr-visual/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: pr-visual
-description: Read a pull request's summary and code, trace the changed behavior, and return an interactive visual. Use for "visualize this PR", "draw this change", "PR visual", "chart this PR", "graph this change", or a PR URL with a request for a visual. Accept any accessible GitHub PR.
+description: Read a pull request's summary and code, trace the changed behavior, and return an interactive visual. Also draws a tracker epic's status from its issues and linked pull requests. Use for "visualize this PR", "draw this change", "PR visual", "chart this PR", "graph this change", a status catch-up on an epic, or a PR or issue URL with a request for a visual. Accept any accessible GitHub PR or issue.
 ---
 
 # PR visual
@@ -11,13 +11,15 @@ Turn a PR into a visual explanation of what its code changes. Return the display
 
 Accept a PR URL. Resolve a bare PR number only when the repository is known.
 
+Accept an issue URL for a status catch-up on an epic or tracker. The collector captures the issue, its sub-issues two levels deep, and the pull requests their bodies link. Draw that scene in this same viewer, batched with the scenes of the pull requests it names. Every pr-visual request renders through `assets/viewer.html`; a status report never moves to another page template. A tracker scene always draws every card inside its state chart. Set `board` in the scene: `lanes` run top to bottom in flow order, and each lane names one scene node. A lane with `progress` (`no_pull`, `open_pull`, `merged_pull`) takes every open tracker card in that state, grouped under its parent epic. A lane with `groups` takes cards that each cite a captured record and link inside the repository, such as done, skipped, or follow-up work listed in an epic body. Every node sits in exactly one lane. `strip` drops title prefixes, `titles` gives plain wording by issue number, and `exclude` leaves out issues that are not work. `steps` names the issue body sections each card shows as its own state diagram, such as `Today` and `Fix`, with a label and colour; the step marked `inline` also prints on the card. `wording` swaps words or whole sentences in that text for plain ones. A cited card carries its `steps` itself. Clicking a card opens its diagram in the side panel, with a link to the card on GitHub. `verify.py` checks the card count, that each title fits its card, that the first card in each lane opens a diagram with one box per step, and that board and diagram text is 16px or larger at 7:1 contrast.
+
 Read the description, changed code, relevant callers, and tests. Build an interactive diagram with short labels, visual drilldowns, source details, and a summary-to-code comparison.
 
 Use the current agent for interpretation. The collector and renderer run locally. The shell command alone does not review code. Complete the whole workflow when this skill is invoked.
 
 ## Workflow
 
-1. **Capture the PR.** Run `python <skill-root>/scripts/collect.py <PR-URL> --out <run-dir>/evidence`. It saves the PR description, open or closed state, base and head commits, changed paths, patches, and full base/head changed-file source. Use an authorized GitHub connector if gh is unavailable. Preserve the same snapshot fields. If capture fails or a patch is incomplete, fetch the missing source before interpretation. Do not invent a complete review from a partial diff.
+1. **Capture the PR or issue.** Run `python <skill-root>/scripts/collect.py <PR-or-issue-URL> --out <run-dir>/evidence`. An issue capture writes `issues/<n>.md`, `issues/<n>.json`, `pulls/<n>.json`, and `tracker.json` under `head/`; cite their lines, and chart `tracker.json` counts by JSON pointer. It saves the PR description, open or closed state, base and head commits, changed paths, patches, and full base/head changed-file source. Use an authorized GitHub connector if gh is unavailable. Preserve the same snapshot fields. If capture fails or a patch is incomplete, fetch the missing source before interpretation. Do not invent a complete review from a partial diff.
 2. **Trace the behavior.** Read the snapshot description and diff. Follow the code from its entry point to its output, including decisions, side effects, failure paths, and material callers. Fetch unchanged callers at the captured commit when needed. Read repository review instructions. Compare the summary with the code. Record material extra scope, contradictions, and limitations. Treat prose claims and past test reports as claims until supported by current source or observed execution.
 3. **Choose the format.** Read [the visual contract](references/visual-contract.md). Pick the structure the change needs. Use a state loop for a sampler, a decision tree for an admission gate, split lanes for two job paths, or an angle loop for capture. Keep the top dashboard to compact PR selectors. Embed quantitative charts inside the relevant flow-step cards and their expansions. Keep the review, charts, and evidence together on one Page. Use a chart when captured numerical data answers the question: bars for categories, lines for ordered observations, scatter for relationships. Read [format selection](references/formats.md). Keep the cream background, teal line icons, green progress paths, orange conditional paths, and generous spacing. Give every node a source-backed mini-diagram in a docked detail panel, related-step navigation, and collapsed exact explanation and sources. Keep the main map usable while the panel is open. Do not copy the shipping instructions into unrelated content.
 4. **Render the scene.** Write a scene JSON using [the scene contract](references/scene-contract.md). Attach immutable file-and-line evidence to every node. Render it with `python <skill-root>/scripts/render.py <scene.json> --out <run-dir>/visual.html`. For hosted display, add `--links-only` to omit full PR bodies and source excerpts while retaining the diagrams and immutable links. For a batch, pass multiple scene files to create a compact selector dashboard and flow reviews. Avoid a detached chart-demo gallery. Compare the generated diagram with the source once more. Fix misleading arrows, labels, implied guarantees, or omitted branches before continuing.
@@ -56,7 +58,7 @@ Return the displayed visual and a short link to the saved result. Mention a mate
 | `scripts/visual_config/` | Shared constants |
 | `assets/` | Standalone viewer and icon symbol definitions |
 | `references/` | Scene, visual, and format contracts |
-| `fixtures/` | Synthetic flow, bar, line, and scatter examples |
+| `fixtures/` | Synthetic flow, bar, line, scatter, and tracker examples |
 | `scripts/test_render.py` | Evidence and numerical validation cases |
 | `scripts/test_collect.py` | Capture consistency and stale-head cases |
 | `scripts/test_metrics.py` | Embedded-chart provenance and passive literal extraction |

package/.agents/skills/pr-visual/assets/viewer.html

@@ -36,6 +36,13 @@
 [data-pr-visual] .detail-map .mini-label{font-size:12px;font-weight:700}[data-pr-visual] .detail-map .mini-edge{font-size:10px;fill:#64746e}
 [data-pr-visual] .detail-jumps{display:grid;grid-template-columns:repeat(3,minmax(0,1fr));gap:7px;margin-bottom:18px}[data-pr-visual] .detail-jumps button{display:flex;flex-direction:column;align-items:center;gap:7px;background:#f2f5ea;border:1px solid #879b8e;border-radius:6px;padding:9px 4px;color:#17353f;font-size:11px;line-height:1.3}[data-pr-visual] .detail-jumps button span{color:#17353f}[data-pr-visual] .detail-jumps svg{width:24px;height:24px}
 [data-pr-visual] .exact-source{border-top:1px solid #d5dcd2;padding-top:14px;margin:18px 0}[data-pr-visual] .exact-source summary{font-size:13px;font-weight:700;color:#52695f;cursor:pointer}
+[data-pr-visual] .band{fill:#fffef8;stroke:#d5dcd2;stroke-width:1.5}[data-pr-visual] .band.lime{fill:#f1f9db;stroke:#a4c357}[data-pr-visual] .band.orange{fill:#fcf1e4;stroke:#ca955e}[data-pr-visual] .band.green{fill:#eef5ea;stroke:#9db996}[data-pr-visual] .band.blue{fill:#e9f2f5;stroke:#8faeb9}
+[data-pr-visual] [data-card]{cursor:pointer;outline:none}[data-pr-visual] .card-chip{fill:#fffef8;stroke:#aabdac;stroke-width:1.5}[data-pr-visual] [data-card]:hover .card-chip,[data-pr-visual] [data-card]:focus .card-chip{stroke:#217757;stroke-width:3}
+[data-pr-visual] .drawer .card-state{font-size:16px;font-weight:700;color:#17353f;margin:0 0 14px}[data-pr-visual] .drawer .card-link{font-size:16px;font-weight:700;color:#17353f;margin:18px 0}
+[data-pr-visual] .card-step{fill:#fffef8;stroke:#aabdac;stroke-width:1.5}[data-pr-visual] .card-step.orange{fill:#fcf1e4;stroke:#ca955e}[data-pr-visual] .card-step.lime{fill:#f1f9db;stroke:#a4c357}[data-pr-visual] .card-step.blue{fill:#e9f2f5;stroke:#8faeb9}[data-pr-visual] .card-step.green{fill:#eef5ea;stroke:#9db996}
+[data-pr-visual] .card-flow .card-step-label{font-size:16px;font-weight:800;fill:#17353f}[data-pr-visual] .card-flow .card-step-text{font-size:16px;fill:#17353f}
+[data-pr-visual] .board .card-text{font-size:16px;font-weight:700;fill:#17353f}[data-pr-visual] .board .card-build,[data-pr-visual] .board .lane-sub{font-size:16px;fill:#17353f}[data-pr-visual] .board .card-note{font-size:16px;font-weight:700;fill:#17353f}[data-pr-visual] .board .board-group{font-size:18px;font-weight:800;fill:#17353f;text-decoration:underline}
+[data-pr-visual] .board .subtitle,[data-pr-visual] .board .micro,[data-pr-visual] .board .kicker,[data-pr-visual] .board .stamp,[data-pr-visual] .board .foot-label{font-size:16px;fill:#17353f}
 [data-pr-visual] .sr-only{position:absolute;width:1px;height:1px;overflow:hidden;clip:rect(0,0,0,0)}
 [data-pr-visual] button:focus-visible,[data-pr-visual] summary:focus-visible,[data-pr-visual] a:focus-visible{outline:3px solid #17353f;outline-offset:3px}
 [data-pr-visual] .toolbar button:focus-visible{outline-color:#d8f687}
@@ -49,7 +56,7 @@
 <script type="application/json" data-scenes>__SCENES__</script><script>
 (()=>{
 const root=document.currentScript.closest('[data-pr-visual]'),$=s=>root.querySelector(s),all=s=>[...root.querySelectorAll(s)],ns='http://www.w3.org/2000/svg';
-const scenes=JSON.parse($('[data-scenes]').textContent),icons=`__ICONS__`,prefix='prv-'+Math.random().toString(36).slice(2)+'-';
+const scenes=JSON.parse($('[data-scenes]').textContent),isIssue=s=>s.pr.kind==='issue',refName=s=>isIssue(s)?'Issue':'PR',icons=`__ICONS__`,prefix='prv-'+Math.random().toString(36).slice(2)+'-';
 const canvas=$('.canvas'),tabs=$('.tabs'),drawer=$('.drawer'),workspace=$('.workspace'),content=$('.content');let active=0,zoom=1,lastFocus;
 canvas.id=prefix+'diagram';drawer.id=prefix+'details';
 function el(tag,attrs={},text){const n=document.createElementNS(ns,tag);Object.entries(attrs).forEach(([k,v])=>{if(k==='href'&&v.startsWith('#'))v='#'+prefix+v.slice(1);if(k==='marker-end')v=v.replace('#','#'+prefix);n.setAttribute(k,String(v))});if(text!==undefined)n.textContent=text;return n}
@@ -102,9 +109,32 @@ function showPanel(title,flow,paragraphs,sources=[],raw,related=[],trigger,chart
  if(related.length){content.append(dom('h3','Related steps'));const jumps=dom('div',undefined,'detail-jumps');related.forEach(n=>{const b=dom('button');b.dataset.detailTarget=n.id;const icon=el('svg',{viewBox:'0 0 48 48','aria-hidden':true});icon.append(el('use',{href:'#'+n.icon,width:48,height:48,class:'icon'}));b.append(icon,dom('span',n.label.join(' ')));b.onclick=()=>showNode(n.id);jumps.append(b)});content.append(jumps)}
  const exact=dom('details',undefined,'exact-source');exact.append(dom('summary','Explanation and sources'));paragraphs.forEach(v=>exact.append(dom('p',v)));
  sources.forEach(s=>{const a=dom('a',`${s.path} \u00b7 lines ${s.line}\u2013${s.end||s.line}`);a.href=s.url;a.target='_blank';a.rel='noopener noreferrer';exact.append(a);if(s.excerpt)exact.append(dom('pre',s.excerpt))});
- if(raw)exact.append(dom('h3','PR description at capture'),dom('pre',raw));content.append(exact);content.scrollTop=0;drawer.hidden=false;workspace.classList.add('open');$('.close').focus({preventScroll:true})}
+ if(raw)exact.append(dom('h3',`${refName(scenes[active])} description at capture`),dom('pre',raw));content.append(exact);content.scrollTop=0;drawer.hidden=false;workspace.classList.add('open');$('.close').focus({preventScroll:true})}
 function showNode(id){const s=scenes[active],n=s.nodes.find(n=>n.id===id);resetSelection();const trigger=all('[data-node]').find(g=>g.dataset.node===id);trigger.setAttribute('aria-expanded','true');const neighbors=new Set(s.edges.filter(e=>e.from===id||e.to===id).flatMap(e=>[e.from,e.to]));neighbors.delete(id);showPanel(n.label.join(' '),n.drilldown,n.detail,n.sources,undefined,s.nodes.filter(n=>neighbors.has(n.id)),trigger,n.chart)}
 $('.close').onclick=()=>close();root.addEventListener('keydown',e=>{if(e.key==='Escape'&&!drawer.hidden){e.preventDefault();close()}});
+function drawNode(svg,n,subClass='micro',subGap=19){const g=el('g',{class:'node','data-node':n.id,tabindex:0,role:'button','aria-expanded':'false','aria-controls':drawer.id,'aria-label':n.label.join(' ')});g.append(el('title',{},'Open code evidence'));if(n.chart){stepCard(g,n)}else if(n.kind==='decision'){g.append(el('path',{d:`M${n.x} ${n.y-54} L${n.x+62} ${n.y} L${n.x} ${n.y+54} L${n.x-62} ${n.y} Z`,class:'diamond'}));lines(g,n.x,n.y-3,n.label,'node-label','middle',21)}else{g.append(el('circle',{cx:n.x,cy:n.y,r:n.r||43,class:`disc ${n.kind||''}`}));g.append(el('use',{href:`#${n.icon}`,x:n.x-22,y:n.y-22,width:44,height:44,class:'icon'}));lines(g,n.x,n.y+70,n.label,'node-label','middle')}if(n.sub&&!n.chart)lines(g,n.x,n.y+(n.label.length>1?121:99),n.sub,subClass,'middle',subGap);const show=()=>showNode(n.id);g.onclick=show;g.onkeydown=e=>{if(e.key==='Enter'||e.key===' '){e.preventDefault();show()}};svg.append(g)}
+const measure=document.createElement('canvas').getContext('2d');
+function wrap(value,width,font){measure.font=font;const out=[];let line='';value.split(' ').forEach(w=>{const next=line?`${line} ${w}`:w;if(line&&measure.measureText(next).width>width){out.push(line);line=w}else line=next});if(line)out.push(line);return out}
+function link(href){return el('a',{href,target:'_blank',rel:'noopener noreferrer'})}
+function drawBoard(svg,s){
+ const rail=150,left=300,right=1404,gap=14,pad=14,step=22,columns=2,width=(right-left-gap*(columns-1))/columns;let y=184,previous;
+ s.board.lanes.forEach(lane=>{const n={...s.nodes.find(n=>n.id===lane.node),x:rail,y:y+72},band=el('rect',{x:24,y,width:1392,rx:18,class:`band ${n.kind||''}`});svg.append(band);
+  const nodeBottom=n.y+(n.sub?(n.label.length>1?121:99)+(n.sub.length-1)*21:70+(n.label.length-1)*23)+12;let cy=y+20;
+  lane.groups.forEach(g=>{const head=link(g.url);text(head,left,cy+20,`${g.title} \u00b7 ${g.cards.length}`,'board-group');svg.append(head);cy+=36;
+   for(let i=0;i<g.cards.length;i+=columns){const row=g.cards.slice(i,i+columns).map(card=>{const inline=(card.steps||[]).find(v=>v.inline);return {card,body:wrap(card.title,width-pad*2,'bold 16px Arial'),build:inline?wrap(`${inline.label}: ${inline.text}`,width-pad*2,'16px Arial'):[],note:card.note?wrap(card.note,width-pad*2,'bold 16px Arial'):[]}});const height=pad*2+Math.max(...row.map(r=>r.body.length+r.build.length+r.note.length))*step-4;
+    row.forEach((r,j)=>{const x=left+j*(width+gap),chip=el('g',{tabindex:0,role:'button','aria-label':`${r.card.title}. Open its details.`});chip.dataset.card=r.card.number||'cited';chip.append(el('title',{},'Open what this card builds'),el('rect',{x,y:cy,width,height,rx:8,class:'card-chip'}));let ty=cy+pad+14;lines(chip,x+pad,ty,r.body,'card-text','start',step);ty+=r.body.length*step;lines(chip,x+pad,ty,r.build,'card-build','start',step);ty+=r.build.length*step;lines(chip,x+pad,ty,r.note,'card-note','start',step);const show=()=>showCard(r.card,lane,chip);chip.onclick=show;chip.onkeydown=e=>{if(e.key==='Enter'||e.key===' '){e.preventDefault();show()}};svg.append(chip)});cy+=height+10}cy+=10});
+  const bottom=Math.max(cy,nodeBottom)+12;band.setAttribute('height',bottom-y);
+  if(previous!==undefined)svg.append(el('path',{d:`M${rail} ${previous} L${rail} ${n.y-54}`,class:'wire','marker-end':'url(#arrow)'}));
+  drawNode(svg,n,'lane-sub',21);previous=nodeBottom;y=bottom+16});
+ return y}
+function cardFlow(steps){const width=396,pad=14,step=22,flow=el('svg',{class:'card-flow',role:'img','aria-label':steps.map(v=>v.label).join(', then ')});let y=4;
+ steps.forEach((v,i)=>{const body=wrap(v.text,width-pad*2-4,'16px Arial'),height=pad*2+step+body.length*step;if(i)flow.append(el('path',{d:`M${width/2} ${y-30} L${width/2} ${y-4}`,class:'wire green','marker-end':'url(#arrowGreen)'}));
+  flow.append(el('rect',{x:2,y,width:width-4,height,rx:12,class:`card-step ${v.kind||''}`}));text(flow,pad+2,y+pad+15,v.label,'card-step-label');lines(flow,pad+2,y+pad+15+step,body,'card-step-text','start',step);y+=height+34});
+ flow.setAttribute('viewBox',`0 0 ${width} ${y-30}`);return flow}
+function showCard(card,lane,trigger){const s=scenes[active],state=s.nodes.find(n=>n.id===lane.node);lastFocus=trigger;resetSelection();content.replaceChildren();$('[data-detail-title]').textContent=card.title;
+ content.append(dom('p',[state.label.join(' '),card.note].filter(Boolean).join(' \u00b7 '),'card-state'),cardFlow(card.steps?.length?card.steps:[{label:'Card',text:card.title}]));
+ const a=dom('a',card.number?`Open issue ${card.number} on GitHub`:'Open it on GitHub','card-link');a.href=card.url;a.target='_blank';a.rel='noopener noreferrer';content.append(a);
+ content.scrollTop=0;drawer.hidden=false;workspace.classList.add('open');$('.close').focus({preventScroll:true})}
 function chartNode(svg,n,x,y,bar){
  const g=el('g',{class:'node','data-node':n.id,tabindex:0,role:'button','aria-expanded':'false','aria-controls':drawer.id,'aria-label':`${n.label.join(' ')}: ${n.values.y}`});
  g.append(el('title',{},`${n.label.join(' ')}: ${n.values.y}. Open source evidence.`));
@@ -126,21 +156,21 @@ function drawChart(svg,s){
  if(chart.kind==='line'){const sorted=[...points].sort((a,b)=>a.n.values.x-b.n.values.x);svg.append(el('path',{d:sorted.map((p,i)=>`${i?'L':'M'}${p.x} ${p.y}`).join(' '),class:'wire green'}))}
  points.forEach(p=>{const width=Math.min(150,(right-left)/points.length*.6),bar=isBar?el('rect',{x:p.x-width/2,y:Math.min(p.y,y(0)),width,height:Math.max(2,Math.abs(y(0)-p.y)),rx:5,class:'disc green'}):undefined;chartNode(svg,p.n,p.x,p.y,bar)})
 }
-function draw(index){close(false);active=index;const s=scenes[index];[...tabs.children].forEach((b,i)=>{b.setAttribute('aria-selected',i===index);b.tabIndex=i===index?0:-1});canvas.replaceChildren();const svg=el('svg',{viewBox:'0 0 1440 1020',role:'img','aria-label':`${s.title}. ${s.subtitle}`});const desc=el('desc',{},s.alt);svg.append(desc);const defs=el('defs');defs.innerHTML=icons.replace(/id="([^"]+)"/g,(_,id)=>`id="${prefix}${id}"`);svg.append(defs,el('rect',{width:1440,height:1020,fill:'#f6f5ef'}));text(svg,40,54,s.title,'title');text(svg,42,86,s.subtitle,'subtitle');text(svg,1398,49,`PR #${s.pr.number} \u00b7 ${s.pr.merged?'MERGED':s.pr.state==='closed'?'CLOSED':s.pr.draft?'DRAFT':'OPEN'}`,'kicker','end');
-text(svg,42,128,s.before,'micro');text(svg,42,155,s.after,'micro');text(svg,1398,128,`${s.pr.changed_files} CHANGED FILES`,'kicker','end');
-if(s.chart){drawChart(svg,s)}else{
+function draw(index){close(false);active=index;const s=scenes[index];[...tabs.children].forEach((b,i)=>{b.setAttribute('aria-selected',i===index);b.tabIndex=i===index?0:-1});canvas.replaceChildren();const svg=el('svg',{viewBox:'0 0 1440 1020',role:'img','aria-label':`${s.title}. ${s.subtitle}`});if(s.board)svg.classList.add('board');const desc=el('desc',{},s.alt);svg.append(desc);const defs=el('defs');defs.innerHTML=icons.replace(/id="([^"]+)"/g,(_,id)=>`id="${prefix}${id}"`);const backdrop=el('rect',{width:1440,height:1020,fill:'#f6f5ef'});svg.append(defs,backdrop);text(svg,40,54,s.title,'title');text(svg,42,86,s.subtitle,'subtitle');text(svg,1398,49,`${refName(s).toUpperCase()} #${s.pr.number} \u00b7 ${s.pr.merged?'MERGED':s.pr.state==='closed'?'CLOSED':s.pr.draft?'DRAFT':'OPEN'}`,'kicker','end');
+text(svg,42,128,s.before,'micro');text(svg,42,155,s.after,'micro');text(svg,1398,128,`${s.pr.changed_files} ${isIssue(s)?'TRACKED ISSUES':'CHANGED FILES'}`,'kicker','end');
+let footTop=835;if(s.chart){drawChart(svg,s)}else if(s.board){footTop=Math.max(835,drawBoard(svg,s)+10)}else{
 (s.groups||[]).forEach(g=>{svg.append(el('rect',{x:g.x,y:g.y,width:g.w,height:g.h,rx:20,class:'group'}));text(svg,g.x+g.w/2,g.y+27,g.label,'panel-label','middle')});
 const chartArrows=[];s.edges.forEach(e=>{const cls=e.kind||'',target=s.nodes.find(n=>n.id===e.to),path=el('path',{d:e.path,class:`wire ${cls}`});if(target.chart)chartArrows.push({path,target,cls});else path.setAttribute('marker-end',`url(#${prefix}${cls==='green'?'arrowGreen':cls==='orange'?'arrowOrange':'arrow'})`);svg.append(path);if(e.label)text(svg,e.x,e.y,e.label,`edge-label ${cls}`,'middle')});
-s.nodes.forEach(n=>{const g=el('g',{class:'node','data-node':n.id,tabindex:0,role:'button','aria-expanded':'false','aria-controls':drawer.id,'aria-label':n.label.join(' ')});g.append(el('title',{},'Open code evidence'));if(n.chart){stepCard(g,n)}else if(n.kind==='decision'){g.append(el('path',{d:`M${n.x} ${n.y-54} L${n.x+62} ${n.y} L${n.x} ${n.y+54} L${n.x-62} ${n.y} Z`,class:'diamond'}));lines(g,n.x,n.y-3,n.label,'node-label','middle',21)}else{g.append(el('circle',{cx:n.x,cy:n.y,r:n.r||43,class:`disc ${n.kind||''}`}));g.append(el('use',{href:`#${n.icon}`,x:n.x-22,y:n.y-22,width:44,height:44,class:'icon'}));lines(g,n.x,n.y+70,n.label,'node-label','middle')}if(n.sub&&!n.chart)lines(g,n.x,n.y+(n.label.length>1?121:99),n.sub,'micro','middle',19);const show=()=>showNode(n.id);g.onclick=show;g.onkeydown=e=>{if(e.key==='Enter'||e.key===' '){e.preventDefault();show()}};svg.append(g)});
+s.nodes.forEach(n=>drawNode(svg,n));
 chartArrows.forEach(({path,target,cls})=>cardArrow(svg,path,target,cls));
 }
-svg.append(el('line',{x1:40,y1:835,x2:1400,y2:835,stroke:'#d5dcd2','stroke-width':2}));s.notes.forEach((n,i)=>{const x=42+i*455;text(svg,x,876,n.label,'foot-label');lines(svg,x,907,n.text,'foot-text','start',23)});
-const when=new Date(s.pr.observed_at).toLocaleString('en-US',{timeZone:'America/New_York',month:'short',day:'numeric',hour:'numeric',minute:'2-digit'});text(svg,42,991,`Code reviewed \u00b7 ${when} ET \u00b7 ${s.pr.head.slice(0,10)}`,'stamp');text(svg,1398,991,'Click any symbol for code and source links.','micro','end');canvas.append(svg);const a=document.createElement('a');a.className='sr-only';a.href=s.pr.url;a.textContent=`Open PR ${s.pr.number}`;canvas.append(a);setZoom(1,true)}
+const shift=footTop-835,foot=el('g',{transform:`translate(0 ${shift})`}),height=1020+shift;svg.setAttribute('viewBox',`0 0 1440 ${height}`);backdrop.setAttribute('height',height);svg.append(foot);foot.append(el('line',{x1:40,y1:835,x2:1400,y2:835,stroke:'#d5dcd2','stroke-width':2}));s.notes.forEach((n,i)=>{const x=42+i*455;text(foot,x,876,n.label,'foot-label');lines(foot,x,907,n.text,'foot-text','start',23)});
+const when=new Date(s.pr.observed_at).toLocaleString('en-US',{timeZone:'America/New_York',month:'short',day:'numeric',hour:'numeric',minute:'2-digit'});text(foot,42,991,`${isIssue(s)?'Tracker read':'Code reviewed'} \u00b7 ${when} ET \u00b7 ${s.pr.head.slice(0,10)}`,'stamp');text(foot,1398,991,s.board?'Click a card to see what it builds.':'Click any symbol for code and source links.','micro','end');canvas.append(svg);const a=document.createElement('a');a.className='sr-only';a.href=s.pr.url;a.textContent=`Open ${refName(s)} ${s.pr.number}`;canvas.append(a);setZoom(1,true)}
 
-scenes.forEach((s,i)=>{const b=dom('button');b.dataset.reviewCard=String(i);b.append(dom('span',`PR #${s.pr.number}`,'tab-number'),dom('span',s.tab,'tab-name'));b.id=prefix+`tab-${i}`;b.role='tab';b.setAttribute('aria-controls',canvas.id);b.onclick=()=>draw(i);b.onkeydown=e=>{if(e.key==='ArrowRight'||e.key==='ArrowLeft'){e.preventDefault();const next=(i+(e.key==='ArrowRight'?1:scenes.length-1))%scenes.length;draw(next);tabs.children[next].focus()}};tabs.append(b)});
+scenes.forEach((s,i)=>{const b=dom('button');b.dataset.reviewCard=String(i);b.append(dom('span',`${refName(s)} #${s.pr.number}`,'tab-number'),dom('span',s.tab,'tab-name'));b.id=prefix+`tab-${i}`;b.role='tab';b.setAttribute('aria-controls',canvas.id);b.onclick=()=>draw(i);b.onkeydown=e=>{if(e.key==='ArrowRight'||e.key==='ArrowLeft'){e.preventDefault();const next=(i+(e.key==='ArrowRight'?1:scenes.length-1))%scenes.length;draw(next);tabs.children[next].focus()}};tabs.append(b)});
 function setZoom(value,fit=false){zoom=Math.max(.7,Math.min(2,value));canvas.style.width=fit?'':`${1440*zoom}px`;canvas.style.maxWidth=fit?'1540px':'none'}
 $('[data-plus]').onclick=()=>setZoom(zoom+.2);$('[data-minus]').onclick=()=>setZoom(zoom-.2);$('[data-fit]').onclick=()=>setZoom(1,true);
-$('[data-compare]').onclick=e=>showPanel('Summary vs code',{title:'Compare the claim with the implementation',steps:[{label:['PR','description'],icon:'list'},{label:['Trace the','code'],icon:'code'},{label:['Compare','behavior'],icon:'eye'}]},scenes[active].comparison,[],scenes[active].summary,scenes[active].nodes,e.currentTarget);
+$('[data-compare]').onclick=e=>showPanel('Summary vs code',{title:'Compare the claim with the implementation',steps:[{label:[refName(scenes[active]),'description'],icon:'list'},{label:['Trace the','code'],icon:'code'},{label:['Compare','behavior'],icon:'eye'}]},scenes[active].comparison,[],scenes[active].summary,scenes[active].nodes,e.currentTarget);
 $('[data-review]').onclick=e=>showPanel('Review notes',{title:'Scope and evidence',steps:[{label:['Captured','source'],icon:'ledger'},{label:['Reviewed','path'],icon:'branches'},{label:['Scope and','limitations'],icon:'shield'}]},scenes[active].review,[],undefined,scenes[active].nodes,e.currentTarget);
 draw(0);
 })();

package/.agents/skills/pr-visual/fixtures/tracker/head/issues/1.json

@@ -0,0 +1,31 @@
+{
+  "number": 1,
+  "title": "Synthetic tracker epic",
+  "state": "open",
+  "state_reason": null,
+  "html_url": "https://github.com/example/project/issues/1",
+  "created_at": "2026-10-18T12:00:00Z",
+  "updated_at": "2026-10-19T12:00:00Z",
+  "closed_at": null,
+  "labels": [],
+  "linked_pulls": [
+    {
+      "number": 3,
+      "title": "Synthetic fix",
+      "state": "closed",
+      "draft": false,
+      "merged_at": "2026-10-19T12:00:00Z",
+      "closed_at": "2026-10-19T12:00:00Z",
+      "updated_at": "2026-10-19T12:00:00Z",
+      "html_url": "https://github.com/example/project/pull/3"
+    }
+  ],
+  "progress": "merged_pull",
+  "counts": {
+    "open": 2,
+    "closed": 0,
+    "merged_pull": 1,
+    "open_pull": 0,
+    "no_pull": 1
+  }
+}

package/.agents/skills/pr-visual/fixtures/tracker/head/issues/1.md

@@ -0,0 +1,5 @@
+## Synthetic tracker epic
+
+Status: 2 tasks open, 1 with a pull request.
+
+- Task one ships in https://github.com/example/project/pull/3

package/.agents/skills/pr-visual/fixtures/tracker/head/issues/2.json

@@ -0,0 +1,31 @@
+{
+  "number": 2,
+  "title": "Synthetic task with a fix",
+  "state": "open",
+  "state_reason": null,
+  "html_url": "https://github.com/example/project/issues/2",
+  "created_at": "2026-10-18T12:00:00Z",
+  "updated_at": "2026-10-19T12:00:00Z",
+  "closed_at": null,
+  "labels": [],
+  "linked_pulls": [
+    {
+      "number": 3,
+      "title": "Synthetic fix",
+      "state": "closed",
+      "draft": false,
+      "merged_at": "2026-10-19T12:00:00Z",
+      "closed_at": "2026-10-19T12:00:00Z",
+      "updated_at": "2026-10-19T12:00:00Z",
+      "html_url": "https://github.com/example/project/pull/3"
+    }
+  ],
+  "progress": "merged_pull",
+  "counts": {
+    "open": 0,
+    "closed": 0,
+    "merged_pull": 0,
+    "open_pull": 0,
+    "no_pull": 0
+  }
+}

package/.agents/skills/pr-visual/fixtures/tracker/head/issues/2.md

@@ -0,0 +1 @@
+Synthetic task with a linked fix: https://github.com/example/project/pull/3

package/.agents/skills/pr-visual/fixtures/tracker/head/issues/4.json

@@ -0,0 +1,20 @@
+{
+  "number": 4,
+  "title": "Synthetic task without a fix",
+  "state": "open",
+  "state_reason": null,
+  "html_url": "https://github.com/example/project/issues/4",
+  "created_at": "2026-10-18T12:00:00Z",
+  "updated_at": "2026-10-19T12:00:00Z",
+  "closed_at": null,
+  "labels": [],
+  "linked_pulls": [],
+  "progress": "no_pull",
+  "counts": {
+    "open": 0,
+    "closed": 0,
+    "merged_pull": 0,
+    "open_pull": 0,
+    "no_pull": 0
+  }
+}

package/.agents/skills/pr-visual/fixtures/tracker/head/issues/4.md

@@ -0,0 +1,11 @@
+Synthetic task with no linked fix.
+
+## Today
+The synthetic task has no fix yet.
+
+## Fix
+Build the synthetic fix
+and link it.
+
+## Proof
+A synthetic test shows the fix.

package/.agents/skills/pr-visual/fixtures/tracker/head/pulls/3.json

@@ -0,0 +1,10 @@
+{
+  "number": 3,
+  "title": "Synthetic fix",
+  "state": "closed",
+  "draft": false,
+  "merged_at": "2026-10-19T12:00:00Z",
+  "closed_at": "2026-10-19T12:00:00Z",
+  "updated_at": "2026-10-19T12:00:00Z",
+  "html_url": "https://github.com/example/project/pull/3"
+}

package/.agents/skills/pr-visual/fixtures/tracker/head/tracker.json

@@ -0,0 +1,86 @@
+{
+  "number": 1,
+  "title": "Synthetic tracker epic",
+  "state": "open",
+  "state_reason": null,
+  "html_url": "https://github.com/example/project/issues/1",
+  "created_at": "2026-10-18T12:00:00Z",
+  "updated_at": "2026-10-19T12:00:00Z",
+  "closed_at": null,
+  "labels": [],
+  "linked_pulls": [
+    {
+      "number": 3,
+      "title": "Synthetic fix",
+      "state": "closed",
+      "draft": false,
+      "merged_at": "2026-10-19T12:00:00Z",
+      "closed_at": "2026-10-19T12:00:00Z",
+      "updated_at": "2026-10-19T12:00:00Z",
+      "html_url": "https://github.com/example/project/pull/3"
+    }
+  ],
+  "progress": "merged_pull",
+  "children": [
+    {
+      "number": 2,
+      "title": "Synthetic task with a fix",
+      "state": "open",
+      "state_reason": null,
+      "html_url": "https://github.com/example/project/issues/2",
+      "created_at": "2026-10-18T12:00:00Z",
+      "updated_at": "2026-10-19T12:00:00Z",
+      "closed_at": null,
+      "labels": [],
+      "linked_pulls": [
+        {
+          "number": 3,
+          "title": "Synthetic fix",
+          "state": "closed",
+          "draft": false,
+          "merged_at": "2026-10-19T12:00:00Z",
+          "closed_at": "2026-10-19T12:00:00Z",
+          "updated_at": "2026-10-19T12:00:00Z",
+          "html_url": "https://github.com/example/project/pull/3"
+        }
+      ],
+      "progress": "merged_pull",
+      "children": [],
+      "counts": {
+        "open": 0,
+        "closed": 0,
+        "merged_pull": 0,
+        "open_pull": 0,
+        "no_pull": 0
+      }
+    },
+    {
+      "number": 4,
+      "title": "Synthetic task without a fix",
+      "state": "open",
+      "state_reason": null,
+      "html_url": "https://github.com/example/project/issues/4",
+      "created_at": "2026-10-18T12:00:00Z",
+      "updated_at": "2026-10-19T12:00:00Z",
+      "closed_at": null,
+      "labels": [],
+      "linked_pulls": [],
+      "progress": "no_pull",
+      "children": [],
+      "counts": {
+        "open": 0,
+        "closed": 0,
+        "merged_pull": 0,
+        "open_pull": 0,
+        "no_pull": 0
+      }
+    }
+  ],
+  "counts": {
+    "open": 2,
+    "closed": 0,
+    "merged_pull": 1,
+    "open_pull": 0,
+    "no_pull": 1
+  }
+}

package/.agents/skills/pr-visual/fixtures/tracker/snapshot.json

@@ -0,0 +1,20 @@
+{
+  "schema_version": 1,
+  "kind": "issue",
+  "observed_at": "2026-10-19T12:00:00Z",
+  "repo": "example/project",
+  "number": 1,
+  "url": "https://github.com/example/project/issues/1",
+  "state": "open",
+  "head": "eeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
+  "base": null,
+  "diff_base": null,
+  "metadata": {
+    "title": "Synthetic tracker epic",
+    "body": "Synthetic tracker for rendering verification only.",
+    "draft": false,
+    "merged": false,
+    "tracked_issues": 3
+  },
+  "files": []
+}

package/.agents/skills/pr-visual/fixtures/tracker.scene.json

@@ -0,0 +1,90 @@
+{
+  "snapshot": "tracker/snapshot.json",
+  "tab": "Tracker",
+  "title": "Follow a synthetic tracker epic",
+  "subtitle": "Synthetic fixture: an epic, two tasks, and one linked fix.",
+  "before": "BEFORE: Task progress lives in issue bodies.",
+  "after": "AFTER: Each task links to its captured issue and fix.",
+  "alt": "A synthetic epic has two tasks. One task links a merged fix; the other has none yet.",
+  "nodes": [
+    {
+      "id": "epic",
+      "x": 300,
+      "y": 430,
+      "label": ["Synthetic", "epic"],
+      "sub": ["Synthetic", "branches"],
+      "icon": "list",
+      "kind": "blue",
+      "detail": ["Synthetic tracker data, not a project status."],
+      "sources": [{"path": "issues/1.md", "line": 3}],
+      "drilldown": {
+        "title": "Read the epic",
+        "steps": [
+          {"label": ["Epic", "body"], "icon": "ledger"},
+          {"label": ["Two", "tasks"], "icon": "list"}
+        ]
+      }
+    },
+    {
+      "id": "fixed",
+      "x": 700,
+      "y": 330,
+      "label": ["Task with", "a fix"],
+      "sub": ["Merged fix,", "task open"],
+      "icon": "merge",
+      "kind": "green",
+      "detail": ["The task body links a pull request that merged."],
+      "sources": [{"path": "issues/2.json", "line": 1, "end": 4}, {"path": "pulls/3.json", "line": 1, "end": 6}],
+      "drilldown": {
+        "title": "Follow the linked fix",
+        "steps": [
+          {"label": ["Task links", "a fix"], "icon": "github"},
+          {"label": ["Fix", "merged"], "icon": "merge", "kind": "green"}
+        ]
+      }
+    },
+    {
+      "id": "left",
+      "x": 700,
+      "y": 560,
+      "label": ["Task left", "to build"],
+      "sub": ["No fix", "yet"],
+      "icon": "flag",
+      "kind": "lime",
+      "detail": ["The task body links no pull request yet."],
+      "sources": [{"path": "tracker.json", "line": 79, "end": 85}],
+      "drilldown": {
+        "title": "Count what is left",
+        "steps": [
+          {"label": ["No linked", "fix"], "icon": "pause"},
+          {"label": ["Counted as", "left"], "icon": "flag"}
+        ]
+      }
+    }
+  ],
+  "edges": [
+    {"from": "epic", "to": "fixed", "path": "M340 412 L660 345", "kind": "green"},
+    {"from": "epic", "to": "left", "path": "M340 448 L660 545", "kind": "orange"}
+  ],
+  "notes": [
+    {"label": "SOURCE", "text": ["Captured issues", "Links to each record"]},
+    {"label": "INTERACTION", "text": ["Select a task", "Open its issue"]},
+    {"label": "SCOPE", "text": ["Synthetic data only", "No project claim"]}
+  ],
+  "board": {
+    "strip": ["^Synthetic "],
+    "wording": {"synthetic": "sample"},
+    "steps": [
+      {"heading": "Today", "label": "Today", "kind": "orange"},
+      {"heading": "Fix", "label": "Build", "kind": "lime", "inline": true},
+      {"heading": "Proof", "label": "Proof", "kind": "green"}
+    ],
+    "lanes": [
+      {"node": "epic", "groups": [{"title": "Follow-up branches", "cards": [{"title": "Task one follow-up", "source": {"path": "issues/1.md", "line": 5}}]}]},
+      {"node": "left", "progress": "no_pull"},
+      {"node": "fixed", "progress": "merged_pull"}
+    ]
+  },
+  "comparison": ["The fixture epic body and its captured tasks agree on one fix and one open task."],
+  "review": ["This fixture checks tracker rendering, not a project status."]
+}

package/.agents/skills/pr-visual/scripts/collect.py

@@ -1,4 +1,4 @@
-"""Capture PR metadata, patches, and immutable changed-file source through gh."""
+"""Capture PR source or tracker issue records as immutable evidence through gh."""
 import argparse
 import base64
 import concurrent.futures
@@ -67,7 +67,10 @@ def _capture_file(item: dict, metadata: dict, diff_base: str, destination: Path)
 
 def _save_snapshot(snapshot: dict, destination: Path) -> None:
     (destination / c.SNAPSHOT_NAME).write_text(json.dumps(snapshot, indent=c.JSON_INDENT), encoding="utf-8")
-    all_sections = [c.DIFF_SECTION.format(filename=each_file["filename"], patch=each_file.get("patch", "Patch unavailable. Compare saved base and head source.")) for each_file in snapshot["files"]]
+    if snapshot.get("kind") == c.ISSUE_KIND:
+        all_sections = []
+    else:
+        all_sections = [c.DIFF_SECTION.format(filename=each_file["filename"], patch=each_file.get("patch", "Patch unavailable. Compare saved base and head source.")) for each_file in snapshot["files"]]
     (destination / c.DIFF_NAME).write_text(c.PARAGRAPH_BREAK.join(all_sections), encoding="utf-8")
     print(json.dumps({"pr": snapshot["number"], "snapshot": str(destination / c.SNAPSHOT_NAME), "state": snapshot["state"], "files": len(snapshot["files"])}), flush=True)
 
@@ -102,10 +105,122 @@ def collect(url: str, root: Path) -> None:
     _save_snapshot(snapshot, destination)
 
 
+def _sub_issues(repo: str, number: int) -> list[dict]:
+    all_children = []
+    page = 1
+    while True:
+        batch = _api(c.SUB_ISSUES_ENDPOINT.format(repo=repo, number=number, size=c.PAGE_SIZE, page=page))
+        all_children.extend(batch)
+        if len(batch) < c.PAGE_SIZE:
+            break
+        page += 1
+    return all_children
+
+
+def _write_capture(destination: Path, relative_path: str, raw_bytes: bytes) -> dict:
+    capture_path = destination / c.HEAD_SIDE / relative_path
+    capture_path.parent.mkdir(parents=True, exist_ok=True)
+    capture_path.write_bytes(raw_bytes)
+    return {"filename": relative_path, "captures": {c.HEAD_SIDE: {"path": f"{c.HEAD_SIDE}/{relative_path}", "sha256": hashlib.sha256(raw_bytes).hexdigest(), "bytes": len(raw_bytes)}}}
+
+
+def _json_bytes(record: dict) -> bytes:
+    return (json.dumps(record, indent=c.JSON_INDENT) + c.NEWLINE).encode()
+
+
+def _pull_progress(record: dict) -> str:
+    all_pulls = record["linked_pulls"]
+    if any(each_pull["merged_at"] for each_pull in all_pulls):
+        return "merged_pull"
+    if any(each_pull["state"] == "open" for each_pull in all_pulls):
+        return "open_pull"
+    return "no_pull"
+
+
+def _child_counts(all_children: list[dict]) -> dict[str, int]:
+    all_progress = [each_child["progress"] for each_child in all_children]
+    return {
+        "open": sum(each_child["state"] == "open" for each_child in all_children),
+        "closed": sum(each_child["state"] == "closed" for each_child in all_children),
+        **{each_progress: all_progress.count(each_progress) for each_progress in c.ALL_PULL_PROGRESS},
+    }
+
+
+def _capture_issue_tree(repo: str, issue: dict, depth: int, all_pulls_by_number: dict[int, dict], destination: Path, all_files: list[dict]) -> dict:
+    record = {each_field: issue.get(each_field) for each_field in c.ALL_ISSUE_FIELDS}
+    record["labels"] = [each_label["name"] for each_label in issue.get("labels", [])]
+    body = issue.get("body") or ""
+    linked_numbers = sorted({int(each_number) for each_number in re.findall(c.LINKED_PULL_PATTERN.format(repo=re.escape(repo)), body)})
+    for each_number in linked_numbers:
+        if each_number not in all_pulls_by_number:
+            pull = _api(c.PR_ENDPOINT.format(repo=repo, number=each_number))
+            all_pulls_by_number[each_number] = {each_field: pull.get(each_field) for each_field in c.ALL_PULL_FIELDS}
+    record["linked_pulls"] = [all_pulls_by_number[each_number] for each_number in linked_numbers]
+    record["progress"] = _pull_progress(record)
+    children = _sub_issues(repo, issue["number"]) if depth < c.SUB_ISSUE_DEPTH else []
+    record["children"] = [_capture_issue_tree(repo, each_child, depth + 1, all_pulls_by_number, destination, all_files) for each_child in children]
+    record["counts"] = _child_counts(record["children"])
+    all_files.append(_write_capture(destination, c.ISSUE_BODY_PATH.format(number=issue["number"]), (body + c.NEWLINE).encode()))
+    issue_record = {each_field: each_entry for each_field, each_entry in record.items() if each_field != "children"}
+    all_files.append(_write_capture(destination, c.ISSUE_RECORD_PATH.format(number=issue["number"]), _json_bytes(issue_record)))
+    return record
+
+
+def _capture_tracker(repo: str, issue: dict, destination: Path) -> tuple[bytes, list[dict]]:
+    all_files: list[dict] = []
+    all_pulls_by_number: dict[int, dict] = {}
+    tracker_bytes = _json_bytes(_capture_issue_tree(repo, issue, 0, all_pulls_by_number, destination, all_files))
+    for each_number, each_pull in all_pulls_by_number.items():
+        all_files.append(_write_capture(destination, c.PULL_RECORD_PATH.format(number=each_number), _json_bytes(each_pull)))
+    all_files.append(_write_capture(destination, c.TRACKER_PATH, tracker_bytes))
+    return tracker_bytes, all_files
+
+
+def _tracker_snapshot(url: str, repo: str, refreshed: dict, observed_at: str, tracker_bytes: bytes, all_files: list[dict]) -> dict:
+    tracked_count = sum(1 for each_file in all_files if re.fullmatch(c.CAPTURED_ISSUE_RECORD_PATTERN, each_file["filename"]))
+    metadata = {"title": refreshed["title"], "body": refreshed.get("body") or "", "draft": False, "merged": False, "tracked_issues": tracked_count}
+    return {"schema_version": 1, "kind": c.ISSUE_KIND, "observed_at": observed_at, "repo": repo, "number": refreshed["number"], "url": url, "state": refreshed["state"], "head": hashlib.sha256(tracker_bytes).hexdigest(), "base": None, "diff_base": None, "metadata": metadata, "files": all_files}
+
+
+def collect_issue(url: str, root: Path) -> None:
+    """Save an issue, its sub-issues, and the pull requests their bodies link.
+
+    A tracker epic becomes the same kind of snapshot a pull request does::
+
+        issues/12.md      the issue body, line by line
+        issues/12.json    state, labels, linked pull requests, child counts
+        pulls/34.json     each linked pull request's state
+        tracker.json      the whole tree, for charts and citations
+
+    Args:
+        url: GitHub issue URL.
+        root: Directory receiving a folder for the captured issue.
+
+    Raises:
+        CaptureRunFatal: The issue changed during capture.
+    """
+    matched_url = re.fullmatch(c.ISSUE_URL_PATTERN, url)
+    if not matched_url:
+        raise CaptureRunFatal("Use a GitHub issue URL, https://github.com/owner/repo/issues/number")
+    repo, number = matched_url.groups()
+    endpoint = c.ISSUE_ENDPOINT.format(repo=repo, number=number)
+    issue = _api(endpoint)
+    observed_at = datetime.datetime.now(datetime.UTC).isoformat()
+    destination = root / f"issue-{number}" / observed_at.replace(":", "-")
+    tracker_bytes, all_files = _capture_tracker(repo, issue, destination)
+    refreshed = _api(endpoint)
+    if refreshed["updated_at"] != issue["updated_at"]:
+        raise CaptureRunFatal("Issue changed during capture. Rerun collection.")
+    _save_snapshot(_tracker_snapshot(url, repo, refreshed, observed_at, tracker_bytes, all_files), destination)
+
+
 if __name__ == "__main__":
     parser = argparse.ArgumentParser(description=__doc__)
     parser.add_argument("urls", nargs="+")
     parser.add_argument("--out", type=Path, default=Path(c.DEFAULT_EVIDENCE_DIRECTORY))
     arguments = parser.parse_args()
     for each_url in arguments.urls:
-        collect(each_url, arguments.out)
+        if re.fullmatch(c.ISSUE_URL_PATTERN, each_url):
+            collect_issue(each_url, arguments.out)
+        else:
+            collect(each_url, arguments.out)

package/.agents/skills/pr-visual/scripts/render.py

@@ -1,6 +1,7 @@
 """Validate evidence-backed diagram scenes and render a portable HTML visual."""
 import argparse
 import copy
+import itertools
 import json
 import re
 from pathlib import Path
@@ -36,7 +37,7 @@ def _validate_graph(scene: dict) -> None:
         if not re.fullmatch(c.SVG_PATH_PATTERN, each_edge["path"]):
             raise RenderRunFatal("Invalid SVG path.")
     for each_node in scene["nodes"]:
-        if not scene.get("chart") and (not c.MINIMUM_NODE_X <= each_node["x"] <= c.MAXIMUM_NODE_X or not c.MINIMUM_NODE_Y <= each_node["y"] <= c.MAXIMUM_NODE_Y):
+        if not scene.get("chart") and not scene.get("board") and (not c.MINIMUM_NODE_X <= each_node["x"] <= c.MAXIMUM_NODE_X or not c.MINIMUM_NODE_Y <= each_node["y"] <= c.MAXIMUM_NODE_Y):
             raise RenderRunFatal("Node lies outside diagram bounds.")
         if not each_node.get("sources"):
             raise RenderRunFatal("Every node needs source evidence.")
@@ -56,10 +57,117 @@ def _source_evidence(source: dict, snapshot: dict, snapshot_path: Path) -> None:
     if not 1 <= first <= last <= len(all_lines):
         raise RenderRunFatal("Invalid source line range.")
     source["excerpt"] = c.NEWLINE.join(c.SOURCE_LINE.format(number=each_index + first, line=each_line) for each_index, each_line in enumerate(all_lines[first - 1:last]))
+    if snapshot.get("kind") == c.ISSUE_KIND:
+        source["url"] = _captured_record_link(source["path"], snapshot)
+        return
     revision = snapshot.get("diff_base", snapshot[c.BASE_SIDE]) if side == c.BASE_SIDE else snapshot[c.HEAD_SIDE]
     source["url"] = c.SOURCE_LINK.format(repo=snapshot["repo"], revision=revision, path=quote(source["path"], safe="/"), first=first, last=last)
 
 
+def _captured_record_link(relative_path: str, snapshot: dict) -> str:
+    if matched_issue := re.fullmatch(c.CAPTURED_ISSUE_PATTERN, relative_path):
+        return c.ISSUE_LINK.format(repo=snapshot["repo"], number=matched_issue.group(1))
+    if matched_pull := re.fullmatch(c.CAPTURED_PULL_PATTERN, relative_path):
+        return c.PULL_LINK.format(repo=snapshot["repo"], number=matched_pull.group(1))
+    if relative_path == c.TRACKER_PATH:
+        return snapshot["url"]
+    raise RenderRunFatal("Tracker evidence must cite a captured issue, pull request, or tracker file.")
+
+
+def _plain_title(record: dict, settings: dict) -> str:
+    title = settings.get("titles", {}).get(str(record["number"]), record["title"])
+    for each_pattern in settings.get("strip", []):
+        title = re.sub(each_pattern, "", title, count=1)
+    return title
+
+
+def _issue_steps(number: int, snapshot_path: Path, settings: dict) -> list[dict]:
+    all_lines = (snapshot_path.parent / c.HEAD_SIDE / c.ISSUE_BODY_PATH.format(number=number)).read_text(encoding="utf-8").splitlines()
+    all_steps = []
+    for each_step in settings.get("steps", []):
+        heading = c.SECTION_HEADING.format(heading=each_step["heading"])
+        if heading not in all_lines:
+            continue
+        all_paragraph_lines = list(itertools.takewhile(str.strip, all_lines[all_lines.index(heading) + 1:]))
+        text = c.SPACE_SEPARATOR.join(all_paragraph_lines)
+        for each_word, each_plain_word in settings.get("wording", {}).items():
+            text = re.sub(c.WHOLE_PHRASE_PATTERN.format(phrase=re.escape(each_word)), each_plain_word, text)
+        all_steps.append({**{each_field: each_setting for each_field, each_setting in each_step.items() if each_field != "heading"}, "text": text})
+    return all_steps
+
+
+def _tracker_card(issue: dict, repo: str, settings: dict, snapshot_path: Path) -> dict:
+    progress = issue["progress"]
+    all_pulls = [each_pull for each_pull in issue["linked_pulls"] if (each_pull["merged_at"] if progress == "merged_pull" else each_pull["state"] == "open")]
+    pulls = c.PULL_REFERENCE_SEPARATOR.join(c.PULL_REFERENCE.format(number=each_pull["number"]) for each_pull in all_pulls)
+    return {
+        "number": issue["number"],
+        "title": _plain_title(issue, settings),
+        "url": c.ISSUE_LINK.format(repo=repo, number=issue["number"]),
+        "note": c.ALL_CARD_NOTES[progress].format(pulls=pulls),
+        "steps": _issue_steps(issue["number"], snapshot_path, settings),
+    }
+
+
+def _tracker_groups(record: dict, progress: str, repo: str, settings: dict, snapshot_path: Path) -> list[dict]:
+    all_tasks = [each_child for each_child in record["children"] if not each_child["children"] and each_child["state"] == "open" and each_child["progress"] == progress and each_child["number"] not in settings.get("exclude", [])]
+    all_groups = [{"title": _plain_title(record, settings), "url": c.ISSUE_LINK.format(repo=repo, number=record["number"]), "cards": [_tracker_card(each_task, repo, settings, snapshot_path) for each_task in all_tasks]}] if all_tasks else []
+    for each_child in record["children"]:
+        all_groups.extend(_tracker_groups(each_child, progress, repo, settings, snapshot_path))
+    return all_groups
+
+
+def _cited_group(group: dict, snapshot: dict, snapshot_path: Path) -> dict:
+    for each_card in group["cards"]:
+        _source_evidence(each_card["source"], snapshot, snapshot_path)
+        each_card.setdefault("url", each_card["source"]["url"])
+        each_card.setdefault("note", "")
+        if not each_card["url"].startswith(c.REPOSITORY_LINK.format(repo=snapshot["repo"])):
+            raise RenderRunFatal("A board card must link inside the tracked repository.")
+    group.setdefault("url", snapshot["url"])
+    return group
+
+
+def _board_lane(lane: dict, tracker: dict, settings: dict, snapshot: dict, snapshot_path: Path) -> dict:
+    if "progress" in lane:
+        all_groups = _tracker_groups(tracker, lane["progress"], snapshot["repo"], settings, snapshot_path)
+    else:
+        all_groups = [_cited_group(each_group, snapshot, snapshot_path) for each_group in lane.get("groups", [])]
+    return {"node": lane["node"], "groups": all_groups, "count": sum(len(each_group["cards"]) for each_group in all_groups)}
+
+
+def _prepare_board(scene: dict, snapshot: dict, snapshot_path: Path) -> None:
+    """Place every tracker card in the state lane its scene names.
+
+    The flow runs top to bottom. Each lane is one state node with its cards
+    beside it, grouped under their parent epic::
+
+        (Not started)   Convert . 2     [task 12]  [task 13]
+              |
+        (Fixed)         Icons . 1       [task 14  Merged in pull request 20]
+
+    Args:
+        scene: Scene with ``board`` settings: ``lanes`` in flow order, each
+            naming a scene ``node`` and either a tracker ``progress``
+            (``no_pull``, ``open_pull``, ``merged_pull``) or cited ``groups``
+            of cards; ``strip`` title prefix patterns, ``titles`` keyed by
+            issue number, ``exclude`` issue numbers that are not work,
+            ``steps`` naming the body sections each card diagram shows,
+            and ``wording`` swaps for that text.
+        snapshot: Captured tracker snapshot.
+        snapshot_path: Snapshot file the tracker tree sits beside.
+
+    Raises:
+        RenderRunFatal: A node lacks exactly one lane, or a card leaves the repository.
+    """
+    settings = scene["board"]
+    tracker = json.loads((snapshot_path.parent / c.HEAD_SIDE / c.TRACKER_PATH).read_text(encoding="utf-8"))
+    if sorted(each_lane["node"] for each_lane in settings["lanes"]) != sorted(each_node["id"] for each_node in scene["nodes"]):
+        raise RenderRunFatal("Every board node needs exactly one lane.")
+    all_lanes = [_board_lane(each_lane, tracker, settings, snapshot, snapshot_path) for each_lane in settings["lanes"]]
+    scene["board"] = {"lanes": all_lanes, "count": sum(each_lane["count"] for each_lane in all_lanes)}
+
+
 def _prepare_sources(scene: dict, snapshot: dict, snapshot_path: Path) -> None:
     for each_node in scene["nodes"]:
         for each_source in each_node["sources"]:
@@ -82,10 +190,13 @@ def prepare(path: Path) -> dict:
     snapshot_path = (path.parent / scene["snapshot"]).resolve()
     snapshot = json.loads(snapshot_path.read_text(encoding="utf-8"))
     scene["pr"] = {each_key: snapshot[each_key] for each_key in ("number", "url", "repo", "state", "head", "base", "observed_at")}
-    scene["pr"].update(draft=snapshot["metadata"]["draft"], merged=snapshot["metadata"].get("merged", False), changed_files=len(snapshot["files"]), title=snapshot["metadata"]["title"])
+    is_issue = snapshot.get("kind") == c.ISSUE_KIND
+    scene["pr"].update(kind=snapshot.get("kind", "pull"), draft=snapshot["metadata"]["draft"], merged=snapshot["metadata"].get("merged", False), changed_files=snapshot["metadata"]["tracked_issues"] if is_issue else len(snapshot["files"]), title=snapshot["metadata"]["title"])
     scene["summary"] = snapshot["metadata"]["body"] or "No PR description."
     _validate_graph(scene)
     _prepare_sources(scene, snapshot, snapshot_path)
+    if is_issue and scene.get("board"):
+        _prepare_board(scene, snapshot, snapshot_path)
     prepare_chart(scene, snapshot_path)
     prepare_embedded_charts(scene, snapshot_path)
     return scene
@@ -96,6 +207,10 @@ def _omit_private_payload(scene: dict) -> None:
     for each_node in scene["nodes"]:
         for each_source in each_node["sources"]:
             each_source.pop("excerpt", None)
+    for each_lane in scene.get("board", {}).get("lanes", []):
+        for each_group in each_lane["groups"]:
+            for each_card in each_group["cards"]:
+                each_card.get("source", {}).pop("excerpt", None)
 
 
 def render(all_scenes: list[dict], artifact_path: Path, is_links_only: bool = False) -> None:

package/.agents/skills/pr-visual/scripts/test_collect.py

@@ -56,3 +56,51 @@ def test_incomplete_changed_file_list_fails(monkeypatch: pytest.MonkeyPatch) ->
     monkeypatch.setattr(collect, "_api", Mock(return_value=[]))
     with pytest.raises(collect.CaptureRunFatal, match="incomplete"):
         collect._changed_files(REPOSITORY, "1", 1)
+
+
+ISSUE_URL = "https://github.com/example/project/issues/10"
+EPIC = {"number": 10, "title": "Synthetic epic", "state": "open", "updated_at": "2026-10-19T12:00:00Z", "labels": [], "body": "Tasks below."}
+TASK_WITH_FIX = {"number": 11, "title": "Task with a fix", "state": "open", "updated_at": "2026-10-19T12:00:00Z", "labels": [], "body": "Fix: https://github.com/example/project/pull/20"}
+TASK_IN_FLIGHT = {"number": 12, "title": "Task in flight", "state": "open", "updated_at": "2026-10-19T12:00:00Z", "labels": [], "body": "Fix: https://github.com/example/project/pull/21"}
+TASK_LEFT = {"number": 13, "title": "Task left", "state": "closed", "updated_at": "2026-10-19T12:00:00Z", "labels": [], "body": None}
+FINISHED_PULL = {"number": 20, "title": "Finished fix", "state": "closed", "draft": False, "merged_at": "2026-10-19T11:00:00Z"}
+OPEN_PULL = {"number": 21, "title": "Open fix", "state": "open", "draft": True, "merged_at": None}
+
+
+def _tracker_github(refreshed_epic: dict) -> Mock:
+    responses = {
+        "repos/example/project/issues/10": [EPIC, refreshed_epic],
+        "repos/example/project/issues/10/sub_issues?per_page=100&page=1": [[TASK_WITH_FIX, TASK_IN_FLIGHT, TASK_LEFT]],
+        "repos/example/project/issues/11/sub_issues?per_page=100&page=1": [[]],
+        "repos/example/project/issues/12/sub_issues?per_page=100&page=1": [[]],
+        "repos/example/project/issues/13/sub_issues?per_page=100&page=1": [[]],
+        "repos/example/project/pulls/20": [FINISHED_PULL],
+        "repos/example/project/pulls/21": [OPEN_PULL],
+    }
+    return Mock(side_effect=lambda endpoint, *options: responses[endpoint].pop(0))
+
+
+def test_issue_capture_counts_each_task_by_its_linked_pull_request(tmp_path: Path, monkeypatch: pytest.MonkeyPatch) -> None:
+    """An epic snapshot records each task's fix state and hashes every captured record."""
+    monkeypatch.setattr(collect, "_api", _tracker_github(EPIC))
+    collect.collect_issue(ISSUE_URL, tmp_path)
+    destination = next((tmp_path / "issue-10").iterdir())
+    snapshot = json.loads((destination / "snapshot.json").read_text())
+    tracker = json.loads((destination / "head/tracker.json").read_text())
+    assert tracker["counts"] == {"open": 2, "closed": 1, "merged_pull": 1, "open_pull": 1, "no_pull": 1}
+    assert [each_child["progress"] for each_child in tracker["children"]] == ["merged_pull", "open_pull", "no_pull"]
+    assert snapshot["kind"] == "issue"
+    assert snapshot["metadata"]["tracked_issues"] == 4
+    assert (destination / "head/issues/11.md").read_text() == TASK_WITH_FIX["body"] + "\n"
+    assert json.loads((destination / "head/pulls/21.json").read_text())["draft"] is True
+    for each_file in snapshot["files"]:
+        assert hashlib.sha256((destination / each_file["captures"]["head"]["path"]).read_bytes()).hexdigest() == each_file["captures"]["head"]["sha256"]
+
+
+def test_edited_issue_never_saves_a_tracker_snapshot(tmp_path: Path, monkeypatch: pytest.MonkeyPatch) -> None:
+    """An epic edited during capture requires another capture before rendering."""
+    edited = {**EPIC, "updated_at": "2026-10-19T12:05:00Z"}
+    monkeypatch.setattr(collect, "_api", _tracker_github(edited))
+    with pytest.raises(collect.CaptureRunFatal, match="changed during capture"):
+        collect.collect_issue(ISSUE_URL, tmp_path)
+    assert not list(tmp_path.rglob("snapshot.json"))

package/.agents/skills/pr-visual/scripts/test_render.py

@@ -1,6 +1,7 @@
 """Exercise numerical provenance, evidence boundaries, and portable rendering."""
 import copy
 import json
+import shutil
 import sys
 from pathlib import Path
 
@@ -75,3 +76,86 @@ def test_embedded_text_cannot_close_script(tmp_path: Path) -> None:
     artifact_path = tmp_path / "visual.html"
     render([scene], artifact_path)
     assert scene["summary"] not in artifact_path.read_text()
+
+
+def test_tracker_scene_links_each_record_to_its_issue_or_pull_request(tmp_path: Path) -> None:
+    """Tracker evidence opens the issue or pull request a captured record came from."""
+    scene = prepare(FIXTURES / "tracker.scene.json")
+    render([scene], tmp_path / "visual.html")
+    all_links = [each_source["url"] for each_node in scene["nodes"] for each_source in each_node["sources"]]
+    assert all_links == ["https://github.com/example/project/issues/1", "https://github.com/example/project/issues/2", "https://github.com/example/project/pull/3", "https://github.com/example/project/issues/1"]
+    assert scene["pr"]["kind"] == "issue"
+    assert scene["pr"]["changed_files"] == 3
+
+
+def test_tracker_scene_rejects_evidence_outside_captured_records(tmp_path: Path) -> None:
+    """A tracker source must name a captured issue, pull request, or the tracker tree."""
+    tracker_copy = tmp_path / "tracker"
+    shutil.copytree(FIXTURES / "tracker", tracker_copy)
+    (tracker_copy / "head/notes.txt").write_text("synthetic\n")
+    snapshot = json.loads((tracker_copy / "snapshot.json").read_text())
+    with pytest.raises(RenderRunFatal, match="Tracker evidence"):
+        _source_evidence({"path": "notes.txt", "line": 1}, snapshot, tracker_copy / "snapshot.json")
+
+
+def test_tracker_scene_places_every_card_in_its_state_lane(tmp_path: Path) -> None:
+    """Each card lands once in the lane for its state, under its epic, with its issue link."""
+    scene = prepare(FIXTURES / "tracker.scene.json")
+    render([scene], tmp_path / "visual.html", is_links_only=True)
+    branches, left, fixed = scene["board"]["lanes"]
+    assert [each_lane["node"] for each_lane in scene["board"]["lanes"]] == ["epic", "left", "fixed"]
+    assert [(each_card["title"], each_card["note"]) for each_card in left["groups"][0]["cards"]] == [("task without a fix", "")]
+    assert [(each_card["title"], each_card["note"]) for each_card in fixed["groups"][0]["cards"]] == [("task with a fix", "Merged in pull request 3")]
+    assert fixed["groups"][0]["title"] == "tracker epic"
+    assert fixed["groups"][0]["cards"][0]["url"] == "https://github.com/example/project/issues/2"
+    assert branches["groups"][0]["cards"][0]["url"] == "https://github.com/example/project/issues/1"
+    assert scene["board"]["count"] == 3
+    assert left["groups"][0]["cards"][0]["steps"] == [
+        {"label": "Today", "kind": "orange", "text": "The sample task has no fix yet."},
+        {"label": "Build", "kind": "lime", "inline": True, "text": "Build the sample fix and link it."},
+        {"label": "Proof", "kind": "green", "text": "A sample test shows the fix."},
+    ]
+    assert fixed["groups"][0]["cards"][0]["steps"] == []
+    assert "Task one ships" not in (tmp_path / "visual.html").read_text()
+
+
+def _board_scene(tmp_path: Path) -> dict:
+    shutil.copytree(FIXTURES / "tracker", tmp_path / "tracker")
+    return json.loads((FIXTURES / "tracker.scene.json").read_text())
+
+
+def _prepare_copy(tmp_path: Path, scene: dict) -> dict:
+    (tmp_path / "tracker.scene.json").write_text(json.dumps(scene))
+    return prepare(tmp_path / "tracker.scene.json")
+
+
+def test_tracker_cited_card_rejects_a_link_outside_the_repository(tmp_path: Path) -> None:
+    """A cited board card cannot point away from the tracked repository."""
+    scene = _board_scene(tmp_path)
+    scene["board"]["lanes"][0]["groups"][0]["cards"][0]["url"] = "https://example.com/elsewhere"
+    with pytest.raises(RenderRunFatal, match="tracked repository"):
+        _prepare_copy(tmp_path, scene)
+
+
+def test_tracker_board_rejects_a_node_with_no_lane(tmp_path: Path) -> None:
+    """Every state node on a board sits in exactly one lane."""
+    scene = _board_scene(tmp_path)
+    scene["board"]["lanes"].pop()
+    with pytest.raises(RenderRunFatal, match="exactly one lane"):
+        _prepare_copy(tmp_path, scene)
+
+
+def test_tracker_scene_leaves_out_excluded_issues(tmp_path: Path) -> None:
+    """An issue the scene names as not a work item stays off the board."""
+    scene = _board_scene(tmp_path)
+    scene["board"]["exclude"] = [4]
+    left_lane = _prepare_copy(tmp_path, scene)["board"]["lanes"][1]
+    assert left_lane["groups"] == [] and left_lane["count"] == 0
+
+
+def test_tracker_scene_uses_the_plain_title_a_scene_gives(tmp_path: Path) -> None:
+    """A card shows the plain title a scene gives for an issue number."""
+    scene = _board_scene(tmp_path)
+    scene["board"]["titles"] = {"4": "Build the missing fix"}
+    left_lane = _prepare_copy(tmp_path, scene)["board"]["lanes"][1]
+    assert [each_card["title"] for each_card in left_lane["groups"][0]["cards"]] == ["Build the missing fix"]

package/.agents/skills/pr-visual/scripts/verify.py

@@ -51,6 +51,35 @@ def _toolbar_details(root: Locator, node_count: int) -> None:
         root.get_by_role("button", name=c.CLOSE_BUTTON_LABEL).click()
 
 
+def _check_board(root: Locator, scene: dict) -> None:
+    all_cards = root.locator(c.BOARD_CARD_SELECTOR)
+    if not scene.get("board"):
+        assert all_cards.count() == 0
+        return
+    assert all_cards.count() == scene["board"]["count"]
+    assert not all_cards.evaluate_all(c.CARD_FIT_EXPRESSION)
+    _check_board_text(root, c.CANVAS_TEXT_SELECTOR)
+    first_card = 0
+    for each_lane in scene["board"]["lanes"]:
+        if not each_lane["count"]:
+            continue
+        card = each_lane["groups"][0]["cards"][0]
+        all_cards.nth(first_card).click()
+        assert root.locator(c.DETAIL_TITLE_SELECTOR).inner_text() == card["title"]
+        assert root.locator(c.CARD_STEP_SELECTOR).count() == max(1, len(card.get("steps", [])))
+        _check_board_text(root, c.CARD_FLOW_TEXT_SELECTOR)
+        root.get_by_role("button", name=c.CLOSE_BUTTON_LABEL).click()
+        assert root.locator(c.DRAWER_SELECTOR).is_hidden()
+        first_card += each_lane["count"]
+
+
+def _check_board_text(root: Locator, selector: str) -> None:
+    background = _luminance(c.PAGE_BACKGROUND_COLOR)
+    for each_text in root.locator(selector).evaluate_all(c.BOARD_TEXT_EXPRESSION):
+        assert each_text["size"] >= c.MINIMUM_BOARD_FONT_SIZE, each_text
+        assert (background + c.CONTRAST_OFFSET) / (_luminance(each_text["color"]) + c.CONTRAST_OFFSET) >= c.MINIMUM_BOARD_CONTRAST, each_text
+
+
 def _keyboard_and_zoom(page: Page, root: Locator) -> None:
     first_node = root.locator(c.NODE_SELECTOR).first
     first_node.focus()
@@ -66,11 +95,15 @@ def _keyboard_and_zoom(page: Page, root: Locator) -> None:
 
 def _scene_screenshots(page: Page, root: Locator, scene: dict, proof_directory: Path, scene_index: int) -> None:
     page.screenshot(path=str(proof_directory / c.PR_SCREENSHOT_NAME.format(number=scene["pr"]["number"], index=scene_index)), full_page=True)
+    if scene.get("board"):
+        root.locator(c.WORKSPACE_SELECTOR).evaluate(c.UNCLIP_WORKSPACE_EXPRESSION)
+        root.locator(c.CANVAS_SELECTOR).screenshot(path=str(proof_directory / c.BOARD_SCREENSHOT_NAME.format(number=scene["pr"]["number"], index=scene_index)))
+        root.locator(c.WORKSPACE_SELECTOR).evaluate(c.RECLIP_WORKSPACE_EXPRESSION)
     all_nodes = root.locator(c.NODE_SELECTOR)
     all_nodes.first.click()
     page.screenshot(path=str(proof_directory / c.DETAIL_SCREENSHOT_NAME.format(number=scene["pr"]["number"], index=scene_index)), full_page=True)
     if all_nodes.count() > 1:
-        all_nodes.nth(1).click()
+        root.locator(c.NODE_TARGET_SELECTOR.format(target=scene["nodes"][1]["id"])).click()
         assert root.locator(c.DETAIL_TITLE_SELECTOR).inner_text() == c.SPACE_SEPARATOR.join(scene["nodes"][1]["label"])
     page.keyboard.press("Escape")
 
@@ -78,17 +111,18 @@ def _scene_screenshots(page: Page, root: Locator, scene: dict, proof_directory:
 def _verify_scene(page: Page, root: Locator, scene: dict, scene_index: int, proof_directory: Path) -> dict:
     root.get_by_role("tab").nth(scene_index).click()
     all_nodes = root.locator(c.NODE_SELECTOR)
-    for each_index, each_node in enumerate(scene["nodes"]):
-        all_nodes.nth(each_index).click()
+    for each_node in scene["nodes"]:
+        root.locator(c.NODE_TARGET_SELECTOR.format(target=each_node["id"])).click()
         _check_node(root, each_node)
         _navigate_related(root)
         page.keyboard.press("Escape")
         assert root.locator(c.DRAWER_SELECTOR).is_hidden()
         assert root.locator(c.SELECTED_NODE_SELECTOR).count() == 0
     _toolbar_details(root, len(scene["nodes"]))
+    _check_board(root, scene)
     _keyboard_and_zoom(page, root)
     _scene_screenshots(page, root, scene, proof_directory, scene_index)
-    return {"pr": scene["pr"]["number"], "nodes_checked": all_nodes.count(), "docked_panel": "pass", "mini_diagrams": "pass", "related_navigation": "pass", "collapsed_sources": "pass", "keyboard_and_zoom": "pass"}
+    return {"pr": scene["pr"]["number"], "nodes_checked": all_nodes.count(), "docked_panel": "pass", "mini_diagrams": "pass", "related_navigation": "pass", "collapsed_sources": "pass", "keyboard_and_zoom": "pass", "board_cards": scene["board"]["count"] if scene.get("board") else "none"}
 
 
 def _dashboard(page: Page, root: Locator, all_scenes: list[dict], proof_directory: Path) -> None:

package/.agents/skills/pr-visual/scripts/visual_config/config/constants.py

@@ -12,6 +12,30 @@ HEAD_SIDE = "head"
 BASE_SIDE = "base"
 PR_URL_PATTERN = r"https://github\.com/([\w.-]+/[\w.-]+)/pull/([1-9]\d*)/?"
 PR_ENDPOINT = "repos/{repo}/pulls/{number}"
+ISSUE_URL_PATTERN = r"https://github\.com/([\w.-]+/[\w.-]+)/issues/([1-9]\d*)/?"
+ISSUE_ENDPOINT = "repos/{repo}/issues/{number}"
+SUB_ISSUES_ENDPOINT = "repos/{repo}/issues/{number}/sub_issues?per_page={size}&page={page}"
+LINKED_PULL_PATTERN = r"https://github\.com/{repo}/pull/([1-9]\d*)"
+ISSUE_KIND = "issue"
+SUB_ISSUE_DEPTH = 2
+ISSUE_RECORD_PATH = "issues/{number}.json"
+ISSUE_BODY_PATH = "issues/{number}.md"
+SECTION_HEADING = "## {heading}"
+WHOLE_PHRASE_PATTERN = r"(?<!\w){phrase}(?!\w)"
+PULL_RECORD_PATH = "pulls/{number}.json"
+TRACKER_PATH = "tracker.json"
+ISSUE_LINK = "https://github.com/{repo}/issues/{number}"
+PULL_LINK = "https://github.com/{repo}/pull/{number}"
+REPOSITORY_LINK = "https://github.com/{repo}/"
+CAPTURED_ISSUE_PATTERN = r"issues/([1-9]\d*)\.(?:json|md)"
+CAPTURED_ISSUE_RECORD_PATTERN = r"issues/([1-9]\d*)\.json"
+CAPTURED_PULL_PATTERN = r"pulls/([1-9]\d*)\.json"
+ALL_ISSUE_FIELDS = ("number", "title", "state", "state_reason", "html_url", "created_at", "updated_at", "closed_at")
+ALL_PULL_PROGRESS = ("merged_pull", "open_pull", "no_pull")
+ALL_CARD_NOTES = {"no_pull": "", "open_pull": "Open in pull request {pulls}", "merged_pull": "Merged in pull request {pulls}"}
+PULL_REFERENCE = "{number}"
+PULL_REFERENCE_SEPARATOR = ", "
+ALL_PULL_FIELDS =("number", "title", "state", "draft", "merged_at", "closed_at", "updated_at", "html_url")
 COMPARE_ENDPOINT = "repos/{repo}/compare/{base}...{head}"
 FILES_ENDPOINT = "repos/{repo}/pulls/{number}/files?per_page={size}&page={page}"
 CONTENTS_ENDPOINT = "repos/{repo}/contents/{path}?ref={revision}"
@@ -37,11 +61,23 @@ ROOT_SELECTOR = "[data-pr-visual]"
 DRAWER_SELECTOR = ".drawer"
 STAGE_SELECTOR = ".stage"
 CANVAS_SELECTOR = ".canvas"
+WORKSPACE_SELECTOR = ".workspace"
+UNCLIP_WORKSPACE_EXPRESSION = "(n)=>{n.style.height='auto';n.firstElementChild.style.overflow='visible'}"
+RECLIP_WORKSPACE_EXPRESSION = "(n)=>{n.style.height='';n.firstElementChild.style.overflow=''}"
 EXACT_SELECTOR = ".exact-source"
 DISCLOSURE_SELECTOR = ".exact-source summary"
 DETAIL_TITLE_SELECTOR = "[data-detail-title]"
 NODE_SELECTOR = "[data-node]"
 JUMP_SELECTOR = "[data-detail-target]"
+BOARD_CARD_SELECTOR = "[data-card]"
+CANVAS_TEXT_SELECTOR = ".canvas svg text"
+CARD_FLOW_TEXT_SELECTOR = ".drawer .card-flow text"
+CARD_STEP_SELECTOR = ".drawer .card-flow rect"
+MINIMUM_BOARD_FONT_SIZE = 16
+MINIMUM_BOARD_CONTRAST = 7
+PAGE_BACKGROUND_COLOR = "rgb(246, 245, 239)"
+BOARD_TEXT_EXPRESSION = "(nodes)=>nodes.map(n=>({size:parseFloat(getComputedStyle(n).fontSize),color:getComputedStyle(n).fill}))"
+CARD_FIT_EXPRESSION = "(cards)=>cards.filter(a=>{const r=a.querySelector('rect').getBBox();return [...a.querySelectorAll('text')].some(t=>{const b=t.getBBox();return b.x<r.x||b.x+b.width>r.x+r.width||b.y<r.y||b.y+b.height>r.y+r.height})}).map(a=>a.textContent)"
 DATA_SCENES_SELECTOR = "[data-scenes]"
 CANVAS_WIDTH_EXPRESSION = "(n)=>n.style.width"
 DISCLOSURE_OPEN_EXPRESSION = "(n)=>n.open"
@@ -56,6 +92,7 @@ NODE_TARGET_SELECTOR = '[data-node="{target}"]'
 SELECTED_NODE_SELECTOR = '[data-node][aria-expanded=true]'
 PR_SCREENSHOT_NAME = "scene-{index}-pr-{number}.png"
 DETAIL_SCREENSHOT_NAME = "scene-{index}-pr-{number}-detail.png"
+BOARD_SCREENSHOT_NAME = "scene-{index}-pr-{number}-board.png"
 MOBILE_SCREENSHOT_NAME = "mobile-detail.png"
 REPORT_NAME = "verification.json"
 DEFAULT_PROOF_DIRECTORY = "proof"
@@ -63,7 +100,7 @@ SPACE_SEPARATOR = " "
 ZOOM_BUTTON_LABEL = "Zoom in"
 CLOSE_BUTTON_LABEL = "Close details"
 ALL_TOOLBAR_DETAIL_LABELS = ("Summary vs code", "Review notes")
-OVERFLOW_EXPRESSION = "(nodes)=>nodes.filter(n=>{const b=n.getBBox(); return b.x<0||b.x+b.width>1440||b.y<0||b.y+b.height>1020}).map(n=>n.textContent)"
+OVERFLOW_EXPRESSION = "(nodes)=>nodes.filter(n=>{const b=n.getBBox(),v=n.ownerSVGElement.viewBox.baseVal; return b.x<0||b.x+b.width>v.width||b.y<0||b.y+b.height>v.height}).map(n=>n.textContent)"
 MAIN_FRAGMENT_PATTERN = r"<main data-pr-visual>.*?</main>"
 STYLE_FRAGMENT_PATTERN = r"<style>.*?</style>"
 HOST_FIXTURE_HTML = '<div class="toolbar" id="host-toolbar">Host toolbar</div>'

package/bin/install-pstack-plugin.mjs

@@ -67,6 +67,9 @@ const HOST_DEFINITIONS = Object.freeze({
         orphanedVersionsDirectory: (homeDirectory, spec) => join(
             homeDirectory, 'plugins', 'cache', spec.marketplaceName, spec.name,
         ),
+        staleCloneDirectory: (homeDirectory, spec) => join(
+            homeDirectory, 'plugins', 'marketplaces', `${spec.marketplaceRepository.replaceAll('/', '-')}..clone`,
+        ),
         installVerb: 'install',
         uninstallVerb: 'uninstall',
     }),
@@ -215,6 +218,24 @@ function singleLineDetail(text) {
     return (text ?? '').split(/\r?\n/).map(eachLine => eachLine.trim()).filter(Boolean).join(' ');
 }
 
+/**
+ * Delete the clone folder an interrupted marketplace add left behind.
+ *
+ * Claude Code clones a marketplace into `<owner>-<repository>..clone` and
+ * renames it when the clone finishes. A clone that stops partway leaves that
+ * folder with its `.git/shallow.lock`, and `marketplace remove` does not
+ * delete it, so every later add fails on the lock. Removing the folder
+ * before the add lets the add start from an empty slot.
+ *
+ * @param {string|undefined} cloneDirectory The leftover clone folder.
+ * @returns {boolean} True when a folder was removed.
+ */
+export function removeStaleMarketplaceClone(cloneDirectory) {
+    if (!cloneDirectory || !existsSync(cloneDirectory)) return false;
+    rmSync(cloneDirectory, { recursive: true, force: true, maxRetries: 3 });
+    return true;
+}
+
 const ORPHANED_VERSION_MARKER = '.orphaned_at';
 
 /**
@@ -269,6 +290,9 @@ function installForHost(allSpecs, host, homeDirectory, environment, runCommand,
         });
         if (namesAnAbsentCommand(outcome)) return absentHostOutcome(allSpecs, host, executable);
     }
+    if (HOST_DEFINITIONS[host].staleCloneDirectory && homeDirectory) {
+        removeStaleMarketplaceClone(HOST_DEFINITIONS[host].staleCloneDirectory(homeDirectory, allSpecs[0]));
+    }
     for (const commandArguments of plan.commands) {
         const outcome = runCommand(executable, [...commandArguments], {
             environment: commandEnvironment,
@@ -300,6 +324,8 @@ function installForHost(allSpecs, host, homeDirectory, environment, runCommand,
  * Each host first removes every plugin in the set and then the marketplace,
  * so an older version never survives beside the new one. A removal that finds
  * nothing to remove exits non-zero on a fresh home, and the install goes on.
+ * Before the Claude marketplace add, the install deletes the half-made clone
+ * folder an interrupted earlier add left, so the add starts in an empty slot.
  *
  * Each host is one member of the batch. A host without its command-line tool
  * is skipped and a host whose command fails is reported, so the rules, hooks,

package/bin/install-pstack-plugin.test.mjs

@@ -15,6 +15,7 @@ import {
     installMarketplacePlugins,
     marketplacePluginsPlan,
     removeOrphanedPluginVersions,
+    removeStaleMarketplaceClone,
     removeRetiredMarketplacePlugins,
     shouldInstallMarketplacePlugin,
 } from './install-pstack-plugin.mjs';
@@ -478,3 +479,24 @@ test('a held folder that was not searched adds no claim about what holds it', ()
     assert.match(claude.warning, /EPERM: operation not permitted$/);
     assert.doesNotMatch(claude.warning, /likely holder|Close /);
 });
+
+test('should delete a half-made marketplace clone before the shared marketplace add', () => {
+    const claudeRoot = mkdtempSync(join(tmpdir(), 'cde-stale-clone-'));
+    const cloneDirectory = join(claudeRoot, 'plugins', 'marketplaces', 'jl-cmd-projects-claude-dev-env..clone');
+    mkdirSync(join(cloneDirectory, '.git'), { recursive: true });
+    writeFileSync(join(cloneDirectory, '.git', 'shallow.lock'), '');
+    const allCloneStatesAtAdd = [];
+    const outcome = installMarketplacePlugins([USAGE_WRAPUP_PLUGIN_SPEC], { claudeRoot, hosts: ['claude'] }, {
+        runCommand: (executable, commandArguments) => {
+            if (commandArguments[2] === 'add') allCloneStatesAtAdd.push(existsSync(cloneDirectory));
+            return { status: 0, stderr: '' };
+        },
+    });
+    assert.equal(outcome.status, 'installed');
+    assert.deepEqual(allCloneStatesAtAdd, [false]);
+    rmSync(claudeRoot, { recursive: true, force: true });
+});
+
+test('should report no removal when no stale marketplace clone exists', () => {
+    assert.equal(removeStaleMarketplaceClone(join(tmpdir(), 'cde-no-such-clone')), false);
+});

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "claude-dev-env",
-    "version": "8.95.0",
+    "version": "8.96.0",
     "description": "Claude Code development standards — rules, hooks, agents, commands, and skills",
     "type": "module",
     "bin": {