From a191d64293458e9f88504238e2dd9b7562a7db82 Mon Sep 17 00:00:00 2001 From: Mark Rogers <156112+m4bwav@users.noreply.github.com> Date: Thu, 15 Oct 2026 22:44:29 -0500 Subject: [PATCH] ai-docs: after 0.2.0 (handoff, log, next-session prompt) --- ai-docs/HANDOFF.md | 8 ++++---- ai-docs/log.md | 2 ++ ai-docs/next-session-prompt.md | 15 +++++++-------- 3 files changed, 13 insertions(+), 12 deletions(-) diff --git a/ai-docs/HANDOFF.md b/ai-docs/HANDOFF.md index 22325ef..8d72a37 100644 --- a/ai-docs/HANDOFF.md +++ b/ai-docs/HANDOFF.md @@ -3,9 +3,9 @@ ## Current state -- 0.1.0 released on 2026-10-15 (tag v0.1.0, GitHub Release) on the owner's go-ahead. Wiki written and live (9 pages; [notes/2026-10-15-github-wiki.md](notes/2026-10-15-github-wiki.md) says how to update it). -- Two skills: `skills/fetchwright` (reader, CLI `scripts/fetchwright.py` with `check` and `read`) and `skills/fetchwright-setup` (key, tiers, quotas, privacy; `verify_at_use`). Both are registered with evergreen, and `evergreen.py lint` is OK on both. Installed locally as fetchwright@mark-local 0.1.0 (user scope). -- Tests: `python tests/test_fetchwright.py` (37 offline, pass), `python tests/smoke_live.py` (live, passed 2026-10-15), `python scripts/budget.py` (all green). CI runs the suite on three operating systems with Python 3.10 and 3.14, plus the budget job. +- 0.2.0 released on 2026-10-16 (tag v0.2.0, GitHub Release; the quota fall-through) on the owner's go-ahead; 0.1.0 on 2026-10-15. Wiki live and updated for 0.2.0 (9 pages; [notes/2026-10-15-github-wiki.md](notes/2026-10-15-github-wiki.md) says how to update it). +- Two skills: `skills/fetchwright` (reader, CLI `scripts/fetchwright.py` with `check` and `read`) and `skills/fetchwright-setup` (key, tiers, quotas, privacy; `verify_at_use`). Both are registered with evergreen, and `evergreen.py lint` is OK on both. Installed locally as fetchwright@mark-local 0.2.0 (user scope); everscout finds it there (the owner's everscout config no longer sets `fetchwright.cli`). +- Tests: `python tests/test_fetchwright.py` (39 offline, pass), `python tests/smoke_live.py` (live, passed 2026-10-15), `python scripts/budget.py` (all green). CI runs the suite on three operating systems with Python 3.10 and 3.14, plus the budget job. - Live on 2026-10-15: - `gemini-3.8-flash` answers `check` but gives 503 or drops on URL context reads; `gemini-3.5-flash-lite` read every page. - A settled Reddit thread gave 47 comments. @@ -15,7 +15,7 @@ ## In progress - Eval cases in `evals/` (6 trigger and decoy, 2 action) have never run. They need a fresh session with the plugin installed; the action cases need `GEMINI_API_KEY` in the eval environment. - 0.1.1 candidate: `read --json` on stdout is cut at `--max-chars`, giving broken JSON for long threads (wiki note, inaccuracy 2). Leave JSON uncut, or say so in the README. -- everscout wiring: the owner asked for it on 2026-10-15; the prompt is everscout's `ai-docs/next-session-prompt.md` (PR #20). It calls this CLI with `--max-chars 0`. +- everscout 0.5.0 calls this CLI (`--max-chars 0`, `--max-comments 100`) as its opt-in Reddit thread reader. Its discovery plan (everscout `ai-docs/plans/2026-10-16-reddit-discovery-after-arctic-shift.md`) caps reads at 10 a scan. ## Decisions made this session - Standalone plugin, named fetchwright; pages default to a digest; `store: false`; one URL a request. Reasons in [decisions/2026-10-15-fetchwright-as-a-standalone-public-plugin-with-a-stdlib-cli.md](decisions/2026-10-15-fetchwright-as-a-standalone-public-plugin-with-a-stdlib-cli.md). diff --git a/ai-docs/log.md b/ai-docs/log.md index 72a52e2..a86e59c 100644 --- a/ai-docs/log.md +++ b/ai-docs/log.md @@ -12,3 +12,5 @@ Append-only. One line per operation: `## [YYYY-MM-DD] op | title` where op is on ## [2026-10-16] build | a 429 on one model's quota moves to the next model (PR #2, merged, unreleased) everscout's first live run hit the free tier's 20-a-day limit on gemini-3.8-flash and fetchwright stopped although flash-lite had quota. Mark agreed to fall through on a per-model quota 429. Lessons L-004 and L-005 (PR #1). everscout runs this clone through its `fetchwright.cli` config until a 0.2.0 release, which needs Mark's go-ahead. ## [2026-10-16] release | fetchwright 0.2.0: the quota fall-through (PR #2), every version field bumped, README budget table refreshed (all green); released on the owner's go-ahead +## [2026-10-16] update | wiki updated for 0.2.0 (Versions page, the 429 quota fall-through on Commands, How pages are read, Recipes and FAQ, budget output, footer); installed plugin updated to 0.2.0 +## [2026-10-15] index | rebuilt (4 entries) diff --git a/ai-docs/next-session-prompt.md b/ai-docs/next-session-prompt.md index 80cfac1..e463fb6 100644 --- a/ai-docs/next-session-prompt.md +++ b/ai-docs/next-session-prompt.md @@ -1,13 +1,13 @@ -# Next session: fetchwright after 0.1.0 (evals, 0.1.1) +# Next session: fetchwright after 0.2.0 (evals, 0.2.1) -Written 2026-10-15 (night). Run from `D:\m4bwa\Claude\Projects\Ai`. The repository is `Ai\fetchwright` (public, m4bwav/fetchwright, branch main). everscout is `Ai\everscout`; its main clone holds another session's uncommitted edits, so work there in a worktree off origin/main (`Ai\everscout-wt-urlctx` exists). +Written 2026-10-15 (night), updated 2026-10-16 after the 0.2.0 release. Run from `D:\m4bwa\Claude\Projects\Ai`. The repository is `Ai\fetchwright` (public, m4bwav/fetchwright, branch main). everscout is `Ai\everscout`; its main clone holds another session's uncommitted edits, so work there in a worktree off origin/main (`Ai\everscout-wt-urlctx` exists). ## Where things stand -- fetchwright 0.1.0 is released (tag v0.1.0, 2026-10-15) and its wiki is live (ai-docs/notes/2026-10-15-github-wiki.md). It holds two skills (the reader and a setup advisor), the stdlib CLI `skills/fetchwright/scripts/fetchwright.py`, 37 offline tests, a live smoke test, a size budget (all green) and CI. -- Installed as fetchwright@mark-local 0.1.0 (user scope) from `Ai\.claude-plugin\marketplace.json` on 2026-10-15; first CI run green on all seven jobs. +- fetchwright 0.2.0 is released (tag v0.2.0, 2026-10-16: a 429 on one model's quota moves to the next model) and its wiki is live and updated for 0.2.0 (ai-docs/notes/2026-10-15-github-wiki.md). It holds two skills (the reader and a setup advisor), the stdlib CLI `skills/fetchwright/scripts/fetchwright.py`, 39 offline tests, a live smoke test, a size budget (all green) and CI. +- Installed as fetchwright@mark-local 0.2.0 (user scope) from `Ai\.claude-plugin\marketplace.json`; CI green on all seven jobs for 0.2.0. - `GEMINI_API_KEY` is set at user level and works. On 2026-10-15 `gemini-3.8-flash` answered plain calls but 503'd or dropped on URL context; `gemini-3.5-flash-lite` read everything. -- everscout: conduct rule 17 and a kb/platforms.md keyed-sources row for the route (merged, everscout PR #18). +- everscout 0.5.0 uses this CLI as its opt-in Reddit thread reader and finds the installed plugin (Mark's config no longer sets `fetchwright.cli`). Free tier: `gemini-3.8-flash` 20 requests a day; Mark's config runs `gemini-3.5-flash-lite` first. ## Read first @@ -18,8 +18,8 @@ Written 2026-10-15 (night). Run from `D:\m4bwa\Claude\Projects\Ai`. The reposito ## The next steps and their limits 1. Run the eval suite: `claude plugin eval . --tag trigger` (native Windows), and the `live` action cases where `GEMINI_API_KEY` reaches the harness. Earlier runs of this harness used WSL2 for Bash cases (readwright's LEARNINGS L-002, and its solution on running the suite on Windows). Record each run as `T-` in each skill's TESTS.md and update `evergreen.json` `tests`. A failure goes to evergreen-tune. -2. 0.1.1: stop cutting `--json` output at `--max-chars` (a long thread prints broken JSON today), with a test; update the wiki in wikiwright's Update mode (the note lists the pages that name the version). A release needs Mark's go-ahead. -3. The everscout wiring has its own prompt: everscout's `ai-docs/next-session-prompt.md`. If that session is running or done, do not duplicate it; take any CLI change it asks of fetchwright here. +2. 0.2.1: stop cutting `--json` output at `--max-chars` (a long thread prints broken JSON today), with a test; update the wiki in wikiwright's Update mode (the note lists the pages that name the version). A release needs Mark's go-ahead. +3. everscout's own work (its discovery plan) has its own prompt: everscout's `ai-docs/next-session-prompt.md`. Take any CLI change it asks of fetchwright here. 4. Re-test `gemini-3.8-flash` on URL context once Google's load settles. Note the result in RESEARCH.md as an `R-` finding. ## Rules @@ -35,6 +35,5 @@ Written 2026-10-15 (night). Run from `D:\m4bwa\Claude\Projects\Ai`. The reposito - If Gemini starts returning text from deleted or removed posts. - If requests fail with refusals or 429s: record it and stop. - Before any release or tag. -- Before wiring everscout to fetchwright. When you stop, rewrite this file for the session after you: what to read first, the next step and its limits, the rules, when to stop and ask. Its last paragraph must give that session this same instruction.