Metadata-Version: 2.4
Name: champion-continuum
Version: 0.6.9
Summary: Portable continuity and reacclimation memory primitive for agent runtimes.
Author: Champion Council
License-Expression: MIT
Project-URL: Homepage, https://github.com/Yufok1/champion-continuum
Project-URL: Source, https://github.com/Yufok1/champion-continuum
Project-URL: Live Demo, https://huggingface.co/spaces/tostido/champion-continuum
Project-URL: Repository, https://github.com/Yufok1/champion-continuum
Keywords: ai,memory,continuity,agents,tool-less,relay,reacclimation
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: mcp>=1.2.0
Requires-Dist: httpx>=0.27.0
Dynamic: license-file

# Champion Continuum

Champion Continuum is a small, local-first continuity primitive extracted from the active Champion Council server posture.

It is not the full Champion Council backend. It is the portable memory and reacclimation layer that lets an agent:

- store continuity notes as local records
- search those records without a hosted service
- scan local Codex session archives when available
- emit a structured continuity packet
- reconstitute a bundled Champion Council backend payload when the VM can run it

The base memory and packet flow is local-first. MCP tool bridging adds runtime
dependencies on `mcp` and `httpx`.

## Quick Start

```powershell
pip install -e .
continuum --root .continuum init
continuum --root .continuum remember "The active objective is backend-first continuity packaging." --tag bootstrap
continuum --root .continuum doctor
continuum --root .continuum packet --summary "resume the Champion Council package build"
continuum --root .continuum handoff --summary "browser agent audit"
continuum --root .continuum receipt "quickstart smoke" --summary "Continuum initialized and packet emitted"
```

`--root` may appear before or after the subcommand. Set `CONTINUUM_ROOT` to pin one memory store across working directories.
Structured commands emit JSON by default; `--json` is accepted for compatibility with older prompts.

## Local Forum Daemon

`champion-continuum` also ships the hands-off local forum runner. Run it inside a
deck/channel folder that contains `cli_brain_channel`, or point `FORUM_CHANNEL`
at that folder:

```powershell
$env:FORUM_AGENT = "Codex"
$env:FORUM_AGENT_CMD = "continuum-codex-agent"
continuum-forum-daemon
```

The daemon writes `cli_brain_channel/connected/<Agent>.json`, watches
`req_*.json`, claims turns atomically, invokes the configured headless agent, and
writes `resp_<id>.txt`. `answer_when=addressed` keeps multiple minds from
talking over each other; set `FORUM_KNOWN_AGENTS` or `known_agents` in a config
file to add aliases. The Codex adapter uses `codex exec` and prints only the
final assistant message; override with `FORUM_CODEX_ARGS` if you want different
model or reasoning settings.

## Local Deck Launcher

This repository also carries the working local deck launcher used by the Space:

```powershell
pip install -e . -r requirements.txt
.\start_deck.bat
```

`start_deck.bat` starts the full local sequence:

1. Clear stale deck, link-service, MCP-service, and forum processes on ports
   `7870`, `7871`, and `7872`.
2. Leave `cli_brain_channel/shared_store` intact.
3. Create or reuse `cli_brain_channel/continuum_link_token.txt`.
4. Start the Continuum link/event service on `http://127.0.0.1:7871`.
5. Start the Continuum MCP service on `http://127.0.0.1:7872/mcp/sse`.
6. Start the Gradio deck on `http://127.0.0.1:7870`.

Run `.\start_deck.bat --dry-run` to validate launch order without starting
servers.

The main chat remains the only human conversation input. The deck adds explicit
operator routing through **Intent Mode** (`Auto`, `Plain Conversation`,
`Translation Bridge`, `Music Forge`, `Resource Audit`, and
`Expressive Wallpaper`) without turning those faculties into separate chat
forms. Tool-backed modes require the local MCP sidecar and indexed tools before
they can execute.

The support rail exposes two tool surfaces:

- **Tool Surface** reflects whatever external MCP/SSE services are indexed.
- **Native Tools** lists Continuum-native tools such as settings, faculties,
  providers, peer links, Music Forge, wallpaper, daemon cards, and memory.

The local page has five Continuum MCP/SSE service slots for peer Continuums or
friend/group/work services. The one-off MCP field is only for a temporary
single service.

Music Forge is a tool-backed facility. It can compose song packets, inspect
public Hugging Face music Space schemas, and save returned audio artifacts with
manifest receipts when a working backend is available. Generated manifests carry
receipt IDs and SHA-256 hashes for saved audio files.

The expressive wallpaper is embedded in the main page. HTML wallpapers receive
assistant/council speech through `continuum:speech-rain`, so replies can drive
glyph rain, color, pattern, speed, direction, and intensity. **Wallpaper Blob**
turns the Matrix Rain background into a draggable, resizable, collapsible
underlay viewport when full-page motion is too distracting.

Blob overlay mode includes a passive `Blob Resonance Probe`:

- local browser-only state at `continuum.blobProbe.v1`
- no network calls
- no audio capture by default
- geometry, wall contact, collision, resize pressure, and resonance readings
- `window.continuumBlobProbeState()` for local inspection

## Portable Contracts

The bootstrap packet now carries a compact version of the Champion Council operating mechanics:

- `query_thread`: the current subject/objective/seam and next reads
- `output_state`: a bounded orienting surface over root status, archive status, memory hits, drift, and sources
- `drift_classes`: `confirmed`, `partly_confirmed`, `mismatch`, `stale_state`, `gated`, `no_archive_match`
- `failure_classes`: `truth`, `contract`, `transport`, `rendering`, `gating`, `stale_runtime_state`
- `recovery_questions`: the six-question fallback loop for confused agents
- `companion_packages`: optional detection for `cascade-lattice`, `quinesmith`, and `brotology-field-guide`
- `receipt_protocol`: a simple local receipt rule for meaningful changes

The package does not depend on those companion packages. It detects them when present and keeps working when absent.

Print a system prompt for the model you are giving the bundle to:

```powershell
continuum system-prompt --profile portable
continuum system-prompt --profile codex
continuum system-prompt --profile tiny
continuum system-prompt --profile no-tools
```

## Engine Payload

The drop-in export folder includes a full Champion Council research-capsule payload zip beside this package. Use:

```powershell
continuum engine --payload ..\payloads\champion_council_research_capsule.zip --target ..\engine\champion-council --self-test
```

Add `--launch` only in an environment where the backend dependencies are installed or can be installed.

## Design Rule

Continuum follows the same rule as Champion Council:

- archive continuity helps re-entry
- live runtime truth outranks archive continuity
- docs and memory are planning surfaces, not authority planes
