From 0889201e91312f656739421ddedbcc059578fabd Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Mon, 9 Nov 2026 18:23:47 +0000 Subject: [PATCH] docs: add the unsent M0 promotion pack Refs #13473. Planning files under docs/promotion and a local promotion_kernel gate in specs/promotion/t27l_promotion.t27. No network post was sent. The child issues stay open: this change also edits docs/README.md, which is outside each child Boundary. Co-authored-by: Dmitrii Vasilev --- .trinity/seals/promotion_promotion_t27l.json | 28 +++++++ docs/README.md | 6 ++ docs/promotion/README.md | 50 ++++++++++++ docs/promotion/baseline.json | 52 ++++++++++++ docs/promotion/baseline.md | 59 ++++++++++++++ docs/promotion/content-bank.json | 18 +++++ docs/promotion/content-bank.md | 21 +++++ docs/promotion/content-calendar.md | 39 +++++++++ docs/promotion/contributor-path.md | 33 ++++++++ docs/promotion/course-map.md | 62 ++++++++++++++ docs/promotion/funnel.md | 29 +++++++ docs/promotion/good-first-issue-template.md | 24 ++++++ docs/promotion/metrics.md | 32 ++++++++ docs/promotion/monetization-ladder.md | 24 ++++++ docs/promotion/publish-gate.md | 38 +++++++++ docs/promotion/self-improving-loop.md | 26 ++++++ docs/promotion/t27l-promotion-schema.md | 48 +++++++++++ docs/promotion/weekly-report-template.md | 32 ++++++++ docs/promotion/widget-inventory.json | 27 +++++++ docs/promotion/widget-inventory.md | 41 ++++++++++ specs/promotion/t27l_promotion.t27 | 85 ++++++++++++++++++++ 21 files changed, 774 insertions(+) create mode 100644 .trinity/seals/promotion_promotion_t27l.json create mode 100644 docs/promotion/README.md create mode 100644 docs/promotion/baseline.json create mode 100644 docs/promotion/baseline.md create mode 100644 docs/promotion/content-bank.json create mode 100644 docs/promotion/content-bank.md create mode 100644 docs/promotion/content-calendar.md create mode 100644 docs/promotion/contributor-path.md create mode 100644 docs/promotion/course-map.md create mode 100644 docs/promotion/funnel.md create mode 100644 docs/promotion/good-first-issue-template.md create mode 100644 docs/promotion/metrics.md create mode 100644 docs/promotion/monetization-ladder.md create mode 100644 docs/promotion/publish-gate.md create mode 100644 docs/promotion/self-improving-loop.md create mode 100644 docs/promotion/t27l-promotion-schema.md create mode 100644 docs/promotion/weekly-report-template.md create mode 100644 docs/promotion/widget-inventory.json create mode 100644 docs/promotion/widget-inventory.md create mode 100644 specs/promotion/t27l_promotion.t27 diff --git a/.trinity/seals/promotion_promotion_t27l.json b/.trinity/seals/promotion_promotion_t27l.json new file mode 100644 index 0000000000..35ca935c2d --- /dev/null +++ b/.trinity/seals/promotion_promotion_t27l.json @@ -0,0 +1,28 @@ +{ + "built_by": "t27c-bootstrap@0.5.2+116178f1d", + "closure": [], + "config": "gen=c,rust,verilog,zig;tests=zig", + "gen_hash_c": "sha256:ac1bc71e3fb8077927876b02b4784ed7cd829bab6ef634c59baa886e4002377a", + "gen_hash_rust": "sha256:4c98699ffa7aaa447963d8436399140627e2b23bffed9354fd4910af7147e667", + "gen_hash_verilog": "sha256:8986ee282cd9a04b35123b534764c9a6721e09e7cf1fd295eb939b2b612eecc9", + "gen_hash_zig": "sha256:b4ba4e472b74fddad87c8b0a49f6bf4ae755f6175bbe030bdb014406b72fc561", + "module": "promotion_t27l", + "ring": 12, + "seal_schema": 2, + "sealed_at": "2026-11-09T18:16:47Z", + "sealed_by": "t27c-bootstrap@0.5.2", + "spec_hash": "sha256:a086430758531b6918cb62209c7de538250d4771e7e9b7430b35319501911e2a", + "spec_path": "specs/promotion/t27l_promotion.t27", + "tests": { + "failed": 0, + "failing": [], + "forced": false, + "passed": 6, + "total": 6, + "vacuous": 0 + }, + "toolchain": { + "test_runner": "sha256:1a50286d6170ef41c779d26385a1be59823925d7131497c93d84194144ba93b3", + "zig": "0.16.0" + } +} \ No newline at end of file diff --git a/docs/README.md b/docs/README.md index 46f5ae0651..07f2f6a347 100644 --- a/docs/README.md +++ b/docs/README.md @@ -54,6 +54,12 @@ TDD, bootstrap/testing plans, math/physics test framework charter, PHI loop, tec | [`nona-03-manifest/VIZ-PETAL-GUIDE.md`](nona-03-manifest/VIZ-PETAL-GUIDE.md) | Contributor guide: add the visualization for one more petal (start, write, test, check, land) through `viz_contract` and `petal_viz_plan` (#12173) | | [`nona-03-manifest/ELECTRONICS-101-TEARDOWN.md`](nona-03-manifest/ELECTRONICS-101-TEARDOWN.md) | Teardown of electronics-101-six.vercel.app: lesson-as-data architecture, `/closed-loop` vertical slice, 48-lesson content tree, learning model and a course-27 mapping | +## Promotion kernel (M0 planning, not published) + +| Path | Role | +|------|------| +| [`promotion/README.md`](promotion/README.md) | Index of the #13473 planning pack. Drafts stay unsent until a named owner approval. | + ## External Projects | Project | Description | Link | diff --git a/docs/promotion/README.md b/docs/promotion/README.md new file mode 100644 index 0000000000..abb9b4d205 --- /dev/null +++ b/docs/promotion/README.md @@ -0,0 +1,50 @@ +# Promotion kernel, M0 + +Part of #13473. Planning and drafts only. Nothing in this directory was posted, scheduled, or mailed. The publish gate is `publish-gate.md`. + +`docs/README.md` links this index because a new `docs/` directory has to be on that map. + +## Deliverables + +| Issue | File | +| --- | --- | +| #13474 | `baseline.md`, `baseline.json` | +| #13475 | `course-map.md` | +| #13476 | `widget-inventory.md`, `widget-inventory.json` | +| #13477 | `content-calendar.md` | +| #13478 | `content-bank.md`, `content-bank.json` | +| #13479 | `funnel.md` | +| #13480 | `metrics.md`, `weekly-report-template.md` | +| #13481 | `contributor-path.md`, `good-first-issue-template.md` | +| #13482 | `monetization-ladder.md` | +| #13483 | `t27l-promotion-schema.md`, `specs/promotion/t27l_promotion.t27` | +| #13484 | `self-improving-loop.md` | +| #13485 | `publish-gate.md` | + +These issues stay open. Each child issue says a landing that finishes it changes only that issue's Boundary paths. This pack also edits `docs/README.md` and adds one spec plus its seal, so it does not claim to finish them. + +## Other open social and media tasks + +Measured with `gh search issues --repo Trinity-S-AI-DNA/t27 --state open` and `gh issue view`. Home skill files were checked with `test -e` on this VM: `/home/ubuntu/.claude` and `/home/ubuntu/.codex` are absent, so the Mac skill files named in the cloud brief are not here. + +| Issue | State | Where it runs now | This run | +| --- | --- | --- | --- | +| #12630 tri blog | OPEN | `specs/tri/blog/blog.t27` absent (`test -f` exit 1). Built `tri` is not given a blog subcommand by this pack. | not started. Rust glue needs the owner-approved-foreign label the issue names. | +| #12866 t27b post on t27.ai | OPEN | `specs/blog/t27b_progress.t27` exists. `curl` of `https://t27.ai/blog/t27b-against-other-second-backends/` returned HTTP 404. | not published. | +| #12865 append 2026-10-28 lab entry | OPEN | The spec's newest entry is still 2026-10-05 (`DATE` `[20261004, 20261005]`). `curl` of `https://t27b-lab-production.up.railway.app/latest.json` returned HTTP 404. | not appended. The issue requires the lab summary object. | +| #12869 t27b blog steward cron | OPEN | No new cron card in this pack. | not added and not run. | +| #12631 epic progress card batch | OPEN | `specs/blog/epic_progress.t27` is the merge-train post, three entries, not the 37-card batch the issue describes. | not rewritten. Replacing that file would drop the existing post. | +| #13248 course bench-board post | OPEN | `specs/blog/course_bench_board.t27` absent. Trinity issue #1806 is OPEN (`gh issue view 1806 --repo Trinity-S-AI-DNA/trinity`). | not started. | +| #13273 queen stack progress card | OPEN | `specs/blog/queen_stack_progress.t27` absent. | not started. The issue also edits `AGENTS.md`, `access-map`, and `docs/t27os/keys-orchestration.md`. | +| #5629 blog to social networks | OPEN | Law in `specs/automation/blog-share.t27` version 5. Host named there is 999-multibots-telegraf, not this VM. | not posted. | +| #5626 first post through network APIs | OPEN | GitHub issue. | not posted. | +| #5625 connect Threads, Facebook, Instagram, LinkedIn, X | OPEN | GitHub issue. | accounts not connected. | +| #8318 blog-share v6 autopost | OPEN | Would post every new article to X, Telegram, and other networks. | not implemented. | +| #11620 Instagram reels via Graph API | OPEN | GitHub issue. | not published. | +| #10915 content factory epic | OPEN | `specs/t27f/post_caption.t27` present. Skill card `specs/skills/t27-social-pack.t27` present. Cover PR #10830 is MERGED (`gh issue view 10830`). | no new post. | +| #10560 lesson reels | OPEN | Epic. Publishing is out of its boundary until the owner says yes. | no render and no post. | +| #9063 course factory | OPEN | Epic. Course rows are copied into `course-map.md` only. | no new course page. | + +`gh search issues` for `habr` in this repo, state open, limit 15, returned no rows. `content plan` returned no rows. `back-catalogue` and `back catalogue` returned no social-task title; the hits were unrelated. `notebooklm` returned port and CI titles, and the media back-catalogue skill file is absent, so that catalogue was not run. `terminal cast` returned #13267 and #11780; those titles are a queen ring and widget cards, and the terminal-cast skill file is absent, so no cast asset was made. + +X handle `@t27_dev` is named in `specs/automation/blog-share.t27`. Followers and impressions are unavailable (`client-not-enrolled`). See `baseline.md`. diff --git a/docs/promotion/baseline.json b/docs/promotion/baseline.json new file mode 100644 index 0000000000..2b29b6824e --- /dev/null +++ b/docs/promotion/baseline.json @@ -0,0 +1,52 @@ +{ + "part_of": 13473, + "issue": 13474, + "status": "DRAFT_UNSENT", + "published": false, + "measured_at_utc": "2026-11-09T18:23:02Z", + "repo": "Trinity-S-AI-DNA/t27", + "master_sha": "116178f1d9ccec481ebc41d82cd7eb8d13d6ff2a", + "master_commit_time": "2026-11-09 15:09:35 +0000", + "github": { + "stars": 5, + "forks": 4, + "open_issues_count_includes_pull_requests": 2109, + "open_issues_search": 2041, + "open_pull_requests_search": 68, + "contributors_anon": 31, + "repo_pushed_at": "2026-11-09T18:19:51Z", + "commands": [ + "gh api repos/Trinity-S-AI-DNA/t27 --jq '{stars:.stargazers_count,forks:.forks_count,open_issues_count:.open_issues_count,pushed:.pushed_at}'", + "gh api -X GET search/issues -f q='repo:Trinity-S-AI-DNA/t27 is:issue is:open' -f per_page=1 --jq .total_count", + "gh api -X GET search/issues -f q='repo:Trinity-S-AI-DNA/t27 is:pr is:open' -f per_page=1 --jq .total_count", + "gh api 'repos/Trinity-S-AI-DNA/t27/contributors?per_page=100&anon=true' --jq length" + ] + }, + "x": { + "handle": "t27_dev", + "handle_source": "specs/automation/blog-share.t27", + "followers": null, + "impressions": null, + "status": "unavailable", + "reason": "get_users_by_username t27_dev returned client-not-enrolled" + }, + "course": { + "lesson_count_t27": 27, + "lesson_count_source": "specs/course/lesson_frames.t27 LESSON_COUNT", + "trinity_course_blob_sha": "3b3aa5d21a1dc86876c5b873bf6d6b8cf8d20b21", + "trinity_course_blob_size": 28305, + "trinity_lesson_count": 27, + "tasks_in_fpga_course_v2": 12, + "tasks_done": 6, + "tasks_parked": 3, + "tasks_claimed": 1, + "tasks_open": 2, + "task_state_source": "specs/course/fpga_course_v2.t27 TASK_STATE" + }, + "blog_t27b_url": { + "url": "https://t27.ai/blog/t27b-against-other-second-backends/", + "http_status": 404 + }, + "conformance_v0_json_files": 109, + "conformance_count_note": "ls conformance/vectors/*_conformance_v0.json | wc -l. This is not the epic phrase '6 bit-exact conformance packs', which was not remeasured." +} diff --git a/docs/promotion/baseline.md b/docs/promotion/baseline.md new file mode 100644 index 0000000000..4f9dafffc3 --- /dev/null +++ b/docs/promotion/baseline.md @@ -0,0 +1,59 @@ +# Promotion baseline + +Part of #13473. Issue #13474. Status: DRAFT_UNSENT. Nothing in this file was posted, scheduled, or mailed. + +Measured at 2026-11-09T18:23:02Z (`date -u +%Y-%m-%dT%H:%M:%SZ`). Machine-readable copy: `docs/promotion/baseline.json`. + +## GitHub + +Repository `Trinity-S-AI-DNA/t27`. Master commit `116178f1d9ccec481ebc41d82cd7eb8d13d6ff2a`, commit time `2026-11-09 15:09:35 +0000` (`git log -1 --format='%H %ci' origin/master` after `git fetch origin master`). + +| Field | Value | Command | +| --- | --- | --- | +| stars | 5 | `gh api repos/Trinity-S-AI-DNA/t27 --jq .stargazers_count` | +| forks | 4 | same call, `.forks_count` | +| open_issues_count | 2109 | same call, `.open_issues_count` (GitHub includes open pull requests) | +| open issues | 2041 | `gh api -X GET search/issues -f q='repo:Trinity-S-AI-DNA/t27 is:issue is:open' -f per_page=1 --jq .total_count` | +| open pull requests | 68 | `gh api -X GET search/issues -f q='repo:Trinity-S-AI-DNA/t27 is:pr is:open' -f per_page=1 --jq .total_count` | +| contributors | 31 | `gh api 'repos/Trinity-S-AI-DNA/t27/contributors?per_page=100&anon=true' --jq length` | +| repo pushed_at | 2026-11-09T18:19:51Z | same repo call, `.pushed_at` | + +2041 + 68 = 2109, which matches `open_issues_count`. `pushed_at` and the master commit time are two different API fields; this file does not explain the gap. + +## X + +Handle named in `specs/automation/blog-share.t27`: `@t27_dev`. + +Followers: unavailable. Impressions: unavailable. + +`get_users_by_username` for `t27_dev` returned `client-not-enrolled`. No post was sent. No impression count exists in this run. + +## Course + +| Field | Value | Source | +| --- | --- | --- | +| lesson count in this repo | 27 | `specs/course/lesson_frames.t27` `LESSON_COUNT` | +| lesson count in the live course spec | 27 | `Trinity-S-AI-DNA/trinity` `apps/website/specs/course/course.t27`, blob sha `3b3aa5d21a1dc86876c5b873bf6d6b8cf8d20b21`, size 28305 (`gh api repos/Trinity-S-AI-DNA/trinity/contents/apps/website/specs/course/course.t27 --jq '{sha,size}'`) | +| course title | From zero to a chip: FPGA programming with t27 | `TITLE` in that blob | +| v2 task rows | 12 | `specs/course/fpga_course_v2.t27` `TASK_COUNT` | +| done / parked / claimed / open | 6 / 3 / 1 / 2 | `TASK_STATE` `[2, 2, 3, 1, 2, 2, 2, 2, 3, 3, 0, 0]` with `DONE=2`, `PARKED=3`, `CLAIMED=1`, `OPEN=0` | +| t27b blog URL | HTTP 404 | `curl -sS -o /tmp/blog-body.html -w '%{http_code}' https://t27.ai/blog/t27b-against-other-second-backends/` | + +The map of the 27 lessons is `docs/promotion/course-map.md`. Lesson prose from the trinity blob was not copied: `specs/course/fpga_course_v2.t27` weak point W1 says lesson 1 and lesson 3 still name the wrong board. + +## Conformance files, not the paper phrase + +`ls conformance/vectors/*_conformance_v0.json | wc -l` printed 109. Issue #13473 lists the approved sentence "6 bit-exact conformance packs." That sentence was not remeasured here. The two numbers are different quantities. + +## Promotional items + +No item in this baseline is publishable. Drafts that quote the approved sentences are in `docs/promotion/content-bank.md`. Each one has claim, artifact, path, visual, CTA, and metric, and `published` is false. + +| Field | This baseline | +| --- | --- | +| claim | N/A -- this file records reach, not a paper sentence | +| artifact | `docs/promotion/baseline.json` | +| reproducible path | the commands in the tables above | +| visual | N/A -- no screenshot taken | +| CTA | N/A -- not sent | +| metric | the GitHub counts above; X metrics unavailable | diff --git a/docs/promotion/content-bank.json b/docs/promotion/content-bank.json new file mode 100644 index 0000000000..be2e780d2e --- /dev/null +++ b/docs/promotion/content-bank.json @@ -0,0 +1,18 @@ +{ + "part_of": 13473, + "issue": 13478, + "status": "DRAFT_UNSENT", + "published": false, + "remeasured": false, + "drafts": [ + {"id": "D01", "claim": "84 formats in one vendor-neutral catalog.", "artifact": "https://arxiv.org/abs/2606.09686", "path": "not remeasured", "visual": null, "cta": "read the paper", "metric": "not measured", "sent": false}, + {"id": "D02", "claim": "6 bit-exact conformance packs.", "artifact": "https://arxiv.org/abs/2606.09686", "path": "not remeasured", "visual": null, "cta": "read the paper", "metric": "not measured", "sent": false}, + {"id": "D03", "claim": "Every pack has a SHA-256 fingerprint.", "artifact": "https://arxiv.org/abs/2606.09686", "path": "not remeasured", "visual": null, "cta": "read the paper", "metric": "not measured", "sent": false}, + {"id": "D04", "claim": "BF16: 21/21 vectors match ml_dtypes.", "artifact": "https://arxiv.org/abs/2606.09686", "path": "not remeasured", "visual": null, "cta": "read the paper", "metric": "not measured", "sent": false}, + {"id": "D05", "claim": "FP8 E4M3: 15/16 vectors match; the difference is documented.", "artifact": "https://arxiv.org/abs/2606.09686", "path": "not remeasured", "visual": null, "cta": "read the paper", "metric": "not measured", "sent": false}, + {"id": "D06", "claim": "We publish abs_error instead of hiding it.", "artifact": "https://arxiv.org/abs/2606.09686", "path": "conformance/vectors/abs_error_allowlist.json exists; not rechecked", "visual": null, "cta": "read the paper", "metric": "not measured", "sent": false}, + {"id": "D07", "claim": "One catalog generates Markdown, JSON, Python, Rust, C, and TypeScript.", "artifact": "https://arxiv.org/abs/2606.09686", "path": "not remeasured", "visual": null, "cta": "read the paper", "metric": "not measured", "sent": false}, + {"id": "D08", "claim": "No Vivado. Open tools only.", "artifact": "https://arxiv.org/abs/2606.09686", "path": "trinity course MODULE_LINES index 7", "visual": null, "cta": "open the course spec", "metric": "not measured", "sent": false}, + {"id": "D09", "claim": "Every course widget is a compiled t27 spec.", "artifact": "trinity course blob 3b3aa5d21a1dc86876c5b873bf6d6b8cf8d20b21", "path": "specs/widgets/gallery.t27 absent in this checkout", "visual": null, "cta": "see course-map.md", "metric": "not measured", "sent": false} + ] +} diff --git a/docs/promotion/content-bank.md b/docs/promotion/content-bank.md new file mode 100644 index 0000000000..005f2f2560 --- /dev/null +++ b/docs/promotion/content-bank.md @@ -0,0 +1,21 @@ +# Content bank + +Part of #13473. Issue #13478. Status: DRAFT_UNSENT. Every row is a draft. None was published, scheduled, or mailed. + +Each claim sentence is copied from the "Approved claim patterns" list in #13473. This run did not remeasure the numbers inside those sentences. `ls conformance/vectors/*_conformance_v0.json | wc -l` printed 109, which is a different quantity from "6" and from "84". + +Visual proof is N/A for every row: no screenshot was taken. `may_publish` in `specs/promotion/t27l_promotion.t27` is false unless the asset fields and the proof gate (widget, screenshot, test pass, human yes) are all true. Human approval for a named draft was not given. + +| id | claim | artifact | reproducible path | visual | CTA | metric | sent | +| --- | --- | --- | --- | --- | --- | --- | --- | +| D01 | 84 formats in one vendor-neutral catalog. | https://arxiv.org/abs/2606.09686 | not remeasured; do not use the 109-file count as this number | N/A | read the paper | not measured | no | +| D02 | 6 bit-exact conformance packs. | https://arxiv.org/abs/2606.09686 | not remeasured; 109 `*_conformance_v0.json` files is a different count | N/A | read the paper | not measured | no | +| D03 | Every pack has a SHA-256 fingerprint. | https://arxiv.org/abs/2606.09686 | not remeasured | N/A | read the paper | not measured | no | +| D04 | BF16: 21/21 vectors match ml_dtypes. | https://arxiv.org/abs/2606.09686 | not remeasured | N/A | read the paper | not measured | no | +| D05 | FP8 E4M3: 15/16 vectors match; the difference is documented. | https://arxiv.org/abs/2606.09686 | not remeasured | N/A | read the paper | not measured | no | +| D06 | We publish abs_error instead of hiding it. | https://arxiv.org/abs/2606.09686 | `conformance/vectors/abs_error_allowlist.json` exists; the allowlist was not rechecked | N/A | read the paper | not measured | no | +| D07 | One catalog generates Markdown, JSON, Python, Rust, C, and TypeScript. | https://arxiv.org/abs/2606.09686 | not remeasured | N/A | read the paper | not measured | no | +| D08 | No Vivado. Open tools only. | https://arxiv.org/abs/2606.09686 | course `MODULE_LINES` index 7 in the trinity blob says "with no Vivado"; not a new measurement | N/A | open the course spec | not measured | no | +| D09 | Every course widget is a compiled t27 spec. | trinity course blob `3b3aa5d21a1dc86876c5b873bf6d6b8cf8d20b21` | `specs/widgets/gallery.t27` is absent here, so this sentence is not checked | N/A | see course-map.md | not measured | no | + +Machine-readable copy: `docs/promotion/content-bank.json`. diff --git a/docs/promotion/content-calendar.md b/docs/promotion/content-calendar.md new file mode 100644 index 0000000000..1808f52889 --- /dev/null +++ b/docs/promotion/content-calendar.md @@ -0,0 +1,39 @@ +# Content calendar + +Part of #13473. Issue #13477. Status: DRAFT_UNSENT. No day on this calendar is scheduled. No post was sent. + +## What the issues name, and what they do not + +#13477 says the calendar must include a 10-day cycle from the V5 spec, plus a weekly cadence with pillar tags. The epic body of #13473 does not list ten day topics and does not name a weekday. This file does not invent posts or dates. + +## 10 slots + +Slots 1-9 are the nine `MODULE_TITLES` from the trinity course blob `3b3aa5d21a1dc86876c5b873bf6d6b8cf8d20b21`. Slot 10 is the proof layer named in #13473 (the two arXiv papers). Pillar tags are the six asset fields the epic requires. Each slot's draft text is N/A. + +| slot | source | pillar tags | calendar date | draft | sent | +| --- | --- | --- | --- | --- | --- | +| 1 | module "The chip" | claim, artifact, path, visual, CTA, metric | not set | N/A | no | +| 2 | module "Numbers in hardware" | claim, artifact, path, visual, CTA, metric | not set | N/A | no | +| 3 | module "Your t27 program" | claim, artifact, path, visual, CTA, metric | not set | N/A | no | +| 4 | module "Inside t27c" | claim, artifact, path, visual, CTA, metric | not set | N/A | no | +| 5 | module "From spec to hardware" | claim, artifact, path, visual, CTA, metric | not set | N/A | no | +| 6 | module "Reading synthesis" | claim, artifact, path, visual, CTA, metric | not set | N/A | no | +| 7 | module "Place, route, timing" | claim, artifact, path, visual, CTA, metric | not set | N/A | no | +| 8 | module "The bitstream" | claim, artifact, path, visual, CTA, metric | not set | N/A | no | +| 9 | module "On the board" | claim, artifact, path, visual, CTA, metric | not set | N/A | no | +| 10 | #13473 proof layer: arXiv:2606.09686 and arXiv:2606.05017 | claim, artifact, path, visual, CTA, metric | not set | see content-bank.md | no | + +## Weekly cadence + +#13480 asks for a weekly report. The blank form is `docs/promotion/weekly-report-template.md`. No weekday is chosen, because #13473 does not name one. No report has been filled with a new measurement beyond `docs/promotion/baseline.md`. + +## Asset fields for this calendar + +| Field | Value | +| --- | --- | +| claim | N/A -- slots are course module titles, not approved claim sentences | +| artifact | `docs/promotion/course-map.md` | +| reproducible path | trinity course blob fetch recorded in `course-map.md` | +| visual | N/A | +| CTA | N/A -- not sent | +| metric | not measured | diff --git a/docs/promotion/contributor-path.md b/docs/promotion/contributor-path.md new file mode 100644 index 0000000000..c17a82da01 --- /dev/null +++ b/docs/promotion/contributor-path.md @@ -0,0 +1,33 @@ +# Contributor path + +Part of #13473. Issue #13481. Status: DRAFT_UNSENT. This run filed no issue and sent no mail. + +## Existing entry + +`CONTRIBUTING.md` is the entry point already in the repo. It tells a contributor to read `SOUL.md`, `OWNERS.md`, and to reference a GitHub issue. The issue-shape sections a new issue needs are Boundary, User Scenarios, Requirements, and Success Criteria (`specs/policy/issue_shape.t27`, named from `AGENTS.md`). + +## Good-first-issue label + +Open issues with that label: 0. + +Command: `gh api -X GET search/issues -f q='repo:Trinity-S-AI-DNA/t27 is:issue is:open label:good-first-issue' -f per_page=1 --jq .total_count` + +No template file for that label existed under `docs/promotion/` before this pack. The proposed shape, not a filed issue, is `docs/promotion/good-first-issue-template.md`. + +## Path + +1. Read `CONTRIBUTING.md`. +2. Pick a lesson row in `docs/promotion/course-map.md` whose `frame_next` cell is not blank (eight rows; `specs/course/lesson_frames.t27` test `the_edit_changes_eight_frames_and_no_exempt_one`). +3. File an issue with the proposed template only after the issue-shape check the skill describes. This pack does not file it. +4. Open a pull request that references that issue. + +## Asset fields + +| Field | Value | +| --- | --- | +| claim | N/A | +| artifact | `CONTRIBUTING.md` and `docs/promotion/good-first-issue-template.md` | +| reproducible path | the label search above | +| visual | N/A | +| CTA | N/A -- not sent | +| metric | 0 open good-first-issue issues | diff --git a/docs/promotion/course-map.md b/docs/promotion/course-map.md new file mode 100644 index 0000000000..d9765d1b80 --- /dev/null +++ b/docs/promotion/course-map.md @@ -0,0 +1,62 @@ +# Course map: 27 lessons + +Part of #13473. Issue #13475. Status: DRAFT_UNSENT. Nothing here was posted. + +## Source + +Live lesson rows are `LESSON_IDS`, `LESSON_TITLES`, `LESSON_MODULES`, `LESSON_WIDGETS`, `LESSON_SPECS`, and `LESSON_GOALS` in `Trinity-S-AI-DNA/trinity` `apps/website/specs/course/course.t27`. + +Fetched this run with `gh api repos/Trinity-S-AI-DNA/trinity/contents/apps/website/specs/course/course.t27`. Blob sha `3b3aa5d21a1dc86876c5b873bf6d6b8cf8d20b21`, size 28305. `LESSON_COUNT` is 27. + +`specs/course/lesson_frames.t27` in this repo says `FRAME_NOW` is that `LESSON_SPECS` table as read on 2026-11-07, and `FRAME_NEXT` is the table a later course edit writes. `changed() == 8`. The column `frame_next` below is blank when the two paths are the same string. + +Lesson body text was not copied. `specs/course/fpga_course_v2.t27` weak point W1 records that lesson 1 and lesson 3 still frame boards that are not the bench board `specs/boards/ax7203.t27`. + +This repo's lesson 1 title in `specs/course/lesson_01_fpga_intro.t27` is `Lesson 1: What is an FPGA?`. That string is not the trinity lesson 1 title below. + +## Asset fields, same for every lesson + +| Field | Value | +| --- | --- | +| claim | N/A -- a lesson title is not one of the nine approved sentences in #13473 | +| visual proof | the widget id; screenshot N/A, none captured in this run | +| CTA | N/A -- not sent | +| metric | not measured | + +`gallery.t27` is not in this checkout (`test -f specs/widgets/gallery.t27` exit 1). The course spec says every widget id is a gallery id. This map cannot check that membership from this tree. + +## Lessons + +| n | id | title | module | widget | spec now | frame_next | result named by LESSON_GOALS | +| --- | --- | --- | --- | --- | --- | --- | --- | +| 1 | fpga-is-a-grid | An FPGA is a grid you configure | chip | fasm-skyline | specs/boards/wukong_v1.t27 | specs/boards/ax7203.t27 | What an FPGA is made of, and why a design uses only part of the chip. | +| 2 | which-chip | Which chip is this? | chip | idcode | specs/tools/tri/fpga.t27 | | How a chip names itself in 32 bits, and how to read those bits. | +| 3 | pins-and-package | Pins, balls and the package | chip | pin-map | specs/boards/xc7a100t_minimal.t27 | specs/boards/ax7203.t27 | How the signals of your design reach the outside world. | +| 4 | bits-and-trits | Bits, trits and GF16 | numbers | gf16-calc | specs/tutorial/01_values_and_types.t27 | specs/ternary/packed_trit.t27 | How a number is stored in bits, and how balanced ternary stores it in trits. | +| 5 | what-arithmetic-costs | What arithmetic costs | numbers | cost-curves | specs/tutorial/05_widths_and_casts.t27 | specs/ternary/hybrid_arithmetic.t27 | Why a multiplier is expensive and an adder is cheap, measured on a real chip. | +| 6 | how-much-fits | How much fits on the chip | numbers | fits-on | specs/fpga/stdlib.t27 | | How to read a resource count and find which resource runs out first. | +| 7 | hello-t27 | Hello, t27 | program | play-hello-world | specs/tutorial/02_functions.t27 | | What a t27 spec looks like, and what the compiler does with it in your browser. | +| 8 | tests-are-the-spec | Tests are part of the spec | program | test-waves | specs/tutorial/07_tests_invariants_benches.t27 | | Why every t27 spec carries its own tests, and what a waveform shows. | +| 9 | compiles-is-not-correct | Compiles is not the same as correct | program | t27-tri-misread | specs/tutorial/03_operators.t27 | | Why green checks are not proof, and how to catch code that compiles and is wrong. | +| 10 | compiler-stages | The stages of t27c | compiler | t27c-stages | specs/tutorial/06_structs_enums_switch.t27 | | The path a spec takes inside t27c: tokens, syntax tree, types, HIR, code. | +| 11 | t27c-on-a-real-machine | t27c on a real machine | compiler | t27c-hello-world | specs/demos/hello_world.t27 | | The same compiler on a real machine, printing what it really prints. | +| 12 | seven-backends-and-t27b | Seven backends, and t27b | compiler | play-rust | specs/tutorial/08_modules_and_arrays.t27 | | One spec, many target languages, and a native compiler with no LLVM. | +| 13 | spec-to-verilog | From a spec to Verilog | hardware | play-verilog | specs/ternary/clocked_counter.t27 | | How a t27 function becomes logic, and how a clocked function becomes registers. | +| 14 | count-the-cells | Count the cells | hardware | stat-card | specs/tutorial/04_control_flow.t27 | specs/ternary/ternary_full_adder.t27 | How to count what a synthesizer built: LUTs, flip-flops, DSPs, block RAM. | +| 15 | one-lut-up-close | One LUT, up close | hardware | lut-explain | specs/ternary/ternary_full_adder.t27 | | What a 6-input lookup table is, and how 64 bits describe any gate. | +| 16 | synthesis-warnings | Synthesis warnings that matter | synthesis | synth-smells | specs/fpga/crossopt.t27 | | How to read a yosys log, and the warnings that become bugs on silicon. | +| 17 | state-machines | State machines | synthesis | fsm-sketch | specs/fpga/dft.t27 | specs/fpga/uart.t27 | How a synthesizer finds a state machine in your design, or refuses to. | +| 18 | where-the-luts-go | Where the LUTs go | synthesis | lut-treemap | specs/fpga/partition.t27 | | Which part of a design spends the LUTs, and why hierarchy matters. | +| 19 | placement | Placement: where the cells land | timing | placement-map | specs/fpga/placement.t27 | | What place and route does, and where it put a real design. | +| 20 | logic-depth | Logic depth | timing | lut-depth | specs/fpga/timing.t27 | | Why the longest chain of logic sets how fast a design can run. | +| 21 | timing-slack | Timing and slack | timing | slack-waterfall | specs/fpga/cts.t27 | specs/fpga/timing.t27 | What slack is, and how to read a timing report path by path. | +| 22 | fasm-to-frames | From FASM to frames | bitstream | tri-x7-fasm | specs/tools/trios/tri/x7-fasm.t27 | | What FASM is, and how features become configuration frames. | +| 23 | a-build-receipt | A build, itemised | bitstream | build-receipt | specs/fpga/adapter.t27 | specs/fpga/board_receipt.t27 | Every stage from a spec to a bitstream, with its time, tool and hash. | +| 24 | read-a-bitstream | Read a bitstream | bitstream | bit-autopsy | specs/tools/trios/tri/x7-writer.t27 | | What is inside a .bit file, and which chip it was built for. | +| 25 | jtag-asks-the-chip | JTAG asks the chip | board | tri-fpga-jtag | specs/tools/trios/tri/fpga-jtag.t27 | | How a cable finds the chip on a board and reads its IDCODE. | +| 26 | same-bits-on-the-board | The same bits, on the board | board | x7-board | specs/tools/trios/tri/x7-board.t27 | | How to show that a bitstream is byte-identical and that it runs. | +| 27 | capstone | Capstone: out-guess yosys | board | gatle | specs/fpga/e2e_demo.t27 | | Put it together: guess what a real t27 module costs in LUTs. | + +Lesson 5's goal says "measured on a real chip" and does not give the number in `LESSON_GOALS`. The number is not measured in this run. + +Nine module titles, from `MODULE_TITLES` in the same blob: The chip; Numbers in hardware; Your t27 program; Inside t27c; From spec to hardware; Reading synthesis; Place, route, timing; The bitstream; On the board. diff --git a/docs/promotion/funnel.md b/docs/promotion/funnel.md new file mode 100644 index 0000000000..72876747e9 --- /dev/null +++ b/docs/promotion/funnel.md @@ -0,0 +1,29 @@ +# Funnel + +Part of #13473. Issue #13479. Status: DRAFT_UNSENT. One CTA is written per step. None was sent. + +The step order is the funnel sentence in #13473: X, then arXiv/GitHub, then the t27.ai course, then a widget, then a good first issue, then a contributor, then a paid product, then B2B. + +| step | CTA text (not sent) | artifact | metric | +| --- | --- | --- | --- | +| 1. X | Open the paper from the post. No post exists in this run. | N/A -- X followers unavailable, see baseline.md | not measured | +| 2. arXiv/GitHub | Read https://arxiv.org/abs/2606.09686 and the repo Trinity-S-AI-DNA/t27. | those two URLs | GitHub stars 5, forks 4, see baseline.md | +| 3. t27.ai course | Open the course spec recorded in course-map.md. | trinity course blob 3b3aa5d21a1dc86876c5b873bf6d6b8cf8d20b21 | lesson count 27 | +| 4. widget | Use one lesson widget id from course-map.md. | course-map.md | gallery membership not measured | +| 5. good first issue | Use the proposed template in good-first-issue-template.md. This run filed no issue. | docs/promotion/good-first-issue-template.md | open issues labelled good-first-issue: 0 | +| 6. contributor | Read CONTRIBUTING.md, then open a pull request that names an issue. | CONTRIBUTING.md | contributors 31, see baseline.md | +| 7. paid product | N/A -- #13473 names the step and names no product and no price | N/A | not measured | +| 8. B2B | N/A -- #13473 names the step and names no offer | N/A | not measured | + +Paid and B2B stay empty on purpose. Inventing a price or a product name is not this task. + +## Asset fields for the funnel page itself + +| Field | Value | +| --- | --- | +| claim | N/A | +| artifact | this file | +| reproducible path | baseline commands plus `gh api -X GET search/issues -f q='repo:Trinity-S-AI-DNA/t27 is:issue is:open label:good-first-issue' -f per_page=1 --jq .total_count` which printed 0 | +| visual | N/A | +| CTA | N/A -- the step texts above were not sent | +| metric | the counts named in the table | diff --git a/docs/promotion/good-first-issue-template.md b/docs/promotion/good-first-issue-template.md new file mode 100644 index 0000000000..0dae5bad66 --- /dev/null +++ b/docs/promotion/good-first-issue-template.md @@ -0,0 +1,24 @@ +# Proposed good-first-issue body + +Part of #13473. Issue #13481. This is a template. It was not filed. Replace every `FILL` from a source you can name. Do not invent a lesson number or a test count. + +```text +## Boundary + +- FILL: one path from docs/promotion/course-map.md + +## User Scenarios + +**Given** the lesson row named above **when** a new contributor opens the spec **then** FILL: the check they can run. + +## Requirements + +- FR-001: FILL +- FR-002: The change must not post to X, LinkedIn, Telegram, Habr, or Instagram. + +## Success Criteria + +- FILL: one command and the output it must print. +``` + +The four section names are the ones `AGENTS.md` says `specs/policy/issue_shape.t27` requires. diff --git a/docs/promotion/metrics.md b/docs/promotion/metrics.md new file mode 100644 index 0000000000..771685dc6c --- /dev/null +++ b/docs/promotion/metrics.md @@ -0,0 +1,32 @@ +# Metrics + +Part of #13473. Issue #13480. Status: DRAFT_UNSENT. This file does not post a report. + +The weekly blank is `docs/promotion/weekly-report-template.md`. Its field names are the final-report template in #13473. Values stay blank until a later run fills them from a named command. + +Numbers already measured once, on 2026-11-09T18:23:02Z, live in `docs/promotion/baseline.md`. They are a baseline, not a weekly delta. + +Tracked names, and whether this run has a value: + +| name | value in this run | where | +| --- | --- | --- | +| GitHub stars | 5 | baseline.md | +| GitHub forks | 4 | baseline.md | +| open issues | 2041 | baseline.md | +| open pull requests | 68 | baseline.md | +| contributors | 31 | baseline.md | +| X followers | unavailable | baseline.md | +| X impressions | unavailable | baseline.md | +| course lesson count | 27 | course-map.md | +| content-bank drafts sent | 0 | content-bank.json `sent: false` on every row | + +## Asset fields + +| Field | Value | +| --- | --- | +| claim | N/A | +| artifact | `docs/promotion/weekly-report-template.md` | +| reproducible path | baseline.md commands | +| visual | N/A | +| CTA | N/A -- not sent | +| metric | the table above | diff --git a/docs/promotion/monetization-ladder.md b/docs/promotion/monetization-ladder.md new file mode 100644 index 0000000000..40a1aa508b --- /dev/null +++ b/docs/promotion/monetization-ladder.md @@ -0,0 +1,24 @@ +# Monetization ladder + +Part of #13473. Issue #13482. Status: DRAFT_UNSENT. No price is written. No offer was sent. The epic says not to sell "AGI access". + +#13473 names five tiers and does not name a price, a SKU, or a paid package. Empty tiers stay empty. + +| tier | offer named by #13473 | price | sent | +| --- | --- | --- | --- | +| Free | open artifacts in Trinity-S-AI-DNA/t27 and the 27-lesson course | none named | no | +| Low | not specified | not written | no | +| Mid | not specified | not written | no | +| High | not specified | not written | no | +| B2B | the funnel names the step and names no offer | not written | no | + +## Asset fields + +| Field | Value | +| --- | --- | +| claim | N/A -- no paid claim is approved in the nine sentences | +| artifact | this file | +| reproducible path | issue #13473 "Funnel" and "Approved claim patterns" | +| visual | N/A | +| CTA | N/A -- not sent | +| metric | not measured | diff --git a/docs/promotion/publish-gate.md b/docs/promotion/publish-gate.md new file mode 100644 index 0000000000..5da8b7de7c --- /dev/null +++ b/docs/promotion/publish-gate.md @@ -0,0 +1,38 @@ +# Publish gate + +Part of #13473. Issue #13485. The gate is closed. Nothing was published. + +## Refuse unless all are true + +From #13485 and `proof_ready` in `specs/promotion/t27l_promotion.t27`: + +1. a widget +2. a screenshot +3. a passing test +4. a human approval for that named draft + +From #13473, the asset also needs a claim, an artifact, a reproducible path, a visual proof, a CTA, and a metric (`asset_ready`). `may_publish` is false if either gate is false. + +The owner's yes for a social post is already specified in `specs/skills/t27-social-visual-consent.t27`: explicit yes, in the owner's own chat, for that post and that channel, after the uniqueness gate. This pack does not copy that spec. No such yes was given for any draft here. + +## This run + +| check | state | +| --- | --- | +| widget for a new post | not rendered | +| screenshot | not taken | +| test of a post | the promotion gate spec passed; that is not a test of a sent post | +| human approval | absent | +| content-bank `sent` | false on all 9 drafts | +| X, LinkedIn, Telegram, Habr, Instagram, email | not called to send | + +## Asset fields + +| Field | Value | +| --- | --- | +| claim | N/A | +| artifact | `specs/promotion/t27l_promotion.t27` | +| reproducible path | `./target/debug/t27c test-report specs/promotion/t27l_promotion.t27` | +| visual | N/A | +| CTA | N/A -- not sent | +| metric | drafts sent: 0 | diff --git a/docs/promotion/self-improving-loop.md b/docs/promotion/self-improving-loop.md new file mode 100644 index 0000000000..ca2c68666e --- /dev/null +++ b/docs/promotion/self-improving-loop.md @@ -0,0 +1,26 @@ +# Self-improving loop + +Part of #13473. Issue #13484. Status: specified, not started as a job. This file does not add a workflow, does not run cron, and does not call a paid model. + +## Bound + +One pass, then stop. + +1. Read `docs/promotion/baseline.md` and `docs/promotion/weekly-report-template.md`. +2. If a metric has no command, write `not measured`. Do not write 0 in its place. +3. If the model or the API returns a rate limit, record `WAITING_RATE_LIMIT` (`on_rate_limit(false)` in `specs/promotion/t27l_promotion.t27`) and stop. +4. `on_rate_limit(true)` is `refused`. There is no paid fallback (#13473, `FREE_MODELS_FIRST`). +5. The only edit a pass may make before a named owner approval is under `docs/promotion/` and `specs/promotion/`. It does not post. + +No cron card was added. Issue #12869 asks for a blog-steward workflow. That workflow is not this loop, and it was not added. + +## Asset fields + +| Field | Value | +| --- | --- | +| claim | N/A | +| artifact | this file and `specs/promotion/t27l_promotion.t27` | +| reproducible path | `t27c test-report` recorded in `t27l-promotion-schema.md` | +| visual | N/A | +| CTA | N/A -- not sent | +| metric | not measured -- the loop has not run | diff --git a/docs/promotion/t27l-promotion-schema.md b/docs/promotion/t27l-promotion-schema.md new file mode 100644 index 0000000000..748082e644 --- /dev/null +++ b/docs/promotion/t27l-promotion-schema.md @@ -0,0 +1,48 @@ +# T27L promotion schema + +Part of #13473. Issue #13483. Status: DRAFT_UNSENT. The spec does not emit a live event and does not post. + +## Surface + +Name: `promotion_kernel`. + +Constant: `SURFACE` in `specs/promotion/t27l_promotion.t27`. + +`REGISTERED_IN_T27L` is false. `specs/t27os/t27l.t27` on master `116178f1d` sets `TL_SURFACE_LAST` to 19. `tl_surface_name` returns `course_hud`, `dev_view`, `pane`, `viewer`, `neko`, `menu_l`, `browser`, `other`, `cost`, `system`, `agent`, `security`, `research`, `memory`, `time`, `ci`, `migration`, `visual`, `roadmap`. None of those strings is `promotion_kernel`. This pack does not edit `t27l.t27`. + +## Actions + +| constant | text | +| --- | --- | +| ACTION_DRAFT | draft | +| ACTION_GATE_CHECK | gate_check | +| ACTION_PUBLISH_APPROVED | publish_approved | +| ACTION_WAITING_RATE_LIMIT | WAITING_RATE_LIMIT | +| ACTION_REFUSED | refused | + +`on_rate_limit(false)` returns `WAITING_RATE_LIMIT`. `on_rate_limit(true)` returns `refused`. A paid model is not a fallback. + +## Gates + +`asset_ready` is true only when claim, artifact, path, visual, CTA, and metric are all present. + +`proof_ready` is true only when widget, screenshot, test pass, and human yes are all present (#13485). + +`may_publish` is true only when both gates are true. + +## Check + +`./target/debug/t27c test-report specs/promotion/t27l_promotion.t27` on this run: tests 6, pass 6, FAIL 0, vacuous passes 0 of 6. + +Seal: `.trinity/seals/promotion_promotion_t27l.json`, saved with `./target/debug/t27c seal specs/promotion/t27l_promotion.t27 --save`, then `--verify` printed `all hashes MATCH`. + +## Asset fields + +| Field | Value | +| --- | --- | +| claim | N/A | +| artifact | `specs/promotion/t27l_promotion.t27` | +| reproducible path | the test-report command above | +| visual | N/A | +| CTA | N/A -- not sent | +| metric | 6 tests, 0 failures, 0 vacuous | diff --git a/docs/promotion/weekly-report-template.md b/docs/promotion/weekly-report-template.md new file mode 100644 index 0000000000..e02d73857f --- /dev/null +++ b/docs/promotion/weekly-report-template.md @@ -0,0 +1,32 @@ +# Weekly promotion report (blank) + +Part of #13473. Issue #13480. Do not fill a number that has no command. Write `not measured` instead. Do not send this form. + +```text +WEEK_ENDING_UTC: +EPIC_CREATED: +ISSUES_CREATED: +BASELINE_CAPTURED: +COURSE_MAP_CREATED: +WIDGET_INVENTORY_CREATED: +CONTENT_CALENDAR_CREATED: +CONTENT_BANK_CREATED: +FUNNEL_LIVE: +METRICS_TRACKED: +CONTRIBUTOR_PATH_LIVE: +MONETIZATION_LIVE: +SELF_IMPROVING_LOOP_LIVE: +REGRESSION_STATUS: +ANOMALIES_FOUND: +BLOCKERS: +NEXT_ACTION: +GITHUB_STARS: +GITHUB_FORKS: +GITHUB_OPEN_ISSUES: +GITHUB_CONTRIBUTORS: +X_FOLLOWERS: +X_IMPRESSIONS: +DRAFTS_SENT: +``` + +`DRAFTS_SENT` stays 0 until the owner approves a named draft and a later run records the send. This template does not approve one. diff --git a/docs/promotion/widget-inventory.json b/docs/promotion/widget-inventory.json new file mode 100644 index 0000000000..d43c471767 --- /dev/null +++ b/docs/promotion/widget-inventory.json @@ -0,0 +1,27 @@ +{ + "part_of": 13473, + "issue": 13476, + "status": "DRAFT_UNSENT", + "published": false, + "gallery_spec_in_this_repo": false, + "gallery_check": "test -f specs/widgets/gallery.t27", + "course_blob_sha": "3b3aa5d21a1dc86876c5b873bf6d6b8cf8d20b21", + "types": [ + {"type": "interactive number", "status": "nearest", "nearest": "lesson 4 widget gf16-calc", "screenshot": null}, + {"type": "bit layout explorer", "status": "nearest", "nearest": "lesson 2 widget idcode", "screenshot": null}, + {"type": "encode/decode", "status": "nearest", "nearest": "lesson 2 widget idcode", "screenshot": null}, + {"type": "rounding", "status": "nearest", "nearest": "lesson 4 widget gf16-calc", "screenshot": null}, + {"type": "overflow", "status": "absent", "nearest": null, "screenshot": null}, + {"type": "NaN", "status": "absent", "nearest": null, "screenshot": null}, + {"type": "block scale", "status": "absent", "nearest": "conformance/vectors/block_fp_conformance_v0.json is not a widget", "screenshot": null}, + {"type": "ternary adder", "status": "nearest", "nearest": "specs/ternary/ternary_full_adder.t27", "screenshot": null}, + {"type": "ternary multiplier", "status": "nearest", "nearest": "lesson 8 widget test-waves", "screenshot": null}, + {"type": "FPGA blink", "status": "nearest", "nearest": "lesson 24 widget bit-autopsy", "screenshot": null}, + {"type": "neural training loop", "status": "absent", "nearest": null, "screenshot": null}, + {"type": "loss curve", "status": "absent", "nearest": "specs/widgets/cost_curves.t27 is LUT cost, not training loss", "screenshot": null}, + {"type": "before/after", "status": "partial", "nearest": "specs/course/lesson_01_diff_main.t27", "screenshot": null}, + {"type": "live build", "status": "nearest", "nearest": "lesson 23 widget build-receipt", "screenshot": null}, + {"type": "agent swarm view", "status": "absent", "nearest": "lesson 27 LESSON_ALSO includes race-the-bee", "screenshot": null}, + {"type": "course progress", "status": "partial", "nearest": "specs/course/course_hud_state.t27", "screenshot": null} + ] +} diff --git a/docs/promotion/widget-inventory.md b/docs/promotion/widget-inventory.md new file mode 100644 index 0000000000..74dc7f8411 --- /dev/null +++ b/docs/promotion/widget-inventory.md @@ -0,0 +1,41 @@ +# Widget inventory + +Part of #13473. Issue #13476. Status: DRAFT_UNSENT. Nothing here was posted. + +The 16 type names are the list in #13476 FR-003. They are not ids in the live course. The course widget ids are `LESSON_WIDGETS` in the trinity course blob `3b3aa5d21a1dc86876c5b873bf6d6b8cf8d20b21` (see `docs/promotion/course-map.md`). + +`test -f specs/widgets/gallery.t27` exited 1. This checkout cannot show that a type is a compiled gallery widget. + +`nearest` means a lesson widget or a file in this repo that covers part of the same words. It is not a claim that the V5 type exists under that name. + +| type | status | nearest source | visual output checked | +| --- | --- | --- | --- | +| interactive number | nearest | lesson 4 widget `gf16-calc` | screenshot N/A | +| bit layout explorer | nearest | lesson 2 widget `idcode` | screenshot N/A | +| encode/decode | nearest | lesson 2 widget `idcode` | screenshot N/A | +| rounding | nearest | lesson 4 widget `gf16-calc` | screenshot N/A | +| overflow | absent | not in `LESSON_WIDGETS` | N/A | +| NaN | absent | not in `LESSON_WIDGETS` | N/A | +| block scale | absent | not in `LESSON_WIDGETS`; `conformance/vectors/block_fp_conformance_v0.json` is a vector file, not a widget | N/A | +| ternary adder | nearest | lesson 15 spec `specs/ternary/ternary_full_adder.t27` (`test -f` present); widget on that lesson is `lut-explain` | screenshot N/A | +| ternary multiplier | nearest | lesson 8 widget `test-waves` | screenshot N/A | +| FPGA blink | nearest | lesson 24 widget `bit-autopsy`; the lesson task text in the blob names a `blink_j26` sample | screenshot N/A | +| neural training loop | absent | not in `LESSON_WIDGETS` | N/A | +| loss curve | absent | lesson 5 widget `cost-curves` is a LUT-cost chart (`specs/widgets/cost_curves.t27` present), not a training-loss curve | screenshot N/A | +| before/after | partial | `specs/course/lesson_01_diff_main.t27` present; not a `LESSON_WIDGETS` id | screenshot N/A | +| live build | nearest | lesson 23 widget `build-receipt` | screenshot N/A | +| agent swarm view | absent | not a `LESSON_WIDGETS` id; lesson 27 `LESSON_ALSO` includes `race-the-bee` | screenshot N/A | +| course progress | partial | `specs/course/course_hud_state.t27` present; not a `LESSON_WIDGETS` id | screenshot N/A | + +## Asset fields + +| Field | Value | +| --- | --- | +| claim | N/A for the 16 type names; the approved sentence "Every course widget is a compiled t27 spec." is a content-bank draft, not a result of this inventory | +| artifact | `docs/promotion/widget-inventory.json` | +| reproducible path | `test -f` lines above, plus the course blob fetch in `course-map.md` | +| visual | N/A -- no screenshot | +| CTA | N/A -- not sent | +| metric | 16 types listed; gallery membership not measured | + +Machine-readable copy: `docs/promotion/widget-inventory.json`. diff --git a/specs/promotion/t27l_promotion.t27 b/specs/promotion/t27l_promotion.t27 new file mode 100644 index 0000000000..a0e1450256 --- /dev/null +++ b/specs/promotion/t27l_promotion.t27 @@ -0,0 +1,85 @@ +// SPDX-License-Identifier: Apache-2.0 +; specs/promotion/t27l_promotion.t27 -- local gate for promotion_kernel events. +; Part of #13473, issue #13483. This file does not register a surface in +; specs/t27os/t27l.t27. On master 116178f1d, tl_surface_name covers ids 1..19 +; (TL_SURFACE_LAST = 19) and none of those names is promotion_kernel. +; Nothing here posts, sends mail, or starts a cron. +; phi^2 + 1/phi^2 = 3 | TRINITY + +module promotion_t27l; + +pub const SURFACE : str = "promotion_kernel"; +pub const REGISTERED_IN_T27L : bool = false; + +pub const ACTION_DRAFT : str = "draft"; +pub const ACTION_GATE_CHECK : str = "gate_check"; +pub const ACTION_PUBLISH_APPROVED : str = "publish_approved"; +pub const ACTION_WAITING_RATE_LIMIT : str = "WAITING_RATE_LIMIT"; +pub const ACTION_REFUSED : str = "refused"; + +; The six fields of a publishable asset (issue #13473). A missing field is false. +pub fn asset_ready(has_claim: bool, has_artifact: bool, has_path: bool, has_visual: bool, has_cta: bool, has_metric: bool) -> bool { + return has_claim and has_artifact and has_path and has_visual and has_cta and has_metric; +} + +; Issue #13485: widget, screenshot, test pass, and a human yes, all required. +pub fn proof_ready(widget: bool, screenshot: bool, test_pass: bool, human_yes: bool) -> bool { + return widget and screenshot and test_pass and human_yes; +} + +; Both gates. There is no default yes. +pub fn may_publish(asset: bool, proof: bool) -> bool { + return asset and proof; +} + +; A rate limit stops the loop. A paid model is not a fallback. +pub fn on_rate_limit(paid_fallback: bool) -> str { + if paid_fallback { + return ACTION_REFUSED; + } + return ACTION_WAITING_RATE_LIMIT; +} + +test surface_is_promotion_kernel_and_not_registered { + assert SURFACE == "promotion_kernel"; + assert REGISTERED_IN_T27L == false; + assert ACTION_WAITING_RATE_LIMIT == "WAITING_RATE_LIMIT"; +} + +test asset_ready_needs_every_field { + assert asset_ready(true, true, true, true, true, true); + assert asset_ready(false, true, true, true, true, true) == false; + assert asset_ready(true, false, true, true, true, true) == false; + assert asset_ready(true, true, false, true, true, true) == false; + assert asset_ready(true, true, true, false, true, true) == false; + assert asset_ready(true, true, true, true, false, true) == false; + assert asset_ready(true, true, true, true, true, false) == false; +} + +test proof_ready_needs_widget_screenshot_test_and_human_yes { + assert proof_ready(true, true, true, true); + assert proof_ready(false, true, true, true) == false; + assert proof_ready(true, false, true, true) == false; + assert proof_ready(true, true, false, true) == false; + assert proof_ready(true, true, true, false) == false; +} + +test may_publish_is_false_without_both_gates { + assert may_publish(true, true); + assert may_publish(true, false) == false; + assert may_publish(false, true) == false; + assert may_publish(false, false) == false; +} + +test rate_limit_waits_and_refuses_a_paid_fallback { + assert on_rate_limit(false) == "WAITING_RATE_LIMIT"; + assert on_rate_limit(true) == "refused"; + assert on_rate_limit(true) != "WAITING_RATE_LIMIT"; +} + +test negative_control_wrong_surface { + assert SURFACE != "this-surface-is-wrong"; + assert ACTION_DRAFT == "draft"; + assert ACTION_GATE_CHECK == "gate_check"; + assert ACTION_PUBLISH_APPROVED == "publish_approved"; +}