Skip to content

docs: add maintainable token tutorial production toolkit - #1175

Draft
Claudius-Maginificent wants to merge 5 commits into
v1.0-devfrom
docs/token-tutorial-toolkit
Draft

Claudius-Maginificent wants to merge 5 commits into
v1.0-devfrom
docs/token-tutorial-toolkit

Conversation

@Claudius-Maginificent

@Claudius-Maginificent Claudius-Maginificent commented Nov 11, 2026 •

Copy link
Copy Markdown
Collaborator

TL;DR: Add a source toolkit for maintaining the six-part English token tutorial and preparing reproducible future edits, with current instructions, recorded test evidence and explicit gaps in live coverage.

User story

As a tutorial maintainer, I can update the dialogue and screen plan, check them against the application, and prepare a new edit while keeping private recordings, credentials and wallet data outside the repository.

Scenario

Base flow

A maintainer revises the tutorial after the application changes, checks the instructions and demonstrations, then prepares an approved recording and narration session.

Actual behavior

Production sources are maintained outside the repository, and the original film describes an older creator. Updates can mix outdated controls, examples, captions and narration.

Expected behavior

The repository provides the complete editable lesson, a readable transcript, a screen and control checklist, and a repeatable production workflow. Each claimed result has a stated verification scope. Historical recordings remain clearly separate from the current lesson.

Detailed discussion

What was done

  • Add tools/token-tutorial/ with canonical dialogue, synchronized transcript and scene plan, source anchors, a walkthrough checklist, editable slides, eight worked emission examples, production scripts and regression tests.
  • Preserve 54 scenes in six episodes, the seven-section creator, and 366 control references covering permissions, distributions, groups, history, discovery, document types, preparation, registration and recovery. The help inventory contains 90 topics.
  • Preserve Chad G. P. Taylor (Cedar), Ewa Dashwood (Nova), natural English dialogue, the AI-generated presentation disclosure and three seconds of opening silence.
  • Provide offline-first narration planning, explicit approved-hash execution, guarded reuse, isolated GUI capture, media assembly, captions and provenance checks. Changes to source, voice or instructions invalidate incompatible narration reuse; uncertain requests are not automatically retried.
  • Keep recordings, generated narration, private profiles, credentials, fonts and model binaries outside Git. Accepted media metadata and timed subtitles remain an immutable historical archive; their hashes reject direct reuse with the refreshed dialogue.
  • Target DET 77c2a6c92e0d136dcb1be616277bbe1d4a9ed94c and Platform 575d961fe0c54bd7e01a3cf3823494e58c6c4fdb. The tutorial describes the creator in feat(ui): align app-wide styles with the token proposal #1177 with the export and navigation fixes in fix(tokens): keep JSON export responsive when the file chooser stalls #1178 and fix(tokens): retain the creator when opening a registered contract #1179. This PR targets v1.0-dev and contains no Rust application changes.

Testing

  • Current project/source checks: 5 passed. The existing offline toolkit suite has 89 passed evidence; it was not rerun in full for the final source-only update. Formatting and diff checks passed.

  • Independent review of the core lesson and the final scoped source update found no open content defects. The final check verified all 54 scene-plan/checklist blocks, the exact readable transcript, 23 source anchors, all eight evidence hashes and six frozen follow-up ledgers.

  • Live observations retain their actual revision scopes:

    Application revision Verified scope
    9759930 Original control/help observations, all eight emission previews with eleven rows each, and the first fixed-policy accepted registration. Its QA name differs from illustrative CloudCredit.
    9c41644 — fix(tokens): keep JSON export responsive when the file chooser stalls #1178 Eleven export checks from an accepted receipt: exact bytes, cancellation, explicit replacement, failure correction, native selection, stalled-chooser fallback and discarded late selection.
    77c2a6c — fix(tokens): retain the creator when opening a registered contract #1179 Exact CloudPoint preparation and accepted registration; four receipt-navigation checks, including returning to the retained Creator receipt and starting a fresh draft.
  • Both accepted contracts matched their respective reviewed canonical configurations, excluding only created/updated metadata. CloudPoint's five owner performers and per-mint recipient choice require explicit customization beyond the limited owner example.

  • Live coverage remains partial: 36 of 90 help dialogs were exercised. The other 54 topics, remaining keyboard/focus paths, prepared-state file export, unknown-outcome/conflict/local-restoration branches, allocations, claims and post-registration token actions remain separate TODOs. Normal creation and loading an existing receipt do not verify recovery.

  • No new recording, audio generation or narration-provider calls were performed or approved for this refresh. Full Rust CI is not claimed for this draft documentation/tooling PR.

