<feed xmlns='http://www.w3.org/2005/Atom'>
<title>sisudoc-abstraction-format, branch claude</title>
<subtitle>SiSU Spine: specs</subtitle>
<link rel='alternate' type='text/html' href='https://git.sisudoc.org/sisudoc-abstraction-format/'/>
<entry>
<title>spec: .parent emission rule, regenerate the worked example</title>
<updated>2026-09-03T00:26:44+00:00</updated>
<author>
<name>Ralph Amissah</name>
<email>ralph.amissah@gmail.com</email>
</author>
<published>2026-09-03T00:26:44+00:00</published>
<link rel='alternate' type='text/html' href='https://git.sisudoc.org/sisudoc-abstraction-format/commit/?id=f934da74b13168782332a1283e32f88f7a0f32dd'/>
<id>f934da74b13168782332a1283e32f88f7a0f32dd</id>
<content type='text'>
.parent is no longer "omit when zero". spine emits it for every
object, 0 included, except the :A~ document root (no parent) and the
entries of the generated @toc section (furniture, placed by their
.indent level; the toc heading itself keeps .parent: 1). A missing
.parent must not be read as 0.

- omission table row and a new paragraph under Properties
- example-autonomous-contract.ssp regenerated from spine 0.22.0,
  which also picks up the ancestors / dom_status / last_descendant /
  parent_lev fixes made in spine since 2026-08-27, and the corrected
  .ocn_off on paragraph objects

example-wealth-of-networks.ssp is a hand-elided excerpt and has not
been regenerated; its verbatim lines predate these changes.

(assisted by Claude-Code)
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
.parent is no longer "omit when zero". spine emits it for every
object, 0 included, except the :A~ document root (no parent) and the
entries of the generated @toc section (furniture, placed by their
.indent level; the toc heading itself keeps .parent: 1). A missing
.parent must not be read as 0.

- omission table row and a new paragraph under Properties
- example-autonomous-contract.ssp regenerated from spine 0.22.0,
  which also picks up the ancestors / dom_status / last_descendant /
  parent_lev fixes made in spine since 2026-08-27, and the corrected
  .ocn_off on paragraph objects

example-wealth-of-networks.ssp is a hand-elided excerpt and has not
been regenerated; its verbatim lines predate these changes.

(assisted by Claude-Code)
</pre>
</div>
</content>
</entry>
<entry>
<title>examples: real spine output in place of the hand-written ones</title>
<updated>2026-08-27T18:01:16+00:00</updated>
<author>
<name>Ralph Amissah</name>
<email>ralph.amissah@gmail.com</email>
</author>
<published>2026-08-27T18:00:51+00:00</published>
<link rel='alternate' type='text/html' href='https://git.sisudoc.org/sisudoc-abstraction-format/commit/?id=047ec2a6f7eecae8f08f1ea609c3f25aa13966aa'/>
<id>047ec2a6f7eecae8f08f1ea609c3f25aa13966aa</id>
<content type='text'>
Both example files said so in their own headers: "Hand-crafted
example showing what the serialized abstraction would look like",
with illustrative OCNs. They predated several format changes and
neither showed an object embedding an image.

example-autonomous-contract.ssp is now spine's output for that
sample document, complete and unedited but for the comment lines
naming the command that regenerates it.

example-wealth-of-networks.ssp is an excerpt of spine's output for
that document, the whole being some 19,500 lines: verbatim lines
with marked elisions, keeping the @meta / @make / @doc_has
preamble, the @head section, and body objects [95] to [99], among
them [97], which embeds an image and so carries an .image record.

Both parse: ssp-reader --tree and --images read them, the latter
reporting the image record of [97] against the digest the pod's
digests.txt gives for won_benkler_2_1.png.

README: the two files described separately (complete / excerpt),
and the quickstart names the flags that actually write a .ssp.

Carries with it the git.sisudoc.org namespace corrections to the
README links that were already staged in the working tree.

(assisted by Claude-Code)
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
Both example files said so in their own headers: "Hand-crafted
example showing what the serialized abstraction would look like",
with illustrative OCNs. They predated several format changes and
neither showed an object embedding an image.

example-autonomous-contract.ssp is now spine's output for that
sample document, complete and unedited but for the comment lines
naming the command that regenerates it.

example-wealth-of-networks.ssp is an excerpt of spine's output for
that document, the whole being some 19,500 lines: verbatim lines
with marked elisions, keeping the @meta / @make / @doc_has
preamble, the @head section, and body objects [95] to [99], among
them [97], which embeds an image and so carries an .image record.

Both parse: ssp-reader --tree and --images read them, the latter
reporting the image record of [97] against the digest the pod's
digests.txt gives for won_benkler_2_1.png.

README: the two files described separately (complete / excerpt),
and the quickstart names the flags that actually write a .ssp.

Carries with it the git.sisudoc.org namespace corrections to the
README links that were already staged in the working tree.

