panopticon-cli 0.3.2 → 0.3.4

package/README.md

@@ -340,6 +340,44 @@ Cloister manages specialized agents that handle specific phases of the developme
 | **review-agent** | Code review before merge | After tests pass (manual trigger) |
 | **merge-agent** | Handles git merge and conflict resolution | "Approve & Merge" button |
 
+#### Merge Agent Workflow
+
+The merge-agent is a specialist that handles **ALL** merges, not just conflicts. This ensures:
+- It sees all code changes coming through the pipeline
+- It builds context about the codebase over time
+- When conflicts DO occur, it has better understanding for intelligent resolution
+- Tests are always run before completing the merge
+
+**Workflow:**
+
+1. **Pull latest main** - Ensures local main is up-to-date
+2. **Analyze incoming changes** - Reviews what the feature branch contains
+3. **Perform merge** - Merges feature branch into main
+4. **Resolve conflicts** - If conflicts exist, uses AI to resolve them intelligently
+5. **Run tests** - Verifies the merge didn't break anything
+6. **Commit merge** - Commits the merge with descriptive message
+7. **Report results** - Returns success/failure with details
+
+**Triggering merge-agent:**
+
+```bash
+# Via dashboard - click "Approve & Merge" on an issue card
+# merge-agent is ALWAYS invoked, regardless of whether conflicts exist
+
+# Via CLI
+pan specialists wake merge-agent --issue MIN-123
+```
+
+The merge-agent uses a specialized prompt template that instructs it to:
+- Never force-push
+- Always run tests before completing
+- Document conflict resolution decisions
+- Provide detailed feedback on what was merged
+
+#### Specialist Auto-Initialization
+
+When Cloister starts, it automatically initializes specialists that don't exist yet. This ensures the test-agent, review-agent, and merge-agent are ready to receive wake signals without manual setup.
+
 ### Automatic Handoffs
 
 Cloister detects situations that require intervention:
@@ -349,8 +387,55 @@ Cloister detects situations that require intervention:
 | **stuck_escalation** | No activity for 30+ minutes | Escalate to more capable model |
 | **complexity_upgrade** | Task complexity exceeds model capability | Route to Opus |
 | **implementation_complete** | Agent signals work is done | Wake test-agent |
+| **test_failure** | Tests fail repeatedly | Escalate model or request help |
+| **planning_complete** | Planning session finishes | Transition to implementation |
 | **merge_requested** | User clicks "Approve & Merge" | Wake merge-agent |
 
+### Handoff Methods
+
+Cloister supports two handoff methods, automatically selected based on agent type:
+
+| Method | When Used | How It Works |
+|--------|-----------|--------------|
+| **Kill & Spawn** | General agents (agent-min-123, etc.) | 1. Captures full context (STATE.md, beads, git state)<br>2. Kills tmux session<br>3. Spawns new agent with handoff prompt<br>4. New agent continues work with preserved context |
+| **Specialist Wake** | Permanent specialists (merge-agent, test-agent) | 1. Captures handoff context<br>2. Sends wake message to existing session<br>3. Specialist resumes with context injection |
+
+**Kill & Spawn** is used for temporary agents that work on specific issues. It creates a clean handoff by:
+- Capturing the agent's current understanding (from STATE.md)
+- Preserving beads task progress and open items
+- Including relevant git diff and file context
+- Building a comprehensive handoff prompt for the new model
+
+**Specialist Wake** is used for permanent specialists that persist across multiple issues. It avoids the overhead of killing/respawning by injecting context into the existing session.
+
+### Handoff Context Capture
+
+When a handoff occurs, Cloister captures:
+
+```json
+{
+  "agentId": "agent-min-123",
+  "issueId": "MIN-123",
+  "currentModel": "sonnet",
+  "targetModel": "opus",
+  "reason": "stuck_escalation",
+  "handoffCount": 1,
+  "state": {
+    "phase": "implementation",
+    "complexity": "complex",
+    "lastActivity": "2024-01-22T10:30:00-08:00"
+  },
+  "beadsTasks": [...],
+  "gitContext": {
+    "branch": "feature/min-123",
+    "uncommittedChanges": ["src/auth.ts", "src/tests/auth.test.ts"],
+    "recentCommits": [...]
+  }
+}
+```
+
+Handoff prompts are saved to `~/.panopticon/agents/{agent-id}/handoffs/` for debugging.
+
 ### Heartbeat Monitoring
 
 Agents send heartbeats via Claude Code hooks. Cloister tracks:
