@pipeworx/mcp-tw-law 0.1.0 → 0.2.0

package/README.md

@@ -5,7 +5,7 @@ the Ministry of Justice's own official English translation where one exists
 — searchable by title, resolvable by exact citation, and readable one
 provision at a time.
 
-Part of [Pipeworx](https://pipeworx.io) — an MCP gateway connecting AI agents to 1815+ live data sources. This is an independent, unofficial integration — not affiliated with, endorsed by, or published by the upstream provider.
+Part of [Pipeworx](https://pipeworx.io) — an MCP gateway connecting AI agents to 1857+ live data sources. This is an independent, unofficial integration — not affiliated with, endorsed by, or published by the upstream provider.
 
 ## Tools
 
@@ -115,7 +115,7 @@ directly, instead of just this one's:
 }
 ```
 
-Both URLs reach the same gateway and the same 1815+ data sources. The
+Both URLs reach the same gateway and the same 1857+ data sources. The
 only difference is which pack's tools are listed **directly**; `ask_pipeworx`
 reaches all of them from either one.
 
@@ -129,10 +129,12 @@ curl -X POST https://gateway.pipeworx.io/v1/tools/tw_law_search \
 
 No account needed for the first calls. Inspect any tool: `GET https://gateway.pipeworx.io/v1/tools/tw_law_search`. Find one: `POST https://gateway.pipeworx.io/v1/tools/search_packs` with `{"query":"..."}`.
 
-## Standalone (no gateway account)
+## Run it from npm
 
-This package also runs as a local stdio MCP server — no Pipeworx account, no
-gateway round-trip:
+`@pipeworx/mcp-tw-law` is a local stdio bridge to the Pipeworx gateway: your MCP client
+starts it with `npx`, and it forwards every call to the same
+`https://gateway.pipeworx.io/tw-law/mcp` endpoint shown above. It needs network access;
+there is no offline mode.
 
 ```json
 {
@@ -145,15 +147,18 @@ gateway round-trip:
 }
 ```
 
-Or run it directly to confirm it starts:
+Without a key it calls anonymously, capped at 50 calls a day. A free account
+raises that to 200 a day: get a key at https://pipeworx.io/signup and add
+`"env": { "PIPEWORX_API_KEY": "<your key>" }` to the server entry.
+The key is sent as a Bearer token, the same way a hosted connection sends it,
+so calls are metered and billed exactly as they are there.
 
-```bash
-npx -y @pipeworx/mcp-tw-law
-```
+It lists **only** this pack's tools by default. Set `PIPEWORX_META_TOOLS=1` to
+also list `ask_pipeworx` and the other gateway-wide tools.
 
-It speaks MCP over stdin/stdout and answers `initialize`/`tools/list`/`tools/call`
-for **only** this pack's tools — none of the shared meta-tools the gateway
-connection above adds. Same source, same tools, no ask_pipeworx routing.
+Behind an HTTPS proxy: Node's built-in `fetch` does not read `HTTPS_PROXY` by
+default. Newer Node releases honour it when `NODE_USE_ENV_PROXY=1` is set; check
+your Node version's documentation.
 
 ## Using with ask_pipeworx
 

package/bin/cli.js

@@ -1,17 +1,61 @@
 #!/usr/bin/env node
+// Entry point for `npx @pipeworx/mcp-<slug>` in gateway mode (bin/cli.js).
 //
-// Entry point for `npx @pipeworx/mcp-<slug>`.
+// A stdio MCP server that relays every message to the Pipeworx gateway's
+// /<slug>/mcp endpoint -- fleet #3759, docs/standalone-via-gateway-plan.md.
+// It carries no pack code and has no local mode. The relay itself lives in
+// ../lib/index.js (copied from scripts/templates/standalone-gateway-lib.js);
+// this file only owns stdin/stdout.
 //
-// Packs ship as raw TypeScript (no build step — see publish-pack.sh for why:
-// tsx sidesteps every extensionless-import / bare-JSON-import edge case a
-// per-pack tsc build would have to solve one pack at a time). This file
-// registers tsx's ESM loader programmatically, then hands off to src/server.ts,
-// which wraps the pack's {tools, callTool} export in a stdio MCP server.
+// Copied VERBATIM into every gateway-mode package by scripts/publish-pack.sh.
+// Edit scripts/templates/standalone-gateway-cli.js in the monorepo, never a
+// per-pack copy. Zero dependencies, Node 18+.
 //
-// Copied verbatim into every published pack repo by scripts/publish-pack.sh —
-// edit this file, not a per-pack copy.
-import { register } from 'tsx/esm/api';
+// stdout carries newline-delimited JSON-RPC and nothing else; every diagnostic
+// goes to stderr, because a single stray line on stdout breaks the host's
+// parser.
+import { createInterface } from 'node:readline';
+import { relay, bridgeConfig } from '../lib/index.js';
 
-register();
+const cfg = bridgeConfig();
+const warn = (line) => process.stderr.write(`${line}\n`);
+const write = (msg) => { if (msg) process.stdout.write(`${JSON.stringify(msg)}\n`); };
 
-await import('../src/server.ts');
+const pending = new Set();
+function track(p) {
+  pending.add(p);
+  p.finally(() => pending.delete(p));
+}
+
+async function handleLine(line) {
+  const text = line.trim();
+  if (!text) return;
+  let message;
+  try {
+    message = JSON.parse(text);
+  } catch {
+    write({ jsonrpc: '2.0', id: null, error: { code: -32700, message: 'Parse error' } });
+    return;
+  }
+  // A JSON-RPC batch: relay each member, answer with the non-notification replies.
+  if (Array.isArray(message)) {
+    const replies = (await Promise.all(message.map((m) => relay(m, { cfg, warn })))).filter(Boolean);
+    if (replies.length) write(replies);
+    return;
+  }
+  write(await relay(message, { cfg, warn }));
+}
+
+// Requests are handled concurrently and answered as they finish: JSON-RPC ids
+// let the host match them, and a slow tool call must not hold up a ping.
+const rl = createInterface({ input: process.stdin, crlfDelay: Infinity });
+rl.on('line', (line) => {
+  track(handleLine(line).catch((err) => warn(`pipeworx-standalone: ${err && err.stack ? err.stack : err}`)));
+});
+rl.on('close', async () => {
+  // stdin closed: finish what is in flight, then exit.
+  while (pending.size) await Promise.allSettled([...pending]);
+  // Exit only once stdout has flushed: on a pipe that is not synchronous
+  // everywhere, and a bare exit can drop the last reply.
+  process.stdout.write('', () => process.exit(0));
+});

package/lib/index.js

@@ -0,0 +1,333 @@
+// @pipeworx/mcp-<slug> -- library half of the gateway bridge (lib/index.js).
+//
+// Copied VERBATIM into every gateway-mode pack package by scripts/publish-pack.sh
+// (fleet #3759, docs/standalone-via-gateway-plan.md section 1). There is no
+// per-pack templating: the slug and version are read from this package's own
+// package.json (`pipeworx.slug`, `version`) at load time, so the same bytes
+// ship in every package and the source hash can cover them once. Edit this
+// file in the monorepo (scripts/templates/standalone-gateway-lib.js), never a
+// per-pack copy.
+//
+// What it is: a relay. Every JSON-RPC message goes to
+// ${PIPEWORX_GATEWAY_URL:-https://gateway.pipeworx.io}/<slug>/mcp, the same
+// endpoint a hosted MCP client uses, so tiers, rate limits and credits apply
+// exactly as they do there. There is no local mode: the pack's code is not in
+// this package.
+//
+// Zero dependencies, plain ESM, Node 18+ (global fetch). Nothing here writes
+// to stdout -- bin/cli.js owns stdout and it carries JSON-RPC only.
+//
+// Environment:
+//   PIPEWORX_API_KEY      sent as `Authorization: Bearer <key>`. Never as
+//                         X-API-Key: the gateway reads a pwx_ key sent that way
+//                         as an unvalidated BYO string with no account.
+//   PIPEWORX_GATEWAY_URL  gateway base URL (no path), default the public gateway.
+//   PIPEWORX_META_TOOLS=1 list the gateway-wide tools (ask_pipeworx, ...) too.
+//   PIPEWORX_TIMEOUT_MS   per-request timeout, default 120000.
+
+import { readFileSync } from 'node:fs';
+
+const readJson = (rel) => JSON.parse(readFileSync(new URL(rel, import.meta.url), 'utf8'));
+
+const PKG = readJson('../package.json');
+export const SLUG = PKG.pipeworx && PKG.pipeworx.slug;
+if (typeof SLUG !== 'string' || !/^[a-z0-9][a-z0-9_-]*$/.test(SLUG)) {
+  throw new Error(`${PKG.name}: package.json carries no valid pipeworx.slug -- this package was built wrong`);
+}
+/**
+ * The pack's slug on the GATEWAY: the /<slug>/mcp route and the `_meta.pack`
+ * every listed tool carries. Usually the same as `slug` (the npm/directory
+ * name), but 14 packs differ -- `hex-pm` is `hex_pm` on the gateway -- and
+ * filtering tools/list on the npm slug would match none of their tools
+ * (fleet #3761). publish-pack.sh stamps it from the gateway manifest.
+ */
+export const GATEWAY_SLUG = (PKG.pipeworx && PKG.pipeworx.gatewaySlug) || SLUG;
+if (typeof GATEWAY_SLUG !== 'string' || !/^[a-z0-9][a-z0-9_-]*$/.test(GATEWAY_SLUG)) {
+  throw new Error(`${PKG.name}: package.json carries an invalid pipeworx.gatewaySlug -- this package was built wrong`);
+}
+export const PACKAGE_NAME = PKG.name;
+export const VERSION = PKG.version;
+
+/** The pack's own tool definitions at publish time (the offline tools/list answer). */
+export const tools = readJson('../tools.json');
+
+const DEFAULT_GATEWAY = 'https://gateway.pipeworx.io';
+const DEFAULT_TIMEOUT_MS = 120_000;
+const SIGNUP_URL = 'https://pipeworx.io/signup';
+const VIA = '(via pipeworx-standalone)';
+
+/** Resolve the bridge's settings. Exported for the tests and for callTool. */
+export function bridgeConfig(env = process.env, overrides = {}) {
+  const base = String(overrides.gatewayUrl || env.PIPEWORX_GATEWAY_URL || DEFAULT_GATEWAY).trim().replace(/\/+$/, '');
+  const apiKey = String(overrides.apiKey ?? env.PIPEWORX_API_KEY ?? '').trim();
+  const t = Number(overrides.timeoutMs ?? env.PIPEWORX_TIMEOUT_MS);
+  return {
+    endpoint: `${base}/${GATEWAY_SLUG}/mcp`,
+    apiKey,
+    timeoutMs: Number.isFinite(t) && t > 0 ? t : DEFAULT_TIMEOUT_MS,
+    metaTools: (overrides.metaTools ?? env.PIPEWORX_META_TOOLS) === '1' || overrides.metaTools === true,
+  };
+}
+
+function requestHeaders(cfg) {
+  const h = {
+    'Content-Type': 'application/json',
+    Accept: 'application/json',
+    // Stable per package version: the gateway remembers a client's name by
+    // identifier + User-Agent (workers/gateway/src/client-identity.ts).
+    'User-Agent': `pipeworx-standalone/${VERSION} (${PACKAGE_NAME})`,
+    // Analytics label only (blob11 = 'standalone'). It never changes tier,
+    // limits or price -- anyone can send it.
+    'X-Pipeworx-Surface': 'standalone',
+  };
+  if (cfg.apiKey) h.Authorization = `Bearer ${cfg.apiKey}`;
+  return h;
+}
+
+/** Parse a gateway body: JSON, or the last JSON `data:` frame of an SSE stream. */
+function parseBody(text, contentType) {
+  if (/text\/event-stream/i.test(contentType || '')) {
+    let last = null;
+    for (const line of text.split(/\r?\n/)) {
+      if (!line.startsWith('data:')) continue;
+      try { last = JSON.parse(line.slice(5).trim()); } catch { /* keep-alive or partial frame */ }
+    }
+    return last;
+  }
+  try { return JSON.parse(text); } catch { return null; }
+}
+
+/**
+ * POST one JSON-RPC message. Never throws: the outcome is one of
+ *   { kind: 'http', status, headers, body, text }   the gateway answered
+ *   { kind: 'network', detail }                      DNS, TLS, refused, reset
+ *   { kind: 'timeout' }                              no answer in cfg.timeoutMs
+ */
+export async function postToGateway(message, cfg) {
+  const ac = new AbortController();
+  const timer = setTimeout(() => ac.abort(), cfg.timeoutMs);
+  try {
+    const res = await fetch(cfg.endpoint, {
+      method: 'POST',
+      headers: requestHeaders(cfg),
+      body: JSON.stringify(message),
+      signal: ac.signal,
+    });
+    const text = await res.text();
+    return { kind: 'http', status: res.status, headers: res.headers, body: parseBody(text, res.headers.get('content-type')), text };
+  } catch (err) {
+    if (ac.signal.aborted || (err && (err.name === 'AbortError' || err.name === 'TimeoutError'))) return { kind: 'timeout' };
+    const cause = err && err.cause;
+    const detail = (cause && (cause.code || cause.message)) || (err && err.message) || String(err);
+    return { kind: 'network', detail };
+  } finally {
+    clearTimeout(timer);
+  }
+}
+
+// ── The key-not-accepted warning (one per process) ──────────────────
+
+let warnedKeyIgnored = false;
+const KEY_IGNORED = 'PIPEWORX_API_KEY was not accepted, calling anonymously.';
+
+/** True when a key was sent but the gateway still served the call as anonymous. */
+function keyIgnored(out, cfg) {
+  return !!cfg.apiKey && out.kind === 'http' && (out.headers.get('x-ratelimit-tier') || '').toLowerCase() === 'anonymous';
+}
+
+function noteTier(out, cfg, warn) {
+  if (!keyIgnored(out, cfg) || warnedKeyIgnored) return;
+  warnedKeyIgnored = true;
+  warn(`${PACKAGE_NAME}: ${KEY_IGNORED} Check the key at ${SIGNUP_URL}.`);
+}
+
+/** Test hook: forget that the warning was printed. */
+export function _resetWarnings() { warnedKeyIgnored = false; }
+
+// ── Results the host shows to the model ─────────────────────────────
+
+function errorResult(text, detail) {
+  const result = { content: [{ type: 'text', text }], isError: true };
+  if (detail) result._meta = { pipeworx_standalone: detail };
+  return result;
+}
+
+const rpcResult = (id, result) => ({ jsonrpc: '2.0', id, result });
+const rpcError = (id, code, message) => ({ jsonrpc: '2.0', id, error: { code, message } });
+
+function firstLine(text) {
+  const line = String(text || '').split(/\r?\n/).map((l) => l.trim()).find(Boolean) || '(empty body)';
+  return line.length > 200 ? `${line.slice(0, 200)}...` : line;
+}
+
+function unreachableText(cfg, out) {
+  if (out.kind === 'timeout') {
+    return `The Pipeworx gateway at ${cfg.endpoint} did not answer within ${Math.round(cfg.timeoutMs / 1000)}s, so this call timed out. `
+      + `${PACKAGE_NAME} forwards every call to the Pipeworx gateway and has no local mode. Try again; a call that keeps timing out is worth reporting.`;
+  }
+  return `Could not reach the Pipeworx gateway at ${cfg.endpoint} (${out.detail}). `
+    + `${PACKAGE_NAME} forwards every call to the Pipeworx gateway and has no local mode, so it needs network access.`;
+}
+
+function isAuthRequired(body) {
+  return !!body && (body.error_code === 'authentication_required'
+    || (body.error && body.error.data && body.error.data.reason === 'authentication_required'));
+}
+
+/** Map a tools/call outcome to the JSON-RPC response the host gets. */
+function toolsCallResponse(id, out, cfg) {
+  if (out.kind !== 'http') return rpcResult(id, errorResult(unreachableText(cfg, out), { reason: out.kind }));
+  const { status, body } = out;
+
+  // Anonymous daily cap: the gateway answers 401 with a JSON-RPC error whose
+  // message is the offer. Hosts often swallow protocol errors, so hand it over
+  // as a tool result the model actually reads.
+  if (status === 401 && isAuthRequired(body)) {
+    const data = (body.error && body.error.data) || {};
+    const parts = [body.error && body.error.message ? body.error.message : 'The anonymous daily allowance is used up.'];
+    if (data.resets_at) parts.push(`The anonymous allowance resets at ${data.resets_at}.`);
+    parts.push(cfg.apiKey
+      ? `${KEY_IGNORED} Check the key, or get a free one at ${SIGNUP_URL}.`
+      : `To keep going now, set PIPEWORX_API_KEY in this MCP server's environment; a free key is at ${SIGNUP_URL}.`);
+    return rpcResult(id, errorResult(parts.join('\n\n'), { status, reason: 'authentication_required', resets_at: data.resets_at ?? null }));
+  }
+
+  // A keyed tier over its cap: today the gateway answers 429 with a RESULT
+  // that has no isError, which reads as a success (fleet #3760). Mark it.
+  if (status === 429 && body && body.result && typeof body.result === 'object') {
+    const result = { ...body.result, isError: true };
+    if (cfg.apiKey && keyIgnored(out, cfg)) {
+      result.content = [...(Array.isArray(result.content) ? result.content : []), { type: 'text', text: KEY_IGNORED }];
+    }
+    return rpcResult(id, result);
+  }
+  if ((status === 401 || status === 429) && body && body.error) {
+    const extra = keyIgnored(out, cfg) ? ` ${KEY_IGNORED}` : '';
+    return rpcResult(id, errorResult(`${body.error.message || `HTTP ${status}`}${extra}`, { status }));
+  }
+
+  // A real JSON-RPC answer (result or protocol error): relay it verbatim,
+  // structuredContent and _meta (cost, tier, provenance) included.
+  if (body && body.jsonrpc === '2.0' && (body.result !== undefined || body.error !== undefined) && status < 500) {
+    return { ...body, id };
+  }
+
+  // 5xx, an HTML edge page, or anything else that is not JSON-RPC.
+  return rpcResult(id, errorResult(`The Pipeworx gateway returned HTTP ${status}: ${firstLine(out.text)}`, { status }));
+}
+
+function localInitialize(params) {
+  return {
+    protocolVersion: (params && params.protocolVersion) || '2025-06-18',
+    capabilities: { tools: {} },
+    serverInfo: { name: PACKAGE_NAME, version: VERSION },
+  };
+}
+
+const scopedInstructions = () =>
+  `${PACKAGE_NAME} forwards to the Pipeworx gateway and lists only the ${SLUG} pack's tools. `
+  + 'Set PIPEWORX_META_TOOLS=1 to also list ask_pipeworx and the other gateway-wide tools.';
+
+/** `<host name> (via pipeworx-standalone)`. The slug stays OUT of the name: the
+ *  gateway's scanner-name check substring-matches words like poll/watch/index. */
+export function bridgedClientName(name) {
+  const n = typeof name === 'string' && name.trim() ? name.trim() : 'unknown';
+  return n.includes(VIA) ? n : `${n} ${VIA}`;
+}
+
+/**
+ * Relay one JSON-RPC message to the gateway and return the response to write
+ * back, or null for a notification. Never throws.
+ *
+ * @param {object} message  a parsed JSON-RPC request or notification
+ * @param {{cfg?: object, warn?: (line: string) => void}} [opts]
+ */
+export async function relay(message, opts = {}) {
+  const cfg = opts.cfg || bridgeConfig();
+  const warn = opts.warn || ((line) => process.stderr.write(`${line}\n`));
+  if (!message || typeof message !== 'object' || message.jsonrpc !== '2.0' || typeof message.method !== 'string') {
+    const id = message && typeof message === 'object' && 'id' in message ? message.id : null;
+    return rpcError(id ?? null, -32600, 'Invalid Request');
+  }
+  const isNotification = !('id' in message) || message.id === undefined;
+  const id = message.id;
+
+  if (isNotification) {
+    const out = await postToGateway(message, cfg);
+    if (out.kind !== 'http') warn(`${PACKAGE_NAME}: notification ${message.method} not delivered: ${unreachableText(cfg, out)}`);
+    return null;
+  }
+
+  if (message.method === 'initialize') {
+    const params = { ...(message.params || {}) };
+    params.clientInfo = { ...(params.clientInfo || {}), name: bridgedClientName(params.clientInfo && params.clientInfo.name) };
+    if (!params.clientInfo.version) params.clientInfo.version = '0';
+    const out = await postToGateway({ ...message, params }, cfg);
+    noteTier(out, cfg, warn);
+    if (out.kind === 'http' && out.body && out.body.result && typeof out.body.result === 'object') {
+      const result = { ...out.body.result, serverInfo: { name: PACKAGE_NAME, version: VERSION } };
+      if (!cfg.metaTools) result.instructions = scopedInstructions();
+      return rpcResult(id, result);
+    }
+    // The host must still start: answer locally and let the calls report the
+    // gateway problem when they happen.
+    warn(`${PACKAGE_NAME}: initialize answered locally -- ${out.kind === 'http' ? `gateway HTTP ${out.status}` : unreachableText(cfg, out)}`);
+    return rpcResult(id, { ...localInitialize(message.params), instructions: scopedInstructions() });
+  }
+
+  if (message.method === 'tools/list') {
+    const out = await postToGateway(message, cfg);
+    noteTier(out, cfg, warn);
+    const listed = out.kind === 'http' && out.body && out.body.result && Array.isArray(out.body.result.tools)
+      ? out.body.result : null;
+    if (listed) {
+      if (cfg.metaTools) return rpcResult(id, listed);
+      const own = listed.tools.filter((t) => t && t._meta && (t._meta.pack === GATEWAY_SLUG || t._meta.pack === SLUG));
+      if (own.length > 0) return rpcResult(id, { ...listed, tools: own });
+      warn(`${PACKAGE_NAME}: the gateway listed no ${SLUG} tools; serving the tool list bundled with this package`);
+    } else {
+      warn(`${PACKAGE_NAME}: tools/list served from the snapshot bundled with this package -- ${out.kind === 'http' ? `gateway HTTP ${out.status}` : unreachableText(cfg, out)}`);
+    }
+    return rpcResult(id, { tools });
+  }
+
+  if (message.method === 'tools/call') {
+    const out = await postToGateway(message, cfg);
+    noteTier(out, cfg, warn);
+    return toolsCallResponse(id, out, cfg);
+  }
+
+  // Everything else (ping, resources/*, prompts/*, ...): relay as-is.
+  const out = await postToGateway(message, cfg);
+  noteTier(out, cfg, warn);
+  if (out.kind === 'http' && out.body && out.body.jsonrpc === '2.0') return { ...out.body, id };
+  if (message.method === 'ping') return rpcResult(id, {});
+  return rpcError(id, -32603, out.kind === 'http'
+    ? `The Pipeworx gateway returned HTTP ${out.status}: ${firstLine(out.text)}`
+    : unreachableText(cfg, out));
+}
+
+/**
+ * Call one of this pack's tools through the gateway -- the `{tools, callTool}`
+ * shape earlier versions of this package exported. Resolves with the tool's
+ * structured result; rejects with the gateway's message on any error.
+ *
+ * @param {string} name
+ * @param {Record<string, unknown>} [args]
+ * @param {{apiKey?: string, gatewayUrl?: string, timeoutMs?: number}} [opts]
+ *        apiKey defaults to process.env.PIPEWORX_API_KEY.
+ */
+export async function callTool(name, args = {}, opts = {}) {
+  const cfg = bridgeConfig(process.env, opts);
+  const res = await relay({ jsonrpc: '2.0', id: 1, method: 'tools/call', params: { name, arguments: args } }, { cfg });
+  if (res.error) throw new Error(res.error.message);
+  const result = res.result || {};
+  const text = Array.isArray(result.content)
+    ? result.content.filter((c) => c && c.type === 'text').map((c) => c.text).join('\n')
+    : '';
+  if (result.isError) throw new Error(text || `${name} failed`);
+  if (result.structuredContent !== undefined) return result.structuredContent;
+  try { return JSON.parse(text); } catch { return text; }
+}
+
+export default { tools, callTool };

package/package.json

@@ -1,32 +1,33 @@
 {
   "name": "@pipeworx/mcp-tw-law",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "tw-law — Taiwan national statutes and the Constitution, in Chinese plus the Ministry of Justice's own official English translations where one exists, from the Ministry of Justice Laws & Regulations Database (全國法規資料庫). Fleet #3129.",
   "type": "module",
-  "main": "src/index.ts",
-  "types": "src/index.ts",
+  "main": "lib/index.js",
+  "exports": {
+    ".": "./lib/index.js",
+    "./tools.json": "./tools.json",
+    "./package.json": "./package.json"
+  },
   "bin": {
     "mcp-tw-law": "bin/cli.js"
   },
+  "files": ["bin/", "lib/", "tools.json", "server.json"],
+  "engines": {
+    "node": ">=18"
+  },
   "keywords": ["mcp", "mcp-server", "model-context-protocol", "pipeworx", "tw-law"],
   "license": "MIT",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/pipeworx-io/mcp-tw-law.git"
   },
-  "scripts": {
-    "typecheck": "tsc --noEmit"
-  },
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.30.0",
-    "tsx": "^4.19.0"
-  },
-  "devDependencies": {
-    "typescript": "^5.9.3",
-    "@cloudflare/workers-types": "^4.20260405.1"
-  },
+  "mcpName": "io.github.pipeworx-io/tw-law",
   "pipeworx": {
-    "sourceHash": "v1-93f7e951839b7103df727620fff2c2dd9349d7ec823117325ece1c28e2bfcafd",
-    "sourceCommit": "fe38188882d0fe91e5a45d82b7b989b4aae1e8b6"
+    "mode": "gateway",
+    "slug": "tw-law",
+    "gatewaySlug": "tw-law",
+    "sourceHash": "v1-bb03e0a55c3a85636f48efead2fcf80019e28a76db649bda8c5fcc57d05a486d",
+    "sourceCommit": "f47d581679e1e887373df51ba623f891fbe4c464"
   }
 }

package/server.json

@@ -3,7 +3,7 @@
   "name": "io.github.pipeworx-io/tw-law",
   "title": "Tw Law",
   "description": "tw-law — Taiwan national statutes and the Constitution, in Chinese plus the Ministry of Justice's…",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "websiteUrl": "https://pipeworx.io/packs/tw-law",
   "repository": {
     "url": "https://github.com/pipeworx-io/mcp-tw-law",

package/tools.json

@@ -0,0 +1,88 @@
+[
+  {
+    "name": "tw_law_search",
+    "description": "Search Taiwan national statutes and the Constitution by TITLE keyword, Chinese or English — \"個人資料保護法\", \"Personal Data Protection\", \"民法\", \"Civil Code\". This is a title search, not full-text; it will not find a law by a phrase appearing only inside an article. Returns each match's pcode (for tw_law_info/tw_law_article), Chinese and English titles, law level, category, whether an official English translation exists, and the last amendment date. Source: Taiwan Ministry of Justice, Laws & Regulations Database.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "query": {
+          "type": "string",
+          "description": "Title keyword, Chinese or English, e.g. \"個人資料保護法\" or \"Personal Data Protection Act\"."
+        },
+        "limit": {
+          "type": "number",
+          "description": "Max laws to return (1-50, default 10)."
+        }
+      },
+      "required": [
+        "query"
+      ]
+    }
+  },
+  {
+    "name": "tw_law_info",
+    "description": "Resolve a Taiwan law to its full metadata by pcode (from tw_law_search) or an exact/partial Chinese or English title — the exact-citation step before reading an article. Returns the law's level (法律/憲法), category, official English title if one exists, whether it has been abolished, the LAST AMENDMENT date and the date that amendment TAKES/TOOK LEGAL EFFECT as separate fields (Taiwan statutes can be amended on one date and take effect on another, sometimes \"to be set later by the Executive Yuan\" — flagged as effective_date_pending), the full promulgation history (in Chinese, and in English when the law has an official translation), and the article count. Source: Taiwan Ministry of Justice, Laws & Regulations Database.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "pcode": {
+          "type": "string",
+          "description": "The law's pcode, e.g. \"I0050021\" (from tw_law_search)."
+        },
+        "name": {
+          "type": "string",
+          "description": "Chinese or English law title, exact or partial, used when pcode is not known."
+        }
+      }
+    }
+  },
+  {
+    "name": "tw_law_toc",
+    "description": "Table of contents for one Taiwan law: its chapter/section headings and the article number of every provision, in order, paged. Use to browse a law's structure before reading a specific article with tw_law_article, or to enumerate every article number a long law has. Returns has_more and next_offset when the law has more entries than the page size.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "pcode": {
+          "type": "string",
+          "description": "The law's pcode (from tw_law_search or tw_law_info)."
+        },
+        "name": {
+          "type": "string",
+          "description": "Chinese or English law title, used when pcode is not known."
+        },
+        "offset": {
+          "type": "number",
+          "description": "Pagination offset (default 0)."
+        },
+        "limit": {
+          "type": "number",
+          "description": "Max entries to return (1-500, default 200)."
+        }
+      }
+    }
+  },
+  {
+    "name": "tw_law_article",
+    "description": "Full text of ONE article (條) of a Taiwan law, by pcode or title plus article number in any spelling — \"2\", \"第 2 條\", \"Article 2\", \"第 6-1 條\", \"Article 6-1\". Returns the Chinese text and, when the Ministry has published an official English translation of that law, the official English text of the SAME article, labelled official (never a machine translation) — plus the chapter/section heading it falls under. A long law is never returned whole; use tw_law_toc to find article numbers, and call this once per article.",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "pcode": {
+          "type": "string",
+          "description": "The law's pcode (from tw_law_search or tw_law_info)."
+        },
+        "name": {
+          "type": "string",
+          "description": "Chinese or English law title, used when pcode is not known."
+        },
+        "article": {
+          "type": "string",
+          "description": "Article number, any spelling: \"2\", \"第 2 條\", \"Article 2\", \"6-1\"."
+        }
+      },
+      "required": [
+        "article"
+      ]
+    }
+  }
+]

package/src/index.ts

@@ -1,223 +0,0 @@
-interface McpToolDefinition {
-  name: string;
-  description: string;
-  /** Human-facing one-liner (fleet #1967). Optional; consumers fall back to
-   *  description. Kept in step with shared/src/types.ts — scripts/lib/
-   *  check-inlined-types.mjs reports drift at publish time. */
-  summary?: string;
-  inputSchema: {
-    type: 'object';
-    properties: Record<string, unknown>;
-    required?: string[];
-    anyOf?: Array<{ required: string[] }>;
-    oneOf?: Array<{ required: string[] }>;
-    allOf?: Array<{ required: string[] }>;
-  };
-  outputSchema?: Record<string, unknown>;
-}
-
-interface McpToolExport {
-  tools: McpToolDefinition[];
-  callTool: (name: string, args: Record<string, unknown>) => Promise<unknown>;
-  meter?: { credits: number };
-  cost?: Record<string, unknown>;
-  provider?: string;
-}
-
-/**
- * tw-law — Taiwan national statutes and the Constitution, in Chinese plus
- * the Ministry of Justice's own official English translations where one
- * exists, from the Ministry of Justice Laws & Regulations Database
- * (全國法規資料庫). Fleet #3129.
- *
- * The source publishes its whole catalog only as two bulk JSON exports (no
- * per-law or per-article live route — verified 2026-10-15), so this pack
- * reads from a D1 copy loaded and refreshed by scripts/tw-law/load-data.mjs,
- * per Bruce's 2026-09-23 local-copy ruling. See src/store.ts for the licence
- * and the full load path.
- *
- * Every response carries `source` and `data_as_of` (when the load last ran).
- * Every English field is the Ministry's OWN translation, tied to the exact
- * Chinese law/article it translates, and labelled official — never a
- * machine translation.
- */
-import {
-  type D1Like,
-  dataAsOf,
-  getArticle,
-  getHeadingBefore,
-  getLaw,
-  getToc,
-  requireDb,
-  searchLaws,
-  shapeLaw,
-  SOURCE,
-} from './store.js';
-
-const tools: McpToolExport['tools'] = [
-  {
-    name: 'tw_law_search',
-    description:
-      'Search Taiwan national statutes and the Constitution by TITLE keyword, Chinese or English — "個人資料保護法", "Personal Data Protection", "民法", "Civil Code". This is a title search, not full-text; it will not find a law by a phrase appearing only inside an article. Returns each match\'s pcode (for tw_law_info/tw_law_article), Chinese and English titles, law level, category, whether an official English translation exists, and the last amendment date. Source: Taiwan Ministry of Justice, Laws & Regulations Database.',
-    summary: 'Find a Taiwan law by title (Chinese or English).',
-    inputSchema: {
-      type: 'object' as const,
-      properties: {
-        query: { type: 'string', description: 'Title keyword, Chinese or English, e.g. "個人資料保護法" or "Personal Data Protection Act".' },
-        limit: { type: 'number', description: 'Max laws to return (1-50, default 10).' },
-      },
-      required: ['query'],
-    },
-  },
-  {
-    name: 'tw_law_info',
-    description:
-      'Resolve a Taiwan law to its full metadata by pcode (from tw_law_search) or an exact/partial Chinese or English title — the exact-citation step before reading an article. Returns the law\'s level (法律/憲法), category, official English title if one exists, whether it has been abolished, the LAST AMENDMENT date and the date that amendment TAKES/TOOK LEGAL EFFECT as separate fields (Taiwan statutes can be amended on one date and take effect on another, sometimes "to be set later by the Executive Yuan" — flagged as effective_date_pending), the full promulgation history (in Chinese, and in English when the law has an official translation), and the article count. Source: Taiwan Ministry of Justice, Laws & Regulations Database.',
-    summary: "One Taiwan law's metadata: level, category, amendment vs. effective dates, repeal status, promulgation history.",
-    inputSchema: {
-      type: 'object' as const,
-      properties: {
-        pcode: { type: 'string', description: 'The law\'s pcode, e.g. "I0050021" (from tw_law_search).' },
-        name: { type: 'string', description: 'Chinese or English law title, exact or partial, used when pcode is not known.' },
-      },
-    },
-  },
-  {
-    name: 'tw_law_toc',
-    description:
-      'Table of contents for one Taiwan law: its chapter/section headings and the article number of every provision, in order, paged. Use to browse a law\'s structure before reading a specific article with tw_law_article, or to enumerate every article number a long law has. Returns has_more and next_offset when the law has more entries than the page size.',
-    summary: "A Taiwan law's chapter structure and article numbers, paged.",
-    inputSchema: {
-      type: 'object' as const,
-      properties: {
-        pcode: { type: 'string', description: 'The law\'s pcode (from tw_law_search or tw_law_info).' },
-        name: { type: 'string', description: 'Chinese or English law title, used when pcode is not known.' },
-        offset: { type: 'number', description: 'Pagination offset (default 0).' },
-        limit: { type: 'number', description: 'Max entries to return (1-500, default 200).' },
-      },
-    },
-  },
-  {
-    name: 'tw_law_article',
-    description:
-      'Full text of ONE article (條) of a Taiwan law, by pcode or title plus article number in any spelling — "2", "第 2 條", "Article 2", "第 6-1 條", "Article 6-1". Returns the Chinese text and, when the Ministry has published an official English translation of that law, the official English text of the SAME article, labelled official (never a machine translation) — plus the chapter/section heading it falls under. A long law is never returned whole; use tw_law_toc to find article numbers, and call this once per article.',
-    summary: 'One article of a Taiwan law, Chinese plus the official English translation when one exists.',
-    inputSchema: {
-      type: 'object' as const,
-      properties: {
-        pcode: { type: 'string', description: 'The law\'s pcode (from tw_law_search or tw_law_info).' },
-        name: { type: 'string', description: 'Chinese or English law title, used when pcode is not known.' },
-        article: { type: 'string', description: 'Article number, any spelling: "2", "第 2 條", "Article 2", "6-1".' },
-      },
-      required: ['article'],
-    },
-  },
-];
-
-function clamp(v: unknown, lo: number, hi: number, d: number): number {
-  const n = Math.floor(Number(v));
-  return Number.isFinite(n) && n > 0 ? Math.min(hi, Math.max(lo, n)) : d;
-}
-
-async function resolvePcode(db: D1Like, args: Record<string, unknown>): Promise<string> {
-  const pcode = args.pcode != null ? String(args.pcode).trim() : '';
-  const name = args.name != null ? String(args.name).trim() : '';
-  if (!pcode && !name) throw new Error('Provide either "pcode" (from tw_law_search) or "name" (a Chinese or English law title).');
-  const law = await getLaw(db, { pcode: pcode || undefined, name: name || undefined });
-  if (!law) throw new Error(`No Taiwan law found for ${pcode ? `pcode "${pcode}"` : `name "${name}"`}. Try tw_law_search first.`);
-  return law.pcode;
-}
-
-async function searchTool(db: D1Like, args: Record<string, unknown>) {
-  const query = String(args.query ?? '').trim();
-  if (!query) throw new Error('Required argument "query" is missing (a Chinese or English law title keyword).');
-  const limit = clamp(args.limit, 1, 50, 10);
-  const rows = await searchLaws(db, { query, limit });
-  return {
-    query,
-    returned: rows.length,
-    laws: rows.map((r) => ({ ...shapeLaw(r), matched_on: r.matched_on })),
-    note: rows.length === 0 ? 'No law title matched. This is a title search — try tw_law_search with a different keyword, not an article phrase.' : undefined,
-    source: SOURCE,
-    data_as_of: await dataAsOf(db),
-  };
-}
-
-async function infoTool(db: D1Like, args: Record<string, unknown>) {
-  const pcode = args.pcode != null ? String(args.pcode).trim() : '';
-  const name = args.name != null ? String(args.name).trim() : '';
-  if (!pcode && !name) throw new Error('Provide either "pcode" (from tw_law_search) or "name" (a Chinese or English law title).');
-  const law = await getLaw(db, { pcode: pcode || undefined, name: name || undefined });
-  if (!law) throw new Error(`No Taiwan law found for ${pcode ? `pcode "${pcode}"` : `name "${name}"`}. Try tw_law_search first.`);
-  return { ...shapeLaw(law), data_as_of: await dataAsOf(db) };
-}
-
-async function tocTool(db: D1Like, args: Record<string, unknown>) {
-  const pcode = await resolvePcode(db, args);
-  const offset = clamp(args.offset, 0, 1_000_000, 0);
-  const limit = clamp(args.limit, 1, 500, 200);
-  const { rows, total } = await getToc(db, { pcode, offset, limit });
-  return {
-    pcode,
-    total_entries: total,
-    returned: rows.length,
-    offset,
-    entries: rows.map((r) => ({
-      seq: r.seq,
-      kind: r.article_type === 'C' ? 'heading' : 'article',
-      article_no: r.article_no || null,
-      eng_article_no: r.eng_article_no || null,
-      text: r.article_type === 'C' ? r.content : undefined,
-    })),
-    has_more: offset + rows.length < total,
-    next_offset: offset + rows.length < total ? offset + rows.length : null,
-    source: SOURCE,
-    data_as_of: await dataAsOf(db),
-  };
-}
-
-async function articleTool(db: D1Like, args: Record<string, unknown>) {
-  const articleArg = args.article != null ? String(args.article).trim() : '';
-  if (!articleArg) throw new Error('Required argument "article" is missing, e.g. "2" or "Article 2".');
-  const pcode = await resolvePcode(db, args);
-  const row = await getArticle(db, { pcode, articleNo: articleArg });
-  if (!row) {
-    throw new Error(
-      `No article "${articleArg}" found for this law. Use tw_law_toc to list its real article numbers — some laws skip numbers or use "-1"/"-2" sub-articles.`,
-    );
-  }
-  const law = await getLaw(db, { pcode });
-  const heading = await getHeadingBefore(db, { pcode, seq: row.seq });
-  return {
-    pcode,
-    law_name: law?.law_name ?? null,
-    eng_law_name: law?.eng_law_name ?? null,
-    heading: heading,
-    article_no: row.article_no,
-    content: row.content,
-    eng_article_no: row.eng_article_no,
-    eng_content: row.eng_content,
-    translation_label: row.eng_content ? 'official' : null,
-    has_official_english_translation: !!row.eng_content,
-    source: SOURCE,
-    data_as_of: await dataAsOf(db),
-  };
-}
-
-async function callTool(name: string, args: Record<string, unknown>): Promise<unknown> {
-  const db = requireDb(args._d1);
-  switch (name) {
-    case 'tw_law_search':
-      return searchTool(db, args);
-    case 'tw_law_info':
-      return infoTool(db, args);
-    case 'tw_law_toc':
-      return tocTool(db, args);
-    case 'tw_law_article':
-      return articleTool(db, args);
-    default:
-      throw new Error(`Unknown tool: ${name}`);
-  }
-}
-
-export default { tools, callTool, meter: { credits: 1 } } satisfies McpToolExport;

