OpsContext for AI Agents — 2.0.0

Strategic pivot release. The package previously known as @compr/contextengine-mcp ships as @compr/opscontext-mcp starting with this version. Same code, sharper positioning — the ops + compliance layer Claude Code can't grow natively.

📦 npm: https://www.npmjs.com/package/@compr/opscontext-mcp
🚨 Migration: @compr/contextengine-mcp is deprecated on the registry with a pointer at this package. Existing installs keep working; new installs should use the new name.

Three new pillars

🔭 Operational visibility

Read-only collectors snapshot your live infra so AI agents see what's actually running, not stale code:

• PM2 process state, nginx config, Docker containers
• Git working-tree drift across multiple repos, port-conflict detection
• Crontab, redacted .env, composer, systemd, shell history
• Cross-project search through everything in one query

🧾 Tamper-evident audit log

Hash-chained JSONL at ~/.contextengine/audit.log — compliance evidence out of the box:

• SOC2 CC7.2 (audit logging) + ISO 27001 A.12.4.1 (event logs)
• audit_verify walks the chain; mutating any record breaks verification at the mutated index
• 19 adversarial tests covering tamper / splice / forgery / corrupt-JSON-graceful-failure

🛡️ Policy-as-code git hooks

Declarative .contextengine/policy.json with four sections:

• secret_patterns (with paths glob scoping — e.g. JWT pattern only applied to docs/sessions/**)
• doc_coverage (diff-aware, replaces wall-clock staleness gates that taught their own bypass)
• deploy_verify_hosts (encodes "DEPLOY = VERIFY LIVE")
• bypass_tokens (documented escape hatches with reason + TTL — alternative to undocumented --no-verify)
• Pre-commit hook now layers gitleaks (~150 patterns) + scoped policy patterns + 17 inline CE patterns
• contextengine hook secret-scan / hook doc-coverage CLI for CI use

Plus

• 🪝 Native Claude Code integration: install-skill adds an opscontext skill to ~/.claude/skills/; sync-claude-md maintains a managed block in CLAUDE.md so the latest snapshot reaches the agent at every session start with zero MCP calls; auto-discovery of ~/.claude/projects/*/memory/ brings Claude's own auto-memory into search results.
• 🔐 Ed25519-signed PRO licenses: server now signs license payloads with Ed25519. Client verifies with the embedded public key. Closes a real revenue leak (the old "signature" was a recomputable hash never verified). Backward compatible — legacy SHA-256 licenses grandfathered until 2026-08-15.
• 📦 @huggingface/transformers moved to optionalDependencies: cold install drops from 547 MB to 120 MB. BM25 keyword search ships always; semantic re-ranking is opt-in.
• 📤 export-learnings --project X: cross-client confidentiality for consultants.
• 🧹 101 → 122 kB tarball despite three new substantive modules (audit, policy, hooks). Sourcemaps + obfuscation theater + dead artifacts removed.

What's NOT changed

• Storage paths (~/.contextengine/), repo policy path (.contextengine/policy.json), env vars (CONTEXTENGINE_HOME), config name (contextengine.json), TypeScript code identifiers — all preserved so existing users lose nothing.
• Bin aliases: opscontext (primary) + opscontext-mcp + contextengine + contextengine-mcp (back-compat).

Stats

• 20 MCP tools, 21 CLI subcommands
• 182 / 182 tests passing
• Build clean, server side also clean
• 1,000+ accumulated learnings preserved

Full changelog

See CHANGELOG.md.

Session arc

The complete story of the pivot + ship is in docs/sessions/SESSION_05_2026-06-11.md, including the production path bug caught and fixed during the Ed25519 deploy.

---

Built by FASTPROD (PROD LLC). BSL-1.1 license — see LICENSE.

v1.22.1 — A-to-Z Audit + Session Save Timer

What's New

A-to-Z Audit — 12 Bugs Fixed (v1.22.0)

• generateMcpJson() broken args — node -y is invalid (-y is npx flag). Fixed to use npx.
• McpServer version hardcoded — now reads package.json at startup.
• list_sources version hardcoded — now uses dynamic version.
• activeProjectNames never set in main() — learnings leaked cross-project. Fixed.
• estimateTimeSaved() always ~6min — nudge + auto-injection inflation removed.
• delete_learning not registered as MCP tool — now tool #18.
• firewall.setProjectDirs() skipped when collectOps=false. Fixed.
• autoImportFromSources() missing from main() — now runs on startup.
• Redundant loadProjectDirs() calls — deduplicated.
• Dead accepted variable in ingest.ts — removed.
• SKILL.md tool count 15→18, added missing tools.
• License inconsistency — AGPL→BSL-1.1 in SKILL.md and CLAUDE.md.

10-Minute Session Save Timer (v1.22.1)

• After 10 minutes without save_session, the firewall injects an urgent 🚨 block into every MCP tool response demanding:
  1. Save session (save_session)
  2. Commit all changes
  3. Push to all remotes
• Overrides escalation to at least header level when overdue.
• sessionOverdue exposed in getState() for VS Code extension.
• 5 new tests (81 total, was 76).

Stats

• 18 MCP tools (14 free + 4 gated)
• 81 vitest tests across 6 files
• ~12,800 lines of source code

npm install -g @compr/contextengine-mcp@1.22.1

v1.20.2 — Test Coverage + MCP Config Fix + Multi-Window Logs

What's New (since v1.19.1)

v1.20.2

MCP Config Fix

• .vscode/mcp.json — corrected schema: mcpServers → servers, added "type": "stdio". MCP was disconnected from Copilot Chat without this.
• Removed deprecated MCP config from workspace settings (VS Code no longer reads it there).

Multi-Window Output Logs

• outputLogger.ts — each log line now tagged with workspace name (e.g. [ContextE], [compR]). Multiple VS Code windows all write to ~/.contextengine/output.log — tags disambiguate the source.

Test Coverage

• 3 new test suites: cli.test.ts, sessions.test.ts, firewall.test.ts
• 57 tests across 6 files (was 25 tests in 3 files)
• PM2 ecosystem.config.cjs for local dev

v1.20.1

Pre-Commit Hook Blocks

• hooks/pre-commit now exits 1 (blocks commit) when CE docs are stale >4h. Agents ignore warnings — only hard gates work.

Extension v0.6.2–v0.6.7

• Terminal watcher — 9 categories, credential redaction (10 patterns), stuck-pattern detection
• Log dedup — fingerprint-based, 99% log noise reduction
• Output file logger — mirrors Output panel to ~/.contextengine/output.log for agent analysis
• Credential redaction broadened to cover WORD_API_KEY= patterns + vendor prefixes

v1.20.0

Value Meter & Session Stats

• Status bar shows recalls, saves, estimated time saved
• Live stats dashboard in info panel
• CLI stats command reads session metrics
• Stats written by Protocol Firewall to ~/.contextengine/session-stats.json

Stats

• 57 tests passing (6 files)
• 17 MCP tools (13 free + 4 PRO)
• ~12,800 lines of source code
• Score: 95% A+
• npm: 1,233 weekly downloads

Install

npx @compr/contextengine-mcp

v1.19.1 — Quality Gates + Protocol Firewall

What's New

Learning Quality Gates (v1.19.1)

• Minimum rule length (15 chars) — rejects junk like "Fix", "PHP", "UI" with actionable error message
• Auto-categorization — "other" category auto-inferred from 30+ keyword mappings
• Import quality filter — markdown/JSON importers skip short headings and single-word rules
• Store cleaned — 1,626 to 942 quality learnings (557 junk purged, 190 reclassified)

Protocol Firewall (v1.19.0)

• Progressive enforcement — escalating compliance on all 17 tool responses
• Obligation tracking — monitors learnings saved, sessions, git status, doc freshness
• Escalation levels — silent, footer, header, degraded output
• Replaces old nudge system (only 2/17 tools, zero consequences)

Auto-Import Learnings (v1.19.0)

• Automatically extracts rules from discovered markdown sources during reindex
• Called on MCP startup + end-session — no manual import needed
• Deduplication built-in

Delta Module Obfuscation

• terser mangle + compress on PRO delta modules
• 46-72% size reduction, stripped comments

Other

• Credentials extracted from committed docs to gitignored .copilot-credentials.md
• VS Code Extension v0.5.0 — redesigned info panel with Protocol Firewall explainer

Stats

• 942 quality learnings across 21 projects
• 17 MCP tools (13 free + 4 PRO)
• 25 tests passing
• Zero API keys, 100% local
• ~260 npm downloads/day

Install

npx @compr/contextengine-mcp