panopticon-cli 0.4.33 → 0.5.0

package/dist/index.d.ts

@@ -829,5 +829,14 @@ declare function getProviderEnv(provider: ProviderConfig, apiKey: string): Recor
  * Must be called before spawning the agent.
  */
 declare function setupCredentialFileAuth(provider: ProviderConfig, workspacePath: string): void;
+/**
+ * Clear credential-file auth from workspace settings.
+ *
+ * When switching from a credential-file provider (e.g. Kimi) to a static/plan-based
+ * provider (e.g. Anthropic), the apiKeyHelper must be removed from
+ * .claude/settings.local.json. Otherwise Claude Code will keep using the stale
+ * token helper and fail with "Invalid API key".
+ */
+declare function clearCredentialFileAuth(workspacePath: string): void;
 
-export { AGENTS_DIR, ARCHIVES_DIR, type AnthropicModel, type ApiKeysConfig, BACKUPS_DIR, BIN_DIR, type BackupInfo, CACHE_AGENTS_DIR, CACHE_MANIFEST, CACHE_RULES_DIR, CACHE_SKILLS_DIR, CERTS_DIR, CLAUDE_DIR, CLAUDE_MD_TEMPLATES, COMMANDS_DIR, CONFIG_DIR, CONFIG_FILE, COSTS_DIR, type Comment, type ComplexityLevel, type ComplexityModels, DOCS_DIR, type DevrootSyncItem, type GitHubConfig, GitHubTracker, type GitLabConfig, GitLabTracker, type GoogleModel, HEARTBEATS_DIR, type HookItem, INIT_DIRS, type Issue, type IssueFilters, IssueNotFoundError, type IssueState, type IssueTracker, type IssueUpdate, type KimiModel, LEGACY_RUNTIME_DIRS, type LinearConfig, LinearTracker, type LinkDirection, LinkManager, type MigrationResult, type ModelId, type ModelsConfig, type NewIssue, NotImplementedError, type OpenAIModel, PANOPTICON_HOME, PRDS_DIR, PRD_DRAFTS_DIR, PRD_PUBLISHED_DIR, PROJECT_DOCS_SUBDIR, PROJECT_PRDS_ACTIVE_SUBDIR, PROJECT_PRDS_COMPLETED_SUBDIR, PROJECT_PRDS_PLANNED_SUBDIR, PROJECT_PRDS_SUBDIR, PROVIDERS, type PanopticonConfig, type ProviderAuthType, type ProviderCompatibility, type ProviderConfig, type ProviderName, type RallyConfig, type RefreshCacheResult, type RemoteConfig, type RemoteExeConfig, SETTINGS_FILE, SKILLS_DIR, SOURCE_AGENTS_DIR, SOURCE_DEV_SKILLS_DIR, SOURCE_RULES_DIR, SOURCE_SCRIPTS_DIR, SOURCE_SKILLS_DIR, SOURCE_TEMPLATES_DIR, SOURCE_TRAEFIK_TEMPLATES, SYNC_TARGET, type SettingsConfig, type ShadowConfig, type Shell, type SpecialistModels, type SyncItem, type SyncOptions, type SyncPlan, type SyncResult, TEMPLATES_DIR, TRAEFIK_CERTS_DIR, TRAEFIK_DIR, TRAEFIK_DYNAMIC_DIR, TrackerAuthError, type TrackerConfig, type TrackerConfigItem, type TrackerLink, type TrackerType, type TrackersConfig, type ZAIModel, addAlias, cleanOldBackups, createBackup, createBackupTimestamp, createTracker, createTrackerFromConfig, detectShell, executeSync, findDevrootForProject, formatIssueRef, getAgentCommand, getAliasInstructions, getAllTrackers, getAvailableModels, getClaudeModelFlag, getDashboardApiUrl, getDefaultConfig, getDefaultSettings, getDevrootPath, getDirectProviders, getLinkManager, getPanopticonHome, getPrimaryTracker, getProviderEnv, getProviderForModel, getRouterProviders, getSecondaryTracker, getShellRcFile, hasAlias, isAnthropicModel, isDevMode, isPanopticonSymlink, listBackups, loadConfig, loadSettings, migrateFromPersonalSymlinks, needsRouter, parseIssueRef, planHooksSync, planSync, refreshCache, requiresRouter, restoreBackup, saveConfig, saveSettings, setupCredentialFileAuth, syncHooks, syncStatusline, validateSettings };
+export { AGENTS_DIR, ARCHIVES_DIR, type AnthropicModel, type ApiKeysConfig, BACKUPS_DIR, BIN_DIR, type BackupInfo, CACHE_AGENTS_DIR, CACHE_MANIFEST, CACHE_RULES_DIR, CACHE_SKILLS_DIR, CERTS_DIR, CLAUDE_DIR, CLAUDE_MD_TEMPLATES, COMMANDS_DIR, CONFIG_DIR, CONFIG_FILE, COSTS_DIR, type Comment, type ComplexityLevel, type ComplexityModels, DOCS_DIR, type DevrootSyncItem, type GitHubConfig, GitHubTracker, type GitLabConfig, GitLabTracker, type GoogleModel, HEARTBEATS_DIR, type HookItem, INIT_DIRS, type Issue, type IssueFilters, IssueNotFoundError, type IssueState, type IssueTracker, type IssueUpdate, type KimiModel, LEGACY_RUNTIME_DIRS, type LinearConfig, LinearTracker, type LinkDirection, LinkManager, type MigrationResult, type ModelId, type ModelsConfig, type NewIssue, NotImplementedError, type OpenAIModel, PANOPTICON_HOME, PRDS_DIR, PRD_DRAFTS_DIR, PRD_PUBLISHED_DIR, PROJECT_DOCS_SUBDIR, PROJECT_PRDS_ACTIVE_SUBDIR, PROJECT_PRDS_COMPLETED_SUBDIR, PROJECT_PRDS_PLANNED_SUBDIR, PROJECT_PRDS_SUBDIR, PROVIDERS, type PanopticonConfig, type ProviderAuthType, type ProviderCompatibility, type ProviderConfig, type ProviderName, type RallyConfig, type RefreshCacheResult, type RemoteConfig, type RemoteExeConfig, SETTINGS_FILE, SKILLS_DIR, SOURCE_AGENTS_DIR, SOURCE_DEV_SKILLS_DIR, SOURCE_RULES_DIR, SOURCE_SCRIPTS_DIR, SOURCE_SKILLS_DIR, SOURCE_TEMPLATES_DIR, SOURCE_TRAEFIK_TEMPLATES, SYNC_TARGET, type SettingsConfig, type ShadowConfig, type Shell, type SpecialistModels, type SyncItem, type SyncOptions, type SyncPlan, type SyncResult, TEMPLATES_DIR, TRAEFIK_CERTS_DIR, TRAEFIK_DIR, TRAEFIK_DYNAMIC_DIR, TrackerAuthError, type TrackerConfig, type TrackerConfigItem, type TrackerLink, type TrackerType, type TrackersConfig, type ZAIModel, addAlias, cleanOldBackups, clearCredentialFileAuth, createBackup, createBackupTimestamp, createTracker, createTrackerFromConfig, detectShell, executeSync, findDevrootForProject, formatIssueRef, getAgentCommand, getAliasInstructions, getAllTrackers, getAvailableModels, getClaudeModelFlag, getDashboardApiUrl, getDefaultConfig, getDefaultSettings, getDevrootPath, getDirectProviders, getLinkManager, getPanopticonHome, getPrimaryTracker, getProviderEnv, getProviderForModel, getRouterProviders, getSecondaryTracker, getShellRcFile, hasAlias, isAnthropicModel, isDevMode, isPanopticonSymlink, listBackups, loadConfig, loadSettings, migrateFromPersonalSymlinks, needsRouter, parseIssueRef, planHooksSync, planSync, refreshCache, requiresRouter, restoreBackup, saveConfig, saveSettings, setupCredentialFileAuth, syncHooks, syncStatusline, validateSettings };

