panopticon-cli 0.1.3 → 0.1.6

package/dist/index.d.ts

@@ -5,6 +5,10 @@ declare const COMMANDS_DIR: string;
 declare const AGENTS_DIR: string;
 declare const BACKUPS_DIR: string;
 declare const COSTS_DIR: string;
+declare const TRAEFIK_DIR: string;
+declare const TRAEFIK_DYNAMIC_DIR: string;
+declare const TRAEFIK_CERTS_DIR: string;
+declare const CERTS_DIR: string;
 declare const CONFIG_FILE: string;
 declare const CLAUDE_DIR: string;
 declare const CODEX_DIR: string;
@@ -31,8 +35,174 @@ declare const SYNC_TARGETS: {
 type Runtime = keyof typeof SYNC_TARGETS;
 declare const TEMPLATES_DIR: string;
 declare const CLAUDE_MD_TEMPLATES: string;
+declare const SOURCE_TEMPLATES_DIR: string;
+declare const SOURCE_TRAEFIK_TEMPLATES: string;
 declare const INIT_DIRS: string[];
 
+/**
+ * Issue Tracker Abstraction Layer
+ *
+ * Provides a unified interface for different issue tracking systems
+ * (Linear, GitHub Issues, GitLab Issues, etc.)
+ */
+type TrackerType = 'linear' | 'github' | 'gitlab';
+type IssueState = 'open' | 'in_progress' | 'closed';
+interface Issue {
+    /** Tracker-specific unique ID */
+    id: string;
+    /** Human-readable reference (e.g., MIN-630, #42) */
+    ref: string;
+    /** Issue title */
+    title: string;
+    /** Issue description/body (markdown) */
+    description: string;
+    /** Normalized state */
+    state: IssueState;
+    /** Labels/tags */
+    labels: string[];
+    /** Assignee username/name */
+    assignee?: string;
+    /** Web URL to the issue */
+    url: string;
+    /** Which tracker this issue came from */
+    tracker: TrackerType;
+    /** Cross-tracker linked issue references */
+    linkedIssues?: string[];
+    /** Priority (1=urgent, 2=high, 3=normal, 4=low) */
+    priority?: number;
+    /** Due date (ISO string) */
+    dueDate?: string;
+    /** Creation timestamp (ISO string) */
+    createdAt: string;
+    /** Last update timestamp (ISO string) */
+    updatedAt: string;
+}
+interface Comment {
+    id: string;
+    issueId: string;
+    body: string;
+    author: string;
+    createdAt: string;
+    updatedAt: string;
+}
+interface IssueFilters {
+    /** Filter by state */
+    state?: IssueState;
+    /** Filter by labels (AND logic) */
+    labels?: string[];
+    /** Filter by assignee */
+    assignee?: string;
+    /** Filter by team/project (tracker-specific) */
+    team?: string;
+    /** Search query for title/description */
+    query?: string;
+    /** Maximum number of results */
+    limit?: number;
+    /** Include closed issues (default: false) */
+    includeClosed?: boolean;
+}
+interface NewIssue {
+    title: string;
+    description?: string;
+    labels?: string[];
+    assignee?: string;
+    team?: string;
+    priority?: number;
+    dueDate?: string;
+}
+interface IssueUpdate {
+    title?: string;
+    description?: string;
+    state?: IssueState;
+    labels?: string[];
+    assignee?: string;
+    priority?: number;
+    dueDate?: string;
+}
+/**
+ * Abstract interface for issue trackers.
+ * Implementations must handle normalization to/from tracker-specific formats.
+ */
+interface IssueTracker {
+    /** Tracker type identifier */
+    readonly name: TrackerType;
+    /**
+     * List issues matching filters
+     */
+    listIssues(filters?: IssueFilters): Promise<Issue[]>;
+    /**
+     * Get a single issue by ID or ref
+     * @param id - Issue ID or human-readable ref (e.g., "MIN-630", "#42")
+     */
+    getIssue(id: string): Promise<Issue>;
+    /**
+     * Update an existing issue
+     */
+    updateIssue(id: string, update: IssueUpdate): Promise<Issue>;
+    /**
+     * Create a new issue
+     */
+    createIssue(issue: NewIssue): Promise<Issue>;
+    /**
+     * Get comments on an issue
+     */
+    getComments(issueId: string): Promise<Comment[]>;
+    /**
+     * Add a comment to an issue
+     */
+    addComment(issueId: string, body: string): Promise<Comment>;
+    /**
+     * Transition issue to a new state
+     */
+    transitionIssue(id: string, state: IssueState): Promise<void>;
+    /**
+     * Link a PR/MR to an issue
+     */
+    linkPR(issueId: string, prUrl: string): Promise<void>;
+}
+/**
+ * Error thrown when a tracker feature is not implemented
+ */
+declare class NotImplementedError extends Error {
+    constructor(feature: string);
+}
+/**
+ * Error thrown when an issue is not found
+ */
+declare class IssueNotFoundError extends Error {
+    constructor(id: string, tracker: TrackerType);
+}
+/**
+ * Error thrown when tracker authentication fails
+ */
+declare class TrackerAuthError extends Error {
+    constructor(tracker: TrackerType, message: string);
+}
+
+interface LinearConfig {
+    type: 'linear';
+    api_key_env?: string;
+    team?: string;
+}
+interface GitHubConfig {
+    type: 'github';
+    token_env?: string;
+    owner: string;
+    repo: string;
+}
+interface GitLabConfig {
+    type: 'gitlab';
+    token_env?: string;
+    project_id: string;
+}
+type TrackerConfigItem = LinearConfig | GitHubConfig | GitLabConfig;
+interface TrackersConfig {
+    primary: TrackerType;
+    secondary?: TrackerType;
+    linear?: LinearConfig;
+    github?: GitHubConfig;
+    gitlab?: GitLabConfig;
+}
 interface PanopticonConfig {
     panopticon: {
         version: string;
@@ -40,15 +210,19 @@ interface PanopticonConfig {
     sync: {
         targets: string[];
         backup_before_sync: boolean;
+        auto_sync?: boolean;
+        strategy?: 'symlink' | 'copy';
     };
-    trackers: {
-        primary: string;
-        secondary?: string;
-    };
+    trackers: TrackersConfig;
     dashboard: {
         port: number;
         api_port: number;
     };
+    traefik?: {
+        enabled: boolean;
+        dashboard_port?: number;
+        domain?: string;
+    };
 }
 declare function loadConfig(): PanopticonConfig;
 declare function saveConfig(config: PanopticonConfig): void;
@@ -105,4 +279,193 @@ interface SyncResult {
  */
 declare function executeSync(runtime: Runtime, options?: SyncOptions): SyncResult;
 
-export { AGENTS_DIR, BACKUPS_DIR, type BackupInfo, CLAUDE_DIR, CLAUDE_MD_TEMPLATES, CODEX_DIR, COMMANDS_DIR, CONFIG_DIR, CONFIG_FILE, COSTS_DIR, CURSOR_DIR, GEMINI_DIR, INIT_DIRS, PANOPTICON_HOME, type PanopticonConfig, type Runtime, SKILLS_DIR, SYNC_TARGETS, type Shell, type SyncItem, type SyncOptions, type SyncPlan, type SyncResult, TEMPLATES_DIR, addAlias, cleanOldBackups, createBackup, createBackupTimestamp, detectShell, executeSync, getAliasInstructions, getDefaultConfig, getShellRcFile, hasAlias, isPanopticonSymlink, listBackups, loadConfig, planSync, restoreBackup, saveConfig };
+/**
+ * Linear Issue Tracker Adapter
+ *
+ * Implements IssueTracker interface for Linear.
+ */
+
+declare class LinearTracker implements IssueTracker {
+    readonly name: TrackerType;
+    private client;
+    private defaultTeam?;
+    constructor(apiKey: string, options?: {
+        team?: string;
+    });
+    listIssues(filters?: IssueFilters): Promise<Issue[]>;
+    getIssue(id: string): Promise<Issue>;
+    updateIssue(id: string, update: IssueUpdate): Promise<Issue>;
+    createIssue(newIssue: NewIssue): Promise<Issue>;
+    getComments(issueId: string): Promise<Comment[]>;
+    addComment(issueId: string, body: string): Promise<Comment>;
+    transitionIssue(id: string, state: IssueState): Promise<void>;
+    linkPR(issueId: string, prUrl: string): Promise<void>;
+    private normalizeIssue;
+    private mapState;
+    private reverseMapState;
+}
+
+/**
+ * GitHub Issues Tracker Adapter
+ *
+ * Implements IssueTracker interface for GitHub Issues.
+ */
+
+declare class GitHubTracker implements IssueTracker {
+    readonly name: TrackerType;
+    private octokit;
+    private owner;
+    private repo;
+    constructor(token: string, owner: string, repo: string);
+    listIssues(filters?: IssueFilters): Promise<Issue[]>;
+    getIssue(id: string): Promise<Issue>;
+    updateIssue(id: string, update: IssueUpdate): Promise<Issue>;
+    createIssue(newIssue: NewIssue): Promise<Issue>;
+    getComments(issueId: string): Promise<Comment[]>;
+    addComment(issueId: string, body: string): Promise<Comment>;
+    transitionIssue(id: string, state: IssueState): Promise<void>;
+    linkPR(issueId: string, prUrl: string): Promise<void>;
+    private normalizeIssue;
+    private mapStateFromGitHub;
+    private mapStateToGitHub;
+}
+
+/**
+ * GitLab Issues Tracker Adapter (Stub)
+ *
+ * Placeholder implementation for GitLab Issues support.
+ * Full implementation will use @gitbeaker/rest.
+ */
+
+declare class GitLabTracker implements IssueTracker {
+    private token;
+    private projectId;
+    readonly name: TrackerType;
+    constructor(token: string, projectId: string);
+    listIssues(_filters?: IssueFilters): Promise<Issue[]>;
+    getIssue(_id: string): Promise<Issue>;
+    updateIssue(_id: string, _update: IssueUpdate): Promise<Issue>;
+    createIssue(_issue: NewIssue): Promise<Issue>;
+    getComments(_issueId: string): Promise<Comment[]>;
+    addComment(_issueId: string, _body: string): Promise<Comment>;
+    transitionIssue(_id: string, _state: IssueState): Promise<void>;
+    linkPR(_issueId: string, _prUrl: string): Promise<void>;
+}
+
+/**
+ * Tracker Factory
+ *
+ * Creates appropriate tracker instances based on configuration.
+ */
+
+interface TrackerConfig {
+    type: TrackerType;
+    apiKeyEnv?: string;
+    team?: string;
+    tokenEnv?: string;
+    owner?: string;
+    repo?: string;
+    projectId?: string;
+}
+/**
+ * Create a tracker instance from configuration
+ */
+declare function createTracker(config: TrackerConfig): IssueTracker;
+/**
+ * Create tracker from trackers configuration section
+ */
+declare function createTrackerFromConfig(trackersConfig: TrackersConfig, trackerType: TrackerType): IssueTracker;
+/**
+ * Get the primary tracker from configuration
+ */
+declare function getPrimaryTracker(trackersConfig: TrackersConfig): IssueTracker;
+/**
+ * Get the secondary tracker from configuration (if configured)
+ */
+declare function getSecondaryTracker(trackersConfig: TrackersConfig): IssueTracker | null;
+/**
+ * Get all configured trackers
+ */
+declare function getAllTrackers(trackersConfig: TrackersConfig): IssueTracker[];
+
+/**
+ * Cross-Tracker Linking
+ *
+ * Manages links between issues in different trackers.
+ * Links are stored in a local JSON file for persistence.
+ */
+
+type LinkDirection = 'blocks' | 'blocked_by' | 'related' | 'duplicate_of';
+interface TrackerLink {
+    sourceIssueRef: string;
+    sourceTracker: TrackerType;
+    targetIssueRef: string;
+    targetTracker: TrackerType;
+    direction: LinkDirection;
+    createdAt: string;
+}
+/**
+ * Parse an issue reference to extract tracker and ID
+ * Examples:
+ *   "#42" -> { tracker: "github", ref: "#42" }
+ *   "github#42" -> { tracker: "github", ref: "#42" }
+ *   "MIN-630" -> { tracker: "linear", ref: "MIN-630" }
+ *   "gitlab#15" -> { tracker: "gitlab", ref: "#15" }
+ */
+declare function parseIssueRef(ref: string): {
+    tracker: TrackerType;
+    ref: string;
+} | null;
+/**
+ * Format an issue ref with tracker prefix for display
+ */
+declare function formatIssueRef(ref: string, tracker: TrackerType): string;
+/**
+ * Link Manager for cross-tracker issue linking
+ */
+declare class LinkManager {
+    private storePath;
+    private store;
+    constructor(storePath?: string);
+    private load;
+    private save;
+    /**
+     * Add a link between two issues
+     */
+    addLink(source: {
+        ref: string;
+        tracker: TrackerType;
+    }, target: {
+        ref: string;
+        tracker: TrackerType;
+    }, direction?: LinkDirection): TrackerLink;
+    /**
+     * Remove a link between two issues
+     */
+    removeLink(source: {
+        ref: string;
+        tracker: TrackerType;
+    }, target: {
+        ref: string;
+        tracker: TrackerType;
+    }): boolean;
+    /**
+     * Get all issues linked to a given issue
+     */
+    getLinkedIssues(ref: string, tracker: TrackerType): TrackerLink[];
+    /**
+     * Get all links (for debugging/admin)
+     */
+    getAllLinks(): TrackerLink[];
+    /**
+     * Find linked issue in another tracker
+     */
+    findLinkedIssue(ref: string, sourceTracker: TrackerType, targetTracker: TrackerType): string | null;
+    /**
+     * Clear all links (for testing)
+     */
+    clear(): void;
+}
+declare function getLinkManager(): LinkManager;
+
+export { AGENTS_DIR, BACKUPS_DIR, type BackupInfo, CERTS_DIR, CLAUDE_DIR, CLAUDE_MD_TEMPLATES, CODEX_DIR, COMMANDS_DIR, CONFIG_DIR, CONFIG_FILE, COSTS_DIR, CURSOR_DIR, type Comment, GEMINI_DIR, type GitHubConfig, GitHubTracker, type GitLabConfig, GitLabTracker, INIT_DIRS, type Issue, type IssueFilters, IssueNotFoundError, type IssueState, type IssueTracker, type IssueUpdate, type LinearConfig, LinearTracker, type LinkDirection, LinkManager, type NewIssue, NotImplementedError, PANOPTICON_HOME, type PanopticonConfig, type Runtime, SKILLS_DIR, SOURCE_TEMPLATES_DIR, SOURCE_TRAEFIK_TEMPLATES, SYNC_TARGETS, type Shell, 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, addAlias, cleanOldBackups, createBackup, createBackupTimestamp, createTracker, createTrackerFromConfig, detectShell, executeSync, formatIssueRef, getAliasInstructions, getAllTrackers, getDefaultConfig, getLinkManager, getPrimaryTracker, getSecondaryTracker, getShellRcFile, hasAlias, isPanopticonSymlink, listBackups, loadConfig, parseIssueRef, planSync, restoreBackup, saveConfig };

package/dist/index.js

@@ -1,6 +1,7 @@
 import {
   AGENTS_DIR,
   BACKUPS_DIR,
+  CERTS_DIR,
   CLAUDE_DIR,
   CLAUDE_MD_TEMPLATES,
   CODEX_DIR,
@@ -10,31 +11,52 @@ import {
   COSTS_DIR,
   CURSOR_DIR,
   GEMINI_DIR,
+  GitHubTracker,
+  GitLabTracker,
   INIT_DIRS,
+  IssueNotFoundError,
+  LinearTracker,
+  LinkManager,
+  NotImplementedError,
   PANOPTICON_HOME,
   SKILLS_DIR,
+  SOURCE_TEMPLATES_DIR,
+  SOURCE_TRAEFIK_TEMPLATES,
   SYNC_TARGETS,
   TEMPLATES_DIR,
+  TRAEFIK_CERTS_DIR,
+  TRAEFIK_DIR,
+  TRAEFIK_DYNAMIC_DIR,
+  TrackerAuthError,
   addAlias,
   cleanOldBackups,
   createBackup,
   createBackupTimestamp,
+  createTracker,
+  createTrackerFromConfig,
   detectShell,
   executeSync,
+  formatIssueRef,
   getAliasInstructions,
+  getAllTrackers,
   getDefaultConfig,
+  getLinkManager,
+  getPrimaryTracker,
+  getSecondaryTracker,
   getShellRcFile,
   hasAlias,
   isPanopticonSymlink,
   listBackups,
   loadConfig,
+  parseIssueRef,
   planSync,
   restoreBackup,
   saveConfig
-} from "./chunk-FR2P66GU.js";
+} from "./chunk-RM3WGTFO.js";
 export {
   AGENTS_DIR,
   BACKUPS_DIR,
+  CERTS_DIR,
   CLAUDE_DIR,
   CLAUDE_MD_TEMPLATES,
   CODEX_DIR,
@@ -44,24 +66,44 @@ export {
   COSTS_DIR,
   CURSOR_DIR,
   GEMINI_DIR,
+  GitHubTracker,
+  GitLabTracker,
   INIT_DIRS,
+  IssueNotFoundError,
+  LinearTracker,
+  LinkManager,
+  NotImplementedError,
   PANOPTICON_HOME,
   SKILLS_DIR,
+  SOURCE_TEMPLATES_DIR,
+  SOURCE_TRAEFIK_TEMPLATES,
   SYNC_TARGETS,
   TEMPLATES_DIR,
+  TRAEFIK_CERTS_DIR,
+  TRAEFIK_DIR,
+  TRAEFIK_DYNAMIC_DIR,
+  TrackerAuthError,
   addAlias,
   cleanOldBackups,
   createBackup,
   createBackupTimestamp,
+  createTracker,
+  createTrackerFromConfig,
   detectShell,
   executeSync,
+  formatIssueRef,
   getAliasInstructions,
+  getAllTrackers,
   getDefaultConfig,
+  getLinkManager,
+  getPrimaryTracker,
+  getSecondaryTracker,
   getShellRcFile,
   hasAlias,
   isPanopticonSymlink,
   listBackups,
   loadConfig,
+  parseIssueRef,
   planSync,
   restoreBackup,
   saveConfig

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "panopticon-cli",
-  "version": "0.1.3",
+  "version": "0.1.6",
   "description": "Multi-agent orchestration for AI coding assistants (Claude Code, Codex, Cursor, Gemini CLI)",
   "keywords": [
     "ai-agents",
@@ -50,6 +50,7 @@
   "dependencies": {
     "@iarna/toml": "^2.2.5",
     "@linear/sdk": "^70.0.0",
+    "@octokit/rest": "^22.0.1",
     "chalk": "^5.6.2",
     "commander": "^12.1.0",
     "conf": "^12.0.0",

package/templates/traefik/README.md

@@ -0,0 +1,106 @@
+# Panopticon Traefik Configuration
+
+Traefik reverse proxy for local development with HTTPS.
+
+## Directory Structure
+
+```
+~/.panopticon/traefik/
+├── docker-compose.yml      # Traefik container definition
+├── traefik.yml             # Static configuration
+├── dynamic/                # Dynamic routing configs
+│   └── panopticon.yml      # Dashboard routing
+├── certs/                  # mkcert SSL certificates
+│   ├── _wildcard.pan.localhost.pem
+│   └── _wildcard.pan.localhost-key.pem
+└── README.md               # This file
+```
+
+## URLs
+
+| URL | Service |
+|-----|---------|
+| `https://pan.localhost` | Panopticon Dashboard (Frontend) |
+| `https://pan.localhost/api/*` | Panopticon Dashboard (API) |
+| `http://localhost:8080` | Traefik Dashboard |
+
+## How It Works
+
+### Static Configuration (`traefik.yml`)
+- Defines entry points (HTTP:80, HTTPS:443)
+- Enables Traefik dashboard on port 8080
+- Configures file provider for dynamic configs
+- Sets up TLS with wildcard certificates
+
+### Dynamic Configuration (`dynamic/panopticon.yml`)
+- Routes `https://pan.localhost` to dashboard frontend (port 3001)
+- Routes `https://pan.localhost/api/*` to dashboard API (port 3002)
+- Uses `host.docker.internal` to access host-based services
+
+### Docker Compose
+- Runs Traefik v3.0 in a container
+- Exposes ports 80, 443, 8080
+- Mounts configuration files and certificates
+- Uses `panopticon` network for container communication
+
+## Prerequisites
+
+1. **mkcert certificates** must be generated first:
+   ```bash
+   mkcert "*.pan.localhost" "*.localhost" localhost 127.0.0.1 ::1
+   ```
+   Certificates should be in `~/.panopticon/traefik/certs/`
+
+2. **DNS/Hosts configuration**:
+   - Add to `/etc/hosts`: `127.0.0.1 pan.localhost`
+   - Wildcard `*.localhost` resolves automatically on most systems
+
+## Usage
+
+Start Traefik:
+```bash
+cd ~/.panopticon/traefik
+docker-compose up -d
+```
+
+Stop Traefik:
+```bash
+cd ~/.panopticon/traefik
+docker-compose down
+```
+
+View logs:
+```bash
+docker logs -f panopticon-traefik
+```
+
+## Managed by CLI
+
+These commands are automated via `pan` CLI:
+- `pan install` - Sets up Traefik (creates configs, generates certs)
+- `pan up` - Starts Traefik container
+- `pan down` - Stops Traefik container
+
+## Adding Workspace Routes
+
+Workspace-specific routes should be added as separate YAML files in `dynamic/`:
+
+```yaml
+# dynamic/feature-pan-4.yml
+http:
+  routers:
+    workspace-feature-pan-4-frontend:
+      rule: "Host(`feature-pan-4.myn.localhost`)"
+      service: workspace-feature-pan-4-frontend
+      entryPoints:
+        - websecure
+      tls: {}
+
+  services:
+    workspace-feature-pan-4-frontend:
+      loadBalancer:
+        servers:
+          - url: "http://workspace-feature-pan-4-frontend:3000"
+```
+
+These are auto-generated by `pan workspace create` and `pan workspace start`.

package/templates/traefik/docker-compose.yml

@@ -0,0 +1,40 @@
+services:
+  traefik:
+    image: traefik:v3.0
+    container_name: panopticon-traefik
+    restart: unless-stopped
+    ports:
+      - "8081:80"     # HTTP (redirects to HTTPS)
+      - "8443:443"    # HTTPS
+      - "8082:8080"   # Traefik Dashboard
+    volumes:
+      # Traefik configuration
+      - ./traefik.yml:/etc/traefik/traefik.yml:ro
+      - ./dynamic:/etc/traefik/dynamic:ro
+
+      # TLS certificates (mkcert generated)
+      - ./certs:/etc/traefik/certs:ro
+
+      # Docker socket for service discovery
+      - /var/run/docker.sock:/var/run/docker.sock:ro
+
+    networks:
+      - panopticon
+
+    labels:
+      - "traefik.enable=true"
+
+      # Dashboard routing (traefik.pan.localhost:8080)
+      - "traefik.http.routers.traefik-dashboard.rule=Host(`traefik.pan.localhost`)"
+      - "traefik.http.routers.traefik-dashboard.entrypoints=websecure"
+      - "traefik.http.routers.traefik-dashboard.tls=true"
+      - "traefik.http.routers.traefik-dashboard.service=api@internal"
+
+    extra_hosts:
+      # Allow Traefik to reach host services (dashboard on ports 3001/3002)
+      - "host.docker.internal:host-gateway"
+
+networks:
+  panopticon:
+    name: panopticon
+    driver: bridge