Skip to content

docs: scope follow-up overlay tooling gaps - #60

Open
andresdefi wants to merge 1 commit into
mainfrom
docs/overlay-tooling-gaps
Open

docs: scope follow-up overlay tooling gaps#60
andresdefi wants to merge 1 commit into
mainfrom
docs/overlay-tooling-gaps

Conversation

@andresdefi

Copy link
Copy Markdown
Owner

Summary

Proposal doc — no code changes. Captures four real overlay-tooling gaps hit while building decorative line + icon overlays for a marketing screenshot, with file:line citations, acceptance criteria, and S/M/L estimates so the work is unblocked when someone picks it up:

  • Gap 1 (M) Line shape minimum size — overlaySchema.size preprocess at packages/core/src/config/schema.ts:290 silently rewrites any value under 50 to ≥50 (legacy 1-50% migration), so 10-40 px speed lines aren't reachable.
  • Gap 2 (S) Line thickness — line height is hard-coded to 4px in packages/core/src/templates/injectors.ts:175 (server export) and packages/web-preview/src/client/hooks/useInstantPatch.ts (live canvas). No shapeStrokeWidth field.
  • Gap 4 (S → M) Icon catalog scope — the Lucide catalog is fully exposed (~1500 icons), but there's no list_icons MCP tool, so agents guess iconRef values instead of discovering them. Phase 1 = list_icons (S). Phase 2 = additional libraries (M per library, deferred).
  • Gap 5 (S) rotation description polish — the field is already in OVERLAY_FIELD_SCHEMA at packages/mcp/src/tools/overlay.ts:74 but buried in the tool description.

Gap 3 and Gap 6 from the original investigation prompt were already resolved by PR #59 (add_overlay icon bake + tool description fix). Numbering preserved for cross-reference; resolved gaps are not re-described.

Test plan

  • Doc only — no code change, no tests.
  • Reviewer: confirm file:line citations still match main (none of them are in files that change frequently, but worth a sanity check).

🤖 Generated with Claude Code

…s, icon discovery)

Snapshot of friction points hit while building decorative line + icon
overlays for a marketing screenshot. Four real gaps with file:line
citations, acceptance criteria, and S/M/L estimates:

- Line shape size floor: preprocess silently rewrites size<50 (M)
- No line thickness control: height hard-coded to 4px in two paths (S)
- No `list_icons` MCP tool, so agents guess `iconRef` values (S)
- `add_overlay` description undersells the already-exposed rotation (S)

Picks up after PR #59 which fixed the icon-render and tool-description
gaps end-to-end.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant