mirror of
https://github.com/BradGroux/veritas-kanban.git
synced 2026-08-28 02:44:59 +00:00
docs: update documentation for agent CRUD, theme toggle, and bug fixes
This commit is contained in:
Brad Groux
parent
adc14a49e7
commit
76b93ebe85
3 changed files with 65 additions and 15 deletions
47
CHANGELOG.md
47
CHANGELOG.md
|
|
@ -5,6 +5,52 @@ All notable changes to Veritas Kanban are documented in this file.
|
|||
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
|
||||
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
|
||||
|
||||
## [1.1.0] - 2026-01-30
|
||||
|
||||
### Added
|
||||
|
||||
#### Agent CRUD Management
|
||||
|
||||
- Full Add/Edit/Remove for agents in Settings → Agents
|
||||
- Add Agent form with name, type slug (auto-generated), command, and args
|
||||
- Edit Agent: inline edit name, command, and args via pencil icon
|
||||
- Remove Agent: trash icon with confirmation dialog (blocked for the default agent)
|
||||
- `AgentType` loosened from a fixed enum (`claude-code | amp | copilot | gemini | veritas`) to any string slug — users can define completely custom agents
|
||||
|
||||
#### Dark/Light Mode Toggle
|
||||
|
||||
- Settings → General → Appearance section with toggle switch (moon/sun icon)
|
||||
- Persists to localStorage; default is dark mode
|
||||
- Inline script in `index.html` prevents flash of wrong theme on page load
|
||||
|
||||
#### UI Theme
|
||||
|
||||
- Primary color changed to purple (`270° 50% 40%`) with white text in dark mode
|
||||
- Focus rings updated to purple
|
||||
- Switch toggle thumbs: white in dark mode, black in light mode
|
||||
|
||||
### Fixed
|
||||
|
||||
#### Cross-Column Drag-and-Drop
|
||||
|
||||
- Tasks can now be dragged between Kanban columns reliably
|
||||
- Added local state management during drag for real-time column updates
|
||||
- Custom collision detection using `pointerWithin` with `rectIntersection` fallback
|
||||
- Tooltips suppressed during drag operations to prevent interference
|
||||
|
||||
#### Dashboard
|
||||
|
||||
- Agent Comparison chart: fixed broken data fetch — replaced raw `fetch()` with `apiFetch()` to properly unwrap the API response envelope
|
||||
- Rolling average line: changed from purple to vibrant cyan-teal to contrast new purple theme
|
||||
- Bar chart hover cursor: changed from white flash to subtle muted fill
|
||||
- Drill-down panels: removed duplicate X close button
|
||||
- Drill-down focus rings: changed to `ring-inset` to prevent clipping at panel edges
|
||||
- Dashboard section `overflow-hidden`: now only applies when the section is collapsed
|
||||
- StatusTimeline: redesigned to Daily Activity (75%) + Recent Status Changes (25%) side-by-side layout
|
||||
- `open-task` event: wired up so clicking tasks in drill-down panels opens the task detail panel (with API fallback for deleted tasks)
|
||||
|
||||
---
|
||||
|
||||
## [1.0.0] - 2026-01-29
|
||||
|
||||
### 🎉 Initial Public Release
|
||||
|
|
@ -104,4 +150,5 @@ Veritas Kanban is an AI-native project management board built for developers and
|
|||
|
||||
_Built by [Digital Meld](https://digitalmeld.io) — AI-driven enterprise automation._
|
||||
|
||||
[1.1.0]: https://github.com/dm-bradgroux/veritas-kanban/releases/tag/v1.1.0
|
||||
[1.0.0]: https://github.com/dm-bradgroux/veritas-kanban/releases/tag/v1.0.0
|
||||
|
|
|
|||
|
|
@ -10,7 +10,7 @@ Built for developers who want a visual Kanban board that works with autonomous c
|
|||
|
||||
[](https://github.com/BradGroux/veritas-kanban/actions/workflows/ci.yml)
|
||||
[](LICENSE)
|
||||
[](CHANGELOG.md)
|
||||
[](CHANGELOG.md)
|
||||
[](https://www.typescriptlang.org/)
|
||||
[](CONTRIBUTING.md)
|
||||
|
||||
|
|
@ -81,7 +81,7 @@ Open [http://localhost:3000](http://localhost:3000) — that's it.
|
|||
|
||||
- **Drag-and-drop Kanban** — Move tasks across To Do, In Progress, Review, Done
|
||||
- **Markdown storage** — Human-readable task files with YAML frontmatter
|
||||
- **Dark mode** — Easy on the eyes, always
|
||||
- **Dark/light mode** — Toggle between dark and light themes in Settings
|
||||
|
||||
### 🔀 Code Workflow
|
||||
|
||||
|
|
@ -94,6 +94,7 @@ Open [http://localhost:3000](http://localhost:3000) — that's it.
|
|||
### 🤖 AI Agents
|
||||
|
||||
- **Agent orchestration** — Spawn autonomous coding agents on tasks
|
||||
- **Custom agents** — Add your own agents with any name and command; not limited to built-in types
|
||||
- **Platform-agnostic API** — REST endpoints work with any agentic platform
|
||||
- **Built-in Moltbot support** — Native integration with [Moltbot](https://github.com/moltbot/moltbot) (formerly Clawdbot)
|
||||
- **Multiple attempts** — Retry with different agents, preserve history
|
||||
|
|
@ -109,7 +110,7 @@ Open [http://localhost:3000](http://localhost:3000) — that's it.
|
|||
|
||||
### ⚙️ Settings & Customization
|
||||
|
||||
- **Modular settings** — 7 focused tabs (General, Board, Tasks, Agents, Data, Notifications, Manage)
|
||||
- **Modular settings** — 8 focused tabs (General, Board, Tasks, Agents, Data, Notifications, Security, Manage)
|
||||
- **Security hardened** — XSS prevention, path traversal blocking, prototype pollution protection
|
||||
- **WCAG 2.1 AA** — Full accessibility with ARIA labels, keyboard navigation
|
||||
- **Error boundaries** — Crash isolation per tab with recovery options
|
||||
|
|
|
|||
|
|
@ -30,14 +30,14 @@ Complete feature reference for Veritas Kanban. For a quick overview, see the [RE
|
|||
The Kanban board is the central interface — a drag-and-drop workspace that reflects your project's state in real time.
|
||||
|
||||
- **Kanban columns** — Four default columns: To Do, In Progress, Blocked, Done
|
||||
- **Drag-and-drop** — Move tasks between columns with [@dnd-kit](https://dndkit.com/); reorder within columns
|
||||
- **Drag-and-drop** — Move tasks between columns with [@dnd-kit](https://dndkit.com/); reorder within columns; custom collision detection (pointerWithin + rectIntersection fallback) for reliable cross-column moves; tooltips suppressed during drag; local state management for real-time column updates
|
||||
- **Task CRUD** — Create, read, update, and delete tasks through the UI or API
|
||||
- **Create task dialog** — Quick-create with title, type, priority, project, sprint, and description
|
||||
- **Task detail panel** — Slide-out sheet with tabbed sections: Details, Git, Agent, Diff, Review, Preview, Attachments, Metrics
|
||||
- **Task types** — Configurable type system with icons and color-coded card borders (code, research, content, automation, and custom types)
|
||||
- **Priority levels** — Low, medium, and high with visual indicators on cards
|
||||
- **Markdown storage** — Tasks stored as human-readable `.md` files with YAML frontmatter (via [gray-matter](https://github.com/jonschlinkert/gray-matter))
|
||||
- **Dark mode** — Ships dark by default; easy on the eyes
|
||||
- **Dark/light mode** — Ships dark by default with a toggle in Settings → General → Appearance; persists to localStorage; inline script in `index.html` prevents flash of wrong theme on load
|
||||
- **Filter bar** — Search tasks by text, filter by project and task type; filters persist in URL query params
|
||||
- **Bulk operations** — Select multiple tasks to move, archive, or delete in batch; select-all toggle
|
||||
- **Keyboard shortcuts** — Navigate tasks (j/k, arrows), open (Enter), close (Esc), create (c), move to column (1-4), help (?)
|
||||
|
|
@ -108,7 +108,8 @@ Integrated git workflow from branch creation to merge.
|
|||
First-class support for autonomous coding agents.
|
||||
|
||||
- **Agent orchestration** — Start, stop, and monitor AI agents on code tasks from the UI or API
|
||||
- **Multi-agent support** — Choose from Claude Code, Amp, Copilot, Gemini, or Veritas agents
|
||||
- **Multi-agent support** — Ships with Claude Code, Amp, Copilot, Gemini, and Veritas agents; add completely custom agents via Settings → Agents
|
||||
- **Agent CRUD management** — Full Add/Edit/Remove for agents in Settings → Agents; add agent form with name, type slug (auto-generated), command, and args; inline edit via pencil icon; remove via trash icon with confirmation (blocked for the default agent); `AgentType` accepts any string slug, not just built-in names
|
||||
- **Agent request files** — Server writes structured requests to `.veritas-kanban/agent-requests/` for agent pickup
|
||||
- **Completion callbacks** — Agents call the completion endpoint with success/failure status and summary
|
||||
- **Multiple attempts** — Retry tasks with different agents; full attempt history preserved with status (pending, running, complete, failed)
|
||||
|
|
@ -296,14 +297,15 @@ Real-time project metrics and telemetry.
|
|||
- **Blocked task breakdown** — Blocked task counts by category (feedback, technical snag, prerequisite, other)
|
||||
- **Sprint velocity** — Track task completion rate over time
|
||||
- **Cost budget tracking** — Token usage and cost metrics with budget cards
|
||||
- **Agent comparison** — Side-by-side performance metrics across different AI agents
|
||||
- **Drill-down panels** — Click any metric card to drill into tasks, errors, tokens, or duration details
|
||||
- **Tasks drill-down** — List of tasks matching the selected metric
|
||||
- **Agent comparison** — Side-by-side performance metrics across different AI agents (uses `apiFetch()` to properly unwrap the API envelope)
|
||||
- **Drill-down panels** — Click any metric card to drill into tasks, errors, tokens, or duration details; focus rings use `ring-inset` to prevent clipping
|
||||
- **Tasks drill-down** — List of tasks matching the selected metric; clicking a task opens its detail panel (with API fallback for deleted tasks via `open-task` event)
|
||||
- **Errors drill-down** — Failed agent runs with error details
|
||||
- **Tokens drill-down** — Token usage breakdown by agent and task
|
||||
- **Duration drill-down** — Time distribution analysis
|
||||
- **Trends charts** — Time-series charts for key metrics
|
||||
- **Status timeline** — Visual timeline of task status changes
|
||||
- **Trends charts** — Time-series charts for key metrics; rolling average line in vibrant cyan-teal for contrast with the purple theme; bar chart hover uses subtle muted fill instead of white flash
|
||||
- **Status timeline** — Daily Activity (75%) + Recent Status Changes (25%) side-by-side layout
|
||||
- **Section collapsing** — Dashboard sections apply `overflow-hidden` only when collapsed
|
||||
- **Daily digest** — Summary of the day's activity: tasks completed/created, agent runs, token usage, failures and issues
|
||||
- **Task-level metrics** — Per-task panel showing attempt history, token counts, duration, cost, and status timeline
|
||||
- **Export dialog** — Export dashboard data for external analysis
|
||||
|
|
@ -316,10 +318,10 @@ Modular settings system with 8 focused tabs.
|
|||
|
||||
| Tab | What It Controls |
|
||||
| ----------------- | -------------------------------------------------------------------------------------------------------------- |
|
||||
| **General** | Application-wide preferences |
|
||||
| **General** | Application-wide preferences, appearance (dark/light mode toggle with moon/sun icon) |
|
||||
| **Board** | Column visibility and board layout |
|
||||
| **Tasks** | Default values, auto-complete behavior |
|
||||
| **Agents** | Agent configuration, default agent selection |
|
||||
| **Agents** | Agent CRUD (add/edit/remove), default agent selection, custom agent types with any string slug |
|
||||
| **Data** | Storage, telemetry retention settings |
|
||||
| **Notifications** | Per-event notification toggles (task complete, agent failed, review ready, etc.) |
|
||||
| **Security** | Password change with strength indicator, API key display |
|
||||
|
|
@ -499,7 +501,7 @@ Working toward WCAG 2.1 AA compliance.
|
|||
- **Keyboard shortcuts dialog** — Discoverable via `?` key with grouped shortcut reference
|
||||
- **Focus management** — Focus trapped in dialogs and sheets; restored on close
|
||||
- **Screen reader support** — Semantic HTML, ARIA roles, and descriptive labels throughout
|
||||
- **Color contrast** — Dark mode palette designed for readability
|
||||
- **Color contrast** — Dark and light mode palettes designed for readability; purple primary (`270° 50% 40%`) buttons with white text in dark mode
|
||||
- **Skip navigation** — Keyboard users can navigate efficiently between sections
|
||||
- **Sortable list accessibility** — Drag-and-drop lists in settings include keyboard-accessible reordering
|
||||
- **Interactive cards** — Task cards, metric cards, and stat cards support keyboard activation (Enter/Space)
|
||||
|
|
@ -507,4 +509,4 @@ Working toward WCAG 2.1 AA compliance.
|
|||
|
||||
---
|
||||
|
||||
_Last updated: 2026-01-29 · [Back to README](../README.md)_
|
||||
_Last updated: 2026-01-30 · [Back to README](../README.md)_
|
||||
|
|
|
|||
Loading…
Add table
Reference in a new issue