Skip to content

docs: preserve complete agent runtime architecture package - #331

Open
jmagar wants to merge 1 commit into
mainfrom
docs/agent-runtime-package-20260805
Open

docs: preserve complete agent runtime architecture package#331
jmagar wants to merge 1 commit into
mainfrom
docs/agent-runtime-package-20260805

Conversation

@jmagar

@jmagar jmagar commented Aug 5, 2026

Copy link
Copy Markdown
Collaborator

Summary

  • preserve the complete proposed Soma agent-runtime documentation package
  • add specs, contracts, models, Rust-facing type blueprints, JSON Schemas, examples, implementation phases, code skeletons, file plan, and test matrix
  • add the generated package manifest, validation report, and canonical validation script
  • index the package from docs/CLAUDE.md and record it in CHANGELOG.md
  • use neutral devhost fixture identities rather than internal hostnames
  • narrowly exclude the schema-backed snippet and isolated external-consumer fixture from repository rules that do not apply to their artifact formats
  • exact-pin soma-ops schemars to the already locked 1.2.1 release and refresh the external-consumer fixture lockfile

Validation

  • check-agent-runtime-docs.py: 75 files and 7 schema-backed examples passed
  • exact pinned fleet repository contract: passed
  • root and external-consumer cargo metadata --locked --no-deps: passed
  • git diff --check: passed
  • cargo xtask check-stale-claims: passed
  • cargo xtask check-schema-docs --check: passed
  • cargo xtask check-architecture: passed (40 workspace packages, 92 internal edges)
  • cargo xtask check-docs: generated docs current and Python platform policy passed; unrelated SDK import timing gate exceeded its 500 ms budget during the captured run

Scope

This PR preserves a proposal package for review. It does not claim the described runtime is implemented and should not be auto-merged solely as cleanup.

Copilot AI lite review requested due to automatic review settings August 5, 2026 18:39

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

Copilot AI review requested due to automatic review settings August 5, 2026 18:43
@jmagar
jmagar force-pushed the docs/agent-runtime-package-20260805 branch from 65cea06 to 0c96506 Compare August 5, 2026 18:43

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

@jmagar
jmagar force-pushed the docs/agent-runtime-package-20260805 branch from 0c96506 to 76963ff Compare August 5, 2026 20:17
Copilot AI review requested due to automatic review settings August 5, 2026 20:17

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

Copilot AI review requested due to automatic review settings August 5, 2026 20:20
@jmagar
jmagar force-pushed the docs/agent-runtime-package-20260805 branch from 76963ff to 2e3b58a Compare August 5, 2026 20:20

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

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.

2 participants