package/dist/index.js

@@ -21,7 +21,7 @@ import {
   restoreBackup,
   syncHooks,
   syncStatusline
-} from "./chunk-XKT5MHPT.js";
+} from "./chunk-WQG2TYCB.js";
 import "./chunk-AQXETQHW.js";
 import {
   GitHubTracker,
@@ -32,9 +32,10 @@ import {
   getAllTrackers,
   getPrimaryTracker,
   getSecondaryTracker
-} from "./chunk-XFR2DLMR.js";
+} from "./chunk-NTO3EDB3.js";
 import {
   PROVIDERS,
+  clearCredentialFileAuth,
   getAgentCommand,
   getAvailableModels,
   getClaudeModelFlag,
@@ -52,7 +53,7 @@ import {
   saveSettings,
   setupCredentialFileAuth,
   validateSettings
-} from "./chunk-7XNJJBH6.js";
+} from "./chunk-HJSM6E6U.js";
 import {
   findDevrootForProject,
   getDashboardApiUrl,
@@ -177,6 +178,7 @@ export {
   TrackerAuthError,
   addAlias,
   cleanOldBackups,
+  clearCredentialFileAuth,
   createBackup,
   createBackupTimestamp,
   createTracker,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["// Panopticon CLI - Main exports for library usage\nexport * from './lib/paths.js';\nexport * from './lib/config.js';\nexport * from './lib/shell.js';\nexport * from './lib/backup.js';\nexport * from './lib/sync.js';\nexport * from './lib/tracker/index.js';\nexport * from './lib/providers.js';\nexport * from './lib/settings.js';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AACA;AACA;AAKA;AACA;","names":[]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["// Panopticon CLI - Main exports for library usage\nexport * from './lib/paths.js';\nexport * from './lib/config.js';\nexport * from './lib/shell.js';\nexport * from './lib/backup.js';\nexport * from './lib/sync.js';\nexport * from './lib/tracker/index.js';\nexport * from './lib/providers.js';\nexport * from './lib/settings.js';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AACA;AACA;AAKA;AACA;","names":[]}

package/dist/{specialist-context-T3NBMCIE.js → specialist-context-ZC6A4M3I.js}

@@ -1,13 +1,13 @@
 import {
   getRecentRunLogs,
   init_specialist_logs
-} from "./chunk-ASY7T35E.js";
+} from "./chunk-AAFQANKW.js";
 import {
   getModelId,
   init_work_type_router
-} from "./chunk-KJ2TRXNK.js";
+} from "./chunk-FTCPTHIJ.js";
 import "./chunk-JQBV3Q2W.js";
-import "./chunk-7XNJJBH6.js";
+import "./chunk-HJSM6E6U.js";
 import {
   getProject,
   init_projects
@@ -254,4 +254,4 @@ export {
   regenerateContextDigest,
   scheduleDigestGeneration
 };
-//# sourceMappingURL=specialist-context-T3NBMCIE.js.map
+//# sourceMappingURL=specialist-context-ZC6A4M3I.js.map

package/dist/{specialist-logs-CVKD3YJ3.js → specialist-logs-KLGJCEUL.js}

@@ -16,10 +16,10 @@ import {
   isRunLogActive,
   listRunLogs,
   parseLogMetadata
-} from "./chunk-ASY7T35E.js";
-import "./chunk-KJ2TRXNK.js";
+} from "./chunk-AAFQANKW.js";
+import "./chunk-FTCPTHIJ.js";
 import "./chunk-JQBV3Q2W.js";
-import "./chunk-7XNJJBH6.js";
+import "./chunk-HJSM6E6U.js";
 import "./chunk-OMNXYPXC.js";
 import "./chunk-ZTFNYOC7.js";
 import "./chunk-ZHC57RCV.js";
@@ -42,4 +42,4 @@ export {
   listRunLogs,
   parseLogMetadata
 };
-//# sourceMappingURL=specialist-logs-CVKD3YJ3.js.map
+//# sourceMappingURL=specialist-logs-KLGJCEUL.js.map

package/dist/{specialists-TKAP6T6Z.js → specialists-O4HWDJL5.js}

@@ -55,10 +55,10 @@ import {
   wakeSpecialist,
   wakeSpecialistOrQueue,
   wakeSpecialistWithTask
-} from "./chunk-ASY7T35E.js";
-import "./chunk-KJ2TRXNK.js";
+} from "./chunk-AAFQANKW.js";
+import "./chunk-FTCPTHIJ.js";
 import "./chunk-JQBV3Q2W.js";