@@ -373,6 +458,41 @@ Heartbeat files are stored in `~/.panopticon/heartbeats/`:
 }
 ```
 
+### Heartbeat Hook Installation
+
+The heartbeat hook is automatically synced to `~/.panopticon/bin/heartbeat-hook` via `pan sync`. It's also installed automatically when you install or upgrade Panopticon via npm.
+
+**Manual installation:**
+```bash
+pan sync  # Syncs all skills, agents, AND hooks
+```
+
+**Hook configuration in `~/.claude/settings.json`:**
+```json
+{
+  "hooks": {
+    "PostToolUse": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "~/.panopticon/bin/heartbeat-hook"
+          }
+        ]
+      }
+    ]
+  }
+}
+```
+
+**Hook resilience:** The heartbeat hook is designed to fail silently if:
+- The heartbeats directory doesn't exist
+- Write permissions are missing
+- The hook script has errors
+
+This prevents hook failures from interrupting agent work.
+
 ### Configuration
 
 Cloister configuration lives in `~/.panopticon/cloister/config.json`:
@@ -398,6 +518,77 @@ Cloister configuration lives in `~/.panopticon/cloister/config.json`:
 
 ---
 
+## Model Routing & Complexity Detection
+
+Cloister automatically routes tasks to the appropriate model based on detected complexity, optimizing for cost while ensuring quality.
+
+### Complexity Levels
+
+| Level | Model | Use Case |
+|-------|-------|----------|
+| **trivial** | Haiku | Typos, comments, documentation updates |
+| **simple** | Haiku | Small fixes, test additions, minor changes |
+| **medium** | Sonnet | Features, components, integrations |
+| **complex** | Sonnet/Opus | Refactors, migrations, redesigns |
+| **expert** | Opus | Architecture, security, performance optimization |
+
+### Complexity Detection Signals
+
+Complexity is detected from multiple signals (in priority order):
+
+1. **Explicit field** - Task has a `complexity` field set (e.g., in beads)
+2. **Labels/tags** - Issue labels like `architecture`, `security`, `refactor`
+3. **Keywords** - Title/description contains keywords like "migration", "overhaul"
+4. **File count** - Number of files changed (>20 files = complex)
+5. **Time estimate** - If estimate exceeds thresholds
+
+**Keyword patterns:**
+```javascript
+{
+  trivial: ['typo', 'rename', 'comment', 'documentation', 'readme'],
+  simple: ['add comment', 'update docs', 'fix typo', 'small fix'],
+  medium: ['feature', 'endpoint', 'component', 'service'],
+  complex: ['refactor', 'migration', 'redesign', 'overhaul'],
+  expert: ['architecture', 'security', 'performance optimization']
+}
+```
+
+### Configuring Model Routing
+
+Edit `~/.panopticon/cloister/config.json`:
+
+```json
+{
+  "model_selection": {
+    "default_model": "sonnet",
+    "complexity_routing": {
+      "trivial": "haiku",
+      "simple": "haiku",
+      "medium": "sonnet",
+      "complex": "sonnet",
+      "expert": "opus"
+    }
+  }
+}
+```
+
+### Cost Optimization
+
+Model routing helps optimize costs:
+
+| Model | Relative Cost | Best For |
+|-------|---------------|----------|
+| Haiku | 1x (cheapest) | Simple tasks, bulk operations |
+| Sonnet | 3x | Most development work |
+| Opus | 15x | Complex architecture, critical fixes |
+
+A typical agent run might:
+1. Start on Haiku for initial exploration
+2. Escalate to Sonnet for implementation
+3. Escalate to Opus only if stuck or complexity detected
+
+---
+
 ## Multi-Project Support
 
 Panopticon supports managing multiple projects with intelligent issue routing.
@@ -462,9 +653,22 @@ pan sync --dry-run    # Preview what will be synced
 pan doctor            # Check system health
 pan skills            # List available skills
 pan status            # Show running agents
+pan up                # Start dashboard (Docker or minimal)
+pan down              # Stop dashboard and services
 ```
 
