Business-Wrap

• Release zip: business-wrap-<version>.zip + .sha256 from https://github.com/NJ-Burrito/Business-Wrap/releases/latest. In that folder: npm ci.
• MCP from a clone: claude mcp add business-wrap -- node <path-to>/Business-Wrap/mcp/cli.mjs (no npm ci needed)
• Tools (15): build_editor, validate_edits, apply_edits, export_document, export_design_pack, check_fonts, harvest_model, harvest_crawl, harvest_merge, harvest_sources, open_in_editor, close_editor, diagram_mermaid, check_update, apply_update, plus the learning_* tools. A harvest tool given open: true opens its result in the editor. See mcp/README.md.

node engine/build-editor.mjs <doc.json | folder>... --out out/my.editor.html [--theme design/ours/theme.json] [--embed-fonts] [--ui ar|en]
node engine/export.mjs --doc <document.json> [--edits edits.json] [--locale ar|en] [--out dir]

Opened from disk (file://), «PDF + DOCX» downloads the edited document JSON and shows the export.mjs command; through npm run serve it exports in one click. The ready-made editor is assets/editor/business-wrap.html.

Installed as a plugin, Business-Wrap adds these commands; type / in Claude Code to see them. Each runs engine/cli.mjs (the same business-wrap <verb> you can run yourself, with no AI and no network) and says in one line what it did.

Without Claude Code the same verbs run as npm run cli -- <verb> (for example npm run cli -- open samples/event-permit, npm run host:close). Every verb works offline, with no AI.

At launch the editor (served by npm run serve -- <editor.html> or node engine/serve.mjs <editor.html>) checks for a newer release, at most once a day and without blocking anything. Update now downloads the release, checks its fingerprint, backs up, replaces the program files only, verifies the new version, restarts the server and reopens your document where you were. Your documents, edits and their history, design packs, fonts, logos, out/ and .local/ are never touched. Settings (toolbar View section, or Ctrl+K) shows About, the update state with Check now and the auto-check switch, and your preferences. Opened from disk (file://), the page cannot check: Settings says how to update. Every release: https://github.com/NJ-Burrito/Business-Wrap/releases. Details: bible/07-updates.md.

🔤 Every chosen font is embedded as real text in PDF and DOCX; the font's licence is your responsibility.

The crawler never files a request unless you ask. A crawl is a dry run: it reads every step and stops before the final action (Send, Submit, Confirm, Pay; «إرسال»، «تقديم»، «تأكيد»، «دفع»). Filing a real request needs submit: true in the config and --yes-file-real-request.

npm run harvest:model -- <process.bpmn | .drawio | .yaml>   # roles, workflow, rules, statuses
npm run harvest:crawl -- <crawl.json>                        # card, form, attachments, messages
npm run harvest:merge -- <harvest.json> <process.json>       # the union of both

Each gives the Arabic and English document JSON and an editor. In the editor: New document. See bible/08-harvest.md.

• Sticky selection tools. A block, a table cell, a logo, an image, a diagram shape or an arrow puts its own section first in the toolbar. It stays while you use menus, the Design panel, colour pickers or inline editors. A click on empty space, or Esc, returns the general tools.
• Sections that fold the same way in both languages. Every word keeps the width of the longer of its Arabic and English forms, so «ع» and «E» show the same tools in the same places.
• «ع» / «E» switch the interface language and the edition you edit; RTL / LTR switch the direction of the words.
• Commands (Ctrl+K): every action, searchable. Focus mode (F) hides the tools; Calm mode turns motion off (also on when the system asks for reduced motion).

Page views (View → Pages): Continuous is the long sheet; Single shows one page at a time; Book opens on the cover alone, then pairs pages in the document's reading direction (Arabic: first page of a pair on the right).

Diagrams: click a shape for shape tools, an arrow for arrow tools, the empty drawing for diagram tools. Drag to move, drag a corner to resize, drag an arrow's segment to bend it, double-click to edit a label, Ctrl + wheel to zoom. Import / Export Mermaid (npm run diagram:mermaid, MCP diagram_mermaid).

Design: colours by role, sizes and spacing, template parts (show, hide, order), printed labels, one block's own style (Style this) and sanitised advanced CSS.

Export & Print: one Export menu and one Print entry; PDF and DOCX per language or both, HTML, print HTML, edits, design pack, Mermaid / SVG / PNG of diagrams; page range and cover option.

Template packs: e-service, e-commerce, call-centre, approval, SaaS, generic IEEE 29148, plus your own (templates/_example-custom). Every requirement cites its evidence. See bible/09-template-packs.md.

Local learning: a journal of your edits in .local/learning/ on this machine only; npm run learn turns repeated corrections into rules for your AI agent. Settings → "Local learning" to switch it off or forget everything. See bible/10-learning.md.

• Documents («المستندات», Ctrl+O): every Save is a document of its own (a template is never overwritten); open here or in a new tab, duplicate, delete and restore, import PDF, DOCX or HTML.
• Changes («تغييرات», Ctrl+Shift+H): a timeline of every edit with back, forward and checkpoints; the counter starts again at each Save HTML.
• Save folder: <folder>\Business-Wrap\{PDF,DOCX,HTML,HISTORY}, files named <title>-<date>-<AR|ENG>, asked once on the first Save or export.
• Background host: closing the last tab saves every tab and stops the server; the next launch offers to resume everything or start new work.
• Header and Footer toolbar sections: text, fields, logos, page numbers; each item for every page, this page only, or from this page on; edited on each page in the page views.
• Page setup: A3, A4, A5, Letter, Legal; portrait or landscape for the whole document or one section; page breaks at a chosen section.
• Objects: tables, sections and chapters anywhere; copy and paste a whole block; free text boxes; images with Word's seven wrap modes.
• Format bar: colour, size, font, alignment, lists to six levels, quote, link, code; Ctrl+B / I / U.
• Everything editable: TOC entries, the document-control table, revisions; they get the table tools.
• Trust: profile, provenance per change, sign, share, lock and unlock, a tamper-evident history, a work report as PDF.
• Tooling: the business-wrap CLI (offline, no AI), "/" commands, MCP harvest → editor, healers and per-stage gates.
• Design: import a colour palette (with the contrast gate), logo motion, calmer side panels (groups collapsed), short click-to-dismiss toasts.

Machine settings (never committed): .local/config.json (gitignored) or environment variables; env wins.

Browser support: Chrome and Edge, latest stable (Chromium 120+).

Security gate:

$env:PYTHONUTF8 = "1"
python security/check.py --all   # tree + history + commit messages: no client content, secrets or local paths
python design/build.py           # palette contrast gate + theme
git config core.hooksPath .githooks