ads-fe 0.0.1

package/skills/element-plus-vue3/examples/guide/quick-start.md

@@ -0,0 +1,103 @@
+# Quick Start
+
+## Instructions
+
+This example provides a quick start guide for Element Plus.
+
+### Key Concepts
+
+- Basic setup
+- First component
+- Global configuration
+- Component usage
+
+### Example: Basic Setup
+
+```vue
+<template>
+  <el-button type="primary">Button</el-button>
+</template>
+
+<script setup>
+// Component is auto-imported if using unplugin-vue-components
+</script>
+```
+
+### Example: With Options API
+
+```vue
+<template>
+  <el-button type="primary" @click="handleClick">
+    Click Me
+  </el-button>
+</template>
+
+<script>
+export default {
+  methods: {
+    handleClick() {
+      console.log('Button clicked')
+    }
+  }
+}
+</script>
+```
+
+### Example: With Composition API
+
+```vue
+<template>
+  <el-button type="primary" @click="handleClick">
+    Click Me
+  </el-button>
+</template>
+
+<script setup>
+const handleClick = () => {
+  console.log('Button clicked')
+}
+</script>
+```
+
+### Example: Global Configuration
+
+```javascript
+// main.js
+import { createApp } from 'vue'
+import ElementPlus from 'element-plus'
+import 'element-plus/dist/index.css'
+import App from './App.vue'
+
+const app = createApp(App)
+app.use(ElementPlus, {
+  size: 'large',
+  zIndex: 3000
+})
+app.mount('#app')
+```
+
+### Example: Using ConfigProvider
+
+```vue
+<template>
+  <el-config-provider :locale="locale" :size="size">
+    <el-button>Button</el-button>
+  </el-config-provider>
+</template>
+
+<script setup>
+import { ref } from 'vue'
+import zhCn from 'element-plus/dist/locale/zh-cn.mjs'
+
+const locale = ref(zhCn)
+const size = ref('default')
+</script>
+```
+
+### Key Points
+
+- Use el- prefix for components
+- Support both Options API and Composition API
+- Configure globally or per component
+- Use ConfigProvider for locale and size
+- Import styles for components

package/skills/element-plus-vue3/examples/guide/theme.md

@@ -0,0 +1,78 @@
+# Theme Customization
+
+## Instructions
+
+This example demonstrates how to customize Element Plus theme.
+
+### Key Concepts
+
+- CSS variables
+- SCSS variables
+- Theme builder
+- Color customization
+
+### Example: Using CSS Variables
+
+```vue
+<template>
+  <el-button type="primary">Button</el-button>
+</template>
+
+<style>
+:root {
+  --el-color-primary: #409eff;
+  --el-color-success: #67c23a;
+  --el-color-warning: #e6a23c;
+  --el-color-danger: #f56c6c;
+  --el-color-info: #909399;
+}
+</style>
+```
+
+### Example: SCSS Variables
+
+```scss
+// variables.scss
+$--color-primary: #409eff;
+$--color-success: #67c23a;
+$--color-warning: #e6a23c;
+$--color-danger: #f56c6c;
+$--color-info: #909399;
+```
+
+### Example: Import Custom Theme
+
+```javascript
+// main.js
+import { createApp } from 'vue'
+import ElementPlus from 'element-plus'
+import './theme/index.css'
+import App from './App.vue'
+
+const app = createApp(App)
+app.use(ElementPlus)
+app.mount('#app')
+```
+
+### Example: Component-Level Customization
+
+```vue
+<template>
+  <el-button class="custom-button">Button</el-button>
+</template>
+
+<style scoped>
+.custom-button {
+  --el-button-bg-color: #409eff;
+  --el-button-text-color: #fff;
+}
+</style>
+```
+
+### Key Points
+
+- Use CSS variables for customization
+- Override theme variables
+- Use SCSS for advanced customization
+- Component-level customization supported
+- Use theme builder for visual customization

