BradGroux
0ed0064d85
docs: add canonical API Reference (docs/API-REFERENCE.md)
...
- Comprehensive endpoint catalog: tasks, time tracking, observations,
analytics, config, settings, hooks, chat/squad, agent status, auth,
telemetry, health, WebSocket
- Auth methods (Bearer, X-API-Key, WS query param), roles, permissions
- Error model and status codes
- Common workflows: agent task lifecycle, polling, blockers, webhooks
- Versioning/deprecation guidance and rate limits
- Linked from README docs map and GETTING-STARTED What's Next section
2026-03-02 01:25:25 -06:00
V.K. Watson
50dfff84ef
revert: restore port 3001 across codebase, keep Express 5 path fix
...
Reverts port change from 1b7a9fe
2026-02-20 21:12:49 -06:00
V.K. Watson
1b7a9feb03
fix: update default API port from 3001 to 3002 across codebase
...
Avoids conflict with OpenClaw gateway on port 3001.
Updated: server config, docs, README, WebSocket hook.
2026-02-20 21:11:40 -06:00
Brad Groux
bcd212dac4
docs: update changelog, readme, and guides for v2.1.1 release
2026-02-07 15:01:32 -06:00
Brad Groux
f176592259
feat(US-1611): Complete orchestrator-inspired features
...
- #73 Prompts registry: prompt-registry/ with 10 starter templates ✓
- #74 Doc freshness: CLAUDE.md template + SOP-documentation-freshness.md ✓
- #75 Setup wizard: vk setup command ✓
- #76 Lifecycle hooks: hook-service.ts + SOP-lifecycle-hooks.md ✓
- #77 Shared resources: SOP-shared-resources.md ✓
Credit: Inspired by Monika Voutov's BoardKit Orchestrator
https://github.com/BoardKit/orchestrator
Closes #73 , closes #74 , closes #75 , closes #76 , closes #77
2026-02-04 09:47:38 -06:00
Brad Groux
4a1cf7d36d
docs: US-1611 SOP-shared-resources — multi-repo resource sharing patterns
...
Added docs/SOP-shared-resources.md covering:
- Single repo vs multi-repo directory structures
- Mounting strategies (copy, symlinks, git submodules, npm packages)
- What to share vs what to keep project-specific
- Referencing shared resources in tasks and prompts
- Versioning and update protocols
- Migration checklist
Updated GETTING-STARTED.md to reference the new prompt-registry templates.
Credit: BoardKit Orchestrator (Monika Voutov) for the shared resources pattern.
Closes #77
2026-02-04 09:36:02 -06:00
Brad Groux
43c01ec8e8
feat: US-1611 prompt-registry — 10 copy/paste prompt templates
...
Created prompt-registry/ folder with starter templates:
- sprint-planning.md — Break epics into sprints
- worker-handoff.md — PM → Worker assignment
- cross-model-review.md — Claude ↔ GPT review gate
- feature-development.md — E2E feature implementation
- bug-triage.md — Investigation and fix workflow
- research-report.md — Deep research deliverable
- task-completion.md — Pre-completion checklist
- blocked-escalation.md — Blocker reporting
- pm-orchestration.md — PM agent managing workers
- standup-summary.md — Daily status report
Updated docs to reference prompt-registry/ instead of shared/prompt-registry/.
Credit: BoardKit Orchestrator (Monika Voutov) for the registry pattern.
Closes #69
2026-02-04 09:34:36 -06:00
Brad Groux
89d6efbe6e
feat(cli): US-1611 vk setup — guided onboarding wizard
...
New CLI command that validates environment and helps new users get started:
- Checks Node version (requires >=18)
- Verifies server is running and accessible
- Tests API authentication
- Optionally creates a welcome task with next steps
- Supports --json output for automation
- Supports --skip-task to skip sample task creation
Updated docs/GETTING-STARTED.md to reference the new command.
Credit: BoardKit Orchestrator (Monika Voutov) for the wizard pattern inspiration.
Closes #71
2026-02-04 09:14:01 -06:00
Brad Groux
eeb11ba219
feat(US-1600): Complete SOP Sprint + fix GH-86 & GH-87
...
Documentation (8 new files in docs/):
- GETTING-STARTED.md: 5-min quickstart, BoardKit insights, sanity checks
- SOP-agent-task-workflow.md: Full lifecycle (claim → work → complete)
- SOP-sprint-planning.md: Epic → sprint → task hierarchy + estimation
- SOP-multi-agent-orchestration.md: PM + worker roles, handoff patterns
- SOP-cross-model-code-review.md: Claude ↔ GPT gate, checklist, RF-002 ref
- BEST-PRACTICES.md: 10 DOs + 10 DON'Ts based on real usage
- EXAMPLES-agent-workflows.md: 6 copy/pasteable recipes (feature, bug fix, docs, audit, content, research)
- TIPS-AND-TRICKS.md: CLI shortcuts, keyboard shortcuts, integrations (MCP, git worktrees, Obsidian)
- README.md: Added 'Documentation Map' linking all new docs
Bug Fixes:
- fix(GH-86): BulkActionsBar now handles archive errors gracefully
* Per-task error tracking (replaces Promise.all)
* Toast notifications on success/partial/failure
* Logs individual failures to console
- fix(GH-87): Sidebar metrics now stay in sync with board state
* Invalidate metrics cache when task status changes
* Prevents up-to-30s lag in sidebar counts
* Preserves timer state during mutations
Scripts:
- scripts/dev-clean.sh: Added explicit pnpm path resolution for launchd
- scripts/dev-watchdog.sh: Fixed restart storm prevention + pnpm path
BREAKING: None
TESTING:
- Manual: Bulk archive Done column tasks, verify toasts appear
- Manual: Move tasks between columns, verify sidebar counts update <2s
- Unit: Consider regression tests for metrics invalidation
2026-02-04 08:18:01 -06:00
