v0.0.6

Release v0.0.6 (+ docs audit) (#43)

Preps the v0.0.6 patch release and lands a full documentation audit of
CLAUDE.md, README, skills, reference docs, and per-verb CLI help against
the verb registry (`overcast commands --json`) and the actual
implementations.

## Docs audit fixes

**Registry / CLI help (source of truth for generated skills):**
- `see`: removed the phantom `--embed` flag — declared in help but never
read by the implementation (`overcast see img.jpg --embed` silently did
nothing). Also scrubbed the stale `see --embed` comments and the dead
`TargetEntry.seed` field in `src/state/target.ts`.
- `provider --preset` help: added missing `basic-clip` to the preset
enum.
- `wall --source` help + error: added missing `x` and `lens` source
types.
- `setup` summary: added the implemented-but-unlisted `memory`
subcommand.
- `monitor --alert` help: clarified it's a file sink (records already
stream to stdout).

**README:**
- Fixed the `skills install` block: there is no interactive menu and no
`--global` flag; it copies all shipped skills into `~/.claude/skills`
(`--harness claude-code` is the only target).
- Split `view` / `crop` / `wall` out of the **Senses** table into an
**Inspect** table, matching the registry's grouping.

**docs/flows.md:**
- Visual-DB provider-class bullet now covers `face-cluster` +
`basic-clip`; sources bullet now covers `lens`.
- Command matrix gains the missing `image`, `cluster`, `similar` rows.
- New flow **18. Copycat sweep (x + lens reverse-image)** covering the
`x:` refs (`x:@handle`, `x:video:<q>`, `x:image:<q>`), `lens:`
reverse-image search, and the geometry-gated `image match` layer.
- Preset list gains `basic-clip`.

**docs/providers.md:** preset table gains `basic-clip` →
`similar:basic-clip`; visual-db samples list gains `face_cluster.py`.

**Skills (fixed in `src/skill-gen.ts` templates, regenerated):**
- visual-target-search: `overcast image ./clip.mp4 …` → `overcast image
match …` (the bare form errors); noted that `see --detect` requires
binding a detection provider first.
- copycat-sweep: corrected the score-scale caveat — face similarity is
0–100 (percent), but `image match` reports a RANSAC inlier count + 0–1
inlier ratio (there is no 0–100 image similarity).
- media-bug-triage: `frame://<record-id>@<timestamp>` → `@<seconds>`
(the parser only accepts numeric seconds).

**test/e2e/README.md:** live-case list gains the missing `14_face`,
`15_crop`, `17_face_cluster`, `25_case_setup`.

Confirmed accurate during the audit (no changes needed):
CLAUDE.md/AGENTS.md, all env vars, pinned versions (pi 0.80.1, tinycloud
≥0.3.4 / rec 0.3.7, node ≥22), source-ref grammars, slash-command list,
record contract, provider transports, and per-verb flag coverage for the
other 24 verbs.

## Release v0.0.6

`npm version 0.0.6 --no-git-tag-version` + `sync-version` —
package.json, package-lock.json, `src/version.ts`, and both
`.claude-plugin/*.json` bumped in lockstep (`sync-version.mjs --check`
passes).

## Verification

- `npm run typecheck` clean
- `npm test`: 542/542 unit tests pass
- `npm run test:e2e` (offline fixtures): 164/164 pass
- `skills generate` is byte-stable against the committed skills

## After merge (per RELEASING.md)

```bash
git checkout main && git pull
git tag v0.0.6 && git push origin v0.0.6
```

The tag push triggers `release.yml`: npm publish via OIDC trusted
publishing + cross-compiled bun binaries attached to the GitHub Release.

<!-- CURSOR_SUMMARY -->
---

> [!NOTE]
> **Low Risk**
> Mostly documentation and help text; the only runtime-adjacent change
is removing the documented-but-unimplemented `see --embed` flag and
stale target `seed` field, which should not affect working flows.
> 
> **Overview**
> **Release v0.0.6** — version bumped in lockstep across `package.json`,
lockfile, `src/version.ts`, and Claude plugin manifests.
> 
> **Docs & skills audit** so README, `docs/flows.md`,
`docs/providers.md`, generated skills, and `verbs.md` match the registry
and real behavior:
> 
> - **README**: Corrects `skills install` (no menu/`--global`; copies to
`~/.claude/skills`). Splits **Inspect** (`view` / `crop` / `wall`) out
of the Senses table.
> - **`docs/flows.md`**: Documents visual DB index types
(`face-cluster`, `basic-clip`), `lens` sources, command-matrix rows for
`image` / `cluster` / `similar`, the **copycat sweep** flow (X + Lens +
geometry-gated `image match`), and the `basic-clip` preset.
> - **Skills** (templates in `src/skill-gen.ts` + committed outputs):
`image match` subcommand, `frame://@<seconds>`, detection-provider note
for `see --detect`, and copycat score-scale caveats (face 0–100 vs
RANSAC inliers/ratio).
> 
> **CLI help / registry fixes** in verb specs: drops undocumented **`see
--embed`** from help and removes the unused `TargetEntry.seed` field;
**`setup`** summary lists **`memory`**; **`wall --source`** and
**`provider --preset`** include **`x`**, **`lens`**, and
**`basic-clip`**; **`monitor --alert`** clarified as file-only (stdout
already streams records).
> 
> <sup>Reviewed by [Cursor Bugbot](https://cursor.com/bugbot) for commit
405dc379a2724a00c0d2664feba06f1399f91cb9. Bugbot is set up for automated
code reviews on this repo. Configure
[here](https://www.cursor.com/dashboard/bugbot).</sup>
<!-- /CURSOR_SUMMARY -->