(assisted by Claude-Code)
</pre>
</div>
</content>
</entry>
<entry>
<title>spec: correct drift between documented and emitted properties</title>
<updated>2026-08-27T00:08:30+00:00</updated>
<author>
<name>Ralph Amissah</name>
<email>ralph.amissah@gmail.com</email>
</author>
<published>2026-08-27T00:08:30+00:00</published>
<link rel='alternate' type='text/html' href='https://git.sisudoc.org/sisudoc-abstraction-format/commit/?id=604e7d5eafafe76d7e430ba6e821793a4dc263d6'/>
<id>604e7d5eafafe76d7e430ba6e821793a4dc263d6</id>
<content type='text'>
Found while documenting the image record: the property reference
had fallen behind the emitter. Checked property by property against
src/sisudoc/ocda/abstraction/ssp.d and against .ssp output for
the_wealth_of_networks; documented and emitted sets now agree.

Corrected names:
- .heading_ancestors  -&gt; .heading_ancestors_text
- .links (one line, space separated) -&gt; .stow_link (repeatable)
- .identifier: dropped, a heading's identifier is not a property,
  it follows the level on the declaration line: [5] heading :1 id

Documented, previously absent: .children, .heading_lev_collapsed,
.parent_lev, .o_n_type, .is_of_type, .attrib, .meta_lang,
.meta_syntax, .segment_epub, .heading_lev_anchor, .anchor_tag,
.lev4_subtoc, and the images_no_dim flag of .has.

Also: heading_lev_collapsed was listed as not serialised while
being emitted; @make showed a breaks: line that is not emitted and
lacked auto_num_top_lv; omission rules extended to the properties
above, with .section and .anchor stated more precisely (each is
omitted when it repeats the enclosing section / the .segment
value).

(assisted by Claude-Code)
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
Found while documenting the image record: the property reference
had fallen behind the emitter. Checked property by property against
src/sisudoc/ocda/abstraction/ssp.d and against .ssp output for
the_wealth_of_networks; documented and emitted sets now agree.

Corrected names:
- .heading_ancestors  -&gt; .heading_ancestors_text
- .links (one line, space separated) -&gt; .stow_link (repeatable)
- .identifier: dropped, a heading's identifier is not a property,
  it follows the level on the declaration line: [5] heading :1 id

Documented, previously absent: .children, .heading_lev_collapsed,
.parent_lev, .o_n_type, .is_of_type, .attrib, .meta_lang,
.meta_syntax, .segment_epub, .heading_lev_anchor, .anchor_tag,
.lev4_subtoc, and the images_no_dim flag of .has.

Also: heading_lev_collapsed was listed as not serialised while
being emitted; @make showed a breaks: line that is not emitted and
lacked auto_num_top_lv; omission rules extended to the properties
above, with .section and .anchor stated more precisely (each is
omitted when it repeats the enclosing section / the .segment
value).

(assisted by Claude-Code)
</pre>
</div>
</content>
</entry>
<entry>
<title>spec: image records, .image property</title>
<updated>2026-08-27T00:07:13+00:00</updated>
<author>
<name>Ralph Amissah</name>
<email>ralph.amissah@gmail.com</email>
</author>
<published>2026-08-27T00:07:13+00:00</published>
<link rel='alternate' type='text/html' href='https://git.sisudoc.org/sisudoc-abstraction-format/commit/?id=76c67a798d76186df081be59cefa0292f1cea569'/>
<id>76c67a798d76186df081be59cefa0292f1cea569</id>
<content type='text'>
Documents the per-object image record that spine now emits, one
repeatable .image line per image, filename first then
self-describing key:value fields:

  .image: won_benkler_2_1.png sha256:5BA4...D128 bytes:93861 px:420x342
  .image: ffa.png missing:true

