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

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

@@ -7,6 +7,31 @@ 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

{logseq_matryca_parser-1.11.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) — **1.11.0** release candidate; as of 2026-10-02, latest published version is **1.10.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.11.0 → logseq_matryca_parser-1.11.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: logseq-matryca-parser
-Version: 1.11.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**.
@@ -352,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 |
@@ -360,14 +377,19 @@ We welcome issues, pull requests, and constructive feedback.
 
 ## 📦 Release history
 
-As of 2026-10-02, version 1.11.0 is prepared but not published; v1.10.0 is the
-latest published and supported release. Preparing these notes does not publish
-a package or change support status.
+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.
@@ -377,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.11.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**.
@@ -313,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 |
@@ -321,14 +338,19 @@ We welcome issues, pull requests, and constructive feedback.
 
 ## 📦 Release history
 
-As of 2026-10-02, version 1.11.0 is prepared but not published; v1.10.0 is the
-latest published and supported release. Preparing these notes does not publish
-a package or change support status.
+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.
@@ -338,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.11.0 → logseq_matryca_parser-1.11.1}/RELEASE_HIGHLIGHTS.md

@@ -7,12 +7,27 @@ published artifacts and attestations, see
 
 ## Unreleased
 
-No unreleased highlights are currently recorded.
+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
 
-Status note dated 2026-10-02: this release is prepared but not yet published;
-v1.10.0 remains the latest published package as of that date.
+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.
@@ -22,6 +37,7 @@ the existing Markdown parser and graph workflow unchanged.
 | **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
 
@@ -129,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.11.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/). As of 2026-10-02, the latest supported release is v1.10.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.11.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.10.0** (latest released) | Yes |
-| 1.9.0 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.11.0 → logseq_matryca_parser-1.11.1}/docs/CLEAN_CODE_ARCHITECTURE.md

@@ -8,8 +8,8 @@ audience: contributors
 owner: logseq-matryca-parser
 authority: source_repository
 execution_mode: reviewed
-last_verified: 2026-10-02
-verified: 2026-10-02
+last_verified: 2026-10-04
+verified: 2026-10-04
 stale_after: 2027-03-31
 okf_profile: matryca_okf_inspired_quality
 okf_spec_version: null
@@ -19,7 +19,7 @@ superseded_by: null
 
 # Clean Code & Clean Architecture — Logseq Matryca Parser
 
-**Version:** maintainer contracts refreshed for the **v1.11.0** release cycle; the release candidate includes the experimental Org-reader slice (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.11.0 → logseq_matryca_parser-1.11.1}/docs/README.md

@@ -8,8 +8,8 @@ audience: contributors
 owner: logseq-matryca-parser
 authority: source_repository
 execution_mode: reviewed
-last_verified: 2026-10-02
-verified: 2026-10-02
+last_verified: 2026-10-10
+verified: 2026-10-10
 stale_after: 2027-03-31
 okf_profile: matryca_okf_inspired_quality
 okf_spec_version: 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)) |

logseq_matryca_parser-1.11.1/docs/ROADMAP_2026-2027.md

@@ -0,0 +1,255 @@
+---
+type: PublicRoadmap
+title: Public roadmap for 2026–2027
+description: Dependency-ordered roadmap for repository trust, documentation, assurance, community, and interoperability.
+status: stable
+classification: active
+audience: contributors
+owner: logseq-matryca-parser
+authority: source_repository
+execution_mode: reviewed
+last_verified: 2026-10-11
+verified: 2026-10-11
+stale_after: 2026-11-17
+okf_profile: matryca_okf_inspired_quality
+okf_spec_version: null
+supersedes: null
+superseded_by: null
+---
+
+# Public roadmap for 2026–2027
+
+This is the canonical public navigation view for the GitHub, assurance,
+interoperability, and AAIF-readiness programme.
+The detailed evidence, exclusions, and historical anchors remain in the
+[readiness study](REPOSITORY_GOVERNANCE_AAIF_STUDY_2026-08-19.md). It is a
+roadmap, not a release promise or an AAIF submission claim.
+
+## Status vocabulary
+
+| Status | Meaning |
+|---|---|
+| Completed locally | Source changes and local checks are complete; publication is recorded separately |
+| In progress | An owner is actively working within a defined scope |
+| Waiting for evidence | Requires current external, release, security, or adoption evidence |
+| Research only | A bounded study is authorized, but no product implementation is committed |
+| Deferred | Intentionally postponed until a dependency or user need exists |
+
+## Milestones
+
+| Milestone | Status | Owner | Dependency | Exit evidence |
+|---|---|---|---|---|
+| M0 — Public baseline | Waiting for evidence | Maintainer | Valid GitHub API access | Exact `main` SHA, rulesets, Actions permissions, security features, and issue/PR/project receipt |
+| M1 — Governance minimum | Completed locally | Maintainer | Documentation review | Governance, maintainers, support, citation, and AI-contribution documents linked and passing the docs gate |
+| M2 — Supply-chain proof | Completed for v1.8.1 | Release owner | M0 and a real tag | v1.8.1 hosted release evidence plus the stable NLTK registry declaration, regenerated lock, package contract, SBOM, dependency/license inventory, checksums, and attestations ([#186](https://github.com/MarcoPorcellato/logseq-matryca-parser/issues/186)) |
+| M3 — Documentation convergence | Migration gate recorded | Documentation owner | Matryca Knowledge profile decision | Current provenance references, dual-profile audit, and reviewed projection evidence without rewriting history |
+| M4 — Semantic assurance | In progress | Parser owner | Exact-head parser evidence | Coherent graph mutation publication is complete in v1.8.1 ([#103](https://github.com/MarcoPorcellato/logseq-matryca-parser/issues/103)); remaining exits are bounded property generation built on existing semantic profiles ([#104](https://github.com/MarcoPorcellato/logseq-matryca-parser/issues/104)) and reproducible performance decisions ([#111](https://github.com/MarcoPorcellato/logseq-matryca-parser/issues/111)) |
+| M5 — Community durability | In progress | Maintainers | M0 and sustained contributor activity | Triage policy, current label taxonomy, public roadmap, response measurement, and independent reviewer path |
+| M6 — Interoperability and adoption | Research only; adapters deferred | Product and community | M4 and permissioned use cases | Synthetic Logseq DB export-conformance report ([#185](https://github.com/MarcoPorcellato/logseq-matryca-parser/issues/185)); any adapter remains a later decision |
+| M7 — AAIF decision gate | NO-GO recorded | Maintainer and legal reviewer | M0–M6 | A future reconsideration record supported by a completed evidence matrix |
+
+## Current delivery focus
+
+The 2026-10-11 update verifies the #104 assurance and publication follow-ups
+below. Older milestone and delivery records retain their stated evidence
+dates; this is not a fresh audit of every roadmap item.
+
+1. Extend [#104](https://github.com/MarcoPorcellato/logseq-matryca-parser/issues/104)
+   with bounded Hypothesis strategies that reuse `semantic_roundtrip_v1`, the
+   fixture-specific identity policy, deterministic replay, and the existing
+   classification vocabulary. A partial local increment now checks bounded,
+   grammar-valid synthetic outlines and semantic round trips; focused and full
+   local quality/package gates passed on 2026-09-26 using source `HEAD`
+   `d85ea35ec2dbd37f5121d5052bf1e481bded973d` plus the uncommitted Task 1–3
+   worktree changes. This does not close `#104`. It does not claim general parser
+   correctness or a hard timeout; existing M3 adversarial, replay, and
+   parent-enforced timeout evidence remains separate and authoritative.
+   The [malformed Markdown tranche](superpowers/plans/2026-10-03-hypothesis-malformed-markdown.md)
+   now adds source-free recipe replay and opt-in generated execution through
+   the existing isolated runner, without changing the production parser.
+   Its broad local profile passed sixty cases (48 parsed, 12 typed strict-reference
+   errors); independent review passed after tightening the error-type oracle.
+   Post-review local quality gates passed: 1064 tests, five native-platform
+   skips, 89.79% coverage, package checks, and bounded artifact inspection.
+   It does not close #104 or replace valid-input semantic projections.
+   Its diagnostic follow-up passed 1070 local tests and the hosted matrix;
+   PR #232 is merged, with successful post-merge CI at
+   `3070a8f1d788a295849ad34f263f63ef83b464ab`. The initial Windows failure's
+   cause remains unknown.
+   The approved [graph construction increment](quality/GRAPH_PROPERTY_ASSURANCE_2026-10-03.md)
+   is locally implemented and reviewed: a bounded synthetic model checks page
+   order, alias identity, backlink routing, and disk/snapshot parity. Eleven
+   focused tests pass; Sol re-review returned PASS; the full local gate passed
+   with 1081 tests, five platform skips, and 89.79% coverage. The increment is
+   recorded at the original uncommitted local qualification checkpoint.
+   Subsequent PR #233 passed all fourteen hosted checks and was squash-merged
+   as `0e2b0187ddc54abd92f6a50e7dbde5166e474ffd`; its
+   [post-merge CI](https://github.com/MarcoPorcellato/logseq-matryca-parser/actions/runs/37112297184)
+   passed all nine jobs, including six native-platform combinations.
+   The next approved [composite valid Markdown increment](quality/COMPOSITE_MARKDOWN_ASSURANCE_2026-10-03.md)
+   initially encountered a blocking local smoke finding: the original-input model passed in a
+   diagnostic attempt, but semantic round-trip comparison failed. Draft
+   harness reporting defects are recorded separately. Task/property/reference
+   interactions and original source spans remain the selected coverage focus;
+   no broad run or full qualification is complete. Sol diagnosis returned
+   BLOCKED; the maintainer subsequently approved test-only harness repairs and
+   one separately bounded diagnostic. Thirty-five parser-free harness tests
+   and static checks pass. The reviewed one-child diagnostic confirms semantic
+   differences in content and metadata fields; it stopped without retry.
+   The maintainer separately approved a
+   [bounded scalar serializer correction](superpowers/plans/2026-10-03-scalar-metadata-serialization.md)
+   and accepted its CRITICAL impact warning. The bounded local correction has
+   RED/GREEN evidence, 312 passing focused regressions, Sol High implementation
+   review PASS_WITH_NOTES, and passing complete quality gates: 1,153 tests, five
+   native-platform skips, and 89.83% coverage. It remains uncommitted and is not
+   hosted or release qualification. Generic replay execution and within-block deduplication
+   coverage remain incomplete; no broad campaign or publication is authorized.
+   The maintainer approved a schema-3 developmental replay repair with complete
+   local source inventory and selected runtime compatibility, not runtime-byte
+   attestation. Its first checkpoint passed 49 parser-free controls but Sol High
+   review found five missing entry-point/probe/error/inventory/metadata cases.
+   The bounded repair is now locally complete: 79 guarded parser-free controls,
+   focused static checks and final Sol High PASS, after resolving all five
+   findings and strengthening one assertion. At that repair checkpoint no actual child or replay ran;
+   smoke/broad execution, full-suite requalification of the new harness bytes
+   and publication remain separate gates. Runtime-byte attestation is not claimed.
+   A subsequently authorized single smoke stopped after two children: the
+   original three-block literal case passed its model and round-trip; a nested
+   CRLF/Unicode case failed an original-input assertion before round-trip.
+   Source/worker provenance remained valid, but the campaign failed. Subsequent
+   read-only Luna diagnosis and Sol High PASS_WITH_NOTES independently establish
+   two August oracle epoch literals offset by +28,800 seconds. The historical
+   assertion remains unidentified; no additional production defect is proved.
+   The subsequently approved parser-free repair corrected only those literals
+   after expected RED, added independent controls for all four dates, passed
+   84 guarded tests and focused static checks, and received Sol High PASS.
+   A subsequently authorized fresh one-child evaluation passed the previously
+   failing August recipe's model and semantic round-trip, with unchanged
+   production bytes and valid source/runtime provenance. Independent receipt
+   checks validated it; Sol High interpretation review returned PASS_WITH_NOTES.
+   This strongly supports the oracle explanation but does not recover the old
+   assertion. Historical smoke remains failed. A separately authorized fresh
+   smoke now passes all three recorded cases under cap four, including the
+   mixed thirty-two-block input. Independent Luna receipt validation returned
+   VALIDATED; Sol High phase review returned PASS_WITH_NOTES. Source/context
+   and protected hashes remained unchanged. No fourth distinct generated case,
+   full-suite, package or release readiness was claimed from that smoke alone.
+   The subsequent authorized broad profile passed 119 recipes representing
+   117 distinct sources across fixed seeds 104/417/911, under cap 120, with
+   no retry. Luna VALIDATED; Sol High PASS_WITH_NOTES. The earlier composite
+   complete quality gate passed 1,202 tests, five native-platform skips and 89.83%
+   coverage. An earlier offline package attempt stopped before Twine execution;
+   a separately authorized final cycle subsequently passed build, wheel contract,
+   Twine 6.2.0, isolated wheel-installed Mypy 1.20.2 and bounded artifact checks.
+   Sol High returned PASS_WITH_NOTES without blockers. Earlier failed attempts
+   remain historical. The maintainer authorized the documentary completion
+   update, commit, push and draft PR on 2026-10-04. Those publication gates
+   subsequently passed. PR #234 was squash-merged as
+   `a26370a73d0c1ec99eb186e0131044a23e4acb00`; its
+   [post-merge CI](https://github.com/MarcoPorcellato/logseq-matryca-parser/actions/runs/37185041499)
+   passed all six native combinations and the rebuilt package contract.
+   PR #237 then aligned the README and release history, with successful
+   [post-merge CI](https://github.com/MarcoPorcellato/logseq-matryca-parser/actions/runs/37191353787).
+   The preceding local checkpoints remain historical; the composite change
+   remains unreleased and #104 remains open.
+   The subsequent shielding tranche is implemented in one test file for closed
+   inline code, HTML comments and single/double-dollar math. Four hand-checked
+   anchors precede finite generated variations, capped at twenty distinct
+   recipes and forty parses per selected loop. Independent expectations check
+   visible link/tag multiplicity, occurrence order, links-before-tags stable
+   reference deduplication, exact content and one-line spans. Parser-free
+   corruption controls and existing tree/exact-projection helpers support the
+   oracle. No production change, new dependency, replay framework or broad
+   campaign is included. Fifteen focused tests pass; the observed selection
+   contains twenty recipes and forty parses, with no parser failure. After a
+   test-only typing correction, the fresh complete local gate passed 1,217
+   tests, five platform skips and 89.83% coverage. Independent GPT-6.1 Sol
+   Medium implementation review returned PASS_WITH_NOTES; its historical-
+   checkpoint wording note is addressed. Separate publication and merge
+   authorization followed: [PR #238](https://github.com/MarcoPorcellato/logseq-matryca-parser/pull/238)
+   passed all fourteen hosted checks and was squash-merged as
+   `bda44e60a36cfa73d086159fa7dabea8f29dd519` on 2026-10-04.
+   Its [post-merge CI](https://github.com/MarcoPorcellato/logseq-matryca-parser/actions/runs/37202912593)
+   passed quality, dependency and package checks and all six native OS/Python
+   combinations. Separate post-merge security checks also passed. These are
+   exact-commit hosted results; the shielding tranche remains unreleased.
+   A separate [randomized multiline shielding follow-up](quality/COMPOSITE_MARKDOWN_ASSURANCE_2026-10-03.md#follow-up-bounded-randomized-multiline-shielding)
+   remains local and unpublished. Its single 2026-10-04 macOS pilot passed
+   sixteen parse-only evaluations from eight unique LF/CRLF-paired recipes
+   with closed comments and fences. On 2026-10-11, corrected cleanup,
+   output-cap, and optimized-runtime qualification controls detected four
+   selected injected faults; all 68 focused tests passed. The helper is
+   unchanged and no new pilot was run. These are bounded local results,
+   not hosted qualification of the pending bytes or complete Markdown support.
+   Separately, the [313-document official-corpus report](quality/OFFICIAL_LOGSEQ_MARKDOWN_COMPATIBILITY_2026-10-10.md)
+   was published through PR #239 with a successful exact-commit post-merge
+   matrix. Its structural/raw-source result does not establish complete
+   semantic conformance or retroactively strengthen the randomized oracle.
+   Remaining Hypothesis-specific expansions include broader graph/filesystem
+   behavior and concurrency; broader syntax coverage requires separately
+   bounded slices. The new increment does not close #104.
+2. Use [#111](https://github.com/MarcoPorcellato/logseq-matryca-parser/issues/111)
+   to compare serial, thread, and process execution plus repeated unchanged
+   loads. Record separate GO/NO-GO decisions before proposing a persistent cache
+   or changing the default executor.
+3. Continue [#108](https://github.com/MarcoPorcellato/logseq-matryca-parser/issues/108)
+   only through bounded child slices for the residual reducer, semantic
+   enrichment, final equivalence, and benchmark gates. The delivered line
+   classifier and lexical-state object remain accepted foundations.
+4. Reconcile [#109](https://github.com/MarcoPorcellato/logseq-matryca-parser/issues/109)
+   and [#110](https://github.com/MarcoPorcellato/logseq-matryca-parser/issues/110)
+   against the maintained documentation and diagnostics contracts. Close only
+   the acceptance criteria proven by exact source and private-profile evidence.
+5. Run [#185](https://github.com/MarcoPorcellato/logseq-matryca-parser/issues/185)
+   as a synthetic, read-only Logseq DB export-conformance study. Classify
+   semantics as preserved, transformed, lost, unsupported, or unknown without
+   claiming a DB adapter.
+6. Keep documentation and the Matryca Knowledge source profile aligned through
+   reviewed source and projection changes, preserving the measured official
+   OKF backlog until the profile conflict is resolved.
+
+## Evidence-gated improvement decisions
+
+| Decision | Existing surface | Entry gate | Exit evidence | No automatic inference |
+|---|---|---|---|---|
+| Coherent in-process graph mutations | #103 / merged #180 | Completed in v1.8.1 | Full local and hosted checks plus independent concurrency review | No cross-process or deep-immutable snapshot claim |
+| Stable NLTK registry source | #186 / merged #189 | Completed in v1.8.1 | Stable declaration, regenerated lock, audit, inventory, package and full quality gates | No blanket advisory or license exception |
+| Property-based parser assurance | #104 | Existing corpus and projections remain authoritative | Bounded strategies, deterministic replay, semantic/invariant regressions | No byte-equality or universal synthetic-UUID promise |
+| Cache and executor choice | #111 | Thresholds and resource envelope declared before measurement | Source-free comparative receipts and two explicit GO/NO-GO decisions | No cache or `ProcessPoolExecutor` implementation from source inspection alone |
+| Logseq DB interoperability | #185 | Synthetic versioned export available | Reproducible conformance report with observed transformation classes | No SQLite dependency, reader, writer, migration, or sync commitment |
+
+## GitHub planning surfaces
+
+- The public [Evidence-Gated Roadmap project](https://github.com/users/MarcoPorcellato/projects/5)
+  mirrors operational status, track, evidence level, risk, and next gate. This
+  versioned roadmap remains the canonical programme contract.
+- **Parser Assurance: M3-M7** remains open for #104, #108, and #111; #103 is
+  complete.
+- **Evidence-gated improvements** retains research item #185; completed
+  supply-chain item #186 remains attached as milestone evidence.
+- The legacy **v1.0 GUI** milestone is closed; issue #3 remains an adoption-gated
+  RFC without a release commitment.
+- The **v1.6 Clean Architecture** milestone is closed as completed historical
+  evidence.
+
+## What this roadmap does not promise
+
+- a date for an MCP or A2A implementation;
+- a persistent cache, process-pool default, Logseq DB adapter, DuckDB export,
+  bidirectional Obsidian sync, standalone binary, GUI, or editor extension
+  before its evidence and adoption gates pass;
+- a security, release, or AAIF claim without independent evidence;
+- a second maintainer before a qualified person accepts that role;
+- a release schedule or feature commitment merely because an item appears here.
+
+## Related documents
+
+- [Governance](../GOVERNANCE.md)
+- [Issue triage policy](ISSUE_TRIAGE_POLICY.md)
+- [AAIF alignment](AAIF_ALIGNMENT.md)
+- [Agent action contract](reference/AGENT_ACTION_CONTRACT.md)
+- [Protocol adapter decision](decisions/ADR-0001-PROTOCOL_ADAPTER_BOUNDARY.md)
+- [Dependency, license, SBOM, and provenance policy](reference/DEPENDENCY_LICENSE_POLICY.md)
+- [Daily metrics threat model](security/DAILY_METRICS_THREAT_MODEL.md)
+- [Official OKF migration gate](decisions/ADR-0002-OFFICIAL-OKF-V02-MIGRATION-GATE.md)
+- [AAIF submission gate](decisions/ADR-0003-AAIF-SUBMISSION-GATE.md)

{logseq_matryca_parser-1.11.0 → logseq_matryca_parser-1.11.1}/docs/index.md

@@ -8,8 +8,8 @@ audience: maintainers
 owner: logseq-matryca-parser
 authority: source_repository
 execution_mode: reviewed
-last_verified: 2026-10-02
-verified: 2026-10-02
+last_verified: 2026-10-10
+verified: 2026-10-10
 stale_after: 2027-03-31
 okf_profile: matryca_okf_inspired_quality
 okf_spec_version: null
@@ -36,6 +36,8 @@ navigation layers only.
 | [AI contribution policy](AI_CONTRIBUTION_POLICY.md) | Human accountability, privacy, disclosure, and review rules for AI-assisted work |
 | [Agent action contract](reference/AGENT_ACTION_CONTRACT.md) | Read/write authority, provenance, prompt-injection boundary, and approval matrix |
 | [Support and compatibility matrix](reference/CONFORMANCE_SUPPORT_MATRIX.md) | Supported runtimes, public API tiers, optional integrations, companion boundary, and explicit limits |
+| [Official Logseq Markdown compatibility evidence](quality/OFFICIAL_LOGSEQ_MARKDOWN_COMPATIBILITY_2026-10-10.md) | Results for all 313 selected official documents, focused metadata semantics, reproducible provenance and explicit coverage limits |
+| [Additional Logseq Markdown datasets](quality/LOGSEQ_MARKDOWN_DATASET_CANDIDATES_2026-10-10.md) | Researched corpus candidates, licensing, syntax diversity and priorities for future qualification |
 | [Org reader limits](internal/LOGSEQ_ORG_PARSER_EXPERIMENTAL_STATUS.md) | Experimental private Org subset, selected diagnostics, and explicit non-conformance limits |
 | [Org reader implementation plan](superpowers/plans/2026-09-29-logseq-org-parser.md) | Completed D2 qualification; D3 graph integration deferred and Markdown improvement prioritized |
 | [LlamaIndex companion migration checkpoint](internal/LLAMAINDEX_COMPANION_MIGRATION_CHECKPOINT_2026-09-27.md) | Historical migration evidence with a dated current-state refresh; rebind live PR and release state before action |