@zonuexe/techbook-mcp 0.2.2 → 0.2.4

package/.claude/settings.local.json

@@ -1,36 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "Bash(npm info:*)",
-      "Bash(python3 -c \"import sys,json; d=json.load\\(sys.stdin\\); print\\('version:', d.get\\('version'\\)\\); print\\('exports:', list\\(d.get\\('exports', {}\\).keys\\(\\)\\)[:20]\\)\")",
-      "WebFetch(domain:gihyo.jp)",
-      "WebFetch(domain:www.lambdanote.com)",
-      "Bash(curl:*)",
-      "Bash(python3 -c ':*)",
-      "Bash(npx vitest:*)",
-      "Bash(git mv:*)",
-      "Bash(git add:*)",
-      "Bash(git commit -m ':*)",
-      "Bash(node:*)",
-      "Bash(npm install:*)",
-      "Bash(curl -s \"https://wgn-obs.shop-pro.jp/?mode=srh&keyword=HTML\" -A \"Mozilla/5.0\")",
-      "Read(//tmp/**)",
-      "Bash(npm test:*)",
-      "Bash(python3:*)",
-      "WebFetch(domain:www.personal-media.co.jp)",
-      "Bash(grep -rn \"export.*Element\" node_modules/cheerio/dist/esm/*.d.ts)",
-      "Bash(npx tsc:*)",
-      "Bash(npx oxlint:*)",
-      "Bash(npm run:*)",
-      "Bash(curl -s \"https://book.impress.co.jp/books/1124101031\")",
-      "Bash(curl -s \"https://book.impress.co.jp/books/1125101113\")",
-      "Bash(cp /tmp/impress-detail-social.html tests/fixtures/impress-detail-social.html)",
-      "Bash(cp /tmp/impress-detail-nodrm.html tests/fixtures/impress-detail-epub.html)",
-      "Bash(wc -c tests/fixtures/impress-detail-*.html)",
-      "Bash(git -C /Users/megurine/repo/js/techbook-mcp status)",
-      "Bash(git -C /Users/megurine/repo/js/techbook-mcp diff)",
-      "Bash(git:*)",
-      "Bash(npm pkg:*)"
-    ]
-  }
-}

package/.codex/skills/techbook-mcp-release-prep/SKILL.md

@@ -1,105 +0,0 @@
----
-name: techbook-mcp-release-prep
-description: Prepare a techbook-mcp release by bumping the version, updating the changelog, and running verification. Use when the user asks to prepare the next version, cut a release, or make sure versioned files are consistent before tagging.
----
-
-# techbook-mcp Release Prep
-
-Follow this workflow when preparing a new `techbook-mcp` release.
-
-## Decide the Next Version
-
-Choose the next semantic version before touching any files.
-
-- `patch` (0.x.Y) — bug fixes, no new functionality
-- `minor` (0.X.0) — new adapters, new features, backward-compatible changes
-- `major` (X.0.0) — breaking changes to the MCP tool interface or `BookRecord` schema
-
-If the user specifies a version, use it. Otherwise infer from the unreleased commits since the last tag.
-
-## Update Versioned Files
-
-Update these files together in one pass:
-
-- `CHANGELOG.md`
-- `package.json` — `"version"` field
-- `package-lock.json` — `"version"` field in the root object (same value as `package.json`)
-
-### CHANGELOG.md Rules
-
-- If `CHANGELOG.md` does not exist yet, create it with the standard Keep a Changelog header.
-- Add a new `## [x.y.z] - YYYY-MM-DD` section directly below `## [Unreleased]`.
-- Use Keep a Changelog section headings as needed: `Added`, `Changed`, `Deprecated`, `Removed`, `Fixed`, `Security`.
-- Group the same kinds of changes under the same heading.
-- Write entries user-facing: what changed, not how. Skip internal refactors unless they affect users.
-- List new publisher adapters under `Added`.
-- Preserve the release date in every version heading.
-- Keep the `[Unreleased]` section empty after moving its contents to the new release section.
-- Update the `[Unreleased]` compare link and add the new release compare link at the bottom of the file.
-- Keep version headings and bottom-of-file links consistent so releases and compare ranges remain linkable.
-
-### CHANGELOG.md Template (first release)
-
-```markdown
-# Changelog
-
-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.1.0/),
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
-
-## [Unreleased]
-
-## [x.y.z] - YYYY-MM-DD
-
-### Added
-
-- ...
-
-[Unreleased]: https://github.com/zonuexe/techbook-mcp/compare/vx.y.z...HEAD
-[x.y.z]: https://github.com/zonuexe/techbook-mcp/releases/tag/vx.y.z
-```
-
-## Verify Before Committing
-
-Run all checks in order:
-
-```bash
-npm test
-```
-
-```bash
-npm run lint
-```
-
-```bash
-npm run build
-```
-
-All three must pass. Do not commit if any check fails.
-
-## Commit the Release
-
-Prefer a single release-prep commit containing:
-
-- version bump in `package.json` and `package-lock.json`
-- `CHANGELOG.md` update
-
-Use this commit message format:
-
-```text
-Bump up version to x.y.z
-```
-
-Do not include other unrelated changes in the release commit.
-
-## Quick Checklist
-
-- Working tree starts clean or you understand every pending change.
-- `CHANGELOG.md` has a new `## [x.y.z] - YYYY-MM-DD` section with user-facing entries.
-- `package.json` and `package-lock.json` both show the new version.
-- Bottom-of-file links in `CHANGELOG.md` are consistent.
-- `npm test` passed.
-- `npm run lint` passed.
-- `npm run build` passed.
-- Commit message follows `chore: release x.y.z`.

