Skip to content

Commit 98389bd

Browse files
committed
docs: prepare verified launch captures and provenance
1 parent 4b1238c commit 98389bd

12 files changed

Lines changed: 185 additions & 27 deletions

‎docs/CONTEXT.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -84,7 +84,7 @@ Recheck these observations before acting:
8484
- Existing Commons run 49092854-f9bd-4b7a-8d12-4ac5ea0e5f70 retains the approved,
8585
unmerged safe-timer change from job 811bdb98-bcbb-4b65-80b9-f19693aef6b4.
8686
Preserve it. 29 earlier lab experiments were verified before this release work.
87-
- Public source: antropos17/commit-zero at 64704c6 (06:14 UTC), CI green; use clean .cache/publication and preserve histories.
87+
- Public source: antropos17/commit-zero at 4b1238c (06:27 UTC), CI green; use clean .cache/publication and preserve histories.
8888
README GIF is a 15.8s condensed walkthrough of retained Sequence Kit work,
8989
not a continuous live recording. Static fallback included; desktop/mobile and all
9090
three CI jobs passed. Evidence: runtime/verification/github-readme-gif-2026-10-19.json.

‎docs/DEVELOPMENT.md‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -34,6 +34,9 @@ only Node `.test.mjs` files. Run `npm run test:ui` for real browser coverage.
3434
`npm run benchmark:ui -- --history 1000 --samples 5` measures a labelled read-only
3535
chat fixture in cold browser contexts after `npm run build`. Use the same browser,
3636
viewport and parameters for comparison; it never opens a retained user store.
37+
`npm run capture:launch` performs disposable model-free journeys and captures
38+
ready-size launch images with provenance under `runtime/verification/launch-assets`.
39+
Review the actual images before copying them into source; see [distribution](DISTRIBUTION.md).
3740
Focused suites are explicitly labeled feedback, not full acceptance. Select an area
3841
deliberately: changed-file inference is unreliable in this dirty checkout and can
3942
miss integration dependencies. The full gate remains serial to bound PGlite memory.

‎docs/DISTRIBUTION.md‎

Lines changed: 38 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ active catalog agents or a generated-code sandbox.
99

