@atlashub/smartstack-cli 3.39.0 → 3.41.0

package/templates/project/test-frontend/msw/server.ts

@@ -1,25 +1,25 @@
-import { setupServer } from 'msw/node';
-import { handlers } from './handlers';
-
-/**
- * MSW (Mock Service Worker) server for intercepting API calls in tests.
- * Configured with default handlers that mock common SmartStack API endpoints.
- *
- * Usage:
- * - Default handlers are loaded from ./handlers.ts
- * - Override handlers per-test using server.use()
- *
- * @example
- * import { server } from '@/test/msw/server';
- * import { http, HttpResponse } from 'msw';
- *
- * test('custom handler', () => {
- *   server.use(
- *     http.get('/api/products', () =>
- *       HttpResponse.json({ items: [], totalCount: 0 })
- *     )
- *   );
- *   // ... test code
- * });
- */
-export const server = setupServer(...handlers);
+import { setupServer } from 'msw/node';
+import { handlers } from './handlers';
+
+/**
+ * MSW (Mock Service Worker) server for intercepting API calls in tests.
+ * Configured with default handlers that mock common SmartStack API endpoints.
+ *
+ * Usage:
+ * - Default handlers are loaded from ./handlers.ts
+ * - Override handlers per-test using server.use()
+ *
+ * @example
+ * import { server } from '@/test/msw/server';
+ * import { http, HttpResponse } from 'msw';
+ *
+ * test('custom handler', () => {
+ *   server.use(
+ *     http.get('/api/products', () =>
+ *       HttpResponse.json({ items: [], totalCount: 0 })
+ *     )
+ *   );
+ *   // ... test code
+ * });
+ */
+export const server = setupServer(...handlers);

package/templates/project/test-frontend/setup.ts

@@ -1,16 +1,16 @@
-import '@testing-library/jest-dom/vitest';
-import { cleanup } from '@testing-library/react';
-import { afterEach, beforeAll, afterAll } from 'vitest';
-import { server } from './msw/server';
-
-// Start MSW server before all tests
-beforeAll(() => server.listen({ onUnhandledRequest: 'warn' }));
-
-// Reset handlers after each test (to not leak state between tests)
-afterEach(() => {
-  cleanup();
-  server.resetHandlers();
-});
-
-// Close MSW server after all tests
-afterAll(() => server.close());
+import '@testing-library/jest-dom/vitest';
+import { cleanup } from '@testing-library/react';
+import { afterEach, beforeAll, afterAll } from 'vitest';
+import { server } from './msw/server';
+
+// Start MSW server before all tests
+beforeAll(() => server.listen({ onUnhandledRequest: 'warn' }));
+
+// Reset handlers after each test (to not leak state between tests)
+afterEach(() => {
+  cleanup();
+  server.resetHandlers();
+});
+
+// Close MSW server after all tests
+afterAll(() => server.close());

package/templates/project/test-frontend/test-utils.tsx

@@ -1,59 +1,59 @@
-import React, { type ReactElement } from 'react';
-import { render, type RenderOptions } from '@testing-library/react';
-import { BrowserRouter } from 'react-router-dom';
-import { I18nextProvider } from 'react-i18next';
-import i18n from '../i18n'; // Adjust path to your i18n config
-
-/**
- * AuthContext mock for tests.
- * Provides a default authenticated user with admin permissions.
- */
-const mockAuthContext = {
-  user: {
-    id: 'test-user-id',
-    email: 'test-admin@smartstack.io',
-    name: 'Test Admin',
-    role: 'Administrator',
-  },
-  isAuthenticated: true,
-  isLoading: false,
-  login: async () => {},
-  logout: async () => {},
-  hasPermission: () => true,
-  refreshPermissions: async () => {},
-};
-
-/**
- * Wraps components with all necessary providers for testing.
- * Includes: Router, i18n, Auth context.
- */
-function AllProviders({ children }: { children: React.ReactNode }) {
-  return (
-    <BrowserRouter>
-      <I18nextProvider i18n={i18n}>
-        {children}
-      </I18nextProvider>
-    </BrowserRouter>
-  );
-}
-
-/**
- * Custom render function that wraps components with test providers.
- * Use this instead of @testing-library/react's render.
- *
- * @example
- * import { renderWithProviders, screen } from '@/test/test-utils';
- * renderWithProviders(<MyComponent />);
- * expect(screen.getByText('Hello')).toBeInTheDocument();
- */
-function renderWithProviders(
-  ui: ReactElement,
-  options?: Omit<RenderOptions, 'wrapper'>
-) {
-  return render(ui, { wrapper: AllProviders, ...options });
-}
-
-// Re-export everything from testing-library
-export * from '@testing-library/react';
-export { renderWithProviders };
-export { mockAuthContext };
+import React, { type ReactElement } from 'react';
+import { render, type RenderOptions } from '@testing-library/react';
+import { BrowserRouter } from 'react-router-dom';
+import { I18nextProvider } from 'react-i18next';
+import i18n from '../i18n'; // Adjust path to your i18n config
+
+/**
+ * AuthContext mock for tests.
+ * Provides a default authenticated user with admin permissions.
+ */
+const mockAuthContext = {
+  user: {
+    id: 'test-user-id',
+    email: 'test-admin@smartstack.io',
+    name: 'Test Admin',
+    role: 'Administrator',
+  },
+  isAuthenticated: true,
+  isLoading: false,
+  login: async () => {},
+  logout: async () => {},
+  hasPermission: () => true,
+  refreshPermissions: async () => {},
+};
+
+/**
+ * Wraps components with all necessary providers for testing.
+ * Includes: Router, i18n, Auth context.
+ */
+function AllProviders({ children }: { children: React.ReactNode }) {
+  return (
+    <BrowserRouter>
+      <I18nextProvider i18n={i18n}>
+        {children}
+      </I18nextProvider>
+    </BrowserRouter>
+  );
+}
+
+/**
+ * Custom render function that wraps components with test providers.
+ * Use this instead of @testing-library/react's render.
+ *
+ * @example
+ * import { renderWithProviders, screen } from '@/test/test-utils';
+ * renderWithProviders(<MyComponent />);
+ * expect(screen.getByText('Hello')).toBeInTheDocument();
+ */
+function renderWithProviders(
+  ui: ReactElement,
+  options?: Omit<RenderOptions, 'wrapper'>
+) {
+  return render(ui, { wrapper: AllProviders, ...options });
+}
+
+// Re-export everything from testing-library
+export * from '@testing-library/react';
+export { renderWithProviders };
+export { mockAuthContext };

package/templates/project/test-frontend/vitest.config.ts

@@ -1,31 +1,31 @@
-/// <reference types="vitest/config" />
-import { defineConfig } from 'vite';
-import react from '@vitejs/plugin-react';
-import path from 'path';
-
-export default defineConfig({
-  plugins: [react()],
-  test: {
-    globals: true,
-    environment: 'jsdom',
-    setupFiles: ['./src/test/setup.ts'],
-    css: false,
-    include: ['src/**/*.{test,spec}.{ts,tsx}'],
-    coverage: {
-      provider: 'v8',
-      reporter: ['text', 'json', 'html'],
-      include: ['src/**/*.{ts,tsx}'],
-      exclude: [
-        'src/test/**',
-        'src/**/*.d.ts',
-        'src/main.tsx',
-        'src/vite-env.d.ts',
-      ],
-    },
-  },
-  resolve: {
-    alias: {
-      '@': path.resolve(__dirname, './src'),
-    },
-  },
-});
+/// <reference types="vitest/config" />
+import { defineConfig } from 'vite';
+import react from '@vitejs/plugin-react';
+import path from 'path';
+
+export default defineConfig({
+  plugins: [react()],
+  test: {
+    globals: true,
+    environment: 'jsdom',
+    setupFiles: ['./src/test/setup.ts'],
+    css: false,
+    include: ['src/**/*.{test,spec}.{ts,tsx}'],
+    coverage: {
+      provider: 'v8',
+      reporter: ['text', 'json', 'html'],
+      include: ['src/**/*.{ts,tsx}'],
+      exclude: [
+        'src/test/**',
+        'src/**/*.d.ts',
+        'src/main.tsx',
+        'src/vite-env.d.ts',
+      ],
+    },
+  },
+  resolve: {
+    alias: {
+      '@': path.resolve(__dirname, './src'),
+    },
+  },
+});

package/templates/ralph/README.md

