webseek 0.1.0 → 0.2.0

package/README.md

@@ -23,7 +23,7 @@ express mode** (`vertex-express`).
 
 ```bash
 npm install -g webseek      # install the CLI globally
-npx webseek search "..." -p google   # or run without installing
+npx webseek "..." -p google   # or run without installing
 ```
 
 ### Build from source
@@ -39,10 +39,10 @@ the TypeScript source through `tsx`).
 ## CLI mode
 
 ```bash
-webseek search <query...> --provider <openai|google|gemini> [options]
+webseek <query...> --provider <openai|google|gemini> [options]
 ```
 
-Options for `search`:
+Options:
 
 | Flag                    | Description                                 |
 | ----------------------- | ------------------------------------------- |
@@ -56,9 +56,9 @@ Options for `search`:
 Examples:
 
 ```bash
-webseek search "best static site generators 2026" -p google -n 5
-webseek search "summarize the latest TypeScript release" -p openai
-webseek search "who won euro 2024" -p gemini --gemini-backend vertex-express --json
+webseek "best static site generators 2026" -p google -n 5
+webseek "summarize the latest TypeScript release" -p openai
+webseek "who won euro 2024" -p gemini --gemini-backend vertex-express --json
 ```
 
 ## MCP server mode
@@ -135,7 +135,7 @@ they don't leak into shell history or process listings.
 ```
 src/
   index.ts    public library entry (runSearch, types, createWebSearchTool)
-  cli/        commander program: `search` and `mcp` commands
+  cli/        commander program: root search command and `mcp` command
   mcp/        MCP server + the web_search tool
   lib/        runSearch — the shared core called by both CLI and MCP
   providers/  per-provider implementations (openai, google-cse, gemini)
@@ -151,3 +151,19 @@ src/
 pnpm cicheck      # format check, lint, typecheck, unit tests, spelling, secrets
 pnpm test:e2e     # end-to-end tests (CLI subprocess + MCP stdio client)
 ```
+
+## Releasing
+
+Publishing to npm is automated. To cut a new version:
+
+1. Run the `draft-release` skill — it bumps the version on a `release/vX.Y.Z`
+   branch, opens a PR, and creates a **draft** GitHub release.
+2. Review and merge the release PR into `main`.
+3. Open the draft release on GitHub and click **Publish release**.
+
+Publishing the release triggers
+[`.github/workflows/publish.yml`](.github/workflows/publish.yml), which verifies
+the tag matches `package.json` and runs `pnpm publish`. Authentication uses npm
+**trusted publishing** (OIDC) — no token secret is required, and provenance is
+generated automatically. Configure the trusted publisher for the package once on
+npmjs.com, pointing it at this repository's `publish.yml` workflow.

package/dist/cli/index.cjs

@@ -161,8 +161,12 @@ async function runSearchCommand(params) {
 		json: Boolean(params.options.json)
 	}));
 }
+/**
+* Configure the root program to run a web search. Search has no dedicated
+* subcommand — `webseek "<query>" -p <provider>` is the primary invocation.
+*/
 function registerSearchCommand(program) {
-	program.command("search").description("Search the web via a provider").argument("<query...>", "the search query").requiredOption("-p, --provider <name>", "provider: openai | google | gemini").option("-n, --max-results <number>", "desired number of results (SERP providers)").option("-m, --model <name>", "model override (openai, gemini)").option("--gemini-backend <backend>", "gemini backend: gemini-api | vertex-express").option("--json", "emit normalized JSON instead of text").option("--raw", "include the provider's raw response").action(wrapCommand(async ({ logger }, queryParts, options) => {
+	program.argument("[query...]", "the search query").option("-p, --provider <name>", "provider: openai | google | gemini").option("-n, --max-results <number>", "desired number of results (SERP providers)").option("-m, --model <name>", "model override (openai, gemini)").option("--gemini-backend <backend>", "gemini backend: gemini-api | vertex-express").option("--json", "emit normalized JSON instead of text").option("--raw", "include the provider's raw response").action(wrapCommand(async ({ logger }, queryParts, options) => {
 		await runSearchCommand({
 			logger,
 			queryParts,
@@ -176,8 +180,8 @@ function registerSearchCommand(program) {
 * webseek CLI entry point.
 *
 * Two modes:
-*   webseek search <query> --provider <name>   run a one-off web search
-*   webseek mcp                                start the MCP server (stdio)
+*   webseek <query> --provider <name>   run a one-off web search (root command)
+*   webseek mcp                         start the MCP server (stdio)
 */
 function readPackageVersion(dir) {
 	try {

package/dist/cli/index.mjs

@@ -161,8 +161,12 @@ async function runSearchCommand(params) {
 		json: Boolean(params.options.json)
 	}));
 }
+/**
+* Configure the root program to run a web search. Search has no dedicated
+* subcommand — `webseek "<query>" -p <provider>` is the primary invocation.
+*/
 function registerSearchCommand(program) {
-	program.command("search").description("Search the web via a provider").argument("<query...>", "the search query").requiredOption("-p, --provider <name>", "provider: openai | google | gemini").option("-n, --max-results <number>", "desired number of results (SERP providers)").option("-m, --model <name>", "model override (openai, gemini)").option("--gemini-backend <backend>", "gemini backend: gemini-api | vertex-express").option("--json", "emit normalized JSON instead of text").option("--raw", "include the provider's raw response").action(wrapCommand(async ({ logger }, queryParts, options) => {
+	program.argument("[query...]", "the search query").option("-p, --provider <name>", "provider: openai | google | gemini").option("-n, --max-results <number>", "desired number of results (SERP providers)").option("-m, --model <name>", "model override (openai, gemini)").option("--gemini-backend <backend>", "gemini backend: gemini-api | vertex-express").option("--json", "emit normalized JSON instead of text").option("--raw", "include the provider's raw response").action(wrapCommand(async ({ logger }, queryParts, options) => {
 		await runSearchCommand({
 			logger,
 			queryParts,
@@ -176,8 +180,8 @@ function registerSearchCommand(program) {
 * webseek CLI entry point.
 *
 * Two modes:
-*   webseek search <query> --provider <name>   run a one-off web search
-*   webseek mcp                                start the MCP server (stdio)
+*   webseek <query> --provider <name>   run a one-off web search (root command)
+*   webseek mcp                         start the MCP server (stdio)
 */
 function readPackageVersion(dir) {
 	try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "webseek",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Unified multi-provider web search as a CLI, MCP server, and library (OpenAI, Google Custom Search, Gemini)",
   "keywords": [
     "web-search",
@@ -12,13 +12,13 @@
     "gemini",
     "serp"
   ],
-  "homepage": "https://github.com/dyoshikawa/websearch#readme",
+  "homepage": "https://github.com/dyoshikawa/webseek#readme",
   "bugs": {
-    "url": "https://github.com/dyoshikawa/websearch/issues"
+    "url": "https://github.com/dyoshikawa/webseek/issues"
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/dyoshikawa/websearch.git"
+    "url": "https://github.com/dyoshikawa/webseek.git"
   },
   "license": "MIT",
   "author": "dyoshikawa",
@@ -54,6 +54,7 @@
     "access": "public"
   },
   "devDependencies": {
+    "@openrouter/sdk": "0.13.7",
     "@secretlint/secretlint-rule-preset-recommend": "13.0.2",
     "@tsconfig/node24": "^24.0.4",
     "@types/node": "^26.0.0",
@@ -61,6 +62,8 @@
     "lint-staged": "17.0.7",
     "oxfmt": "0.55.0",
     "oxlint": "1.70.0",
+    "repomix": "1.14.1",
+    "resend": "6.14.0",
     "rulesync": "^8.31.0",
     "secretlint": "13.0.2",
     "simple-git-hooks": "2.13.1",
@@ -89,8 +92,10 @@
     "fix": "pnpm run fmt && pnpm run oxlint:fix",
     "test": "vitest run --config vitest.config.ts --silent=true",
     "test:e2e": "vitest run --config vitest.e2e.config.ts --silent=false",
+    "sync:skill-docs": "tsx scripts/sync-skill-docs.ts",
+    "check:sync-skill-docs": "tsx scripts/check-skill-docs-sync.ts",
     "cicheck:code": "pnpm run check && pnpm run test",
-    "cicheck:content": "pnpm run cspell && pnpm run secretlint",
+    "cicheck:content": "pnpm run check:sync-skill-docs && pnpm run cspell && pnpm run secretlint",
     "cicheck": "pnpm run cicheck:code && pnpm run cicheck:content",
     "generate": "rulesync generate",
     "gitignore": "rulesync gitignore"