aassrv2-core 1.0.1__tar.gz

aassrv2_core-1.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 aether0xff-afk
+
+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.

aassrv2_core-1.0.1/PKG-INFO

@@ -0,0 +1,117 @@
+Metadata-Version: 2.4
+Name: aassrv2-core
+Version: 1.0.1
+Summary: Environment-independent cognitive core for AASSRv2
+Author: aether0xff-afk
+License-Expression: MIT
+Project-URL: Repository, https://github.com/aether0xff-afk/AASSRv2
+Classifier: Development Status :: 4 - Beta
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: gui
+Requires-Dist: PyQt6<7,>=6.7; extra == "gui"
+Dynamic: license-file
+
+# AASSRv2 Core
+
+> **Current core release:** `v1.0.1`
+
+AASSRv2 Core는 환경 구현, 플러그인 구현, 학습 실험과 자산을 포함하지 않는 순수
+Python 인지 코어 패키지다. 상태와 행동, 지식 저장, 예측·상상, 정책, 궤적 평가,
+환경 독립 실행 계약과 선택 설치형 PyQt Core Workbench를 제공한다.
+
+## Release scope
+
+이 브랜치가 배포하는 범위는 다음뿐이다.
+
+- `core/`: AASSRv2 Core 런타임과 환경 독립 계약
+- `aassrv2_gui/`: 플러그인을 포함하지 않는 PyQt Core Workbench
+- `tests/`: Core 단위·계약 테스트
+- `pyproject.toml`: `aassrv2-core` 빌드 메타데이터
+- `LICENSE`, `VERSION`: 라이선스와 릴리즈 버전
+
+GridWorld를 포함한 구체 환경, 플러그인, training pipeline, 연구 runner, notebook,
+checkpoint와 실행 결과는 이 릴리즈에 포함하지 않는다.
+
+## Install
+
+Python 3.10 이상이 필요하다. 런타임 외부 의존성은 없다.
+
+```bash
+python -m pip install .
+```
+
+설치 후:
+
+```python
+from core import Action, AASSRCore, Plugin, State
+
+
+class CounterSession(Plugin):
+    def __init__(self) -> None:
+        self.value = 0
+        self.increment = Action("increment")
+
+    def observe(self) -> State:
+        return State({"value": self.value})
+
+    def available_actions(self) -> list[Action]:
+        return [self.increment]
+
+    def execute(self, action: Action) -> None:
+        if action != self.increment:
+            raise ValueError(action.key)
+        self.value += 1
+
+
+core = AASSRCore(CounterSession())
+transition = core.act(core.available_actions()[0])
+```
+
+## PyQt Core Workbench
+
+GUI를 함께 설치한다.
+
+```bash
+python -m pip install ".[gui]"
+```
+
+다음 중 하나로 실행한다.
+
+```bash
+aassrv2-gui
+python -m aassrv2_gui
+```
+
+Workbench는 특정 환경이나 플러그인을 내장하지 않는다. 사용자가 현재 상태와 다음
+상태를 JSON 객체로 입력하고 행동을 선택하면 실제 `AASSRCore.act()`를 실행해 다음을
+확인할 수 있다.
+
+- 현재 semantic state와 사용 가능한 action
+- 실행된 `(State, Action, Next State)` ASEQ
+- transition history와 memory revision
+- Core가 허용하는 flat scalar JSON 상태 계약
+
+## Verify and build
+
+```bash
+python -m pip install -r requirements-dev.txt
+python -m pytest -q
+python -m build
+python -m twine check dist/*
+```
+
+빌드 결과의 wheel과 source distribution에는 `core`와 환경 독립
+`aassrv2_gui` 패키지만 포함된다. PyQt6는 `gui` extra를 선택했을 때만 설치되므로
+Core 자체의 런타임 의존성은 계속 0개다.
+
+## License
+
+MIT. 자세한 내용은 `LICENSE`를 참고한다.

aassrv2_core-1.0.1/README.md