-> **Note:** `pan sync` now automatically syncs heartbeat hooks to `~/.panopticon/bin/`. This happens automatically on `npm install/upgrade` as well.
+#### What `pan sync` Does
+
+`pan sync` synchronizes Panopticon assets to all supported AI tools:
+
+| Asset Type | Source | Destinations |
+|------------|--------|--------------|
+| **Skills** | `~/.panopticon/skills/` | `~/.claude/skills/`, `~/.codex/skills/`, `~/.gemini/skills/` |
+| **Agents** | `~/.panopticon/agents/*.md` | `~/.claude/agents/` |
+| **Commands** | `~/.panopticon/commands/` | `~/.claude/commands/` |
+| **Hooks** | `src/hooks/` (in package) | `~/.panopticon/bin/` |
+
+**Automatic sync:** Hooks are also synced automatically when you install or upgrade Panopticon via npm (`postinstall` hook).
 
 ### Agent Management
 
@@ -1029,6 +1233,7 @@ This ensures every Panopticon-managed project has a well-defined canonical PRD t
       hook.json         # GUPP work queue
       cv.json           # Work history
       mail/             # Incoming messages
+      handoffs/         # Handoff prompts (for debugging)
 
   cloister/             # Cloister AI lifecycle manager
     config.json         # Cloister settings
@@ -1038,6 +1243,9 @@ This ensures every Panopticon-managed project has a well-defined canonical PRD t
   heartbeats/           # Real-time agent activity
     agent-min-123.json  # Last heartbeat from agent
 
+  logs/                 # Log files
+    handoffs.jsonl      # All handoff events (for analytics)
+
   costs/                # Raw cost logs (JSONL)
   backups/              # Sync backups
   traefik/              # Traefik reverse proxy config