package/skills/element-plus-vue3/templates/component-usage.md

@@ -0,0 +1,92 @@
+# Component Usage Templates
+
+## Button Usage
+
+```vue
+<template>
+  <el-button type="primary" @click="handleClick">
+    Click Me
+  </el-button>
+</template>
+
+<script setup>
+const handleClick = () => {
+  console.log('Clicked')
+}
+</script>
+```
+
+## Form Usage
+
+```vue
+<template>
+  <el-form :model="form" :rules="rules" ref="formRef">
+    <el-form-item label="Name" prop="name">
+      <el-input v-model="form.name" />
+    </el-form-item>
+    <el-form-item>
+      <el-button type="primary" @click="handleSubmit">Submit</el-button>
+    </el-form-item>
+  </el-form>
+</template>
+
+<script setup>
+import { ref } from 'vue'
+
+const formRef = ref()
+const form = ref({
+  name: ''
+})
+
+const rules = {
+  name: [
+    { required: true, message: 'Please input name', trigger: 'blur' }
+  ]
+}
+
+const handleSubmit = async () => {
+  await formRef.value.validate((valid) => {
+    if (valid) {
+      console.log('Form:', form.value)
+    }
+  })
+}
+</script>
+```
+
+## Table Usage
+
+```vue
+<template>
+  <el-table :data="tableData">
+    <el-table-column prop="name" label="Name" />
+    <el-table-column prop="email" label="Email" />
+  </el-table>
+</template>
+
+<script setup>
+import { ref } from 'vue'
+
+const tableData = ref([
+  { name: 'John', email: 'john@example.com' },
+  { name: 'Jane', email: 'jane@example.com' }
+])
+</script>
+```
+
+## Dialog Usage
+
+```vue
+<template>
+  <el-button @click="dialogVisible = true">Open Dialog</el-button>
+  <el-dialog v-model="dialogVisible" title="Dialog">
+    <span>Dialog Content</span>
+  </el-dialog>
+</template>
+
+<script setup>
+import { ref } from 'vue'
+
+const dialogVisible = ref(false)
+</script>
+```

package/skills/element-plus-vue3/templates/installation.md

@@ -0,0 +1,82 @@
+# Installation Templates
+
+## npm Installation
+
+```bash
+npm install element-plus
+```
+
+## Full Import
+
+```javascript
+// main.js
+import { createApp } from 'vue'
+import ElementPlus from 'element-plus'
+import 'element-plus/dist/index.css'
+import App from './App.vue'
+
+const app = createApp(App)
+app.use(ElementPlus)
+app.mount('#app')
+```
+
+## On-Demand Import
+
+```javascript
+// main.js
+import { createApp } from 'vue'
+import { ElButton, ElInput } from 'element-plus'
+import 'element-plus/es/components/button/style/css'
+import 'element-plus/es/components/input/style/css'
+import App from './App.vue'
+
+const app = createApp(App)
+app.component(ElButton.name, ElButton)
+app.component(ElInput.name, ElInput)
+app.mount('#app')
+```
+
+## Auto Import with unplugin-vue-components
+
+```javascript
+// vite.config.js
+import { defineConfig } from 'vite'
+import vue from '@vitejs/plugin-vue'
+import AutoImport from 'unplugin-auto-import/vite'
+import Components from 'unplugin-vue-components/vite'
+import { ElementPlusResolver } from 'unplugin-vue-components/resolvers'
+
+export default defineConfig({
+  plugins: [
+    vue(),
+    AutoImport({
+      resolvers: [ElementPlusResolver()],
+    }),
+    Components({
+      resolvers: [ElementPlusResolver()],
+    }),
+  ],
+})
+```
+
+## CDN Import
+
+```html
+<!DOCTYPE html>
+<html>
+<head>
+  <link rel="stylesheet" href="https://unpkg.com/element-plus/dist/index.css" />
+</head>
+<body>
+  <div id="app"></div>
+  <script src="https://unpkg.com/vue@next"></script>
+  <script src="https://unpkg.com/element-plus"></script>
+  <script>
+    const { createApp } = Vue
+    const app = createApp({})
+    app.use(ElementPlus)
+    app.mount('#app')
+  </script>
+</body>
+</html>
+```

