<feed xmlns='http://www.w3.org/2005/Atom'>
<title>sisudoc-abstraction-format/format-specification.md, 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>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>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: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>
