alktype

45 Commits 3 Branches 4 Tags

2 Commits

Include renames

Author	SHA1	Message	Date
glm-5.2	62270b03ca	Sync architecture docs and ADRs to BAST pivot (steps 9-10) Step 9 (convert tests to BAST format) was a no-op: steps 4-8 converted the tests as they went. The only remaining reference in src/tests was the intentional rejection test at src/schema.rs:462 (asserting the old keyword form is rejected). Full suite passes: 389 tests (312 lib + 77 integration). Step 10 (sync architecture docs and ADRs): Descriptive docs rewritten/updated for BAST: - schema-layer.md: rewritten for the BAST parser (BastDoc/BastDef/ BastType typed tree, AlkTypeKind enum with to_bast_str/from_bast_str, what was removed). Points at bast-format.md for the normative format. - validation.md: rewritten for the two-validator model (bast_validation for validate_bytes, standard jsonschema for validate_json). Documents the repurposed build_validator, the AlkTypeError::Validation uniform payload (D-BAST-009), and what is removed. - builder.md: updated all output examples to BAST JSON (struct_() -> { kind: struct, fields: [...] }; object() -> standard JSON Schema). Documents build_doc, count(), and the field-name union fields requirement (D-BAST-005). - overview.md: updated for BAST (what/why, schema-is-the-format table, dependencies, architecture pointers, design decisions table). - README.md (architecture index): updated document table, ADR table (new ADR-BAST + ADR-VAL-SPLIT, superseded ADR-001), OQ table (OQ-007/OQ-008 resolutions updated for BAST-native validator), and key design principles (#1, #2, #7, #10 reworded for BAST). - data-access.md: updated tunion function signatures to BastUnion and the variant resolution to return BastType (resolve_typeref for refs). - layout-engine.md: updated construct signatures (LayoutBuilder::new(bast_doc, root_name), OffsetMap::compute(&doc), SequentialReader::new(bast_doc, root_name)), the recursive-walk description (BAST typed tree), and composite-kind headings (TStruct/TUnion/TArray -> struct/union/array). Added D-BAST-004 note on array count requirement. New ADRs: - ADR-BAST (bast-bast-format.md): the BAST format, meta-schema, //kind vocabulary, design principles, what is removed, the enum index bounds bug fix. Supersedes ADR-001's format-specific content; records D-BAST-001..009. - ADR-VAL-SPLIT (val-split-two-validator-model.md): the two-validator model (BAST-native for validate_bytes, standard jsonschema for validate_json), the repurposed build_validator, the uniform AlkTypeError::Validation payload. Refines ADR-004's validation strategy and ADR-010's validation step; records D-BAST-006/007/009. Amended ADRs (supersession/amendment notes added; original decision text preserved as historical record): - ADR-001: format-specific content superseded by ADR-BAST; purpose/scope and schema-is-the-format principle retained. - ADR-002: unchanged under the pivot; one-line note that the input format changed but the modes didn't. - ADR-003: annotation semantics retained; annotation location moved to BAST type-level properties (amended by ADR-BAST). - ADR-004: AlkTypeError enum retained (D-BAST-009); validation strategy section refined by ADR-VAL-SPLIT. - ADR-009: builder API surface retained; build() output format amended to BAST / standard JSON Schema by ADR-BAST (D-BAST-008). - ADR-010: validate_bytes two-step concept retained; validation step amended to the BAST-native validator by ADR-VAL-SPLIT. Other: - Cargo.toml description: JSON Schema with AlkType:* custom keywords -> BAST document. - bast-pivot.md research record: status draft -> implemented, with a pointer to the ADRs that superseded its decisions. - bast-implementation.md plan: status draft -> complete, with a note that step 9 was a no-op and step 10 is this commit. - open-questions.md: OQ-006/OQ-007/OQ-008 resolutions updated for the BAST-native validator. - questions/008-unionvalidator-variant-dispatch.md: added a post-BAST-pivot note pointing to the current bast_validation implementation; v0.1.0 resolution text preserved as historical record. Verification: - cargo test --release: 389 pass (312 lib + 77 integration) - cargo clippy --all-targets -- -D warnings: clean - cargo doc --no-deps: clean - cross-reference check: every relative link in the new/updated docs resolves (verified by script).	2026-08-15 14:03:21 +00:00
glm-5.2	f5f52c61e8	Decompose BAST pivot doc into normative spec + implementation plan The bast-pivot.md research doc had grown to 1477 lines (~58KB) through iterative editing, pushing its most actionable content (D-BAST decisions, POC result, migration steps) past the 50KB Read tool cap. Agents peeking at the truncated file landed in duplicated/out-of-order sections. Decompose into three readable-sized files with distinct roles: - docs/architecture/bast-format.md (28KB, new): the normative BAST format spec -- meta-schema, TypeRef, examples, validation model. Grounded in the POC and D-BAST-001..009. Stable and safe to write now; schema-layer.md/validation.md stay describing current code and are rewritten post-implementation (per AGENTS.md ADR-grounding rule). - docs/plans/bast-implementation.md (31KB, new): the execution entry point -- ordered 10-step plan with per-step goal/files/spec-ref/ verification, the public-API semver contract table up front as a scope-creep guardrail, and the ADR-sync checklist at the end. Each step links to the specific bast-format.md section and D-BAST anchor. - docs/research/bast-pivot.md (28KB, trimmed): now the research record only -- Summary, Motivation, POC scope/result, Decisions, Risks, References. The normative format spec, what-changes tables, validator-split details, and migration steps moved to the two new docs; pointers added. 1155 lines removed, 216 added. - docs/architecture/README.md: index updated to list bast-format.md and the two in-progress pivot docs, with notes on schema-layer.md and validation.md being rewritten when the pivot lands. All three files are under the 50KB Read cap, so an implementing agent gets the whole document in one call. Cross-reference anchors verified to resolve. No code changes; cargo test --release (396 tests) green. Verification: cargo test --release (310 crate + 86 integration, all pass).	2026-08-15 10:59:14 +00:00

Author

SHA1

Message

Date

glm-5.2

62270b03ca

Sync architecture docs and ADRs to BAST pivot (steps 9-10)

Step 9 (convert tests to BAST format) was a no-op: steps 4-8 converted
the tests as they went. The only remaining  reference in
src/tests was the intentional  rejection test at
src/schema.rs:462 (asserting the old keyword form is rejected). Full
suite passes: 389 tests (312 lib + 77 integration).

Step 10 (sync architecture docs and ADRs):

Descriptive docs rewritten/updated for BAST:
- schema-layer.md: rewritten for the BAST parser (BastDoc/BastDef/
  BastType typed tree, AlkTypeKind enum with to_bast_str/from_bast_str,
  what was removed). Points at bast-format.md for the normative format.
- validation.md: rewritten for the two-validator model
  (bast_validation for validate_bytes, standard jsonschema for
  validate_json). Documents the repurposed build_validator, the
  AlkTypeError::Validation uniform payload (D-BAST-009), and what is
  removed.
- builder.md: updated all output examples to BAST JSON
  (struct_() -> { kind: struct, fields: [...] }; object() -> standard
  JSON Schema). Documents build_doc, count(), and the field-name union
  fields requirement (D-BAST-005).
- overview.md: updated for BAST (what/why, schema-is-the-format table,
  dependencies, architecture pointers, design decisions table).
- README.md (architecture index): updated document table, ADR table
  (new ADR-BAST + ADR-VAL-SPLIT, superseded ADR-001), OQ table
  (OQ-007/OQ-008 resolutions updated for BAST-native validator), and
  key design principles (#1, #2, #7, #10 reworded for BAST).
- data-access.md: updated tunion function signatures to BastUnion and
  the variant resolution to return BastType (resolve_typeref for refs).
- layout-engine.md: updated construct signatures
  (LayoutBuilder::new(bast_doc, root_name), OffsetMap::compute(&doc),
  SequentialReader::new(bast_doc, root_name)), the recursive-walk
  description (BAST typed tree), and composite-kind headings
  (TStruct/TUnion/TArray -> struct/union/array). Added D-BAST-004
  note on array count requirement.

New ADRs:
- ADR-BAST (bast-bast-format.md): the BAST format, meta-schema,
  //kind vocabulary, design principles, what is removed, the
  enum index bounds bug fix. Supersedes ADR-001's format-specific
  content; records D-BAST-001..009.
- ADR-VAL-SPLIT (val-split-two-validator-model.md): the two-validator
  model (BAST-native for validate_bytes, standard jsonschema for
  validate_json), the repurposed build_validator, the uniform
  AlkTypeError::Validation payload. Refines ADR-004's validation
  strategy and ADR-010's validation step; records D-BAST-006/007/009.

Amended ADRs (supersession/amendment notes added; original decision
text preserved as historical record):
- ADR-001: format-specific content superseded by ADR-BAST;
  purpose/scope and schema-is-the-format principle retained.
- ADR-002: unchanged under the pivot; one-line note that the input
  format changed but the modes didn't.
- ADR-003: annotation semantics retained; annotation location moved
  to BAST type-level properties (amended by ADR-BAST).
- ADR-004: AlkTypeError enum retained (D-BAST-009); validation
  strategy section refined by ADR-VAL-SPLIT.
- ADR-009: builder API surface retained; build() output format
  amended to BAST / standard JSON Schema by ADR-BAST (D-BAST-008).
- ADR-010: validate_bytes two-step concept retained; validation step
  amended to the BAST-native validator by ADR-VAL-SPLIT.

Other:
- Cargo.toml description: JSON Schema with AlkType:* custom keywords
  -> BAST document.
- bast-pivot.md research record: status draft -> implemented, with a
  pointer to the ADRs that superseded its decisions.
- bast-implementation.md plan: status draft -> complete, with a note
  that step 9 was a no-op and step 10 is this commit.
- open-questions.md: OQ-006/OQ-007/OQ-008 resolutions updated for the
  BAST-native validator.
- questions/008-unionvalidator-variant-dispatch.md: added a
  post-BAST-pivot note pointing to the current bast_validation
  implementation; v0.1.0 resolution text preserved as historical
  record.

Verification:
- cargo test --release: 389 pass (312 lib + 77 integration)
- cargo clippy --all-targets -- -D warnings: clean
- cargo doc --no-deps: clean
- cross-reference check: every relative link in the new/updated docs
  resolves (verified by script).

2026-08-15 14:03:21 +00:00

glm-5.2

f5f52c61e8

Decompose BAST pivot doc into normative spec + implementation plan

The bast-pivot.md research doc had grown to 1477 lines (~58KB) through
iterative editing, pushing its most actionable content (D-BAST
decisions, POC result, migration steps) past the 50KB Read tool cap.
Agents peeking at the truncated file landed in duplicated/out-of-order
sections. Decompose into three readable-sized files with distinct roles:

- docs/architecture/bast-format.md (28KB, new): the normative BAST
  format spec -- meta-schema, TypeRef, examples, validation model.
  Grounded in the POC and D-BAST-001..009. Stable and safe to write
  now; schema-layer.md/validation.md stay describing current code and
  are rewritten post-implementation (per AGENTS.md ADR-grounding rule).
- docs/plans/bast-implementation.md (31KB, new): the execution entry
  point -- ordered 10-step plan with per-step goal/files/spec-ref/
  verification, the public-API semver contract table up front as a
  scope-creep guardrail, and the ADR-sync checklist at the end. Each
  step links to the specific bast-format.md section and D-BAST anchor.
- docs/research/bast-pivot.md (28KB, trimmed): now the research record
  only -- Summary, Motivation, POC scope/result, Decisions, Risks,
  References. The normative format spec, what-changes tables,
  validator-split details, and migration steps moved to the two new
  docs; pointers added. 1155 lines removed, 216 added.
- docs/architecture/README.md: index updated to list bast-format.md
  and the two in-progress pivot docs, with notes on schema-layer.md
  and validation.md being rewritten when the pivot lands.

All three files are under the 50KB Read cap, so an implementing agent
gets the whole document in one call. Cross-reference anchors verified
to resolve. No code changes; cargo test --release (396 tests) green.

Verification: cargo test --release (310 crate + 86 integration, all pass).

2026-08-15 10:59:14 +00:00