30fc7775a5
Modernizes several `internal/*` packages under the Go proxy, replaces
third-party forks with standard-library primitives, and brings the
test suite from near-zero to high coverage across the touched packages.
Package changes
- **`internal/errors`** — Rewrites the `pkg/errors` fork as a thin
wrapper
over stdlib `errors`. A single `withStack` struct captures stack
traces via `runtime.Callers`; `fmt.Errorf("%w", ...)` handles all
message wrapping. Restores `errors.Is`/`As`/`Unwrap` chain traversal
(silently broken in the fork) and deletes ~190 lines of stack/frame
formatting. `Is`, `As`, `Unwrap`, and `Join` are re-exported so
callers need a single import.
- **`internal/logger`** — Swaps stdlib `log.Logger` for `log/slog` JSON
handlers with UTC timestamps and custom level labels (`verb`, `debug`,
`warn`, `error`). Hides `withContextID` (no external callers).
- **`internal/sync`** — Converts `Map[K, V]` from a concrete struct to
an interface with a `NewMap` constructor for testability.
- **`internal/signal`** — Adds `signalNotify` / `osExit` indirections so
`InstallSignals` and `InstallForceQuit` can be exercised without real
OS signals or process termination.
- **`internal/utils`** — Drops deprecated `io/ioutil` and the stdlib
`errors` alias (the internal `errors` package re-exports what's
needed).
- **`internal/version`** — No code changes; fully covered by new tests.
---------
Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
77 lines
2.7 KiB
Markdown
77 lines
2.7 KiB
Markdown
# TOOLS.md - Local Notes
|
|
|
|
Skills define _how_ tools work. This file is for _your_ specifics — the stuff that's unique to your setup.
|
|
|
|
## What Goes Here
|
|
|
|
Things like:
|
|
|
|
- Camera names and locations
|
|
- SSH hosts and aliases
|
|
- Preferred voices for TTS
|
|
- Speaker/room names
|
|
- Device nicknames
|
|
- Anything environment-specific
|
|
|
|
## Examples
|
|
|
|
```markdown
|
|
### Cameras
|
|
|
|
- living-room → Main area, 180° wide angle
|
|
- front-door → Entrance, motion-triggered
|
|
|
|
### SSH
|
|
|
|
- home-server → 192.168.1.100, user: admin
|
|
|
|
### TTS
|
|
|
|
- Preferred voice: "Nova" (warm, slightly British)
|
|
- Default speaker: Kitchen HomePod
|
|
```
|
|
|
|
## Why Separate?
|
|
|
|
Skills are shared. Your setup is yours. Keeping them apart means you can update skills without losing your notes, and share skills without leaking your infrastructure.
|
|
|
|
## Model Auth
|
|
|
|
- Anthropic / Opus refresh: `claude setup-token` -> `openclaw models auth setup-token --provider anthropic`
|
|
- Codex refresh: `openclaw models auth login --provider openai-codex`
|
|
- Temporary workaround when one model auth is broken: use `/model ...` in the current session to switch to another working model.
|
|
|
|
### Telegram
|
|
|
|
- Channel: `telegram`, accountId: `srs` (SRS bot)
|
|
- When sending to William's Telegram: `channel: "telegram"`, `accountId: "srs"`
|
|
|
|
### Working Directory
|
|
|
|
- ⚠️ **CRITICAL RULE:** Find everything from the current working directory. All SRS project directories are available here — no discovery, no parent traversal, no absolute paths.
|
|
- Available directories: `trunk/`, `cmd/`, `internal/`, `cmake/`, `docs/`, `memory/`
|
|
- All AI tools (OpenClaw, Codex, Claude Code, Kiro CLI) see the same relative paths.
|
|
- ACP agents (Codex, Claude Code, etc.) also use the current directory as root — they find files from here too.
|
|
- Use the OpenClaw workspace itself only for OpenClaw-specific/meta tasks.
|
|
|
|
### Git Commit Workflow
|
|
|
|
- **Never `git add`** — William stages files himself
|
|
- **Never `git push`** — William pushes himself
|
|
- **Commit workflow:** `git diff --cached` → understand the changes → write title/description → `git commit -m "OpenClaw: ..."` or `"Claude: ..."`
|
|
- Title prefix: `OpenClaw:` or `Claude:`
|
|
- **Co-author for ACP Claude Code:** If Claude Code (ACP) was used to make the changes, add:
|
|
`Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>`
|
|
- **Co-author for ACP Codex:** If Codex (ACP) was used to make the changes, add:
|
|
`Co-authored-by: chatgpt-codex-connector[bot] <199175422+chatgpt-codex-connector[bot]@users.noreply.github.com>`
|
|
|
|
### Go (GVM)
|
|
|
|
- Go is managed via **GVM** (Go Version Manager), NOT Homebrew
|
|
- Before running any `go` command: `source ~/.gvm/scripts/gvm`
|
|
- **Never** use `brew install go` — always use GVM
|
|
|
|
---
|
|
|
|
Add whatever helps you do your job. This is your cheat sheet.
|