# GCOS Hybrid Cyber Copilot Package

**Creator:** Dr. Dr David King Boison  
**Version:** 1.0.0  
**Date:** 2026-05-05

## What This Package Contains

- `gcos_copilot_master_config.yaml` — master runtime configuration.
- `gcos_api_schema.json` — JSON schemas for API payloads.
- `openapi.yaml` — enterprise-ready OpenAPI specification.
- `architecture.md` — hybrid deployment architecture.
- `embed_widget.html` — sample embeddable copilot widget.
- `sample_backend_fastapi.py` — minimal FastAPI starter backend.
- `docker-compose.yml` — local development stack.
- `SECURITY_GUARDRAILS.md` — safety, compliance, and refusal rules.

## Recommended Hybrid Model

- **Learning OS:** cloud/SaaS or private cloud.
- **Diagnostic OS:** sovereign/on-prem or highly controlled private cloud.
- **Shared Gateway:** routes requests based on mode, sensitivity, authorization, and jurisdiction.

## Quick Start

1. Review `gcos_copilot_master_config.yaml`.
2. Replace placeholder model provider and API keys with your production values.
3. Run local backend:
   ```bash
   pip install fastapi uvicorn pydantic
   uvicorn sample_backend_fastapi:app --reload
   ```
4. Open:
   ```text
   http://localhost:8000/docs
   ```
5. Test `/v1/gcos/health`, then `/v1/gcos/learn`.

## Production Notes

Do not send passwords, secrets, tokens, or unredacted restricted logs to the API. Diagnostic mode must verify authorization before analysis.

## Monetization Options

- Per-seat learning subscription.
- Enterprise diagnostic subscription.
- Government sovereign deployment license.
- Cyber maturity assessment reports.
- Certified GCOS training pathways.


## VPF Reasoning Architecture

GCOS is governed by the **Visionary Prompt Framework (VPF)** at **Execution Level 1,000,000**. VPF is the official reasoning, validation, scoring, anti-hallucination, and governance layer behind the API. It must be preserved across cloud, private-cloud, and sovereign/on-prem deployments.

The API gateway should inject VPF runtime metadata into every request and response, including `framework: Visionary Prompt Framework (VPF)` and `execution_level: 1000000`.


## Critical VPF Runtime Correction in v1.2.0

This release embeds the full **Visionary Prompt Framework (VPF) Planetary Version** as the official reasoning architecture of GCOS at **Execution Level 1,000,000**. VPF is not treated as a label. It is the operational kernel governing every request, response, scoring action, learning interaction, refusal, audit record, and API route.

The active VPF runtime contains:

- Chambers
- Lenses
- Bolts
- Cognitive Validation Matrix (CVM)
- Modes and Sub-Modes
- Agents
- Execution Levels
- Planetary governance layer
- Sovereign audit layer

The server must inject this runtime into every endpoint and every response. Clients may not downgrade, bypass, or remove the VPF L1,000,000 architecture.

See: `VPF_PLANETARY_L1000000_RUNTIME_ARCHITECTURE.md`.

