13 lines
8.2 KiB
JSON
13 lines
8.2 KiB
JSON
{"author":"zenchant","created_at":"2026-03-01T23:35:26Z","id":1,"issue_id":"beadboard-0fi.3","text":"\"yo"}
|
|
{"author":"claude","created_at":"2026-03-01T23:36:35Z","id":2,"issue_id":"beadboard-0fi.3","text":"yo back 👋 — comment system confirmed working"}
|
|
{"author":"ZenchantLive","created_at":"2026-03-02T04:13:21Z","id":4,"issue_id":"beadboard-43c","text":"this is a multi word test comment"}
|
|
{"author":"ZenchantLive","created_at":"2026-03-02T04:14:15Z","id":5,"issue_id":"beadboard-43c","text":"we"}
|
|
{"author":"ZenchantLive","created_at":"2026-03-02T04:15:29Z","id":6,"issue_id":"beadboard-43c","text":"we"}
|
|
{"author":"zenchant","created_at":"2026-03-02T04:21:18Z","id":7,"issue_id":"bb-18e.4","text":"\"yo"}
|
|
{"author":"ZenchantLive","created_at":"2026-03-02T04:29:59Z","id":8,"issue_id":"beadboard-43c","text":"this is a multi word test via full shell path"}
|
|
{"author":"zenchantlive","created_at":"2026-03-02T04:31:41Z","id":9,"issue_id":"beadboard-43c","text":"\"this"}
|
|
{"author":"zenchant","created_at":"2026-03-02T04:33:32Z","id":10,"issue_id":"bb-ui2.23","text":"\"multi"}
|
|
{"author":"zenchant","created_at":"2026-03-02T04:35:12Z","id":11,"issue_id":"bb-ui2.23","text":"hello helloo"}
|
|
{"author":"zenchant","created_at":"2026-03-02T04:36:22Z","id":12,"issue_id":"beadboard-d2x.1","text":"we need to make sure that we are corectly calculating blocked and anywhere wher eitis reffenced that it saccurate."}
|
|
{"author":"zenchantlive","created_at":"2026-03-02T04:36:24Z","id":13,"issue_id":"beadboard-43c","text":"this is a multi word comment after the fix"}
|
|
{"author":"ZenchantLive","created_at":"2026-03-04T02:15:10Z","id":14,"issue_id":"beadboard-izs","text":"izs.1 audit — existing bb coordination stack and integration contract\n\nFiles audited:\n1) tools/bb.ts\n2) src/lib/agent-mail.ts\n3) src/lib/agent-registry.ts\n4) src/lib/agent-reservations.ts\n5) src/cli/beadboard-cli.ts\n\nA) Existing command surface (source of truth)\n\n1) Internal bb agent CLI in tools/bb.ts (node:util parseArgs)\n- Domain routing: `bb agent \u003ccommand\u003e` only\n- Supported commands:\n - identity: `register`, `list`, `show`, `activity-lease`\n - mail: `send`, `inbox`, `read`, `ack`\n - reservations: `reserve`, `release`, `status`\n- Shared optional output flag: `--json`\n- Passive heartbeat behavior: when any command includes an agent id (`--agent` / `--from` / `--name`), `extendActivityLease()` is attempted as side-effect (except register/activity-lease).\n\n2) Global npm CLI in src/cli/beadboard-cli.ts\n- Current public command surface: `doctor`, `self-update`, `uninstall`, and help text mentions runtime commands (`start/open/status`) via wrapper routing.\n- Not currently wired to expose `bb agent ...` coordination subcommands.\n- CLI parsing style is custom lightweight argv parsing (`command = first non-flag arg`), returns structured `CliResult` and JSON-friendly output.\n\nB) Storage model + paths (confirmed)\n\n1) Mail storage (src/lib/agent-mail.ts)\n- Root: `~/.beadboard/agent/messages/` where `~` resolves as:\n - `process.env.USERPROFILE?.trim()` if present, else `os.homedir()`\n- Inbox per recipient: `~/.beadboard/agent/messages/\u003cagent\u003e.jsonl`\n- Message index (authoritative mutable record): `~/.beadboard/agent/messages/index/\u003cmessage_id\u003e.json`\n- Read path behavior:\n - Inbox lists parse JSONL lines, then hydrate each line from index JSON if present.\n - Message state transitions (`read`, `ack`) update index JSON, not inbox JSONL lines.\n\n2) Reservation storage (src/lib/agent-reservations.ts)\n- Root: `~/.beadboard/agent/reservations/` using same USERPROFILE-\u003ehomedir resolution.\n- Active reservations snapshot: `~/.beadboard/agent/reservations/active.json`\n- History append log: `~/.beadboard/agent/reservations/history.jsonl`\n- Lock file for mutation serialization: `~/.beadboard/agent/reservations/.lock`\n\nC) Integration contract for downstream tasks\n\n1) izs.2 (global CLI wiring contract)\n- Global `bb`/`beadboard` CLI must expose a passthrough/adapter for:\n - `agent register|list|show|activity-lease|send|inbox|read|ack|reserve|release|status`\n- Preserve internal flag semantics from tools/bb.ts:\n - register: `--name --role [--display] [--force-update]`\n - send: `--from --to --bead --category --subject --body [--thread]`\n - inbox: `--agent [--state] [--bead] [--limit]`\n - read/ack: `--agent --message`\n - reserve: `--agent --scope --bead [--ttl] [--takeover-stale]`\n - release: `--agent --scope`\n - status: `[--agent] [--bead]`\n- Output contract: return the same command response envelope:\n - `{ ok, command, data, error }`\n\n2) izs.3 (API routes contract)\nTarget routes:\n- `/api/agents/mail`\n- `/api/agents/reservations`\n\nRecommended HTTP contracts mapped to existing libs (no domain logic reimplementation):\n\n`/api/agents/mail`\n- POST (create/send):\n - body: `{ action: \"send\", from, to, bead, category, subject, body, thread? }`\n - calls `sendAgentMessage`\n - 200 on success, 4xx for validation/not-found codes, 5xx for internal error\n- GET (list/inbox):\n - query: `agent` (required), `state?`, `bead?`, `limit?`\n - calls `inboxAgentMessages`\n- PATCH (state transitions):\n - body:\n - `{ action: \"read\", agent, message }` -\u003e `readAgentMessage`\n - `{ action: \"ack\", agent, message }` -\u003e `ackAgentMessage`\n- Response envelope for all operations: `{ ok, command, data, error }`\n- Note on CRUD: no delete semantics in current mail engine; lifecycle is unread -\u003e read -\u003e acked.\n\n`/api/agents/reservations`\n- POST (create/reserve):\n - body: `{ action: \"reserve\", agent, scope, bead, ttl?, takeoverStale? }`\n - calls `reserveAgentScope`\n- DELETE (logical release):\n - body: `{ action: \"release\", agent, scope }`\n - calls `releaseAgentReservation`\n- GET (status/list):\n - query: `agent?`, `bead?`\n - calls `statusAgentReservations`\n- Response envelope for all operations: `{ ok, command, data, error }`\n- Note on CRUD: release is logical state transition + history append; no destructive delete.\n\n3) izs.5 (bd mail delegate contract)\n- `bd mail` should delegate to same coordination primitives used by `bb agent` (mail + reservations + registry path).\n- Session preflight should verify:\n - agent identity exists/registered\n - path root is writable (`~/.beadboard/agent/...`)\n - JSONL/index storage accessible\n- Delegate path should preserve command response envelope + error codes to keep UI/CLI behavior consistent.\n\nD) API/error semantics that must stay consistent\n\nMail categories: `HANDOFF | BLOCKED | DECISION | INFO`\n- requires_ack=true for HANDOFF and BLOCKED (from `requiresAck()` in agent-mail.ts).\n\nMail states: `unread | read | acked`\n\nRepresentative error codes to propagate (not remap silently):\n- mail: `UNKNOWN_SENDER`, `UNKNOWN_RECIPIENT`, `MISSING_BEAD_ID`, `INVALID_CATEGORY`, `INVALID_MESSAGE`, `AGENT_NOT_FOUND`, `INVALID_STATE`, `INVALID_LIMIT`, `MESSAGE_NOT_FOUND`, `INVALID_MESSAGE_ID`, `READ_FORBIDDEN`, `ACK_FORBIDDEN`, `INTERNAL_ERROR`\n- reservations: `AGENT_NOT_FOUND`, `INVALID_ARGS`, `RESERVATION_CONFLICT`, `RESERVATION_STALE_FOUND`, `RESERVATION_NOT_FOUND`, `RELEASE_FORBIDDEN`, `INTERNAL_ERROR`\n\nE) Platform/path risks (Windows USERPROFILE vs Linux HOME)\n\nObserved:\n- agent-mail.ts and agent-reservations.ts use USERPROFILE first, then os.homedir().\n- beadboard-cli.ts runtime path resolution passes HOME fallback to os.homedir().\n\nRisk:\n- In mixed WSL/Windows sessions, USERPROFILE may point to a Windows path while HOME/homedir for running process differs, causing CLI/runtime artifacts and agent mail/reservation artifacts to diverge across roots.\n\nRecommendation for izs stream:\n- Centralize path-root resolution in one shared helper used by CLI + mail + reservations.\n- Add explicit diagnostics to show the resolved coordination root path in doctor/status outputs.\n- Add contract tests for path parity under mocked env combinations:\n - USERPROFILE set + HOME unset\n - USERPROFILE unset + HOME set\n - both set to different roots\n\nF) Entry points and framework notes\n- Internal coordination CLI entry: `tools/bb.ts` (parseArgs-based command router).\n- Global CLI implementation: `src/cli/beadboard-cli.ts`; package `bin` routes `bb` and `beadboard` to `bin/beadboard.js` wrapper that invokes CLI logic.\n\nThis audit is the contract baseline for izs.2, izs.3, izs.5.\n"}
|