hypergumbo 2.5.1__tar.gz → 2.7.0__tar.gz
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.
- {hypergumbo-2.5.1 → hypergumbo-2.7.0}/.gitignore +21 -2
- {hypergumbo-2.5.1 → hypergumbo-2.7.0}/PKG-INFO +20 -12
- {hypergumbo-2.5.1 → hypergumbo-2.7.0}/README.md +15 -7
- {hypergumbo-2.5.1 → hypergumbo-2.7.0}/pyproject.toml +5 -5
- {hypergumbo-2.5.1 → hypergumbo-2.7.0}/src/hypergumbo/__init__.py +0 -0
- {hypergumbo-2.5.1 → hypergumbo-2.7.0}/src/hypergumbo/__main__.py +0 -0
- {hypergumbo-2.5.1 → hypergumbo-2.7.0}/tests/test_meta.py +0 -0
|
@@ -19,6 +19,7 @@ hypergumbo_capsule/
|
|
|
19
19
|
hypergumbo.results.json
|
|
20
20
|
hypergumbo.results.*.json
|
|
21
21
|
slice.json
|
|
22
|
+
slice.*.json
|
|
22
23
|
|
|
23
24
|
# Agent configuration
|
|
24
25
|
**/*.local.json
|
|
@@ -28,18 +29,34 @@ slice.json
|
|
|
28
29
|
**/.cursor/state/
|
|
29
30
|
**/*-session/
|
|
30
31
|
AUTONOMOUS_MODE.txt
|
|
32
|
+
autonomous_intent.txt
|
|
31
33
|
.agent/LOOP
|
|
32
34
|
.agent/disabled.LOOP
|
|
33
|
-
.agent/last_stop_check.json
|
|
34
35
|
.agent/invariant-ledger.md
|
|
35
|
-
.
|
|
36
|
+
# Per-session transcript pipeline (ADR-0018, per-session amendment 2026-04-08).
|
|
37
|
+
# Each session writes per-session-keyed files. The .last_*/.second_to_last_*
|
|
38
|
+
# global slots are written at session END by rotate-on-session-end.sh.
|
|
39
|
+
.agent/.current_session_transcript.*.jsonl
|
|
40
|
+
.agent/.current_injection_history.*.jsonl
|
|
41
|
+
.agent/.transcript-sync.*.pid
|
|
42
|
+
.agent/.transcript-sync-state.*.json
|
|
43
|
+
.agent/.transcript-poll-state.*
|
|
44
|
+
.agent/.transcript-injection-state.*.json
|
|
36
45
|
.agent/.last_session_transcript.jsonl
|
|
37
46
|
.agent/.second_to_last_transcript.jsonl
|
|
47
|
+
.agent/.last_injection_history.jsonl
|
|
48
|
+
.agent/.second_to_last_injection_history.jsonl
|
|
49
|
+
.agent/.archived-transcripts/
|
|
50
|
+
.agent/.rotation.lock
|
|
51
|
+
# Legacy paths from before the per-session amendment (ignored for one-time
|
|
52
|
+
# upgrade-cleanup safety; may be removed once no repo still has these).
|
|
53
|
+
.agent/.current_session_transcript.jsonl
|
|
38
54
|
.agent/.transcript-sync.pid
|
|
39
55
|
.agent/.transcript-sync-state.json
|
|
40
56
|
.agent/.transcript-poll-state
|
|
41
57
|
.agent/.transcript-injection-state.json
|
|
42
58
|
.agent/.transcript-session-token
|
|
59
|
+
.agent/.current_injection_history.jsonl
|
|
43
60
|
hook-canary.txt
|
|
44
61
|
|
|
45
62
|
# Coverage
|
|
@@ -72,5 +89,7 @@ package-lock.json
|
|
|
72
89
|
.agent/.sync-logs/
|
|
73
90
|
.agent/.training-data.jsonl
|
|
74
91
|
.agent/.training-data-selected.jsonl
|
|
92
|
+
.agent/.training-data-v1-snapshot-*.jsonl
|
|
93
|
+
.agent/.deprecated-datasets/
|
|
75
94
|
.agent/finetuned-model/
|
|
76
95
|
.agent/transcript-model.gguf
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: hypergumbo
|
|
3
|
-
Version: 2.
|
|
3
|
+
Version: 2.7.0
|
|
4
4
|
Summary: Local-first repo behavior map generator
|
|
5
5
|
Author: Hypergumbo contributors
|
|
6
6
|
License: AGPL-3.0-or-later
|
|
@@ -10,10 +10,10 @@ Classifier: License :: OSI Approved :: GNU Affero General Public License v3 or l
|
|
|
10
10
|
Classifier: Programming Language :: Python :: 3
|
|
11
11
|
Classifier: Programming Language :: Python :: 3 :: Only
|
|
12
12
|
Requires-Python: >=3.10
|
|
13
|
-
Requires-Dist: hypergumbo-core==2.
|
|
14
|
-
Requires-Dist: hypergumbo-lang-common==2.
|
|
15
|
-
Requires-Dist: hypergumbo-lang-extended1==2.
|
|
16
|
-
Requires-Dist: hypergumbo-lang-mainstream==2.
|
|
13
|
+
Requires-Dist: hypergumbo-core==2.7.0
|
|
14
|
+
Requires-Dist: hypergumbo-lang-common==2.7.0
|
|
15
|
+
Requires-Dist: hypergumbo-lang-extended1==2.7.0
|
|
16
|
+
Requires-Dist: hypergumbo-lang-mainstream==2.7.0
|
|
17
17
|
Provides-Extra: dev
|
|
18
18
|
Requires-Dist: bandit~=1.9.3; extra == 'dev'
|
|
19
19
|
Requires-Dist: check-jsonschema~=0.36.1; extra == 'dev'
|
|
@@ -150,6 +150,8 @@ hypergumbo . -t 8000 # detailed with many symbols
|
|
|
150
150
|
hypergumbo [path] # Markdown sketch (default)
|
|
151
151
|
hypergumbo run [path] # Full JSON behavior map
|
|
152
152
|
hypergumbo slice --entry X # Subgraph from entry point
|
|
153
|
+
hypergumbo io-boundaries # Find all I/O (filesystem, network, subprocess, env)
|
|
154
|
+
hypergumbo verify-claims ... # Verify security claims against analysis
|
|
153
155
|
hypergumbo routes [path] # List HTTP routes
|
|
154
156
|
hypergumbo search <query> # Search symbols
|
|
155
157
|
hypergumbo symbols [path] # Browse symbols with connectivity
|
|
@@ -160,8 +162,8 @@ hypergumbo catalog # List analysis passes
|
|
|
160
162
|
|
|
161
163
|
Useful flags:
|
|
162
164
|
```bash
|
|
163
|
-
hypergumbo . -x # exclude test files (
|
|
164
|
-
hypergumbo . --
|
|
165
|
+
hypergumbo . -x # exclude test files (cleaner output)
|
|
166
|
+
hypergumbo . --no-source # omit source code (included by default)
|
|
165
167
|
hypergumbo . --no-progress # hide progress indicator (on by default)
|
|
166
168
|
hypergumbo --help --all # comprehensive help for all commands
|
|
167
169
|
```
|
|
@@ -178,8 +180,11 @@ See `hypergumbo --help` for all options.
|
|
|
178
180
|
## What It Understands
|
|
179
181
|
|
|
180
182
|
- **Language analyzers**: Python, JS/TS, Java, Rust, Go, C/C++, and [many more](https://codeberg.org/iterabloom/hypergumbo/src/branch/dev/docs/LANGUAGES.md)
|
|
181
|
-
- **
|
|
183
|
+
- **Linkers**: Tier 2 edge-recovery passes across four subcategories — Protocol (HTTP, WebSocket, message queues, SQL), Bridge (JNI, wasm_bindgen, Tauri IPC, language-pair FFI), Framework (gRPC, GraphQL, React components, DI resolution, ORM), Infrastructure (containment, inheritance, module imports). [Full catalogue](https://codeberg.org/iterabloom/hypergumbo/src/branch/dev/docs/LINKERS.md).
|
|
182
184
|
- **Framework patterns**: FastAPI, Django, Rails, Spring Boot, Phoenix, Express, and [many more](https://codeberg.org/iterabloom/hypergumbo/src/branch/dev/docs/FRAMEWORKS.md)
|
|
185
|
+
- **I/O boundary detection**: Maps every call chain that reaches the filesystem, network, subprocesses, or environment — across FFI boundaries
|
|
186
|
+
- **Taint-flow analysis**: Traces data from sensitive sources (crypto keys, plaintext) to sinks (filesystem, network), with sanitizer awareness
|
|
187
|
+
- **Supply chain tiers**: Classifies code as first-party, internal, external, or derived for dependency-aware analysis
|
|
183
188
|
|
|
184
189
|
## How It Works
|
|
185
190
|
|
|
@@ -187,7 +192,9 @@ See `hypergumbo --help` for all options.
|
|
|
187
192
|
2. **Analyze**: Run language-specific analyzers to extract symbols and edges
|
|
188
193
|
3. **Link**: Connect symbols across language boundaries (JS fetch → Python route)
|
|
189
194
|
4. **Enrich**: Detect frameworks via YAML pattern matching
|
|
190
|
-
5. **
|
|
195
|
+
5. **Classify**: Assign supply chain tiers (first-party, internal, external, derived)
|
|
196
|
+
6. **Trace I/O**: Map call chains to I/O boundaries; run taint-flow analysis
|
|
197
|
+
7. **Output**: Generate Markdown sketch or JSON behavior map
|
|
191
198
|
|
|
192
199
|
### The Internal Representation
|
|
193
200
|
|
|
@@ -197,7 +204,7 @@ All analyzers produce the same IR types:
|
|
|
197
204
|
- **Edge**: A relationship between symbols (calls, imports, extends, implements)
|
|
198
205
|
- **Span**: Source location (file, line, column)
|
|
199
206
|
|
|
200
|
-
This uniform IR is what allows all language analyzers and
|
|
207
|
+
This uniform IR is what allows all language analyzers and linkers (Protocol / Bridge / Framework / Infrastructure — see [ADR-0003-ext](https://codeberg.org/iterabloom/hypergumbo/src/branch/dev/docs/adr/0003-linker-subcategory-restoration.md)) to work together coherently.
|
|
201
208
|
|
|
202
209
|
## Architecture
|
|
203
210
|
|
|
@@ -209,7 +216,7 @@ packages/
|
|
|
209
216
|
│ ├── ir.py # Symbol, Edge, Span
|
|
210
217
|
│ ├── sketch.py # Token-budgeted Markdown
|
|
211
218
|
│ ├── slice.py # Subgraph extraction
|
|
212
|
-
│ ├── linkers/ #
|
|
219
|
+
│ ├── linkers/ # Tier 2 edge-recovery passes (Protocol/Bridge/Framework/Infrastructure)
|
|
213
220
|
│ └── frameworks/ # Framework detection (YAML patterns)
|
|
214
221
|
├── hypergumbo-lang-mainstream/ # Python, JS, Java, Go, Rust, etc.
|
|
215
222
|
├── hypergumbo-lang-common/ # Haskell, Elixir, GraphQL, etc.
|
|
@@ -244,11 +251,12 @@ See [CONTRIBUTING.md](CONTRIBUTING.md) for PR workflow (including fork-based wor
|
|
|
244
251
|
- [docs/USE-CASES.md](https://codeberg.org/iterabloom/hypergumbo/src/branch/dev/docs/USE-CASES.md) — Practical workflows and examples
|
|
245
252
|
- [CHANGELOG.md](https://codeberg.org/iterabloom/hypergumbo/src/branch/dev/CHANGELOG.md) — Implementation history
|
|
246
253
|
- [docs/LANGUAGES.md](https://codeberg.org/iterabloom/hypergumbo/src/branch/dev/docs/LANGUAGES.md) — Supported languages
|
|
247
|
-
- [docs/LINKERS.md](https://codeberg.org/iterabloom/hypergumbo/src/branch/dev/docs/LINKERS.md) —
|
|
254
|
+
- [docs/LINKERS.md](https://codeberg.org/iterabloom/hypergumbo/src/branch/dev/docs/LINKERS.md) — Linkers catalogue (Protocol / Bridge / Framework / Infrastructure)
|
|
248
255
|
- [docs/FRAMEWORKS.md](https://codeberg.org/iterabloom/hypergumbo/src/branch/dev/docs/FRAMEWORKS.md) — Framework patterns
|
|
249
256
|
- [docs/hypergumbo-spec.md](https://codeberg.org/iterabloom/hypergumbo/src/branch/dev/docs/hypergumbo-spec.md) — Detailed specification
|
|
250
257
|
- [docs/CITATIONS.md](https://codeberg.org/iterabloom/hypergumbo/src/branch/dev/docs/CITATIONS.md) — Paper citations for embedding models
|
|
251
258
|
- [docs/CACHE.md](https://codeberg.org/iterabloom/hypergumbo/src/branch/dev/docs/CACHE.md) — Caching architecture
|
|
259
|
+
- [docs/agent-supervisor.md](https://codeberg.org/iterabloom/hypergumbo/src/branch/dev/docs/agent-supervisor.md) — Operator guide for `scripts/agent-supervisor` (the tmux-session watchdog for autonomous agents)
|
|
252
260
|
- [SECURITY.md](https://codeberg.org/iterabloom/hypergumbo/src/branch/dev/SECURITY.md) — Vulnerability reporting
|
|
253
261
|
- [hypergumbo-tracker README](packages/hypergumbo-tracker/README.md) — Standalone tracker for AI agent governance
|
|
254
262
|
|
|
@@ -120,6 +120,8 @@ hypergumbo . -t 8000 # detailed with many symbols
|
|
|
120
120
|
hypergumbo [path] # Markdown sketch (default)
|
|
121
121
|
hypergumbo run [path] # Full JSON behavior map
|
|
122
122
|
hypergumbo slice --entry X # Subgraph from entry point
|
|
123
|
+
hypergumbo io-boundaries # Find all I/O (filesystem, network, subprocess, env)
|
|
124
|
+
hypergumbo verify-claims ... # Verify security claims against analysis
|
|
123
125
|
hypergumbo routes [path] # List HTTP routes
|
|
124
126
|
hypergumbo search <query> # Search symbols
|
|
125
127
|
hypergumbo symbols [path] # Browse symbols with connectivity
|
|
@@ -130,8 +132,8 @@ hypergumbo catalog # List analysis passes
|
|
|
130
132
|
|
|
131
133
|
Useful flags:
|
|
132
134
|
```bash
|
|
133
|
-
hypergumbo . -x # exclude test files (
|
|
134
|
-
hypergumbo . --
|
|
135
|
+
hypergumbo . -x # exclude test files (cleaner output)
|
|
136
|
+
hypergumbo . --no-source # omit source code (included by default)
|
|
135
137
|
hypergumbo . --no-progress # hide progress indicator (on by default)
|
|
136
138
|
hypergumbo --help --all # comprehensive help for all commands
|
|
137
139
|
```
|
|
@@ -148,8 +150,11 @@ See `hypergumbo --help` for all options.
|
|
|
148
150
|
## What It Understands
|
|
149
151
|
|
|
150
152
|
- **Language analyzers**: Python, JS/TS, Java, Rust, Go, C/C++, and [many more](https://codeberg.org/iterabloom/hypergumbo/src/branch/dev/docs/LANGUAGES.md)
|
|
151
|
-
- **
|
|
153
|
+
- **Linkers**: Tier 2 edge-recovery passes across four subcategories — Protocol (HTTP, WebSocket, message queues, SQL), Bridge (JNI, wasm_bindgen, Tauri IPC, language-pair FFI), Framework (gRPC, GraphQL, React components, DI resolution, ORM), Infrastructure (containment, inheritance, module imports). [Full catalogue](https://codeberg.org/iterabloom/hypergumbo/src/branch/dev/docs/LINKERS.md).
|
|
152
154
|
- **Framework patterns**: FastAPI, Django, Rails, Spring Boot, Phoenix, Express, and [many more](https://codeberg.org/iterabloom/hypergumbo/src/branch/dev/docs/FRAMEWORKS.md)
|
|
155
|
+
- **I/O boundary detection**: Maps every call chain that reaches the filesystem, network, subprocesses, or environment — across FFI boundaries
|
|
156
|
+
- **Taint-flow analysis**: Traces data from sensitive sources (crypto keys, plaintext) to sinks (filesystem, network), with sanitizer awareness
|
|
157
|
+
- **Supply chain tiers**: Classifies code as first-party, internal, external, or derived for dependency-aware analysis
|
|
153
158
|
|
|
154
159
|
## How It Works
|
|
155
160
|
|
|
@@ -157,7 +162,9 @@ See `hypergumbo --help` for all options.
|
|
|
157
162
|
2. **Analyze**: Run language-specific analyzers to extract symbols and edges
|
|
158
163
|
3. **Link**: Connect symbols across language boundaries (JS fetch → Python route)
|
|
159
164
|
4. **Enrich**: Detect frameworks via YAML pattern matching
|
|
160
|
-
5. **
|
|
165
|
+
5. **Classify**: Assign supply chain tiers (first-party, internal, external, derived)
|
|
166
|
+
6. **Trace I/O**: Map call chains to I/O boundaries; run taint-flow analysis
|
|
167
|
+
7. **Output**: Generate Markdown sketch or JSON behavior map
|
|
161
168
|
|
|
162
169
|
### The Internal Representation
|
|
163
170
|
|
|
@@ -167,7 +174,7 @@ All analyzers produce the same IR types:
|
|
|
167
174
|
- **Edge**: A relationship between symbols (calls, imports, extends, implements)
|
|
168
175
|
- **Span**: Source location (file, line, column)
|
|
169
176
|
|
|
170
|
-
This uniform IR is what allows all language analyzers and
|
|
177
|
+
This uniform IR is what allows all language analyzers and linkers (Protocol / Bridge / Framework / Infrastructure — see [ADR-0003-ext](https://codeberg.org/iterabloom/hypergumbo/src/branch/dev/docs/adr/0003-linker-subcategory-restoration.md)) to work together coherently.
|
|
171
178
|
|
|
172
179
|
## Architecture
|
|
173
180
|
|
|
@@ -179,7 +186,7 @@ packages/
|
|
|
179
186
|
│ ├── ir.py # Symbol, Edge, Span
|
|
180
187
|
│ ├── sketch.py # Token-budgeted Markdown
|
|
181
188
|
│ ├── slice.py # Subgraph extraction
|
|
182
|
-
│ ├── linkers/ #
|
|
189
|
+
│ ├── linkers/ # Tier 2 edge-recovery passes (Protocol/Bridge/Framework/Infrastructure)
|
|
183
190
|
│ └── frameworks/ # Framework detection (YAML patterns)
|
|
184
191
|
├── hypergumbo-lang-mainstream/ # Python, JS, Java, Go, Rust, etc.
|
|
185
192
|
├── hypergumbo-lang-common/ # Haskell, Elixir, GraphQL, etc.
|
|
@@ -214,11 +221,12 @@ See [CONTRIBUTING.md](CONTRIBUTING.md) for PR workflow (including fork-based wor
|
|
|
214
221
|
- [docs/USE-CASES.md](https://codeberg.org/iterabloom/hypergumbo/src/branch/dev/docs/USE-CASES.md) — Practical workflows and examples
|
|
215
222
|
- [CHANGELOG.md](https://codeberg.org/iterabloom/hypergumbo/src/branch/dev/CHANGELOG.md) — Implementation history
|
|
216
223
|
- [docs/LANGUAGES.md](https://codeberg.org/iterabloom/hypergumbo/src/branch/dev/docs/LANGUAGES.md) — Supported languages
|
|
217
|
-
- [docs/LINKERS.md](https://codeberg.org/iterabloom/hypergumbo/src/branch/dev/docs/LINKERS.md) —
|
|
224
|
+
- [docs/LINKERS.md](https://codeberg.org/iterabloom/hypergumbo/src/branch/dev/docs/LINKERS.md) — Linkers catalogue (Protocol / Bridge / Framework / Infrastructure)
|
|
218
225
|
- [docs/FRAMEWORKS.md](https://codeberg.org/iterabloom/hypergumbo/src/branch/dev/docs/FRAMEWORKS.md) — Framework patterns
|
|
219
226
|
- [docs/hypergumbo-spec.md](https://codeberg.org/iterabloom/hypergumbo/src/branch/dev/docs/hypergumbo-spec.md) — Detailed specification
|
|
220
227
|
- [docs/CITATIONS.md](https://codeberg.org/iterabloom/hypergumbo/src/branch/dev/docs/CITATIONS.md) — Paper citations for embedding models
|
|
221
228
|
- [docs/CACHE.md](https://codeberg.org/iterabloom/hypergumbo/src/branch/dev/docs/CACHE.md) — Caching architecture
|
|
229
|
+
- [docs/agent-supervisor.md](https://codeberg.org/iterabloom/hypergumbo/src/branch/dev/docs/agent-supervisor.md) — Operator guide for `scripts/agent-supervisor` (the tmux-session watchdog for autonomous agents)
|
|
222
230
|
- [SECURITY.md](https://codeberg.org/iterabloom/hypergumbo/src/branch/dev/SECURITY.md) — Vulnerability reporting
|
|
223
231
|
- [hypergumbo-tracker README](packages/hypergumbo-tracker/README.md) — Standalone tracker for AI agent governance
|
|
224
232
|
|
|
@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
|
|
|
4
4
|
|
|
5
5
|
[project]
|
|
6
6
|
name = "hypergumbo"
|
|
7
|
-
version = "2.
|
|
7
|
+
version = "2.7.0"
|
|
8
8
|
description = "Local-first repo behavior map generator"
|
|
9
9
|
readme = "README.md"
|
|
10
10
|
requires-python = ">=3.10"
|
|
@@ -19,10 +19,10 @@ classifiers = [
|
|
|
19
19
|
]
|
|
20
20
|
dependencies = [
|
|
21
21
|
# Meta-package that pulls in all hypergumbo components
|
|
22
|
-
"hypergumbo-core==2.
|
|
23
|
-
"hypergumbo-lang-mainstream==2.
|
|
24
|
-
"hypergumbo-lang-common==2.
|
|
25
|
-
"hypergumbo-lang-extended1==2.
|
|
22
|
+
"hypergumbo-core==2.7.0",
|
|
23
|
+
"hypergumbo-lang-mainstream==2.7.0",
|
|
24
|
+
"hypergumbo-lang-common==2.7.0",
|
|
25
|
+
"hypergumbo-lang-extended1==2.7.0",
|
|
26
26
|
]
|
|
27
27
|
|
|
28
28
|
[project.optional-dependencies]
|
|
File without changes
|
|
File without changes
|
|
File without changes
|