andodeki/makepad
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
makepad/docs/agents
History
Exact
Admin a45c57d534 ai: CUDA kernels behind a cuda feature that only the AI Hub enables (apps stay CPU-only; no CUDA rebuild ping-pong between hub and app launches) 
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-26 09:47:27 +01:00
..
change-report-example change_report: the change report format, its checker and the agents' steps for "send what I changed" -- people who install Makepad apps with the Builder change them with their own coding agent (Codex desktop or CLI, Claude Code, ...); a change report tells Makepad what they changed as concepts (what is different for someone using the app, and why), read and approved by them before it is sent. docs/agents/change-report.md is the format: a zip of at most 256 KB holding exactly report.json (format makepad-change-report, version 1: app id and release, optional base commits and summary, 1-100 changes with title, kind fix/feature/tweak/ui/performance/refactor/docs/other, what, why, areas and an optional tiny snippet, the redactions by kind and count, and whether a diff is included), REPORT.md (the same list for people, naming every change) and, only on opt-in, a trimmed changes.diff; UTF-8 text only, per-file limits, no binary patches, unknown fields refused. Its JSON schema is docs/agents/change-report.schema.json, with a complete example. The anonymisation rules say what an agent replaces with which bracketed placeholder ([name], [email], [path], [host], [secret], [private-url], [personal]) and lists. libs/change_report (makepad-change-report: strict-json, zip-file and fast-inflate only) checks a report exactly as documented, in the Builder before sending and on the server when it arrives: sizes before inflating (output bounded by the declared sizes, CRC checked), the schema, REPORT.md against the titles, the diff flag, and a safety-net scan for email addresses (not @example.*, @makepad.nl or git@), absolute and home paths (Unix, drive letters, shares), well-known key and token formats, Bearer tokens, quoted secret assignments, credentials in URLs and private network addresses, naming file, line and kind of each finding. The root AGENTS.md (which ships in every source pack) gets "Sending your changes to Makepad": find the installation, collect the changes with the Builder's changes command (or git), write the concept list, anonymise, show it and wait for approval (diff and reply email opt-in), write builder/changes/<app>-report, check it with send-changes, send with --yes (or leave it for the Builder's review, or POST the zip with curl), report the id. Tests: the documented example round-trips and opens, the schema file matches the checker's limits and kinds, every schema rule, zip contents and size limits (whole zip, a file's unpacked size, extra files, binary text, missing files, diff flag, binary patch), the anonymisation checklist (19 kinds of personal or secret data found, 16 look-alikes left alone), a refused report lists every finding, folder packing. Checked on the Linux node: cargo test --release -p makepad-change-report, 8 passed. 2026-09-29 14:13:13 +02:00
app-remote.md tools, libs and the rest 2026-10-13 12:26:21 +02:00
change-report.md tools, libs and the rest 2026-10-13 12:26:21 +02:00
change-report.schema.json change_report: the change report format, its checker and the agents' steps for "send what I changed" -- people who install Makepad apps with the Builder change them with their own coding agent (Codex desktop or CLI, Claude Code, ...); a change report tells Makepad what they changed as concepts (what is different for someone using the app, and why), read and approved by them before it is sent. docs/agents/change-report.md is the format: a zip of at most 256 KB holding exactly report.json (format makepad-change-report, version 1: app id and release, optional base commits and summary, 1-100 changes with title, kind fix/feature/tweak/ui/performance/refactor/docs/other, what, why, areas and an optional tiny snippet, the redactions by kind and count, and whether a diff is included), REPORT.md (the same list for people, naming every change) and, only on opt-in, a trimmed changes.diff; UTF-8 text only, per-file limits, no binary patches, unknown fields refused. Its JSON schema is docs/agents/change-report.schema.json, with a complete example. The anonymisation rules say what an agent replaces with which bracketed placeholder ([name], [email], [path], [host], [secret], [private-url], [personal]) and lists. libs/change_report (makepad-change-report: strict-json, zip-file and fast-inflate only) checks a report exactly as documented, in the Builder before sending and on the server when it arrives: sizes before inflating (output bounded by the declared sizes, CRC checked), the schema, REPORT.md against the titles, the diff flag, and a safety-net scan for email addresses (not @example.*, @makepad.nl or git@), absolute and home paths (Unix, drive letters, shares), well-known key and token formats, Bearer tokens, quoted secret assignments, credentials in URLs and private network addresses, naming file, line and kind of each finding. The root AGENTS.md (which ships in every source pack) gets "Sending your changes to Makepad": find the installation, collect the changes with the Builder's changes command (or git), write the concept list, anonymise, show it and wait for approval (diff and reply email opt-in), write builder/changes/<app>-report, check it with send-changes, send with --yes (or leave it for the Builder's review, or POST the zip with curl), report the id. Tests: the documented example round-trips and opens, the schema file matches the checker's limits and kinds, every schema rule, zip contents and size limits (whole zip, a file's unpacked size, extra files, binary text, missing files, diff flag, binary patch), the anonymisation checklist (19 kinds of personal or secret data found, 16 look-alikes left alone), a refused report lists every finding, folder packing. Checked on the Linux node: cargo test --release -p makepad-change-report, 8 passed. 2026-09-29 14:13:13 +02:00
local-ai.md ai: CUDA kernels behind a cuda feature that only the AI Hub enables (apps stay CPU-only; no CUDA rebuild ping-pong between hub and app launches) 2026-10-26 09:47:27 +01:00
splash.md docs: the agent guides cover the designer's routes, the tween inspector, hidden windows on Windows and the surface material 2026-10-02 08:52:56 +02:00
tweaker.md tools, libs and the rest 2026-10-13 12:26:21 +02:00
web-pack.md docs (agents): web packs and scan: -- web-pack.md says how cargo makepad wasm --pack collects (the collect-web run, Event::Scan, the manifest) and packs (shader pack, cut fonts, stripped JS sections), what a widget emits in a scan (ScanEvent::need_*) and what to do when a web build misses something; splash.md: widgets that create children from data carry a scan: [...] list of their templates by default, with an example. 2026-10-01 11:43:06 +02:00