panopticon-cli 0.4.32 → 0.5.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

package/skills/pan-reopen/SKILL.md

@@ -0,0 +1,65 @@
+---
+name: pan-reopen
+description: Reopen a completed issue for re-work. Resets specialist states, removes from queues, and prepares workspace for a new implementation cycle.
+triggers:
+  - reopen issue
+  - reopen PAN-
+  - issue needs re-work
+  - re-open this issue
+  - reset specialist status
+  - reopen for rework
+  - issue was closed but needs work
+---
+
+# Reopen Issue for Re-Work
+
+Use this skill when an issue needs to be re-worked after being marked done, when review feedback requires significant new work, or when a merged fix turns out to be incomplete.
+
+## What Reopen Does
+
+1. **Moves tracker status** to "In Progress" (not Backlog — agent resumes with existing plan)
+2. **Resets specialist states** — review/test/merge status → pending
+3. **Removes queue items** — clears any stale entries from specialist queues
+4. **Updates STATE.md** — appends a "Reopened" section with context
+5. **Fetches tracker comments** — injects latest feedback into STATE.md
+
+## When to Use
+
+- Issue was marked Done but follow-up work is needed
+- Review passed but post-merge testing found regressions
+- User requested changes after review
+- Agent fast-pathed to done on restart (STATE.md said "complete")
+
+## How to Reopen
+
+### Via CLI (recommended for agents/supervisors)
+```bash
+pan work reopen PAN-123
+# With explicit reason:
+pan work reopen PAN-123 --reason "Post-merge regression in auth flow"
+# Skip confirmation prompt:
+pan work reopen PAN-123 --force
+```
+
+### Via Dashboard API
+```bash
+curl -X POST http://localhost:3011/api/issues/PAN-123/reopen \
+  -H "Content-Type: application/json" \
+  -d '{"reason": "Post-merge regression found"}'
+```
+
+### Via Dashboard UI
+Click the **Reopen** button in the WorkspacePanel (visible when review/test has passed or issue is merged).
+
+## After Reopening
+
+1. The issue is now "In Progress" in the tracker
+2. Specialist states are all `pending`
+3. STATE.md has a new "Reopened" section with context and tracker comments
+4. Start the agent normally: `pan work PAN-123`
+
+The agent will read STATE.md, see the "Reopened" section, and resume work based on the tracker context rather than fast-pathing to done.
+
+## Do NOT Use `pan work done` Until Re-Work Is Complete
+
+After reopening, the agent must complete the requested changes, pass tests, and go through review again before signaling `pan work done`.

package/skills/pan-sync-main/SKILL.md

@@ -0,0 +1,87 @@
+---
+name: pan-sync-main
+description: Sync latest main into a workspace's feature branch via git merge. Use when a hotfix has been merged to main and active workspaces need to pick up the changes.
+triggers:
+  - sync with main
+  - sync main into workspace
+  - pull in hotfix
+  - merge main into branch
+  - pan sync-main
+  - get latest changes from main
+allowed-tools:
+  - Bash
+  - Read
+---
+
+# Sync with Main
+
+Merges the latest `main` branch into a workspace's feature branch. Uses `git merge` (not rebase) to avoid rewriting history, and delegates conflict resolution to the merge-agent specialist.
+
+## Usage
+
+```bash
+# CLI command
+pan work sync-main PAN-XXX
+
+# Or via the dashboard API
+curl -X POST http://localhost:3011/api/workspaces/PAN-XXX/sync-main
+```
+
+## What It Does
+
+1. Checks for uncommitted changes (blocks if any — must commit or stash first)
+2. Cleans up any stale git locks
+3. Runs `git fetch origin main`
+4. Runs `git merge origin/main`
+5. If clean merge: reports commit count and changed files
+6. If conflicts: wakes the merge-agent specialist to resolve them
+7. After conflict resolution: scans for leftover markers, then reports result
+
+## Outcomes
+
+| Result | Meaning |
+|--------|---------|
+| Already up to date | Main has no new commits since last sync |
+| Success (N commits) | Clean merge or agent-resolved conflicts |
+| Uncommitted changes | Commit or stash workspace changes first |
+| Conflict (unresolvable) | Agent could not resolve — merge aborted, workspace unchanged |
+
+## Design Decisions
+
+- **Merge, not rebase** — Rebase rewrites SHAs and requires force-push. Merge commits serve as audit markers.
+- **No tests/builds** — Feature branch is WIP. Running tests after sync would fail on pre-existing issues.
+- **No push to remote** — This is a local workspace operation only.
+- **All-or-nothing for polyrepo** — If any repo fails, all are aborted (not implemented yet; sync is per-workspace).
+
+## Examples
+
+```bash
+# Sync PAN-123 workspace with latest main
+pan work sync-main PAN-123
+
+# Output on success:
+# ✓ Synced 3 commit(s) from main
+#   Commits merged: 3
+#   Changed files (5):
+#     src/lib/auth.ts
+#     src/lib/config.ts
+#     ...
+
+# Output when already current:
+# ✓ PAN-123 is already up to date with main
+
+# Output on uncommitted changes (blocks):
+# ✗ Sync failed: Workspace has uncommitted changes. Commit or stash them before syncing with main.
+```
+
+## Dashboard
+
+The "Sync with Main" button appears in the workspace detail panel:
+- In the **Git Status** section as a small "Sync" button next to the branch name (disabled if uncommitted changes)
+- In the **Actions** section as a full "Sync with Main" button
+
+## Related Commands
+
+- `pan work approve <id>` — Review and merge to main
+- `pan work request-review <id>` — Trigger review pipeline
+- `pan work tell <id> "<message>"` — Send message to agent

