Skip to content

v5.5.0 — Guardian Mode: Zero-Config Protection

Choose a tag to compare

@sgroy10 sgroy10 released this 08 Apr 09:39
· 30 commits to main since this release

Your AI has rules. SpecLock makes them unbreakable.

New: npx speclock protect

Zero-config Guardian Mode — reads your existing AI rule files and makes them enforceable. One command, no flags, no API key needed.

What it does:

  1. Discovers .cursorrules, CLAUDE.md, AGENTS.md, copilot-instructions.md, .windsurfrules, GEMINI.md, .aider.conf.yml
  2. Extracts enforceable constraints using heuristic pattern matching (NEVER/ALWAYS/MUST/DO NOT)
  3. Adds them as SpecLock locks (deduplicates against existing)
  4. Installs a pre-commit hook (blocks commits that violate rules)
  5. Syncs rules to all other AI tools (without overwriting source files)

Why this matters: 39K developers starred awesome-cursorrules. 60K+ projects use AGENTS.md. But these are just suggestions — the AI can ignore every
line. SpecLock is the enforcement layer that makes them laws.

Changes

  • New: src/core/guardian.js — discover, extract, protect flow
  • New: speclock_protect MCP tool — zero-config guardian via MCP
  • New: speclock_discover_rules MCP tool — find all AI rule files in project
  • New: 47 tests for guardian module (976 total, 19 suites, 100% pass)
  • New: excludeFiles option in rules-sync to avoid overwriting source files
  • Updated: npm description rewritten for discoverability
  • Updated: Tagline: "Your AI has rules. SpecLock makes them unbreakable."
  • Updated: All version references across 16 files
  • 51 MCP tools (was 49)
  • 976 tests (was 929)

Install / Update

npm install -g speclock@5.5.0
# or just
npx speclock protect

Verify

curl https://speclock-mcp-production.up.railway.app/health
# → { "version": "5.5.0", "tools": 51 }

---Developed by Sandeep Roy — https://www.npmjs.com/package/speclock · https://smithery.ai/servers/sgroy10/speclock · https://sgroy10.github.io/speclock/