@@ -1,93 +1,93 @@
-# Ralph Weegund - SmartStack Automation Loop
-
-Ralph Weegund is an iterative AI loop that enables autonomous feature development with mandatory MCP server integration.
-
-## Directory Structure
-
-```
-.ralph/
-├── ralph.config.yaml    # Configuration (DO NOT DELETE)
-├── logs/                # Execution logs
-│   └── ralph-YYYY-MM-DD.log
-├── reports/             # Feature completion reports
-│   └── feature-name-TIMESTAMP.md
-└── README.md            # This file
-```
-
-## Configuration
-
-Edit `ralph.config.yaml` to customize:
-
-- **MCP servers**: Required servers and behavior
-- **Logging**: What to log and retention
-- **Reports**: Auto-generation and format
-- **Iteration**: Max iterations and completion detection
-
-## Required MCP Servers
-
-Ralph **requires** these MCP servers to function:
-
-### 1. Install packages
-```bash
-npm install -g @atlashub/smartstack-cli
-npm install -g @upstash/context7-mcp
-```
-
-### 2. Register in Claude Code
-```bash
-claude mcp add smartstack -- npx --package @atlashub/smartstack-cli smartstack-mcp
-claude mcp add context7 -- npx @upstash/context7-mcp
-```
-
-## Usage
-
-1. Ensure MCP servers are installed:
-   ```bash
-   smartstack check-mcp
-   ```
-
-2. Start Ralph:
-   ```bash
-   smartstack ralph start
-   ```
-
-3. In Claude Code, use:
-   ```
-   /ralph-loop "Your feature description"
-   ```
-
-## Logs
-
-Logs are stored in `.ralph/logs/` with daily rotation.
-
-View recent logs:
-```bash
-smartstack ralph logs
-```
-
-## Reports
-
-Feature completion reports are auto-generated in `.ralph/reports/`.
-
-View last report:
-```bash
-smartstack ralph report --last
-```
-
-## Troubleshooting
-
-### Ralph won't start
-
-1. Check MCP servers: `smartstack check-mcp`
-2. Run diagnostics: `smartstack doctor`
-3. Check logs: `smartstack ralph logs`
-
-### MCP server unavailable
-
-Ralph will abort if required MCP servers are unavailable.
-This is by design - no fallback mode exists.
-
-## More Information
-
-- Documentation: https://atlashub.ch/docs/ralph
-- Issues: https://github.com/atlashub/smartstack-cli/issues
+# Ralph Weegund - SmartStack Automation Loop
+
+Ralph Weegund is an iterative AI loop that enables autonomous feature development with mandatory MCP server integration.
+
+## Directory Structure
+
+```
+.ralph/
+├── ralph.config.yaml    # Configuration (DO NOT DELETE)
+├── logs/                # Execution logs
+│   └── ralph-YYYY-MM-DD.log
+├── reports/             # Feature completion reports
+│   └── feature-name-TIMESTAMP.md
+└── README.md            # This file
+```
+
+## Configuration
+
+Edit `ralph.config.yaml` to customize:
+
+- **MCP servers**: Required servers and behavior
+- **Logging**: What to log and retention
+- **Reports**: Auto-generation and format
+- **Iteration**: Max iterations and completion detection
+
+## Required MCP Servers
+
+Ralph **requires** these MCP servers to function:
+
+### 1. Install packages
+```bash
+npm install -g @atlashub/smartstack-cli
+npm install -g @upstash/context7-mcp
+```
+
+### 2. Register in Claude Code
+```bash
+claude mcp add smartstack -- npx --package @atlashub/smartstack-cli smartstack-mcp
+claude mcp add context7 -- npx @upstash/context7-mcp
+```
+
+## Usage
+
+1. Ensure MCP servers are installed:
+   ```bash
+   smartstack check-mcp
+   ```
+
+2. Start Ralph:
+   ```bash
+   smartstack ralph start
+   ```
+
+3. In Claude Code, use:
+   ```
+   /ralph-loop "Your feature description"
+   ```
+
+## Logs
+
+Logs are stored in `.ralph/logs/` with daily rotation.
+
+View recent logs:
+```bash
+smartstack ralph logs
+```
+
+## Reports
+
+Feature completion reports are auto-generated in `.ralph/reports/`.
+
+View last report:
+```bash
+smartstack ralph report --last
+```
+
+## Troubleshooting
+
+### Ralph won't start
+
+1. Check MCP servers: `smartstack check-mcp`
+2. Run diagnostics: `smartstack doctor`
+3. Check logs: `smartstack ralph logs`
+
+### MCP server unavailable
+
+Ralph will abort if required MCP servers are unavailable.
+This is by design - no fallback mode exists.
+
+## More Information
+
+- Documentation: https://atlashub.ch/docs/ralph
+- Issues: https://github.com/atlashub/smartstack-cli/issues

package/templates/ralph/ralph.config.yaml