@@ -0,0 +1,96 @@
+# AASSRv2 Core
+
+> **Current core release:** `v1.0.1`
+
+AASSRv2 Core는 환경 구현, 플러그인 구현, 학습 실험과 자산을 포함하지 않는 순수
+Python 인지 코어 패키지다. 상태와 행동, 지식 저장, 예측·상상, 정책, 궤적 평가,
+환경 독립 실행 계약과 선택 설치형 PyQt Core Workbench를 제공한다.
+
+## Release scope
+
+이 브랜치가 배포하는 범위는 다음뿐이다.
+
+- `core/`: AASSRv2 Core 런타임과 환경 독립 계약
+- `aassrv2_gui/`: 플러그인을 포함하지 않는 PyQt Core Workbench
+- `tests/`: Core 단위·계약 테스트
+- `pyproject.toml`: `aassrv2-core` 빌드 메타데이터
+- `LICENSE`, `VERSION`: 라이선스와 릴리즈 버전
+
+GridWorld를 포함한 구체 환경, 플러그인, training pipeline, 연구 runner, notebook,
+checkpoint와 실행 결과는 이 릴리즈에 포함하지 않는다.
+
+## Install
+
+Python 3.10 이상이 필요하다. 런타임 외부 의존성은 없다.
+
+```bash
+python -m pip install .
+```
+
+설치 후:
+
+```python
+from core import Action, AASSRCore, Plugin, State
+
+
+class CounterSession(Plugin):
+    def __init__(self) -> None:
+        self.value = 0
+        self.increment = Action("increment")
+
+    def observe(self) -> State:
+        return State({"value": self.value})
+
+    def available_actions(self) -> list[Action]:
+        return [self.increment]
+
+    def execute(self, action: Action) -> None:
+        if action != self.increment:
+            raise ValueError(action.key)
+        self.value += 1
+
+
+core = AASSRCore(CounterSession())
+transition = core.act(core.available_actions()[0])
+```
+
+## PyQt Core Workbench
+
+GUI를 함께 설치한다.
+
+```bash
+python -m pip install ".[gui]"
+```
+
+다음 중 하나로 실행한다.
+
+```bash
+aassrv2-gui
+python -m aassrv2_gui
+```
+
+Workbench는 특정 환경이나 플러그인을 내장하지 않는다. 사용자가 현재 상태와 다음
+상태를 JSON 객체로 입력하고 행동을 선택하면 실제 `AASSRCore.act()`를 실행해 다음을
+확인할 수 있다.
+
+- 현재 semantic state와 사용 가능한 action
+- 실행된 `(State, Action, Next State)` ASEQ
+- transition history와 memory revision
+- Core가 허용하는 flat scalar JSON 상태 계약
+
+## Verify and build
+
+```bash
+python -m pip install -r requirements-dev.txt
+python -m pytest -q
+python -m build
+python -m twine check dist/*
+```
+
+빌드 결과의 wheel과 source distribution에는 `core`와 환경 독립
+`aassrv2_gui` 패키지만 포함된다. PyQt6는 `gui` extra를 선택했을 때만 설치되므로
+Core 자체의 런타임 의존성은 계속 0개다.
+
+## License
+
+MIT. 자세한 내용은 `LICENSE`를 참고한다.

aassrv2_core-1.0.1/aassrv2_core.egg-info/PKG-INFO