-import "./chunk-7XNJJBH6.js";
+import "./chunk-HJSM6E6U.js";
 import "./chunk-OMNXYPXC.js";
 import "./chunk-ZTFNYOC7.js";
 import "./chunk-ZHC57RCV.js";
@@ -120,4 +120,4 @@ export {
   wakeSpecialistOrQueue,
   wakeSpecialistWithTask
 };
-//# sourceMappingURL=specialists-TKAP6T6Z.js.map
+//# sourceMappingURL=specialists-O4HWDJL5.js.map

package/dist/{traefik-QX4ZV4YG.js → traefik-QN7R5I6V.js}

@@ -4,7 +4,7 @@ import {
   ensureProjectCerts,
   generatePanopticonTraefikConfig,
   generateTlsConfig
-} from "./chunk-RBUO57TC.js";
+} from "./chunk-PPRFKTVC.js";
 import "./chunk-FQ66DECN.js";
 import "./chunk-OMNXYPXC.js";
 import "./chunk-ZTFNYOC7.js";
@@ -16,4 +16,4 @@ export {
   generatePanopticonTraefikConfig,
   generateTlsConfig
 };
-//# sourceMappingURL=traefik-QX4ZV4YG.js.map
+//# sourceMappingURL=traefik-QN7R5I6V.js.map

