components(asking-star): add Scheme-B semantic runtime components - #1
Open
ymy-yry wants to merge 10 commits into
Open
components(asking-star): add Scheme-B semantic runtime components#1ymy-yry wants to merge 10 commits into
ymy-yry wants to merge 10 commits into
Conversation
Document the Asking Star V5/V5.5/V5.6 surfaces that are already present in the Scheme-B component import, including Walker-Giant ingress, Primordial seed refs, AlgebraSkeleton, TimelineJoint, Star-layer vessel transport, MultiChamber runtime, ChamberPouch observation, SkinUI projection, ReflexGeneBank, and the related test locations. Keep the evidence boundary explicit: this documents the componentized implementation and local tests without claiming BoardReal or full RK3588 robot closure.
Add the Asking Star system architecture diagram to the PR branch README and document the five-layer mapping across OuterKernel, Sky/DigitalSet, Asking Star Core, Soil/vessel/chamber runtime, and InnerKernel/hardware boundaries. The README now explains how AlgebraSkeleton, TimelineJoint, VesselBus, MultiChamber, ChamberPouchView, Soil, and Starry Sentinel fit into the submitted componentized design.
Author
|
Ownership and Maintenance Boundary Asking Star Scheme-B is submitted as a componentized contribution for TGOSKits upstream review. This PR does not transfer the independent ownership, project identity, roadmap authority, or sublicensing authority of Asking Star to unrelated third parties. Future maintenance should follow TGOSKits repository governance and should be performed by the repository owners, authorized maintainers, original contributors, or contributors accepted through the normal PR review process. Substantial architecture changes, public renaming, license changes, or transfer of maintenance authority should require explicit review by the original contributors and TGOSKits maintainers. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
This PR introduces Asking Star Scheme-B into TGOSKits as componentized runtime
and Soil/adapter components, together with import scripts, component smoke-test
scripts, the system architecture diagram, and documentation.
The goal is not to replace the existing StarryOS, ArceOS, or AxVisor
architecture, nor to directly rewrite StarryOS kernel scheduling paths. Instead,
this PR organizes the Asking Star semantic runtime, Sky/Soil symmetric boundary,
OS/ABI adapter layer, DigitalSet evidence chain, and local test entry points as
buildable, testable, and reviewable components for incremental upstream review.
This PR adds:
components/asking-star-runtimecomponents/asking-star-soiltools/import_asking_star_scheme_b.shtools/run_asking_star_scheme_b_tests.shdocs/docs/asking-star/scheme-b-overview.mddocs/static/images/asking-star-system-architecture.pngvalidation boundary, and collaboration notes
Motivation
Asking Star targets StarryOS, RK3588 / Orange Pi 5 Plus edge-intelligence
platforms, AI inference adaptation, and embodied-intelligence application
migration.
In edge-intelligence systems, application intent, AI inference, OS services,
drivers, syscalls, ioctls, device nodes, and hardware behavior are often tightly
coupled. That can work in a Linux environment, but it becomes difficult to
migrate, replay, or compare behavior across StarryOS, QEMU, Mock, Replay, Linux
user, and real-board validation.
Asking Star tries to address the following problems:
KernelRequest,KernelResult, trace, and logs arescattered;
confused;
boundaries;
Asking Star uses DigitalSet, StarRuntime, Sun/Organ, VesselBus, MultiChamber,
SoilRuntime, Trace, and adapter boundaries to organize application intent,
runtime state, AI inference requests, OS/ABI requests, and execution results
into a traceable semantic runtime path.
Five-Layer Architecture
The system uses a layered architecture across the hardware platform, StarryOS
kernel, runtime and verification layer, and OuterKernel / application-intent
layer. The hardware layer is centered on RK3588 and provides ARM big.LITTLE CPU,
NPU, memory, storage, UART, USB, camera, and related devices. The StarryOS
kernel layer handles early boot, MMU, memory management, task scheduling,
syscalls, and basic drivers. Starry Sentinel runs on the host side and handles
builds, loading, serial logs, and exception reports; it is not a guest-kernel
component.
Asking Star V5.6 sits in the runtime and adaptation layer. It uses the
OuterKernel -> SkyLayer -> Asking Star Core -> SoilLayer -> InnerKernelLayerSky-Soil symmetric structure to unify application intent, AI inference requests,
OS/ABI calls, and test evidence into recordable DigitalSet structures:
The terms OuterKernel, Asking Star Core / middle core, and InnerKernelLayer are
engineering metaphors in the Asking Star design. They do not rename or replace
the traditional OS kernel:
including shell commands, AI demos, robot tasks, SkinUI, Walker input, and
outer-kernel userspace. It expresses intent, but does not directly access
OS/ABI details.
DigitalSet interpretation, Gene / Charge / DigitalCell, Sun admission, and
Organ execution organization. It understands task semantics, organizes runtime
state, and creates executable semantic units.
including StarryOS, ArceOS, AxVisor, Linux user, QEMU, and BoardReal paths.
Asking Star enters this layer only through SoilRuntime and adapter surfaces.
StarRuntime, ChamberRuntime, and Walker surfaces must not bypass Soil.
The Star layer sits between application intent and the OS boundary. It is not a
traditional OS kernel and not just an application framework. It is the semantic
middle core of Asking Star: it converts external intent into traceable,
schedulable, replayable, and verifiable runtime facts.
Implemented Architecture Surface
This PR does not only add a minimal
StarRuntimefacade. The Scheme-B componentimport includes the core Asking Star V5/V5.5/V5.6 implementation surface,
including:
DigitalSetas the fact carrier;Gene / Charge / DigitalCellsemantic runtime units;Walker-Giant ingressas the outer input surface;PrimordialDigitalSet/ startup seed refs;AlgebraSkeletonas the main time-axis skeleton;TimelineJointfor horizontal ref mounting;asking_star/v56/vesselStar-layer vessel transport;Sun / Organadmission and execution organization;MultiChamberruntime;ChamberRuntimeexecution-environment selection;ChamberPouchViewfor observation, health, fallback, trace, and reflexcandidates;
SkinUIProjectionfor readable state projection and UI event input;ReflexGeneBankand preset-charge flow;Replay / RKNN / StarryOS dry-run chambersurfaces;SoilRuntimeand the Soil MultiChamber adapter;BoardReal guard paths.
The intended path is:
Asking Star Runtime does not directly replace StarryOS kernel scheduling.
Instead, it adds task orchestration, capability scheduling, and state-feedback
layers above the traditional OS. It focuses on how tasks are expressed, how they
flow, how state is generated, and how runtime work enters the system boundary.
The current design uses the DigitalSet fact base, Star-layer dual semantic
modules, cell-level task units, organ-level capability execution,
chamber-backend selection, and Sky/Soil symmetric boundaries to satisfy the
design requirement of building a semantic runtime above kernel scheduling.
The benefit is not simply making the call chain shorter. The value is reducing
invalid computation, repeated failures, and resource waste through task-graph
scheduling, capability selection, device adaptation, inference fallback, and
observation feedback, thereby improving the overall efficiency and
optimizability of edge-intelligence tasks.
Validation
Local validation results:
31/31 tests passedcargo fmt --all -- --checkpassedcargo xtask clippypassedcargo xtask sync-lintpassedcargo xtask testpassed11/11The QEMU matrix covers:
x86_64,aarch64,riscv64,loongarch64x86_64,aarch64,riscv64,loongarch64aarch64,riscv64,loongarch64Evidence Boundary
This PR does not claim:
Mock, Replay, Linux baseline, QEMU dry-run, and StarryOS dry-run results are not
treated as BoardReal evidence. Starry Sentinel host-side artifact verification,
U-Boot probes, serial marker monitoring, JSONL event streams, and Markdown
reports are also not equivalent to guest-kernel execution evidence.
Review Notes
Suggested review order:
README.md;docs/docs/asking-star/scheme-b-overview.md;tools/import_asking_star_scheme_b.sh;tools/run_asking_star_scheme_b_tests.sh;components/asking-star-runtime;components/asking-star-soil;We would like to share Asking Star in small, reviewable steps while respecting
the upstream maintenance process. We hope this work can serve as a basis for
equal collaboration, mutual learning, and cooperative development with the
upstream community.
If maintainers prefer different directory placement, API naming, component
boundaries, test organization, or documentation scope, we are willing to keep
adjusting the branch based on community feedback and work together toward a
cleaner, more maintainable integration path.