marco/open-design
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
automation/refresh-contributors-wall
open-design/docs/plans/manual-edit-mode-implementation.md
marco 5dd70b5016
Some checks failed
ci / Validate workspace (push) Successful in 12m32s
Details
landing-page-ci / Validate landing page (push) Successful in 9m41s
Details
landing-page-deploy / Deploy landing page (push) Failing after 5m23s
Details
github-metrics / Generate repository metrics SVG (push) Failing after 2m3s
Details
refresh-contributors-wall / Refresh contributors wall cache bust (push) Failing after 11s
Details
Initial import: open-design source for helix-mind.ai distribution 
This repository contains the open-design daemon CLI source code, built
and packaged at https://helix-mind.ai/cli/open-design/latest.tgz for use
by the HelixMind /design slash command.

Licenses: Apache-2.0 (root) + MIT (skills/*)
2026-05-06 20:50:24 +02:00

2.0 KiB
Raw Permalink Blame History

Manual Edit Mode Implementation Plan

Source requirement: specs/current/manual-edit-mode-requirements.md.

Base branch: origin/main at 72edd4fc6090a3fda4ed175bd35dca76099a82f2.

Implementation branch: codex/manual-edit-mode.

Goal

Migrate the accepted manual edit-mode prototype into the production Open Design web app.

The product boundary is fixed:

  • Edit is manual HTML/CSS editing.
  • Comment remains the AI-assisted scoped edit path.
  • Tweaks is for global/token parameters.
  • Draw is annotation input and does not mutate HTML/CSS in v1.

Implementation Steps

  1. Add apps/web/src/edit-mode/ with typed targets, patches, history, iframe bridge, and source patch helpers.
  2. Integrate manual edit state into the HTML branch of FileViewer.
  3. Enable the existing Edit toolbar button only for HTML/deck-HTML artifacts.
  4. Keep comment mode and edit mode mutually independent; do not send manual edits to chat or daemon agent runs.
  5. Save manual patches through the existing project file write provider, then refresh preview source.
  6. Add the accepted layout: layers rail, canvas-first preview, right edit modal, and changes panel.
  7. Add English i18n keys plus conservative fallback locale entries.
  8. Add focused tests for patch helpers and the main browser smoke path.

Acceptance Criteria

  • Manual edit mode starts from latest origin/main.
  • User can select a preview element or a layer row.
  • Content, style, attributes, selected HTML, and full source edits are source-backed.
  • Undo and redo work during the session.
  • Attribute edits do not delete unrelated attributes or prior style edits.
  • Comment mode still works as the AI edit path.
  • Share/export and deck navigation still work after the edit-mode changes.

Verification Commands

pnpm --filter @open-design/web typecheck
pnpm --filter @open-design/web test
pnpm --filter @open-design/e2e test:ui -- --grep "manual edit"
pnpm typecheck
pnpm test
pnpm check:residual-js