package/dist/{workspace-manager-KLHUCIZV.js → workspace-manager-IE4JL2JP.js}

@@ -4,7 +4,7 @@ import {
   preTrustDirectory,
   removeWorkspace,
   stopWorkspaceDocker
-} from "./chunk-PI7Y3PSN.js";
+} from "./chunk-GR6ZZMCX.js";
 import "./chunk-7SN4L4PH.js";
 import "./chunk-AQXETQHW.js";
 import "./chunk-ZTFNYOC7.js";
@@ -19,4 +19,4 @@ export {
   removeWorkspace,
   stopWorkspaceDocker
 };
-//# sourceMappingURL=workspace-manager-KLHUCIZV.js.map
+//# sourceMappingURL=workspace-manager-IE4JL2JP.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "panopticon-cli",
-  "version": "0.4.33",
+  "version": "0.5.0",
   "description": "Multi-agent orchestration for AI coding assistants (Claude Code, Codex, Cursor, Gemini CLI)",
   "keywords": [
     "ai-agents",

package/scripts/stop-hook

@@ -57,5 +57,12 @@ if [ -x "$SPECIALIST_HOOK" ]; then
   "$SPECIALIST_HOOK" &
 fi
 
+# Chain to work-agent completion detection hook
+# Detects when a work agent forgot to call "pan work done" and nudges it
+WORK_AGENT_HOOK="$HOME/.panopticon/bin/work-agent-stop-hook"
+if [ -x "$WORK_AGENT_HOOK" ]; then
+  "$WORK_AGENT_HOOK" &
+fi
+
 # Always exit successfully
 exit 0

package/scripts/work-agent-stop-hook

@@ -0,0 +1,137 @@
+#!/bin/bash
+# ~/.panopticon/bin/work-agent-stop-hook
+# Called when any agent goes idle — detects work agents that forgot "pan work done"
+#
+# Uses a lightweight AI model to analyze the last N lines of terminal output
+# and determine if the agent completed its work but failed to signal completion.
+# If so, sends a nudge message to the agent via tmux.
+#
+# The model used is configurable via PANOPTICON_COMPLETION_CHECK_MODEL env var
+# or defaults to the models.overrides.completion-check-hook setting in config.yaml,
+# falling back to claude-haiku-4-5.
+
+# Don't use set -e - resilient to failures, never break Claude Code execution
+
+# Get agent ID
+if [ -n "$PANOPTICON_AGENT_ID" ]; then
+  AGENT_ID="$PANOPTICON_AGENT_ID"
+elif [ -n "$TMUX" ]; then
+  AGENT_ID=$(tmux display-message -p '#S' 2>/dev/null)
+else
+  exit 0
+fi
+
+# Only run for work agents (agent-min-XXX, agent-pan-XXX, etc.)
+case "$AGENT_ID" in
+  agent-*)
+    # Check it's not a specialist
+    case "$AGENT_ID" in
+      specialist-*) exit 0 ;;
+    esac
+    ;;
+  *)
+    exit 0  # Not a work agent
+    ;;
+esac
+
+# Extract issue ID from agent ID (e.g., "agent-min-725" -> "MIN-725")
+ISSUE_ID=$(echo "$AGENT_ID" | sed 's/^agent-//' | tr '[:lower:]' '[:upper:]')
+
+# Skip if completion marker already exists (agent already called pan work done)
+COMPLETED_FILE="$HOME/.panopticon/agents/$AGENT_ID/completed"
+if [ -f "$COMPLETED_FILE" ]; then
+  exit 0
+fi
+
+# Cooldown: don't nudge more than once per 10 minutes
+NUDGE_FILE="$HOME/.panopticon/agents/$AGENT_ID/.last-completion-nudge"
+if [ -f "$NUDGE_FILE" ]; then
+  LAST_NUDGE=$(cat "$NUDGE_FILE" 2>/dev/null || echo "0")
+  NOW=$(date +%s)
+  ELAPSED=$(( NOW - LAST_NUDGE ))
+  if [ "$ELAPSED" -lt 600 ]; then
+    exit 0  # Too soon since last nudge
+  fi
+fi
+
+# Capture the last 80 lines of terminal output
+OUTPUT=$(tmux capture-pane -t "$AGENT_ID" -p -S -80 2>/dev/null || echo "")
+if [ -z "$OUTPUT" ]; then
+  exit 0
+fi
+
+# Quick heuristic pre-check: skip the expensive AI call if the output clearly
+# shows the agent is mid-work (e.g., running tests, editing files, reading)
+if echo "$OUTPUT" | grep -qE '(Reading|Editing|Searching|Running|Compiling|Building|Installing|●.*Bash|●.*Read|●.*Edit|●.*Grep|●.*Write|●.*Glob)' | tail -5 | grep -qE '●'; then
+  exit 0
+fi
+
+# Check if the agent appears to be at an idle prompt (not mid-response)
+if ! echo "$OUTPUT" | tail -10 | grep -qE '(^❯|Worked for)'; then
+  exit 0  # Agent doesn't appear to be at an idle prompt
+fi
+
+# Determine model to use for completion check
+# Priority: env var > config.yaml override > default
+COMPLETION_MODEL="${PANOPTICON_COMPLETION_CHECK_MODEL:-}"
+if [ -z "$COMPLETION_MODEL" ]; then
+  CONFIG_FILE="$HOME/.panopticon/config.yaml"
+  if [ -f "$CONFIG_FILE" ] && command -v grep &> /dev/null; then
+    COMPLETION_MODEL=$(grep 'completion-check-hook:' "$CONFIG_FILE" 2>/dev/null | awk '{print $2}' | tr -d '"' || echo "")
+  fi
+fi
+COMPLETION_MODEL="${COMPLETION_MODEL:-claude-haiku-4-5}"
+
+# Build the analysis prompt
+ANALYSIS_PROMPT="You are analyzing a work agent's terminal output to determine if it finished its work but forgot to call 'pan work done'.
+
+The agent was working on issue $ISSUE_ID. Here is the last 80 lines of its terminal output:
+
+<terminal_output>
+$OUTPUT
+</terminal_output>
+
+Respond with EXACTLY one of these words (nothing else):
+- FORGOT_COMPLETION — if the agent clearly finished its implementation work (closed beads, committed code, ran tests) but stopped without calling 'pan work done'
+- STILL_WORKING — if the agent appears to have more work to do (mentioned next steps, was mid-task)
+- STOPPED_FOR_INPUT — if the agent stopped because it needs human input or hit a blocker
+- UNCLEAR — if you cannot determine the state"
+
+# Run the analysis using claude CLI (headless, no interactive session)
+RESULT=$(echo "$ANALYSIS_PROMPT" | claude -p --model "$COMPLETION_MODEL" --max-tokens 20 2>/dev/null || echo "UNCLEAR")
+
+# Extract just the verdict (first word of output, strip whitespace)
+VERDICT=$(echo "$RESULT" | tr -d '[:space:]' | head -c 30)
+
+# Log the check
+LOG_DIR="$HOME/.panopticon/logs"
+mkdir -p "$LOG_DIR"
+echo "[$(date -Iseconds)] work-agent-stop-hook: $AGENT_ID ($ISSUE_ID) -> $VERDICT (model: $COMPLETION_MODEL)" \
+  >> "$LOG_DIR/hooks.log" 2>/dev/null || true
+
+if [ "$VERDICT" = "FORGOT_COMPLETION" ]; then
+  # Record nudge timestamp for cooldown
+  mkdir -p "$(dirname "$NUDGE_FILE")"
+  date +%s > "$NUDGE_FILE" 2>/dev/null || true
+
+  # Write the nudge message to a temp file and use load-buffer + paste-buffer
+  # (the reliable tmux message delivery pattern from CLAUDE.md)
+  NUDGE_MSG="You stopped without calling pan work done. If your implementation is complete, you MUST run this command now:
+
+pan work done $ISSUE_ID -c \"Implementation complete\"
+
+If you still have remaining tasks, continue working on them. Do NOT stop until all work is done AND you have called pan work done."
+
+  TMPFILE=$(mktemp)
+  echo "$NUDGE_MSG" > "$TMPFILE"
+  tmux load-buffer "$TMPFILE" 2>/dev/null
+  tmux paste-buffer -t "$AGENT_ID" 2>/dev/null
+  sleep 0.3
+  tmux send-keys -t "$AGENT_ID" C-m 2>/dev/null
+  rm -f "$TMPFILE"
+
+  echo "[$(date -Iseconds)] work-agent-stop-hook: Sent completion nudge to $AGENT_ID" \
+    >> "$LOG_DIR/hooks.log" 2>/dev/null || true
+fi
+
+exit 0