@@ -1045,6 +1253,36 @@ This ensures every Panopticon-managed project has a well-defined canonical PRD t
     certs/              # TLS certificates
 ```
 
+### Agent State Management
+
+Each agent's state is tracked in `~/.panopticon/agents/{agent-id}/state.json`:
+
+```json
+{
+  "id": "agent-min-123",
+  "issueId": "MIN-123",
+  "workspace": "/home/user/projects/myapp/workspaces/feature-min-123",
+  "branch": "feature/min-123",
+  "phase": "implementation",
+  "model": "sonnet",
+  "complexity": "medium",
+  "handoffCount": 0,
+  "sessionId": "abc123",
+  "createdAt": "2024-01-22T10:00:00-08:00",
+  "updatedAt": "2024-01-22T10:30:00-08:00"
+}
+```
+
+| Field | Description |
+|-------|-------------|
+| `phase` | Current work phase: `planning`, `implementation`, `testing`, `review`, `merging` |
+| `model` | Current model: `haiku`, `sonnet`, `opus` |
+| `complexity` | Detected complexity: `trivial`, `simple`, `medium`, `complex`, `expert` |
+| `handoffCount` | Number of times the agent has been handed off to a different model |
+| `sessionId` | Claude Code session ID (for resuming after handoff) |
+
+**State Cleanup:** When an agent is killed or aborted (`pan work kill`), Panopticon automatically cleans up its state files to prevent stale data from affecting future runs.
+
 ## Health Monitoring (Deacon Pattern)
 
 Panopticon implements the Deacon pattern for stuck agent detection:

package/dist/{chunk-PSJRCUOA.js → chunk-BH6BR26M.js}

@@ -1,12 +1,8 @@
 import {
-  PANOPTICON_HOME,
-  init_esm_shims,
-  init_paths
-} from "./chunk-SG7O6I7R.js";
+  PANOPTICON_HOME
+} from "./chunk-P5TQ5C3J.js";
 
 // src/lib/projects.ts
-init_esm_shims();
-init_paths();
 import { existsSync, readFileSync, writeFileSync, mkdirSync } from "fs";
 import { join } from "path";
 import { parse as parseYaml, stringify as stringifyYaml } from "yaml";
@@ -174,4 +170,4 @@ export {
   createDefaultProjectsConfig,
   initializeProjectsConfig
 };
-//# sourceMappingURL=chunk-PSJRCUOA.js.map
+//# sourceMappingURL=chunk-BH6BR26M.js.map

package/dist/{chunk-PSJRCUOA.js.map → chunk-BH6BR26M.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/lib/projects.ts"],"sourcesContent":["/**\n * Project Registry - Multi-project support for Panopticon\n *\n * Maps Linear team prefixes and labels to project paths for workspace creation.\n */\n\nimport { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs';\nimport { join } from 'path';\nimport { parse as parseYaml, stringify as stringifyYaml } from 'yaml';\nimport { PANOPTICON_HOME } from './paths.js';\n\nexport const PROJECTS_CONFIG_FILE = join(PANOPTICON_HOME, 'projects.yaml');\n\n/**\n * Issue routing rule - routes issues with certain labels to specific paths\n */\nexport interface IssueRoutingRule {\n  labels?: string[];\n  default?: boolean;\n  path: string;\n}\n\n/**\n * Project configuration\n */\nexport interface ProjectConfig {\n  name: string;\n  path: string;\n  linear_team?: string;\n  issue_routing?: IssueRoutingRule[];\n}\n\n/**\n * Full projects configuration file\n */\nexport interface ProjectsConfig {\n  projects: Record<string, ProjectConfig>;\n}\n\n/**\n * Resolved project info for workspace creation\n */\nexport interface ResolvedProject {\n  projectKey: string;\n  projectName: string;\n  projectPath: string;\n  linearTeam?: string;\n}\n\n/**\n * Load projects configuration from ~/.panopticon/projects.yaml\n */\nexport function loadProjectsConfig(): ProjectsConfig {\n  if (!existsSync(PROJECTS_CONFIG_FILE)) {\n    return { projects: {} };\n  }\n\n  try {\n    const content = readFileSync(PROJECTS_CONFIG_FILE, 'utf-8');\n    const config = parseYaml(content) as ProjectsConfig;\n    return config || { projects: {} };\n  } catch (error: any) {\n    console.error(`Failed to parse projects.yaml: ${error.message}`);\n    return { projects: {} };\n  }\n}\n\n/**\n * Save projects configuration\n */\nexport function saveProjectsConfig(config: ProjectsConfig): void {\n  const dir = PANOPTICON_HOME;\n  if (!existsSync(dir)) {\n    mkdirSync(dir, { recursive: true });\n  }\n\n  const yaml = stringifyYaml(config, { indent: 2 });\n  writeFileSync(PROJECTS_CONFIG_FILE, yaml, 'utf-8');\n}\n\n/**\n * Get a list of all registered projects\n */\nexport function listProjects(): Array<{ key: string; config: ProjectConfig }> {\n  const config = loadProjectsConfig();\n  return Object.entries(config.projects).map(([key, projectConfig]) => ({\n    key,\n    config: projectConfig,\n  }));\n}\n\n/**\n * Add or update a project in the registry\n */\nexport function registerProject(key: string, projectConfig: ProjectConfig): void {\n  const config = loadProjectsConfig();\n  config.projects[key] = projectConfig;\n  saveProjectsConfig(config);\n}\n\n/**\n * Remove a project from the registry\n */\nexport function unregisterProject(key: string): boolean {\n  const config = loadProjectsConfig();\n  if (config.projects[key]) {\n    delete config.projects[key];\n    saveProjectsConfig(config);\n    return true;\n  }\n  return false;\n}\n\n/**\n * Extract Linear team prefix from an issue ID\n * E.g., \"MIN-123\" -> \"MIN\", \"PAN-456\" -> \"PAN\"\n */\nexport function extractTeamPrefix(issueId: string): string | null {\n  const match = issueId.match(/^([A-Z]+)-\\d+$/i);\n  return match ? match[1].toUpperCase() : null;\n}\n\n/**\n * Find project by Linear team prefix\n */\nexport function findProjectByTeam(teamPrefix: string): ProjectConfig | null {\n  const config = loadProjectsConfig();\n\n  for (const [, projectConfig] of Object.entries(config.projects)) {\n    if (projectConfig.linear_team?.toUpperCase() === teamPrefix.toUpperCase()) {\n      return projectConfig;\n    }\n  }\n\n  return null;\n}\n\n/**\n * Resolve the correct project path for an issue based on labels\n *\n * @param project - The project config\n * @param labels - Array of label names from the Linear issue\n * @returns The resolved path (may differ from project.path based on routing rules)\n */\nexport function resolveProjectPath(project: ProjectConfig, labels: string[] = []): string {\n  if (!project.issue_routing || project.issue_routing.length === 0) {\n    return project.path;\n  }\n\n  // Normalize labels to lowercase for comparison\n  const normalizedLabels = labels.map(l => l.toLowerCase());\n\n  // First, check label-based routing rules\n  for (const rule of project.issue_routing) {\n    if (rule.labels && rule.labels.length > 0) {\n      const ruleLabels = rule.labels.map(l => l.toLowerCase());\n      const hasMatch = ruleLabels.some(label => normalizedLabels.includes(label));\n      if (hasMatch) {\n        return rule.path;\n      }\n    }\n  }\n\n  // Then, find default rule\n  for (const rule of project.issue_routing) {\n    if (rule.default) {\n      return rule.path;\n    }\n  }\n\n  // Fall back to project path\n  return project.path;\n}\n\n/**\n * Resolve project from an issue ID (and optional labels)\n *\n * @param issueId - Linear issue ID (e.g., \"MIN-123\")\n * @param labels - Optional array of label names\n * @returns Resolved project info or null if not found\n */\nexport function resolveProjectFromIssue(\n  issueId: string,\n  labels: string[] = []\n): ResolvedProject | null {\n  const teamPrefix = extractTeamPrefix(issueId);\n  if (!teamPrefix) {\n    return null;\n  }\n\n  const config = loadProjectsConfig();\n\n  // Find project by team prefix\n  for (const [key, projectConfig] of Object.entries(config.projects)) {\n    if (projectConfig.linear_team?.toUpperCase() === teamPrefix) {\n      const resolvedPath = resolveProjectPath(projectConfig, labels);\n      return {\n        projectKey: key,\n        projectName: projectConfig.name,\n        projectPath: resolvedPath,\n        linearTeam: projectConfig.linear_team,\n      };\n    }\n  }\n\n  return null;\n}\n\n/**\n * Get a project by key\n */\nexport function getProject(key: string): ProjectConfig | null {\n  const config = loadProjectsConfig();\n  return config.projects[key] || null;\n}\n\n/**\n * Check if projects.yaml exists and has any projects\n */\nexport function hasProjects(): boolean {\n  const config = loadProjectsConfig();\n  return Object.keys(config.projects).length > 0;\n}\n\n/**\n * Create a default projects.yaml with example structure\n */\nexport function createDefaultProjectsConfig(): ProjectsConfig {\n  const defaultConfig: ProjectsConfig = {\n    projects: {\n      // Example project - commented out in actual file\n    },\n  };\n\n  return defaultConfig;\n}\n\n/**\n * Initialize projects.yaml with example configuration\n */\nexport function initializeProjectsConfig(): void {\n  if (existsSync(PROJECTS_CONFIG_FILE)) {\n    console.log(`Projects config already exists at ${PROJECTS_CONFIG_FILE}`);\n    return;\n  }\n\n  const exampleYaml = `# Panopticon Project Registry\n# Maps Linear teams to project paths for workspace creation\n\nprojects:\n  # Example: Mind Your Now project\n  # myn:\n  #   name: \"Mind Your Now\"\n  #   path: /home/user/projects/myn\n  #   linear_team: MIN\n  #   issue_routing:\n  #     # Route docs/marketing issues to docs repo\n  #     - labels: [docs, marketing, seo, landing-pages]\n  #       path: /home/user/projects/myn/docs\n  #     # Default: main repo\n  #     - default: true\n  #       path: /home/user/projects/myn\n\n  # Example: Panopticon itself\n  # panopticon:\n  #   name: \"Panopticon\"\n  #   path: /home/user/projects/panopticon\n  #   linear_team: PAN\n`;\n\n  const dir = PANOPTICON_HOME;\n  if (!existsSync(dir)) {\n    mkdirSync(dir, { recursive: true });\n  }\n\n  writeFileSync(PROJECTS_CONFIG_FILE, exampleYaml, 'utf-8');\n  console.log(`Created example projects config at ${PROJECTS_CONFIG_FILE}`);\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../src/lib/projects.ts"],"sourcesContent":["/**\n * Project Registry - Multi-project support for Panopticon\n *\n * Maps Linear team prefixes and labels to project paths for workspace creation.\n */\n\nimport { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs';\nimport { join } from 'path';\nimport { parse as parseYaml, stringify as stringifyYaml } from 'yaml';\nimport { PANOPTICON_HOME } from './paths.js';\n\nexport const PROJECTS_CONFIG_FILE = join(PANOPTICON_HOME, 'projects.yaml');\n\n/**\n * Issue routing rule - routes issues with certain labels to specific paths\n */\nexport interface IssueRoutingRule {\n  labels?: string[];\n  default?: boolean;\n  path: string;\n}\n\n/**\n * Project configuration\n */\nexport interface ProjectConfig {\n  name: string;\n  path: string;\n  linear_team?: string;\n  issue_routing?: IssueRoutingRule[];\n}\n\n/**\n * Full projects configuration file\n */\nexport interface ProjectsConfig {\n  projects: Record<string, ProjectConfig>;\n}\n\n/**\n * Resolved project info for workspace creation\n */\nexport interface ResolvedProject {\n  projectKey: string;\n  projectName: string;\n  projectPath: string;\n  linearTeam?: string;\n}\n\n/**\n * Load projects configuration from ~/.panopticon/projects.yaml\n */\nexport function loadProjectsConfig(): ProjectsConfig {\n  if (!existsSync(PROJECTS_CONFIG_FILE)) {\n    return { projects: {} };\n  }\n\n  try {\n    const content = readFileSync(PROJECTS_CONFIG_FILE, 'utf-8');\n    const config = parseYaml(content) as ProjectsConfig;\n    return config || { projects: {} };\n  } catch (error: any) {\n    console.error(`Failed to parse projects.yaml: ${error.message}`);\n    return { projects: {} };\n  }\n}\n\n/**\n * Save projects configuration\n */\nexport function saveProjectsConfig(config: ProjectsConfig): void {\n  const dir = PANOPTICON_HOME;\n  if (!existsSync(dir)) {\n    mkdirSync(dir, { recursive: true });\n  }\n\n  const yaml = stringifyYaml(config, { indent: 2 });\n  writeFileSync(PROJECTS_CONFIG_FILE, yaml, 'utf-8');\n}\n\n/**\n * Get a list of all registered projects\n */\nexport function listProjects(): Array<{ key: string; config: ProjectConfig }> {\n  const config = loadProjectsConfig();\n  return Object.entries(config.projects).map(([key, projectConfig]) => ({\n    key,\n    config: projectConfig,\n  }));\n}\n\n/**\n * Add or update a project in the registry\n */\nexport function registerProject(key: string, projectConfig: ProjectConfig): void {\n  const config = loadProjectsConfig();\n  config.projects[key] = projectConfig;\n  saveProjectsConfig(config);\n}\n\n/**\n * Remove a project from the registry\n */\nexport function unregisterProject(key: string): boolean {\n  const config = loadProjectsConfig();\n  if (config.projects[key]) {\n    delete config.projects[key];\n    saveProjectsConfig(config);\n    return true;\n  }\n  return false;\n}\n\n/**\n * Extract Linear team prefix from an issue ID\n * E.g., \"MIN-123\" -> \"MIN\", \"PAN-456\" -> \"PAN\"\n */\nexport function extractTeamPrefix(issueId: string): string | null {\n  const match = issueId.match(/^([A-Z]+)-\\d+$/i);\n  return match ? match[1].toUpperCase() : null;\n}\n\n/**\n * Find project by Linear team prefix\n */\nexport function findProjectByTeam(teamPrefix: string): ProjectConfig | null {\n  const config = loadProjectsConfig();\n\n  for (const [, projectConfig] of Object.entries(config.projects)) {\n    if (projectConfig.linear_team?.toUpperCase() === teamPrefix.toUpperCase()) {\n      return projectConfig;\n    }\n  }\n\n  return null;\n}\n\n/**\n * Resolve the correct project path for an issue based on labels\n *\n * @param project - The project config\n * @param labels - Array of label names from the Linear issue\n * @returns The resolved path (may differ from project.path based on routing rules)\n */\nexport function resolveProjectPath(project: ProjectConfig, labels: string[] = []): string {\n  if (!project.issue_routing || project.issue_routing.length === 0) {\n    return project.path;\n  }\n\n  // Normalize labels to lowercase for comparison\n  const normalizedLabels = labels.map(l => l.toLowerCase());\n\n  // First, check label-based routing rules\n  for (const rule of project.issue_routing) {\n    if (rule.labels && rule.labels.length > 0) {\n      const ruleLabels = rule.labels.map(l => l.toLowerCase());\n      const hasMatch = ruleLabels.some(label => normalizedLabels.includes(label));\n      if (hasMatch) {\n        return rule.path;\n      }\n    }\n  }\n\n  // Then, find default rule\n  for (const rule of project.issue_routing) {\n    if (rule.default) {\n      return rule.path;\n    }\n  }\n\n  // Fall back to project path\n  return project.path;\n}\n\n/**\n * Resolve project from an issue ID (and optional labels)\n *\n * @param issueId - Linear issue ID (e.g., \"MIN-123\")\n * @param labels - Optional array of label names\n * @returns Resolved project info or null if not found\n */\nexport function resolveProjectFromIssue(\n  issueId: string,\n  labels: string[] = []\n): ResolvedProject | null {\n  const teamPrefix = extractTeamPrefix(issueId);\n  if (!teamPrefix) {\n    return null;\n  }\n\n  const config = loadProjectsConfig();\n\n  // Find project by team prefix\n  for (const [key, projectConfig] of Object.entries(config.projects)) {\n    if (projectConfig.linear_team?.toUpperCase() === teamPrefix) {\n      const resolvedPath = resolveProjectPath(projectConfig, labels);\n      return {\n        projectKey: key,\n        projectName: projectConfig.name,\n        projectPath: resolvedPath,\n        linearTeam: projectConfig.linear_team,\n      };\n    }\n  }\n\n  return null;\n}\n\n/**\n * Get a project by key\n */\nexport function getProject(key: string): ProjectConfig | null {\n  const config = loadProjectsConfig();\n  return config.projects[key] || null;\n}\n\n/**\n * Check if projects.yaml exists and has any projects\n */\nexport function hasProjects(): boolean {\n  const config = loadProjectsConfig();\n  return Object.keys(config.projects).length > 0;\n}\n\n/**\n * Create a default projects.yaml with example structure\n */\nexport function createDefaultProjectsConfig(): ProjectsConfig {\n  const defaultConfig: ProjectsConfig = {\n    projects: {\n      // Example project - commented out in actual file\n    },\n  };\n\n  return defaultConfig;\n}\n\n/**\n * Initialize projects.yaml with example configuration\n */\nexport function initializeProjectsConfig(): void {\n  if (existsSync(PROJECTS_CONFIG_FILE)) {\n    console.log(`Projects config already exists at ${PROJECTS_CONFIG_FILE}`);\n    return;\n  }\n\n  const exampleYaml = `# Panopticon Project Registry\n# Maps Linear teams to project paths for workspace creation\n\nprojects:\n  # Example: Mind Your Now project\n  # myn:\n  #   name: \"Mind Your Now\"\n  #   path: /home/user/projects/myn\n  #   linear_team: MIN\n  #   issue_routing:\n  #     # Route docs/marketing issues to docs repo\n  #     - labels: [docs, marketing, seo, landing-pages]\n  #       path: /home/user/projects/myn/docs\n  #     # Default: main repo\n  #     - default: true\n  #       path: /home/user/projects/myn\n\n  # Example: Panopticon itself\n  # panopticon:\n  #   name: \"Panopticon\"\n  #   path: /home/user/projects/panopticon\n  #   linear_team: PAN\n`;\n\n  const dir = PANOPTICON_HOME;\n  if (!existsSync(dir)) {\n    mkdirSync(dir, { recursive: true });\n  }\n\n  writeFileSync(PROJECTS_CONFIG_FILE, exampleYaml, 'utf-8');\n  console.log(`Created example projects config at ${PROJECTS_CONFIG_FILE}`);\n}\n"],"mappings":"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","names":[]}

