This release is a pre-release and may not be stable for production use.
RPOS — Responsibility Pathway Operating System
RPOS is an executable responsibility operating layer for consequential AI and automation workflows.
Its core rule is: authorization is not execution, an execution receipt is not proof of external effect, and failure or uncertainty must not erase responsibility.
RPOS preserves a responsibility pathway across:
proposal -> Human Gate -> authorization -> dispatch -> effect verification -> uncertainty -> repair -> explicit resumption -> completion
Public alpha status
Version: 0.1.0a1 candidate — Early Public Alpha / Executable Preview
The current implementation provides a Python/SQLite executable core, durable responsibility state, Human Gate handling, bounded dispatch attempts, external-effect separation, reconciliation, repair/resume, evidence history, reusable Responsibility State Envelopes, guideline/evidence views, provenance support, a CLI, runnable examples, and a bounded machine-checked Lean formal model.
This alpha is intended for engineering evaluation and bounded pilots, not unattended production use.
Why RPOS exists
Agent systems can produce a successful tool receipt while the real-world effect is absent, partial, duplicated, ambiguous, or unverifiable. They can also lose the human decision boundary when retrying after failure.
RPOS keeps those cases explicit:
AUTHORIZEDdoes not mean execution has started or succeeded.DISPATCHINGpreserves an issued but unresolved attempt.EFFECT_UNKNOWNpreserves uncertainty instead of reporting false success.REPAIR_REQUIREDmakes recovery responsibility explicit.READY_TO_RESUMEmeans repair readiness, not permission to execute.- resumption restores authority before a fresh dispatch attempt.
COMPLETEDfollows bounded verification, not merely a transport receipt.
Install
Python 3.11+ is required.
python -m pip install responsibility-pathway-os==0.1.0a1
rpos --db rpos.db boot
For a source checkout:
python -m pip install -e .
python examples/quick_start_end_to_end.py
For a short evaluator route covering executable, formal, and field-quality boundaries, see docs/en/public-alpha-evaluation-guide.md.
Executable examples
The public alpha candidate includes eight executable evaluation scenarios:
python examples/happy_path_verified.py
python examples/human_gate_denied.py
python examples/effect_unknown_restart_reconcile.py
python examples/quick_start_end_to_end.py
python examples/idempotency_replay_guard.py
python examples/human_return_reauthorization.py
python examples/adapter_exception_containment.py
python examples/reconciliation_unresolved_human_return.py
They cover:
- Human Gate approval followed by bounded independent verification and completion;
- Human Gate denial with no dispatch;
- successful receipt ->
EFFECT_UNKNOWN-> process restart -> observation-only reconciliation -> completion; - failed first attempt ->
REPAIR_REQUIRED-> repair preparation ->READY_TO_RESUME-> explicit resume authorization -> fresh attempt ->EFFECT_UNKNOWN-> restart -> reconciliation -> completion; - duplicate idempotency/effect identity -> no silent redispatch of the recorded semantic effect;
- repair responsibility -> explicit Human Return -> explicit resume authority rather than implicit authority restoration;
- adapter exception after dispatch begins ->
EFFECT_UNKNOWNrather than proof that no external effect occurred; - unavailable reconciliation observer -> preserved
EFFECT_UNKNOWNand explicit Human Return.
The examples are executable evidence for those bounded scenarios only.
Responsibility State Envelope templates
templates/catalog.json contains reusable neutral-role templates for:
- operation proposal;
- Human Gate decision;
- verification contract;
- repair plan;
- resume authorization;
- dependency evidence;
- external evaluation evidence;
- Human Return packet.
The preferred rpos.validate_envelope(...) API rejects unknown fields, missing required fields, unsupported template kinds/schema versions, and any envelope that claims an authority effect.
Every Responsibility State Envelope has authority_effect: "none": filling or validating an envelope never authorizes, dispatches, verifies, completes, or resumes an operation. The earlier ResponsibilityPacket, validate_packet(...), and rpos.packet.v0.1 names remain supported for backward compatibility. See docs/en/responsibility-packet-templates.md.
Core responsibility states
PROPOSED, HUMAN_GATE, AUTHORIZED, DISPATCHING, EFFECT_UNKNOWN, VERIFIED, REPAIR_REQUIRED, READY_TO_RESUME, COMPLETED, DENIED, ABORTED.
The normative transition model intentionally prevents a success receipt from directly proving completion and prevents repair readiness from silently restoring execution authority.
Bounded Lean 4 formal model
RPOS has a machine-checked formal evidence surface pinned to Lean 4.32.2. It is independently reproducible as a Lake project:
cd formal/lean
lake build
Current modules:
formal/lean/RPOSState.lean— states, direct transitions, local invariants;formal/lean/RPOSReachability.lean— bounded multi-step reachability and no-direct-shortcut properties;formal/lean/RPOSEvidenceBoundary.lean— bounded separation among authorization-relevant evidence, external-effect-verification evidence, receipts, evaluations, and dependency evidence;formal/lean/RPOSPacketBoundary.lean— bounded no-authority-effect properties for responsibility envelopes/packets;formal/lean/RPOSOperationalBoundary.lean— bounded operational responsibility properties;formal/lean/RPOSTransparencyBoundary.lean— bounded transparency/evidence distinctions.
Examples of machine-checked properties include:
- only
AUTHORIZEDdirectly entersDISPATCHING; - only
VERIFIEDdirectly entersCOMPLETED; EFFECT_UNKNOWNcannot directly complete;REPAIR_REQUIREDcannot directly dispatch;READY_TO_RESUMErestores authority throughAUTHORIZED, not direct dispatch;- execution receipts, evaluation evidence, and dependency evidence do not become external-effect verification evidence in the declared abstract model.
Positive reachability theorems are path-existence witnesses, not liveness guarantees.
Formal proof evidence does not prove the Python implementation. RPOS explicitly keeps formal proof, executable implementation evidence, and operational external-effect evidence separate. See formal/lean/README.md.
Evidence boundaries
RPOS separates evidence classes instead of allowing one kind of evidence to impersonate another:
- authority and admission;
- execution / receipt;
- external effect;
- recovery and resume;
- safety / capability evaluation evidence;
- dependency / software-supply-chain evidence;
- guideline evidence matrices;
- engineering provenance and future public-claim review inputs.
Evidence recording does not automatically promote operational responsibility state unless the corresponding state-transition contract explicitly requires it.
Defensive provenance
RPOS records engineering provenance so later qualified review can reconstruct when and why a feature was introduced and where implementation boundaries may be replaceable.
Unpublished third-party patent claims are not treated as design inputs. Public-claim review records require actual publication metadata and a public claim-text reference.
RPOS does not determine patent non-infringement, patent invalidity, freedom to operate, prior-art sufficiency, or legal claim scope.
Japan-first development
The initial adoption profile is Japan-first. Current bounded evidence work references official Japanese AI and software-supply-chain guidance and preserves explicit gaps rather than emitting a compliance verdict.
International mappings are planned after the Japanese operating/profile layer stabilizes.
Continuous development cycle
RPOS is developed as one layer of a continuous feedback system:
Responsibility Pathway Model / Paper
-> Responsibility Pathway Engineering
-> Responsibility Pathway Runtime
-> RPOS
-> formal + executable + operational evidence
-> Engineering + Model / Paper
A concept should move downstream into executable evidence and then return upstream as definitions, counterexamples, engineering obligations, limitations, or empirical questions. No layer may claim another layer's evidence.
Verification
Current release-candidate verification includes:
- the full Python test suite;
- execution of all eight source examples;
- wheel and source-distribution builds;
- isolated clean installation of wheel and sdist;
- installed CLI/API and Quick Start checks outside the repository working directory;
- deterministic exact-HEAD public-export reconstruction;
- source-bound CycloneDX SBOM and SHA-256 release-artifact evidence;
- likely-secret scanning of the public source boundary;
- Windows field-portability checks on Python 3.11 and 3.12;
- pinned
lake buildverification of the declared bounded Lean 4 project.
Passing these checks is evidence within their declared scope. It does not establish production readiness, legal compliance, external-system correctness, universal safety, or implementation-wide formal correctness.
Project surfaces
product-status.json— machine-readable release stage, verified surfaces, non-claims, and release gates;CHANGELOG.md— public-alpha changes and explicit deferrals;CONTRIBUTING.md— contribution and evidence discipline;SUPPORT.md— alpha support expectations;SECURITY.md— security reporting and supported boundary;docs/en/public-alpha-evaluation-guide.md— short third-party evaluation route.
Claim boundary and promotion path
RPOS does not treat every current non-claim as a permanent disclaimer. Public boundaries are separated into evidence-limited boundaries that can move and permanent responsibility boundaries that RPOS should not cross by itself. See Claim Boundary Promotion.
Current evidence-limited boundaries
The following claims are intentionally withheld because the required evidence is not yet sufficient. They may be promoted only after scoped, reviewable evidence is obtained and explicitly admitted into the public claim:
- production readiness — requires sustained workload/soak evidence, fault injection across supported deployment profiles, upgrade/rollback/backup/recovery evidence, operational monitoring/SLO evidence, and reviewed security/deployment controls;
- broader platform support — requires a declared support matrix with reproducible CI and field results for the supported OS, Python, container, network, identity, and storage profiles;
- implementation-wide formal conformance — requires an explicit refinement/conformance relation between the formal model and executable semantics plus reproducible conformance evidence for the claimed implementation surface;
- broader software-supply-chain trust — requires stronger provenance, immutable inputs where justified, artifact signing/attestation, independent verification, and maintained vulnerability-response evidence;
- domain effectiveness beyond the published scenarios — requires domain-specific pilots with declared hypotheses, failure criteria, observed outcomes, counterexamples, and independent review.
Promotion is not automatic: new evidence must be scoped, reviewable, reproducible where applicable, and explicitly adopted into the corresponding public claim.
Permanent responsibility boundaries
These are not unfinished features and are not expected to disappear merely because RPOS matures:
- RPOS does not create legal authority, legal interpretation, liability, certification, or regulatory approval by itself;
- RPOS does not make an arbitrary external system correct merely because it governs the pathway to that system;
- a transport receipt does not become proof of a real-world effect without an appropriate verification contract and evidence source;
- RPOS does not transfer final organizational responsibility from the responsible human or institution to software;
- RPOS cannot provide a universal exactly-once guarantee for arbitrary external systems that do not expose the required transactional/idempotency/verification contract;
- formal proof about an abstract model does not automatically prove the complete Python implementation or deployment environment;
- patent non-infringement, patent invalidity, freedom to operate, and legal claim scope remain outside RPOS's authority.
Where practical, evidence-limited boundaries are tracked as evidence_collecting, review_ready, or promoted; permanent boundaries are permanently_out_of_scope.
License
MIT License.
Lineage
Responsibility Pathway Design / Model
-> Responsibility Pathway Engineering
-> Responsibility Pathway Runtime
-> RPOS — Responsibility Pathway Operating System
RPOS is independently engineered as the operating layer that preserves responsibility continuity through authority, execution, uncertainty, repair, and explicitly authorized resumption.
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file responsibility_pathway_os-0.1.0a1.tar.gz.
File metadata
- Download URL: responsibility_pathway_os-0.1.0a1.tar.gz
- Upload date:
- Size: 50.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
128e842dcfe638d6f5eec5073c89bebe41fc9b74ac4639cc54c41b67903f04b2
|
|
| MD5 |
007994a92ad10bd62a4e30ba663c3f58
|
|
| BLAKE2b-256 |
00d495801bedb8896c684f41c34e2dcea731cb382256176a63982f60f2347698
|
Provenance
The following attestation bundles were made for responsibility_pathway_os-0.1.0a1.tar.gz:
Publisher:
release.yml on YutoriKomeiji/responsibility-pathway-os
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
responsibility_pathway_os-0.1.0a1.tar.gz -
Subject digest:
128e842dcfe638d6f5eec5073c89bebe41fc9b74ac4639cc54c41b67903f04b2 - Sigstore transparency entry: 2632252647
- Sigstore integration time:
-
Permalink:
YutoriKomeiji/responsibility-pathway-os@16acfc773764031187900d0aff2bf3ea91c14185 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/YutoriKomeiji
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@16acfc773764031187900d0aff2bf3ea91c14185 -
Trigger Event:
workflow_dispatch
-
Statement type:
File details
Details for the file responsibility_pathway_os-0.1.0a1-py3-none-any.whl.
File metadata
- Download URL: responsibility_pathway_os-0.1.0a1-py3-none-any.whl
- Upload date:
- Size: 40.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d54b5c256e7c09d265cc1a70c50381f1a8520f7898c38fb02bc5e6858279cc17
|
|
| MD5 |
93292bec020a25a2ccc834d51b8da76d
|
|
| BLAKE2b-256 |
46cd47295d81427b5061b25495ab7510db328ee9d6b9d0c2fc57b29d303cecaa
|
Provenance
The following attestation bundles were made for responsibility_pathway_os-0.1.0a1-py3-none-any.whl:
Publisher:
release.yml on YutoriKomeiji/responsibility-pathway-os
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
responsibility_pathway_os-0.1.0a1-py3-none-any.whl -
Subject digest:
d54b5c256e7c09d265cc1a70c50381f1a8520f7898c38fb02bc5e6858279cc17 - Sigstore transparency entry: 2632252736
- Sigstore integration time:
-
Permalink:
YutoriKomeiji/responsibility-pathway-os@16acfc773764031187900d0aff2bf3ea91c14185 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/YutoriKomeiji
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@16acfc773764031187900d0aff2bf3ea91c14185 -
Trigger Event:
workflow_dispatch
-
Statement type: