Skip to content

Update manual test docs for TokenJam rename + new dashboard#54

Merged
anshss merged 1 commit into
mainfrom
update/manual-test-docs
May 8, 2026
Merged

Update manual test docs for TokenJam rename + new dashboard#54
anshss merged 1 commit into
mainfrom
update/manual-test-docs

Conversation

@anilmurty
Copy link
Copy Markdown
Contributor

Summary

Manual pre-release and new-release testing checklists in `tests/` had been left untouched through the project rename and dashboard overhaul. They referenced `ocw` everywhere, pointed at `/.ocw`/`/.config/ocw`, described the old "Open(white)Claw(blue)Watch(white)" sidebar, and overstated the role of `server.state` in Codex onboarding. This PR brings both docs back in sync with the current code.

Changes

Bulk rename to current CLI / paths

  • `ocw ` → `tj ` (every command in both docs)
  • `/.ocw` → `/.tj` (telemetry DB location)
  • `/.config/ocw` → `/.config/tj` (global config)
  • `.ocw/` → `.tj/` (project-local config)
  • `/.local/share/ocw/server.state` → `/.local/share/tj/server.state`
  • `[mcp_servers.ocw]` → `[mcp_servers.tj]`
  • `import tj; tj.file` → `import tokenjam; tokenjam.file` (the Python package directory was renamed to `tokenjam/`)
  • `ruff check ocw/` → `ruff check tokenjam/`
  • `/tmp/ocw-test-project-2` → `/tmp/tj-test-project-2`

UI verification steps updated

  • Old: "Sidebar: Open(white)Claw(blue)Watch(white) with SVG icon"
  • New: "Sidebar: TJ jar-mark SVG + 'TokenJam' wordmark, monochrome (uses `currentColor`)"
  • Removed the "deep navy + blue accent" / "opencla.watch styling" references — the dashboard is now Vercel-style monochrome matching tokenjam.dev.
  • Added explicit theme-toggle verification: cycles `System ⊙ → Light ☀ → Dark ☾`, persists across reloads, no flash on reload, light mode renders correctly.

Codex onboarding flow corrected

  • The doc previously claimed `tj onboard --codex` "reads `server.state` to find the running server's secret." That isn't what `cmd_onboard.py` actually does — onboarding writes to / reads from the global config (`~/.config/tj/config.toml`); `server.state` is informational only.
  • Reordered the Codex section: `tj onboard --codex` first (no server needed), then `tj serve &` before the `codex exec` ingestion test.

Diff

  • `tests/manual-pre-release-testing.md`: +/- ~78 lines each (bulk find/replace + UI block + Codex prereq)
  • `tests/manual-new-release-tests.md`: +/- ~50 lines each

🤖 Generated with Claude Code

Pre-release and new-release testing checklists were full of stale `ocw`
references and old branding. Updated to reflect the current code:

- All `ocw <subcommand>` → `tj <subcommand>`
- `~/.ocw` → `~/.tj` (telemetry DB)
- `~/.config/ocw` → `~/.config/tj` (global config)
- `.ocw/` → `.tj/` (project-local config)
- `~/.local/share/ocw/server.state` → `~/.local/share/tj/server.state`
- `[mcp_servers.ocw]` → `[mcp_servers.tj]`
- `import tj` → `import tokenjam` (Python package directory was renamed)
- `ruff check ocw/` → `ruff check tokenjam/`
- `/tmp/ocw-test-project-2` → `/tmp/tj-test-project-2`

UI checks updated for the new monochrome dashboard:
- Sidebar: "Open(white)Claw(blue)Watch(white) with SVG icon" → "TJ jar-mark
  SVG + TokenJam wordmark, monochrome (currentColor)"
- Old "deep navy + blue accent" styling reference → "monochrome black/white
  matching tokenjam.dev"
- Added theme-toggle verification step (System ⊙ → Light ☀ → Dark ☾)
- Added explicit light-mode rendering check

Codex onboarding flow corrected:
- Removed misleading prereq claim that `tj onboard --codex` "reads
  server.state to find the running server's secret". Onboarding writes
  to / reads from the global config (~/.config/tj/config.toml); it does
  not consult server.state. server.state remains informational only.
- Reordered: `tj onboard --codex` runs first (no server needed), then
  `tj serve` starts before the `codex exec` ingestion test.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@anshss anshss merged commit ec07489 into main May 8, 2026
4 checks passed
@anilmurty anilmurty deleted the update/manual-test-docs branch May 12, 2026 05:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants