logseq-matryca-parser 1.10.0__tar.gz → 1.11.1__tar.gz

{logseq_matryca_parser-1.10.0 → logseq_matryca_parser-1.11.1}/.gitattributes

@@ -1 +1,2 @@
 tests/fixtures/compat/** text eol=lf
+tests/fixtures/org/** text eol=lf

{logseq_matryca_parser-1.10.0 → logseq_matryca_parser-1.11.1}/AGENTS.md

@@ -11,6 +11,14 @@ and safely extend a vault without flattening its structure.
 Markdown files are the source of truth. The in-memory graph, registries,
 backlinks, exports, visualizations, and AI chunks are derived views.
 
+The v1.11.0 release line also contains an experimental read-only Org reader
+behind a private, non-stable module API. It accepts Org text or one selected
+`.org` file and does not load a vault graph. Its diagnostics cover selected
+conditions only; unknown syntax may be retained without a warning. Do not
+present this subset as complete GNU Org or Logseq support. Markdown remains the
+primary supported parser surface; see
+[`docs/internal/LOGSEQ_ORG_PARSER_EXPERIMENTAL_STATUS.md`](docs/internal/LOGSEQ_ORG_PARSER_EXPERIMENTAL_STATUS.md).
+
 ## Capability map
 
 | Layer | Use it for | Primary entry point |

{logseq_matryca_parser-1.10.0 → logseq_matryca_parser-1.11.1}/CHANGELOG.md

@@ -7,6 +7,54 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.11.1] - 2026-10-20
+
+### Fixed
+
+- **Fenced code in outline items** — enter code mode from the actual list-item
+  fence opener and require a matching delimiter character, sufficient closing
+  width and whitespace-only closing suffix. Keep literal properties and bullets
+  inside code, preserve raw payload and source spans, and attach metadata and
+  following siblings to their correct blocks after closure.
+
+- **Multiline scalar metadata round trips** — emit genuine nonempty, single-line
+  scalar block properties before ordinary prose continuations on eligible
+  nodes, preserving their metadata and explicit block UUIDs when parsed again.
+  Property-like text after a continuation remains literal. Drawers, list-shaped
+  or multiline values, and excluded complex layouts retain their prior output;
+  this is not a general mixed-layout round-trip guarantee.
+
+### Added
+
+- **Composite Markdown assurance** — add a bounded synthetic valid-input family
+  with independent expectations for outline shape, source spans, tasks,
+  priorities, dates, metadata and visible references, followed by semantic
+  round-trip checks. Finite recipes and source-free receipts complement the
+  existing tests; they do not establish exhaustive Markdown coverage (#104).
+
+## [1.11.0] - 2026-10-02
+
+### Added
+
+- **Experimental Logseq Org reader** — add a read-only, source-preserving
+  parser for Org text or one caller-selected `.org` file. It remains a private,
+  non-stable API and does not load a vault graph. Its fixed diagnostics cover
+  selected conditions only; unsupported syntax may be retained without a
+  warning. Retained text or a diagnostic-free result does not mean that Org or
+  Logseq semantics were understood. Review the original source when omitted
+  behavior matters.
+
+### Fixed
+
+- **Source archive hygiene** — exclude selected ignored local maintainer and
+  tool-cache directories from source distributions; runtime behavior is unchanged.
+
+### Security
+
+- **Development-toolchain security** — update the locked `virtualenv` from
+  21.5.1 to 21.14.4, closing four Dependabot advisories in the `pre-commit`
+  development dependency chain. Published runtime dependencies are unchanged.
+
 ## [1.10.0] - 2026-09-27
 
 ### Changed

{logseq_matryca_parser-1.10.0 → logseq_matryca_parser-1.11.1}/CONTRIBUTING.md

@@ -17,7 +17,7 @@ User-facing behavior is documented in:
 - [`docs/ARCHITECTURE.md`](docs/ARCHITECTURE.md) — LOGOS, SYNAPSE, `LogseqGraph`, agents, and data flow
 - [`docs/internal/LOCAL_CODE_STUDY.md`](docs/internal/LOCAL_CODE_STUDY.md) — maintainer local code audit runbook (not for public issues/CHANGELOG)
 - [`docs/logseq_ast_primer.md`](docs/logseq_ast_primer.md) — Logseq Spatial Markdown domain rules
-- [`CHANGELOG.md`](CHANGELOG.md) — prepared **1.10.0** release notes (not yet published); latest released version remains **1.9.0** (Keep a Changelog)
+- [`CHANGELOG.md`](CHANGELOG.md) — published release history and the separate **Unreleased** development record (Keep a Changelog)
 - [`docs/RELEASE_PROCESS.md`](docs/RELEASE_PROCESS.md) — version bump, tag, and PyPI publish checklist
 - [`docs/CI_ASSURANCE.md`](docs/CI_ASSURANCE.md) — pull-request, scheduled, settings-managed, and release checks
 - [`docs/CODEQL.md`](docs/CODEQL.md) — CodeQL default setup (no custom `codeql.yml`)

{logseq_matryca_parser-1.10.0 → logseq_matryca_parser-1.11.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: logseq-matryca-parser
-Version: 1.10.0
+Version: 1.11.1
 Summary: The Logos Protocol: Deterministic Logseq AST parsing for Matryca.ai.
 Project-URL: Homepage, https://github.com/MarcoPorcellato/logseq-matryca-parser
 Project-URL: Repository, https://github.com/MarcoPorcellato/logseq-matryca-parser
@@ -59,7 +59,7 @@ Description-Content-Type: text/markdown
 
 [👉 **TRY THE LIVE INTERACTIVE DEMO**](https://MarcoPorcellato.github.io/logseq-matryca-parser/)
 
-[Quickstart](#quickstart) · [Documentation](docs/README.md) · [Roadmap](docs/ROADMAP_2026-2027.md) · [Cookbook](docs/COOKBOOK.md) · [Release highlights](RELEASE_HIGHLIGHTS.md) · [AI / LLM index](llms.txt)
+[Quickstart](#quickstart) · [Compatibility](#verified-logseq-markdown-compatibility) · [Documentation](docs/README.md) · [Roadmap](docs/ROADMAP_2026-2027.md) · [Cookbook](docs/COOKBOOK.md) · [Release highlights](RELEASE_HIGHLIGHTS.md) · [AI / LLM index](llms.txt)
 
 </div>
 
@@ -94,6 +94,22 @@ selected by the caller.
 
 ---
 
+## Verified Logseq Markdown compatibility
+
+**313/313 selected official Logseq Markdown documents passed our corpus checks.**
+
+Testing against a pinned official documentation snapshot found no parser
+exceptions, timeouts, or structural failures. Every input retained its exact
+source text, and returned nodes passed identity and tree-linkage checks.
+
+[Detailed compatibility report](docs/quality/OFFICIAL_LOGSEQ_MARKDOWN_COMPATIBILITY_2026-10-10.md) · [Per-document results](docs/quality/official_logseq_corpus_2026-10-10.json) · [Additional dataset study](docs/quality/LOGSEQ_MARKDOWN_DATASET_CANDIDATES_2026-10-10.md)
+
+These results verify the tested corpus and checks—not complete interpretation
+of every Logseq feature. Further datasets and semantic tests will extend this
+evidence; they are not included in the current results.
+
+---
+
 ## 🌐 The Vision: Virtual Centralization vs. Binary Lock-in
 
 The PKM (Personal Knowledge Management) world is currently forcing users to make a painful choice between **Data Longevity** and **AI Power**.
@@ -194,6 +210,13 @@ Logseq Matryca Parser is a deterministic **Stack-Machine engine** that acts as t
 | **Export and integrate — SYNAPSE, FORGE, LENS** | Lineage-aware LangChain exports and context-enriched chunks; LlamaIndex nodes through a separate companion; JSON and Markdown serialization, Obsidian vault generation, and interactive graph visualization. |
 | **Automate safely — KINETIC and agent tools** | CLI parse, scan, export, and visualization; token-efficient X-Ray reads; append-only logging; bounded AST writes; vault containment, dry-run patches, and atomic replacement. |
 
+The v1.11.0 release line also contains an **experimental, read-only Org
+reader** behind a private, non-stable API. It reads Org text or one selected
+`.org` file; it does not load a vault graph or claim complete GNU Org or
+Logseq semantics. Its diagnostics are selective, not a complete inventory of
+unsupported syntax. See the [API stability contract](docs/reference/API_STABILITY.md)
+and [release highlights](RELEASE_HIGHLIGHTS.md).
+
 The base parser is local-first and has zero telemetry. Optional AI, watcher, and
 visualization dependencies remain lazy. See the [architecture](docs/ARCHITECTURE.md)
 and [API stability reference](docs/reference/API_STABILITY.md) for exact boundaries.
@@ -345,6 +368,7 @@ We welcome issues, pull requests, and constructive feedback.
 | **Documentation index** | [docs/README.md](docs/README.md) — active vs historical docs |
 | **Documentation system** | [docs/DOCUMENTATION_SYSTEM.md](docs/DOCUMENTATION_SYSTEM.md) — authority, lifecycle, metadata, and federation |
 | **Roadmap** | [docs/ROADMAP_2026-2027.md](docs/ROADMAP_2026-2027.md) — milestones, dependencies, and evidence gates |
+| **Markdown compatibility evidence** | [Official Logseq corpus report](docs/quality/OFFICIAL_LOGSEQ_MARKDOWN_COMPATIBILITY_2026-10-10.md) — all 313 selected official documents passed raw-content and tree checks; semantic coverage and limits are explained |
 | **Support** | [SUPPORT.md](SUPPORT.md) — safe issue routing, support scope, and response boundaries |
 | **Governance** | [GOVERNANCE.md](GOVERNANCE.md) — decisions, maintainer path, and conflict handling |
 | **Agent safety** | [docs/reference/AGENT_ACTION_CONTRACT.md](docs/reference/AGENT_ACTION_CONTRACT.md) — authority, approvals, provenance, and prompt-injection boundary |
@@ -353,13 +377,21 @@ We welcome issues, pull requests, and constructive feedback.
 
 ## 📦 Release history
 
-Version 1.10.0 release notes are prepared, but the package has not yet been
-published to PyPI. The latest published release remains v1.9.0.
+Current source version: **v1.11.1**. The [PyPI project page](https://pypi.org/project/logseq-matryca-parser/) and
+[GitHub Releases](https://github.com/MarcoPorcellato/logseq-matryca-parser/releases) list available distributions.
+Security support follows the [latest-release policy](SECURITY.md).
+
+The v1.11.1 source includes fenced-code parsing fixes for outline items, eligible
+multiline scalar-metadata round trips, and bounded composite Markdown assurance.
+See the [changelog](CHANGELOG.md) for scope and limits.
 
 Read the complete [release highlights](RELEASE_HIGHLIGHTS.md), the exhaustive
 [changelog](CHANGELOG.md), or the signed artifacts on
 [GitHub Releases](https://github.com/MarcoPorcellato/logseq-matryca-parser/releases).
 
+- **v1.11.1** — Fixes fenced-code parsing in outline items, preserves eligible multiline scalar-metadata round trips, and adds bounded composite Markdown assurance.
+- **v1.11.0** — Adds an experimental, read-only Logseq Org reader with source retention and explicit support limits.
+- **v1.10.0** — Clarifies the LlamaIndex companion boundary and removes the Parser's NLTK dependency chain.
 - **v1.9.0** — Adds the stable in-memory snapshot graph factory, clarifies the Parser-Plumber boundary, and governs the temporary optional-NLTK advisory exception.
 - **v1.8.2** — Adds SHA-pinned hosted assurance, portable Windows local assurance, corrected cookbook recipes, consistent optional-AI guidance, and `Path | str` graph loading.
 - **v1.8.1** — Hardened deep-outline parsing, coherent incremental graph mutations, bounded assurance cleanup, and stable provenance for optional NLTK.
@@ -367,7 +399,7 @@ Read the complete [release highlights](RELEASE_HIGHLIGHTS.md), the exhaustive
 - **v1.7.1** — Added the runnable offline SYNAPSE RAG example and tightened release-note and optional-dependency security checks.
 - **v1.7.0** — Hardened parser correctness, graph diagnostics, writer safety, API stability, documentation governance, and release provenance.
 - **v1.6.0** — Clean Architecture v1 structural slices, new public graph APIs, layer-boundary CI, and documentation SSOT.
-- **v1.5.0** — Added opt-in CLI detection of unresolved block references for vault and CI hygiene.
+- **v1.5.0 (documented version)** — Added opt-in CLI detection of unresolved block references; no release artifacts are currently listed (see highlights).
 - **v1.4.2** — Fixed agent-write newline handling, controlled corrupt-state failures, and cyclic SYNAPSE page embeds.
 - **v1.4.1** — Expanded contributor tests and refreshed the good-first-issue onboarding path.
 - **v1.4.0** — Strengthened graph integrity, live reloads, serialization, path safety, strict references, and parser edge cases.

{logseq_matryca_parser-1.10.0 → logseq_matryca_parser-1.11.1}/README.md

@@ -20,7 +20,7 @@
 
 [👉 **TRY THE LIVE INTERACTIVE DEMO**](https://MarcoPorcellato.github.io/logseq-matryca-parser/)
 
-[Quickstart](#quickstart) · [Documentation](docs/README.md) · [Roadmap](docs/ROADMAP_2026-2027.md) · [Cookbook](docs/COOKBOOK.md) · [Release highlights](RELEASE_HIGHLIGHTS.md) · [AI / LLM index](llms.txt)
+[Quickstart](#quickstart) · [Compatibility](#verified-logseq-markdown-compatibility) · [Documentation](docs/README.md) · [Roadmap](docs/ROADMAP_2026-2027.md) · [Cookbook](docs/COOKBOOK.md) · [Release highlights](RELEASE_HIGHLIGHTS.md) · [AI / LLM index](llms.txt)
 
 </div>
 
@@ -55,6 +55,22 @@ selected by the caller.
 
 ---
 
+## Verified Logseq Markdown compatibility
+
+**313/313 selected official Logseq Markdown documents passed our corpus checks.**
+
+Testing against a pinned official documentation snapshot found no parser
+exceptions, timeouts, or structural failures. Every input retained its exact
+source text, and returned nodes passed identity and tree-linkage checks.
+
+[Detailed compatibility report](docs/quality/OFFICIAL_LOGSEQ_MARKDOWN_COMPATIBILITY_2026-10-10.md) · [Per-document results](docs/quality/official_logseq_corpus_2026-10-10.json) · [Additional dataset study](docs/quality/LOGSEQ_MARKDOWN_DATASET_CANDIDATES_2026-10-10.md)
+
+These results verify the tested corpus and checks—not complete interpretation
+of every Logseq feature. Further datasets and semantic tests will extend this
+evidence; they are not included in the current results.
+
+---
+
 ## 🌐 The Vision: Virtual Centralization vs. Binary Lock-in
 
 The PKM (Personal Knowledge Management) world is currently forcing users to make a painful choice between **Data Longevity** and **AI Power**.
@@ -155,6 +171,13 @@ Logseq Matryca Parser is a deterministic **Stack-Machine engine** that acts as t
 | **Export and integrate — SYNAPSE, FORGE, LENS** | Lineage-aware LangChain exports and context-enriched chunks; LlamaIndex nodes through a separate companion; JSON and Markdown serialization, Obsidian vault generation, and interactive graph visualization. |
 | **Automate safely — KINETIC and agent tools** | CLI parse, scan, export, and visualization; token-efficient X-Ray reads; append-only logging; bounded AST writes; vault containment, dry-run patches, and atomic replacement. |
 
+The v1.11.0 release line also contains an **experimental, read-only Org
+reader** behind a private, non-stable API. It reads Org text or one selected
+`.org` file; it does not load a vault graph or claim complete GNU Org or
+Logseq semantics. Its diagnostics are selective, not a complete inventory of
+unsupported syntax. See the [API stability contract](docs/reference/API_STABILITY.md)
+and [release highlights](RELEASE_HIGHLIGHTS.md).
+
 The base parser is local-first and has zero telemetry. Optional AI, watcher, and
 visualization dependencies remain lazy. See the [architecture](docs/ARCHITECTURE.md)
 and [API stability reference](docs/reference/API_STABILITY.md) for exact boundaries.
@@ -306,6 +329,7 @@ We welcome issues, pull requests, and constructive feedback.
 | **Documentation index** | [docs/README.md](docs/README.md) — active vs historical docs |
 | **Documentation system** | [docs/DOCUMENTATION_SYSTEM.md](docs/DOCUMENTATION_SYSTEM.md) — authority, lifecycle, metadata, and federation |
 | **Roadmap** | [docs/ROADMAP_2026-2027.md](docs/ROADMAP_2026-2027.md) — milestones, dependencies, and evidence gates |
+| **Markdown compatibility evidence** | [Official Logseq corpus report](docs/quality/OFFICIAL_LOGSEQ_MARKDOWN_COMPATIBILITY_2026-10-10.md) — all 313 selected official documents passed raw-content and tree checks; semantic coverage and limits are explained |
 | **Support** | [SUPPORT.md](SUPPORT.md) — safe issue routing, support scope, and response boundaries |
 | **Governance** | [GOVERNANCE.md](GOVERNANCE.md) — decisions, maintainer path, and conflict handling |
 | **Agent safety** | [docs/reference/AGENT_ACTION_CONTRACT.md](docs/reference/AGENT_ACTION_CONTRACT.md) — authority, approvals, provenance, and prompt-injection boundary |
@@ -314,13 +338,21 @@ We welcome issues, pull requests, and constructive feedback.
 
 ## 📦 Release history
 
-Version 1.10.0 release notes are prepared, but the package has not yet been
-published to PyPI. The latest published release remains v1.9.0.
+Current source version: **v1.11.1**. The [PyPI project page](https://pypi.org/project/logseq-matryca-parser/) and
+[GitHub Releases](https://github.com/MarcoPorcellato/logseq-matryca-parser/releases) list available distributions.
+Security support follows the [latest-release policy](SECURITY.md).
+
+The v1.11.1 source includes fenced-code parsing fixes for outline items, eligible
+multiline scalar-metadata round trips, and bounded composite Markdown assurance.
+See the [changelog](CHANGELOG.md) for scope and limits.
 
 Read the complete [release highlights](RELEASE_HIGHLIGHTS.md), the exhaustive
 [changelog](CHANGELOG.md), or the signed artifacts on
 [GitHub Releases](https://github.com/MarcoPorcellato/logseq-matryca-parser/releases).
 
+- **v1.11.1** — Fixes fenced-code parsing in outline items, preserves eligible multiline scalar-metadata round trips, and adds bounded composite Markdown assurance.
+- **v1.11.0** — Adds an experimental, read-only Logseq Org reader with source retention and explicit support limits.
+- **v1.10.0** — Clarifies the LlamaIndex companion boundary and removes the Parser's NLTK dependency chain.
 - **v1.9.0** — Adds the stable in-memory snapshot graph factory, clarifies the Parser-Plumber boundary, and governs the temporary optional-NLTK advisory exception.
 - **v1.8.2** — Adds SHA-pinned hosted assurance, portable Windows local assurance, corrected cookbook recipes, consistent optional-AI guidance, and `Path | str` graph loading.
 - **v1.8.1** — Hardened deep-outline parsing, coherent incremental graph mutations, bounded assurance cleanup, and stable provenance for optional NLTK.
@@ -328,7 +360,7 @@ Read the complete [release highlights](RELEASE_HIGHLIGHTS.md), the exhaustive
 - **v1.7.1** — Added the runnable offline SYNAPSE RAG example and tightened release-note and optional-dependency security checks.
 - **v1.7.0** — Hardened parser correctness, graph diagnostics, writer safety, API stability, documentation governance, and release provenance.
 - **v1.6.0** — Clean Architecture v1 structural slices, new public graph APIs, layer-boundary CI, and documentation SSOT.
-- **v1.5.0** — Added opt-in CLI detection of unresolved block references for vault and CI hygiene.
+- **v1.5.0 (documented version)** — Added opt-in CLI detection of unresolved block references; no release artifacts are currently listed (see highlights).
 - **v1.4.2** — Fixed agent-write newline handling, controlled corrupt-state failures, and cyclic SYNAPSE page embeds.
 - **v1.4.1** — Expanded contributor tests and refreshed the good-first-issue onboarding path.
 - **v1.4.0** — Strengthened graph integrity, live reloads, serialization, path safety, strict references, and parser edge cases.

{logseq_matryca_parser-1.10.0 → logseq_matryca_parser-1.11.1}/RELEASE_HIGHLIGHTS.md

@@ -7,12 +7,48 @@ published artifacts and attestations, see
 
 ## Unreleased
 
-The Parser is separating native LlamaIndex export into a companion package.
-The compatibility method remains, but the proposed companion is not yet
-published; Parser `[ai]` provides LangChain, while `[all]` also includes
-visualization dependencies. Neither extra installs LlamaIndex or NLTK. See
-the [support matrix](docs/reference/CONFORMANCE_SUPPORT_MATRIX.md) for the
-current boundary.
+No changes are currently listed. See the [changelog](CHANGELOG.md) for the
+current source record.
+
+## v1.11.1
+
+
+The v1.11.1 changes fix fenced-code parsing in outline items, preserve eligible
+multiline scalar metadata and explicit block UUIDs across round trips, and add
+bounded synthetic Markdown assurance.
+
+| Area | Change |
+| :--- | :--- |
+| **Fenced code in outline items** | Recognizes list-item fence openers and closes only on a matching delimiter type with sufficient width and a whitespace-only suffix; preserves raw payload, source spans, and neighboring block attachment. |
+| **Multiline scalar metadata** | Emits eligible genuine single-line scalar properties before prose continuations, preserving metadata and explicit block UUIDs when parsed again. |
+| **Composite Markdown assurance** | Adds bounded synthetic cases for outline shape, source spans, tasks, dates, metadata, references, and semantic round trips; does not claim exhaustive Markdown coverage. |
+
+## v1.11.0
+
+Published on 2026-10-02:
+[GitHub Release](https://github.com/MarcoPorcellato/logseq-matryca-parser/releases/tag/v1.11.0)
+and [PyPI package](https://pypi.org/project/logseq-matryca-parser/1.11.0/).
+
+Minor release — adds an experimental, read-only Logseq Org reader while keeping
+the existing Markdown parser and graph workflow unchanged.
+
+| Area | Change |
+| :--- | :--- |
+| **Org input** | Parses Org text or one caller-selected `.org` file without loading a vault graph; the API remains private and non-stable. |
+| **Scope and diagnostics** | Diagnostics cover selected conditions, not every unsupported construct. Preserved source text or no diagnostic does not establish that Org or Logseq semantics were understood; inspect the original source when needed. |
+| **Source archive hygiene** | Excludes selected ignored local maintainer and tool-cache directories from source distributions; runtime behavior is unchanged. |
+| **Development-toolchain security** | Updates the locked `virtualenv` dependency from 21.5.1 to 21.14.4 for four Dependabot advisories in the `pre-commit` chain; published runtime dependencies are unchanged. |
+
+## v1.10.0
+
+Minor release — clarifies the native LlamaIndex companion boundary and removes
+the Parser's NLTK dependency chain. No intentional breaking changes to the
+existing package API or CLI behavior.
+
+| Area | Change |
+| :--- | :--- |
+| **LlamaIndex boundary** | Keeps `SynapseAdapter.to_llamaindex_nodes()` as a lazy compatibility shim while native node construction moves to a separate companion. |
+| **Dependency security** | Removes `llama-index-core` and NLTK from Parser extras, lock, and package metadata; the `[ai]` extra provides LangChain and `[all]` also adds visualization dependencies. |
 
 ## v1.9.0
 
@@ -109,6 +145,10 @@ Minor release — Clean Architecture v1 structural slices, new public graph APIs
 
 ## v1.5.0
 
+Historical version entry: no v1.5.0 tag, GitHub Release, or PyPI distributions
+are currently listed (verified 2026-10-04). These notes preserve the documented
+source changes; they are not evidence of package publication.
+
 Minor release — CLI vault hygiene for broken block references. **No intentional
 breaking changes** to default `scan` behavior (`--broken-refs` is opt-in).
 

{logseq_matryca_parser-1.10.0 → logseq_matryca_parser-1.11.1}/SECURITY.md

@@ -2,15 +2,14 @@
 
 ## Supported Versions
 
-Security fixes are provided **only for the latest released version** on [PyPI](https://pypi.org/project/logseq-matryca-parser/). The latest supported release is v1.9.0.
+Security fixes are provided **only for the latest release on PyPI**. Check the [PyPI project page](https://pypi.org/project/logseq-matryca-parser/) for the currently published version.
 
-Version 1.10.0 release preparation does not change this support status; it will
-do so only after publication to PyPI.
+Unreleased changes on `main` do not change the supported package version.
 
-| Version | Supported |
+| Release | Supported |
 | ------- | --------- |
-| **1.9.0** (latest released) | Yes |
-| 1.8.2 and older | No |
+| Latest release on PyPI | Yes |
+| Older releases | No |
 
 We recommend always running the current release and upgrading promptly when a security advisory is published.
 

{logseq_matryca_parser-1.10.0 → logseq_matryca_parser-1.11.1}/SUPPORT.md

@@ -36,6 +36,12 @@ model-provider support, or compatibility with undocumented private APIs. Optiona
 AI and visualization integrations remain separately documented and may have
 their own dependency or upstream support requirements.
 
+The experimental Org reader in the v1.11.0 release line is an internal,
+non-stable interface, not part of the supported public API. It does not load a
+vault graph or promise full Org or Logseq semantics. Its selected diagnostics do
+not identify every unsupported construct; see the
+[API stability contract](docs/reference/API_STABILITY.md) before relying on it.
+
 Security response expectations are defined in [`SECURITY.md`](SECURITY.md).
 General issue response time depends on maintainer availability; opening an issue
 does not guarantee a feature or a fixed release date.

{logseq_matryca_parser-1.10.0 → logseq_matryca_parser-1.11.1}/docs/CLEAN_CODE_ARCHITECTURE.md

@@ -8,9 +8,9 @@ audience: contributors
 owner: logseq-matryca-parser
 authority: source_repository
 execution_mode: reviewed
-last_verified: 2026-09-27
-verified: 2026-09-27
-stale_after: 2027-03-26
+last_verified: 2026-10-04
+verified: 2026-10-04
+stale_after: 2027-03-31
 okf_profile: matryca_okf_inspired_quality
 okf_spec_version: null
 supersedes: null
@@ -19,7 +19,7 @@ superseded_by: null
 
 # Clean Code & Clean Architecture — Logseq Matryca Parser
 
-**Version:** documents maintainer contracts refreshed for **v1.10.0** release preparation; v1.10.0 is not yet published (v1 structural backlog complete; parser, graph-coherence, local-assurance, and stable snapshot-graph slices merged)
+**Version:** maintainer contracts refreshed for **v1.11.0**, published on 2026-10-02; the release includes the experimental Org-reader slice (v1 structural backlog complete; parser, graph-coherence, local-assurance, and stable snapshot-graph slices merged)
 **Audience:** contributors and Cursor agents patching `src/logseq_matryca_parser/`  
 **Companion:** [`ARCHITECTURE.md`](ARCHITECTURE.md) (LOGOS domain contract) · [`BUG_HUNT_REPORT.md`](BUG_HUNT_REPORT.md) (audit evidence) · [`CONTRIBUTING.md`](../CONTRIBUTING.md)
 

{logseq_matryca_parser-1.10.0 → logseq_matryca_parser-1.11.1}/docs/README.md

@@ -8,9 +8,9 @@ audience: contributors
 owner: logseq-matryca-parser
 authority: source_repository
 execution_mode: reviewed
-last_verified: 2026-08-30
-verified: 2026-08-30
-stale_after: 2027-02-26
+last_verified: 2026-10-10
+verified: 2026-10-10
+stale_after: 2027-03-31
 okf_profile: matryca_okf_inspired_quality
 okf_spec_version: null
 supersedes: null
@@ -45,6 +45,8 @@ entry points.
 | [`CLEAN_CODE_ARCHITECTURE.md`](CLEAN_CODE_ARCHITECTURE.md) | Contributors, maintainers | Uncle Bob rings, SOLID, module maps, layer CI |
 | [`ARCHITECTURE.md`](ARCHITECTURE.md) | Contributors, integrators | LOGOS, SYNAPSE, `LogseqGraph`, agents, data flow |
 | [`quality/`](quality/) | Maintainers | Architecture backlog (v1 complete), GitHub roadmap, triage |
+| [`quality/OFFICIAL_LOGSEQ_MARKDOWN_COMPATIBILITY_2026-10-10.md`](quality/OFFICIAL_LOGSEQ_MARKDOWN_COMPATIBILITY_2026-10-10.md) | Users, integrators, maintainers | Evidence from all 313 selected official Logseq documents, metadata-only semantics, test coverage and remaining limits |
+| [`quality/LOGSEQ_MARKDOWN_DATASET_CANDIDATES_2026-10-10.md`](quality/LOGSEQ_MARKDOWN_DATASET_CANDIDATES_2026-10-10.md) | Parser contributors, maintainers | Additional public corpus candidates, content rights, syntax diversity and proposed admission sequence |
 | [`internal/LOCAL_CODE_STUDY.md`](internal/LOCAL_CODE_STUDY.md) | Maintainers | Local code audit runbook (graph-based MCP) |
 | [`logseq_ast_primer.md`](logseq_ast_primer.md) | Parser contributors | Logseq Spatial Markdown domain rules |
 | [`GOOD_FIRST_ISSUES.md`](GOOD_FIRST_ISSUES.md) | New contributors | Curated starter tasks; Clean Architecture v1 shipped in **v1.6.0** ([#78](https://github.com/MarcoPorcellato/logseq-matryca-parser/issues/78)) |
@@ -55,8 +57,12 @@ entry points.
 | [`REPOSITORY_STELLAR_ROADMAP_2026-08-06.md`](REPOSITORY_STELLAR_ROADMAP_2026-08-06.md) | Maintainers, contributors | Dated evidence-backed audit baseline, confirmed defects, and original issue map; the public roadmap is the current execution view |
 | [`REPOSITORY_GOVERNANCE_AAIF_STUDY_2026-08-19.md`](REPOSITORY_GOVERNANCE_AAIF_STUDY_2026-08-19.md) | Maintainers | GitHub governance, supply-chain, agent interoperability, and AAIF-readiness study |
 | [`LSDOC_REFERENCE_STUDY_AND_EXECUTION_PLAN_2026-08-16.md`](LSDOC_REFERENCE_STUDY_AND_EXECUTION_PLAN_2026-08-16.md) | Maintainers, parser contributors | License-safe comparative study and execution plan for semantic, complexity, and source-location assurance |
+| [`superpowers/specs/2026-09-29-logseq-org-parser-design.md`](superpowers/specs/2026-09-29-logseq-org-parser-design.md) | Maintainers | Approved, review-gated design for a read-only Org parser scoped to Logseq OG file graphs |
+| [`superpowers/plans/2026-09-29-logseq-org-parser.md`](superpowers/plans/2026-09-29-logseq-org-parser.md) | Maintainers | D2 implementation and six-cell hosted qualification; D3 deferred and Markdown parser work prioritized |
+| [`internal/LOGSEQ_ORG_PARSER_EXPERIMENTAL_STATUS.md`](internal/LOGSEQ_ORG_PARSER_EXPERIMENTAL_STATUS.md) | Maintainers | Experimental Org subset, selected diagnostics, explicit non-conformance limits, and deferred scope |
+| [`internal/LLAMAINDEX_COMPANION_MIGRATION_CHECKPOINT_2026-09-27.md`](internal/LLAMAINDEX_COMPANION_MIGRATION_CHECKPOINT_2026-09-27.md) | Maintainers | Historical Parser/companion checkpoint with a dated 2026-10-02 live-status refresh |
 | [`README_READABILITY_REPORT_2026-08-08.md`](README_READABILITY_REPORT_2026-08-08.md) | Maintainers | Measured human and AI README assessment with a phased simplification proposal |
-| [`quality/OPEN_ISSUE_RECONCILIATION_2026-09-24.md`](quality/OPEN_ISSUE_RECONCILIATION_2026-09-24.md) | Maintainers | Current disposition of all 33 live open issues and four open PRs |
+| [`quality/OPEN_ISSUE_RECONCILIATION_2026-09-24.md`](quality/OPEN_ISSUE_RECONCILIATION_2026-09-24.md) | Maintainers | Dated 2026-09-24 issue/PR snapshot; rebind live GitHub state before acting |
 | [`decisions/index.md`](decisions/index.md) | Maintainers | Canonical decision registry, including the external-oracle boundary |
 | [`reference/index.md`](reference/index.md) | Maintainers, integrators | Provenance and Matryca ecosystem relations |
 | [`reference/DIAGNOSTICS.md`](reference/DIAGNOSTICS.md) | Integrators, contributors | Stable diagnostic codes, payload schema, path safety, CLI rendering, and escalation |

{logseq_matryca_parser-1.10.0 → logseq_matryca_parser-1.11.1}/docs/RELEASE_PROCESS.md

@@ -48,6 +48,8 @@ version; use `vX.Y.Z` for the git tag).
 - [ ] Leave an empty `## [Unreleased]` section at the top
 - [ ] Set `__version__ = "X.Y.Z"` in `src/logseq_matryca_parser/_version.py`; the pinned Hatchling backend derives package metadata from this single source
 - [ ] Update `README.md`, `SECURITY.md`, and contributor-facing current-version references
+- [ ] Reconcile `RELEASE_HIGHLIGHTS.md`, support/API contracts, `AGENTS.md`, `llms.txt`, and maintained documentation indexes with shipped capabilities; keep historical records dated and append current status rather than rewriting past evidence
+- [ ] Audit the exact source distribution for ignored local caches, maintainer state, private paths, and secret-like values; do not rely on a clean checkout assumption alone
 - [ ] Verify every file, command, issue disposition, and shipped capability
       named in the versioned changelog against the exact release commit
 - [ ] Run `make all` (Ruff, Mypy, documentation checks, and Pytest)