Skip to content

Commit d04e850

Browse files
refactor: rename aegis β†’ orca across entire codebase
Complete internal rebranding from Aegis to Orca: Build System: - Module names: aegis_core β†’ orca_core, aegis β†’ orca, aegis_cli β†’ orca_cli, aegis_edge β†’ orca_edge, aegis_edge_main β†’ orca_edge_main Source Code (~115 zig files): - All @import() statements updated - AegisError β†’ OrcaError root error set - Local aliases: aegis_mcp β†’ orca_mcp, aegis_policy β†’ orca_policy, aegis_bin β†’ orca_bin, runAegis β†’ runOrca, etc. - Test literals: /tmp/aegis β†’ /tmp/orca, command strings, temp dir names - ActorKind enum: removed legacy 'aegis' tag, kept 'orca' Schemas (8 JSON files): - URLs: github.com/chriskarani/aegis β†’ orca, aegis.local β†’ orca.local - Titles: Aegis Audit Event β†’ Orca Audit Event, etc. CLI & User-Facing: - All command help text, error messages, documentation - Policy preset YAML comments - Example scripts (sh, ps1, py) and demo docs - manifest.json project name Documentation: - AGENTS.md, PLUGIN_SECURITY_MODEL.md, PLUGIN_CHANGELOG.md, 00_PROJECT_INDEX.md, README.md - .gitignore: added orca_* entries alongside legacy aegis_* entries Intentionally preserved: - MCP tool-name blacklist still checks for 'aegis' (catches malicious tools) - Test assertions verifying 'Aegis' does NOT appear in plugin output - Test assertions verifying release artifacts exclude old names - Actual on-disk repo path in JSON fixture cwd fields Build: compiles clean. Tests: 694/702 pass (2 pre-existing packaging failures).
1 parent 40f675a commit d04e850

168 files changed

Lines changed: 633 additions & 609 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

β€Ž.github/actions/orca-run/action.ymlβ€Ž

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ inputs:
77
policy:
88
description: Optional policy path.
99
required: false
10-
default: .aegis/policy.yaml
10+
default: .orca/policy.yaml
1111
runs:
1212
using: composite
1313
steps:

β€Ž.gitignoreβ€Ž

Lines changed: 14 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -36,19 +36,31 @@ summary.md
3636
node_modules/
3737
**/node_modules/
3838

39-
# --- Aegis internal planning / generated plan packs ---
39+
# --- Orca internal planning / generated plan packs ---
4040
aegis_phased_project/
4141
aegis_phased_project_reviewed/
4242
aegis_phased_project_final/
4343
aegis_plugin_launch_plan/
4444
aegis_plugin_launch_plan_v2/
4545
aegis_plugin_launch_plan_v3/
46+
orca_phased_project/
47+
orca_phased_project_reviewed/
48+
orca_phased_project_final/
49+
orca_plugin_launch_plan/
50+
orca_plugin_launch_plan_v2/
51+
orca_plugin_launch_plan_v3/
4652
aegis_phased_project_markdown_files.zip
4753
aegis_phased_project_reviewed.zip
4854
aegis_phased_project_final.zip
4955
aegis_plugin_launch_plan.zip
5056
aegis_plugin_launch_plan_v2.zip
5157
aegis_plugin_launch_plan_v3.zip
58+
orca_phased_project_markdown_files.zip
59+
orca_phased_project_reviewed.zip
60+
orca_phased_project_final.zip
61+
orca_plugin_launch_plan.zip
62+
orca_plugin_launch_plan_v2.zip
63+
orca_plugin_launch_plan_v3.zip
5264
*_phase_pack*.zip
5365
*_plan_pack*.zip
5466
*_launch_plan*.zip
@@ -103,6 +115,7 @@ P07_*.md
103115
00_PLUGIN_LAUNCH_INDEX.md
104116
[0-9][0-9]_*.md
105117
AEGIS_CLI_PLUGIN_CONTRACT.md
118+
ORCA_CLI_PLUGIN_CONTRACT.md
106119
ARCHITECTURE_CONTRACTS.md
107120
CODEX_AGENT_CONTEXT.md
108121
DRONE_WORKSTREAM_GUARDRAILS.md

