swadhin / contexa public

refactor: rename project from 'cortexa' to 'contexa' across root files and CI

Swadhin Biswas committed 7 months ago
619eb5e
1 parent b34e9d6
commit 619eb5e
8 files changed
+55 -55
Showing 8 changed files+55-55
.github/ISSUE_TEMPLATE/bug_report.yml.github/ISSUE_TEMPLATE/feature_request.yml.github/ISSUE_TEMPLATE/question.yml.github/workflows/ci.yml.github/workflows/publish.ymlCONTRIBUTING.mdREADME.mdSECURITY.md
▼.github/ISSUE_TEMPLATE/bug_report.yml
+3-3
@@ -1,5 +1,5 @@
1
1
name: Bug Report
2
-description: Report a bug in cortexa
2
+description: Report a bug in contexa
3
3
title: "[Bug]: "
4
4
labels: ["bug"]
5
5
body:
@@ -29,7 +29,7 @@ body:
29
29
id: version
30
30
attributes:
31
31
label: Package Version
32
- description: "Which version of cortexa are you using? (e.g. 0.1.1)"
32
+ description: "Which version of contexa are you using? (e.g. 0.1.1)"
33
33
placeholder: "0.1.1"
34
34
validations:
35
35
required: true
@@ -106,5 +106,5 @@ body:
106
106
options:
107
107
- label: I have searched existing issues and this hasn't been reported before
108
108
required: true
109
- - label: I am using the latest version of cortexa
109
+ - label: I am using the latest version of contexa
110
110
required: false
111
111
▼.github/ISSUE_TEMPLATE/feature_request.yml
+1-1
@@ -1,5 +1,5 @@
1
1
name: Feature Request
2
-description: Suggest a new feature or enhancement for cortexa
2
+description: Suggest a new feature or enhancement for contexa
3
3
title: "[Feature]: "
4
4
labels: ["enhancement"]
5
5
body:
6
6
▼.github/ISSUE_TEMPLATE/question.yml
+2-2
@@ -1,12 +1,12 @@
1
1
name: Question
2
-description: Ask a question about using cortexa
2
+description: Ask a question about using contexa
3
3
title: "[Question]: "
4
4
labels: ["question"]
5
5
body:
6
6
- type: markdown
7
7
attributes:
8
8
value: |
9
- Have a question about using cortexa? Ask below. For bugs, please use the Bug Report template instead.
9
+ Have a question about using contexa? Ask below. For bugs, please use the Bug Report template instead.
10
10
11
11
- type: dropdown
12
12
id: language
13
13
▼.github/workflows/ci.yml
+1-1
@@ -117,7 +117,7 @@ jobs:
117
117
run: go build ./...
118
118
119
119
- name: Run tests
120
- run: go test -v ./cortexa/
120
+ run: go test -v ./contexa/
121
121
122
122
# ── Zig ─────────────────────────────────────────────────────────────
123
123
test-zig:
124
124
▼.github/workflows/publish.yml
+10-10
@@ -81,7 +81,7 @@ jobs:
81
81
cache-dependency-path: GO/go.sum
82
82
- run: go mod download
83
83
- run: go build ./...
84
- - run: go test -v ./cortexa/
84
+ - run: go test -v ./contexa/
85
85
86
86
test-zig:
87
87
name: Test Zig
@@ -227,7 +227,7 @@ jobs:
227
227
- name: Publish to LuaRocks
228
228
env:
229
229
LUAROCKS_API_KEY: ${{ secrets.LUAROCKS_API_KEY }}
230
- run: luarocks upload cortexa-0.1.1-1.rockspec --api-key="$LUAROCKS_API_KEY"
230
+ run: luarocks upload contexa-0.1.1-1.rockspec --api-key="$LUAROCKS_API_KEY"
231
231
232
232
# ── Publish Elixir to Hex.pm ────────────────────────────────────────
233
233
publish-elixir:
@@ -284,7 +284,7 @@ jobs:
284
284
TAG="${{ steps.version.outputs.version }}"
285
285
{
286
286
echo "notes<<EOF"
287
- echo "## cortexa $TAG"
287
+ echo "## contexa $TAG"
288
288
echo ""
289
289
echo "Git-inspired context management for LLM agents — COMMIT, BRANCH, MERGE, and CONTEXT operations over a persistent versioned memory workspace."
290
290
echo ""
@@ -292,12 +292,12 @@ jobs:
292
292
echo ""
293
293
echo "| Language | Command |"
294
294
echo "|----------|---------|"
295
- echo "| Python | \`pip install cortexa\` |"
296
- echo "| JS/TS | \`npm install cortexa\` |"
297
- echo "| Rust | \`cargo add cortexa-gcc\` |"
298
- echo "| Go | \`go get github.com/swadhinbiswas/Cortexa/GO/cortexa@GO/$TAG\` |"
299
- echo "| Lua | \`luarocks install cortexa\` |"
300
- echo "| Elixir | \`{:cortexa, \"~> 0.1.1\"}\` in mix.exs |"
295
+ echo "| Python | \`pip install contexa\` |"
296
+ echo "| JS/TS | \`npm install contexa\` |"
297
+ echo "| Rust | \`cargo add contexa-gcc\` |"
298
+ echo "| Go | \`go get github.com/swadhinbiswas/Cortexa/GO/contexa@GO/$TAG\` |"
299
+ echo "| Lua | \`luarocks install contexa\` |"
300
+ echo "| Elixir | \`{:contexa, \"~> 0.1.1\"}\` in mix.exs |"
301
301
echo "| Zig | Add dependency via \`build.zig.zon\` (see README) |"
302
302
echo ""
303
303
echo "### Changes"
@@ -311,7 +311,7 @@ jobs:
311
311
uses: softprops/action-gh-release@v2
312
312
with:
313
313
tag_name: ${{ steps.version.outputs.version }}
314
- name: "cortexa ${{ steps.version.outputs.version }}"
314
+ name: "contexa ${{ steps.version.outputs.version }}"
315
315
body: ${{ steps.notes.outputs.notes }}
316
316
draft: false
317
317
prerelease: ${{ contains(steps.version.outputs.version, '-') }}
318
318
▼CONTRIBUTING.md
+5-5
@@ -1,6 +1,6 @@
1
-# Contributing to cortexa
1
+# Contributing to contexa
2
2
3
-Thank you for your interest in contributing to **cortexa** — git-inspired context management for LLM agents.
3
+Thank you for your interest in contributing to **contexa** — git-inspired context management for LLM agents.
4
4
5
5
This is a polyglot monorepo with implementations in **Python, JavaScript/TypeScript, Rust, Go, Zig, Lua, and Elixir**. Contributions to any language are welcome.
6
6
@@ -23,8 +23,8 @@ This project follows the [Contributor Covenant v2.1](CODE_OF_CONDUCT.md). By par
23
23
1. Fork the repository: <https://github.com/swadhinbiswas/Cortexa>
24
24
2. Clone your fork:
25
25
```bash
26
- git clone https://github.com/<your-username>/cortexa.git
27
- cd cortexa
26
+ git clone https://github.com/<your-username>/contexa.git
27
+ cd contexa
28
28
```
29
29
3. Create a feature branch:
30
30
```bash
@@ -131,7 +131,7 @@ CI runs all 7 language test suites on every pull request. Your PR must pass all
131
131
- **Rust**: Run `cargo fmt` and `cargo clippy` before committing.
132
132
- **Go**: Run `gofmt` and `go vet`.
133
133
- **Zig**: Follow the [Zig style guide](https://ziglang.org/documentation/master/#Style-Guide).
134
-- **Lua**: Follow the existing style in `LUA/cortexa/`.
134
+- **Lua**: Follow the existing style in `LUA/contexa/`.
135
135
- **Elixir**: Run `mix format` before committing.
136
136
137
137
## Labels
138
138
▼README.md
+31-31
@@ -10,11 +10,11 @@
10
10
<p align="center">
11
11
<a href="LICENSE"><img src="https://img.shields.io/badge/License-MIT-green.svg" alt="License: MIT" /></a>
12
12
<a href="https://arxiv.org/abs/2508.00031"><img src="https://img.shields.io/badge/arXiv-2508.00031-b31b1b.svg" alt="arXiv" /></a>
13
- <a href="https://pypi.org/project/cortexa/"><img src="https://img.shields.io/pypi/v/cortexa.svg" alt="PyPI" /></a>
14
- <a href="https://www.npmjs.com/package/cortexa"><img src="https://img.shields.io/npm/v/cortexa.svg" alt="npm" /></a>
15
- <a href="https://crates.io/crates/cortexa"><img src="https://img.shields.io/crates/v/cortexa.svg" alt="crates.io" /></a>
13
+ <a href="https://pypi.org/project/contexa/"><img src="https://img.shields.io/pypi/v/contexa.svg" alt="PyPI" /></a>
14
+ <a href="https://www.npmjs.com/package/contexa"><img src="https://img.shields.io/npm/v/contexa.svg" alt="npm" /></a>
15
+ <a href="https://crates.io/crates/contexa"><img src="https://img.shields.io/crates/v/contexa.svg" alt="crates.io" /></a>
16
16
<a href="https://pkg.go.dev/github.com/swadhinbiswas/Cortexa/GO"><img src="https://pkg.go.dev/badge/github.com/swadhinbiswas/Cortexa/GO.svg" alt="Go Reference" /></a>
17
- <a href="https://hex.pm/packages/cortexa"><img src="https://img.shields.io/hexpm/v/cortexa.svg" alt="Hex.pm" /></a>
17
+ <a href="https://hex.pm/packages/contexa"><img src="https://img.shields.io/hexpm/v/contexa.svg" alt="Hex.pm" /></a>
18
18
</p>
19
19
20
20
---
@@ -74,13 +74,13 @@ Outperforms 26 existing open and commercial agent systems. Key findings:
74
74
75
75
| Language | Package | Install |
76
76
|----------|---------|---------|
77
-| Python | [`cortexa`](https://pypi.org/project/cortexa/) | `pip install cortexa` |
78
-| TypeScript/JS | [`cortexa`](https://www.npmjs.com/package/cortexa) | `npm install cortexa` |
79
-| Rust | [`cortexa-gcc`](https://crates.io/crates/cortexa-gcc) | `cargo add cortexa-gcc` |
80
-| Go | [`cortexa`](https://pkg.go.dev/github.com/swadhinbiswas/Cortexa/GO) | `go get github.com/swadhinbiswas/Cortexa/GO/cortexa` |
81
-| Lua | [`cortexa`](https://luarocks.org/modules/swadhinbiswas/cortexa) | `luarocks install cortexa` |
82
-| Elixir | [`cortexa`](https://hex.pm/packages/cortexa) | `{:cortexa, "~> 0.1.1"}` in mix.exs |
83
-| Zig | `cortexa` | See [Zig README](ZIG/README.md) |
77
+| Python | [`contexa`](https://pypi.org/project/contexa/) | `pip install contexa` |
78
+| TypeScript/JS | [`contexa`](https://www.npmjs.com/package/contexa) | `npm install contexa` |
79
+| Rust | [`contexa-gcc`](https://crates.io/crates/contexa-gcc) | `cargo add contexa-gcc` |
80
+| Go | [`contexa`](https://pkg.go.dev/github.com/swadhinbiswas/Cortexa/GO) | `go get github.com/swadhinbiswas/Cortexa/GO/contexa` |
81
+| Lua | [`contexa`](https://luarocks.org/modules/swadhinbiswas/contexa) | `luarocks install contexa` |
82
+| Elixir | [`contexa`](https://hex.pm/packages/contexa) | `{:contexa, "~> 0.1.1"}` in mix.exs |
83
+| Zig | `contexa` | See [Zig README](ZIG/README.md) |
84
84
85
85
All 7 packages produce the same `.GCC/` file system layout. A workspace created by one language can be read or extended by any other.
86
86
@@ -91,7 +91,7 @@ All 7 packages produce the same `.GCC/` file system layout. A workspace created
91
91
### Python
92
92
93
93
```python
94
-from cortexa import GCCWorkspace
94
+from contexa import GCCWorkspace
95
95
96
96
ws = GCCWorkspace("/path/to/project")
97
97
ws.init("Build a REST API with user auth")
@@ -115,7 +115,7 @@ print(ctx.summary()) # Formatted markdown ready for LLM prompt injection
115
115
### TypeScript
116
116
117
117
```typescript
118
-import { GCCWorkspace } from "cortexa";
118
+import { GCCWorkspace } from "contexa";
119
119
120
120
const ws = new GCCWorkspace("/path/to/project");
121
121
ws.init("Build a REST API");
@@ -131,7 +131,7 @@ console.log(ctx.summary());
131
131
### Rust
132
132
133
133
```rust
134
-use cortexa::GCCWorkspace;
134
+use contexa::GCCWorkspace;
135
135
136
136
let mut ws = GCCWorkspace::new("/path/to/project");
137
137
ws.init("Build a REST API")?;
@@ -147,9 +147,9 @@ println!("{}", ctx.summary());
147
147
### Go
148
148
149
149
```go
150
-import "github.com/swadhinbiswas/Cortexa/GO/cortexa"
150
+import "github.com/swadhinbiswas/Cortexa/GO/contexa"
151
151
152
-ws := cortexa.New("/path/to/project")
152
+ws := contexa.New("/path/to/project")
153
153
ws.Init("Build a REST API")
154
154
ws.LogOTA("saw empty dir", "scaffold first", "createFiles()")
155
155
ws.Commit("Project scaffold done", nil, nil)
@@ -163,9 +163,9 @@ fmt.Println(ctx.Summary())
163
163
### Zig
164
164
165
165
```zig
166
-const cortexa = @import("cortexa");
166
+const contexa = @import("contexa");
167
167
168
-var ws = cortexa.Workspace.init(allocator, "/path/to/project");
168
+var ws = contexa.Workspace.init(allocator, "/path/to/project");
169
169
try ws.create("Build a REST API");
170
170
_ = try ws.logOTA("saw empty dir", "scaffold first", "createFiles()");
171
171
const c = try ws.commit("Project scaffold done", null);
@@ -182,9 +182,9 @@ defer ctx.deinit(allocator);
182
182
### Lua
183
183
184
184
```lua
185
-local cortexa = require("cortexa")
185
+local contexa = require("contexa")
186
186
187
-local ws = cortexa.GCCWorkspace.new("/path/to/project")
187
+local ws = contexa.GCCWorkspace.new("/path/to/project")
188
188
ws:init("Build a REST API")
189
189
ws:log_ota("saw empty dir", "scaffold first", "create_files()")
190
190
ws:commit("Project scaffold done")
@@ -192,7 +192,7 @@ ws:branch("auth-jwt", "Explore JWT authentication")
192
192
ws:commit("JWT middleware implemented")
193
193
ws:merge("auth-jwt", nil, "main")
194
194
local ctx = ws:context("main", 1)
195
-print(cortexa.context_summary(ctx))
195
+print(contexa.context_summary(ctx))
196
196
```
197
197
198
198
### Elixir
@@ -247,13 +247,13 @@ All data is stored as **human-readable Markdown and YAML** -- inspect and debug
247
247
248
248
```
249
249
Cortexa/
250
- PYTHON/ # PyPI: cortexa (Python 3.10+)
251
- JS/ # npm: cortexa (Node.js 18+)
252
- RUST/ # crates.io: cortexa (Rust stable)
250
+ PYTHON/ # PyPI: contexa (Python 3.10+)
251
+ JS/ # npm: contexa (Node.js 18+)
252
+ RUST/ # crates.io: contexa (Rust stable)
253
253
GO/ # pkg.go.dev (Go 1.21+)
254
254
ZIG/ # Zig package (Zig 0.14+)
255
- LUA/ # LuaRocks: cortexa (Lua 5.1+)
256
- ELIXIR/ # Hex.pm: cortexa (Elixir 1.15+)
255
+ LUA/ # LuaRocks: contexa (Lua 5.1+)
256
+ ELIXIR/ # Hex.pm: contexa (Elixir 1.15+)
257
257
assets/ # Logo and visual assets
258
258
```
259
259
@@ -297,10 +297,10 @@ If you use Cortexa in research, please cite the original paper:
297
297
## Links
298
298
299
299
- [Original Paper](https://arxiv.org/abs/2508.00031) -- arXiv:2508.00031v2
300
-- [Python (PyPI)](https://pypi.org/project/cortexa/)
301
-- [TypeScript (npm)](https://www.npmjs.com/package/cortexa)
302
-- [Rust (crates.io)](https://crates.io/crates/cortexa)
300
+- [Python (PyPI)](https://pypi.org/project/contexa/)
301
+- [TypeScript (npm)](https://www.npmjs.com/package/contexa)
302
+- [Rust (crates.io)](https://crates.io/crates/contexa)
303
303
- [Go (pkg.go.dev)](https://pkg.go.dev/github.com/swadhinbiswas/Cortexa/GO)
304
-- [Lua (LuaRocks)](https://luarocks.org/modules/swadhinbiswas/cortexa)
305
-- [Elixir (Hex.pm)](https://hex.pm/packages/cortexa)
304
+- [Lua (LuaRocks)](https://luarocks.org/modules/swadhinbiswas/contexa)
305
+- [Elixir (Hex.pm)](https://hex.pm/packages/contexa)
306
306
- [Author: Swadhin Biswas](https://github.com/swadhinbiswas)
307
307
▼SECURITY.md
+2-2
@@ -9,7 +9,7 @@
9
9
10
10
## Reporting a Vulnerability
11
11
12
-If you discover a security vulnerability in cortexa, please report it responsibly by emailing **[email protected]** with the following information:
12
+If you discover a security vulnerability in contexa, please report it responsibly by emailing **[email protected]** with the following information:
13
13
14
14
- Description of the vulnerability
15
15
- Steps to reproduce
@@ -26,7 +26,7 @@ If you discover a security vulnerability in cortexa, please report it responsibl
26
26
27
27
## Scope
28
28
29
-This security policy covers all 7 language implementations of cortexa:
29
+This security policy covers all 7 language implementations of contexa:
30
30
31
31
- Python
32
32
- JavaScript
33
33