mempalace-code 1.13.6__tar.gz → 1.13.8__tar.gz

{mempalace_code-1.13.6 → mempalace_code-1.13.8}/CHANGELOG.md

@@ -2,6 +2,57 @@
 
 ## Unreleased
 
+## v1.13.8 — 2026-09-02
+
+Recovery release for the accumulated v1.13.7 changes. The immutable v1.13.7
+tag stopped before artifact build when the pinned upstream head moved, so no
+v1.13.7 package or GitHub Release exists.
+
+### Fixed
+
+- Temporal KG queries now classify bounded, expired, and future facts against
+  their full validity windows; statistics reconcile current, expired, and
+  future facts. Omitted invalidation bounds retire facts at the current UTC
+  instant while explicit date-only bounds remain inclusive through that day.
+- Invalid KG directions return bounded argument errors, including JSON-RPC
+  `-32602` through MCP.
+- A decoded non-object JSON-RPC envelope returns `-32600` without terminating
+  the stdio server, so the next valid request is still served.
+- Concurrent first-open KG initialization now retries a short bounded
+  `SQLITE_BUSY` window instead of repeating the WAL transition immediately.
+
+### Changed
+
+- Refreshed the reviewed upstream snapshot through `d9f05907`. Its optional
+  three-tool PQL facade, temporal response buckets, and logstream coordination
+  remain outside this fork because the existing typed MCP profiles already own
+  the supported surface.
+- Added the failed v1.13.7 tag to the immutable orphan-tag evidence registry.
+- The installed-wheel release gate now exercises temporal KG classification,
+  invalid direction recovery, malformed-envelope recovery, and the existing
+  concurrent-watcher KG path through the built applications.
+
+## v1.13.7 — 2026-09-02 (tagged, not published)
+
+The tag remains immutable public evidence. Publication stopped before artifact
+build because the reviewed upstream head changed; these changes ship in v1.13.8.
+
+### Fixed
+
+- Canonical FastEmbed mining now applies the existing 256-token contract to
+  batch padding, preventing mixed-length inputs from failing with an
+  `inhomogeneous shape` error.
+- The pinned .NET retrieval benchmark now participates in the existing
+  `release-required` aggregate, so a red or missing benchmark blocks the exact
+  release candidate.
+- Backup retention now treats a backup removed concurrently by another process
+  as an idempotent success while still reporting other filesystem failures.
+- Watcher startup now reports whether post-mine optimization was refused by a
+  safety check or failed with an error, with a direct health-check recovery step.
+- Concurrent watchers can initialize one fresh palace safely: Lance table
+  creation is idempotent, and SQLite knowledge-graph WAL setup retries one
+  initial busy collision without hiding unrelated failures.
+
 ## v1.13.6 — 2026-09-01
 
 ### Fixed

{mempalace_code-1.13.6 → mempalace_code-1.13.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: mempalace-code
-Version: 1.13.6
+Version: 1.13.8
 Summary: Developer memory tool — mine codebases and conversations into a LanceDB-backed searchable palace. No API key required.
 Project-URL: Homepage, https://github.com/rergards/mempalace-code
 Project-URL: Repository, https://github.com/rergards/mempalace-code
@@ -1275,7 +1275,7 @@ python -m pyright --pythonpath "$(python -c 'import sys; print(sys.executable)')
 Apache 2.0 — see [LICENSE](LICENSE) and [NOTICE](NOTICE).
 
 <!-- Link Definitions -->
-[version-shield]: https://img.shields.io/badge/version-1.13.6-4dc9f6?style=flat-square&labelColor=0a0e14
+[version-shield]: https://img.shields.io/badge/version-1.13.8-4dc9f6?style=flat-square&labelColor=0a0e14
 [release-link]: https://github.com/rergards/mempalace-code/releases
 [python-shield]: https://img.shields.io/badge/python-3.11+-7dd8f8?style=flat-square&labelColor=0a0e14&logo=python&logoColor=7dd8f8
 [python-link]: https://www.python.org/

{mempalace_code-1.13.6 → mempalace_code-1.13.8}/README.md

@@ -1216,7 +1216,7 @@ python -m pyright --pythonpath "$(python -c 'import sys; print(sys.executable)')
 Apache 2.0 — see [LICENSE](LICENSE) and [NOTICE](NOTICE).
 
 <!-- Link Definitions -->
-[version-shield]: https://img.shields.io/badge/version-1.13.6-4dc9f6?style=flat-square&labelColor=0a0e14
+[version-shield]: https://img.shields.io/badge/version-1.13.8-4dc9f6?style=flat-square&labelColor=0a0e14
 [release-link]: https://github.com/rergards/mempalace-code/releases
 [python-shield]: https://img.shields.io/badge/python-3.11+-7dd8f8?style=flat-square&labelColor=0a0e14&logo=python&logoColor=7dd8f8
 [python-link]: https://www.python.org/

{mempalace_code-1.13.6 → mempalace_code-1.13.8}/benchmarks/README.md

@@ -227,21 +227,25 @@ HF_HUB_OFFLINE=1 TRANSFORMERS_OFFLINE=1 python benchmarks/dotnet_bench.py \
 
 ### CI Gate
 
-The workflow `.github/workflows/dotnet-bench.yml` runs on every pull request to
-`main` and every push to `main`. It:
+The `dotnet-bench` job in `.github/workflows/ci.yml` runs for every `Tests`
+workflow event. Pull requests to `main` and pushes to `main` or `release/v*` can
+provide release evidence; `workflow_dispatch` is diagnostic only and cannot
+satisfy release admission. The job:
 
 1. Fetches `jasontaylordev/CleanArchitecture` at the pinned commit
    `5a600ab8749c110384bc3bd436b9c67f3067b489` and verifies `HEAD` matches.
 2. Runs `--validate-queries` to confirm expected files are present in the corpus.
 3. Runs the benchmark with `--fail-under-r5 0.900`; exits 1 when overall R@5
    falls below 0.900.
-4. Uploads `benchmarks/results_dotnet_bench_ci.json` as a build artifact, even
-   on failure, so the report is always available.
-
-To skip the benchmark on a pull request (e.g. for documentation-only changes),
-add the **`skip-bench`** label. The job is skipped before cloning
-CleanArchitecture or downloading the embedding model. Pushes to `main` always
-run the benchmark regardless of labels.
+4. Uploads `benchmarks/results_dotnet_bench_ci.json` as the
+   `dotnet-bench-results` artifact even on failure.
+5. Feeds the existing `release-required` aggregate. A failed, skipped, or missing
+   benchmark blocks release admission.
+
+The job has no skip label. If it fails, inspect `dotnet-bench-results`, then run
+the reproduction command above against the pinned commit. Recover by rerunning
+the failed push or pull-request `Tests` run for the same candidate SHA; never
+dispatch a new run as release evidence.
 
 ## What Each Benchmark Tests
 

{mempalace_code-1.13.6 → mempalace_code-1.13.8}/docs/BACKUP_RESTORE.md

@@ -381,8 +381,14 @@ The watcher emits grep-friendly `WATCH_RUN` lines at each startup transition so
 | `WATCH_RUN run_id=<id> state=initial-mine-completed` | Initial mine finished successfully |
 | `WATCH_RUN run_id=<id> state=initial-mine-skipped reason=disk-budget` | Mine skipped because disk budget is too low |
 | `WATCH_RUN run_id=<id> state=optimize-completed` | Post-mine optimize pass succeeded |
-| `WATCH_RUN run_id=<id> state=optimize-skipped reason=backup-gate` | Optimize skipped (backup gate rejected) |
-| `WATCH_RUN run_id=<id> state=watch-ready` | All startup gates passed; daemon entered the watch loop |
+| `WATCH_RUN run_id=<id> state=optimize-skipped reason=safety-check` | Safe optimize refused or failed; see the preceding storage log for the precise cause |
+| `WATCH_RUN run_id=<id> state=optimize-skipped reason=error` | Optimize raised an unexpected error; the preceding optimize line contains the cause |
+| `WATCH_RUN run_id=<id> state=watch-ready` | Daemon entered the watch loop; inspect earlier markers for startup work that was skipped |
+
+For either `optimize-skipped` reason, the initial mine completed but optimization did not.
+The watcher continues. Inspect the preceding optimize output, then run
+`mempalace-code --palace /path/palace health`; if it recurs, resolve that reported storage
+error before restarting.
 
 The `run_id` is unique per startup attempt. An appended log file may contain `WATCH_RUN` lines from older runs that exited with disk-budget or backup failures. To find the latest healthy startup, locate the last `state=watch-ready` line and use its `run_id` to filter the associated transitions:
 

{mempalace_code-1.13.6 → mempalace_code-1.13.8}/docs/LLM_USAGE_RULES.md

@@ -107,7 +107,7 @@ For large monorepos, prefer the highest-ROI initialized subdirectory first when
 ## Existing memory systems
 
 If the repo already has curated memory docs (`MEMORY.md`, project notes, hand-written summaries), do not mirror them wholesale into drawers. Use stores by job:
-- KG = volatile current facts that need exact lookup or history.
+- KG = temporal facts that need exact lookup, current-state filtering, or history.
 - Drawers = verbatim source material, decisions, root causes, and discussion excerpts.
 - Diary = this agent's own continuity notes.
 - Curated docs = compressed narrative, rationale, and human-maintained summaries.
@@ -118,7 +118,16 @@ Do not turn a carefully compressed memory file into drawer content unless the hu
 
 Use the KG for facts that **change over time** or need **exact-match lookup** — version numbers, stack choices, ownership, statuses, deadlines.
 
-Update protocol: `mempalace_kg_query` → `mempalace_kg_invalidate` (old triple, today's date) → `mempalace_kg_add` (new triple, validity window). Never leave two live triples for the same `(subject, predicate)`.
+`mempalace_kg_query` without `as_of` returns historical, current, and future
+facts with an explicit `current` output field. For present state, filter the
+returned facts where `current` is `true`; never send `current` as an input
+argument. Pass `as_of` when the question names another date.
+
+Update protocol: `mempalace_kg_query` → select the intended returned triple
+whose `current` field is `true` → `mempalace_kg_invalidate` (omit `ended` to
+retire it now; pass a date for an inclusive end-of-day bound) →
+`mempalace_kg_add` (new triple, validity window). Never leave two current
+triples for the same `(subject, predicate)`.
 
 Bad for KG: code patterns, debugging notes, prose — those belong in a drawer.
 
@@ -265,7 +274,7 @@ Active tools: `mempalace_status`, `mempalace_search`, `mempalace_check_duplicate
 | Semantic search | `mempalace_search` |
 | Duplicate check before filing | `mempalace_check_duplicate` |
 | Save a decision or note | `mempalace_add_drawer` |
-| Query an entity's current facts | `mempalace_kg_query` |
+| Query an entity's temporal facts; filter returned facts by the `current` output field for present state | `mempalace_kg_query` |
 | Add a temporal fact | `mempalace_kg_add` |
 | Retire an outdated fact | `mempalace_kg_invalidate` |
 | See how facts changed over time | `mempalace_kg_timeline` |

{mempalace_code-1.13.6 → mempalace_code-1.13.8}/docs/RELEASING.md

@@ -50,7 +50,7 @@ python scripts/docs_drift_guard.py
 python scripts/public_safety_scan.py --tracked --staged
 python scripts/quality_scorecard.py --check
 python scripts/release_preflight.py --tag vX.Y.Z --require-clean
-python scripts/release_preflight.py --tag vX.Y.Z --require-clean --expect-sha <40-hex-candidate-sha> --check-public-main --check-required-check --check-dependency-audit --check-branch-rules --check-tag-ruleset
+python scripts/release_preflight.py --tag vX.Y.Z --require-clean --expect-sha <40-hex-candidate-sha> --check-public-main --check-required-check --check-dependency-audit --check-branch-rules --check-tag-ruleset --check-public-orphan-tags
 python scripts/release_install_metadata_smoke.py --all-installers --install-spec . --json
 WHEEL=dist/mempalace_code-X.Y.Z-py3-none-any.whl
 python scripts/release_readiness_gate.py --installed-golden-wheel "$WHEEL" --json
@@ -165,7 +165,7 @@ The exact-SHA release admission command is the publication boundary after the
 operator has reviewed the candidate commit and fetched the public target:
 
 ```bash
-python scripts/release_preflight.py --tag vX.Y.Z --require-clean --expect-sha <40-hex-candidate-sha> --candidate-ref publish/main --check-required-check --check-dependency-audit --check-branch-rules --check-tag-ruleset
+python scripts/release_preflight.py --tag vX.Y.Z --require-clean --expect-sha <40-hex-candidate-sha> --candidate-ref publish/main --check-required-check --check-dependency-audit --check-branch-rules --check-tag-ruleset --check-public-orphan-tags
 ```
 
 This command binds `HEAD`, the intended `vX.Y.Z` tag target, the
@@ -320,7 +320,7 @@ owner:
 
 ```bash
 test "$(git rev-parse HEAD)" = "$CANDIDATE_SHA"
-python scripts/release_preflight.py --require-clean --expect-sha "$CANDIDATE_SHA" --check-required-check --check-dependency-audit --check-branch-rules --check-tag-ruleset
+python scripts/release_preflight.py --require-clean --expect-sha "$CANDIDATE_SHA" --check-required-check --check-dependency-audit --check-branch-rules --check-tag-ruleset --check-public-orphan-tags
 ```
 
 A non-zero exit means the release is not admissible. Fix the reported row and
@@ -356,7 +356,7 @@ Public `main` has moved, so re-run exact-SHA admission — this time bound to
 `publish/main` — before any tag exists:
 
 ```bash
-python scripts/release_preflight.py --tag vX.Y.Z --require-clean --expect-sha <40-hex-candidate-sha> --candidate-ref publish/main --check-required-check --check-dependency-audit --check-branch-rules --check-tag-ruleset
+python scripts/release_preflight.py --tag vX.Y.Z --require-clean --expect-sha <40-hex-candidate-sha> --candidate-ref publish/main --check-required-check --check-dependency-audit --check-branch-rules --check-tag-ruleset --check-public-orphan-tags
 ```
 
 A non-zero exit means the release is not admissible. Fix the reported row; do

{mempalace_code-1.13.6 → mempalace_code-1.13.8}/docs/UPSTREAM_COMPARISON.md

@@ -14,14 +14,14 @@ document, and the README pointer consistent.
 
 | Field | Value |
 |---|---|
-| Reviewed date | `2026-08-31` |
+| Reviewed date | `2026-09-02` |
 | Canonical upstream repository | <https://github.com/MemPalace/mempalace> |
 | Branch reviewed | `develop` |
-| Commit reviewed | `e8098348ddfce59964fe536e5deffb81da579e6b` |
-| Previous reviewed commit | `a9f345cc63254eb4dea7abad36963b85c9f8453a` |
-| Previous reviewed date | `2026-08-29` |
+| Commit reviewed | `d9f059076c866fa6f29195679d75712436986024` |
+| Previous reviewed commit | `e8098348ddfce59964fe536e5deffb81da579e6b` |
+| Previous reviewed date | `2026-08-31` |
 | Upstream release described by its changelog | `3.9.0` |
-| Upstream paths tracked for drift | `README.md`, `CHANGELOG.md`, `pyproject.toml`, plugin/MCP metadata, update awareness, hub, logstream, MCP, search, embedding, Qdrant, benchmark, configuration, split-file, and RFC 003–005 sources |
+| Upstream paths tracked for drift | `README.md`, `CHANGELOG.md`, `pyproject.toml`, plugin/MCP metadata, update awareness, hub, logstream, MCP, lightweight MCP/PQL, KG, CLI, search, embedding, Qdrant, benchmark, coordination, configuration, split-file, and RFC 003–005 sources |
 | Fork commit at review time | this repository, `main` |
 
 All upstream statements below are limited to the pinned public sources. Upstream
@@ -32,90 +32,66 @@ or independently compatibility-tested.
 
 Pinned primary upstream sources, all at the reviewed commit:
 
-- <https://github.com/MemPalace/mempalace/tree/e8098348ddfce59964fe536e5deffb81da579e6b>
-- <https://github.com/MemPalace/mempalace/blob/e8098348ddfce59964fe536e5deffb81da579e6b/README.md>
-- <https://github.com/MemPalace/mempalace/blob/e8098348ddfce59964fe536e5deffb81da579e6b/CHANGELOG.md>
-- <https://github.com/MemPalace/mempalace/blob/e8098348ddfce59964fe536e5deffb81da579e6b/pyproject.toml>
-- <https://github.com/MemPalace/mempalace/blob/e8098348ddfce59964fe536e5deffb81da579e6b/.codex-plugin/plugin.json>
-- <https://github.com/MemPalace/mempalace/blob/e8098348ddfce59964fe536e5deffb81da579e6b/.claude-plugin/plugin.json>
-- <https://github.com/MemPalace/mempalace/blob/e8098348ddfce59964fe536e5deffb81da579e6b/.agents/plugins/marketplace.json>
-- <https://github.com/MemPalace/mempalace/blob/e8098348ddfce59964fe536e5deffb81da579e6b/.mcp.json>
-- <https://github.com/MemPalace/mempalace/blob/e8098348ddfce59964fe536e5deffb81da579e6b/mempalace/config.py>
-- <https://github.com/MemPalace/mempalace/blob/e8098348ddfce59964fe536e5deffb81da579e6b/mempalace/split_mega_files.py>
-- <https://github.com/MemPalace/mempalace/blob/e8098348ddfce59964fe536e5deffb81da579e6b/mempalace/update_awareness.py>
-- <https://github.com/MemPalace/mempalace/blob/e8098348ddfce59964fe536e5deffb81da579e6b/mempalace/hub_client.py>
-- <https://github.com/MemPalace/mempalace/blob/e8098348ddfce59964fe536e5deffb81da579e6b/mempalace/logstream.py>
-- <https://github.com/MemPalace/mempalace/blob/e8098348ddfce59964fe536e5deffb81da579e6b/mempalace/mcp_server.py>
-- <https://github.com/MemPalace/mempalace/blob/e8098348ddfce59964fe536e5deffb81da579e6b/mempalace/searcher.py>
-- <https://github.com/MemPalace/mempalace/blob/e8098348ddfce59964fe536e5deffb81da579e6b/mempalace/embedding.py>
-- <https://github.com/MemPalace/mempalace/blob/e8098348ddfce59964fe536e5deffb81da579e6b/mempalace/backends/qdrant.py>
-- <https://github.com/MemPalace/mempalace/blob/e8098348ddfce59964fe536e5deffb81da579e6b/benchmarks/PRIVATE_PALACE.md>
-- <https://github.com/MemPalace/mempalace/blob/e8098348ddfce59964fe536e5deffb81da579e6b/docs/rfcs/003-agent-logstream-coordination.md>
-- <https://github.com/MemPalace/mempalace/blob/e8098348ddfce59964fe536e5deffb81da579e6b/docs/rfcs/004-replicated-palace.md>
-- <https://github.com/MemPalace/mempalace/blob/e8098348ddfce59964fe536e5deffb81da579e6b/docs/rfcs/005-agent-identity-routing.md>
+- <https://github.com/MemPalace/mempalace/tree/d9f059076c866fa6f29195679d75712436986024>
+- <https://github.com/MemPalace/mempalace/blob/d9f059076c866fa6f29195679d75712436986024/README.md>
+- <https://github.com/MemPalace/mempalace/blob/d9f059076c866fa6f29195679d75712436986024/CHANGELOG.md>
+- <https://github.com/MemPalace/mempalace/blob/d9f059076c866fa6f29195679d75712436986024/pyproject.toml>
+- <https://github.com/MemPalace/mempalace/blob/d9f059076c866fa6f29195679d75712436986024/.codex-plugin/plugin.json>
+- <https://github.com/MemPalace/mempalace/blob/d9f059076c866fa6f29195679d75712436986024/.claude-plugin/plugin.json>
+- <https://github.com/MemPalace/mempalace/blob/d9f059076c866fa6f29195679d75712436986024/.agents/plugins/marketplace.json>
+- <https://github.com/MemPalace/mempalace/blob/d9f059076c866fa6f29195679d75712436986024/.mcp.json>
+- <https://github.com/MemPalace/mempalace/blob/d9f059076c866fa6f29195679d75712436986024/mempalace/config.py>
+- <https://github.com/MemPalace/mempalace/blob/d9f059076c866fa6f29195679d75712436986024/mempalace/split_mega_files.py>
+- <https://github.com/MemPalace/mempalace/blob/d9f059076c866fa6f29195679d75712436986024/mempalace/update_awareness.py>
+- <https://github.com/MemPalace/mempalace/blob/d9f059076c866fa6f29195679d75712436986024/mempalace/hub_client.py>
+- <https://github.com/MemPalace/mempalace/blob/d9f059076c866fa6f29195679d75712436986024/mempalace/logstream.py>
+- <https://github.com/MemPalace/mempalace/blob/d9f059076c866fa6f29195679d75712436986024/mempalace/mcp_server.py>
+- <https://github.com/MemPalace/mempalace/blob/d9f059076c866fa6f29195679d75712436986024/mempalace/searcher.py>
+- <https://github.com/MemPalace/mempalace/blob/d9f059076c866fa6f29195679d75712436986024/mempalace/embedding.py>
+- <https://github.com/MemPalace/mempalace/blob/d9f059076c866fa6f29195679d75712436986024/mempalace/backends/qdrant.py>
+- <https://github.com/MemPalace/mempalace/blob/d9f059076c866fa6f29195679d75712436986024/benchmarks/PRIVATE_PALACE.md>
+- <https://github.com/MemPalace/mempalace/blob/d9f059076c866fa6f29195679d75712436986024/docs/rfcs/003-agent-logstream-coordination.md>
+- <https://github.com/MemPalace/mempalace/blob/d9f059076c866fa6f29195679d75712436986024/docs/rfcs/004-replicated-palace.md>
+- <https://github.com/MemPalace/mempalace/blob/d9f059076c866fa6f29195679d75712436986024/docs/rfcs/005-agent-identity-routing.md>
+- <https://github.com/MemPalace/mempalace/blob/d9f059076c866fa6f29195679d75712436986024/integrations/shared/coordination-protocol.md>
+- <https://github.com/MemPalace/mempalace/blob/d9f059076c866fa6f29195679d75712436986024/mempalace/cli.py>
+- <https://github.com/MemPalace/mempalace/blob/d9f059076c866fa6f29195679d75712436986024/mempalace/knowledge_graph.py>
+- <https://github.com/MemPalace/mempalace/blob/d9f059076c866fa6f29195679d75712436986024/mempalace/mcp_light_server.py>
+- <https://github.com/MemPalace/mempalace/blob/d9f059076c866fa6f29195679d75712436986024/mempalace/query_parser.py>
+- <https://github.com/MemPalace/mempalace/blob/d9f059076c866fa6f29195679d75712436986024/website/guide/lightweight-mcp.md>
 
 The exact public range between the previous pin and this one is:
 
-- <https://github.com/MemPalace/mempalace/compare/a9f345cc63254eb4dea7abad36963b85c9f8453a...e8098348ddfce59964fe536e5deffb81da579e6b>
+- <https://github.com/MemPalace/mempalace/compare/e8098348ddfce59964fe536e5deffb81da579e6b...d9f059076c866fa6f29195679d75712436986024>
 
 ## Upstream Delta Since the Previous Pin
 
-The compare range contains 47 commits. Each commit is owned exactly once by one
-of the 12 first-parent merge groups below. Each group has one stance from the
+The compare range contains 10 commits. Each commit is owned exactly once by the
+single first-parent merge group below. The group has one stance from the
 closed set `adopted`, `equivalent-local`, `migration-only`, `deferred`, or
 `irrelevant`.
 
 | Delta decision | Upstream change, as its sources describe it | Stance | Release-critical | Merge group |
 |---|---|---|---|---|
-| `opt-in-release-awareness` | Disabled-by-default stable-release checks, cached agent status, and installer-specific upgrade plans | `equivalent-local` | yes | `dae19f61` |
-| `release-history-sync` | Develop imports the 3.7.1 and 3.8.0 main release merge ancestry | `irrelevant` | no | `45ee7608` |
-| `logstream-topic-reverse-pagination` | Logstream topic routing plus status, before-event, and ordering filters | `irrelevant` | no | `c524d11a` |
-| `ruff-precommit-pin` | Upstream pre-commit Ruff pin alignment | `irrelevant` | no | `b54f64cd` |
-| `docker-login-action-update` | Upstream image workflow raises docker/login-action to 4.6.0 | `irrelevant` | no | `6242edfb` |
-| `qdrant-bounded-get-scroll` | Qdrant bounds safe paged `get()` scrolling by offset plus limit | `irrelevant` | no | `49737d50` |
-| `concurrent-hub-palace-reads` | HTTP MCP palace reads use a shared lock while writes remain exclusive | `irrelevant` | no | `da245c6c` |
-| `closet-search-source-index` | Closet search indexes source lookups and reports raw vector similarity | `irrelevant` | no | `6597908a` |
-| `private-palace-search-benchmark` | A private-palace search benchmark harness and operator procedure | `irrelevant` | no | `b0b10aa8` |
-| `embeddinggemma-batch-size-override` | EmbeddingGemma sub-batch size becomes configurable | `irrelevant` | no | `dc43751c` |
-| `live-hub-cli-search-forwarding` | CLI search reuses a compatible live hub with configuration, output, and token guards | `irrelevant` | no | `307a6765` |
-| `release-3-9-0-metadata` | Package, plugin, integration, badge, lockfile, and changelog sources move to 3.9.0 | `irrelevant` | no | `e8098348` |
-
-The manifest records the exact 47-commit full-range inventory for
-`a9f345cc..e8098348`: 12 top-level merge commits, four nested merge commits,
-and a 31-commit non-merge constituent subset. Its SHA-256 anchor is
-`4ee827c643113410c17140162f4650930586a5b4ea92d28ca720b2ec6cd648df`.
+| `lightweight-mcp-pql` | Optional three-tool MCP facade with PQL/structured inputs, KG temporal buckets, and on-demand logstream coordination guidance | `irrelevant` | no | `d9f05907` |
+
+The manifest records the exact 10-commit full-range inventory for
+`e8098348..d9f05907`: one top-level merge commit, zero nested merge commits,
+and a nine-commit non-merge constituent subset. Its SHA-256 anchor is
+`127aa2ccb94b5e549c305a9cc4317ba4a2f6c0488b5db1707ead7e8cb4a5d24c`.
 Grouped by the top-level merge commits:
 
-- `dae19f61`: `c83f1ebc`, `8baf1df4`
-- `45ee7608`: `359c579d` (nested merge), `87e6f383` (nested merge), `98a0f824` (nested merge)
-- `c524d11a`: `148bc6f2`
-- `b54f64cd`: `59ce3588`
-- `6242edfb`: `238b5ce9`
-- `49737d50`: `720f3d81`
-- `da245c6c`: `dc085859`
-- `6597908a`: `fe98bfce`
-- `b0b10aa8`: `3bf31aaa`
-- `dc43751c`: `a616a577`
-- `307a6765`: `b232fa3d`, `87ec8545`, `460924eb`, `90e8214b`, `67be3950`, `ae8a4e8c`, `fd556bee`, `e9616245`, `bd94b7f4`, `733a0c6d`, `e016aff4`, `2edd215b`, `24dc2e6b`, `4a971ef3`, `90dcd41f`, `f19ea69f`, `648ef944`, `75770f4f`, `722bf22a`, `e20384c7`, `c044acda` (nested merge)
-- `e8098348`: `434f00b5`
-
-**Equivalent locally.** `opt-in-release-awareness` maps to the fork's existing
-version-check and updater owners. Checks and scheduling are disabled by default;
-`update status` and `update check` are explicit read-only paths; `update apply
---yes` requires confirmation and a supported installer; malformed configuration,
-unsupported platforms, and overlapping scheduled work fail closed. The cited
-predicates verify those outcomes. Upstream's MCP cached-status response shape is
-outside this equivalence claim.
-
-**Not applicable.** The fork has no live HTTP hub, logstream database, closet
-index, EmbeddingGemma runtime, Qdrant backend, upstream Docker publication, or
-upstream release-metadata owner. The private benchmark supplies no comparable
-fork measurement. Repository-only dependency, history, and version changes
-remain owned by each repository.
-
-The release-critical update-awareness row is closed by existing local predicates.
-The range therefore has zero unresolved release-critical decisions and imports no
-upstream runtime behavior.
+- `d9f05907`: `85d60c90`, `17936626`, `478ecee9`, `66b3b23d`, `4aa1e7f1`, `bf30db9b`, `be27f731`, `57ab367a`, `ea0c780b`
+
+**Not applicable.** The fork already has one typed MCP registry: 29 tools in the
+full profile and four tools in the portable minimal profile. Importing a second
+free-form PQL parser and server would duplicate that owner and add hub,
+logstream, and fuzzy-resolution contracts absent from this fork. The local KG
+retains typed tool arguments and returns explicit temporal state on its existing
+query surfaces.
+
+The range has no release-critical decisions and imports no upstream runtime
+behavior.
 
 ## Capability Comparison
 
@@ -126,9 +102,10 @@ upstream runtime behavior.
 | Embeddings | New onboarding offers multilingual `embeddinggemma-300m`; opt-in `openai-compat` targets an OpenAI-compatible endpoint; 3.9.0 adds an EmbeddingGemma sub-batch override | `all-MiniLM-L6-v2`; no supported multilingual configuration or migration path, and no remote embedding-provider integration |
 | Search | Date-window filtering is advertised; 3.9.0 can forward compatible CLI searches to a live hub and reports raw vector similarity for closet-enriched search | No date-window or live-hub forwarding surface; local Lance search remains process-local |
 | Agent integration | A Hermes `MemoryProvider`, source adapters, shared-hub routing, and skill-first coordination are advertised | No Hermes provider, source-adapter ingestion, or shared-hub surface |
-| MCP count and plugin wording | README and Claude plugin wording say 45 MCP tools; the Codex plugin wording says 44 | Direct stdio MCP registration defaults to the full 29-tool profile |
+| MCP count and plugin wording | README and Claude plugin wording say 45 MCP tools; the Codex plugin wording says 44; an optional lightweight facade exposes three PQL/structured tools | Direct stdio MCP registration defaults to the typed 29-tool profile; the portable package defaults to four typed tools |
 | Plugin metadata | Codex manifest identifies `mempalace` version 3.9.0 and points at `.mcp.json` | Standards-conformant Agent Plugins 1.0 portable package with a four-tool default |
-| Coordination and replication | Logstream includes watcher behavior, topic routing, reverse pagination, artifact handoffs, and an RFC 004 multi-master foundation | No logstream, palace replication, mesh, or live-hub transport |
+| Coordination and replication | Logstream includes watcher behavior, topic routing, reverse pagination, artifact handoffs, on-demand coordination guidance, and an RFC 004 multi-master foundation | No logstream, palace replication, mesh, or live-hub transport |
+| KG query shape | Entity candidates can be resolved through the lightweight facade and partitioned into active, historical, and future facts | Existing typed KG tools return each fact with explicit temporal state; no PQL or fuzzy entity-resolution layer |
 | Hub concurrency | HTTP MCP permits concurrent palace reads while retaining exclusive writes | Stdio-only MCP; no shared HTTP palace lock |
 | Update awareness | Stable-release checks are opt-in, cached, agent-visible, and do not install automatically | Disabled-by-default version checks plus explicit `update status`, `update check`, and confirmed `update apply --yes`; no upstream MCP cached-status compatibility claim |
 | Benchmarks | A private-palace search benchmark procedure is published | Independent local benchmark gates; no cross-project result equivalence claim |
@@ -180,6 +157,9 @@ Upstream, advertised at the reviewed commit:
 - `qdrant-bounded-get-scroll`
 - `closet-search-source-index`
 - `private-palace-search-benchmark`
+- `lightweight-mcp-pql-three-tools`
+- `kg-entity-candidate-temporal-buckets`
+- `on-demand-logstream-coordination`
 
 This fork, current:
 
@@ -200,9 +180,9 @@ This fork, current:
 
 ## Capability Sources
 
-The manifest carries the exact source mapping. The established capabilities
-remain pinned to README, changelog, plugin/MCP metadata, and RFC 003–005. The
-new 3.9.0 capabilities use these reviewed sources:
+The manifest carries the exact source mapping. Established capabilities remain
+pinned to README, changelog, plugin/MCP metadata, and RFC 003–005. The newest
+delta uses these reviewed sources:
 
 | Upstream identifier | Read from |
 |---|---|
@@ -218,6 +198,9 @@ new 3.9.0 capabilities use these reviewed sources:
 | `qdrant-bounded-get-scroll` | `CHANGELOG.md`, `mempalace/backends/qdrant.py` |
 | `closet-search-source-index` | `CHANGELOG.md`, `mempalace/searcher.py` |
 | `private-palace-search-benchmark` | `benchmarks/PRIVATE_PALACE.md` |
+| `lightweight-mcp-pql-three-tools` | lightweight MCP guide, `mempalace/mcp_light_server.py`, `mempalace/query_parser.py`, `mempalace/cli.py`, `pyproject.toml` |
+| `kg-entity-candidate-temporal-buckets` | `mempalace/mcp_server.py`, `mempalace/knowledge_graph.py` |
+| `on-demand-logstream-coordination` | `integrations/shared/coordination-protocol.md` |
 
 `mempalace/config.py` is also pinned for the live-hub search fingerprint.
 `mempalace/split_mega_files.py` and RFC 005 remain tracked because changes to
@@ -243,7 +226,8 @@ logstream, live-hub routing, and replication remain outside the local code-memor
 scope.
 
 **MCP and packages.** Direct MCP defaults to 29 tools. The separate Agent
-Plugins 1.0 portable package defaults to the four-tool `minimal` profile.
+Plugins 1.0 portable package defaults to the four-tool `minimal` profile. The
+fork keeps this one typed registry and does not import the optional PQL facade.
 
 ## Evidence Limits
 
@@ -252,10 +236,8 @@ Plugins 1.0 portable package defaults to the four-tool `minimal` profile.
   sources. No upstream behavior was run.
 - **Nothing was measured.** This document contains no cross-project benchmark,
   quality, performance, adoption, or compatibility measurement.
-- **Delta stances are about this fork.** Every commit is assigned to one merge
-  group. The update-awareness row claims only equivalent local outcomes backed
-  by the named predicates; the other 11 rows are repository-only `irrelevant`
-  decisions with no local predicate claim.
+- **Delta stances are about this fork.** Every commit is assigned to the one
+  merge group. Its `irrelevant` stance imports no local predicate claim.
 - **Plugin counts are source-local wording.** The pinned README and Claude plugin
   say 45 tools; the pinned Codex plugin says 44. The fork's 29-tool direct profile
   and four-tool portable default are independent.

{mempalace_code-1.13.6 → mempalace_code-1.13.8}/docs/quality/scorecard.json

@@ -1,10 +1,10 @@
 {
   "code_size": {
-    "package_code_lines": 24154,
+    "package_code_lines": 24281,
     "package_files": 80,
-    "package_total_lines": 29373,
+    "package_total_lines": 29511,
     "test_files": 88,
-    "test_total_lines": 80330
+    "test_total_lines": 81582
   },
   "demo_gates": {
     "architecture_guard": {
@@ -58,7 +58,7 @@
   },
   "largest_modules": [
     {
-      "lines": 2071,
+      "lines": 2107,
       "path": "mempalace_code/storage.py"
     },
     {
@@ -78,7 +78,7 @@
       "path": "mempalace_code/dialect.py"
     },
     {
-      "lines": 987,
+      "lines": 989,
       "path": "mempalace_code/backup.py"
     },
     {
@@ -276,13 +276,13 @@
       "mempalace_code",
       "tests"
     ],
-    "type_pyright_total": 170,
+    "type_pyright_total": 171,
     "type_pyright_unreasoned": 0,
     "unreasoned_total": 0
   },
   "tests": {
     "test_files": 88,
-    "test_functions": 3721
+    "test_functions": 3755
   },
   "verification_commands": [
     {

{mempalace_code-1.13.6 → mempalace_code-1.13.8}/docs/quality/scorecard.md

@@ -9,21 +9,21 @@ Schema version: 4
 | Metric | Value |
 |--------|------:|
 | Package files (`mempalace_code/`) | 80 |
-| Package total lines | 29373 |
-| Package code lines | 24154 |
+| Package total lines | 29511 |
+| Package code lines | 24281 |
 | Test files (`tests/`) | 88 |
-| Test total lines | 80330 |
+| Test total lines | 81582 |
 
 ## Largest Modules (top 10)
 
 | Module | Lines |
 |--------|------:|
-| `mempalace_code/storage.py` | 2071 |
+| `mempalace_code/storage.py` | 2107 |
 | `mempalace_code/updater.py` | 1780 |
 | `mempalace_code/mining/chunkers.py` | 1466 |
 | `mempalace_code/watcher.py` | 1333 |
 | `mempalace_code/dialect.py` | 1074 |
-| `mempalace_code/backup.py` | 987 |
+| `mempalace_code/backup.py` | 989 |
 | `mempalace_code/cli.py` | 947 |
 | `mempalace_code/mining/symbols.py` | 904 |
 | `mempalace_code/entity_detector.py` | 885 |
@@ -117,7 +117,7 @@ Scope: `mempalace_code/`, `tests/` (excludes `tests/fixtures/`).
 
 | Metric | Value |
 |--------|------:|
-| type/pyright ignores (total) | 170 |
+| type/pyright ignores (total) | 171 |
 | type/pyright unreasoned | 0 |
 | noqa (total) | 39 |
 | noqa blanket | 0 |
@@ -128,7 +128,7 @@ Scope: `mempalace_code/`, `tests/` (excludes `tests/fixtures/`).
 | Metric | Value |
 |--------|------:|
 | Test files | 88 |
-| Test functions | 3721 |
+| Test functions | 3755 |
 
 ## Available Suites