@@ -0,0 +1,117 @@
+Metadata-Version: 2.4
+Name: aassrv2-core
+Version: 1.0.1
+Summary: Environment-independent cognitive core for AASSRv2
+Author: aether0xff-afk
+License-Expression: MIT
+Project-URL: Repository, https://github.com/aether0xff-afk/AASSRv2
+Classifier: Development Status :: 4 - Beta
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: gui
+Requires-Dist: PyQt6<7,>=6.7; extra == "gui"
+Dynamic: license-file
+
+# AASSRv2 Core
+
+> **Current core release:** `v1.0.1`
+
+AASSRv2 Core는 환경 구현, 플러그인 구현, 학습 실험과 자산을 포함하지 않는 순수
+Python 인지 코어 패키지다. 상태와 행동, 지식 저장, 예측·상상, 정책, 궤적 평가,
+환경 독립 실행 계약과 선택 설치형 PyQt Core Workbench를 제공한다.
+
+## Release scope
+
+이 브랜치가 배포하는 범위는 다음뿐이다.
+
+- `core/`: AASSRv2 Core 런타임과 환경 독립 계약
+- `aassrv2_gui/`: 플러그인을 포함하지 않는 PyQt Core Workbench
+- `tests/`: Core 단위·계약 테스트
+- `pyproject.toml`: `aassrv2-core` 빌드 메타데이터
+- `LICENSE`, `VERSION`: 라이선스와 릴리즈 버전
+
+GridWorld를 포함한 구체 환경, 플러그인, training pipeline, 연구 runner, notebook,
+checkpoint와 실행 결과는 이 릴리즈에 포함하지 않는다.
+
+## Install
+
+Python 3.10 이상이 필요하다. 런타임 외부 의존성은 없다.
+
+```bash
+python -m pip install .
+```
+
+설치 후:
+
+```python
+from core import Action, AASSRCore, Plugin, State
+
+
+class CounterSession(Plugin):
+    def __init__(self) -> None:
+        self.value = 0
+        self.increment = Action("increment")
+
+    def observe(self) -> State:
+        return State({"value": self.value})
+
+    def available_actions(self) -> list[Action]:
+        return [self.increment]
+
+    def execute(self, action: Action) -> None:
+        if action != self.increment:
+            raise ValueError(action.key)
+        self.value += 1
+
+
+core = AASSRCore(CounterSession())
+transition = core.act(core.available_actions()[0])
+```
+
+## PyQt Core Workbench
+
+GUI를 함께 설치한다.
+
+```bash
+python -m pip install ".[gui]"
+```
+
+다음 중 하나로 실행한다.
+
+```bash
+aassrv2-gui
+python -m aassrv2_gui
+```
+
+Workbench는 특정 환경이나 플러그인을 내장하지 않는다. 사용자가 현재 상태와 다음
+상태를 JSON 객체로 입력하고 행동을 선택하면 실제 `AASSRCore.act()`를 실행해 다음을
+확인할 수 있다.
+
+- 현재 semantic state와 사용 가능한 action
+- 실행된 `(State, Action, Next State)` ASEQ
+- transition history와 memory revision
+- Core가 허용하는 flat scalar JSON 상태 계약
+
+## Verify and build
+
+```bash
+python -m pip install -r requirements-dev.txt
+python -m pytest -q
+python -m build
+python -m twine check dist/*
+```
+
+빌드 결과의 wheel과 source distribution에는 `core`와 환경 독립
+`aassrv2_gui` 패키지만 포함된다. PyQt6는 `gui` extra를 선택했을 때만 설치되므로
+Core 자체의 런타임 의존성은 계속 0개다.
+
+## License
+
+MIT. 자세한 내용은 `LICENSE`를 참고한다.

aassrv2_core-1.0.1/aassrv2_core.egg-info/SOURCES.txt

@@ -0,0 +1,34 @@
+LICENSE
+README.md
+pyproject.toml
+aassrv2_core.egg-info/PKG-INFO
+aassrv2_core.egg-info/SOURCES.txt
+aassrv2_core.egg-info/dependency_links.txt
+aassrv2_core.egg-info/entry_points.txt
+aassrv2_core.egg-info/requires.txt
+aassrv2_core.egg-info/top_level.txt
+aassrv2_gui/__init__.py
+aassrv2_gui/__main__.py
+aassrv2_gui/app.py
+aassrv2_gui/launcher.py
+aassrv2_gui/model.py
+aassrv2_gui/window.py
+core/__init__.py
+core/actions.py
+core/contracts.py
+core/datas.py
+core/imagination.py
+core/knowledge_storage.py
+core/main.py
+core/policy.py
+core/prophecy.py
+core/py.typed
+core/trajectory_scoring.py
+tests/test_code_style.py
+tests/test_core_contract.py
+tests/test_gui_model.py
+tests/test_gui_window.py
+tests/test_policy.py
+tests/test_release_surface.py
+tests/test_trajectory_scoring.py
+tests/test_version_contract.py

aassrv2_core-1.0.1/aassrv2_core.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

aassrv2_core-1.0.1/aassrv2_core.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+aassrv2-gui = aassrv2_gui.launcher:main

aassrv2_core-1.0.1/aassrv2_core.egg-info/requires.txt

@@ -0,0 +1,3 @@
+
+[gui]
+PyQt6<7,>=6.7

aassrv2_core-1.0.1/aassrv2_core.egg-info/top_level.txt

@@ -0,0 +1,2 @@
+aassrv2_gui
+core

aassrv2_core-1.0.1/aassrv2_gui/__init__.py

