@simplysm/sd-claude 13.0.55 → 13.0.57

package/claude/{rules → refs}/sd-code-conventions.md

@@ -8,6 +8,7 @@
 ## Prototype Extensions
 
 Importing `@simplysm/core-common` adds extension methods to Array, Map, Set:
+
 - `Array`: `single()`, `filterExists()`, `groupBy()`, `orderBy()`, etc.
 - `Map`: `getOrCreate()`, `update()`
 - `Set`: `adds()`, `toggle()`
@@ -28,6 +29,11 @@ function readFileSync() { ... }        // Sync version
 async function readFileAsync() { ... } // Async suffix prohibited
 ```
 
+## File Naming
+
+- Auxiliary files (`types.ts`, `utils.ts`, etc.) must be prefixed with the main file name (e.g., `CrudSheet.types.ts`)
+- File names must be self-identifying without relying on the parent directory
+
 ## JSDoc Convention
 
 - Not enforced — omit when code is self-explanatory

package/claude/refs/sd-orm.md

@@ -0,0 +1,17 @@
+# ORM Guidelines
+
+## Table Definition
+```typescript
+const User = Table("User")
+  .database("mydb")
+  .columns((c) => ({ id: c.bigint().autoIncrement(), name: c.varchar(100) }))
+  .primaryKey("id");
+```
+
+## SQL Injection Prevention
+ORM uses string escaping (not parameter binding). **Always validate user input before ORM queries.**
+```typescript
+const userId = Number(req.query.id);
+if (Number.isNaN(userId)) throw new Error("Invalid ID");
+await db.user().where((u) => [expr.eq(u.id, userId)]).result();
+```

package/claude/refs/sd-service.md

@@ -0,0 +1,5 @@
+# Service Guidelines
+
+- `ServiceServer`: Fastify-based HTTP/WebSocket server
+- `ServiceClient`: WebSocket client, RPC calls
+- `ServiceProtocol`: Message split/merge (300KB chunks when >3MB)

package/claude/refs/sd-simplysm-docs.md

@@ -0,0 +1,52 @@
+# @simplysm Package Documentation
+
+When you need API details, usage examples, or component props for `@simplysm/*` packages,
+read the package's README.md from node_modules.
+
+## How to use
+
+Read the package README directly:
+
+```
+node_modules/@simplysm/{package-name}/README.md
+```
+
+If not found (pnpm hoisting), try:
+
+```
+packages/*/node_modules/@simplysm/{package-name}/README.md
+```
+
+## When to use
+
+**MANDATORY**: Read the relevant README BEFORE any of the following:
+
+- Writing new code that uses `@simplysm/*` APIs
+- Fixing type errors or bugs in code that uses `@simplysm/*` APIs
+- Making assumptions about type mappings (e.g., DB column types → TypeScript types)
+- Refactoring or migrating code that depends on `@simplysm/*` packages
+
+Do NOT guess API behavior or type mappings — always verify from the README first.
+
+## Available Packages
+
+| Package                        | Description                                                     |
+| ------------------------------ | --------------------------------------------------------------- |
+| `core-common`                  | Common utilities, custom types (DateTime, DateOnly, Time, Uuid) |
+| `core-browser`                 | Browser-specific extensions                                     |
+| `core-node`                    | Node.js utilities (filesystem, workers)                         |
+| `orm-common`                   | ORM query builder, table schema definitions                     |
+| `orm-node`                     | DB connectors (MySQL, MSSQL, PostgreSQL)                        |
+| `service-common`               | Service protocol, type definitions                              |
+| `service-client`               | WebSocket client                                                |
+| `service-server`               | Fastify-based HTTP/WebSocket server                             |
+| `solid`                        | SolidJS UI components + Tailwind CSS                            |
+| `excel`                        | Excel (.xlsx) read/write                                        |
+| `storage`                      | FTP/SFTP client                                                 |
+| `sd-cli`                       | Build, lint, typecheck CLI tool                                 |
+| `claude`                       | Claude Code skills/agents (auto-installs via postinstall)       |
+| `eslint-plugin`                | Custom ESLint rules                                             |
+| `capacitor-plugin-auto-update` | Auto update                                                     |
+| `capacitor-plugin-broadcast`   | Broadcast                                                       |
+| `capacitor-plugin-file-system` | File system                                                     |
+| `capacitor-plugin-usb-storage` | USB storage                                                     |

package/claude/refs/sd-solid.md

@@ -0,0 +1,49 @@
+# SolidJS Guidelines
+
+**SolidJS is NOT React!**
+
+## Core Concepts
+- Component functions run **once** at mount (not on every state change)
+- Fine-grained reactivity: unchanged signals don't re-evaluate expressions
+- `createMemo`: only for expensive computations used in multiple places
+- **Props destructuring prohibited** → use `props.xxx`
+- Conditionals: `<Show>`, Lists: `<For>`
+- No SSR → browser APIs usable directly
+- Responsive: Mobile UI below 520px
+- Chrome 84+ target
+  - CSS NOT transpiled → no `aspect-ratio`, `inset`, `:is()`, `:where()`
+
+## Props Design
+- Props that don't need parameters must accept plain values (`editable={perms().edit}`), not wrapped in functions (`editable={() => perms().edit}`) — use function props only when parameters are needed (callbacks)
+
+## Implementation Rules
+- Prefer signals/stores over Provider/Context
+- Check existing patterns before introducing abstractions
+- Before modifying components: always Read the file to check existing props/patterns
+
+## Hook Naming
+- `create*`: Reactive hooks wrapping SolidJS primitives
+- `use*`: Hooks depending on Provider Context
+- Others: no hook prefix
+
+## Compound Components
+All sub-components via dot notation only (`Parent.Child`).
+- Define `interface ParentComponent { Child: typeof ChildComponent }`
+- Assign `Parent.Child = ChildComponent;`
+- Don't export sub-components separately (export parent only)
+- UI elements → compound sub-components, non-rendering config (state, behavior, callbacks) → props
+
+## Tailwind CSS
+- `darkMode: "class"`, `aspectRatio` plugin disabled (Chrome 84)
+- Semantic colors: `primary`(blue), `info`(sky), `success`(green), `warning`(amber), `danger`(red), `base`(zinc) → never use `zinc-*` directly
+- Heights: `field`, `field-sm`, `field-lg`
+- z-index: `sidebar`(100), `sidebar-backdrop`(99), `dropdown`(1000)
+- Default `rem`, use `em` for text-relative sizing (e.g., Icon)
+- Use `clsx()` with semantic grouping + `twMerge()` for conflict resolution
+- Before modifying styles: Read existing class patterns of the same component
+
+## Application View Naming (`client-*`)
+- `~Sheet` — List view based on DataSheet (e.g., `UserSheet`)
+- `~Detail` — Single record detail/edit view (e.g., `MyInfoDetail`)
+- `~View` — Everything else (e.g., `LoginView`, `MainView`)
+- Directory: `src/views/` (usable as standalone page, embedded component, or modal)

package/claude/rules/sd-refs-linker.md

@@ -0,0 +1,18 @@
+# Reference Guide
+
+Before starting work, **Read** the relevant reference files from `.claude/refs/`.
+
+| When | Read this file |
+|------|---------------|
+| Writing or modifying code | `.claude/refs/sd-code-conventions.md` |
+| Working with `.cache/` or Playwright screenshots | `.claude/refs/sd-directories.md` |
+| Using `@simplysm/*` package APIs | `.claude/refs/sd-simplysm-docs.md` |
+| Debugging, problem-solving, or planning approach | `.claude/refs/sd-workflow.md` |
+| SolidJS / @simplysm/solid / Tailwind 작업 시 | `.claude/refs/sd-solid.md` |
+| @simplysm/orm-* 사용 시 (`@^13`) | `.claude/refs/sd-orm.md` |
+| @simplysm/service-* 사용 시 (`@^13`) | `.claude/refs/sd-service.md` |
+
+**Rules:**
+- Read the reference BEFORE starting the related work (not after)
+- You may read multiple references if the task spans multiple areas
+- If unsure whether a reference applies, read it — the cost of reading is low

package/claude/skills/sd-check/SKILL.md

@@ -1,184 +1,40 @@
 ---
 name: sd-check
 description: Use when verifying code quality via typecheck, lint, and tests - before deployment, PR creation, after code changes, or when type errors, lint violations, or test failures are suspected. Applies to whole project or specific paths.
-allowed-tools: Bash(node .claude/skills/sd-check/run-checks.mjs), Bash(pnpm typecheck), Bash(pnpm lint --fix), Bash(pnpm vitest)
+allowed-tools: Bash(pnpm check), Bash(pnpm typecheck), Bash(pnpm lint --fix), Bash(pnpm vitest)
 ---
 
 # sd-check
 
-Verify code quality through parallel execution of typecheck, lint, and test checks.
-
-## Overview
-
-**This skill provides EXACT STEPS you MUST follow - it is NOT a command to invoke.**
-
-**Foundational Principle:** Violating the letter of these steps is violating the spirit of verification.
-
-When the user asks to verify code, YOU will manually execute **EXACTLY THESE 3 STEPS** (no more, no less):
-
-**Step 1:** Run the unified check script (single background command)
-**Step 2:** Collect results, fix errors in priority order
-**Step 3:** Re-verify (go back to Step 1) until all pass
-
-**Core principle:** Always re-run ALL checks after any fix - changes can cascade.
-
-**CRITICAL:**
-- This skill verifies ONLY typecheck, lint, and test
-- **NO BUILD. NO DEV SERVER. NO TEAMS. NO TASK LISTS.**
-- Do NOT create your own "better" workflow - follow these 3 steps EXACTLY
+Run `pnpm check`, fix errors, repeat until clean.
 
 ## Usage
 
-- `/sd-check` — verify entire project
-- `/sd-check packages/core-common` — verify specific path only
-
-**Default:** If no path argument provided, verify entire project.
-
-## Quick Reference
-
-| Check | Purpose |
-|-------|---------|
-| Typecheck | Type errors |
-| Lint | Code quality (with auto-fix) |
-| Test | Functionality |
-
-**All 3 run in PARALLEL** inside the unified script (single command).
-
-## Workflow
-
-### Step 1: Run Unified Check Script
-
-Launch the single check command in background:
-
-```
-Bash tool:
-  command: "node .claude/skills/sd-check/run-checks.mjs [path]"
-  description: "Run typecheck + lint + test"
-  timeout: 600000
-```
-
-Replace `[path]` with user's argument, or OMIT if no argument (defaults to full project).
-
-**Output format:**
 ```
-====== TYPECHECK: PASS ======
-
-====== LINT: FAIL → .tmp/sd-check/lint.log ======
-
-====== TEST: PASS (47 tests) ======
-
-====== SUMMARY: 1/3 FAILED (lint) ======
+pnpm check [path] [--type typecheck|lint|test]
 ```
 
-- Failed checks write full output to `.tmp/sd-check/{name}.log`
-- Use the **Read tool** to read log files for error details
-
-- **ENV-CHECK FAIL**: Environment prerequisites missing. Report to user and STOP.
-- **SUMMARY: ALL PASSED**: Complete (see Completion Criteria).
-- **SUMMARY: N/3 FAILED**: Proceed to Step 2.
+| Example | Effect |
+|---------|--------|
+| `/sd-check` | Full project, all checks |
+| `/sd-check packages/core-common` | Specific path, all checks |
+| `/sd-check test` | Tests only, full project |
+| `/sd-check packages/core-common lint` | Specific path + type |
 
-### Step 2: Fix Errors
+Multiple types: `--type typecheck,lint`. No path = full project. No type = all checks.
 
-1. **Analyze by priority:** Typecheck → Lint → Test
-   - Typecheck errors may cause lint/test errors (cascade)
-
-2. **Read log files** (`.tmp/sd-check/{name}.log`) to see full error output, then **read failing source files** to identify root cause
-
-3. **Fix with Edit:**
-   - **Typecheck:** Fix type issues
-   - **Lint:** Fix code quality (most auto-fixed by `--fix`)
-   - **Test:**
-     - Run `git diff` to check intentional changes
-     - If changes not reflected in tests: Update test
-     - If source bug: Fix source
-     - **If root cause unclear OR 2-3 fix attempts failed:** Recommend `/sd-debug`
-
-4. **Proceed to Step 3**
-
-### Step 3: Re-verify (Loop Until All Pass)
-
-**CRITICAL:** After ANY fix, re-run ALL 3 checks.
-
-Go back to Step 1 and run the unified script again.
-
-**Do NOT assume:** "I only fixed typecheck → skip lint/test". Fixes cascade.
-
-Repeat Steps 1-3 until all 3 checks pass.
-
-## Common Mistakes
-
-### Fixing before reading full output
-**Wrong:** See first error in output → fix immediately
-**Right:** Read full SUMMARY → collect all errors → fix in priority order → re-verify
-
-### Skipping re-verification after fixes
-**Wrong:** Fix typecheck → assume lint/test still pass
-**Right:** ALWAYS re-run the script after any fix
-
-### Using agents instead of background Bash
-**Wrong:** Launch haiku/sonnet/opus agents via Task tool to run the script
-**Right:** Use `Bash` with `run_in_background: true` (no model overhead)
-
-### Including build/dev steps
-**Wrong:** Run `pnpm build` or `pnpm dev` as part of verification
-**Right:** sd-check is ONLY typecheck, lint, test (no build, no dev)
-
-### Asking user for path
-**Wrong:** No path provided → ask "which package?"
-**Right:** No path → verify entire project (omit path in command)
-
-### Infinite fix loop
-**Wrong:** Keep trying same fix when tests fail repeatedly
-**Right:** After 2-3 failed attempts → recommend `/sd-debug`
-
-### Claiming success without fresh evidence
-**Wrong:** "All checks should pass now" or "Great, that fixes it!"
-**Right:** Run script → read output → cite results (e.g., "0 errors, 47 tests passed") → THEN claim
-
-## Red Flags - STOP and Follow Workflow
-
-If you find yourself doing ANY of these, you're violating the skill:
-
-- Including build or dev server in verification
-- Using Task/agent instead of background Bash
-- Not re-verifying after every fix
-- Asking user for path when none provided
-- Continuing past 2-3 failed fix attempts without recommending `/sd-debug`
-- Expressing satisfaction ("Great!", "Perfect!", "Done!") before all 3 checks pass
-- Using vague language: "should work", "probably passes", "seems fine"
-- Claiming completion based on a previous run, not the current one
-
-**All of these violate the skill's core principles. Go back to Step 1 and follow the workflow exactly.**
-
-## Completion Criteria
-
-**Complete when:**
-- All 3 checks (typecheck, lint, test) pass without errors **in the most recent run**
-- Report with evidence: "All checks passed" + cite actual output (e.g., "0 errors", "47 tests passed")
-
-**Fresh evidence required:**
-- "Passes" = you ran it THIS iteration and saw it pass in the output
-- Previous run results are NOT evidence for current state
-- Confidence is NOT evidence — run the check
+## Workflow
 
-**Do NOT complete if:**
-- Any check has errors
-- Haven't re-verified after a fix
-- Environment pre-checks failed
-- Using "should", "probably", or "seems to" instead of actual output
+1. **Run** `pnpm check [path] [--type type]` (timeout: 600000)
+2. **All passed?** Report with actual output numbers → done
+3. **Errors?** Fix in priority order: typecheck → lint → test (fixes cascade)
+   - Test failures: run `git diff` to decide — update test or fix source
+   - Stuck after 2-3 attempts → recommend `/sd-debug`
+4. **Go to 1** — always re-run ALL checks after any fix
 
-## Rationalization Table
+## Rules
 
-| Excuse | Reality |
-|--------|---------|
-| "I'm following the spirit, not the letter" | Violating the letter IS violating the spirit - follow EXACTLY |
-| "I'll create a better workflow with teams/tasks" | Follow the 3 steps EXACTLY - no teams, no task lists |
-| "Agents can analyze output better" | Background Bash is sufficient - analysis happens in main context |
-| "I only fixed lint, typecheck still passes" | Always re-verify ALL - fixes can cascade |
-| "Build is part of verification" | Build is deployment, not verification - NEVER include it |
-| "Let me ask which path to check" | Default to full project - explicit behavior |
-| "I'll try one more fix approach" | After 2-3 attempts → recommend /sd-debug |
-| "Tests are independent of types" | Type fixes affect tests - always re-run ALL |
-| "I'm confident it passes" | Confidence is not evidence — run the check |
-| "It should work now" | "Should" = no evidence — run the check |
-| "I already verified earlier" | Earlier is not now — re-run after every change |
+- **Always re-run ALL checks** after any fix — never assume other checks still pass
+- **Report with evidence** — cite actual numbers (e.g., "0 errors, 47 tests passed"), not "should work"
+- **No build, no dev server** — typecheck + lint + test only
+- **Run Bash directly** — no Task/agent/team overhead

package/claude/skills/sd-check/run-checks.mjs

@@ -1,9 +1,8 @@
-import { readFileSync, existsSync, mkdirSync, writeFileSync } from "fs";
+import { readFileSync, existsSync } from "fs";
 import { resolve } from "path";
 import { spawn } from "child_process";
 
 const root = resolve(import.meta.dirname, "../../..");
-const pathArg = process.argv[2];
 
 // ══════════════════════════════════════════
 // Phase 1: Environment Pre-check
@@ -20,11 +19,8 @@ if (!existsSync(pkgPath)) {
   if (Number.isNaN(major) || major < 13) {
     errors.push(`This skill requires simplysm v13+. Current: ${pkg.version}`);
   }
-  if (!pkg.scripts?.typecheck) {
-    errors.push("'typecheck' script not defined in package.json");
-  }
-  if (!pkg.scripts?.lint) {
-    errors.push("'lint' script not defined in package.json");
+  if (!pkg.scripts?.check) {
+    errors.push("'check' script not defined in package.json");
   }
 }
 
@@ -44,80 +40,15 @@ if (errors.length > 0) {
   process.exit(1);
 }
 
-// ══════════════════════════════════════════
-// Phase 2: Run 3 checks in parallel
-// ══════════════════════════════════════════
-
-const logDir = resolve(root, ".tmp/sd-check");
-
-function runCommand(name, cmd, args) {
-  return new Promise((res) => {
-    const child = spawn(cmd, args, { cwd: root, shell: true, stdio: "pipe" });
-    const chunks = [];
-
-    child.stdout.on("data", (d) => chunks.push(d));
-    child.stderr.on("data", (d) => chunks.push(d));
-
-    child.on("close", (code) => {
-      const output = Buffer.concat(chunks).toString("utf8");
-      res({ name, code, output });
-    });
-
-    child.on("error", (err) => {
-      res({ name, code: 1, output: err.message });
-    });
-  });
-}
-
-function extractTestCount(output) {
-  const match =
-    output.match(/(\d+)\s+tests?\s+passed/i) ??
-    output.match(/Tests\s+(\d+)\s+passed/i) ??
-    output.match(/(\d+)\s+pass/i);
-  return match ? match[1] : null;
-}
-
-const checks = [
-  { name: "TYPECHECK", cmd: "pnpm", args: pathArg ? ["typecheck", pathArg] : ["typecheck"] },
-  { name: "LINT", cmd: "pnpm", args: pathArg ? ["lint", "--fix", pathArg] : ["lint", "--fix"] },
-  { name: "TEST", cmd: "pnpm", args: pathArg ? ["vitest", pathArg, "--run"] : ["vitest", "--run"] },
-];
-
-const results = await Promise.all(checks.map((c) => runCommand(c.name, c.cmd, c.args)));
+console.log("ENV-CHECK OK");
 
 // ══════════════════════════════════════════
-// Output results
+// Phase 2: Delegate to pnpm check
 // ══════════════════════════════════════════
 
-const failed = [];
-mkdirSync(logDir, { recursive: true });
-
-for (const r of results) {
-  const passed = r.code === 0;
-  let label = passed ? "PASS" : "FAIL";
-
-  if (passed && r.name === "TEST") {
-    const count = extractTestCount(r.output);
-    if (count) label = `PASS (${count} tests)`;
-  }
-
-  if (passed) {
-    console.log(`\n${"=".repeat(6)} ${r.name}: ${label} ${"=".repeat(6)}`);
-  } else {
-    const logFile = resolve(logDir, `${r.name.toLowerCase()}.log`);
-    writeFileSync(logFile, r.output, "utf8");
-    console.log(`\n${"=".repeat(6)} ${r.name}: ${label} → ${logFile} ${"=".repeat(6)}`);
-    failed.push(r.name.toLowerCase());
-  }
-}
-
-console.log();
-if (failed.length === 0) {
-  console.log(`${"=".repeat(6)} SUMMARY: ALL PASSED ${"=".repeat(6)}`);
-} else {
-  console.log(
-    `${"=".repeat(6)} SUMMARY: ${failed.length}/3 FAILED (${failed.join(", ")}) ${"=".repeat(6)}`,
-  );
-}
+const args = ["check", ...process.argv.slice(2)];
+const child = spawn("pnpm", args, { cwd: root, shell: true, stdio: "inherit" });
 
-process.exit(failed.length > 0 ? 1 : 0);
+child.on("close", (code) => {
+  process.exit(code ?? 1);
+});

package/claude/skills/sd-plan/SKILL.md

@@ -19,10 +19,13 @@ Turn a design doc into a step-by-step implementation plan through codebase explo
 - Ask questions one at a time as they arise during planning, with your recommendation
 - Don't batch questions upfront — real questions emerge while deep in the details
 
-**Ask about:**
-- Conflicts with existing codebase patterns discovered while exploring
-- Implementation choices the design didn't specify (which pattern, which abstraction level)
-- Ambiguous behavior uncovered while designing tests or file structure
+**Ask about anything you're not 100% confident about.** Examples:
+- Dependency choices (add library vs implement directly)
+- Conflicts with existing codebase patterns
+- Implementation choices the design didn't specify
+- Ambiguous behavior or edge cases
+- Migration concerns (breaking changes, compatibility)
+- If in doubt, ask. The cost of asking is low; the cost of a wrong assumption is high.
 
 **Don't ask — just decide:**
 - Internal details covered by project conventions (file naming, export patterns)

package/claude/skills/sd-worktree/sd-worktree.mjs

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import { execSync } from "node:child_process";
-import { existsSync } from "node:fs";
-import { resolve } from "node:path";
+import { existsSync, rmSync } from "node:fs";
+import { resolve, sep } from "node:path";
 
 const [cmd, ...args] = process.argv.slice(2);
 
@@ -21,8 +21,8 @@ const mainWorktree = getOutput("git worktree list --porcelain")
 function detectWorktreeName() {
   const cwd = process.cwd();
   const worktreesDir = resolve(mainWorktree, ".worktrees");
-  if (cwd.startsWith(worktreesDir + "/")) {
-    return cwd.slice(worktreesDir.length + 1).split("/")[0];
+  if (cwd.startsWith(worktreesDir + sep)) {
+    return cwd.slice(worktreesDir.length + 1).split(sep)[0];
   }
   return undefined;
 }
@@ -118,7 +118,14 @@ switch (cmd) {
     }
     if (existsSync(worktreePath)) {
       console.log(`Removing worktree: .worktrees/${name}`);
-      run(`git worktree remove "${worktreePath}"`, { cwd: mainWorktree });
+      try {
+        run(`git worktree remove --force "${worktreePath}"`, { cwd: mainWorktree });
+      } catch {
+        // node_modules 등으로 git worktree remove 실패 시 수동 정리
+        console.log("git worktree remove failed, cleaning up manually...");
+        rmSync(worktreePath, { recursive: true, force: true });
+        run("git worktree prune", { cwd: mainWorktree });
+      }
     }
     console.log(`Deleting branch: ${name}`);
     run(`git branch -d "${name}"`, { cwd: mainWorktree });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@simplysm/sd-claude",
-  "version": "13.0.55",
+  "version": "13.0.57",
   "description": "Simplysm Claude Code CLI — asset installer and cross-platform npx wrapper",
   "author": "김석래",
   "license": "Apache-2.0",

package/claude/rules/sd-simplysm-docs.md

@@ -1,52 +0,0 @@
-# @simplysm Package Documentation
-
-When you need API details, usage examples, or component props for `@simplysm/*` packages,
-read the package's README.md from node_modules.
-
-## How to use
-
-Read the package README directly:
-
-```
-node_modules/@simplysm/{package-name}/README.md
-```
-
-If not found (pnpm hoisting), try:
-
-```
-packages/*/node_modules/@simplysm/{package-name}/README.md
-```
-
-## When to use
-
-**MANDATORY**: Read the relevant README BEFORE any of the following:
-
-- Writing new code that uses `@simplysm/*` APIs
-- Fixing type errors or bugs in code that uses `@simplysm/*` APIs
-- Making assumptions about type mappings (e.g., DB column types → TypeScript types)
-- Refactoring or migrating code that depends on `@simplysm/*` packages
-
-Do NOT guess API behavior or type mappings — always verify from the README first.
-
-## Available Packages
-
-| Package | Description |
-|---------|-------------|
-| `core-common` | Common utilities, custom types (DateTime, DateOnly, Time, Uuid) |
-| `core-browser` | Browser-specific extensions |
-| `core-node` | Node.js utilities (filesystem, workers) |
-| `orm-common` | ORM query builder, table schema definitions |
-| `orm-node` | DB connectors (MySQL, MSSQL, PostgreSQL) |
-| `service-common` | Service protocol, type definitions |
-| `service-client` | WebSocket client |
-| `service-server` | Fastify-based HTTP/WebSocket server |
-| `solid` | SolidJS UI components + Tailwind CSS |
-| `excel` | Excel (.xlsx) read/write |
-| `storage` | FTP/SFTP client |
-| `sd-cli` | Build, lint, typecheck CLI tool |
-| `claude` | Claude Code skills/agents (auto-installs via postinstall) |
-| `eslint-plugin` | Custom ESLint rules |
-| `capacitor-plugin-auto-update` | Auto update |
-| `capacitor-plugin-broadcast` | Broadcast |
-| `capacitor-plugin-file-system` | File system |
-| `capacitor-plugin-usb-storage` | USB storage |