speexor 0.1.0 → 0.2.0

package/API-REFERENCE.md

@@ -154,10 +154,56 @@ function createEventBus(): EventBus
 // EventBus: { emit(event, data), on(event, handler), off(event, handler), once(event, handler) }
 ```
 
+## SecretsVault API
+
+```typescript
+interface SecretsVault {
+  setSecret(scope: string, key: string, value: string): Promise<void>
+  getSecret(scope: string, key: string): Promise<string | null>
+  hasScope(scope: string): Promise<boolean>
+  grantScope(scope: string): Promise<void>
+}
+```
+
+## ExtensionManager API
+
+```typescript
+interface ExtensionManager {
+  install(name: string, source?: string): Promise<void>
+  remove(name: string): Promise<void>
+  list(): Promise<ExtensionInfo[]>
+  search(query: string): Promise<ExtensionInfo[]>
+  verifyInstall(name: string): Promise<{ valid: boolean; checksum: string }>
+}
+```
+
+## GovernanceEngine API
+
+```typescript
+interface GovernanceEngine {
+  evaluateTaskProposal(task: AgentTask): Promise<ApprovalDecision>
+  evaluateAction(action: ActionProposal): Promise<ApprovalDecision>
+  canRollback(actionId: string): Promise<boolean>
+  executeRollback(actionId: string): Promise<void>
+}
+```
+
+## Scheduler API
+
+```typescript
+interface Scheduler {
+  processGraph(graphId: string): Promise<void>
+  spawnNodeAgent(nodeId: string): Promise<string>
+  getStatus(): SchedulerStatus
+  start(): Promise<void>
+  stop(): Promise<void>
+}
+```
+
 ## Configuration Schema
 
 ```yaml
-version: "1"
+version: "5"
 projects:
   - name: <string>
     repository: <string>
@@ -177,6 +223,35 @@ projects:
       scm?: string
       runtime?: string
       notifier?: string
+    decomposition?:
+      maxTaskGraphDepth?: <number>      # default: 3
+      maxAgentSpawnDepth?: <number>     # default: 5
+      plannerProvider?: <string>
+    scheduler?:
+      maxConcurrentAgents?: <number>    # default: 4
+      retryOnFailure?: <boolean>        # default: true
+      providerFallbackChain?: <string[]>
+    worktreeHierarchy?:
+      pinToCommitHash?: <boolean>       # default: false
+      serializeMerges?: <boolean>       # default: true
+      conflictEscalatesToApproval?: <boolean>  # default: true
+    governance?:
+      autoApproveProposedTasks?: <boolean>     # default: false
+      autoApproveCategories?: <string[]>
+    riskPolicy?:
+      autoApprove?: <string[]>          # risk categories auto-approved
+      requireApproval?: <string[]>      # risk categories requiring approval
+      approvalTimeout?: <number>        # seconds, default: 300
+      budgetLimitUSD?: <number>
+    extensions?:
+      marketplaceIndex?: <string>
+      permissionsMode?: "strict" | "permissive"
+    security?:
+      secretsBackend?: "keychain" | "credential-manager" | "encrypted-file"
+      encryptAtRest?: <boolean>
+      sandboxModel?: "vm" | "worker-threads" | "docker"
+    performance?:
+      workerThreadPoolSize?: <number>   # default: 4
 ```
 
 ## Dashboard API
@@ -187,6 +262,18 @@ projects:
 | GET | `/api/projects` | Project configurations |
 | GET | `/api/sessions` | Active sessions, worktrees, runtimes |
 | GET | `/api/health` | Health check with memory stats |
+| GET | `/api/task-graphs` | All task graphs |
+| GET | `/api/task-graphs/:id` | Single task graph with nodes |
+| GET | `/api/task-graphs/:id/nodes/:nodeId` | Task node detail with agent, skills, commands |
+| GET | `/api/approvals` | Pending and all approvals |
+| POST | `/api/approvals/:id/approve` | Approve an approval item |
+| POST | `/api/approvals/:id/reject` | Reject an approval item |
+| POST | `/api/approvals/:id/rollback` | Rollback an approved action |
+| GET | `/api/decision-log` | Decision log entries |
+| GET | `/api/activity-feed` | Live agent activity feed |
+| GET | `/api/cost` | Cost data by provider/project/task node |
+| GET | `/api/eval/calibration` | Confidence calibration report |
+| GET | `/api/events` | SSE event stream (real-time updates) |
 | GET | `/` or `/dashboard` | HTML dashboard UI |
 
 ## CLI Reference
@@ -199,3 +286,11 @@ projects:
 | `speexor stop <session-id>` | Stop agent session |
 | `speexor logs <session-id>` | Tail session logs |
 | `speexor config-help` | Print config schema |
+| `speexor task submit <description>` | Submit high-level task for recursive decomposition |
+| `speexor ext search <query>` | Search extension marketplace |
+| `speexor ext install <name>` | Install extension with permission confirmation |
+| `speexor ext list` | List installed extensions |
+| `speexor ext update [name]` | Update extension(s) |
+| `speexor ext remove <name>` | Remove extension |
+| `speexor config validate` | Validate config schema, run migration if needed |
+| `speexor eval decisions` | Run decision quality evaluation and calibration report |

package/ARCHITECTURE.md

@@ -1,6 +1,6 @@
 # Speexor Architecture
 
-**Version:** 0.1.0 — **Package:** `@speexjs/speexor`
+**Version:** 0.1.0 — **Package:** `speexor`
 
 ---
 
@@ -21,26 +21,37 @@ Speexor (Agent Orchestrator) is a plugin-based, agent-agnostic orchestrator for
 ## 2. High-Level Architecture
 
 ```
-┌──────────────────────────────────────────────────────────────────────┐
-│                         CLI (Commander)                              │
-│  start  |  agent spawn  |  list  |  stop  |  logs  |  config-help   │
-└──────────────────────────┬───────────────────────────────────────────┘
-                           │
-                           ▼
-┌──────────────────────────────────────────────────────────────────────┐
-│                      SpeexorLifecycle                                │
-│                                                                      │
-│  ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌────────────────────┐  │
-│  │  Plugin  │  │  Plugin  │  │  Plugin  │  │   Session Manager  │  │
-│  │ Registry │  │  Loader  │  │  Context │  │   (in-memory Map)  │  │
-│  └────┬─────┘  └────┬─────┘  └────┬─────┘  └────────────────────┘  │
-│       │             │             │                                  │
-│       ▼             ▼             ▼                                  │
-│  ┌──────────────────────────────────────────────────────────────┐   │
-│  │                      EventBus                                │   │
-│  │              (EventEmitter3 wrapper)                         │   │
-│  └──────────────────────────────────────────────────────────────┘   │
-└──────────────────────────────────────────────────────────────────────┘
+┌──────────────────────────────────────────────────────────────────────────┐
+│                          CLI (Commander)                                  │
+│  start  |  agent spawn  |  task submit  |  list  |  stop  |  logs  |     │
+│  ext (search/install/list/update/remove)  |  config (validate/help)  |    │
+│  eval decisions  |  config-help                                          │
+└────────────────────────────┬─────────────────────────────────────────────┘
+                             │
+                             ▼
+┌──────────────────────────────────────────────────────────────────────────┐
+│                        SpeexorLifecycle                                   │
+│                                                                           │
+│  ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌────────────────────────┐  │
+│  │  Plugin  │  │  Plugin  │  │  Plugin  │  │   Session Manager      │  │
+│  │ Registry │  │  Loader  │  │  Context │  │   (in-memory Map)      │  │
+│  └────┬─────┘  └────┬─────┘  └────┬─────┘  └────────────────────────┘  │
+│       │             │             │                                      │
+│       ▼             ▼             ▼                                      │
+│  ┌──────────────────────────────────────────────────────────────────┐  │
+│  │                        EventBus                                  │  │
+│  │                (EventEmitter3 wrapper)                           │  │
+│  └──────────────────────────────────────────────────────────────────┘  │
+│                                                                           │
+│  ┌──────────────────────────────────────────────────────────────────┐  │
+│  │                     v2 Core Components                           │  │
+│  │  PlannerEngine  |  TaskGraphManager  |  Scheduler                │  │
+│  │  GovernanceEngine  |  ApprovalManager  |  CostTracker            │  │
+│  │  SecretsVault  |  ExtensionRegistry  |  SkillWrapper             │  │
+│  │  DecisionEvaluator  |  SessionGuard  |  DashboardState           │  │
+│  │  WorktreeHierarchyProtocol                                        │  │
+│  └──────────────────────────────────────────────────────────────────┘  │
+└──────────────────────────────────────────────────────────────────────────┘
          │            │              │              │
          ▼            ▼              ▼              ▼
 ┌─────────────┐ ┌──────────┐ ┌──────────┐ ┌──────────────────┐
@@ -48,13 +59,14 @@ Speexor (Agent Orchestrator) is a plugin-based, agent-agnostic orchestrator for
 │  Adapters   │ │ Adapters │ │ Adapters │ │ Adapters│Adapt. │
 │ (4 impls)   │ │ (2 impls)│ │ (1 impl) │ │ (1 impl)│(1impl)│
 └─────────────┘ └──────────┘ └──────────┘ └──────────────────┘
-                           │
-                           ▼
-┌──────────────────────────────────────────────────────────────────────┐
-│                    Dashboard Server (Node.js HTTP)                   │
-│  /api/status | /api/projects | /api/sessions | /api/health |  /     │
-│  (4 JSON endpoints + single-page HTML dashboard, auto-refresh 5s)   │
-└──────────────────────────────────────────────────────────────────────┘
+                            │
+                            ▼
+┌──────────────────────────────────────────────────────────────────────────┐
+│                    Dashboard Server (Node.js HTTP)                        │
+│  /api/status | /api/projects | /api/sessions | /api/health |  /         │
+│  (4 JSON endpoints + single-page HTML dashboard, auto-refresh 5s)       │
+│  v2 panels: Task Tree | Fleet | Approvals | Cost                        │
+└──────────────────────────────────────────────────────────────────────────┘
 ```
 
 The lifecycle is the central orchestrator. It holds a plugin registry (keyed by slot), an in-memory session map, and the EventBus. Plugins are loaded via `loadAllPlugins()`, registered by slot, and collaborate through the shared `PluginContext` (config + EventBus + logger).
@@ -188,7 +200,7 @@ interface TerminalPlugin extends PluginModule {
 
 ## 4. Plugin Implementations
 
-The built-in registry (`src/plugins/index.ts`) includes 10 implementations loaded at startup:
+The built-in registry (`src/plugins/index.ts`) includes 13+ implementations loaded at startup:
 
 | Plugin | Class | Slot | Dependencies |
 |--------|-------|------|-------------|
@@ -202,6 +214,9 @@ The built-in registry (`src/plugins/index.ts`) includes 10 implementations loade
 | GitHub Tracker | `GitHubTracker` | tracker | `gh` CLI |
 | GitHub SCM | `GitHubSCM` | scm | `gh` CLI |
 | Desktop Notifier | `DesktopNotifier` | notifier | osascript / PowerShell / notify-send |
+| ECC Skill | `EccSkillPlugin` | agent | ECC skill folders |
+| Affaan M Skill | `AffaanSkillPlugin` | agent | affaan-m skill folders |
+| Extension Manager | `ExtensionManagerPlugin` | agent | extension registry |
 
 **Runtime fallback logic:** The loader registers both `TmuxRuntime` and `ProcessRuntime`. `TmuxRuntime.initialize()` throws if `tmux` is not available; lifecycle initialization failure is caught per-plugin, allowing `ProcessRuntime` to serve as the fallback on Windows.
 
@@ -236,7 +251,10 @@ speexor start <repo-url>
     │       ├─ new GitWorktreeWorkspace()
     │       ├─ new GitHubTracker()
     │       ├─ new GitHubSCM()
-    │       └─ new DesktopNotifier()
+    │       ├─ new DesktopNotifier()
+    │       ├─ new EccSkillPlugin()
+    │       ├─ new AffaanSkillPlugin()
+    │       └─ new ExtensionManagerPlugin()
     │
     ├─ 6. for each plugin → lifecycle.registerPlugin(plugin)
     │       └─ plugin slot → Map<PluginSlot, PluginModule[]>
@@ -423,6 +441,9 @@ Retries are tracked per `issueId:eventType` key in a `Map<string, number>`. Once
 | `GET` | `/api/projects` | All configured projects with provider routing |
 | `GET` | `/api/sessions` | Active agent sessions, worktrees, runtimes |
 | `GET` | `/api/health` | Health check with memory usage and timestamp |
+| `GET` | `/api/tasks` | Task graph tree (v2) |
+| `GET` | `/api/approvals` | Pending/approved/rejected approvals (v2) |
+| `GET` | `/api/costs` | Cost breakdown by provider/project/node (v2) |
 | `GET` | `/` or `/dashboard` | Single-page HTML dashboard |
 
 All JSON endpoints return CORS headers (`Access-Control-Allow-Origin: *`).
@@ -435,7 +456,8 @@ The dashboard is served as an inline HTML string from `DashboardServer.serveDash
 - **Stat cards**: project count, active agents, system status, uptime
 - **Projects table**: name, repository, primary agent, fallback agents
 - **Sessions table**: session ID, task, provider, status, start time
-- **Auto-refresh**: polls all 3 JSON endpoints every 5 seconds via `setInterval`
+- **v2 Panels**: Task Tree, Fleet, Approvals, Cost (toggleable)
+- **Auto-refresh**: polls all JSON endpoints every 5 seconds via `setInterval`
 - **No build step** — single HTML file with embedded `<style>` and `<script>`
 
 ### 8.3 Architecture
@@ -450,13 +472,16 @@ DashboardServer
     │     └─ 'session:completed' → DashboardState.removeSession()
     │
     ├─ DashboardState (in-memory)
-    │     ├─ SpeexorState { sessions, worktrees, runtimes, projects }
+    │     ├─ SpeexorState { sessions, worktrees, runtimes, projects, taskGraph, approvals, costs }
     │     └─ listener pattern for reactive updates
     │
     └─ Routes:
           ├─ /api/status   → lifecycle.getStatus(), lifecycle.listSessions()
           ├─ /api/projects → lifecycle.getConfig().projects
           ├─ /api/sessions → lifecycle.listSessions()
+          ├─ /api/tasks    → taskGraphManager.toJSON()
+          ├─ /api/approvals → approvalManager.list()
+          ├─ /api/costs    → costTracker.getBreakdown()
           ├─ /api/health   → { status, timestamp, memory }
           ├─ /             → serveDashboardHTML()
           └─ 404           → { error: 'Not found' }
@@ -535,6 +560,28 @@ Implement `TrackerPlugin` for Jira, Linear, or GitLab issues. Implement `SCMPlug
 
 ---
 
+## 11. v2 Core Components
+
+The following components were added in v0.2.0 as Speexor's advanced orchestration layer:
+
+| Component | Responsibility |
+|-----------|---------------|
+| PlannerEngine | LLM-based task decomposition, heuristic fallback |
+| TaskGraphManager | DAG data model, topological sort, cycle detection |
+| Scheduler | Tick-based parallel execution, retry/reassign |
+| GovernanceEngine | Two-axis approval, duplicate detection, rollback |
+| ApprovalManager | Approval lifecycle, expiry, default actions |
+| CostTracker | Provider/project/node cost tracking, budget guard |
+| SecretsVault | OS-native secure credential storage |
+| ExtensionRegistry | Install, verify, enable/disable extensions |
+| SkillWrapper | Auto-detect ECC/affaan-m skill folders |
+| DecisionEvaluator | Confidence calibration, decision logging |
+| SessionGuard | AFK auto-pause, idle timeout |
+| WorktreeHierarchyProtocol | Fork/pin/merge subagent branches |
+| DashboardState | Reactive state for all dashboard panels |
+
+---
+
 ## Key Design Decisions
 
 | Decision | Rationale |
@@ -545,4 +592,8 @@ Implement `TrackerPlugin` for Jira, Linear, or GitLab issues. Implement `SCMPlug
 | Synchronous JSON state file | Simplicity — avoids database dependency for session tracking |
 | Inline HTML dashboard | Zero build step, zero dependencies for the UI |
 | `gh` CLI dependency | Avoids GitHub API token management; delegates auth to `gh` |
-| Reverse-order destroy | Dependencies destroyed before dependents (terminal → notifier → scm → tracker → workspace → runtime → agent) |
+| Reverse-order destroy | Dependencies destroyed before dependents (terminal → notifier → scm → tracker → workspace → runtime → agent) |
+| SQLite for DAG persistence | Task graph durability without a full DBMS |
+| OS-keychain for secrets | No .env files; credentials stored in OS secure storage |
+| Two-axis governance | Separates approval authority from execution for audit compliance |
+| ECC skill auto-detection | Zero-config integration with existing Claude skill ecosystem |

package/BENCHMARKS.md

@@ -0,0 +1,52 @@
+# Benchmarks
+
+> Performance targets and baseline measurements for Speexor.
+
+## Performance Targets (v4 §8.3)
+
+| Metric | Target | Measured (Baseline) | Notes |
+|--------|--------|---------------------|-------|
+| Agent spawn time | <2s | — | Time from `spawnAgent()` call to agent process accepting input |
+| Dashboard API latency | <200ms | — | P95 response time for `/api/status`, `/api/projects`, `/api/sessions` |
+| Event-to-dashboard latency | <1s | — | Time from event emission to dashboard state update |
+| Store throughput | ≥100 writes/sec | — | Concurrent `state.json` or SQLite write operations |
+| Memory footprint (idle) | <200MB | — | RSS after startup with no active agents |
+| Memory footprint (per agent) | <50MB | — | Additional RSS per active agent session |
+| CLI startup time | <500ms | — | Time from `speexor <command>` to first output |
+
+## Benchmark Baseline
+
+Baseline measurements are collected via:
+
+```bash
+# Agent spawn time
+hyperfine --warmup 3 'speexor agent spawn --task benchmark --agent opencode'
+
+# Dashboard API latency
+wrk -t4 -c10 -d30s http://localhost:3000/api/status
+
+# Store throughput
+node benchmarks/store-throughput.js
+
+# Memory footprint
+node -e "const m = process.memoryUsage(); console.log('RSS:', m.rss / 1024 / 1024, 'MB')"
+```
+
+## How to Run Benchmarks
+
+```bash
+# Install benchmark dependencies
+pnpm add -D hyperfine wrk
+
+# Run full benchmark suite
+pnpm benchmark
+
+# Run specific benchmark
+node benchmarks/store-throughput.js
+```
+
+## Benchmark Results History
+
+| Date | Version | Spawn Time | Dashboard Latency (P95) | Event-to-Dashboard | Store Writes/s | Idle Memory | Notes |
+|------|---------|-----------|------------------------|-------------------|---------------|-------------|-------|
+| — | 0.1.0 | — | — | — | — | — | Baseline not yet collected |

package/CHANGELOG.md

@@ -30,12 +30,43 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Configurable reaction rules (ci-failed, changes-requested, approved-and-green)
 - Graceful shutdown with SIGINT/SIGTERM handling
 
-## [0.2.0] — Planned
+## [0.2.0] — 2026-06-30
 
 ### Added
-- Recursive task decomposition (DAG-based multi-agent orchestration)
-- Real-time WebSocket terminal streaming
-- Cost/usage tracking per provider
+- Recursive Task Decomposition: DAG-based task graph with LLM Planner engine, heuristic decomposition fallback, depth control (maxTaskGraphDepth/maxAgentSpawnDepth)
+- Parallel Scheduler: Resource-aware agent orchestration with tick-based scheduling, auto-retry on failure, provider fallback chain
+- Governance Engine: Two-axis Approval Model (Task Origin Gate + Action Risk Gate), risk-based action classification, approval timeout with default actions
+- Cost Tracking: Per-provider, per-project, per-task-node cost tracking with budget guard (80% warning, 100% halt)
+- Extension Manager CLI: `speexor ext search/install/list/update/remove` commands with marketplace index support
+- Secrets Vault: OS-native secure credential storage (macOS Keychain, Windows Credential Manager, Linux encrypted file)
+- Plugin SDK scaffold: `src/sdk/` with extension scaffold generator for 6 extension types
+- Decision Quality Eval: `speexor eval decisions` with calibration report, confidence bucketing, under/over-confidence detection
+- Worktree Hierarchy Protocol: Fork-with-pin, serialized merges, conflict escalation to approval
+- Interactive Dashboard v2: Collapsible Task Tree, node drill-down panel, Cost by Task Node bar chart, Simple Mode toggle, Unicode status icons, WCAG 2.1 AA keyboard navigation
+- Session Guard: AFK auto-pause with configurable maxAfkDurationHours
+- Provider Error Retry: Exponential backoff (1s→2s→4s→8s) with automatic provider fallback
+- Skill Manifest Wrapper: Auto-detect ECC/affaan-m-style skill folders and generate compatible manifests
+- Config Schema Migration: Version detection, automatic migration with backup
+- Task Graph Persistence: SQLite-backed task graph store with WAL mode
+- Instrumented Agent Adapters: Command wrapper, file watcher, activity feed for all 4 agent backends
+- Canonical data directory: `~/.speexor/` with per-project hash isolation
+- 19 test files with ~320 unit/integration tests across all modules
+- GitHub Actions CI/CD pipeline (test, lint, build, publish)
+- 5 Architecture Decision Records in docs/adr/
+- Glossary (GLOSSARY.md) with 22 canonical terms
+- Performance benchmarks (BENCHMARKS.md) with tracked targets
+- Updated ROADMAP.md with v5 milestones
+
+### Architecture
+- Split maxDepth into maxTaskGraphDepth / maxAgentSpawnDepth with independent defaults
+- IsolatedSandbox reimplemented with node:vm (not worker_threads) for true security boundary
+- Extension permission verification with SHA-256 checksums at install time
+- Rollback API for approved actions within configurable grace window
+- Unified two-axis Approval Model surfacing in single Approvals panel
+
+### Fixed
+- DEFAULT_REACTION_RULES changed approved-and-green escalateAfter from 0 to 1 (was invalid per Zod min(1))
+- Permission enforcer now documents worker_threads as performance-only, not security boundary
 
 ## [0.3.0] — Planned
 

package/CODE-OF-CONDUCT.md

@@ -1,83 +1,83 @@
-# Contributor Covenant Code of Conduct
-
-## Our Pledge
-
-We as members, contributors, and leaders pledge to make participation in our
-community a harassment-free experience for everyone, regardless of age, body
-size, visible or invisible disability, ethnicity, sex characteristics, gender
-identity and expression, level of experience, education, socio-economic status,
-nationality, personal appearance, race, caste, color, religion, or sexual
-identity and orientation.
-
-We pledge to act and interact in ways that contribute to an open, welcoming,
-diverse, inclusive, and healthy community.
-
-## Our Standards
-
-Examples of behavior that contributes to a positive environment:
-
-* Demonstrating empathy and kindness toward other people
-* Being respectful of differing opinions, viewpoints, and experiences
-* Giving and gracefully accepting constructive feedback
-* Accepting responsibility and apologizing to those affected by our mistakes
-* Focusing on what is best not just for us as individuals, but for the overall community
-
-Examples of unacceptable behavior:
-
-* The use of sexualized language or imagery, and sexual attention or advances
-* Trolling, insulting or derogatory comments, and personal or political attacks
-* Public or private harassment
-* Publishing others' private information without explicit permission
-* Other conduct which could reasonably be considered inappropriate in a professional setting
-
-## Enforcement Responsibilities
-
-Project maintainers are responsible for clarifying and enforcing our standards of
-acceptable behavior and will take appropriate and fair corrective action in
-response to any behavior that they deem inappropriate, threatening, offensive,
-or harmful.
-
-## Scope
-
-This Code of Conduct applies within all community spaces, and also applies when
-an individual is officially representing the community in public spaces.
-
-## Enforcement
-
-Instances of abusive, harassing, or otherwise unacceptable behavior may be
-reported to the project maintainers at opensource@superdevids.com.
-All complaints will be reviewed and investigated promptly and fairly.
-
-## Enforcement Guidelines
-
-Project maintainers will follow these Community Impact Guidelines:
-
-### 1. Correction
-**Community Impact:** Use of inappropriate language or other behavior deemed
-unprofessional or unwelcome.
-**Consequence:** A private, written warning, providing clarity around the nature
-of the violation and an explanation of why the behavior was inappropriate.
-
-### 2. Warning
-**Community Impact:** A violation through a single incident or series of actions.
-**Consequence:** A warning with consequences for continued behavior. No
-interaction with the people involved for a specified period of time.
-
-### 3. Temporary Ban
-**Community Impact:** A serious violation of community standards.
-**Consequence:** A temporary ban from any sort of interaction or public
-communication with the community for a specified period of time.
-
-### 4. Permanent Ban
-**Community Impact:** Demonstrating a pattern of violation of community standards.
-**Consequence:** A permanent ban from any sort of public interaction within the
-community.
-
-## Attribution
-
-This Code of Conduct is adapted from the [Contributor Covenant][homepage],
-version 2.1, available at
-[https://www.contributor-covenant.org/version/2/1/code_of_conduct.html][v2.1].
-
-[homepage]: https://www.contributor-covenant.org
-[v2.1]: https://www.contributor-covenant.org/version/2/1/code_of_conduct.html
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone, regardless of age, body
+size, visible or invisible disability, ethnicity, sex characteristics, gender
+identity and expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, caste, color, religion, or sexual
+identity and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming,
+diverse, inclusive, and healthy community.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment:
+
+* Demonstrating empathy and kindness toward other people
+* Being respectful of differing opinions, viewpoints, and experiences
+* Giving and gracefully accepting constructive feedback
+* Accepting responsibility and apologizing to those affected by our mistakes
+* Focusing on what is best not just for us as individuals, but for the overall community
+
+Examples of unacceptable behavior:
+
+* The use of sexualized language or imagery, and sexual attention or advances
+* Trolling, insulting or derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information without explicit permission
+* Other conduct which could reasonably be considered inappropriate in a professional setting
+
+## Enforcement Responsibilities
+
+Project maintainers are responsible for clarifying and enforcing our standards of
+acceptable behavior and will take appropriate and fair corrective action in
+response to any behavior that they deem inappropriate, threatening, offensive,
+or harmful.
+
+## Scope
+
+This Code of Conduct applies within all community spaces, and also applies when
+an individual is officially representing the community in public spaces.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported to the project maintainers at opensource@superdevids.com.
+All complaints will be reviewed and investigated promptly and fairly.
+
+## Enforcement Guidelines
+
+Project maintainers will follow these Community Impact Guidelines:
+
+### 1. Correction
+**Community Impact:** Use of inappropriate language or other behavior deemed
+unprofessional or unwelcome.
+**Consequence:** A private, written warning, providing clarity around the nature
+of the violation and an explanation of why the behavior was inappropriate.
+
+### 2. Warning
+**Community Impact:** A violation through a single incident or series of actions.
+**Consequence:** A warning with consequences for continued behavior. No
+interaction with the people involved for a specified period of time.
+
+### 3. Temporary Ban
+**Community Impact:** A serious violation of community standards.
+**Consequence:** A temporary ban from any sort of interaction or public
+communication with the community for a specified period of time.
+
+### 4. Permanent Ban
+**Community Impact:** Demonstrating a pattern of violation of community standards.
+**Consequence:** A permanent ban from any sort of public interaction within the
+community.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 2.1, available at
+[https://www.contributor-covenant.org/version/2/1/code_of_conduct.html][v2.1].
+
+[homepage]: https://www.contributor-covenant.org
+[v2.1]: https://www.contributor-covenant.org/version/2/1/code_of_conduct.html