surf-skill 4.0.0 → 4.0.1

package/CHANGELOG.md

@@ -1,5 +1,46 @@
 # Changelog
 
+## v4.0.1 — fix missing `surf-search-skill` bin after v4.0.0 rename
+
+### The bug
+
+`npm i -g surf-skill@4.0.0` installed the package but did **not** create
+the `surf-search-skill` command on PATH. Only `surf` and
+`surf-plan-skill` symlinks were created. Calling `surf-search-skill …`
+produced `command not found`, breaking the skill end-to-end.
+
+### Root cause
+
+The v4.0.0 rename moved `bin/surf-skill.mjs` → `bin/surf-search-skill.mjs`
+(file rename) but `package.json#bin` was missed — it still mapped
+`"surf-skill": "./bin/surf-skill.mjs"`, pointing at a file that no longer
+exists. npm silently skipped the broken bin entry instead of erroring,
+so no `surf-search-skill` symlink was ever created.
+
+### Fix
+
+- `package.json#bin`: `"surf-skill": "./bin/surf-skill.mjs"` →
+  `"surf-search-skill": "./bin/surf-search-skill.mjs"`.
+
+### Files changed
+
+- `package.json` (bin entry + version bump).
+- `bin/{surf,surf-search-skill,surf-plan-skill}.mjs` — `VERSION` →
+  `4.0.1`.
+- `src/install/postinstall.mjs` — banner string.
+- `SKILL.md`, `skills/surf-plan-skill/SKILL.md` — frontmatter
+  `version: "4.0.1"`.
+- `README.md` — Status badge and Repository layout heading.
+
+### Upgrading
+
+```bash
+npm i -g surf-skill@latest
+surf-search-skill --version   # 4.0.1
+```
+
+No other behavior changes — this is purely a packaging fix.
+
 ## v4.0.0 — rename `surf-skill` skill → `surf-search-skill` (consistent suffix), audit cleanup
 
 ### Why a major bump

package/README.md

@@ -39,7 +39,7 @@ architect / spec ──────────────────►│  (
 
 | | |
 |---|---|
-| **Status** | v4.0.0 (npm) |
+| **Status** | v4.0.1 (npm) |
 | **Install** | `npm i -g surf-skill` (Linux · macOS · Windows) |
 | **Skills shipped** | `surf-search-skill` (search) + `surf-plan-skill` (planning) |
 | **Bins shipped** | `surf` (interactive setup + validation), `surf-search-skill`, `surf-plan-skill` |
@@ -437,11 +437,11 @@ research-poll <id>`. Sync research is capped at 50 s on purpose.
 
 ---
 
-## Repository layout (v4.0.0)
+## Repository layout (v4.0.1)
 
 ```text
 .
-├── package.json                       ← name: surf-skill (npm), version 4.0.0, 3 bins
+├── package.json                       ← name: surf-skill (npm), version 4.0.1, 3 bins
 ├── README.md           ← you're here
 ├── CHANGELOG.md
 ├── LICENSE

package/SKILL.md

@@ -4,7 +4,7 @@ description: Web search, content extraction, site crawl, URL mapping, and deep r
 license: MIT
 allowed-tools: bash
 metadata:
-  version: "4.0.0"
+  version: "4.0.1"
   requires: "node>=18; install via `npm i -g surf-skill` (bundles surf-search-skill + surf-plan-skill); keys via `surf` (interactive, with live validation) or `surf-search-skill setup`; per-project bash timeout via `surf-search-skill project-config`"
 ---
 

package/bin/surf-plan-skill.mjs

@@ -9,7 +9,7 @@ import { listPlans, readPlan, newPlanStub } from '../src/plan/plan-file.mjs';
 import { slugify } from '../src/plan/slug.mjs';
 import { checkSurfSkill } from '../src/lib/check-surf-skill.mjs';
 
-const VERSION = '4.0.0';
+const VERSION = '4.0.1';
 
 const HELP = `surf-plan-skill — research-grounded execution planning skill
 

package/bin/surf-search-skill.mjs

@@ -15,7 +15,7 @@ import { runProjectConfig, formatProjectConfigResult } from '../src/lib/project-
 import { providerFromRequestId } from '../src/lib/providers/index.mjs';
 import { progress, setSilent } from '../src/lib/progress.mjs';
 
-const VERSION = '4.0.0';
+const VERSION = '4.0.1';
 
 // Catch SIGTERM/SIGINT so a harness-driven kill surfaces a useful message
 // instead of dying silently. This is defense-in-depth: dispatch already

package/bin/surf.mjs

@@ -21,7 +21,7 @@ import { loadState, saveStateAtomic, KEYS_FILE, PROVIDERS } from '../src/lib/sta
 import { validateKey, formatValidation } from '../src/validators/index.mjs';
 import { HARNESS_DIRS } from '../src/lib/harness-install.mjs';
 
-const VERSION = '4.0.0';
+const VERSION = '4.0.1';
 
 const HELP = `surf — multi-skill setup & validation
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "surf-skill",
-  "version": "4.0.0",
+  "version": "4.0.1",
   "description": "Multi-skill bundle for AI coding agents: surf-search-skill (multi-provider web search via Tavily + Parallel + Brave) + surf-plan-skill (research-driven execution planning). Includes `surf` interactive setup with live key validation, automatic provider fallback, multi-key rotation, --mode tiers, per-project timeout config, and a Node library.",
   "type": "module",
   "main": "./src/index.mjs",
@@ -12,7 +12,7 @@
   },
   "bin": {
     "surf": "./bin/surf.mjs",
-    "surf-skill": "./bin/surf-skill.mjs",
+    "surf-search-skill": "./bin/surf-search-skill.mjs",
     "surf-plan-skill": "./bin/surf-plan-skill.mjs"
   },
   "files": [

package/skills/surf-plan-skill/SKILL.md

@@ -4,7 +4,7 @@ description: Generate a research-grounded execution plan for any coding task. AL
 license: MIT
 allowed-tools: bash, read, glob, grep, edit, write, AskUserQuestion
 metadata:
-  version: "4.0.0"
+  version: "4.0.1"
   requires: "node>=18; surf-search-skill in PATH (npm i -g surf-skill); plan dir at ~/.claude/plans/ (or ./plans/ if it exists in the project)"
 ---
 

package/src/install/postinstall.mjs

@@ -59,7 +59,7 @@ async function main() {
   if (skel.created) process.stdout.write(`✓ created ${skel.created} (chmod 600)\n`);
 
   process.stdout.write('\n');
-  process.stdout.write('✓ surf-skill 4.0.0 installed globally — 2 skills + 3 bins:\n');
+  process.stdout.write('✓ surf-skill 4.0.1 installed globally — 2 skills + 3 bins:\n');
   process.stdout.write('    surf                interactive setup with live key validation\n');
   process.stdout.write('    surf-search-skill   multi-provider web search (Tavily + Parallel + Brave)\n');
   process.stdout.write('    surf-plan-skill     research-grounded execution planning\n');