Plan-001 — semantic data schemas
Contents of the Plan-001 bundle.
Open source Repository Open in the app JSON README (API)
About
# Plan-001 — semantic data schemas
## Contents
* [Plan-001: semantic data schemas](./plan.md) - Plan overview, dependency graph, tracks, gates, test plan.
* [Task-001](./tasks/Task-001-typespec-toolchain-generator.md) - TypeSpec toolchain, schema generator and drift gate.
* [Task-002](./tasks/Task-002-role-distinct-models.md) - The eight role-distinct models and their support models.
* [Task-003](./tasks/Task-003-emitted-set-digests-packaging.md) - Emitted set, toolchain.json, digests and packaging.
* [Task-004](./tasks/Task-004-manifest-semantic-contract.md) - Manifest 0.3.0, semantic block, reference data_schema, lexicon repair.
* [Task-005](./tasks/Task-005-executable-skeletons.md) - Executable skeletons, sysml alternates and negative fixtures.
* [Task-006](./tasks/Task-006-added-locators.md) - required:false locators for the sections the skeletons introduced.
* [Task-007](./tasks/Task-007-test-environment-and-baseline.md) - Quire provisioning, the no-vacuous-skip gate and the 0.2
Details
- Kind
- OKF bundles
- Topic
- Cloud & DevOps
- Publisher
- agent-ix
- Origin
- okf_github
- Category
- dados
- Version
- 0.1
- Stars
- 1
- Last push
- 2026-09-04T22:12:40Z
- Repository state
- ativo
- Language
- Python
- License
- AGPL-3.0
- Added
- 2026-09-08 22:08:51
- Updated
- 2026-09-08 22:08:51
- Origin id
agent-ix/spec-objects-operational:plan/Plan-001-semantic-data-schemas/index.md
README
# spec-objects-operational > Filament Module: tier-2 operational ObjectTypes (configuration, migration, hook, job, sli, slo) Agent-IX Filament module loaded by [`quire-cli`](https://github.com/agent-ix/quire-cli) and [`quoin`](https://github.com/agent-ix/quoin). ## Installing quire-cli `@agent-ix` packages are published to public npm. Install the CLI globally: ```bash npm install -g @agent-ix/quire-cli ``` See https://github.com/agent-ix/quire-cli#install for details. ## Install this module via npm This module is also published as a config-only npm package: `@agent-ix/spec-objects-operational`. The package root **is** the Filament module (`manifest.yaml` + schemas/skeletons), so it works directly as a `--module` target or via quoin's `package:` source. ```bash npm install @agent-ix/spec-objects-operational ``` ```bash # quoin — resolve the module from npm by name quoin plugin install package:@agent-ix/spec-objects-operational # or point any tool at the installed package root quire validate spec/**/*.md --module node_modules/@agent-ix/spec-objects-operational ``` ## Object types provided | Object | `type:` | Description | |--------|---------|-------------| | Configuration | `configuration` | A service's tunable settings as a required `## Configuration` table (Name, Scope, Type, Default, Description), where Scope ∈ creation \| runtime \| session, plus optional load/reload Behavior. | | Migration | `migration` | A database migration carrying its runnable, idempotent/guarded change in a required `## Migration` SQL code block. | | SLI | `sli` | A service-level indicator defining what is measured (e.g. the success ratio) via a required `## Query` code block. | | SLO | `slo` | A service-level objective with frontmatter `target` and `window` fields, describing the reliability goal and its error budget. | | Alert | `alert` | A burn-rate/monitoring alert whose escalation logic is a required `## Flow` mermaid diagram. | | Runbook | `runbook` | An ordered, executable response procedure captured as a required `## Steps` list with the exact operator commands. | | Incident | `incident` | A post-incident record with a required `## Timeline` of timestamped (UTC), ordered, factual events. | | Deployment | `deployment` | A deployment topology rendered as a required `## Topology` mermaid diagram of replicas, services, and dependencies. | ## How this module is used ### With quoin (recommended) ```bash quoin plugin install path:../spec-objects-operational quoin catalog list quoin write . --types configuration,slo quoin review ``` See https://github.com/agent-ix/quoin. ### With quire-cli directly ```bash quire schema configuration --module ./spec_objects_operational quire validate spec/**/*.md --module ./spec_objects_operational quire extract SLO-001.md --module ./spec_objects_operational ``` See https://github.com/agent-ix/quire-cli#usage-instructions. ## Development Python 3.13+ package (`spec_objects_operational`, flat layout) managed with Poetry. CI runs on GitHub Actions and publishes to Google Artifact Registry (PyPI-compatible) on `tag v*.*.*`. ```bash make install # install dependencies in Poetry venv make test # run pytest make lint # ruff + black check make format # ruff + black format make build # build wheel and sdist under dist/ make update-lock # update poetry.lock make use-local p=<name> # switch dep to local pypi.ix make use-upstream p=<name> # switch dep back to upstream make local-publish # build and publish to local pypi.ix ``` Install from local PyPI: ```bash pip install --index-url http://pypi.ix/root/dev/+simple/ spec_objects_operational ``` CI requires the `GCP_SERVICE_ACCOUNT_KEY` secret and the `GCP_REGION`, `GCP_PROJECT_NAME`, and `GCP_PYPI` variables for Artifact Registry publishing. Versioning is dynamic from the Git tag.