adaptive-manifest-schema

Adaptive Interfaces PyPI Docs Site Repo Python 3.15+ License: MIT

CI Docs Links

Canonical MANIFEST.toml schema for the Adaptive Interfaces ecosystem.

Part of the Adaptive Interfaces ecosystem.

Introduction

Every Adaptive Interfaces repository includes a MANIFEST.toml that declares its identity, scope, dependencies, provided artifacts, and tooling configuration. This repository defines and validates that schema.

adaptive-manifest-schema has no upstream Adaptive Interfaces dependencies. All other repos in the ecosystem depend on it. It is the foundation layer.

Scope: Included

  • The canonical MANIFEST.toml schema definition (schema/manifest-1.toml)
  • A CLI validator (adaptive-manifest validate)
  • Field definitions, types, and invariants for all schema sections
  • Cross-field validation rules including agent safety field enum enforcement
  • A Python library for reading and validating manifests programmatically

Scope: Excluded

  • Repo scaffolding or generation tools
  • Convention file management
  • CI workflow templates
  • Schemas specific to other organizations (SE, civic-interconnect, etc.)

Safety

Agents working in codebases can cause serious harm when given permissions beyond what a task requires. A known failure mode is an agent that understands a constraint but overrides it under goal pressure. The constraint must be architectural, not just instructional.

This schema encodes a read-generate-review cycle as the architectural checkpoint:

  • Agents read files and produce artifacts.
  • Humans review before anything is applied.
  • No agent has autonomous write access to production systems.

The [agent] section in every MANIFEST.toml declares this posture explicitly:

[agent]
conformance = "https://github.com/adaptive-interfaces/adaptive-conformance-specification"
skill = "SKILL.md"
permissions = "read-generate"
checkpoint = "human-review-required"
scope = "this-repo-only"
stop_on_ambiguity = true

The validator enforces allowed values for permissions, checkpoint, and scope. Conservative defaults apply when fields are omitted. Omitting [agent] entirely does not grant additional permissions. See DECISIONS.md D-006 for full rationale.

Contents

  • API Reference - auto-generated from src/adaptive_manifest_schema/

Command Reference

Show command reference

In a machine terminal

Open a machine terminal where you want the project:

git clone https://github.com/adaptive-interfaces/adaptive-manifest-schema

cd adaptive-manifest-schema
code .

In a VS Code terminal

# uv cache clean # if corrupted
uv self update
uv python pin 3.15
uv sync --extra dev --extra docs --upgrade

uvx pre-commit install

git add -A
uvx pre-commit run --all-files
# repeat if changes were made
git add -A
uvx pre-commit run --all-files

# validate schema source of truth (this repo only)
uv run adaptive-manifest validate-schema --strict

# validate repo MANIFEST.toml against schema (also used downstream)
uv run adaptive-manifest validate --strict

# do chores
uv run python -m pyright
uv run python -m pytest
uv run python -m zensical build

# build package artifacts
uv run python -m build

# validate package metadata
uv run python -m twine check dist/*

# confirm wheel contains runtime schema artifact
uv run python -c "import pathlib, zipfile; wheels=list(pathlib.Path('dist').glob('*.whl')); assert wheels, 'No wheel found'; wheel=wheels[-1]; names=zipfile.ZipFile(wheel).namelist(); print([n for n in names if n.endswith('manifest-schema.toml')]); assert 'adaptive_manifest_schema/manifest-schema.toml' in names"

# save progress
git add -A
git commit -m "update"
git push -u origin main

Agent Usage

This repository is structured for agent-assisted maintenance. Read these files in order before generating any artifact:

  1. MANIFEST.toml - repository contract and agent configuration
  2. SKILL.md - operating guide and interface contract
  3. DECISIONS.md - design rationale
  4. AGENTS.md - workflow requirements
  5. AGENT_CONDUCT.md - behavioral constraints

Documentation

Documentation Site

See also

License

MIT © 2026 Adaptive Interfaces

Project links

Data verified by PyPI on May 5, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for denisecase from gravatar.com denisecase

Credits

Author: Adaptive Interfaces

GitHub Statistics

Data verified by PyPI on May 5, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

MIT
View SPDX License List

Requires

Python >=3.15

Provides Extra

dev docs

Tags

adaptive-interfaces manifest schema toml validation

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

adaptive_manifest_schema-0.3.0.tar.gz (17.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

adaptive_manifest_schema-0.3.0-py3-none-any.whl (20.8 kB view details)

Uploaded Python 3

File details

Details for the file adaptive_manifest_schema-0.3.0.tar.gz.

File metadata

  • Download URL: adaptive_manifest_schema-0.3.0.tar.gz
  • Upload date:
  • Size: 17.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for adaptive_manifest_schema-0.3.0.tar.gz
Algorithm Hash digest
SHA256 cbd037464ed536a84457d6a1d4f6bd32a4a14060d5d20712188eb8e2df4b4e3a
MD5 977fc7b921b45343a2b64ba04c379825
BLAKE2b-256 bdff93098dc7b45d4dcb8f3ff5e0e6b27d0cc6a5fdb4bc0ecdbcf7d1464bbe8e

See more details on using hashes here.

Provenance

The following attestation bundles were made for adaptive_manifest_schema-0.3.0.tar.gz:

Publisher: release-pypi.yml on adaptive-interfaces/adaptive-manifest-schema

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file adaptive_manifest_schema-0.3.0-py3-none-any.whl.

File metadata

File hashes

Hashes for adaptive_manifest_schema-0.3.0-py3-none-any.whl
Algorithm Hash digest
SHA256 98de5146fa45c05f15d3938af3999381df6a2964a5f74cb24d455569f2540f23
MD5 24198f0cea6cfff02a72e2116f057355
BLAKE2b-256 9332b92a8dbeffb6402f8425dccbb313d21f8a8c20fa16bb88b1fb9504429467

See more details on using hashes here.

Provenance

The following attestation bundles were made for adaptive_manifest_schema-0.3.0-py3-none-any.whl:

Publisher: release-pypi.yml on adaptive-interfaces/adaptive-manifest-schema

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

0.3.0 This release

2 files

0.2.0

2 files

0.1.0

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page