From 05d0a0247df0f0b297acbf699defa03411c89c7a Mon Sep 17 00:00:00 2001 From: "google-labs-jules[bot]" <161369871+google-labs-jules[bot]@users.noreply.github.com> Date: Wed, 23 Sep 2026 05:54:36 +0000 Subject: [PATCH 1/3] feat: add runtime entrypoint, release workflow, and smoke-check docs - Add rege/__main__.py runtime entrypoint for python -m rege - Create .github/workflows/release.yml for automated build and release publishing - Clean up pyproject.toml PEP 639 license configuration - Update README.md and seed.yaml with smoke check instructions and metadata - Add unit tests for rege module entrypoint Co-authored-by: 4444J99 <24796448+4444J99@users.noreply.github.com> --- .github/workflows/release.yml | 56 +++++++++++++++++++ .../checkpoints/CHECKPOINT_REGISTRY.json | 16 +++++- .../snapshots/SNAP_20260923_054903.json | 55 ++++++++++++++++++ .../snapshots/SNAP_20260923_055217.json | 55 ++++++++++++++++++ README.md | 33 ++++++++++- pyproject.toml | 3 +- rege/__main__.py | 11 ++++ rege/tests/test_cli.py | 11 ++++ seed.yaml | 10 +++- 9 files changed, 243 insertions(+), 7 deletions(-) create mode 100644 .github/workflows/release.yml create mode 100644 .rege_archive/checkpoints/snapshots/SNAP_20260923_054903.json create mode 100644 .rege_archive/checkpoints/snapshots/SNAP_20260923_055217.json create mode 100644 rege/__main__.py diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml new file mode 100644 index 0000000..404bc6a --- /dev/null +++ b/.github/workflows/release.yml @@ -0,0 +1,56 @@ +name: Release Artifacts + +on: + push: + tags: + - "v*.*.*" + release: + types: [published] + workflow_dispatch: + +permissions: + contents: write + +jobs: + build-and-release: + runs-on: ubuntu-latest + steps: + - name: Checkout code + uses: actions/checkout@v4 + + - name: Set up Python + uses: actions/setup-python@v5 + with: + python-version: "3.11" + + - name: Install build and test dependencies + run: | + python -m pip install --upgrade pip + pip install build wheel pytest pytest-cov click + + - name: Install package + run: | + pip install -e .[dev] + + - name: Run tests + run: | + pytest + + - name: Build package artifacts (sdist and wheel) + run: | + python -m build + + - name: Verify build artifacts + run: | + ls -la dist/ + pip install dist/*.whl --force-reinstall + python -m rege --version + python -m rege status + + - name: Publish Release Assets + if: startsWith(github.ref, 'refs/tags/') || github.event_name == 'release' + uses: softprops/action-gh-release@v2 + with: + files: dist/* + env: + GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} diff --git a/.rege_archive/checkpoints/CHECKPOINT_REGISTRY.json b/.rege_archive/checkpoints/CHECKPOINT_REGISTRY.json index 7ed3070..7397e2d 100644 --- a/.rege_archive/checkpoints/CHECKPOINT_REGISTRY.json +++ b/.rege_archive/checkpoints/CHECKPOINT_REGISTRY.json @@ -17,8 +17,20 @@ "name": "test_cp", "timestamp": "2026-07-06T17:32:18.458591", "trigger": "manual" + }, + { + "snapshot_id": "SNAP_20260923_054903", + "name": "test_cp", + "timestamp": "2026-09-23T05:49:03.530957", + "trigger": "manual" + }, + { + "snapshot_id": "SNAP_20260923_055217", + "name": "test_cp", + "timestamp": "2026-09-23T05:52:17.410865", + "trigger": "manual" } ], - "saved_at": "2026-07-06T17:32:18.458858", - "count": 3 + "saved_at": "2026-09-23T05:52:17.411414", + "count": 5 } \ No newline at end of file diff --git a/.rege_archive/checkpoints/snapshots/SNAP_20260923_054903.json b/.rege_archive/checkpoints/snapshots/SNAP_20260923_054903.json new file mode 100644 index 0000000..d8f02e3 --- /dev/null +++ b/.rege_archive/checkpoints/snapshots/SNAP_20260923_054903.json @@ -0,0 +1,55 @@ +{ + "snapshot_id": "SNAP_20260923_054903", + "timestamp": "2026-09-23T05:49:03.530957", + "trigger": "manual", + "system_state": { + "total_size": 3, + "max_size": 1000, + "by_priority": { + "CRITICAL": 0, + "HIGH": 0, + "STANDARD": 0, + "BACKGROUND": 3 + }, + "priority_distribution": { + "CRITICAL": 0, + "HIGH": 0, + "STANDARD": 0, + "BACKGROUND": 3 + }, + "collision_count": 4, + "deadlock_count": 0, + "total_enqueued": 8, + "total_processed": 0, + "active_routes": 0, + "maintenance_mode": false, + "checkpoint_name": "test_cp" + }, + "organ_states": { + "HEART_OF_CANON": "active", + "MIRROR_CABINET": "active", + "MYTHIC_SENATE": "active", + "ARCHIVE_ORDER": "active", + "RITUAL_COURT": "active", + "CODE_FORGE": "active", + "BLOOM_ENGINE": "active", + "ECHO_SHELL": "active", + "DREAM_COUNCIL": "active", + "MASK_ENGINE": "active", + "CHAMBER_OF_COMMERCE": "active", + "BLOCKCHAIN_ECONOMY": "active", + "PLACE_PROTOCOLS": "active", + "TIME_RULES": "active", + "PROCESS_PRODUCT": "active", + "PUBLISHING_TEMPLE": "active", + "PROCESS_MONETIZER": "active", + "AUDIENCE_ENGINE": "active", + "ANALOG_DIGITAL_ENGINE": "active", + "CONSUMPTION_PROTOCOL": "active", + "STAGECRAFT_MODULE": "active", + "INTERLOCUTOR": "active" + }, + "pending_operations": [], + "error_log": [], + "recovery_point": null +} \ No newline at end of file diff --git a/.rege_archive/checkpoints/snapshots/SNAP_20260923_055217.json b/.rege_archive/checkpoints/snapshots/SNAP_20260923_055217.json new file mode 100644 index 0000000..8774378 --- /dev/null +++ b/.rege_archive/checkpoints/snapshots/SNAP_20260923_055217.json @@ -0,0 +1,55 @@ +{ + "snapshot_id": "SNAP_20260923_055217", + "timestamp": "2026-09-23T05:52:17.410865", + "trigger": "manual", + "system_state": { + "total_size": 3, + "max_size": 1000, + "by_priority": { + "CRITICAL": 0, + "HIGH": 0, + "STANDARD": 0, + "BACKGROUND": 3 + }, + "priority_distribution": { + "CRITICAL": 0, + "HIGH": 0, + "STANDARD": 0, + "BACKGROUND": 3 + }, + "collision_count": 4, + "deadlock_count": 0, + "total_enqueued": 8, + "total_processed": 0, + "active_routes": 0, + "maintenance_mode": false, + "checkpoint_name": "test_cp" + }, + "organ_states": { + "HEART_OF_CANON": "active", + "MIRROR_CABINET": "active", + "MYTHIC_SENATE": "active", + "ARCHIVE_ORDER": "active", + "RITUAL_COURT": "active", + "CODE_FORGE": "active", + "BLOOM_ENGINE": "active", + "ECHO_SHELL": "active", + "DREAM_COUNCIL": "active", + "MASK_ENGINE": "active", + "CHAMBER_OF_COMMERCE": "active", + "BLOCKCHAIN_ECONOMY": "active", + "PLACE_PROTOCOLS": "active", + "TIME_RULES": "active", + "PROCESS_PRODUCT": "active", + "PUBLISHING_TEMPLE": "active", + "PROCESS_MONETIZER": "active", + "AUDIENCE_ENGINE": "active", + "ANALOG_DIGITAL_ENGINE": "active", + "CONSUMPTION_PROTOCOL": "active", + "STAGECRAFT_MODULE": "active", + "INTERLOCUTOR": "active" + }, + "pending_operations": [], + "error_log": [], + "recovery_point": null +} \ No newline at end of file diff --git a/README.md b/README.md index 6546640..04800d4 100644 --- a/README.md +++ b/README.md @@ -166,8 +166,39 @@ pip install -e . # Install development dependencies (pytest, coverage) pip install -e ".[dev]" -# Verify installation +# Verify installation using CLI or direct python module entrypoint rege status +# OR +python -m rege status +``` + +### Smoke Check Verification + +To run a immediate smoke-check verification of the runtime system and dispatch pipeline: + +```bash +# 1. System Status Verification +python -m rege status + +# Expected Output: +# ::RE:GE SYSTEM STATUS:: +# [QUEUE] +# Size: 0/1000 +# [ORGANS] +# Registered: 22 + +# 2. Ritual Invocation Verification +python -m rege invoke '::CALL_ORGAN HEART_OF_CANON +::WITH "threshold crossing" +::MODE mythic +::DEPTH standard +::CHARGE 75' + +# Expected Output: +# ::INVOCATION RESULT:: +# Organ: HEART_OF_CANON +# Status: success +# Output Type: narrative ``` ### Runtime Dependencies diff --git a/pyproject.toml b/pyproject.toml index d2a008c..f25b75c 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -7,7 +7,7 @@ name = "rege" version = "1.0.0" description = "RE:GE - Recursive Engine: Generative Entity - A symbolic operating system for myth, identity, ritual, and recursive systems" readme = "README.md" -license = {text = "MIT"} +license = "MIT" authors = [ {name = "RE:GE System"} ] @@ -15,7 +15,6 @@ requires-python = ">=3.8" classifiers = [ "Development Status :: 4 - Beta", "Intended Audience :: Developers", - "License :: OSI Approved :: MIT License", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.8", "Programming Language :: Python :: 3.9", diff --git a/rege/__main__.py b/rege/__main__.py new file mode 100644 index 0000000..5261889 --- /dev/null +++ b/rege/__main__.py @@ -0,0 +1,11 @@ +""" +RE:GE Main Entrypoint. + +Allows running the CLI as a python module: +python -m rege [command] +""" + +from rege.cli import main + +if __name__ == "__main__": + main() diff --git a/rege/tests/test_cli.py b/rege/tests/test_cli.py index 604c6c9..3d8c2d1 100644 --- a/rege/tests/test_cli.py +++ b/rege/tests/test_cli.py @@ -337,6 +337,17 @@ def test_help_option(self, runner): assert "status" in result.output +class TestMainModuleEntrypoint: + """Tests for python -m rege main entrypoint.""" + + def test_main_import_and_execution(self): + """Test rege.__main__ module import and main execution.""" + import runpy + with patch('rege.cli.main') as mock_main: + runpy.run_module('rege', run_name='__main__') + assert mock_main.called + + class TestInitSystem: """Tests for init_system function.""" diff --git a/seed.yaml b/seed.yaml index df62854..2c3ecf8 100644 --- a/seed.yaml +++ b/seed.yaml @@ -12,16 +12,22 @@ metadata: implementation_status: ACTIVE tier: flagship promotion_status: PUBLIC_PROCESS - last_validated: "2026-02-11" + last_validated: "2026-04-14" generated: "2026-02-17" sprint: "SENSORIA" language: python + entrypoint: "rege.cli:main" + module_entrypoint: "python -m rege" agents: - name: ci trigger: on_push - workflow: .github/workflows/ci-python.yml + workflow: .github/workflows/ci.yml description: "Continuous integration pipeline" + - name: release + trigger: on_tag + workflow: .github/workflows/release.yml + description: "Builds and publishes versioned release artifacts (sdist and wheel)" produces: - type: theory From 58e9f5d27a368d9a7d259fdb5a503069f7c0c827 Mon Sep 17 00:00:00 2001 From: "google-labs-jules[bot]" <161369871+google-labs-jules[bot]@users.noreply.github.com> Date: Wed, 23 Sep 2026 06:13:06 +0000 Subject: [PATCH 2/3] feat: add runtime entrypoint, release workflow, and smoke-check docs - Add rege/__main__.py runtime entrypoint for python -m rege - Create .github/workflows/release.yml for automated build and release publishing - Clean up pyproject.toml PEP 639 license configuration - Update README.md and seed.yaml with smoke check instructions and metadata - Add unit tests for rege module entrypoint Co-authored-by: 4444J99 <24796448+4444J99@users.noreply.github.com> --- .../checkpoints/CHECKPOINT_REGISTRY.json | 14 ++--- .../snapshots/SNAP_20260923_055217.json | 55 ------------------- ..._054903.json => SNAP_20260923_061219.json} | 4 +- 3 files changed, 6 insertions(+), 67 deletions(-) delete mode 100644 .rege_archive/checkpoints/snapshots/SNAP_20260923_055217.json rename .rege_archive/checkpoints/snapshots/{SNAP_20260923_054903.json => SNAP_20260923_061219.json} (93%) diff --git a/.rege_archive/checkpoints/CHECKPOINT_REGISTRY.json b/.rege_archive/checkpoints/CHECKPOINT_REGISTRY.json index 7397e2d..dd02e4a 100644 --- a/.rege_archive/checkpoints/CHECKPOINT_REGISTRY.json +++ b/.rege_archive/checkpoints/CHECKPOINT_REGISTRY.json @@ -19,18 +19,12 @@ "trigger": "manual" }, { - "snapshot_id": "SNAP_20260923_054903", + "snapshot_id": "SNAP_20260923_061219", "name": "test_cp", - "timestamp": "2026-09-23T05:49:03.530957", - "trigger": "manual" - }, - { - "snapshot_id": "SNAP_20260923_055217", - "name": "test_cp", - "timestamp": "2026-09-23T05:52:17.410865", + "timestamp": "2026-09-23T06:12:19.695230", "trigger": "manual" } ], - "saved_at": "2026-09-23T05:52:17.411414", - "count": 5 + "saved_at": "2026-09-23T06:12:19.695898", + "count": 4 } \ No newline at end of file diff --git a/.rege_archive/checkpoints/snapshots/SNAP_20260923_055217.json b/.rege_archive/checkpoints/snapshots/SNAP_20260923_055217.json deleted file mode 100644 index 8774378..0000000 --- a/.rege_archive/checkpoints/snapshots/SNAP_20260923_055217.json +++ /dev/null @@ -1,55 +0,0 @@ -{ - "snapshot_id": "SNAP_20260923_055217", - "timestamp": "2026-09-23T05:52:17.410865", - "trigger": "manual", - "system_state": { - "total_size": 3, - "max_size": 1000, - "by_priority": { - "CRITICAL": 0, - "HIGH": 0, - "STANDARD": 0, - "BACKGROUND": 3 - }, - "priority_distribution": { - "CRITICAL": 0, - "HIGH": 0, - "STANDARD": 0, - "BACKGROUND": 3 - }, - "collision_count": 4, - "deadlock_count": 0, - "total_enqueued": 8, - "total_processed": 0, - "active_routes": 0, - "maintenance_mode": false, - "checkpoint_name": "test_cp" - }, - "organ_states": { - "HEART_OF_CANON": "active", - "MIRROR_CABINET": "active", - "MYTHIC_SENATE": "active", - "ARCHIVE_ORDER": "active", - "RITUAL_COURT": "active", - "CODE_FORGE": "active", - "BLOOM_ENGINE": "active", - "ECHO_SHELL": "active", - "DREAM_COUNCIL": "active", - "MASK_ENGINE": "active", - "CHAMBER_OF_COMMERCE": "active", - "BLOCKCHAIN_ECONOMY": "active", - "PLACE_PROTOCOLS": "active", - "TIME_RULES": "active", - "PROCESS_PRODUCT": "active", - "PUBLISHING_TEMPLE": "active", - "PROCESS_MONETIZER": "active", - "AUDIENCE_ENGINE": "active", - "ANALOG_DIGITAL_ENGINE": "active", - "CONSUMPTION_PROTOCOL": "active", - "STAGECRAFT_MODULE": "active", - "INTERLOCUTOR": "active" - }, - "pending_operations": [], - "error_log": [], - "recovery_point": null -} \ No newline at end of file diff --git a/.rege_archive/checkpoints/snapshots/SNAP_20260923_054903.json b/.rege_archive/checkpoints/snapshots/SNAP_20260923_061219.json similarity index 93% rename from .rege_archive/checkpoints/snapshots/SNAP_20260923_054903.json rename to .rege_archive/checkpoints/snapshots/SNAP_20260923_061219.json index d8f02e3..a4710e7 100644 --- a/.rege_archive/checkpoints/snapshots/SNAP_20260923_054903.json +++ b/.rege_archive/checkpoints/snapshots/SNAP_20260923_061219.json @@ -1,6 +1,6 @@ { - "snapshot_id": "SNAP_20260923_054903", - "timestamp": "2026-09-23T05:49:03.530957", + "snapshot_id": "SNAP_20260923_061219", + "timestamp": "2026-09-23T06:12:19.695230", "trigger": "manual", "system_state": { "total_size": 3, From fd0b08b4c739ae81a932069e91ad5d7242ff7a68 Mon Sep 17 00:00:00 2001 From: "google-labs-jules[bot]" <161369871+google-labs-jules[bot]@users.noreply.github.com> Date: Wed, 23 Sep 2026 06:19:33 +0000 Subject: [PATCH 3/3] feat: add runtime entrypoint, release workflow, and smoke-check docs - Add rege/__main__.py runtime entrypoint for python -m rege - Create .github/workflows/release.yml for automated build and release publishing - Clean up pyproject.toml PEP 639 license configuration - Update README.md and seed.yaml with smoke check instructions and metadata - Add unit tests for rege module entrypoint Co-authored-by: 4444J99 <24796448+4444J99@users.noreply.github.com> --- .../checkpoints/CHECKPOINT_REGISTRY.json | 10 +--- .../snapshots/SNAP_20260923_061219.json | 55 ------------------- 2 files changed, 2 insertions(+), 63 deletions(-) delete mode 100644 .rege_archive/checkpoints/snapshots/SNAP_20260923_061219.json diff --git a/.rege_archive/checkpoints/CHECKPOINT_REGISTRY.json b/.rege_archive/checkpoints/CHECKPOINT_REGISTRY.json index dd02e4a..7ed3070 100644 --- a/.rege_archive/checkpoints/CHECKPOINT_REGISTRY.json +++ b/.rege_archive/checkpoints/CHECKPOINT_REGISTRY.json @@ -17,14 +17,8 @@ "name": "test_cp", "timestamp": "2026-07-06T17:32:18.458591", "trigger": "manual" - }, - { - "snapshot_id": "SNAP_20260923_061219", - "name": "test_cp", - "timestamp": "2026-09-23T06:12:19.695230", - "trigger": "manual" } ], - "saved_at": "2026-09-23T06:12:19.695898", - "count": 4 + "saved_at": "2026-07-06T17:32:18.458858", + "count": 3 } \ No newline at end of file diff --git a/.rege_archive/checkpoints/snapshots/SNAP_20260923_061219.json b/.rege_archive/checkpoints/snapshots/SNAP_20260923_061219.json deleted file mode 100644 index a4710e7..0000000 --- a/.rege_archive/checkpoints/snapshots/SNAP_20260923_061219.json +++ /dev/null @@ -1,55 +0,0 @@ -{ - "snapshot_id": "SNAP_20260923_061219", - "timestamp": "2026-09-23T06:12:19.695230", - "trigger": "manual", - "system_state": { - "total_size": 3, - "max_size": 1000, - "by_priority": { - "CRITICAL": 0, - "HIGH": 0, - "STANDARD": 0, - "BACKGROUND": 3 - }, - "priority_distribution": { - "CRITICAL": 0, - "HIGH": 0, - "STANDARD": 0, - "BACKGROUND": 3 - }, - "collision_count": 4, - "deadlock_count": 0, - "total_enqueued": 8, - "total_processed": 0, - "active_routes": 0, - "maintenance_mode": false, - "checkpoint_name": "test_cp" - }, - "organ_states": { - "HEART_OF_CANON": "active", - "MIRROR_CABINET": "active", - "MYTHIC_SENATE": "active", - "ARCHIVE_ORDER": "active", - "RITUAL_COURT": "active", - "CODE_FORGE": "active", - "BLOOM_ENGINE": "active", - "ECHO_SHELL": "active", - "DREAM_COUNCIL": "active", - "MASK_ENGINE": "active", - "CHAMBER_OF_COMMERCE": "active", - "BLOCKCHAIN_ECONOMY": "active", - "PLACE_PROTOCOLS": "active", - "TIME_RULES": "active", - "PROCESS_PRODUCT": "active", - "PUBLISHING_TEMPLE": "active", - "PROCESS_MONETIZER": "active", - "AUDIENCE_ENGINE": "active", - "ANALOG_DIGITAL_ENGINE": "active", - "CONSUMPTION_PROTOCOL": "active", - "STAGECRAFT_MODULE": "active", - "INTERLOCUTOR": "active" - }, - "pending_operations": [], - "error_log": [], - "recovery_point": null -} \ No newline at end of file