Skip to content

Resume: bounds rollout (step 7 next) and docs review follow-ups #197

Closed

Description

@Kinflou

State of the work, to pick up later.

In flight

  • Docs review: Docs review: fix what's wrong, one place per explanation, more diagrams docs#140 (branch docs/review, 2 commits, pushed). CI not checked yet; merge when green.
    • Commit 1 fixes wrong and outdated facts, adds guide/idl/annotations.md, writes reference/congregation/config-id.md (was empty), a package files overview and a tools index, removes the empty "Compliance features" section, and updates the nav.
    • Commit 2 makes guide/runtime/call-system.md the one page that explains format, framing, handshake and transport; duplicated tables become links; diagrams added (17 in total, all parse with mermaid 11.4.1).
    • Check locally with zensical build --strict (catches broken links and anchors).

Docs follow-ups not done

  • Bounds documentation (rollout step 12), once the CLI pins the new core:
    • types page: char and T[max N]
    • const page: sizes taken from constants
    • settings page: bounds.*.max
    • annotations page: @max_depth
    • validator page: any[] and the new std validators (NonEmpty, MinChars, MinItems, IntRange)
    • use.md: the std table
    • getting started: the sample schema needs bounds
    • regenerate std/*.md
  • Not reviewed in depth: c-abi, generator-protocol, conformance, inspect and doc references, and design/proposals (only their statuses were checked).
  • The type-bounds proposals index still says "not settled": mark it decided.

Bugs found, not fixed

  • cli: comline reset help and message say the next build starts at 0.0.1; core starts at 0.1.0-dev.1 (src/cli.rs:311, src/commands/reset.rs:5,70).
  • comline-typescript: the status table in runtime/README.md is stale ("Next: a generator…").

Bounds rollout (#98)

Activity

  1. Kinflou commented on Nov 3, 2026

    @Kinflou
    MemberAuthor

    generation bounds pin: f7586b186dded54fc1f5cdf617f1f1f60707f4d2 (branch feat/bounds-core-pin, ComlineProject/generation#112; comline-core 8f5dc91)

  2. Kinflou commented on Nov 3, 2026

    @Kinflou
    MemberAuthor

    generation bounds pin (updated): 32ed2254ca36d2614862aa4b33da0bc50f2334bc — adds Validation::expand_bounds (inlines aliases that carry a bound at each use site), bounds::has_bounds and bounds::max_depth to the kernel. Additive; the earlier pin f7586b1 still works.

  3. Kinflou commented on Nov 3, 2026

    @Kinflou
    MemberAuthor

    comline-typescript bounds rev: e09e7e6abee36ca167dcb79f8d88b0eaa8f156a6 (branch feat/bounds-codegen, comline-typescript#125 stacked on #124; pins generation f7586b1 and comline-core 8f5dc91). Against generation's conformance goldens at f7586b1, only bounds/typescript moves and chars/typescript is new; every other fixture is byte-identical.

  4. Kinflou commented on Nov 3, 2026

    @Kinflou
    MemberAuthor

    Final generation SHA for the bounds rollout: 064f6e12b80040015bafabe690d87eab0dd069f5 (generation#112). Since 32ed225, only conformance pins, goldens and FEATURES changed, so codegen is identical. comline-rust#101 (44ae2ad) pins generation 32ed225.

  5. Kinflou commented on Nov 3, 2026

    @Kinflou
    MemberAuthor

    Picked up and finished (2026-11-03):

    • Docs review: docs#140 merged; the five unreviewed reference pages in docs#143; the bounds docs (step 12) in docs#142; std pages regenerated in docs#146. The reset help text is fixed (cli#127). The TS runtime README is updated (comline-typescript#123).
    • Bounds rollout:
      • step 7: runtime#78, core#200, docs#144;
      • steps 8–9: comline-rust#101, comline-typescript#124/Settings blocks supply annotation defaults #125, generation#112;
      • step 10: cli#130 (bounded core, spec 0.3 runner, migration hint, --reconcile), language-server#97, playground#111, generation#116 (validate_on_decode defaults to collect; { off = "reason" } to give it up), comline-rust#104.
    • RUNTIME_REV/STD_REV are moved in comline-rust#101 and chore: remove dead todo!() stubs #103.

    Left: core#202 (worst-case sizes against frame limits), comline-rust#102, generation#113, runtime#79, core#199, cli#131.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions