Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 4 additions & 4 deletions ai-docs/HANDOFF.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,9 +3,9 @@
<!-- Keep under 50 lines. Replace, never append. Written at the end of a work session so the next one starts without re-deriving state. -->

## 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.
Expand All @@ -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).
Expand Down
2 changes: 2 additions & 0 deletions ai-docs/log.md
Original file line number Diff line number Diff line change
Expand Up @@ -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)
15 changes: 7 additions & 8 deletions ai-docs/next-session-prompt.md
Original file line number Diff line number Diff line change
@@ -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

Expand All @@ -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
Expand All @@ -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.
Loading