diff --git a/docs/release-proof.md b/docs/release-proof.md deleted file mode 100644 index 3b8fa6f..0000000 --- a/docs/release-proof.md +++ /dev/null @@ -1,123 +0,0 @@ -# Release lifecycle rehearsal - -Recorded on 2026-10-02 against `main` at `fd1e1f6`, using a fresh local Git -repository. This verifies setup, export preparation, and removal with the -source-built CLI. It does not publish issues or a release. There were no GitHub -releases when this rehearsal ran. - -## Automated proof - -`scripts/lifecycle-check.sh` accepts the absolute path of an installed Quest -binary. The focused CI job installs the checkout through the flake's source -build (`nix build`) on Linux and macOS, then runs the script. `just test` also -runs the script against the local bundle, `dist/quest.js`. - -The script exercises both real skill-directory layouts and both root instruction -choices. It checks init idempotence, the installed stubs, a planned dependency, -check/ready output, uninstall idempotence, and byte-for-byte preservation of -instructions, custom skills, modified Quest stubs, extra user files, and plans. -Separate fixtures prove that a same-named user skill causes init to refuse and -survives cleanup of any stubs created before refusal. - -The existing release install workflow still checks mise and the shell installer -on all four native release targets. Its published-artifact checks require a -real tag; the lifecycle job adds pre-release CLI coverage without expanding the -Ubuntu-only full repository checks. - -## Setup transcript - -Following `SETUP.md`, installation used an isolated temporary prefix instead -of a global install. The source checkout supplies the pre-release revision; -the eventual demonstration should use the repository's chosen tool manager -and a published tag. - -```text -$ nix develop --command cargo install --locked --path . --root /install -Installed package `quest v0.1.0` (executable `quest`) -$ /install/bin/quest --version -quest 0.1.0 -$ quest init -.agents/skills -.claude/skills/quest-audit/SKILL.md -.claude/skills/quest-complete/SKILL.md -.claude/skills/quest-delete/SKILL.md -.claude/skills/quest-export/SKILL.md -.claude/skills/quest-import/SKILL.md -.claude/skills/quest-merge/SKILL.md -.claude/skills/quest-plan/SKILL.md -.claude/skills/quest-spawn/SKILL.md -.claude/skills/quest-start/SKILL.md -.claude/skills/quest-takeover/SKILL.md -quest/README.md -CLAUDE.md -``` - -The existing `CLAUDE.md` retained its repository rule and gained the `Quests:` -pointer. No `AGENTS.md` was created. The export stub named `quest-export` and -pointed to `quest skill export` and the setup guide. The root Goal was adapted -by copying the existing `examples/export/quest/` fixture, whose intended outcome -and plans are already written. This rehearsal creates no project backlog work. - -```text -$ quest guide -[Read the complete guide.] -$ quest check -quest: 4 documents ok -$ quest ready -quest/m0/export.md -``` - -## Export preparation transcript - -```text -$ quest skill export -[Read the complete export instructions.] -$ git remote get-url origin -https://github.com/kixelated/quest.git -$ git log -1 --format=%H -- quest/m0/export.md -132b66b51c8a6395a4520be16ce759009413c299 -``` - -That commit belongs to the local fixture and was never pushed. It demonstrates -the source-revision lookup; a publishable issue needs a reachable commit in the -repository being exported. No fixture links were posted to the real repository. - -The complete proposed export, treating quest contents as data, was: - -| Active document | Intended action | Issue content | -| --- | --- | --- | -| `quest/README.md` | Create an issue | CSV export example: illustrate the endpoint and download-button feature. | -| `quest/m0/README.md` | Create an issue | Download your data: download records as CSV from settings. | -| `quest/m0/export.md` | Create an issue | Add a CSV export endpoint: own records only; include the header and escaping/security Plan. | -| `quest/m0/download.md` | Create an issue | Add a download button: download from settings; include progress/retry Plan. | - -None of these fixtures has a `Closes` section. The export skill's background -rule stops after this survey, before any GitHub write. Recommendation for a -real demonstration: review the four proposed issues, approve publication in a -dedicated scratch repository, then verify Goal, Plan, and permanent source links -in the resulting issues. Issue creation/update remains unverified here. - -## Removal transcript - -Removal was rehearsed locally without publishing the fixture's export. The -fixture plans were deliberately kept. - -```text -$ quest uninstall -[Removed all ten unmodified Quest stubs, the skill-directory link, and the pointer.] -$ cat CLAUDE.md -# Scratch repository - -Keep the repository rules. -$ cat user-data.txt -Keep this user-owned content. -$ quest check -quest: 4 documents ok -``` - -## Remaining release work - -After review, a maintainer must tag and publish v0.1.0 and confirm the existing -Release workflow's mise/shell install checks pass on macOS and Linux. The -release-proof quest remains open until that condition and the approved live -export demonstration are satisfied. diff --git a/quest/m0/cloudflare/README.md b/quest/m0/cloudflare/README.md index 8ee60db..0decd6c 100644 --- a/quest/m0/cloudflare/README.md +++ b/quest/m0/cloudflare/README.md @@ -51,7 +51,8 @@ Decided while planning on 2026-10-01. Research sources: a Workers custom domain, so its DNS moves to Cloudflare before deploying. - Quest moves from Rust to TypeScript (decided 2026-10-06): one language and one core for the CLI, Worker, site, and map, replacing the wasm bridge. - The port and its release pipeline land on this line's branch. + The port landed on this line's branch, which then folded into main + (#35, decided 2026-10-07). Remaining children target main, per #44. - Agents run either locally or hosted. Watching an agent run live is a non-goal beyond showing its status. In v1, checks run `quest check` only. diff --git a/quest/m0/cloudflare/release.md b/quest/m0/cloudflare/release.md index 0f97629..9027017 100644 --- a/quest/m0/cloudflare/release.md +++ b/quest/m0/cloudflare/release.md @@ -17,7 +17,8 @@ Decided while planning on 2026-10-06: and nix pins keep working. The cost is roughly 60 MB per binary. - Replaces cargo-dist, which the port to TypeScript removed along with Rust. Nothing is tagged yet, so no published pin breaks. -- Lands on the Cloudflare questline's branch, where the TypeScript CLI lives. +- Targets main. The Cloudflare questline's branch folded into main on + 2026-10-07, after the TypeScript port landed. - Unreleased pins go through the nix flake's source build. There are no rolling prereleases. Remove the `cargo:` rev pin and `cargo install` from `SETUP.md`. diff --git a/quest/m0/launch.md b/quest/m0/launch.md index 4c8d11c..758e90f 100644 --- a/quest/m0/launch.md +++ b/quest/m0/launch.md @@ -17,7 +17,8 @@ scope. The README and the landing page belong to work tracking for coding agents) and [OpenSpec](https://github.com/Fission-AI/OpenSpec) (spec-driven work), as checked on 2026-09-19. Re-check them before writing. -- Use the release-proof transcript for the demo. +- Use the release-proof transcript, kept in that quest's PR description, for + the demo. ## Required diff --git a/quest/m0/release-proof.md b/quest/m0/release-proof.md index 7df9f23..d272e0f 100644 --- a/quest/m0/release-proof.md +++ b/quest/m0/release-proof.md @@ -9,11 +9,14 @@ installs through mise and the shell installer on macOS and Linux. ## Plan -- CLI lifecycle coverage and a local setup/export-preparation transcript are - implemented in [the release rehearsal](../../docs/release-proof.md). The +- CLI lifecycle coverage runs in CI (`scripts/lifecycle-check.sh`). The focused CI job installs this checkout on Linux and macOS; the full repository check stays on Ubuntu. Live export publication and the maintainer's release tag remain outstanding, so this quest stays open. +- The Rust-era rehearsal record, `docs/release-proof.md`, was deleted on + 2026-10-07. It went stale with the TypeScript port, and the site publishes + every `docs/*.md`. Re-run the setup/export-preparation rehearsal against the + compiled binaries, and keep the transcript in this quest's PR description. - The CLI half runs scripted in CI on macOS and Linux. The agent half (setup guide, export skill) is verified once by hand against a scratch repository, with the transcript kept for the launch demo.