@wonderwhy-er/desktop-commander 0.2.38 → 0.2.39

package/dist/ui/file-preview/types.d.ts

@@ -0,0 +1 @@
+export type HtmlPreviewMode = 'rendered' | 'source';

package/dist/ui/server-integration.d.ts

@@ -0,0 +1,13 @@
+export declare function listUiResources(): {
+    uri: string;
+    name: string;
+    description: string;
+    mimeType: string;
+}[];
+export declare function readUiResource(uri: string): Promise<{
+    contents: {
+        uri: string;
+        mimeType: string;
+        text: string;
+    }[];
+} | null>;

package/dist/ui/server-integration.js

@@ -0,0 +1,31 @@
+import { CONFIG_EDITOR_RESOURCE, FILE_PREVIEW_RESOURCE, getConfigEditorResourceText, getFilePreviewResourceText, } from './resources.js';
+import { CONFIG_EDITOR_RESOURCE_URI, FILE_PREVIEW_RESOURCE_URI } from './contracts.js';
+const READABLE_UI_RESOURCES = {
+    [FILE_PREVIEW_RESOURCE_URI]: {
+        mimeType: FILE_PREVIEW_RESOURCE.mimeType,
+        getText: getFilePreviewResourceText,
+    },
+    [CONFIG_EDITOR_RESOURCE_URI]: {
+        mimeType: CONFIG_EDITOR_RESOURCE.mimeType,
+        getText: getConfigEditorResourceText,
+    },
+};
+export function listUiResources() {
+    return [FILE_PREVIEW_RESOURCE, CONFIG_EDITOR_RESOURCE];
+}
+export async function readUiResource(uri) {
+    const resource = READABLE_UI_RESOURCES[uri];
+    if (!resource) {
+        return null;
+    }
+    const resourceText = await resource.getText();
+    return {
+        contents: [
+            {
+                uri,
+                mimeType: resource.mimeType,
+                text: resourceText,
+            },
+        ],
+    };
+}

package/dist/ui/shared/ToolHeader.d.ts

@@ -0,0 +1,9 @@
+export interface ToolHeaderConfig {
+    pillLabel: string;
+    pillClassName?: string;
+    title: string;
+    subtitle: string;
+    badges: string[];
+    actionsHtml: string;
+}
+export declare function renderToolHeader(config: ToolHeaderConfig): string;

package/dist/ui/shared/ToolHeader.js

@@ -0,0 +1,29 @@
+function escapeHtml(value) {
+    return value
+        .split('&').join('&')
+        .split('<').join('&lt;')
+        .split('>').join('&gt;')
+        .split('"').join('&quot;')
+        .split("'").join('&#39;');
+}
+export function renderToolHeader(config) {
+    return `
+    <header class="toolbar">
+      <div class="meta">
+        <div class="meta-main">
+          <span class="file-pill ${escapeHtml(config.pillClassName ?? '')}">${escapeHtml(config.pillLabel)}</span>
+          <div class="meta-text">
+            <span class="filename" title="${escapeHtml(config.title)}">${escapeHtml(config.title)}</span>
+            <span class="filepath" title="${escapeHtml(config.subtitle)}">${escapeHtml(config.subtitle)}</span>
+          </div>
+        </div>
+        <div class="meta-badges">
+          ${config.badges.map((badge) => `<span class="badge">${escapeHtml(badge)}</span>`).join('')}
+        </div>
+      </div>
+      <div class="actions">
+        ${config.actionsHtml}
+      </div>
+    </header>
+  `;
+}

package/dist/ui/shared/app-bootstrap.d.ts

@@ -0,0 +1,9 @@
+import { App } from '@modelcontextprotocol/ext-apps';
+import { type UiChromeState } from './host-context.js';
+export interface ConnectWithSharedHostContextOptions {
+    app: App;
+    chrome: UiChromeState;
+    onContextApplied?: () => void;
+    onConnected?: () => void | Promise<void>;
+}
+export declare function connectWithSharedHostContext(options: ConnectWithSharedHostContextOptions): Promise<void>;

package/dist/ui/shared/app-bootstrap.js

