Setting up project structure and initial files - #10
Merged
Conversation
Copilot created this pull request from a session on behalf of
Pmaster-dev
August 2, 2026 11:18
View session
Contributor
There was a problem hiding this comment.
Pull request overview
This PR introduces an initial “kernel” package with stub engine implementations, along with accompanying documentation and OpenAPI schema scaffolding to establish the project’s baseline structure.
Changes:
- Added
src/kernel/with a sharedKernelEnginebase class and six stub engines (Registry, Event Store, Workflow, Decision, Document, Outcome) exposed viakernel’s public API. - Added a new OpenAPI document
docs/openapi/kernel.yamlto publish shared kernel schemas. - Updated ecosystem documentation (renamed inventory doc) and adjusted README references; added smoke tests for kernel engines.
Reviewed changes
Copilot reviewed 15 out of 19 changed files in this pull request and generated 6 comments.
Show a summary per file
| File | Description |
|---|---|
tests/test_kernel.py |
Adds smoke tests validating importability and minimal result-shape expectations for each kernel engine. |
src/kernel/_base.py |
Introduces the abstract KernelEngine interface and the name resolution helper. |
src/kernel/__init__.py |
Defines the kernel package public API (__all__) and quick-start module docstring. |
src/kernel/registry.py |
Adds stub RegistryEngine with documented context/result contract. |
src/kernel/events.py |
Adds stub EventStoreEngine with documented context/result contract. |
src/kernel/workflows.py |
Adds stub WorkflowEngine and documents workflow advancement contract. |
src/kernel/decisions.py |
Adds stub DecisionEngine with documented context/result contract. |
src/kernel/documents.py |
Adds stub DocumentEngine with documented context/result contract. |
src/kernel/outcomes.py |
Adds stub OutcomeEngine with documented context/result contract. |
docs/openapi/kernel.yaml |
Publishes initial kernel schemas intended as shared contracts for downstream services. |
docs/ecosystem-inventory.md |
Adds the new ecosystem inventory document replacing the prior pinkycollie-focused version. |
docs/pinkycollie-ecosystem-inventory.md |
Removes the old ecosystem inventory document. |
docs/architecture/kernel.md |
Adds kernel data-model documentation describing kernel objects/tables and accessibility profile concepts. |
docs/architecture/engines.md |
Adds narrative documentation for the six kernel engine capabilities and their responsibilities. |
README.md |
Updates repository description and points ecosystem reference to the renamed inventory doc. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
| 4. ``process`` returns a dict when called with a minimal valid context. | ||
| """ | ||
|
|
||
| import pytest |
| @@ -0,0 +1,191 @@ | |||
| """ | |||
| Smoke tests for src/kernel — one test per engine module. | |||
Comment on lines
+93
to
+97
| def test_workflow_engine_process_returns_dict(): | ||
| result = WorkflowEngine().process({"workflow_name": "intake"}) | ||
| assert isinstance(result, dict) | ||
| assert "next_steps" in result | ||
| assert "updated_state" in result |
Comment on lines
+19
to
+22
| Returned keys | ||
| ------------- | ||
| workflow_id : str | ||
| ID of the (new or existing) workflow instance. |
Comment on lines
+9
to
+13
| tags: | ||
| - name: Kernel | ||
| components: | ||
| schemas: | ||
|
|
| ## Ecosystem | ||
|
|
||
| See [`docs/pinkycollie-ecosystem-inventory.md`](docs/pinkycollie-ecosystem-inventory.md) for the full cross-org architecture map. | ||
| See [`docs/ecosystem-inventory.md`](docs/ecosystem-inventory.md) for the full cross-org architecture map. |
Owner
|
@copilot Fix the code for all comments in this review thread. When a review comment includes a suggested change, apply the suggestion exactly. Do not make changes beyond what is described in the linked review thread. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Pull request created by AI Agent