package/dist/{chunk-B2JBBOJN.js → chunk-C6A7S65K.js}

@@ -6,14 +6,10 @@ import {
   CONFIG_FILE,
   SKILLS_DIR,
   SOURCE_SCRIPTS_DIR,
-  SYNC_TARGETS,
-  init_esm_shims,
-  init_paths
-} from "./chunk-SG7O6I7R.js";
+  SYNC_TARGETS
+} from "./chunk-P5TQ5C3J.js";
 
 // src/lib/config.ts
-init_esm_shims();
-init_paths();
 import { readFileSync, writeFileSync, existsSync } from "fs";
 import { parse, stringify } from "@iarna/toml";
 var DEFAULT_CONFIG = {
@@ -74,7 +70,6 @@ function getDefaultConfig() {
 }
 
 // src/lib/shell.ts
-init_esm_shims();
 import { existsSync as existsSync2, readFileSync as readFileSync2, appendFileSync } from "fs";
 import { homedir } from "os";
 import { join } from "path";
@@ -126,8 +121,6 @@ function getAliasInstructions(shell) {
 }
 
 // src/lib/backup.ts
-init_esm_shims();
-init_paths();
 import { existsSync as existsSync3, mkdirSync, readdirSync, cpSync, rmSync } from "fs";
 import { join as join2, basename } from "path";
 function createBackupTimestamp() {
@@ -194,8 +187,6 @@ function cleanOldBackups(keepCount = 10) {
 }
 
 // src/lib/sync.ts
-init_esm_shims();
-init_paths();
 import { existsSync as existsSync4, mkdirSync as mkdirSync2, readdirSync as readdirSync2, symlinkSync, unlinkSync, lstatSync, readlinkSync, rmSync as rmSync2, copyFileSync, chmodSync } from "fs";
 import { join as join3 } from "path";
 function removeTarget(targetPath) {
@@ -379,7 +370,6 @@ function syncHooks() {
 }
 
 // src/lib/tracker/interface.ts
-init_esm_shims();
 var NotImplementedError = class extends Error {
   constructor(feature) {
     super(`Not implemented: ${feature}`);
@@ -400,7 +390,6 @@ var TrackerAuthError = class extends Error {
 };
 
 // src/lib/tracker/linear.ts
-init_esm_shims();
 import { LinearClient } from "@linear/sdk";
 var STATE_MAP = {
   backlog: "open",
@@ -610,7 +599,6 @@ var LinearTracker = class {
 };
 
 // src/lib/tracker/github.ts
-init_esm_shims();
 import { Octokit } from "@octokit/rest";
 var GitHubTracker = class {
   name = "github";
@@ -771,7 +759,6 @@ var GitHubTracker = class {
 };
 
 // src/lib/tracker/gitlab.ts
-init_esm_shims();
 var GitLabTracker = class {
   constructor(token, projectId) {
     this.token = token;
@@ -820,11 +807,7 @@ var GitLabTracker = class {
   }
 };
 
-// src/lib/tracker/factory.ts
-init_esm_shims();
-
 // src/lib/tracker/rally.ts
-init_esm_shims();
 import rally from "rally";
 var STATE_MAP2 = {
   Defined: "open",
@@ -1287,7 +1270,6 @@ function getAllTrackers(trackersConfig) {
 }
 
 // src/lib/tracker/linking.ts
-init_esm_shims();
 import { readFileSync as readFileSync3, writeFileSync as writeFileSync2, existsSync as existsSync5, mkdirSync as mkdirSync3 } from "fs";
 import { join as join4 } from "path";
 import { homedir as homedir2 } from "os";
@@ -1428,9 +1410,6 @@ function getLinkManager() {
   return _linkManager;
 }
 
-// src/lib/tracker/index.ts
-init_esm_shims();
-
 export {
   loadConfig,
   saveConfig,
@@ -1466,4 +1445,4 @@ export {
   LinkManager,
   getLinkManager
 };
-//# sourceMappingURL=chunk-B2JBBOJN.js.map
+//# sourceMappingURL=chunk-C6A7S65K.js.map