@jlongo78/agent-spaces 0.9.8 → 0.9.9

package/.next/standalone/cortex-hook-debug.log

@@ -55,3 +55,64 @@
 [2026-04-19T13:39:55.433Z] Querying: http://localhost:3457/api/cortex/context/?q=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&limit=5&workspace_id=2 (event: UserPromptSubmit)
 [2026-04-19T13:39:55.467Z] Main error: 307
 [2026-04-19T13:39:55.467Z] Hook finished
+[2026-04-19T13:42:05.596Z] [LEARN] Learn hook started
+[2026-04-19T13:42:05.605Z] [LEARN] Input length: 573
+[2026-04-19T13:42:05.615Z] [LEARN] Sending POST to http://localhost:3457/api/cortex/knowledge/
+[2026-04-19T13:42:05.657Z] [LEARN] Response: 307
+[2026-04-19T13:42:36.645Z] Hook started
+[2026-04-19T13:42:36.651Z] Input length: 356
+[2026-04-19T13:42:36.652Z] Querying: http://localhost:3457/api/cortex/context/?q=this%20is%20my%20pc%20--%20why%20does%20it%20matter%20if%20it's%20exposed%20in%20the%20conversation%3F&limit=5&workspace_id=2 (event: UserPromptSubmit)
+[2026-04-19T13:42:36.692Z] Main error: 307
+[2026-04-19T13:42:36.693Z] Hook finished
+[2026-04-19T13:42:48.628Z] [LEARN] Learn hook started
+[2026-04-19T13:42:48.803Z] [LEARN] Input length: 1549
+[2026-04-19T13:42:48.814Z] [LEARN] Sending POST to http://localhost:3457/api/cortex/knowledge/
+[2026-04-19T13:42:48.851Z] [LEARN] Response: 307
+[2026-04-19T13:43:13.309Z] Hook started
+[2026-04-19T13:43:13.315Z] Input length: 325
+[2026-04-19T13:43:13.315Z] Querying: http://localhost:3457/api/cortex/context/?q=how%20do%20I%20check%20to%20see%20if%20telemetry%20is%20on%3F&limit=5&workspace_id=2 (event: UserPromptSubmit)
+[2026-04-19T13:43:13.350Z] Main error: 307
+[2026-04-19T13:43:13.350Z] Hook finished
+[2026-04-19T13:43:53.691Z] [LEARN] Learn hook started
+[2026-04-19T13:43:53.703Z] [LEARN] Input length: 1307
+[2026-04-19T13:43:53.713Z] [LEARN] Sending POST to http://localhost:3457/api/cortex/knowledge/
+[2026-04-19T13:43:53.750Z] [LEARN] Response: 307
+[2026-04-19T13:48:18.876Z] Hook started
+[2026-04-19T13:48:18.882Z] Input length: 287
+[2026-04-19T13:48:18.882Z] Prompt too short
+[2026-04-19T13:52:11.498Z] [LEARN] Learn hook started
+[2026-04-19T13:52:11.505Z] [LEARN] Input length: 354
+[2026-04-19T13:52:11.514Z] [LEARN] Sending POST to http://localhost:3457/api/cortex/knowledge/
+[2026-04-19T13:52:11.557Z] [LEARN] Response: 307
+[2026-04-19T13:52:37.908Z] Hook started
+[2026-04-19T13:52:37.914Z] Input length: 314
+[2026-04-19T13:52:37.916Z] Querying: http://localhost:3457/api/cortex/context/?q=add%20that%20to%20my%20claude%20settings&limit=5&workspace_id=2 (event: UserPromptSubmit)
+[2026-04-19T13:52:37.948Z] Main error: 307
+[2026-04-19T13:52:37.949Z] Hook finished
+[2026-04-19T13:53:23.519Z] [LEARN] Learn hook started
+[2026-04-19T13:53:23.529Z] [LEARN] Input length: 532
+[2026-04-19T13:53:23.541Z] [LEARN] Sending POST to http://localhost:3457/api/cortex/knowledge/
+[2026-04-19T13:53:23.579Z] [LEARN] Response: 307
+[2026-04-22T17:51:18.661Z] Hook started
+[2026-04-22T17:51:18.668Z] Input length: 326
+[2026-04-22T17:51:18.669Z] Querying: http://localhost:3457/api/cortex/context/?q=update%20ffrom%20github%20and%20push%20a%20new%20npm%20release&limit=5&workspace_id=2 (event: UserPromptSubmit)
+[2026-04-22T17:51:18.696Z] Main error: 
+[2026-04-22T17:51:18.696Z] Hook finished
+[2026-04-22T17:51:58.962Z] [LEARN] Learn hook started
+[2026-04-22T17:51:58.968Z] [LEARN] Input length: 559
+[2026-04-22T17:51:58.976Z] [LEARN] Sending POST to http://localhost:3457/api/cortex/knowledge/
+[2026-04-22T17:51:59.003Z] [LEARN] Request error: 
+[2026-04-22T18:06:02.839Z] Hook started
+[2026-04-22T18:06:02.845Z] Input length: 1514
+[2026-04-22T18:06:02.846Z] Querying: http://localhost:3457/api/cortex/context/?q=npm%20notice%201.4kB%20bin%2Fspaces-reset-totp.js%0Anpm%20notice%2036.8kB%20bin%2Fspaces-service.js%0Anpm%20notice%208.9kB%20bin%2Fspaces-setup.js%0Anpm%20notice%2033.6kB%20bin%2Fspaces.js%0Anpm%20notice%202.3kB%20bin%2Fssh-auth-keys.sh%0Anpm%20notice%20108.5kB%20bin%2Fterminal-server.js%0Anpm%20notice%203.4kB%20package.json%0Anpm%20notice%20Tarball%20Details%0Anpm%20notice%20name%3A%20%40jlongo78%2Fagent-spaces%0Anpm%20notice%20version%3A%200.9.9%0Anpm%20notice%20filename%3A%20jlongo78-agent-spaces-0.9.9.tgz%0Anpm%20notice%20package%20size%3A%2018.5%20MB%0Anpm%20notice%20unpacked%20size%3A%2089.8%20MB%0Anpm%20notice%20shasum%3A%2051e72b721f4acb1c8310031c78f24475639d870c%0Anpm%20notice%20integrity%3A%20sha512-L3MTwHtZpUSCN%5B...%5DY1n6%2FUIyMlpYA%3D%3D%0Anpm%20notice%20total%20files%3A%203341%0Anpm%20notice%0Anpm%20notice%20Publishing%20to%20https%3A%2F%2Fregistry.npmjs.org%2F%20with%20tag%20latest%20and%20public%20access%0Anpm%20error%20code%20E404%0Anpm%20error%20404%20Not%20Found%20-%20PUT%20https%3A%2F%2Fregistry.npmjs.org%2F%40jlongo78%252fagent-spaces%20-%20Not%20found%0Anpm%20error%20404%0Anpm%20error%20404%20%20'%40jlongo78%2Fagent-spaces%400.9.9'%20is%20not%20in%20this%20registry.%0Anpm%20error%20404%0Anpm%20error%20404%20Note%20that%20you%20can%20also%20install%20from%20a%0Anpm%20error%20404%20tarball%2C%20folder%2C%20http%20url%2C%20or%20git%20url.%0Anpm%20error%20A%20complete%20log%20of%20this%20run%20can%20be%20found%20in%3A%20C%3A%5CUsers%5Cjohns%5CAppData%5CLocal%5Cnpm-cache%5C_logs%5C2026-04-22T18_01_12_712Z-debug-0.log%0A%0AD%3A%5Cprojects%5Cspaces%3E&limit=5&workspace_id=2 (event: UserPromptSubmit)
+[2026-04-22T18:06:02.872Z] Main error: 
+[2026-04-22T18:06:02.873Z] Hook finished
+[2026-04-22T18:06:14.831Z] [LEARN] Learn hook started
+[2026-04-22T18:06:14.838Z] [LEARN] Input length: 960
+[2026-04-22T18:06:14.847Z] [LEARN] Sending POST to http://localhost:3457/api/cortex/knowledge/
+[2026-04-22T18:06:14.877Z] [LEARN] Request error: 
+[2026-04-22T18:07:49.032Z] Hook started
+[2026-04-22T18:07:49.039Z] Input length: 320
+[2026-04-22T18:07:49.041Z] Querying: http://localhost:3457/api/cortex/context/?q=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&limit=5&workspace_id=2 (event: UserPromptSubmit)
+[2026-04-22T18:07:49.071Z] Main error: 
+[2026-04-22T18:07:49.071Z] Hook finished

package/.next/standalone/docs/features/claude-usage.md

@@ -0,0 +1,105 @@
+# Claude Plan-Usage Display
+
+**Status:** stable
+**Owner:** jlongo
+**Last updated:** 2026-04-22
+
+## Overview
+
+A compact readout of the user's Anthropic plan-usage rate limits, surfaced in the terminal page header whenever the active workspace has at least one Claude pane. Shows 5-hour, 7-day Opus, and 7-day Sonnet windows at a glance; click expands to all windows plus overage credits. Data matches what `/usage` shows inside Claude Code.
+
+## User-facing behavior
+
+- Open any workspace on `/terminal` that has a Claude pane.
+- A horizontal strip appears in the header (right side, before Files / Collab / Close / Add Pane).
+- Three thin progress bars: **5h**, **Opus**, **Sonnet** — each with a percent label and a color that escalates green → amber → red.
+- Hover a bar → tooltip `{label}: X% used · resets in 2h 14m`.
+- Click the strip → popover with all five rate-limit windows + an overage-credits block if the account has overage enabled.
+- If the OAuth token is missing or expired, the strip shows `sign in via Claude Code` with a small login icon. No auto-refresh.
+- If the Anthropic endpoint fails or times out, the strip hides silently.
+
+## Architecture
+
+UI (`src/components/claude/claude-usage-strip.tsx`) → polling hook (`src/hooks/use-claude-usage.ts`) → API route (`src/app/api/claude/usage/route.ts`) → credentials reader (`src/lib/claude/credentials.ts`) + Anthropic fetcher with 30s cache (`src/lib/claude/usage.ts`) → `https://api.anthropic.com/api/oauth/usage`.
+
+Polling: hook calls the route on mount and every 60s while the strip is enabled. Server caches the Anthropic response 30s per access-token prefix so rapid re-polls don't hammer Anthropic.
+
+## Key files
+
+| Path | Role |
+|---|---|
+| `src/lib/claude/credentials.ts` | Reads `~/.claude/.credentials.json`, extracts `claudeAiOauth`, exposes `isTokenExpired()`. |
+| `src/lib/claude/usage.ts` | Calls Anthropic's `/api/oauth/usage`, 5s timeout, 30s in-memory cache. |
+| `src/app/api/claude/usage/route.ts` | `GET` handler; returns one of `ok` / `unauthenticated` / `expired` / `upstream_error`. |
+| `src/hooks/use-claude-usage.ts` | 60s polling hook, toggled by `enabled` arg. |
+| `src/components/claude/claude-usage-strip.tsx` | Compact 3-bar strip + expanded popover. |
+| `src/app/(desktop)/terminal/page.tsx` | Mounts the strip conditionally in the header. |
+| `src/types/claude.ts` | `RateLimit`, `ExtraUsage`, `Utilization`, `UsageResponse`. |
+
+## Data model
+
+No DB tables. All state is transient:
+- Server-side: in-memory `Map<tokenPrefix, { fetchedAt, data }>` in `src/lib/claude/usage.ts` with 30s TTL. Process-local; resets on server restart.
+- Client-side: React state in the hook.
+
+## APIs / contracts
+
+### Internal endpoints
+
+- `GET /api/claude/usage` — returns `UsageResponse`:
+  - `200 { status: "ok", data: Utilization }` — happy path.
+  - `200 { status: "unauthenticated" }` — no credentials file or no `claudeAiOauth`.
+  - `200 { status: "expired" }` — access token past `expiresAt`.
+  - `200 { status: "upstream_error" }` — Anthropic non-2xx or timeout.
+
+Auth: same `withUser`/`getAuthUser` wrapping as every other `/api/*` route.
+
+### External calls
+
+- **Anthropic `GET https://api.anthropic.com/api/oauth/usage`** — uses the user's own OAuth access token read from `~/.claude/.credentials.json`. No secret of our own. User-Agent `claude-code/spaces-integration`.
+
+## Configuration & environment
+
+- `CLAUDE_CONFIG_DIR` — respected (defaults to `~/.claude`). Same semantics as Claude Code.
+- No env vars, feature flags, or tier gates specific to this feature.
+
+## How to run / test locally
+
+```bash
+npm install
+npm run build
+npm start
+# visit http://localhost:3457/terminal, enter a workspace, add a Claude pane
+```
+
+Manual QA checklist:
+
+1. With a valid OAuth session (logged in via any recent Claude Code run): the strip appears in the header; percents match `/usage` inside Claude Code.
+2. Hover each bar → tooltip shows the reset timing.
+3. Click → popover with all five windows and overage block (if applicable).
+4. Delete the Claude pane from the workspace → strip disappears.
+5. Set `claudeAiOauth.expiresAt` to a past timestamp in `.credentials.json`, reload → strip shows "sign in via Claude Code".
+6. Move `.credentials.json` aside temporarily, reload → same sign-in hint.
+7. Disconnect network → within ~90s the strip silently hides (`upstream_error` → null render).
+
+No automated tests for v1.
+
+## Known quirks & decisions
+
+- **Passive refresh.** We do not refresh the OAuth access token. Claude Code owns the refresh lifecycle and writes `.credentials.json`; racing with it would corrupt the shared file.
+- **Account-wide data, not per-pane.** The Anthropic endpoint returns account-level rate limits. Rendering once in the header (not per-pane) is intentional.
+- **User-Agent and anthropic-beta header.** The Anthropic `/api/oauth/usage` endpoint requires the `anthropic-beta: oauth-2025-04-20` header in addition to the Bearer token — without it the call 4xx-errors out. Both the UA (`claude-code/spaces`) and the beta header are constants in `src/lib/claude/usage.ts`; if upstream ever rotates the beta header, bump it there.
+- **30s cache + 60s poll.** Outer-bound staleness is ~90s; fine for windows that move in hours.
+- **Token-prefix cache key.** First 16 chars of `accessToken`. Collision probability is effectively nil; avoids holding full tokens in the cache structure beyond the single request.
+- **Silent upstream failure.** Errors hide the strip rather than showing a red toast — rate-limit info is nice-to-have, not mission-critical.
+- **Ships direct to `main`.** Per repo convention.
+
+## Open questions / TODOs
+
+- [ ] Active OAuth refresh — mirror Claude Code's `/oauth/token` dance to keep the widget live past expiry. Deferred for v1.
+- [ ] Session-cost complement using local JSONL token counts (different data source).
+- [ ] Consider surfacing 7-day-overall alongside the current three for users who care.
+
+## Changelog
+
+- 2026-04-22 — Initial implementation. v1 ships direct to `main`.

package/.next/standalone/docs/features/workspace-todos.md

@@ -0,0 +1,127 @@
+# Workspace Todos
+
+**Status:** stable
+**Owner:** jlongo
+**Last updated:** 2026-04-21
+
+## Overview
+
+A lightweight todo list attached to each workspace. Renders inline at the top of `/terminal` above the pane grid, always visible. Minimal model: text + checkbox + delete. Scoped per-workspace — switching workspaces swaps the list. Not in scope: agent read/write, drag-reorder, priorities/due dates, cross-workspace views.
+
+## User-facing behavior
+
+- Visit `/terminal`, enter any workspace.
+- A "Todos" bar renders above the pane grid with an "Add todo…" input.
+- Enter adds a todo at the bottom of the uncompleted list. Input stays focused.
+- Click the checkbox → strike-through + sink to the completed section.
+- Click text → inline edit. Enter saves, Esc cancels, blur saves.
+- Hover row → `×` delete button.
+- Eye icon in the header toggles visibility of completed todos (ephemeral, resets on reload).
+
+## Architecture
+
+UI (`src/components/workspace/workspace-todos.tsx`) → API routes (`src/app/api/workspaces/[id]/todos/*`) → DB helpers (`src/lib/db/queries.ts`) → SQLite (`workspace_todos` table in the per-user DB at `~/.spaces/<user>.db`).
+
+Mutations are optimistic client-side with rollback on failure. Workspace switch triggers a fresh refetch keyed on `workspaceId`.
+
+## Key files
+
+| Path | Role |
+|---|---|
+| `src/components/workspace/workspace-todos.tsx` | Inline UI component — fetching, optimistic CRUD, rendering |
+| `src/app/api/workspaces/[id]/todos/route.ts` | `GET` list, `POST` create |
+| `src/app/api/workspaces/[id]/todos/[todoId]/route.ts` | `PATCH` update, `DELETE` remove |
+| `src/lib/db/schema.ts` | `workspace_todos` table declaration inside `initSchema()` |
+| `src/lib/db/queries.ts` | `getWorkspaceTodos`, `addWorkspaceTodo`, `updateWorkspaceTodo`, `deleteWorkspaceTodo` |
+| `src/types/claude.ts` | `WorkspaceTodo` type |
+| `src/app/(desktop)/terminal/page.tsx` | Mounts `<WorkspaceTodos>` above the pane grid |
+| `tests/db/workspace-todos.test.ts` | Query-layer tests — ordering, cascade, scoping |
+
+## Data model
+
+### `workspace_todos`
+
+| Column | Type | Notes |
+|---|---|---|
+| `id` | INTEGER PK | autoincrement |
+| `workspace_id` | INTEGER NOT NULL | FK → `workspaces(id)` ON DELETE CASCADE |
+| `text` | TEXT NOT NULL | trimmed on insert/update; empty rejected |
+| `completed` | INTEGER NOT NULL DEFAULT 0 | 0 or 1 |
+| `sort_order` | INTEGER NOT NULL DEFAULT 0 | meaningful only among uncompleted rows |
+| `created` | TEXT NOT NULL DEFAULT datetime('now') | |
+| `completed_at` | TEXT | set when completed flips 0→1, cleared on 1→0 |
+
+Index: `idx_workspace_todos_workspace` on `workspace_id`.
+
+### TypeScript
+
+```ts
+interface WorkspaceTodo {
+  id: number;
+  workspaceId: number;
+  text: string;
+  completed: boolean;
+  sortOrder: number;
+  created: string;
+  completedAt: string | null;
+}
+```
+
+### Invariants
+
+- Listing order: uncompleted first by `sort_order` ASC, then completed by `completed_at` DESC.
+- New todos get `sort_order = MAX(sort_order WHERE completed=0) + 1`.
+- `completed_at` is `NULL` iff `completed = 0`.
+- Deleting a workspace deletes its todos via FK cascade.
+
+## APIs / contracts
+
+### Internal endpoints
+
+| Method | Path | Request | Response |
+|---|---|---|---|
+| `GET` | `/api/workspaces/:id/todos` | — | `WorkspaceTodo[]` |
+| `POST` | `/api/workspaces/:id/todos` | `{ text: string }` | `201 WorkspaceTodo` or `400 { error }` |
+| `PATCH` | `/api/workspaces/:id/todos/:todoId` | `{ text?, completed? }` | `WorkspaceTodo` or `400`/`404` |
+| `DELETE` | `/api/workspaces/:id/todos/:todoId` | — | `{ ok: true }` |
+
+Auth via `getAuthUser` + `withUser`, same pattern as sibling workspace routes.
+
+### External calls
+N/A.
+
+## Configuration & environment
+None. Always-on Community-tier feature. No env vars, flags, or tier gates.
+
+## How to run / test locally
+
+```bash
+npm install
+npm run build
+npm start
+# visit http://localhost:3457/terminal, enter any workspace
+```
+
+Automated:
+```bash
+npx vitest run tests/db/workspace-todos.test.ts
+```
+
+## Known quirks & decisions
+
+- **Schema lives in `initSchema()`, no migration file.** Matches the pattern in `src/lib/db/schema.ts`; the repo has no separate migration system.
+- **No agent write path in v1.** The coworker's "pi /todos" plugin that inspired this lets agents add todos from inside the session — deferred because it requires an MCP tool or CLI surface.
+- **Optimistic updates without toasts.** Failures `console.error` and revert local state; this is a local-only app, so silent revert is acceptable for v1.
+- **`sort_order = Number.MAX_SAFE_INTEGER` for optimistic inserts.** The temp row sorts to the bottom of uncompleted; the server returns the real `sort_order` on response and replaces the temp.
+- **No confirm on delete.** Minimal ethos. Add undo toast in a follow-up if this proves painful.
+- **Direct-to-main workflow.** Per repo convention for this codebase; no PR flow.
+
+## Open questions / TODOs
+
+- [ ] Agent write access via MCP tool once UI v1 proves out.
+- [ ] Optional: persist the "show completed" toggle in localStorage.
+- [ ] Optional: keyboard shortcut to focus the add-input from anywhere on `/terminal`.
+
+## Changelog
+
+- 2026-04-21 — Initial implementation. v1 ships direct to `main`.