1010
| Channel and audience | Official submission rules and fit | Required preparation and timing |
1111
| --- | --- | --- |
12-
| [Product Hunt](https://www.producthunt.com/launch): makers and early adopters who can install a developer tool | [Launch guide](https://www.producthunt.com/launch/preparing-for-launch) accepts a GitHub repository URL, asks for a plain name, tagline up to 60 characters, description up to 500, square thumbnail under 3 MB and at least two gallery images. The [guide](https://www.producthunt.com/launch) forbids direct requests for upvotes. | Best after final public commit and CI pass. Use existing real workspace/review captures as two gallery images, the repository logo as thumbnail only after checking dimensions, and a maker's personal account. The owner should verify all fields and be available for questions. No scheduled launch yet. |
12+
| [Product Hunt](https://www.producthunt.com/launch): makers and early adopters who can install a developer tool | [Launch guide](https://www.producthunt.com/launch/preparing-for-launch) accepts a GitHub repository URL, asks for a plain name, tagline up to 60 characters, description up to 500, square thumbnail under 3 MB and at least two gallery images. Recommended dimensions are 240x240 and 1270x760. The [guide](https://www.producthunt.com/launch) forbids direct requests for upvotes. | Best after final public commit and CI pass. The checked asset set below provides two real viewport captures and the current application mark. A maker's personal account, final fields and availability for questions remain prerequisites. No scheduled launch yet. |
1313
| [Show HN](https://news.ycombinator.com/showhn.html): developers who can run the project | Show HN accepts software people can run locally, asks for a `Show HN` title and easy trial without a signup barrier. [HN guidelines](https://news.ycombinator.com/newsguidelines.html) prohibit generated or AI-edited submission text and promotion-first participation. | Provide a clean quickstart, public source and reproducible demo. The human maker must write the submission and comments personally. This file supplies a fact sheet, not post copy. Do not ask for votes. |
1414
| [DEV Community](https://dev.to/): technical readers interested in verification and local AI | [AI-assisted article rules](https://dev.to/guidelines-for-ai-assisted-articles-on-dev) require disclosure and fact checking, and disallow AI-assisted articles promoting a program. | Defer a launch post. A human-authored technical case study about revision-checked reviews and simulation may fit after sustained real-world feedback. No promotional draft is prepared. |
1515
| [r/LocalLLaMA](https://www.reddit.com/r/LocalLLaMA/): local-model practitioners | The accessible [community rules page](https://www.reddit.com/r/LocalLLaMA/about/rules/) did not expose the rules to this research tool. Reddit's [general guidance](https://www.reddit.com/wiki/selfpromotion/) explicitly says its older self-promotion page is no longer updated and asks authors to check subreddit-specific rules. | Hold. Recheck current rules in a logged-in view and establish genuine community participation before considering a post. Do not infer permission from old general advice. |
@@ -37,10 +37,32 @@ Assets: [workspace desktop](media/workspace-desktop.png), [review](media/workspa
3737
[condensed saved-run demo](media/workflow-demo.gif), and [static fallback](media/workflow-poster.png).
3838
The [current scenario PR diff](media/scenario-pr-2026-10-19.png) is a real Chrome
3939
capture of the deterministic ten-step example; caption it as simulated activity.
40-
The new [catalog capture](media/agent-catalog-2026-10-19.png) is an optional
41-
third image only when captioned as 18 disabled proposals in a deterministic
42-
fixture. Gallery sizing/crop and thumbnail have not been checked against Product
43-
Hunt's upload requirements; those are prerequisites before submission.
40+
The [catalog capture](media/agent-catalog-2026-10-19.png) is optional only when
41+
captioned as 18 disabled proposals. Prefer the following ready-size set for a
42+
first launch; it demonstrates a model-free entry path and the repository example.
43+
44+
| Asset | Checked file | Required caption |
45+
| --- | --- | --- |
46+
| Gallery 1 | [Commons first run](media/launch-2026-10-19/commons-first-run.png), 1270x760 | Actual local project and issue created by a deterministic capture script in disposable services. No model task started. |
47+
| Gallery 2 | [Scenario PR](media/launch-2026-10-19/scenario-pr.png), 1270x760 | Deterministic ten-step repository example. Author, review and checks are simulated. |
48+
| Thumbnail | [Current commit mark](media/launch-2026-10-19/thumbnail.png), 240x240 | Current application SVG mark rendered in Chrome, light mode. |
49+
50+
The [capture manifest](media/launch-2026-10-19/manifest.json) records dimensions,
51+
bytes, SHA-256, capture time, source fingerprint and Chrome version. The PNGs are
52+
actual viewports without resizing, compositing or invented activity; all are
53+
below 3 MB. Visual inspection confirmed the relevant issue and changed lines
54+
are visible. The manifest is capture provenance, not a full release gate.
55+
56+
Regenerate after `npm run build` with `npm run capture:launch`. On this Windows
57+
host set `CZ_BROWSER_EXECUTABLE` as described in [development](DEVELOPMENT.md).
58+
The command starts disposable in-memory services, performs actual scenario and
59+
Commons HTTP interactions, captures PNGs, checks sizes/hashes and awaits cleanup.
60+
It writes only `runtime/verification/launch-assets`; copy reviewed assets into a
61+
dated source folder. Captured issue timestamps can differ on later runs, so the
62+
journey is reproducible but byte-identical screenshots are not promised. The
63+
personal account, maker comment and final launch timing remain human actions.
64+
The mutable manifest is replaced with `running` before capture and `failed` on
65+
an error; an interrupted attempt cannot leave an older success marked current.
4466

4567
## GitHub release candidate draft
4668

@@ -59,6 +81,11 @@ announcement posted elsewhere.
5981
> in isolated fixtures. The sandbox contract reports its actual host readiness;
6082
> no container execution is claimed without a working runtime.
6183
>
84+
> Chat now starts with the latest 40 saved messages and explicitly loads earlier
85+
> batches while preserving the reading anchor. `npm run benchmark:ui` records a
86+
> read-only large-history fixture; smaller initial DOM size is verified, while
87+
> changed snapshots still transfer the full history.
88+
>
6289
> The existing local Builder/Reviewer and Language lab paths remain separate
6390
> from the deterministic repository example and new fixtures. Proposal parsing
6491
> and review do not prove code behavior. Follow `README.md` for installation,
@@ -67,6 +94,12 @@ announcement posted elsewhere.
6794
Before publishing a release, replace the candidate version with an actual tag,
6895
link its exact commit and CI run, re-run the documented gates, and record real
6996
browser/model/sandbox coverage separately. No release was created by this note.
97+
Current implemented-code checkpoint: public `4b1238c`, [CI run 39210013058](https://github.com/antropos17/commit-zero/actions/runs/39210013058)
98+
passed full gate, Chromium and runtime dependency audit. Local frozen gate at
99+
`6bab440` passed 66/66 Node tests, DOM/axe 2/2, build and serving with source
100+
hash `20deff889c69cfceab726fa372d4bf96568ba2b9afea2b43fd8293e0cf9c7917`;
101+
separate Chrome coverage passed 11/11. This draft and capture tooling will require
102+
their own final source check before publication.
70103

71104
## Show HN fact sheet for a human author
72105

‎docs/HANDOFF-2026-10-19.md‎

Lines changed: 22 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -8,17 +8,17 @@ tracks dated decisions and receipts; this file is the operational entry point.
88
## Repositories and state
99

1010
- Working repository: `X:\ai-github`, branch `codex/development-foundation`,
11-
latest fully checked local commit `c394536` at this checkpoint. The local data and model
11+
latest fully checked local commit `6bab440` at this checkpoint. The local data and model
1212
installation are here. Recheck status before acting; this file can age.
1313
- Public repository: [antropos17/commit-zero](https://github.com/antropos17/commit-zero),
14-
`main` at `64704c604e1038070de3c137e8e569906bf975ec` after a normal push.
14+
`main` at `4b1238c7af6be8d7facf155c031aaffff28168b8` after a normal push.
1515
Its separate checkout is `.cache/publication`. The histories are unrelated;
16-
the public tree matches local `c394536` (`d0702664b8c8322babb2e9d30111e8e095af35eb`).
17-
A measured chat rendering-window unit is currently pending a full gate.
16+
the public tree matches local `6bab440` (`77c4ae23feb8d9595d87d7945a8dfa0847d0f571`).
17+
A launch capture-tooling/documentation unit is currently pending a full gate.
1818
Do not merge histories, reset the local branch or force push. Recheck remote
1919
before publishing anything else.
20-
- Public CI [run 39208716434](https://github.com/antropos17/commit-zero/actions/runs/39208716434)
21-
passed all three jobs for `64704c6`: full gate, Chromium and runtime
20+
- Public CI [run 39210013058](https://github.com/antropos17/commit-zero/actions/runs/39210013058)
21+
passed all three jobs for `4b1238c`: full gate, Chromium and runtime
2222
dependency audit.
2323
- This mission has not run local or hosted model inference, spawned product
2424
agents, submitted promotional posts or created a new release. Prior retained
@@ -43,8 +43,9 @@ run `npm run test:ui`. The browser suite starts disposable in-memory services.
4343

4444
Preserve `runtime/database`, `runtime/identity`, `runtime/backups`, `.env`,
4545
`runtime/verification` and `runtime/local-model`. The normal gateway at 4173
46-
was offline during this pass. Installed model files existed; no readiness or
47-
inference was probed. The existing Commons run
46+
was offline during this pass. Installed model files existed; their weights and
47+
inference capability were not verified. UI health reads are separate from model
48+
execution, and no model-backed job was started. The existing Commons run
4849
`49092854-f9bd-4b7a-8d12-4ac5ea0e5f70` has an approved **unmerged** Safe
4950
Timer proposal from job `811bdb98-bcbb-4b65-80b9-f19693aef6b4`. Preserve it.
5051

@@ -99,11 +100,11 @@ Timer proposal from job `811bdb98-bcbb-4b65-80b9-f19693aef6b4`. Preserve it.
99100

100101
## Evidence and limits
101102

102-
- Latest local frozen full gate at `c394536`: 66/66 Node tests, compiled DOM/axe
103+
- Latest local frozen full gate at `6bab440`: 66/66 Node tests, compiled DOM/axe
103104
2/2, build and static serving passed. Stable source hash
104-
`c37587cb34fe1e3735011bed37a55065d6aabc52579c2eba8b7897eddaeda74f`;
105-
receipt `runtime/verification/scenario-pr-full-2026-10-19.json` (ignored by Git).
106-
- Installed Chrome browser suite passed 10/10 at desktop and 390px. Real captures
105+
`20deff889c69cfceab726fa372d4bf96568ba2b9afea2b43fd8293e0cf9c7917`;
106+
receipt `runtime/verification/chat-window-full-2026-10-19.json` (ignored by Git).
107+
- Installed Chrome browser suite passed 11/11 at desktop and 390px. Real captures
107108
are `runtime/verification/commons-first-run-{desktop,narrow}-2026-10-19.png`,
108109
`commons-provider-offline-desktop-2026-10-19.png` and catalog captures. Tests
109110
used in-memory services; provider-health responses were controlled in the
@@ -128,11 +129,13 @@ Timer proposal from job `811bdb98-bcbb-4b65-80b9-f19693aef6b4`. Preserve it.
128129
10-test grouped run including the final mobile cue, keyboard horizontal scroll
129130
and narrow axe checks. Actual [PR capture](media/scenario-pr-2026-10-19.png)
130131
shows deterministic activity. Its full frozen gate and public CI passed at
131-
`64704c6`. A pending chat window renders the latest 40 messages with explicit
132+
`64704c6`. The chat window renders the latest 40 messages with explicit
132133
earlier loading. Before/after browser measurements and a separate held-out
133134
history test are recorded in [measurements](WORKFLOW-MEASUREMENTS.md). Fast/UI
134-
checks and all 11 grouped Chrome tests passed; full acceptance for this unit
135-
remains.
135+
checks, all 11 grouped Chrome tests, the full gate and public CI passed for
136+
this unit. Pending launch tooling creates ready-size images and a provenance
137+
manifest; its missing-browser failure and subsequent successful capture both
138+
exited after disposable-service cleanup. [Assets and drafts](DISTRIBUTION.md).
136139
- `npm run benchmark:backend` used a disposable PGlite snapshot of five projects
137140
and 1,000 messages. Twenty samples per path: current normalized message-write
138141
p50 9.09 ms versus retained legacy pattern 42.99 ms. This verifies a prior
@@ -146,7 +149,7 @@ Timer proposal from job `811bdb98-bcbb-4b65-80b9-f19693aef6b4`. Preserve it.
146149

147150
## Next work, in order
148151

149-
1. Complete the chat rendering-window unit: run focused UI, grouped Chrome and `npm run check` on frozen source,
152+
1. Complete the launch capture-tooling unit: run fast/tooling checks and `npm run check` on frozen source,
150153
commit it, copy the unpublished local commit into the separate public
151154
checkout, compare Git trees, push without force and inspect public CI.
152155
Record exact SHA and receipt.
@@ -163,10 +166,10 @@ Timer proposal from job `811bdb98-bcbb-4b65-80b9-f19693aef6b4`. Preserve it.
163166
limits, qualify output and cancellation, and explicitly enable one role at a
164167
time. Current names are hypotheses, not benchmark results.
165168
5. The changed Commons snapshot still hydrates the full document in the UI.
166-
The pending latest-40 window bounds initial DOM work; network bytes remain
169+
The latest-40 window bounds initial DOM work; network bytes remain
167170
unchanged. Measure snapshot transfer on larger actual histories before deciding
168171
whether cursor reads justify a partial cache. Preserve revision and reading
169-
position. Product Hunt needs verified image sizes and a
172+
position. Product Hunt now has checked-size assets and still needs a
170173
human maker; HN prohibits generated submission text. Do not post in this
171174
mission.
172175

@@ -179,7 +182,7 @@ Timer proposal from job `811bdb98-bcbb-4b65-80b9-f19693aef6b4`. Preserve it.
179182
> `docs/HANDOFF-2026-10-19.md`, and `docs/MISSION-2026-10-19.md`. Recheck Git
180183
> state and `npm run doctor`; use `npm run map -- <area>`. Preserve all runtime
181184
> data, credentials, earlier model receipts, and separate Git histories.
182-
> First confirm public CI for `64704c6` and complete any dirty chat rendering or
185+
> First confirm public CI for `4b1238c` and complete any dirty launch tooling or
183186
> handoff unit. Then reproduce and improve one
184187
> concrete browser or transaction journey, using focused checks and the full
185188
> `npm run check` on frozen source. Keep model-backed catalog roles disabled;

‎docs/MISSION-2026-10-19.md‎

Lines changed: 5 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ Start: 03:46:17 UTC. Deadline: 15:46:17 UTC. Final integration reserve begins 14
1212

1313
## Current action
1414

15-
Finish the measured Commons chat rendering window and reproducible UI benchmark. Validate the held-out history/anchor journey, focused UI and grouped Chrome, then run the frozen full gate. Commit and publish with tree comparison. The final integration reserve still begins at 14:16:17 UTC.
15+
Finish the reproducible launch capture command and checked image set, run fast/tooling feedback and the frozen full gate, then publish with tree comparison. Next audit model/provider source evidence and unmet mission criteria. The final integration reserve still begins at 14:16:17 UTC.
1616

1717
## Decisions and limits
1818

@@ -59,7 +59,10 @@ Finish the measured Commons chat rendering window and reproducible UI benchmark.
5959
- 06:14 UTC: PR inspection unit committed as local `c394536` after full gate 66/66, source hash `c37587cb`; receipt `runtime/verification/scenario-pr-full-2026-10-19.json`. All 13 changed files matched by SHA-256 and tree `d070266` in the public checkout. Normal push produced `64704c6`; [CI run 39208716434](https://github.com/antropos17/commit-zero/actions/runs/39208716434) passed all three jobs.
6060
- 06:20 UTC: new browser benchmark measured a routed 1,000-message read-only fixture before/after a latest-40 chat window (five cold contexts and one warmup each). DOM elements fell from 8,224 to 547; p50 228.25/212.72 ms is descriptive only, not a general speedup claim. Full snapshot bytes remain 926,125. A separate 147-message browser fixture passed anchor preservation, new-message appends, explicit earlier loading, oldest-message task linkage and narrow axe. Details and raw-receipt paths: [measurements](WORKFLOW-MEASUREMENTS.md). Focused/full gates remain.
6161
- 06:24 UTC: `check:fast` passed 9/9 and `check:ui` passed DOM/axe 2/2, build and serving. Three fresh-service Chrome groups passed 11/11, including the held-out chat history and existing first-run/conflict/recovery journeys. Full frozen gate remains before committing the rendering-window unit.
62+
- 06:27 UTC: chat window/benchmark committed locally as `6bab440` after frozen full gate 66/66, source hash `20deff88`; receipt `runtime/verification/chat-window-full-2026-10-19.json`. All 15 changed files matched by SHA-256 and Git tree `77c4ae2`; normal push produced public `4b1238c`. [CI run 39210013058](https://github.com/antropos17/commit-zero/actions/runs/39210013058) passed all three jobs.
63+
- 06:33 UTC: resumed the same worker after an explicit liveness checkpoint ended the preceding turn. Repository commands and publication had continued since the 06:05 capacity restart; no second worker or inference was used. The deadline/reserve are unchanged.
64+
- 06:34 UTC: `npm run capture:launch` produced actual Chrome viewport PNGs at Product Hunt's documented recommended dimensions (two 1270x760 gallery images and a 240x240 current app mark), visually inspected and copied with SHA-256 equality to `docs/media/launch-2026-10-19/`. A missing-browser fixture exited with error and replaced the manifest with `failed`; the next successful run replaced it with `captured`. Both invocations exited after awaited service cleanup. No retained database, model task or external submission was involved. [Distribution](DISTRIBUTION.md) now includes captions, provenance and human launch prerequisites. Full gate remains.
6265

6366
## Next checkpoint
6467

65-
Finish the chat rendering-window unit, run the frozen full gate, then commit and publish through the separate checkout after tree comparison. Continue bounded implementation. Keep the final 90-minute reserve from 14:16:17 UTC.
68+
Finish the capture-tooling unit, run the frozen full gate, then commit and publish through the separate checkout after tree comparison. Continue bounded implementation. Keep the final 90-minute reserve from 14:16:17 UTC.
108 KB
Loading

0 commit comments

Comments
 (0)