package/skills/pan-tldr/SKILL.md

@@ -0,0 +1,149 @@
+---
+name: pan-tldr
+description: TLDR code analysis — token-efficient codebase understanding. Use before reading large files.
+triggers:
+  - tldr
+  - code analysis
+  - understand codebase
+  - explore code
+  - what does this file do
+allowed-tools:
+  - Bash
+  - Read
+  - Grep
+  - Glob
+---
+
+# TLDR Code Analysis
+
+## What It Is
+
+TLDR is a 5-layer code analysis tool that produces structured summaries using 500-1,200 tokens per file instead of 10-25k for raw reads. It extends how much work you can accomplish per session by 10-20x.
+
+## When to Use TLDR
+
+**Always use TLDR first when:**
+- Exploring unfamiliar code (use `tldr context` or `tldr structure`)
+- Understanding function relationships (use `tldr calls` or `tldr impact`)
+- Searching code by description (use `tldr semantic`)
+- Planning changes across multiple files
+
+**Read the full file when:**
+- You need exact line numbers for editing
+- The file is small (< 3KB)
+- You need config files, docs, or non-code files
+- TLDR context wasn't sufficient for the specific section
+
+## Decision Tree
+
+```
+Need to understand a file?
+├── Small file (< 3KB) → Read directly
+├── Need exact content for editing → Read with offset/limit
+└── Understanding structure/relationships → Use TLDR first
+    ├── "What does this file export?" → tldr context <file>
+    ├── "What's in this directory?" → tldr structure <dir>
+    ├── "What calls this function?" → tldr calls <func> <file>
+    ├── "What does this function call?" → tldr impact <func> <file>
+    ├── "Find code that handles X" → tldr semantic "X"
+    └── "Show me the architecture" → tldr arch <dir>
+```
+
+## Available Commands
+
+All commands run from the workspace root. The binary is at `.venv/bin/tldr`.
+
+### Exploration
+
+| Command | Purpose | Tokens |
+|---------|---------|--------|
+| `tldr context <file>` | File structure, exports, imports, key functions | ~800 |
+| `tldr structure <dir>` | Directory layout and relationships | ~500 |
+| `tldr tree <dir>` | File tree with language detection | ~200 |
+| `tldr arch <dir>` | Architectural overview | ~600 |
+
+### Relationships
+
+| Command | Purpose | Tokens |
+|---------|---------|--------|
+| `tldr calls <file>` | What calls functions in this file (callers) | ~400 |
+| `tldr impact <func> <file>` | What this function calls (callees) | ~400 |
+| `tldr imports <file>` | What this file imports | ~200 |
+| `tldr importers <file>` | What files import this one | ~200 |
+
+### Analysis
+
+| Command | Purpose | Tokens |
+|---------|---------|--------|
+| `tldr cfg <func> <file>` | Control flow graph | ~300 |
+| `tldr dfg <func> <file>` | Data flow graph | ~300 |
+| `tldr slice <func> <file>` | Program slice (dependency chain) | ~400 |
+| `tldr dead <dir>` | Dead code detection | ~500 |
+| `tldr change-impact <file>` | Files affected by changes to this file | ~300 |
+| `tldr diagnostics <file>` | Type errors and lint issues | ~200 |
+
+### Search
+
+| Command | Purpose | Tokens |
+|---------|---------|--------|
+| `tldr search <pattern> <dir>` | Structural code search (AST-aware) | ~400 |
+| `tldr semantic "query"` | Natural language code search (embedding-based) | ~500 |
+| `tldr extract <symbol> <file>` | Extract specific function/class definition | ~300 |
+
+## MCP Tools (if configured)
+
+When TLDR is set up as an MCP server, Claude Code agents get these tools natively:
+- `tldr_context <file>` — File structure overview
+- `tldr_structure <directory>` — Directory layout
+- `tldr_calls <function> <file>` — Call graph (callers)
+- `tldr_impact <function> <file>` — Impact analysis (callees)
+- `tldr_semantic <query>` — Natural language search
+
+## Hook Integration
+
+TLDR hooks run automatically:
+
+- **Read enforcer** (PreToolUse): Intercepts reads on large code files (> 3KB) and returns TLDR summaries instead. To read the full file, use `Read` with `offset` and `limit` parameters.
+- **Post-edit notify** (PostToolUse): Tracks edited files and triggers background re-warm after 10 edits to keep the index fresh.
+
+## Index Management
+
+```bash
+# Check index status
+pan tldr status
+
+# Manually warm/rebuild the index
+pan tldr warm
+
+# Start/stop the daemon
+pan tldr start
+pan tldr stop
+```
+
+The index is built automatically:
+- On workspace creation (background warm after daemon start)
+- After merges to main (merge-agent triggers re-warm)
+- After 10 code file edits (post-edit hook triggers re-warm)
+- On `pan up` (main daemon starts)
+
+## Token Savings Example
+
+```
+Without TLDR:
+  20 files x 15,000 tokens = 300,000 tokens (exhausts context)
+
+With TLDR:
+  20 files x 800 tokens = 16,000 tokens (94% savings)
+  + 3 full reads for editing = 45,000 tokens
+  Total: 61,000 tokens — can do 5x more work per session
+```
+
+## Troubleshooting
+
+| Symptom | Fix |
+|---------|-----|
+| `tldr: command not found` | Run from workspace root: `.venv/bin/tldr` |
+| No `.venv` directory | `python3 -m venv .venv && .venv/bin/pip install llm-tldr` |
+| Stale index | `pan tldr warm` or `.venv/bin/tldr warm .` |
+| Empty results | Check `.tldrignore` isn't excluding your files |
+| Daemon not running | `pan tldr start` or it auto-starts with `pan up` |