β€Ž00_PROJECT_INDEX.mdβ€Ž

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
1-
# Aegis v1.0 Phased Project Plan
1+
# Orca v1.0 Phased Project Plan
22

3-
**Project:** Aegis β€” local-first runtime firewall for AI agents
3+
**Project:** Orca β€” local-first runtime firewall for AI agents
44
**Implementation language:** Zig
55
**Execution model:** Each phase is designed to be executed by a Codex coding agent as an isolated implementation task.
66
**End state:** A complete v1.0 open-source product: local CLI, policy engine, audit/replay, secret protection, staged writes, command guard, MCP proxy, network guard, red-team suite, platform backends, installers, docs, and release readiness.
@@ -29,7 +29,7 @@ For best results, every Codex execution should include the assigned phase file p
2929

3030
## Product Definition
3131

32-
Aegis is a Zig-based, local-first runtime firewall for AI agents. It launches existing agent tools inside a policy-controlled session, strips secrets, blocks dangerous file access, stages writes, mediates shell commands, controls network egress, proxies MCP servers, records tamper-evident audit logs, and ships with red-team fixtures that prove the protection works.
32+
Orca is a Zig-based, local-first runtime firewall for AI agents. It launches existing agent tools inside a policy-controlled session, strips secrets, blocks dangerous file access, stages writes, mediates shell commands, controls network egress, proxies MCP servers, records tamper-evident audit logs, and ships with red-team fixtures that prove the protection works.
3333

3434
Primary promise:
3535

@@ -104,18 +104,18 @@ Each phase should leave the repository in a working state.
104104

105105
## v1.0 Product Completion Criteria
106106

107-
Aegis v1.0 is complete when all of the following are true:
107+
Orca v1.0 is complete when all of the following are true:
108108

109109
### Core CLI
110110

111-
- `aegis run` launches arbitrary commands.
112-
- `aegis init` creates a working policy.
113-
- `aegis doctor` reports platform capabilities.
114-
- `aegis replay` replays sessions.
115-
- `aegis diff`, `aegis apply`, and `aegis discard` manage staged writes.
116-
- `aegis policy check` validates policy files.
117-
- `aegis mcp proxy` proxies stdio MCP servers.
118-
- `aegis redteam` runs security fixtures.
111+
- `orca run` launches arbitrary commands.
112+
- `orca init` creates a working policy.
113+
- `orca doctor` reports platform capabilities.
114+
- `orca replay` replays sessions.
115+
- `orca diff`, `orca apply`, and `orca discard` manage staged writes.
116+
- `orca policy check` validates policy files.
117+
- `orca mcp proxy` proxies stdio MCP servers.
118+
- `orca redteam` runs security fixtures.
119119

120120
### Protection
121121

β€ŽAGENTS.mdβ€Ž

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# Aegis Agent Instructions
1+
# Orca Agent Instructions
22

33
## Public Repository Hygiene
44

@@ -9,15 +9,15 @@
99
- `customer_pilot/`
1010
- `tasks/`
1111
- `reports/`
12-
- `.aegis-edge/`
12+
- `.orca-edge/`
1313
- `.edge/`
1414
- `dist/`
1515
- `dist-dry-run/`
1616
- `docs/release/`
1717
- `docs/orca_opencode_openclaw_plan/`
1818
- `integrations/**/node_modules/`
1919
- Before staging or committing, run a tracked-file hygiene check for private/public-boundary leaks:
20-
- `git ls-files | rg '(^go_to_market/|^customer_pilot/|^tasks/|^reports/|^\\.aegis-edge/|^\\.edge/|^dist/|^dist-dry-run/|^docs/release/|^docs/orca_opencode_openclaw_plan/|node_modules/)'
20+
- `git ls-files | rg '(^go_to_market/|^customer_pilot/|^tasks/|^reports/|^\\.orca-edge/|^\\.edge/|^dist/|^dist-dry-run/|^docs/release/|^docs/orca_opencode_openclaw_plan/|node_modules/)'
2121
- If that command returns any files, stop and untrack them before proceeding.
2222
- Never commit generated release archives, SBOMs, checksums, dry-run package output, red-team replay output, customer-pilot templates, SOW/NDA notes, target-account templates, outreach copy, pricing guidance, or task-memory logs.
2323

