---

Constellation — The AVIS Intelligence Pipeline

Constellation is the central intelligence pipeline of the Mercwar ecosystem.
It unifies every repo, robot, source, and intelligence model into a single,
schema‑driven, AVIS‑compliant system.

Constellation is:

• A pipeline
• A robot framework
• A knowledge graph
• A schema system
• A publisher
• A universal intelligence builder

It is the root of all intelligence flow in the AVIS‑2026 architecture.

---

Table of Contents

• Repository Overview
• Constellation Pipeline
• Key Directories
  • Constellation/
  • robots/
  • sources/
  • maps/
  • queries/
  • tools/
  • tabs/
  • images/
  • universal/
• Sitemap
• Purpose
• Legal Section — Constellation Intelligence Law
• Next Steps
  • Repo Packs
  • Sentinel Ingest
  • Constellation Visual Maps
  • Cyborg Language Integration

---

Repository Overview

This repository contains:

• The Constellation pipeline programs
• The universal Constellation folder
• Robots (Sentinel, Walker, Shared Protocol)
• Sources for AVIS, Fire‑Gem, Cyborg, Robo‑Knight
• Maps for robot navigation
• Queries for robot search
• Tabs for documentation
• Tools for build, verify, and sync
• Images for visual maps
• The sitemap generator
• The universal.zip distribution

Each subsystem is designed to be robot‑navigable, schema‑aligned, and
future‑absorbing, ensuring that Constellation can ingest, interpret, and
publish intelligence from any repo in the Mercwar ecosystem.

---

Constellation Pipeline

Constellation runs through six intelligence stages, forming a complete
end‑to‑end intelligence lifecycle:

1. Scanner — discovers versions, folders, and intelligence atoms
2. Reducer — cleans bulk, removes noise, and normalizes structure
3. Autobuild — compiles versions into .bin intelligence artifacts
4. Linker — merges binaries into a unified intelligence.model
5. Validator — ensures schema, structure, continuity, and AVIS compliance
6. Publisher — sends the final model into the AVIS‑Datalake

Robots follow this exact order, ensuring deterministic behavior across all repos.

---

Key Directories

1. Constellation/

The core pipeline folder.

Contains:

• constellation.c — Scanner
• constellation_reduce.c — Reducer
• constellation_autobuild.c — Autobuild
• constellation_linker.c — Linker
• constellation_validator.c — Validator
• constellation_publisher.c — Publisher
• AVIS.schema — schema law
• AVIS.datalake — datalake definition
• CONSTELLATION.index — robot index
• ROBOT.boot — robot boot sequence
• custom/ — repo‑specific overrides

---

2. robots/

Robots that navigate repos and execute Constellation logic.

Sentinel

• sentinel.boot
• sentinel.nav
• sentinel.memory/graph/index.mem

Walker

• walker.rules
• walker.scan

Shared

• protocol.avs
• index.types

---

3. sources/

Raw intelligence sources for each repo family.

Includes:

• AVIS
• FIRE‑GEM
• CYBORG
• ROBO‑KNIGHT

Each contains:

• meta.avs — metadata
• structure.map — structural map
• index.src — source index

---

4. maps/

Robot navigation maps.

Includes:

• MERCWAR.CONSTELLATION.AVIS
• ROBOT.SELFSEARCH.AVIS
• ROBOT.AUTOSCAN.AVIS

---

5. queries/

Robot query language files.

Includes:

• find.by.type.q
• find.by.pattern.q
• list.files.q
• list.repos.q
• robot.query.index

---

6. tools/

Build, verify, and sync utilities.

Includes:

• build.verify
• build.sync
• verify.models
• verify.graph
• sync.repos
• sync.constellation

---

7. tabs/

Documentation tabs for GitHub UI.

Includes:

• tab_001.md
• tab_002.md
• tab_003.md
• tab_004.md
• tab_005.md

---

8. images/

Visual maps and starfields.

Includes:

• starfield_*.png
• nodes_*.png
• links_*.png
• mercwar_constellation_map_*.png

---

9. universal/

The universal Constellation folder distribution.

Contains:

• Full universal Constellation folder
• universal.zip

---

Sitemap

The repo includes:

• sitemap.sh — generator
• sitemap.xml — full recursive map

This ensures robots and external systems can index the entire repo.

---

Purpose

Constellation exists to:

• Unify intelligence across all repos
• Provide a consistent pipeline
• Enable robots to navigate any repo
• Produce AVIS‑ready intelligence models
• Maintain future‑proof compatibility

It is the central nervous system of the Mercwar ecosystem.

---

Legal Section — Constellation Intelligence Law

/* ------------------------------------------------------------
   AVIS.CONSTELLATION.LEGAL

   ARTICLE I — INTELLIGENCE OWNERSHIP
   All intelligence models produced by Constellation are the
   property of their originating repository unless explicitly
   transferred to AVIS-DATALAKE.

   ARTICLE II — SCHEMA COMPLIANCE
   All Constellation programs must adhere to AVIS.schema and
   AVIS.publish.schema.

   ARTICLE III — ROBOT ACCESS
   Robots must follow ROBOT.boot and CONSTELLATION.index.

   ARTICLE IV — CUSTOM OVERRIDES
   Repo-specific overrides supersede universal logic.

   ARTICLE V — PUBLISHING RIGHTS
   Only constellation_publisher.c may publish intelligence models.

   ARTICLE VI — SECURITY
   Constellation must not ingest encrypted binaries without manifest,
   external executables, non-schema files, or unverified robot instructions.

   ARTICLE VII — FUTURE EXTENSION
   All future modules must include AVIS.HEADER, filename, and path comments.

   ARTICLE VIII — LIABILITY
   Constellation provides intelligence transformation “AS IS”.
   ------------------------------------------------------------ */

---

Next Steps

1. Repo Packs

Located in Constellation/universal/custom.

These define:

• Repo identity
• Repo rules
• Repo semantic graph
• Repo knowledge‑binding law
• Repo version lineage

---

2. Sentinel Ingest

Located in /Sentinel.

Sentinel handles:

• Repo scanning
• Navigation
• Memory graph traversal
• Enforcement of AVIS law
• Bootstrapping Constellation intelligence

Sentinel functions similarly to Windows NT subsystems:

• HAL
• Executive
• Object Manager
• I/O Manager

---

3. Constellation Visual Maps

Located in /images.

Includes:

• Starfields
• Node graphs
• Link graphs
• Full Mercwar Constellation map

Used by robots, humans, AVIS‑Datalake, and external AI systems.

4. Cyborg Language Integration

Cyborg Language is modeled after:

• x86 instruction semantics
• Windows API message routing
• MSDN‑style documentation
• Deterministic message passing
• Structured ABI alignment

Practical Evolution Steps

• Add ABI alignment to Cyborg binding
• Map Cyborg opcodes to WinAPI signatures
• Enforce calling conventions (stdcall, fastcall, thiscall)
• Add x86‑style micro‑ops (MOV, PUSH, CALL, RET)
• Add symbolic registers (AX, CX, DX)
• Add message routing tables (WM_CYBORG_EXEC, WM_CYBORG_LOAD)

---