panopticon-cli 0.1.3 → 0.2.0

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-J7JUNJGH.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.2.0",
   "description": "Multi-agent orchestration for AI coding assistants (Claude Code, Codex, Cursor, Gemini CLI)",
   "keywords": [
     "ai-agents",
@@ -44,12 +44,19 @@
     "build": "tsup",
     "typecheck": "tsc --noEmit",
     "lint": "eslint src/",
-    "test": "vitest",
+    "test": "vitest --no-file-parallelism",
+    "test:unit": "vitest run tests/unit",
+    "test:integration": "vitest run tests/integration",
+    "test:e2e": "vitest run tests/e2e",
+    "test:coverage": "vitest run --coverage",
+    "docs": "typedoc",
+    "docs:watch": "typedoc --watch",
     "prepublishOnly": "npm run build"
   },
   "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",
@@ -60,9 +67,11 @@
   "devDependencies": {
     "@types/inquirer": "^9.0.9",
     "@types/node": "^20.10.0",
+    "@vitest/coverage-v8": "^1.0.4",
     "eslint": "^8.55.0",
     "tsup": "^8.0.1",
     "tsx": "^4.6.2",
+    "typedoc": "^0.25.0",
     "typescript": "^5.3.2",
     "vitest": "^1.0.4"
   }

package/templates/context/CLAUDE.md.template

@@ -0,0 +1,81 @@
+# Agent Instructions: {{ISSUE_ID}}
+
+## Your Mission
+
+You are an autonomous AI coding agent working on:
+
+**{{ISSUE_ID}}**: {{ISSUE_TITLE}}
+
+## Critical Rules
+
+1. **Read STATE.md first** - Always check `.planning/STATE.md` for current progress
+2. **Update STATE.md frequently** - Keep state current for crash recovery
+3. **Commit often** - Small, focused commits with clear messages
+4. **Test your changes** - Run tests before marking work complete
+5. **Ask when unsure** - Don't guess on requirements, ask for clarification
+
+## Project Context
+
+{{PROJECT_CONTEXT}}
+
+## Coding Standards
+
+{{CODING_STANDARDS}}
+
+## Issue Details
+
+### Description
+{{ISSUE_DESCRIPTION}}
+
+### Acceptance Criteria
+{{ACCEPTANCE_CRITERIA}}
+
+### Technical Requirements
+{{TECHNICAL_REQUIREMENTS}}
+
+## File Locations
+
+| Purpose | Path |
+|---------|------|
+{{FILE_LOCATIONS}}
+
+## Workflow
+
+1. **Start**: Read STATE.md, understand current progress
+2. **Plan**: Break down work into small steps
+3. **Implement**: Write code, following project standards
+4. **Test**: Run tests, fix any failures
+5. **Document**: Update STATE.md with progress
+6. **Commit**: Create focused commits with clear messages
+7. **Repeat**: Continue until issue is complete
+
+## Communication
+
+To send a message to the user or request help:
+- Update STATE.md with your question under "Questions for Review"
+- Include clear context about what you need
+
+## Completion Checklist
+
+Before marking this issue complete:
+
+- [ ] All acceptance criteria met
+- [ ] Tests pass
+- [ ] Code follows project standards
+- [ ] STATE.md updated with final status
+- [ ] Changes committed and pushed
+- [ ] No console errors or warnings
+- [ ] Documentation updated if needed
+
+## Emergency Recovery
+
+If you're resuming after a crash:
+
+1. Run `git status` to see uncommitted changes
+2. Read STATE.md for last known progress
+3. Check "Last Action" and "Next Steps" sections
+4. Continue from where work was interrupted
+
+---
+
+*This file is auto-generated by Panopticon. Modify project-specific sections as needed.*