panopticon-cli 0.5.9 → 0.5.10

package/dist/index.d.ts

@@ -390,9 +390,14 @@ interface MigrationResult {
  * .panopticon directories. Removes only those symlinks, preserving any
  * user-created content (real files/directories).
  *
- * This is safe to run multiple times — it's a no-op if no symlinks remain.
+ * This is safe to run multiple times — it's a no-op if nothing remains to clean up.
+ *
+ * Removes two kinds of stale Panopticon content from ~/.claude/:
+ * 1. Symlinks pointing to .panopticon or panopticon-cli (legacy sync method)
+ * 2. Plain directories that also exist in the devroot (stale copies from before
+ *    the devroot migration — these cause duplicate skill listings)
  */
-declare function migrateFromPersonalSymlinks(): MigrationResult;
+declare function migrateStalePersonalContent(): MigrationResult;
 interface RefreshCacheResult {
     skills: {
         copied: number;
@@ -849,4 +854,4 @@ declare function setupCredentialFileAuth(provider: ProviderConfig, workspacePath
  */
 declare function clearCredentialFileAuth(workspacePath: string): void;
 
-export { AGENTS_DIR, ARCHIVES_DIR, type AnthropicModel, type ApiKeysConfig, BACKUPS_DIR, BIN_DIR, type BackupInfo, CACHE_AGENTS_DIR, CACHE_MANIFEST, CACHE_RULES_DIR, CACHE_SKILLS_DIR, CERTS_DIR, CLAUDE_DIR, CLAUDE_MD_TEMPLATES, COMMANDS_DIR, CONFIG_DIR, CONFIG_FILE, COSTS_DIR, type Comment, type ComplexityLevel, type ComplexityModels, DOCS_DIR, type DevrootSyncItem, 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, LEGACY_RUNTIME_DIRS, type LinearConfig, LinearTracker, type LinkDirection, LinkManager, type MigrationResult, type ModelId, type ModelsConfig, type NewIssue, NotImplementedError, type OpenAIModel, PANOPTICON_HOME, PRDS_DIR, PRD_DRAFTS_DIR, PRD_PUBLISHED_DIR, PROJECT_DOCS_SUBDIR, PROJECT_PRDS_ACTIVE_SUBDIR, PROJECT_PRDS_COMPLETED_SUBDIR, PROJECT_PRDS_PLANNED_SUBDIR, PROJECT_PRDS_SUBDIR, PROVIDERS, type PanopticonConfig, type ProviderAuthType, type ProviderCompatibility, type ProviderConfig, type ProviderName, type RallyConfig, type RefreshCacheResult, type RemoteConfig, type RemoteFlyConfig, SETTINGS_FILE, SKILLS_DIR, SOURCE_AGENTS_DIR, SOURCE_DEV_SKILLS_DIR, SOURCE_RULES_DIR, SOURCE_SCRIPTS_DIR, SOURCE_SKILLS_DIR, SOURCE_TEMPLATES_DIR, SOURCE_TRAEFIK_TEMPLATES, SYNC_TARGET, type SettingsConfig, type ShadowConfig, 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, clearCredentialFileAuth, createBackup, createBackupTimestamp, createTracker, createTrackerFromConfig, detectShell, executeSync, findDevrootForProject, formatIssueRef, getAgentCommand, getAliasInstructions, getAllTrackers, getAvailableModels, getClaudeModelFlag, getDashboardApiUrl, getDefaultConfig, getDefaultSettings, getDevrootPath, getDirectProviders, getLinkManager, getPanopticonHome, getPrimaryTracker, getProviderEnv, getProviderForModel, getRouterProviders, getSecondaryTracker, getShellRcFile, hasAlias, isAnthropicModel, isDevMode, isPanopticonSymlink, listBackups, loadConfig, loadSettings, migrateFromPersonalSymlinks, needsRouter, parseIssueRef, planHooksSync, planSync, refreshCache, requiresRouter, restoreBackup, saveConfig, saveSettings, setupCredentialFileAuth, syncHooks, syncStatusline, validateSettings };
+export { AGENTS_DIR, ARCHIVES_DIR, type AnthropicModel, type ApiKeysConfig, BACKUPS_DIR, BIN_DIR, type BackupInfo, CACHE_AGENTS_DIR, CACHE_MANIFEST, CACHE_RULES_DIR, CACHE_SKILLS_DIR, CERTS_DIR, CLAUDE_DIR, CLAUDE_MD_TEMPLATES, COMMANDS_DIR, CONFIG_DIR, CONFIG_FILE, COSTS_DIR, type Comment, type ComplexityLevel, type ComplexityModels, DOCS_DIR, type DevrootSyncItem, 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, LEGACY_RUNTIME_DIRS, type LinearConfig, LinearTracker, type LinkDirection, LinkManager, type MigrationResult, type ModelId, type ModelsConfig, type NewIssue, NotImplementedError, type OpenAIModel, PANOPTICON_HOME, PRDS_DIR, PRD_DRAFTS_DIR, PRD_PUBLISHED_DIR, PROJECT_DOCS_SUBDIR, PROJECT_PRDS_ACTIVE_SUBDIR, PROJECT_PRDS_COMPLETED_SUBDIR, PROJECT_PRDS_PLANNED_SUBDIR, PROJECT_PRDS_SUBDIR, PROVIDERS, type PanopticonConfig, type ProviderAuthType, type ProviderCompatibility, type ProviderConfig, type ProviderName, type RallyConfig, type RefreshCacheResult, type RemoteConfig, type RemoteFlyConfig, SETTINGS_FILE, SKILLS_DIR, SOURCE_AGENTS_DIR, SOURCE_DEV_SKILLS_DIR, SOURCE_RULES_DIR, SOURCE_SCRIPTS_DIR, SOURCE_SKILLS_DIR, SOURCE_TEMPLATES_DIR, SOURCE_TRAEFIK_TEMPLATES, SYNC_TARGET, type SettingsConfig, type ShadowConfig, 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, clearCredentialFileAuth, createBackup, createBackupTimestamp, createTracker, createTrackerFromConfig, detectShell, executeSync, findDevrootForProject, formatIssueRef, getAgentCommand, getAliasInstructions, getAllTrackers, getAvailableModels, getClaudeModelFlag, getDashboardApiUrl, getDefaultConfig, getDefaultSettings, getDevrootPath, getDirectProviders, getLinkManager, getPanopticonHome, getPrimaryTracker, getProviderEnv, getProviderForModel, getRouterProviders, getSecondaryTracker, getShellRcFile, hasAlias, isAnthropicModel, isDevMode, isPanopticonSymlink, listBackups, loadConfig, loadSettings, migrateStalePersonalContent, needsRouter, parseIssueRef, planHooksSync, planSync, refreshCache, requiresRouter, restoreBackup, saveConfig, saveSettings, setupCredentialFileAuth, syncHooks, syncStatusline, validateSettings };

package/dist/index.js

@@ -13,7 +13,7 @@ import {
   hasAlias,
   isPanopticonSymlink,
   listBackups,
-  migrateFromPersonalSymlinks,
+  migrateStalePersonalContent,
   parseIssueRef,
   planHooksSync,
   planSync,
@@ -21,7 +21,7 @@ import {
   restoreBackup,
   syncHooks,
   syncStatusline
-} from "./chunk-GM22HPYS.js";
+} from "./chunk-H7T35QDO.js";
 import "./chunk-AQXETQHW.js";
 import {
   PROVIDERS,
@@ -213,7 +213,7 @@ export {
   listBackups,
   loadConfig,
   loadSettings,
-  migrateFromPersonalSymlinks,
+  migrateStalePersonalContent,
   needsRouter,
   parseIssueRef,
   planHooksSync,

package/dist/{label-cleanup-4HJVX6NP.js → label-cleanup-4IVZIPGK.js}

@@ -3,7 +3,7 @@ import {
   stepFailed,
   stepOk,
   stepSkipped
-} from "./chunk-R4KPLLRB.js";
+} from "./chunk-SFX3BG6N.js";
 import {
   init_esm_shims
 } from "./chunk-ZHC57RCV.js";
@@ -100,4 +100,4 @@ async function cleanupLabelsLinear(ctx, apiKey) {
 export {
   cleanupMergedLabels
 };
-//# sourceMappingURL=label-cleanup-4HJVX6NP.js.map
+//# sourceMappingURL=label-cleanup-4IVZIPGK.js.map

package/dist/{merge-agent-756U4NPX.js → merge-agent-6YOMGQMX.js}

@@ -8,13 +8,13 @@ import {
   recordWake,
   spawnEphemeralSpecialist,
   wakeSpecialist
-} from "./chunk-3WDSD2VK.js";
+} from "./chunk-4OQ4SXQZ.js";
 import "./chunk-JQBV3Q2W.js";
 import {
   init_workspace_config,
   replacePlaceholders
 } from "./chunk-AAP4G6U7.js";
-import "./chunk-4R6ATXYI.js";
+import "./chunk-PFA5XE2V.js";
 import "./chunk-USYP2SBE.js";
 import {
   init_config,
@@ -534,7 +534,7 @@ async function postMergeLifecycle(issueId, projectPath) {
   }
   console.log(`[merge-agent] Running post-merge cleanup for ${issueId}`);
   try {
-    const { movePrd } = await import("./archive-planning-U3AZAKWI.js");
+    const { movePrd } = await import("./archive-planning-54J6EP6A.js");
     const prdResult = await movePrd({ issueId, projectPath });
     if (prdResult.success && !prdResult.skipped) {
       console.log(`[merge-agent] \u2713 ${prdResult.details?.join("; ")}`);
@@ -548,7 +548,7 @@ async function postMergeLifecycle(issueId, projectPath) {
     console.warn(`[merge-agent] Could not move PRD: ${err}`);
   }
   try {
-    const { cleanPlanningArtifacts } = await import("./clean-planning-7Z5YY64X.js");
+    const { cleanPlanningArtifacts } = await import("./clean-planning-V4SSVU26.js");
     const cleanResult = await cleanPlanningArtifacts({ issueId, projectPath });
     if (cleanResult.success && !cleanResult.skipped) {
       console.log(`[merge-agent] \u2713 ${cleanResult.details?.join("; ")}`);
@@ -563,7 +563,7 @@ async function postMergeLifecycle(issueId, projectPath) {
   }
   closeIssueWithCircuitBreaker(issueId, projectPath);
   try {
-    const { cleanupMergedLabels } = await import("./label-cleanup-4HJVX6NP.js");
+    const { cleanupMergedLabels } = await import("./label-cleanup-4IVZIPGK.js");
     const ghResolved = resolveGitHubIssue(issueId);
     const labelCtx = ghResolved.isGitHub ? { issueId, projectPath, github: { owner: ghResolved.owner, repo: ghResolved.repo, number: ghResolved.number } } : { issueId, projectPath };
     const labelResult = await cleanupMergedLabels(labelCtx);
@@ -579,7 +579,7 @@ async function postMergeLifecycle(issueId, projectPath) {
     console.warn(`[merge-agent] Could not clean labels: ${err}`);
   }
   try {
-    const { compactBeads } = await import("./compact-beads-72SHALOL.js");
+    const { compactBeads } = await import("./compact-beads-YQDVF6FQ.js");
     const beadsResult = await compactBeads({ issueId, projectPath });
     if (beadsResult.success && !beadsResult.skipped) {
       console.log(`[merge-agent] \u2713 ${beadsResult.details?.join("; ")}`);
@@ -589,7 +589,7 @@ async function postMergeLifecycle(issueId, projectPath) {
     console.warn(`[merge-agent] Beads compaction failed: ${err}`);
   }
   try {
-    const { getAgentState, saveAgentState } = await import("./agents-M2ZOZL3P.js");
+    const { getAgentState, saveAgentState } = await import("./agents-MOMDECON.js");
     const { killSession, sessionExists: sessionExists2 } = await import("./tmux-X2I5SAIJ.js");
     const agentId = `agent-${issueId.toLowerCase()}`;
     const agentState = getAgentState(agentId);
@@ -609,8 +609,8 @@ async function postMergeLifecycle(issueId, projectPath) {
     console.warn(`[merge-agent] Could not kill agent sessions: ${err}`);
   }
   try {
-    const { findWorkspacePath } = await import("./archive-planning-U3AZAKWI.js");
-    const { stopWorkspaceDocker } = await import("./workspace-manager-OWHLR5BL.js");
+    const { findWorkspacePath } = await import("./archive-planning-54J6EP6A.js");
+    const { stopWorkspaceDocker } = await import("./workspace-manager-Z57ROWBQ.js");
     const issueLower = issueId.toLowerCase();
     const workspacePath = findWorkspacePath(projectPath, issueLower);
     if (workspacePath) {
@@ -636,7 +636,7 @@ function closeIssueWithCircuitBreaker(issueId, projectPath) {
   }
   (async () => {
     try {
-      const { closeIssue } = await import("./close-issue-CTZK777I.js");
+      const { closeIssue } = await import("./close-issue-5OMOP2FU.js");
       const ghResolved = resolveGitHubIssue(issueId);
       const ctx = ghResolved.isGitHub ? { issueId, projectPath, github: { owner: ghResolved.owner, repo: ghResolved.repo, number: ghResolved.number } } : { issueId, projectPath };
       const results = await closeIssue(ctx, { applyLabel: false, comment: "Merged to main via Panopticon merge-agent" });
@@ -1210,7 +1210,7 @@ Report any issues or conflicts you encountered.`;
     console.warn(`[merge-agent] Could not resolve project for ${issueId} \u2014 falling back to global specialist. Check projects.yaml configuration.`);
   }
   if (mergeProjectKey) {
-    const { getAgentRuntimeState, saveAgentRuntimeState } = await import("./agents-M2ZOZL3P.js");
+    const { getAgentRuntimeState, saveAgentRuntimeState } = await import("./agents-MOMDECON.js");
     const IDLE_POLL_INTERVAL = 3e3;
     const IDLE_MAX_WAIT = 36e4;
     const idleStart = Date.now();
@@ -1722,4 +1722,4 @@ export {
   spawnMergeAgentForBranches,
   syncMainIntoWorkspace
 };
-//# sourceMappingURL=merge-agent-756U4NPX.js.map
+//# sourceMappingURL=merge-agent-6YOMGQMX.js.map

package/dist/{specialist-context-UBVUUFJV.js → specialist-context-GVF4DV3M.js}

@@ -1,12 +1,12 @@
 import {
   getRecentRunLogs,
   init_specialist_logs
-} from "./chunk-3WDSD2VK.js";
+} from "./chunk-4OQ4SXQZ.js";
 import "./chunk-JQBV3Q2W.js";
 import {
   getModelId,
   init_work_type_router
-} from "./chunk-4R6ATXYI.js";
+} from "./chunk-PFA5XE2V.js";
 import "./chunk-USYP2SBE.js";
 import "./chunk-QAJAJBFW.js";
 import {
@@ -257,4 +257,4 @@ export {
   regenerateContextDigest,
   scheduleDigestGeneration
 };
-//# sourceMappingURL=specialist-context-UBVUUFJV.js.map
+//# sourceMappingURL=specialist-context-GVF4DV3M.js.map

package/dist/{specialist-logs-FQRI3AIS.js → specialist-logs-W47SAAIU.js}

@@ -16,9 +16,9 @@ import {
   isRunLogActive,
   listRunLogs,
   parseLogMetadata
-} from "./chunk-3WDSD2VK.js";
+} from "./chunk-4OQ4SXQZ.js";
 import "./chunk-JQBV3Q2W.js";
-import "./chunk-4R6ATXYI.js";
+import "./chunk-PFA5XE2V.js";
 import "./chunk-USYP2SBE.js";
 import "./chunk-QAJAJBFW.js";
 import "./chunk-7ZB5D46Y.js";
@@ -45,4 +45,4 @@ export {
   listRunLogs,
   parseLogMetadata
 };
-//# sourceMappingURL=specialist-logs-FQRI3AIS.js.map
+//# sourceMappingURL=specialist-logs-W47SAAIU.js.map

package/dist/{specialists-CXRGSJY3.js → specialists-SIXRWCZ3.js}

@@ -55,9 +55,9 @@ import {
   wakeSpecialist,
   wakeSpecialistOrQueue,
   wakeSpecialistWithTask
-} from "./chunk-3WDSD2VK.js";
+} from "./chunk-4OQ4SXQZ.js";
 import "./chunk-JQBV3Q2W.js";
-import "./chunk-4R6ATXYI.js";
+import "./chunk-PFA5XE2V.js";
 import "./chunk-USYP2SBE.js";
 import "./chunk-QAJAJBFW.js";
 import "./chunk-7ZB5D46Y.js";
@@ -123,4 +123,4 @@ export {
   wakeSpecialistOrQueue,
   wakeSpecialistWithTask
 };
-//# sourceMappingURL=specialists-CXRGSJY3.js.map
+//# sourceMappingURL=specialists-SIXRWCZ3.js.map

package/dist/{workspace-manager-OWHLR5BL.js → workspace-manager-Z57ROWBQ.js}

@@ -4,7 +4,7 @@ import {
   preTrustDirectory,
   removeWorkspace,
   stopWorkspaceDocker
-} from "./chunk-KPGVCGST.js";
+} from "./chunk-BHRMW7BY.js";
 import "./chunk-JT4O4YVM.js";
 import "./chunk-ZWZNEA26.js";
 import "./chunk-DW3PKGIS.js";
@@ -19,4 +19,4 @@ export {
   removeWorkspace,
   stopWorkspaceDocker
 };
-//# sourceMappingURL=workspace-manager-OWHLR5BL.js.map
+//# sourceMappingURL=workspace-manager-Z57ROWBQ.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "panopticon-cli",
-  "version": "0.5.9",
+  "version": "0.5.10",
   "description": "Multi-agent orchestration for AI coding assistants (Claude Code, Codex, Cursor, Gemini CLI)",
   "keywords": [
     "ai-agents",

package/skills/pan-new-project/SKILL.md

@@ -266,7 +266,7 @@ Validation: 8/8 checks passed
 
 Next steps:
   1. Create issues on <tracker>
-  2. Run: pan opus-plan <PREFIX>-<N>  (plan with Opus)
+  2. Run: pan plan <PREFIX>-<N>  (plan with Opus)
   3. Run: pan work issue <PREFIX>-<N> (spawn implementation agent)
 ```
 

package/skills/pan-oversee/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: pan-oversee
-description: Actively supervise an agent through the full work lifecycle, fixing infrastructure issues as they arise
+description: Test the Panopticon framework by supervising an agent through the full lifecycle, identifying and filing every bug encountered
 triggers:
   - oversee issue
   - oversee agent
@@ -17,15 +17,35 @@ allowed-tools:
   - Task
 ---
 
-# Pan Oversee — Active Agent Supervision
+# Pan Oversee — Panopticon Framework Testing
 
 ## Purpose
 
-Actively supervise an agent working on an issue through the **entire lifecycle**:
+**This skill exists to test the Panopticon framework itself.** The issue being overseen is a test payload — the real goal is exercising the full agent lifecycle pipeline and identifying every bug, glitch, and rough edge along the way.
+
+Supervise an agent working on an issue through the **entire lifecycle**:
 `spawn/resume → work → completion → review → feedback loop → test → merge-ready`
 
-This is NOT passive monitoring — you actively watch for breakdowns at each stage
-and fix the underlying Panopticon infrastructure code when something fails.
+This is NOT passive monitoring. You are actively:
+- **Watching for bugs at every stage** — dashboard rendering, agent spawning, workspace creation, beads lifecycle, specialist handoffs, status transitions, terminal output, API responses
+- **Documenting everything** — no bug is too small. If something flickers, logs a warning, shows stale data, or doesn't match expected state, that's a finding
+- **Fixing infrastructure bugs** when they block progress, then continuing the test
+- **Filing or updating GitHub issues** (PAN-XXX) for every bug found
+
+## Bug Tracking During Oversight
+
+Maintain a running bug log throughout the session. For each finding:
+
+1. **Note it immediately** — don't wait until the end. Capture the symptom, what you expected, and what actually happened.
+2. **Check for existing issues** — `gh issue list --search "keyword"` before filing duplicates
+3. **File new issues or update existing ones** — include reproduction context from this oversight run
+4. **Categorize severity:**
+   - **Blocker** — stops the pipeline, had to fix inline to continue
+   - **Bug** — incorrect behavior but pipeline continued
+   - **Cosmetic** — dashboard display issue, misleading status, stale data
+   - **Observation** — not clearly a bug but worth investigating
+
+At the end of the oversight session, **report a summary** to the user of all findings: what was filed, what was updated, what was fixed inline, and what needs follow-up.
 
 ## Usage
 
@@ -306,13 +326,28 @@ pan work approve PAN-{ID}
 
 When you find a bug in the Panopticon infrastructure:
 
-1. **Stop the agent** (if it's actively hitting the bug)
-2. **Identify the root cause** in the source code
-3. **Fix the code** — edit the relevant file(s)
-4. **Rebuild if needed** — `npx tsup` or restart dashboard
-5. **Resume/restart the agent** to continue from where it left off
+1. **Log the finding** — add to your running bug list with symptom, expected behavior, and actual behavior
+2. **Check for existing issues** — `gh issue list --state open --search "keyword"` to avoid duplicates
+3. **File or update a GitHub issue** — include context from this oversight run
+4. **Assess: blocker or not?**
+   - **If blocker:** Stop the agent, fix the code, rebuild (`npx tsup` or restart dashboard), resume the agent, continue testing
+   - **If not blocker:** Log it, file the issue, keep going — don't derail the test run for non-blocking bugs
+5. **After fixing a blocker**, verify the fix actually works by continuing through the same pipeline stage
 6. **Continue monitoring** from the current phase
 
+### What Counts as a Bug
+
+Be thorough. All of these are findings worth logging:
+- Dashboard shows wrong status, stale data, or flickers
+- Agent state file says one thing, dashboard shows another
+- Beads not created, duplicated, or disappearing
+- Specialist doesn't wake up or takes too long
+- Terminal output garbled or missing
+- API returns unexpected response
+- Status transition skipped or out of order
+- Workspace in inconsistent state (e.g., directory exists but no git worktree)
+- Any error in server logs, even if the pipeline recovers
+
 ## Key API Endpoints
 
 | Endpoint | Method | Purpose |