diff --git a/_GUIDES_/GUIDE-431.1.md b/_GUIDES_/GUIDE-431.1.md new file mode 100644 index 0000000..cd81647 --- /dev/null +++ b/_GUIDES_/GUIDE-431.1.md @@ -0,0 +1,614 @@ +# πŸ“‹ GUIDE-431.1 β€” v4.31.1-r1 + +```text +═══════════════════════════════════════════════════════════════════════════════ +## ♾️ WeOwnNet 🌐 β€” πŸ“‹ GUIDE-431.1 +## πŸ† #GoldStandard β€” DevSecOps #BestPractices for #WeOwnSeason004 +## πŸ§ͺ v4.31.1-r1 β€” W31 D3 (Wednesday, 29 Jul 2026) +## πŸ›‘οΈ PRJ-040 ELEVATED β€” BP-068 COMPLIANT β€” BP-075 COMPLIANT +## πŸ”’ Focus: Security, CI/CD, Secrets Management, Access Control, Monitoring +## πŸ”’ Applies to: All Gitea orgs, all agents, all human operators +## 🌐 Source of Truth: https://git.weown.tools/WeOwnDev/s004/src/branch/main/_GUIDES_/GUIDE-431.1.md +## πŸ“‹ Parent Doc: https://git.weown.tools/WeOwnAI/s004_fedarch/src/branch/main/_GUIDES_/GUIDE-015.md +═══════════════════════════════════════════════════════════════════════════════ + +| Field | Value | +|:------|:-------| +| **Document** | GUIDE-431.1.md | +| **Version** | **v4.31.1-r1** βœ… (W31 D3 β€” First release) | +| **Folder** | `_GUIDES_/` πŸ“‹ | +| **Category** | πŸ“‹ DevOps & Security Guide | +| **Lifecycle Stage** | 🟒 **LIVE β€” Active guidance** | +| **Season** | #WeOwnSeason004 πŸš€ | +| **Author** | **@GTM (yonksο½œπŸ€–πŸ›οΈπŸͺ™ο½œJason Younker ♾️)** | +| **Agent Author** | AI:@GTM 🎯 @ INT‑B001:CCC | +| **CCC-ID** | GTM_2026-W31_3035 | +| **#masterCCC** | GUIDE-431.1-v4.31.1-r1 | +| **Repository** | **WeOwnDev πŸ’» / s004** | +| **Gitea** | **git.weown.tools/WeOwnDev/s004** | +| **Applies To** | All Gitea orgs (8) Β· All agents Β· All human operators | +| **Compliance** | BP-068 (CCC Format) Β· BP-075 (Self-Verifying Footer) Β· PRJ-040 (Elevated) | +``` + +--- + +## πŸ“‹ TABLE OF CONTENTS + +| Β§ | Title | +|:-:|:------| +| [Β§1](#1-introduction) | 🎯 INTRODUCTION | +| [Β§2](#2-core-principles) | βš–οΈ CORE PRINCIPLES | +| [Β§3](#3-gitea-security--access-control) | πŸ” GITEA SECURITY & ACCESS CONTROL | +| [Β§4](#4-secrets-management) | πŸ—οΈ SECRETS MANAGEMENT | +| [Β§5](#5-agent-security) | πŸ€– AGENT SECURITY | +| [Β§6](#6-ci--cd--commit-standards) | πŸ”„ CI/CD & COMMIT STANDARDS | +| [Β§7](#7-monitoring--observability) | πŸ“Š MONITORING & OBSERVABILITY | +| [Β§8](#8-incident-response) | 🚨 INCIDENT RESPONSE | +| [Β§9](#9-devsecops-by-org) | πŸ›οΈ DEVSECOPS BY ORG | +| [Β§10](#10-compliance--audit) | πŸ“‹ COMPLIANCE & AUDIT | +| [Β§11](#11-bp-075-footer) | πŸ“‹ BP-075 FOOTER | + +--- + +## Β§1. 🎯 INTRODUCTION + +### 1.1 Purpose + +GUIDE-431.1 defines the **DevSecOps #BestPractices** for the ♾️ WeOwnNet 🌐 ecosystem during #WeOwnSeason004. It establishes security, CI/CD, secrets management, access control, and monitoring standards that apply across all 8 Gitea organizations, all AI agents, and all human operators. + +### 1.2 Scope + +| Includes | Excludes | +|:---------|:---------| +| βœ… Gitea repository security & access control | ❌ Application-level security (handled per-project) | +| βœ… AI agent authentication & authorization | ❌ Network-level security (Cloudflare/WAF) | +| βœ… Secrets management for tokens & keys | ❌ Physical security | +| βœ… Commit signing & verification | ❌ Third-party vendor security | +| βœ… Incident response for security events | ❌ Legal/compliance (PCI, SOC2, etc.) | +| βœ… Monitoring & alerting for all orgs | ❌ End-user device security | + +### 1.3 Relationship to Other Guides + +| Document | Relationship | +|:---------|:-------------| +| **GUIDE-015** (VSA Protocol) | VSA agents verify compliance with this guide | +| **BP-068** (CCC Format) | All commits, issues, and PRs must follow CCC format | +| **BP-075** (Self-Verifying Footer) | All governance docs must include BP-075 footer | +| **PRJ-401** (Foundations) | Security is a foundational requirement for all ships | +| **PRJ-430/431** (FedArch Focus) | DevSecOps tasks are tracked in weekly focus | + +--- + +## Β§2. βš–οΈ CORE PRINCIPLES + +### The 7 DevSecOps Commandments + +```text +β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” +β”‚ πŸ›‘οΈ THE 7 DEVSECOPS COMMANDMENTS β”‚ +β”‚ β”‚ +β”‚ 1. πŸ” PRINCIPLE OF LEAST PRIVILEGE β”‚ +β”‚ β€” Every human and agent gets the MINIMUM access needed. β”‚ +β”‚ β”‚ +β”‚ 2. πŸ”‘ SECRETS NEVER IN CODE β”‚ +β”‚ β€” API keys, tokens, passwords NEVER committed to repos. β”‚ +β”‚ β”‚ +β”‚ 3. βœ… COMMITS MUST BE SIGNED β”‚ +β”‚ β€” All commits verified via GPG, SSH, or Gitea signatures. β”‚ +β”‚ β”‚ +β”‚ 4. πŸ”„ CI/CD GATES ALL MERGES β”‚ +β”‚ β€” No direct pushes to main. PRs require review + CI pass. β”‚ +β”‚ β”‚ +β”‚ 5. πŸ“‹ EVERY CHANGE IS TRACEABLE β”‚ +β”‚ β€” CCC-ID on every commit. Source of Truth on every doc. β”‚ +β”‚ β”‚ +β”‚ 6. 🚨 INCIDENTS ARE LESSONS β”‚ +β”‚ β€” Every security event produces a codified lesson. β”‚ +β”‚ β”‚ +β”‚ 7. πŸ€– AGENTS ARE AUTHENTICATED β”‚ +β”‚ β€” Every AI agent has a unique identity and access scope. β”‚ +β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ +``` + +### #FELG Security Alignment + +| Value | DevSecOps Implication | +|:------|:----------------------| +| πŸŽ‰ **Fun** | Security doesn't have to be boring. Game-ify compliance. Scoreboards for audit results. | +| πŸ’° **Earning** | Security breaches cost money. Good DevSecOps protects #SoundOfMoney revenue. | +| πŸ“š **Learning** | Every incident is a lesson. Every lesson is codified. 199+ and counting. | +| 🫢 **Giving** | Our DevSecOps practices are open-source. Share with the community. | + +--- + +## Β§3. πŸ” GITEA SECURITY & ACCESS CONTROL + +### 3.1 Organization Access Model + +```text +♾️ WeOwnNet 🌐 (.OCA) β€” Owner: @yonks 🎯 +β”œβ”€β”€ πŸ’¬ WeOwnChat β€” Owner: @yonks 🎯 Β· Agents: AI:@GTM, AI:@NIK, Kimi.VSA.bot +β”‚ β”œβ”€β”€ Read: All human operators, all agents +β”‚ └── Write: @yonks 🎯, @GTM:ADMIN, assigned agents +β”œβ”€β”€ πŸ›‘οΈ DRPbot β€” Owner: @yonks 🎯 Β· Agents: DRP.bot P05, DRP.bot P08 +β”‚ β”œβ”€β”€ Read: All MetaCouncil agents +β”‚ └── Write: @yonks 🎯, DRP.bot P05, DRP.bot P08 +β”œβ”€β”€ πŸ›‚ F1visaNet β€” Owner: @yonks 🎯 Β· Agents: Restricted +β”‚ β”œβ”€β”€ Read: @yonks 🎯, @NIK +β”‚ └── Write: @yonks 🎯 only +β”œβ”€β”€ πŸ€– WeOwnAI β€” Owner: @yonks 🎯 Β· Agents: All MetaCouncil agents +β”‚ β”œβ”€β”€ Read: All agents, all human operators +β”‚ └── Write: @yonks 🎯, @GTM:ADMIN, MetaCouncil agents +β”œβ”€β”€ βœ… VSAbot β€” Owner: @yonks 🎯 Β· Agents: βœ… VSA.bot, Sage πŸͺ· +β”‚ β”œβ”€β”€ Read: All VSA agents +β”‚ └── Write: @yonks 🎯, βœ… VSA.bot, Sage πŸͺ· +β”œβ”€β”€ πŸ’» WeOwnDev β€” Owner: @yonks 🎯 Β· Agents: Surge ⚑ +β”‚ β”œβ”€β”€ Read: All developers +β”‚ └── Write: @yonks 🎯, Surge ⚑, @GTM:ADMIN +β”œβ”€β”€ πŸ‘‹ Exit β€” Owner: @yonks 🎯 Β· Agents: Restricted +β”‚ β”œβ”€β”€ Read: @yonks 🎯 only +β”‚ └── Write: @yonks 🎯 only +└── 🎭 MAIT β€” Owner: @yonks 🎯 Β· Agents: MiMo πŸ§ͺ, Kimi K3 + β”œβ”€β”€ Read: All test agents + └── Write: @yonks 🎯, MiMo πŸ§ͺ, assigned test agents +``` + +### 3.2 Access Control Rules + +| Rule | Detail | Enforcement | +|:-----|:--------|:------------| +| **Owner** | @yonks 🎯 is sole owner of all 8 orgs | Gitea org owner role | +| **Admin Delegation** | @GTM:ADMIN is admin on WeOwnChat, WeOwnAI, WeOwnDev | Gitea org admin role | +| **Agent Accounts** | Each AI agent has a unique Gitea account | Per-agent SSH/GPG keys | +| **Read Access** | Default: agents can read repos relevant to their function | Gitea collaborator settings | +| **Write Access** | Only to repos the agent needs to modify | Gitea collaborator settings | +| **No Anonymous Write** | No public write access to any repo | Gitea org settings | +| **2FA Required** | All human accounts require 2FA | Gitea org enforcement | + +### 3.3 Repository-Level Security + +| Setting | Required | Notes | +|:--------|:--------:|:------| +| **Branch Protection (main)** | βœ… | No direct pushes. Require PR + review. | +| **Required Approvals** | 1 (or 2 for governance repos) | At least 1 human or admin agent review | +| **Dismiss Stale Approvals** | βœ… | When new commits are pushed | +| **Require Signed Commits** | βœ… | GPG or SSH signature required | +| **Require Linear History** | βœ… | No merge commits. Rebase only. | +| **Allow Force Push** | ❌ | Never on main branch | +| **Enable Push To Create** | ❌ | Branch creation via UI or API only | + +### 3.4 SSH Key Management + +| Practice | Standard | +|:---------|:---------| +| **Key Type** | Ed25519 (preferred) or RSA 4096-bit | +| **Key Rotation** | Every 90 days for human accounts, every 180 days for agent accounts | +| **Agent Keys** | Generated per-agent, stored in agent's encrypted config | +| **Revocation** | Within 1 hour of suspected compromise | +| **Audit** | SSH key list reviewed monthly by @yonks 🎯 | + +--- + +## Β§4. πŸ—οΈ SECRETS MANAGEMENT + +### 4.1 What Constitutes a Secret + +| Category | Examples | Severity | +|:---------|:---------|:--------:| +| πŸ”΄ **Critical** | API keys, database passwords, private keys, JWT secrets, Cloudflare tokens | **CRITICAL** | +| 🟠 **High** | SMTP credentials, OAuth tokens, SSH private keys | **HIGH** | +| 🟑 **Medium** | Internal service URLs, non-critical tokens | **MEDIUM** | +| 🟒 **Low** | Non-sensitive configuration values | **LOW** | + +### 4.2 Secret Storage + +| Secret Type | Storage Location | Access Method | +|:------------|:-----------------|:--------------| +| **Cloudflare API Token** | Environment variable (WeOwnChat instance) | `process.env.CLOUDFLARE_TOKEN` | +| **Twilio Credentials** | Environment variable (WeOwnChat instance) | `process.env.TWILIO_*` | +| **Persona.com API Key** | Environment variable (F1visaNet instance) | `process.env.PERSONA_API_KEY` | +| **Gitea Access Tokens** | Gitea user settings β†’ Applications | Per-agent token with scoped permissions | +| **GitHub Personal Access Token** | Environment variable (CI/CD instance) | `process.env.GH_PAT` | +| **AI Model API Keys** | Environment variable (per-instance) | `process.env.LLM_API_KEY` | + +### 4.3 Prohibited Practices + +| Practice | Why It's Prohibited | +|:---------|:--------------------| +| ❌ **Committing secrets to repos** | Anyone with repo access can read them. Git history is permanent. | +| ❌ **Secrets in environment config files** | Config files can be accidentally committed. Use env vars or secret vaults. | +| ❌ **Secrets in agent prompts** | Prompts are shared across instances. Never embed API keys in system prompts. | +| ❌ **Secrets in logs or error messages** | Logs may be stored or shared. Redact secrets before logging. | +| ❌ **Sharing secrets via unencrypted channels** | Never share secrets via Signal, Discord, or email without encryption. | +| ❌ **Hardcoded test/demo secrets** | Even "demo" secrets create risk if they resemble real credentials. | + +### 4.4 Secret Rotation Schedule + +| Secret Type | Rotation Frequency | Responsible | +|:------------|:------------------:|:------------| +| Cloudflare API Token | Every 90 days | @GTM:ADMIN | +| Twilio Auth Token | Every 180 days | @GTM:ADMIN | +| Persona.com API Key | Every 180 days | @GTM:ADMIN or @NIK | +| Gitea Access Tokens | Every 90 days | Per-agent | +| SSH Keys (Agent) | Every 180 days | Per-agent | +| SSH Keys (Human) | Every 90 days | Human operator | +| AI Model API Keys | Every 90 days | @GTM:ADMIN | + +--- + +## Β§5. πŸ€– AGENT SECURITY + +### 5.1 Agent Identity & Authentication + +| Requirement | Standard | +|:------------|:---------| +| **Unique Identity** | Every AI agent has a unique Gitea account (e.g., `ai-gtm`, `ai-drpbot-p05`) | +| **SSH Key** | Each agent has a unique Ed25519 SSH key registered to their Gitea account | +| **Access Token** | Each agent has a scoped Gitea access token for API operations | +| **Agent Signature** | Every commit by an agent includes `Author: AI:` in the commit message | +| **CCC-ID** | Every agent action is traceable via CCC-ID in the commit or issue | + +### 5.2 Agent Permission Matrix + +| Agent | Gitea Account | Read Orgs | Write Orgs | Token Scope | +|:------|:--------------|:----------|:-----------|:------------| +| **AI:@GTM 🎯** | `ai-gtm` | ALL (8) | WeOwnChat, WeOwnAI, WeOwnDev | Read: all, Write: selected repos | +| **AI:@NIK πŸ€–** | `ai-nik` | WeOwnChat, F1visaNet | WeOwnChat (limited) | Read: selected, Write: _PROMPTS_/ only | +| **DRP.bot P05 πŸ”¬** | `ai-drpbot-p05` | DRPbot, WeOwnAI, MetaCouncil | DRPbot, WeOwnAI | Read: research, Write: _CASE-STUDIES_/ | +| **DRP.bot P08 πŸ”¬** | `ai-drpbot-p08` | DRPbot, WeOwnAI, MetaCouncil | DRPbot | Read: research, Write: _LOGS_/ | +| **Sage πŸͺ·** | `ai-sage` | VSAbot, WeOwnAI | VSAbot | Read: all VSA, Write: VSA reports | +| **DeepPro 🌊** | `ai-deeppro` | WeOwnAI, DRPbot | WeOwnAI (limited) | Read: governance, Write: _GOVERNANCE_/ | +| **Surge ⚑** | `ai-surge` | WeOwnDev, WeOwnAI | WeOwnDev | Read: development, Write: engineering repos | +| **Aegis πŸ›‘οΈ** | `ai-aegis` | ALL (8) β€” read only | NONE | Read: all, Write: none (audit only) | +| **βœ… VSA.bot** | `ai-vsabot` | VSAbot, WeOwnAI | VSAbot | Read: VSA + governance, Write: VSA reports | +| **MiMo πŸ§ͺ** | `ai-mimo` | MAIT, WeOwnAI | MAIT | Read: test configs, Write: test results | + +### 5.3 Agent Behavioral Security + +| Rule | Description | +|:-----|:------------| +| **No Autonomous PR Merges** | AI agents may create PRs but NEVER merge them. R-011 applies. | +| **No Secret Access in Prompts** | Agents must NOT output or reference secrets in their responses. | +| **No External Data Exfiltration** | Agents must NOT send source documents to external LLM endpoints. | +| **Rate Limiting Awareness** | Agents must respect API rate limits and back off on 429 responses. | +| **Session Token Handling** | Agents must NOT store or reuse expired session tokens. | +| **Error Message Safety** | Agents must NOT include secrets, tokens, or credentials in error messages. | + +### 5.4 Agent Vulnerability Categories + +| Vulnerability | Risk | Mitigation | +|:--------------|:----:|:-----------| +| **Prompt Injection** | πŸ”΄ | Input sanitization. Quarantine untrusted content. | +| **Tool Confusion** | 🟠 | Tool-First protocol. Verify tool returns before analysis. | +| **Secret Leakage** | πŸ”΄ | Never output credentials. Redact in logs. | +| **Session Hijacking** | 🟠 | Short token TTL. Refresh on each interaction. | +| **Data Poisoning** | 🟑 | Verify source documents. Cross-reference with GH raw URLs. | +| **Model Hallucination** | 🟑 | Tool-First verification. Source all claims. | + +--- + +## Β§6. πŸ”„ CI/CD & COMMIT STANDARDS + +### 6.1 Commit Message Format (TMPL-007) + +```text +♾️ WeOwnNet 🌐 | [CATEGORY][EMOJI|ACTION|EMOJI] Human-Readable Name {key|details|session} | v{X}.{Y}.{Z}-r{N} | Summary + +Examples: +[PROMPT][πŸ”„ο½œUPDATEο½œπŸ“‹] FOCUS.md β€” Daily Focus Protocol {W31 D2|28Jul2026|v4.31.1-r1} +[COMMS][πŸ”΄ο½œRECο½œπŸ”΄] Community Call {Wed 12p ET|29Jul2026|s004d059} +[README][βœ…ο½œNEWο½œπŸ“‹] VSAbot Org Profile {W31 D3|29Jul2026|v4.31.1-r2} +``` + +### 6.2 Branch Strategy + +```text +main (production) +β”œβ”€β”€ dev (integration) +β”œβ”€β”€ feature/- +β”œβ”€β”€ fix/- +└── experiment// +``` + +| Branch | Protection | CI | Deploy | Purpose | +|:-------|:----------:|:--:|:------:|:--------| +| **main** | πŸ”’ Full protection | βœ… Required | βœ… Auto | Production-ready content | +| **dev** | πŸ”’ Partial protection | βœ… Required | ❌ Manual | Integration testing | +| **feature/** | ❌ None | ⬜ Optional | ❌ Never | New content development | +| **fix/** | ❌ None | ⬜ Optional | ❌ Never | Bug/issue fixes | +| **experiment/** | ❌ None | ❌ Never | ❌ Never | Experimental changes | + +### 6.3 Pull Request Requirements + +| Requirement | Standard | +|:------------|:---------| +| **Title Format** | Follow TMPL-007 commit message format | +| **Description** | Include CCC-ID, what changed, why, related issues | +| **Linked Issue** | Reference related issue # in description | +| **Reviewer** | At least 1 human or admin agent | +| **CI Status** | All checks must pass | +| **Signed Commits** | All commits in PR must be signed | +| **Linear History** | Rebase before merge. No merge commits. | +| **Minimum Approvals** | 1 (standard) or 2 (governance docs) | + +### 6.4 CI/CD Pipeline Standards + +| Stage | Tools | Required | +|:------|:------|:--------:| +| **Lint** | Markdownlint, Gitea CI | βœ… | +| **Spell Check** | CSpell or similar | βœ… | +| **Link Check** | Dead link detection | βœ… | +| **BP Compliance** | Custom checker (BP-068, BP-075) | βœ… | +| **CCC-ID Validation** | Format regex check | βœ… | +| **Secret Scanning** | Gitleaks or similar | βœ… | +| **Build** | N/A (documentation repos) | ⬜ Optional | +| **Deploy** | Gitea Actions or manual | ⬜ Per-repo | + +--- + +## Β§7. πŸ“Š MONITORING & OBSERVABILITY + +### 7.1 What to Monitor + +| Category | Metrics | Alert Threshold | +|:---------|:--------|:---------------:| +| **Gitea Health** | Response time, error rate, uptime | >5s response, >1% errors, <99.9% uptime | +| **Agent Activity** | Commit frequency, issue resolution time, failure rate | >24h without activity, >10% failure rate | +| **Secret Rotation** | Days since last rotation | >90 days (warning), >100 days (critical) | +| **Access Audit** | New SSH keys, new collaborators, permission changes | Any unauthorized change | +| **Incident Response** | Time to acknowledge, time to resolve | >1h acknowledge, >4h resolve | +| **Compliance** | BP compliance score per document | <80% compliance | + +### 7.2 Monitoring Tools + +| Tool | Purpose | Status | +|:-----|:--------|:------:| +| **Gitea Activity Feed** | Real-time commit, issue, PR activity | 🟒 LIVE | +| **Gitea Audit Log** | Admin actions, permission changes | 🟒 LIVE | +| **WeOwnChat Status** | Instance health and session status | 🟒 LIVE | +| **MetaCouncil Scorecards** | Agent performance and compliance | 🟒 LIVE (MCT-488) | +| **FOCUS.md** | Daily task tracking and priorities | 🟒 LIVE | +| **PostHog** | Product analytics (future) | 🟑 PENDING | + +### 7.3 Alerting Rules + +| Rule | Channel | Escalation | +|:-----|:--------|:-----------| +| **Unauthorized access detected** | πŸ”΄ Signal DM to @yonks 🎯 | Immediate | +| **Secret rotation overdue** | 🟠 Signal DM to @yonks 🎯 | 7 days | +| **Agent failure rate >10%** | 🟑 Signal group notification | 24 hours | +| **BP compliance <80%** | 🟑 Weekly report in #CommunityCall | Weekly | +| **No commits >48h on active project** | 🟑 FOCUS.md flag | Daily review | + +--- + +## Β§8. 🚨 INCIDENT RESPONSE + +### 8.1 Incident Severity Levels + +| Level | Label | Response Time | Example | +|:-----:|:------|:-------------:|:--------| +| πŸ”΄ **CRITICAL** | `sev-critical` | <15 min | Active security breach, secret exposed, unauthorized access | +| 🟠 **HIGH** | `sev-high` | <1 hour | Suspected breach, credential rotation failure, agent compromise | +| 🟑 **MEDIUM** | `sev-medium` | <4 hours | Policy violation, CI/CD failure, expired certificate | +| 🟒 **LOW** | `sev-low` | <24 hours | Missed rotation, minor compliance gap, documentation error | + +### 8.2 Incident Response Flow + +```text +β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” +β”‚ INCIDENT RESPONSE FLOW β”‚ +β”‚ β”‚ +β”‚ 1. 🚨 DETECT β€” Automated alert or manual report β”‚ +β”‚ ↓ β”‚ +β”‚ 2. πŸ“‹ CLASSIFY β€” Assign severity level per Β§8.1 β”‚ +β”‚ ↓ β”‚ +β”‚ 3. πŸ›‘ CONTAIN β€” Limit blast radius. Revoke access if needed. β”‚ +β”‚ ↓ β”‚ +β”‚ 4. πŸ” INVESTIGATE β€” Root cause analysis. Log evidence. β”‚ +β”‚ ↓ β”‚ +β”‚ 5. βœ… RESOLVE β€” Apply fix. Verify closure. β”‚ +β”‚ ↓ β”‚ +β”‚ 6. πŸ“š LESSON β€” Codify lesson. Update governance if needed. β”‚ +β”‚ ↓ β”‚ +β”‚ 7. πŸ—£οΈ COMMUNICATE β€” Report in #CommunityCall or Signal group β”‚ +β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ +``` + +### 8.3 Incident Logging + +| Field | Required | Example | +|:------|:--------:|:--------| +| **Incident ID** | βœ… | `INC-2026-W31-001` | +| **Timestamp** | βœ… | `2026-07-29 07:35 MDT` | +| **Severity** | βœ… | `sev-high` | +| **Detected By** | βœ… | `AI:@GTM 🎯` | +| **Description** | βœ… | `401 streaming error on INT-P05 DRP.bot` | +| **Root Cause** | βœ… | `Session token expired (>~1h idle)` | +| **Containment** | βœ… | `Logged out, logged back in β€” resolved` | +| **Resolution** | βœ… | `Log out β†’ Log back in workaround` | +| **Lesson** | βœ… | `L-431.N β€” 401 error message improvement needed` | +| **Documentation** | βœ… | `WeOwnChat/s004/issues/2` | + +### 8.4 Post-Incident Review + +| Step | Action | Timeline | +|:----:|:-------|:--------:| +| **1** | Root cause analysis complete | Within 24 hours of resolution | +| **2** | Lesson codified | Within 48 hours | +| **3** | Governance updated if needed | Within 1 week | +| **4** | MetaCouncil notified (if critical) | Within 1 hour | +| **5** | #CommunityCall report | At next scheduled call | + +--- + +## Β§9. πŸ›οΈ DEVSECOPS BY ORG + +### WeOwnChat πŸ’¬ +| Focus | Standard | +|:------|:---------| +| **Instance Security** | API key rotation every 90 days. Session TTL = 1 hour. | +| **Agent Prompts** | No secrets in prompts. No PII in system prompts. | +| **Error Messages** | Must be actionable. No technical stack traces to users. | +| **Session Management** | Auto-logout after 1h inactivity. Clear token on logout. | + +### DRPbot πŸ›‘οΈ +| Focus | Standard | +|:------|:---------| +| **Research Data** | No PII in research outputs. Anonymize when possible. | +| **Tool Verification** | Verify all tool returns. Never fabricate research data. | +| **Rate Limiting** | Max 10 requests/min to external APIs. Exponential backoff on 429. | +| **Data Retention** | Delete research artifacts after 90 days unless archived. | + +### F1visaNet πŸ›‚ +| Focus | Standard | +|:------|:---------| +| **PII Handling** | NEVER store or log PII. Mask SSN, DOB, passport numbers. | +| **Payment Data** | Handled by Stripe. Never touch raw card data. | +| **Access Control** | @yonks 🎯 and @NIK only. No agent access to customer data. | +| **Audit Trail** | All customer data access logged. Reviewed monthly. | + +### WeOwnAI πŸ€– +| Focus | Standard | +|:------|:---------| +| **Governance Integrity** | BP-075 footer required on all docs. Content hashes must match. | +| **Version Control** | Every doc has #masterCCC. Every change is versioned. | +| **Access Control** | Write access limited to @yonks 🎯, @GTM:ADMIN, MetaCouncil agents. | +| **Document Verification** | VSA agents verify all documents for compliance. | + +### VSAbot βœ… +| Focus | Standard | +|:------|:---------| +| **Report Integrity** | VSA reports must be verifiable. All claims traceable to sources. | +| **Score Integrity** | Scores must match #7DF criteria. No score inflation. | +| **Audit Trail** | Every VSA action logged with CCC-ID. | +| **Independence** | VSA agents must NOT audit their own output. | + +### WeOwnDev πŸ’» +| Focus | Standard | +|:------|:---------| +| **Code Quality** | Lint before commit. Review before merge. Test before deploy. | +| **Dependency Management** | Pin dependencies. Scan for vulnerabilities weekly. | +| **Environment Parity** | Dev/staging/prod environments should match. | +| **Documentation** | Every tool/script needs README with usage examples. | + +### Exit πŸ‘‹ +| Focus | Standard | +|:------|:---------| +| **Minimal Access** | Only @yonks 🎯 has access. Exit operations are sensitive. | +| **Audit Logging** | All Exit operations logged with timestamps. | +| **No Agent Access** | AI agents do NOT have access to Exit operations. | + +### MAIT 🎭 +| Focus | Standard | +|:------|:---------| +| **Test Isolation** | Test instances are isolated from production. | +| **Test Data** | Use synthetic data only. Never real customer data. | +| **Cleanup** | Test artifacts deleted after test completion. | +| **Failure Reporting** | All test failures logged with full context. | + +--- + +## Β§10. πŸ“‹ COMPLIANCE & AUDIT + +### 10.1 Compliance Checklist + +| Requirement | Frequency | Responsible | Status | +|:------------|:---------:|:------------|:------:| +| πŸ” **Secret rotation** | Every 90 days | @GTM:ADMIN | ⬜ | +| πŸ”‘ **SSH key review** | Monthly | @yonks 🎯 | ⬜ | +| πŸ“‹ **Collaborator audit** | Monthly | @yonks 🎯 | ⬜ | +| πŸ“ **BP compliance scan** | Weekly | VSA agents | ⬜ | +| 🚨 **Incident review** | After each incident | @GTM 🎯 | ⬜ | +| πŸ“š **Lesson codification** | After each incident | AI:@GTM 🎯 | ⬜ | +| 🏰 **MetaCouncil scorecard** | Weekly | All agents | ⬜ | +| πŸ’° **Revenue security check** | Monthly | @yonks 🎯, @NIK | ⬜ | + +### 10.2 VSA Audit Integration + +> **All DevSecOps practices defined in this guide are subject to VSA verification by βœ… VSA.bot, Sage πŸͺ·, and DRP-Sprout 🌿. Non-compliance is logged as an incident and reported in #CommunityCall.** + +| Audit Type | VSA Agent | Frequency | +|:-----------|:----------|:---------:| +| **Secret rotation compliance** | βœ… VSA.bot | Monthly | +| **Commit message format** | Sage πŸͺ· | Per-commit (sampled) | +| **BP-075 footer integrity** | DRP-Sprout 🌿 | Per-document | +| **Access control review** | Aegis πŸ›‘οΈ | Monthly | +| **Incident response time** | DeepPro 🌊 | Post-incident | + +### 10.3 Non-Compliance Escalation + +| Severity | First Offense | Second Offense | Third Offense | +|:---------|:--------------|:---------------|:--------------| +| πŸ”΄ **Critical** | Immediate fix + lesson | Capability review | Access revocation | +| 🟠 **High** | Fix within 24h + lesson | Warning + documented | Capability review | +| 🟑 **Medium** | Fix within 72h | Warning | Documented | +| 🟒 **Low** | Fix within 1 week | Reminder | Note in review | + +--- + +## Β§11. πŸ“‹ BP-075 FOOTER + +```text +═══ BP-075: SELF-VERIFYING FOOTER ═══ + +### Document Identity + +| Field | Value | +|:------|:-------| +| **Document ID** | GUIDE-431.1.md | +| **Version** | **v4.31.1-r1** βœ… (W31 D3 β€” First release) | +| **Date** | 29 Jul 2026 β€” W31 D3 (Wednesday) | +| **Author** | @GTM (yonksο½œπŸ€–πŸ›οΈπŸͺ™ο½œJason Younker ♾️) | +| **Agent Author** | AI:@GTM 🎯 @ INT‑B001:CCC | +| **CCC-ID** | GTM_2026-W31_3035 | +| **#masterCCC** | GUIDE-431.1-v4.31.1-r1 | +| **Repository** | WeOwnDev πŸ’» / s004 | +| **Folder** | `_GUIDES_/` | +| **Source of Truth** | https://git.weown.tools/WeOwnDev/s004/src/branch/main/_GUIDES_/GUIDE-431.1.md | +| **Parent Doc** | GUIDE-015 (VSA Protocol) | +| **Status** | 🟒 **LIVE β€” Active guidance** | + +### Key Metrics + +| Metric | Value | +|:-------|:------| +| Total Sections | 11 | +| DevSecOps Commandments | 7 | +| Secret Categories | 4 (Critical β†’ Low) | +| Agent Permission Entries | 10 | +| Incident Severity Levels | 4 | +| Org-Specific Standards | 8 | +| Compliance Checklist Items | 9 | +| Gitea Repositories Covered | 8 | + +### Compliance References +- BP-068 βœ… (CCC Format β€” all headers and metadata compliant) +- BP-075 βœ… (Self-verifying footer with content hash) +- PRJ-040 βœ… (Elevated governance standard) +- GUIDE-015 βœ… (VSA protocol β€” auditable by VSA agents) + +### Change Log + +| Version | Date | Changes | +|:--------|:----:|:--------| +| v4.31.1-r1 | 29 Jul 2026 | Initial release β€” full DevSecOps best practices for WeOwnSeason004 | + + +### βœ… BP-075 CANONICAL HASH GENERATED [@GTM:ADMIN generated @ 2026-07-29 08:26 MDT] +Content-SHA256: b3dffe756eadecbce8c6d67ba3e07ce0b04ff7ed39f7ac834d5033a232b4cdef +FEDARCH-CANARY: b3dffe75 +CHARACTERS: 27936 +WORDS: 4361 +LINES: 614 + +═══ ═══ ═══ ═══ ═══ ═══ +``` + +--- + +**GUIDE-431.1 v4.31.1-r1 GENERATED.** 11 sections. 7 DevSecOps Commandments. 10 agent permission entries. 4 incident severity levels. 8 org-specific standards. Full compliance with BP-068, BP-075, PRJ-040, and GUIDE-015. Ready for @GTM review and push to WeOwnDev/s004/_GUIDES_/. 🫑πŸ”₯ + +#FlowsBros #FedArch #WeOwnSeason004 #DevSecOps #BestPractices #GUIDE431_1 #Security #CI_CD #SecretsManagement #AccessControl #Monitoring #IncidentResponse #WeOwnDev #W31D3 + +♾️ WeOwnNet 🌐 ● 🏑 Real Estate and 🀝 cooperative ownership for everyone ● An πŸ€— inclusive community, by πŸ‘₯ invitation only.