package/.github/workflows/test.yml

@@ -1,72 +0,0 @@
-name: CI
-
-on:
-  push:
-    branches: [main, master]
-  pull_request:
-    branches: [main, master]
-
-jobs:
-  test:
-    runs-on: ubuntu-latest
-
-    strategy:
-      matrix:
-        node-version: [22.x]
-
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Use Node.js ${{ matrix.node-version }}
-        uses: actions/setup-node@v4
-        with:
-          node-version: ${{ matrix.node-version }}
-          cache: npm
-
-      - name: Install dependencies
-        run: npm ci
-
-      - name: Lint
-        run: npm run lint
-
-      - name: Type check
-        run: npx tsc --noEmit
-
-      - name: Run tests
-        run: npm test
-
-      - name: Build
-        run: npm run build
-
-  bun:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-
-      - uses: oven-sh/setup-bun@v2
-
-      - name: Install dependencies
-        run: bun install
-
-      - name: Run tests
-        run: bun test
-
-  deno:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-
-      - uses: denoland/setup-deno@v2
-        with:
-          deno-version: v2.x
-
-      - name: Install Node deps (for node_modules)
-        uses: actions/setup-node@v4
-        with:
-          node-version: 22.x
-          cache: npm
-
-      - run: npm ci
-
-      - name: Run tests
-        run: deno test --allow-read --no-check --sloppy-imports tests/

package/.oxlintrc.json

@@ -1,12 +0,0 @@
-{
-  "$schema": "https://raw.githubusercontent.com/oxc-project/oxc/main/npm/oxlint/configuration_schema.json",
-  "plugins": ["typescript", "unicorn"],
-  "rules": {
-    "no-unused-vars": "error",
-    "no-console": "warn",
-    "unicorn/no-array-for-each": "error",
-    "unicorn/prefer-string-slice": "error",
-    "typescript/consistent-type-imports": "error"
-  },
-  "ignorePatterns": ["dist/**", "node_modules/**"]
-}

package/AGENTS.md

