tigrbl-kernel 0.4.2.dev3__tar.gz → 0.4.2.dev4__tar.gz

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (54) hide show
  1. tigrbl_kernel-0.4.2.dev4/NOTICE +7 -0
  2. {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/PKG-INFO +114 -28
  3. tigrbl_kernel-0.4.2.dev4/README.md +157 -0
  4. {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/pyproject.toml +1 -1
  5. tigrbl_kernel-0.4.2.dev3/README.md +0 -72
  6. {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/LICENSE +0 -0
  7. {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/__init__.py +0 -0
  8. {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/_build.py +0 -0
  9. {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/_compile.py +0 -0
  10. {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/atoms.py +0 -0
  11. {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/cache.py +0 -0
  12. {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/callbacks.py +0 -0
  13. {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/contract_classification.py +0 -0
  14. {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/core.py +0 -0
  15. {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/eventkey.py +0 -0
  16. {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/eventkey_hooks.py +0 -0
  17. {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/events.py +0 -0
  18. {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/helpers.py +0 -0
  19. {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/hook_types.py +0 -0
  20. {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/labels.py +0 -0
  21. {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/lifecycle_matrix.py +0 -0
  22. {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/loop_modes.py +0 -0
  23. {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/loop_regions.py +0 -0
  24. {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/measure.py +0 -0
  25. {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/models.py +0 -0
  26. {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/opchannel_capabilities.py +0 -0
  27. {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/opview_compiler.py +0 -0
  28. {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/ordering.py +0 -0
  29. {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/payload.py +0 -0
  30. {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/protocol_bindings.py +0 -0
  31. {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/protocol_chains/__init__.py +0 -0
  32. {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/protocol_chains/http_stream.py +0 -0
  33. {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/protocol_chains/http_unary.py +0 -0
  34. {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/protocol_chains/lifespan.py +0 -0
  35. {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/protocol_chains/sse.py +0 -0
  36. {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/protocol_chains/static_files.py +0 -0
  37. {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/protocol_chains/websocket.py +0 -0
  38. {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/protocol_completion.py +0 -0
  39. {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/protocol_fusion.py +0 -0
  40. {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/protocol_legality_matrix.py +0 -0
  41. {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/protocol_phase_tree.py +0 -0
  42. {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/rust_compile.py +0 -0
  43. {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/rust_plan.py +0 -0
  44. {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/rust_spec.py +0 -0
  45. {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/segment_fusion.py +0 -0
  46. {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/subevent_handlers.py +0 -0
  47. {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/subevent_taxonomy.py +0 -0
  48. {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/trace.py +0 -0
  49. {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/transaction_units.py +0 -0
  50. {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/transport_atoms.py +0 -0
  51. {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/transport_events.py +0 -0
  52. {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/types.py +0 -0
  53. {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/utils.py +0 -0
  54. {tigrbl_kernel-0.4.2.dev3 → tigrbl_kernel-0.4.2.dev4}/tigrbl_kernel/webtransport_events.py +0 -0
@@ -0,0 +1,7 @@
1
+ Tigrbl
2
+ Copyright 2026 Swarmauri
3
+
4
+ This product includes software developed by Swarmauri.
5
+
6
+ Tigrbl is licensed under the Apache License, Version 2.0.
7
+ See the LICENSE file distributed with this work for the full license text.
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: tigrbl-kernel
3
- Version: 0.4.2.dev3
3
+ Version: 0.4.2.dev4
4
4
  Summary: Kernel orchestration for composing Tigrbl runtime plans, bindings, operation dispatch, and optimized ASGI execution.
5
5
  License: Apache License
6
6
  Version 2.0, January 2004
@@ -204,6 +204,7 @@ License: Apache License
204
204
  See the License for the specific language governing permissions and
205
205
  limitations under the License.
206
206
  License-File: LICENSE
207
+ License-File: NOTICE
207
208
  Keywords: tigrbl,asgi,api,json-rpc,rest,sqlalchemy,pydantic,kernel,orchestration,dispatch,openapi,openrpc,schema-first
208
209
  Author: Jacob Stewart
209
210
  Author-email: jacob@swarmauri.com
@@ -240,12 +241,45 @@ Description-Content-Type: text/markdown
240
241
  <p><strong>Kernel orchestration for composing Tigrbl runtime plans, bindings, operation dispatch, and optimized ASGI execution.</strong></p>
241
242
  <a href="https://pypi.org/project/tigrbl-kernel/"><img src="https://img.shields.io/pypi/v/tigrbl-kernel?label=PyPI" alt="PyPI version for tigrbl-kernel"/></a>
242
243
  <a href="https://pypi.org/project/tigrbl-kernel/"><img src="https://static.pepy.tech/badge/tigrbl-kernel" alt="Downloads for tigrbl-kernel"/></a>
244
+ <a href="https://discord.gg/K4YTAPapjR"><img src="https://img.shields.io/badge/Discord-Join%20chat-5865F2?logo=discord&logoColor=white" alt="Discord community for tigrbl-kernel"/></a>
243
245
  <a href="https://github.com/tigrbl/tigrbl/blob/master/pkgs/core/tigrbl_kernel/README.md"><img src="https://hits.sh/github.com/tigrbl/tigrbl/blob/master/pkgs/core/tigrbl_kernel/README.md.svg?label=hits" alt="Repository hits for tigrbl-kernel README"/></a>
244
246
  <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache%202.0-525252" alt="Apache 2.0 license"/></a>
245
- <a href="pyproject.toml"><img src="https://img.shields.io/badge/python-3.10%20to%203.15-3776ab" alt="Python requirement for tigrbl-kernel"/></a>
247
+ <a href="pyproject.toml"><img src="https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12%20%7C%203.13%20%7C%203.14-3776ab" alt="Python versions 3.10 | 3.11 | 3.12 | 3.13 | 3.14 for tigrbl-kernel"/></a>
246
248
  <a href="https://github.com/tigrbl/tigrbl/blob/master/docs/README.md"><img src="https://img.shields.io/badge/workspace-core-1f6feb" alt="Workspace group for tigrbl-kernel"/></a>
247
249
  </div>
248
250
 
251
+ ## What is tigrbl-kernel?
252
+
253
+ Kernel orchestration for composing Tigrbl runtime plans, bindings, operation dispatch, and optimized ASGI execution.
254
+
255
+ ## Why use tigrbl-kernel?
256
+
257
+ Use it when you need this foundational Tigrbl layer directly as a small, focused dependency.
258
+
259
+ ## When should I install tigrbl-kernel?
260
+
261
+ Install it for extension packages, package-local tests, or internals that need this boundary without the whole facade.
262
+
263
+ ## Who is tigrbl-kernel for?
264
+
265
+ Framework maintainers, extension authors, and advanced users composing Tigrbl from split packages.
266
+
267
+ ## Where does tigrbl-kernel fit?
268
+
269
+ `tigrbl-kernel` lives at `pkgs/core/tigrbl_kernel` and serves a focused layer in the split Tigrbl framework.
270
+
271
+ ## How does tigrbl-kernel work?
272
+
273
+ It owns a narrow layer in the split workspace and is consumed by higher-level packages through explicit dependencies.
274
+
275
+ ## Certification Status
276
+
277
+ - Package status: governed package in the `tigrbl/tigrbl` workspace.
278
+ - Governance source: [SSOT registry](https://github.com/tigrbl/tigrbl/blob/master/.ssot/registry.json).
279
+ - Release evidence: [publish workflow](https://github.com/tigrbl/tigrbl/actions/workflows/publish.yml) validates package builds, tests, GitHub release assets, and PyPI publication for managed packages.
280
+ - Local certification guard: `pkgs/core/tigrbl_tests/tests/unit/test_package_badges_and_notices.py` verifies every package README keeps the Discord badge, Apache 2.0 badge, explicit Python-version badge, `LICENSE`, and `NOTICE`.
281
+ - Scope note: this README documents the package boundary. Runtime feature support remains governed by `.ssot/` entities and the conformance docs linked below.
282
+
249
283
  ## Install
250
284
 
251
285
  ```bash
@@ -256,54 +290,106 @@ uv add tigrbl-kernel
256
290
  pip install tigrbl-kernel
257
291
  ```
258
292
 
293
+ ## Surface Coverage
294
+
295
+ | Surface | Value |
296
+ |---|---|
297
+ | PyPI package | [`tigrbl-kernel`](https://pypi.org/project/tigrbl-kernel/) |
298
+ | Repository path | [`pkgs/core/tigrbl_kernel`](https://github.com/tigrbl/tigrbl/tree/master/pkgs/core/tigrbl_kernel) |
299
+ | Python import root | `tigrbl_kernel` |
300
+ | Console scripts | none declared |
301
+ | Entry points | none declared |
302
+ | Optional extras | none declared |
303
+ | Legal files | `LICENSE`, `NOTICE` |
304
+ | Supported Python | `3.10 | 3.11 | 3.12 | 3.13 | 3.14` |
305
+
259
306
  ## What It Owns
260
307
 
261
- `tigrbl-kernel` owns the kernel boundary inside the split Python workspace. Key implementation roots include `tigrbl_kernel` with `_build, _compile, atoms, cache, callbacks, core`.
308
+ `tigrbl-kernel` owns the `foundational framework package` boundary. It should be installed when you need this package's focused responsibility without assuming every other Tigrbl workspace package is present.
309
+
310
+ Implementation orientation:
311
+ - `tigrbl_kernel`: _build, _compile, atoms, cache, callbacks, contract_classification, core, eventkey, eventkey_hooks, events, helpers, hook_types
312
+
313
+ ## Public API and Import Surface
262
314
 
263
- ## Use It When
315
+ - Import roots: `tigrbl_kernel`.
316
+ - Public symbols: `BatchOpPlan`, `ExecutionBackend`, `Kernel`, `OpView`, `PackedKernel`, `RustBackendConfig`, `RustPlan`, `SchemaIn`, `SchemaOut`, `build_kernel_plan`, `build_packed_kernel`, `build_packed_kernel_measurement_view`.
317
+ - Workspace dependencies: [`tigrbl-typing`](https://pypi.org/project/tigrbl-typing/), [`tigrbl-atoms`](https://pypi.org/project/tigrbl-atoms/), [`tigrbl-core`](https://pypi.org/project/tigrbl-core/).
318
+ - External runtime dependencies: none declared.
264
319
 
265
- Use `tigrbl-kernel` when you want this subsystem directly as a package boundary instead of consuming it only through the top-level `tigrbl` facade.
320
+ ## Usage Examples
266
321
 
267
- ## Public Surface
322
+ ### Verify the installed package
268
323
 
269
- - `tigrbl_kernel` exposes `import_module, Any, Dict, List, Mapping, build_rust_kernel, build_rust_parity_snapshot, normalize_rust_spec`.
324
+ ```bash
325
+ python -m pip show tigrbl-kernel
326
+ python - <<'PY'
327
+ from importlib.metadata import version
328
+ print(version("tigrbl-kernel"))
329
+ PY
330
+ ```
270
331
 
271
- ## Internal Layout
332
+ ### Import the package boundary
272
333
 
273
- - Workspace path: `pkgs/core/tigrbl_kernel`.
274
- - Package class: `core framework package`.
275
- - Python requirement: `>=3.10,<3.15`.
276
- - `tigrbl_kernel` modules: `_build, _compile, atoms, cache, callbacks, core, eventkey, eventkey_hooks, events, helpers`.
334
+ ```python
335
+ import importlib
277
336
 
278
- ## Dependency Surface
337
+ module = importlib.import_module("tigrbl_kernel")
338
+ print(module.__name__)
339
+ ```
279
340
 
280
- - Workspace package dependencies: [`tigrbl-typing`](https://pypi.org/project/tigrbl-typing/), [`tigrbl-atoms`](https://pypi.org/project/tigrbl-atoms/), [`tigrbl-core`](https://pypi.org/project/tigrbl-core/).
281
- - External runtime dependencies: none declared.
282
- - Optional extras: none declared.
341
+ ### Import a public symbol
342
+
343
+ ```python
344
+ from tigrbl_kernel import BatchOpPlan
345
+
346
+ print(BatchOpPlan)
347
+ ```
348
+
349
+ ### Use with the facade when building applications
350
+
351
+ ```bash
352
+ uv add tigrbl tigrbl-kernel
353
+ python - <<'PY'
354
+ import tigrbl
355
+ print(tigrbl.__name__)
356
+ PY
357
+ ```
358
+
359
+ ## How To Choose This Package
360
+
361
+ Choose `tigrbl-kernel` when the quick-answer table matches your use case. Choose [`tigrbl`](https://pypi.org/project/tigrbl/) instead when you want the full public facade. Choose a lower-level package such as [`tigrbl-core`](https://pypi.org/project/tigrbl-core/), [`tigrbl-base`](https://pypi.org/project/tigrbl-base/), or [`tigrbl-runtime`](https://pypi.org/project/tigrbl-runtime/) when you are building framework extensions or testing a specific internal boundary.
283
362
 
284
363
  ## Related Packages
285
364
 
286
- - [`tigrbl`](https://pypi.org/project/tigrbl/)
287
365
  - [`tigrbl-typing`](https://pypi.org/project/tigrbl-typing/)
288
366
  - [`tigrbl-atoms`](https://pypi.org/project/tigrbl-atoms/)
289
367
  - [`tigrbl-core`](https://pypi.org/project/tigrbl-core/)
368
+ - [`tigrbl`](https://pypi.org/project/tigrbl/)
369
+ - [`tigrbl-base`](https://pypi.org/project/tigrbl-base/)
370
+ - [`tigrbl-runtime`](https://pypi.org/project/tigrbl-runtime/)
371
+
372
+ ## Documentation Links
373
+
374
+ - [Workspace docs](https://github.com/tigrbl/tigrbl/blob/master/docs/README.md)
375
+ - [Package catalog](https://github.com/tigrbl/tigrbl/blob/master/docs/developer/PACKAGE_CATALOG.md)
376
+ - [Package layout](https://github.com/tigrbl/tigrbl/blob/master/docs/developer/PACKAGE_LAYOUT.md)
377
+ - [Current target](https://github.com/tigrbl/tigrbl/blob/master/docs/conformance/CURRENT_TARGET.md)
378
+ - [Current state](https://github.com/tigrbl/tigrbl/blob/master/docs/conformance/CURRENT_STATE.md)
379
+ - [SSOT registry](https://github.com/tigrbl/tigrbl/blob/master/.ssot/registry.json)
380
+ - [Release workflow](https://github.com/tigrbl/tigrbl/actions/workflows/publish.yml)
290
381
 
291
- ## Canonical Repository Docs
382
+ ## Support
292
383
 
293
- - `docs/README.md`
294
- - `docs/conformance/CURRENT_TARGET.md`
295
- - `docs/conformance/CURRENT_STATE.md`
296
- - `docs/conformance/NEXT_STEPS.md`
297
- - `docs/governance/DOC_POINTERS.md`
298
- - `docs/developer/PACKAGE_CATALOG.md`
299
- - `docs/developer/PACKAGE_LAYOUT.md`
384
+ - Community: [Discord](https://discord.gg/K4YTAPapjR).
385
+ - Issues: [GitHub Issues](https://github.com/tigrbl/tigrbl/issues).
386
+ - Repository: [pkgs/core/tigrbl_kernel](https://github.com/tigrbl/tigrbl/tree/master/pkgs/core/tigrbl_kernel).
300
387
 
301
388
  ## Package-local Boundary
302
389
 
303
- This file is a package-local distribution entry point.
304
- Use this page for package installation and boundary orientation. Repository governance, conformance state, target status, and release evidence remain governed from `docs/` and `.ssot/`.
390
+ This README is the package-local distribution entry point for `tigrbl-kernel`. It answers install, usage, API, ownership, and certification-orientation questions for this package. Broader architectural decisions, release status, and cross-package proof chains remain in the repository-level docs and SSOT registry.
305
391
 
306
392
  ## License
307
393
 
308
- Licensed under the Apache License, Version 2.0. See `LICENSE` and the official [Apache 2.0 license text](https://www.apache.org/licenses/LICENSE-2.0).
394
+ Licensed under the Apache License, Version 2.0. See `LICENSE`, `NOTICE`, and the official [Apache 2.0 license text](https://www.apache.org/licenses/LICENSE-2.0).
309
395
 
@@ -0,0 +1,157 @@
1
+ <div align="center">
2
+ <h1>tigrbl-kernel</h1>
3
+ <img src="https://raw.githubusercontent.com/swarmauri/swarmauri-sdk/master/assets/tigrbl_full_logo.png" alt="Tigrbl logo" width="140"/>
4
+ <p><strong>Kernel orchestration for composing Tigrbl runtime plans, bindings, operation dispatch, and optimized ASGI execution.</strong></p>
5
+ <a href="https://pypi.org/project/tigrbl-kernel/"><img src="https://img.shields.io/pypi/v/tigrbl-kernel?label=PyPI" alt="PyPI version for tigrbl-kernel"/></a>
6
+ <a href="https://pypi.org/project/tigrbl-kernel/"><img src="https://static.pepy.tech/badge/tigrbl-kernel" alt="Downloads for tigrbl-kernel"/></a>
7
+ <a href="https://discord.gg/K4YTAPapjR"><img src="https://img.shields.io/badge/Discord-Join%20chat-5865F2?logo=discord&logoColor=white" alt="Discord community for tigrbl-kernel"/></a>
8
+ <a href="https://github.com/tigrbl/tigrbl/blob/master/pkgs/core/tigrbl_kernel/README.md"><img src="https://hits.sh/github.com/tigrbl/tigrbl/blob/master/pkgs/core/tigrbl_kernel/README.md.svg?label=hits" alt="Repository hits for tigrbl-kernel README"/></a>
9
+ <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache%202.0-525252" alt="Apache 2.0 license"/></a>
10
+ <a href="pyproject.toml"><img src="https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12%20%7C%203.13%20%7C%203.14-3776ab" alt="Python versions 3.10 | 3.11 | 3.12 | 3.13 | 3.14 for tigrbl-kernel"/></a>
11
+ <a href="https://github.com/tigrbl/tigrbl/blob/master/docs/README.md"><img src="https://img.shields.io/badge/workspace-core-1f6feb" alt="Workspace group for tigrbl-kernel"/></a>
12
+ </div>
13
+
14
+ ## What is tigrbl-kernel?
15
+
16
+ Kernel orchestration for composing Tigrbl runtime plans, bindings, operation dispatch, and optimized ASGI execution.
17
+
18
+ ## Why use tigrbl-kernel?
19
+
20
+ Use it when you need this foundational Tigrbl layer directly as a small, focused dependency.
21
+
22
+ ## When should I install tigrbl-kernel?
23
+
24
+ Install it for extension packages, package-local tests, or internals that need this boundary without the whole facade.
25
+
26
+ ## Who is tigrbl-kernel for?
27
+
28
+ Framework maintainers, extension authors, and advanced users composing Tigrbl from split packages.
29
+
30
+ ## Where does tigrbl-kernel fit?
31
+
32
+ `tigrbl-kernel` lives at `pkgs/core/tigrbl_kernel` and serves a focused layer in the split Tigrbl framework.
33
+
34
+ ## How does tigrbl-kernel work?
35
+
36
+ It owns a narrow layer in the split workspace and is consumed by higher-level packages through explicit dependencies.
37
+
38
+ ## Certification Status
39
+
40
+ - Package status: governed package in the `tigrbl/tigrbl` workspace.
41
+ - Governance source: [SSOT registry](https://github.com/tigrbl/tigrbl/blob/master/.ssot/registry.json).
42
+ - Release evidence: [publish workflow](https://github.com/tigrbl/tigrbl/actions/workflows/publish.yml) validates package builds, tests, GitHub release assets, and PyPI publication for managed packages.
43
+ - Local certification guard: `pkgs/core/tigrbl_tests/tests/unit/test_package_badges_and_notices.py` verifies every package README keeps the Discord badge, Apache 2.0 badge, explicit Python-version badge, `LICENSE`, and `NOTICE`.
44
+ - Scope note: this README documents the package boundary. Runtime feature support remains governed by `.ssot/` entities and the conformance docs linked below.
45
+
46
+ ## Install
47
+
48
+ ```bash
49
+ uv add tigrbl-kernel
50
+ ```
51
+
52
+ ```bash
53
+ pip install tigrbl-kernel
54
+ ```
55
+
56
+ ## Surface Coverage
57
+
58
+ | Surface | Value |
59
+ |---|---|
60
+ | PyPI package | [`tigrbl-kernel`](https://pypi.org/project/tigrbl-kernel/) |
61
+ | Repository path | [`pkgs/core/tigrbl_kernel`](https://github.com/tigrbl/tigrbl/tree/master/pkgs/core/tigrbl_kernel) |
62
+ | Python import root | `tigrbl_kernel` |
63
+ | Console scripts | none declared |
64
+ | Entry points | none declared |
65
+ | Optional extras | none declared |
66
+ | Legal files | `LICENSE`, `NOTICE` |
67
+ | Supported Python | `3.10 | 3.11 | 3.12 | 3.13 | 3.14` |
68
+
69
+ ## What It Owns
70
+
71
+ `tigrbl-kernel` owns the `foundational framework package` boundary. It should be installed when you need this package's focused responsibility without assuming every other Tigrbl workspace package is present.
72
+
73
+ Implementation orientation:
74
+ - `tigrbl_kernel`: _build, _compile, atoms, cache, callbacks, contract_classification, core, eventkey, eventkey_hooks, events, helpers, hook_types
75
+
76
+ ## Public API and Import Surface
77
+
78
+ - Import roots: `tigrbl_kernel`.
79
+ - Public symbols: `BatchOpPlan`, `ExecutionBackend`, `Kernel`, `OpView`, `PackedKernel`, `RustBackendConfig`, `RustPlan`, `SchemaIn`, `SchemaOut`, `build_kernel_plan`, `build_packed_kernel`, `build_packed_kernel_measurement_view`.
80
+ - Workspace dependencies: [`tigrbl-typing`](https://pypi.org/project/tigrbl-typing/), [`tigrbl-atoms`](https://pypi.org/project/tigrbl-atoms/), [`tigrbl-core`](https://pypi.org/project/tigrbl-core/).
81
+ - External runtime dependencies: none declared.
82
+
83
+ ## Usage Examples
84
+
85
+ ### Verify the installed package
86
+
87
+ ```bash
88
+ python -m pip show tigrbl-kernel
89
+ python - <<'PY'
90
+ from importlib.metadata import version
91
+ print(version("tigrbl-kernel"))
92
+ PY
93
+ ```
94
+
95
+ ### Import the package boundary
96
+
97
+ ```python
98
+ import importlib
99
+
100
+ module = importlib.import_module("tigrbl_kernel")
101
+ print(module.__name__)
102
+ ```
103
+
104
+ ### Import a public symbol
105
+
106
+ ```python
107
+ from tigrbl_kernel import BatchOpPlan
108
+
109
+ print(BatchOpPlan)
110
+ ```
111
+
112
+ ### Use with the facade when building applications
113
+
114
+ ```bash
115
+ uv add tigrbl tigrbl-kernel
116
+ python - <<'PY'
117
+ import tigrbl
118
+ print(tigrbl.__name__)
119
+ PY
120
+ ```
121
+
122
+ ## How To Choose This Package
123
+
124
+ Choose `tigrbl-kernel` when the quick-answer table matches your use case. Choose [`tigrbl`](https://pypi.org/project/tigrbl/) instead when you want the full public facade. Choose a lower-level package such as [`tigrbl-core`](https://pypi.org/project/tigrbl-core/), [`tigrbl-base`](https://pypi.org/project/tigrbl-base/), or [`tigrbl-runtime`](https://pypi.org/project/tigrbl-runtime/) when you are building framework extensions or testing a specific internal boundary.
125
+
126
+ ## Related Packages
127
+
128
+ - [`tigrbl-typing`](https://pypi.org/project/tigrbl-typing/)
129
+ - [`tigrbl-atoms`](https://pypi.org/project/tigrbl-atoms/)
130
+ - [`tigrbl-core`](https://pypi.org/project/tigrbl-core/)
131
+ - [`tigrbl`](https://pypi.org/project/tigrbl/)
132
+ - [`tigrbl-base`](https://pypi.org/project/tigrbl-base/)
133
+ - [`tigrbl-runtime`](https://pypi.org/project/tigrbl-runtime/)
134
+
135
+ ## Documentation Links
136
+
137
+ - [Workspace docs](https://github.com/tigrbl/tigrbl/blob/master/docs/README.md)
138
+ - [Package catalog](https://github.com/tigrbl/tigrbl/blob/master/docs/developer/PACKAGE_CATALOG.md)
139
+ - [Package layout](https://github.com/tigrbl/tigrbl/blob/master/docs/developer/PACKAGE_LAYOUT.md)
140
+ - [Current target](https://github.com/tigrbl/tigrbl/blob/master/docs/conformance/CURRENT_TARGET.md)
141
+ - [Current state](https://github.com/tigrbl/tigrbl/blob/master/docs/conformance/CURRENT_STATE.md)
142
+ - [SSOT registry](https://github.com/tigrbl/tigrbl/blob/master/.ssot/registry.json)
143
+ - [Release workflow](https://github.com/tigrbl/tigrbl/actions/workflows/publish.yml)
144
+
145
+ ## Support
146
+
147
+ - Community: [Discord](https://discord.gg/K4YTAPapjR).
148
+ - Issues: [GitHub Issues](https://github.com/tigrbl/tigrbl/issues).
149
+ - Repository: [pkgs/core/tigrbl_kernel](https://github.com/tigrbl/tigrbl/tree/master/pkgs/core/tigrbl_kernel).
150
+
151
+ ## Package-local Boundary
152
+
153
+ This README is the package-local distribution entry point for `tigrbl-kernel`. It answers install, usage, API, ownership, and certification-orientation questions for this package. Broader architectural decisions, release status, and cross-package proof chains remain in the repository-level docs and SSOT registry.
154
+
155
+ ## License
156
+
157
+ Licensed under the Apache License, Version 2.0. See `LICENSE`, `NOTICE`, and the official [Apache 2.0 license text](https://www.apache.org/licenses/LICENSE-2.0).
@@ -1,6 +1,6 @@
1
1
  [project]
2
2
  name = "tigrbl-kernel"
3
- version = "0.4.2.dev3"
3
+ version = "0.4.2.dev4"
4
4
  description = "Kernel orchestration for composing Tigrbl runtime plans, bindings, operation dispatch, and optimized ASGI execution."
5
5
  readme = "README.md"
6
6
  license = { file = "LICENSE" }
@@ -1,72 +0,0 @@
1
- <div align="center">
2
- <h1>tigrbl-kernel</h1>
3
- <img src="https://raw.githubusercontent.com/swarmauri/swarmauri-sdk/master/assets/tigrbl_full_logo.png" alt="Tigrbl logo" width="140"/>
4
- <p><strong>Kernel orchestration for composing Tigrbl runtime plans, bindings, operation dispatch, and optimized ASGI execution.</strong></p>
5
- <a href="https://pypi.org/project/tigrbl-kernel/"><img src="https://img.shields.io/pypi/v/tigrbl-kernel?label=PyPI" alt="PyPI version for tigrbl-kernel"/></a>
6
- <a href="https://pypi.org/project/tigrbl-kernel/"><img src="https://static.pepy.tech/badge/tigrbl-kernel" alt="Downloads for tigrbl-kernel"/></a>
7
- <a href="https://github.com/tigrbl/tigrbl/blob/master/pkgs/core/tigrbl_kernel/README.md"><img src="https://hits.sh/github.com/tigrbl/tigrbl/blob/master/pkgs/core/tigrbl_kernel/README.md.svg?label=hits" alt="Repository hits for tigrbl-kernel README"/></a>
8
- <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache%202.0-525252" alt="Apache 2.0 license"/></a>
9
- <a href="pyproject.toml"><img src="https://img.shields.io/badge/python-3.10%20to%203.15-3776ab" alt="Python requirement for tigrbl-kernel"/></a>
10
- <a href="https://github.com/tigrbl/tigrbl/blob/master/docs/README.md"><img src="https://img.shields.io/badge/workspace-core-1f6feb" alt="Workspace group for tigrbl-kernel"/></a>
11
- </div>
12
-
13
- ## Install
14
-
15
- ```bash
16
- uv add tigrbl-kernel
17
- ```
18
-
19
- ```bash
20
- pip install tigrbl-kernel
21
- ```
22
-
23
- ## What It Owns
24
-
25
- `tigrbl-kernel` owns the kernel boundary inside the split Python workspace. Key implementation roots include `tigrbl_kernel` with `_build, _compile, atoms, cache, callbacks, core`.
26
-
27
- ## Use It When
28
-
29
- Use `tigrbl-kernel` when you want this subsystem directly as a package boundary instead of consuming it only through the top-level `tigrbl` facade.
30
-
31
- ## Public Surface
32
-
33
- - `tigrbl_kernel` exposes `import_module, Any, Dict, List, Mapping, build_rust_kernel, build_rust_parity_snapshot, normalize_rust_spec`.
34
-
35
- ## Internal Layout
36
-
37
- - Workspace path: `pkgs/core/tigrbl_kernel`.
38
- - Package class: `core framework package`.
39
- - Python requirement: `>=3.10,<3.15`.
40
- - `tigrbl_kernel` modules: `_build, _compile, atoms, cache, callbacks, core, eventkey, eventkey_hooks, events, helpers`.
41
-
42
- ## Dependency Surface
43
-
44
- - Workspace package dependencies: [`tigrbl-typing`](https://pypi.org/project/tigrbl-typing/), [`tigrbl-atoms`](https://pypi.org/project/tigrbl-atoms/), [`tigrbl-core`](https://pypi.org/project/tigrbl-core/).
45
- - External runtime dependencies: none declared.
46
- - Optional extras: none declared.
47
-
48
- ## Related Packages
49
-
50
- - [`tigrbl`](https://pypi.org/project/tigrbl/)
51
- - [`tigrbl-typing`](https://pypi.org/project/tigrbl-typing/)
52
- - [`tigrbl-atoms`](https://pypi.org/project/tigrbl-atoms/)
53
- - [`tigrbl-core`](https://pypi.org/project/tigrbl-core/)
54
-
55
- ## Canonical Repository Docs
56
-
57
- - `docs/README.md`
58
- - `docs/conformance/CURRENT_TARGET.md`
59
- - `docs/conformance/CURRENT_STATE.md`
60
- - `docs/conformance/NEXT_STEPS.md`
61
- - `docs/governance/DOC_POINTERS.md`
62
- - `docs/developer/PACKAGE_CATALOG.md`
63
- - `docs/developer/PACKAGE_LAYOUT.md`
64
-
65
- ## Package-local Boundary
66
-
67
- This file is a package-local distribution entry point.
68
- Use this page for package installation and boundary orientation. Repository governance, conformance state, target status, and release evidence remain governed from `docs/` and `.ssot/`.
69
-
70
- ## License
71
-
72
- Licensed under the Apache License, Version 2.0. See `LICENSE` and the official [Apache 2.0 license text](https://www.apache.org/licenses/LICENSE-2.0).