Covers the four fields (sha256, bytes, px, missing), the reader
requirements (repeatable, order-independent fields, ignore what is
not recognised, do not assume a field count), the distinction
between px (the file's own pixel size) and the w##h## display
dimensions carried in the object text, and the PEG rules for the
record. Notes why the pod digests.txt keeps its own flat form.

(assisted by Claude-Code)
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
Documents the per-object image record that spine now emits, one
repeatable .image line per image, filename first then
self-describing key:value fields:

  .image: won_benkler_2_1.png sha256:5BA4...D128 bytes:93861 px:420x342
  .image: ffa.png missing:true

Covers the four fields (sha256, bytes, px, missing), the reader
requirements (repeatable, order-independent fields, ignore what is
not recognised, do not assume a field count), the distinction
between px (the file's own pixel size) and the w##h## display
dimensions carried in the object text, and the PEG rules for the
record. Notes why the pod digests.txt keeps its own flat form.

(assisted by Claude-Code)
</pre>
</div>
</content>
</entry>
<entry>
<title>docs: add README under git.sisudoc.org/tools/ namespace</title>
<updated>2026-05-12T00:41:31+00:00</updated>
<author>
<name>Ralph Amissah</name>
<email>ralph.amissah@gmail.com</email>
</author>
<published>2026-05-12T00:41:31+00:00</published>
<link rel='alternate' type='text/html' href='https://git.sisudoc.org/sisudoc-abstraction-format/commit/?id=c17ca174c4aca4ed6cf47682f5f49389502b8ae5'/>
<id>c17ca174c4aca4ed6cf47682f5f49389502b8ae5</id>
<content type='text'>
Add a top-level README.md identifying the repository as a
specification (not a program), summarising what .ssp is (a
human-readable, PEG-parsable serialisation of spine's in-memory
document abstraction), listing the line-type grammar at a glance,
and pointing readers at format-specification.md for the full
reference and at the two example .ssp files shipped alongside.

Canonical URLs use the new git.sisudoc.org/tools/ namespace,
matching the parallel moves in tree-sitter-sisu and ssp-reader
and the local rename of sisudoc-spine-utils/ to
sisudoc-spine-tools/. Cross-references to ssp-reader and
tree-sitter-sisu follow the same convention.

(assisted by Claude-Code)
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
Add a top-level README.md identifying the repository as a
specification (not a program), summarising what .ssp is (a
human-readable, PEG-parsable serialisation of spine's in-memory
document abstraction), listing the line-type grammar at a glance,
and pointing readers at format-specification.md for the full
reference and at the two example .ssp files shipped alongside.

Canonical URLs use the new git.sisudoc.org/tools/ namespace,
matching the parallel moves in tree-sitter-sisu and ssp-reader
and the local rename of sisudoc-spine-utils/ to
sisudoc-spine-tools/. Cross-references to ssp-reader and
tree-sitter-sisu follow the same convention.

(assisted by Claude-Code)
</pre>
</div>
</content>
</entry>
<entry>
<title>rename .sda references and files to .ssp</title>
<updated>2026-04-21T18:16:00+00:00</updated>
<author>
<name>Ralph Amissah</name>
<email>ralph.amissah@gmail.com</email>
</author>
<published>2026-04-21T18:16:00+00:00</published>
<link rel='alternate' type='text/html' href='https://git.sisudoc.org/sisudoc-abstraction-format/commit/?id=bc2d3f1e2a2793c7a55d1671a2ddd344780136d2'/>
<id>bc2d3f1e2a2793c7a55d1671a2ddd344780136d2</id>
<content type='text'>
Rename file extension from .sda to .ssp throughout the
format specification and example files.

- example-autonomous-contract.sda -&gt; .ssp
- example-wealth-of-networks.sda -&gt; .ssp
- format-specification.md: all .sda references updated

Co-Authored-By: Anthropic Claude Opus 4.6 (1M context)
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
Rename file extension from .sda to .ssp throughout the
format specification and example files.

- example-autonomous-contract.sda -&gt; .ssp
- example-wealth-of-networks.sda -&gt; .ssp
- format-specification.md: all .sda references updated

Co-Authored-By: Anthropic Claude Opus 4.6 (1M context)
</pre>
</div>
</content>
</entry>
<entry>
<title>explore spec</title>
<updated>2026-04-19T00:42:32+00:00</updated>
<author>
<name>Ralph Amissah</name>
<email>ralph.amissah@gmail.com</email>
</author>
<published>2026-04-19T00:42:32+00:00</published>
<link rel='alternate' type='text/html' href='https://git.sisudoc.org/sisudoc-abstraction-format/commit/?id=b854f908655c4b2872496e61def636361bbd2b20'/>
<id>b854f908655c4b2872496e61def636361bbd2b20</id>
<content type='text'>
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
</pre>
</div>
</content>
</entry>
<entry>
<title>explore spec</title>
<updated>2026-04-19T00:28:29+00:00</updated>
<author>
<name>Ralph Amissah</name>
<email>ralph.amissah@gmail.com</email>
</author>
<published>2026-04-19T00:28:29+00:00</published>
<link rel='alternate' type='text/html' href='https://git.sisudoc.org/sisudoc-abstraction-format/commit/?id=638b1c4cbaa56d5534d1d2c9601b1903e6400ebe'/>
<id>638b1c4cbaa56d5534d1d2c9601b1903e6400ebe</id>
<content type='text'>
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
</pre>
</div>
</content>
</entry>
<entry>
<title>format spec .md</title>
<updated>2026-04-19T00:25:17+00:00</updated>
<author>
<name>Ralph Amissah</name>
<email>ralph.amissah@gmail.com</email>
</author>
<published>2026-04-19T00:25:17+00:00</published>
<link rel='alternate' type='text/html' href='https://git.sisudoc.org/sisudoc-abstraction-format/commit/?id=9fcd5aae5f1a55c5525929f7d5b1bd864f3e694d'/>
<id>9fcd5aae5f1a55c5525929f7d5b1bd864f3e694d</id>
<content type='text'>
</content>
<content type='xhtml'>
<div xmlns='http://www.w3.org/1999/xhtml'>
<pre>
</pre>
</div>
</content>
</entry>
</feed>
