+---------------------------------------------------------------------------------------------------------+
| ⚡ ARCHWIZ COCKPIT // TERMUX HYPER-FORGE | TARGET: Android/Termux | GATES: repo-gate + smoke |
| MODE: operator / supervised-autonomous | STATE: source-of-truth bound | THEME: Tron-capable |
+---------------------------------------------------------------------------------------------------------+
| [1] 🤖 Swarm Autonomous Dispatch (Jules/Commingle) [13] 🔄 Session Pipeline & Live Telemetry |
| [2] 🔍 Deep RECON & Archaeology Sweep (ICM Routing) [14] 📜 Narrative Feed & Execution Ledger |
| [3] ⚡ Agent Shell v3 (Role-Aware Multi-Model) [15] 🌾 Lexicon & AST Context Harvest |
| [4] 📊 Real-Time Metrics & Performance Monitor [16] 👁️ Live View & Interactive Preview Portal |
| [5] 💾 System Backup & State Persistence [17] 🔬 Forensic Toolchain & Pointer Indexer |
| [6] 🔄 Ecosystem Refresh & Rebuild Indices [18] 📝 Auto-Doc Pipeline (COMMIT_NOTES.md) |
| [7] ⚙️ Profile & Environment Management [19] 🚀 Promote Sandbox Workspace -> Master |
| [8] 🛠️ StepWise MCP Automation Engine [20] 🛡️ Execute Dual-Gate CI Validation |
+---------------------------------------------------------------------------------------------------------+
| >> PIPELINE: ACTIVE [auto] | MCP-HUB: CONNECTED | ICM ROUTER: ONLINE | "Ask && U $h411 π3c31ve" |
+---------------------------------------------------------------------------------------------------------+
The cinematic cockpit concept is now grounded in a real Termux-native implementation. The Hyper-Forge is an ANSI/TUI adapter over existing repository primitives rather than a second orchestration system.
TERMUX / ANDROID
│
┌─────────▼─────────┐
│ ARCHWIZ HYPER-FORGE│
│ ANSI / TUI layer │
└─────────┬─────────┘
│
┌────────────────┼────────────────┐
▼ ▼ ▼
FORESIGHT CHRONOMANCER DISPATCH
impact/context time-aware fork bounded task
└────────────────┼────────────────┘
▼
DUAL-GATE VALIDATION
repo-gate + termux-smoke
│
▼
RECORD
Launch directly on Termux:
python3 archwiz/termux_cockpit.pyOr enter it from the established ArchWiz TUI with [20] Termux Hyper-Forge Cockpit.
The optional ARCHWIZ_THEME=tron mode supplies the Tron-inspired cyan/green terminal treatment. It is presentation-only: it does not change routing, authority, telemetry schemas, or promotion semantics.
See docs/ops/TERMUX-ARCHWIZ-HYPERFORGE.md.
Evidence rule: header images and cinematic panels are visual seeds, not live telemetry. Never present generated art as current branch/PR/CI state unless it was generated from a verified repository snapshot.
Powered by autonomous AI employees. This project uses CellCog AI employees for continuous integration, PR review, and engineering operations. Standing AI workers run across persistent sessions with their own cloud environments, tool execution, and team channels. Sign up through the community partner invitation to receive 500 bonus credits on your first purchase. See the landing page and the preview portal (WIP).
Ecosystem partners — referral, affiliate, and gifted-usage lanes — are registered in
docs/PARTNERS.md(active lanes, pipeline, wallets). Partner links may be affiliate or referral links; new accounts may receive promotional credits, terms apply.
AI Agent Benchmarking Performance Framework — ATES
Agent Efficiency / Effectiveness Telemetry System (acronym in progress).
Placeholder graphic — original Drive/GH PNG is corrupt (truncated IDAT). Pipeline: docs/ops/IMAGE-ASSET-PIPELINE.md · track #529.
C×O operator guide. Build deliberately. Preserve evidence. Keep the Android/Termux target first; treat every other environment as a simulation, review surface, or constrained support plane.
This repository is a mixed research, automation, and agentic-development monorepo. It is not a one-command product installer. Use it as an evidence-led operating system for change: enter through the smallest authoritative map, establish the relevant boundary, make a bounded change, and leave a validation trail.
The repository’s public language is deliberately compact, but never opaque. Full paths, explicit ownership, reviewable commits, and human approval outrank clever abbreviations. Internal short pointers belong only to a known local registry and must expand to an unambiguous source before they are acted upon.1
| Operator posture | Meaning |
|---|---|
| Target | Android/Termux is the intended execution environment. Linux desktops, CI, and cloud tools are support or simulation surfaces unless a current source says otherwise. |
| Default | Read the system map, then the owning source; do not infer runtime capability from historical artifacts, names, or external forks. |
| Counter-culture rule | No mystique without traceability. A compressed phrase, agent label, or short pointer must have a recoverable canonical source. |
| Promotion rule | Reviewable evidence and passing relevant checks precede promotion. An explicit operator override must be recorded, not implied. |
Start with one of these routes. Do not load the entire repository merely because it is available.
| Need | Start here | What it owns |
|---|---|---|
| Agent / operator entry (primary) | CLAUDE.md |
Governance, hard rules, dual gates, adaptive WAIT, skills inventory pointer. Load this first. |
| Task routing (one verified card) | docs/icm/CLAUDE.md |
Repository-native ICM system map, objects, processes, and impact routes. |
| Linguist / CedrLang surface only | AGENTS.md |
Deprecated as primary entry — retained as Linguist compression target + tooling compatibility. |
| Maintain the ICM map itself | docs/icm/maintenance/CLAUDE.md |
Inventory → human design review → verification → promotion procedure. |
| Operate or inspect the ArchWiz surface | archwiz/TOOL_INDEX.md |
Named cockpit, forensic, autonomous, verification, and knowledge tools. |
| Review open proposal governance | docs/proposals/ |
Registered active proposals, operator policy notes, and validation structure. |
| Skills + adaptive WAIT | docs/ops/SKILLS-INVENTORY.md |
Ops skill table, admission/queue stalls, evidence-led loop. |
| Deployment lanes (Vercel / Pages) | docs/DEPLOYMENT-LANES.md |
Live Vercel projects, Pages status, hosting identity rules. |
| README / docs image optimize | docs/ops/IMAGE-ASSET-PIPELINE.md |
Fail-closed resize + validate before embed. |
| Review safety and tracked-state debt | docs/CREDENTIAL-EXPOSURE.md |
Credential exposure findings and safe remediation boundary. |
The root README is an entry point, not a duplicate source of truth. Primary agent entry is CLAUDE.md (AGENTS.md is Linguist-only after #488/#534). When this file conflicts with a maintained subsystem map, the subsystem’s cited canonical source wins.
| Surface | URL | Status (see docs/DEPLOYMENT-LANES.md) |
|---|---|---|
| Vercel — termux-monorepo | https://termux-monorepo.vercel.app/ | LIVE showcase / preview portal (demo-portal/public). WIP content; rate-limit noise on PR checks is non-blocking. |
| Vercel — mcp-hub | (MCP router) | LIVE bearer-gated MCP for termux-mcp / android-mcp. |
| GitHub Pages | https://timerloggedout-spec.github.io/ | Landing / static publication. Pages for repo docs remains candidate unless a reviewed workflow enables it. |
| DeepWiki | https://deepwiki.com/timerloggedout-spec/termux-monorepo | Discovery only — never authority to change source. |
Vercel is the only currently documented live application-hosting lane. One Vercel project per independently deployable root. Do not treat a badge or reachable URL as proof of the intended SHA without verification evidence.
The repository’s Wiki surfaces have different responsibilities. They are designed to make discovery convenient without letting a provider-generated summary, an outdated snapshot, or an external page authorize a repository change.
| Surface | Primary role | Validation and write boundary |
|---|---|---|
| GitHub Wiki | Published reader view for approved Wiki Markdown. | Updated only by the managed publisher from reviewed in-repository wiki/ content. |
| Public DeepWiki | Public discovery, repository orientation, source-linked questions, and provider-generated documentation. | Treat the displayed snapshot and its source reference as a discovery aid; verify freshness and corroborate material claims against repository source and review evidence. |
| Devin Wiki | Authenticated documentation-generation and research surface. | Root .devin/wiki.json steers coverage; Devin is not a GitHub Actions writer or a source of change authorization. |
wiki/ |
Canonical, reviewable Markdown projection for GitHub Wiki publication. | Changes follow the normal pull-request process and are published only after merge. |
The badge above links directly to the public DeepWiki page. The current public page exposes an indexed, source-linked snapshot, while the provider’s documentation describes automatic Wiki indexing and optional root-level steering through .devin/wiki.json.5 6 That convenience does not establish snapshot freshness, implementation truth, or authority to write. A stale, incomplete, or drifted provider description must be rechecked against the current repository path, commit, workflow, or review record before it is adopted.
Repository-surface discovery is automated through the existing job-scoped operator-token lane. Its daily read-only reconciliation discovers repositories that the credential can actually reach—including accessible organization and collaborator repositories—and reports the managed Wiki-publisher state as current, missing, drifted, unmanaged, excluded, or blocked. A drifted or missing publisher is a review signal, not a write permission: only a manually requested apply=true run may create a dedicated branch and reviewable pull request; it never modifies a default branch or merges for a repository.7
A companion Devin Wiki access reconciler runs daily after repository-surface discovery. Where the existing Devin GitHub App uses selected-repository access and the established operator PAT meets GitHub’s documented requirements, it assigns newly discovered repositories to that existing App installation. This makes provider-managed Devin/DeepWiki indexing eligible, but it does not call an undocumented public DeepWiki indexing or refresh endpoint, and it does not claim an index is current until its visible source reference is verified.8
The validation sequence is therefore deliberate: use DeepWiki or Devin to discover context; bind material claims to primary repository evidence; bring approved documentation into wiki/ through a pull request; and let the managed publisher project only that reviewed Markdown to GitHub Wiki. The full trust boundary, stale/drift handling, and operator runbook are maintained in wiki/DeepWiki-Mirror.md, docs/agentic/repository-surface-reconciliation.md, and docs/agentic/devin-wiki-access-reconciliation.md. The Linguist machine-parity README enhancement is a separate proposal and is not part of this documentation or badge change.
The Interpretable Context Methodology is applied to this repository itself. It makes folders and Markdown contracts into an agent-readable control plane: each component has a purpose, source boundary, relationships, and first-order change impact. The operating workspace is docs/icm/; external forks are inputs, not a replacement for the repository’s own architecture.2
| ICM surface | Use it for | Boundary |
|---|---|---|
docs/icm/CLAUDE.md |
System orientation and route selection | docs/icm/AGENTS.md is its byte-identical static alias. |
docs/icm/routing.md |
Provider-routing evidence and proposals | It is deliberately separate from the static catalog; it does not invoke providers, store secrets, or mutate workflows. |
docs/icm/effects/CONTEXT.md |
“If I change X, what must I read?” | First-order impacts only; source documents own implementation detail. |
docs/icm/_meta/method-coverage.md |
Verify ICM form coverage and intentional omissions | Describes documentation context, not runtime behavior. |
docs/ICM-ARCHITECT-INTEGRATION.md |
Inspect reference forks and initialization rules | All forks are shallow, reviewed, and reference-only. |
| Reference input | Repository role |
|---|---|
icm-architect_fork |
Compact forms, templates, and system-map guidance. |
interpretable-context-methodology_fork |
Full methodology, conventions, and example workspaces. |
content-agent-routing-promptbase_fork |
Layered routing, canonical-source, and one-way-dependency precedent. |
icm-cctv_fork |
File-backed visual-review and human-checkpoint pattern. |
The full initialization and update rules are maintained in the integration guide. A Gitlink is a reviewed reference pointer; it is not permission to execute, deploy, or inherit an external project’s behavior.
This repository supports agents, CI, and review tools, but it does not authorize unattended self-modification. Agentic work is governed by source ownership, repository checks, peer review, explicit secrets boundaries, and the human operator.
| Actor / surface | Current role | Must not be assumed |
|---|---|---|
| Human operator | Sets scope, approves sensitive promotion or runtime access, and resolves exceptions | An always-online shell, device approval, or implicit consent. |
| GitHub Actions | Runs repository checks, lifecycle validation, review orchestration, and configured publication tasks | A substitute for runtime architecture or a blanket right to change code. |
| Devin | Peer review and review/fix participant under existing repository orchestration | A public Auto-Fix API or automatic write permission outside configured service settings. |
| Jules | Coordinated builder path through existing issue and review workflows | Unbounded scope, device access, or duplication of work already claimed by another agent. |
| Dependabot | Valid monitor configuration for GitHub Actions dependencies; version-update pull requests are limited to zero | A release manager or an approval substitute. |
| Termux / BLU B160V | Design and future execution context where currently verified | A live MCP transport, public shell, or device capability merely because historical artifacts mention one. |
The current integration markers are maintained in .github/connectors/integrations.yaml, and peer coordination is implemented in the relevant workflow sources. Read the current workflow before proposing a new bot loop; do not create a parallel control plane.
The repository’s Linguist work optimizes internal agent communication through CedrLang compression and short-pointer conventions. The current cid.py implementation stores mappings locally under ~/.cedar/cedar_index.json, generates short base-36 pointers, and expands them back to full commands.1 The merged CedrLang v2 implementation documented lossless, line-oriented handling for its intended compiler pipeline.3
README rule: public documentation stays explicit. Use readable paths and links here. CID pointers are an internal efficiency mechanism only when the receiving context has the same trusted registry and can expand the pointer before execution.
| Surface | Purpose | Audit route |
|---|---|---|
workspace/compression_sandbox/cedrlang/cid.py |
Local CedarIndex short-pointer registry and expansion behavior | Source-level implementation. |
harmony_hub/workspace/agent/LINGUIST_SPEC.md |
Linguist role, pointer conventions, and integration intent | Agent specification. |
| PR #196 | Merged CedrLang v2 compilation work | Historical implementation and review evidence. |
| PR #228 | Merged fast-path term-search optimization | Subsequent performance evidence. |
1337-style naming may be used as a display dialect, never as a substitute for a source path, permission boundary, or validation result. The disciplined version of “l33t” is legibility under pressure.
The repository now owns initiated, file-backed review cards at docs/icm/_tv/. They can mirror an approved stage or human checkpoint while leaving the source artifact canonical.
| Status | Meaning |
|---|---|
| Initiated | Card layout, response cage, and initial ICM integration screens exist in the repository. |
| Not enabled by default | No renderer, file watcher, WebSocket loop, public service, device connection, or provider polling is started by these files. |
| Future mobile path | A static export can later be published to a mobile browser through a separately reviewed publication change. GitHub Pages can serve static output; it is not the live renderer. |
Do not treat a dashboard card as an approval, an execution command, or a source of truth. Open the cited source card or operational document before changing runtime behavior.
The repository gate is designed to be cheap, portable, and usable without device access. It reads the Git index, applies hard checks to changed paths, and ratchets tracked debt instead of allowing it to grow. It now handles Git submodule Gitlinks as commit references rather than trying to read them as blobs, so the ICM reference inputs can be safely checked in CI.4
# From the repository root
python3 scripts/ci/repo_gate.py --base origin/master
python3 scripts/proposals/validate_registry.pyUse the ICM change-and-validate process to identify the relevant source, proposal, and checks. The repository’s historical termux-smoke topology may require separate current-source verification; never infer a runnable device path simply from a branch name or stale document.
The monorepo contains recovered, generated, historical, and mixed-confidence material. Treat workspace/, session artifacts, saved outputs, and recovery-era content as evidence to classify before using—not as indisputable runtime configuration.
| Situation | Read first | Do not do |
|---|---|---|
| Credential or browser-profile concern | docs/CREDENTIAL-EXPOSURE.md |
Copy, publish, or normalize secrets into a new artifact. |
| Workspace artifact or generated-map request | docs/icm/objects/knowledge/workspace-artifact-estate.md |
Delete, promote, or execute it without classification. |
| Device or service availability question | docs/icm/objects/platform/blu-b160v-free-services.md |
Infer live Termux or device access from a design constraint. |
| Reference fork update | docs/icm/objects/knowledge/reference-inputs.md |
Treat an external fork as an unchecked runtime dependency. |
| Broad staging-history recovery | docs/icm/_meta/master-rebuild-integration-evidence.md |
Import the archive wholesale; review components independently. |
This README replaces a recovery-era root document with a deliberate navigation and operating guide. The immediate predecessor ICM entry-point update is preserved at a49efbb. The repository-native ICM delivery entered master through PR #232 at merge commit 2b8396a.
The preserved pre-rebuild branch archive/pr232-pre-master-rebuild-20260817 remains available as review evidence for later component-by-component workflow and application work. It is intentionally not a mandate to replay divergent history.