The planner MCP no longer opens a local planner.db. It is now a thin client
that proxies every operation to a separate planner_server over HTTPS.
- Package
planner_remote_mcprenamed toplanner_mcp(binaryplanner-mcp); the old local SQLiteplannerpackage was removed. - Requires a planner_server URL and a service token (or an mTLS client cert):
--server-url/PLANNER_SERVER_URLand--token/PLANNER_SERVER_TOKEN, plus optional--ca-cert,--client-cert/--client-key, and--insecure. --planner-data-rootis no longer used by the planner (still used by code-index).- Issue a service token on the planner_server host:
planner_server token issue --name <label> --kind mcp.
Removed operations:
index-file— replaced byauto-indexwith layer-aware parametersshow-file— replaced byget-filewith selectable layersfile-summary— replaced byget-filewithlayers: [0, 1]
New operations:
auto-scan— walk the project tree, compare hashes, return a structured indexing plan. Supportssince(mtime pre-filter) andrebuild: true(clean rebuild).get-file— retrieve a single file's layered data (layers 0–4). Default:[0, 1, 4]. Includesneeds_reindexstale detection.get-files— batched version ofget-filefor multiple paths.usages— search external symbol usages by symbol, module, dot-path pattern, or kind.is-allowed— check whether a path is inside thecode-indexallowed paths.
Changed operations:
auto-index— now layer-aware; acceptslayers,short_summary,symbol_summaries. Computes layer 0 + 2 deterministically for Dart files viapackage:analyzer.search— now also matches against external symbol usages via FTS.
Other changes:
- Database uses clean-rebuild semantics instead of schema migrations. If the on-disk schema version differs, the DB is discarded and rebuilt.
- Added
package:analyzerdependency for deterministic Dart parsing (replaces regex-baseddart_parser.dart). - External symbol usages stored in dot-path notation (
module.source_path.symbol) for cross-reference queries. - Layered information model: metadata (0), short summary (1), symbols (2), per-symbol summaries (3), public API (4).
jhsware-code.yamlallowed-path enforcement extended to all operations. Out-of-scope paths return structuredout_of_scoperesponses.
- Initial version.