panopticon-cli 0.4.0 → 0.4.4

package/dist/index.d.ts

@@ -12,6 +12,7 @@ declare const TRAEFIK_DYNAMIC_DIR: string;
 declare const TRAEFIK_CERTS_DIR: string;
 declare const CERTS_DIR: string;
 declare const CONFIG_FILE: string;
+declare const SETTINGS_FILE: string;
 declare const CLAUDE_DIR: string;
 declare const CODEX_DIR: string;
 declare const CURSOR_DIR: string;
@@ -518,4 +519,127 @@ declare class LinkManager {
 }
 declare function getLinkManager(): LinkManager;
 
-export { AGENTS_DIR, BACKUPS_DIR, BIN_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, HEARTBEATS_DIR, type HookItem, 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 RallyConfig, type Runtime, SKILLS_DIR, SOURCE_DEV_SKILLS_DIR, SOURCE_SCRIPTS_DIR, SOURCE_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, isDevMode, isPanopticonSymlink, listBackups, loadConfig, parseIssueRef, planHooksSync, planSync, restoreBackup, saveConfig, syncHooks };
+type AnthropicModel = 'claude-opus-4-5' | 'claude-sonnet-4-5' | 'claude-haiku-4-5';
+type OpenAIModel = 'gpt-5.2-codex' | 'o3-deep-research' | 'gpt-4o' | 'gpt-4o-mini';
+type GoogleModel = 'gemini-3-pro-preview' | 'gemini-3-flash-preview' | 'gemini-2.5-pro' | 'gemini-2.5-flash';
+type ZAIModel = 'glm-4.7' | 'glm-4.7-flash';
+type KimiModel = 'kimi-k2' | 'kimi-k2.5';
+type ModelId = AnthropicModel | OpenAIModel | GoogleModel | ZAIModel | KimiModel;
+type ComplexityLevel = 'trivial' | 'simple' | 'medium' | 'complex' | 'expert';
+interface SpecialistModels {
+    review_agent: ModelId;
+    test_agent: ModelId;
+    merge_agent: ModelId;
+}
+type ComplexityModels = {
+    [K in ComplexityLevel]: ModelId;
+};
+interface ModelsConfig {
+    specialists: SpecialistModels;
+    planning_agent: ModelId;
+    complexity: ComplexityModels;
+}
+interface ApiKeysConfig {
+    openai?: string;
+    google?: string;
+    zai?: string;
+    kimi?: string;
+}
+interface SettingsConfig {
+    models: ModelsConfig;
+    api_keys: ApiKeysConfig;
+}
+/**
+ * Load settings from ~/.panopticon/settings.json
+ * Returns default settings if file doesn't exist or is invalid
+ * Also loads API keys from environment variables as fallback
+ */
+declare function loadSettings(): SettingsConfig;
+/**
+ * Save settings to ~/.panopticon/settings.json
+ * Writes with pretty formatting (2-space indent)
+ */
+declare function saveSettings(settings: SettingsConfig): void;
+/**
+ * Validate settings structure and model IDs
+ * Returns error message if invalid, null if valid
+ */
+declare function validateSettings(settings: SettingsConfig): string | null;
+/**
+ * Get a deep copy of the default settings
+ */
+declare function getDefaultSettings(): SettingsConfig;
+/**
+ * Get available models for a provider based on configured API keys
+ * Returns empty array if provider API key is not configured
+ */
+declare function getAvailableModels(settings: SettingsConfig): {
+    anthropic: AnthropicModel[];
+    openai: OpenAIModel[];
+    google: GoogleModel[];
+    zai: ZAIModel[];
+    kimi: KimiModel[];
+};
+
+/**
+ * Provider Configuration and Compatibility
+ *
+ * Defines which LLM providers are compatible with Claude Code's API format.
+ * - Direct providers: Implement Anthropic-compatible API (no router needed)
+ * - Router providers: Require claude-code-router for API translation
+ */
+
+type ProviderName = 'anthropic' | 'kimi' | 'openai' | 'google' | 'zai';
+/**
+ * Provider compatibility types
+ * - direct: Anthropic-compatible API, use ANTHROPIC_BASE_URL directly
+ * - router: Incompatible API, requires claude-code-router for translation
+ */
+type ProviderCompatibility = 'direct' | 'router';
+/**
+ * Provider configuration
+ */
+interface ProviderConfig {
+    name: ProviderName;
+    displayName: string;
+    compatibility: ProviderCompatibility;
+    baseUrl?: string;
+    models: ModelId[];
+    tested: boolean;
+    description: string;
+}
+/**
+ * All provider configurations
+ */
+declare const PROVIDERS: Record<ProviderName, ProviderConfig>;
+/**
+ * Get provider for a given model ID
+ */
+declare function getProviderForModel(modelId: ModelId): ProviderConfig;
+/**
+ * Check if a provider requires claude-code-router
+ */
+declare function requiresRouter(provider: ProviderName): boolean;
+/**
+ * Get all providers that require router (have router compatibility)
+ */
+declare function getRouterProviders(): ProviderConfig[];
+/**
+ * Get all direct-compatible providers
+ */
+declare function getDirectProviders(): ProviderConfig[];
+/**
+ * Check if any configured providers require router
+ * Used to determine if router installation is needed
+ */
+declare function needsRouter(apiKeys: {
+    openai?: string;
+    google?: string;
+    zai?: string;
+}): boolean;
+/**
+ * Get environment variables for spawning agent with specific provider
+ */
+declare function getProviderEnv(provider: ProviderConfig, apiKey: string): Record<string, string>;
+
+export { AGENTS_DIR, type AnthropicModel, type ApiKeysConfig, BACKUPS_DIR, BIN_DIR, type BackupInfo, CERTS_DIR, CLAUDE_DIR, CLAUDE_MD_TEMPLATES, CODEX_DIR, COMMANDS_DIR, CONFIG_DIR, CONFIG_FILE, COSTS_DIR, CURSOR_DIR, type Comment, type ComplexityLevel, type ComplexityModels, GEMINI_DIR, 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, type LinearConfig, LinearTracker, type LinkDirection, LinkManager, type ModelId, type ModelsConfig, type NewIssue, NotImplementedError, type OpenAIModel, PANOPTICON_HOME, PROVIDERS, type PanopticonConfig, type ProviderCompatibility, type ProviderConfig, type ProviderName, type RallyConfig, type Runtime, SETTINGS_FILE, SKILLS_DIR, SOURCE_DEV_SKILLS_DIR, SOURCE_SCRIPTS_DIR, SOURCE_SKILLS_DIR, SOURCE_TEMPLATES_DIR, SOURCE_TRAEFIK_TEMPLATES, SYNC_TARGETS, type SettingsConfig, 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, formatIssueRef, getAliasInstructions, getAllTrackers, getAvailableModels, getDefaultConfig, getDefaultSettings, getDirectProviders, getLinkManager, getPrimaryTracker, getProviderEnv, getProviderForModel, getRouterProviders, getSecondaryTracker, getShellRcFile, hasAlias, isDevMode, isPanopticonSymlink, listBackups, loadConfig, loadSettings, needsRouter, parseIssueRef, planHooksSync, planSync, requiresRouter, restoreBackup, saveConfig, saveSettings, syncHooks, validateSettings };

