Files
PaperClipAI/ui/storybook/support/html-artifacts/report.html
T
DottaandPaperclip 88bf4c6c1d refactor(storybook): organize folders and navigation by feature map (#16049)
## Thinking Path

> - Paperclip is the open source app people use to manage AI agents for
work.
> - The feature map describes product areas and verification entry
points.
> - Storybook has 223 story suites that show production components,
proposals, and retained history.
> - The parent PR maps those suites to features, but their folders and
sidebar still use unrelated groups.
> - This pull request puts the existing suites under feature folders and
uses the feature map's names and order in the sidebar.
> - Explicit meta IDs preserve existing story links while the titles
change.
> - Contributors can find stories through the same product structure
without losing examples.

## Linked Issues or Issue Description

Refs #16046. This is the requested follow-up. Parent #16046 is merged.
This PR now targets master, with its single follow-up commit rebased
onto the parent squash merge. The Storybook implementation is unchanged
by that rebase. Related open Storybook PRs were checked; this change
organizes existing suites and adds no product capability.

## What Changed

- Move all 223 story files into folders named for their primary feature
area. Keep useful scenario groups below the feature's sidebar label.
- Order the sidebar by the eight feature-map sections. Put Overview
first and shared Foundations last. Leave areas with no stories out of
the sidebar.
- Move 19 support files into `ui/storybook/support/` and update relative
imports and active documentation.
- Preserve all 2,210 story IDs and the single docs ID through explicit
CSF meta IDs. Keep all entry names and story exports.
- Record stable IDs and sidebar titles in the downstream catalog.
Validate feature folders, title prefixes, and IDs. Update the
maintenance skill and review evidence.

## Verification

- Storybook build passed. Built index comparison against parent
`75bd3c977cd828d5222823850339e8204f40eb47` found the same 2,211 entries,
IDs, and names.
- UI typecheck passed (`ui/node_modules/.bin/tsc -b` from `ui`, invoked
as `./node_modules/.bin/tsc -b`).
- UI Vitest project: 728 files and 8,176 tests passed.
- Catalog checker and its nine tests passed. Feature-map checks, token
gates, and the maintenance-skill validator passed.
- Chromium: nine existing play cases and one render case reached
`storyFinished: success` with no page exceptions. The guide rendered,
sidebar sections followed map order, and a search for `steering/queue`
opened its preserved story link.
- Source comparison found only meta title/ID changes, rebased relative
references, and updated fixture path text in story files.
- To inspect: build Storybook, start `node
scripts/serve-storybook-static.mjs --port 6136`, and open the Overview
guide. Expand feature folders and use existing story links.
- The complete repository suite was not repeated for this organization
change. The parent records a backend timeout that passed in isolation,
without a complete broad-suite pass. Visual comparisons remain blocked
by the unpublished empty baseline. The separate fixture-server story was
not run.

## Risks

- Open branches that add stories under old paths will need to choose a
feature folder and update the catalog. Cross-feature suites have one
primary home and retain related capability references.
- Sidebar paths change; story and docs IDs remain stable. Automated
references to source paths may need the new location.
- This is one requested follow-up with 258 changed files, mostly moves.
It exceeds the usual review-size guideline because splitting it would
leave the sidebar and folder convention partly migrated.
- Browser verification samples ten stories, not all 2,210. Existing
production/prototype classifications and review gaps remain unchanged.
- Required CI gates and a 5/5 review passed on the original head. Fresh
checks and review are running for the rebased head. Catalog validation
and all nine checker tests passed after rebase; UI, map, skill, and
checker contents are identical to the original reviewed head.

## Model Used

- OpenAI Codex, GPT-6. The exact runtime model ID and context-window
size are not exposed in this session. Used reasoning, repository
inspection, code execution, and local browser automation.

## Checklist

- [x] I have included a thinking path that traces from project context
to this change
- [x] I have specified the model used (with version and capability
details)
- [x] I have checked ROADMAP.md and confirmed this PR does not duplicate
planned core work
- [x] I have searched GitHub for duplicate or related PRs and linked
them above
- [x] I have either (a) linked existing issues with `Fixes: #` / `Closes
#` / `Refs #` OR (b) described the issue in-PR following the relevant
issue template
- [x] I have not referenced internal/instance-local Paperclip issues or
links (only public GitHub `#NNN` / `github.com/paperclipai/paperclip`
URLs)
- [x] My branch name describes the change (e.g. `docs/...`, `fix/...`)
and contains no internal Paperclip ticket id or instance-derived details
- [x] I have run tests locally and they pass
- [x] I have added or updated tests where applicable
- [x] I have updated relevant documentation to reflect my changes
- [x] I have considered and documented any risks above
- [ ] All Paperclip CI gates are green
- [ ] Greptile is 5/5 with no open P2s, recommendations, or follow-ups
- [x] I will address all Greptile and reviewer comments before
requesting merge

Co-authored-by: Paperclip <noreply@paperclip.ing>
2026-10-12 22:29:22 +00:00

30 lines
3.2 KiB
HTML

<!doctype html>
<html lang="en"><head><meta name="viewport" content="width=device-width,initial-scale=1">
<title>Popular repositories with repeated Paperclip credit</title>
<style>
body{margin:0;padding:28px;color:#19332b;background:#f6f8f4;font:15px/1.6 system-ui,sans-serif}
h1{font-size:28px;line-height:1.2;margin:8px 0 16px}p{color:#526459}small{display:block;color:#526459}
.eyebrow{font-size:12px;text-transform:uppercase;letter-spacing:.08em;color:#527366}
.controls{display:flex;flex-wrap:wrap;gap:20px;margin:24px 0;padding:18px;background:white;border:1px solid #dce4da;border-radius:12px}
label{display:grid;gap:6px;flex:1;min-width:180px}input{accent-color:#28765d;font:inherit;padding:6px;min-width:0}
table{border-collapse:collapse;width:100%;font-size:14px}th{text-align:left;color:#526459;font-weight:500}td,th{padding:12px 8px;border-bottom:1px solid #dce4da}
.bar{height:6px;background:#28765d;border-radius:3px;margin-top:5px}.scroll{overflow:auto}
@media(max-width:480px){body{padding:18px}h1{font-size:24px}}
</style></head><body>
<div class="eyebrow">Research report · October 7, 2026</div>
<h1>Popular repositories that use Paperclip a lot</h1>
<p>Compare repository popularity with repeated, attributed usage. Adjust the weighting to explore the ranking.</p>
<div class="controls">
<label>Popularity weight <input id="weight" type="range" min="0" max="100" value="50"><small id="weights"></small></label>
<label>Find a repository <input id="query" type="search" placeholder="Search repositories"></label>
</div>
<p id="total" aria-live="polite"></p>
<div class="scroll"><table><thead><tr><th>Rank</th><th>Repository</th><th>Stars</th><th>Credits</th><th>Score</th></tr></thead><tbody></tbody></table></div>
<small>Illustrative Storybook snapshot. Credits measure attribution, not unique users.</small>
<script>
const records=[['juspay/hyperswitch',46434,117],['storybookjs/storybook',94832,56],['lacymorrow/crossover',1251,44],['smart-mcp-proxy/mcpproxy-go',387,57],['octasoft-ltd/wsl-ui',411,40],['s4solutionsllc/Nexis',87,131]];
const weight=document.querySelector('#weight'),query=document.querySelector('#query');
function render(){const w=Number(weight.value)/100;const rows=records.map(([name,stars,credits])=>({name,stars,credits,score:Math.pow(Math.log1p(stars),w)*Math.pow(Math.log1p(credits),1-w)})).sort((a,b)=>b.score-a.score);const max=rows[0].score;document.querySelector('#weights').textContent=weight.value+'% popularity · '+(100-weight.value)+'% attributed usage';const visible=rows.filter(r=>r.name.toLowerCase().includes(query.value.toLowerCase()));document.querySelector('#total').textContent=visible.length+' qualifying repositories';const body=document.querySelector('tbody');body.replaceChildren();visible.forEach(r=>{const tr=document.createElement('tr');[rows.indexOf(r)+1,r.name,r.stars.toLocaleString(),r.credits,(100*r.score/max).toFixed(1)].forEach((value,i)=>{const td=document.createElement('td');td.textContent=value;if(i===4){const bar=document.createElement('div');bar.className='bar';bar.style.width=(100*r.score/max)+'%';td.append(bar)}tr.append(td)});body.append(tr)})}
weight.addEventListener('input',render);query.addEventListener('input',render);render();
</script></body></html>