claude-org-runtime 0.1.1__tar.gz

claude_org_runtime-0.1.1/LICENSE

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

claude_org_runtime-0.1.1/PKG-INFO

@@ -0,0 +1,107 @@
+Metadata-Version: 2.4
+Name: claude-org-runtime
+Version: 0.1.1
+Summary: Python runtime for claude-org-ja: dispatcher, state schema, and reference role prompts.
+Author-email: suisya-systems <iwama.ryo.0731@gmail.com>
+License: MIT
+Project-URL: Repository, https://github.com/suisya-systems/claude-org-runtime
+Project-URL: Issues, https://github.com/suisya-systems/claude-org-runtime/issues
+Classifier: Development Status :: 4 - Beta
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: License :: OSI Approved :: MIT License
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: jsonschema>=4.18
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Dynamic: license-file
+
+# claude-org-runtime
+
+Python runtime extracted from [claude-org-ja](https://github.com/suisya-systems/claude-org-ja)
+for Claude Code orchestrator setups using renga panes. Sibling of
+[core-harness](https://github.com/suisya-systems/core-harness); provides a
+dispatcher runner, state schema, and reference role prompts (secretary /
+dispatcher / curator).
+
+Not an AI agent framework — this is plumbing for human-driven Claude Code
+orchestrator workflows, not an autonomous-agent toolkit.
+
+## Status
+
+**0.1.0**: dispatcher runner + settings generator + reference role
+prompts + state schema + `v1->v2` polymorphic migrate. This is the first
+release that consumers (notably `claude-org-ja`) can `pip install` to
+replace their in-tree `tools/dispatcher_runner.py` /
+`tools/generate_worker_settings.py` / `tools/role_configs_schema.json`.
+
+## Install
+
+```sh
+pip install claude-org-runtime==0.1.0
+```
+
+For local development:
+
+```sh
+git clone https://github.com/suisya-systems/claude-org-runtime
+cd claude-org-runtime
+python -m pip install -e .[dev]
+```
+
+## Quick start
+
+```sh
+# Render a per-role settings.local.json:
+claude-org-runtime settings generate \
+    --role default \
+    --worker-dir /path/to/worker \
+    --claude-org-path /path/to/claude-org \
+    --out /path/to/worker/.claude/settings.local.json
+
+# Compute a Dispatcher delegation action plan:
+claude-org-runtime dispatcher delegate-plan \
+    --task-json .state/dispatcher/inbox/<task_id>.json \
+    --panes-json panes.json \
+    --state-dir .state
+```
+
+See [`docs/cli.md`](docs/cli.md) for the full CLI reference and the
+migration recipe for `claude-org-ja` consumers.
+
+## Reference role prompts
+
+The runtime ships English reference prompts for the three roles used in
+the `claude-org-ja` reference organization (`secretary`, `dispatcher`,
+`curator`):
+
+```python
+from claude_org_runtime.prompts import load, load_meta
+
+prompt = load("dispatcher")          # raw markdown, frontmatter included
+meta = load_meta("dispatcher")       # {'role': 'dispatcher', 'source': ..., 'status': ...}
+```
+
+These are **reference**, not prescriptive. They capture one working
+configuration from `claude-org-ja`, not an "agent framework" opinion.
+Consumers are expected to load them as a starting point and then override
+or rewrite sections from their own project-root `CLAUDE.md` (or skill
+files) to match their organization's conventions, terminology, and slash
+commands.
+
+## Related
+
+- [core-harness](https://github.com/suisya-systems/core-harness) — sibling
+  repo with reusable safety primitives for Claude Code harnesses.
+- [claude-org-ja#129](https://github.com/suisya-systems/claude-org-ja/issues/129)
+  — Phase 4 epic that motivated extracting this runtime.
+- [Issues](https://github.com/suisya-systems/claude-org-runtime/issues) for
+  this repo.
+
+## License
+
+MIT — see [LICENSE](LICENSE).

claude_org_runtime-0.1.1/README.md

@@ -0,0 +1,85 @@
+# claude-org-runtime
+
+Python runtime extracted from [claude-org-ja](https://github.com/suisya-systems/claude-org-ja)
+for Claude Code orchestrator setups using renga panes. Sibling of
+[core-harness](https://github.com/suisya-systems/core-harness); provides a
+dispatcher runner, state schema, and reference role prompts (secretary /
+dispatcher / curator).
+
+Not an AI agent framework — this is plumbing for human-driven Claude Code
+orchestrator workflows, not an autonomous-agent toolkit.
+
+## Status
+
+**0.1.0**: dispatcher runner + settings generator + reference role
+prompts + state schema + `v1->v2` polymorphic migrate. This is the first
+release that consumers (notably `claude-org-ja`) can `pip install` to
+replace their in-tree `tools/dispatcher_runner.py` /
+`tools/generate_worker_settings.py` / `tools/role_configs_schema.json`.
+
+## Install
+
+```sh
+pip install claude-org-runtime==0.1.0
+```
+
+For local development:
+
+```sh
+git clone https://github.com/suisya-systems/claude-org-runtime
+cd claude-org-runtime
+python -m pip install -e .[dev]
+```
+
+## Quick start
+
+```sh
+# Render a per-role settings.local.json:
+claude-org-runtime settings generate \
+    --role default \
+    --worker-dir /path/to/worker \
+    --claude-org-path /path/to/claude-org \
+    --out /path/to/worker/.claude/settings.local.json
+
+# Compute a Dispatcher delegation action plan:
+claude-org-runtime dispatcher delegate-plan \
+    --task-json .state/dispatcher/inbox/<task_id>.json \
+    --panes-json panes.json \
+    --state-dir .state
+```
+
+See [`docs/cli.md`](docs/cli.md) for the full CLI reference and the
+migration recipe for `claude-org-ja` consumers.
+
+## Reference role prompts
+
+The runtime ships English reference prompts for the three roles used in
+the `claude-org-ja` reference organization (`secretary`, `dispatcher`,
+`curator`):
+
+```python
+from claude_org_runtime.prompts import load, load_meta
+
+prompt = load("dispatcher")          # raw markdown, frontmatter included
+meta = load_meta("dispatcher")       # {'role': 'dispatcher', 'source': ..., 'status': ...}
+```
+
+These are **reference**, not prescriptive. They capture one working
+configuration from `claude-org-ja`, not an "agent framework" opinion.
+Consumers are expected to load them as a starting point and then override
+or rewrite sections from their own project-root `CLAUDE.md` (or skill
+files) to match their organization's conventions, terminology, and slash
+commands.
+
+## Related
+
+- [core-harness](https://github.com/suisya-systems/core-harness) — sibling
+  repo with reusable safety primitives for Claude Code harnesses.
+- [claude-org-ja#129](https://github.com/suisya-systems/claude-org-ja/issues/129)
+  — Phase 4 epic that motivated extracting this runtime.
+- [Issues](https://github.com/suisya-systems/claude-org-runtime/issues) for
+  this repo.
+
+## License
+
+MIT — see [LICENSE](LICENSE).

claude_org_runtime-0.1.1/pyproject.toml

@@ -0,0 +1,44 @@
+[project]
+name = "claude-org-runtime"
+dynamic = ["version"]
+description = "Python runtime for claude-org-ja: dispatcher, state schema, and reference role prompts."
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+authors = [{ name = "suisya-systems", email = "iwama.ryo.0731@gmail.com" }]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "License :: OSI Approved :: MIT License",
+]
+dependencies = [
+  "jsonschema>=4.18",
+]
+
+[project.optional-dependencies]
+dev = ["pytest"]
+
+[project.urls]
+Repository = "https://github.com/suisya-systems/claude-org-runtime"
+Issues = "https://github.com/suisya-systems/claude-org-runtime/issues"
+
+[project.scripts]
+claude-org-runtime = "claude_org_runtime.cli:main"
+
+[build-system]
+requires = ["setuptools>=64", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools.dynamic]
+version = { attr = "claude_org_runtime.__about__.__version__" }
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+"claude_org_runtime.schema.json_schema" = ["*.json"]
+"claude_org_runtime.prompts.templates" = ["*.md"]
+"claude_org_runtime.settings" = ["*.json"]

claude_org_runtime-0.1.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

claude_org_runtime-0.1.1/src/claude_org_runtime/__about__.py

@@ -0,0 +1,2 @@
+# Single source of truth for the package version.
+__version__ = "0.1.1"

claude_org_runtime-0.1.1/src/claude_org_runtime/__init__.py

@@ -0,0 +1,18 @@
+"""Public surface of the ``claude-org-runtime`` package.
+
+Importing the top-level package exposes the per-feature subpackages
+(:mod:`dispatcher`, :mod:`settings`, :mod:`prompts`, :mod:`schema`,
+:mod:`migrate`) and the package version SoT (:data:`__version__`).
+"""
+
+from .__about__ import __version__
+from . import dispatcher, migrate, prompts, schema, settings
+
+__all__ = [
+    "__version__",
+    "dispatcher",
+    "migrate",
+    "prompts",
+    "schema",
+    "settings",
+]

claude_org_runtime-0.1.1/src/claude_org_runtime/cli.py

@@ -0,0 +1,96 @@
+"""Unified ``claude-org-runtime`` CLI.
+
+Subcommands:
+
+- ``dispatcher delegate-plan ...`` -> :mod:`claude_org_runtime.dispatcher.runner`
+- ``settings generate ...`` -> :mod:`claude_org_runtime.settings.generator`
+- ``migrate ...`` -> :mod:`claude_org_runtime.migrate.v1_to_v2`
+
+The subcommands re-use the same parser builders the per-module CLIs
+expose, so flags stay in lock-step.
+"""
+
+from __future__ import annotations
+
+import argparse
+import sys
+from typing import Optional
+
+from . import __version__
+from .dispatcher import runner as dispatcher_runner
+from .migrate import v1_to_v2 as migrate_v1_to_v2
+from .settings import generator as settings_generator
+
+
+def _run_settings_generate(args: argparse.Namespace) -> int:
+    return settings_generator.run(args)
+
+
+def _run_migrate_v1_to_v2(args: argparse.Namespace) -> int:
+    return migrate_v1_to_v2.run(args)
+
+
+def build_parser() -> argparse.ArgumentParser:
+    parser = argparse.ArgumentParser(
+        prog="claude-org-runtime",
+        description=(
+            "Python runtime for claude-org-ja: dispatcher runner, "
+            "settings generator, state-schema migrate."
+        ),
+    )
+    parser.add_argument(
+        "--version", action="version", version=f"claude-org-runtime {__version__}",
+    )
+    sub = parser.add_subparsers(dest="group", required=True)
+
+    # dispatcher
+    dispatcher_p = sub.add_parser(
+        "dispatcher",
+        help="Dispatcher state-machine helpers (delegate-plan ...)",
+    )
+    dispatcher_sub = dispatcher_p.add_subparsers(dest="cmd", required=True)
+    dispatcher_runner.add_subparsers(dispatcher_sub)
+
+    # settings
+    settings_p = sub.add_parser(
+        "settings",
+        help="Worker settings.local.json generator",
+    )
+    settings_sub = settings_p.add_subparsers(dest="cmd", required=True)
+    gen_p = settings_sub.add_parser(
+        "generate",
+        help=(
+            "Render a per-role settings.local.json from the bundled "
+            "role_configs_schema.json"
+        ),
+    )
+    settings_generator.add_arguments(gen_p)
+    gen_p.set_defaults(func=_run_settings_generate)
+
+    # migrate
+    migrate_p = sub.add_parser(
+        "migrate",
+        help="State-schema migration helpers (v1 -> v2)",
+    )
+    migrate_sub = migrate_p.add_subparsers(dest="cmd", required=True)
+    v1v2_p = migrate_sub.add_parser(
+        "v1-to-v2",
+        help=(
+            "Migrate a v1 .state/ artefact (journal.jsonl or org-state.md) "
+            "to the v2 polymorphic schema."
+        ),
+    )
+    migrate_v1_to_v2.add_arguments(v1v2_p)
+    v1v2_p.set_defaults(func=_run_migrate_v1_to_v2)
+
+    return parser
+
+
+def main(argv: Optional[list[str]] = None) -> int:
+    parser = build_parser()
+    args = parser.parse_args(argv)
+    return args.func(args)
+
+
+if __name__ == "__main__":
+    sys.exit(main())

claude_org_runtime-0.1.1/src/claude_org_runtime/dispatcher/__init__.py

@@ -0,0 +1,23 @@
+"""Dispatcher state-machine helpers ported from claude-org-ja ``tools/dispatcher_runner.py``.
+
+Public surface (``runner`` is lazy-imported to avoid ``runpy``
+double-load warnings when invoked as
+``python -m claude_org_runtime.dispatcher.runner``):
+
+- :mod:`runner` -- :func:`runner.build_plan`, :func:`runner.choose_split`,
+  :class:`runner.LocaleConfig`, :func:`runner.main`.
+- :class:`LocaleConfig` -- re-exported here for ergonomic
+  ``from claude_org_runtime.dispatcher import LocaleConfig``.
+"""
+
+__all__ = ["LocaleConfig", "runner"]
+
+
+def __getattr__(name: str):  # pragma: no cover - thin lazy bridge
+    if name == "runner":
+        import importlib
+        return importlib.import_module(f"{__name__}.runner")
+    if name == "LocaleConfig":
+        import importlib
+        return importlib.import_module(f"{__name__}.runner").LocaleConfig
+    raise AttributeError(name)