pi-inspect 0.2.0 → 0.3.0

package/extensions/inspect.ts

@@ -1,10 +1,10 @@
 import { spawn, spawnSync, type ChildProcess } from "node:child_process";
-import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { mkdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
 import { createConnection } from "node:net";
 import { homedir } from "node:os";
 import { join as joinPath, resolve as resolvePath } from "node:path";
 import { fileURLToPath } from "node:url";
-import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import { type ExtensionAPI, parseFrontmatter } from "@earendil-works/pi-coding-agent";
 
 const extDir = fileURLToPath(new URL(".", import.meta.url));
 const port = 5462;
@@ -100,6 +100,161 @@ function writeSnapshot(id: string, snapshot: unknown): void {
 	writeFileSync(joinPath(SNAP_DIR, `${sanitize(id)}.json`), JSON.stringify(snapshot, null, 2), "utf8");
 }
 
+type DisabledKind = "command" | "skill" | "extension" | "theme";
+type DisabledScope = "user" | "project";
+type DisabledItem = {
+	kind: DisabledKind;
+	name: string;
+	displayName: string;
+	description: string;
+	source: string;
+	scope: DisabledScope;
+	settingsPath: string;
+	path: string;
+	reason: string;
+};
+
+const AGENT_DIR = joinPath(homedir(), ".pi", "agent");
+const SETTINGS_PATH = joinPath(AGENT_DIR, "settings.json");
+const NPM_ROOT = joinPath(AGENT_DIR, "npm", "node_modules");
+
+type FilterKind = "prompts" | "skills" | "extensions" | "themes";
+const FILTER_KINDS: readonly FilterKind[] = ["prompts", "skills", "extensions", "themes"];
+
+const KIND_CFG: Record<FilterKind, { kind: DisabledKind; stripExt: RegExp; display: (n: string) => string }> = {
+	prompts:    { kind: "command",   stripExt: /\.md$/i,                  display: (n) => `/${n}` },
+	skills:     { kind: "skill",     stripExt: /\.md$/i,                  display: (n) => `/skill:${n}` },
+	extensions: { kind: "extension", stripExt: /\.(ts|js|mjs|cjs)$/i,     display: (n) => n },
+	themes:     { kind: "theme",     stripExt: /\.(json|toml|ya?ml)$/i,   display: (n) => n },
+};
+
+function resolvePackageRoot(source: string): string | null {
+	if (source.startsWith("npm:")) return joinPath(NPM_ROOT, source.slice(4));
+	let s = source.replace(/\\/g, "/");
+	if (s.startsWith("~/")) s = joinPath(homedir(), s.slice(2));
+	try { return statSync(s).isDirectory() ? s : null; } catch { return null; }
+}
+
+function sourceLabel(source: string): string {
+	if (source.startsWith("npm:")) return source.slice(4);
+	const norm = source.replace(/\\/g, "/").replace(/\/$/, "");
+	return norm.split("/").pop() ?? norm;
+}
+
+const describeCache = new Map<string, { mtimeMs: number; desc: string }>();
+
+function describeFrom(filePath: string, isDir: boolean): string {
+	const path = isDir ? joinPath(filePath, "SKILL.md") : filePath;
+	let mtimeMs: number;
+	try { mtimeMs = statSync(path).mtimeMs; } catch { return ""; }
+	const cached = describeCache.get(path);
+	if (cached && cached.mtimeMs === mtimeMs) return cached.desc;
+	let desc = "";
+	try {
+		const { frontmatter, body } = parseFrontmatter<{ description?: string }>(readFileSync(path, "utf8"));
+		desc = typeof frontmatter.description === "string" && frontmatter.description
+			? frontmatter.description
+			: body.split(/\r?\n/).find((l) => l.trim() && !l.trim().startsWith("#"))?.trim().slice(0, 240) ?? "";
+	} catch {}
+	describeCache.set(path, { mtimeMs, desc });
+	return desc;
+}
+
+function nameFromRel(filterKind: FilterKind, rel: string): string {
+	const base = rel.split("/").pop() ?? rel;
+	if (filterKind === "skills" && /SKILL\.md$/i.test(base)) {
+		const parent = rel.replace(/\/SKILL\.md$/i, "").split("/").pop();
+		return parent ?? base;
+	}
+	return base.replace(KIND_CFG[filterKind].stripExt, "");
+}
+
+type GroupCtx = {
+	root: string;
+	label: string;
+	scope: DisabledScope;
+	settingsPath: string;
+};
+
+function pushDisabled(
+	items: DisabledItem[],
+	filterKind: FilterKind,
+	raw: unknown,
+	ctx: GroupCtx,
+): void {
+	if (typeof raw !== "string" || !raw.startsWith("-")) return;
+	const rel = raw.slice(1).replace(/\\/g, "/");
+	const filePath = joinPath(ctx.root, rel);
+	let isDir = false;
+	try { isDir = statSync(filePath).isDirectory(); } catch { return; }
+	const cfg = KIND_CFG[filterKind];
+	const name = nameFromRel(filterKind, rel);
+	items.push({
+		kind: cfg.kind,
+		name,
+		displayName: cfg.display(name),
+		description: describeFrom(filePath, isDir),
+		source: ctx.label,
+		scope: ctx.scope,
+		settingsPath: ctx.settingsPath,
+		path: filePath,
+		reason: raw,
+	});
+}
+
+function collectGroup(items: DisabledItem[], group: any, ctx: GroupCtx): void {
+	for (const filterKind of FILTER_KINDS) {
+		const arr = group?.[filterKind];
+		if (!Array.isArray(arr)) continue;
+		for (const raw of arr) pushDisabled(items, filterKind, raw, ctx);
+	}
+}
+
+const settingsCache = new Map<string, { mtimeMs: number; items: DisabledItem[] }>();
+
+function readDisabledFrom(
+	settingsPath: string,
+	baseDir: string,
+	scope: DisabledScope,
+): DisabledItem[] {
+	let mtimeMs: number;
+	try { mtimeMs = statSync(settingsPath).mtimeMs; } catch { return []; }
+	const cached = settingsCache.get(settingsPath);
+	if (cached && cached.mtimeMs === mtimeMs) return cached.items;
+
+	let settings: any;
+	try { settings = JSON.parse(readFileSync(settingsPath, "utf8")); } catch { return []; }
+	const items: DisabledItem[] = [];
+
+	collectGroup(items, settings, { root: baseDir, label: scope, scope, settingsPath });
+
+	const packages = Array.isArray(settings?.packages) ? settings.packages : [];
+	for (const entry of packages) {
+		if (!entry || typeof entry !== "object" || Array.isArray(entry)) continue;
+		const source = String(entry.source ?? "");
+		if (!source) continue;
+		const root = resolvePackageRoot(source);
+		if (!root) continue;
+		collectGroup(items, entry, { root, label: sourceLabel(source), scope, settingsPath });
+	}
+	settingsCache.set(settingsPath, { mtimeMs, items });
+	return items;
+}
+
+function discoverDisabledFromPackages(cwd: string | null): DisabledItem[] {
+	const scopes: { settings: string; base: string; scope: DisabledScope }[] = [
+		{ settings: SETTINGS_PATH, base: AGENT_DIR, scope: "user" },
+	];
+	if (cwd) scopes.push({ settings: joinPath(cwd, ".pi", "settings.json"), base: joinPath(cwd, ".pi"), scope: "project" });
+
+	// Project overrides user when both disable the same path.
+	const byPath = new Map<string, DisabledItem>();
+	for (const { settings, base, scope } of scopes) {
+		for (const it of readDisabledFrom(settings, base, scope)) byPath.set(it.path, it);
+	}
+	return [...byPath.values()];
+}
+
 function captureSnapshot(ctx: any): { id: string; entry: IndexEntry } | null {
 	const sm = ctx.sessionManager;
 	const id = sm?.getSessionId?.();
@@ -112,8 +267,9 @@ function captureSnapshot(ctx: any): { id: string; entry: IndexEntry } | null {
 	const commands = typeof pi?.getCommands === "function" ? pi.getCommands() : [];
 	const tools = typeof pi?.getAllTools === "function" ? pi.getAllTools() : [];
 	const activeTools = typeof pi?.getActiveTools === "function" ? pi.getActiveTools() : [];
+	const disabledItems = discoverDisabledFromPackages(cwd);
 	const capturedAt = Date.now();
-	const snap = { sessionId: id, sessionName: name, cwd, model, systemPrompt, commands, tools, activeTools, capturedAt };
+	const snap = { sessionId: id, sessionName: name, cwd, model, systemPrompt, commands, tools, activeTools, disabledItems, capturedAt };
 	try {
 		writeSnapshot(id, snap);
 		upsertIndex({ id, cwd, name, model, capturedAt });

package/lib/snapshot.js

@@ -40,6 +40,49 @@ async function readSnapshot(sessionId) {
   }
 }
 
+async function writeIndex(sessions) {
+  await fsp.mkdir(SNAPSHOT_DIR, { recursive: true });
+  await fsp.writeFile(INDEX_PATH, JSON.stringify({ sessions }, null, 2), 'utf8');
+}
+
+async function cleanupIndex() {
+  const sessions = await readIndex();
+  const kept = [];
+  const removed = [];
+  for (const s of sessions) {
+    try {
+      await fsp.access(snapshotPath(s.id));
+      kept.push(s);
+    } catch {
+      removed.push(s.id);
+    }
+  }
+  if (removed.length) await writeIndex(kept);
+  return { kept: kept.length, removed };
+}
+
+async function keepOnly(sessionId) {
+  if (!sessionId) throw new Error('sessionId required');
+  const sessions = await readIndex();
+  const kept = sessions.filter((s) => s.id === sessionId);
+  const removed = [];
+  let files;
+  try { files = await fsp.readdir(SNAPSHOT_DIR); }
+  catch { files = []; }
+  const keepPath = path.basename(snapshotPath(sessionId));
+  for (const f of files) {
+    if (!f.endsWith('.json') || f === 'index.json' || f === keepPath) continue;
+    try {
+      await fsp.unlink(path.join(SNAPSHOT_DIR, f));
+      removed.push(f.replace(/\.json$/, ''));
+    } catch (e) {
+      console.warn(`pi-inspect: unlink ${f}: ${e.message}`);
+    }
+  }
+  await writeIndex(kept);
+  return { kept: kept.length, removed };
+}
+
 async function readLatestSnapshot() {
   const sessions = await readIndex();
   if (!sessions.length) return null;
@@ -51,6 +94,9 @@ module.exports = {
   snapshotDir,
   snapshotPath,
   readIndex,
+  writeIndex,
+  cleanupIndex,
+  keepOnly,
   readSnapshot,
   readLatestSnapshot,
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-inspect",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Introspection dashboard for the pi coding agent — tools, slash commands, skills, and the system prompt injected on init.",
   "keywords": [
     "pi-package",

package/public/app.js

@@ -5,7 +5,7 @@ const state = {
   snapshot: null,
   search: '',
   kind: 'all',
-  expanded: { context: true, tool: true, command: true, skill: true },
+  expanded: { context: true, tool: true, command: true, prompt: true, skill: true },
   selected: null,
   expandAll: true,
   highlight: -1,
@@ -110,7 +110,11 @@ function inferSource(x) {
   const si = x?.sourceInfo;
   if (si) {
     if (si.label) return si.label;
-    if (si.source) return si.source.startsWith('npm:') ? si.source.slice(4) : si.source;
+    if (si.source) {
+      const src = si.source.startsWith('npm:') ? si.source.slice(4) : si.source;
+      if (src === 'auto' && si.scope) return si.scope;
+      return src;
+    }
     if (si.origin) return si.origin;
     if (si.kind) return si.kind;
   }
@@ -122,16 +126,20 @@ function buildItems() {
   const s = state.snapshot;
   if (!s) return [];
   const items = [];
+  const activeSet = new Set(s.activeTools ?? []);
+  const activeIds = new Set();
   for (const t of s.tools ?? []) {
     const description = (t.description ?? '').replace(/\s+/g, ' ').trim();
+    const id = `tool:${t.name}`;
+    activeIds.add(id);
     items.push({
       kind: 'tool',
-      id: `tool:${t.name}`,
+      id,
       name: t.name ?? '(tool)',
       source: inferSource(t),
       description,
       chars: (t.description ?? '').length,
-      active: (s.activeTools ?? []).includes(t.name),
+      active: activeSet.has(t.name),
       path: inferPath(t),
       raw: t,
     });
@@ -139,18 +147,39 @@ function buildItems() {
   for (const c of s.commands ?? []) {
     const name = c.name ?? c.command ?? '';
     const isSkill = name.startsWith('skill:');
+    const src = inferSource(c);
+    const isPrompt = !isSkill && c.source === 'prompt';
+    const kind = isSkill ? 'skill' : isPrompt ? 'prompt' : 'command';
     const description = (c.description ?? '').replace(/\s+/g, ' ').trim();
+    const id = `${kind}:${name}`;
+    activeIds.add(id);
     items.push({
-      kind: isSkill ? 'skill' : 'command',
-      id: `${isSkill ? 'skill' : 'command'}:${name}`,
+      kind,
+      id,
       name: `/${name}`,
-      source: inferSource(c),
+      source: src,
       description,
       chars: (c.description ?? '').length,
       path: inferPath(c),
       raw: c,
     });
   }
+  for (const d of s.disabledItems ?? []) {
+    const id = `${d.kind}:${d.name}`;
+    if (activeIds.has(id)) continue;
+    const description = (d.description ?? '').replace(/\s+/g, ' ').trim();
+    items.push({
+      kind: d.kind,
+      id,
+      name: d.displayName ?? d.name,
+      source: d.source ?? '(package)',
+      description,
+      chars: (d.description ?? '').length,
+      disabled: true,
+      path: d.path ?? null,
+      raw: d,
+    });
+  }
   if (s.systemPrompt) {
     for (const part of splitSystemPrompt(s.systemPrompt, s.cwd)) {
       items.push({
@@ -189,8 +218,9 @@ function filterItems(items) {
   });
 }
 
-const KIND_ORDER = ['context', 'tool', 'command', 'skill'];
-const KIND_LABEL = { context: 'Context', tool: 'Tools', command: 'Commands', skill: 'Skills' };
+const KIND_ORDER = ['context', 'tool', 'command', 'prompt', 'skill'];
+const KIND_LABEL = { context: 'Context', tool: 'Tools', command: 'Commands', prompt: 'Prompts', skill: 'Skills' };
+const SOURCE_RANK = { user: 0, project: 1, auto: 2, builtin: 3 };
 //#endregion
 
 //#region ICONS
@@ -201,6 +231,9 @@ function iconFor(kind) {
   if (kind === 'command') {
     return `<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><polyline points="4 17 10 11 4 5"/><line x1="12" y1="19" x2="20" y2="19"/></svg>`;
   }
+  if (kind === 'prompt') {
+    return `<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M21 15a2 2 0 01-2 2H7l-4 4V5a2 2 0 012-2h14a2 2 0 012 2z"/><line x1="7" y1="9" x2="17" y2="9"/><line x1="7" y1="13" x2="13" y2="13"/></svg>`;
+  }
   if (kind === 'skill') {
     return `<svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><polygon points="13 2 3 14 12 14 11 22 21 10 12 10 13 2"/></svg>`;
   }
@@ -334,11 +367,9 @@ function renderTree() {
       const useSubgroups = bySource.size > 1 && kind !== 'context';
       const sources = useSubgroups
         ? [...bySource.keys()].sort((a, b) => {
-            const rank = (s) => {
-              const i = ['auto', 'builtin'].indexOf(s);
-              return i === -1 ? Infinity : i;
-            };
-            return (rank(a) - rank(b)) || a.localeCompare(b);
+            const ra = SOURCE_RANK[a] ?? Infinity;
+            const rb = SOURCE_RANK[b] ?? Infinity;
+            return (ra - rb) || a.localeCompare(b);
           })
         : ['__all__'];
       if (!useSubgroups) bySource.set('__all__', list);
@@ -367,8 +398,9 @@ function renderTree() {
             const descHtml = it.description
               ? `<span class="tree-desc">${esc(it.description)}</span><div class="spacer"></div>`
               : '<div class="spacer"></div>';
+            const disabledCls = it.disabled ? ' disabled' : '';
             html.push(`
-              <div class="tree-row ${selected}" data-item="${esc(it.id)}" style="padding-left:${pad}px">
+              <div class="tree-row ${selected}${disabledCls}" data-item="${esc(it.id)}" style="padding-left:${pad}px">
                 <div class="tree-icon">${iconFor(it.kind)}</div>
                 <div class="tree-label">${esc(it.name)}</div>
                 ${descHtml}
@@ -443,6 +475,8 @@ function renderDetail() {
     `);
   }
 
+  const scope = it.raw?.scope;
+  const settingsPath = it.raw?.settingsPath;
   bodySections.push(`
     <div class="detail-section">
       <h4>Metadata</h4>
@@ -450,6 +484,8 @@ function renderDetail() {
         <span class="detail-meta-item">Kind: ${esc(it.kind)}</span>
         <span class="detail-meta-item">Source: ${esc(it.source)}</span>
         ${it.active != null ? `<span class="detail-meta-item">Active: ${it.active ? 'yes' : 'no'}</span>` : ''}
+        ${it.disabled ? `<span class="detail-meta-item">Disabled${scope ? ` (${esc(scope)})` : ''}</span>` : ''}
+        ${settingsPath ? `<span class="detail-meta-item">Settings: ${esc(settingsPath)}</span>` : ''}
       </div>
     </div>
   `);
@@ -582,6 +618,33 @@ function bindEvents() {
     toast('refreshed');
   });
 
+  $('cleanupSessionsBtn').addEventListener('click', async () => {
+    const keep = state.currentSessionId;
+    if (!keep) { toast('select a session first'); return; }
+    const others = state.sessions.filter((s) => s.id !== keep).length;
+    if (!others) { toast('only one session — nothing to remove'); return; }
+    if (!confirm(`Delete ${others} other snapshot${others === 1 ? '' : 's'} and keep only the selected session?`)) return;
+    const btn = $('cleanupSessionsBtn');
+    btn.classList.add('loading');
+    try {
+      const r = await fetch('/api/sessions/cleanup', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ keep }),
+      });
+      const data = await r.json();
+      if (!r.ok || data.ok === false) throw new Error(data.error || `HTTP ${r.status}`);
+      const n = data.removed?.length ?? 0;
+      await loadSessions();
+      renderTopbar();
+      toast(n ? `removed ${n} session${n === 1 ? '' : 's'}` : 'nothing to remove');
+    } catch (e) {
+      toast(`cleanup failed: ${e.message}`);
+    } finally {
+      btn.classList.remove('loading');
+    }
+  });
+
   $('themeBtn').addEventListener('click', () => {
     document.body.classList.toggle('light');
     try {

package/public/index.html

@@ -31,9 +31,13 @@
       <option value="context">Context</option>
       <option value="tool">Tools</option>
       <option value="command">Commands</option>
+      <option value="prompt">Prompts</option>
       <option value="skill">Skills</option>
     </select>
     <select class="topbar-select" id="sessionSelect" title="Switch session"></select>
+    <button class="topbar-btn" id="cleanupSessionsBtn" title="Delete all snapshots except the selected session">
+      <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><polyline points="3 6 5 6 21 6"/><path d="M19 6l-2 14a2 2 0 01-2 2H9a2 2 0 01-2-2L5 6"/><path d="M10 11v6"/><path d="M14 11v6"/><path d="M9 6V4a2 2 0 012-2h2a2 2 0 012 2v2"/></svg>
+    </button>
     <div class="topbar-project" id="projectBtn" title="Current cwd">
       <svg width="14" height="14" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M22 19a2 2 0 01-2 2H4a2 2 0 01-2-2V5a2 2 0 012-2h5l2 3h9a2 2 0 012 2z"/></svg>
       <span id="projectPath">—</span>

package/public/style.css

@@ -359,15 +359,30 @@ body {
   border-bottom: 1px solid var(--border);
   position: sticky;
   top: 0;
-  z-index: 2;
+  z-index: 3;
   font-size: 12px;
   text-transform: uppercase;
   letter-spacing: 0.04em;
   padding: 8px 12px;
 }
+/* Stacks under the group row (top:0); 38px matches .tree-row min-height. */
+.tree-row.marketplace-row.tree-subgroup {
+  top: 38px;
+  z-index: 2;
+}
 .tree-row.marketplace-row.virtual .tree-icon {
   color: var(--plan);
 }
+.tree-row.disabled .tree-label,
+.tree-row.disabled .tree-desc,
+.tree-row.disabled .tree-icon {
+  opacity: 0.45;
+}
+.tree-row.disabled .tree-meta {
+  color: var(--text-muted, #888);
+  font-style: italic;
+  opacity: 0.8;
+}
 
 .tree-indent {
   flex-shrink: 0;
@@ -433,10 +448,11 @@ body {
 .tree-subgroup .tree-icon { width: 14px; height: 14px; }
 .tree-subgroup .tree-icon svg { width: 14px; height: 14px; }
 .tree-meta {
-  font-size: 10px;
-  color: var(--text-muted);
+  font-size: 11px;
+  color: var(--text, inherit);
   flex-shrink: 0;
   white-space: nowrap;
+  opacity: 0.65;
 }
 .tree-desc {
   font-size: 11px;

package/server.js

@@ -40,6 +40,18 @@ app.get('/api/sessions', async (_req, res) => {
   }
 });
 
+app.post('/api/sessions/cleanup', async (req, res) => {
+  try {
+    const keep = (req.body && req.body.keep) || req.query.keep || null;
+    const result = keep
+      ? await snapshots.keepOnly(String(keep))
+      : await snapshots.cleanupIndex();
+    res.json({ ok: true, ...result });
+  } catch (e) {
+    res.status(500).json({ ok: false, error: e.message });
+  }
+});
+
 const githubMemo = new Map(); // sessionId -> Record<root, {url, source}>
 
 function collectSourceRoots(snap) {