Skip to content

site: the PFS pages reflect the phase 2/3 results (pubid#706) - #27

Merged
ronaldtse merged 1 commit into
mainfrom
docs/pfs-refresh
Nov 14, 2026
Merged

ronaldtse merged 1 commit into
mainfrom
docs/pfs-refresh

Conversation

@ronaldtse

Copy link
Copy Markdown
Contributor

Summary

Refreshes the two PFS pages (#25) with the Phase 2/3 results. Closes #26.

Concept page (/concepts/pfs) — prose only

  • The proofs in present tense: four compiled flavors green on pubid main
    (2.0.26) — doi_pfs 55/55, etsi_pfs 24,718/24,718 full byte parity
    (was accept-only with pinned gaps), calconnect_pfs 400-example
    whole-corpus byte parity
    (the acceptance test passed; was future tense),
    cen_pfs with the honest 55-absorbed / 134-pinned boundary. The
    in-review pubid#714 references are now landed facts.
  • The module library as shipped (definitions/modules/*.pfsmod, six
    modules), the tier story updated for the compiler v2 (the narrowed v1
    boundaries, the landed tier-B extensions, the measured cen tier call).
  • The Conormis adoption linked for the first time
    (conormis/platform#406 — private repo, added to .lycheeignore with a
    comment, per the existing convention for correct-but-unresolvable URLs).
  • The TS side now names all three compiled flavors (pubid-ts#170, #174,
    #175) — one artifact, both engines.

Reference page (/library/pfs) — reference-shaped

  • The compiler v2 surface documented as implemented: collection bindings
    (kind: list + item: + render:), the fold (builder_only +
    fold: {into, flag}), conditional render segments (the alternated
    optional), supplement wrapper synthesis (new supplements: section),
    int-kind URN cores, the urn.official composition surface
    (lower/affix/edition_affix/compose), the mr: hooks (new
    section), and the named-segments rule (new grammar: section; unnamed
    captures rejected).
  • New DIN module-composition example: the modules binding plus the
    definition's own face — compiled green for this page (2 positives,
    3 negatives verified), mirroring the shipped cen.pfs composition.
  • "What the compiler rejects" gains the named-segments, lists and
    supplements rows; v1 boundaries restated per definitions/README.md
    (field kinds are string and list now; multi-type, free-standing
    stages maps and semantic decode remain fail-closed).
  • The parity-harness section carries the four proofs with their measured
    numbers; the both-engines section covers doi/calconnect/etsi.

Verification

  • Every snippet executed against the current toolchain (grammar main
    1f84627, parsanol 1.3.126, the CI pin): the Wxyz worked example and the
    DIN composition both compile + bake + verify green; the etsi/calconnect
    quoted blocks are verbatim from the shipped definitions (CI-compiled).
    The console blocks show the toolchain's actual output (output paths
    passed explicitly so the printout stays machine-independent; checksums
    re-verified stable for the same relative path).
  • Parity harnesses re-run locally against pubid main: doi 55/55,
    calconnect 400/400, cen 248/248, etsi 36/36 over the 24,718 inventory —
    all 0 failures; pubid main CI (rake + conformance + downstream-test) and
    grammar main CI green on the commits these pages describe.
  • astro check 0 errors; npm run build 358 pages; vitest run 435/435;
    lychee 7,055 OK, 0 errors.

Refs pubid#706, pubid/pubid#714 (merged), pubid-grammar#119.

The concept page carries the proofs in present tense — the four
compiled flavors green on pubid main (doi 55/55, etsi 24,718/24,718
full parity, calconnect 400-example whole-corpus byte parity, cen's
55-absorbed/134-pinned boundary), the module library as shipped, the
TS declarations for three flavors, the Conormis adoption linked. The
reference page documents the compiler v2 surface as implemented —
collection bindings, the fold, conditional render segments, supplement
wrapper synthesis, int-kind URN cores, the urn.official composition
surface, the mr: hooks, the named-segments rule — with the DIN
module-composition example compiled for this page and every console
block re-executed against grammar main + parsanol 1.3.126.
@ronaldtse
ronaldtse merged commit 008b9c4 into main Nov 14, 2026
1 check passed
@ronaldtse
ronaldtse deleted the docs/pfs-refresh branch November 14, 2026 05:59
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Refresh the PFS pages with the Phase 2/3 results (compiler v2, modules, the proofs)

1 participant