Skip to content

feat(author): route 4's link is written by the model, with the source as readable JSON, and no code block - #207

Merged
alekswebnet merged 2 commits into
mainfrom
feat/route4-readable-link
Nov 15, 2026
Merged

alekswebnet merged 2 commits into
mainfrom
feat/route4-readable-link

Conversation

@alekswebnet

@alekswebnet alekswebnet commented Nov 14, 2026 •

Copy link
Copy Markdown
Contributor

Closes #206.

Route 4, where nothing is built in the chat, now hands the source over as one Markdown link that the model writes itself, with the source in it as readable JSON. There is no code block, no Preview and no command: the person clicks the link. It needs the build page to read that form, which missing-elements/missing-elements.github.io#54 adds, so this should merge only after #54 is live.

What changes

  • skills/h5p-author/references/build/browser.md: the page template is gone. The model writes [Build and play it](https://missing-elements.github.io/h5p/build/#source=…) with the source on one line. Eight characters are escaped (space % & \ ( ) < >), and everything else stays as it is, letters of any language included. A table and one example show it, and the text says the link ends with a ) after the source's last }.
  • What the reply holds, as a list: the link; one line asking the person to click it, which adds that the page asks for the files where the source names any (a link now carries such a source too); and, only where a code tool runs, the line offering the build archive.
  • Outside a chat, the source also goes to <name>.source.json, since a terminal may not open such a link. The build page opens that file.
  • Unchanged: routes 1–3 and the compressed link their command prints (built-here.md).
  • design/author.md: a new rule, In route 4 the model writes the link, the source in it as JSON, with what each wording cost. The page rule and the route-4 line of the h5p-author: one file per build route, picked by checks in SKILL.md #204 rule point to it, and the count is twenty-nine.

Tested

Haiku, the weakest model first, reading the skill through a logging reader. Each reply was rendered by markdown-it as a chat renders Markdown, and its link was read by Node's URL as a browser reads it, decoded as the build page of #54 decodes it, built with h5p-author and verified with h5p-verify.

Text Built and passed
Seven escapes, the reply's parts in prose 5 of 7. A True/False left one closing } out. An Accordion on HTML tags wrote &lt;, which Markdown turns into <, and no ) to close the link.
& escaped too, the link's closing ) named, and #54 closing up to three open braces 12 of 12, none needing a closer: three Accordions on HTML tags, three True/False questions naming cat.jpg, five Question Sets (one Ukrainian, three from a code tool with no network), a Drag the Words with % and parentheses

No reply held a code block or the source a second time. Links ran from 0.5 to 6.9 KB as written, and a Ukrainian one to 16.6 KB once its letters are escaped. The archive line, as an item of the reply's list, came out in 2 of 2 runs with a code tool and none without one. As a last paragraph it came out in 1 of 2 with a code tool and 1 of 6 without one.

pnpm test in packages/author passes (184).

Not measured: what ChatGPT's renderer and other chat apps make of such a link, and how long a link they keep clickable. That is the owner's run, once #54 is live.


Summary by cubic

Route 4, where nothing is built in the chat, now hands the source to the build page as one Markdown link the model writes itself, with the source in it as readable JSON. The HTML page template, code block, Preview step, and command are gone: the person clicks the link. Routes 1–3 and the compressed link their command prints are unchanged. Closes #206.

This depends on missing-elements/missing-elements.github.io#54, which adds build-page support for that form — merge only after it is live.

Changed

  • skills/h5p-author/references/build/browser.md no longer contains a page template. The model writes [Build and play it](https://missing-elements.github.io/h5p/build/#source=…) with the whole source as JSON on one line. Eight characters are escaped (space % & \ ( ) < >); everything else, letters of any language included, stays as is.
  • The reply holds, as a list: the link, one line asking the person to click it (adding that the page asks for the files where the source names any), and, only where a code tool runs, the archive line.
  • Outside a chat the source also goes to <name>.source.json, since a terminal may not open such a link.
  • design/author.md records the new rule In route 4 the model writes the link, the source in it as JSON, with what each wording cost; the rule count goes from twenty-eight to twenty-nine.

Written for commit c14f16c. Summary will update on new commits.

View guided diff Turn on auto-fix

… the source in it as JSON, and no code block

@cubic-dev-ai cubic-dev-ai Bot left a comment •

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

All reported issues were addressed across 2 files

Reply with feedback, questions, or to request a fix.

View guided diff | Turn on auto-fix | Re-trigger cubic

Comment thread design/author.md Resolved
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.

h5p-author route 4: the model writes the build page's link with the source as readable JSON, no code block

1 participant