gabbe-kit 1.0.0 → 1.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +22 -6
- package/docs/INSTALL.md +17 -8
- package/docs/POST_INSTALL.md +7 -3
- package/docs/QUICK_GUIDE.md +1 -1
- package/install.ps1 +6 -6
- package/install.sh +6 -6
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -19,7 +19,7 @@
|
|
|
19
19
|
- The system features an experimental **Meta-Cognitive Orchestrator "Brain"** (Neurocognitive based architecture derived from Neuroscience, Cognitive Psychology, Epistemology, treating the Software System not as a machine, but as a **Cognitive Entity**), using Active Inference to plan, route, and optimize work.
|
|
20
20
|
- The system features a **Multi-Agent Swarm "Loki" Engineering Team** (30+ specialized agent roles for large projects), providing episodic and semantic memory, project history auditing and checkpoints.
|
|
21
21
|
- Experimental support for budget enforcement, tokens, hard stops, policy rules, cli tool gateway (via MCP server), audit tracing and logs, human escalation, and deterministic replay, with built-in rules for agents to select the best specialized skills/guides, proactively recommend necessary MCP servers, and default to continuous cost & budget optimization—always requiring human approval for expensive operations.
|
|
22
|
-
- **v1.0** extends the framework to a **cradle-to-grave ADLC (S00–S13)** — Day-0 Strategy & Discovery (S00) through the S01–S10 SDLC to Day-2 Operate/Evolve/Decommission (S11–S13), grounded in named industry methods (ADD 3.0, ATAM, Wardley, JTBD, RICE, DORA/SPACE, ADKAR) — and adds an **evals + standards-grounded guardrails layer** (eval-driven development, LLM-as-judge, RAG/trajectory evals, plus prompt-injection-defense and output-validation mapped to OWASP LLM Top 10 / NIST AI RMF / MITRE ATLAS / ISO 42001 / EU AI Act), **advanced testing** (property-based, metamorphic, chaos/fault-injection, and mutation testing; `gabbe verify --chaos`), and **one-command, multi-OS install with autodetect** (`gabbe doctor` reports OS/arch, runtimes, and detected agents;
|
|
22
|
+
- **v1.0** extends the framework to a **cradle-to-grave ADLC (S00–S13)** — Day-0 Strategy & Discovery (S00) through the S01–S10 SDLC to Day-2 Operate/Evolve/Decommission (S11–S13), grounded in named industry methods (ADD 3.0, ATAM, Wardley, JTBD, RICE, DORA/SPACE, ADKAR) — and adds an **evals + standards-grounded guardrails layer** (eval-driven development, LLM-as-judge, RAG/trajectory evals, plus prompt-injection-defense and output-validation mapped to OWASP LLM Top 10 / NIST AI RMF / MITRE ATLAS / ISO 42001 / EU AI Act), **advanced testing** (property-based, metamorphic, chaos/fault-injection, and mutation testing; `gabbe verify --chaos`), and **one-command, multi-OS install with autodetect** (`gabbe doctor` reports OS/arch, runtimes, and detected agents; `update`/`uninstall` are manifest-backed for `gabbe`-CLI-managed kits via `.gabbe/manifest.json`). The "world-first" framing stays honest: the **self-evolving "genes" / brain-inference-via-skills** model is a conceptual framing — the production brain is epsilon-greedy with a monotonic success-rate, and evals/PBT **sample and raise confidence, they do not prove**.
|
|
23
23
|
|
|
24
24
|
It contains:
|
|
25
25
|
- **214 Skills** (specialized capabilities)
|
|
@@ -48,6 +48,17 @@ It contains:
|
|
|
48
48
|
|
|
49
49
|
### ⚡ Automated Setup (Recommended)
|
|
50
50
|
|
|
51
|
+
**All install options at a glance** (every channel is a single command — pick one):
|
|
52
|
+
|
|
53
|
+
| Channel | One-command install | Notes |
|
|
54
|
+
|---|---|---|
|
|
55
|
+
| **npm / Node** | `npx gabbe-kit init` | Python-independent; bundles the kit & wires detected agents |
|
|
56
|
+
| **PyPI** | `pipx install gabbe` | adds the `gabbe` **CLI** (doctor/brain/route/gateway); install the kit via npx / curl / checkout |
|
|
57
|
+
| **Shell bootstrap** | `curl -fsSL https://raw.githubusercontent.com/andreibesleaga/GABBE/main/install.sh \| sh` | picks the best available installer |
|
|
58
|
+
| **Git checkout** | `git clone https://github.com/andreibesleaga/GABBE && cd GABBE && python3 scripts/init.py` | the interactive wizard |
|
|
59
|
+
|
|
60
|
+
> On npm the package is **`gabbe-kit`** (npm refuses the unscoped `gabbe`); on PyPI it is **`gabbe`**. The installed command is `gabbe` either way. After installing, run `gabbe doctor` for an environment + install report. Full guide: [`docs/INSTALL.md`](docs/INSTALL.md).
|
|
61
|
+
|
|
51
62
|
**Universal, Python-independent (one command):**
|
|
52
63
|
```bash
|
|
53
64
|
npx gabbe-kit init # Node installer — bundles the kit, wires every agent
|
|
@@ -56,10 +67,12 @@ npx gabbe-kit init --agents claude,cursor,antigravity,opencode --yes # non-int
|
|
|
56
67
|
curl -fsSL https://raw.githubusercontent.com/andreibesleaga/GABBE/main/install.sh | sh
|
|
57
68
|
```
|
|
58
69
|
|
|
59
|
-
**Python
|
|
70
|
+
**Python / PyPI:**
|
|
60
71
|
```bash
|
|
61
|
-
|
|
62
|
-
|
|
72
|
+
pipx install gabbe # installs the `gabbe` CLI (doctor / brain / route / gateway)
|
|
73
|
+
# the kit is Python-independent — land it into a project with:
|
|
74
|
+
npx gabbe-kit init # (or `curl … | sh`)
|
|
75
|
+
python3 scripts/init.py # …or the wizard from a checkout (equivalent to `gabbe setup`)
|
|
63
76
|
```
|
|
64
77
|
|
|
65
78
|
The installer is a **Universal Skill Compiler** — it generates the correct format for each AI tool:
|
|
@@ -703,10 +716,13 @@ GABBE has also an experimental helper, **Zero-Dependency CLI** (`gabbe`) for a "
|
|
|
703
716
|
| `GABBE_OTEL_ENABLED` | `false` | Enable OpenTelemetry tracing |
|
|
704
717
|
|
|
705
718
|
### Installation
|
|
706
|
-
The CLI is a Python package
|
|
719
|
+
The CLI is a Python package, published on PyPI as **`gabbe`**.
|
|
707
720
|
|
|
708
721
|
```bash
|
|
709
|
-
#
|
|
722
|
+
# 1a. Install from PyPI (recommended)
|
|
723
|
+
pipx install gabbe # or: pip install gabbe / uvx gabbe
|
|
724
|
+
|
|
725
|
+
# 1b. …or install locally from a checkout (for development)
|
|
710
726
|
pip install -e .
|
|
711
727
|
|
|
712
728
|
# 2. Verify installation
|
package/docs/INSTALL.md
CHANGED
|
@@ -1,16 +1,23 @@
|
|
|
1
1
|
# Installing, Updating & Uninstalling GABBE
|
|
2
2
|
|
|
3
|
-
GABBE installs are **
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
|
|
3
|
+
GABBE installs are **isolated**: nothing is ever written outside the chosen target
|
|
4
|
+
unless you pass `--global`.
|
|
5
|
+
|
|
6
|
+
> **Reversibility — scope.** Manifest-backed, precise `update`/`uninstall` (recorded
|
|
7
|
+
> in `.gabbe/manifest.json`) covers kits managed by the Python `gabbe` CLI — i.e.
|
|
8
|
+
> after a `gabbe update` from a checkout / editable install, which writes the
|
|
9
|
+
> manifest. The Python-independent installers (`npx gabbe-kit init`, `curl … | sh`,
|
|
10
|
+
> and the `scripts/init.py` wizard) copy the kit but do **not** write a manifest, so
|
|
11
|
+
> `gabbe uninstall` cannot auto-reverse them — remove those manually (delete the
|
|
12
|
+
> created `agents/`, `.agents/`, per-agent dirs, and root `AGENTS.md`), or run
|
|
13
|
+
> `gabbe update` from a checkout to begin manifest tracking.
|
|
7
14
|
|
|
8
15
|
## One-command install (every channel)
|
|
9
16
|
|
|
10
17
|
| Channel | Command | Notes |
|
|
11
18
|
|---|---|---|
|
|
12
19
|
| npm / Node | `npx gabbe-kit init` | Python-independent; bundles the kit and wires detected agents |
|
|
13
|
-
| PyPI | `pipx install gabbe
|
|
20
|
+
| PyPI | `pipx install gabbe` (or `pip install gabbe` / `uvx gabbe`) | adds the `gabbe` **CLI** (doctor/brain/route/gateway). The kit is Python-independent — land it with `npx gabbe-kit init` / `curl … \| sh` / a checkout. `gabbe setup` wires the kit only from a checkout. |
|
|
14
21
|
| Shell bootstrap | `curl -fsSL https://raw.githubusercontent.com/andreibesleaga/GABBE/main/install.sh \| sh` | picks the best available installer |
|
|
15
22
|
| Git checkout | `git clone … && python3 scripts/init.py` | the interactive wizard |
|
|
16
23
|
|
|
@@ -38,7 +45,7 @@ gabbe update # additive refresh of kit files; prunes orphans
|
|
|
38
45
|
your memory/project files; it only refreshes managed kit artifacts and removes
|
|
39
46
|
ones that are no longer emitted.
|
|
40
47
|
|
|
41
|
-
## Uninstalling (
|
|
48
|
+
## Uninstalling (manifest-backed installs)
|
|
42
49
|
|
|
43
50
|
```bash
|
|
44
51
|
gabbe uninstall --dry-run # print exactly what would be removed
|
|
@@ -56,8 +63,10 @@ pwsh ./uninstall.ps1 -DryRun # Windows / PowerShell
|
|
|
56
63
|
|
|
57
64
|
Uninstall reads `.gabbe/manifest.json`, removes **exactly** what was installed,
|
|
58
65
|
restores any shadowed user files from their `.bak`, prunes now-empty directories,
|
|
59
|
-
and is idempotent (safe to run twice).
|
|
60
|
-
pre-install state.
|
|
66
|
+
and is idempotent (safe to run twice). When a manifest is present the result is
|
|
67
|
+
byte-identical to the pre-install state. **Note:** `npx` / `curl` / wizard installs
|
|
68
|
+
are not manifest-tracked (see the scope note at the top); for those, delete the kit
|
|
69
|
+
directories manually or run `gabbe update` from a checkout first.
|
|
61
70
|
|
|
62
71
|
## Verification
|
|
63
72
|
|
package/docs/POST_INSTALL.md
CHANGED
|
@@ -68,8 +68,12 @@ gabbe eval # deterministic skill-eval self-check
|
|
|
68
68
|
## 5. Updating / uninstalling later
|
|
69
69
|
|
|
70
70
|
```bash
|
|
71
|
-
gabbe update # additive kit refresh; preserves user files
|
|
72
|
-
gabbe uninstall --dry-run # preview the exact
|
|
71
|
+
gabbe update # additive kit refresh; preserves user files (writes the manifest)
|
|
72
|
+
gabbe uninstall --dry-run # preview the exact removal (manifest-backed installs only)
|
|
73
73
|
```
|
|
74
74
|
|
|
75
|
-
|
|
75
|
+
`update`/`uninstall` are manifest-backed for kits managed by the Python `gabbe`
|
|
76
|
+
CLI. `npx` / `curl` / wizard installs aren't manifest-tracked — run `gabbe update`
|
|
77
|
+
from a checkout first, or remove the kit directories manually. See
|
|
78
|
+
`docs/INSTALL.md` for scopes (project / `--global` / `--dir`), channels, and the
|
|
79
|
+
full reversibility scope note.
|
package/docs/QUICK_GUIDE.md
CHANGED
|
@@ -129,7 +129,7 @@ python scripts/fill_placeholders.py
|
|
|
129
129
|
| `gabbe verify --chaos` | **Resilience**: fault-injection self-checks (fail-closed tool, hard-stop, escalation). |
|
|
130
130
|
| `gabbe eval` | **Skill evals**: deterministic self-check; `--live` scores via the model. |
|
|
131
131
|
| `gabbe doctor` | **Autodetect**: OS/runtimes/agents + post-install MCP next-steps. |
|
|
132
|
-
| `gabbe update` / `gabbe uninstall` |
|
|
132
|
+
| `gabbe update` / `gabbe uninstall` | Additive refresh / manifest-backed removal (for `gabbe`-CLI-managed kits; npx/curl/wizard installs aren't manifest-tracked). |
|
|
133
133
|
| `gabbe status`| **Dashboard**: Visualizes project phase and task progress. |
|
|
134
134
|
| `gabbe brain` | **Meta-Cognition**: Activates Active Inference loop or Evolutionary Prompt Optimization (Requires API Key). |
|
|
135
135
|
| `gabbe route` | **Cost Router**: Arbitrates between Local and Remote LLMs based on task complexity (Requires API Key). |
|
package/install.ps1
CHANGED
|
@@ -5,7 +5,7 @@
|
|
|
5
5
|
# irm https://raw.githubusercontent.com/andreibesleaga/GABBE/main/install.ps1 | iex
|
|
6
6
|
#
|
|
7
7
|
# Picks the best available installer:
|
|
8
|
-
# 1. Node present -> `npx --yes gabbe init` (Python-independent path).
|
|
8
|
+
# 1. Node present -> `npx --yes gabbe-kit init` (Python-independent path).
|
|
9
9
|
# 2. Else python -> `python scripts/init.py` (the interactive wizard).
|
|
10
10
|
#
|
|
11
11
|
# No destructive operations: it only runs an installer that copies the kit into
|
|
@@ -28,7 +28,7 @@ Usage:
|
|
|
28
28
|
.\install.ps1 [installer-args...]
|
|
29
29
|
|
|
30
30
|
Behavior:
|
|
31
|
-
- If Node is installed, runs: npx --yes gabbe init [args...]
|
|
31
|
+
- If Node is installed, runs: npx --yes gabbe-kit init [args...]
|
|
32
32
|
- Else if Python is installed: python scripts/init.py
|
|
33
33
|
- Otherwise, prints how to install Node or Python and exits non-zero.
|
|
34
34
|
|
|
@@ -54,14 +54,14 @@ if ($Args) { $passthru = $Args }
|
|
|
54
54
|
|
|
55
55
|
if ((Test-Cmd 'node') -and (Test-Cmd 'npx')) {
|
|
56
56
|
$ver = (& node --version)
|
|
57
|
-
Write-Output "-> Node detected ($ver). Using: npx --yes gabbe init"
|
|
58
|
-
& npx --yes gabbe init @passthru
|
|
57
|
+
Write-Output "-> Node detected ($ver). Using: npx --yes gabbe-kit init"
|
|
58
|
+
& npx --yes gabbe-kit init @passthru
|
|
59
59
|
exit $LASTEXITCODE
|
|
60
60
|
}
|
|
61
61
|
|
|
62
62
|
if (Test-Cmd 'npx') {
|
|
63
|
-
Write-Output '-> npx detected. Using: npx --yes gabbe init'
|
|
64
|
-
& npx --yes gabbe init @passthru
|
|
63
|
+
Write-Output '-> npx detected. Using: npx --yes gabbe-kit init'
|
|
64
|
+
& npx --yes gabbe-kit init @passthru
|
|
65
65
|
exit $LASTEXITCODE
|
|
66
66
|
}
|
|
67
67
|
|
package/install.sh
CHANGED
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
# curl -fsSL https://raw.githubusercontent.com/andreibesleaga/GABBE/main/install.sh | sh
|
|
7
7
|
#
|
|
8
8
|
# Picks the best available installer for your machine:
|
|
9
|
-
# 1. Node present -> `npx --yes gabbe init` (Python-independent path).
|
|
9
|
+
# 1. Node present -> `npx --yes gabbe-kit init` (Python-independent path).
|
|
10
10
|
# 2. Else python3 -> `python3 scripts/init.py` (the interactive wizard).
|
|
11
11
|
#
|
|
12
12
|
# It performs no destructive operations: it only runs an installer that copies
|
|
@@ -25,7 +25,7 @@ Usage:
|
|
|
25
25
|
sh install.sh [installer-args...]
|
|
26
26
|
|
|
27
27
|
Behavior:
|
|
28
|
-
- If Node is installed, runs: npx --yes gabbe init [args...]
|
|
28
|
+
- If Node is installed, runs: npx --yes gabbe-kit init [args...]
|
|
29
29
|
- Else if python3 is installed: python3 scripts/init.py
|
|
30
30
|
- Otherwise, prints how to install Node or Python and exits non-zero.
|
|
31
31
|
|
|
@@ -59,13 +59,13 @@ fi
|
|
|
59
59
|
echo "GABBE installer: detecting runtime..."
|
|
60
60
|
|
|
61
61
|
if have node && have npx; then
|
|
62
|
-
echo "→ Node detected ($(node --version)). Using: npx --yes gabbe init"
|
|
63
|
-
exec npx --yes gabbe init "$@"
|
|
62
|
+
echo "→ Node detected ($(node --version)). Using: npx --yes gabbe-kit init"
|
|
63
|
+
exec npx --yes gabbe-kit init "$@"
|
|
64
64
|
fi
|
|
65
65
|
|
|
66
66
|
if have npx; then
|
|
67
|
-
echo "→ npx detected. Using: npx --yes gabbe init"
|
|
68
|
-
exec npx --yes gabbe init "$@"
|
|
67
|
+
echo "→ npx detected. Using: npx --yes gabbe-kit init"
|
|
68
|
+
exec npx --yes gabbe-kit init "$@"
|
|
69
69
|
fi
|
|
70
70
|
|
|
71
71
|
if have python3; then
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "gabbe-kit",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.1",
|
|
4
4
|
"description": "GABBE - Generative Architectural Brain Base Engine. A Markdown agentic engineering kit installer (Python-independent). Wires AGENTS.md, skills, and per-agent rule files into any project.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"agentic",
|