@shuji-bonji/rxjs-mcp 0.3.0 → 0.4.0

package/CHANGELOG.md

@@ -5,6 +5,20 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.4.0] - 2026-05-17
+
+### Added
+- **`lint_rxjs` ツール**: eslint-plugin-rxjs-x の recommended/strict ルールを正規表現ベースで再実装。コードスニペットを渡すだけで即座にフィードバック（ESLint 不要）
+  - **20 recommended ルール**: no-async-subscribe, no-create, no-nested-subscribe, no-sharereplay, prefer-root-operators, no-topromise, no-unsafe-takeuntil, throw-error 等
+  - **8 strict ルール**: no-exposed-subjects, no-floating-observables, no-misused-observables, no-subclass, finnish 等
+  - **フレームワーク固有ルール**: Angular (takeUntilDestroyed 推奨), React (useEffect 内 subscribe), Vue (onUnmounted cleanup)
+  - `config` パラメータ: `recommended`（デフォルト）/ `strict`
+  - `framework` パラメータ: `angular` / `react` / `vue` / `none`
+  - `rules` パラメータ: 個別ルール指定可能
+
+### Changed
+- `DOC_BASE_URL` エイリアスを削除 (v0.3.0 で deprecated 告知済み)
+
 ## [0.3.0] - 2026-05-16
 
 ### BREAKING

package/README.md

@@ -212,6 +212,31 @@ Available patterns:
 - `cache-refresh` - Cache with refresh strategy
 - And more...
 
+### lint_rxjs
+
+Lint RxJS code snippets for common issues and best practices. Based on [eslint-plugin-rxjs-x](https://github.com/JasonWeinzierl/eslint-plugin-rxjs-x) rules.
+
+```typescript
+// Parameters:
+{
+  code: string;           // RxJS code to lint
+  config?: 'recommended' | 'strict';  // Rule set (default: recommended)
+  framework?: 'angular' | 'react' | 'vue' | 'none'; // Framework context
+  rules?: string[];       // Specific rules to check (overrides config)
+}
+```
+
+**Config levels:**
+
+- `recommended` — 20 rules covering the most common issues
+- `strict` — All rules including style checks (finnish, no-exposed-subjects, etc.)
+
+**Framework-specific checks:**
+
+- **Angular** — Detects missing `takeUntilDestroyed()` or `takeUntil(destroy$)` in components
+- **React** — Detects `subscribe()` without `useEffect` cleanup
+- **Vue** — Detects `subscribe()` without `onUnmounted` cleanup
+
 ## Usage Examples
 
 ### With Claude
@@ -329,9 +354,42 @@ Future Meta-MCP integration will allow seamless coordination between these tools
 │ • analyze_operators│
 │ • detect_memory_leak│
 │ • suggest_pattern│
+│ • lint_rxjs      │
 └─────────────────┘
 ```
 
+## Documentation Reference System
+
+Since v0.3.0, `analyze_operators` outputs three-tier documentation links for each operator and creation function:
+
+| Tier | Source | Purpose | AI-readable? |
+|------|--------|---------|:---:|
+| **Official** | [rxjs.dev](https://rxjs.dev) | Authoritative API reference for humans | ❌ (SPA) |
+| **Source** | [GitHub (tag 7.8.2)](https://github.com/ReactiveX/rxjs/tree/7.8.2/src/internal) | JSDoc + implementation — the richest context for AI | ✅ |
+| **Guide** | [RxJS-with-TypeScript](https://github.com/shuji-bonji/RxJS-with-TypeScript) | Bilingual JP/EN explanations with practical examples | ✅ |
+
+### Why include the community guide alongside official docs?
+
+1. **rxjs.dev is a client-rendered SPA.** AI assistants cannot fetch its content — HTTP requests return an empty shell with JavaScript loaders. The official site is therefore a "link to hand to humans," not a source AI can read.
+
+2. **GitHub source provides raw truth.** The RxJS source code (pinned at tag `7.8.2`) contains JSDoc, type signatures, and implementation details. This is the primary reference for AI assistants.
+
+3. **The bilingual guide adds learning context.** It organizes operators by use-case (not just alphabetically), provides runnable examples, and offers Japanese translations. For Japanese-speaking users or learners, this fills a gap that neither rxjs.dev nor raw source addresses.
+
+### Priority order
+
+When the MCP server outputs references, it follows this priority:
+
+1. `officialUrl` — always shown (authority, human-readable)
+2. `sourceUrl` — shown when available (AI should read this)
+3. `guideUrl` — shown when the page exists (supplementary)
+
+If a guide page does not yet exist for an operator, the field is simply omitted (no broken link). Coverage is tracked by the [URL validation CI](.github/workflows/url-validation.yml).
+
+### Can I disable the guide references?
+
+Currently there is no runtime option to exclude `guideUrl` from output. If you prefer official-only references, you can fork this server or open a feature request. A future version may support a `--references=official,source` flag.
+
 ## Contributing
 
 Contributions are welcome! Please feel free to submit a PR.

package/dist/data/lint-rules.d.ts

@@ -0,0 +1,33 @@
+/**
+ * RxJS Lint Rules Database
+ *
+ * Regex-based reimplementation of eslint-plugin-rxjs-x rules.
+ * These rules work on code snippets without requiring ESLint runtime or TypeScript parser.
+ *
+ * Reference: https://github.com/JasonWeinzierl/eslint-plugin-rxjs-x
+ */
+export type LintSeverity = 'error' | 'warning' | 'info';
+export type LintConfig = 'recommended' | 'strict';
+export type FrameworkContext = 'angular' | 'react' | 'vue' | 'none';
+export interface LintDiagnostic {
+    rule: string;
+    severity: LintSeverity;
+    message: string;
+    line?: number;
+    suggestion?: string;
+    docUrl: string;
+}
+export interface LintRule {
+    name: string;
+    description: string;
+    severity: LintSeverity;
+    config: LintConfig;
+    /** Whether this rule requires type information (cannot be fully checked with regex) */
+    requiresTypeInfo: boolean;
+    docUrl: string;
+    check: (code: string, framework: FrameworkContext) => LintDiagnostic[];
+}
+export declare const allLintRules: LintRule[];
+/** Get rules for a given config level */
+export declare function getRulesForConfig(config: LintConfig): LintRule[];
+//# sourceMappingURL=lint-rules.d.ts.map

package/dist/data/lint-rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lint-rules.d.ts","sourceRoot":"","sources":["../../src/data/lint-rules.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AACxD,MAAM,MAAM,UAAU,GAAG,aAAa,GAAG,QAAQ,CAAC;AAClD,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,OAAO,GAAG,KAAK,GAAG,MAAM,CAAC;AAEpE,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,YAAY,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,YAAY,CAAC;IACvB,MAAM,EAAE,UAAU,CAAC;IACnB,uFAAuF;IACvF,gBAAgB,EAAE,OAAO,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,gBAAgB,KAAK,cAAc,EAAE,CAAC;CACxE;AAigCD,eAAO,MAAM,YAAY,EAAE,QAAQ,EAiClC,CAAC;AAEF,yCAAyC;AACzC,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,GAAG,QAAQ,EAAE,CAMhE"}