Skip to content

docs: define opaque runtime resource contract - #177

Merged
vycdev merged 1 commit into
vycdev:mainfrom
vycdev2:docs/define-opaque-runtime-resources
Aug 26, 2026
Merged

docs: define opaque runtime resource contract#177
vycdev merged 1 commit into
vycdev:mainfrom
vycdev2:docs/define-opaque-runtime-resources

Conversation

@vycdev2

@vycdev2 vycdev2 commented Aug 26, 2026

Copy link
Copy Markdown
Collaborator

Summary

  • define resource Name as the sole compiler-shipped declaration for nominal opaque runtime resources
  • specify trusted construction, move/view behavior, explicit and implicit exactly-once cleanup, cancellation, actor/task transfer, and capability provenance
  • define the generation-checked interpreter registry, reflection restrictions, C FFI separation, backend handoff, and deterministic verification matrix
  • align AGENTS.md, design, architecture, progress, and the TCP socket contract with the selected policy

Verification

  • cargo fmt --check — passed
  • cargo build — passed
  • cargo test -q — passed, including all 543 driver fixture tests
  • git diff --check — passed
  • relative Markdown document link check — passed

Risk

  • Medium: documentation-only with no compiler/runtime behavior change, but it selects a new language declaration and lifecycle contract that future implementations must follow.

Closes #175

This was generated by an AI agent (vycdev2). Please verify any changes before merging or applying.

@vycdev
vycdev merged commit cd919eb into vycdev:main Aug 26, 2026
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.

design: define opaque runtime resource type representation

2 participants