package/skills/element-plus-vue3/templates/project-setup.md

@@ -0,0 +1,83 @@
+# Project Setup Templates
+
+## Vite Project Setup
+
+```bash
+# Create Vite project
+npm create vite@latest my-app -- --template vue
+
+# Install dependencies
+cd my-app
+npm install
+npm install element-plus
+
+# Install auto-import plugins
+npm install -D unplugin-vue-components unplugin-auto-import
+```
+
+```javascript
+// vite.config.js
+import { defineConfig } from 'vite'
+import vue from '@vitejs/plugin-vue'
+import AutoImport from 'unplugin-auto-import/vite'
+import Components from 'unplugin-vue-components/vite'
+import { ElementPlusResolver } from 'unplugin-vue-components/resolvers'
+
+export default defineConfig({
+  plugins: [
+    vue(),
+    AutoImport({
+      resolvers: [ElementPlusResolver()],
+    }),
+    Components({
+      resolvers: [ElementPlusResolver()],
+    }),
+  ],
+})
+```
+
+## Vue CLI Project Setup
+
+```bash
+# Create Vue CLI project
+vue create my-app
+
+# Install Element Plus
+cd my-app
+npm install element-plus
+```
+
+```javascript
+// main.js
+import { createApp } from 'vue'
+import ElementPlus from 'element-plus'
+import 'element-plus/dist/index.css'
+import App from './App.vue'
+
+const app = createApp(App)
+app.use(ElementPlus)
+app.mount('#app')
+```
+
+## Nuxt 3 Project Setup
+
+```bash
+# Create Nuxt 3 project
+npx nuxi@latest init my-app
+
+# Install Element Plus
+cd my-app
+npm install element-plus
+```
+
+```javascript
+// nuxt.config.ts
+import { defineNuxtConfig } from 'nuxt/config'
+
+export default defineNuxtConfig({
+  css: ['element-plus/dist/index.css'],
+  build: {
+    transpile: ['element-plus']
+  }
+})
+```

package/skills/node/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Matteo Collina
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/skills/node/SKILL.md