package/skills/myn-standards/SKILL.md

@@ -0,0 +1,351 @@
+---
+name: myn-standards
+description: >
+  Mind Your Now coding standards, design system, and component patterns.
+  Auto-applied when writing or reviewing MYN code.
+triggers:
+  - myn component
+  - mind your now
+  - myn styling
+  - myn design
+  - myn frontend
+  - myn ui
+  - notification toast
+  - task card
+  - briefing
+---
+
+# Mind Your Now Design System & Coding Standards
+
+## Brand Identity
+
+### Brand Colors
+
+| Name | Hex | Tailwind Token | Usage |
+|------|-----|----------------|-------|
+| All-Knowing Blu | `#00AEEF` | `brand-blue` | Primary brand, links, CTAs |
+| Yours Truly Blu | `#80D7F7` | `brand-blue-light` | Hover states, light accents |
+| Golden Hour Yellow | `#FFC60B` | `brand-yellow` | Accent, highlights, "now" in wordmark |
+| Midnight Blue | `#0C4064` | `brand-dark` | Headings on light backgrounds |
+
+### Brand Wordmark
+
+```tsx
+<h1>
+  <span className="text-blue-800">mind</span>
+  <span className="font-thin text-blue-200">your</span>
+  <span className="text-yellow-500">now</span>
+</h1>
+```
+
+### Logo
+
+- Asset: `/images/logo-no-text.png` (sun-burst motif)
+- Always paired with the wordmark on splash/auth screens
+
+## Color System
+
+### Semantic Colors
+
+| Token | Light | Dark | Usage |
+|-------|-------|------|-------|
+| `semantic-success` | `#22C55E` | `#4ADE80` | Completed, positive |
+| `semantic-warning` | `#F59E0B` | `#FBBF24` | Attention needed |
+| `semantic-error` | `#EF4444` | `#F87171` | Errors, overdue |
+| `semantic-info` | `#3B82F6` | `#60A5FA` | Informational |
+
+### Priority Colors
+
+| Priority | Hex | Token |
+|----------|-----|-------|
+| Critical | `#EF4444` | `priority-critical` |
+| High | `#F97316` | `priority-high` |
+| Medium | `#EAB308` | `priority-medium` |
+| Low | `#22C55E` | `priority-low` |
+| None | `#6B7280` | `priority-none` |
+
+### MYN Task Type Colors (Methodology)
+
+| Type | Hex | Token |
+|------|-----|-------|
+| Parking Lot | `#F04F23` | `taskType-parkinglot` |
+| Over the Horizon | `#F9913B` | `taskType-overthehorizon` |
+| Critical Now | `#0C803D` | `taskType-critical` |
+| Opportunity Now | `#107CC4` | `taskType-opportunitynow` |
+| Tomorrow | `#854EB1` | `taskType-tomorrow` |
+
+### Shadcn/UI Semantic Tokens (CSS Variables)
+
+```
+--background       Page background (white / slate-950)
+--foreground       Primary text (slate-950 / slate-50)
+--card             Card backgrounds (white / slate-900)
+--muted            Muted backgrounds (slate-100 / slate-800)
+--muted-foreground Secondary text (slate-500 / slate-400)
+--border           Borders (slate-200 / slate-700)
+--primary          Primary actions (blue-600 / blue-500)
+--destructive      Destructive actions (red-600 / red-500)
+--ring             Focus rings (blue-500 / blue-400)
+```
+
+### App Background
+
+- Light: `#eff6ff` (blue-50)
+- Dark: `#0f172a` (slate-900)
+- Surfaces: `#1e293b` dark, `#334155` elevated dark
+
+## Typography
+
+### Font Stack
+
+- **Primary**: Inter (all UI text)
+- **Monospace**: SF Mono, Monaco, Cascadia Code
+- **Accessibility**: Tiresias Infofont, OpenDyslexic3 (user-selectable)
+- All legacy font aliases (Roboto, Lato, Montserrat, SF Pro) map to Inter
+
+### Type Scale
+
+| Token | Size | Weight | Letter Spacing | Usage |
+|-------|------|--------|----------------|-------|
+| `display` | 2.441rem (39px) | 700 | -0.02em | Hero headlines |
+| `h1` | 1.953rem (31px) | 700 | -0.01em | Page titles |
+| `h2` | 1.563rem (25px) | 600 | -0.01em | Section headers |
+| `h3` | 1.25rem (20px) | 600 | -- | Card headers |
+| `body-lg` | 1.125rem (18px) | 400 | -- | Large body text |
+| `body` | 1rem (16px) | 400 | -- | Default body text |
+| `body-sm` | 0.875rem (14px) | 400 | -- | Compact text, task titles |
+| `caption` | 0.75rem (12px) | 400 | -- | Labels, hints |
+| `overline` | 0.625rem (10px) | 600 | 0.1em | Category labels |
+
+### Text Colors
+
+```
+text-foreground         Primary text
+text-muted-foreground   Secondary text, labels, icons
+text-primary            Links, emphasis
+text-destructive        Errors
+text-card-foreground    Text on cards
+```
+
+## Spacing & Layout
+
+### Spacing Scale
+
+Standard Tailwind 4px base: `1`=4px, `2`=8px, `3`=12px, `4`=16px, `6`=24px, `8`=32px
+
+### Common Patterns
+
+```tsx
+// Page container
+<div className="max-w-[1320px] mx-auto pt-4 px-3 sm:px-4 lg:px-6">
+
+// Two-column grid (sidebar visible at xl)
+<div className="grid gap-7 xl:grid-cols-[minmax(0,820px)_420px]">
+
+// Card padding
+p-3   // Compact
+p-4   // Standard
+p-5   // Spacious
+
+// Section gaps
+mt-3  // Between compact sections
+mt-4  // Between standard sections
+gap-2 // Icon + text
+gap-3 // Form elements
+```
+
+### Breakpoints
+
+| Token | Width | Usage |
+|-------|-------|-------|
+| `xxs` | 350px | Small phones |
+| `sm` | 640px | Small tablets |
+| `md` | 768px | Tablets |
+| `lg` | 1024px | Small desktops |
+| `xl` | 1280px | Desktop (sidebar visible) |
+
+## Border & Shadow
+
+### Border Radius
+
+```
+rounded-md   (6px)  Buttons, inputs, small cards
+rounded-lg   (8px)  Cards, panels
+rounded-xl   (12px) Large cards, modals
+rounded-full        Pills, avatars
+```
+
+### Shadows
+
+```
+shadow-sm   Sidebar cards, secondary
+shadow-md   Main cards, primary content
+shadow-lg   Dropdowns, modals
+shadow-xl   Popovers, overlays
+shadow-2xl  Dialogs
+```
+
+### Opacity Modifiers
+
+```tsx
+bg-muted/40         // Very subtle containers
+border-border/50    // Container borders (default)
+border-border/60    // Button/input borders
+ring-ring/40        // Focus state ring
+```
+
+## Component Patterns
+
+### Buttons
+
+| Size | Height | Padding | Icon | Usage |
+|------|--------|---------|------|-------|
+| xs | `h-7` | `px-2` | `h-3.5 w-3.5` | Inline actions |
+| sm | `h-8` | `px-3` | `h-4 w-4` | Secondary actions |
+| md | `h-9` | `px-3` | `h-4 w-4` | Icon buttons |
+| lg | `h-10` | `px-4` | `h-5 w-5` | Primary actions |
+
+```tsx
+// Primary
+"h-10 px-4 rounded-md bg-primary text-primary-foreground hover:opacity-90"
+
+// Secondary
+"h-10 px-4 rounded-md border border-border/60 bg-card hover:bg-muted"
+
+// Ghost
+"h-9 px-3 rounded-md hover:bg-muted"
+
+// Icon
+"h-9 w-9 rounded-md hover:bg-muted text-muted-foreground"
+```
+
+### Cards
+
+```tsx
+// Main card (primary, higher elevation)
+<Card className="bg-card text-card-foreground rounded-lg shadow-md">
+
+// Sidebar card (secondary, lower)
+<Card className="bg-card text-card-foreground rounded-lg shadow-sm">
+
+// Subtle container
+<div className="rounded-md border border-border/50 bg-muted/40 px-3 py-2">
+```
+
+### Frosted Glass (Auth/Splash Screens)
+
+```tsx
+// Blue gradient background
+style={{ background: 'linear-gradient(to bottom, rgb(56, 189, 248), rgb(37, 99, 235))' }}
+
+// Frosted glass card
+<Card className="bg-white/90 backdrop-blur-sm border-blue-200 hover:shadow-lg transition-all duration-300">
+```
+
+### Toast Notifications
+
+Current implementation uses Radix UI `@radix-ui/react-toast` with CVA variants:
+
+```tsx
+// Variants: default, destructive, success, error, warning, info
+// Base style:
+"rounded-lg border-2 p-5 pr-7 shadow-xl backdrop-blur-sm"
+
+// Each variant has light/dark mode colors:
+// success: border-green-300 bg-green-50/95 text-green-900
+// error:   border-red-300 bg-red-50/95 text-red-900
+// warning: border-amber-300 bg-amber-50/95 text-amber-900
+// info:    border-blue-300 bg-blue-50/95 text-blue-900
+
+// Viewport: bottom-right on desktop, top on mobile
+// Max width: 420px
+// Animations: slide-in-from-top (mobile), slide-in-from-bottom (desktop)
+// Hover: shadow-2xl + translate-y-0.5 lift
+// Icons: Lucide (CheckCircle2, AlertCircle, AlertTriangle, Info) in rounded-full bg
+// Close: absolute top-right, visible on hover
+```
+
+### Form Controls
+
+```tsx
+// Input
+"h-10 rounded-md border border-border/60 bg-card px-3 text-sm focus:ring-2 focus:ring-ring/40"
+
+// Textarea
+"rounded-md border border-border/60 bg-card p-3 text-sm min-h-[80px] focus:ring-2 focus:ring-ring/40"
+```
+
+## Animation System
+
+### Tailwind Keyframes
+
+| Name | Duration | Usage |
+|------|----------|-------|
+| `wiggle` | 1s infinite | Playful attention |
+| `fade-in` | 0.5s ease-out | Element entrance (translateY 10px) |
+| `spin-slow` | 3s linear infinite | Loading states |
+| `pulse-subtle` | 2s infinite | Gentle pulse (opacity 1→0.9) |
+| `shimmer` | 2s linear infinite | Loading skeleton |
+| `bounce-once` | 1s ease | Single bounce |
+
+### Framer Motion (Auth/Splash)
+
+```tsx
+// Container: stagger children by 0.1s
+const containerVariants = {
+  hidden: { opacity: 0 },
+  visible: { opacity: 1, transition: { staggerChildren: 0.1 } },
+}
+
+// Items: spring up from 20px below
+const itemVariants = {
+  hidden: { y: 20, opacity: 0 },
+  visible: { y: 0, opacity: 1, transition: { type: 'spring', stiffness: 50 } },
+}
+```
+
+### Task Completion
+
+- Wavy green SVG strikethrough line + text fade
+- 2s animation duration
+- Do NOT modify sort logic in `sortTasksAndEvents.js`
+
+## Design Principles
+
+1. **Neutral Over Saturated** -- Use muted backgrounds, subtle borders. No saturated gradients for secondary elements.
+2. **Elevation Hierarchy** -- Primary content gets `shadow-md`, secondary gets `shadow-sm`.
+3. **Progressive Disclosure** -- Hide secondary actions until hover/focus.
+4. **Density Over Chrome** -- Tight padding, compact buttons, reduce visual noise.
+
+## Tech Stack
+
+- **Framework**: React 19, Vite 7, TypeScript
+- **State**: Jotai (client) + TanStack Query (server)
+- **UI**: shadcn/ui (new-york style) + Material-UI (legacy, migrating away)
+- **Styling**: Tailwind CSS with custom design tokens
+- **Icons**: Lucide (primary), FontAwesome (legacy, GettingStarted only)
+- **Animation**: Framer Motion (auth flows), Tailwind keyframes (in-app)
+- **Mobile**: Capacitor for iOS/Android
+- **Dark Mode**: `class` strategy via Tailwind `darkMode: 'class'`
+
+## File Structure
+
+```
+src/
+  styles/
+    design-tokens.css        CSS custom properties (brand, semantic, priority, task type)
+    notification-animations.css  Toast animation keyframes
+    globals.css              shadcn/ui CSS variables
+  components/
+    ui/                      shadcn/ui base components (toast, card, button, etc.)
+    auth/                    Auth flows (GettingStarted, EmailForm)
+    notifications/           NotificationItem, notification panels
+  lib/
+    utils.ts                 cn() helper (clsx + tailwind-merge)
+```
+
+## Key Files
+
+- `tailwind.config.js` -- All design tokens, type scale, colors, animations
+- `src/styles/design-tokens.css` -- CSS custom properties with dark mode overrides
+- `docs/technical/frontend/UI-DESIGN-SYSTEM.md` -- Full design system documentation