@orkestrel/qualifier 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Orkestrel
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,67 @@
+# @orkestrel/qualifier
+
+A typed **pre-rating eligibility engine** over [`@orkestrel/reason`](https://github.com/orkestrel/reason):
+authored **passes** — quantitative derivations and logical rule gates — run in order
+against a **subject** (a plain data record) to produce **findings** (evidence-rich
+ruling outcomes), **derivations** (quantitative audit trails), and **eligibility**
+(global plus per-scope). The caller supplies the definition; `Qualifier` only
+evaluates what it is given. Qualification never mutates its inputs — every result is
+a fresh object. Environment-agnostic — no I/O, no browser or server assumptions.
+Part of the `@orkestrel` line.
+
+## Install
+
+```sh
+npm install @orkestrel/qualifier
+```
+
+## Requirements
+
+- Node.js >= 24
+- ESM (`import`) and CommonJS (`require`) via the `exports` field
+
+## Usage
+
+```ts
+import { createQualifier, qualificationDefinition, rulingDefinition } from '@orkestrel/qualifier'
+import { atom, logicalDefinition, rule } from '@orkestrel/reason'
+
+const gates = logicalDefinition('gates', 'Eligibility gates', [
+	rule('licensed', [atom('licensed', 'equals', false)], atom('blocked', 'equals', true)),
+])
+
+const definition = qualificationDefinition('standard', 'Standard eligibility', [gates], {
+	rulings: [
+		rulingDefinition('license', 'gates', 'licensed', 'restriction', {
+			message: 'A license is required',
+		}),
+	],
+})
+
+const qualifier = createQualifier()
+const result = qualifier.qualify({ id: 'risk-1', licensed: false }, definition)
+
+result.eligibility // 'ineligible'
+result.findings[0]?.message // 'A license is required'
+result.derivations // [] — no quantitative pass ran
+
+qualifier.destroy()
+```
+
+`qualify` accepts exactly one subject per call — there is no batch-of-subjects
+overload. Every `qualify` call fires once through `qualifier.emitter` (`qualify`).
+
+## Guide
+
+For the full surface — `Qualifier`, `QualificationResult`, finding types, validators,
+factories, errors, and options — see
+[`guides/src/qualifier.md`](guides/src/qualifier.md).
+
+## Package
+
+Published as a single typed entry point per the `exports` field in
+`package.json`.
+
+## License
+
+MIT © [Orkestrel](https://github.com/orkestrel) — see [LICENSE](./LICENSE).