@@ -0,0 +1,94 @@
+---
+name: node
+description: Provides domain-specific best practices for Node.js development with TypeScript, covering type stripping, async patterns, error handling, streams, modules, testing, performance, caching, logging, and more. Use when setting up Node.js projects with native TypeScript support, configuring type stripping (--experimental-strip-types), writing Node 22+ TypeScript without a build step, or when the user mentions 'native TypeScript in Node', 'strip types', 'Node 22 TypeScript', '.ts files without compilation', 'ts-node alternative', or needs guidance on error handling, graceful shutdown, flaky tests, profiling, or environment configuration in Node.js. Helps configure tsconfig.json for type stripping, set up package.json scripts, handle module resolution and import extensions, and apply robust patterns across the full Node.js stack.
+metadata:
+  tags: node, nodejs, javascript, typescript, type-stripping, backend, server
+---
+
+## When to use
+
+Use this skill whenever you are dealing with Node.js code to obtain domain-specific knowledge for building robust, performant, and maintainable Node.js applications.
+
+## TypeScript with Type Stripping
+
+When writing TypeScript for Node.js, use **type stripping** (Node.js 22.6+) instead of build tools like ts-node or tsx. Type stripping runs TypeScript directly by removing type annotations at runtime without transpilation.
+
+Key requirements for type stripping compatibility:
+- Use `import type` for type-only imports
+- Use const objects instead of enums
+- Avoid namespaces and parameter properties
+- Use `.ts` extensions in imports
+
+**Minimal example** — a valid type-stripped TypeScript file:
+
+```ts
+// greet.ts
+import type { IncomingMessage } from 'node:http';
+
+const greet = (name: string): string => `Hello, ${name}!`;
+console.log(greet('world'));
+```
+
+Run directly with:
+```bash
+node greet.ts
+```
+
+See [rules/typescript.md](rules/typescript.md) for complete configuration and examples.
+
+## Common Workflows
+
+For multi-step processes, follow these high-level sequences before consulting the relevant rule file:
+
+**Graceful shutdown**: Register signal handlers (SIGTERM/SIGINT) → stop accepting new work → drain in-flight requests → close external connections (DB, cache) → exit with appropriate code. See [rules/graceful-shutdown.md](rules/graceful-shutdown.md).
+
+**Error handling**: Define a shared error base class → classify errors (operational vs programmer) → add async boundary handlers (`process.on('unhandledRejection')`) → propagate typed errors through the call stack → log with context before responding or crashing. See [rules/error-handling.md](rules/error-handling.md).
+
+**Diagnosing flaky tests**: Isolate the test with `--test-only` → check for shared state or timer dependencies → inspect async teardown order → add retry logic as a temporary diagnostic step → fix root cause. See [rules/flaky-tests.md](rules/flaky-tests.md).
+
+**Diagnosing stuck processes/tests** (`node --test` hangs, "process did not exit", CI timeout, open handles): isolate file/test → run with explicit timeout/reporter → inspect handles via `why-is-node-running` (`SIGUSR1`) → patch deterministic teardown in resource-creation scope → rerun isolated + full suite until stable. See [rules/stuck-processes-and-tests.md](rules/stuck-processes-and-tests.md).
+
+**Profiling a slow path**: Reproduce under realistic load → capture a CPU profile with `--cpu-prof` → identify hot functions → check for stream backpressure or unnecessary serialisation → validate improvement with a benchmark. See [rules/profiling.md](rules/profiling.md) and [rules/performance.md](rules/performance.md).
+
+## High-priority activation checklist (streams + caching)
+
+When the task mentions **CSV**, **ETL**, **ingestion pipelines**, **large file processing**, **backpressure**, **repeated lookups**, or **deduplicating concurrent async calls**, explicitly apply this checklist:
+
+1. Use `await pipeline(...)` from `node:stream/promises` (prefer this over chained `.pipe()` in guidance/code).
+2. Include at least one explicit `async function*` transform when data is being transformed in-stream.
+3. Choose a cache strategy when repeated work appears:
+   - `lru-cache` for bounded in-memory reuse in a single process.
+   - `async-cache-dedupe` for async request deduplication / stale-while-revalidate behavior.
+4. Show where backpressure is handled (implicitly via `pipeline()` or explicitly via `drain`).
+
+### Integrated example pattern (CSV/ETL)
+
+For CSV/ETL-style prompts, prefer an answer structure like:
+- `createReadStream(input)`
+- `async function*` parser/transform
+- optional cached enrichment lookup (`async-cache-dedupe` or `lru-cache`)
+- `await pipeline(...)` to a writable destination
+
+Link relevant rules directly in explanations so models can retrieve details:
+- [rules/streams.md](rules/streams.md)
+- [rules/caching.md](rules/caching.md)
+
+## How to use
+
+Read individual rule files for detailed explanations and code examples:
+
+- [rules/error-handling.md](rules/error-handling.md) - Error handling patterns in Node.js
+- [rules/async-patterns.md](rules/async-patterns.md) - Async/await and Promise patterns
+- [rules/streams.md](rules/streams.md) - Working with Node.js streams
+- [rules/modules.md](rules/modules.md) - ES Modules and CommonJS patterns
+- [rules/testing.md](rules/testing.md) - Testing strategies for Node.js applications
+- [rules/flaky-tests.md](rules/flaky-tests.md) - Identifying and diagnosing flaky tests with node:test
+- [rules/stuck-processes-and-tests.md](rules/stuck-processes-and-tests.md) - Diagnosing processes that do not exit and tests that get stuck
+- [rules/node-modules-exploration.md](rules/node-modules-exploration.md) - Navigating and analyzing node_modules directories
+- [rules/performance.md](rules/performance.md) - Performance optimization techniques
+- [rules/caching.md](rules/caching.md) - Caching patterns and libraries
+- [rules/profiling.md](rules/profiling.md) - Profiling and benchmarking tools
+- [rules/logging.md](rules/logging.md) - Logging and debugging patterns
+- [rules/environment.md](rules/environment.md) - Environment configuration and secrets management
+- [rules/graceful-shutdown.md](rules/graceful-shutdown.md) - Graceful shutdown and signal handling
+- [rules/typescript.md](rules/typescript.md) - TypeScript configuration and type stripping in Node.js

