spec-objects-enterprise

Filament Module: tier-2 enterprise-architecture ObjectTypes (capability, business_function, value_stream, decision, objective, principle, kpi)

An Agent-IX Filament module loaded by quire-cli and quoin.

Installing quire-cli

@agent-ix packages are published to public npm. Install the CLI globally:

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-enterprise. 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.

npm install @agent-ix/spec-objects-enterprise

# quoin — resolve the module from npm by name
quoin plugin install package:@agent-ix/spec-objects-enterprise

# or point any tool at the installed package root
quire validate spec/**/*.md --module node_modules/@agent-ix/spec-objects-enterprise

Object types provided

| Object | type: | Description | |:-------|:--------|:------------| | Capability | capability | An ability the organization possesses (e.g. Order Fulfillment), decomposed into an H2 "Sub-capabilities" list of child capabilities. | | Business Function | business_function | An organizational function (e.g. Supply Chain Management) described in an H2 "Description" covering what it does, who performs it and which capabilities it supports. | | Value Stream | value_stream | An end-to-end flow of value to a stakeholder (e.g. Order to Delivery), listing its ordered "Stages" and the value each stage adds. | | Decision | decision | An architectural decision (e.g. adopt event-driven order orchestration) stated in an H2 "Decision" with its scope and the alternatives it supersedes. | | Objective | objective | A measurable goal carrying frontmatter metric and target (with optional deadline), explaining why it matters and how it will be pursued. | | Principle | principle | A guiding rule (e.g. promise only what the network can deliver) justified in an H2 "Rationale" with its implications. | | KPI | kpi | A key performance indicator carrying frontmatter metric and target (with optional threshold), explaining how it is computed, who owns it and what happens on a breach. |

Semantic contract

Every object type ships a real JSON Schema 2020-12 declaration record under spec_objects_enterprise/schemas/, emitted from typespec/main.tsp against @agent-ix/semantic-core and referenced from manifest.yaml by path. The skeletons author their declarations in the typed ## Properties table (or the equivalent sysml fence), with clauses as ocl fences under ## Invariants.

One rule is worth naming here, because it is the reason the KPI type has a schema at all: a KPI declaration is a measure definition, never a reading of one. Kpi.json requires at least one field carrying a unit (a dimensionless measure uses the UCUM unity symbol 1) and admits no identity field and no Timestamp field — the identity and the instant an observation would carry. An objective is its mirror: time-bound, and referencing a KPI definition through its targets rather than declaring a measure of its own.

make schemas        # re-emit schemas/ from typespec/
make schemas-check  # fail on any drift (also run by `make lint`)
poetry install       # installs the Quire wheel the semantic tests need

quire is a pinned dev dependency resolved from internal-pypi, so poetry install provisions the Quire release carrying extract_semantic. The semantic tests fail rather than skip when it is absent: a skipped row is not coverage.

How this module is used

With quoin (recommended)

quoin plugin install path:../spec-objects-enterprise
quoin catalog list
quoin write . --types capability,value_stream
quoin review

See https://github.com/agent-ix/quoin.

With quire-cli directly

quire schema capability --module ./spec_objects_enterprise
quire validate spec/**/*.md --module ./spec_objects_enterprise
quire extract DEC-001.md --module ./spec_objects_enterprise

See https://github.com/agent-ix/quire-cli#usage-instructions.

Development

Native Poetry-based Python 3.13+ package (flat layout, package at root). Common targets:

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 + sdist under dist/
make update-lock      # update poetry.lock
make local-publish    # publish to local pypi.ix

CI (GitHub Actions) runs tests and lint on push/PR, and on a v*.*.* tag builds with poetry build and publishes to Google Artifact Registry via twine upload -r internal-pypi. Versioning is dynamic from the Git tag. Required CI config: secret GCP_SERVICE_ACCOUNT_KEY; variables GCP_REGION, GCP_PROJECT_NAME, GCP_PYPI.