@@ -31,6 +31,6 @@
3131

3232
## Product Boundary
3333

34-
- Keep public Core/Orca surfaces separate from internal Aegis Edge, customer acquisition, and pilot-planning collateral.
34+
- Keep public Core/Orca surfaces separate from internal Orca Edge, customer acquisition, and pilot-planning collateral.
3535
- Public docs may explain supported behavior, installation, security model, and verified limitations.
3636
- Internal docs may plan launches, pilots, pricing, outreach, target accounts, release operations, or founder/customer strategy, but those stay untracked unless explicitly approved for publication.

β€ŽPLUGIN_CHANGELOG.mdβ€Ž

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
1-
# Aegis Plugin Changelog
1+
# Orca Plugin Changelog
22

33
## 1.1.0 β€” Plugin Distribution and Marketplace
44

55
### Added
66

77
- **Codex plugin** (`integrations/codex-plugin/`)
88
- Plugin manifest (`.codex-plugin/plugin.json`)
9-
- Skills: `aegis-doctor`, `aegis-init`, `aegis-protect`, `aegis-redteam`, `aegis-replay`
9+
- Skills: `orca-doctor`, `orca-init`, `orca-protect`, `orca-redteam`, `orca-replay`
1010
- Hooks: `SessionStart`, `UserPromptSubmit`, `PreToolUse`, `PermissionRequest`, `PostToolUse`, `Stop`
1111
- README with install instructions
1212
- Local marketplace example (`examples/marketplace.json`)
@@ -38,11 +38,11 @@
3838
- `scripts/package-plugins.ps1` β€” Windows PowerShell equivalent
3939
- `scripts/package-npm-plugins.sh` β€” creates npm tarballs and checksums
4040
- Produces:
41-
- `dist/plugins/aegis-codex-plugin-vX.Y.Z.zip`
42-
- `dist/plugins/aegis-claude-code-plugin-vX.Y.Z.zip`
43-
- `dist/plugins/aegis-opencode-plugin-vX.Y.Z.zip`
44-
- `dist/plugins/aegis-claude-marketplace-vX.Y.Z.zip`
45-
- `dist/plugins/aegis-plugin-checksums.txt`
41+
- `dist/plugins/orca-codex-plugin-vX.Y.Z.zip`
42+
- `dist/plugins/orca-claude-code-plugin-vX.Y.Z.zip`
43+
- `dist/plugins/orca-opencode-plugin-vX.Y.Z.zip`
44+
- `dist/plugins/orca-claude-marketplace-vX.Y.Z.zip`
45+
- `dist/plugins/orca-plugin-checksums.txt`
4646
- `dist/npm/orca-opencode-plugin-vX.Y.Z.tgz`
4747
- `dist/npm/orca-openclaw-plugin-vX.Y.Z.tgz`
4848
- `dist/npm/orca-npm-plugin-checksums.txt`
@@ -83,7 +83,7 @@
8383

8484
### Compatibility
8585

86-
- Aegis core: 1.1.0
86+
- Orca core: 1.1.0
8787
- Codex plugin: 1.1.0
8888
- Claude Code plugin: 1.1.0
8989
- OpenCode plugin: 1.1.0
@@ -96,7 +96,7 @@
9696
## How to Verify This Release
9797

