@soleri/domain-component

Component registry lifecycle domain pack for Soleri agents.

What it does

Provides component intelligence ops across a single component domain: search, inspect, register, drift detection, dependency analysis, and sync status checking. Ops are vault-backed when a PackRuntime is available, with an in-memory registry fallback.

Ops

| Op | Auth | Description | |----|------|-------------| | search | read | Search vault for components by query string | | get | read | Get a component by ID from the registry | | list | read | List components with optional tag/name filters | | create | write | Register a new component in the vault with metadata | | detect_drift | read | Compare component code against stored vault metadata to detect prop/structure changes | | analyze_dependencies | read | Parse import statements in component code to build a dependency graph | | sync_status | read | Check sync between vault registry and a provided file list |

Install

npm install @soleri/domain-component

Requires @soleri/core ^9.0.0 as a peer dependency.

Usage

Add the pack to your agent.yaml:

packs:
  - name: component
    package: "@soleri/domain-component"

Development

npm install
npm run build       # tsc
npm test            # vitest
npm run typecheck   # tsc --noEmit

Pack Structure

src/
  index.ts          # Pack definition (default export)
  __tests__/        # Tests
data/               # Static data files (JSON, etc.)
knowledge/          # Tiered knowledge (canonical, curated, captured)

Publishing

Tag a release and push to trigger CI:

git tag v<version>
git push origin v<version>

License

Apache-2.0