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.
@@ -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
- .agent/.current_session_transcript.jsonl
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.5.1
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.5.1
14
- Requires-Dist: hypergumbo-lang-common==2.5.1
15
- Requires-Dist: hypergumbo-lang-extended1==2.5.1
16
- Requires-Dist: hypergumbo-lang-mainstream==2.5.1
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 (faster)
164
- hypergumbo . --with-source # append full source code
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
- - **Cross-language linkers**: JNI, HTTP, WebSocket, gRPC, GraphQL, message queues ([full list](https://codeberg.org/iterabloom/hypergumbo/src/branch/dev/docs/LINKERS.md))
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. **Output**: Generate Markdown sketch or JSON behavior map
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 cross-language linkers to work together coherently.
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/ # Cross-language 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) — Cross-language linkers
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 (faster)
134
- hypergumbo . --with-source # append full source code
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
- - **Cross-language linkers**: JNI, HTTP, WebSocket, gRPC, GraphQL, message queues ([full list](https://codeberg.org/iterabloom/hypergumbo/src/branch/dev/docs/LINKERS.md))
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. **Output**: Generate Markdown sketch or JSON behavior map
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 cross-language linkers to work together coherently.
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/ # Cross-language 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) — Cross-language linkers
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.5.1"
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.5.1",
23
- "hypergumbo-lang-mainstream==2.5.1",
24
- "hypergumbo-lang-common==2.5.1",
25
- "hypergumbo-lang-extended1==2.5.1",
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]