Commit graph

18 commits

Author SHA1 Message Date
Brad Groux
044e0c0ba3
Fix Docker source builds
Some checks are pending
CI / Lint & Type Check (push) Waiting to run
CI / Workspace Unit Tests (push) Waiting to run
CI / Build (push) Waiting to run
CI / Security Audit (push) Waiting to run
Fix Docker build context and pnpm setup for source builds. Closes #725.
2026-06-18 13:47:00 -05:00
Brad Groux
81bfafdf62
Refresh v5 docs media (#657) 2026-06-05 16:16:42 -05:00
Brad Groux
2cd7fe2ad2 Add prompt template import command 2026-06-04 01:01:14 -07:00
Brad Groux
eb7085a34a Add redacted runtime snapshot command 2026-06-04 00:45:31 -07:00
Brad Groux
5c6ca0651d Add vk doctor setup health command 2026-06-04 00:29:32 -07:00
Brad Groux
dee44f7456 Add board-first setup readiness levels 2026-06-03 08:55:08 -07:00
Brad Groux
ce0ff8022f Clarify optional integration setup docs 2026-06-03 08:50:42 -07:00
Brad Groux
d3976f1d74 chore: harden audit findings and release QA
Add release validation and scheduled QA workflows.

Harden webhook URL handling, API helper edge cases, and runtime version reporting.

Split heavy web bundles, centralize view metadata, and stabilize full-suite tests.
2026-05-16 18:59:40 -05:00
Brad Groux
578269963a
Clarify setup paths and integration auth
Clarify setup paths, integration auth behavior, and communication docs.
2026-05-13 14:21:30 -05:00
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. OpenClaw gateway will move off 3001 instead.
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