paperclip/doc/plans/chat-adapters/wireframes-archive.md

2.6 KiB

Historical chat-adapter wireframes

All generated wireframe images and their HTML gallery are excluded from the PR. The final 67 v8 SVGs and gallery remain recoverable in the pre-removal archive. The 455 generated v1-v7 SVGs were removed earlier; their exact contents remain available in the pre-prune archive commit. Written plans, implementation, tests, and production provider icons remain.

The superseded v2 design note, v3 design note and v4 design note are also archived in Git history. This retains their exact decisions while keeping the combined implementation and upstream compatibility fixes within the 500-file review limit. Current designs and live qualification records remain in the working tree; the historical regeneration inputs remain in the archive below.

The retained generators are an ordered chain, not standalone snapshot builders; in particular, the v8 generator reads v7 outputs. For historical regeneration, use a scratch checkout of the pre-prune archive commit above so all snapshot notes and outputs are present. Run node generate-wireframes.mjs for v1 independently; then run node generate-wireframes-v2.mjs, node generate-provider-wireframes.mjs, and node generate-wireframes-v3.mjs through node generate-wireframes-v8.mjs in numeric order. These scripts also overwrite viewer/specification files such as index.html, so do not run them in a working tree with documentation changes you intend to keep.

The superseded v5 design note also remains available in Git history. Its separate setup audit stays in the working tree. The v6 surface note and minimum-setup specification remain here too; v6 was restored byte-for-byte when the CI-owned lockfile delta was removed. Archiving only v5 makes room for the pinned Discord WebSocket shutdown fix without splitting this review or dropping implementation/tests.