{"_id":"@agent-ix/spec-objects-operational","_rev":"3-4b4bcb2c38f092f61c36e5148b7d8290","name":"@agent-ix/spec-objects-operational","dist-tags":{"latest":"0.6.0"},"versions":{"0.5.0":{"name":"@agent-ix/spec-objects-operational","version":"0.5.0","keywords":["agent-ix","filament","filament-module","quoin","quire","spec"],"author":{"name":"Agent IX","email":"agents@agent-ix.dev"},"license":"MIT","_id":"@agent-ix/spec-objects-operational@0.5.0","maintainers":[{"name":"agent-ix","email":"peter@agent-ix.ai"}],"homepage":"https://github.com/agent-ix/spec-objects-operational#readme","bugs":{"url":"https://github.com/agent-ix/spec-objects-operational/issues"},"dist":{"shasum":"dbbc2f2c56dc4717c9f506d727f4e9cc8d643e75","tarball":"https://registry.npmjs.org/@agent-ix/spec-objects-operational/-/spec-objects-operational-0.5.0.tgz","fileCount":12,"integrity":"sha512-8TIftvgR0RYaBSM/zoof8iN6ws87XdZXLzc4ZmIruUr/SDSOmt51UV3JY92pEBVquzzIXvUnWPInAbvidHc9NQ==","signatures":[{"sig":"MEYCIQDNNKMOsjQkkd6BCJNLE0UmP90+QVM967EN0MU2FW8o7gIhAMfVWYb9INltF8Aance6kIH9M/Jd/ac6rqpiwRA8zKNi","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":55423},"gitHead":"3a77e270e3c937063fdf57f32f4ad6b6a9f2df24","scripts":{"prepack":"node scripts/stage-npm.mjs"},"_npmUser":{"name":"agent-ix","email":"peter@agent-ix.ai"},"repository":{"url":"git+https://github.com/agent-ix/spec-objects-operational.git","type":"git"},"_npmVersion":"10.9.8","description":"Filament Module: tier-2 operational ObjectTypes (configuration, migration, hook, job, sli, slo)","directories":{},"_nodeVersion":"22.23.0","publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/spec-objects-operational_0.5.0_1782529032585_0.9363602308583812","host":"s3://npm-registry-packages-npm-production"}},"0.5.1":{"name":"@agent-ix/spec-objects-operational","version":"0.5.1","keywords":["agent-ix","filament","filament-module","quoin","quire","spec"],"author":{"name":"Agent IX","email":"agents@agent-ix.dev"},"license":"AGPL-3.0-or-later","_id":"@agent-ix/spec-objects-operational@0.5.1","maintainers":[{"name":"agent-ix","email":"peter@agent-ix.ai"}],"homepage":"https://github.com/agent-ix/spec-objects-operational#readme","bugs":{"url":"https://github.com/agent-ix/spec-objects-operational/issues"},"dist":{"shasum":"2cf8f0f5fe227732f2f6c2cf69a1bfc035dd7fad","tarball":"https://registry.npmjs.org/@agent-ix/spec-objects-operational/-/spec-objects-operational-0.5.1.tgz","fileCount":12,"integrity":"sha512-GW0RSdmfiH2PDWTYObNeWaUcRDY7GequaJ8BdihjvmSse5x8ZLsK7a5p6kOSGpq3nh1xA3q3SiKvgu67Bhx9hA==","signatures":[{"sig":"MEQCIDDlx6i9/m1HiwKfygbSFPQpHA0lcOYRsmWmF5NmEjH7AiBmh/yw951/USdzL+Ddzgjfb3LtpJeK0Poz3aiyJ+opDA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":55437},"gitHead":"d0caaedbd79138988dc350cbca64808a70db5d65","scripts":{"prepack":"node scripts/stage-npm.mjs"},"_npmUser":{"name":"agent-ix","email":"peter@agent-ix.ai"},"repository":{"url":"git+https://github.com/agent-ix/spec-objects-operational.git","type":"git"},"_npmVersion":"10.9.8","description":"Filament Module: tier-2 operational ObjectTypes (configuration, migration, hook, job, sli, slo)","directories":{},"_nodeVersion":"22.23.0","publishConfig":{"access":"public","registry":"https://registry.npmjs.org/"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/spec-objects-operational_0.5.1_1782538119860_0.893742037320514","host":"s3://npm-registry-packages-npm-production"}},"0.6.0":{"name":"@agent-ix/spec-objects-operational","version":"0.6.0","description":"Filament Module: tier-2 operational ObjectTypes (configuration, migration, hook, job, sli, slo)","license":"AGPL-3.0-or-later","author":{"name":"Agent IX","email":"agents@agent-ix.dev"},"keywords":["agent-ix","filament","filament-module","quoin","quire","spec"],"scripts":{"prepack":"node scripts/stage-npm.mjs"},"publishConfig":{"registry":"https://registry.npmjs.org/","access":"public"},"repository":{"type":"git","url":"git+https://github.com/agent-ix/spec-objects-operational.git"},"gitHead":"7eae00cab87f6f9262128f0e2fc9f93cf2e1d577","_id":"@agent-ix/spec-objects-operational@0.6.0","bugs":{"url":"https://github.com/agent-ix/spec-objects-operational/issues"},"homepage":"https://github.com/agent-ix/spec-objects-operational#readme","_nodeVersion":"22.23.1","_npmVersion":"12.0.2","dist":{"integrity":"sha512-DeGJthTRgjENFGBj4rrXG2ahgYONEfw4DCSfpx2nlIjdbHD5XHMqfBOD4q11w0MkoNYKISojKTSq3U7l38OeEg==","shasum":"396ea8b37e9622c51bb19e51d6100a96d490410d","tarball":"https://registry.npmjs.org/@agent-ix/spec-objects-operational/-/spec-objects-operational-0.6.0.tgz","fileCount":12,"unpackedSize":55437,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQC/OQP1jJvs+kxdT+JKDeK9aUHtl9bxtPbDg7W+RU81CwIhAMc8TjJF35r8rCMGC/nAWgEaMHg4LwDIRcqVF8K7Gcic"}]},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:18ae0f2b-3efd-4688-a19e-5b4f68b9e739"}},"directories":{},"maintainers":[{"name":"agent-ix","email":"peter@agent-ix.ai"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/spec-objects-operational_0.6.0_1786207970897_0.6638045416578964"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-27T02:57:12.438Z","modified":"2026-08-08T16:52:51.194Z","0.5.0":"2026-06-27T02:57:12.717Z","0.5.1":"2026-06-27T05:28:40.002Z","0.6.0":"2026-08-08T16:52:51.044Z"},"bugs":{"url":"https://github.com/agent-ix/spec-objects-operational/issues"},"author":{"name":"Agent IX","email":"agents@agent-ix.dev"},"license":"AGPL-3.0-or-later","homepage":"https://github.com/agent-ix/spec-objects-operational#readme","keywords":["agent-ix","filament","filament-module","quoin","quire","spec"],"repository":{"type":"git","url":"git+https://github.com/agent-ix/spec-objects-operational.git"},"description":"Filament Module: tier-2 operational ObjectTypes (configuration, migration, hook, job, sli, slo)","maintainers":[{"name":"agent-ix","email":"peter@agent-ix.ai"}],"readme":"# spec-objects-operational\n\n> Filament Module: tier-2 operational ObjectTypes (configuration, migration, hook, job, sli, slo)\n\nAgent-IX Filament module loaded by [`quire-cli`](https://github.com/agent-ix/quire-cli) and [`quoin`](https://github.com/agent-ix/quoin).\n\n## Installing quire-cli\n\n`@agent-ix` packages are published to public npm. Install the CLI globally:\n\n```bash\nnpm install -g @agent-ix/quire-cli\n```\n\nSee https://github.com/agent-ix/quire-cli#install for details.\n\n## Install this module via npm\n\nThis module is also published as a config-only npm package: `@agent-ix/spec-objects-operational`.\nThe package root **is** the Filament module (`manifest.yaml` + schemas/skeletons),\nso it works directly as a `--module` target or via quoin's `package:` source.\n\n```bash\nnpm install @agent-ix/spec-objects-operational\n```\n\n```bash\n# quoin — resolve the module from npm by name\nquoin plugin install package:@agent-ix/spec-objects-operational\n\n# or point any tool at the installed package root\nquire validate spec/**/*.md --module node_modules/@agent-ix/spec-objects-operational\n```\n\n## Object types provided\n\n| Object | `type:` | Description |\n|--------|---------|-------------|\n| 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. |\n| Migration | `migration` | A database migration carrying its runnable, idempotent/guarded change in a required `## Migration` SQL code block. |\n| SLI | `sli` | A service-level indicator defining what is measured (e.g. the success ratio) via a required `## Query` code block. |\n| SLO | `slo` | A service-level objective with frontmatter `target` and `window` fields, describing the reliability goal and its error budget. |\n| Alert | `alert` | A burn-rate/monitoring alert whose escalation logic is a required `## Flow` mermaid diagram. |\n| Runbook | `runbook` | An ordered, executable response procedure captured as a required `## Steps` list with the exact operator commands. |\n| Incident | `incident` | A post-incident record with a required `## Timeline` of timestamped (UTC), ordered, factual events. |\n| Deployment | `deployment` | A deployment topology rendered as a required `## Topology` mermaid diagram of replicas, services, and dependencies. |\n\n## How this module is used\n\n### With quoin (recommended)\n\n```bash\nquoin plugin install path:../spec-objects-operational\nquoin catalog list\nquoin write . --types configuration,slo\nquoin review\n```\n\nSee https://github.com/agent-ix/quoin.\n\n### With quire-cli directly\n\n```bash\nquire schema configuration --module ./spec_objects_operational\nquire validate spec/**/*.md --module ./spec_objects_operational\nquire extract SLO-001.md --module ./spec_objects_operational\n```\n\nSee https://github.com/agent-ix/quire-cli#usage-instructions.\n\n## Development\n\nPython 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*.*.*`.\n\n```bash\nmake install          # install dependencies in Poetry venv\nmake test             # run pytest\nmake lint             # ruff + black check\nmake format           # ruff + black format\nmake build            # build wheel and sdist under dist/\nmake update-lock      # update poetry.lock\nmake use-local p=<name>     # switch dep to local pypi.ix\nmake use-upstream p=<name>  # switch dep back to upstream\nmake local-publish    # build and publish to local pypi.ix\n```\n\nInstall from local PyPI:\n\n```bash\npip install --index-url http://pypi.ix/root/dev/+simple/ spec_objects_operational\n```\n\nCI 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.\n","readmeFilename":"README.md"}