codesift-mcp 0.2.0 → 0.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +56 -0
  2. package/package.json +4 -3
package/README.md CHANGED
@@ -503,6 +503,62 @@ npm run test:coverage # Coverage report
503
503
  npm run lint # Type check (tsc --noEmit)
504
504
  ```
505
505
 
506
+ ## Publishing a new version
507
+
508
+ After making changes, follow these steps to publish to npm:
509
+
510
+ ```bash
511
+ # 1. Ensure clean working tree
512
+ git status # No uncommitted changes
513
+
514
+ # 2. Build and verify
515
+ npm run build # Must succeed with 0 errors
516
+ npm test # Must pass (flaky ast-query tests may fail in full suite — OK if they pass individually)
517
+
518
+ # 3. Bump version (choose one)
519
+ npm version patch # 0.2.0 → 0.2.1 (bug fixes)
520
+ npm version minor # 0.2.0 → 0.3.0 (new features)
521
+ npm version major # 0.2.0 → 1.0.0 (breaking changes)
522
+ # This creates a git commit + tag automatically
523
+
524
+ # 4. Publish to npm
525
+ npm publish --ignore-scripts
526
+ # npm will open browser for WebAuthn/Keychain authentication
527
+ # Press Enter, confirm in browser, done
528
+
529
+ # 5. Push to GitHub (commit + tag)
530
+ git push && git push --tags
531
+ ```
532
+
533
+ ### What gets published
534
+
535
+ The `files` field in `package.json` controls what ships:
536
+ - `dist/` — compiled JavaScript
537
+ - `rules/` — platform-specific agent rules (codesift.md, codesift.mdc, codex.md, gemini.md)
538
+ - `src/parser/languages/` — tree-sitter WASM grammars
539
+ - `README.md`, `LICENSE`
540
+
541
+ ### After publishing
542
+
543
+ Users update with:
544
+ ```bash
545
+ npm update -g codesift-mcp # Update package
546
+ codesift setup all # Update rules files to latest version
547
+ ```
548
+
549
+ If using `npx -y codesift-mcp` (the default in MCP config), the latest version is picked up automatically on next session start.
550
+
551
+ ### Checklist before publishing
552
+
553
+ - [ ] `npm run build` — 0 TypeScript errors
554
+ - [ ] `npm test` — 895+ tests pass
555
+ - [ ] `rules/codesift.md` updated if hints or tools changed
556
+ - [ ] `src/instructions.ts` updated if rules changed (compact version)
557
+ - [ ] `README.md` updated if features added
558
+ - [ ] `CLAUDE.md` updated if architecture changed
559
+ - [ ] Version bumped via `npm version`
560
+ - [ ] Changes committed and pushed to GitHub
561
+
506
562
  ## License
507
563
 
508
564
  BSL-1.1
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "codesift-mcp",
3
- "version": "0.2.0",
4
- "description": "MCP server for code intelligence — 39 tools for symbol search, call graph, semantic search, route tracing, community detection, LSP bridge, and HTML reporting",
3
+ "version": "0.2.1",
4
+ "description": "MCP server for code intelligence — 63 tools for symbol search, call graph, semantic search, route tracing, community detection, LSP bridge, secret detection, and conversation search",
5
5
  "license": "BSL-1.1",
6
6
  "author": "Greg Laskowski",
7
7
  "type": "module",
@@ -26,7 +26,8 @@
26
26
  "test:coverage": "vitest run --coverage",
27
27
  "lint": "tsc --noEmit",
28
28
  "download-wasm": "tsx scripts/download-wasm.ts",
29
- "prepublishOnly": "npm run build && npm test"
29
+ "prepublishOnly": "npm run build && npm test",
30
+ "postinstall": "echo '\n ✨ CodeSift MCP installed. Run setup for your platform:\n\n codesift setup claude # Claude Code\n codesift setup cursor # Cursor\n codesift setup codex # Codex CLI\n codesift setup gemini # Gemini CLI\n codesift setup all # All platforms\n'"
30
31
  },
31
32
  "dependencies": {
32
33
  "@modelcontextprotocol/sdk": "^1.0.0",