From da833f8b157ae501c9f6eec827dd4a965bfa7265 Mon Sep 17 00:00:00 2001 From: Ralph Amissah Date: Thu, 24 Sep 2026 11:12:28 -0400 Subject: format 2.0: the version gate The reader as it stood when the format reached 2.0, in D: a parser of the .ssp with no dependency beyond phobos, and outputs from it - a heading tree, an html scroll, breadcrumbed text, chunked jsonl for embedding pipelines, an image manifest, and a check of image records against the images on disk. Brought to abstraction format 2.0, and made able to say what it does not understand, so a reader can check that its format specification is complete. Previously the reader ignored what it did not recognise and reported nothing, which made it seem it had understood a 2.0 file (and drop things in silence). Now: - the banner is read, and the major part checked. A major this reader does not know is refused, exit 3, because an unknown major means a property may have changed meaning or gone away and loading it half populated in silence is the failure the check exists to prevent. --any-version reads it regardless, for looking at a file rather than trusting one. A file with no banner warns and is read. - @source is a preamble block beside @meta, @make and @doc_has, and the summary line shows the language and the markup digest. - tail is a section like the rest. - --report-unknown lists every property, block and line shape met and not understood, with counts. Ignoring them remains the conforming behaviour within a major version; the counting is so that it is not silent. Over the markup document samples that report names 18 properties, from .is_of_type at 56,882 occurrences down to .attrib at 1. Several are legitimately of no interest to a renderer and several are not. Deciding which is which is the next pass, and it now has a measured work list rather than a guess. (assisted by Claude-Code) --- dub.json | 15 +++++++++++++++ 1 file changed, 15 insertions(+) create mode 100644 dub.json (limited to 'dub.json') diff --git a/dub.json b/dub.json new file mode 100644 index 0000000..51f7132 --- /dev/null +++ b/dub.json @@ -0,0 +1,15 @@ +{ + "authors": [ + "Ralph Amissah" + ], + "copyright": "Copyright (C) 2026 Ralph Amissah", + "name": "ssp-reader", + "version": "2.0.0", + "description": "reader for SiSU Document Abstraction (.ssp) files", + "homepage": "https://sisudoc.org", + "license": "AGPL-3.0+", + "targetPath": "./bin", + "sourcePaths": [ "./src" ], + "targetType": "executable", + "targetName": "ssp-reader" +} -- cgit v1.2.3