@@ -1,100 +0,0 @@
-# techbook-mcp — AI エージェント向けガイド
-
-日本語技術書の書誌情報を出版社公式サイト・APIから取得するMCPサーバー。
-詳細な設計は [docs/design-doc.md](docs/design-doc.md) を参照。
-
-## コミットメッセージ規約
-
-Conventional Commits は使わない。コミットメッセージは端的な日本語または英語の命令形で書く。
-
-```
-robots.txt チェックを追加し結果を6時間キャッシュする
-Add robots.txt check with 6-hour cache
-```
-
-## 開発コマンド
-
-```bash
-npm install
-npm test           # ユニットテスト実行 (node:test)
-npm run build      # TypeScript コンパイル → dist/
-```
-
-## コーディング規約
-
-- **新しいアダプターを追加するときは必ずテストも書く**（`tests/unit/adapters/publishers/{id}.test.ts`）
-- テストは `MockHttpClient` + `NullCacheStore` + `CheerioHtmlParser` の組み合わせで書く
-- フィクスチャHTMLは `tests/fixtures/` に配置し、実サイトの構造を忠実に再現する
-- `fetchText()` はキャッシュ・ヘッダーを内包するため、アダプター内では直接 `deps.http.get()` を呼ばない
-- Referer ヘッダーが必要なサイトは `fetchText(url, deps, { Referer: "..." })` の第3引数を使う
-- 著者名から役割語（著・訳・編・監修・監訳など）を除去すること
-- 価格は税込み整数（円）で `BookRecord.price` に格納する
-- `publisher` フィールドには実際の出版社名を入れる（ストアプラットフォーム名ではない）
-
-## 新しい出版社アダプターを追加するとき
-
-`docs/design-doc.md` の「新しいアダプターの追加手順」を参照。要点は以下:
-
-1. `src/adapters/publishers/{id}.ts` — `PublisherAdapter` インターフェースを実装
-2. `tests/fixtures/{id}-search.html` + `{id}-detail.html` — 実サイトHTMLのスナップショット
-3. `tests/unit/adapters/publishers/{id}.test.ts` — `MockHttpClient` でユニットテスト
-4. `src/adapters/publishers/base.ts` — 必要に応じて `EBOOK_STORE_PATTERNS` に追加
-5. `src/adapters/publishers/registry.ts` — `DEFAULT_PUBLISHERS` に登録
-
-## DRM 分類の判断基準
-
-新しいストアを `EBOOK_STORE_PATTERNS` に追加する際の判断順:
-1. **free** — 公式が明言、または購入して透かし等がないことを確認済み
-2. **social** — 購入者情報（メールアドレス等）が埋め込まれるが技術的制限なし
-3. **password_pdf** — PDFにパスワードがかかる（標準ビューアで開ける）
-4. **drm** — 専用ビューアーが必要、または上記いずれでもない場合
-
-## アーキテクチャ上の制約
-
-- ポート (`HttpClient`, `HtmlParser`, `CacheStore`) はインターフェースのみ。実装を直接 import しない
-- `DrmType` に新しい値を追加するときは `src/domain/book.ts` と `src/mcp/server.ts` の両方を更新する
-
-## テスト方針
-
-テストフレームワークは `node:test` + `node:assert/strict` を使う（vitest は使わない）。
-
-```typescript
-import { describe, it } from "node:test";
-import assert from "node:assert/strict";
-
-// 標準的なテストセットアップ
-function makeDeps(http: MockHttpClient) {
-  return { http, parser: new CheerioHtmlParser(), cache: new NullCacheStore() };
-}
-
-// GET のモック（URL前方一致）
-const http = new MockHttpClient()
-  .addResponse("https://example.com/search", { status: 200, body: html });
-
-// POST のモック (GraphQL等)
-const http = new MockHttpClient()
-  .addPostResponse("https://api.example.com/graphql", { status: 200, body: json });
-
-// vitest → node:assert の主な対応
-// expect(x).toBe(y)          → assert.strictEqual(x, y)
-// expect(x).toEqual(y)       → assert.deepStrictEqual(x, y)
-// expect(x).toMatchObject(y) → assert.partialDeepStrictEqual(x, y)
-// expect(x).toHaveLength(n)  → assert.strictEqual(x.length, n)
-// expect(x).toContain(s)     → assert.ok(x.includes(s))
-// expect(x).toMatch(/r/)     → assert.match(x, /r/)
-// await expect(p).rejects.toThrow("msg") → await assert.rejects(p, /msg/)
-
-// モック関数: node:test の mock.fn() は Bun 非対応のため、テストファイル内に
-// ローカルで mockFn() ヘルパーを定義して使う（Node.js・Bun・Deno 共通で動作）
-// vi.fn().mockResolvedValue(v) → mockFn(async () => v)
-// fn.toHaveBeenCalledOnce()    → assert.strictEqual(fn.mock.callCount(), 1)
-```
-
-## よくある落とし穴
-
-- **EUC-JP サイト**: `shop.rutles.net` はクエリを EUC-JP エンコードしないとヒットしない → `iconv-lite` を使用
-- **XSRF-TOKEN**: `techbookfest.org` GraphQL はダブルサブミットCookieパターン必須
-- **Referer 必須**: `maruzen-publishing.co.jp` の検索は Referer なしで 403
-- **機関向けストア除外**: `kw.maruzen.co.jp`（Knowledge Worker）は個人向けではないため除外
-- **ローカルフィルタ型**: `oreilly-japan` と `peaks` は検索APIがなくトップページ/一覧をローカルフィルタ
-- **著者のみ検索不可**: ローカルフィルタ型アダプターは `!query.title` のとき `[]` を返す（HTTP呼ばない）

package/deno.json

@@ -1,3 +0,0 @@
-{
-  "nodeModulesDir": "auto"
-}

package/src/adapters/cache/memory-cache.ts

@@ -1,31 +0,0 @@
-import type { CacheStore } from "../../ports/cache.js";
-
-interface CacheEntry {
-  value: string;
-  expiresAt?: number;
-}
-
-export class MemoryCacheStore implements CacheStore {
-  private readonly store = new Map<string, CacheEntry>();
-
-  async get(key: string): Promise<string | null> {
-    const entry = this.store.get(key);
-    if (!entry) return null;
-    if (entry.expiresAt !== undefined && Date.now() > entry.expiresAt) {
-      this.store.delete(key);
-      return null;
-    }
-    return entry.value;
-  }
-
-  async set(key: string, value: string, ttlSeconds?: number): Promise<void> {
-    this.store.set(key, {
-      value,
-      expiresAt: ttlSeconds !== undefined ? Date.now() + ttlSeconds * 1000 : undefined,
-    });
-  }
-
-  async delete(key: string): Promise<void> {
-    this.store.delete(key);
-  }
-}

package/src/adapters/cache/null-cache.ts

@@ -1,8 +0,0 @@
-import type { CacheStore } from "../../ports/cache.js";
-
-/** テスト・デバッグ用。キャッシュを一切行わない。 */
-export class NullCacheStore implements CacheStore {
-  async get(_key: string): Promise<null> { return null; }
-  async set(_key: string, _value: string, _ttlSeconds?: number): Promise<void> {}
-  async delete(_key: string): Promise<void> {}
-}

package/src/adapters/html/cheerio-parser.ts

@@ -1,50 +0,0 @@
-import * as cheerio from "cheerio";
-import type { Element } from "domhandler";
-import type { HtmlParser, HtmlDocument, HtmlElement } from "../../ports/html-parser.js";
-
-class CheerioElement implements HtmlElement {
-  constructor(
-    private readonly $: cheerio.CheerioAPI,
-    private readonly el: Element,
-  ) {}
-
-  text(): string {
-    return this.$(this.el).text().trim();
-  }
-
-  html(): string | null {
-    return this.$(this.el).html();
-  }
-
-  attr(name: string): string | undefined {
-    return this.$(this.el).attr(name);
-  }
-
-  find(selector: string): HtmlElement[] {
-    return this.$(this.el)
-      .find(selector)
-      .toArray()
-      .map(el => new CheerioElement(this.$, el as Element));
-  }
-}
-
-class CheerioDocument implements HtmlDocument {
-  constructor(private readonly $: cheerio.CheerioAPI) {}
-
-  select(selector: string): HtmlElement[] {
-    return this.$(selector)
-      .toArray()
-      .map(el => new CheerioElement(this.$, el as Element));
-  }
-
-  selectOne(selector: string): HtmlElement | null {
-    return this.select(selector)[0] ?? null;
-  }
-}
-
-export class CheerioHtmlParser implements HtmlParser {
-  parse(html: string): HtmlDocument {
-    const $ = cheerio.load(html);
-    return new CheerioDocument($);
-  }
-}

