feat: integrate the classification and enrichment packages

CONTRIBUTING.md

@@ -41,6 +41,7 @@ Prefer extending the package that owns the concept:
 | `@0xintuition/iid-spec` | Normative identity specification and fixtures |
 | `@0xintuition/iid` | Canonical parsing, validation, and derivation |
 | `@0xintuition/iid-registry` | Classification and provider capability resolution |
+| `@0xintuition/pipeline-runtime` | Effect-free runtime utilities and provider host policies; consumer-owned Effect integrations |
 | `@0xintuition/iid-ladder` | Identifier selection from application/import input |
 | `@0xintuition/ids` | Deterministic atom, predicate, triple, and counter-triple IDs |
 | `@0xintuition/classifications` | Intuition atom classifications, recommended fields, metadata predicates, matrix rows, and creation profiles |
@@ -49,8 +50,11 @@ Prefer extending the package that owns the concept:
 | `@0xintuition/protocol` | Core contract wrappers, event parsing, and protocol interaction helpers; re-exports core ABIs and addresses from `deployments` |
 | `@0xintuition/periphery` | Periphery contract helpers (bridge, router, FeeProxy); re-exports periphery ABIs and addresses from `deployments` |
 | `@0xintuition/sdk` | Integration-level API reads, onchain action planning, and deterministic utilities composed from the protocol packages |
-| `@0xintuition/cli` | Side-effect-free calldata encoders, agent action plan builders, and the `intuition` executable |
+| `@0xintuition/cli` | Side-effect-free calldata encoders, deprecated SDK action plan aliases, and the `intuition` executable |
 | `@0xintuition/react` | React providers and hooks |
+| `@0xintuition/atom-parser` | Input detection, normalization, optional remote inspection, parser types; apps own configured fetch policy and worker integration |
+| `@0xintuition/atom-classification` | Classification engine, plugin contracts, reusable classifiers/resolvers, configurable presets; apps own enabled plugins, fallback policy, injected identity capabilities and service wiring |
+| `@0xintuition/atom-enrichment` | Enrichment engine, provider adapters, extraction, artifact validation, cache interfaces and reusable adapters; apps own credentials, cache provisioning/configuration, queue scheduling, retries, persistence and service wiring |
 
 Keep package dependencies one-way. Focused foundation packages should stay
 usable on their own; for example, `ids` should not import `primitives`, and
@@ -121,7 +125,7 @@ and PR before implementation.
 
 ## Local Setup
 
-Use Node 22.12+ and the Bun version pinned in `package.json`. The repo enforces
+Use Node 20 minimum (Node 24 tested) and the Bun version pinned in `package.json`. The repo enforces
 Bun installs. Package consumers can use npm or another package manager.
 
 ```bash
@@ -207,3 +211,12 @@ packages, but published versions must never be reused.
 Keep assistant instructions, prompts, and planning notes in ignored local directories
 such as `.local/`. Commit public API documentation, tests, and reproducible release
 checks. Package publication checks reject internal agent files in npm tarballs.
+
+## Relative ESM imports
+
+Use `.js` relative specifiers for new TypeScript modules where practical. Existing
+packages and generators still emit extensionless imports, so builds retain
+`scripts/normalize-dist-imports.mjs` to resolve them to Node-compatible `.js` and
+`/index.js` paths. Removing the normalizer requires migrating those sources and
+generators together and passing the Node tarball consumer checks; that migration
+is outside this pre-publication hygiene pass.

README.md

@@ -28,7 +28,7 @@ The IID packages and anchor API are new in this release candidate; the existing
 npm `alpha` tags do not yet contain them. See the [release guide](./docs/release.md)
 for package versions and validation requirements.
 
-To run the dry-run UI example from a checkout, use Node 22.12+ and the Bun version
+To run the dry-run UI example from a checkout, use Node 20 minimum (Node 24 tested) and the Bun version
 pinned in `package.json`:
 
 ```bash
@@ -54,8 +54,12 @@ relationships, sameAs links, and deterministic IDs without submitting transactio
 
 See the [IID explainer](./packages/iid-spec/explainer.md) for identity schemes and
 representation profiles. The packages supply deterministic identity and graph
-building tools; application-specific enrichment, ranking, and reasoning policies
-remain in your application.
+building tools and reusable parsing, classification, and enrichment runtimes.
+Applications configure providers, credentials, cache adapters, scheduling,
+ranking, and persistence; importing a runtime does not start a worker or fetch data.
+
+For the coordinated Core extraction and publication gates, see the
+[atom runtime migration runbook](./docs/atom-runtime-migration.md).
 
 ## What You Can Build
 
@@ -87,9 +91,10 @@ Use `fields` to render atom inputs and `relationships` to suggest triples such a
 | Semantic / data modeling | `schema-org`, `classifications`, `predicates` | Canonical vocabulary, schema references, recommended atom fields, metadata predicates, and relationship guardrails |
 | Identity | `iid-spec`, `iid`, `iid-registry`, `iid-ladder`, `ids` | Canonical real-world identifiers, semantic/provider resolution, deterministic input projection, and content-addressable protocol IDs |
 | Builder helpers | `primitives` | Higher-level atom, predicate, triple, discovery, and validation helpers |
+| Pipeline runtime | `pipeline-runtime` | Effect-free concurrency, circuit breaking, cancellation, observation, and provider host policies |
+| Atom processing | `atom-parser`, `atom-classification`, `atom-enrichment` | Input parsing, plugin-based classification, provider execution, and field extraction |
 | Application integration | `sdk`, `cli` | Typed action plans, API reads, and deterministic command-line calldata generation |
 | Protocol plumbing | `protocol`, `deployments`, `periphery`, `curves`, `react` | ABIs, bytecode, chain/deployment metadata, bridge/router and fee-proxy helpers, curve math, and React hooks |
-| Integration and agents | `sdk`, `cli` | Action planning and read helpers over the protocol packages, plus side-effect-free calldata encoders, plan builders, and the `intuition` executable |
 
 ## Packages
 
@@ -108,6 +113,10 @@ Use `fields` to render atom inputs and `relationships` to suggest triples such a
 - [`@0xintuition/curves`](https://www.npmjs.com/package/@0xintuition/curves) - bonding curve math helpers, including dynamic-fee curve quotes and exact-net gross-up quotes.
 - [`@0xintuition/sdk`](https://www.npmjs.com/package/@0xintuition/sdk) - integration SDK with API reads, onchain action planning helpers, and deterministic utilities.
 - [`@0xintuition/cli`](https://www.npmjs.com/package/@0xintuition/cli) - agent-oriented calldata encoders, action plan builders, and the `intuition` executable.
+- `@0xintuition/pipeline-runtime` - Effect-free Promise runtime utilities and provider host policies.
+- `@0xintuition/atom-parser` - input detection, normalization, and bounded remote inspection.
+- `@0xintuition/atom-classification` - configurable classification engines and reusable plugins.
+- `@0xintuition/atom-enrichment` - provider adapters, enrichment execution, and field extraction using public classification specifications.
 - [`@0xintuition/react`](https://www.npmjs.com/package/@0xintuition/react) - React provider and hooks for protocol reads/writes.
 
 ## Install