@@ -0,0 +1,9 @@
+"""Environment-independent PyQt workbench helpers for AASSRv2 Core."""
+
+from .model import ManualSession, parse_action_keys, parse_state_json
+
+__all__ = [
+    "ManualSession",
+    "parse_action_keys",
+    "parse_state_json",
+]

aassrv2_core-1.0.1/aassrv2_gui/__main__.py

@@ -0,0 +1,4 @@
+from .launcher import main
+
+
+raise SystemExit(main())

aassrv2_core-1.0.1/aassrv2_gui/app.py

@@ -0,0 +1,24 @@
+import sys
+
+from PyQt6.QtWidgets import QApplication
+
+from .window import WorkbenchWindow
+
+
+def create_application(
+    arguments: list[str] | None = None,
+) -> tuple[QApplication, WorkbenchWindow]:
+    application = QApplication.instance()
+    if application is None:
+        application = QApplication(arguments if arguments is not None else sys.argv)
+
+    application.setApplicationName("AASSRv2 Core Workbench")
+    application.setOrganizationName("AASSRv2")
+    window = WorkbenchWindow()
+    return application, window
+
+
+def run(arguments: list[str] | None = None) -> int:
+    application, window = create_application(arguments)
+    window.show()
+    return application.exec()

aassrv2_core-1.0.1/aassrv2_gui/launcher.py

@@ -0,0 +1,11 @@
+def main() -> int:
+    try:
+        from .app import run
+    except ModuleNotFoundError as error:
+        if error.name == "PyQt6" or str(error.name).startswith("PyQt6."):
+            raise SystemExit(
+                'PyQt6가 필요합니다. pip install "aassrv2-core[gui]"로 설치하세요.'
+            ) from error
+        raise
+
+    return run()

aassrv2_core-1.0.1/aassrv2_gui/model.py

@@ -0,0 +1,77 @@
+import json
+import re
+
+from core import Action, Plugin, State
+
+
+def parse_state_json(text: str) -> State:
+    """Parse the flat semantic-state format accepted by AASSRv2 Core."""
+
+    try:
+        data = json.loads(text)
+    except json.JSONDecodeError as error:
+        raise ValueError(f"상태 JSON을 해석할 수 없습니다: {error.msg}") from error
+
+    if not isinstance(data, dict):
+        raise ValueError("상태는 JSON 객체여야 합니다")
+
+    allowed_values = (bool, int, float, str, type(None))
+    facts: dict[str, bool | int | float | str | None] = {}
+
+    for key, value in data.items():
+        if not isinstance(key, str):
+            raise ValueError("상태 키는 문자열이어야 합니다")
+        if not isinstance(value, allowed_values):
+            raise ValueError(
+                f"{key!r} 값은 bool, number, string, null 중 하나여야 합니다"
+            )
+        facts[key] = value
+
+    return State(facts)
+
+
+def parse_action_keys(text: str) -> list[str]:
+    """Parse comma or newline separated action identifiers."""
+
+    keys = [item.strip() for item in re.split(r"[,\n]", text)]
+    keys = [key for key in keys if key]
+
+    if len(keys) == 0:
+        raise ValueError("행동을 하나 이상 입력해야 합니다")
+    if len(set(keys)) != len(keys):
+        raise ValueError("행동 ID는 중복될 수 없습니다")
+
+    return keys
+
+
+class ManualSession(Plugin):
+    """GUI adapter that lets a user drive Core without bundling a domain plugin."""
+
+    def __init__(self, state: State, action_keys: list[str]) -> None:
+        self._state = State(state.as_dict())
+        self._actions = [Action(key) for key in action_keys]
+        self._next_state: State | None = None
+
+    def observe(self) -> State:
+        return State(self._state.as_dict())
+
+    def available_actions(self) -> list[Action]:
+        return list(self._actions)
+
+    def stage_next_state(self, state: State) -> None:
+        self._next_state = State(state.as_dict())
+
+    def action_for_key(self, key: str) -> Action:
+        for action in self._actions:
+            if action.key == key:
+                return action
+        raise ValueError(f"등록되지 않은 행동입니다: {key}")
+
+    def execute(self, action: Action) -> None:
+        if action not in self._actions:
+            raise ValueError(f"등록되지 않은 행동입니다: {action.key}")
+        if self._next_state is None:
+            raise RuntimeError("다음 상태를 먼저 준비해야 합니다")
+
+        self._state = self._next_state
+        self._next_state = None