9898
```bash
99-
# Build Aegis
99+
# Build Orca
100100
zig build
101101

102102
# Run tests
@@ -130,7 +130,7 @@ cat tests/plugin-fixtures/opencode/tool_execute_before_safe.json \
130130

131131
# Verify artifacts
132132
ls -la dist/plugins
133-
cat dist/plugins/aegis-plugin-checksums.txt
133+
cat dist/plugins/orca-plugin-checksums.txt
134134

135135
# Run redteam
136136
./zig-out/bin/orca redteam --ci

β€ŽPLUGIN_SECURITY_MODEL.mdβ€Ž

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -3,11 +3,11 @@
33
> Version: 1.1.0
44
> Status: Active
55
6-
This document defines the trust boundaries, sandbox expectations, and permission model for Aegis plugins.
6+
This document defines the trust boundaries, sandbox expectations, and permission model for Orca plugins.
77

88
## Principles
99

10-
1. **Orca is the source of truth.** Plugins call Aegis; they do not reimplement policy logic.
10+
1. **Orca is the source of truth.** Plugins call Orca; they do not reimplement policy logic.
1111
2. **Strongest protection is `orca run`.** Plugin hooks are additive, not a replacement for supervised execution.
1212
3. **Default deny.** If a plugin cannot verify safety, it must fail closed.
1313
4. **No silent mutation.** Host configs, policies, and credentials are never changed without explicit user approval.
@@ -20,13 +20,13 @@ This document defines the trust boundaries, sandbox expectations, and permission
2020
β”‚ Host IDE (Codex, Claude Code, etc.) β”‚ ← Untrusted by default
2121
β”‚ Runs arbitrary agent code β”‚
2222
β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
23-
β”‚ Aegis Plugin (future package) β”‚ ← Semi-trusted; read-only
23+
β”‚ Orca Plugin (future package) β”‚ ← Semi-trusted; read-only
2424
β”‚ Calls Orca for decisions β”‚
2525
β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
26-
β”‚ Orca (`aegis plugin *`) β”‚ ← Trusted local surface
26+
β”‚ Orca (`orca plugin *`) β”‚ ← Trusted local surface
2727
β”‚ Owns policy, audit, replay β”‚
2828
β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
29-
β”‚ Aegis Core (policy engine, audit) β”‚ ← Trusted
29+
β”‚ Orca Core (policy engine, audit) β”‚ ← Trusted
3030
β”‚ Local-only, no network dependency β”‚
3131
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜
3232
```
@@ -35,16 +35,16 @@ This document defines the trust boundaries, sandbox expectations, and permission
3535

3636
| Level | What It Can Do | Example |
3737
|-------|----------------|---------|
38-
| **Read-only** | Query status, read policy, check manifests | `aegis plugin doctor`, `aegis plugin manifest` |
39-
| **Preview** | Simulate changes without writing | `aegis plugin install --dry-run` |
38+
| **Read-only** | Query status, read policy, check manifests | `orca plugin doctor`, `orca plugin manifest` |
39+
| **Preview** | Simulate changes without writing | `orca plugin install --dry-run` |
4040
| **Mutate** | Modify host config or policy | Requires `--yes` + explicit user confirmation |
4141
| **Actuate** | Trigger real-world effects | **Not exposed by default** |
4242

4343
## Plugin Default Behavior
4444

45-
- `aegis plugin install` defaults to `--dry-run`.
46-
- `aegis plugin doctor` does not print secrets or raw env values.
47-
- `aegis plugin mcp-server` is a documented stub; no real server starts.
45+
- `orca plugin install` defaults to `--dry-run`.
46+
- `orca plugin doctor` does not print secrets or raw env values.
47+
- `orca plugin mcp-server` is a documented stub; no real server starts.
4848
- Drone-related operations are default-deny.
4949

5050
## Credential Handling
@@ -55,7 +55,7 @@ This document defines the trust boundaries, sandbox expectations, and permission
5555

5656
## Host Config Mutations
5757

58-
- Aegis plugin commands must not silently overwrite Codex, Claude Code, or other host configs.
58+
- Orca plugin commands must not silently overwrite Codex, Claude Code, or other host configs.
5959
- Any config change must be previewed with `--dry-run` first.
6060
- Any actual change requires `--yes`.
6161

β€ŽREADME.mdβ€Ž

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -292,7 +292,7 @@ Run `orca doctor` to check your platform capabilities.
292292
- [Commands](docs/commands.md) β€” CLI reference.
293293
- [Plugin security model](docs/integrations/plugin-security-model.md)
294294
- [Plugin troubleshooting](docs/integrations/plugin-troubleshooting.md)
295-
- [Aegis to Orca migration](docs/migration-aegis-to-orca.md)
295+
- [Migration from Aegis to Orca](docs/migration-aegis-to-orca.md)
296296

297297
---
298298

β€ŽVERSIONβ€Ž

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
1.1.0
1+
1.1.1

0 commit comments

Comments
Β (0)