package/dist/index.js

@@ -32,7 +32,7 @@ import {
   restoreBackup,
   saveConfig,
   syncHooks
-} from "./chunk-7BGFIAWQ.js";
+} from "./chunk-ITI4IC5A.js";
 import {
   AGENTS_DIR,
   BACKUPS_DIR,
@@ -50,6 +50,8 @@ import {
   HEARTBEATS_DIR,
   INIT_DIRS,
   PANOPTICON_HOME,
+  PROVIDERS,
+  SETTINGS_FILE,
   SKILLS_DIR,
   SOURCE_DEV_SKILLS_DIR,
   SOURCE_SCRIPTS_DIR,
@@ -61,9 +63,19 @@ import {
   TRAEFIK_CERTS_DIR,
   TRAEFIK_DIR,
   TRAEFIK_DYNAMIC_DIR,
-  isDevMode
-} from "./chunk-U4LCHEVU.js";
-import "./chunk-DGUM43GV.js";
+  getAvailableModels,
+  getDefaultSettings,
+  getDirectProviders,
+  getProviderEnv,
+  getProviderForModel,
+  getRouterProviders,
+  isDevMode,
+  loadSettings,
+  needsRouter,
+  requiresRouter,
+  saveSettings,
+  validateSettings
+} from "./chunk-7HHDVXBM.js";
 export {
   AGENTS_DIR,
   BACKUPS_DIR,
@@ -87,6 +99,8 @@ export {
   LinkManager,
   NotImplementedError,
   PANOPTICON_HOME,
+  PROVIDERS,
+  SETTINGS_FILE,
   SKILLS_DIR,
   SOURCE_DEV_SKILLS_DIR,
   SOURCE_SCRIPTS_DIR,
@@ -110,9 +124,15 @@ export {
   formatIssueRef,
   getAliasInstructions,
   getAllTrackers,
+  getAvailableModels,
   getDefaultConfig,
+  getDefaultSettings,
+  getDirectProviders,
   getLinkManager,
   getPrimaryTracker,
+  getProviderEnv,
+  getProviderForModel,
+  getRouterProviders,
   getSecondaryTracker,
   getShellRcFile,
   hasAlias,
@@ -120,11 +140,16 @@ export {
   isPanopticonSymlink,
   listBackups,
   loadConfig,
+  loadSettings,
+  needsRouter,
   parseIssueRef,
   planHooksSync,
   planSync,
+  requiresRouter,
   restoreBackup,
   saveConfig,
-  syncHooks
+  saveSettings,
+  syncHooks,
+  validateSettings
 };
 //# sourceMappingURL=index.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "panopticon-cli",
-  "version": "0.4.0",
+  "version": "0.4.4",
   "description": "Multi-agent orchestration for AI coding assistants (Claude Code, Codex, Cursor, Gemini CLI)",
   "keywords": [
     "ai-agents",
@@ -24,6 +24,11 @@
     "url": "https://github.com/eltmon/panopticon-cli/issues"
   },
   "type": "module",
+  "workspaces": [
+    "packages/shared",
+    "src/dashboard/server",
+    "src/dashboard/frontend"
+  ],
   "bin": {
     "pan": "./dist/cli/index.js",
     "panopticon": "./dist/cli/index.js"
@@ -49,7 +54,7 @@
     "build:dashboard:server": "cd src/dashboard/server && npm run build",
     "typecheck": "tsc --noEmit",
     "lint": "eslint src/",
-    "test": "vitest --run --no-file-parallelism",
+    "test": "vitest --run --no-file-parallelism && cd src/dashboard/frontend && npm test",
     "test:unit": "vitest run tests/unit",
     "test:integration": "vitest run tests/integration",
     "test:e2e": "vitest run tests/e2e",
@@ -70,12 +75,14 @@
     "conf": "^12.0.0",
     "execa": "^8.0.1",
     "inquirer": "^9.3.8",
+    "js-yaml": "^4.1.1",
     "ora": "^8.2.0",
     "yaml": "^2.8.2"
   },
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.13",
     "@types/inquirer": "^9.0.9",
+    "@types/js-yaml": "^4.0.9",
     "@types/node": "^20.10.0",
     "@vitest/coverage-v8": "^1.0.4",
     "eslint": "^8.55.0",

package/templates/claude-md/sections/warnings.md

@@ -4,6 +4,22 @@
 - **DO NOT** push to main/master branch directly
 - **ALWAYS** check for existing patterns before introducing new ones
 
+## CRITICAL: Workspace Isolation
+
+**You are working in an ISOLATED WORKSPACE. Your working directory MUST be:**
+
+```
+{{WORKSPACE_PATH}}
+```
+
+**Before making ANY file changes:**
+1. Run `pwd` to verify you're in the workspace
+2. All file paths should be relative to the workspace OR absolute paths within the workspace
+3. NEVER use paths like `/home/.../projects/panopticon/src/...` (main project)
+4. ALWAYS use paths like `./src/...` or `{{WORKSPACE_PATH}}/src/...` (workspace)
+
+**If you see yourself working in the main project directory instead of the workspace, STOP and correct your working directory.**
+
 ## NEVER Defer Work (CRITICAL)
 
 **You MUST complete ALL work in the issue scope. NEVER defer tasks to "future PRs".**
@@ -37,9 +53,18 @@
 # 1. Run tests
 npm test  # or: mvn test, cargo test, etc.
 
-# 2. Stage and commit ALL changes
+# 2. Stage and commit ALL changes with Co-Authored-By line
+# CRITICAL: Use YOUR EXACT MODEL ID in the Co-Authored-By line
+# You have access to your model ID - it's shown in your system context
 git add -A
-git commit -m "feat: description (ISSUE-XXX)"
+git commit -m "feat: description (ISSUE-XXX)
+
+Co-Authored-By: Claude <your-exact-model-id-here> <noreply@anthropic.com>"
+
+# Example for claude-sonnet-4-5-20250929:
+# git commit -m "feat: add specialist completion API
+#
+# Co-Authored-By: Claude claude-sonnet-4-5-20250929 <noreply@anthropic.com>"
 
 # 3. Push to remote
 git push -u origin $(git branch --show-current)

package/templates/context/CLAUDE.md.template

@@ -67,6 +67,28 @@ Before marking this issue complete:
 - [ ] No console errors or warnings
 - [ ] Documentation updated if needed
 
+## Responding to Review Feedback
+
+If you receive feedback from review-agent indicating issues to fix:
+
+1. **Read the feedback carefully** - Understand each issue raised
+2. **Fix all issues** - Address every item in the feedback
+3. **Test your fixes** - Ensure tests still pass
+4. **Commit and push** - Push your fixes to the remote branch
+5. **Request re-review** - Run this command:
+   ```bash
+   pan work request-review {{ISSUE_ID}} -m "Fixed: [brief summary of what you fixed]"
+   ```
+
+**Circuit breaker**: You can auto-request re-review up to 3 times. After that, a human must click "Review" in the dashboard.
+
+**Example**:
+```bash
+pan work request-review PAN-123 -m "Fixed: added real tests instead of placeholders"
+```
+
+This will queue the review-agent to re-review your changes.
+
 ## Emergency Recovery
 
 If you're resuming after a crash:

package/templates/context/REOPEN_PROMPT.md.template

@@ -0,0 +1,75 @@
+# Reopened Issue: {{ISSUE_ID}}
+
+## ⚠️ Important: This is Follow-up Work
+
+This issue was previously completed and merged. It has been **reopened** for additional work.
+
+## What This Means
+
+You are NOT starting from scratch. Instead:
+
+1. **Previous work exists** - Code has already been written, tested, and merged
+2. **Build on what's there** - Extend, fix, or enhance the existing implementation
+3. **Preserve functionality** - Don't break what's already working
+4. **Understand the context** - Review what was done before planning new work
+
+## Your Mission
+
+**{{ISSUE_ID}}**: {{ISSUE_TITLE}}
+
+### Why It Was Reopened
+
+{{REOPEN_REASON}}
+
+### What Was Previously Accomplished
+
+{{PREVIOUS_WORK_SUMMARY}}
+
+### Original Issue Description
+
+{{ISSUE_DESCRIPTION}}
+
+## Getting Started
+
+1. **Read `.planning/REOPEN.md`** - Detailed context about previous work
+2. **Read `.planning/STATE.md`** - Full implementation history
+3. **Review the codebase** - Understand what was built:
+   {{KEY_FILES}}
+4. **Check for new requirements** - Look for:
+   - New comments on the GitHub issue
+   - User feedback or bug reports
+   - Additional acceptance criteria
+5. **Plan your approach** - Identify what needs to be added/fixed
+6. **Implement carefully** - Build on the existing foundation
+7. **Test thoroughly** - Ensure both old and new functionality works
+8. **Request review** - When complete, run `pan work request-review {{ISSUE_ID}}`
+
+## Critical Guidelines
+
+- **Don't duplicate work** - Check if functionality already exists
+- **Don't break existing tests** - All {{EXISTING_TESTS}} existing tests must still pass
+- **Follow existing patterns** - Match the code style and architecture
+- **Update existing docs** - Don't create duplicate documentation
+- **Respect git history** - Review commits to understand design decisions
+
+## Workspace Info
+
+- **Branch**: {{BRANCH_NAME}}
+- **Workspace**: {{WORKSPACE_PATH}}
+- **Previous commits**: {{COMMIT_COUNT}} commits on this branch
+- **Tests**: {{TEST_COUNT}} tests currently passing
+
+## Review Workflow
+
+This reopened issue can go through the standard review workflow:
+
+1. Complete your work
+2. Commit and push: `git push -u origin {{BRANCH_NAME}}`
+3. Request review: `pan work request-review {{ISSUE_ID}} -m "Completed follow-up work"`
+4. Review-agent will review
+5. Test-agent will run tests
+6. Human will approve and merge
+
+---
+
+**Remember**: This is iterative development. You're adding to something that already works, not building from zero.