package/skills/node/SYNC.md

@@ -0,0 +1,5 @@
+# Sync Info
+
+- Source: `vendor/mcollina/skills/node`
+- Git SHA: `5b2a81354b6d10325da0db9decc9ce5ecc714138`
+- Synced: 2026-05-21

package/skills/node/rules/assets/graceful-server.test.ts

@@ -0,0 +1,88 @@
+import { describe, it, before, after } from 'node:test';
+import assert from 'node:assert/strict';
+import { createServer, IncomingMessage, ServerResponse, Server } from 'node:http';
+
+describe('graceful server shutdown', () => {
+  let server: Server;
+  let isShuttingDown = false;
+
+  function createHandler() {
+    return (req: IncomingMessage, res: ServerResponse) => {
+      if (isShuttingDown) {
+        res.setHeader('Connection', 'close');
+      }
+
+      if (req.url === '/health') {
+        if (isShuttingDown) {
+          res.writeHead(503, { 'Content-Type': 'application/json' });
+          res.end(JSON.stringify({ status: 'shutting_down' }));
+          return;
+        }
+        res.writeHead(200, { 'Content-Type': 'application/json' });
+        res.end(JSON.stringify({ status: 'healthy' }));
+        return;
+      }
+
+      res.writeHead(200, { 'Content-Type': 'application/json' });
+      res.end(JSON.stringify({ message: 'Hello, World!' }));
+    };
+  }
+
+  before(() => {
+    server = createServer(createHandler());
+    server.listen(0); // Random available port
+  });
+
+  after(async () => {
+    await new Promise<void>((resolve) => server.close(() => resolve()));
+  });
+
+  function getPort(): number {
+    const address = server.address();
+    if (typeof address === 'object' && address !== null) {
+      return address.port;
+    }
+    throw new Error('Server not listening');
+  }
+
+  it('should return healthy status when not shutting down', async () => {
+    const port = getPort();
+    const response = await fetch(`http://localhost:${port}/health`);
+
+    assert.equal(response.status, 200);
+    const body = await response.json();
+    assert.deepEqual(body, { status: 'healthy' });
+  });
+
+  it('should return 503 and shutting_down status during shutdown', async () => {
+    isShuttingDown = true;
+    const port = getPort();
+
+    const response = await fetch(`http://localhost:${port}/health`);
+
+    assert.equal(response.status, 503);
+    const body = await response.json();
+    assert.deepEqual(body, { status: 'shutting_down' });
+
+    isShuttingDown = false; // Reset for other tests
+  });
+
+  it('should set Connection: close header during shutdown', async () => {
+    isShuttingDown = true;
+    const port = getPort();
+
+    const response = await fetch(`http://localhost:${port}/`);
+
+    assert.equal(response.headers.get('connection'), 'close');
+
+    isShuttingDown = false;
+  });
+
+  it('should not set Connection: close header when not shutting down', async () => {
+    const port = getPort();
+
+    const response = await fetch(`http://localhost:${port}/`);
+
+    assert.notEqual(response.headers.get('connection'), 'close');
+  });
+});