@@ -1,113 +1,113 @@
-# Ralph Weegund Configuration
-# Auto-generated by SmartStack CLI
-# Documentation: https://atlashub.ch/docs/ralph
-
-version: "1.0.0"
-
-# MCP Servers - REQUIRED for Ralph to function
-mcp:
-  required:
-    - name: context7
-      description: "Library documentation and code examples"
-      install_command: "npm install -g @upstash/context7-mcp && claude mcp add context7 -- npx @upstash/context7-mcp"
-      health_check: true
-
-    - name: smartstack
-      description: "SmartStack validation and scaffolding (bundled in CLI)"
-      install_command: "claude mcp add smartstack -- npx --package @atlashub/smartstack-cli smartstack-mcp"
-      health_check: true
-
-  # Behavior when MCP is unavailable
-  on_unavailable: "abort"  # abort | warn | ignore
-
-  # Health check interval (seconds) - 0 to disable
-  health_check_interval: 300
-
-# Logging configuration
-logging:
-  enabled: true
-  level: "info"  # debug | info | warn | error
-
-  # Log directory (relative to project root)
-  directory: ".ralph/logs"
-
-  # Log file naming pattern
-  file_pattern: "ralph-{date}.log"
-
-  # Retention in days (0 = unlimited)
-  retention_days: 30
-
-  # What to log
-  log_mcp_calls: true
-  log_tool_usage: true
-  log_iterations: true
-  log_file_changes: true
-
-# Feature reports
-reports:
-  enabled: true
-
-  # Reports directory (relative to project root)
-  directory: ".ralph/reports"
-
-  # Auto-generate report on feature completion
-  auto_generate: true
-
-  # Report format
-  format: "markdown"  # markdown | json | html
-
-  # Include in report
-  include:
-    mcp_usage_stats: true
-    files_created: true
-    files_modified: true
-    duration: true
-    iterations_count: true
-    validations_performed: true
-
-# Iteration settings
-iteration:
-  # Maximum iterations before forced stop (0 = unlimited)
-  max_iterations: 0
-
-  # Pause between iterations (milliseconds)
-  pause_ms: 1000
-
-  # Completion detection
-  completion:
-    # Require explicit completion promise
-    require_promise: true
-
-    # Keywords that indicate completion
-    keywords:
-      - "TASK_COMPLETE"
-      - "FEATURE_DONE"
-
-# Metrics and counters
-metrics:
-  enabled: true
-
-  # Track MCP tool usage
-  track_mcp_tools: true
-
-  # Track file operations
-  track_file_ops: true
-
-  # Export metrics on completion
-  export_on_complete: true
-
-# Alerting (future feature)
-alerts:
-  enabled: false
-
-  # Alert on MCP failure
-  on_mcp_failure: true
-
-  # Alert on max iterations reached
-  on_max_iterations: true
-
-  # Alert destinations (future)
-  # destinations:
-  #   - type: "console"
-  #   - type: "file"
-  #   - type: "webhook"
+# Ralph Weegund Configuration
+# Auto-generated by SmartStack CLI
+# Documentation: https://atlashub.ch/docs/ralph
+
+version: "1.0.0"
+
+# MCP Servers - REQUIRED for Ralph to function
+mcp:
+  required:
+    - name: context7
+      description: "Library documentation and code examples"
+      install_command: "npm install -g @upstash/context7-mcp && claude mcp add context7 -- npx @upstash/context7-mcp"
+      health_check: true
+
+    - name: smartstack
+      description: "SmartStack validation and scaffolding (bundled in CLI)"
+      install_command: "claude mcp add smartstack -- npx --package @atlashub/smartstack-cli smartstack-mcp"
+      health_check: true
+
+  # Behavior when MCP is unavailable
+  on_unavailable: "abort"  # abort | warn | ignore
+
+  # Health check interval (seconds) - 0 to disable
+  health_check_interval: 300
+
+# Logging configuration
+logging:
+  enabled: true
+  level: "info"  # debug | info | warn | error
+
+  # Log directory (relative to project root)
+  directory: ".ralph/logs"
+
+  # Log file naming pattern
+  file_pattern: "ralph-{date}.log"
+
+  # Retention in days (0 = unlimited)
+  retention_days: 30
+
+  # What to log
+  log_mcp_calls: true
+  log_tool_usage: true
+  log_iterations: true
+  log_file_changes: true
+
+# Feature reports
+reports:
+  enabled: true
+
+  # Reports directory (relative to project root)
+  directory: ".ralph/reports"
+
+  # Auto-generate report on feature completion
+  auto_generate: true
+
+  # Report format
+  format: "markdown"  # markdown | json | html
+
+  # Include in report
+  include:
+    mcp_usage_stats: true
+    files_created: true
+    files_modified: true
+    duration: true
+    iterations_count: true
+    validations_performed: true
+
+# Iteration settings
+iteration:
+  # Maximum iterations before forced stop (0 = unlimited)
+  max_iterations: 0
+
+  # Pause between iterations (milliseconds)
+  pause_ms: 1000
+
+  # Completion detection
+  completion:
+    # Require explicit completion promise
+    require_promise: true
+
+    # Keywords that indicate completion
+    keywords:
+      - "TASK_COMPLETE"
+      - "FEATURE_DONE"
+
+# Metrics and counters
+metrics:
+  enabled: true
+
+  # Track MCP tool usage
+  track_mcp_tools: true
+
+  # Track file operations
+  track_file_ops: true
+
+  # Export metrics on completion
+  export_on_complete: true
+
+# Alerting (future feature)
+alerts:
+  enabled: false
+
+  # Alert on MCP failure
+  on_mcp_failure: true
+
+  # Alert on max iterations reached
+  on_max_iterations: true
+
+  # Alert destinations (future)
+  # destinations:
+  #   - type: "console"
+  #   - type: "file"
+  #   - type: "webhook"