Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

422 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

cpython-android-cli

An evidence-driven research repository for adapting upstream Android/Bionic CPython into a practical standalone CLI runtime and studying its use under Termux and uv.

This repository is the laboratory, governance record, and historical evidence archive. It is not the final release repository, a CPython fork, a replacement for Termux Python, or a claim that every demonstrated capability belongs in the eventual product.

Current project coordinates

Generated from docs/current/STATE.json. Do not hand-edit this block.

agent bootstrap       established — AGENT_BOOTSTRAP.md
session transport     full Git bundle -> one runner -> complete receipt
immediate action      rebind-epoch4-native-data-contract-to-canonical-product
program epoch         E4 — Android native-data research reconciled with the canonical product
program gate          E4/CANONICAL-PRODUCT-NATIVE-DATA-REBIND — Rebind selected native-data research to the canonical product model

Current claim boundary

dual-device claim     accepted — AArch64 Termux compatibility
emulator qualified    false
selectable            true
publication           true
Epoch 3 selection     true

Active blockers

none

Unresolved risks

  • upstream-api24-floor-declared-and-qualified-on-api36-device-but-not-on-api24-hardware
  • canonical-product-qualified-only-in-Termux-on-SM-S908N-Android16-API36-arm64-v8a
  • non-Termux-ADB-shell-and-emulator-contexts-unqualified-and-unclaimed
  • actual-16KiB-runtime-explicitly-unsupported-and-unqualified
  • other-Android-ABIs-explicitly-out-of-scope
  • user-built-wheel-portability-and-repair-explicitly-out-of-scope
  • product-publication-accepted-from-owner-supplied-snapshot-without-live-remote-readback
  • supplied-product-bundle-binds-complete-HEAD-tree-but-not-standalone-complete-history
  • source-lock-retains-stale-Termux-tzpath-metadata-not-selected-by-ci-targets
  • API24-runtime-declared-supported-from-build-floor-but-device-unvalidated
  • non-Termux-support-qualified-only-for-android-terminal-appuid-native-shell-on-S22-API36
  • adb-shell-and-other-non-Termux-contexts-unqualified-and-not-required
  • runtime-16KiB-explicitly-unsupported-unqualified-owner-scope-excluded
  • emulator-unqualified-and-not-required-for-current-release-blocker-gate
  • upstream-derived-full-is-not-Astral-producer-object-full
  • zero-producer-path-rule-not-derived-from-astral-golden-contract
  • android-user-trust-network-security-config-and-conscrypt-policy-semantics-unclaimed
  • standard-invalid-override-fail-closed-semantics-must-be-preserved
  • source-producer-host-isolation-and-libffi-fallback-evidenced-but-not-productized
  • openssl-openssldir-alone-does-not-address-android-cacerts-layout
  • android-system-root-direct-capath-rejected-because-platform-files-use-old-subject-hash-retain-packaged-or-caller-supplied-ca
  • epoch4-product-policy-selected-ca-packaged-data-default-timezone-android-native-default-without-release-selectability
  • ca-overlay-symlink-mode-does-not-claim-historical-root-set-rollback-after-apex-replacement-packaged-ca-remains-rollback
  • android-trustmanager-network-security-config-user-ca-ct-ocsp-and-sct-semantics-remain-unclaimed
  • app-hosted-java-trustmanager-and-icu-bridges-outside-current-standalone-cli-profile
  • ca-current-hash-private-overlay-accepted-but-not-product-selected
  • old-hash-fallback-requires-openssl-update-patch-replay-and-independent-requalification
  • android-native-old-hash-fallback-selected-but-not-yet-applied-to-a-source-produced-product-family
  • termux-fixed-timezone-path-selected-non-termux-package-owned-absolute-path-withheld
  • timezone-content-addressed-integration-accepted-but-not-yet-applied-to-a-source-produced-product-family
  • selected-native-data-source-family-not-yet-built
  • historical-epoch4-native-data-selection-is-not-a-canonical-product-default
  • epoch4-r1-source-product-integration-failed-non-dispositively-on-obsolete-archive-root-assumption
  • canonical-product-native-data-candidate-requires-revision2-contract-target-qualification-and-explicit-product-decision
  • canonical-product-artifact-bytes-are-bound-by-product-repository-receipt-but-not-copied-into-this-research-repository

Accepted authorities

Agent entry

Agent session entry

A new agent session starts from the full Git bundle at AGENT_BOOTSTRAP.md. The owner does not need to provide a separate handoff package or a large prompt.

Stable human entry points

Authority model

present coordinates   -> docs/current/STATE.json
agent task routing    -> docs/current/AGENT_TASK.json
program design        -> canonical active plan + ADRs + epoch charters
proven result         -> frozen contract + evidence + machine authority
past statement        -> historical snapshot at its recorded boundary
where to read         -> generated navigation

Engineering principle

understand -> reproduce -> measure -> compare -> design -> optimize

Complete independently audited target evidence outranks design intent, local reconstruction, static inspection, and chat memory. Narrow evidence must not be expanded into a broader claim.

About

Evidence-driven research on standalone CPython CLI runtimes for Android/Bionic, Termux, and uv.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages