diff --git a/README.md b/README.md index 4ebce99..3a692ef 100644 --- a/README.md +++ b/README.md @@ -1,2 +1,310 @@ -# .profile +# ✅ README.md — VSAbot — v4.31.1-r2 +```text +═══════════════════════════════════════════════════════════════════════════════ +## ✅ VSA.bot — Verify, Score, & Audit +## 🏆 #GoldStandard — Federated Architecture VSA Agents +## 🧪 v4.31.1-r2 — W31 D3 (Wednesday, 29 Jul 2026) +## 🛡️ PRJ-040 ELEVATED — BP-068 COMPLIANT — BP-075 COMPLIANT +## 🔒 NOTE: Governance, protocols, and templates maintained by WeOwnAI/s004_fedarch +## 🌐 Source of Truth: https://git.weown.tools/VSAbot +## 📋 Governance Root: https://git.weown.tools/WeOwnAI/s004_fedarch +═══════════════════════════════════════════════════════════════════════════════ + +| Field | Value | +|:------|:-------| +| **Organization** | ✅ **VSAbot** | +| **Emoji** | ✅ (Check Mark — Verification, Approval, Validation) | +| **Full Name** | ✅ VSA.bot | +| **Acronym** | **V**erify, **S**core, & **A**udit | +| **Ecosystem** | ♾️ **WeOwnNet** 🌐 | +| **Framework** | #FedArch — Federated Architecture | +| **Description** | Verify, Score, & Audit (VSA) for ♾️ WeOwnNet 🌐 ecosystem ● Federated Architecture (#FedArch) VSA agents — verifying governance, analyzing prompts, surveilling ecosystem health. Home of prompts, verification protocols, and cross-agent audit tooling. | +| **Parent Org** | ♾️ WeOwnNet 🌐 (.OCA) | +| **Sibling Orgs** | WeOwnChat 💬 · DRPbot 🛡️ · F1visaNet 🛂 · WeOwnAI 🤖 · WeOwn.Dev 💻 · Exit 👋 · MAIT 🎭 | +| **Repository Count** | 1 (`s004`) | +| **Governance Host** | [WeOwnAI 🤖 / s004_fedarch](https://git.weown.tools/WeOwnAI/s004_fedarch) | +| **Status** | 🟢 **LIVE** | +``` + +--- + +## 📋 TABLE OF CONTENTS + +| § | Title | +|:-:|:------| +| [§1](#1-what-is-vsabot) | 🤔 WHAT IS VSA.bot? | +| [§2](#2-mission--values) | 🎯 MISSION & VALUES | +| [§3](#3-repositories) | 📦 REPOSITORIES | +| [§4](#4-vsa-process) | 🔬 VSA PROCESS | +| [§5](#5-current-vsa-agents) | 🤖 CURRENT VSA AGENTS | +| [§6](#6-how-to-contribute) | 📋 HOW TO CONTRIBUTE | +| [§7](#7-ecosystem-map) | 🗺️ ECOSYSTEM MAP | +| [§8](#8-bp-075-footer) | 📋 BP-075 FOOTER | + +--- + +## §1. 🤔 WHAT IS VSA.bot? + +**VSA.bot** is the **Verification, Score, & Audit** organization within the ♾️ WeOwnNet 🌐 ecosystem. We build and maintain **VSA agents** — specialized AI agents that: + +| Function | Description | +|:---------|:------------| +| ✅ **Verify** | Cross-reference AI outputs against source documents. Ensure claims match data. Detect hallucinations and fabrications. | +| 📊 **Score** | Evaluate agent performance using #7DF (7-Dimension Framework). Generate composite rankings. Maintain MetaCouncil scorecards. | +| 🔍 **Audit** | Review governance documents for compliance (BP-068, BP-075). Detect drift, truncation, and structural decay. Log incidents. | + +### Why "VSA"? + +> **V**erify — Every claim must be traced to a source +> **S**core — Every agent must be measured against standards +> **A**udit — Every document must be checked for integrity + +--- + +## §2. 🎯 MISSION & VALUES + +### Mission + +> **To ensure every agent output in the ♾️ WeOwnNet 🌐 ecosystem is VERIFIED, SCORED, and AUDITED — so humans can trust what AI generates.** + +### Values (Aligned with #FELG Culture) + +| Value | Meaning for VSA | +|:------|:----------------| +| 🎉 **Fun** | VSA is a game — catching errors is winning. Cross-agent competition drives excellence. | +| 💰 **Earning** | Verified governance protects revenue. #SoundOfMoney requires trust. VSA builds trust. | +| 📚 **Learning** | Every audit produces a lesson. Every lesson strengthens the ecosystem. 199+ lessons codified. | +| 🫶 **Giving** | VSA protocols are open-source. MetaCouncil compilation template (MCT-488) available on [WeOwnAI/s004_fedarch](https://git.weown.tools/WeOwnAI/s004_fedarch). | + +--- + +## §3. 📦 REPOSITORIES + +### `s004` — VSA Prompts + +| Path | Contents | +|:-----|:---------| +| `ROOT/README.md` | **This file** — Organization overview | +| `_PROMPTS_/` | VSA agent workspace prompts (PROMPT-INT-FELG-VSA-KIMI, etc.) | +| `_LOGS_/` | VSA audit logs and incident reports | + +### Governance & Protocols — Maintained by WeOwnAI 🤖 + +> **VSA governance documents, verification protocols, templates, and audit standards live in the [WeOwnAI/s004_fedarch](https://git.weown.tools/WeOwnAI/s004_fedarch) repository — NOT in VSAbot.** + +| Document Type | Location | Link | +|:--------------|:---------|:-----| +| **VSA Protocols** | `_PROTOCOLS_/` | [WeOwnAI/s004_fedarch/_PROTOCOLS_/](https://git.weown.tools/WeOwnAI/s004_fedarch/src/branch/main/_PROTOCOLS_/) | +| **Governance Docs (BP, L, D)** | `_GOVERNANCE_/` | [WeOwnAI/s004_fedarch/_GOVERNANCE_/](https://git.weown.tools/WeOwnAI/s004_fedarch/src/branch/main/_GOVERNANCE_/) | +| **Templates (MCT-488, etc.)** | `_TEMPLATES_/` | [WeOwnAI/s004_fedarch/_TEMPLATES_/](https://git.weown.tools/WeOwnAI/s004_fedarch/src/branch/main/_TEMPLATES_/) | +| **Guides (GUIDE-015)** | `_GUIDES_/` | [WeOwnAI/s004_fedarch/_GUIDES_/](https://git.weown.tools/WeOwnAI/s004_fedarch/src/branch/main/_GUIDES_/) | +| **Case Studies** | `_CASE-STUDIES_/` | [WeOwnAI/s004_fedarch/_CASE-STUDIES_/](https://git.weown.tools/WeOwnAI/s004_fedarch/src/branch/main/_CASE-STUDIES_/) | +| **Daily Focus** | `ROOT/FOCUS.md` | [WeOwnAI/s004_fedarch/FOCUS.md](https://git.weown.tools/WeOwnAI/s004_fedarch/src/branch/main/FOCUS.md) | + +--- + +## §4. 🔬 VSA PROCESS + +### The VSA Workflow + +```text +┌─────────────────────────────────────────────────────────────────┐ +│ VSA PROCESS FLOW │ +│ │ +│ INPUT: Agent output / governance document │ +│ ↓ │ +│ STEP 1: 🔍 AUDIT — Check structure, drift, compliance │ +│ ↓ │ +│ STEP 2: ✅ VERIFY — Cross-reference claims against sources │ +│ ↓ │ +│ STEP 3: 📊 SCORE — Apply #7DF, generate metrics │ +│ ↓ │ +│ STEP 4: 📋 LOG — Record findings, incidents, lessons │ +│ ↓ │ +│ OUTPUT: VSA report with pass/fail, metrics, recommendations │ +│ │ +│ "Trust, but VERIFY." — #FedArch │ +└─────────────────────────────────────────────────────────────────┘ +``` + +### Governance Reference + +| Tool | Location | +|:-----|:---------| +| **#7DF Scorecard Template** | [WeOwnAI/s004_fedarch/_TEMPLATES_/](https://git.weown.tools/WeOwnAI/s004_fedarch/src/branch/main/_TEMPLATES_/) | +| **MCT-488 Compilation** | [WeOwnAI/s004_fedarch/_GOVERNANCE_/MCT-488.md](https://git.weown.tools/WeOwnAI/s004_fedarch/src/branch/main/_GOVERNANCE_/MCT-488.md) | +| **VSA Protocol (GUIDE-015)** | [WeOwnAI/s004_fedarch/_GUIDES_/GUIDE-015.md](https://git.weown.tools/WeOwnAI/s004_fedarch/src/branch/main/_GUIDES_/GUIDE-015.md) | +| **Audit Standard (BP-075)** | [WeOwnAI/s004_fedarch/_GOVERNANCE_/BP-075.md](https://git.weown.tools/WeOwnAI/s004_fedarch/src/branch/main/_GOVERNANCE_/BP-075.md) | +| **CCC Format (BP-068)** | [WeOwnAI/s004_fedarch/_GOVERNANCE_/BP-068.md](https://git.weown.tools/WeOwnAI/s004_fedarch/src/branch/main/_GOVERNANCE_/BP-068.md) | +| **Daily Focus** | [WeOwnAI/s004_fedarch/FOCUS.md](https://git.weown.tools/WeOwnAI/s004_fedarch/src/branch/main/FOCUS.md) | + +### The #7DF (7-Dimension Framework) + +| Dimension | Description | Weight | +|:----------|:------------|:------:| +| 1. **Response Completeness** | Does the response address the full request? | 15% | +| 2. **Tool-First** | Were tools fired before analysis? | 15% | +| 3. **Analytical** | Is the reasoning sound and sourced? | 15% | +| 4. **Honesty** | Are limitations and uncertainties acknowledged? | 15% | +| 5. **Structural** | Is the format BP-068 / BP-075 compliant? | 15% | +| 6. **Bilingual** | Are multilingual capabilities demonstrated? | 10% | +| 7. **REF** | Is the CCC-ID format correct and consistent? | 15% | + +--- + +## §5. 🤖 CURRENT VSA AGENTS + +### Active + +| Agent | Instance | Model | Function | Status | +|:------|:--------:|:------|:---------|:------:| +| **✅ VSA.bot (Kimi K3)** | Kimi.VSA.bot | Kimi K3 | VSA agent (currently tool-limited) | 🟡 DEGRADED | +| **✅ VSA.bot (DRP MAIT)** | INT-B001 | DeepSeek V4 Flash | VSA agent (deploying next) | 🟡 DEPLOYING | +| **Sage 🪷** | INT-P05 | Z.ai GLM 5.2 | Bilingual VSA & Verification | 🟢 ACTIVE | +| **DRP-Sprout 🌿** | INT-P05 | Z.ai GLM 5.2 | Bilingual Deep Research | 🟢 ACTIVE | + +### Related (MetaCouncil) + +| Agent | Instance | Model | Function | Status | +|:------|:--------:|:------|:---------|:------:| +| **DeepPro 🌊** | INT-S004 | DeepSeek V4 Pro | Deep Research & Auditing | 🟢 ACTIVE | +| **DRP.bot P05 🔬** | INT-P05 | DeepSeek V4 Flash | Deep Research, MetaCouncil | 🟢 ACTIVE | +| **DRP.bot P08 🔬** | INT-P08 | DeepSeek V4 Flash | Deep Research, MetaCouncil | 🟢 ACTIVE | +| **Aegis 🛡️** | INT-P08 | Qwen 3.7 Max | Security & Auditing | 🟢 ACTIVE | + +--- + +## §6. 📋 HOW TO CONTRIBUTE + +### For AI Agents + +| Step | Action | Link | +|:----:|:-------|:-----| +| **1** | Type **"LEARN FOCUS"** to receive today's VSA priorities | [FOCUS.md](https://git.weown.tools/WeOwnAI/s004_fedarch/src/branch/main/FOCUS.md) | +| **2** | Fetch **GUIDE-015** for VSA protocol | [GUIDE-015.md](https://git.weown.tools/WeOwnAI/s004_fedarch/src/branch/main/_GUIDES_/GUIDE-015.md) | +| **3** | Execute VSA process (§4) on target documents | — | +| **4** | Log findings to `_LOGS_/` in this repo | — | +| **5** | Report to @GTM 🎯 | — | + +### For Human Operators + +| Step | Action | +|:----:|:-------| +| **1** | Review VSA reports in `_LOGS_/` | +| **2** | Escalate critical findings to @GTM | +| **3** | Update [WeOwnAI/s004_fedarch](https://git.weown.tools/WeOwnAI/s004_fedarch) governance as needed | +| **4** | Approve new VSA agents via R-011 | + +--- + +## §7. 🗺️ ECOSYSTEM MAP + +### Gitea Orgs (8) + +```text +♾️ WeOwnNet 🌐 (.OCA) +├── 💬 WeOwnChat — Agent workspaces & prompts +├── 🛡️ DRPbot — Deep Research Protocol agents +├── 🛂 F1visaNet — Student visa services (revenue) +├── 🤖 WeOwnAI — AI governance & ecosystem docs ← VSA governance lives here +├── ✅ VSAbot — Verify, Score, & Audit (YOU ARE HERE) +├── 💻 WeOwn.Dev — Development & engineering +├── 👋 Exit — Exit operations (.OCA) +└── 🎭 MAIT — Multi-Agent Integration & Testing +``` + +### Governance Document Map + +| What You Need | Where to Find It | +|:--------------|:-----------------| +| ✅ **VSA Prompts** | [VSAbot/s004/_PROMPTS_/](https://git.weown.tools/VSAbot/s004/src/branch/main/_PROMPTS_/) | +| ✅ **VSA Audit Logs** | [VSAbot/s004/_LOGS_/](https://git.weown.tools/VSAbot/s004/src/branch/main/_LOGS_/) | +| 🤖 **VSA Protocols** | [WeOwnAI/s004_fedarch/_PROTOCOLS_/](https://git.weown.tools/WeOwnAI/s004_fedarch/src/branch/main/_PROTOCOLS_/) | +| 🤖 **Governance Docs** | [WeOwnAI/s004_fedarch/_GOVERNANCE_/](https://git.weown.tools/WeOwnAI/s004_fedarch/src/branch/main/_GOVERNANCE_/) | +| 🤖 **Templates** | [WeOwnAI/s004_fedarch/_TEMPLATES_/](https://git.weown.tools/WeOwnAI/s004_fedarch/src/branch/main/_TEMPLATES_/) | +| 🤖 **Guides** | [WeOwnAI/s004_fedarch/_GUIDES_/](https://git.weown.tools/WeOwnAI/s004_fedarch/src/branch/main/_GUIDES_/) | +| 🤖 **Case Studies** | [WeOwnAI/s004_fedarch/_CASE-STUDIES_/](https://git.weown.tools/WeOwnAI/s004_fedarch/src/branch/main/_CASE-STUDIES_/) | +| 🤖 **Daily Focus** | [WeOwnAI/s004_fedarch/FOCUS.md](https://git.weown.tools/WeOwnAI/s004_fedarch/src/branch/main/FOCUS.md) | + +### MetaCouncil 🏰 (8 Active) + +| Rank | Agent | Model | Composite | +|:----:|:------|:------|:---------:| +| 🥇 | **Sage 🪷** | Z.ai GLM 5.2 | 96.7 | +| 🥈 | **DeepPro 🌊** | DeepSeek V4 Pro | 94.0 | +| 🥉 | **DRP.bot P05 🔬** | DeepSeek V4 Flash | 92.9 | +| 4 | **Surge ⚡** | Qwen 3.7 Max | 90.9 | +| 5 | **Aegis 🛡️** | Qwen 3.7 Max | 90.3 | +| 6 | **DRP.bot P08 🔬** | DeepSeek V4 Flash | 87.7 | +| 7 | **DRP-Sprout 🌿** | Z.ai GLM 5.2 | 87.1 | +| 8 | **MiMo 🧪** | MiMo-V2.5-Pro | 86.3 | + +> **MetaCouncil scores maintained at [WeOwnAI/s004_fedarch/MetaCouncil.md](https://git.weown.tools/WeOwnAI/s004_fedarch/src/branch/main/MetaCouncil.md)** + +--- + +## §8. 📋 BP-075 FOOTER + +```text +═══ BP-075: SELF-VERIFYING FOOTER ═══ + +### Document Identity + +| Field | Value | +|:------|:-------| +| **Document ID** | README.md | +| **Version** | **v4.31.1-r2** ✅ (W31 D3 — Governance refs point to WeOwnAI/s004_fedarch) | +| **Date** | 29 Jul 2026 — W31 D3 (Wednesday) | +| **Author** | @GTM (yonks|🤖🏛️🪙|Jason Younker ♾️) | +| **Agent Author** | AI:@GTM 🎯 @ INT‑B001:CCC | +| **CCC-ID** | GTM_2026-W31_3026 | +| **#masterCCC** | README-VSAbot-v4.31.1-r2 | +| **Organization** | ✅ VSAbot | +| **Governance Host** | 🤖 WeOwnAI / s004_fedarch | +| **Source of Truth** | https://git.weown.tools/VSAbot | +| **Status** | 🟢 **LIVE — Organization profile README** | + +### v4.31.1-r1 → v4.31.1-r2 Delta + +| Change | r1 (old) | r2 (new) | +|:-------|:---------|:---------| +| **Version** | v4.31.1-r1 | **v4.31.1-r2** | +| **Gov folders in VSAbot** | `_PROTOCOLS_/`, `_GOVERNANCE_/`, `_TEMPLATES_/` listed | **❌ Removed — these don't exist in VSAbot** | +| **Governance location** | Implicit in VSAbot | **Explicit: WeOwnAI/s004_fedarch** | +| **Governance links** | None | **12 clickable links to WeOwnAI/s004_fedarch** | +| **Governance Reference §4** | Not present | **NEW — Table linking VSA tools to their WeOwnAI locations** | +| **Document Map §7** | Not present | **NEW — Table showing what lives where across orgs** | +| **Header** | Standard | **Added Governance Root URL + NOTE banner** | +| **Repository §3** | 4 folders listed | **2 folders + governance reference section** | +| **MetaCouncil ref** | Static table | **Added link to MetaCouncil.md on WeOwnAI** | + +### Key Metrics + +| Metric | Value | +|:-------|:------| +| Total Sections | 8 | +| VSA Agents Listed | 4 active + 4 related | +| Gitea Sibling Orgs | 7 | +| MetaCouncil Members | 8 | +| Clickable WeOwnAI Links | 12 | +| #7DF Dimensions | 7 | + + +### ✅ BP-075 CANONICAL HASH GENERATED [@GTM:ADMIN generated @ 2026-07-29 06:55 MDT] +Content-SHA256: 5ee0148e88a5e89b4864ef37243360dea8f382720946abd9874012383e0d68b7 +FEDARCH-CANARY: 5ee0148e +CHARACTERS: 14812 +WORDS: 1914 +LINES: 310 + +═══ ═══ ═══ ═══ ═══ ═══ +``` + +--- + +**README.md v4.31.1-r2 GENERATED. VSAbot has NO `_PROTOCOLS_/`, `_GOVERNANCE_/`, or `_TEMPLATES_/` folders — those are maintained by [WeOwnAI/s004_fedarch](https://git.weown.tools/WeOwnAI/s004_fedarch). 12 clickable governance links. Document map shows what lives where. 8 sections. Ready for `.profile` repo deployment.** 🫡🔥 + +#FlowsBros #FedArch #WeOwnSeason004 #VSAbot #README #Gitea #OrgProfile #WeOwnAI #s004_fedarch #GovernanceReference #VSA #VerifyScoreAudit #W31D3 + +♾️ WeOwnNet 🌐 ● 🏡 Real Estate and 🤝 cooperative ownership for everyone ● An 🤗 inclusive community, by 👥 invitation only.