@su-record/vibe 2.9.23 → 2.9.24

package/skills/characterization-test/templates/test-template.ts

@@ -1,101 +1,101 @@
-/**
- * Characterization test template — lock existing behavior before refactoring.
- *
- * Instructions:
- *   1. Replace {{MODULE_NAME}} with the module under test.
- *   2. Replace {{IMPORT_PATH}} with the relative import path.
- *   3. Replace {{FUNCTION_NAME}} with each public export to characterize.
- *   4. Run once to generate snapshots: npx vitest run --update {{TEST_FILE}}
- *   5. Verify all tests pass BEFORE making any changes to the source.
- *
- * IMPORTANT: Capture ACTUAL behavior, not expected/ideal behavior.
- * If the current code has a bug, capture the buggy output — fix it separately.
- */
-
-import { describe, it, expect, vi, beforeEach } from 'vitest';
-// import { {{FUNCTION_NAME}} } from '{{IMPORT_PATH}}';
-
-describe('{{MODULE_NAME}} — characterization tests', () => {
-  beforeEach(() => {
-    vi.clearAllMocks();
-  });
-
-  // -------------------------------------------------------------------------
-  // Happy path — normal inputs
-  // -------------------------------------------------------------------------
-
-  it('should handle typical input', () => {
-    // const result = {{FUNCTION_NAME}}({{TYPICAL_INPUT}});
-    // expect(result).toMatchSnapshot();
-  });
-
-  it('should handle minimum valid input', () => {
-    // const result = {{FUNCTION_NAME}}({{MIN_INPUT}});
-    // expect(result).toMatchSnapshot();
-  });
-
-  it('should handle maximum valid input', () => {
-    // const result = {{FUNCTION_NAME}}({{MAX_INPUT}});
-    // expect(result).toMatchSnapshot();
-  });
-
-  // -------------------------------------------------------------------------
-  // Edge cases — boundary values
-  // -------------------------------------------------------------------------
-
-  it('should handle empty string input', () => {
-    // const result = {{FUNCTION_NAME}}('');
-    // expect(result).toMatchSnapshot();
-  });
-
-  it('should handle empty array input', () => {
-    // const result = {{FUNCTION_NAME}}([]);
-    // expect(result).toMatchSnapshot();
-  });
-
-  it('should handle zero / false / null-like values', () => {
-    // const result = {{FUNCTION_NAME}}(0);
-    // expect(result).toMatchSnapshot();
-  });
-
-  // -------------------------------------------------------------------------
-  // Error paths — failure modes
-  // -------------------------------------------------------------------------
-
-  it('should handle null input', () => {
-    // expect(() => {{FUNCTION_NAME}}(null)).toThrowErrorMatchingSnapshot();
-  });
-
-  it('should handle undefined input', () => {
-    // expect(() => {{FUNCTION_NAME}}(undefined)).toThrowErrorMatchingSnapshot();
-  });
-
-  it('should handle invalid type input', () => {
-    // expect(() => {{FUNCTION_NAME}}({{INVALID_INPUT}})).toThrowErrorMatchingSnapshot();
-  });
-
-  // -------------------------------------------------------------------------
-  // Side effects — external interactions
-  // -------------------------------------------------------------------------
-
-  it('should call external dependency with correct arguments', () => {
-    // const spy = vi.spyOn({{DEPENDENCY}}, '{{METHOD}}');
-    // {{FUNCTION_NAME}}({{TYPICAL_INPUT}});
-    // expect(spy).toHaveBeenCalledWith({{EXPECTED_ARGS}});
-    // expect(spy).toHaveBeenCalledTimes(1);
-  });
-
-  // -------------------------------------------------------------------------
-  // Branching paths — one test per major branch
-  // -------------------------------------------------------------------------
-
-  it('should take branch A when condition is true', () => {
-    // const result = {{FUNCTION_NAME}}({{BRANCH_A_INPUT}});
-    // expect(result).toMatchSnapshot();
-  });
-
-  it('should take branch B when condition is false', () => {
-    // const result = {{FUNCTION_NAME}}({{BRANCH_B_INPUT}});
-    // expect(result).toMatchSnapshot();
-  });
-});
+/**
+ * Characterization test template — lock existing behavior before refactoring.
+ *
+ * Instructions:
+ *   1. Replace {{MODULE_NAME}} with the module under test.
+ *   2. Replace {{IMPORT_PATH}} with the relative import path.
+ *   3. Replace {{FUNCTION_NAME}} with each public export to characterize.
+ *   4. Run once to generate snapshots: npx vitest run --update {{TEST_FILE}}
+ *   5. Verify all tests pass BEFORE making any changes to the source.
+ *
+ * IMPORTANT: Capture ACTUAL behavior, not expected/ideal behavior.
+ * If the current code has a bug, capture the buggy output — fix it separately.
+ */
+
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+// import { {{FUNCTION_NAME}} } from '{{IMPORT_PATH}}';
+
+describe('{{MODULE_NAME}} — characterization tests', () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+  });
+
+  // -------------------------------------------------------------------------
+  // Happy path — normal inputs
+  // -------------------------------------------------------------------------
+
+  it('should handle typical input', () => {
+    // const result = {{FUNCTION_NAME}}({{TYPICAL_INPUT}});
+    // expect(result).toMatchSnapshot();
+  });
+
+  it('should handle minimum valid input', () => {
+    // const result = {{FUNCTION_NAME}}({{MIN_INPUT}});
+    // expect(result).toMatchSnapshot();
+  });
+
+  it('should handle maximum valid input', () => {
+    // const result = {{FUNCTION_NAME}}({{MAX_INPUT}});
+    // expect(result).toMatchSnapshot();
+  });
+
+  // -------------------------------------------------------------------------
+  // Edge cases — boundary values
+  // -------------------------------------------------------------------------
+
+  it('should handle empty string input', () => {
+    // const result = {{FUNCTION_NAME}}('');
+    // expect(result).toMatchSnapshot();
+  });
+
+  it('should handle empty array input', () => {
+    // const result = {{FUNCTION_NAME}}([]);
+    // expect(result).toMatchSnapshot();
+  });
+
+  it('should handle zero / false / null-like values', () => {
+    // const result = {{FUNCTION_NAME}}(0);
+    // expect(result).toMatchSnapshot();
+  });
+
+  // -------------------------------------------------------------------------
+  // Error paths — failure modes
+  // -------------------------------------------------------------------------
+
+  it('should handle null input', () => {
+    // expect(() => {{FUNCTION_NAME}}(null)).toThrowErrorMatchingSnapshot();
+  });
+
+  it('should handle undefined input', () => {
+    // expect(() => {{FUNCTION_NAME}}(undefined)).toThrowErrorMatchingSnapshot();
+  });
+
+  it('should handle invalid type input', () => {
+    // expect(() => {{FUNCTION_NAME}}({{INVALID_INPUT}})).toThrowErrorMatchingSnapshot();
+  });
+
+  // -------------------------------------------------------------------------
+  // Side effects — external interactions
+  // -------------------------------------------------------------------------
+
+  it('should call external dependency with correct arguments', () => {
+    // const spy = vi.spyOn({{DEPENDENCY}}, '{{METHOD}}');
+    // {{FUNCTION_NAME}}({{TYPICAL_INPUT}});
+    // expect(spy).toHaveBeenCalledWith({{EXPECTED_ARGS}});
+    // expect(spy).toHaveBeenCalledTimes(1);
+  });
+
+  // -------------------------------------------------------------------------
+  // Branching paths — one test per major branch
+  // -------------------------------------------------------------------------
+
+  it('should take branch A when condition is true', () => {
+    // const result = {{FUNCTION_NAME}}({{BRANCH_A_INPUT}});
+    // expect(result).toMatchSnapshot();
+  });
+
+  it('should take branch B when condition is false', () => {
+    // const result = {{FUNCTION_NAME}}({{BRANCH_B_INPUT}});
+    // expect(result).toMatchSnapshot();
+  });
+});

package/skills/chub-usage/SKILL.md

@@ -1,139 +1,139 @@
----
-name: chub-usage
-tier: optional
-description: "Context Hub (chub) — fetch vetted, up-to-date API documentation. Write accurate code based on the latest docs instead of training data when working with external APIs/SDKs."
-triggers: [chub, context hub, API docs, latest API, deprecated API, SDK documentation, api reference, 최신 문서]
-priority: 65
----
-
-# Context Hub (chub) Usage
-
-A skill for fetching vetted, up-to-date documentation before writing external API/SDK code.
-Solves the knowledge cutoff problem inherent in training data.
-
-## Why?
-
-| Problem | Solution |
-|---------|----------|
-| Relying on training data → using deprecated APIs | chub get → code based on vetted latest docs |
-| Web search → noisy results | chub search → curated docs only |
-| Repeating the same mistakes every session | chub annotate → accumulated learnings |
-
-## When to Use
-
-| Situation | Example |
-|-----------|---------|
-| Writing external API code | "Integrate Stripe payments" |
-| Checking latest SDK version | "Call the latest OpenAI model" |
-| Need official documentation | "Set up Supabase auth" |
-| Preventing deprecated patterns | "Firebase v10 migration" |
-
-## Workflow
-
-```
-Request to write external API/SDK code
-    ↓
-Step 0: Check if chub is installed (auto-install if not)
-    ↓
-Step 1: chub search "<library name>"
-    ↓
-Step 2: chub get <id> --lang ts
-    ↓
-Step 3: Write code based on the docs
-    ↓
-Step 4: chub annotate when a gotcha is discovered
-```
-
-## Step 0 — Auto-install
-
-**Always perform this step before running the skill.**
-
-```bash
-# 1. Check if chub exists
-which chub || command -v chub
-```
-
-If chub is not found, attempt automatic installation:
-
-```bash
-npm install -g @aisuite/chub
-```
-
-If installation fails, fall back to running via `npx @aisuite/chub`:
-
-```bash
-# search example
-npx @aisuite/chub search "stripe"
-# get example
-npx @aisuite/chub get stripe/api --lang ts
-```
-
-If `npx` also fails, fall back to context7 or Web Search (see Fallback Chain).
-
-## Usage
-
-### Step 1 — Search for docs
-
-```bash
-chub search "stripe"
-chub search "openai"
-chub search ""           # View full list
-```
-
-### Step 2 — Fetch latest docs
-
-```bash
-chub get stripe/api --lang ts
-chub get openai/chat --lang py
-chub get supabase/auth --lang js
-```
-
-### Step 3 — Write code based on the docs
-
-Write accurate code based on the fetched documentation.
-**Never rely on training data. Docs first, code second.**
-
-### Step 4 — Record learnings
-
-Gotchas, workarounds, and version issues discovered during work:
-
-```bash
-chub annotate stripe/api "pg parameter is required for Korean payments"
-chub annotate openai/chat "tool_calls in streaming comes as delta"
-chub annotate firebase/auth "getAuth() import path changed in v10"
-```
-
-Annotations are stored locally and automatically included the next time you run `chub get`.
-
-## Implementation Pattern (Subagent)
-
-Run via subagent to prevent context bloat:
-
-```
-Task tool call:
-- subagent_type: Explore
-- model: haiku
-- prompt: "Run `chub search <library>` then `chub get <id> --lang <lang>` to fetch latest API documentation for [topic]. Return only the relevant API usage examples, key changes from previous versions, and any annotations."
-```
-
-The subagent handles the chub calls and returns only a summary — keeping the main context clean.
-
-## Supported APIs (1,000+)
-
-OpenAI, Anthropic, Stripe, Firebase, Supabase, Vercel, AWS S3, Cloudflare Workers, Auth0, Clerk, and more.
-
-```bash
-chub search    # Run without arguments to view the full list
-```
-
-## Fallback Chain
-
-```
-which chub fails
-    ↓
-npm install -g @aisuite/chub (auto attempt)
-    ↓
-On failure: npx @aisuite/chub <command> (temporary execution)
-    ↓
-If npx also fails: context7 or Web Search fallback
-```
+---
+name: chub-usage
+tier: optional
+description: "Context Hub (chub) — fetch vetted, up-to-date API documentation. Write accurate code based on the latest docs instead of training data when working with external APIs/SDKs."
+triggers: [chub, context hub, API docs, latest API, deprecated API, SDK documentation, api reference, 최신 문서]
+priority: 65
+---
+
+# Context Hub (chub) Usage
+
+A skill for fetching vetted, up-to-date documentation before writing external API/SDK code.
+Solves the knowledge cutoff problem inherent in training data.
+
+## Why?
+
+| Problem | Solution |
+|---------|----------|
+| Relying on training data → using deprecated APIs | chub get → code based on vetted latest docs |
+| Web search → noisy results | chub search → curated docs only |
+| Repeating the same mistakes every session | chub annotate → accumulated learnings |
+
+## When to Use
+
+| Situation | Example |
+|-----------|---------|
+| Writing external API code | "Integrate Stripe payments" |
+| Checking latest SDK version | "Call the latest OpenAI model" |
+| Need official documentation | "Set up Supabase auth" |
+| Preventing deprecated patterns | "Firebase v10 migration" |
+
+## Workflow
+
+```
+Request to write external API/SDK code
+    ↓
+Step 0: Check if chub is installed (auto-install if not)
+    ↓
+Step 1: chub search "<library name>"
+    ↓
+Step 2: chub get <id> --lang ts
+    ↓
+Step 3: Write code based on the docs
+    ↓
+Step 4: chub annotate when a gotcha is discovered
+```
+
+## Step 0 — Auto-install
+
+**Always perform this step before running the skill.**
+
+```bash
+# 1. Check if chub exists
+which chub || command -v chub
+```
+
+If chub is not found, attempt automatic installation:
+
+```bash
+npm install -g @aisuite/chub
+```
+
+If installation fails, fall back to running via `npx @aisuite/chub`:
+
+```bash
+# search example
+npx @aisuite/chub search "stripe"
+# get example
+npx @aisuite/chub get stripe/api --lang ts
+```
+
+If `npx` also fails, fall back to context7 or Web Search (see Fallback Chain).
+
+## Usage
+
+### Step 1 — Search for docs
+
+```bash
+chub search "stripe"
+chub search "openai"
+chub search ""           # View full list
+```
+
+### Step 2 — Fetch latest docs
+
+```bash
+chub get stripe/api --lang ts
+chub get openai/chat --lang py
+chub get supabase/auth --lang js
+```
+
+### Step 3 — Write code based on the docs
+
+Write accurate code based on the fetched documentation.
+**Never rely on training data. Docs first, code second.**
+
+### Step 4 — Record learnings
+
+Gotchas, workarounds, and version issues discovered during work:
+
+```bash
+chub annotate stripe/api "pg parameter is required for Korean payments"
+chub annotate openai/chat "tool_calls in streaming comes as delta"
+chub annotate firebase/auth "getAuth() import path changed in v10"
+```
+
+Annotations are stored locally and automatically included the next time you run `chub get`.
+
+## Implementation Pattern (Subagent)
+
+Run via subagent to prevent context bloat:
+
+```
+Task tool call:
+- subagent_type: Explore
+- model: haiku
+- prompt: "Run `chub search <library>` then `chub get <id> --lang <lang>` to fetch latest API documentation for [topic]. Return only the relevant API usage examples, key changes from previous versions, and any annotations."
+```
+
+The subagent handles the chub calls and returns only a summary — keeping the main context clean.
+
+## Supported APIs (1,000+)
+
+OpenAI, Anthropic, Stripe, Firebase, Supabase, Vercel, AWS S3, Cloudflare Workers, Auth0, Clerk, and more.
+
+```bash
+chub search    # Run without arguments to view the full list
+```
+
+## Fallback Chain
+
+```
+which chub fails
+    ↓
+npm install -g @aisuite/chub (auto attempt)
+    ↓
+On failure: npx @aisuite/chub <command> (temporary execution)
+    ↓
+If npx also fails: context7 or Web Search fallback
+```