@@ -0,0 +1,15 @@
+import { applySharedHostContext } from './host-context.js';
+export async function connectWithSharedHostContext(options) {
+    const { app, chrome, onContextApplied, onConnected } = options;
+    app.onhostcontextchanged = (context) => {
+        applySharedHostContext(context, chrome);
+        onContextApplied?.();
+    };
+    await app.connect();
+    const hostContext = app.getHostContext();
+    if (hostContext) {
+        applySharedHostContext(hostContext, chrome);
+        onContextApplied?.();
+    }
+    await onConnected?.();
+}

package/dist/ui/shared/guards.d.ts

@@ -0,0 +1 @@
+export declare function isObjectRecord(value: unknown): value is Record<string, unknown>;

package/dist/ui/shared/guards.js

@@ -0,0 +1,3 @@
+export function isObjectRecord(value) {
+    return typeof value === 'object' && value !== null;
+}

package/dist/ui/shared/host-lifecycle.d.ts

@@ -6,6 +6,7 @@ interface UiHostLifecycleOptions {
     appName: string;
     appVersion?: string;
     getRootElement?: () => Element | null;
+    onHostContext?: (hostContext: Record<string, unknown>) => void;
 }
 export interface UiHostLifecycle {
     notifyRender: () => void;

package/dist/ui/shared/host-lifecycle.js

@@ -1,5 +1,5 @@
 export function createUiHostLifecycle(rpcClient, options) {
-    const { appName, appVersion = '1.0.0', getRootElement } = options;
+    const { appName, appVersion = '1.0.0', getRootElement, onHostContext } = options;
     const resolveRootElement = () => getRootElement?.() ?? (document.getElementById('app')?.firstElementChild ?? document.getElementById('app'));
     const notifySizeChanged = () => {
         const node = resolveRootElement();
@@ -23,7 +23,13 @@ export function createUiHostLifecycle(rpcClient, options) {
                 appInfo: { name: appName, version: appVersion },
                 appCapabilities: {},
                 protocolVersion: '2026-01-26',
-            }).then(() => {
+            }).then((response) => {
+                if (onHostContext && response !== null && typeof response === 'object') {
+                    const hostContext = response.hostContext;
+                    if (hostContext !== null && typeof hostContext === 'object') {
+                        onHostContext(hostContext);
+                    }
+                }
                 rpcClient.notify('ui/notifications/initialized', {});
             }).catch(() => {
                 // Initialization handshake failure should not break rendering.

package/dist/ui/shared/widget-state.d.ts

@@ -23,6 +23,11 @@ export declare function isChatGPT(): boolean;
  * Create a widget state storage adapter.
  *
  * On ChatGPT: Uses window.openai.widgetState for persistence
- * On other hosts: Returns no-op adapter (state comes from ui/notifications/tool-result)
+ * On other hosts: Uses sessionStorage as a fallback so the preview can survive
+ *   transient interruptions (page refresh on hosts that don't re-send tool_result,
+ *   visibility/focus loss, etc.).
+ *   The fallback cache key is scoped by app pathname and a per-frame widget id
+ *   persisted in window.name, so different widgets in the same origin/session
+ *   do not overwrite one another's cached state.
  */
 export declare function createWidgetStateStorage<T>(validator?: (state: unknown) => boolean): WidgetStateStorage<T>;

package/dist/ui/shared/widget-state.js

@@ -9,6 +9,71 @@
  * - ChatGPT: Uses window.openai.widgetState
  * - Other hosts: No-op (rely on standard ui/notifications/tool-result)
  */
+const FALLBACK_WIDGET_STATE_KEY_PREFIX = 'desktop-commander:widget-state';
+const FALLBACK_WIDGET_INSTANCE_MARKER = '__dc_widget_id__:';
+function createWidgetInstanceId() {
+    const cryptoObject = typeof globalThis.crypto === 'object' ? globalThis.crypto : undefined;
+    if (typeof cryptoObject?.randomUUID === 'function') {
+        return cryptoObject.randomUUID();
+    }
+    return `widget-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 10)}`;
+}
+function readWidgetInstanceIdFromWindowName(windowName) {
+    const markerIndex = windowName.indexOf(FALLBACK_WIDGET_INSTANCE_MARKER);
+    if (markerIndex === -1) {
+        return undefined;
+    }
+    const encodedValue = windowName
+        .slice(markerIndex + FALLBACK_WIDGET_INSTANCE_MARKER.length)
+        .split('|', 1)[0];
+    if (!encodedValue) {
+        return undefined;
+    }
+    try {
+        return decodeURIComponent(encodedValue);
+    }
+    catch {
+        return encodedValue;
+    }
+}
+function getFallbackWidgetInstanceId() {
+    if (typeof window === 'undefined') {
+        return 'unknown-instance';
+    }
+    const currentWindowName = typeof window.name === 'string' ? window.name : '';
+    const existingInstanceId = readWidgetInstanceIdFromWindowName(currentWindowName);
+    if (existingInstanceId) {
+        return existingInstanceId;
+    }
+    const instanceId = createWidgetInstanceId();
+    const marker = `${FALLBACK_WIDGET_INSTANCE_MARKER}${encodeURIComponent(instanceId)}`;
+    try {
+        window.name = currentWindowName ? `${currentWindowName}|${marker}` : marker;
+    }
+    catch {
+        // Ignore window.name write failures and fall back to the in-memory id.
+    }
+    return instanceId;
+}
+function getFallbackWidgetStateKey() {
+    if (typeof window === 'undefined') {
+        return `${FALLBACK_WIDGET_STATE_KEY_PREFIX}:unknown`;
+    }
+    const appPath = window.location.pathname || 'unknown';
+    const instanceId = getFallbackWidgetInstanceId();
+    return `${FALLBACK_WIDGET_STATE_KEY_PREFIX}:${appPath}:${encodeURIComponent(instanceId)}`;
+}
+function getSessionStorage() {
+    if (typeof window === 'undefined') {
+        return undefined;
+    }
+    try {
+        return window.sessionStorage;
+    }
+    catch {
+        return undefined;
+    }
+}
 /**
  * Check if we're running in ChatGPT (has special widget state API)
  */
@@ -20,14 +85,47 @@ export function isChatGPT() {
  * Create a widget state storage adapter.
  *
  * On ChatGPT: Uses window.openai.widgetState for persistence
- * On other hosts: Returns no-op adapter (state comes from ui/notifications/tool-result)
+ * On other hosts: Uses sessionStorage as a fallback so the preview can survive
+ *   transient interruptions (page refresh on hosts that don't re-send tool_result,
+ *   visibility/focus loss, etc.).
+ *   The fallback cache key is scoped by app pathname and a per-frame widget id
+ *   persisted in window.name, so different widgets in the same origin/session
+ *   do not overwrite one another's cached state.
  */
 export function createWidgetStateStorage(validator) {
     if (!isChatGPT()) {
-        // Other hosts don't have widget state persistence - return no-op
+        const storage = getSessionStorage();
+        const storageKey = getFallbackWidgetStateKey();
         return {
-            read: () => undefined,
-            write: () => { }
+            read() {
+                if (!storage)
+                    return undefined;
+                try {
+                    const raw = storage.getItem(storageKey);
+                    if (!raw)
+                        return undefined;
+                    const parsed = JSON.parse(raw);
+                    const payload = parsed?.payload;
+                    if (payload === undefined)
+                        return undefined;
+                    if (validator && !validator(payload))
+                        return undefined;
+                    return payload;
+                }
+                catch {
+                    return undefined;
+                }
+            },
+            write(state) {
+                if (!storage)
+                    return;
+                try {
+                    storage.setItem(storageKey, JSON.stringify({ payload: state }));
+                }
+                catch {
+                    // Ignore storage failures
+                }
+            }
         };
     }
     // ChatGPT-specific implementation

package/dist/utils/files/base.d.ts

@@ -87,6 +87,8 @@ export interface FileResult {
 export interface FileMetadata {
     /** For images */
     isImage?: boolean;
+    /** For directories (read_file fallback to listDirectory) */
+    isDirectory?: boolean;
     /** For binary files */
     isBinary?: boolean;
     /** For Excel files */

package/dist/utils/open-browser.js

@@ -24,7 +24,7 @@ export async function openBrowser(url) {
                 break;
             case 'win32':
                 // Windows 'start' is a shell builtin, use spawn with shell but pass URL as separate arg
-                spawn('cmd', ['/c', 'start', '', url], { shell: false }).on('close', (code) => {
+                spawn('cmd', ['/c', 'start', '', url], { shell: false, windowsHide: true }).on('close', (code) => {
                     code === 0 ? resolve() : reject(new Error(`Exit code ${code}`));
                 });
                 break;

package/dist/utils/ui-call-context.d.ts

@@ -0,0 +1,8 @@
+export declare const UI_CALL_CONTEXT_META_KEY = "dcUiContext";
+export interface UiCallTelemetryFields {
+    call_origin: 'ui' | 'llm';
+    ui_component?: string;
+    ui_action?: string;
+    ui_invocation_id?: string;
+}
+export declare function extractUiCallTelemetryFields(metadata: unknown): UiCallTelemetryFields;

package/dist/utils/ui-call-context.js

@@ -0,0 +1,72 @@
+// Shared key used by UI widgets to attach call-origin metadata inside tools/call _meta.
+export const UI_CALL_CONTEXT_META_KEY = 'dcUiContext';
+function normalizeLabel(value, maxLength) {
+    // Keep telemetry labels compact and query-friendly (snake-like + bounded length).
+    if (typeof value !== 'string') {
+        return undefined;
+    }
+    const trimmed = value.trim();
+    if (trimmed.length === 0) {
+        return undefined;
+    }
+    const normalized = trimmed
+        .toLowerCase()
+        .replace(/[^a-z0-9_.:-]+/g, '_')
+        .replace(/^_+|_+$/g, '')
+        .slice(0, maxLength);
+    if (normalized.length === 0) {
+        return undefined;
+    }
+    return normalized;
+}
+function normalizeInvocationId(value, maxLength) {
+    // Invocation IDs are correlation-only; strip unusual characters and cap length.
+    if (typeof value !== 'string') {
+        return undefined;
+    }
+    const trimmed = value.trim();
+    if (trimmed.length === 0) {
+        return undefined;
+    }
+    const clipped = trimmed.slice(0, maxLength);
+    const sanitized = clipped.replace(/[^A-Za-z0-9_.:-]+/g, '');
+    if (sanitized.length === 0) {
+        return undefined;
+    }
+    return sanitized;
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null;
+}
+export function extractUiCallTelemetryFields(metadata) {
+    // Default classification is LLM unless an explicit UI-origin envelope is present.
+    const base = { call_origin: 'llm' };
+    if (!isRecord(metadata)) {
+        return base;
+    }
+    const rawContext = metadata[UI_CALL_CONTEXT_META_KEY];
+    if (!isRecord(rawContext)) {
+        return base;
+    }
+    const rawOrigin = typeof rawContext.callOrigin === 'string'
+        ? rawContext.callOrigin.trim().toLowerCase()
+        : '';
+    if (rawOrigin !== 'ui') {
+        // We only elevate to UI when the caller explicitly declares callOrigin="ui".
+        return base;
+    }
+    const result = { call_origin: 'ui' };
+    const component = normalizeLabel(rawContext.uiComponent, 64);
+    if (component) {
+        result.ui_component = component;
+    }
+    const action = normalizeLabel(rawContext.uiAction, 64);
+    if (action) {
+        result.ui_action = action;
+    }
+    const invocationId = normalizeInvocationId(rawContext.uiInvocationId, 120);
+    if (invocationId) {
+        result.ui_invocation_id = invocationId;
+    }
+    return result;
+}

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const VERSION = "0.2.38";
+export declare const VERSION = "0.2.39";

package/dist/version.js

@@ -1 +1 @@
-export const VERSION = '0.2.38';
+export const VERSION = '0.2.39';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wonderwhy-er/desktop-commander",
-  "version": "0.2.38",
+  "version": "0.2.39",
   "description": "MCP server for terminal operations and file editing",
   "mcpName": "io.github.wonderwhy-er/desktop-commander",
   "license": "MIT",
@@ -86,6 +86,10 @@
     "@modelcontextprotocol/sdk": "^1.9.0",
     "@opendocsg/pdf2md": "^0.2.2",
     "@supabase/supabase-js": "^2.89.0",
+    "@tiptap/core": "^3.22.3",
+    "@tiptap/extension-image": "^3.22.3",
+    "@tiptap/pm": "^3.22.3",
+    "@tiptap/starter-kit": "^3.22.3",
     "@vscode/ripgrep": "^1.15.9",
     "cross-fetch": "^4.1.0",
     "exceljs": "^4.4.0",
@@ -103,6 +107,7 @@
     "remark-gfm": "^4.0.1",
     "remark-parse": "^11.0.0",
     "sharp": "^0.34.5",
+    "tiptap-markdown": "^0.9.0",
     "unified": "^11.0.5",
     "unpdf": "^1.4.0",
     "zod": "^3.24.1",

package/dist/data/spec-kit-prompts.json

@@ -1,123 +0,0 @@
-{
-  "version": "1.0.0",
-  "description": "Spec-Kit prompts for specification-driven development workflows",
-  "prompts": [
-    {
-      "id": "spec_001",
-      "title": "Initialize Spec-Kit Project",
-      "description": "Set up a new project with spec-driven development workflow including templates, scripts, and AI agent integration.",
-      "prompt": "Let's initialize a new spec-driven development project! 🎯\n\n**Project Setup Process:**\n\n1. **Check Current Environment**: I'll verify if we're already in a spec-kit project (look for `.specify` folder)\n2. **Initialize New Project**: Set up project structure with `specify init <project-name>`\n3. **Configure AI Integration**: Choose your preferred AI agent (claude, copilot, gemini, cursor, etc.)\n4. **Explain Workflow**: Show you the available slash commands and methodology\n\n**What's the name of your new project?**\n\n*Example: `my-photo-app` or `user-auth-service`*\n\nOnce initialized, you'll have access to the complete spec-driven workflow:\n• `/constitution` - Define project principles\n• `/specify` - Create feature specifications\n• `/plan` - Generate technical plans\n• `/tasks` - Break down into actionable tasks\n• `/implement` - Execute implementation\n\nReady to get started?",
-      "categories": ["spec-kit"],
-      "secondaryTag": "Setup",
-      "votes": 0,
-      "gaClicks": 0,
-      "icon": "Rocket",
-      "author": "GitHub Spec-Kit",
-      "verified": true
-    },
-    {
-      "id": "spec_002",
-      "title": "Create Project Constitution",
-      "description": "Define project principles and governance that will guide all development decisions and ensure consistency across features.",
-      "prompt": "Let's establish your project constitution - the foundational principles that will guide all development! 📜\n\n**Constitution Creation Process:**\n\n1. **Analyze Current Context**: I'll check if you already have a constitution and understand your project\n2. **Define Core Principles**: Create non-negotiable rules for your development process\n3. **Set Governance**: Establish how principles are updated and enforced\n4. **Sync Dependencies**: Ensure all templates align with your new principles\n\n**What principles should guide your project?**\n\n*Examples:*\n• Code quality standards (testing requirements, review processes)\n• User experience consistency (accessibility-first, performance targets)\n• Technical constraints (preferred frameworks, deployment requirements)\n• Security requirements (authentication standards, data protection)\n\n**Tell me about your project's core values and constraints:**\n\nI'll create a comprehensive constitution that includes:\n• Principle definitions with clear rationale\n• Amendment procedures and versioning\n• Compliance review expectations\n• Template synchronization\n\nThis becomes the foundation for all future specifications and technical decisions!",
-      "categories": ["spec-kit"],
-      "secondaryTag": "Setup",
-      "votes": 0,
-      "gaClicks": 0,
-      "icon": "BookOpen",
-      "author": "GitHub Spec-Kit",
-      "verified": true
-    },
-    {
-      "id": "spec_003",
-      "title": "Create Feature Specification",
-      "description": "Generate a comprehensive feature specification from natural language description using spec-kit methodology and templates.",
-      "prompt": "Let's create a detailed feature specification using the spec-kit methodology! 📋\n\n**Specification Process:**\n\n1. **Create Feature Branch**: I'll run the create-new-feature script to set up a new branch and spec file\n2. **Generate Comprehensive Spec**: Use the spec-kit template to create:\n   • User scenarios and testing approaches\n   • Functional requirements (testable and unambiguous)\n   • Key entities and data models\n   • Success criteria and acceptance criteria\n3. **Mark Clarifications**: Highlight any areas that need more detail with [NEEDS CLARIFICATION] markers\n4. **Review Checklist**: Validate completeness and business alignment\n\n**What feature do you want to build?**\n\n*Be as detailed as possible about WHAT and WHY, avoid HOW:*\n\n*Examples:*\n• \"User authentication system with login, logout, and password reset\"\n• \"Photo album management with drag-and-drop organization\"\n• \"Real-time chat with message history and user presence\"\n• \"Task management with projects, assignments, and Kanban boards\"\n\n**Feature Description:**\n\nI'll focus on:\n✅ What users need and why\n✅ Business requirements and user scenarios\n✅ Testable functional requirements\n❌ Technical implementation details (saved for planning phase)\n\nReady to create your specification?",
-      "categories": ["spec-kit"],
-      "secondaryTag": "Specification",
-      "votes": 0,
-      "gaClicks": 0,
-      "icon": "FileText",
-      "author": "GitHub Spec-Kit",
-      "verified": true
-    },
-    {
-      "id": "spec_004",
-      "title": "Clarify Specification Requirements",
-      "description": "Run structured clarification workflow to resolve ambiguous requirements and ensure specification completeness before planning.",
-      "prompt": "Let's clarify any ambiguous areas in your specification before moving to technical planning! 🔍\n\n**Clarification Workflow:**\n\n1. **Analyze Current Spec**: I'll read your feature specification and identify areas marked with [NEEDS CLARIFICATION]\n2. **Structured Questioning**: Ask targeted questions about:\n   • User types and permissions\n   • Data retention and deletion policies\n   • Performance targets and scale requirements\n   • Error handling behaviors\n   • Integration requirements\n3. **Document Answers**: Record all clarifications in the specification\n4. **Validate Completeness**: Ensure all requirements are testable and unambiguous\n\n**Current clarification areas in your spec:**\n\nI'll systematically work through each unclear aspect:\n• Who are the users and what are their roles?\n• What are the data and storage requirements?\n• What are the performance and scale expectations?\n• How should errors and edge cases be handled?\n• What integrations or external dependencies exist?\n\n**Ready to clarify your specification?**\n\n*This step is crucial for reducing rework during planning and implementation phases.*\n\nOnce clarified, your specification will be ready for technical planning with `/plan`!",
-      "categories": ["spec-kit"],
-      "secondaryTag": "Specification",
-      "votes": 0,
-      "gaClicks": 0,
-      "icon": "HelpCircle",
-      "author": "GitHub Spec-Kit",
-      "verified": true
-    },
-    {
-      "id": "spec_005",
-      "title": "Generate Technical Implementation Plan",
-      "description": "Create detailed technical plan from specification including architecture, tech stack, data models, and implementation strategy.",
-      "prompt": "Let's create a comprehensive technical implementation plan for your feature! 🏗️\n\n**Planning Process:**\n\n1. **Analyze Specification**: I'll read your feature spec and understand all requirements\n2. **Check Constitution**: Ensure alignment with project principles and constraints\n3. **Generate Implementation Plan**: Create detailed technical plan including:\n   • Architecture and tech stack decisions\n   • Data models based on key entities\n   • API contracts and interfaces\n   • Research for technical decisions\n   • Quickstart validation scenarios\n4. **Validate Against Gates**: Check simplicity, anti-abstraction, and constitutional compliance\n\n**What's your preferred technology approach?**\n\n*Specify your tech stack and architectural preferences:*\n\n*Examples:*\n• \"React with TypeScript, Node.js backend, PostgreSQL database\"\n• \"Vanilla HTML/CSS/JavaScript, SQLite for local storage\"\n• \"Python FastAPI, Redis for caching, Docker deployment\"\n• \"Vue.js frontend, .NET Core API, SQL Server database\"\n\n**Technical Context:**\n\nI'll generate:\n📋 **Implementation Plan** - Architecture and approach\n🗄️ **Data Model** - Entities and relationships\n🔌 **API Contracts** - Endpoints and specifications\n🔬 **Research Notes** - Technical decisions and rationale\n⚡ **Quickstart Guide** - Key validation scenarios\n\nReady to create your technical plan?",
-      "categories": ["spec-kit"],
-      "secondaryTag": "Planning",
-      "votes": 0,
-      "gaClicks": 0,
-      "icon": "Blueprint",
-      "author": "GitHub Spec-Kit",
-      "verified": true
-    },
-    {
-      "id": "spec_006",
-      "title": "Generate Implementation Tasks",
-      "description": "Break down technical plan into actionable, dependency-ordered tasks ready for execution with parallel execution markers.",
-      "prompt": "Let's break down your implementation plan into actionable tasks! ✅\n\n**Task Generation Process:**\n\n1. **Analyze Design Artifacts**: I'll read your plan.md, data-model.md, contracts/, and other design documents\n2. **Generate Task Breakdown**: Create specific tasks organized by phases:\n   • **Setup Tasks**: Project init, dependencies, configuration\n   • **Test Tasks [P]**: Contract tests, integration scenarios (parallel)\n   • **Core Tasks**: Models, services, CLI commands, endpoints\n   • **Integration Tasks**: Database, middleware, logging\n   • **Polish Tasks [P]**: Unit tests, performance, docs (parallel)\n3. **Order Dependencies**: Ensure proper execution sequence (TDD approach)\n4. **Mark Parallelization**: Identify tasks that can run simultaneously with [P]\n\n**Task Generation Rules:**\n• Each contract → test task marked [P]\n• Each entity → model creation task marked [P]\n• Each endpoint → implementation task\n• Different files = parallel [P]\n• Same files = sequential\n• Tests before implementation (TDD)\n\n**Additional context for task generation:**\n\n*Any specific requirements or preferences for the implementation approach?*\n\nI'll create a `tasks.md` file with:\n📝 **Numbered Tasks** (T001, T002, etc.)\n📁 **File Paths** for each task\n🔗 **Dependencies** clearly marked\n⚡ **Parallel Groups** for efficient execution\n\nReady to generate your implementation tasks?",
-      "categories": ["spec-kit"],
-      "secondaryTag": "Planning",
-      "votes": 0,
-      "gaClicks": 0,
-      "icon": "CheckSquare",
-      "author": "GitHub Spec-Kit",
-      "verified": true
-    },
-    {
-      "id": "spec_007",
-      "title": "Execute Feature Implementation",
-      "description": "Execute all implementation tasks following the task breakdown with TDD approach, dependency management, and progress tracking.",
-      "prompt": "Let's implement your feature following the spec-driven task breakdown! 🚀\n\n**Implementation Process:**\n\n1. **Load Implementation Context**: I'll read all your design documents:\n   • tasks.md (execution plan)\n   • plan.md (architecture and tech stack)\n   • data-model.md (entities and relationships)\n   • contracts/ (API specifications)\n   • research.md (technical decisions)\n\n2. **Execute Phase-by-Phase**:\n   • **Setup**: Project structure, dependencies, configuration\n   • **Tests**: Contract tests and integration scenarios (TDD)\n   • **Core**: Models, services, CLI commands, endpoints\n   • **Integration**: Database, middleware, logging\n   • **Polish**: Unit tests, performance, documentation\n\n3. **Follow Execution Rules**:\n   • Respect task dependencies (sequential vs parallel)\n   • Tests before implementation (TDD approach)\n   • File-based coordination (same file = sequential)\n   • Mark completed tasks with [X]\n\n4. **Progress Tracking**: Report after each completed task with validation\n\n**Implementation preferences:**\n\n*Any specific notes for the implementation (deployment targets, testing frameworks, etc.)?*\n\nI'll execute tasks systematically:\n✅ **Validate Prerequisites** - All documents ready\n📋 **Phase-by-Phase Execution** - Setup → Tests → Core → Integration → Polish\n🔄 **Real-time Progress** - Track completion and handle errors\n🎯 **Final Validation** - Ensure specs match implementation\n\nReady to build your feature?",
-      "categories": ["spec-kit"],
-      "secondaryTag": "Implementation",
-      "votes": 0,
-      "gaClicks": 0,
-      "icon": "Play",
-      "author": "GitHub Spec-Kit",
-      "verified": true
-    },
-    {
-      "id": "spec_008",
-      "title": "Analyze Spec-Kit Project Status",
-      "description": "Comprehensive analysis of current spec-kit project state including features, phases, and recommended next steps.",
-      "prompt": "Let me analyze your spec-kit project and show you the current state! 📊\n\n**Project Analysis Process:**\n\n1. **Project Structure Review**: I'll examine your `.specify` directory and validate:\n   • Templates and scripts availability\n   • Project constitution and principles\n   • Current branch and feature context\n\n2. **Feature Inventory**: Scan the `specs/` directory to identify:\n   • All features and their completion status\n   • Current phase (specification, planning, tasks, implementation)\n   • Missing or incomplete artifacts\n\n3. **Health Check**: Verify project follows spec-kit best practices:\n   • All required templates present\n   • Script permissions and functionality\n   • Git branch structure and workflow\n\n4. **Progress Assessment**: For the current feature:\n   • What phase are you in?\n   • What files exist vs. what's missing?\n   • What's the logical next step?\n\n**Current Project Overview:**\n\nI'll provide:\n📋 **Feature Status Matrix** - All features and their phases\n🎯 **Current Focus** - Active feature and next steps\n⚙️ **Configuration Health** - Templates and scripts status\n📈 **Recommendations** - Suggested workflow continuations\n\n**Any specific areas you'd like me to focus on?**\n\n*Examples: \"Focus on feature completion status\" or \"Check for any configuration issues\"*\n\nLet me give you a complete project status report!",
-      "categories": ["spec-kit"],
-      "secondaryTag": "Analysis",
-      "votes": 0,
-      "gaClicks": 0,
-      "icon": "BarChart3",
-      "author": "GitHub Spec-Kit",
-      "verified": true
-    },
-    {
-      "id": "spec_009",
-      "title": "Validate Spec-Kit Workflow Compliance",
-      "description": "Check project adherence to spec-kit methodology and constitutional requirements with recommendations for improvements.",
-      "prompt": "Let's validate your project's compliance with spec-kit methodology and constitutional requirements! ✅\n\n**Compliance Validation Process:**\n\n1. **Constitutional Compliance**: I'll check if your features align with project constitution:\n   • Principle adherence in specifications\n   • Technical decisions follow governance\n   • Implementation respects constraints\n\n2. **Methodology Validation**: Verify proper spec-kit workflow:\n   • Specifications focus on WHAT/WHY (not HOW)\n   • Technical plans follow from specifications\n   • Tasks properly break down implementation\n   • Test-driven development approach\n\n3. **Quality Assessment**: Review specification and planning quality:\n   • Requirements are testable and unambiguous\n   • No [NEEDS CLARIFICATION] markers remain\n   • Success criteria are measurable\n   • Technical decisions have clear rationale\n\n4. **Process Adherence**: Check workflow execution:\n   • Proper phase progression (spec → plan → tasks → implement)\n   • Branch management and version control\n   • Documentation completeness\n\n**Compliance Report:**\n\nI'll generate:\n📋 **Constitutional Alignment** - Principle compliance score\n🔄 **Workflow Adherence** - Methodology following assessment\n📝 **Quality Metrics** - Specification and planning quality\n⚠️ **Issue Identification** - Areas needing attention\n🎯 **Recommendations** - Specific improvement actions\n\n**Any specific compliance areas you're concerned about?**\n\nReady for a complete compliance assessment?",
-      "categories": ["spec-kit"],
-      "secondaryTag": "Analysis",
-      "votes": 0,
-      "gaClicks": 0,
-      "icon": "Shield",
-      "author": "GitHub Spec-Kit",
-      "verified": true
-    }
-  ]
-}

package/dist/handlers/macos-control-handlers.d.ts

@@ -1,16 +0,0 @@
-import { ServerResult } from '../types.js';
-export declare function handleMacosAxStatus(args: unknown): Promise<ServerResult>;
-export declare function handleMacosAxListApps(args: unknown): Promise<ServerResult>;
-export declare function handleMacosAxListElements(args: unknown): Promise<ServerResult>;
-export declare function handleMacosAxFind(args: unknown): Promise<ServerResult>;
-export declare function handleMacosAxGetState(args: unknown): Promise<ServerResult>;
-export declare function handleMacosAxFindAndClick(args: unknown): Promise<ServerResult>;
-export declare function handleMacosAxClick(args: unknown): Promise<ServerResult>;
-export declare function handleMacosAxType(args: unknown): Promise<ServerResult>;
-export declare function handleMacosAxKey(args: unknown): Promise<ServerResult>;
-export declare function handleMacosAxActivate(args: unknown): Promise<ServerResult>;
-export declare function handleMacosAxWaitFor(args: unknown): Promise<ServerResult>;
-export declare function handleMacosAxBatch(args: unknown): Promise<ServerResult>;
-export declare function handleElectronDebugAttach(args: unknown): Promise<ServerResult>;
-export declare function handleElectronDebugEval(args: unknown): Promise<ServerResult>;
-export declare function handleElectronDebugDisconnect(args: unknown): Promise<ServerResult>;