From b95546cdb4995cf7fe598823f5d3264d53c274a8 Mon Sep 17 00:00:00 2001 From: Ralph Amissah Date: Tue, 13 Oct 2026 16:54:02 -0400 Subject: frozen: superseded by ocda-read in sisudoc-ocda-lib This reader is no longer maintained. Its modes are carried by ocda-read, the reader of sisudoc-ocda-lib, which is built on the library's model and so reads a .ssp, a .ocda.db and a pod alike. On every .ssp of the markup document samples it gives the D reader's output byte for byte after the first line (Read: where this says Parsed:) in --tree, --html, --llm-text, --llm-jsonl, --images, --verify and --validate; its summary differs only in the closing hint. The repository is kept as the record of what it showed: two readers, in D and in Gleam, written from the specification and from nothing else, agreeing; and a validator that found two rules the specification had left unstated. Its commits are matched to the points the specification reached, format 2.0 and format 2.1. The README says so at its head, and says "every document-language" where it gave a count; the ruby/ row goes, that reader not now to be written. The version is 2.1.0, the format this reader was brought to; it was 2.0.0. (assisted by Claude-Code) --- dlang/README.md | 18 +++++++++--------- dlang/dub.json | 2 +- dlang/flake.nix | 2 +- 3 files changed, 11 insertions(+), 11 deletions(-) (limited to 'dlang') diff --git a/dlang/README.md b/dlang/README.md index bb0aefd..181d27f 100644 --- a/dlang/README.md +++ b/dlang/README.md @@ -1,7 +1,7 @@ # ssp-reader, in D Reader for the **`.ssp` document-abstraction text format** emitted -by [sisudoc-spine](https://git.sisudoc.org/projects/sisudoc-spine). +by [sisudoc-spine](https://git.sisudoc.org/sisudoc-spine). Reads a `.ssp` file (spine's PEG-parsable serialisation of its internal document abstraction) and renders it into a chosen output: @@ -44,7 +44,7 @@ Spine's processing pipeline has three stages: `ssp-reader` picks up the abstraction at the end of stage 2 (the `.ssp` file) and runs alternative stage-3 renderings on top of it. The `.ssp` format itself is documented in -[`sisudoc-abstraction-format`](https://git.sisudoc.org/tools/sisudoc-abstraction-format). +[`sisudoc-abstraction-format`](https://git.sisudoc.org/sisudoc-abstraction-format). ## Quickstart @@ -127,7 +127,7 @@ the HTML, in the plain text, and as an embedding chunk in the JSONL. Fixed, and the reason the report exists. That is deliberate and is what makes the reader usable as a check on the -[format specification](https://git.sisudoc.org/specs/sisudoc-abstraction-format): +[format specification](https://git.sisudoc.org/sisudoc-abstraction-format): a reader that drops what it does not know is conforming, but one that cannot say what it dropped cannot tell you whether the specification it was written from was complete. Silence and understanding look alike otherwise. @@ -135,7 +135,7 @@ written from was complete. Silence and understanding look alike otherwise. ## Documentation - The `.ssp` format itself: see - [sisudoc-abstraction-format](https://git.sisudoc.org/tools/sisudoc-abstraction-format). + [sisudoc-abstraction-format](https://git.sisudoc.org/sisudoc-abstraction-format). - Source: [`src/`](src/) - one module per output format (`output_tree.d`, `output_html.d`, `output_llm_breadcrumbs.d`, `output_llm_jsonl.d`, `output_images.d`, `verify_images.d`), plus @@ -144,19 +144,19 @@ written from was complete. Silence and understanding look alike otherwise. ## License AGPL-3.0-or-later. See [`dub.json`](dub.json) and the parent -[sisudoc-spine](https://git.sisudoc.org/projects/sisudoc-spine) +[sisudoc-spine](https://git.sisudoc.org/sisudoc-spine) project for full licence text. ## Repository -- **Canonical URL:** https://git.sisudoc.org/tools/sisudoc-ssp-reader +- **Canonical URL:** https://git.sisudoc.org/sisudoc-ssp-reader - **Clone:** `git clone --depth=1 git://git.sisudoc.org/tools/sisudoc-ssp-reader` ## Related projects -- [sisudoc-spine](https://git.sisudoc.org/projects/sisudoc-spine) - +- [sisudoc-spine](https://git.sisudoc.org/sisudoc-spine) - produces the `.ssp` files this tool consumes. -- [sisudoc-abstraction-format](https://git.sisudoc.org/tools/sisudoc-abstraction-format) - +- [sisudoc-abstraction-format](https://git.sisudoc.org/sisudoc-abstraction-format) - specification of the `.ssp` text format. -- [tree-sitter-sisu](https://git.sisudoc.org/tools/tree-sitter-sisu) - +- [tree-sitter-sisu](https://git.sisudoc.org/tree-sitter-sisu) - tree-sitter grammar for the upstream `.sst` / `.ssm` markup. diff --git a/dlang/dub.json b/dlang/dub.json index 51f7132..544b737 100644 --- a/dlang/dub.json +++ b/dlang/dub.json @@ -4,7 +4,7 @@ ], "copyright": "Copyright (C) 2026 Ralph Amissah", "name": "ssp-reader", - "version": "2.0.0", + "version": "2.1.0", "description": "reader for SiSU Document Abstraction (.ssp) files", "homepage": "https://sisudoc.org", "license": "AGPL-3.0+", diff --git a/dlang/flake.nix b/dlang/flake.nix index 554b8e0..d039297 100644 --- a/dlang/flake.nix +++ b/dlang/flake.nix @@ -17,7 +17,7 @@ */ mkReader = { compiler, compilerBin }: pkgs.stdenv.mkDerivation { pname = name; - version = "2.0.0"; + version = "2.1.0"; src = self; nativeBuildInputs = [ pkgs.dub compiler ]; buildPhase = '' -- cgit v1.2.3