package/src/server.ts

@@ -1,48 +0,0 @@
-/**
- * Stdio MCP server entry point for @pipeworx/mcp-tw-law.
- * Generated by scripts/publish-pack.sh — do not hand-edit in the pack repo;
- * edit scripts/publish-pack.sh (the server.ts heredoc) and republish instead.
- */
-import { Server } from '@modelcontextprotocol/sdk/server/index.js';
-import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
-import pack from './index.js';
-
-
-const server = new Server(
-  { name: '@pipeworx/mcp-tw-law', version: '0.1.0' },
-  { capabilities: { tools: {} } },
-);
-
-server.setRequestHandler(ListToolsRequestSchema, async () => ({
-  tools: pack.tools.map((t) => ({
-    name: t.name,
-    description: t.description,
-    inputSchema: t.inputSchema,
-  })),
-}));
-
-server.setRequestHandler(CallToolRequestSchema, async (request) => {
-  const { name, arguments: args } = request.params;
-  try {
-    const callArgs = { ...((args ?? {}) as Record<string, unknown>) };
-    
-    const result = await pack.callTool(name, callArgs);
-    return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
-  } catch (err) {
-    return {
-      content: [{ type: 'text', text: err instanceof Error ? err.message : String(err) }],
-      isError: true,
-    };
-  }
-});
-
-async function main() {
-  const transport = new StdioServerTransport();
-  await server.connect(transport);
-}
-
-main().catch((err) => {
-  console.error('Fatal error running server:', err);
-  process.exit(1);
-});

package/src/store.ts

@@ -1,214 +0,0 @@
-/**
- * Reads for tw-law (fleet #3129).
- *
- * Taiwan's Ministry of Justice Laws & Regulations Database
- * (全國法規資料庫, law.moj.gov.tw) publishes its whole catalog — every national
- * statute and the Constitution, in Chinese, plus the Ministry's own official
- * English translations where one exists — only as two bulk JSON exports (one
- * per language), never a per-law or per-article live route (verified
- * 2026-10-15: both `/api/Ch/Law/JSON` and `/api/En/Law/JSON` return a zip of
- * the ENTIRE catalog; there is no `LawSearchContent`-style per-item endpoint).
- * Per Bruce's 2026-09-23 ruling on bulk-only sources, `scripts/tw-law/load-data.mjs`
- * downloads both exports, joins each Chinese law to its official English
- * translation by title (the join key the source itself uses — see that
- * script's header), and writes the result into a D1 database the gateway
- * hands this pack as `_d1`
- * (pack-manifest "d1Binding": "TW_LAW_DB"). Table/column names here must
- * match that script's buildSchemaSql().
- *
- * Licence: 政府資料開放授權條款-第1版 (Government Open Data Licence v1), the
- * licence law.moj.gov.tw's own data-reuse declaration
- * (law.moj.gov.tw/Service/Copyright.aspx) names for this database — free,
- * non-exclusive, re-licensable, and explicitly permits reproduction,
- * adaptation and public transmission (i.e. a mirror, not just a live proxy),
- * conditioned only on citing the source. That is what is cited below.
- */
-
-/** The slice of Cloudflare's D1Database this pack uses, declared here so the
- *  pack needs no workers-types and a test can pass a node:sqlite stub. */
-export interface D1Like {
-  prepare(sql: string): D1StmtLike;
-}
-export interface D1StmtLike {
-  bind(...values: unknown[]): D1StmtLike;
-  all<T = Record<string, unknown>>(): Promise<{ results: T[] }>;
-  first<T = Record<string, unknown>>(): Promise<T | null>;
-}
-
-// Provenance is publisher + dataset + data_as_of (CLAUDE.md step 9b) — never
-// the download route.
-export const SOURCE = 'Taiwan Ministry of Justice, Laws & Regulations Database (全國法規資料庫)';
-export const LICENSE =
-  '政府資料開放授權條款-第1版 (Government Open Data Licence v1) — free, non-exclusive, ' +
-  're-licensable reuse including reproduction and public transmission, conditioned on citing the source.';
-
-export class StoreUnavailableError extends Error {
-  constructor() {
-    super(
-      'tw-law: the law store is not bound in this runtime (no _d1). These tools only answer through the Pipeworx gateway; a standalone install has no data to read.',
-    );
-    this.name = 'StoreUnavailableError';
-  }
-}
-export function requireDb(d1: unknown): D1Like {
-  if (!d1 || typeof (d1 as D1Like).prepare !== 'function') throw new StoreUnavailableError();
-  return d1 as D1Like;
-}
-
-export interface LawRow {
-  pcode: string;
-  law_name: string;
-  eng_law_name: string | null;
-  law_level: string;
-  law_category: string | null;
-  law_url: string;
-  eng_law_url: string | null;
-  has_eng_version: number;
-  modified_date: string | null;
-  effective_date: string | null;
-  effective_note: string | null;
-  abandon_note: string | null;
-  foreword: string | null;
-  histories: string | null;
-  eng_histories: string | null;
-  article_count: number;
-}
-
-const LAW_COLS = `pcode, law_name, eng_law_name, law_level, law_category, law_url, eng_law_url, has_eng_version,
-  modified_date, effective_date, effective_note, abandon_note, foreword, histories, eng_histories, article_count`;
-
-/** Chinese government dates are plain YYYYMMDD strings; a few historical
- *  entries are empty (effective on promulgation) or the "99991231" sentinel
- *  the source itself uses for "date set later by the Executive Yuan" — never
- *  guess a real date for either, surface them as given. */
-function fmtDate(raw: string | null): string | null {
-  if (!raw) return null;
-  if (raw === '99991231') return null;
-  const m = /^(\d{4})(\d{2})(\d{2})$/.exec(raw);
-  return m ? `${m[1]}-${m[2]}-${m[3]}` : raw;
-}
-
-function isPending(raw: string | null): boolean {
-  return raw === '99991231';
-}
-
-export function shapeLaw(r: LawRow) {
-  return {
-    pcode: r.pcode,
-    law_name: r.law_name,
-    eng_law_name: r.eng_law_name,
-    law_level: r.law_level,
-    law_category: r.law_category,
-    law_url: r.law_url,
-    eng_law_url: r.eng_law_url,
-    has_official_english_translation: r.has_eng_version === 1,
-    abolished: !!(r.abandon_note && r.abandon_note.trim()),
-    abandon_note: r.abandon_note || null,
-    // Dates kept apart per the legal-pack contract: amendment date (most
-    // recent change to the text) vs. the date that amendment takes/took
-    // legal effect — the source tracks these as two separate fields, and so
-    // does this pack.
-    last_amended_date: fmtDate(r.modified_date),
-    effective_date: fmtDate(r.effective_date),
-    effective_date_pending: isPending(r.effective_date),
-    effective_note: r.effective_note || null,
-    foreword: r.foreword || null,
-    promulgation_history: r.histories || null,
-    promulgation_history_english: r.eng_histories || null,
-    article_count: r.article_count,
-    source: SOURCE,
-  };
-}
-
-export async function dataAsOf(db: D1Like): Promise<string | null> {
-  const r = await db.prepare(`SELECT value FROM tw_law_meta WHERE key = 'loaded_at'`).first<{ value: string }>();
-  return r?.value ?? null;
-}
-
-/** The whole catalog is 1,351 laws — a LIKE scan over that is trivial, so
- *  title search skips FTS5 entirely (and the chunked-import trap that comes
- *  with it; see reference_d1_fts5_import_trap) in favor of a plain
- *  substring match on both the Chinese and English titles. */
-export async function searchLaws(
-  db: D1Like,
-  opts: { query: string; limit: number },
-): Promise<Array<LawRow & { matched_on: 'chinese_title' | 'english_title' }>> {
-  const q = opts.query.trim();
-  if (!q) return [];
-  const cols = LAW_COLS.split(',').map((c) => `l.${c.trim()}`).join(', ');
-  const r = await db
-    .prepare(
-      `SELECT ${cols},
-         CASE WHEN l.law_name LIKE ? THEN 'chinese_title' ELSE 'english_title' END AS matched_on
-       FROM tw_laws l WHERE l.law_name LIKE ? OR l.eng_law_name LIKE ?
-       ORDER BY length(l.law_name) LIMIT ?`,
-    )
-    .bind(`%${q}%`, `%${q}%`, `%${q}%`, opts.limit)
-    .all<LawRow & { matched_on: 'chinese_title' | 'english_title' }>();
-  return r.results;
-}
-
-export async function getLaw(db: D1Like, opts: { pcode?: string; name?: string }): Promise<LawRow | null> {
-  if (opts.pcode) {
-    return db.prepare(`SELECT ${LAW_COLS} FROM tw_laws WHERE pcode = ?`).bind(opts.pcode).first<LawRow>();
-  }
-  if (opts.name) {
-    const exact = await db.prepare(`SELECT ${LAW_COLS} FROM tw_laws WHERE law_name = ? OR eng_law_name = ?`).bind(opts.name, opts.name).first<LawRow>();
-    if (exact) return exact;
-    return db
-      .prepare(`SELECT ${LAW_COLS} FROM tw_laws WHERE law_name LIKE ? OR eng_law_name LIKE ? ORDER BY length(law_name) LIMIT 1`)
-      .bind(`%${opts.name}%`, `%${opts.name}%`)
-      .first<LawRow>();
-  }
-  return null;
-}
-
-export interface ArticleRow {
-  seq: number;
-  article_type: 'A' | 'C';
-  article_no: string | null;
-  article_no_norm: string | null;
-  content: string;
-  eng_article_no: string | null;
-  eng_content: string | null;
-}
-const ARTICLE_COLS = 'seq, article_type, article_no, article_no_norm, content, eng_article_no, eng_content';
-
-export async function getToc(
-  db: D1Like,
-  opts: { pcode: string; offset: number; limit: number },
-): Promise<{ rows: ArticleRow[]; total: number }> {
-  const total = await db.prepare(`SELECT count(*) AS n FROM tw_articles WHERE pcode = ?`).bind(opts.pcode).first<{ n: number }>();
-  const r = await db
-    .prepare(`SELECT ${ARTICLE_COLS} FROM tw_articles WHERE pcode = ? ORDER BY seq LIMIT ? OFFSET ?`)
-    .bind(opts.pcode, opts.limit, opts.offset)
-    .all<ArticleRow>();
-  return { rows: r.results, total: total?.n ?? 0 };
-}
-
-/** "第 2 條" / "2" / "Article 2" / "第 6-1 條" / "Article 6-1" all normalize
- *  to the same key the loader stored, so any of the source's own spellings
- *  (Chinese or English) resolves a provision. */
-export function normalizeArticleNo(v: string): string {
-  const m = /(\d+)(?:[-之](\d+))?/.exec(String(v));
-  if (!m) return String(v).trim();
-  return m[2] ? `${m[1]}-${m[2]}` : m[1];
-}
-
-export async function getArticle(db: D1Like, opts: { pcode: string; articleNo: string }): Promise<ArticleRow | null> {
-  const norm = normalizeArticleNo(opts.articleNo);
-  return db
-    .prepare(`SELECT ${ARTICLE_COLS} FROM tw_articles WHERE pcode = ? AND article_type = 'A' AND article_no_norm = ? LIMIT 1`)
-    .bind(opts.pcode, norm)
-    .first<ArticleRow>();
-}
-
-/** The chapter/section heading (ArticleType 'C') immediately preceding a
- *  given seq, for context — "第 一 章 總則" above Article 1, etc. */
-export async function getHeadingBefore(db: D1Like, opts: { pcode: string; seq: number }): Promise<string | null> {
-  const r = await db
-    .prepare(`SELECT content FROM tw_articles WHERE pcode = ? AND article_type = 'C' AND seq < ? ORDER BY seq DESC LIMIT 1`)
-    .bind(opts.pcode, opts.seq)
-    .first<{ content: string }>();
-  return r?.content ?? null;
-}

package/tsconfig.json

@@ -1,18 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "ESNext",
-    "moduleResolution": "bundler",
-    "lib": ["ES2022"],
-    "types": ["@cloudflare/workers-types"],
-    "strict": true,
-    "esModuleInterop": true,
-    "skipLibCheck": true,
-    "resolveJsonModule": true,
-    "outDir": "dist",
-    "rootDir": "src",
-    "declaration": true
-  },
-  "include": ["src"],
-  "exclude": ["src/server.ts"]
-}