@slycode/slycode 0.1.18 → 0.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/web/.next/BUILD_ID +1 -1
- package/dist/web/.next/build-manifest.json +2 -2
- package/dist/web/.next/server/app/_global-error.html +2 -2
- package/dist/web/.next/server/app/_global-error.rsc +1 -1
- package/dist/web/.next/server/app/_global-error.segments/__PAGE__.segment.rsc +1 -1
- package/dist/web/.next/server/app/_global-error.segments/_full.segment.rsc +1 -1
- package/dist/web/.next/server/app/_global-error.segments/_head.segment.rsc +1 -1
- package/dist/web/.next/server/app/_global-error.segments/_index.segment.rsc +1 -1
- package/dist/web/.next/server/app/_global-error.segments/_tree.segment.rsc +1 -1
- package/dist/web/.next/server/app/_not-found.html +1 -1
- package/dist/web/.next/server/app/_not-found.rsc +1 -1
- package/dist/web/.next/server/app/_not-found.segments/_full.segment.rsc +1 -1
- package/dist/web/.next/server/app/_not-found.segments/_head.segment.rsc +1 -1
- package/dist/web/.next/server/app/_not-found.segments/_index.segment.rsc +1 -1
- package/dist/web/.next/server/app/_not-found.segments/_not-found/__PAGE__.segment.rsc +1 -1
- package/dist/web/.next/server/app/_not-found.segments/_not-found.segment.rsc +1 -1
- package/dist/web/.next/server/app/_not-found.segments/_tree.segment.rsc +1 -1
- package/dist/web/.next/server/app/page_client-reference-manifest.js +1 -1
- package/dist/web/.next/server/app/project/[id]/page_client-reference-manifest.js +1 -1
- package/dist/web/.next/server/chunks/[root-of-the-server]__46b023d4._.js +1 -1
- package/dist/web/.next/server/chunks/[root-of-the-server]__4c7995bf._.js +1 -1
- package/dist/web/.next/server/chunks/[root-of-the-server]__4d0d3464._.js +1 -1
- package/dist/web/.next/server/chunks/[root-of-the-server]__543058c2._.js +3 -3
- package/dist/web/.next/server/chunks/[root-of-the-server]__6d330d40._.js +1 -1
- package/dist/web/.next/server/chunks/[root-of-the-server]__884d73e4._.js +1 -1
- package/dist/web/.next/server/chunks/[root-of-the-server]__949bb248._.js +1 -1
- package/dist/web/.next/server/chunks/[root-of-the-server]__949d814c._.js +1 -1
- package/dist/web/.next/server/chunks/[root-of-the-server]__aa814a86._.js +1 -1
- package/dist/web/.next/server/chunks/[root-of-the-server]__ad64e04f._.js +2 -2
- package/dist/web/.next/server/chunks/[root-of-the-server]__baa99257._.js +1 -1
- package/dist/web/.next/server/chunks/[root-of-the-server]__bbb4b3ac._.js +1 -1
- package/dist/web/.next/server/chunks/[root-of-the-server]__bf286c26._.js +1 -1
- package/dist/web/.next/server/chunks/[root-of-the-server]__ce429522._.js +1 -1
- package/dist/web/.next/server/chunks/[root-of-the-server]__d38c7a96._.js +1 -1
- package/dist/web/.next/server/chunks/[root-of-the-server]__e9b0e744._.js +1 -1
- package/dist/web/.next/server/chunks/[root-of-the-server]__f1fe18e6._.js +2 -2
- package/dist/web/.next/server/chunks/ssr/[root-of-the-server]__677b7660._.js +1 -1
- package/dist/web/.next/server/chunks/ssr/[root-of-the-server]__79c0188d._.js +1 -1
- package/dist/web/.next/server/chunks/ssr/src_lib_registry_ts_2fc87c9c._.js +1 -1
- package/dist/web/.next/server/pages/404.html +1 -1
- package/dist/web/.next/server/pages/500.html +2 -2
- package/dist/web/.next/static/chunks/7660448872d80e27.js +4 -0
- package/dist/web/.next/static/chunks/{4793f1f83885d568.js → b694f741bb34ac84.js} +1 -1
- package/dist/web/src/components/ClaudeTerminalPanel.tsx +15 -11
- package/dist/web/src/lib/store-scanner.ts +70 -10
- package/dist/web/tsconfig.tsbuildinfo +1 -1
- package/package.json +1 -1
- package/templates/kanban-seed.json +1 -1
- package/dist/store/.backups/actions/onboard.md +0 -33
- package/dist/store/.backups/actions/review.md +0 -37
- package/dist/store/.backups/actions/show-card.md +0 -20
- package/dist/store/.backups/checkpoint/SKILL.md +0 -43
- package/dist/store/.backups/context-priming/SKILL.md +0 -153
- package/dist/store/.backups/context-priming/references/area-index.md +0 -101
- package/dist/store/.backups/context-priming/references/areas/claude-actions.md +0 -120
- package/dist/store/.backups/context-priming/references/areas/messaging.md +0 -177
- package/dist/store/.backups/context-priming/references/areas/scripts-deployment.md +0 -138
- package/dist/store/.backups/context-priming/references/areas/skills.md +0 -135
- package/dist/store/.backups/context-priming/references/areas/terminal-bridge.md +0 -232
- package/dist/store/.backups/context-priming/references/areas/web-frontend.md +0 -252
- package/dist/store/.backups/context-priming/references/maintenance.md +0 -128
- package/dist/store/.ignored-updates.json +0 -37
- package/dist/store/actions/analyse-implementation.md +0 -72
- package/dist/store/actions/archive.md +0 -36
- package/dist/store/actions/clear.md +0 -13
- package/dist/store/actions/complete.md +0 -34
- package/dist/store/actions/continue.md +0 -20
- package/dist/store/agents/doc-updater.md +0 -619
- package/dist/store/mcp/context7.json +0 -8
- package/dist/store/skills/claude-code-docs-maintainer/SKILL.md +0 -168
- package/dist/store/skills/create-command/SKILL.md +0 -92
- package/dist/store/skills/doc-discovery/SKILL.md +0 -18
- package/dist/store/skills/doc-update/SKILL.md +0 -15
- package/dist/store/skills/dummy/SKILL.md +0 -22
- package/dist/store/skills/interactive-explainer/SKILL.md +0 -557
- package/dist/store/skills/interactive-explainer/assets/base_template.html +0 -780
- package/dist/store/skills/interactive-explainer/references/design_patterns.md +0 -486
- package/dist/store/skills/interactive-explainer/references/visualization_libraries.md +0 -512
- package/dist/store/skills/problem_summary/SKILL.md +0 -11
- package/dist/store/skills/reference-fetch/SKILL.md +0 -206
- package/dist/store/skills/skill-creator/LICENSE.txt +0 -202
- package/dist/store/skills/skill-creator/SKILL.md +0 -246
- package/dist/store/skills/skill-creator/scripts/init_skill.py +0 -303
- package/dist/store/skills/skill-creator/scripts/package_skill.py +0 -110
- package/dist/store/skills/skill-creator/scripts/quick_validate.py +0 -65
- package/dist/web/.next/static/chunks/5b44413f6e5b9e66.js +0 -4
- /package/dist/web/.next/static/{heUrgyJAcziZUlrZpGOPA → BbBq5FNe-sYRKe8Pc24UW}/_buildManifest.js +0 -0
- /package/dist/web/.next/static/{heUrgyJAcziZUlrZpGOPA → BbBq5FNe-sYRKe8Pc24UW}/_clientMiddlewareManifest.json +0 -0
- /package/dist/web/.next/static/{heUrgyJAcziZUlrZpGOPA → BbBq5FNe-sYRKe8Pc24UW}/_ssgManifest.js +0 -0
|
@@ -1,252 +0,0 @@
|
|
|
1
|
-
# Web Frontend
|
|
2
|
-
|
|
3
|
-
Updated: 2026-02-14
|
|
4
|
-
|
|
5
|
-
## Overview
|
|
6
|
-
|
|
7
|
-
Next.js 16 command center for project management. Features project cards with health scoring, kanban boards with drag-drop, card modals, command configuration, system health monitoring, cross-project toolkit/asset management, global search, activity feed, project scaffolding, and graceful reconnection handling. Neon-minimalist theme (SlyCode Neon) with Tailwind CSS v4, featuring lane-colored gradients, SVG noise textures, and theme-aware terminal styling.
|
|
8
|
-
|
|
9
|
-
## Key Files
|
|
10
|
-
|
|
11
|
-
### Pages & Layout
|
|
12
|
-
- `web/src/app/page.tsx` - Home dashboard, lists projects from registry
|
|
13
|
-
- `web/src/app/project/[id]/page.tsx` - Project detail page with kanban
|
|
14
|
-
- `web/src/components/ProjectPageClient.tsx` - Client wrapper for project pages, global terminal activity polling
|
|
15
|
-
- `web/src/components/ProjectView.tsx` - Project view wrapper, manages archive toggle state
|
|
16
|
-
|
|
17
|
-
### Core Components
|
|
18
|
-
- `web/src/components/Dashboard.tsx` - Project card grid + Toolkit tab, global search, number-key shortcuts
|
|
19
|
-
- `web/src/components/ProjectKanban.tsx` - Kanban board container, drag-drop logic
|
|
20
|
-
- `web/src/components/KanbanColumn.tsx` - Stage columns (backlog, design, impl, testing, done)
|
|
21
|
-
- `web/src/components/KanbanCardItem.tsx` - Individual card, status indicators, active glow effect
|
|
22
|
-
- `web/src/components/CardModal.tsx` - Full card editor with dynamic tabs, edit session protection
|
|
23
|
-
- `web/src/components/ProjectHeader.tsx` - Header with Commands, Archive toggle, HealthMonitor
|
|
24
|
-
|
|
25
|
-
### Project Management
|
|
26
|
-
- `web/src/components/ProjectCard.tsx` - Enhanced project card with health dot, platform badges, edit/delete
|
|
27
|
-
- `web/src/components/AddProjectModal.tsx` - Multi-phase project creation wizard (details → analysis → scaffold → done)
|
|
28
|
-
- `web/src/components/HealthDot.tsx` - Health score indicator with tooltip (green/amber/red)
|
|
29
|
-
- `web/src/components/PlatformBadges.tsx` - Detected AI platform badges (Claude, Gemini, Codex)
|
|
30
|
-
- `web/src/components/SearchBar.tsx` - Global/contextual search across all kanban cards
|
|
31
|
-
|
|
32
|
-
### Terminal & Commands
|
|
33
|
-
- `web/src/components/ClaudeTerminalPanel.tsx` - Reusable terminal with provider selector, startupCommands/activeCommands, card area filtering
|
|
34
|
-
- `web/src/components/Terminal.tsx` - xterm.js terminal with ConnectionManager integration
|
|
35
|
-
- `web/src/components/CommandConfigModal.tsx` - Command configuration UI with Command Assistant terminal
|
|
36
|
-
- `web/src/components/GlobalClaudePanel.tsx` - Floating panel for project-wide session, supports session/CWD/class overrides
|
|
37
|
-
|
|
38
|
-
### Toolkit & Assets
|
|
39
|
-
- `web/src/components/ToolkitTab.tsx` - Asset management tab with matrix view and pending changes
|
|
40
|
-
- `web/src/components/AssetMatrix.tsx` - Cross-project asset deployment matrix with click-to-deploy/remove
|
|
41
|
-
- `web/src/components/AssetViewer.tsx` - Modal viewer for asset content with frontmatter display
|
|
42
|
-
|
|
43
|
-
### Activity & Content
|
|
44
|
-
- `web/src/components/ActivityFeed.tsx` - Collapsible event log with day grouping and stage indicators
|
|
45
|
-
- `web/src/components/MarkdownContent.tsx` - Markdown renderer using react-markdown with GFM support
|
|
46
|
-
|
|
47
|
-
### Health & Connection
|
|
48
|
-
- `web/src/components/HealthMonitor.tsx` - System stats widget (CPU, memory, terminals)
|
|
49
|
-
- `web/src/components/ConnectionStatusIndicator.tsx` - Reconnection toast indicator
|
|
50
|
-
- `web/src/lib/connection-manager.ts` - Centralized SSE reconnection with Page Visibility API
|
|
51
|
-
|
|
52
|
-
### Hooks
|
|
53
|
-
- `web/src/hooks/useConnectionStatus.ts` - Hook for connection state subscription
|
|
54
|
-
- `web/src/hooks/useKeyboardShortcuts.ts` - Keyboard navigation (1-9 project jump, Escape)
|
|
55
|
-
- `web/src/hooks/useCommandsConfig.ts` - Polling-based commands config loader (30s intervals)
|
|
56
|
-
- `web/src/hooks/usePolling.ts` - Generic polling hook
|
|
57
|
-
|
|
58
|
-
### Utilities
|
|
59
|
-
- `web/src/lib/types.ts` - All shared types (see Data Models)
|
|
60
|
-
- `web/src/lib/claude-actions.ts` - getStartupCommands(), getActiveCommands(), renderTemplate()
|
|
61
|
-
- `web/src/lib/registry.ts` - Project registry loader with kanban, health scoring, platform detection
|
|
62
|
-
- `web/src/lib/paths.ts` - Dynamic path resolution for SlyCode root and project directories
|
|
63
|
-
- `web/src/lib/kanban-paths.ts` - Project-aware kanban file path resolution with tiered backup
|
|
64
|
-
- `web/src/lib/asset-scanner.ts` - Asset scanning, frontmatter parsing, version comparison, platform detection
|
|
65
|
-
- `web/src/lib/event-log.ts` - Append-only activity log with filtering/querying (500 event cap)
|
|
66
|
-
- `web/src/lib/health-score.ts` - Health score calculator with configurable weights
|
|
67
|
-
- `web/src/lib/tab-sync.ts` - Cross-tab synchronization using BroadcastChannel API
|
|
68
|
-
|
|
69
|
-
### API Routes
|
|
70
|
-
- `web/src/app/api/kanban/route.ts` - Kanban CRUD
|
|
71
|
-
- `web/src/app/api/bridge/[...path]/route.ts` - Bridge proxy
|
|
72
|
-
- `web/src/app/api/commands/route.ts` - Commands CRUD
|
|
73
|
-
- `web/src/app/api/commands/stream/route.ts` - SSE for command file changes
|
|
74
|
-
- `web/src/app/api/system-stats/route.ts` - CPU/memory metrics
|
|
75
|
-
- `web/src/app/api/areas/route.ts` - Available areas list
|
|
76
|
-
- `web/src/app/api/terminal-classes/route.ts` - Terminal class definitions
|
|
77
|
-
- `web/src/app/api/claude-actions/route.ts` - Commands in ClaudeActionsConfig format
|
|
78
|
-
- `web/src/app/api/toolkit/route.ts` - Scan all project assets, build matrix
|
|
79
|
-
- `web/src/app/api/toolkit/sync/route.ts` - Batch deploy/remove assets
|
|
80
|
-
- `web/src/app/api/toolkit/import/route.ts` - Import asset from project to workspace
|
|
81
|
-
- `web/src/app/api/events/route.ts` - Query activity log with filters
|
|
82
|
-
- `web/src/app/api/search/route.ts` - Cross-project card search
|
|
83
|
-
- `web/src/app/api/projects/route.ts` - List/create projects
|
|
84
|
-
- `web/src/app/api/projects/[id]/route.ts` - GET/PUT/DELETE individual project
|
|
85
|
-
- `web/src/app/api/projects/analyze/route.ts` - Analyze directory before scaffolding
|
|
86
|
-
- `web/src/app/api/providers/route.ts` - GET/PUT for providers.json (provider list + stage defaults)
|
|
87
|
-
- `web/src/app/api/file/route.ts` - Read files from approved directories
|
|
88
|
-
- `web/src/app/api/git-status/route.ts` - Git status for projects
|
|
89
|
-
|
|
90
|
-
## Key Functions
|
|
91
|
-
|
|
92
|
-
- `ProjectKanban.handleDragEnd()` - Reorders cards, handles cross-column moves
|
|
93
|
-
- `ConnectionManager.createManagedEventSource()` - Auto-reconnecting SSE with backoff
|
|
94
|
-
- `getStartupCommands(commands, terminalClass, hasHistory)` - Filter commands for session start
|
|
95
|
-
- `getActiveCommands(commands, terminalClass)` - Filter commands for running session toolbar
|
|
96
|
-
- `scanProjectAssets()` - Scan commands/skills/agents across projects, build matrix
|
|
97
|
-
- `calculateHealthScore()` - Score 0-100 based on configurable weighted factors
|
|
98
|
-
|
|
99
|
-
## CardModal Tabs
|
|
100
|
-
|
|
101
|
-
- **Details** - Edit fields, dropdowns for stage/priority, editable areas/tags chips, delete button
|
|
102
|
-
- **Design** - Shows if `design_ref` exists, renders markdown with copy path button
|
|
103
|
-
- **Feature** - Shows if `feature_ref` exists, renders markdown
|
|
104
|
-
- **Test** - Shows if `test_ref` exists, renders markdown
|
|
105
|
-
- **Checklist** - Interactive checkboxes with progress bar (uses ref-based state for rapid clicks)
|
|
106
|
-
- **Terminal** - AI session with provider selector, auto-connect, startupCommands/activeCommands
|
|
107
|
-
|
|
108
|
-
CardModal uses edit session protection: last-known-value tracking, 2000ms grace period for field editing, prevents overwriting active edits from external updates.
|
|
109
|
-
|
|
110
|
-
## Health Scoring
|
|
111
|
-
|
|
112
|
-
- **Factors**: outdated assets, stale cards, unresolved problems, missing CLAUDE.md, non-compliant frontmatter
|
|
113
|
-
- **Levels**: green (≥80), amber (≥50), red (<50)
|
|
114
|
-
- **Display**: HealthDot component with tooltip showing score breakdown
|
|
115
|
-
- Located on ProjectCard in Dashboard
|
|
116
|
-
|
|
117
|
-
## Toolkit (Asset Management)
|
|
118
|
-
|
|
119
|
-
- Scans commands/skills/agents across all projects
|
|
120
|
-
- Frontmatter validation: name, version, updated, description required
|
|
121
|
-
- Version comparison for detecting outdated assets
|
|
122
|
-
- Matrix view: rows=assets, columns=projects, cells=status
|
|
123
|
-
- Batch operations: deploy to / remove from projects
|
|
124
|
-
- Import from project back to workspace
|
|
125
|
-
|
|
126
|
-
## Connection Management
|
|
127
|
-
|
|
128
|
-
- `ConnectionManager` - Singleton managing all SSE connections
|
|
129
|
-
- Page Visibility API detection for sleep/wake cycles
|
|
130
|
-
- Exponential backoff with jitter (1s initial, 30s max)
|
|
131
|
-
- `ConnectionStatusIndicator` - Toast showing "Reconnecting..." during recovery
|
|
132
|
-
|
|
133
|
-
## Data Models
|
|
134
|
-
|
|
135
|
-
- `KanbanCard` - id, title, description, type, priority, order, areas[], tags[], problems[], checklist[], archived?, design_ref?, feature_ref?, test_ref?, claude_session?
|
|
136
|
-
- `Command` - label, description, group, cardTypes[], prompt, visibleIn, scope, sessionState
|
|
137
|
-
- `BridgeStats` - bridgeTerminals, connectedClients, activelyWorking, sessions[]
|
|
138
|
-
- `SystemStats` - cpu (0-100), memory {used, total}, swap {used, total}
|
|
139
|
-
- `SessionActivity` - name, status, lastOutputAt, isActive
|
|
140
|
-
- `AssetInfo` - name, type, version, updated, description, filePath, frontmatter
|
|
141
|
-
- `AssetCell` - status (present|outdated|missing|extra), masterVersion?, projectVersion?
|
|
142
|
-
- `ToolkitData` - rows (AssetRow[]), projects (string[])
|
|
143
|
-
- `HealthScore` - score (0-100), level (green|amber|red), factors[]
|
|
144
|
-
- `ActivityEvent` - type, timestamp, project, detail, cardId?
|
|
145
|
-
- `SearchResult` - card, project, matchedFields[]
|
|
146
|
-
- `ProjectWithBacklog` - extends Project with assets, gitUncommitted, healthScore, platforms, lastActivity, activeSessions
|
|
147
|
-
- `ProvidersData` - providers (Record<id, ProviderConfig>), defaults (stages, global, projects)
|
|
148
|
-
- `ProviderConfig` - id, displayName, command, permissions, resume, prompt
|
|
149
|
-
|
|
150
|
-
## Design System — SlyCode Neon Theme
|
|
151
|
-
|
|
152
|
-
### Philosophy
|
|
153
|
-
Neon-minimalist aesthetic. Clean surfaces with subtle texture for life and depth. Never sterile/flat, never over-the-top. The theme should feel like a premium tool — atmospheric but professional. Light mode is clean with color; dark mode is moody with glow.
|
|
154
|
-
|
|
155
|
-
### Color Palette
|
|
156
|
-
- **Neon Blue** (`--neon-blue: #00bfff`) — Primary accent, design/implementation lanes, links, active states
|
|
157
|
-
- **Neon Orange** (`--neon-orange: #ff8c00`) — Global/project terminal headers, warnings
|
|
158
|
-
- **Red-Orange** (`#ff6a33`) — Testing lane (NOT standard orange, which looks brown in dark mode)
|
|
159
|
-
- **Green** — Done lane, success states, running indicators
|
|
160
|
-
- **Void** — Neutral grey scale for backgrounds, borders, muted text
|
|
161
|
-
- **Red** (`#ff3b5c`) — Critical/bug indicators, stop buttons
|
|
162
|
-
|
|
163
|
-
### Critical Color Lesson
|
|
164
|
-
Dark-end scale colors (e.g. `neon-orange-950 = #2b1700`) are inherently brown. For vibrant dark mode colors, use the BRIGHT color at LOW OPACITY (e.g. `neon-orange-400/15`) instead of dark scale values.
|
|
165
|
-
|
|
166
|
-
### Texture System (globals.css)
|
|
167
|
-
Three-layer texture approach for gradient surfaces:
|
|
168
|
-
|
|
169
|
-
1. **Fine grain** (`.grain`) — High-frequency SVG feTurbulence noise (`baseFrequency: 0.65`), overlay blend. Desaturate with `feColorMatrix type='saturate' values='0'` when color neutrality matters.
|
|
170
|
-
2. **Perlin noise** (`.depth-glow`) — Low-frequency organic texture (`baseFrequency: 0.015` light, `0.012` dark), large 400px tiles. Light mode uses `screen` blend (lightens), dark mode uses `soft-light`. Masked with left-to-right gradient fade.
|
|
171
|
-
3. **Terminal texture** (`.terminal-texture`) — CRT-like grain + vignette + lane-colored tint via `--terminal-tint` CSS variable. Box-shaped mask (edges visible, centre clear). Light: `soft-light` blend. Dark: `screen` blend (avoids warm/red cast from `soft-light` on dark backgrounds).
|
|
172
|
-
|
|
173
|
-
### Blend Mode Rules
|
|
174
|
-
- `soft-light` on dark backgrounds produces warm/red cast — avoid for dark mode textures
|
|
175
|
-
- `overlay` is neutral but can be invisible on very dark surfaces
|
|
176
|
-
- `screen` always adds light — use for dark mode when you need visible texture
|
|
177
|
-
- `mix-blend-multiply` makes white backgrounds transparent (light mode logos)
|
|
178
|
-
- `mix-blend-lighten` makes black backgrounds transparent (dark mode logos)
|
|
179
|
-
- `filter: drop-shadow()` traces the ALPHA boundary — creates rectangular glow on images with opaque backgrounds. Incompatible with blend-mode logo transparency.
|
|
180
|
-
|
|
181
|
-
### Logo Handling
|
|
182
|
-
Logos have opaque backgrounds (white for light, black for dark). Two `<img>` tags per location:
|
|
183
|
-
- Light: `mix-blend-multiply dark:hidden`
|
|
184
|
-
- Dark: `mix-blend-lighten hidden dark:block`
|
|
185
|
-
- All CSS drop-shadow/filter glow DISABLED (creates rectangular artifacts with blend modes). Logos have baked-in glow.
|
|
186
|
-
- Files: `slycode_light.png` / `slycode.png` (hero), `slycode_logo_light.png` / `slycode_logo.png` (nav)
|
|
187
|
-
|
|
188
|
-
### Lane-Colored Theming
|
|
189
|
-
Stage colors flow through multiple layers:
|
|
190
|
-
- **KanbanColumn headers** — `colorClasses` map with header gradient, text, count badge, border
|
|
191
|
-
- **CardModal header/tabs** — `stageModalStyles` map with gradients, borders per stage. Uses transparency (85% → 50%) for subtle glass quality
|
|
192
|
-
- **CardModal footer** — `stageTerminalColors` with colored top border
|
|
193
|
-
- **Terminal tint** — `stageTerminalTint` map provides rgba color → passed as `tintColor` prop → sets `--terminal-tint` CSS variable on terminal overlay
|
|
194
|
-
|
|
195
|
-
### Gradient Direction Convention
|
|
196
|
-
Left-to-right, vibrant-to-soft. The left/start side is always the stronger color, fading lighter toward the right. Never center-out fades (looks artificial).
|
|
197
|
-
|
|
198
|
-
### Button Aesthetic — Neon Glass
|
|
199
|
-
Terminal/action buttons use semi-transparent backgrounds with colored borders and hover glow:
|
|
200
|
-
```
|
|
201
|
-
border border-{color}-400/40 bg-{color}-400/15 text-{color}-400
|
|
202
|
-
hover:bg-{color}-400/25 hover:shadow-[0_0_12px_rgba(...,0.3)]
|
|
203
|
-
```
|
|
204
|
-
|
|
205
|
-
### Health Monitor
|
|
206
|
-
Uses inline gradient fills + glow shadows (not flat CSS classes):
|
|
207
|
-
- Normal: `linear-gradient(90deg, #00e676, #00bfff)` + blue glow
|
|
208
|
-
- Warning: `linear-gradient(90deg, #ff8c00, #ffaa00)` + orange glow
|
|
209
|
-
- Critical: `linear-gradient(90deg, #ff3b5c, #ff6b81)` + red glow
|
|
210
|
-
|
|
211
|
-
### Terminal Background
|
|
212
|
-
Theme-aware: `#222228` (light mode, slightly lighter) / `#1a1a1a` (dark mode). Detected at xterm mount via `document.documentElement.classList.contains('dark')`. Wrapper divs use `bg-[#222228] dark:bg-[#1a1a1a]`.
|
|
213
|
-
|
|
214
|
-
### Dark Mode Borders
|
|
215
|
-
Card modals get colored outer borders in dark mode (`dark:border dark:border-{color}/25-30`). Section dividers (header/tabs/terminal) use lane colors in both modes.
|
|
216
|
-
|
|
217
|
-
## Patterns & Invariants
|
|
218
|
-
|
|
219
|
-
- Cards auto-save on changes via `/api/kanban` PUT
|
|
220
|
-
- Kanban data stored in `documentation/kanban.json` per project
|
|
221
|
-
- Stage order: backlog → design → implementation → testing → done
|
|
222
|
-
- Active glow: `active-glow-card` CSS class with pulse animation (2s activity threshold)
|
|
223
|
-
- Commands use `startupCommands` (session start) and `activeCommands` (running toolbar)
|
|
224
|
-
- SSE connections managed centrally via ConnectionManager for reconnection
|
|
225
|
-
- Dynamic path resolution via paths.ts (no hardcoded paths)
|
|
226
|
-
- Cross-tab sync via BroadcastChannel API
|
|
227
|
-
- Number keys 1-9 jump to projects, Escape closes modals
|
|
228
|
-
- Event log capped at 500 entries, append-only
|
|
229
|
-
- Session names include provider segment: `{projectId}:{provider}:card:{cardId}`
|
|
230
|
-
- Provider selector shown on no-session screen, pre-filled from stage defaults
|
|
231
|
-
- CardModal detects existing session's provider from session name for pre-selection
|
|
232
|
-
- ProjectKanban/ProjectPageClient use regex patterns to match both new and legacy session names
|
|
233
|
-
|
|
234
|
-
## When to Expand
|
|
235
|
-
|
|
236
|
-
- Editing card behavior → CardModal.tsx
|
|
237
|
-
- Kanban drag/drop issues → ProjectKanban.tsx, KanbanColumn.tsx
|
|
238
|
-
- Adding new card fields → types.ts, CardModal.tsx
|
|
239
|
-
- Command configuration → CommandConfigModal.tsx, data/commands.json
|
|
240
|
-
- Health monitoring → HealthMonitor.tsx, /api/system-stats
|
|
241
|
-
- Connection issues → connection-manager.ts, ConnectionStatusIndicator.tsx
|
|
242
|
-
- Terminal panel behavior → ClaudeTerminalPanel.tsx
|
|
243
|
-
- Provider selection → ClaudeTerminalPanel.tsx, /api/providers, data/providers.json
|
|
244
|
-
- Provider detection for existing sessions → CardModal.tsx (session name parsing)
|
|
245
|
-
- Asset management → asset-scanner.ts, ToolkitTab.tsx, AssetMatrix.tsx
|
|
246
|
-
- Health scoring → health-score.ts, HealthDot.tsx
|
|
247
|
-
- Activity feed → event-log.ts, ActivityFeed.tsx
|
|
248
|
-
- Project scaffolding → AddProjectModal.tsx, /api/projects
|
|
249
|
-
- Search → SearchBar.tsx, /api/search
|
|
250
|
-
- Path resolution → paths.ts, kanban-paths.ts
|
|
251
|
-
- Keyboard shortcuts → useKeyboardShortcuts.ts
|
|
252
|
-
- Theme/design system → globals.css (texture classes), CardModal.tsx (stageModalStyles), KanbanColumn.tsx (colorClasses), GlobalClaudePanel.tsx (terminal header), Terminal.tsx (tintColor, terminal-texture)
|
|
@@ -1,128 +0,0 @@
|
|
|
1
|
-
# Maintenance Doctrine
|
|
2
|
-
|
|
3
|
-
Rules for maintaining context-priming references. Changes to this file require user approval.
|
|
4
|
-
|
|
5
|
-
## Area File Structure
|
|
6
|
-
|
|
7
|
-
Area files should be as lean as the area requires. Include sections that add value; omit those that don't.
|
|
8
|
-
|
|
9
|
-
**Always include:**
|
|
10
|
-
```markdown
|
|
11
|
-
# [Area Name]
|
|
12
|
-
|
|
13
|
-
Updated: YYYY-MM-DD
|
|
14
|
-
|
|
15
|
-
## Overview
|
|
16
|
-
What this area does, boundaries. 2-3 sentences.
|
|
17
|
-
|
|
18
|
-
## Key Files
|
|
19
|
-
- `file.py` - purpose
|
|
20
|
-
[Most important files/modules]
|
|
21
|
-
|
|
22
|
-
## When to Expand
|
|
23
|
-
- [task] → [files to open]
|
|
24
|
-
```
|
|
25
|
-
|
|
26
|
-
**Include when relevant:**
|
|
27
|
-
|
|
28
|
-
| Section | When to include |
|
|
29
|
-
|---------|-----------------|
|
|
30
|
-
| Key Functions | Area has important entry points, APIs, or non-obvious control flow |
|
|
31
|
-
| Data Models | Area defines data structures used internally or externally |
|
|
32
|
-
| Shared Objects | Area defines or consumes objects used across multiple areas |
|
|
33
|
-
| Patterns & Invariants | Area has critical rules that must hold |
|
|
34
|
-
| Interfaces | Area connects to other areas with data flow |
|
|
35
|
-
|
|
36
|
-
**Section formats (when used):**
|
|
37
|
-
|
|
38
|
-
```markdown
|
|
39
|
-
## Key Functions
|
|
40
|
-
- `process_message()` in handlers.py - entry point for incoming messages
|
|
41
|
-
|
|
42
|
-
## Data Models
|
|
43
|
-
- `Message` (models.py) - id, content, sender_id, timestamp | core envelope
|
|
44
|
-
|
|
45
|
-
## Shared Objects
|
|
46
|
-
- `Message` - DEFINED HERE, used by: frontend, api, workers
|
|
47
|
-
- `Config` - defined in core, IMPORTED HERE
|
|
48
|
-
|
|
49
|
-
## Patterns & Invariants
|
|
50
|
-
- Auth middleware runs before handlers
|
|
51
|
-
|
|
52
|
-
## Interfaces
|
|
53
|
-
- → frontend: sends Message via WebSocket
|
|
54
|
-
- ← api: receives Request, returns Response
|
|
55
|
-
```
|
|
56
|
-
|
|
57
|
-
Keep area files under 200 lines. Simple areas may be 20-30 lines; complex areas will be longer.
|
|
58
|
-
|
|
59
|
-
**Shared Objects note**: When present, prevents duplicate definitions. Mark canonical location.
|
|
60
|
-
|
|
61
|
-
## Defragmentation
|
|
62
|
-
|
|
63
|
-
**When to defrag an area:**
|
|
64
|
-
- Information is scattered/duplicated within the file
|
|
65
|
-
- Sections contain outdated content mixed with current
|
|
66
|
-
- File has grown beyond 200 lines
|
|
67
|
-
- Reading the file doesn't quickly answer "what do I need to know?"
|
|
68
|
-
|
|
69
|
-
**Defrag process:**
|
|
70
|
-
1. Read the entire area file
|
|
71
|
-
2. Identify: duplicates, outdated info, poor organization
|
|
72
|
-
3. Consolidate related information
|
|
73
|
-
4. Remove obsolete content (don't comment it out - delete)
|
|
74
|
-
5. Verify remaining content is accurate against current code
|
|
75
|
-
6. Update the `Updated` date
|
|
76
|
-
|
|
77
|
-
**Consult user before defragging if:**
|
|
78
|
-
- Multiple areas need simultaneous restructuring
|
|
79
|
-
- Unsure whether information is obsolete or still relevant
|
|
80
|
-
- Defrag would take significant time
|
|
81
|
-
|
|
82
|
-
## Area Separation
|
|
83
|
-
|
|
84
|
-
**Heuristics for deciding areas:**
|
|
85
|
-
- Group by logical module/subsystem, not by file type
|
|
86
|
-
- An area should be loadable and useful independently
|
|
87
|
-
- If two areas are always loaded together, consider merging
|
|
88
|
-
- If an area covers unrelated concerns, consider splitting
|
|
89
|
-
|
|
90
|
-
**When to split an area:**
|
|
91
|
-
- File exceeds 200 lines despite being concise
|
|
92
|
-
- Contains distinct subsystems that don't interact
|
|
93
|
-
- Load-when triggers have diverged (some tasks need part A, others need part B)
|
|
94
|
-
|
|
95
|
-
**When to merge areas:**
|
|
96
|
-
- Two areas are nearly always loaded together
|
|
97
|
-
- Combined size would still be under 150 lines
|
|
98
|
-
- Separation creates artificial boundaries
|
|
99
|
-
|
|
100
|
-
**Cross-references:**
|
|
101
|
-
- Areas can note "see also: [other-area]" for related context
|
|
102
|
-
- Don't auto-load chains - let the index's load-when guide loading
|
|
103
|
-
- If area A heavily depends on area B, note this in A's Interfaces section
|
|
104
|
-
|
|
105
|
-
## Note Pruning
|
|
106
|
-
|
|
107
|
-
Notes in area-index.md capture learnings. Prune when:
|
|
108
|
-
- Note contradicts newer information (keep newer)
|
|
109
|
-
- Code changed and note no longer applies
|
|
110
|
-
- Note is vague or not actionable
|
|
111
|
-
- Area exceeds 10 notes
|
|
112
|
-
|
|
113
|
-
**Pruning is lightweight** - remove stale notes during routine updates, don't treat as separate task.
|
|
114
|
-
|
|
115
|
-
## New Project Initialization
|
|
116
|
-
|
|
117
|
-
When skill is introduced to a new codebase:
|
|
118
|
-
|
|
119
|
-
1. Clear `areas/` directory
|
|
120
|
-
2. Reset area-index.md to template state
|
|
121
|
-
3. Keep SKILL.md and maintenance.md intact
|
|
122
|
-
4. Scan project structure:
|
|
123
|
-
- Look for obvious module boundaries (directories, packages)
|
|
124
|
-
- Check build configs (package.json, pyproject.toml, etc.)
|
|
125
|
-
- Read CLAUDE.md for existing documentation pointers
|
|
126
|
-
5. Propose 3-6 initial areas to user
|
|
127
|
-
6. After approval, create area files with initial discovery
|
|
128
|
-
7. Mark all as freshly created - validate through actual use
|
|
@@ -1,37 +0,0 @@
|
|
|
1
|
-
{
|
|
2
|
-
"skills/kanban": "1.3.0",
|
|
3
|
-
"skills/code-review": "1.0.0",
|
|
4
|
-
"actions/onboard": "d2a2dd1bcb97",
|
|
5
|
-
"actions/show-card": "185ccdc4beb0",
|
|
6
|
-
"actions/approve": "0d1097e72a69",
|
|
7
|
-
"actions/archive": "44999be606ab",
|
|
8
|
-
"actions/checkpoint": "1b87d19a1c22",
|
|
9
|
-
"actions/clear": "b3f1a7a21337",
|
|
10
|
-
"actions/configure-commands": "778d11c6df39",
|
|
11
|
-
"actions/context": "830cf4fc47d4",
|
|
12
|
-
"actions/continue": "a808fa97513e",
|
|
13
|
-
"actions/convert-asset": "47d33ad765a1",
|
|
14
|
-
"actions/create-card": "3aa7f18c0807",
|
|
15
|
-
"actions/explore": "d67b7785deb0",
|
|
16
|
-
"actions/organise-backlog": "28e9fb9bd19c",
|
|
17
|
-
"actions/summarize": "6ce55b060254",
|
|
18
|
-
"actions/test-review": "baa161179c9d",
|
|
19
|
-
"actions/update-priming": "685464a284c2",
|
|
20
|
-
"actions/analyse-implementation": "f380bedf7c60",
|
|
21
|
-
"actions/chore": "da6c88ff5a07",
|
|
22
|
-
"actions/complete": "4da58630f469",
|
|
23
|
-
"actions/debug": "721c9ce48ed3",
|
|
24
|
-
"actions/deep-design": "02146223d052",
|
|
25
|
-
"actions/design-requirements": "c214c49eb284",
|
|
26
|
-
"actions/implement": "0793a438b277",
|
|
27
|
-
"actions/make-feature": "b4c2763bc890",
|
|
28
|
-
"actions/quick-fix": "a93f3ce3123d",
|
|
29
|
-
"actions/review": "29c6fbf1448f",
|
|
30
|
-
"skills/checkpoint": "0d72f0dc3b87",
|
|
31
|
-
"skills/context-priming": "4979c7d2ff4f",
|
|
32
|
-
"skills/design": "c2cba0b138f4",
|
|
33
|
-
"skills/feature": "aeff2aad7309",
|
|
34
|
-
"skills/implement": "f6dca53805ab",
|
|
35
|
-
"skills/messaging": "1fbb11161959",
|
|
36
|
-
"skills/chore": "dc1fb83dbeca"
|
|
37
|
-
}
|
|
@@ -1,72 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: analyse-implementation
|
|
3
|
-
version: 1.0.0
|
|
4
|
-
label: "Analyse"
|
|
5
|
-
description: "Analyse the implementation for consistency, bugs, bloat, and card alignment"
|
|
6
|
-
group: "Card Actions"
|
|
7
|
-
placement: both
|
|
8
|
-
scope: global
|
|
9
|
-
classes:
|
|
10
|
-
implementation: 20
|
|
11
|
-
testing: 80
|
|
12
|
-
---
|
|
13
|
-
|
|
14
|
-
{{cardContext}}
|
|
15
|
-
|
|
16
|
-
---
|
|
17
|
-
|
|
18
|
-
## Your Task
|
|
19
|
-
|
|
20
|
-
Perform a **thorough analysis** of the implementation for this card.
|
|
21
|
-
|
|
22
|
-
> Card details are provided above. If you need checklist status, notes from prior sessions, or problem IDs, run `sly-kanban show {{card.id}}` before proceeding.
|
|
23
|
-
|
|
24
|
-
**Step 1 - Gather context:**
|
|
25
|
-
Read the card description, acceptance criteria, design_ref and feature_ref (if they exist) to understand what was expected.
|
|
26
|
-
|
|
27
|
-
**Step 2 - Prime context:**
|
|
28
|
-
Use `/context-priming` with the card's **Areas** to load the relevant codebase patterns, conventions, and architecture.
|
|
29
|
-
|
|
30
|
-
**Step 3 - Identify changed files:**
|
|
31
|
-
Use git history, the feature spec, and the card areas to identify all files that were added or modified as part of this implementation. Read every one of them thoroughly.
|
|
32
|
-
|
|
33
|
-
**Step 4 - Analyse against these criteria:**
|
|
34
|
-
|
|
35
|
-
| Category | What to look for |
|
|
36
|
-
|---|---|
|
|
37
|
-
| **Pattern Consistency** | Does the new code follow the same patterns, naming conventions, file organization, and idioms as the existing codebase? Flag deviations. |
|
|
38
|
-
| **Bugs & Logic Errors** | Off-by-one errors, null/undefined handling, missing error handling, incorrect conditionals, type mismatches, silent failures. |
|
|
39
|
-
| **Race Conditions & Timing** | Async operations without proper awaiting, shared mutable state, event ordering assumptions, missing locks or guards, stale closures. |
|
|
40
|
-
| **Card Alignment** | Does the implementation actually deliver what the card description and acceptance criteria specify? Is anything missing, incomplete, or going beyond scope? |
|
|
41
|
-
| **Bloat & Complexity** | Over-engineering, unnecessary abstractions, dead code, premature generalisation, things that could be simpler. Flag anything that adds complexity without clear justification. |
|
|
42
|
-
| **Edge Cases** | Untested boundaries - empty inputs, large inputs, concurrent access, network failures, permission errors, malformed data. |
|
|
43
|
-
| **Security** | Injection risks, missing input validation at boundaries, exposed secrets, unsafe defaults. |
|
|
44
|
-
|
|
45
|
-
**Step 5 - Produce the findings report:**
|
|
46
|
-
|
|
47
|
-
Present a structured table of findings:
|
|
48
|
-
|
|
49
|
-
| # | Severity | Category | File:Line | Finding | Recommendation |
|
|
50
|
-
|---|----------|----------|-----------|---------|----------------|
|
|
51
|
-
| 1 | critical/major/minor | Category from above | path:line | Detailed description of the issue | What should be done to fix it |
|
|
52
|
-
|
|
53
|
-
Severity guide:
|
|
54
|
-
- **critical** - Will cause bugs, data loss, or security issues in production
|
|
55
|
-
- **major** - Significant quality issue, deviation from patterns, or missing card requirement
|
|
56
|
-
- **minor** - Style inconsistency, minor improvement opportunity, or nitpick
|
|
57
|
-
|
|
58
|
-
After the table, provide a brief **overall assessment** - is this implementation solid, or does it need work before approval?
|
|
59
|
-
|
|
60
|
-
**Step 6 - Log issues on the card:**
|
|
61
|
-
|
|
62
|
-
For every **critical** and **major** finding, log it as a problem on the card:
|
|
63
|
-
```bash
|
|
64
|
-
sly-kanban problem {{card.id}} add "[Category] Finding description — Recommendation" --severity <major|critical>
|
|
65
|
-
```
|
|
66
|
-
|
|
67
|
-
For **minor** findings, log them as minor:
|
|
68
|
-
```bash
|
|
69
|
-
sly-kanban problem {{card.id}} add "[Category] Finding description" --severity minor
|
|
70
|
-
```
|
|
71
|
-
|
|
72
|
-
Summarize how many issues were logged at each severity level.
|
|
@@ -1,36 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: archive
|
|
3
|
-
version: 1.0.0
|
|
4
|
-
label: "Archive"
|
|
5
|
-
description: "Archive a completed card"
|
|
6
|
-
group: "Card Actions"
|
|
7
|
-
placement: toolbar
|
|
8
|
-
scope: global
|
|
9
|
-
classes:
|
|
10
|
-
done: 10
|
|
11
|
-
---
|
|
12
|
-
|
|
13
|
-
{{cardContext}}
|
|
14
|
-
|
|
15
|
-
---
|
|
16
|
-
|
|
17
|
-
## Your Task
|
|
18
|
-
|
|
19
|
-
Archive this completed card.
|
|
20
|
-
|
|
21
|
-
**First, verify it's truly complete:**
|
|
22
|
-
```bash
|
|
23
|
-
sly-kanban show {{card.id}}
|
|
24
|
-
```
|
|
25
|
-
|
|
26
|
-
**Check:**
|
|
27
|
-
- All work is complete
|
|
28
|
-
- No unresolved problems
|
|
29
|
-
- Ready to be archived for record-keeping
|
|
30
|
-
|
|
31
|
-
**If ready to archive:**
|
|
32
|
-
```bash
|
|
33
|
-
sly-kanban archive {{card.id}}
|
|
34
|
-
```
|
|
35
|
-
|
|
36
|
-
This removes the card from active view but preserves it in history.
|
|
@@ -1,34 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: complete
|
|
3
|
-
version: 1.0.0
|
|
4
|
-
label: "Complete"
|
|
5
|
-
description: "Wrap up implementation and move to testing"
|
|
6
|
-
group: "Card Actions"
|
|
7
|
-
placement: toolbar
|
|
8
|
-
scope: global
|
|
9
|
-
classes:
|
|
10
|
-
implementation: 40
|
|
11
|
-
---
|
|
12
|
-
|
|
13
|
-
{{cardContext}}
|
|
14
|
-
|
|
15
|
-
---
|
|
16
|
-
|
|
17
|
-
## Your Task
|
|
18
|
-
|
|
19
|
-
Complete the implementation phase for this card.
|
|
20
|
-
|
|
21
|
-
> Card details are provided above. If you need checklist status, notes from prior sessions, or problem IDs, run `sly-kanban show {{card.id}}` before proceeding.
|
|
22
|
-
|
|
23
|
-
**Checklist before moving to testing:**
|
|
24
|
-
1. All planned work is done
|
|
25
|
-
2. Code is committed (use /checkpoint if needed)
|
|
26
|
-
3. No critical issues remain (check problems list)
|
|
27
|
-
4. Basic functionality verified
|
|
28
|
-
|
|
29
|
-
**If ready:**
|
|
30
|
-
```bash
|
|
31
|
-
sly-kanban move {{card.id}} testing
|
|
32
|
-
```
|
|
33
|
-
|
|
34
|
-
**If not ready**, explain what's still needed.
|
|
@@ -1,20 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: continue
|
|
3
|
-
version: 1.0.0
|
|
4
|
-
label: "Continue"
|
|
5
|
-
description: "Continue working from where we left off"
|
|
6
|
-
group: "Session"
|
|
7
|
-
placement: startup
|
|
8
|
-
scope: global
|
|
9
|
-
classes:
|
|
10
|
-
project-terminal: 10
|
|
11
|
-
testing: 40
|
|
12
|
-
---
|
|
13
|
-
|
|
14
|
-
{{cardContext}}
|
|
15
|
-
|
|
16
|
-
---
|
|
17
|
-
|
|
18
|
-
## Your Task
|
|
19
|
-
|
|
20
|
-
Continue from where we left off. Briefly recap what was happening and what's next.
|