@slycode/slycode 0.1.14 → 0.1.15

package/templates/updates/skills/context-priming/references/area-index.md

@@ -1,101 +1,154 @@
 # Area Index
 
-Updated: 2026-02-14
+Updated: 2026-03-14
 
 ## Areas
 
 ### web-frontend
 - path: areas/web-frontend.md
-- updated: 2026-02-14
-- load-when: dashboard, kanban, cards, modal, UI components, drag-drop, project page, checklist, command config, health monitor, reconnection, toolkit, assets, search, scaffolding, activity feed, keyboard shortcuts, health score, tab sync, theme, design system, colors, gradient, texture, grain, noise, logo, neon, glow, blend mode, terminal styling, dark mode, light mode, provider selector, provider dropdown
+- updated: 2026-03-14
+- load-when: dashboard, kanban, cards, modal, UI components, drag-drop, project page, checklist, action config, health monitor, reconnection, cli assets, assets, search, scaffolding, activity feed, keyboard shortcuts, health score, tab sync, theme, design system, colors, gradient, texture, grain, noise, logo, neon, glow, blend mode, terminal styling, dark mode, light mode, provider selector, provider button, store, updates, update delivery, diff, assistant, asset creation, terminal prompt, pushToTerminal, Code Den, StoreView, UpdatesView, SkillDiffViewer, AssetAssistant, mcp config, automation, automations, scheduler, cron, cron-utils, timezone, TZ, agent notes, notes, summary note, wide viewport, 4K, copyright, favicon, context menu, right-click, confirm dialog, CliAssetsTab, project reorder, displayOrder, version check, VersionUpdateToast, AddProjectModal, scaffold wizard, provider overlay, placement, classAssignments, voice, voice input, voice recording, transcribe, Whisper, STT, VoiceControlBar, VoiceSettings, VoiceContext, VoiceClaimant, FloatingVoiceWidget, ThemeToggle, settings, image paste, screenshot, clipboard, DashboardData, chevron, hazard stripe, loadParentEnv, shadow, shadow depth, elevation, shadow-surface, shadow-card, shadow-overlay, lane texture, lane-texture, inset shadow, card number, glow-color, type emoji, glassmorphic, compact card, JetBrains Mono, priority glow, responsive, mobile, touch, fullscreen, snap-scroll, scrollbar-hide, import preview, ImportDialog, SKILL.md-only, skillMainOnly, activity ring, DEV_HOSTNAME, allowedDevOrigins, version display, getRepoRoot, getParentEnv, MASTER_PROJECT_ID, workspace ID, basename, fetchWithTimeout, checkSessionAlive, liveness check, soft failure, hard failure, activity detection, fresh session, resume session, action-scanner, ActionUpdatesModal, action updates, action cache, invalidateActionsCache, instruction file, instruction file warning, resize broadcast, resize sync, grace window, nextRun, getNextRun, HMR, globalThis, per-card provider
 - notes:
-  - CardModal tabs are dynamic: Details, Design?, Feature?, Test?, Checklist?, Terminal
-  - Terminal tab auto-connects when session is running
-  - HealthMonitor in ProjectHeader shows CPU/memory/terminals, expands on hover
-  - ConnectionManager handles SSE reconnection with Page Visibility API
-  - Cards with active work show pulsing green glow (active-glow-card CSS class)
-  - Commands use startupCommands (session start) and activeCommands (toolbar)
-  - ToolkitTab manages cross-project asset deployment (commands/skills/agents)
-  - HealthDot on ProjectCard shows 0-100 score (green/amber/red)
-  - paths.ts replaces all hardcoded paths with dynamic resolution
-  - CardModal has edit session protection (2000ms grace period, last-known-value tracking)
-  - Provider selector in ClaudeTerminalPanel pre-fills from stage defaults via /api/providers
-  - CardModal detects existing session's provider from session name (projectId:provider:card:cardId)
-  - NEVER use dark-end color scales for dark mode vibrant colors — use bright color at low opacity
-  - soft-light blend produces warm/red cast on dark backgrounds — use screen or overlay instead
-  - drop-shadow filters create rectangular glow on images with opaque backgrounds — incompatible with mix-blend-mode logo transparency
-  - Gradient direction: always left (vibrant) to right (soft), never center-out
-  - Texture is three layers: fine grain + perlin noise + depth highlight — each with separate light/dark tuning
+  - CardModal tabs: Details, Notes?, Design?, Feature?, Test?, Checklist?, Terminal. Edit session protection (2000ms grace). suppressAutoTerminal from context menu. Fullscreen on mobile (rounded-none, h-full), windowed on desktop (lg:rounded-xl, lg:max-w-4xl). Horizontal tab scroll with scrollbar-hide on mobile.
+  - Automation uses card description as prompt. Run Now button with feedback. Orange theme. onActiveAutomationsChange drives header pulse. Timezone badge in AutomationsScreen header + AutomationConfig one-shot picker. Automation safeguards: cannot archive automation cards (CLI + web), cannot enable automation on archived cards.
+  - Surgical save: changedCardIds in POST merges against disk. last_modified_by tracks source (web/cli/agent).
+  - Right-click context menu on cards: move stage, set priority, copy title/ID/desc, archive, delete. Portal z-51/52, lane-colored accent bars.
+  - Z-index layers: BackdropModal z-50, ContextMenu z-51, Submenu z-52, ConfirmDialog z-60
+  - Provider button group pre-fills from stage defaults. Session name: {projectId}:{provider}:card:{cardId}
+  - Store canonical flat layout (store/skills/, store/actions/, store/agents/). UpdatesView: accept/dismiss/preview workflow. CliAssetsTab (was ToolkitTab). ImportDialog for skill imports: SKILL.md-only default, full folder option. Preview API lists files before import.
+  - Action updates: ActionUpdatesModal for accept/dismiss/preview with diff viewer. ProjectHeader polls for actionEntries count, shows badge on Actions button. SlyActionConfigModal shows "Updates" tab when available. Cache invalidated via /api/sly-actions/invalidate on modal close.
+  - action-scanner.ts: scans store/actions/*.md, parses YAML frontmatter, assembles SlyActionsConfig with 30s cache, writes back from config (reverse-engineers classes from classAssignments), content-hash based update scanning, additive class merge on accept.
+  - Dashboard project drag-and-drop reordering with displayOrder field. AddProjectModal wizard: details → providers → review → creating → summary.
+  - VersionUpdateToast: npm version polling (6-hour interval, daily dismiss, bottom-left toast).
+  - Scheduler auto-starts via instrumentation.ts (30s), 60s grace window prevents stale ticks on re-enable. HMR-safe via globalThis state/timer. pushToTerminal() dispatches to GlobalClaudePanel.
+  - Single `actions` prop on ClaudeTerminalPanel, split by placement locally (startup/toolbar/both). CardModal and GlobalClaudePanel each call one getActionsForClass().
+  - SlyActionConfigModal: two-tab layout — Commands tab (edit definitions + placement dropdown) and Classes tab (assign + reorder commands per terminal class). Voice-enabled assistant terminal, Escape passes through to terminal when expanded.
+  - Voice: global VoiceContext (useVoice() hook). Claim system: CardModal/GlobalClaudePanel claim → release. FloatingVoiceWidget when unclaimed. VoiceControlBar, MediaRecorder → /api/transcribe → insert at claimant target. ThemeToggle for light/dark in Dashboard.
+  - Image paste: Terminal.tsx intercepts Ctrl+V via xterm's `attachCustomKeyEventHandler` (not DOM keydown — reliable after crash/reconnect), clipboard.read() for images → bridge /sessions/:name/image → inject `[Screenshot: ...]` into PTY. Screenshot toast overlay on ClaudeTerminalPanel.
+  - Path resolution centralized: getSlycodeRoot() (workspace) + getPackageDir() (dev: repo root, prod: node_modules/@slycode/slycode/dist/). All API routes use these — no local getRepoRoot(). CLI assets import/sync use registry.ts getRepoRoot() instead of claude-master project lookup.
+  - next.config.ts: getParentEnv() reads DEV_HOSTNAME from parent .env for allowedDevOrigins (no hardcoded hostnames). Dashboard footer shows slycode version from /api/version-check with clickable slycode.ai link.
+  - Scrubbed hardcoded project names: asset-scanner.ts uses MASTER_PROJECT_ID (path.basename), kanban-paths.ts derives workspace ID with underscore→hyphen normalization. paths.ts removed legacy root env var fallback (SLYCODE_HOME → cwd only).
+  - NEVER use dark-end color scales for vibrant dark mode — use bright color at low opacity instead
+  - Shadow depth system: 3 CSS custom property tiers (--shadow-surface, --shadow-card, --shadow-overlay) with light/dark variants. All neon-pulse keyframes layer glow on top of shadow vars. CardModal uses shadow-(--shadow-overlay). KanbanColumn wrappers use lightweight shadow.
+  - Texture: three layers (grain + perlin + depth) + lane-texture (18px grid on column card areas) + `.light-clean` suppression (hides grain/depth on headers in light mode). soft-light → warm cast on dark — use screen. drop-shadow → rectangular glow with blend-mode logos.
+  - Global terminal rebranded from neon-orange to neon-blue (steely blue #2490b5 in light mode). All glow effects have separate light-mode keyframes for visibility. ClaudeTerminalPanel buttons are neon-blue.
+  - KanbanColumn: light mode flat solid bg (no gradients), thicker borders (3px), neutral text colors (void-500/void-600). Inset shadows on headers (color-matched per lane). Header text has drop-shadow for legibility.
+  - KanbanCardItem: glassmorphism (bg-white/40 + backdrop-blur, dark: bg-[#20232a]/55), priority-colored left border + hover inset glow (--glow-color CSS var), card numbers (#0001 format, JetBrains Mono), type emojis replace color dots, compact mode for done column. Session status: green ping (running), orange (paused), grey (none).
+  - Voice-aware click-outside: GlobalClaudePanel and SlyActionConfigModal won't close while voice is recording/transcribing.
+  - Scheduler timezone-aware (TZ env var). loadParentEnv() reads .env from workspace root (Next.js only loads web/.env). Always recalculates nextRun for accurate countdowns. Automation run header: === AUTOMATION RUN === with time, card, trigger (scheduled with cron description / manual), last run + relative time.
+  - cronToHumanReadable() in cron-utils.ts (shared by AutomationConfig, AutomationsScreen). getNextRunISO() removed — all nextRun calculation now server-side via scheduler.ts getNextRun(). Kanban GET API dynamically computes nextRun for all enabled recurring cards. Timezone abbreviation appended to time descriptions.
+  - AutomationsScreen redesigned: max-w-5xl centered, 2-col grid (not 3), cards have chevron texture + hazard stripe + orange left border. Large countdown timers (text-2xl), "idle" label. Collapsible tag groups via `<details>`. New CSS: `.automation-chevron`, `.hazard-stripe` + muted variants.
+  - AgentNote extended: summary?, summarizedCount?, dateRange? for note summarization. Amber "Summary" badge in CardModal notes tab.
+  - Responsive mobile: CardModal fullscreen on mobile, GlobalClaudePanel fullscreen when expanded (h-svh w-screen on mobile), HealthMonitor click-to-toggle (was hover), Terminal touch-scroll + debounced resize (150ms), ProjectHeader mobile search overlay + hidden Actions, KanbanColumn snap-scroll (85vw on mobile). `.scrollbar-hide` CSS utility. All header buttons min-h/w-[44px] touch targets.
+  - Activity ring: uses isActive (not status=running) for session detection. Global terminal sessions included in counts.
+  - Scheduler split fresh/resume: fresh uses checkSessionAlive(20s), resume uses waitForActivity()+retry. fetchWithTimeout(10s) on all bridge calls. Soft failure notifications only on hard errors.
+  - Instruction file warning: ClaudeTerminalPanel checks /check-instruction-file on provider/cwd change. Amber warning + opt-out checkbox if missing. createInstructionFile state passed to session creation.
+  - Resize broadcast: Terminal.tsx guards resize POST (visible tabs only), suppressResizePost prevents echo loop from SSE resize events, skips resize on reconnect.
 
 ### terminal-bridge
 - path: areas/terminal-bridge.md
-- updated: 2026-02-14
-- load-when: terminal, Claude panel, xterm, bridge, pty, session, websocket, SSE, spawn, terminal class, security, stats, activity log, stop-all, provider, providers.json, multi-provider, gemini, codex, claude, resume, skip-permissions, YOLO
+- updated: 2026-03-14
+- load-when: terminal, terminal panel, xterm, bridge, pty, session, websocket, SSE, spawn, terminal class, security, stats, activity log, stop-all, provider, providers.json, multi-provider, gemini, codex, claude, resume, skip-permissions, YOLO, session detection, session ID, screenshot, image, image upload, image delivery, group status, action endpoint, relink, race condition, creating, mutex, idempotent, session cleanup, stopped session, heartbeat, instruction file, instructionFile, altInstructionFile, check-instruction-file, ensureInstructionFile, resize broadcast, suppressResizePost, Windows, ConPTY, chunked write, deferred prompt, bracketed paste, .cmd, pendingPrompt, paste interception, attachCustomKeyEventHandler
 - notes:
   - Pass prompts as positional args to Claude CLI, NOT -p flag (-p is print mode)
-  - Bridge binds to localhost by default (not 0.0.0.0) for security
-  - Command whitelist in bridge-config.json (only 'claude' and 'bash' allowed)
-  - CWD validated before spawning PTY (must be absolute path)
-  - Activity tracking: lastOutputAt timestamp, 2s threshold for "active" status
-  - Grace period (5s) after disconnect prevents idle timeout race condition
-  - ActivityTransition logging with trigger details for debugging phantom blips
-  - Atomic state saves (temp file + rename) prevent data corruption
-  - POST /sessions/:name/stop sends Escape key (soft stop) vs DELETE (kill)
-  - Session names now include provider: {projectId}:{provider}:card:{cardId} (with legacy fallback)
-  - provider-utils.ts builds command args from providers.json config (flag vs subcommand resume)
-  - GUID detection only for Claude; Gemini/Codex use --resume --last
+  - Bridge: localhost binding, command whitelist (bridge-config.json), CWD validation (absolute path)
+  - Activity tracking: lastOutputAt, 2s threshold. Grace period (5s) prevents idle timeout race. activityStartedAt for debouncing.
+  - Atomic state saves (temp + rename). bridge-sessions.json crash on corrupt, graceful on ENOENT.
+  - Session names: {projectId}:{provider}:card:{cardId} with legacy fallback. POST stop = Escape, DELETE = kill.
+  - provider-utils.ts builds command args from providers.json (flag vs subcommand resume)
+  - Session detection ALL providers: Claude (.jsonl), Codex (rollout UUID), Gemini (chat JSON) — 60s timeout
+  - Prompt works alongside resume: Claude positional, Codex positional after subcommand
+  - claude-utils.ts: provider-agnostic dispatchers (getProviderSessionDir, detectNewProviderSessionId, getMostRecentProviderSessionId)
+  - Image delivery: POST /sessions/:name/image (multer, 10MB), screenshot-utils.ts saves to screenshots/ in session CWD, 10-file retention, auto-.gitignore
+  - ActivityTransition: became (active/inactive), outputAgeMs, triggerSnippet/RawHex/DataLength (flat, not nested)
+  - New endpoints: GET /groups/:group/status, POST /sessions/:name/action (compact/clear/interrupt), POST /sessions/:name/relink
+  - SessionInfo includes group, resumed, lastActive fields
+  - Race condition fix: createSession() uses 'creating' placeholder as mutex. Concurrent requests for same session get 202 (idempotent). guidDetectionCancelled flag prevents stale detection overwrites.
+  - Stopped sessions removed from in-memory map (frees slot), data preserved in persistedState for resume.
+  - SSE heartbeat: 15s comment heartbeats keep connections alive through proxies (Tailscale, Next.js)
+  - Instruction file fallback: checkInstructionFile() priority scan (primary → alt → sibling copy source). ensureInstructionFile() copies on demand. Opt-in via createInstructionFile in CreateSessionRequest. GET /check-instruction-file endpoint for pre-flight checks.
+  - Resize broadcast: PTY resize events sent via SSE to all connected tabs. Terminal.tsx guards resize POST (visible tabs only, suppressResizePost echo-loop prevention, skip on reconnect).
+  - Windows ConPTY: .cmd extension auto-appended for CLI commands. Deferred prompt delivery via bracketed paste after output settles (1.5s quiet / 30s max). Chunked writes (1024B, 500ms delay) avoid ConPTY truncation. Paste interception uses xterm `attachCustomKeyEventHandler` (not DOM keydown).
 
-### claude-actions
-- path: areas/claude-actions.md
-- updated: 2026-02-09
-- load-when: actions, prompts, templates, context injection, commands, visibility, command config
+### terminal-actions
+- path: areas/terminal-actions.md
+- updated: 2026-03-10
+- load-when: actions, prompts, templates, context injection, commands, visibility, action config, terminal commands, startup commands, active commands, test review, placement, classAssignments, deep design, deep-design, action scanner, action updates, action .md, store/actions, action frontmatter, action cache, action delivery
 - notes:
-  - Unified command system in data/commands.json (v2.0)
-  - No 'type' field on Command - filtering by class + sessionState
-  - getStartupCommands() for session start, getActiveCommands() for toolbar
-  - Session states: new, resume, active, any
-  - Groups: Card Actions, Session, Project, Utilities, Problems, Command Assistant
-  - Update Priming and Chore Plan are newer commands
+  - Provider-agnostic: same commands across Claude, Codex, Gemini. Individual .md files in store/actions/ (v4.0)
+  - Each action is a .md file with YAML frontmatter (name, version, label, group, placement, classes map) + prompt body
+  - classAssignments assembled at runtime from per-action classes maps, sorted by priority (ascending)
+  - Context templates hardcoded in sly-actions.ts (no longer in JSON config)
+  - action-scanner.ts: parse, cache (30s), assemble config, write back, update scanning (content-hash), accept with additive class merge
+  - messaging/sly-action-filter.ts has duplicated YAML parser + 30s cache (reads store/actions/ directly)
+  - Action update delivery: updates/actions/ → content-hash diff → accept with class merge → store/actions/
+  - ActionUpdatesModal.tsx for accept/dismiss/preview. ProjectHeader polls for update count badge.
+  - SlyActionConfigModal shows "Updates" tab when action updates available
+  - Groups: Card Actions (14), Session, Project, Utilities, Action Assistant (no Problems group)
+  - Deep Design: 4-phase workflow (design doc → parallel analysis agents → synthesis → Q&A). 6 optional agent perspectives.
+  - Test Review: interactive testing-lane with checklist assessment, area priming, max 3 questions/round
+  - Organise Backlog: `kanban board` snapshot + `kanban reorder` for reprioritisation
 
 ### messaging
 - path: areas/messaging.md
-- updated: 2026-02-14
-- load-when: telegram, messaging, voice, TTS, STT, speech, channel, bot, ElevenLabs, Whisper, voice swap, stop command, response mode, tone, command filter, provider, permission mismatch
+- updated: 2026-03-13
+- load-when: telegram, messaging, voice, TTS, STT, speech, channel, bot, ElevenLabs, Whisper, whisper.cpp, local STT, STT_BACKEND, voice swap, stop command, response mode, tone, action filter, provider, provider resolution, bridge provider, explicit session, default provider, PROVIDER_LABELS, permission mismatch, /search, /provider, /sly, /switch, /global, /project, card search, photo, image, album, navigation, target, inline keyboard, callback, instruction file, ifc_, pre-flight, PendingInstructionFileConfirm
 - notes:
-  - Channel abstraction in types.ts, Telegram is first implementation
-  - Voice pipeline: Whisper STT → ElevenLabs v3 TTS with [audio tags]
-  - sendTextRaw() bypasses Markdown (preserves [brackets] for voice tags)
-  - Chat actions for status indicators (record_voice, typing, upload_voice)
-  - Voice search queries both personal (/v2/voices) and community (/v1/shared-voices)
-  - State persisted in messaging-state.json (project + voice + responseMode + voiceTone)
-  - CLI tool used by messaging skill to send outbound messages
-  - "stop" text intercepted and sends Escape to active session (not forwarded as prompt)
-  - command-filter.ts provides context-aware command filtering with template resolution
-  - kanban-client.ts gives direct access to project card data for prompts
-  - Messaging always forces skipPermissions: true (remote can't approve prompts)
-  - Permission mismatch detection when session started from web UI without skip-permissions
-  - State persists selectedProvider alongside project/voice/mode/tone
+  - Channel interface: onText/onVoice/onPhoto/onCommand + sendText/sendTextRaw/sendVoice/sendInlineKeyboard/setPersistentKeyboard/onCallback
+  - Navigation model: three-level targets (global/project/card) via /switch command with inline keyboards
+  - Bot commands: /start, /switch, /global, /project, /search, /sly, /status, /provider, /voice, /mode, /tone
+  - Callback prefixes: sw_ (switch), qc_ (quick card), cfg_ (config), perm_ (permissions), mode_, tone_
+  - State: messaging-state.json (targetType, projectId, cardId, cardStage, provider, voice, responseMode, voiceTone)
+  - Voice: Dual-backend STT (OpenAI Whisper or local whisper.cpp via STT_BACKEND env var) → ElevenLabs v3 TTS with [audio tags]. "stop" intercepted → Escape to session.
+  - skipPermissions always true. Permission mismatch detection for web-started sessions.
+  - sly-action-filter.ts: v3 classAssignments-based filtering. kanban-client.ts: card data, searchCards
+  - Photo albums batched via media_group_id (2s window). BridgeClient.sendImage() → bridge screenshot
+  - Persistent keyboard: [['/switch', '/search'], ['/provider', '/status'], ['/voice', '/tone'], ['/mode', '/sly']]
+  - Session names: global:{provider}:global, {projectId}:{provider}:global, {projectId}:{provider}:card:{cardId}
+  - Provider auto-resolution: resolveProviderFromBridge() / resolveProjectProviderFromBridge() pick provider from most recent bridge session. hasExplicitSession() determines default vs explicit. Navigation commands (sw_, /global, /project) auto-resolve provider. cfg_ callback updates providers.json global default when no explicit session.
+  - Instruction file pre-flight: checkInstructionFilePreFlight() checks before new session creation (text/voice/photo). Shows ifc_ inline buttons if needed. PendingInstructionFileConfirm stored in StateManager (ephemeral). BridgeClient.checkInstructionFile() + createInstructionFile param on ensureSession/sendMessage.
 
 ### skills
 - path: areas/skills.md
-- updated: 2026-02-09
-- load-when: skills, commands, agents, hooks, slash commands, SKILL.md, scaffolding
+- updated: 2026-03-14
+- load-when: skills, commands, agents, hooks, slash commands, SKILL.md, scaffolding, store, cross-provider, convert-asset, notes, notes summarize, automation, kanban CLI, last_modified_by, updates, update delivery, npm, packages, slycode CLI, migrate, board, reorder, build pipeline, sync-updates, store-manifest, provider overlay, base-instructions, slycode config, slycode uninstall, tutorial project, card number, nextCardNumber, licensing, BUSL, open-core, skillMainOnly, STT_BACKEND, WHISPER_CLI_PATH, WHISPER_MODEL_PATH, timezone, TZ, create-slycode wizard, @slycode scope, @slycode/slycode, @slycode/create-slycode
 - notes:
-  - Skills live in .claude/skills/, commands in .claude/commands/, agents in .claude/agents/
-  - 6 skills: context-priming, interactive-explainer, skill-creator, messaging, claude-code-docs-maintainer, kanban
-  - 1 agent: doc-updater
-  - 10 commands: checkpoint, feature, chore, implement, design, doc-discovery, doc-update, reference-fetch, create-command, problem_summary
-  - Scaffold templates in data/scaffold-templates/
+  - ALL commands converted to skills. 17 skills + 1 agent (doc-updater) + 1 dummy skill (inert test). .claude/commands/ removed. Licensed under BUSL-1.1 (open-core).
+  - Store: 17 canonical skills (store/skills/) + actions (store/actions/*.md). Flat layout, no provider subdirectories.
+  - Update delivery: updates/ → accept → store/ (with backup) → deploy to projects. Actions use content-hash comparison + additive class merge.
+  - NPM: packages/slycode/ (CLI, 11 subcommands incl config + uninstall) + packages/create-slycode/ (scaffold). .agents/skills/ for Codex format.
+  - kanban.js: board, reorder, notes (add/list/search/edit/delete/clear/oldest/summarize), automation subcommands. stamps last_modified_by/source on writes. Notes: 100 hard cap, 30 soft suggestion threshold, summarize replaces oldest N with summary note. Archive safeguard: automation cards cannot be archived. Sequential card numbers: ensureCardNumbers() auto-backfills on first write, nextCardNumber tracked on kanban root. Kanban skill v1.4.0: multiline description example in docs. `automation enable` recalculates nextRun via croner.
+  - Scaffold: multi-provider, tutorial content seeded into workspace root (not separate slycode_tutorial/ subdirectory). Kanban seed uses stage-based format. Clean output: suppresses zero-count lines, reports new vs existing doc dirs. Setup wizard prompts for timezone (auto-detects, writes TZ= to .env). System service prompt skipped on Windows.
+  - NPM packages under `@slycode` scope: `@slycode/slycode` (v0.1.11), `@slycode/create-slycode` (v0.1.11). Template paths: `node_modules/@slycode/slycode/templates/`.
+  - Build pipeline: build-package.ts → sync-updates.ts (skills + actions) → copy scaffold-templates/ + store/ + updates/actions/ to dist/. Templates (skills, actions, tutorial-project) removed from packages/slycode/templates/ — build pipeline is sole delivery mechanism.
+  - Hooks: useSlyActionsConfig.ts (not useCommandsConfig.ts)
+
+### feature-guide
+- path: areas/feature-guide.md
+- updated: 2026-03-14
+
+- load-when: feature guide, feature reference, full scope, system overview, product overview, comprehensive reference, all features, complete reference, deep dive features, product messaging, value proposition, USP, positioning, user story, what is slycode, why slycode, target audience, marketing, website copy, README copy, onboarding copy, pricing, teams tier, per-card provider selection
+- notes:
+  - Auto-maintained by automation card-1772101929502
+  - Comprehensive reference of every SlyCode feature, function, and behavior
+  - Use when needing full product scope for design docs, comparisons, or thorough analysis
+  - PROTECTED: documentation/features/042_slycode_product_messaging.md is the canonical product messaging framework. It defines SlyCode's positioning, value proposition, messaging pillars, target audience, pricing framing, and proof points. Load this document whenever product identity, messaging, marketing copy, or user-facing language is relevant. Do NOT remove or overwrite this reference during context priming updates.
 
 ### scripts-deployment
 - path: areas/scripts-deployment.md
-- updated: 2026-02-10
-- load-when: setup, scripts, deployment, start, stop, restart, dev, ports, service, systemd, launchd, linger, PID, zombie, sly-start, sly-stop, sly-dev, sly-restart, setup.sh, .env, environment, production, build, tmux, bridge-sessions, XDG_RUNTIME_DIR
+- updated: 2026-03-14
+- load-when: setup, scripts, deployment, start, stop, restart, dev, ports, service, systemd, launchd, linger, PID, zombie, sly-start, sly-stop, sly-dev, sly-restart, setup.sh, .env, environment, production, build, tmux, bridge-sessions, XDG_RUNTIME_DIR, build tools, gcc, npm, packages, slycode, create-slycode, migrate, build-package, sync-updates, store-manifest, SLYCODE_HOME, path resolution, getSlycodeRoot, getPackageDir, slycode.config.js, config, uninstall, DEV_HOSTNAME, legacy root env var, timezone, TZ
 - notes:
   - Two port ranges: dev (3003/4/5) and prod (7591/2/3 = "sly" on keypad)
   - Stop by port, NOT PID files (npm spawns children, PIDs go stale)
   - bridge-sessions.json is critical — crash on read errors, never silently wipe
   - XDG_RUNTIME_DIR must be set for systemctl --user in code-server
-  - Build every time on prod start — no stale build risk
+  - slycode.config.js: workspace-level config for ports, services, host. Loaded by config/loader.ts.
+  - Default host: 127.0.0.1. Only web binds to config.host; bridge+messaging always localhost.
+  - slycode CLI: 11 subcommands (workspace, start, stop, service, doctor, skills, sync, update, config, uninstall)
   - sly-dev.sh tmux hook calls sly-stop.sh on session close to prevent zombies
   - Global CLIs: sly-kanban, sly-messaging, sly-scaffold (symlinked to ~/bin)
+  - Build: build-package.ts preserves tutorial-project/ template during wipe/rebuild
+  - NPM packages: packages/slycode/ (v0.1.0 CLI) and packages/create-slycode/ (v0.1.0 scaffold)
+  - Tutorial v3: content seeded into workspace root (not slycode_tutorial/ subdir). Registry default project = workspace root.
+  - Path resolution simplified: legacy root env var env var removed. Resolution is now SLYCODE_HOME → cwd fallback only.

package/{dist/store/skills/context-priming/references → templates/updates/skills/context-priming}/references/areas/feature-guide.md

@@ -1,8 +1,8 @@
-<!-- Last reviewed: 2026-03-13 -->
+<!-- Last reviewed: 2026-03-14 -->
 
 # SlyCode Feature Reference
 
-> Auto-generated comprehensive reference. Last updated: 2026-03-13
+> Auto-generated comprehensive reference. Last updated: 2026-03-14
 > Single source of truth for all SlyCode features, functions, and behaviors.
 > NOT a user guide. Maximally information-dense AI reference document.
 
@@ -224,6 +224,7 @@ SlyCode CLI (npm package)     <-->  All services (start/stop/update/sync)
 
 ### Sly Action Config Modal (`SlyActionConfigModal.tsx`)
 - Voice integration: registers assistant terminal with VoiceContext (`voiceTerminalId="action-assistant"`); `onTerminalReady` wires `registerTerminal`/`unregisterTerminal`
+- Terminal context project name: `'SlyCode'` (was `'ClaudeMaster'`)
 - Voice-aware dismiss: checks `voice.voiceState` from `useVoice()` context; won't close on outside-click while voice is busy
 - Escape key: passes through to terminal uninterrupted when assistant panel is expanded (no longer closes assistant); only navigates back/closes when assistant is collapsed
 - **Action updates integration**: accepts `actionUpdateCount` and `onShowActionUpdates` props; renders badge with pending count in header when > 0; clicking badge invokes `onShowActionUpdates` callback to open `ActionUpdatesModal`
@@ -267,6 +268,13 @@ SlyCode CLI (npm package)     <-->  All services (start/stop/update/sync)
 - VoiceSettingsPopover: configurable shortcuts (Ctrl+., Space, Enter, Shift+Enter, Escape)
 - FloatingVoiceWidget: always-visible mic button
 
+### Transcribe API (`api/transcribe/route.ts`)
+- **Dual STT backend**: `STT_BACKEND` env var selects backend; `'local'` uses local whisper.cpp, default `'openai'` uses OpenAI Whisper API
+- **Local backend**: requires `WHISPER_CLI_PATH` (path to whisper-cli binary) and `WHISPER_MODEL_PATH` (path to .ggml model file); returns 401 if not configured
+- **Local pipeline**: writes uploaded audio to temp file, converts to 16kHz mono WAV via `ffmpeg` (30s timeout), runs `whisper-cli` with `--no-timestamps --output-txt` (120s timeout), cleans up temp files in `finally` block
+- **Env loading**: `loadEnv()` reads all `[A-Z_]+=` lines from root `.env` file (was `loadEnvKey()` reading only `OPENAI_API_KEY`); caches parsed values; sets `process.env` for keys not already present
+- **Audio format detection**: determines extension from MIME type (`mp4`/`ogg`/`webm`); used for both backends
+
 ### Health Monitor (`HealthMonitor.tsx`)
 - CPU%, Memory, Swap from /api/system-stats; terminal counts from /bridge/stats
 - Green (<70%), Amber (70-90%), Critical (>=90%); "Stop All" with confirmation
@@ -343,7 +351,7 @@ SlyCode CLI (npm package)     <-->  All services (start/stop/update/sync)
 | /api/projects/[id] | GET/PUT/DELETE | CRUD |
 | /api/projects/reorder | POST | Reorder |
 | /api/file | POST/GET | Upload (images) / read file content |
-| /api/transcribe | POST | Whisper STT |
+| /api/transcribe | POST | Whisper STT (OpenAI API or local whisper.cpp backend via STT_BACKEND env) |
 | /api/settings | GET/PUT | Preferences |
 | /api/areas | GET | Context-priming areas |
 | /api/terminal-classes | GET | Terminal classes |
@@ -378,6 +386,7 @@ SlyCode CLI (npm package)     <-->  All services (start/stop/update/sync)
 23. SSE-to-polling migration: sly-actions config consumers switched from SSE stream to 30s polling via `useSlyActionsConfig()` hook to conserve scarce HTTP/1.1 connection slots (6 per origin browser limit); SSE stream endpoint retained for backward compatibility
 24. Action update acceptance: additive class merge preserves user customizations -- only adds new upstream classes to the store copy; records upstream content hash (not store hash) so class-merged store files don't trigger false future updates
 25. Instruction file fallback: ClaudeTerminalPanel checks bridge for missing provider instruction files before session start; offers to auto-create from fallback source (e.g. copy provider template when project lacks CLAUDE.md)
+26. Transcribe API env loading: `loadEnv()` reads parent `.env` (via `getSlycodeRoot()`) since Next.js only auto-loads `web/.env`; caches parsed values; STT_BACKEND, WHISPER_CLI_PATH, WHISPER_MODEL_PATH, OPENAI_API_KEY all resolved from this file
 
 ### Key Files
 | File | Purpose |
@@ -418,6 +427,7 @@ SlyCode CLI (npm package)     <-->  All services (start/stop/update/sync)
 | web/src/app/api/cli-assets/store/route.ts | Store import with skillMainOnly option |
 | web/src/app/api/cli-assets/store/preview/route.ts | Skill file listing preview for import dialog |
 | web/src/app/api/cli-assets/updates/route.ts | Unified updates API: skills + actions scan, accept, dismiss |
+| web/src/app/api/transcribe/route.ts | Whisper STT: dual backend (OpenAI API / local whisper.cpp), env loading |
 | web/src/app/api/sly-actions/invalidate/route.ts | Actions config cache invalidation |
 | web/src/app/globals.css | Tokens, colors, priority-based glow keyframes, lane texture, automation textures |
 | web/src/app/layout.tsx | Font loading (Geist Sans, Geist Mono, JetBrains Mono) |
@@ -707,11 +717,12 @@ AutomationConfig {
 - No PTY kill needed for `creating` sessions (no PTY exists yet)
 - `stopAllSessions()` includes `creating` in its status filter alongside `running`/`detached`
 - On stop: session deleted from in-memory `sessions` Map to free the slot; session data preserved in `persistedState` for future resume; `getSessionInfo()` falls back to `persistedState` when not in the Map
+- `hasHistory` in session info: true only when `claudeSessionId` exists (not just persisted state presence) — sessions that never detected a GUID show `hasHistory: false`
 
 ### Provider Session Detection
 | Provider | Dir | Resume |
 |----------|-----|--------|
-| Claude | ~/.claude/projects/-{cwd}/ | --resume {guid} |
+| Claude | ~/.claude/projects/-{cwd}/ (path chars `/ _ \ :` → `-`) | --resume {guid} |
 | Codex | ~/.codex/sessions/YYYY/MM/DD/ | codex resume {guid} |
 | Gemini | ~/.gemini/tmp/{SHA256}/chats/ | --resume |
 - Before/after file list; poll 200ms; live `getClaimedGuids()` check per iteration
@@ -807,7 +818,7 @@ AutomationConfig {
 | bridge/src/websocket.ts | WS heartbeat |
 | bridge/src/pty-handler.ts | PTY ops |
 | bridge/src/provider-utils.ts | Command building, instruction file check/ensure, provider config cache |
-| bridge/src/claude-utils.ts | Session detection |
+| bridge/src/claude-utils.ts | Session detection, Claude project dir path transformation (cross-platform) |
 | bridge/src/screenshot-utils.ts | Image handling |
 | data/providers.json | Provider definitions (commands, flags, instruction files, defaults) |
 
@@ -822,7 +833,7 @@ AutomationConfig {
 
 ### Message Flow
 - Text: authorize -> route -> format -> instructionFilePreFlight -> bridge.sendMessage -> watchActivity
-- Voice: OGG -> Whisper STT -> text with [Telegram/Voice] header -> instructionFilePreFlight -> bridge
+- Voice: OGG -> STT (OpenAI Whisper API or local whisper.cpp) -> text with [Telegram/Voice] header -> instructionFilePreFlight -> bridge
 - Photo: batch by media_group_id (2s) -> bridge.sendImage -> [Screenshot: ...] -> instructionFilePreFlight -> bridge
 - Outbound: cli.ts send -> POST /send or /voice -> channel
 
@@ -871,7 +882,13 @@ AutomationConfig {
 - Quick command callback (`qc_` prefix): inline button -> `executeQuickCommand()` -> resolves prompt -> sends to bridge
 
 ### Voice
-- STT: OGG -> Whisper v1 -> text
+- **STT backend selection**: `STT_BACKEND` env var — `openai` (default) or `local`
+- **OpenAI path**: OGG -> OpenAI Whisper v1 API -> text (requires `OPENAI_API_KEY`)
+- **Local whisper.cpp path**: OGG -> ffmpeg (16kHz mono WAV) -> whisper-cli -> text (requires `WHISPER_CLI_PATH`, `WHISPER_MODEL_PATH`; 120s timeout)
+- `stt.ts` exports: `transcribeAudio(filePath, SttConfig)`, `validateSttConfig(SttConfig)` — routes to `transcribeOpenAI()` or `transcribeLocal()` internally
+- `SttConfig { backend, openaiApiKey, whisperCliPath, whisperModelPath }` — validated before transcription; errors surfaced to user
+- `VoiceConfig` (types.ts): added `sttBackend`, `whisperCliPath`, `whisperModelPath` fields
+- Startup log shows backend-specific STT status (local: validates CLI/model paths; openai: checks API key)
 - TTS: ElevenLabs v3 (eleven_v3, stability=0.5, similarity=0.75) -> MP3 -> ffmpeg libopus -> OGG
 - Search: /v2/voices + /v1/shared-voices parallel
 
@@ -912,13 +929,13 @@ AutomationConfig {
 | messaging/src/state.ts | Navigation, voice, mode, pending instruction file state |
 | messaging/src/bridge-client.ts | Sessions, activity, checkInstructionFile, ensureSession, getProjectSessions |
 | messaging/src/channels/telegram.ts | Polling, keyboards |
-| messaging/src/stt.ts | Whisper STT |
+| messaging/src/stt.ts | Dual-backend STT: OpenAI Whisper API or local whisper.cpp, SttConfig, validateSttConfig |
 | messaging/src/tts.ts | ElevenLabs TTS |
 | messaging/src/voices.ts | Voice search (personal + shared) |
 | messaging/src/sly-action-filter.ts | Action scanning from store/actions/*.md, filtering, template resolution |
 | messaging/src/kanban-client.ts | Board loading |
 | messaging/src/cli.ts | Send messages |
-| messaging/src/types.ts | All shared types (Channel, SlyActionConfig, InstructionFileCheck, PendingInstructionFileConfirm, BridgeCreateSessionRequest, BridgeSessionInfo) |
+| messaging/src/types.ts | All shared types (Channel, VoiceConfig, SlyActionConfig, InstructionFileCheck, PendingInstructionFileConfirm, BridgeCreateSessionRequest, BridgeSessionInfo) |
 | documentation/features/049_per_card_provider_selection.md | Per-card provider selection feature spec |
 
 ---
@@ -927,6 +944,7 @@ AutomationConfig {
 
 ### CLI (packages/slycode/)
 - Entry: bin/slycode.js (Node v20+); 9 lazy-loaded subcommands
+- Package metadata: author `Greg Atkins <support@slycode.ai>`, license BUSL-1.1, repo `slycode-ai/slycode`; both packages publish author, repository, homepage, bugs fields
 
 ### Commands
 | Command | Key Logic |
@@ -954,9 +972,10 @@ AutomationConfig {
 
 ### Create-SlyCode
 - `npx create-slycode [dir] [--yes]`
-- Setup wizard: network binding (localhost vs 0.0.0.0), ports, Telegram token/userId, voice keys (OpenAI/ElevenLabs), system service
+- Setup wizard: timezone (auto-detects via `Intl.DateTimeFormat`, writes `TZ=` to .env for cron scheduling), network binding (localhost vs 0.0.0.0), ports, Telegram token/userId, voice keys (OpenAI/ElevenLabs), system service
 - Existing workspace detection: warns if ~/.slycode/config.json points elsewhere; offers continue or cancel
-- Creates: package.json, slycode.config.js, .env (commented sections), .gitignore
+- Creates: package.json, slycode.config.js, .env (sections: Timezone `TZ=`, Ports, Telegram, Voice STT/TTS), .gitignore
+- `--yes` auto-accepts defaults: detected system timezone, host 0.0.0.0, ports 7591/2/3, no integrations, no service
 - Seeds: commands.json (empty), registry.json (single tutorial project), providers.json from package templates
 - **Actions now individual MD files**: `deployStoreActions()` copies `store/actions/*.md` from package templates (replaces old sly-actions.json seeding); each action is a standalone markdown file with YAML frontmatter + prompt body
 - Kanban seed: `{project_id: 'slycode', stages: {backlog:[], design:[], ...}, last_updated}` (overwritten by tutorial seed if template available)
@@ -1006,7 +1025,9 @@ AutomationConfig {
 | packages/slycode/src/cli/workspace.ts | Workspace resolution, config loading |
 | packages/slycode/src/cli/service.ts | Platform services |
 | packages/slycode/src/cli/uninstall.ts | Clean removal |
-| packages/create-slycode/src/index.ts | Scaffold wizard; deploys store actions as individual MD files |
+| packages/create-slycode/src/index.ts | Scaffold wizard; timezone prompt, deploys store actions as individual MD files |
+| packages/create-slycode/package.json | Package metadata: author, repository (directory: packages/create-slycode), homepage, bugs |
+| packages/slycode/package.json | Package metadata: author, repository, homepage, bugs |
 | packages/slycode/templates/CLAUDE.md | Workspace CLAUDE.md (tutorial mode section) |
 | packages/slycode/templates/store/actions/*.md | Action prompt templates (individual MD files with YAML frontmatter) |
 | packages/slycode/templates/tutorial-project/ | Tutorial content template |
@@ -1038,8 +1059,8 @@ AutomationConfig {
 | reference-fetch | 1.1.1 | Doc retrieval |
 | doc-discovery | 1.0.1 | Doc gap analysis |
 | doc-update | 1.0.1 | Doc maintenance |
-| claude-code-docs-maintainer | 1.0.1 | Claude Code docs |
-| convert-asset | 1.0.0 | Cross-provider conversion |
+| claude-code-docs-maintainer | 1.0.1 | Claude Code docs; references SlyCode repository (was ClaudeMaster); relative doc paths |
+| convert-asset | 1.0.0 | Cross-provider conversion; scope now global (was project-specific) |
 | create-command | 1.0.1 | Slash commands |
 | problem_summary | 1.0.1 | Issue summary |
 
@@ -1071,21 +1092,22 @@ AutomationConfig {
 ### Terminal Actions (Markdown Format, 26 Commands)
 - **Migration from JSON to markdown**: `data/sly-actions.json` archived to `data/archive/sly-actions.json.archived`; conversion script `scripts/convert-actions-to-md.js` (one-time)
 - **Format**: individual `store/actions/<name>.md` files with YAML frontmatter + prompt body (see action-assistant-context.md for full spec)
-- **Frontmatter fields**: name, version, label, description, group, placement, scope, projects, cardTypes, classes (map of terminal-class -> sort priority)
+- **Frontmatter fields**: name, version, label, description, group, placement, scope (global or specific), projects, cardTypes, classes (map of terminal-class -> sort priority)
 - **Scanning**: both web (`action-scanner.ts`) and messaging (`sly-action-filter.ts`) scan `store/actions/*.md` independently; both parse YAML frontmatter with lightweight parsers (no YAML lib); both use 30s in-memory cache
 - **Class assignments**: derived from per-action `classes` map (reverse of old top-level `classAssignments` array); priority numbers with gaps of 10 for insertion; ties broken alphabetically
 - Placement: startup, toolbar, both
-- Groups (5): Card Actions (14), Session (1), Project (4), Utilities (5), Action Assistant (1)
+- Groups (5): Card Actions (14), Session (2), Project (4), Utilities (5), Action Assistant (1)
 - Classes (9): global-terminal, project-terminal, backlog, design, implementation, testing, done, automation, action-assistant
 - Templates: `{{var}}` mustache-style (cardContext, projectContext, globalContext context blocks + field-level card/project/stage/projectPath)
 - Context injection is opt-in: actions must include `{{cardContext}}` etc. in prompt body
 - MAX_VISIBLE_ACTIONS=6; Shift+click inserts without submit
 - All command prompts use `sly-kanban` CLI (not `node scripts/kanban.js`)
 - `data/action-assistant-context.md`: comprehensive reference for the action assistant (format spec, template variables, workflow diagram, common mistakes, learned patterns)
+- **convert-asset**: scope changed from `specific` (claude-master only) to `global` — available in all workspaces
 
 ### Terminal Action Commands
 - **Card Actions** (14): onboard, design-requirements, deep-design, make-feature, implement, quick-fix, debug, complete, review, approve, archive, chore, analyse-implementation, test-review
-- **Session** (1): summarize
+- **Session** (2): summarize, continue
 - **Project** (4): explore, create-card, update-priming, organise-backlog
 - **Utilities** (5): clear, checkpoint, context, show-card, convert-asset
 - **Action Assistant** (1): configure-commands
@@ -1100,9 +1122,11 @@ AutomationConfig {
 
 ### Store (Canonical Flat)
 - store/skills/ (17 dirs, includes dummy), store/actions/ (26 .md files), store/agents/, store/mcp/, store/.backups/
+- **Renaming**: all store assets updated from "ClaudeMaster" to "SlyCode" references (skills, backups, area refs); doc paths normalized to relative (was Windows absolute in claude-code-docs-maintainer)
+- Store skills include full reference subdirectories: `store/skills/context-priming/references/references/areas/{skills,scripts-deployment}.md` (distributed to new workspaces); `updates/skills/` mirrors same structure
 - Update flow: updates/ -> accept -> backup -> overwrite store/ -> deploy
 - Template skill versions (in updates/): context-priming v1.1.8, kanban v1.4.0, chore v1.1.1 (all include `provider: claude` frontmatter)
-- Manifest: 7 skills (context-priming, checkpoint, feature, implement, design, kanban, messaging)
+- Manifest: 8 skills (context-priming, checkpoint, chore, feature, implement, design, kanban, messaging)
 - Ignored: store/.ignored-updates.json (tracks both skills and actions by content hash)
 - Hook: useSlyActionsConfig.ts (renamed from useCommandsConfig.ts)
 - **Import preview**: `GET /api/cli-assets/store/preview` lists all files in a skill directory before import (params: provider, assetType, assetName, sourceProjectId); returns `{ files: string[], isDirectory: boolean }`
@@ -1128,6 +1152,8 @@ provider (claude|codex|gemini), name, version (semver), updated (YYYY-MM-DD), de
 | .claude/skills/context-priming/references/area-index.md | Area index (7 areas, load-when triggers, notes) |
 | .claude/skills/context-priming/references/areas/*.md | Deep reference per area |
 | .claude/skills/context-priming/references/maintenance.md | Defrag, pruning, area separation doctrine |
+| store/skills/claude-code-docs-maintainer/SKILL.md | Claude Code docs skill (SlyCode refs, relative paths) |
+| store/skills/context-priming/references/ | Store copy of context-priming area refs (SlyCode-renamed) |
 | store/actions/*.md | Individual action files (26), YAML frontmatter + prompt body |
 | data/action-assistant-context.md | Action assistant reference (format spec, template variables, workflow, learned patterns) |
 | data/archive/sly-actions.json.archived | Archived legacy JSON format (migrated to store/actions/*.md) |