Commit graph

11 commits

Author SHA1 Message Date
Brad Groux
866afdfc57 docs: fix v6 release notes and harness guidance 2026-07-24 15:40:01 -05:00
Brad Groux
ce0ff8022f Clarify optional integration setup docs 2026-06-03 08:50:42 -07:00
bradgroux
6661cd0b3e docs: update agent task workflow SOP for v4.0
- Remove version tags from section headers
- Add Governance Compliance section covering policy checks,
  decision logging, and output scoring integration
2026-03-25 21:41:47 -05: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
V.K. Watson
9657e731b6
fix: guard updatedTask null check in task routes
also clean up observations section build warning
2026-02-20 01:51:45 -06:00
Brad Groux
af6d72f426 docs(enforcement): comprehensive documentation for all 6 gates (#115)
- Updated docs/enforcement.md with squadChat and orchestratorDelegation gates
- Added 'For AI Agents' section with pre-flight checks, 400 error handling, and polling optimization
- Added error code reference (REVIEW_GATE_FAILED, CLOSING_COMMENT_REQUIRED, etc.)
- Added practical examples of what happens when agents violate enforcement gates
- Updated README.md with Enforcement Gates section in Feature Highlights
- Updated CHANGELOG.md with enforcement feature entry for next release
- Updated SOP-agent-task-workflow.md with enforcement gates awareness section
- All docs now reference both human operators and AI agents as primary audiences
2026-02-10 08:09:21 -06:00
Brad Groux
8cce9f24c4 feat: Squad chat protocol scripts, system events, model attribution
- Add squad-post.sh for regular agent messages
- Add squad-event.sh for lifecycle events (spawned/completed/failed/status)
- Add model field to squad messages (types, server, UI, scripts)
- System events render as divider lines in squad chat panel
- Model attribution displays next to agent names in UI
- Full protocol documented in SQUAD-CHAT-PROTOCOL.md
- Updated CONTRIBUTING.md, README.md, and all SOPs
- Added VK_HOST/VK_PORT env vars to .env.example

4-check cross-model review: 10/10 (Code/GPT-5.1, Func/Grok, Perf/Grok, Sec/GPT-5.1)
Agents: R2-D2 (feature), TARS/CASE/Ava/K-2SO (reviews)
2026-02-07 13:04:17 -06:00
Brad Groux
c57e368a25 docs: add mandatory telemetry emission steps to agent docs
The dashboard's Success Rate, Token Usage, and Average Run Duration
graphs are powered by run.* telemetry events that agents must emit
manually — they are NOT auto-captured like task.* events.

This has broken multiple times when agents lost their AGENTS.md
instructions. Now documented in:
- AGENTS-TEMPLATE.md (copy-paste for new agents)
- SOP-agent-task-workflow.md (full API flow with telemetry steps)

Both docs now include the exact curl commands for run.started,
run.completed, and run.tokens events, plus a table clarifying
what's auto-captured vs. manual.
2026-02-05 18:26:34 -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
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