matryca-logseq 1.4.1__py3-none-any.whl

matryca_logseq-1.4.1.dist-info/METADATA

@@ -0,0 +1,279 @@
+Metadata-Version: 2.4
+Name: matryca-logseq
+Version: 1.4.1
+Summary: MCP bridge between AI agents and Logseq OG (pure Markdown outliner).
+License: Apache-2.0
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: NOTICE
+Requires-Dist: logseq-matryca-parser==0.3.3
+Requires-Dist: pydantic<3.0.0,>=2.0.0
+Requires-Dist: python-dotenv<2.0.0,>=1.0.0
+Requires-Dist: loguru<1.0.0,>=0.7.0
+Requires-Dist: mcp<2.0.0,>=1.0.0
+Requires-Dist: pyyaml<7.0.0,>=6.0.0
+Provides-Extra: dev
+Requires-Dist: pytest<9.0.0,>=8.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio<1.0.0,>=0.24.0; extra == "dev"
+Requires-Dist: ruff<1.0.0,>=0.8.0; extra == "dev"
+Requires-Dist: mypy<2.0.0,>=1.13.0; extra == "dev"
+Dynamic: license-file
+
+# Matryca Logseq LLM Wiki (v1.4.0 — Headless Edition)
+
+> Agentic Knowledge Management for Logseq OG. An MCP server that turns your favorite AI into a spatial Knowledge Architect. It treats your vault as a tree of blocks, not a flat document store. Local-first, database-free, and Markdown-purist.
+
+[![CI](https://github.com/MarcoPorcellato/matryca-logseq-llm-wiki/actions/workflows/ci.yml/badge.svg)](https://github.com/MarcoPorcellato/matryca-logseq-llm-wiki/actions/workflows/ci.yml)
+[![Tests](https://img.shields.io/badge/tests-152%20passing-brightgreen)](https://github.com/MarcoPorcellato/matryca-logseq-llm-wiki/actions/workflows/ci.yml)
+[![Python 3.12+](https://img.shields.io/badge/python-3.12+-3776AB?logo=python&logoColor=white)](https://www.python.org/downloads/)
+[![License](https://img.shields.io/badge/license-Apache--2.0-green.svg)](LICENSE)
+
+![Matryca Logseq LLM Wiki — Agentic Knowledge Management for Logseq OG](images/20260519%20Logseq%20Matryca%20LLM%20Wiki%20copertina%20github.jpg)
+
+Matryca is a **100% Headless, sandboxed** MCP server and CLI built to turn your local Logseq graph into a high token-density agentic workspace — **with no network APIs and no background desktop app required**.
+
+The shift from a **stateful, network-bounded** architecture (Logseq Electron + JSON-RPC) to a **local-first, zero-dependency** model is the milestone of **v1.4.0 — The Headless Revolution**: one required variable (`LOGSEQ_GRAPH_PATH`), atomic AST writes via `logseq-matryca-parser==0.3.3`, and X-Ray persistence in `.matryca_xray_state.json`.
+
+---
+
+## ✨ Core Features
+
+* 🌌 **AST Spatial Intelligence:** understands Logseq’s native parent-child block structure via a deterministic parser.
+* 🤖 **100% Headless & Local-First:** does not require the Logseq desktop app to be open. Mutations use atomic file I/O directly on `.md` sources.
+* 🩻 **X-Ray Token Economy (Printing Press Mode):** compresses Markdown trees and maps UUIDs to persistent aliases like `[0]`, `[1]` — up to ~35× less context noise.
+* 🔒 **Sandboxed Privacy:** mathematically blocks path-traversal attempts outside the graph root (`path_sandbox.py`).
+* ⚡ **Agent-Native CLI:** fast, minimal `matryca` command optimized for terminal scripts and local LLMs.
+* 🧱 **Ironclad Data Plane:** transactional swaps, code-block fence scanning, optional Git snapshots before mutations.
+* 📊 **Zero-DB Lexical Engine:** in-memory Okapi BM25 and structural BFS traversals — no vector store.
+
+---
+
+## ⚙️ Configuration (Zero-Friction)
+
+Forget API tokens and port configuration. The only **required** variable is the absolute path to your graph:
+
+### Claude Desktop
+
+Add this block to `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "matryca-logseq-llm-wiki": {
+      "command": "uv",
+      "args": ["run", "python", "-m", "src.main"],
+      "cwd": "/absolute/path/to/matryca-logseq-llm-wiki",
+      "env": {
+        "LOGSEQ_GRAPH_PATH": "/absolute/path/to/your/Logseq/graph"
+      }
+    }
+  }
+}
+```
+
+Restart the MCP host after edits. Optional: `MATRYCA_GIT_SNAPSHOT_ON_WRITE=true` for automatic commits before writes on git-backed graphs.
+
+---
+
+## 🧪 Stability Markers
+
+* **152 strict passing tests** (unit, integration, subprocess).
+* **100% strict MyPy** type checking and **Ruff** compliance on `src/` and `tests/`.
+* The same bar on `main` in [`.github/workflows/ci.yml`](.github/workflows/ci.yml) — run `make check` locally.
+
+---
+
+## Architecture stack
+
+```mermaid
+flowchart TB
+  subgraph host["Host machine"]
+    IDE["MCP client\n(Claude Desktop, Cursor, …)"]
+  end
+  subgraph proc["matryca-logseq-llm-wiki process"]
+    MCP["FastMCP stdio"]
+    SRV["MatrycaMCPServer\n+ Pydantic validators"]
+    GD["graph_dispatch.py\n(headless CRUD)"]
+    QG["quality_gate\n(credential / key scans)"]
+    MCP --> SRV
+    SRV --> GD
+    SRV --> QG
+  end
+  subgraph data["Data plane (headless)"]
+    FS[("LOGSEQ_GRAPH_PATH\npages/ · journals/ · templates/")]
+    PAR["logseq-matryca-parser==0.3.3\n(spatial read + agent_writer)"]
+    SBX["path_sandbox\n(is_relative_to graph root)"]
+    LOCK["page_rmw_lock\n(per-page RMW)"]
+    GFS["global_fence_scanner\n(dead-zone line index)"]
+    ATW["atomic_write_bytes\n(tmp + fsync + replace)"]
+    GC["generational_cache\n(mtime_ns signatures)"]
+    XRAY[".matryca_xray_state.json\n(SessionAliasRegistry)"]
+  end
+  subgraph delivery["Delivery gates (repo)"]
+    CI["GitHub Actions\nRuff · Mypy · Pytest"]
+    DB["Dependabot\npip + Actions"]
+    REL["tag v* → uv build\ngh release create"]
+  end
+  IDE <-->|JSON-RPC MCP| MCP
+  GD <-->|AST splice + read| FS
+  GD --> PAR
+  GD --> LOCK
+  SRV --> SBX
+  SRV --> GFS
+  SRV --> ATW
+  SRV --> GC
+  SRV --> XRAY
+  CI -.->|enforces| proc
+  DB -.->|updates| delivery
+  REL -.->|artifacts| delivery
+```
+
+### L1 versus L2 (two-layer context)
+
+```mermaid
+flowchart TB
+  subgraph L1["L1 — session rules (small, capped)"]
+    M1["MATRYCA_L1_PATH\nor matryca-l1/*.md\nor matryca-wiki.yml memory_path"]
+  end
+  subgraph L2["L2 — the graph"]
+    M2["pages/ · journals/ · templates/"]
+  end
+  A[Agent] --> R{High-stakes\nbefore vault?}
+  R -->|yes| T[read_l1_memory]
+  R -->|no| Q[query_logseq_pages_local\nBM25 + generational cache]
+  T --> M1
+  Q --> M2
+  M1 --> M2
+```
+
+### Runtime agent loop (search → gate)
+
+```mermaid
+flowchart LR
+  S[Search\nBM25 / hops] --> C[Scan\nread_logseq_page · lint]
+  C --> U[Refactor\nheadless AST mutators]
+  U --> G[Garden\nMOC · tags · split]
+  G --> Q[Quality gate\nsecrets · fan-out · routing_hint]
+  subgraph iron["Ironclad sub-loop"]
+    F[fence scanner] --> A2[atomic swap]
+    A2 --> I[incremental cache]
+  end
+  U -.-> iron
+  G -.-> iron
+```
+
+---
+
+## Feature matrix: architectural phases
+
+Each phase adds capabilities; later phases **harden** earlier tools without necessarily renaming the MCP surface. **Phase** is the product narrative; **modules** are what you grep in `src/`.
+
+| Phase | Core capabilities | MCP tools (exposed names) |
+|:-----:|-------------------|---------------------------|
+| **1 — Baseline bridge** | FastMCP server, **`OutlineNode`** validation, DFS **`write_logseq_outline`**, spatial **`read_logseq_page`**, block-ref integrity scan, dashboard aggregation | `read_logseq_page`, `write_logseq_outline`, `lint_logseq_block_refs`, `render_logseq_dashboard` |
+| **2 — L1 / L2 routing** | Capped **`read_l1_memory`** from configurable paths; **routing hints** on read/write responses for traceability (`routing_hint.py`) | `read_l1_memory` *(hints on other tools’ payloads)* |
+| **3 — PKM refinements** | BM25 and substring local query; structural BFS hops and hub/orphan reports; surgical **`key::`** property edits; templates; wiki-prefix lint; namespace index; optional **git snapshot** on outline and heavy mutators | `query_logseq_pages_local`, `traverse_logseq_structural_hops`, `report_structural_hubs_orphans`, `patch_logseq_block_property_lines`, `list_logseq_templates`, `read_logseq_template`, `lint_matryca_wiki_pages`, `list_logseq_namespace_index`, `snapshot_logseq_graph_git` |
+| **4 — Logseq superpowers** | Advanced Query injection with preset or raw EDN; journal task mining; entity resolution via alias index; page alias append | `search_graph` / `method=resolve_entity`, `mutate_graph` / `inject_query`, `append_journal` |
+| **5 — Graph gardener** | SRS-style flashcards from `::` pairs; vault-wide tag unify; same-page reparent refactor | `generate_logseq_flashcards`, `lint_unify_logseq_tags`, `refactor_logseq_blocks` |
+| **6 — Synthesis engine** | Unlinked mention discovery; MOC generation; long-bullet split; manual git snapshot | `resolve_unlinked_mentions`, `generate_moc_page`, `refactor_large_blocks`, `snapshot_logseq_graph_git` |
+| **7 — Mldoc guards** | **`mldoc_properties`** (property grammar, CSV / wikilink / quote semantics); **`mldoc_guards`** (drawers, fences, macros) wired into property edit, tag unify, alias append, large-block split | *Same tool names as phases 3–6; strengthened internals* |
+| **8 — Ironclad data plane** | **`compute_page_protected_line_indices`** (global fence lexer); **`atomic_write_bytes`** on mutators; **`generational_cache`** (`st_mtime_ns` keyed alias + BM25 corpus reuse, Salsa-style invalidation) | *Same tool names; dead-zone and cache behavior upgraded* |
+| **9 — Trust and policy plane** | **`quality_gate`**: blocks credential-like outline properties and raw query EDN; **`lint_matryca_wiki_pages`** for configurable wiki discipline; structured dry-run / apply responses | Enforcement inside `write_logseq_outline`, `inject_logseq_advanced_query`; governance tools listed in phase 3 |
+| **10 — Delivery and community** | **GitHub Actions** (`ci.yml`): `uv sync --locked`, Ruff lint + format check, **Mypy** on `src` and `tests`, Pytest; **Dependabot** (pip + Actions); **`release.yml`** on `v*` tags (`uv build`, `gh release create`); **`SECURITY.md`**; **Contributor Covenant** (`CODE_OF_CONDUCT.md`); issue and PR templates | *Repository operations — no additional MCP tools* |
+| **11 — Fortress (`v1.3.0`)** | **`path_sandbox.py`** traversal gate on all FS paths; **`mcp_tool_guard`** LLM-safe errors; lifespan lock and telemetry teardown | *Same MCP tool names; adversarial path hardening* |
+| **12 — Headless Revolution (`v1.4.0`)** | Removed **`httpx`** / **`LogseqClient`**; **`graph_dispatch.py`** + **`agent_writer.append_child_to_node`** for atomic AST writes; **`.matryca_xray_state.json`** via **`SessionAliasRegistry`**; **`LogseqGraph.get_broken_references()`** for in-memory ref lint | *Same MCP tool names; 100% disk-native persistence* |
+
+**Roadmaps and design history:** [`docs/roadmaps/`](docs/roadmaps/) (LLM Wiki, Phase 3, Logseq superpowers, Phase 5–6, mldoc compliance, Ironclad Shield).
+
+---
+
+## Zero-install execution (`uvx`)
+
+You do **not** need to clone this repository to run the published console script. **[uv](https://docs.astral.sh/uv/)** can materialize an ephemeral environment from the Git VCS URL (the package depends on **`logseq-matryca-parser`** via `git+https` in `pyproject.toml`, so the practical install path remains VCS-backed).
+
+```bash
+uvx --from git+https://github.com/MarcoPorcellato/matryca-logseq-llm-wiki.git matryca-logseq-llm-wiki
+```
+
+Set **`LOGSEQ_GRAPH_PATH`** to the absolute root of your Logseq graph (the folder containing `pages/`) in your MCP host’s server definition. For **responsible vulnerability disclosure**, see [`SECURITY.md`](SECURITY.md).
+
+---
+
+## Safe testing on a copy of your graph
+
+Because Matryca reads and writes **the same folder** pointed to by `LOGSEQ_GRAPH_PATH`, always point agents at a **dedicated test graph** before experimenting:
+
+1. **Clone the graph.** Copy your real Logseq folder to a dedicated location (for example `Logseq_Matryca_Test`). Use a full copy, not a symlink.
+2. **Set the path.** In `.env` or your MCP host `env` block, set `LOGSEQ_GRAPH_PATH` to that copy’s absolute path.
+3. **Optional rollback.** With `MATRYCA_GIT_SNAPSHOT_ON_WRITE=true`, selected writes also create a local **git commit** on the test graph so you can revert experiments.
+
+<details>
+<summary><b>🛠️ Using Logseq Sync? Click here if Logseq refuses to open the test folder.</b></summary>
+<br>
+If you use Logseq Sync, the app tracks graphs by hidden UUIDs, not folder paths. A direct copy-paste will cause a UUID clash. Do a <b>Clean Transplant</b> instead:
+<ol>
+  <li>Create a brand new, empty folder (e.g., <code>Logseq_Matryca_Test</code>).</li>
+  <li>Open Logseq, click "Add new graph", and select this empty folder to initialize a clean state.</li>
+  <li>Close Logseq completely.</li>
+  <li>Copy <b>ONLY</b> the <code>pages/</code>, <code>journals/</code>, and <code>assets/</code> folders from your real graph into the test folder. (Do NOT copy the <code>logseq/</code> folder or hidden git files).</li>
+  <li>Reopen Logseq and click <b>Re-index</b>.</li>
+</ol>
+</details>
+
+---
+
+## Quickstart (clone and develop)
+
+### Prerequisites
+
+- **Python 3.12+**
+- **[uv](https://docs.astral.sh/uv/)**
+- A **Logseq OG** graph on disk (the directory containing `pages/`)
+
+### Install
+
+```bash
+git clone https://github.com/MarcoPorcellato/matryca-logseq-llm-wiki.git
+cd matryca-logseq-llm-wiki
+make install
+```
+
+### Environment
+
+Copy **`.env.example`** to **`.env`** and set at minimum:
+
+| Variable | Role |
+|----------|------|
+| `LOGSEQ_GRAPH_PATH` | **Required.** Absolute graph root (directory containing `pages/`) |
+| `MATRYCA_L1_PATH` | Optional: file or directory of small Markdown “L1” session rules |
+| `MATRYCA_WIKI_CONFIG` | Optional: path to `matryca-wiki.yml` (else `$LOGSEQ_GRAPH_PATH/matryca-wiki.yml`) |
+| `MATRYCA_GIT_SNAPSHOT_ON_WRITE` | `true` or `false` — opt-in automatic **`git add -A` + `git commit`** before selected writes when the graph is a git checkout |
+
+Optional graph orchestration: copy [`matryca-wiki.example.yml`](matryca-wiki.example.yml) to your graph as **`matryca-wiki.yml`** for namespaces, template subdirectory, wiki lint prefix, and dashboard title.
+
+### Verify
+
+```bash
+make check
+```
+
+Runs Ruff (format + lint), **strict Mypy** on `src/` and `tests/`, and **pytest** (**152** strict passing tests). The same bar is enforced on **`main`** in [`.github/workflows/ci.yml`](.github/workflows/ci.yml).
+
+---
+
+## Documentation map
+
+| Document | Audience |
+|----------|----------|
+| [`SYSTEM_PROMPT.md`](SYSTEM_PROMPT.md) | Agent operators — outline discipline, Search → Scan → Update, dry-run-first mutators |
+| [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md) | Engineers — headless CRUD plane, Ironclad data plane, phase history |
+| [`CONTRIBUTING.md`](CONTRIBUTING.md) | Contributors — `uv`, `make check`, MCP testing notes |
+| [`CODE_OF_CONDUCT.md`](CODE_OF_CONDUCT.md) | Community standards (Contributor Covenant 2.1) |
+| [`SECURITY.md`](SECURITY.md) | Private reporting via GitHub Security Advisories |
+
+---
+
+## License
+
+Apache-2.0 — see [LICENSE](LICENSE).

matryca_logseq-1.4.1.dist-info/RECORD

@@ -0,0 +1,81 @@
+matryca_logseq-1.4.1.dist-info/licenses/LICENSE,sha256=Mhg-e6quei6cAjXg0IjKmlVp33X_95lzV5EGT48BzQQ,11335
+matryca_logseq-1.4.1.dist-info/licenses/NOTICE,sha256=cxxK0OSK5osbO3_Z07E9NF-d64wZ3fgilryRE_sIlzg,311
+src/__init__.py,sha256=KyK-Uw-sdu7LeTL7S5KTYaifwmuSLOfnm7CS71Q-xDg,70
+src/cli.py,sha256=Ww8Kh6uvaC1ZH0HRG-U25aJ5A3Dabpu15qpb8KAgxi0,5888
+src/config.py,sha256=OHuh1tpsvRZQ8S81OWvW3HaizxVMjobGcqsyMae9_ME,3439
+src/main.py,sha256=0PMV-czOnBeNjS5gOQKZ86taAzD-zqDZ14Psm4PaCEY,2047
+src/agent/__init__.py,sha256=f5ek1QNYAXhJIxM_SoOQosoA_WIhV57enbSug0_ZAUI,36
+src/agent/alias_state.py,sha256=zeiG4qyOK8I7Y4_s_qnRz-rx5UW1s_iN0KKs6_CbaBo,3540
+src/agent/git_snapshot.py,sha256=UkNEVgq6Ofazd4SuNNh2saEGeIOKDjZBidufx0S8lfE,3629
+src/agent/graph_dispatch.py,sha256=5JO6HdmIiBDZB0pOKBw7cRnkzMKrKqP_ilMc9l0_MNg,27208
+src/agent/graph_tool_helpers.py,sha256=bRV4OP0uBFTnmzUaXWeux_B0E67u66Y9Nyji32HL5fM,8429
+src/agent/l1_memory.py,sha256=Diuvbzg6x296y2ctGVl7b6m0yGlG-S_61QLxbTqg_hg,4858
+src/agent/mcp_server.py,sha256=kY1ctW51j2pHJjonG1F1WQf23JBDqvzopJRWup97_f0,13144
+src/agent/mcp_telemetry.py,sha256=qKVxhtfb7JFKNRJKLJXy40REFdiNc0Kr2TRsGCJsnyQ,2230
+src/agent/mcp_tool_guard.py,sha256=BCaAuEnzjq_vpmzF32QcOtijZvP1U-fL8cg0ZeXij04,1946
+src/agent/quality_gate.py,sha256=MYmXUdviz81vNFo_8lJuiIJUjUn98k0UzAhKl3Y_AOo,4941
+src/agent/routing_hint.py,sha256=HC62xVjzgegyeboMbnIpLHic_MAv43ZxkZtJyv94IUM,1614
+src/graph/__init__.py,sha256=WPDqP0sR1f07AU_Qbg2tT_EBHq6Fc8mZNIc3G5ea_pA,251
+src/graph/advanced_query_block.py,sha256=GCz70ej976dtpk1timJxKneJnzkEXRnmOStEUu4_Xl8,3116
+src/graph/alias_index.py,sha256=ONFLRv89uY5i5CNiWJonQN_JPXxgNrmaSjwRwOtUAZw,6934
+src/graph/block_ref_lint.py,sha256=Hpjz3jXHKbawqG8wQTQR6XlZwhW9XBOQA7zjKEfSBXo,4209
+src/graph/dashboard.py,sha256=XtiRA4qX43e9UaFs8NizECLhKopvMD_wZ8QL8ZcdCUw,3480
+src/graph/flashcards.py,sha256=qOIDSckxNGdvfNnAitN4gURQZRvgVE2VMiGhh2yujMA,5292
+src/graph/generational_cache.py,sha256=7ssb4El_gUdPfYX0gB5YzLfXRRnIjUnKhfyDVMu6iws,5137
+src/graph/global_fence_scanner.py,sha256=JjeB1H5sEjSzM2j4WajEcTRi7te_so00CmetBMA6gPQ,3809
+src/graph/hubs.py,sha256=WSwmMUzSzMunJrOvma-ySNL8V9t6HyyZqnL8XmV1tdc,1449
+src/graph/journal_task_scan.py,sha256=1VIVfEzbygQ3KDckvJinnpBCbnDvRamloMdm2ZbGS6Y,8824
+src/graph/link_tag_hop.py,sha256=iy1KbKEsyDTUt9n-Qa6MNGHquQ21-A8PA2fFeZN1PL0,10245
+src/graph/logseq_uuid.py,sha256=hnzEF8cMe5M4WlKYek0q9IxqXa6tljv6gKWmG_wDg6I,2096
+src/graph/markdown_blocks.py,sha256=HmKta_Ph3h5eNipIHYyAjuznDJEiWwTNm6crxW4vDQM,6589
+src/graph/mldoc_guards.py,sha256=6BxoHjBVhuFi76L8hBFqPi8DXHWm2Ol5tyu1T7pjZA0,1984
+src/graph/mldoc_properties.py,sha256=2m2ui3I-WBt9ItLOcvQc9Zn5FsG72CElCBYVxzMzrc8,5355
+src/graph/moc_page.py,sha256=W9NdRyi4EAIU3jnaUBC1hziBfv3TtJzAcDO_Mrf_3rM,3510
+src/graph/page_write_lock.py,sha256=1G_PYoMGJvuBOXBvBoq_rrTZQMUy2N7SgJDu-39ODJg,2663
+src/graph/path_sandbox.py,sha256=hTheq7QdmSBOAWFK-snYV_HHFEzUux9Ih2NL8f8_7yw,1614
+src/graph/property_line_edit.py,sha256=6EluQvQxq1g8ZiB3sSgjzZkX954kPYbsM45hms-GWt8,20177
+src/graph/reparent_blocks.py,sha256=JWXyQ2FoGNmwacdiaHSt30Lr46Um8odJh_wOFCea5GA,8484
+src/graph/split_large_blocks.py,sha256=DSOOUNX9QcC70n3yKVkoFjbRfLzdPx9-qKODrvooU6s,8011
+src/graph/tag_unify.py,sha256=UtYHWZcNh01wXOZxWqcz3Y_wU7JCQ2uf0r0YMhsYiuA,9934
+src/graph/templates.py,sha256=2fTAH1SxssHfSDiJQyB2_2KqAF7UuglG3R_VmeEpj4c,3368
+src/graph/unlinked_mentions.py,sha256=fLlkZl6s3j-lk6I1i6nsxQK0qn3H6oVs2Cx_OuFcGsM,5286
+src/graph/wiki_lint.py,sha256=O9pJ4k4RwS7exhjTPPawXjQEwP7OnrvFXEczUK9NkLE,5330
+src/rag/__init__.py,sha256=MRkCy2Q_rhA_bAC6GTgJJ-BrW45Z_xGKWu-SRDjv-VE,61
+src/rag/local_query.py,sha256=xjqRqx4nThyJxAdCKY8g5BSOVQo9E6xI-t2f4klBjgQ,3513
+src/rag/matryca_hooks.py,sha256=CO4GEa5cuuAGVFHk7apbF6F6ffBWS6jqKbkp2bOEA9w,12894
+tests/__init__.py,sha256=XLb0nA9t3At7Z6_3wB2_L5GagN2YIsdG9517gs-XK7s,46
+tests/conftest.py,sha256=wK3bVBUZ0dkhZ9wn5NgCUpzhMzTQtxEcRbRgiRtSi80,378
+tests/test_advanced_query_block.py,sha256=6kVBni2f7Hd6YksymQDJSijPzOLi5PBKedglQ-7gZ6k,1245
+tests/test_adversarial_security.py,sha256=HZrGJZLc2IN6OqHkGNtlIWsudwO3CPteJCl8Avw8enk,2181
+tests/test_alias_index.py,sha256=1y3HhZlxWBpPwYxM9f2TFgGA23SwBVViBvNDvR77_DE,959
+tests/test_alias_state.py,sha256=gyel09Uad6gFHzE-xDkB2-lmKFPgHqnyClat_MFgarI,2486
+tests/test_block_ref_lint.py,sha256=_aKvTV5jmrmNkYGjCz4zVXOoCz6wekMkLuMCMVqzXdc,2415
+tests/test_cli.py,sha256=-fFLxWGhN813vKwD09tZ66xXh4EtKem6aRVgFVtxbXI,7789
+tests/test_config.py,sha256=6-p_S7yTK6-hCh9miIsYZhcJIL6kzN1vXQgxkJLR390,1519
+tests/test_dashboard.py,sha256=JYF36nfSv8w8yWyYt6kiowA5xEPzcplFYJ60K1omXGc,952
+tests/test_git_snapshot.py,sha256=fYhtgEmwTeISCJUZgrvIaf7IH6iU0MyRxhGwh8mRqjI,1853
+tests/test_graph_dispatch_search.py,sha256=DPvm8TLx7tlsFXLKbB9hYMtK2qficrtbi4lyDB5sc2o,715
+tests/test_hardening_final.py,sha256=csNuGy2XeEK2rrQETxFXDSB_4shuPmH_g95PuwFcZ1E,5509
+tests/test_hubs.py,sha256=vfFb-5gLqERqm1NMoRzSmg0KBI2DstwyNbWoWrY-hXA,643
+tests/test_ironclad_phase8.py,sha256=0LRFnSqyCu2NqMxFpKndEGVw-340T6aI2QGCqtIZ6N4,5358
+tests/test_journal_task_scan.py,sha256=JTEIb6LkHI7YLF4KsJGj2YnMrXedo6gy2ESPAx727tw,2514
+tests/test_l1_memory.py,sha256=d0nTCTlKFhwEE0dFfFIALhexuv1J7ZH9FYZIHLH4Bh4,2981
+tests/test_link_tag_hop.py,sha256=3z4DDHu9vBMgmbCs50v_Ab4lFd-h8UkyZgtdVYMzbG4,2518
+tests/test_local_query.py,sha256=_KdHLpHxVJ8nlmien5mYEaRx2WT4RrcYGvEtua89y5E,1554
+tests/test_logseq_uuid.py,sha256=9SSsQxAdKKN--hLBKhouFpOHAaPgilrFHSTMBSJYHAY,1516
+tests/test_markdown_blocks_hygiene.py,sha256=AksD7IbbeLoRzaquR9w0ATHtsVpKlTPmRHp_pvsa_tE,1860
+tests/test_matryca_hooks.py,sha256=iTprK9gUuASrKhu5R1Cy0P0XnrynpWPKzAP_QutWINk,2869
+tests/test_mcp_server.py,sha256=iB23hCk4JpxV2qN7g2UMFRG6fRsth3Ue1lP7_8TUwsk,6081
+tests/test_mcp_telemetry.py,sha256=4kVXcAN_otsGAo1SRROD0Hi_MyRGAt3dWFAfgn-CY4Y,1206
+tests/test_mldoc_phase7.py,sha256=UqLpe-IsOevro5XmhjlSBRngQS8KmUespGlYUtIjQUo,3585
+tests/test_phase_5_6_graph_tools.py,sha256=JoeHNoElaNOKNBVSv4nWppSmO_XpaL1nmr4yRE3d7nk,4417
+tests/test_property_line_edit.py,sha256=Qy0i7_qNfu7QJ5Jn7haBZQNSuEZI-C8SYWurILSqoIY,3228
+tests/test_quality_gate.py,sha256=wj3wXRy2Z0T6FSugJBtQmnhKPiaIq67OchD6otSDimg,1949
+tests/test_routing_hint.py,sha256=yOGZyNlrKR6h7KnXJ-NUVii7xUYJAH6fa41tfnd9vgM,576
+tests/test_templates.py,sha256=5USDdeyoH6P-o8hAVkagb4crpRDr7DdTTXgAzvy3qUs,803
+tests/test_wiki_lint.py,sha256=QJjPlhBiYdiH9FKXtDh0dI7CNEXVVR4kKU5sATbbT5s,888
+matryca_logseq-1.4.1.dist-info/METADATA,sha256=sX1_WlyUgZo2lU-GYsGQo1Jwg5zDLFYbM7jg8s1Kb3M,14723
+matryca_logseq-1.4.1.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+matryca_logseq-1.4.1.dist-info/entry_points.txt,sha256=_V0q1KOC0yLvkzvPzwKceB6_P_zNwY54k5nZrQvkGTw,81
+matryca_logseq-1.4.1.dist-info/top_level.txt,sha256=KW3xgkz9NLMTcmmzgKvW8RFpCFkRIQ085qzq2diFf68,10
+matryca_logseq-1.4.1.dist-info/RECORD,,

matryca_logseq-1.4.1.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

matryca_logseq-1.4.1.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+matryca = src.cli:main
+matryca-logseq-llm-wiki = src.main:main

matryca_logseq-1.4.1.dist-info/licenses/LICENSE

@@ -0,0 +1,201 @@
+Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf
+      of the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly provide otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2026 Marco Porcellato & Matryca.ai
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

matryca_logseq-1.4.1.dist-info/licenses/NOTICE

@@ -0,0 +1,5 @@
+matryca-logseq-llm-wiki
+Copyright 2026 Marco Porcellato and Matryca.ai
+
+This product includes software developed by Marco Porcellato and Matryca.ai.
+The "Matryca logseq llm wiki" and "Logseq Matryca Parser" logic and the atomic-block outliner paradigm are intellectual property linked to the Matryca ecosystem.

matryca_logseq-1.4.1.dist-info/top_level.txt

@@ -0,0 +1,2 @@
+src
+tests

src/__init__.py

@@ -0,0 +1 @@
+"""Matryca Logseq LLM Wiki: MCP and bridge packages for Logseq OG."""

src/agent/__init__.py

@@ -0,0 +1 @@
+"""Agent-facing MCP integration."""