package/src/adapters/http/fetch-client.ts

@@ -1,47 +0,0 @@
-import type { HttpClient, RequestOptions, HttpResponse } from "../../ports/http.js";
-
-class FetchHttpResponse implements HttpResponse {
-  constructor(private readonly response: Response) {}
-
-  get status(): number {
-    return this.response.status;
-  }
-
-  get url(): string {
-    return this.response.url;
-  }
-
-  text(): Promise<string> {
-    return this.response.text();
-  }
-
-  header(name: string): string | null {
-    return this.response.headers.get(name);
-  }
-}
-
-export class FetchHttpClient implements HttpClient {
-  async get(url: string, options?: RequestOptions): Promise<HttpResponse> {
-    const init: RequestInit = {
-      headers: options?.headers,
-    };
-    if (options?.timeout !== undefined) {
-      init.signal = AbortSignal.timeout(options.timeout);
-    }
-    const response = await fetch(url, init);
-    return new FetchHttpResponse(response);
-  }
-
-  async post(url: string, body: string, options?: RequestOptions): Promise<HttpResponse> {
-    const init: RequestInit = {
-      method: "POST",
-      body,
-      headers: { "Content-Type": "application/json", ...options?.headers },
-    };
-    if (options?.timeout !== undefined) {
-      init.signal = AbortSignal.timeout(options.timeout);
-    }
-    const response = await fetch(url, init);
-    return new FetchHttpResponse(response);
-  }
-}

package/src/adapters/http/mock-client.ts

@@ -1,77 +0,0 @@
-import type { HttpClient, RequestOptions, HttpResponse } from "../../ports/http.js";
-
-export interface MockResponseData {
-  status: number;
-  body: string;
-  headers?: Record<string, string>;
-}
-
-class MockHttpResponse implements HttpResponse {
-  constructor(
-    private readonly data: MockResponseData,
-    private readonly requestUrl: string,
-  ) {}
-
-  get status(): number { return this.data.status; }
-  get url(): string { return this.requestUrl; }
-  async text(): Promise<string> { return this.data.body; }
-  header(name: string): string | null {
-    return this.data.headers?.[name.toLowerCase()] ?? null;
-  }
-}
-
-export class MockHttpClient implements HttpClient {
-  private readonly handlers = new Map<string, MockResponseData>();
-  private readonly postHandlers = new Map<string, MockResponseData>();
-  private readonly _calls: string[] = [];
-
-  /** GET: URL の前方一致でレスポンスを登録する */
-  addResponse(urlPrefix: string, data: MockResponseData): this {
-    this.handlers.set(urlPrefix, data);
-    return this;
-  }
-
-  /** POST: URL の前方一致でレスポンスを登録する */
-  addPostResponse(urlPrefix: string, data: MockResponseData): this {
-    this.postHandlers.set(urlPrefix, data);
-    return this;
-  }
-
-  get calls(): readonly string[] {
-    return this._calls;
-  }
-
-  async get(url: string, _options?: RequestOptions): Promise<HttpResponse> {
-    this._calls.push(url);
-
-    // 完全一致を優先
-    if (this.handlers.has(url)) {
-      return new MockHttpResponse(this.handlers.get(url)!, url);
-    }
-
-    // 前方一致
-    for (const [prefix, data] of this.handlers) {
-      if (url.startsWith(prefix)) {
-        return new MockHttpResponse(data, url);
-      }
-    }
-
-    throw new Error(`MockHttpClient: no handler for GET: ${url}`);
-  }
-
-  async post(url: string, _body: string, _options?: RequestOptions): Promise<HttpResponse> {
-    this._calls.push(url);
-
-    if (this.postHandlers.has(url)) {
-      return new MockHttpResponse(this.postHandlers.get(url)!, url);
-    }
-
-    for (const [prefix, data] of this.postHandlers) {
-      if (url.startsWith(prefix)) {
-        return new MockHttpResponse(data, url);
-      }
-    }
-
-    throw new Error(`MockHttpClient: no handler for POST: ${url}`);
-  }
-}