specforge-mcp 0.1.0

package/dist/tools/define-ui-contract-desktop/native-contract.js

@@ -0,0 +1,160 @@
+// === SPEC-014b: WPF / Avalonia MVVM pattern section ===
+/**
+ * Returns true if the project uses WPF or Avalonia (MVVM-oriented .NET desktop frameworks).
+ */
+export function isWpfOrAvaloniaProject(knowledge) {
+    const stack = knowledge.stack.map((s) => s.toLowerCase());
+    return stack.some((s) => s.includes('wpf') || s.includes('avalonia'));
+}
+/**
+ * Generate MVVM pattern section for WPF or Avalonia UI contracts.
+ */
+export function generateMvvmUIContract(screens, knowledge) {
+    const isAvalonia = knowledge.stack.some((s) => s.toLowerCase().includes('avalonia'));
+    const framework = isAvalonia ? 'Avalonia' : 'WPF';
+    const observableBase = isAvalonia
+        ? 'ReactiveUI.ReactiveObject'
+        : 'CommunityToolkit.Mvvm.ObservableObject';
+    const commandType = isAvalonia ? 'ReactiveCommand<Unit, Unit>' : 'RelayCommand';
+    const collectionType = 'ObservableCollection<T>';
+    const lines = [
+        `## ${framework} MVVM UI Contract`,
+        '',
+        '### ViewModel Pattern',
+        '',
+        `- **Base class**: \`${observableBase}\``,
+        `- **Commands**: \`${commandType}\` (auto-notifies CanExecute)`,
+        `- **Collections**: \`${collectionType}\` (triggers UI refresh on Add/Remove)`,
+        `- **Simple properties**: \`[ObservableProperty]\` attribute (CommunityToolkit) or \`RaiseAndSetIfChanged\` (ReactiveUI)`,
+        '',
+        '### XAML Binding Patterns',
+        '',
+        '```xml',
+        '<!-- Simple property binding -->',
+        '<TextBlock Text="{Binding UserName}" />',
+        '',
+        '<!-- Command binding -->',
+        '<Button Command="{Binding SaveCommand}" Content="Save" />',
+        '',
+        '<!-- ObservableCollection binding -->',
+        '<ListBox ItemsSource="{Binding Items}" SelectedItem="{Binding SelectedItem}" />',
+        '',
+        '<!-- Converter binding -->',
+        '<TextBlock Text="{Binding Count, Converter={StaticResource CountToLabelConverter}}" />',
+        '```',
+        '',
+        '### ViewModels per Screen',
+        '',
+    ];
+    for (const screen of screens) {
+        const vmName = screen.charAt(0).toUpperCase() + screen.slice(1).replace(/-/g, '') + 'ViewModel';
+        lines.push(`#### ${vmName}`);
+        lines.push('');
+        lines.push(`- **Properties**: (list observable properties for ${screen})`);
+        lines.push(`- **Commands**: (list ICommand instances for ${screen} actions)`);
+        lines.push(`- **Collections**: (list ObservableCollection<T> for list views)`);
+        lines.push('- **INotifyPropertyChanged**: auto via base class');
+        lines.push('');
+    }
+    lines.push('### Design Guidelines');
+    lines.push('');
+    lines.push('- ViewModels must NOT reference UI elements (no Window/Control references)');
+    lines.push('- Navigation via INavigationService, not direct Window instantiation');
+    lines.push('- Dialogs via IDialogService to keep ViewModels testable');
+    lines.push('- Use `[RelayCommand]` attribute for async commands with cancellation support');
+    return lines.join('\n');
+}
+// === SPEC-014b: macOS native window pattern section ===
+/**
+ * Returns true if the project is a native macOS app (SwiftUI or AppKit).
+ */
+export function isMacOSNativeProject(knowledge) {
+    const lang = knowledge.language.toLowerCase();
+    const stack = knowledge.stack.map((s) => s.toLowerCase());
+    return (lang === 'swift' ||
+        stack.some((s) => s.includes('swiftui') || s.includes('appkit') || s.includes('nsapplication')));
+}
+/**
+ * Generate macOS native window pattern UI contract.
+ */
+export function generateMacOSNativeUIContract(screens, knowledge) {
+    const stack = knowledge.stack.map((s) => s.toLowerCase());
+    const isMenuBar = stack.some((s) => s.includes('nsstatusitem') || s.includes('menubarextra'));
+    const isSwiftUI = stack.some((s) => s.includes('swiftui')) || !stack.some((s) => s.includes('nsapplication'));
+    const framework = isSwiftUI ? 'SwiftUI' : 'AppKit';
+    const lines = [
+        `## macOS Native UI Contract — ${framework}`,
+        '',
+        '### Window Patterns',
+        '',
+    ];
+    if (isSwiftUI) {
+        lines.push('- **WindowGroup**: primary app window (multi-instance, persists state via @SceneStorage)');
+        lines.push('- **Settings { }**: preferences window (Cmd+,), separate scene');
+        lines.push('- **Window**: single-instance auxiliary windows');
+        if (isMenuBar) {
+            lines.push('- **MenuBarExtra**: menu bar item with popover or menu (macOS 13+)');
+            lines.push('  - Use `MenuBarExtra("App", systemImage: "icon")` for native behavior');
+            lines.push('  - Content renders in popover or dropdown menu');
+        }
+        lines.push('');
+        lines.push('### SwiftUI Scene Composition');
+        lines.push('');
+        lines.push('```swift');
+        lines.push('@main');
+        lines.push('struct MyApp: App {');
+        lines.push('  var body: some Scene {');
+        lines.push('    WindowGroup { ContentView() }');
+        lines.push('    Settings { PreferencesView() }');
+        if (isMenuBar) {
+            lines.push('    MenuBarExtra("Status", systemImage: "circle.fill") { MenuView() }');
+        }
+        lines.push('  }');
+        lines.push('}');
+        lines.push('```');
+    }
+    else {
+        lines.push('- **NSWindowController**: manages a single NSWindow + NSViewController pair');
+        lines.push('- **NSViewController**: content controller, owns view hierarchy');
+        lines.push('- **NSApplication.shared.mainWindow**: primary window reference');
+        if (isMenuBar) {
+            lines.push('- **NSStatusItem**: menu bar item (set button.image for icon)');
+            lines.push('  - `NSStatusBar.system.statusItem(withLength: NSStatusItem.squareLength)`');
+            lines.push('  - Attach NSMenu or NSPopover for content');
+        }
+        lines.push('');
+        lines.push('### AppKit Window Hierarchy');
+        lines.push('');
+        lines.push('```');
+        lines.push('NSApplication');
+        lines.push('  └── NSWindowController');
+        lines.push('        └── NSWindow (resizable, min: 800x600)');
+        lines.push('              └── NSViewController');
+        lines.push('                    └── NSView hierarchy');
+        lines.push('```');
+    }
+    lines.push('');
+    lines.push('### Screens / Views');
+    lines.push('');
+    for (const screen of screens) {
+        const viewName = screen.charAt(0).toUpperCase() + screen.slice(1).replace(/-/g, '') + 'View';
+        lines.push(`- **${viewName}**: ${isSwiftUI ? 'SwiftUI View' : 'NSViewController + XIB/Storyboard'}`);
+    }
+    lines.push('');
+    lines.push('### Navigation');
+    lines.push('');
+    if (isSwiftUI) {
+        lines.push('- NavigationSplitView for sidebar-detail layout (macOS 13+)');
+        lines.push('- NavigationStack for push navigation within a column');
+        lines.push('- Sheets: `.sheet(isPresented:) { ... }` for modal dialogs');
+        lines.push('- Inspectors: `.inspector(isPresented:) { ... }` for side panels (macOS 14+)');
+    }
+    else {
+        lines.push('- NSSplitViewController for sidebar-detail layout');
+        lines.push('- NSTabViewController for tabbed interfaces');
+        lines.push('- presentAsModalWindow() for modal windows');
+        lines.push('- presentAsSheet() for sheet attachments');
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=native-contract.js.map

package/dist/tools/define-ui-contract-desktop/native-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-contract.js","sourceRoot":"","sources":["../../../src/tools/define-ui-contract-desktop/native-contract.ts"],"names":[],"mappings":"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"}

package/dist/tools/define-ui-contract-desktop.d.ts

@@ -0,0 +1,3 @@
+export { isDesktopProject, generateDesktopUIContract, } from './define-ui-contract-desktop/desktop-contract.js';
+export { isWpfOrAvaloniaProject, generateMvvmUIContract, isMacOSNativeProject, generateMacOSNativeUIContract, } from './define-ui-contract-desktop/native-contract.js';
+//# sourceMappingURL=define-ui-contract-desktop.d.ts.map

package/dist/tools/define-ui-contract-desktop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-ui-contract-desktop.d.ts","sourceRoot":"","sources":["../../src/tools/define-ui-contract-desktop.ts"],"names":[],"mappings":"AAGA,OAAO,EACL,gBAAgB,EAChB,yBAAyB,GAC1B,MAAM,kDAAkD,CAAC;AAE1D,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,oBAAoB,EACpB,6BAA6B,GAC9B,MAAM,iDAAiD,CAAC"}

package/dist/tools/define-ui-contract-desktop.js

@@ -0,0 +1,5 @@
+// tools/define-ui-contract-desktop.ts — Barrel: Desktop UI contract generation (SPEC-014a/b)
+// Split into subdirectory for SOLID compliance.
+export { isDesktopProject, generateDesktopUIContract, } from './define-ui-contract-desktop/desktop-contract.js';
+export { isWpfOrAvaloniaProject, generateMvvmUIContract, isMacOSNativeProject, generateMacOSNativeUIContract, } from './define-ui-contract-desktop/native-contract.js';
+//# sourceMappingURL=define-ui-contract-desktop.js.map

package/dist/tools/define-ui-contract-desktop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-ui-contract-desktop.js","sourceRoot":"","sources":["../../src/tools/define-ui-contract-desktop.ts"],"names":[],"mappings":"AAAA,6FAA6F;AAC7F,gDAAgD;AAEhD,OAAO,EACL,gBAAgB,EAChB,yBAAyB,GAC1B,MAAM,kDAAkD,CAAC;AAE1D,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,oBAAoB,EACpB,6BAA6B,GAC9B,MAAM,iDAAiD,CAAC"}

package/dist/tools/define-ui-contract-extensions.d.ts

@@ -0,0 +1,10 @@
+import type { ProjectKnowledge } from '../types/index.js';
+/**
+ * Returns true if the project is a browser or IDE extension.
+ */
+export declare function isExtensionProject(knowledge: Pick<ProjectKnowledge, 'projectCategory'>): boolean;
+/**
+ * Generate extension UI contract based on extension type (browser vs IDE).
+ */
+export declare function generateExtensionUIContract(screens: string[], knowledge: Pick<ProjectKnowledge, 'framework' | 'projectCategory'>): string;
+//# sourceMappingURL=define-ui-contract-extensions.d.ts.map

package/dist/tools/define-ui-contract-extensions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-ui-contract-extensions.d.ts","sourceRoot":"","sources":["../../src/tools/define-ui-contract-extensions.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAiB,MAAM,mBAAmB,CAAC;AAIzE;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,IAAI,CAAC,gBAAgB,EAAE,iBAAiB,CAAC,GAAG,OAAO,CAIhG;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,MAAM,EAAE,EACjB,SAAS,EAAE,IAAI,CAAC,gBAAgB,EAAE,WAAW,GAAG,iBAAiB,CAAC,GACjE,MAAM,CAKR"}

package/dist/tools/define-ui-contract-extensions.js

@@ -0,0 +1,261 @@
+// tools/define-ui-contract-extensions.ts — Extension UI contract generation (SPEC-014a)
+// Generates UI contracts for browser extensions and IDE extensions.
+const EXTENSION_CATEGORIES = new Set(['browser-extension', 'ide-extension']);
+/**
+ * Returns true if the project is a browser or IDE extension.
+ */
+export function isExtensionProject(knowledge) {
+    return (knowledge.projectCategory !== undefined && EXTENSION_CATEGORIES.has(knowledge.projectCategory));
+}
+/**
+ * Generate extension UI contract based on extension type (browser vs IDE).
+ */
+export function generateExtensionUIContract(screens, knowledge) {
+    if (knowledge.projectCategory === 'ide-extension') {
+        return generateIDEExtensionUIContract(screens, knowledge);
+    }
+    return generateBrowserExtensionUIContract(screens, knowledge);
+}
+// --- Browser Extension -------------------------------------------------------
+function generateBrowserExtensionUIContract(screens, knowledge) {
+    const platform = knowledge.framework ?? 'chrome';
+    const platformTitle = platform.charAt(0).toUpperCase() + platform.slice(1);
+    const components = buildBrowserExtensionComponents(screens);
+    const lines = [
+        `## Browser Extension UI Contract — ${platformTitle}`,
+        '',
+        '### Popup (Toolbar Icon Click)',
+        ...buildPopupSection(),
+        '',
+        '### Options/Settings Page',
+        ...buildOptionsSection(),
+        '',
+        '### Content Script Overlay',
+        ...buildContentOverlaySection(),
+        '',
+        '### Toolbar Badge',
+        ...buildBadgeSection(),
+        '',
+        '### Component Tree',
+        '```json',
+        JSON.stringify(components, null, 2),
+        '```',
+    ];
+    return lines.join('\n');
+}
+function buildPopupSection() {
+    return [
+        '- **PopupContainer**: 400x600px max, no horizontal scroll',
+        '- **PopupHeader**: extension name, logo, close button',
+        '- **MainContent**: primary extension functionality (varies)',
+        '- **Footer**: version, settings link, feedback button',
+    ];
+}
+function buildOptionsSection() {
+    return [
+        '- **OptionsPage**: full page at chrome-extension://...options.html',
+        '- **SettingsForm**: grouped settings with labels and descriptions',
+        '- **SaveButton**: auto-save on change OR explicit save with feedback',
+        '- **ResetButton**: restore defaults with confirmation dialog',
+    ];
+}
+function buildContentOverlaySection() {
+    return [
+        '- **ContentOverlay**: injected div, z-index 2147483647 (max), non-blocking',
+        '- **FloatingPanel**: draggable, resizable, position memory via localStorage',
+        '- **HighlightLayer**: SVG overlay for element highlighting/annotation',
+        '- **TooltipInjection**: contextual tooltips on target elements',
+    ];
+}
+function buildBadgeSection() {
+    return [
+        '- **BadgeText**: 4-char max, auto-resize, visible on icon',
+        '- **BadgeColor**: semantic colors (green=ok, red=error, orange=warning)',
+        '- **IconState**: active/inactive icon variant (requires icon sizes: 16, 48, 128px)',
+    ];
+}
+function buildBrowserExtensionComponents(screens) {
+    const overlayScreens = screens.filter((s) => s.toLowerCase().includes('overlay') || s.toLowerCase().includes('content'));
+    return [
+        {
+            name: 'BrowserExtension',
+            type: 'client',
+            justification: 'All extension UI runs in the browser renderer — fully client-side',
+            props: [
+                { name: 'type', type: 'string', required: false, description: 'Extension type identifier' },
+            ],
+            children: [
+                {
+                    name: 'Popup',
+                    type: 'client',
+                    justification: 'Popup rendered in isolated extension context on toolbar click',
+                    props: [
+                        {
+                            name: 'maxWidth',
+                            type: 'number',
+                            required: false,
+                            description: 'Max popup width in px',
+                        },
+                    ],
+                    children: [],
+                },
+                {
+                    name: 'OptionsPage',
+                    type: 'client',
+                    justification: 'Full settings page opened in a dedicated extension tab',
+                    props: [
+                        {
+                            name: 'fullPage',
+                            type: 'boolean',
+                            required: false,
+                            description: 'Renders as full browser tab',
+                        },
+                    ],
+                    children: [],
+                },
+                {
+                    name: 'ContentScript',
+                    type: 'client',
+                    justification: 'Injected overlay runs in the host page renderer context',
+                    props: [
+                        {
+                            name: 'injected',
+                            type: 'boolean',
+                            required: false,
+                            description: 'True when injected into host page',
+                        },
+                    ],
+                    children: overlayScreens.map((s) => ({
+                        name: s,
+                        type: 'client',
+                        justification: 'Content script component injected into the host page DOM',
+                        props: [],
+                        children: [],
+                    })),
+                },
+            ],
+        },
+    ];
+}
+// --- IDE Extension -----------------------------------------------------------
+function generateIDEExtensionUIContract(screens, knowledge) {
+    const ide = knowledge.framework ?? 'vscode';
+    const components = buildIDEExtensionComponents(screens);
+    const lines = [
+        `## IDE Extension UI Contract — ${ide}`,
+        '',
+        '### Tree View (Explorer Panel)',
+        ...buildTreeViewSection(),
+        '',
+        '### Webview Panel',
+        ...buildWebviewSection(),
+        '',
+        '### Status Bar Item',
+        ...buildStatusBarSection(),
+        '',
+        '### Command Palette',
+        ...buildCommandPaletteSection(),
+        '',
+        '### Component Tree',
+        '```json',
+        JSON.stringify(components, null, 2),
+        '```',
+    ];
+    return lines.join('\n');
+}
+function buildTreeViewSection() {
+    return [
+        '- **TreeDataProvider**: implements vscode.TreeDataProvider<T>',
+        '- **TreeItem**: icon, label, collapsibleState, command on click',
+        '- **TreeItemContextMenu**: right-click actions per item type',
+        '- **Refresh button**: in view title bar (vscode.commands.registerCommand)',
+    ];
+}
+function buildWebviewSection() {
+    return [
+        '- **WebviewPanel**: vscode.window.createWebviewPanel(), retainContextWhenHidden: true',
+        '- **MessageAPI**: postMessage()/onDidReceiveMessage() for bidirectional communication',
+        '- **ContentSecurityPolicy**: strict CSP header in webview HTML',
+        '- **ThemeSupport**: CSS variables for VS Code theme colors (--vscode-*)',
+    ];
+}
+function buildStatusBarSection() {
+    return [
+        '- **StatusBarItem**: left/right alignment, priority, text with icons ($(icon-name))',
+        '- **ProgressItem**: spinning indicator for async operations',
+        '- **ClickCommand**: command executed on status bar item click',
+    ];
+}
+function buildCommandPaletteSection() {
+    return [
+        '- **Commands**: registered in package.json contributes.commands[]',
+        '- **Title format**: "Extension Name: Action Description"',
+        '- **Keybindings**: optional shortcuts in package.json contributes.keybindings[]',
+        '- **When clause**: conditional visibility (when: "resourceExtname == .ts")',
+    ];
+}
+function buildIDEExtensionComponents(screens) {
+    const extraScreens = screens.map((s) => ({
+        name: s,
+        type: 'client',
+        justification: 'Custom IDE extension view rendered inside the webview',
+        props: [],
+        children: [],
+    }));
+    return [
+        {
+            name: 'IDEExtension',
+            type: 'client',
+            justification: 'IDE extension activates in the VS Code extension host — UI is client-rendered in webviews',
+            props: [
+                { name: 'type', type: 'string', required: false, description: 'Extension type identifier' },
+            ],
+            children: [
+                {
+                    name: 'TreeView',
+                    type: 'client',
+                    justification: 'Sidebar tree view registered via contributes.views in package.json',
+                    props: [
+                        {
+                            name: 'viewId',
+                            type: 'string',
+                            required: true,
+                            description: 'VS Code view contribution ID',
+                        },
+                    ],
+                    children: [],
+                },
+                {
+                    name: 'WebviewPanel',
+                    type: 'client',
+                    justification: 'Full webview panel for rich UI beyond VS Code native components',
+                    props: [
+                        {
+                            name: 'retainContext',
+                            type: 'boolean',
+                            required: false,
+                            description: 'Keep webview alive when hidden',
+                        },
+                    ],
+                    children: [],
+                },
+                {
+                    name: 'StatusBarItem',
+                    type: 'client',
+                    justification: 'Status bar entry reflecting live extension state',
+                    props: [
+                        {
+                            name: 'alignment',
+                            type: 'string',
+                            required: false,
+                            description: '"left" or "right" alignment in status bar',
+                        },
+                    ],
+                    children: [],
+                },
+                ...extraScreens,
+            ],
+        },
+    ];
+}
+//# sourceMappingURL=define-ui-contract-extensions.js.map

package/dist/tools/define-ui-contract-extensions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-ui-contract-extensions.js","sourceRoot":"","sources":["../../src/tools/define-ui-contract-extensions.ts"],"names":[],"mappings":"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"}

package/dist/tools/define-ui-contract-games.d.ts

@@ -0,0 +1,10 @@
+import type { ProjectKnowledge } from '../types/index.js';
+/**
+ * Returns true if the project is a game based on framework or category.
+ */
+export declare function isGameProject(knowledge: Pick<ProjectKnowledge, 'framework' | 'projectCategory'>): boolean;
+/**
+ * Generate a game UI contract with HUD, menus, inventory, and dialog components.
+ */
+export declare function generateGameUIContract(screens: string[], knowledge: Pick<ProjectKnowledge, 'framework' | 'projectCategory'>): string;
+//# sourceMappingURL=define-ui-contract-games.d.ts.map

package/dist/tools/define-ui-contract-games.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-ui-contract-games.d.ts","sourceRoot":"","sources":["../../src/tools/define-ui-contract-games.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAiB,MAAM,mBAAmB,CAAC;AAIzE;;GAEG;AACH,wBAAgB,aAAa,CAC3B,SAAS,EAAE,IAAI,CAAC,gBAAgB,EAAE,WAAW,GAAG,iBAAiB,CAAC,GACjE,OAAO,CAKT;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,EAAE,EACjB,SAAS,EAAE,IAAI,CAAC,gBAAgB,EAAE,WAAW,GAAG,iBAAiB,CAAC,GACjE,MAAM,CAyBR"}