Evidence: core source and GUI review, current source validation, independent follow-up audit and coverage.

Related application changes

  • #1177: the Token Creator described by the lesson.
  • #1178: responsive JSON export with explicit path entry and save confirmation.
  • #1179: contract preview preserves the Creator receipt and its return path.

🤖 Co-authored by Claudius the Magnificent AI Agent

lklimek and others added 2 commits November 11, 2026 11:29
Preserve the approved scenario, transcripts, narration journal, capture helpers,
and media renderer with portable manifests and a complete regeneration runbook.
Reuse verified takes offline and require explicit approval for paid requests.

<sub>🤖 Co-authored by [Claudius the Magnificent](https://github.com/lklimek/claudius) AI Agent</sub>

Co-Authored-By: Claude GPT-6 <noreply@anthropic.com>
Keep private build inputs outside published media, make slide imports inert,
and support ffconcat paths containing spaces and apostrophes. Correct default
asset references and document the screenshot dependency.

<sub>🤖 Co-authored by [Claudius the Magnificent](https://github.com/lklimek/claudius) AI Agent</sub>

Co-Authored-By: Claude GPT-6 <noreply@anthropic.com>
@coderabbitai

coderabbitai Bot commented Nov 11, 2026

Copy link
Copy Markdown
Contributor

Important

Draft PR not reviewed

Draft PRs are not automatically reviewed by default.

  • Trigger a manual review

To automatically review draft PRs, update your CodeRabbit configuration:

reviews:
  auto_review:
    drafts: true
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

Share

@thepastaclaw

thepastaclaw commented Nov 11, 2026 •

Copy link
Copy Markdown
Collaborator

🕓 Review not started yet because this PR is a draft.

  • Request normal review — click when the PR is ready for review.
  • Request priority review — click to move this review to the front of the queue.

Commit 6f44181. Normal review starts when eligible; priority review starts as soon as a slot is available.

lklimek and others added 3 commits November 12, 2026 19:21
Rewrite the six-part conversation and scene plan against the pinned PR1177
application. Cover current controls, eight worked formulas, complete authority
rules, prepared review and recovery gates. Keep historical media archival and
reject stale take reuse; add a reusable scene and help checklist.

Validation: 89 offline toolkit tests passed; final focused source/slide checks
6 passed. No narration, recording, provider API or paid token action performed.

<sub>🤖 Co-authored by [Claudius the Magnificent](https://github.com/lklimek/claudius) AI Agent</sub>

Co-Authored-By: Claude GPT-6 <noreply@anthropic.com>
Record exact prepared CloudPoint coverage, the validated property-position
example, partial help/export checks and the funding failure before registration.
Keep archived media provenance unchanged and synchronize the current sources.

<sub>🤖 Co-authored by [Claudius the Magnificent](https://github.com/lklimek/claudius) AI Agent</sub>
Co-Authored-By: Claude GPT-6 <noreply@anthropic.com>
Record both accepted registrations, fresh-wallet funding and the scoped JSON
export and retained-receipt navigation checks. Preserve remaining live gates,
archive hashes and separate revision provenance; synchronize source derivatives.

<sub>🤖 Co-authored by [Claudius the Magnificent](https://github.com/lklimek/claudius) AI Agent</sub>
Co-Authored-By: Claude GPT-6 <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.

3 participants