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 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; install/update/uninstall are fully reversible via a `.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**.
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 wizard (full interactive, also via PyPI):**
70
+ **Python / PyPI:**
60
71
  ```bash
61
- python3 scripts/init.py # from a checkout
62
- gabbe setup # if the optional gabbe CLI is installed (pipx/uvx/pip)
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
- # 1. Install locally (Recommended)
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 **manifest-backed, reversible, and isolated**: every install
4
- records exactly what it created in `.gabbe/manifest.json`, so `update` and
5
- `uninstall` are precise and never touch unrelated files. Nothing is ever written
6
- outside the chosen target unless you pass `--global`.
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 && gabbe setup` (or `pip install gabbe`) | adds the `gabbe` CLI |
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 (fully reversible)
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). The result is byte-identical to the
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
 
@@ -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, reversible removal
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
- See `docs/INSTALL.md` for scopes (project / `--global` / `--dir`) and channels.
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.
@@ -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` | **Reversible install**: additive refresh / manifest-backed removal. |
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.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",