Zephex

Previous value: -"Version you are upgrading FROM — required for task=upgrade|migrate."New value: +"Version being changed from. Pass for task=upgrade|migrate|debug so release notes and advisories are version-specific."

Previous value: -"check=safe to add? upgrade|migrate=bump plan; security=CVEs; debug=advisories+detail."New value: +"One goal per call: check=safe to add; security=CVEs for version; upgrade=version bump plan; migrate=major-version migration; debug=version-specific release clues."

Previous value: -"Your installed/pinned version — required for CVE check on task=check|security."New value: +"Installed or pinned version. Pass for task=check|security so advisories are evaluated against the user's actual version."

Previous value: -"Project root — absolute path (stdio) or public GitHub URL (hosted). Required for run/detect/missing (or session_id for missing)."New value: +"Project folder. Local/stdio: omit to use the editor cwd (tests run on their machine), or pass the absolute folder. Hosted: public GitHub URL or inline_files — not a local disk path. Required for run/detect unless stdio cwd is a project. missing accepts path or session_id."

Previous value: -"Pass back from prior response (ts_*) for session tasks without re-running"New value: +"From a prior task=run (ts_*). Reuse for failures/status/list/why/fix_prompt so you do not re-run. Omit on stdio to read the last run on this machine."

Previous value: -"detect=0 credits (inventory+gaps); missing=0 credits (test gaps only); run=1 credit hosted; failures|why|status=0 credits on session_id."New value: +"run = execute the suite (stores a session). detect = see runner, do not execute. failures|status|list|coverage|fix_prompt|why = read the last session (no re-run). missing = git-diff sources without tests. Same tasks as zephex check test / check test failures."

Previous value: -"Where the project lives. Stdio MCP: absolute path to the project directory on disk. Hosted transport without local disk: use inline_files (10–50 source files + package.json)."New value: +"The user's project folder. Local/stdio: omit to use editor cwd, or pass the absolute folder. Hosted with no disk: omit and use inline_files, or a public GitHub URL."

Previous value: -"remember=save a fact, recall=keyword search, list=recent titles, forget=delete by id"New value: +"remember=save a note, recall=search notes and return full content, list=recent notes with preview, forget=delete by id"

Previous value: -"Required for remember. Max 500 chars. Paraphrase, not file dumps."New value: +"Required for remember. Up to 12000 characters (~2000 words). Write the why and the trap — not a one-liner."

Previous value: -5New value: +10

Previous value: -"recall/list cap. Default 5, max 10."New value: +"recall/list cap. Default 10, max 20."

Previous value: -"Project bucket — use the same absolute path on remember, recall, and list. Stdio: optional (defaults to editor cwd). Hosted: reuse normalized_path from the remember response."New value: +"Folder these notes belong to. Same string on remember, recall, and list. Stdio: optional (editor cwd). Hosted: reuse that folder string (or normalized_path from remember)."

Previous value: -"project=current DB, personal=~/.zephex personal, all=cross-project with warnings."New value: +"project=this folder only (default). personal=notes that apply everywhere. all=every project — only when they ask to search everything."

Previous value: -"Project folder to search. Local MCP: absolute path (/Users/jane/myapp). Hosted MCP: public GitHub URL or inline_files."New value: +"The user's project folder. Local/stdio: omit to use editor cwd, or pass the absolute folder. Hosted: public GitHub URL or inline_files."

Previous value: -"Absolute path to the project root. Stdio MCP reads manifests from disk directly. Omit on stdio when editor cwd is the project root."New value: +"The user's project folder. Local/stdio: omit to use editor cwd, or pass the absolute folder (any OS). Hosted with no disk: omit and use inline_files."

Previous value: -"Project root. Stdio MCP: absolute path to the directory on disk. Hosted transport without local disk: use inline_files instead. Pair files[] paths from find_code."New value: +"The user's project folder. Local/stdio: omit to use editor cwd, or pass the absolute folder. Hosted with no disk: use inline_files. Pair files[] from find_code."

Previous value: -"Detect source files without test files (defaults true when diff_base set)"New value: +"Git-diff scan for source files without matching tests (default true on detect and when diff_base set)"

Previous value: -"Project root: absolute directory (stdio) or github:owner/repo / GitHub URL (hosted). Required for run/detect."New value: +"Project root — absolute path (stdio) or public GitHub URL (hosted). Required for run/detect/missing (or session_id for missing)."

Previous value: -"run=execute suite (1 credit hosted); detect=dry-run; status|summary|list|failures|coverage|fix_prompt|why|compare=session cache (free); history=cloud scans (free, hosted)"New value: +"detect=0 credits (inventory+gaps); missing=0 credits (test gaps only); run=1 credit hosted; failures|why|status=0 credits on session_id."

Previous value: -[
-  "run",
-  "detect",
-  "status",
-  "summary",
-  "list",
-  "failures",
-  "coverage",
-  "fix_prompt",
-  "history",
-  "why",
-  "compare"
-]New value: +[
+  "run",
+  "detect",
+  "status",
+  "summary",
+  "list",
+  "failures",
+  "missing",
+  "coverage",
+  "fix_prompt",
+  "history",
+  "why",
+  "compare"
+]

Previous value: -"Set true when planning is done and you are about to execute. Produces minimal response."New value: +"true when done planning and about to execute edits."

Previous value: -"Subsystem label (e.g. auth, api, billing) — scopes projectBrief memory recall and context focus."New value: +"Subsystem (auth, billing, api) — scopes project_memory recall."

Previous value: -"Max 5 assumptions. Mark invalidated:true when contradicted."New value: +"Up to 5 assumptions; set invalidated:true when contradicted."

Previous value: -"One sentence restating the original task. Required after thought 2 (two-strike rule)."New value: +"One sentence restating the task — required after thought 2."

Previous value: -"Last 2-5 tool calls as 'name(arg=val)' strings. If the last two are identical, boredLoopDetected fires. Required to detect repeated reads."New value: +"Last 2–5 tool calls as name(arg=val) — identical pair triggers boredLoopDetected."

Previous value: -"Set to false when reasoning is complete. Triggers checkpoint write."New value: +"false ends session and writes checkpoint."

Previous value: -"Absolute project root. Stdio: optional (uses cwd). Used to load projectBrief."New value: +"Local project root (stdio defaults to cwd) for projectBrief."

Previous value: -"Which thought number this revises (use with thoughtType:'revision')."New value: +"Thought number this revision replaces."

Previous value: -"Cross-session memory. Provide at thought 1 to restore last checkpoint."New value: +"Resume prior session; restores checkpoint on thought 1."

Previous value: -"The actual reasoning content (20–2000 chars). Be specific — include file names, function names, error messages."New value: +"Reasoning (20–2000 chars) — file names, symbols, error messages."

Previous value: -"Which thought this is, 1-based"New value: +"1-based thought index in this session."

Previous value: -"Controls compression. hypothesis/conclusion kept verbatim. observation/debug masked when old. plan/revision truncated when old."New value: +"hypothesis|debug for investigation; plan|conclusion before acting."

Previous value: -"Classify last tool result. 3+ noise/error in last 5 triggers loop detection."New value: +"Classify last tool result — 3+ noise/error in last 5 triggers loop."

Previous value: -"Estimated total thoughts needed (revise upward if genuinely needed)"New value: +"Estimated thoughts needed (revise upward if needed)."

Previous value: -"Optional filter for 'search'. Narrows results to one domain."New value: +"Optional search filter — payments, auth, security, databases, etc."

Previous value: -"Use 'search' to find the right entry by query. Use 'get' to fetch full expert knowledge by slug. Always search first, then get."New value: +"search=find by query (first step); get=full entry by slug from search."

Previous value: -"Required for 'search'. Natural language question."New value: +"Required for search — e.g. 'Supabase RLS for multi-tenant' or 'Next.js middleware auth'."

Previous value: -"Required for 'get'. Exact slug from a previous search result."New value: +"Required for get — exact slug from a search hit."

Previous value: -"The https:// URL to audit (public endpoints only)"New value: +"Public https:// URL to audit — e.g. https://myapp.vercel.app or https://zephex.dev"

Previous value: -"Registry to query (default: npm, auto-detected from package name when possible)"New value: +"Registry (default npm, auto-detected). Omit for next/stripe/prisma."

Previous value: -"Version upgrading FROM for task=upgrade|migrate — required unless source:github:owner/repo resolves it from package.json."New value: +"Version you are upgrading FROM — required for task=upgrade|migrate."

Previous value: -"Registry package name: stripe, next, prisma, django, tokio, @supabase/supabase-js, androidx.compose.ui:ui (Maven group:artifact)."New value: +"Package name on the public registry — e.g. next, stripe, prisma, express, @supabase/supabase-js."

Previous value: -"Where to read your pinned version: github:owner/repo (hosted MCP — fetches package.json from GitHub API) or local (stdio only, reads disk). Example: github:vercel/next.js"New value: +"Optional. local = read pinned version from disk (stdio only). Prefer passing version/from_version directly."

Previous value: -"Slice selector (each returns different data): check=exists/slopsquat/CVE gate; upgrade|migrate=GitHub release breaking_changes+migration_steps; security=CVEs only; debug=advisories+code_example."New value: +"check=safe to add? upgrade|migrate=bump plan; security=CVEs; debug=advisories+detail."

Previous value: -"Installed/pinned version for task=check — scopes your_version_affected. Omit when using source:github:owner/repo."New value: +"Your installed/pinned version — required for CVE check on task=check|security."

Previous value: -"Where the project lives. Local absolute directory (e.g. /Users/alice/myapp on macOS, /home/alice/myapp on Linux, C:/Users/alice/myapp on Windows, /mnt/c/Users/alice/myapp on WSL) OR a GitHub / GitLab / Bitbucket URL (https://github.com/owner/repo or short-form github:owner/repo). Private repos require GITHUB_PAT on the server."New value: +"Where the project lives. Stdio MCP: absolute path to the project directory on disk. Hosted transport without local disk: use inline_files (10–50 source files + package.json)."

Previous value: -"Project root. Local MCP: absolute path. Hosted MCP: public GitHub/GitLab URL. Pair with files[] from find_code."New value: +"Project root. Stdio MCP: absolute path to the directory on disk. Hosted transport without local disk: use inline_files instead. Pair files[] paths from find_code."

Previous value: -"Where the project lives. Accepts BOTH: • Local absolute path: /Users/alice/myapp, C:/Users/alice/myapp, /mnt/c/Users/alice/myapp. Local stdio install reads files directly. • GitHub/GitLab/Bitbucket URL: https://github.com/owner/repo (or short-form github:owner/repo). Hosted server fetches and analyses the repo (private GitHub repos work when the server has GITHUB_PAT or the user has linked GitHub). Use a remote URL whenever the user pastes a GitHub link or refers to their repo by name."New value: +"Absolute path to the project root. Stdio MCP reads manifests from disk directly. Omit on stdio when editor cwd is the project root."

Previous value: -"Named slice (each returns different data): identity | framework | backend | frontend | database | auth | deploy | run | structure | integrations | security. Local path or github:owner/repo — same topics. Call identity first; backend vs frontend vs auth return different summaries and key_paths."New value: +"Which slice to return (one per call). identity=project name/type + which topics apply; run=dev/test/build/lint commands; framework=language/runtime/package manager; backend=API routes and server entry points; frontend=UI framework and pages; database=ORM and providers; auth=login/session providers; deploy=hosting and CI; structure=monorepo layout; integrations=Stripe/Sentry/etc.; security=env and auth surface."

Previous value: -"remember=save, recall=FTS5 search, list=titles, forget=delete by id"New value: +"remember=save a fact, recall=keyword search, list=recent titles, forget=delete by id"

Previous value: -"Subsystem label for scoped recall. Max 64 chars."New value: +"Subsystem label (auth, billing, deploy) — included in search index for scoped recall. Max 64 chars."

Previous value: -"Absolute project root. Stdio: optional (uses cwd)."New value: +"Project bucket — use the same absolute path on remember, recall, and list. Stdio: optional (defaults to editor cwd). Hosted: reuse normalized_path from the remember response."

Previous value: -"Required for recall. FTS5 keywords."New value: +"Required for recall. Short keywords from the title or topic (e.g. auth middleware stripe)."

Previous value: -"Required for remember."New value: +"Required for remember. decision=chose an approach; gotcha=non-obvious bug; goal=what we are building toward; preference=user style; area_fact=fact about a subsystem; convention=naming or process rule."

Added value: +{
+  "additionalProperties": {
+    "type": "string"
+  },
+  "description": "Hosted fallback when github is unavailable: { \"package.json\": \"...\", \"src/foo.test.ts\": \"...\" }. Supports task detect and task run (temp dir on Railway). Include package.json with scripts.test.",
+  "type": "object"
+}

Added value: +{
+  "description": "Subsystem label (e.g. auth, api, billing) — scopes projectBrief memory recall and context focus.",
+  "type": "string"
+}

Added value: +{
+  "description": "Absolute project root. Stdio: optional (uses cwd). Used to load projectBrief.",
+  "type": "string"
+}